db4ai 0.1.0

package/dist/cli/seed/index.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Module 15: Seed Runner
+ *
+ * Executes static and generated seeds with progress tracking.
+ *
+ * Two seed types:
+ * - Static (Seed()): Load from API or inline data, apply transforms, mark readOnly
+ * - Generated (Generate()): Use LLM, apply constraints/variations, handle cascading
+ */
+export interface SeedProgress {
+    seedName: string;
+    type: string;
+    phase: 'static' | 'generated';
+    current: number;
+    total: number;
+    percentage: number;
+    rate?: number;
+    eta?: number;
+}
+export interface SeedResult {
+    success: boolean;
+    created: number;
+    skipped: number;
+    errors: SeedErrorInfo[];
+    partial: boolean;
+    duration: number;
+    resumeToken?: string;
+    dryRun?: boolean;
+    wouldCreate?: Record<string, number>;
+    executionOrder?: string[];
+}
+export interface SeedErrorInfo {
+    message: string;
+    position?: number;
+    entity?: unknown;
+}
+export declare class SeedError extends Error {
+    seedName?: string;
+    type?: string;
+    position?: number;
+    constructor(message: string, context?: {
+        seedName?: string;
+        type?: string;
+        position?: number;
+    });
+}
+interface BaseSeedConfig {
+    type: string;
+    readOnly?: boolean;
+    concurrency?: number;
+}
+export interface SeedConfig extends BaseSeedConfig {
+    kind: 'static';
+    data?: Array<Record<string, unknown>>;
+    source?: string;
+    headers?: Record<string, string>;
+    dataPath?: string;
+    nextPath?: string;
+    retries?: number;
+    transform?: (data: unknown) => unknown[] | Promise<unknown[]>;
+    fieldMapping?: Record<string, string>;
+}
+export interface GenerateConfig extends BaseSeedConfig {
+    kind: 'generated';
+    count?: number;
+    ids?: string[];
+    prompt: string;
+    constraints?: Record<string, unknown>;
+    variations?: Array<{
+        weight?: number;
+        [key: string]: unknown;
+    }>;
+    cascade?: boolean;
+    cascadeDepth?: number;
+    cascadeReuse?: boolean;
+}
+interface SeedInput {
+    type: string;
+    data?: Array<Record<string, unknown>>;
+    source?: string;
+    headers?: Record<string, string>;
+    dataPath?: string;
+    nextPath?: string;
+    retries?: number;
+    transform?: (data: unknown) => unknown[] | Promise<unknown[]>;
+    fieldMapping?: Record<string, string>;
+    readOnly?: boolean;
+    concurrency?: number;
+}
+interface GenerateInput {
+    type: string;
+    count?: number;
+    ids?: string[];
+    prompt: string;
+    constraints?: Record<string, unknown>;
+    variations?: Array<{
+        weight?: number;
+        [key: string]: unknown;
+    }>;
+    cascade?: boolean;
+    cascadeDepth?: number;
+    cascadeReuse?: boolean;
+    readOnly?: boolean;
+    concurrency?: number;
+}
+export declare function Seed(input: SeedInput): SeedConfig;
+export declare function Generate(input: GenerateInput): GenerateConfig;
+interface DB {
+    schema: Record<string, unknown>;
+    get: (type: string, id: string) => Promise<unknown>;
+    create: (type: string, data: unknown) => Promise<unknown>;
+    list: (type: string) => Promise<unknown[]>;
+    generate: (config: {
+        type: string;
+        id?: string;
+        prompt?: string;
+        constraints?: Record<string, unknown>;
+        [key: string]: unknown;
+    }) => Promise<unknown>;
+    clear: (type: string) => Promise<void>;
+}
+interface Storage {
+    get: (key: string) => Promise<string | undefined>;
+    set: (key: string, value: string) => Promise<void>;
+}
+interface RunnerOptions {
+    seeds: Record<string, SeedConfig | GenerateConfig>;
+    onProgress?: (progress: SeedProgress) => void;
+    onCheckpoint?: (position: number) => void;
+    onWarning?: (message: string) => void;
+    onEntity?: (type: string, data: unknown) => void;
+    beforeSeed?: (seedName: string, config: SeedConfig | GenerateConfig) => SeedConfig | GenerateConfig | null | undefined | void;
+    afterSeed?: (seedName: string, result: SeedResult) => void;
+    continueOnError?: boolean;
+    timeout?: number;
+    order?: string[];
+    validateSchema?: boolean | 'warn';
+    concurrency?: number;
+    dryRun?: boolean;
+    skipExisting?: boolean;
+    storage?: Storage;
+    persist?: boolean;
+}
+interface RunOptions {
+    resume?: string;
+    cascade?: boolean;
+}
+interface ResetOptions {
+    cascade?: boolean;
+    preserveReadOnly?: boolean;
+}
+export interface SeedRunner {
+    run: (seedName: string, options?: RunOptions) => Promise<SeedResult>;
+    runAll: () => Promise<SeedResult>;
+    reset: (seedName: string, options?: ResetOptions) => Promise<SeedResult>;
+    resetAll: (options?: ResetOptions) => Promise<SeedResult>;
+}
+export declare function createSeedRunner(db: DB, options: RunnerOptions): SeedRunner;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/seed/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../cli/seed/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,QAAQ,GAAG,WAAW,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;gBAGf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;CAUpE;AAGD,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAGD,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,IAAI,EAAE,QAAQ,CAAA;IACd,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACrC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtC;AAGD,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAA;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAGD,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACrC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAA;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAMD,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,CAkBjD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAwB7D;AAMD,UAAU,EAAE;IACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACnD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACzD,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAC1C,QAAQ,EAAE,CAAC,MAAM,EAAE;QACjB,IAAI,EAAE,MAAM,CAAA;QACZ,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KACvB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACtB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACvC;AAMD,UAAU,OAAO;IACf,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACjD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACnD;AAMD,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CAAC,CAAA;IAClD,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAA;IAC7C,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAChD,UAAU,CAAC,EAAE,CACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,GAAG,cAAc,KAChC,UAAU,GAAG,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAA;IAC1D,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,CAAA;IAC1D,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,UAAU,UAAU;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,UAAU,YAAY;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAMD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACpE,MAAM,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAA;IACjC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACxE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;CAC1D;AAMD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,UAAU,CAs2B3E"}