pipework 0.7.11 → 0.7.13

package/dist/core/config/load.d.ts

@@ -0,0 +1,34 @@
+import { type Blueprint, type Environment, type IsolationStrategy } from './schema.js';
+export interface ResolvedObservability {
+    readonly slowQueryMs: number;
+    readonly logAllQueries: boolean;
+    readonly poolMetricsInterval: number;
+}
+export interface ResolvedConfig {
+    readonly raw: Blueprint;
+    readonly environment: Environment;
+    readonly observability: ResolvedObservability;
+    readonly env: Readonly<Record<string, unknown>>;
+    database(name?: string): ResolvedDatabase;
+    databases(): ReadonlyMap<string, ResolvedDatabase>;
+    databaseNames(): readonly string[];
+    defaultDatabaseName(): string;
+    isolationStrategy(dbName: string): IsolationStrategy;
+}
+export interface ResolvedDatabase {
+    readonly name: string;
+    readonly url: string;
+    readonly schema: string | string[] | undefined;
+    readonly migrations: string | undefined;
+    readonly extensions: readonly string[];
+    readonly migrationTable: string;
+    readonly pool: {
+        max: number;
+        idleTimeout: number;
+    };
+    readonly rls?: {
+        readonly sessionVar: string;
+    };
+}
+export declare function loadConfig(raw: unknown): ResolvedConfig;
+//# sourceMappingURL=load.d.ts.map

package/dist/core/config/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../../src/core/config/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAuB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAI9H,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAA;IACvB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAA;IAC7C,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAA;IACzC,SAAS,IAAI,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IAClD,aAAa,IAAI,SAAS,MAAM,EAAE,CAAA;IAClC,mBAAmB,IAAI,MAAM,CAAA;IAC7B,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAAA;CACrD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAA;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;IACnD,QAAQ,CAAC,GAAG,CAAC,EAAE;QAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAavD"}

package/dist/core/config/load.js

