@danielarndt0/cnpj-db-loader 2.4.0-beta.2 → 2.4.0-beta.4

package/dist/index.d.ts

@@ -20,8 +20,14 @@ type AppConfig = {
     description: string;
 };
 type DatasetBlock = "companies" | "establishments" | "partners" | "simples_options" | "countries" | "cities" | "partner_qualifications" | "legal_natures" | "cnaes";
+type FederalRevenueConfig = {
+    shareToken?: string;
+    webdavUrl?: string;
+    userAgent?: string;
+};
 type DatabaseConfig = {
     defaultDbUrl?: string;
+    federalRevenue?: FederalRevenueConfig;
 };
 
 type Result<T> = {
@@ -46,11 +52,74 @@ declare function defaultExtractedOutputPath(inputPath: string): string;
 type SupportedOs = "windows" | "macos" | "linux" | "unknown";
 declare function detectOs(): SupportedOs;
 
-declare function readDatabaseConfig(): Promise<DatabaseConfig>;
-declare function writeDatabaseConfig(config: DatabaseConfig): Promise<void>;
-declare function assertPostgresUrl(url: string): void;
-declare function setDefaultDbUrl(url: string): Promise<void>;
-declare function resetDefaultDbUrl(): Promise<void>;
+type ExtractionEntry = {
+    archivePath: string;
+    archiveName: string;
+    destinationPath: string;
+    success: boolean;
+    sizeInBytes: number;
+    errorMessage?: string;
+};
+type ExtractionSummary = {
+    inputPath: string;
+    outputPath: string;
+    operatingSystem: string;
+    zipFilesFound: number;
+    extractedArchives: string[];
+    skippedEntries: string[];
+    failedArchives: string[];
+    totalArchiveBytes: number;
+    extractedArchiveBytes: number;
+    entries: ExtractionEntry[];
+};
+type ExtractionProgressEvent = {
+    kind: "start";
+    totalArchives: number;
+    totalBytes: number;
+    inputPath: string;
+    outputPath: string;
+} | {
+    kind: "archive-start";
+    currentArchiveName: string;
+    currentArchivePath: string;
+    archiveSizeInBytes: number;
+    archiveIndex: number;
+    totalArchives: number;
+    completedArchives: number;
+    extractedBytes: number;
+    totalBytes: number;
+} | {
+    kind: "archive-complete";
+    currentArchiveName: string;
+    currentArchivePath: string;
+    archiveSizeInBytes: number;
+    archiveIndex: number;
+    totalArchives: number;
+    completedArchives: number;
+    extractedBytes: number;
+    totalBytes: number;
+} | {
+    kind: "archive-failed";
+    currentArchiveName: string;
+    currentArchivePath: string;
+    archiveSizeInBytes: number;
+    archiveIndex: number;
+    totalArchives: number;
+    completedArchives: number;
+    extractedBytes: number;
+    totalBytes: number;
+    errorMessage: string;
+} | {
+    kind: "finish";
+    totalArchives: number;
+    completedArchives: number;
+    failedArchives: number;
+    extractedBytes: number;
+    totalBytes: number;
+    outputPath: string;
+};
+type ExtractionProgressListener = (event: ExtractionProgressEvent) => void;
+declare function extractArchives(inputPath: string, outputPath?: string, onProgress?: ExtractionProgressListener): Promise<ExtractionSummary>;
 
 type FieldDefinition = {
     sourceLabel: string;
@@ -288,299 +357,48 @@ type ImportProgressEvent = {
     totalRows: number;
     committedBatches: number;
     totalBatches: number;
-    quarantinedRows: number;
-};
-type ImportProgressListener = (event: ImportProgressEvent) => void;
-type ImportOptions = {
-    dbUrl?: string;
-    dataset?: ImportDatasetType | undefined;
-    batchSize?: number | undefined;
-    loadBatchSize?: number | undefined;
-    materializeBatchSize?: number | undefined;
-    verboseProgress?: boolean | undefined;
-    onProgress?: ImportProgressListener | undefined;
-};
-type ImportExecutionMode = "full" | "load" | "materialize";
-type ImportSummary = {
-    executionMode: ImportExecutionMode;
-    inputPath: string;
-    validatedPath: string;
-    targetDatabase: string;
-    importPlanId: number | null;
-    reusedImportPlan: boolean;
-    importedDatasets: ImportDatasetType[];
-    importedFiles: number;
-    processedRows: number;
-    plannedRows: number;
-    committedBatches: number;
-    plannedBatches: number;
-    quarantinedRows: number;
-    resumedFiles: number;
-    skippedCompletedFiles: number;
-    datasetSummaries: Array<{
-        dataset: ImportDatasetType;
-        files: number;
-        rows: number;
-    }>;
-    performance: ImportPerformanceSummary;
-    warnings: string[];
-    progressLogPath: string;
-};
-
-type DatabaseCleanupScope = "staging" | "materialized" | "checkpoints" | "plans";
-type CheckpointCleanupPhase = "load" | "materialization" | "all";
-type DatabaseCleanupSummary = {
-    scope: DatabaseCleanupScope;
-    targetDatabase: string;
-    dataset?: ImportDatasetType | undefined;
-    phase?: CheckpointCleanupPhase | undefined;
-    validatedPath?: string | undefined;
-    planId?: number | undefined;
-    truncatedTables: string[];
-    deletedLoadCheckpoints: number;
-    deletedMaterializationCheckpoints: number;
-    deletedPlans: number;
-    notes: string[];
-};
-
-declare function resolveDatabaseUrl(override?: string): Promise<string>;
-declare function testDatabaseConnection(url: string): Promise<void>;
-declare function cleanupDatabaseStagingData(options?: {
-    dbUrl?: string;
-    dataset?: ImportDatasetType | undefined;
-    validatedPath?: string | undefined;
-}): Promise<DatabaseCleanupSummary>;
-declare function cleanupDatabaseMaterializedData(options?: {
-    dbUrl?: string;
-    dataset?: ImportDatasetType | undefined;
-}): Promise<DatabaseCleanupSummary>;
-declare function cleanupDatabaseCheckpointsData(options?: {
-    dbUrl?: string;
-    phase?: CheckpointCleanupPhase | undefined;
-    dataset?: ImportDatasetType | undefined;
-    validatedPath?: string | undefined;
-    planId?: number | undefined;
-}): Promise<DatabaseCleanupSummary>;
-declare function cleanupDatabasePlansData(options?: {
-    dbUrl?: string;
-    validatedPath?: string | undefined;
-    planId?: number | undefined;
-}): Promise<DatabaseCleanupSummary>;
-declare function resolveDbUrl(override?: string): Promise<string>;
-
-declare function getAllLayouts(): TableLayout[];
-declare function getLayoutSummary(): Array<Pick<TableLayout, "key" | "tableName" | "sourceName">>;
-
-declare function runDoctor(inputPath?: string, dbUrl?: string): Promise<string[]>;
-
-declare const SCHEMA_PROFILES: readonly ["full", "final", "staging"];
-type SchemaProfile = (typeof SCHEMA_PROFILES)[number];
-type SchemaGenerationOptions = {
-    profile?: SchemaProfile;
-};
-
-declare function generateSchemaSql(options?: SchemaGenerationOptions): string;
-declare function writeSchemaFile(outFile: string, options?: SchemaGenerationOptions): Promise<void>;
-declare function resolveSchemaProfile(profile?: string): SchemaProfile;
-
-type ValidationSummary = {
-    ok: boolean;
-    errors: string[];
-    warnings: string[];
-    inspected: InspectSummary;
-    validatedPath: string;
-    presentDatasets: DatasetType[];
-    missingDatasets: DatasetType[];
-    nextStep?: string | undefined;
-};
-declare function validateInputDirectory(inputPath: string): Promise<ValidationSummary>;
-
-type ExtractionEntry = {
-    archivePath: string;
-    archiveName: string;
-    destinationPath: string;
-    success: boolean;
-    sizeInBytes: number;
-    errorMessage?: string;
-};
-type ExtractionSummary = {
-    inputPath: string;
-    outputPath: string;
-    operatingSystem: string;
-    zipFilesFound: number;
-    extractedArchives: string[];
-    skippedEntries: string[];
-    failedArchives: string[];
-    totalArchiveBytes: number;
-    extractedArchiveBytes: number;
-    entries: ExtractionEntry[];
-};
-type ExtractionProgressEvent = {
-    kind: "start";
-    totalArchives: number;
-    totalBytes: number;
-    inputPath: string;
-    outputPath: string;
-} | {
-    kind: "archive-start";
-    currentArchiveName: string;
-    currentArchivePath: string;
-    archiveSizeInBytes: number;
-    archiveIndex: number;
-    totalArchives: number;
-    completedArchives: number;
-    extractedBytes: number;
-    totalBytes: number;
-} | {
-    kind: "archive-complete";
-    currentArchiveName: string;
-    currentArchivePath: string;
-    archiveSizeInBytes: number;
-    archiveIndex: number;
-    totalArchives: number;
-    completedArchives: number;
-    extractedBytes: number;
-    totalBytes: number;
-} | {
-    kind: "archive-failed";
-    currentArchiveName: string;
-    currentArchivePath: string;
-    archiveSizeInBytes: number;
-    archiveIndex: number;
-    totalArchives: number;
-    completedArchives: number;
-    extractedBytes: number;
-    totalBytes: number;
-    errorMessage: string;
-} | {
-    kind: "finish";
-    totalArchives: number;
-    completedArchives: number;
-    failedArchives: number;
-    extractedBytes: number;
-    totalBytes: number;
-    outputPath: string;
-};
-type ExtractionProgressListener = (event: ExtractionProgressEvent) => void;
-declare function extractArchives(inputPath: string, outputPath?: string, onProgress?: ExtractionProgressListener): Promise<ExtractionSummary>;
-
-type InputMode = "unzip" | "already-extracted";
-declare function resolveInputMode(options: {
-    unzip?: boolean;
-    alreadyExtracted?: boolean;
-}): InputMode;
-
-declare const LOG_LEVELS: readonly ["trace", "debug", "info", "warning", "error", "critical", "fatal"];
-type LogLevel = (typeof LOG_LEVELS)[number];
-declare const LOG_STATUSES: readonly ["success", "failure"];
-type LogStatus = (typeof LOG_STATUSES)[number];
-type LogRecord = Record<string, unknown>;
-type StructuredLogEntry = LogRecord & {
-    timestamp: string;
-    level: LogLevel;
-    severity: LogLevel;
-    event: string;
-    kind: string;
-    command?: string;
-    status?: LogStatus;
-    message?: string;
-};
-
-type WriteLogOptions = {
-    baseDirectory?: string;
-    event?: string;
-    level?: LogLevel;
-    status?: LogStatus;
-    message?: string;
-};
-declare function getUserAppDirectoryPath(): string;
-declare function getLogsDirectoryPath(baseDirectory?: string): string;
-declare function writeCommandLog(commandName: string, payload: unknown, baseDirectoryOrOptions?: string | WriteLogOptions, maybeOptions?: Omit<WriteLogOptions, "baseDirectory">): Promise<string>;
-declare function writeCommandFailureLog(commandName: string, error: unknown, input?: {
-    argv?: string[];
-    context?: Record<string, unknown>;
-    baseDirectory?: string;
-    fatal?: boolean;
-}): Promise<string>;
-declare function createJsonLinesLog(commandName: string, baseDirectory?: string): Promise<string>;
-declare function appendJsonLinesLog(filePath: string, payload: unknown, options?: Omit<WriteLogOptions, "baseDirectory" | "status"> & {
-    command?: string;
-    status?: LogStatus;
-}): Promise<void>;
-
-declare function importDataToDatabase(inputPath: string, options?: ImportOptions): Promise<ImportSummary>;
-declare function loadImportDataToStaging(inputPath: string, options?: ImportOptions): Promise<ImportSummary>;
-declare function materializeImportedData(inputPath: string, options?: ImportOptions): Promise<ImportSummary>;
-
-type QuarantineStatsFilters = {
-    dataset?: string;
-    category?: string;
-    stage?: string;
-    retryable?: boolean;
-    terminal?: boolean;
-};
-type QuarantineListFilters = QuarantineStatsFilters & {
-    limit: number;
-    afterId?: number;
-};
-type QuarantineStatsCount = {
-    key: string;
-    count: number;
-};
-type QuarantineStatsSummary = {
-    totalRows: number;
-    retryableRows: number;
-    terminalRows: number;
-    rowsByDataset: QuarantineStatsCount[];
-    rowsByCategory: QuarantineStatsCount[];
-    rowsByStage: QuarantineStatsCount[];
-    appliedFilters: QuarantineStatsFilters;
-};
-type QuarantineListRow = {
-    id: number;
-    dataset: string;
-    filePath: string;
-    rowNumber: number | null;
-    checkpointOffset: number | null;
-    errorCode: string | null;
-    errorCategory: string | null;
-    errorStage: string | null;
-    errorMessage: string;
-    retryCount: number;
-    canRetryLater: boolean;
-    createdAt: string;
-};
-type QuarantineListSummary = {
-    rows: QuarantineListRow[];
-    appliedFilters: QuarantineListFilters;
+    quarantinedRows: number;
 };
-type QuarantineRecord = {
-    id: number;
-    dataset: string;
-    filePath: string;
-    rowNumber: number | null;
-    checkpointOffset: number | null;
-    errorCode: string | null;
-    errorCategory: string | null;
-    errorStage: string | null;
-    errorMessage: string;
-    rawLine: string;
-    parsedPayload: Record<string, unknown> | null;
-    sanitizationsApplied: unknown[];
-    retryCount: number;
-    canRetryLater: boolean;
-    createdAt: string;
+type ImportProgressListener = (event: ImportProgressEvent) => void;
+type ImportOptions = {
+    dbUrl?: string;
+    dataset?: ImportDatasetType | undefined;
+    batchSize?: number | undefined;
+    loadBatchSize?: number | undefined;
+    materializeBatchSize?: number | undefined;
+    verboseProgress?: boolean | undefined;
+    onProgress?: ImportProgressListener | undefined;
+};
+type ImportExecutionMode = "full" | "load" | "materialize";
+type ImportSummary = {
+    executionMode: ImportExecutionMode;
+    inputPath: string;
+    validatedPath: string;
+    targetDatabase: string;
+    importPlanId: number | null;
+    reusedImportPlan: boolean;
+    importedDatasets: ImportDatasetType[];
+    importedFiles: number;
+    processedRows: number;
+    plannedRows: number;
+    committedBatches: number;
+    plannedBatches: number;
+    quarantinedRows: number;
+    resumedFiles: number;
+    skippedCompletedFiles: number;
+    datasetSummaries: Array<{
+        dataset: ImportDatasetType;
+        files: number;
+        rows: number;
+    }>;
+    performance: ImportPerformanceSummary;
+    warnings: string[];
+    progressLogPath: string;
 };
 
-declare function getQuarantineStats(filters: QuarantineStatsFilters & {
-    dbUrl?: string;
-}): Promise<QuarantineStatsSummary>;
-declare function listQuarantineRows(filters: QuarantineListFilters & {
-    dbUrl?: string;
-}): Promise<QuarantineListSummary>;
-declare function showQuarantineRow(id: number, options?: {
-    dbUrl?: string;
-}): Promise<QuarantineRecord>;
+declare function importDataToDatabase(inputPath: string, options?: ImportOptions): Promise<ImportSummary>;
+declare function loadImportDataToStaging(inputPath: string, options?: ImportOptions): Promise<ImportSummary>;
+declare function materializeImportedData(inputPath: string, options?: ImportOptions): Promise<ImportSummary>;
 
 type SanitizeSourceEncoding = "WIN1252" | "LATIN1" | "UTF8";
 
@@ -671,6 +489,18 @@ type SanitizeOptions = {
 
 declare function sanitizeInputDirectory(inputPath: string, options?: SanitizeOptions): Promise<SanitizeSummary>;
 
+type ValidationSummary = {
+    ok: boolean;
+    errors: string[];
+    warnings: string[];
+    inspected: InspectSummary;
+    validatedPath: string;
+    presentDatasets: DatasetType[];
+    missingDatasets: DatasetType[];
+    nextStep?: string | undefined;
+};
+declare function validateInputDirectory(inputPath: string): Promise<ValidationSummary>;
+
 type FederalRevenueReferenceMode = "latest" | "current" | "explicit";
 type FederalRevenueClientOptions = {
     baseUrl?: string | undefined;
@@ -917,7 +747,198 @@ type FederalRevenueLockFile = {
     startedAt: string;
 };
 
-declare const DEFAULT_FEDERAL_REVENUE_SHARE_TOKEN = "YggdBLfdninEJX9";
+type FederalRevenueConfigKey = "share-token" | "webdav-url" | "user-agent";
+type FederalRevenueEffectiveConfig = {
+    webdavUrl: string;
+    userAgent: string;
+    shareToken?: string | undefined;
+    configured: {
+        webdavUrl: boolean;
+        userAgent: boolean;
+        shareToken: boolean;
+    };
+};
+declare function readDatabaseConfig(): Promise<DatabaseConfig>;
+declare function writeDatabaseConfig(config: DatabaseConfig): Promise<void>;
+declare function assertPostgresUrl(url: string): void;
+declare function setDefaultDbUrl(url: string): Promise<void>;
+declare function resetDefaultDbUrl(): Promise<void>;
+declare function setFederalRevenueConfigValue(key: string, value: string): Promise<FederalRevenueEffectiveConfig>;
+declare function resetFederalRevenueConfig(key?: string | undefined): Promise<FederalRevenueEffectiveConfig>;
+declare function getFederalRevenueEffectiveConfig(config?: FederalRevenueConfig): FederalRevenueEffectiveConfig;
+declare function readFederalRevenueEffectiveConfig(): Promise<FederalRevenueEffectiveConfig>;
+declare function resolveFederalRevenueClientOptions(overrides?: FederalRevenueClientOptions): Promise<FederalRevenueClientOptions>;
+
+type DatabaseCleanupScope = "staging" | "materialized" | "checkpoints" | "plans";
+type CheckpointCleanupPhase = "load" | "materialization" | "all";
+type DatabaseCleanupSummary = {
+    scope: DatabaseCleanupScope;
+    targetDatabase: string;
+    dataset?: ImportDatasetType | undefined;
+    phase?: CheckpointCleanupPhase | undefined;
+    validatedPath?: string | undefined;
+    planId?: number | undefined;
+    truncatedTables: string[];
+    deletedLoadCheckpoints: number;
+    deletedMaterializationCheckpoints: number;
+    deletedPlans: number;
+    notes: string[];
+};
+
+declare function resolveDatabaseUrl(override?: string): Promise<string>;
+declare function testDatabaseConnection(url: string): Promise<void>;
+declare function cleanupDatabaseStagingData(options?: {
+    dbUrl?: string;
+    dataset?: ImportDatasetType | undefined;
+    validatedPath?: string | undefined;
+}): Promise<DatabaseCleanupSummary>;
+declare function cleanupDatabaseMaterializedData(options?: {
+    dbUrl?: string;
+    dataset?: ImportDatasetType | undefined;
+}): Promise<DatabaseCleanupSummary>;
+declare function cleanupDatabaseCheckpointsData(options?: {
+    dbUrl?: string;
+    phase?: CheckpointCleanupPhase | undefined;
+    dataset?: ImportDatasetType | undefined;
+    validatedPath?: string | undefined;
+    planId?: number | undefined;
+}): Promise<DatabaseCleanupSummary>;
+declare function cleanupDatabasePlansData(options?: {
+    dbUrl?: string;
+    validatedPath?: string | undefined;
+    planId?: number | undefined;
+}): Promise<DatabaseCleanupSummary>;
+declare function resolveDbUrl(override?: string): Promise<string>;
+
+declare function getAllLayouts(): TableLayout[];
+declare function getLayoutSummary(): Array<Pick<TableLayout, "key" | "tableName" | "sourceName">>;
+
+declare function runDoctor(inputPath?: string, dbUrl?: string): Promise<string[]>;
+
+declare const SCHEMA_PROFILES: readonly ["full", "final", "staging"];
+type SchemaProfile = (typeof SCHEMA_PROFILES)[number];
+type SchemaGenerationOptions = {
+    profile?: SchemaProfile;
+};
+
+declare function generateSchemaSql(options?: SchemaGenerationOptions): string;
+declare function writeSchemaFile(outFile: string, options?: SchemaGenerationOptions): Promise<void>;
+declare function resolveSchemaProfile(profile?: string): SchemaProfile;
+
+type InputMode = "unzip" | "already-extracted";
+declare function resolveInputMode(options: {
+    unzip?: boolean;
+    alreadyExtracted?: boolean;
+}): InputMode;
+
+declare const LOG_LEVELS: readonly ["trace", "debug", "info", "warning", "error", "critical", "fatal"];
+type LogLevel = (typeof LOG_LEVELS)[number];
+declare const LOG_STATUSES: readonly ["success", "failure"];
+type LogStatus = (typeof LOG_STATUSES)[number];
+type LogRecord = Record<string, unknown>;
+type StructuredLogEntry = LogRecord & {
+    timestamp: string;
+    level: LogLevel;
+    severity: LogLevel;
+    event: string;
+    kind: string;
+    command?: string;
+    status?: LogStatus;
+    message?: string;
+};
+
+type WriteLogOptions = {
+    baseDirectory?: string;
+    event?: string;
+    level?: LogLevel;
+    status?: LogStatus;
+    message?: string;
+};
+declare function getUserAppDirectoryPath(): string;
+declare function getLogsDirectoryPath(baseDirectory?: string): string;
+declare function writeCommandLog(commandName: string, payload: unknown, baseDirectoryOrOptions?: string | WriteLogOptions, maybeOptions?: Omit<WriteLogOptions, "baseDirectory">): Promise<string>;
+declare function writeCommandFailureLog(commandName: string, error: unknown, input?: {
+    argv?: string[];
+    context?: Record<string, unknown>;
+    baseDirectory?: string;
+    fatal?: boolean;
+}): Promise<string>;
+declare function createJsonLinesLog(commandName: string, baseDirectory?: string): Promise<string>;
+declare function appendJsonLinesLog(filePath: string, payload: unknown, options?: Omit<WriteLogOptions, "baseDirectory" | "status"> & {
+    command?: string;
+    status?: LogStatus;
+}): Promise<void>;
+
+type QuarantineStatsFilters = {
+    dataset?: string;
+    category?: string;
+    stage?: string;
+    retryable?: boolean;
+    terminal?: boolean;
+};
+type QuarantineListFilters = QuarantineStatsFilters & {
+    limit: number;
+    afterId?: number;
+};
+type QuarantineStatsCount = {
+    key: string;
+    count: number;
+};
+type QuarantineStatsSummary = {
+    totalRows: number;
+    retryableRows: number;
+    terminalRows: number;
+    rowsByDataset: QuarantineStatsCount[];
+    rowsByCategory: QuarantineStatsCount[];
+    rowsByStage: QuarantineStatsCount[];
+    appliedFilters: QuarantineStatsFilters;
+};
+type QuarantineListRow = {
+    id: number;
+    dataset: string;
+    filePath: string;
+    rowNumber: number | null;
+    checkpointOffset: number | null;
+    errorCode: string | null;
+    errorCategory: string | null;
+    errorStage: string | null;
+    errorMessage: string;
+    retryCount: number;
+    canRetryLater: boolean;
+    createdAt: string;
+};
+type QuarantineListSummary = {
+    rows: QuarantineListRow[];
+    appliedFilters: QuarantineListFilters;
+};
+type QuarantineRecord = {
+    id: number;
+    dataset: string;
+    filePath: string;
+    rowNumber: number | null;
+    checkpointOffset: number | null;
+    errorCode: string | null;
+    errorCategory: string | null;
+    errorStage: string | null;
+    errorMessage: string;
+    rawLine: string;
+    parsedPayload: Record<string, unknown> | null;
+    sanitizationsApplied: unknown[];
+    retryCount: number;
+    canRetryLater: boolean;
+    createdAt: string;
+};
+
+declare function getQuarantineStats(filters: QuarantineStatsFilters & {
+    dbUrl?: string;
+}): Promise<QuarantineStatsSummary>;
+declare function listQuarantineRows(filters: QuarantineListFilters & {
+    dbUrl?: string;
+}): Promise<QuarantineListSummary>;
+declare function showQuarantineRow(id: number, options?: {
+    dbUrl?: string;
+}): Promise<QuarantineRecord>;
+
 declare const DEFAULT_FEDERAL_REVENUE_WEBDAV_URL = "https://arquivos.receitafederal.gov.br/public.php/webdav";
 declare const DEFAULT_FEDERAL_REVENUE_USER_AGENT = "cnpj-db-loader federal-revenue-client";
 declare function validateFederalRevenueReference(reference: string): void;
@@ -1052,6 +1073,14 @@ type PostgresDirectScriptDatasetSummary = {
     totalBytes: number;
     sourceFiles: string[];
 };
+type PostgresDirectTransactionMode = "single" | "phase" | "none";
+type PostgresDirectIncludeTarget = "domains" | "companies" | "establishments" | "partners" | "simples" | "secondary-cnaes" | "indexes" | "analyze";
+type PostgresDirectScriptStep = {
+    name: string;
+    file: string;
+    dependsOn: string[];
+    included: boolean;
+};
 type PostgresDirectScriptProgressEvent = {
     kind: "start";
     inputPath: string;
@@ -1060,6 +1089,10 @@ type PostgresDirectScriptProgressEvent = {
     totalFiles: number;
     datasets: ImportDatasetType[];
     sourceEncoding: string;
+    transactionMode: PostgresDirectTransactionMode;
+    include: PostgresDirectIncludeTarget[];
+    skipIndexes: boolean;
+    skipAnalyze: boolean;
 } | {
     kind: "file_registered";
     dataset: ImportDatasetType;
@@ -1080,6 +1113,10 @@ type PostgresDirectScriptOptions = {
     dataset?: ImportDatasetType | undefined;
     scriptName?: string | undefined;
     sourceEncoding?: string | undefined;
+    transactionMode?: PostgresDirectTransactionMode | undefined;
+    include?: PostgresDirectIncludeTarget[] | undefined;
+    skipIndexes?: boolean | undefined;
+    skipAnalyze?: boolean | undefined;
     onProgress?: PostgresDirectScriptProgressListener | undefined;
 };
 type PostgresDirectScriptSummary = {
@@ -1089,9 +1126,12 @@ type PostgresDirectScriptSummary = {
     scriptPath: string;
     manifestPath: string;
     sourceEncoding: string;
+    transactionMode: PostgresDirectTransactionMode;
     totalFiles: number;
     totalBytes: number;
     datasets: PostgresDirectScriptDatasetSummary[];
+    scriptFiles: string[];
+    steps: PostgresDirectScriptStep[];
     warnings: string[];
     nextStep?: string | undefined;
 };
@@ -1100,4 +1140,4 @@ declare function exportPostgresCsvDataset(inputPath: string, options?: PostgresC
 
 declare function generatePostgresDirectScript(inputPath: string, options?: PostgresDirectScriptOptions): Promise<PostgresDirectScriptSummary>;
 
-export { type AppConfig, type AppEnvironment, AppError, type CheckpointCleanupPhase, DEFAULT_FEDERAL_REVENUE_DOWNLOAD_ROOT, DEFAULT_FEDERAL_REVENUE_SHARE_TOKEN, DEFAULT_FEDERAL_REVENUE_USER_AGENT, DEFAULT_FEDERAL_REVENUE_WEBDAV_URL, type DatabaseCleanupSummary, type DatabaseConfig, type DatasetBlock, type DatasetType, type ExtractionEntry, type ExtractionProgressEvent, type ExtractionProgressListener, type ExtractionSummary, FEDERAL_REVENUE_CONTROL_DIR, FEDERAL_REVENUE_CONTROL_SCOPE, FEDERAL_REVENUE_MANIFEST_VERSION, type Failure, type FederalRevenueCheckOptions, type FederalRevenueCheckSummary, type FederalRevenueCleanMode, type FederalRevenueCleanOptions, type FederalRevenueCleanSummary, type FederalRevenueClientOptions, type FederalRevenueDownloadEntry, type FederalRevenueDownloadOptions, type FederalRevenueDownloadProgressEvent, type FederalRevenueDownloadProgressListener, type FederalRevenueDownloadStatus, type FederalRevenueDownloadSummary, type FederalRevenueFile, type FederalRevenueLocalFileStatus, type FederalRevenueLocalStatusEntry, type FederalRevenueLockFile, type FederalRevenueManifest, type FederalRevenueManifestFile, type FederalRevenueManifestLastCommand, type FederalRevenueManifestLastStatus, type FederalRevenueReference, type FederalRevenueReferenceMode, type FederalRevenueReferenceSelection, type FederalRevenueRetryOptions, type FederalRevenueStatusOptions, type FederalRevenueStatusSummary, type FederalRevenueSyncLockOptions, type FederalRevenueSyncOptions, type FederalRevenueSyncSummary, type FileInspection, type ImportCheckpointRecord, type ImportCheckpointStatus, type ImportDatasetPlan, type ImportDatasetType, type ImportFilePlan, type ImportOptions, type ImportPerformanceSummary, type ImportPhaseStatus, type ImportPlanRecord, type ImportProgressEvent, type ImportProgressListener, type ImportSchemaCapabilities, type ImportSummary, type InputDetectionMode, type InputMode, type InspectSummary, type LogLevel, type LogStatus, type PostgresCsvDatasetSummary, type PostgresCsvExportOptions, type PostgresCsvExportProgressEvent, type PostgresCsvExportProgressListener, type PostgresCsvExportSummary, type PostgresCsvFile, type PostgresDirectScriptDatasetSummary, type PostgresDirectScriptOptions, type PostgresDirectScriptProgressEvent, type PostgresDirectScriptProgressListener, type PostgresDirectScriptSummary, type PostgresDirectSourceFile, type QuarantineListFilters, type QuarantineListSummary, type QuarantineRecord, type QuarantineStatsFilters, type QuarantineStatsSummary, type Result, type SanitizeDatasetType, type SanitizeOptions, type SanitizePlan, type SanitizeProgressEvent, type SanitizeProgressListener, type SanitizeSourceEncoding, type SanitizeSummary, type SchemaGenerationOptions, type SchemaProfile, ServiceError, type StructuredLogEntry, type SupportedOs, ValidationError, type ValidationSummary, appendJsonLinesLog, assertPostgresUrl, buildFederalRevenueDownloadHeaders, buildFederalRevenueReferenceOutputPath, checkFederalRevenueDataset, cleanFederalRevenueDataset, cleanupDatabaseCheckpointsData, cleanupDatabaseMaterializedData, cleanupDatabasePlansData, cleanupDatabaseStagingData, createFederalRevenueManifest, createJsonLinesLog, defaultExtractedOutputPath, detectOs, downloadFederalRevenueDataset, ensureDirectory, evaluateFederalRevenueManifestFile, evaluateFederalRevenueManifestFiles, exportPostgresCsvDataset, extractArchives, finalizeFederalRevenueManifest, generatePostgresDirectScript, generateSchemaSql, getAllLayouts, getCurrentFederalRevenueReference, getFederalRevenueControlDirectory, getFederalRevenueManifestPath, getFederalRevenueStatus, getFederalRevenueSyncLockPath, getLayoutSummary, getLogsDirectoryPath, getQuarantineStats, getUserAppDirectoryPath, importDataToDatabase, inspectFiles, listFederalRevenueFiles, listFederalRevenueReferences, listQuarantineRows, loadImportDataToStaging, materializeImportedData, prettyJson, readDatabaseConfig, readFederalRevenueManifest, resetDefaultDbUrl, resolveDatabaseUrl, resolveDbUrl, resolveFederalRevenueReference, resolveInputMode, resolveSchemaProfile, retryFederalRevenueDataset, runDoctor, safeReadText, safeWriteText, sanitizeInputDirectory, setDefaultDbUrl, showQuarantineRow, syncFederalRevenueDataset, testDatabaseConnection, toTitleCase, updateFederalRevenueManifestFile, validateFederalRevenueReference, validateInputDirectory, withFederalRevenueSyncLock, writeCommandFailureLog, writeCommandLog, writeDatabaseConfig, writeFederalRevenueManifest, writeSchemaFile };
+export { type AppConfig, type AppEnvironment, AppError, type CheckpointCleanupPhase, DEFAULT_FEDERAL_REVENUE_DOWNLOAD_ROOT, DEFAULT_FEDERAL_REVENUE_USER_AGENT, DEFAULT_FEDERAL_REVENUE_WEBDAV_URL, type DatabaseCleanupSummary, type DatabaseConfig, type DatasetBlock, type DatasetType, type ExtractionEntry, type ExtractionProgressEvent, type ExtractionProgressListener, type ExtractionSummary, FEDERAL_REVENUE_CONTROL_DIR, FEDERAL_REVENUE_CONTROL_SCOPE, FEDERAL_REVENUE_MANIFEST_VERSION, type Failure, type FederalRevenueCheckOptions, type FederalRevenueCheckSummary, type FederalRevenueCleanMode, type FederalRevenueCleanOptions, type FederalRevenueCleanSummary, type FederalRevenueClientOptions, type FederalRevenueConfig, type FederalRevenueConfigKey, type FederalRevenueDownloadEntry, type FederalRevenueDownloadOptions, type FederalRevenueDownloadProgressEvent, type FederalRevenueDownloadProgressListener, type FederalRevenueDownloadStatus, type FederalRevenueDownloadSummary, type FederalRevenueEffectiveConfig, type FederalRevenueFile, type FederalRevenueLocalFileStatus, type FederalRevenueLocalStatusEntry, type FederalRevenueLockFile, type FederalRevenueManifest, type FederalRevenueManifestFile, type FederalRevenueManifestLastCommand, type FederalRevenueManifestLastStatus, type FederalRevenueReference, type FederalRevenueReferenceMode, type FederalRevenueReferenceSelection, type FederalRevenueRetryOptions, type FederalRevenueStatusOptions, type FederalRevenueStatusSummary, type FederalRevenueSyncLockOptions, type FederalRevenueSyncOptions, type FederalRevenueSyncSummary, type FileInspection, type ImportCheckpointRecord, type ImportCheckpointStatus, type ImportDatasetPlan, type ImportDatasetType, type ImportFilePlan, type ImportOptions, type ImportPerformanceSummary, type ImportPhaseStatus, type ImportPlanRecord, type ImportProgressEvent, type ImportProgressListener, type ImportSchemaCapabilities, type ImportSummary, type InputDetectionMode, type InputMode, type InspectSummary, type LogLevel, type LogStatus, type PostgresCsvDatasetSummary, type PostgresCsvExportOptions, type PostgresCsvExportProgressEvent, type PostgresCsvExportProgressListener, type PostgresCsvExportSummary, type PostgresCsvFile, type PostgresDirectIncludeTarget, type PostgresDirectScriptDatasetSummary, type PostgresDirectScriptOptions, type PostgresDirectScriptProgressEvent, type PostgresDirectScriptProgressListener, type PostgresDirectScriptStep, type PostgresDirectScriptSummary, type PostgresDirectSourceFile, type PostgresDirectTransactionMode, type QuarantineListFilters, type QuarantineListSummary, type QuarantineRecord, type QuarantineStatsFilters, type QuarantineStatsSummary, type Result, type SanitizeDatasetType, type SanitizeOptions, type SanitizePlan, type SanitizeProgressEvent, type SanitizeProgressListener, type SanitizeSourceEncoding, type SanitizeSummary, type SchemaGenerationOptions, type SchemaProfile, ServiceError, type StructuredLogEntry, type SupportedOs, ValidationError, type ValidationSummary, appendJsonLinesLog, assertPostgresUrl, buildFederalRevenueDownloadHeaders, buildFederalRevenueReferenceOutputPath, checkFederalRevenueDataset, cleanFederalRevenueDataset, cleanupDatabaseCheckpointsData, cleanupDatabaseMaterializedData, cleanupDatabasePlansData, cleanupDatabaseStagingData, createFederalRevenueManifest, createJsonLinesLog, defaultExtractedOutputPath, detectOs, downloadFederalRevenueDataset, ensureDirectory, evaluateFederalRevenueManifestFile, evaluateFederalRevenueManifestFiles, exportPostgresCsvDataset, extractArchives, finalizeFederalRevenueManifest, generatePostgresDirectScript, generateSchemaSql, getAllLayouts, getCurrentFederalRevenueReference, getFederalRevenueControlDirectory, getFederalRevenueEffectiveConfig, getFederalRevenueManifestPath, getFederalRevenueStatus, getFederalRevenueSyncLockPath, getLayoutSummary, getLogsDirectoryPath, getQuarantineStats, getUserAppDirectoryPath, importDataToDatabase, inspectFiles, listFederalRevenueFiles, listFederalRevenueReferences, listQuarantineRows, loadImportDataToStaging, materializeImportedData, prettyJson, readDatabaseConfig, readFederalRevenueEffectiveConfig, readFederalRevenueManifest, resetDefaultDbUrl, resetFederalRevenueConfig, resolveDatabaseUrl, resolveDbUrl, resolveFederalRevenueClientOptions, resolveFederalRevenueReference, resolveInputMode, resolveSchemaProfile, retryFederalRevenueDataset, runDoctor, safeReadText, safeWriteText, sanitizeInputDirectory, setDefaultDbUrl, setFederalRevenueConfigValue, showQuarantineRow, syncFederalRevenueDataset, testDatabaseConnection, toTitleCase, updateFederalRevenueManifestFile, validateFederalRevenueReference, validateInputDirectory, withFederalRevenueSyncLock, writeCommandFailureLog, writeCommandLog, writeDatabaseConfig, writeFederalRevenueManifest, writeSchemaFile };