@nyrra/prismantix-cli 0.0.1 → 0.0.2-next.0

package/dist/commands/records/generate.js

@@ -0,0 +1,56 @@
+import { randomUUID } from "node:crypto";
+import { Command, Flags } from "@oclif/core";
+import { Effect } from "effect";
+import { apiFlags, failCommand, printResult, requireValue, runApiEffect, validatePositiveInteger, } from "../../command-support.js";
+import { DEFAULT_GENERATION_TIMEOUT_MS, DEFAULT_POLL_INTERVAL_MS } from "../../constants.js";
+import { createRecordGeneration, waitForRecordGeneration } from "../../generation.js";
+export default class RecordsGenerate extends Command {
+    static description = "Append a complete ontology-sized default record set for a client.";
+    static flags = {
+        ...apiFlags,
+        client: Flags.string({ description: "Client ID.", required: true }),
+        ontology: Flags.string({ description: "Registered ontology ID.", required: true }),
+        "poll-interval": Flags.integer({
+            default: DEFAULT_POLL_INTERVAL_MS,
+            description: "Polling interval in milliseconds.",
+        }),
+        timeout: Flags.integer({
+            default: DEFAULT_GENERATION_TIMEOUT_MS,
+            description: "Polling timeout in milliseconds (default: 30 minutes).",
+        }),
+        wait: Flags.boolean({
+            allowNo: true,
+            default: true,
+            description: "Wait for the operation to reach a terminal state.",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(RecordsGenerate);
+        try {
+            validatePositiveInteger(flags["poll-interval"], "--poll-interval");
+            validatePositiveInteger(flags.timeout, "--timeout");
+            const clientId = requireValue(flags.client, "--client");
+            const ontologyId = requireValue(flags.ontology, "--ontology");
+            const idempotencyKey = randomUUID();
+            const printOperationId = (operationId) => this.logToStderr(operationId);
+            const result = await runApiEffect(Effect.gen(function* () {
+                const created = yield* createRecordGeneration(clientId, ontologyId, idempotencyKey);
+                yield* Effect.sync(() => printOperationId(created.operationId));
+                if (!flags.wait)
+                    return created;
+                return yield* waitForRecordGeneration(created, {
+                    pollIntervalMs: flags["poll-interval"],
+                    timeoutMs: flags.timeout,
+                });
+            }), flags["api-base"]);
+            printResult(this, result, flags.json, () => {
+                this.log(`Record generation ${result.operationId}: ${result.status}`);
+                this.log(`Client: ${result.clientId}`);
+                this.log(`Ontology: ${result.ontologyId}`);
+            });
+        }
+        catch (error) {
+            failCommand(this, error, flags.json);
+        }
+    }
+}

package/dist/commands/{download.d.ts → records/pull.d.ts}

@@ -1,22 +1,16 @@
 import { Command } from "@oclif/core";
-export default class Download extends Command {
+export default class RecordsPull extends Command {
     static description: string;
-    static examples: string[];
     static flags: {
-        "api-base": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        client: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        "export-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        client: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         "poll-interval": import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         table: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        tables: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
-        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "api-base": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
-    private fail;
-    private printProgress;
     private printSummary;
 }
-//# sourceMappingURL=download.d.ts.map
+//# sourceMappingURL=pull.d.ts.map

package/dist/commands/records/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../../src/commands/records/pull.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAkB7C,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,OAAO;IAC/C,OAAgB,WAAW,SAA6D;IACxF,OAAgB,KAAK;;;;;;;;MAgBnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBjC,OAAO,CAAC,YAAY;CAMpB"}

package/dist/commands/records/pull.js

@@ -0,0 +1,59 @@
+import { Command, Flags } from "@oclif/core";
+import { Match } from "effect";
+import { makePrismantixApiClientLayer } from "../../api.js";
+import { apiFlags, failCommand, printResult, requireValue, validatePositiveInteger, } from "../../command-support.js";
+import { DEFAULT_POLL_INTERVAL_MS, DEFAULT_PULL_TIMEOUT_MS } from "../../constants.js";
+import { runCliEffect } from "../../runtime.js";
+import { runDownloadWorkflowEffect, } from "../../workflow.js";
+export default class RecordsPull extends Command {
+    static description = "Pull a client CSV-bundle export into a local directory.";
+    static flags = {
+        ...apiFlags,
+        client: Flags.string({ description: "Client ID to export.", required: true }),
+        output: Flags.string({ description: "Output directory." }),
+        "poll-interval": Flags.integer({
+            default: DEFAULT_POLL_INTERVAL_MS,
+            description: "Polling interval in milliseconds.",
+        }),
+        table: Flags.string({
+            description: "Table to pull; repeat for multiple tables.",
+            multiple: true,
+        }),
+        timeout: Flags.integer({
+            default: DEFAULT_PULL_TIMEOUT_MS,
+            description: "Polling timeout in milliseconds.",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(RecordsPull);
+        try {
+            validatePositiveInteger(flags["poll-interval"], "--poll-interval");
+            validatePositiveInteger(flags.timeout, "--timeout");
+            const clientId = requireValue(flags.client, "--client");
+            const result = await runCliEffect(runDownloadWorkflowEffect({
+                clientId,
+                outputDir: flags.output,
+                pollIntervalMs: flags["poll-interval"],
+                tables: flags.table,
+                timeoutMs: flags.timeout,
+            }, { onEvent: (event) => this.logToStderr(progressMessage(event)) }), makePrismantixApiClientLayer({ apiBaseUrl: flags["api-base"] }));
+            printResult(this, result, flags.json, () => this.printSummary(result));
+        }
+        catch (error) {
+            failCommand(this, error, flags.json);
+        }
+    }
+    printSummary(result) {
+        this.log(`Pulled PrismantiX export ${result.exportId}`);
+        this.log(`Output: ${result.outputDir}`);
+        this.log(`Manifest: ${result.manifestPath}`);
+        this.log(`Files: ${result.files.length}`);
+    }
+}
+const progressMessage = Match.type().pipe(Match.discriminatorsExhaustive("type")({
+    created: (event) => `Queued export ${event.exportId} for ${event.clientId}.`,
+    "download-complete": (event) => `Pulled ${event.file.tableName}.`,
+    "download-start": (event) => `Pulling ${event.file.tableName}...`,
+    manifest: (event) => `Manifest ready: ${event.manifest.files.length} file(s).`,
+    poll: (event) => `Export ${event.status.exportId}: ${event.status.status}.`,
+}));

package/dist/commands/records/status.d.ts

@@ -0,0 +1,13 @@
+import { Command } from "@oclif/core";
+export default class RecordsStatus extends Command {
+    static args: {
+        operationId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static flags: {
+        "api-base": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/records/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/records/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAE,MAAM,aAAa,CAAC;AAU5C,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,OAAO;IACjD,OAAgB,IAAI;;MAAoD;IACxE,OAAgB,WAAW,SAAyC;IACpE,OAAgB,KAAK;;;MAAY;IAEpB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAajC"}

package/dist/commands/records/status.js

@@ -0,0 +1,22 @@
+import { Args, Command } from "@oclif/core";
+import { apiFlags, failCommand, printResult, requireValue, runApiEffect, } from "../../command-support.js";
+import { getRecordGeneration } from "../../generation.js";
+export default class RecordsStatus extends Command {
+    static args = { operationId: Args.string({ required: true }) };
+    static description = "Show a record-generation operation.";
+    static flags = apiFlags;
+    async run() {
+        const { args, flags } = await this.parse(RecordsStatus);
+        try {
+            const operationId = requireValue(args.operationId, "operation-id");
+            const result = await runApiEffect(getRecordGeneration(operationId), flags["api-base"]);
+            printResult(this, result, flags.json, () => {
+                this.log(`Record generation ${result.operationId}: ${result.status}`);
+                this.log(`Persisted: ${result.totals.persistedCount}/${result.totals.requestedCount}`);
+            });
+        }
+        catch (error) {
+            failCommand(this, error, flags.json);
+        }
+    }
+}

package/dist/constants.d.ts

@@ -1,5 +1,6 @@
 export declare const DEFAULT_API_BASE_URL = "https://api.prismantix.com";
 export declare const DEFAULT_OUTPUT_ROOT = "prismantix-exports";
 export declare const DEFAULT_POLL_INTERVAL_MS = 1000;
-export declare const DEFAULT_TIMEOUT_MS = 120000;
+export declare const DEFAULT_PULL_TIMEOUT_MS = 120000;
+export declare const DEFAULT_GENERATION_TIMEOUT_MS: number;
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,+BAA+B,CAAC;AACjE,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AACxD,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,kBAAkB,SAAU,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,+BAA+B,CAAC;AACjE,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AACxD,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,uBAAuB,SAAU,CAAC;AAC/C,eAAO,MAAM,6BAA6B,QAAiB,CAAC"}

package/dist/constants.js

@@ -1,4 +1,5 @@
 export const DEFAULT_API_BASE_URL = "https://api.prismantix.com";
 export const DEFAULT_OUTPUT_ROOT = "prismantix-exports";
 export const DEFAULT_POLL_INTERVAL_MS = 1000;
-export const DEFAULT_TIMEOUT_MS = 120_000;
+export const DEFAULT_PULL_TIMEOUT_MS = 120_000;
+export const DEFAULT_GENERATION_TIMEOUT_MS = 30 * 60 * 1000;

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAI;CAMvD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,gBAU5C"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAQA,qBAAa,YAAa,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAI;CAMvD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,gBA8B5C"}

package/dist/errors.js

@@ -1,3 +1,4 @@
+import { Predicate } from "effect";
 export class CliUserError extends Error {
     code;
     exitCode;
@@ -12,8 +13,46 @@ export function toCliUserError(error) {
     if (error instanceof CliUserError) {
         return error;
     }
+    if (isCodedError(error)) {
+        return new CliUserError(error.code, error.message, error.exitCode);
+    }
+    if (hasTag(error, "ApiConfigurationError")) {
+        return new CliUserError("missing_api_key", error.message);
+    }
+    if (hasTag(error, "ApiHttpError")) {
+        return new CliUserError(codeForStatus(error.status), error.message);
+    }
+    if (hasTag(error, "ApiDecodeError")) {
+        return new CliUserError("unexpected_error", error.message);
+    }
+    if (hasTag(error, "ApiTransportError")) {
+        return new CliUserError("unexpected_error", error.message);
+    }
     if (error instanceof Error) {
         return new CliUserError("unexpected_error", error.message);
     }
     return new CliUserError("unexpected_error", String(error));
 }
+function hasTag(error, tag) {
+    return Predicate.hasProperty(error, "_tag") && error._tag === tag;
+}
+function codeForStatus(status) {
+    if (status === 401)
+        return "unauthorized";
+    if (status === 403)
+        return "forbidden";
+    if (status === 404)
+        return "not_found";
+    if (status === 409)
+        return "conflict";
+    if (status === 429)
+        return "rate_limited";
+    return "api_error";
+}
+function isCodedError(error) {
+    return (error instanceof Error &&
+        Predicate.hasProperty(error, "code") &&
+        typeof error.code === "string" &&
+        Predicate.hasProperty(error, "exitCode") &&
+        typeof error.exitCode === "number");
+}

package/dist/generation.d.ts

@@ -0,0 +1,13 @@
+import { Effect } from "effect";
+import { type RecordGenerationCreated, type RecordGenerationStatus, PrismantixApiClient } from "./api.js";
+export interface WaitForGenerationOptions {
+    readonly now?: () => number;
+    readonly pollIntervalMs: number;
+    readonly sleep?: (milliseconds: number) => Promise<void>;
+    readonly timeoutMs: number;
+}
+export declare function createRecordGeneration(clientId: string, ontologyId: string, idempotencyKey: string): Effect.Effect<RecordGenerationCreated, import("./api.js").ApiConfigurationError | import("./api.js").ApiHttpError | import("./api.js").ApiTransportError | import("./api.js").ApiDecodeError, PrismantixApiClient>;
+export declare function getRecordGeneration(operationId: string): Effect.Effect<RecordGenerationStatus, import("./api.js").ApiConfigurationError | import("./api.js").ApiHttpError | import("./api.js").ApiTransportError | import("./api.js").ApiDecodeError, PrismantixApiClient>;
+export declare function cancelRecordGeneration(operationId: string): Effect.Effect<RecordGenerationStatus, import("./api.js").ApiConfigurationError | import("./api.js").ApiHttpError | import("./api.js").ApiTransportError | import("./api.js").ApiDecodeError, PrismantixApiClient>;
+export declare function waitForRecordGeneration(created: RecordGenerationCreated, options: WaitForGenerationOptions): Effect.Effect<RecordGenerationStatus, unknown, PrismantixApiClient>;
+//# sourceMappingURL=generation.d.ts.map

package/dist/generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation.d.ts","sourceRoot":"","sources":["../src/generation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,MAAM,EAAgB,MAAM,QAAQ,CAAC;AACnE,OAAO,EACN,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,mBAAmB,EACnB,MAAM,UAAU,CAAC;AAKlB,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,sNAMtB;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,qNAKtD;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,qNAKzD;AAED,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,wBAAwB,uEASjC"}

package/dist/generation.js

@@ -0,0 +1,77 @@
+import { Cause, Effect, Exit, Option } from "effect";
+import { PrismantixApiClient, } from "./api.js";
+import { CliUserError } from "./errors.js";
+export function createRecordGeneration(clientId, ontologyId, idempotencyKey) {
+    return Effect.gen(function* () {
+        const api = yield* PrismantixApiClient;
+        return yield* api.createRecordGeneration(clientId, ontologyId, idempotencyKey);
+    });
+}
+export function getRecordGeneration(operationId) {
+    return Effect.gen(function* () {
+        const api = yield* PrismantixApiClient;
+        return yield* api.getRecordGeneration(operationId);
+    });
+}
+export function cancelRecordGeneration(operationId) {
+    return Effect.gen(function* () {
+        const api = yield* PrismantixApiClient;
+        return yield* api.cancelRecordGeneration(operationId);
+    });
+}
+export function waitForRecordGeneration(created, options) {
+    return Effect.gen(function* () {
+        const api = yield* PrismantixApiClient;
+        return yield* Effect.tryPromise({
+            try: () => waitForTerminalStatus(api, created.operationId, options),
+            catch: (error) => error,
+        });
+    });
+}
+async function waitForTerminalStatus(api, operationId, options) {
+    const now = resolveNow(options.now);
+    const sleep = resolveSleep(options.sleep);
+    const startedAt = now();
+    for (;;) {
+        const status = await runClientEffect(api.getRecordGeneration(operationId));
+        if (isTerminal(status)) {
+            return requireCompletedGeneration(status);
+        }
+        throwIfTimedOut(operationId, now() - startedAt, options.timeoutMs);
+        await sleep(options.pollIntervalMs);
+    }
+}
+function resolveNow(now) {
+    return now ?? (() => Date.now());
+}
+function resolveSleep(sleep) {
+    return sleep ?? ((milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds)));
+}
+function isTerminal(status) {
+    return ["canceled", "completed", "failed"].includes(status.status);
+}
+function requireCompletedGeneration(status) {
+    if (status.status === "completed")
+        return status;
+    if (status.status === "canceled") {
+        throw new CliUserError("record_generation_canceled", `Record generation ${status.operationId} was canceled.`);
+    }
+    const failureDetails = status.failure
+        ? `${status.failure.message} (${status.failure.code})`
+        : "The API did not provide failure details.";
+    throw new CliUserError("record_generation_failed", `Record generation ${status.operationId} failed: ${failureDetails}`);
+}
+function throwIfTimedOut(operationId, elapsedMs, timeoutMs) {
+    if (elapsedMs < timeoutMs)
+        return;
+    throw new CliUserError("timeout", `Timed out waiting for record generation ${operationId}.`);
+}
+async function runClientEffect(effect) {
+    const exit = await Effect.runPromiseExit(effect);
+    if (Exit.isSuccess(exit))
+        return exit.value;
+    const failure = Cause.findErrorOption(exit.cause);
+    if (Option.isSome(failure))
+        throw failure.value;
+    throw Cause.squash(exit.cause);
+}

package/dist/io.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAKA,wBAAsB,uBAAuB,CAC5C,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,mBAuBZ"}
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAKA,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,mBAkB7E"}

package/dist/io.js

@@ -15,6 +15,6 @@ export async function writeResponseBodyToFile(response, path) {
             callback(null, chunk);
         },
     });
-    await pipeline(Readable.fromWeb(response.body), byteCounter, createWriteStream(path));
+    await pipeline(Readable.from(response.body), byteCounter, createWriteStream(path));
     return sizeBytes;
 }

package/dist/runtime.d.ts

@@ -0,0 +1,3 @@
+import { Effect, type Layer } from "effect";
+export declare const runCliEffect: <A, E, R>(effect: Effect.Effect<A, E, R>, layer: Layer.Layer<R, unknown, never>) => Promise<A>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAQ,KAAK,KAAK,EAAU,MAAM,QAAQ,CAAC;AAEjE,eAAO,MAAM,YAAY,GAAU,CAAC,EAAE,CAAC,EAAE,CAAC,EACzC,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,eAQrC,CAAC"}

package/dist/runtime.js

@@ -0,0 +1,10 @@
+import { Cause, Effect, Exit, Option } from "effect";
+export const runCliEffect = async (effect, layer) => {
+    const exit = await Effect.runPromiseExit(effect.pipe(Effect.provide(layer)));
+    if (Exit.isSuccess(exit))
+        return exit.value;
+    const failure = Cause.findErrorOption(exit.cause);
+    if (Option.isSome(failure))
+        throw failure.value;
+    throw Cause.squash(exit.cause);
+};

package/dist/workflow.d.ts

@@ -1,8 +1,7 @@
 import { mkdir, writeFile } from "node:fs/promises";
-import { type ExportManifest, type ExportManifestFile, type ExportStatus } from "./api.js";
+import { Effect } from "effect";
+import { type ExportManifest, type ExportManifestFile, type ExportStatus, PrismantixApiClient } from "./api.js";
 export interface DownloadWorkflowOptions {
-    readonly apiBaseUrl?: string;
-    readonly apiKey?: string;
     readonly clientId?: string;
     readonly exportId?: string;
     readonly outputDir?: string;
@@ -12,7 +11,6 @@ export interface DownloadWorkflowOptions {
 }
 export interface DownloadWorkflowRuntime {
     readonly cwd?: string;
-    readonly fetchImpl?: typeof fetch;
     readonly mkdir?: typeof mkdir;
     readonly now?: () => number;
     readonly onEvent?: (event: WorkflowEvent) => void;
@@ -51,14 +49,5 @@ export interface DownloadResult {
     readonly manifestPath: string;
     readonly outputDir: string;
 }
-export interface ManifestSummary {
-    readonly fileCount: number;
-    readonly tables: readonly {
-        readonly rowCount?: number;
-        readonly tableName: string;
-    }[];
-    readonly totalRows: number;
-}
-export declare function runDownloadWorkflow(options: DownloadWorkflowOptions, runtime?: DownloadWorkflowRuntime): Promise<DownloadResult>;
-export declare function summarizeManifest(manifest: ExportManifest): ManifestSummary;
+export declare function runDownloadWorkflowEffect(options: DownloadWorkflowOptions, runtime?: DownloadWorkflowRuntime): Effect.Effect<DownloadResult, unknown, PrismantixApiClient>;
 //# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAuB,MAAM,EAAgB,MAAM,QAAQ,CAAC;AACnE,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,mBAAmB,EACnB,MAAM,UAAU,CAAC;AASlB,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;IACtC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACnF;AAED,MAAM,MAAM,aAAa,GACtB;IACA,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CACxB,GACD;IACA,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACrB,GACD;IACA,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CACzB,GACD;IACA,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;CAC/B,GACD;IACA,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;CAClC,CAAC;AAEL,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,uBAAuB,EAChC,OAAO,GAAE,uBAA4B,+DASrC"}

package/dist/workflow.js

@@ -1,37 +1,32 @@
 import { mkdir, writeFile } from "node:fs/promises";
 import { basename, join, resolve } from "node:path";
+import { Cause, Effect, Exit, Option } from "effect";
 import { PrismantixApiClient, } from "./api.js";
-import { DEFAULT_API_BASE_URL, DEFAULT_OUTPUT_ROOT, DEFAULT_POLL_INTERVAL_MS, DEFAULT_TIMEOUT_MS, } from "./constants.js";
+import { DEFAULT_OUTPUT_ROOT, DEFAULT_POLL_INTERVAL_MS, DEFAULT_PULL_TIMEOUT_MS, } from "./constants.js";
 import { CliUserError } from "./errors.js";
 import { writeResponseBodyToFile } from "./io.js";
-export async function runDownloadWorkflow(options, runtime = {}) {
-    const apiKey = options.apiKey?.trim();
-    if (!apiKey) {
-        throw new CliUserError("missing_api_key", "Set PRISMANTIX_API_KEY before running the CLI.");
-    }
-    const sleep = runtime.sleep ??
-        ((ms) => new Promise((resolveSleep) => setTimeout(resolveSleep, ms)));
-    const now = runtime.now ?? (() => Date.now());
-    const mkdirImpl = runtime.mkdir ?? mkdir;
-    const writeFileImpl = runtime.writeFile ?? writeFile;
-    const writeResponseBody = runtime.writeResponseBody ?? writeResponseBodyToFile;
-    const emit = runtime.onEvent ?? (() => undefined);
-    const api = new PrismantixApiClient({
-        apiBaseUrl: options.apiBaseUrl ?? DEFAULT_API_BASE_URL,
-        apiKey,
-        fetchImpl: runtime.fetchImpl,
+export function runDownloadWorkflowEffect(options, runtime = {}) {
+    return Effect.gen(function* () {
+        const api = yield* PrismantixApiClient;
+        return yield* Effect.tryPromise({
+            try: () => runDownloadWorkflowPromise(api, options, runtime),
+            catch: (error) => error,
+        });
     });
-    let clientId = normalizeClientId(options.clientId);
-    let exportId = options.exportId?.trim();
-    if (!exportId) {
-        if (!clientId) {
-            throw new CliUserError("missing_client", "Pass --client when creating a new export.");
-        }
-        const created = await api.createExport(clientId);
-        clientId = created.clientId;
-        exportId = created.exportId;
-        emit({ clientId, exportId, type: "created" });
-    }
+}
+const resolveWorkflowRuntime = (runtime) => ({
+    emit: runtime.onEvent ?? (() => undefined),
+    mkdirImpl: runtime.mkdir ?? mkdir,
+    now: runtime.now ?? (() => Date.now()),
+    sleep: runtime.sleep ?? ((ms) => new Promise((resolveSleep) => setTimeout(resolveSleep, ms))),
+    writeFileImpl: runtime.writeFile ?? writeFile,
+    writeResponseBody: runtime.writeResponseBody ?? writeResponseBodyToFile,
+});
+async function runDownloadWorkflowPromise(api, options, runtime = {}) {
+    const { emit, mkdirImpl, now, sleep, writeFileImpl, writeResponseBody } = resolveWorkflowRuntime(runtime);
+    const resolvedExport = await resolveExport(api, options, emit);
+    let clientId = resolvedExport.clientId;
+    const exportId = resolvedExport.exportId;
     const status = await waitForCompletedExport({
         api,
         exportId,
@@ -39,10 +34,10 @@ export async function runDownloadWorkflow(options, runtime = {}) {
         onPoll: (polledStatus) => emit({ status: polledStatus, type: "poll" }),
         pollIntervalMs: options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS,
         sleep,
-        timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+        timeoutMs: options.timeoutMs ?? DEFAULT_PULL_TIMEOUT_MS,
     });
     clientId = status.clientId;
-    const manifest = await api.getManifest(exportId);
+    const manifest = await runClientEffect(api.getManifest(exportId));
     emit({ manifest, type: "manifest" });
     const outputDir = resolveOutputDir({
         clientId,
@@ -55,26 +50,15 @@ export async function runDownloadWorkflow(options, runtime = {}) {
     await writeFileImpl(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, {
         encoding: "utf8",
     });
-    const selectedFiles = selectManifestFiles(manifest.files, options.tables ?? []);
-    if (selectedFiles.length === 0) {
-        throw new CliUserError("no_matching_files", `No export files matched: ${(options.tables ?? []).join(", ")}`);
-    }
-    const files = [];
-    for (const file of selectedFiles) {
-        emit({ file, type: "download-start" });
-        const destinationPath = join(outputDir, basename(file.fileName));
-        const response = await api.getFile(exportId, file.tableName);
-        const writtenSizeBytes = await writeResponseBody(response, destinationPath);
-        const downloadedFile = {
-            path: destinationPath,
-            rowCount: file.rowCount,
-            sha256: file.sha256,
-            sizeBytes: file.sizeBytes ?? writtenSizeBytes,
-            tableName: file.tableName,
-        };
-        files.push(downloadedFile);
-        emit({ file: downloadedFile, type: "download-complete" });
-    }
+    const selectedFiles = requireSelectedFiles(manifest.files, options.tables ?? []);
+    const files = await downloadFiles({
+        api,
+        emit,
+        exportId,
+        files: selectedFiles,
+        outputDir,
+        writeResponseBody,
+    });
     return {
         clientId,
         exportId,
@@ -83,16 +67,6 @@ export async function runDownloadWorkflow(options, runtime = {}) {
         outputDir,
     };
 }
-export function summarizeManifest(manifest) {
-    return {
-        fileCount: manifest.files.length,
-        tables: manifest.files.map((file) => ({
-            rowCount: file.rowCount,
-            tableName: file.tableName,
-        })),
-        totalRows: manifest.totalRows,
-    };
-}
 function normalizeClientId(value) {
     const normalized = value?.trim();
     return normalized ? normalized.toUpperCase() : undefined;
@@ -100,7 +74,7 @@ function normalizeClientId(value) {
 async function waitForCompletedExport(args) {
     const startedAt = args.now();
     for (;;) {
-        const status = await args.api.getExportStatus(args.exportId);
+        const status = await runClientEffect(args.api.getExportStatus(args.exportId));
         args.onPoll(status);
         if (status.status === "completed") {
             return status;
@@ -114,6 +88,50 @@ async function waitForCompletedExport(args) {
         await args.sleep(args.pollIntervalMs);
     }
 }
+async function runClientEffect(effect) {
+    const exit = await Effect.runPromiseExit(effect);
+    if (Exit.isSuccess(exit))
+        return exit.value;
+    const failure = Cause.findErrorOption(exit.cause);
+    if (Option.isSome(failure))
+        throw failure.value;
+    throw Cause.squash(exit.cause);
+}
+async function resolveExport(api, options, emit) {
+    const clientId = normalizeClientId(options.clientId);
+    const exportId = options.exportId?.trim();
+    if (exportId)
+        return { clientId, exportId };
+    if (!clientId) {
+        throw new CliUserError("missing_client", "Pass --client when creating a new export.");
+    }
+    const created = await runClientEffect(api.createExport(clientId));
+    emit({
+        clientId: created.clientId,
+        exportId: created.exportId,
+        type: "created",
+    });
+    return { clientId: created.clientId, exportId: created.exportId };
+}
+async function downloadFiles(args) {
+    const downloadedFiles = [];
+    for (const file of args.files) {
+        args.emit({ file, type: "download-start" });
+        const destinationPath = join(args.outputDir, basename(file.fileName));
+        const response = await runClientEffect(args.api.getFile(args.exportId, file.tableName));
+        const writtenSizeBytes = await args.writeResponseBody(response, destinationPath);
+        const downloadedFile = {
+            path: destinationPath,
+            rowCount: file.rowCount,
+            sha256: file.sha256,
+            sizeBytes: file.sizeBytes ?? writtenSizeBytes,
+            tableName: file.tableName,
+        };
+        downloadedFiles.push(downloadedFile);
+        args.emit({ file: downloadedFile, type: "download-complete" });
+    }
+    return downloadedFiles;
+}
 function resolveOutputDir(args) {
     return resolve(args.cwd, args.outputDir ?? join(DEFAULT_OUTPUT_ROOT, args.clientId, args.exportId));
 }
@@ -128,3 +146,9 @@ function selectManifestFiles(files, tables) {
     const allowedTables = new Set(normalizedTables);
     return files.filter((file) => allowedTables.has(file.tableName));
 }
+function requireSelectedFiles(files, tables) {
+    const selectedFiles = selectManifestFiles(files, tables);
+    if (selectedFiles.length > 0)
+        return selectedFiles;
+    throw new CliUserError("no_matching_files", `No export files matched: ${tables.join(", ")}`);
+}