@botler/1403-form-filler-module 1.0.0

package/README.md

@@ -0,0 +1,203 @@
+# @botler/1403-form-filler-module
+
+Fills Alberta **Form 1403** PDFs for canvassers. Fetches data from Neon PostgreSQL, fills AcroForm fields, overlays cursive signatures, flattens to image-PDFs, merges per-batch, and uploads to AWS S3.
+
+Usable as a **library** (`import { FormFiller }`) or as a **CLI** (`npx fill-1403 --all`).
+
+## Installation
+
+```bash
+npm install @botler/1403-form-filler-module
+```
+
+> Requires `NPM_TOKEN` for the private `@botler` scope (see `.npmrc`).
+
+## Library usage
+
+### ESM (`.mjs` / `"type": "module"`)
+
+```js
+import { FormFiller } from "@botler/1403-form-filler-module";
+
+const filler = new FormFiller({
+   databaseUrl: process.env.WNC_TRACKING_DATABASE_URI,
+});
+
+// Single user
+const result = await filler.fillForUser("user-abc-123");
+console.log(result); // { success: true, userId: "user-abc-123", outputPath: "..." }
+
+// All open batches (fill → flatten → merge → S3 upload)
+const results = await filler.fillAll();
+
+// Cleanup (closes DB pool if we created it)
+await filler.destroy();
+```
+
+### CJS (`require`)
+
+```js
+const { FormFiller } = require("@botler/1403-form-filler-module");
+
+const filler = new FormFiller({
+   databaseUrl: process.env.WNC_TRACKING_DATABASE_URI,
+});
+```
+
+### Bring your own Pool
+
+If your app already has a `pg.Pool` connected to the same database,
+pass it in to avoid creating a second connection pool:
+
+```js
+import { FormFiller } from "@botler/1403-form-filler-module";
+import pg from "pg";
+
+const pool = new pg.Pool({
+   connectionString: process.env.WNC_TRACKING_DATABASE_URI,
+});
+
+const filler = new FormFiller({ pool });
+const result = await filler.fillForUser("user-abc-123");
+
+// When pool is injected, destroy() does NOT close it — you manage its lifecycle
+await filler.destroy();
+```
+
+## `FormFillerConfig` reference
+
+All fields are optional — sensible defaults are applied.
+
+| Field                    | Type              | Default                                           |
+| ------------------------ | ----------------- | ------------------------------------------------- |
+| `pool`                   | `pg.Pool`         | —                                                 |
+| `databaseUrl`            | `string`          | `TEAM_DATABASE_URL` → `WNC_TRACKING_DATABASE_URI` |
+| `templatePath`           | `string`          | `"s3://coal-forms/template.pdf"`                  |
+| `outputDirectory`        | `string`          | `"temp/filled-forms"`                             |
+| `signatureConfig`        | `SignatureConfig` | Great Vibes cursive, 60px, black                  |
+| `proponentName`          | `string`          | `"Corby Lund"`                                    |
+| `proponentSignatureText` | `string`          | `"Corby Lund"`                                    |
+| `petitionText`           | `string`          | `"No New Coal Mining in the Eastern Slopes…"`     |
+| `s3Bucket`               | `string`          | `"coal-forms"`                                    |
+| `s3KeyPrefix`            | `string`          | `"batches/1403"`                                  |
+| `batchSize`              | `number`          | `10`                                              |
+| `dryRun`                 | `boolean`         | `false`                                           |
+| `skipExisting`           | `boolean`         | `true`                                            |
+| `keepTemp`               | `boolean`         | `false`                                           |
+
+## Public API
+
+```ts
+class FormFiller {
+   constructor(config?: FormFillerConfig);
+
+   /** Fill + flatten the form for a single user */
+   fillForUser(userId: string): Promise<ProcessingResult>;
+
+   /** Fill + flatten for multiple users */
+   fillForUsers(userIds: string[]): Promise<ProcessingResult[]>;
+
+   /** Process all open EA batches (fill → merge → S3) */
+   fillAll(): Promise<ProcessingResult[]>;
+
+   /** Release DB pool (no-op if pool was injected) */
+   destroy(): Promise<void>;
+}
+```
+
+## CLI usage
+
+```bash
+# Via npx (after install)
+npx fill-1403 --all
+
+# Or during development
+npx tsx src/cli.ts --id=<userId>
+npx tsx src/cli.ts --ids=id1,id2,id3
+npx tsx src/cli.ts --all --dry-run
+```
+
+| Flag                | Description                                             |
+| ------------------- | ------------------------------------------------------- |
+| `--id <userId>`     | Process a single user by ID                             |
+| `--ids <id1,id2,…>` | Process multiple users (comma-separated)                |
+| `--all`             | Process all users from open EA submission batches       |
+| `--dry-run`         | Preview what would be processed without generating PDFs |
+| `--skip-existing`   | Skip users whose PDF already exists (default: `true`)   |
+| `--batch-size <N>`  | Records per processing batch (default: `10`)            |
+| `--keep-temp`       | Keep per-user PDF files after batch merge + S3 upload   |
+| `--help`            | Show help                                               |
+
+## Environment variables
+
+| Variable                    | Required | Description                                           |
+| --------------------------- | -------- | ----------------------------------------------------- |
+| `TEAM_DATABASE_URL`         |          | Neon PostgreSQL connection string (primary)           |
+| `WNC_TRACKING_DATABASE_URI` |          | Fallback Neon connection string (same DB)             |
+| `AWS_S3_ACCESS_KEY_ID`      | ✅       | AWS access key for S3 uploads                         |
+| `AWS_S3_SECRET_ACCESS_KEY`  | ✅       | AWS secret key for S3 uploads                         |
+| `AWS_S3_REGION`             |          | AWS region (default: `ca-central-1`)                  |
+| `LOG_LEVEL`                 |          | `debug`, `info`, `warn`, or `error` (default: `info`) |
+
+> When used as a library, pass `databaseUrl` or `pool` in `FormFillerConfig` instead.
+
+## Project structure
+
+```
+form-filler-module/
+├── src/
+│   ├── index.ts                  # Library barrel (public API exports)
+│   ├── form-filler.ts            # FormFiller class (library core)
+│   ├── cli.ts                    # CLI entry point (dotenv, arg parsing)
+│   ├── config.ts                 # CLI argument parsing & validation
+│   ├── canvasser-data-mapper.ts  # Maps DB profile → PDF filler data
+│   ├── types/
+│   │   ├── config.ts             # FormFillerConfig, ScriptConfig, etc.
+│   │   ├── db-tables.ts          # Database table interfaces & enums
+│   │   ├── canvasser-profile.ts  # CanvasserProfile interface
+│   │   └── index.ts
+│   ├── shared/
+│   │   └── logger.ts             # Console logger with level filtering
+│   ├── pdf-filler/               # Vendored PDF form filler library
+│   ├── pdf-converter/            # MuPDF WASM page rasteriser
+│   ├── pdf-merger/               # pdf-lib page concatenation
+│   ├── s3/                       # S3 batch uploader
+│   └── db/                       # Neon PostgreSQL pool & queries
+│       ├── pool.ts               # getPool / setPool / closePool
+│       ├── queries.ts
+│       └── index.ts
+├── templates/
+│   └── template.pdf              # Form 1403 template (also on S3)
+├── dist/                         # Built output (published to npm)
+├── package.json
+├── tsconfig.json
+├── .npmrc
+└── .env.example
+```
+
+## Development
+
+```bash
+# Type-check
+npm run typecheck
+
+# Build to dist/
+npm run build
+
+# Run CLI in dev
+npx tsx src/cli.ts --all
+```
+
+## Publishing
+
+```bash
+# Ensure NPM_TOKEN is set
+export NPM_TOKEN=npm_...
+
+# Build + publish
+npm publish --access restricted
+```
+
+## License
+
+Private — internal use only.

