CrankUpIT: Data Filter (Dart)

The Sovereign Data Sieve for Flutter and Dart. Mirrors the Volkrex PHP and JS implementations.


I. Overview

The Dart Data Filter completes the Trinity of the CrankUpIT data architecture. It ensures that mobile applications running on Flutter provide the same "Atomic Bit" sanitization as our server and web gateways.


II. Features

  • Logic Symmetry: 1:1 match with @crankupit/data-filter (JS) and crankupit/data-filter (PHP).
  • Flutter Ready: Perfect for TextFormField validation and onChanged sanitization.
  • Offline First: Clean data on the device before it ever reaches the network.

III. Installation

Add this to your pubspec.yaml:

dependencies:
    crankupit_data_filter: ^1.0.0

IV. Integration Logic

Important: To ensure system parity, the library must be imported via the sovereign entry point:

import 'package:crankupit_data_filter/crankupit_data_filter.dart';

V. Usage

The package uses a batch-processing Sanitizer to handle multiple fields simultaneously.

final sanitizer = Sanitizer();

final Map<String, dynamic> rawData = {
    "first_name": " sahil chraya ",
    "slug_input": "Volkrex OS"
};

final Map<String, String> fieldMappings = {
    "first_name": "person_name",
    "slug_input": "system_slug"
};

final Map<String, List<String>> globalRules = {
    "person_name": ["royal_case", "atomic_clean"],
    "system_slug": ["slug"]
};

final refined = sanitizer.handle(rawData, fieldMappings, globalRules);

VI. Available Sovereign Filters

Filter Logic/Effect Example
royal_case Multi-word capitalization sahil chraya → Sahil Chraya
atomic_clean Strips non-alpha characters sahil@123 → sahil
slug URL-safe string conversion Volkrex OS → volkrex-os
web_safe HTML Entity escaping <script> → &lt;script&gt;

VII. Troubleshooting

Error: Target of URI doesn't exist

  • Ensure you are using:
    import 'package:crankupit_data_filter/crankupit_data_filter.dart';
    
  • The previous naming convention dart_data_filter.dart is deprecated.

Managed by Volkrex Inc. Secured Globally.