@@ -0,0 +1,113 @@
+import { trunkConfigSchema } from './schema.js';
+import { resolveEnvironment, resolveDbUrl, ConfigError } from './resolve.js';
+import { resolveEnvVars } from './env-resolve.js';
+export function loadConfig(raw) {
+    const parsed = trunkConfigSchema.safeParse(raw);
+    if (!parsed.success) {
+        const issues = parsed.error.issues.map(i => `  - ${i.path.join('.')}: ${i.message}`).join('\n');
+        throw new ConfigError(`Invalid pipework.config.ts:\n${issues}`, 'Check your pipework.config.ts against the expected schema.');
+    }
+    const config = parsed.data;
+    const environment = config.environment ?? resolveEnvironment();
+    return buildResolved(config, environment);
+}
+function buildResolved(config, environment) {
+    const dbMap = new Map();
+    for (const [name, dbConfig] of Object.entries(config.databases)) {
+        const url = resolveDbUrl(dbConfig.url, dbConfig.testUrl, environment, name);
+        dbMap.set(name, resolveDatabase(name, dbConfig, url));
+    }
+    const declaredNames = [...dbMap.keys()];
+    const env = Object.freeze(resolveEnvVars((config.env ?? {}), environment));
+    return {
+        raw: config,
+        environment,
+        observability: {
+            slowQueryMs: config.observability?.slowQueryMs ?? 500,
+            logAllQueries: config.observability?.logAllQueries ?? false,
+            poolMetricsInterval: config.observability?.poolMetricsInterval ?? 0,
+        },
+        env,
+        database(name) {
+            if (name === undefined) {
+                if (declaredNames.length === 1) {
+                    return dbMap.get(declaredNames[0]);
+                }
+                throw new ConfigError('Multiple databases configured — you must specify which one.', `Declared databases: ${declaredNames.join(', ')}\n\n  Use db("${declaredNames[0]}") to specify which database.`);
+            }
+            const db = dbMap.get(name);
+            if (!db) {
+                const suggestion = closestMatch(name, declaredNames);
+                const hint = suggestion !== null
+                    ? `Did you mean "${suggestion}"? Declared databases: ${declaredNames.join(', ')}`
+                    : `Declared databases: ${declaredNames.join(', ')}`;
+                throw new ConfigError(`Unknown database "${name}".`, hint);
+            }
+            return db;
+        },
+        databases() {
+            return dbMap;
+        },
+        databaseNames() {
+            return declaredNames;
+        },
+        defaultDatabaseName() {
+            if (declaredNames.length === 1) {
+                return declaredNames[0];
+            }
+            throw new ConfigError('Multiple databases configured — you must specify which one.', `Declared databases: ${declaredNames.join(', ')}`);
+        },
+        isolationStrategy(dbName) {
+            const perDb = config.test?.databases?.[dbName]?.isolation;
+            if (perDb)
+                return perDb;
+            return config.test?.isolation ?? 'transaction';
+        },
+    };
+}
+function resolveDatabase(name, config, url) {
+    return {
+        name,
+        url,
+        schema: config.schema,
+        migrations: config.migrations,
+        extensions: config.extensions ?? [],
+        migrationTable: config.migrationTable ?? `__pipework_migrations_${name}`,
+        pool: {
+            max: config.pool?.max ?? 10,
+            idleTimeout: config.pool?.idleTimeout ?? 30,
+        },
+        ...(config.rls !== undefined ? { rls: { sessionVar: config.rls.sessionVar } } : {}),
+    };
+}
+function closestMatch(input, candidates) {
+    if (candidates.length === 0)
+        return null;
+    let best = null;
+    let bestDistance = Infinity;
+    for (const candidate of candidates) {
+        const d = levenshtein(input.toLowerCase(), candidate.toLowerCase());
+        if (d < bestDistance && d <= Math.max(input.length, candidate.length) * 0.6) {
+            bestDistance = d;
+            best = candidate;
+        }
+    }
+    return best;
+}
+function levenshtein(a, b) {
+    const m = a.length;
+    const n = b.length;
+    const dp = Array.from({ length: m + 1 }, () => Array.from({ length: n + 1 }, () => 0));
+    for (let i = 0; i <= m; i++)
+        dp[i][0] = i;
+    for (let j = 0; j <= n; j++)
+        dp[0][j] = j;
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+        }
+    }
+    return dp[m][n];
+}
+//# sourceMappingURL=load.js.map

package/dist/core/config/load.js.map

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

package/dist/core/config/namespace.d.ts

