Skip to main content

Import Module Hero Module

The Import module maps incoming files to your schemas, normalizes headers, and prepares rows for validation, masking, and profiling.

Features at a glance​

  • Column mapping with presets and automapping hints
  • Tier-aware limits and license enforcement in-browser
  • Hooks for analytics callbacks and audit trails

Quick React usage​

import {AirgapImporter} from '@airgapkit/import-react';

export function ContactsImport() {
  return (
    <AirgapImporter
      schemaId="contacts"
      onSuccess={(rows) => {
        // Rows have already been parsed, validated, and masked.
        console.log('Clean rows ready for sync', rows);
      }}
      onError={(errors) => {
        console.error('Import issues', errors);
      }}
    />
  );
}

Where it fits in the pipeline​

  • Intake: handles file upload and header discovery.
  • Map: aligns incoming columns to your domain schema with presets.
  • Hand-off: emits normalized rows to Validate, Transform, and Mask.
  • Observe: emits analytics callbacks so you can track success/failure without leaving the browser.

TODO: Add code snippets for controlled column mapping, presets, and serverless webhook callbacks.