package/dist/canvasser-data-mapper.d.ts

@@ -0,0 +1,110 @@
+/**
+ * canvasser-data-mapper.ts - Maps canvasser profile data to PDF filler format
+ *
+ * Transforms a CanvasserProfile (composed from user_profiles,
+ * form_1403_signatures, and addresses) into the CanvasserData
+ * interface expected by the pdf-filler library.
+ */
+import type { CanvasserData } from "./pdf-filler";
+import type { CanvasserProfile } from "./types";
+/** Optional overrides for domain-specific values. */
+export interface DataMapperOverrides {
+    /** Petition question text. @default "No New Coal Mining in the Eastern Slopes of the Rocky Mountains" */
+    petitionText?: string;
+    /** Proponent / Thomas name. @default "Corby Lund" */
+    proponentName?: string;
+    /** Text rendered as proponent signature. @default "Corby Lund" */
+    proponentSignatureText?: string;
+}
+/**
+ * Static utility class for mapping canvasser profile data to PDF form fields.
+ * Contains formatting helpers for phone numbers, postal codes, and addresses.
+ */
+export declare class CanvasserDataMapper {
+    /**
+     * Map a CanvasserProfile to the CanvasserData shape required by the PDF filler.
+     *
+     * Selects the RESIDENTIAL address for physical fields and MAILING address
+     * for mailing fields. Generates signature data from first/last name and
+     * the signedAt date.
+     *
+     * @param profile - Composed canvasser profile from database queries
+     * @param overrides - Optional domain value overrides
+     * @returns CanvasserData ready for PDF form filling
+     * @throws Error if required fields (firstName, lastName) are missing
+     */
+    static mapToFillerData(profile: CanvasserProfile, overrides?: DataMapperOverrides): CanvasserData;
+    /**
+     * Get a human-readable display name for a canvasser profile.
+     *
+     * @param profile - The canvasser profile
+     * @returns Formatted display name, or a fallback with the userId
+     */
+    static getDisplayName(profile: CanvasserProfile): string;
+    /**
+     * Pick the most recent address of a given type from the addresses array.
+     * The DB query already returns DISTINCT ON type ordered by updatedAt DESC,
+     * but this serves as a safety fallback for deduplication.
+     *
+     * @param addresses - All addresses for the user profile
+     * @param type - The AddressType to filter for
+     * @returns The most recent address of the given type, or undefined
+     */
+    private static pickAddressByType;
+    /**
+     * Build a single-line address string from an Address record.
+     * Includes streetAddress2 (unit/suite) when present.
+     *
+     * @param address - The address record
+     * @returns Formatted address line (e.g. "#201, 123 Main St")
+     */
+    private static buildAddressLine;
+    /**
+     * Validate that required fields are present and non-empty.
+     *
+     * @param profile - The canvasser profile to validate
+     * @throws Error listing all missing required fields
+     */
+    private static validateRequiredFields;
+    /**
+     * Capitalize the first letter of each word in a name, handling
+     * spaces, hyphens, and apostrophes as word boundaries.
+     *
+     * @param name - Raw name string
+     * @returns Capitalized name, or the original value if falsy
+     */
+    private static capitalizeName;
+    /**
+     * Remove any non-alphabetical characters from a string.
+     * Keeps only Unicode letters and spaces. Returns empty string for null/undefined.
+     *
+     * @param value - The string to sanitize
+     * @returns Sanitized string containing only letters and spaces
+     */
+    private static sanitizeAlpha;
+    /**
+     * Format a phone number to the standard (XXX) XXX-XXXX format.
+     * Handles 10-digit and 11-digit (1 + area code) North American numbers.
+     *
+     * @param phoneNumber - Raw phone number string
+     * @returns Formatted phone number, or original if format is unrecognised
+     */
+    private static formatPhoneNumber;
+    /**
+     * Format a postal code to the Canadian standard (X1X 1X1).
+     * Inserts a space in the middle of a 6-character code.
+     *
+     * @param postalCode - Raw postal code string
+     * @returns Formatted postal code, or original if format is unexpected
+     */
+    private static formatPostalCode;
+    /**
+     * Safely parse a date value into a Date object.
+     * Handles Date instances, ISO strings, and objects with toISOString().
+     *
+     * @param value - The date value to parse
+     * @returns Parsed Date or undefined if parsing fails
+     */
+    private static parseDate;
+}
+//# sourceMappingURL=canvasser-data-mapper.d.ts.map