@@ -0,0 +1,172 @@
+import { loadConfig, ConfigError } from './index.js';
+import { discoverInstance } from './discover.js';
+/** Configuration namespace — loads and resolves Blueprint configs, discovers pipework.config.ts. */
+export declare const config: {
+    /** Parses and resolves a raw Blueprint into a ResolvedConfig with environment detection. */
+    load: typeof loadConfig;
+    /** Walks up from cwd to find pipework.config.ts, imports it, and returns the Manifold. */
+    discover: typeof discoverInstance;
+    /** The zod schema for Blueprint validation — useful for custom config tooling. */
+    configSchema: import("zod").ZodObject<{
+        name: import("zod").ZodOptional<import("zod").ZodString>;
+        databases: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodObject<{
+            url: import("zod").ZodString;
+            testUrl: import("zod").ZodOptional<import("zod").ZodString>;
+            schema: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodArray<import("zod").ZodString>]>>;
+            migrations: import("zod").ZodOptional<import("zod").ZodString>;
+            extensions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            migrationTable: import("zod").ZodOptional<import("zod").ZodString>;
+            pool: import("zod").ZodOptional<import("zod").ZodObject<{
+                max: import("zod").ZodOptional<import("zod").ZodNumber>;
+                idleTimeout: import("zod").ZodOptional<import("zod").ZodNumber>;
+            }, import("zod/v4/core").$strip>>;
+            rls: import("zod").ZodOptional<import("zod").ZodObject<{
+                sessionVar: import("zod").ZodDefault<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>>;
+        dependencies: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        devDependencies: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        modules: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnion<readonly [import("zod").ZodObject<{
+            dependencies: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+            devDependencies: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+            exports: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{
+                types: import("zod").ZodString;
+                import: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>]>>>;
+            scripts: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+            tsconfig: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+            name: import("zod").ZodOptional<import("zod").ZodString>;
+            version: import("zod").ZodOptional<import("zod").ZodString>;
+            private: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodString]>>>;
+        vitest: import("zod").ZodOptional<import("zod").ZodObject<{
+            testTimeout: import("zod").ZodOptional<import("zod").ZodNumber>;
+            hookTimeout: import("zod").ZodOptional<import("zod").ZodNumber>;
+            inlineDeps: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            database: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            include: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            coverage: import("zod").ZodOptional<import("zod").ZodObject<{
+                provider: import("zod").ZodOptional<import("zod").ZodEnum<{
+                    v8: "v8";
+                    istanbul: "istanbul";
+                }>>;
+                include: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                reporter: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                reportsDirectory: import("zod").ZodOptional<import("zod").ZodString>;
+                thresholds: import("zod").ZodOptional<import("zod").ZodObject<{
+                    lines: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    functions: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    branches: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    statements: import("zod").ZodOptional<import("zod").ZodNumber>;
+                }, import("zod/v4/core").$strip>>;
+            }, import("zod/v4/core").$strip>>;
+            modules: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodObject<{
+                include: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                database: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                setupFiles: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                testTimeout: import("zod").ZodOptional<import("zod").ZodNumber>;
+                hookTimeout: import("zod").ZodOptional<import("zod").ZodNumber>;
+                env: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+                coverage: import("zod").ZodOptional<import("zod").ZodObject<{
+                    provider: import("zod").ZodOptional<import("zod").ZodEnum<{
+                        v8: "v8";
+                        istanbul: "istanbul";
+                    }>>;
+                    include: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                    exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                    reporter: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                    reportsDirectory: import("zod").ZodOptional<import("zod").ZodString>;
+                    thresholds: import("zod").ZodOptional<import("zod").ZodObject<{
+                        lines: import("zod").ZodOptional<import("zod").ZodNumber>;
+                        functions: import("zod").ZodOptional<import("zod").ZodNumber>;
+                        branches: import("zod").ZodOptional<import("zod").ZodNumber>;
+                        statements: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    }, import("zod/v4/core").$strip>>;
+                }, import("zod/v4/core").$strip>>;
+                extra: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+                profiles: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodObject<{
+                    include: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                    exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                    database: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    setupFiles: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                    testTimeout: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    hookTimeout: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    env: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+                    coverage: import("zod").ZodOptional<import("zod").ZodObject<{
+                        provider: import("zod").ZodOptional<import("zod").ZodEnum<{
+                            v8: "v8";
+                            istanbul: "istanbul";
+                        }>>;
+                        include: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                        exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                        reporter: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                        reportsDirectory: import("zod").ZodOptional<import("zod").ZodString>;
+                        thresholds: import("zod").ZodOptional<import("zod").ZodObject<{
+                            lines: import("zod").ZodOptional<import("zod").ZodNumber>;
+                            functions: import("zod").ZodOptional<import("zod").ZodNumber>;
+                            branches: import("zod").ZodOptional<import("zod").ZodNumber>;
+                            statements: import("zod").ZodOptional<import("zod").ZodNumber>;
+                        }, import("zod/v4/core").$strip>>;
+                    }, import("zod/v4/core").$strip>>;
+                    extra: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+                }, import("zod/v4/core").$strip>>>;
+            }, import("zod/v4/core").$strip>>>;
+        }, import("zod/v4/core").$strip>>;
+        environment: import("zod").ZodOptional<import("zod").ZodEnum<{
+            development: "development";
+            test: "test";
+            production: "production";
+        }>>;
+        test: import("zod").ZodOptional<import("zod").ZodObject<{
+            isolation: import("zod").ZodDefault<import("zod").ZodEnum<{
+                transaction: "transaction";
+                database: "database";
+                container: "container";
+            }>>;
+            databases: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodObject<{
+                isolation: import("zod").ZodOptional<import("zod").ZodEnum<{
+                    transaction: "transaction";
+                    database: "database";
+                    container: "container";
+                }>>;
+            }, import("zod/v4/core").$strip>>>;
+        }, import("zod/v4/core").$strip>>;
+        observability: import("zod").ZodOptional<import("zod").ZodObject<{
+            slowQueryMs: import("zod").ZodOptional<import("zod").ZodNumber>;
+            logAllQueries: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            poolMetricsInterval: import("zod").ZodOptional<import("zod").ZodNumber>;
+        }, import("zod/v4/core").$strip>>;
+        env: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+            type: import("zod").ZodLiteral<"string">;
+            required: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            default: import("zod").ZodOptional<import("zod").ZodString>;
+            sensitive: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            defaults: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            type: import("zod").ZodLiteral<"number">;
+            required: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            default: import("zod").ZodOptional<import("zod").ZodNumber>;
+            sensitive: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            defaults: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            type: import("zod").ZodLiteral<"boolean">;
+            required: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            default: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            sensitive: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            defaults: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            type: import("zod").ZodLiteral<"string[]">;
+            separator: import("zod").ZodOptional<import("zod").ZodString>;
+            required: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            default: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            sensitive: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            defaults: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        }, import("zod/v4/core").$strip>], "type">>>;
+    }, import("zod/v4/core").$strip>;
+    /** Thrown for configuration problems — includes a suggestion for how to fix. */
+    ConfigError: typeof ConfigError;
+};
+//# sourceMappingURL=namespace.d.ts.map

