@codemarc/blt 1.6.5 → 1.8.0

package/dist/lib/data-pull-manifest.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Manifest for `blt data pull` → rows shaped like instance YAML
+ * (function / procedure / table + `{ row }[]`).
+ */
+import type { Client } from "pg";
+export type SqlTargetType = "function" | "procedure" | "table";
+export type SnapshotManifestAsset = {
+    id: string;
+    file: string;
+    /** Target name: function name, procedure name, or table name */
+    function: string;
+    sqlType?: SqlTargetType;
+    rowCount: number;
+};
+/** Written next to snapshot JSON/YAML assets */
+export type SnapshotManifest = {
+    instance: string;
+    pulledAt: string;
+    sourceHostRedacted: string;
+    pgVersion: string;
+    schemaVersion?: string;
+    assets: SnapshotManifestAsset[];
+};
+/** One exported asset file ({stem}.{json|yaml}) */
+export type SnapshotAssetFile = {
+    assetId: string;
+    function: string;
+    sqlType?: SqlTargetType;
+    primaryKey?: string[];
+    /** Columns to omit from `ON CONFLICT DO UPDATE SET` (e.g. keep target `id` when upserting on `provider_type`). */
+    conflictUpdateExclude?: string[];
+    /**
+     * SQL predicate for partial unique indexes, e.g. `location_id IS NULL`.
+     * Emitted as `ON CONFLICT (…) WHERE …`.
+     */
+    conflictWhere?: string;
+    /** `information_schema.columns.udt_name` per column (extra `public.*` dumps). */
+    columnUdts?: Record<string, string>;
+    rows: {
+        row: Record<string, unknown>;
+    }[];
+};
+export type PullContext = {
+    includeUsers: boolean;
+    includeSecrets: boolean;
+};
+/** One logical partition (one file on disk) */
+export type PullPartition = {
+    assetId: string;
+    snapshotStem: string;
+    rows: {
+        row: Record<string, unknown>;
+    }[];
+    /** For generic `public.*` table dumps: UPSERT target (omit when no PK). */
+    primaryKey?: string[];
+    conflictUpdateExclude?: string[];
+    /** Partial unique index predicate (see `SnapshotAssetFile.conflictWhere`). */
+    conflictWhere?: string;
+    columnUdts?: Record<string, string>;
+};
+/** Physical `public` tables already exported by {@link FULL_PULL_SEQUENCE}. */
+export declare const MANIFEST_COVERED_PUBLIC_TABLES: readonly string[];
+export type PullManifestEntry = {
+    readonly targetName: string;
+    readonly sqlType: SqlTargetType;
+    /**
+     * When true, `blt data apply` truncates `truncateTable` (with other function-mode
+     * targets) before replay. Only used when sqlType === "function".
+     */
+    readonly needsTruncate: boolean;
+    readonly truncateTable?: string;
+    readonly skip?: (ctx: PullContext) => boolean;
+    readonly fetchPartitions: (client: Client, ctx: PullContext) => Promise<PullPartition[]>;
+};
+export declare function jsonProps(props: unknown): Record<string, unknown>;
+/** FK-safe TRUNCATE order before replaying function-mode snapshot assets (child → parent) */
+export declare const APPLY_TRUNCATE_TABLES: readonly string[];
+/** Map snapshot function target → table truncated before replay */
+export declare const SNAPSHOT_FUNCTION_TRUNCATE_TABLE: Readonly<Record<string, string>>;
+export declare function sortManifestAssetsForApply<T extends {
+    function: string;
+}>(assets: readonly T[]): T[];
+/**
+ * Deletes existing rows for function-mode + selected table-mode snapshot targets (child-before-parent).
+ * Omits tables not referenced by any manifest asset so older menu-only snapshots
+ * do not truncate e.g. `taxes`.
+ */
+export declare function getApplyTruncateSqlForManifest(assets: SnapshotManifestAsset[]): string;
+/** Truncate all function-mode tables (full snapshot). */
+export declare function getApplyTruncateSql(): string;
+/** Ordered pulls: FK-safe apply order (see plan). */
+export declare function getFullPullManifest(): readonly PullManifestEntry[];
+/** @deprecated Use getFullPullManifest */
+export declare function getMenuGraphPullManifest(): readonly PullManifestEntry[];
+/** @deprecated Use getApplyTruncateSql */
+export declare function getMenuGraphApplyTruncateSql(): string;
+//# sourceMappingURL=data-pull-manifest.d.ts.map

package/dist/lib/data-pull-manifest.d.ts.map

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