@botler/1403-form-filler-module 1.0.0

package/dist/cli.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * 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
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const dotenv_1 = __importDefault(require("dotenv"));
+dotenv_1.default.config();
+const logger_1 = require("./shared/logger");
+const config_1 = require("./config");
+const form_filler_1 = require("./form-filler");
+// Configure logging
+logger_1.logger.setLogLevel(logger_1.LogLevel.INFO);
+/**
+ * Main CLI execution.
+ * Parses CLI arguments, creates the orchestrator, and runs it.
+ */
+async function main() {
+    try {
+        const args = process.argv.slice(2);
+        const config = config_1.Config.parseArgs(args);
+        logger_1.logger.info("🚀 Starting canvasser form filling process...");
+        if (config.dryRun) {
+            logger_1.logger.info("🧪 DRY RUN MODE — No PDFs will be generated");
+        }
+        // Validate template and output directory
+        await config_1.Config.validateConfig(config);
+        logger_1.logger.info(`📁 Template: ${config.templatePath} ✓`);
+        logger_1.logger.info(`📁 Output directory: ${config.outputDirectory} ✓`);
+        // Create the library-level FormFiller with CLI-derived settings
+        const formFiller = new form_filler_1.FormFiller({
+            templatePath: config.templatePath,
+            outputDirectory: config.outputDirectory,
+            batchSize: config.batchSize,
+            dryRun: config.dryRun,
+            skipExisting: config.skipExisting,
+            keepTemp: config.keepTemp,
+        });
+        logger_1.logger.info("🔗 Database pool initialised ✓");
+        let results = [];
+        if (config.userId) {
+            logger_1.logger.info(`🚀 Processing user ID: ${config.userId}`);
+            const result = await formFiller.fillForUser(config.userId);
+            results = [result];
+            logResult(result);
+        }
+        else if (config.userIds) {
+            logger_1.logger.info(`🚀 Processing ${config.userIds.length} user IDs`);
+            results = await formFiller.fillForUsers(config.userIds);
+            for (const r of results)
+                logResult(r);
+        }
+        else if (config.processAll) {
+            results = await formFiller.fillAll();
+        }
+        // Report summary
+        reportFinalResults(results, config);
+        await formFiller.destroy();
+        logger_1.logger.info("🔌 Database pool closed");
+        process.exit(0);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger_1.logger.error(`Fatal error: ${message}`);
+        process.exit(1);
+    }
+}
+/** Log a single processing result. */
+function logResult(result) {
+    if (result.success) {
+        if (result.skipped) {
+            logger_1.logger.info(`⏭️  Skipped: ${result.userId} — ${result.reason}`);
+        }
+        else {
+            logger_1.logger.info(`✅ Generated: ${result.userId}.pdf`);
+        }
+    }
+    else {
+        logger_1.logger.error(`❌ Failed: ${result.userId} — ${result.error}`);
+    }
+}
+/** Print a summary of all processing results. */
+function reportFinalResults(results, config) {
+    const successful = results.filter((r) => r.success && !r.skipped).length;
+    const failed = results.filter((r) => !r.success).length;
+    const skipped = results.filter((r) => r.success && r.skipped).length;
+    logger_1.logger.info("\n📈 Summary:");
+    if (config.userId && results.length === 1) {
+        const r = results[0];
+        if (r) {
+            logger_1.logger.info(`  User ID: ${r.userId}`);
+            logger_1.logger.info(`  Status: ${r.success ? (r.skipped ? "Skipped" : "Success") : "Failed"}`);
+            if (r.outputPath)
+                logger_1.logger.info(`  Output: ${r.outputPath}`);
+            if (r.error)
+                logger_1.logger.info(`  Error: ${r.error}`);
+        }
+    }
+    else {
+        logger_1.logger.info(`  Total records: ${results.length}`);
+        logger_1.logger.info(`  Successful: ${successful}`);
+        logger_1.logger.info(`  Failed: ${failed}`);
+        logger_1.logger.info(`  Skipped: ${skipped}`);
+    }
+    if (failed > 0) {
+        logger_1.logger.info("\n❌ Failed records:");
+        for (const r of results.filter((r) => !r.success)) {
+            logger_1.logger.info(`  User ${r.userId}: ${r.error}`);
+        }
+    }
+}
+// Run when executed directly
+if (require.main === module) {
+    main().catch(console.error);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,58 @@
+/**
+ * config.ts - Configuration and CLI parsing for form-filler-module
+ *
+ * Handles command-line argument parsing, default configuration,
+ * and validation of file paths and directories.
+ */
+import type { ScriptConfig } from "./types";
+/**
+ * Static utility class for CLI parsing, configuration, and validation.
+ */
+export declare class Config {
+    /** Default configuration values for all non-mode-specific options */
+    private static readonly DEFAULT_CONFIG;
+    /**
+     * Parse CLI arguments and build a ScriptConfig.
+     *
+     * @param args - Raw process.argv.slice(2) arguments
+     * @returns A fully-resolved ScriptConfig
+     * @throws Error if no processing mode (--id, --ids, --all) is specified
+     */
+    static parseArgs(args: string[]): ScriptConfig;
+    /**
+     * Validate configuration and environment (template exists, output dir writable).
+     *
+     * @param config - The ScriptConfig to validate
+     * @throws Error if template is missing/unreadable or output dir cannot be created
+     */
+    static validateConfig(config: ScriptConfig): Promise<void>;
+    /**
+     * Generate output file path for a user ID.
+     *
+     * @param config - The ScriptConfig containing outputDirectory
+     * @param userId - The user ID used as the filename stem
+     * @returns Absolute path to the output PDF
+     */
+    static getOutputPath(config: ScriptConfig, userId: string): string;
+    /**
+     * Check if an output file already exists for a user ID.
+     *
+     * @param config - The ScriptConfig containing outputDirectory
+     * @param userId - The user ID to check
+     * @returns True if the output PDF already exists
+     */
+    static outputExists(config: ScriptConfig, userId: string): boolean;
+    /**
+     * Parse CLI arguments into key-value pairs.
+     * Supports --key=value, --key value, and boolean flags.
+     *
+     * @param args - Raw CLI argument strings
+     * @returns Parsed CLIArgs object
+     */
+    private static parseCliArgs;
+    /**
+     * Print CLI help information and usage examples.
+     */
+    private static showHelp;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAW,MAAM,SAAS,CAAC;AAErD;;GAEG;AACH,qBAAa,MAAM;IAChB,qEAAqE;IACrE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAYpC;IAEF;;;;;;OAMG;WACW,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY;IAyErD;;;;;OAKG;WACiB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA2CvE;;;;;;OAMG;WACW,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAIzE;;;;;;OAMG;WACW,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAKzE;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAkD3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;CAmDzB"}

package/dist/config.js

@@ -0,0 +1,297 @@
+"use strict";
+/**
+ * config.ts - Configuration and CLI parsing for form-filler-module
+ *
+ * Handles command-line argument parsing, default configuration,
+ * and validation of file paths and directories.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Config = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/**
+ * Static utility class for CLI parsing, configuration, and validation.
+ */
+class Config {
+    /** Default configuration values for all non-mode-specific options */
+    static DEFAULT_CONFIG = {
+        templatePath: path.resolve(process.cwd(), "templates/template.pdf"),
+        outputDirectory: path.resolve(process.cwd(), "temp/filled-forms"),
+        batchSize: 10,
+        dryRun: false,
+        skipExisting: true,
+        maxRetries: 3,
+        retryDelay: 1000,
+        keepTemp: false,
+    };
+    /**
+     * Parse CLI arguments and build a ScriptConfig.
+     *
+     * @param args - Raw process.argv.slice(2) arguments
+     * @returns A fully-resolved ScriptConfig
+     * @throws Error if no processing mode (--id, --ids, --all) is specified
+     */
+    static parseArgs(args) {
+        const parsedArgs = this.parseCliArgs(args);
+        // Show help and exit if requested
+        if (parsedArgs.help) {
+            this.showHelp();
+            process.exit(0);
+        }
+        const config = {
+            ...this.DEFAULT_CONFIG,
+            dryRun: parsedArgs.dryRun || parsedArgs["dry-run"] || false,
+            skipExisting: parsedArgs.skipExisting || parsedArgs["skip-existing"] || true,
+            batchSize: parsedArgs.batchSize
+                ? parseInt(parsedArgs["batch-size"] || parsedArgs.batchSize)
+                : 10,
+            keepTemp: parsedArgs.keepTemp || parsedArgs["keep-temp"] || false,
+        };
+        // Determine processing mode from CLI arguments
+        if (parsedArgs.id) {
+            // Single user mode
+            const id = parsedArgs.id.trim();
+            if (!id || id.length === 0) {
+                throw new Error(`Invalid user ID: ${parsedArgs.id}. Must be a non-empty string.`);
+            }
+            config.userId = id;
+        }
+        else if (parsedArgs.ids) {
+            // Multiple users mode
+            const ids = parsedArgs.ids
+                .split(",")
+                .map((id) => id.trim())
+                .filter((id) => id.length > 0);
+            if (ids.length === 0) {
+                throw new Error("No valid user IDs provided. IDs must be non-empty strings.");
+            }
+            config.userIds = ids;
+        }
+        else if (parsedArgs.all) {
+            // Batch mode — process all users from open EA submission batches
+            config.processAll = true;
+        }
+        else {
+            // No mode specified — show helpful error
+            const providedArgs = Object.keys(parsedArgs);
+            let errorMessage = "Must specify either --id, --ids, or --all. Use --help for usage information.";
+            if (providedArgs.length === 0) {
+                errorMessage += "\n\nNo arguments provided. Available options:\n";
+                errorMessage += "  --id=<ID>     Process single user\n";
+                errorMessage +=
+                    "  --ids=<IDs>   Process multiple users (comma-separated)\n";
+                errorMessage +=
+                    "  --all         Process all users from open EA batches\n";
+                errorMessage += "  --help        Show help information";
+            }
+            else {
+                errorMessage += `\n\nReceived arguments: ${providedArgs.join(", ")}`;
+                errorMessage +=
+                    "\nMake sure to use proper format: --id=value or --ids=value1,value2";
+            }
+            throw new Error(errorMessage);
+        }
+        return config;
+    }
+    /**
+     * Validate configuration and environment (template exists, output dir writable).
+     *
+     * @param config - The ScriptConfig to validate
+     * @throws Error if template is missing/unreadable or output dir cannot be created
+     */
+    static async validateConfig(config) {
+        // Check template file exists
+        if (!fs.existsSync(config.templatePath)) {
+            throw new Error(`Template file not found: ${config.templatePath}`);
+        }
+        // Check template is readable
+        try {
+            await fs.promises.access(config.templatePath, fs.constants.R_OK);
+        }
+        catch (error) {
+            throw new Error(`Template file is not readable: ${config.templatePath}`);
+        }
+        // Ensure output directory exists
+        if (!fs.existsSync(config.outputDirectory)) {
+            try {
+                await fs.promises.mkdir(config.outputDirectory, {
+                    recursive: true,
+                });
+            }
+            catch (error) {
+                throw new Error(`Failed to create output directory: ${config.outputDirectory}`);
+            }
+        }
+        // Check output directory is writable
+        try {
+            await fs.promises.access(config.outputDirectory, fs.constants.W_OK);
+        }
+        catch (error) {
+            throw new Error(`Output directory is not writable: ${config.outputDirectory}`);
+        }
+        // Validate batch size range
+        if (config.batchSize <= 0 || config.batchSize > 100) {
+            throw new Error("Batch size must be between 1 and 100");
+        }
+    }
+    /**
+     * Generate output file path for a user ID.
+     *
+     * @param config - The ScriptConfig containing outputDirectory
+     * @param userId - The user ID used as the filename stem
+     * @returns Absolute path to the output PDF
+     */
+    static getOutputPath(config, userId) {
+        return path.join(config.outputDirectory, `${userId}.pdf`);
+    }
+    /**
+     * Check if an output file already exists for a user ID.
+     *
+     * @param config - The ScriptConfig containing outputDirectory
+     * @param userId - The user ID to check
+     * @returns True if the output PDF already exists
+     */
+    static outputExists(config, userId) {
+        const outputPath = this.getOutputPath(config, userId);
+        return fs.existsSync(outputPath);
+    }
+    /**
+     * Parse CLI arguments into key-value pairs.
+     * Supports --key=value, --key value, and boolean flags.
+     *
+     * @param args - Raw CLI argument strings
+     * @returns Parsed CLIArgs object
+     */
+    static parseCliArgs(args) {
+        const result = {};
+        for (let i = 0; i < args.length; i++) {
+            const arg = args[i];
+            // Handle --key=value format
+            if (arg.startsWith("--") && arg.includes("=")) {
+                const [key, ...valueParts] = arg.slice(2).split("=");
+                const value = valueParts.join("="); // Rejoin in case value contains =
+                result[key] = value;
+            }
+            // Handle --key value format
+            else if (arg.startsWith("--")) {
+                const key = arg.slice(2);
+                const nextArg = args[i + 1];
+                // Boolean flags (no value expected)
+                if ([
+                    "help",
+                    "all",
+                    "dry-run",
+                    "skip-existing",
+                    "keep-temp",
+                ].includes(key)) {
+                    result[key] = true;
+                }
+                // Value flags (consume next argument)
+                else if (nextArg && !nextArg.startsWith("--")) {
+                    result[key] = nextArg;
+                    i++; // Skip next argument as it has been consumed
+                }
+                // Fallback to boolean
+                else {
+                    result[key] = true;
+                }
+            }
+            // Handle key=value format (without --)
+            else if (arg.includes("=")) {
+                const [key, ...valueParts] = arg.split("=");
+                const value = valueParts.join("=");
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    /**
+     * Print CLI help information and usage examples.
+     */
+    static showHelp() {
+        console.log(`
+🔧 Fill Canvasser 1403 Form Generator
+
+USAGE:
+  npx tsx src/index.ts [OPTIONS]
+
+OPTIONS:
+  --id <userId>          Process single user by ID
+  --id=<userId>          Alternative format
+  --ids <id1,id2,id3>   Process multiple users by comma-separated IDs
+  --ids=<id1,id2,id3>   Alternative format
+  --all                  Process all users from open EA submission batches
+  --dry-run              Show what would be processed without generating PDFs
+  --skip-existing        Skip users with existing PDF files (default: true)
+  --batch-size <N>       Number of records to process in each batch (default: 10)
+  --keep-temp            Keep per-user PDF files after batch merge + S3 upload
+  --help                 Show this help message
+
+ENVIRONMENT:
+  TEAM_DATABASE_URL      Neon PostgreSQL connection string (required)
+
+EXAMPLES:
+  # Generate form for a specific user
+  npx tsx src/index.ts --id=abc123
+
+  # Generate forms for multiple users
+  npx tsx src/index.ts --ids=abc,def,ghi
+
+  # Dry-run all open EA submission batches
+  npx tsx src/index.ts --all --dry-run
+
+  # Process all with custom batch size
+  npx tsx src/index.ts --all --batch-size=20
+
+FILES:
+  Template: templates/template.pdf
+  Output:   temp/filled-forms/{userId}.pdf
+
+DATA FLOW:
+  1. Fetches open batches from ea_submission_batches (--all mode)
+  2. Sets batch status to SUBMITTING
+  3. Joins ea_submissions → profile_reviews to get userId per submission
+  4. Builds canvasser profile from user_profiles + form_1403_signatures + addresses
+  5. Maps profile to PDF form fields and generates signed, flattened PDF
+  6. Merges all per-user PDFs in the batch into a single document
+  7. Uploads merged PDF to S3 (batches/1403/{batchId}.pdf)
+  8. Sets batch status to COMPLETED with s3Key (or FAILED on error)
+  9. Deletes per-user temp files (unless --keep-temp)
+`);
+    }
+}
+exports.Config = Config;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/db/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * db/index.ts — Barrel export for the database module
+ */
+export { getPool, setPool, closePool } from "./pool";
+export { getOpenBatches, getSubmissionsWithUserIds, getCanvasserProfile, updateBatchStatus, updateBatchS3Key, } from "./queries";
+//# sourceMappingURL=index.d.ts.map

package/dist/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrD,OAAO,EACJ,cAAc,EACd,yBAAyB,EACzB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,GAClB,MAAM,WAAW,CAAC"}

package/dist/db/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateBatchS3Key = exports.updateBatchStatus = exports.getCanvasserProfile = exports.getSubmissionsWithUserIds = exports.getOpenBatches = exports.closePool = exports.setPool = exports.getPool = void 0;
+/**
+ * db/index.ts — Barrel export for the database module
+ */
+var pool_1 = require("./pool");
+Object.defineProperty(exports, "getPool", { enumerable: true, get: function () { return pool_1.getPool; } });
+Object.defineProperty(exports, "setPool", { enumerable: true, get: function () { return pool_1.setPool; } });
+Object.defineProperty(exports, "closePool", { enumerable: true, get: function () { return pool_1.closePool; } });
+var queries_1 = require("./queries");
+Object.defineProperty(exports, "getOpenBatches", { enumerable: true, get: function () { return queries_1.getOpenBatches; } });
+Object.defineProperty(exports, "getSubmissionsWithUserIds", { enumerable: true, get: function () { return queries_1.getSubmissionsWithUserIds; } });
+Object.defineProperty(exports, "getCanvasserProfile", { enumerable: true, get: function () { return queries_1.getCanvasserProfile; } });
+Object.defineProperty(exports, "updateBatchStatus", { enumerable: true, get: function () { return queries_1.updateBatchStatus; } });
+Object.defineProperty(exports, "updateBatchS3Key", { enumerable: true, get: function () { return queries_1.updateBatchS3Key; } });
+//# sourceMappingURL=index.js.map

package/dist/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,+BAAqD;AAA5C,+FAAA,OAAO,OAAA;AAAE,+FAAA,OAAO,OAAA;AAAE,iGAAA,SAAS,OAAA;AACpC,qCAMmB;AALhB,yGAAA,cAAc,OAAA;AACd,oHAAA,yBAAyB,OAAA;AACzB,8GAAA,mBAAmB,OAAA;AACnB,4GAAA,iBAAiB,OAAA;AACjB,2GAAA,gBAAgB,OAAA"}

package/dist/db/pool.d.ts

@@ -0,0 +1,34 @@
+/**
+ * db/pool.ts — Neon PostgreSQL connection pool
+ *
+ * Creates and manages a singleton pg.Pool connected to the team
+ * Neon database. Supports dependency injection via setPool(), or
+ * auto-creates from a connection string / environment variables.
+ *
+ * Resolution order for the connection string:
+ *   1. Explicit `databaseUrl` passed to `getPool()`
+ *   2. `TEAM_DATABASE_URL` environment variable
+ *   3. `WNC_TRACKING_DATABASE_URI` environment variable
+ */
+import { Pool } from "pg";
+/**
+ * Inject an externally-created Pool instance.
+ * Useful when the consumer already has a connection pool (e.g. a web server).
+ *
+ * @param externalPool - A pg.Pool to use for all subsequent queries
+ */
+export declare function setPool(externalPool: Pool): void;
+/**
+ * Create or return the singleton PostgreSQL connection pool.
+ *
+ * @param databaseUrl - Optional explicit connection string (highest priority)
+ * @returns A connected pg.Pool instance
+ * @throws Error if no connection string can be resolved
+ */
+export declare function getPool(databaseUrl?: string): Pool;
+/**
+ * Gracefully close the connection pool and release all clients.
+ * Safe to call multiple times or when no pool exists.
+ */
+export declare function closePool(): Promise<void>;
+//# sourceMappingURL=pool.d.ts.map

package/dist/db/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/db/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAK1B;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,YAAY,EAAE,IAAI,GAAG,IAAI,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CA0BlD;AAED;;;GAGG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAK/C"}

package/dist/db/pool.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * db/pool.ts — Neon PostgreSQL connection pool
+ *
+ * Creates and manages a singleton pg.Pool connected to the team
+ * Neon database. Supports dependency injection via setPool(), or
+ * auto-creates from a connection string / environment variables.
+ *
+ * Resolution order for the connection string:
+ *   1. Explicit `databaseUrl` passed to `getPool()`
+ *   2. `TEAM_DATABASE_URL` environment variable
+ *   3. `WNC_TRACKING_DATABASE_URI` environment variable
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setPool = setPool;
+exports.getPool = getPool;
+exports.closePool = closePool;
+const pg_1 = require("pg");
+/** Singleton pool instance */
+let pool = null;
+/**
+ * Inject an externally-created Pool instance.
+ * Useful when the consumer already has a connection pool (e.g. a web server).
+ *
+ * @param externalPool - A pg.Pool to use for all subsequent queries
+ */
+function setPool(externalPool) {
+    pool = externalPool;
+}
+/**
+ * Create or return the singleton PostgreSQL connection pool.
+ *
+ * @param databaseUrl - Optional explicit connection string (highest priority)
+ * @returns A connected pg.Pool instance
+ * @throws Error if no connection string can be resolved
+ */
+function getPool(databaseUrl) {
+    if (pool) {
+        return pool;
+    }
+    const connectionString = databaseUrl ||
+        process.env.TEAM_DATABASE_URL ||
+        process.env.WNC_TRACKING_DATABASE_URI;
+    if (!connectionString) {
+        throw new Error("No database connection string found. " +
+            "Provide a `pool` or `databaseUrl` in FormFillerConfig, " +
+            "or set TEAM_DATABASE_URL / WNC_TRACKING_DATABASE_URI.");
+    }
+    pool = new pg_1.Pool({
+        connectionString,
+        max: 10,
+        idleTimeoutMillis: 30_000,
+        connectionTimeoutMillis: 10_000,
+    });
+    return pool;
+}
+/**
+ * Gracefully close the connection pool and release all clients.
+ * Safe to call multiple times or when no pool exists.
+ */
+async function closePool() {
+    if (pool) {
+        await pool.end();
+        pool = null;
+    }
+}
+//# sourceMappingURL=pool.js.map

package/dist/db/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../src/db/pool.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAaH,0BAEC;AASD,0BA0BC;AAMD,8BAKC;AA3DD,2BAA0B;AAE1B,8BAA8B;AAC9B,IAAI,IAAI,GAAgB,IAAI,CAAC;AAE7B;;;;;GAKG;AACH,SAAgB,OAAO,CAAC,YAAkB;IACvC,IAAI,GAAG,YAAY,CAAC;AACvB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,OAAO,CAAC,WAAoB;IACzC,IAAI,IAAI,EAAE,CAAC;QACR,OAAO,IAAI,CAAC;IACf,CAAC;IAED,MAAM,gBAAgB,GACnB,WAAW;QACX,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC7B,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;IAEzC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACZ,uCAAuC;YACpC,yDAAyD;YACzD,uDAAuD,CAC5D,CAAC;IACL,CAAC;IAED,IAAI,GAAG,IAAI,SAAI,CAAC;QACb,gBAAgB;QAChB,GAAG,EAAE,EAAE;QACP,iBAAiB,EAAE,MAAM;QACzB,uBAAuB,EAAE,MAAM;KACjC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACf,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,SAAS;IAC5B,IAAI,IAAI,EAAE,CAAC;QACR,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;QACjB,IAAI,GAAG,IAAI,CAAC;IACf,CAAC;AACJ,CAAC"}