package/dist/core/config/namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../../src/core/config/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAqB,WAAW,EAAE,MAAM,YAAY,CAAA;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEhD,oGAAoG;AACpG,eAAO,MAAM,MAAM;IACjB,4FAA4F;;IAE5F,0FAA0F;;IAE1F,kFAAkF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAElF,gFAAgF;;CAEjF,CAAA"}

package/dist/core/config/namespace.js

@@ -0,0 +1,14 @@
+import { loadConfig, trunkConfigSchema, ConfigError } from './index.js';
+import { discoverInstance } from './discover.js';
+/** Configuration namespace — loads and resolves Blueprint configs, discovers pipework.config.ts. */
+export const config = {
+    /** Parses and resolves a raw Blueprint into a ResolvedConfig with environment detection. */
+    load: loadConfig,
+    /** Walks up from cwd to find pipework.config.ts, imports it, and returns the Manifold. */
+    discover: discoverInstance,
+    /** The zod schema for Blueprint validation — useful for custom config tooling. */
+    configSchema: trunkConfigSchema,
+    /** Thrown for configuration problems — includes a suggestion for how to fix. */
+    ConfigError,
+};
+//# sourceMappingURL=namespace.js.map

package/dist/core/config/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../../src/core/config/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEhD,oGAAoG;AACpG,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,4FAA4F;IAC5F,IAAI,EAAE,UAAU;IAChB,0FAA0F;IAC1F,QAAQ,EAAE,gBAAgB;IAC1B,kFAAkF;IAClF,YAAY,EAAE,iBAAiB;IAC/B,gFAAgF;IAChF,WAAW;CACZ,CAAA"}

package/dist/core/config/resolve.d.ts

@@ -0,0 +1,8 @@
+import type { Environment } from './schema.js';
+export declare function resolveEnvironment(): Environment;
+export declare function resolveDbUrl(envVarName: string, testEnvVarName: string | undefined, environment: Environment, dbName?: string): string;
+export declare class ConfigError extends Error {
+    readonly hint: string;
+    constructor(message: string, hint: string);
+}
+//# sourceMappingURL=resolve.d.ts.map