package/dist/canvasser-data-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasser-data-mapper.d.ts","sourceRoot":"","sources":["../src/canvasser-data-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAIhD,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IACjC,yGAAyG;IACzG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAC7B;;;;;;;;;;;OAWG;WACW,eAAe,CAC1B,OAAO,EAAE,gBAAgB,EACzB,SAAS,CAAC,EAAE,mBAAmB,GAC/B,aAAa;IAkFhB;;;;;OAKG;WACW,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM;IAY/D;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAqBhC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAY/B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAqBrC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAS7B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAY5B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAsBhC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAY/B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;CA+B1B"}

package/dist/canvasser-data-mapper.js

@@ -0,0 +1,259 @@
+"use strict";
+/**
+ * canvasser-data-mapper.ts - Maps canvasser profile data to PDF filler format
+ *
+ * Transforms a CanvasserProfile (composed from user_profiles,
+ * form_1403_signatures, and addresses) into the CanvasserData
+ * interface expected by the pdf-filler library.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CanvasserDataMapper = void 0;
+const types_1 = require("./types");
+/**
+ * Static utility class for mapping canvasser profile data to PDF form fields.
+ * Contains formatting helpers for phone numbers, postal codes, and addresses.
+ */
+class CanvasserDataMapper {
+    /**
+     * Map a CanvasserProfile to the CanvasserData shape required by the PDF filler.
+     *
+     * Selects the RESIDENTIAL address for physical fields and MAILING address
+     * for mailing fields. Generates signature data from first/last name and
+     * the signedAt date.
+     *
+     * @param profile - Composed canvasser profile from database queries
+     * @param overrides - Optional domain value overrides
+     * @returns CanvasserData ready for PDF form filling
+     * @throws Error if required fields (firstName, lastName) are missing
+     */
+    static mapToFillerData(profile, overrides) {
+        // Validate that required name fields are present
+        this.validateRequiredFields(profile);
+        // Pick the best address of each type from the addresses array
+        const residentialAddress = this.pickAddressByType(profile.addresses, types_1.AddressType.RESIDENTIAL);
+        const mailingAddress = this.pickAddressByType(profile.addresses, types_1.AddressType.MAILING);
+        // Build address line strings from the structured address records
+        const physicalAddressLine = residentialAddress
+            ? this.buildAddressLine(residentialAddress)
+            : "";
+        const mailingAddressLine = mailingAddress
+            ? this.buildAddressLine(mailingAddress)
+            : "";
+        // Parse signedAt into a Date if available
+        const signedAtDate = this.parseDate(profile.signedAt);
+        // Capitalize names before any further processing
+        const firstName = this.capitalizeName(profile.firstName) ?? profile.firstName;
+        const lastName = this.capitalizeName(profile.lastName) ?? profile.lastName;
+        const middleName = this.capitalizeName(profile.middleName) ?? profile.middleName;
+        const fillerData = {
+            // Required name fields
+            surname: this.sanitizeAlpha(lastName),
+            givenName: this.sanitizeAlpha(firstName),
+            middleName: middleName ? this.sanitizeAlpha(middleName) : undefined,
+            // Phone number — prefer mobileNumber, fall back to additionalPhones[0]
+            telephoneNumber: this.formatPhoneNumber(profile.mobileNumber || (profile.additionalPhones?.[0] ?? "")),
+            // Email address (from users table)
+            emailAddress: profile.email || undefined,
+            // Physical (residential) address
+            physicalAddress: physicalAddressLine,
+            physicalMunicipality: residentialAddress?.city?.trim() || "",
+            physicalPostalCode: this.formatPostalCode(residentialAddress?.postalCode || ""),
+            // Mailing address (optional, only set when present)
+            mailingAddress: mailingAddressLine || undefined,
+            mailingMunicipality: mailingAddress?.city?.trim() || undefined,
+            mailingPostalCode: mailingAddress
+                ? this.formatPostalCode(mailingAddress.postalCode)
+                : undefined,
+            // Petition question text (configurable per form requirement)
+            proponentName: overrides?.petitionText ??
+                "No New Coal Mining in the Eastern Slopes of the Rocky Mountains",
+            // Canvasser signature — rendered from capitalized first + last name
+            canvasserNameForSignature: `${firstName?.trim() || ""} ${lastName?.trim() || ""}`.trim(),
+            canvasserActualSignatureDate: signedAtDate,
+            // Proponent (Thomas Lukaszuk) signature data
+            ThomasName: overrides?.proponentName ?? "Corby Lund",
+            proponentNameForSignature: overrides?.proponentSignatureText ?? "Corby Lund",
+            proponentSignatureDate: "",
+        };
+        return fillerData;
+    }
+    /**
+     * Get a human-readable display name for a canvasser profile.
+     *
+     * @param profile - The canvasser profile
+     * @returns Formatted display name, or a fallback with the userId
+     */
+    static getDisplayName(profile) {
+        const parts = [profile.firstName, profile.lastName]
+            .filter((part) => part && part.trim().length > 0)
+            .map((part) => part.trim());
+        return parts.length > 0 ? parts.join(" ") : `User ${profile.userId}`;
+    }
+    // =========================================================================
+    // Private helpers
+    // =========================================================================
+    /**
+     * Pick the most recent address of a given type from the addresses array.
+     * The DB query already returns DISTINCT ON type ordered by updatedAt DESC,
+     * but this serves as a safety fallback for deduplication.
+     *
+     * @param addresses - All addresses for the user profile
+     * @param type - The AddressType to filter for
+     * @returns The most recent address of the given type, or undefined
+     */
+    static pickAddressByType(addresses, type) {
+        // Filter to matching type
+        const matching = addresses.filter((a) => a.type === type);
+        if (matching.length === 0) {
+            return undefined;
+        }
+        // Sort by updatedAt descending and take the first (most recent)
+        matching.sort((a, b) => {
+            const dateA = a.updatedAt ? new Date(a.updatedAt).getTime() : 0;
+            const dateB = b.updatedAt ? new Date(b.updatedAt).getTime() : 0;
+            return dateB - dateA;
+        });
+        return matching[0];
+    }
+    /**
+     * Build a single-line address string from an Address record.
+     * Includes streetAddress2 (unit/suite) when present.
+     *
+     * @param address - The address record
+     * @returns Formatted address line (e.g. "#201, 123 Main St")
+     */
+    static buildAddressLine(address) {
+        const line1 = address.streetAddress?.trim() || "";
+        const line2 = address.streetAddress2?.trim() || "";
+        // Prepend unit/suite number if present
+        if (line2) {
+            return `${line2}, ${line1}`.trim();
+        }
+        return line1;
+    }
+    /**
+     * Validate that required fields are present and non-empty.
+     *
+     * @param profile - The canvasser profile to validate
+     * @throws Error listing all missing required fields
+     */
+    static validateRequiredFields(profile) {
+        const errors = [];
+        // Check that first and last name exist and are non-empty
+        if (!profile.firstName || profile.firstName.trim().length === 0) {
+            errors.push("firstName is required and cannot be empty");
+        }
+        if (!profile.lastName || profile.lastName.trim().length === 0) {
+            errors.push("lastName is required and cannot be empty");
+        }
+        if (errors.length > 0) {
+            throw new Error(`Data validation failed for user ${profile.userId}: ${errors.join(", ")}`);
+        }
+    }
+    /**
+     * Capitalize the first letter of each word in a name, handling
+     * spaces, hyphens, and apostrophes as word boundaries.
+     *
+     * @param name - Raw name string
+     * @returns Capitalized name, or the original value if falsy
+     */
+    static capitalizeName(name) {
+        if (!name)
+            return name;
+        return name
+            .toLowerCase()
+            .replace(/(?:^|[\s\-'])\S/g, (char) => char.toUpperCase());
+    }
+    /**
+     * Remove any non-alphabetical characters from a string.
+     * Keeps only Unicode letters and spaces. Returns empty string for null/undefined.
+     *
+     * @param value - The string to sanitize
+     * @returns Sanitized string containing only letters and spaces
+     */
+    static sanitizeAlpha(value) {
+        if (!value)
+            return "";
+        try {
+            // Prefer Unicode letter class to support diacritics
+            return value.replace(/[^\p{L} ]/gu, "").trim();
+        }
+        catch {
+            // Fallback to ASCII letters if Unicode property escapes are unsupported
+            return value.replace(/[^A-Za-z ]/g, "").trim();
+        }
+    }
+    /**
+     * Format a phone number to the standard (XXX) XXX-XXXX format.
+     * Handles 10-digit and 11-digit (1 + area code) North American numbers.
+     *
+     * @param phoneNumber - Raw phone number string
+     * @returns Formatted phone number, or original if format is unrecognised
+     */
+    static formatPhoneNumber(phoneNumber) {
+        // Strip all non-digit characters
+        const digits = phoneNumber.replace(/\D/g, "");
+        // Standard 10-digit North American format
+        if (digits.length === 10) {
+            return `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
+        }
+        // 11-digit with leading country code 1
+        if (digits.length === 11 && digits.startsWith("1")) {
+            return `(${digits.slice(1, 4)}) ${digits.slice(4, 7)}-${digits.slice(7)}`;
+        }
+        // Return original if we cannot format it
+        return phoneNumber;
+    }
+    /**
+     * Format a postal code to the Canadian standard (X1X 1X1).
+     * Inserts a space in the middle of a 6-character code.
+     *
+     * @param postalCode - Raw postal code string
+     * @returns Formatted postal code, or original if format is unexpected
+     */
+    static formatPostalCode(postalCode) {
+        // Remove spaces and convert to uppercase
+        const cleaned = postalCode.replace(/\s/g, "").toUpperCase();
+        // Add space in the middle if it is a valid 6-character code
+        if (cleaned.length === 6) {
+            return `${cleaned.slice(0, 3)} ${cleaned.slice(3)}`;
+        }
+        return postalCode;
+    }
+    /**
+     * Safely parse a date value into a Date object.
+     * Handles Date instances, ISO strings, and objects with toISOString().
+     *
+     * @param value - The date value to parse
+     * @returns Parsed Date or undefined if parsing fails
+     */
+    static parseDate(value) {
+        if (!value)
+            return undefined;
+        // Already a Date instance
+        if (value instanceof Date) {
+            return isNaN(value.getTime()) ? undefined : value;
+        }
+        // ISO string
+        if (typeof value === "string") {
+            const d = new Date(value);
+            return isNaN(d.getTime()) ? undefined : d;
+        }
+        // Object with toISOString (e.g. some ORM date wrappers)
+        try {
+            if (typeof value === "object" &&
+                value !== null &&
+                "toISOString" in value &&
+                typeof value.toISOString === "function") {
+                const d = new Date(value.toISOString());
+                return isNaN(d.getTime()) ? undefined : d;
+            }
+        }
+        catch {
+            // Ignore parse failures
+        }
+        return undefined;
+    }
+}
+exports.CanvasserDataMapper = CanvasserDataMapper;
+//# sourceMappingURL=canvasser-data-mapper.js.map

package/dist/canvasser-data-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasser-data-mapper.js","sourceRoot":"","sources":["../src/canvasser-data-mapper.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * cli.ts — CLI entry point for the 1403 form-filler-module
+ *
+ * Parses CLI arguments, loads environment variables via dotenv,
+ * creates a FormFiller instance, and dispatches to the correct mode.
+ *
+ * Usage:
+ *   npx tsx src/cli.ts --id <userId>
+ *   npx tsx src/cli.ts --ids <id1,id2,...>
+ *   npx tsx src/cli.ts --all
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG"}