package/dist/core/config/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/core/config/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,wBAAgB,kBAAkB,IAAI,WAAW,CAWhD;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAgCtI;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,IAAI,EAAE,MAAM,CAAA;gBAEhB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAK1C"}

package/dist/core/config/resolve.js

@@ -0,0 +1,43 @@
+export function resolveEnvironment() {
+    const explicit = process.env['PIPEWORK_ENV'];
+    if (explicit === 'test' || explicit === 'development' || explicit === 'production') {
+        return explicit;
+    }
+    const nodeEnv = process.env['NODE_ENV'];
+    if (nodeEnv === 'test')
+        return 'test';
+    if (nodeEnv === 'production')
+        return 'production';
+    return 'development';
+}
+export function resolveDbUrl(envVarName, testEnvVarName, environment, dbName) {
+    if (environment === 'test') {
+        if (testEnvVarName === undefined) {
+            throw new ConfigError(`Database "${dbName ?? envVarName}" has no testUrl configured, but environment is "test".`, `Add testUrl to your database config:\n\n` +
+                `  databases: {\n` +
+                `    ${dbName ?? 'app'}: {\n` +
+                `      url: '${envVarName}',\n` +
+                `      testUrl: '${envVarName}_TEST',  // <-- add this\n` +
+                `    },\n` +
+                `  }\n\n` +
+                `Then set ${envVarName}_TEST in your environment.`);
+        }
+        const value = process.env[testEnvVarName];
+        if (value !== undefined && value !== '')
+            return value;
+        throw new ConfigError(`Missing test database URL: environment variable "${testEnvVarName}" is not set.`, `Set ${testEnvVarName} in your .env file or environment.`);
+    }
+    const value = process.env[envVarName];
+    if (value !== undefined && value !== '')
+        return value;
+    throw new ConfigError(`Missing database URL: environment variable "${envVarName}" is not set.`, `Set ${envVarName} in your .env file or environment.`);
+}
+export class ConfigError extends Error {
+    hint;
+    constructor(message, hint) {
+        super(`[pipework] ${message}\n\n  Hint: ${hint}\n`);
+        this.name = 'BlueprintError';
+        this.hint = hint;
+    }
+}
+//# sourceMappingURL=resolve.js.map

package/dist/core/config/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/core/config/resolve.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB;IAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;IAC5C,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,aAAa,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;QACnF,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACvC,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,MAAM,CAAA;IACrC,IAAI,OAAO,KAAK,YAAY;QAAE,OAAO,YAAY,CAAA;IAEjD,OAAO,aAAa,CAAA;AACtB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,cAAkC,EAAE,WAAwB,EAAE,MAAe;IAC5H,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;QAC3B,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,WAAW,CACnB,aAAa,MAAM,IAAI,UAAU,yDAAyD,EAC1F,0CAA0C;gBAC1C,kBAAkB;gBAClB,OAAO,MAAM,IAAI,KAAK,OAAO;gBAC7B,eAAe,UAAU,MAAM;gBAC/B,mBAAmB,UAAU,4BAA4B;gBACzD,UAAU;gBACV,SAAS;gBACT,YAAY,UAAU,4BAA4B,CACnD,CAAA;QACH,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QACzC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;YAAE,OAAO,KAAK,CAAA;QAErD,MAAM,IAAI,WAAW,CACnB,oDAAoD,cAAc,eAAe,EACjF,OAAO,cAAc,oCAAoC,CAC1D,CAAA;IACH,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,KAAK,CAAA;IAErD,MAAM,IAAI,WAAW,CACnB,+CAA+C,UAAU,eAAe,EACxE,OAAO,UAAU,oCAAoC,CACtD,CAAA;AACH,CAAC;AAED,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpB,IAAI,CAAQ;IAE5B,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,cAAc,OAAO,eAAe,IAAI,IAAI,CAAC,CAAA;QACnD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF"}