sqlstack 1.0.25 → 3.0.0

package/dist/esm/stack.js

@@ -0,0 +1,251 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _SqlStack_instances, _SqlStack_entries, _SqlStack_families, _SqlStack_defaultName, _SqlStack_resolver, _SqlStack_closed, _SqlStack_assertOpen, _SqlStack_registeredNames;
+import { setGlobalResolver, clearGlobalResolver, ManifestResolver, assertManifestCoverage, assertManifestCoversClasses, } from './core/resolver.js';
+import { SqlStackError } from './core/errors.js';
+import { FamilyRuntime } from './family.js';
+import { currentBinding, runWithBinding } from './familyBinding.js';
+/**
+ * Environment-owned SQLStack runtime (spec 16 §12-13, repo spec 19 §3-5).
+ *
+ * One instance per owning IoC root; child scopes resolve the root's Singleton.
+ * Native @Query/transaction/resolver execution goes through an instance —
+ * never through the process-global SqlStackDB registry.
+ */
+export class SqlStack {
+    /**
+     * @deprecated Legacy v2 process-global resolver registration
+     * (`SqlStack.useResolver(...)`). Forwards to the deprecated global state,
+     * which is only consulted when no IoC environment is active. Use the
+     * per-instance `useResolver` / SqlStackConfig.resolver instead.
+     */
+    static useResolver(resolver) {
+        setGlobalResolver(resolver);
+    }
+    /** @deprecated See static useResolver. */
+    static clearResolver() {
+        clearGlobalResolver();
+    }
+    constructor(config) {
+        _SqlStack_instances.add(this);
+        _SqlStack_entries.set(this, new Map());
+        _SqlStack_families.set(this, new Map());
+        _SqlStack_defaultName.set(this, void 0);
+        _SqlStack_resolver.set(this, void 0);
+        _SqlStack_closed.set(this, false);
+        if (config?.databases) {
+            for (const [name, reg] of Object.entries(config.databases)) {
+                if (typeof reg === 'object' && reg !== null && 'db' in reg) {
+                    const db = typeof reg.db === 'function' ? reg.db() : reg.db;
+                    this.register(name, db, { owned: reg.owned ?? typeof reg.db === 'function' });
+                }
+                else {
+                    this.register(name, reg);
+                }
+            }
+        }
+        if (config?.default)
+            this.setDefault(config.default);
+        if (config?.resolver)
+            this.useResolver(config.resolver);
+    }
+    register(name, db, options) {
+        __classPrivateFieldGet(this, _SqlStack_instances, "m", _SqlStack_assertOpen).call(this);
+        const entry = { name, db, owned: options?.owned ?? false, stack: this };
+        __classPrivateFieldGet(this, _SqlStack_entries, "f").set(name, entry);
+        if (options?.default || __classPrivateFieldGet(this, _SqlStack_entries, "f").size === 1) {
+            __classPrivateFieldSet(this, _SqlStack_defaultName, __classPrivateFieldGet(this, _SqlStack_defaultName, "f") ?? name, "f");
+            if (options?.default)
+                __classPrivateFieldSet(this, _SqlStack_defaultName, name, "f");
+        }
+        return this;
+    }
+    setDefault(name) {
+        __classPrivateFieldGet(this, _SqlStack_instances, "m", _SqlStack_assertOpen).call(this);
+        if (!__classPrivateFieldGet(this, _SqlStack_entries, "f").has(name)) {
+            throw new SqlStackError(`SqlStack has no database registered under "${name}". Registered: ${__classPrivateFieldGet(this, _SqlStack_instances, "m", _SqlStack_registeredNames).call(this)}`);
+        }
+        __classPrivateFieldSet(this, _SqlStack_defaultName, name, "f");
+        return this;
+    }
+    getEntry(name) {
+        __classPrivateFieldGet(this, _SqlStack_instances, "m", _SqlStack_assertOpen).call(this);
+        const key = name ?? __classPrivateFieldGet(this, _SqlStack_defaultName, "f");
+        if (!key) {
+            throw new SqlStackError('SqlStack has no default database. Register one with { default: true } or call setDefault(name).');
+        }
+        const entry = __classPrivateFieldGet(this, _SqlStack_entries, "f").get(key);
+        if (!entry) {
+            throw new SqlStackError(`SqlStack has no database registered under "${key}". Registered: ${__classPrivateFieldGet(this, _SqlStack_instances, "m", _SqlStack_registeredNames).call(this)}`);
+        }
+        return entry;
+    }
+    database(name) {
+        return this.getEntry(name).db;
+    }
+    has(name) {
+        return __classPrivateFieldGet(this, _SqlStack_entries, "f").has(name) || __classPrivateFieldGet(this, _SqlStack_families, "f").has(name);
+    }
+    /**
+     * Register a dynamic database family (spec 17): one registration whose
+     * concrete member is selected per execution flow via withDatabase(...).
+     */
+    registerFamily(name, config) {
+        __classPrivateFieldGet(this, _SqlStack_instances, "m", _SqlStack_assertOpen).call(this);
+        if (__classPrivateFieldGet(this, _SqlStack_entries, "f").has(name)) {
+            throw new SqlStackError(`"${name}" is already registered as a static database.`);
+        }
+        __classPrivateFieldGet(this, _SqlStack_families, "f").set(name, new FamilyRuntime(this, name, config));
+        return this;
+    }
+    family(name) {
+        const fam = __classPrivateFieldGet(this, _SqlStack_families, "f").get(name);
+        if (!fam) {
+            throw new SqlStackError(`SqlStack has no database family registered under "${name}". Families: ${[...__classPrivateFieldGet(this, _SqlStack_families, "f").keys()].map((n) => `"${n}"`).join(', ') || '(none)'}`);
+        }
+        return fam;
+    }
+    /**
+     * Bind a family registration to a concrete member for the duration of fn
+     * (spec 17 §10). The binding is flow-local to this SqlStack; the member's
+     * connection is leased lazily on first database resolution and released
+     * when fn settles. Rebinding a family to a different key while it has an
+     * active transaction fails deterministically (spec 17 §29).
+     */
+    async withDatabase(family, key, fn) {
+        __classPrivateFieldGet(this, _SqlStack_instances, "m", _SqlStack_assertOpen).call(this);
+        const fam = this.family(family);
+        const { keyId } = fam.normalize(key);
+        const outer = currentBinding(this, family);
+        if (outer && outer.keyId !== keyId && outer.lease) {
+            const { getActiveTransaction } = await import('./transactions');
+            if (getActiveTransaction(outer.lease.entry)) {
+                throw new SqlStackError(`Cannot rebind database family "${family}" from "${outer.keyId}" to "${keyId}": ` +
+                    'a transaction is active for the current member. Finish the transaction first.');
+            }
+        }
+        const frame = { stack: this, family, keyInput: key, keyId };
+        try {
+            return await runWithBinding(frame, fn);
+        }
+        finally {
+            await frame.lease?.release();
+        }
+    }
+    /**
+     * Async database resolution for query/transaction execution. Static
+     * registrations resolve directly; family registrations resolve through the
+     * active flow-local binding, opening/leasing the member on first use.
+     */
+    async resolveEntry(name) {
+        __classPrivateFieldGet(this, _SqlStack_instances, "m", _SqlStack_assertOpen).call(this);
+        const key = name ??
+            __classPrivateFieldGet(this, _SqlStack_defaultName, "f") ??
+            // A stack whose only registration is one family treats it as default.
+            (__classPrivateFieldGet(this, _SqlStack_entries, "f").size === 0 && __classPrivateFieldGet(this, _SqlStack_families, "f").size === 1
+                ? [...__classPrivateFieldGet(this, _SqlStack_families, "f").keys()][0]
+                : undefined);
+        if (key !== undefined) {
+            const entry = __classPrivateFieldGet(this, _SqlStack_entries, "f").get(key);
+            if (entry)
+                return entry;
+            const fam = __classPrivateFieldGet(this, _SqlStack_families, "f").get(key);
+            if (fam) {
+                const frame = currentBinding(this, key);
+                if (!frame) {
+                    throw new SqlStackError(`SQLStack database family "${key}" requires a concrete database key. ` +
+                        'No active binding exists for this execution. Establish the database at the ' +
+                        `orchestration boundary with sqlStack.withDatabase("${key}", key, ...) ` +
+                        'or acquire a member explicitly via sqlStack.family(...).with(...).');
+                }
+                if (!frame.lease) {
+                    frame.lease = await fam.acquire(frame.keyInput);
+                }
+                return frame.lease.entry;
+            }
+        }
+        return this.getEntry(name);
+    }
+    /**
+     * Set this stack's SQL resolver. When `options.classes` supplies the
+     * repository catalog, manifest coverage is validated from those classes'
+     * immutable metadata (environment-local, unpollutable by unrelated
+     * imports). Without a catalog, coverage falls back to the deprecated
+     * process-global decorated list.
+     */
+    useResolver(resolver, options) {
+        __classPrivateFieldGet(this, _SqlStack_instances, "m", _SqlStack_assertOpen).call(this);
+        if (resolver instanceof ManifestResolver && resolver.options.assert !== false) {
+            if (options?.classes) {
+                assertManifestCoversClasses(resolver, options.classes);
+            }
+            else {
+                assertManifestCoverage(resolver);
+            }
+        }
+        __classPrivateFieldSet(this, _SqlStack_resolver, resolver, "f");
+        return this;
+    }
+    resolver() {
+        return __classPrivateFieldGet(this, _SqlStack_resolver, "f");
+    }
+    get closed() {
+        return __classPrivateFieldGet(this, _SqlStack_closed, "f");
+    }
+    /**
+     * Close owned database adapters exactly once and release runtime resources.
+     * Externally supplied databases (owned: false) are not touched. Failures are
+     * collected and reported with database identity rather than swallowed.
+     */
+    async close() {
+        if (__classPrivateFieldGet(this, _SqlStack_closed, "f"))
+            return;
+        __classPrivateFieldSet(this, _SqlStack_closed, true, "f");
+        const failures = [];
+        for (const entry of __classPrivateFieldGet(this, _SqlStack_entries, "f").values()) {
+            if (!entry.owned)
+                continue;
+            try {
+                await entry.db.close();
+            }
+            catch (err) {
+                failures.push(`"${entry.name}": ${err?.message ?? String(err)}`);
+            }
+        }
+        for (const fam of __classPrivateFieldGet(this, _SqlStack_families, "f").values()) {
+            try {
+                await fam.closeAll();
+            }
+            catch (err) {
+                failures.push(err?.message ?? String(err));
+            }
+        }
+        __classPrivateFieldGet(this, _SqlStack_entries, "f").clear();
+        __classPrivateFieldGet(this, _SqlStack_families, "f").clear();
+        __classPrivateFieldSet(this, _SqlStack_resolver, undefined, "f");
+        if (failures.length) {
+            throw new SqlStackError(`SqlStack close failed for ${failures.join(', ')}`);
+        }
+    }
+}
+_SqlStack_entries = new WeakMap(), _SqlStack_families = new WeakMap(), _SqlStack_defaultName = new WeakMap(), _SqlStack_resolver = new WeakMap(), _SqlStack_closed = new WeakMap(), _SqlStack_instances = new WeakSet(), _SqlStack_assertOpen = function _SqlStack_assertOpen() {
+    if (__classPrivateFieldGet(this, _SqlStack_closed, "f")) {
+        throw new SqlStackError('SqlStack has been closed; its owning root was disposed.');
+    }
+}, _SqlStack_registeredNames = function _SqlStack_registeredNames() {
+    const names = [
+        ...[...__classPrivateFieldGet(this, _SqlStack_entries, "f").keys()].map((n) => `"${n}"`),
+        ...[...__classPrivateFieldGet(this, _SqlStack_families, "f").keys()].map((n) => `"${n}" (family)`),
+    ];
+    return names.length ? names.join(', ') : '(none)';
+};
+//# sourceMappingURL=stack.js.map

package/dist/esm/stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.js","sourceRoot":"","sources":["../../src/stack.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Database } from './registry';\nimport type { SqlResolver } from './core/resolver';\nimport {\n  setGlobalResolver,\n  clearGlobalResolver,\n  ManifestResolver,\n  assertManifestCoverage,\n  assertManifestCoversClasses,\n} from './core/resolver';\nimport { SqlStackError } from './core/errors';\nimport { FamilyRuntime } from './family';\nimport type { FamilyConfig, FamilyMemberEntry, DatabaseLease } from './family';\nimport { currentBinding, runWithBinding, BindingFrame } from './familyBinding';\n\n/**\n * Concrete database identity inside one SqlStack instance.\n *\n * The entry OBJECT is the identity: two roots that both register a database\n * under the name \"primary\" produce two distinct DatabaseEntry instances, so\n * transaction lookup, caches, and diagnostics keyed by entry can never collide\n * across roots merely because the registration text matches.\n *\n * Dynamic database families (spec 17) extend this identity with a normalized\n * key; a static database is the no-key case.\n */\nexport interface DatabaseEntry {\n  readonly name: string;\n  readonly db: Database;\n  /** Close() closes owned databases; externally supplied ones are left open. */\n  readonly owned: boolean;\n  /** The stack this entry belongs to, for diagnostics and mismatch checks. */\n  readonly stack: SqlStack;\n}\n\nexport type DatabaseRegistration =\n  | Database\n  | {\n      db: Database | (() => Database);\n      /** Default false for direct Database values, true for factories. */\n      owned?: boolean;\n    };\n\nexport interface SqlStackConfig {\n  databases?: Record<string, DatabaseRegistration>;\n  /** Name of the default database. Required when more than one is registered. */\n  default?: string;\n  resolver?: SqlResolver;\n}\n\n/**\n * Environment-owned SQLStack runtime (spec 16 §12-13, repo spec 19 §3-5).\n *\n * One instance per owning IoC root; child scopes resolve the root's Singleton.\n * Native @Query/transaction/resolver execution goes through an instance —\n * never through the process-global SqlStackDB registry.\n */\nexport class SqlStack {\n  /**\n   * @deprecated Legacy v2 process-global resolver registration\n   * (`SqlStack.useResolver(...)`). Forwards to the deprecated global state,\n   * which is only consulted when no IoC environment is active. Use the\n   * per-instance `useResolver` / SqlStackConfig.resolver instead.\n   */\n  static useResolver(resolver: SqlResolver): void {\n    setGlobalResolver(resolver);\n  }\n\n  /** @deprecated See static useResolver. */\n  static clearResolver(): void {\n    clearGlobalResolver();\n  }\n\n  #entries = new Map<string, DatabaseEntry>();\n  #families = new Map<string, FamilyRuntime<any>>();\n  #defaultName: string | undefined;\n  #resolver: SqlResolver | undefined;\n  #closed = false;\n\n  constructor(config?: SqlStackConfig) {\n    if (config?.databases) {\n      for (const [name, reg] of Object.entries(config.databases)) {\n        if (typeof reg === 'object' && reg !== null && 'db' in reg) {\n          const db = typeof reg.db === 'function' ? reg.db() : reg.db;\n          this.register(name, db, { owned: reg.owned ?? typeof reg.db === 'function' });\n        } else {\n          this.register(name, reg as Database);\n        }\n      }\n    }\n    if (config?.default) this.setDefault(config.default);\n    if (config?.resolver) this.useResolver(config.resolver);\n  }\n\n  register(name: string, db: Database, options?: { owned?: boolean; default?: boolean }): this {\n    this.#assertOpen();\n    const entry: DatabaseEntry = { name, db, owned: options?.owned ?? false, stack: this };\n    this.#entries.set(name, entry);\n    if (options?.default || this.#entries.size === 1) {\n      this.#defaultName ??= name;\n      if (options?.default) this.#defaultName = name;\n    }\n    return this;\n  }\n\n  setDefault(name: string): this {\n    this.#assertOpen();\n    if (!this.#entries.has(name)) {\n      throw new SqlStackError(\n        `SqlStack has no database registered under \"${name}\". Registered: ${this.#registeredNames()}`\n      );\n    }\n    this.#defaultName = name;\n    return this;\n  }\n\n  getEntry(name?: string): DatabaseEntry {\n    this.#assertOpen();\n    const key = name ?? this.#defaultName;\n    if (!key) {\n      throw new SqlStackError(\n        'SqlStack has no default database. Register one with { default: true } or call setDefault(name).'\n      );\n    }\n    const entry = this.#entries.get(key);\n    if (!entry) {\n      throw new SqlStackError(\n        `SqlStack has no database registered under \"${key}\". Registered: ${this.#registeredNames()}`\n      );\n    }\n    return entry;\n  }\n\n  database(name?: string): Database {\n    return this.getEntry(name).db;\n  }\n\n  has(name: string): boolean {\n    return this.#entries.has(name) || this.#families.has(name);\n  }\n\n  /**\n   * Register a dynamic database family (spec 17): one registration whose\n   * concrete member is selected per execution flow via withDatabase(...).\n   */\n  registerFamily<K = string>(name: string, config: FamilyConfig<K>): this {\n    this.#assertOpen();\n    if (this.#entries.has(name)) {\n      throw new SqlStackError(`\"${name}\" is already registered as a static database.`);\n    }\n    this.#families.set(name, new FamilyRuntime(this, name, config));\n    return this;\n  }\n\n  family<K = string>(name: string): FamilyRuntime<K> {\n    const fam = this.#families.get(name);\n    if (!fam) {\n      throw new SqlStackError(\n        `SqlStack has no database family registered under \"${name}\". Families: ${\n          [...this.#families.keys()].map((n) => `\"${n}\"`).join(', ') || '(none)'\n        }`\n      );\n    }\n    return fam;\n  }\n\n  /**\n   * Bind a family registration to a concrete member for the duration of fn\n   * (spec 17 §10). The binding is flow-local to this SqlStack; the member's\n   * connection is leased lazily on first database resolution and released\n   * when fn settles. Rebinding a family to a different key while it has an\n   * active transaction fails deterministically (spec 17 §29).\n   */\n  async withDatabase<T>(family: string, key: unknown, fn: () => Promise<T>): Promise<T> {\n    this.#assertOpen();\n    const fam = this.family(family);\n    const { keyId } = fam.normalize(key);\n\n    const outer = currentBinding(this, family);\n    if (outer && outer.keyId !== keyId && outer.lease) {\n      const { getActiveTransaction } = await import('./transactions');\n      if (getActiveTransaction(outer.lease.entry)) {\n        throw new SqlStackError(\n          `Cannot rebind database family \"${family}\" from \"${outer.keyId}\" to \"${keyId}\": ` +\n            'a transaction is active for the current member. Finish the transaction first.'\n        );\n      }\n    }\n\n    const frame: BindingFrame = { stack: this, family, keyInput: key, keyId };\n    try {\n      return await runWithBinding(frame, fn);\n    } finally {\n      await frame.lease?.release();\n    }\n  }\n\n  /**\n   * Async database resolution for query/transaction execution. Static\n   * registrations resolve directly; family registrations resolve through the\n   * active flow-local binding, opening/leasing the member on first use.\n   */\n  async resolveEntry(name?: string): Promise<DatabaseEntry> {\n    this.#assertOpen();\n    const key =\n      name ??\n      this.#defaultName ??\n      // A stack whose only registration is one family treats it as default.\n      (this.#entries.size === 0 && this.#families.size === 1\n        ? [...this.#families.keys()][0]\n        : undefined);\n    if (key !== undefined) {\n      const entry = this.#entries.get(key);\n      if (entry) return entry;\n      const fam = this.#families.get(key);\n      if (fam) {\n        const frame = currentBinding(this, key);\n        if (!frame) {\n          throw new SqlStackError(\n            `SQLStack database family \"${key}\" requires a concrete database key. ` +\n              'No active binding exists for this execution. Establish the database at the ' +\n              `orchestration boundary with sqlStack.withDatabase(\"${key}\", key, ...) ` +\n              'or acquire a member explicitly via sqlStack.family(...).with(...).'\n          );\n        }\n        if (!frame.lease) {\n          frame.lease = await fam.acquire(frame.keyInput);\n        }\n        return frame.lease.entry;\n      }\n    }\n    return this.getEntry(name);\n  }\n\n  /**\n   * Set this stack's SQL resolver. When `options.classes` supplies the\n   * repository catalog, manifest coverage is validated from those classes'\n   * immutable metadata (environment-local, unpollutable by unrelated\n   * imports). Without a catalog, coverage falls back to the deprecated\n   * process-global decorated list.\n   */\n  useResolver(\n    resolver: SqlResolver,\n    options?: { classes?: ReadonlyArray<abstract new (...args: any[]) => any> }\n  ): this {\n    this.#assertOpen();\n    if (resolver instanceof ManifestResolver && resolver.options.assert !== false) {\n      if (options?.classes) {\n        assertManifestCoversClasses(resolver, options.classes);\n      } else {\n        assertManifestCoverage(resolver);\n      }\n    }\n    this.#resolver = resolver;\n    return this;\n  }\n\n  resolver(): SqlResolver | undefined {\n    return this.#resolver;\n  }\n\n  get closed(): boolean {\n    return this.#closed;\n  }\n\n  /**\n   * Close owned database adapters exactly once and release runtime resources.\n   * Externally supplied databases (owned: false) are not touched. Failures are\n   * collected and reported with database identity rather than swallowed.\n   */\n  async close(): Promise<void> {\n    if (this.#closed) return;\n    this.#closed = true;\n    const failures: string[] = [];\n    for (const entry of this.#entries.values()) {\n      if (!entry.owned) continue;\n      try {\n        await entry.db.close();\n      } catch (err: any) {\n        failures.push(`\"${entry.name}\": ${err?.message ?? String(err)}`);\n      }\n    }\n    for (const fam of this.#families.values()) {\n      try {\n        await fam.closeAll();\n      } catch (err: any) {\n        failures.push(err?.message ?? String(err));\n      }\n    }\n    this.#entries.clear();\n    this.#families.clear();\n    this.#resolver = undefined;\n    if (failures.length) {\n      throw new SqlStackError(`SqlStack close failed for ${failures.join(', ')}`);\n    }\n  }\n\n  #assertOpen(): void {\n    if (this.#closed) {\n      throw new SqlStackError('SqlStack has been closed; its owning root was disposed.');\n    }\n  }\n\n  #registeredNames(): string {\n    const names = [\n      ...[...this.#entries.keys()].map((n) => `\"${n}\"`),\n      ...[...this.#families.keys()].map((n) => `\"${n}\" (family)`),\n    ];\n    return names.length ? names.join(', ') : '(none)';\n  }\n}\n"]}

package/dist/esm/testing/builder.js

@@ -0,0 +1,95 @@
+import * as fs from 'fs';
+import { parseTestSchema } from './schema/parser.js';
+import { generateDdl } from './schema/ddl.js';
+import { allocateDatabase } from './postgres/allocator.js';
+import { createDatabaseHandle } from './postgres/database.js';
+import { dropDatabase } from './postgres/allocator.js';
+import { TestPostgresServerError } from './postgres/server.js';
+import { composeRows, insertRows, toOperations } from './postgres/loadData.js';
+function readRawSql(schema) {
+    return schema.sql.map((entry) => {
+        if (entry.kind === 'inline') {
+            return { label: `sql entry #${entry.index} (inline)`, sql: entry.sql };
+        }
+        try {
+            return {
+                label: `sql entry #${entry.index} (${entry.sourcePath})`,
+                sql: fs.readFileSync(entry.resolvedPath, 'utf8'),
+            };
+        }
+        catch (err) {
+            throw new TestPostgresServerError(`Cannot read raw SQL file for sql entry #${entry.index}: ${entry.resolvedPath} ` +
+                `(authored as "${entry.sourcePath}" in ${schema.source}): ${err.message}`);
+        }
+    });
+}
+function makeBuilder(state) {
+    return {
+        schema: state.schema,
+        ops: state.ops,
+        data(rows) {
+            const newOps = toOperations(state.schema, rows);
+            return makeBuilder({ ...state, ops: [...state.ops, ...newOps] });
+        },
+        async build() {
+            // Fail on pure planning errors (cycles, raw SQL file readability)
+            // before touching the server where possible.
+            const rawSql = readRawSql(state.schema);
+            const ddl = generateDdl(state.schema);
+            const effective = composeRows(state.schema, state.ops);
+            const allocated = await allocateDatabase(state.options);
+            let handle;
+            try {
+                handle = await createDatabaseHandle(allocated, state.options);
+                for (const statement of ddl) {
+                    try {
+                        await handle._pool.query(statement);
+                    }
+                    catch (err) {
+                        throw new TestPostgresServerError(`Failed to apply structured DDL from ${state.schema.source}: ${err.message}\n` +
+                            `Statement:\n${statement}`);
+                    }
+                }
+                for (const entry of rawSql) {
+                    try {
+                        // Simple-query protocol: the pg driver executes multi-statement
+                        // scripts directly when no parameters are passed.
+                        await handle._pool.query(entry.sql);
+                    }
+                    catch (err) {
+                        throw new TestPostgresServerError(`Failed to apply raw ${entry.label} from ${state.schema.source}: ${err.message}`);
+                    }
+                }
+                await insertRows((sql, params) => handle._pool.query(sql, params), state.schema, effective);
+                return handle;
+            }
+            catch (err) {
+                // Clean up partially created owned resources.
+                if (handle) {
+                    await handle._pool.end().catch(() => undefined);
+                }
+                await dropDatabase(allocated.name, state.options).catch(() => undefined);
+                throw err;
+            }
+        },
+    };
+}
+/**
+ * Persistent immutable test database builder.
+ *
+ * `schema` may be a parsed schema object, a YAML string, or a path to a
+ * .yml/.yaml file (raw .sql entries then resolve relative to that file's
+ * directory unless options.sourceDir overrides it).
+ */
+export function testPostgres(schema, options = {}) {
+    const normalized = isNormalizedSchema(schema) ? schema : parseTestSchema(schema, options);
+    return makeBuilder({ schema: normalized, ops: [], options: Object.freeze({ ...options }) });
+}
+function isNormalizedSchema(input) {
+    return (!!input &&
+        typeof input === 'object' &&
+        Array.isArray(input.tables) &&
+        Array.isArray(input.sql) &&
+        typeof input.source === 'string');
+}
+//# sourceMappingURL=builder.js.map

package/dist/esm/testing/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../src/testing/builder.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'fs';\nimport { parseTestSchema } from './schema/parser';\nimport { generateDdl } from './schema/ddl';\nimport type { NormalizedTestSchema, ParseTestSchemaOptions } from './schema/types';\nimport { allocateDatabase } from './postgres/allocator';\nimport { createDatabaseHandle, TestPostgresDatabase } from './postgres/database';\nimport { dropDatabase } from './postgres/allocator';\nimport { TestPostgresServerError, TestServerOptions } from './postgres/server';\nimport { composeRows, DataOperation, insertRows, Row, toOperations } from './postgres/loadData';\n\nexport interface TestPostgresOptions extends TestServerOptions, ParseTestSchemaOptions {}\n\nexport interface TestPostgresBuilder {\n  /** The normalized immutable schema (useful for assertions/diagnostics). */\n  readonly schema: NormalizedTestSchema;\n  /** @internal Accumulated row operations (exposed for pure tests). */\n  readonly ops: readonly DataOperation[];\n  /** Returns a NEW derived builder; this builder is unchanged. */\n  data(rows: Record<string, Row[]>): TestPostgresBuilder;\n  /**\n   * Create a fresh isolated PostgreSQL database, apply DDL + raw SQL,\n   * insert effective scenario rows, and return the handle. Does not\n   * consume the builder: building twice yields two independent databases.\n   */\n  build(): Promise<TestPostgresDatabase>;\n}\n\ninterface BuilderState {\n  readonly schema: NormalizedTestSchema;\n  readonly ops: readonly DataOperation[];\n  readonly options: Readonly<TestPostgresOptions>;\n}\n\nfunction readRawSql(schema: NormalizedTestSchema): { label: string; sql: string }[] {\n  return schema.sql.map((entry) => {\n    if (entry.kind === 'inline') {\n      return { label: `sql entry #${entry.index} (inline)`, sql: entry.sql };\n    }\n    try {\n      return {\n        label: `sql entry #${entry.index} (${entry.sourcePath})`,\n        sql: fs.readFileSync(entry.resolvedPath, 'utf8'),\n      };\n    } catch (err) {\n      throw new TestPostgresServerError(\n        `Cannot read raw SQL file for sql entry #${entry.index}: ${entry.resolvedPath} ` +\n          `(authored as \"${entry.sourcePath}\" in ${schema.source}): ${(err as Error).message}`\n      );\n    }\n  });\n}\n\nfunction makeBuilder(state: BuilderState): TestPostgresBuilder {\n  return {\n    schema: state.schema,\n    ops: state.ops,\n    data(rows: Record<string, Row[]>): TestPostgresBuilder {\n      const newOps = toOperations(state.schema, rows);\n      return makeBuilder({ ...state, ops: [...state.ops, ...newOps] });\n    },\n    async build(): Promise<TestPostgresDatabase> {\n      // Fail on pure planning errors (cycles, raw SQL file readability)\n      // before touching the server where possible.\n      const rawSql = readRawSql(state.schema);\n      const ddl = generateDdl(state.schema);\n      const effective = composeRows(state.schema, state.ops);\n\n      const allocated = await allocateDatabase(state.options);\n      let handle: (TestPostgresDatabase & { _pool: any }) | undefined;\n      try {\n        handle = await createDatabaseHandle(allocated, state.options);\n        for (const statement of ddl) {\n          try {\n            await handle._pool.query(statement);\n          } catch (err) {\n            throw new TestPostgresServerError(\n              `Failed to apply structured DDL from ${state.schema.source}: ${(err as Error).message}\\n` +\n                `Statement:\\n${statement}`\n            );\n          }\n        }\n        for (const entry of rawSql) {\n          try {\n            // Simple-query protocol: the pg driver executes multi-statement\n            // scripts directly when no parameters are passed.\n            await handle._pool.query(entry.sql);\n          } catch (err) {\n            throw new TestPostgresServerError(\n              `Failed to apply raw ${entry.label} from ${state.schema.source}: ${(err as Error).message}`\n            );\n          }\n        }\n        await insertRows((sql, params) => handle!._pool.query(sql, params), state.schema, effective);\n        return handle;\n      } catch (err) {\n        // Clean up partially created owned resources.\n        if (handle) {\n          await handle._pool.end().catch(() => undefined);\n        }\n        await dropDatabase(allocated.name, state.options).catch(() => undefined);\n        throw err;\n      }\n    },\n  };\n}\n\n/**\n * Persistent immutable test database builder.\n *\n * `schema` may be a parsed schema object, a YAML string, or a path to a\n * .yml/.yaml file (raw .sql entries then resolve relative to that file's\n * directory unless options.sourceDir overrides it).\n */\nexport function testPostgres(\n  schema: string | object,\n  options: TestPostgresOptions = {}\n): TestPostgresBuilder {\n  const normalized =\n    isNormalizedSchema(schema) ? schema : parseTestSchema(schema as string | object, options);\n  return makeBuilder({ schema: normalized, ops: [], options: Object.freeze({ ...options }) });\n}\n\nfunction isNormalizedSchema(input: unknown): input is NormalizedTestSchema {\n  return (\n    !!input &&\n    typeof input === 'object' &&\n    Array.isArray((input as NormalizedTestSchema).tables) &&\n    Array.isArray((input as NormalizedTestSchema).sql) &&\n    typeof (input as NormalizedTestSchema).source === 'string'\n  );\n}\n"]}

package/dist/esm/testing/index.js

@@ -0,0 +1,7 @@
+export { testPostgres } from './builder.js';
+export { parseTestSchema } from './schema/parser.js';
+export { normalizeTestSchema, TestSchemaError } from './schema/normalize.js';
+export { generateDdl } from './schema/ddl.js';
+export { TestDataError } from './postgres/loadData.js';
+export { TestPostgresServerError, DEFAULT_ADMIN_URL } from './postgres/server.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC","sourcesContent":["export { testPostgres } from './builder';\nexport type { TestPostgresBuilder, TestPostgresOptions } from './builder';\nexport type { TestPostgresDatabase } from './postgres/database';\nexport { parseTestSchema } from './schema/parser';\nexport { normalizeTestSchema, TestSchemaError } from './schema/normalize';\nexport { generateDdl } from './schema/ddl';\nexport { TestDataError } from './postgres/loadData';\nexport { TestPostgresServerError, DEFAULT_ADMIN_URL } from './postgres/server';\nexport type {\n  NormalizedTestSchema,\n  NormalizedTable,\n  NormalizedColumn,\n  RawSqlEntry,\n  ParseTestSchemaOptions,\n} from './schema/types';\n"]}

package/dist/esm/testing/postgres/allocator.js

@@ -0,0 +1,49 @@
+import { randomBytes } from 'crypto';
+import { connectAdmin, redact, resolveAdminUrl, TestPostgresServerError, withDatabase, } from './server.js';
+const NAME_PREFIX = 'sqlstack_test_';
+let counter = 0;
+/**
+ * Unique, safe, bounded-length database name. Randomness plus a process
+ * counter keeps parallel builds (including across worker processes)
+ * collision-free. Always well under PostgreSQL's 63-byte identifier limit.
+ */
+export function nextDatabaseName() {
+    counter += 1;
+    return `${NAME_PREFIX}${randomBytes(4).toString('hex')}_${counter}`;
+}
+/** Create a fresh uniquely named database on the configured test server. */
+export async function allocateDatabase(options = {}) {
+    const adminUrl = resolveAdminUrl(options);
+    const name = nextDatabaseName();
+    const admin = await connectAdmin(options);
+    try {
+        await admin.query(`CREATE DATABASE "${name}"`);
+    }
+    catch (err) {
+        throw new TestPostgresServerError(`Failed to create test database "${name}" on ${redact(adminUrl)}: ${err.message}\n` +
+            `The admin connection must have CREATE DATABASE privilege ` +
+            `(set SQLSTACK_TEST_PG_URL or options.adminUrl; start the bundled server with npm run db:pg:up).`);
+    }
+    finally {
+        await admin.end().catch(() => undefined);
+    }
+    return { name, url: withDatabase(adminUrl, name), adminUrl };
+}
+/** Drop exactly the named database. Safe to call for an already-dropped db. */
+export async function dropDatabase(name, options = {}) {
+    if (!name.startsWith(NAME_PREFIX)) {
+        throw new TestPostgresServerError(`Refusing to drop database "${name}": not an sqlstack test database (expected prefix ${NAME_PREFIX})`);
+    }
+    const admin = await connectAdmin(options);
+    try {
+        // FORCE (PG 13+) terminates lingering sessions so parallel teardown is robust.
+        await admin.query(`DROP DATABASE IF EXISTS "${name}" WITH (FORCE)`);
+    }
+    catch (err) {
+        throw new TestPostgresServerError(`Failed to drop test database "${name}" on ${redact(resolveAdminUrl(options))}: ${err.message}`);
+    }
+    finally {
+        await admin.end().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=allocator.js.map

package/dist/esm/testing/postgres/allocator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allocator.js","sourceRoot":"","sources":["../../../../src/testing/postgres/allocator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EACL,YAAY,EACZ,MAAM,EACN,eAAe,EACf,uBAAuB,EAEvB,YAAY,GACb,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,GAAG,gBAAgB,CAAC;AACrC,IAAI,OAAO,GAAG,CAAC,CAAC;AAEhB;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,CAAC,CAAC;IACb,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;AACtE,CAAC;AAQD,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAA6B,EAAE;IACpE,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,KAAK,CAAC,oBAAoB,IAAI,GAAG,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,uBAAuB,CAC/B,mCAAmC,IAAI,QAAQ,MAAM,CAAC,QAAQ,CAAC,KAAM,GAAa,CAAC,OAAO,IAAI;YAC5F,2DAA2D;YAC3D,iGAAiG,CACpG,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;AAC/D,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,UAA6B,EAAE;IAC9E,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,uBAAuB,CAC/B,8BAA8B,IAAI,qDAAqD,WAAW,GAAG,CACtG,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,+EAA+E;QAC/E,MAAM,KAAK,CAAC,KAAK,CAAC,4BAA4B,IAAI,gBAAgB,CAAC,CAAC;IACtE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,uBAAuB,CAC/B,iCAAiC,IAAI,QAAQ,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,KAAM,GAAa,CAAC,OAAO,EAAE,CAC3G,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC","sourcesContent":["import { randomBytes } from 'crypto';\nimport {\n  connectAdmin,\n  redact,\n  resolveAdminUrl,\n  TestPostgresServerError,\n  TestServerOptions,\n  withDatabase,\n} from './server';\n\nconst NAME_PREFIX = 'sqlstack_test_';\nlet counter = 0;\n\n/**\n * Unique, safe, bounded-length database name. Randomness plus a process\n * counter keeps parallel builds (including across worker processes)\n * collision-free. Always well under PostgreSQL's 63-byte identifier limit.\n */\nexport function nextDatabaseName(): string {\n  counter += 1;\n  return `${NAME_PREFIX}${randomBytes(4).toString('hex')}_${counter}`;\n}\n\nexport interface AllocatedDatabase {\n  readonly name: string;\n  readonly url: string;\n  readonly adminUrl: string;\n}\n\n/** Create a fresh uniquely named database on the configured test server. */\nexport async function allocateDatabase(options: TestServerOptions = {}): Promise<AllocatedDatabase> {\n  const adminUrl = resolveAdminUrl(options);\n  const name = nextDatabaseName();\n  const admin = await connectAdmin(options);\n  try {\n    await admin.query(`CREATE DATABASE \"${name}\"`);\n  } catch (err) {\n    throw new TestPostgresServerError(\n      `Failed to create test database \"${name}\" on ${redact(adminUrl)}: ${(err as Error).message}\\n` +\n        `The admin connection must have CREATE DATABASE privilege ` +\n        `(set SQLSTACK_TEST_PG_URL or options.adminUrl; start the bundled server with npm run db:pg:up).`\n    );\n  } finally {\n    await admin.end().catch(() => undefined);\n  }\n  return { name, url: withDatabase(adminUrl, name), adminUrl };\n}\n\n/** Drop exactly the named database. Safe to call for an already-dropped db. */\nexport async function dropDatabase(name: string, options: TestServerOptions = {}): Promise<void> {\n  if (!name.startsWith(NAME_PREFIX)) {\n    throw new TestPostgresServerError(\n      `Refusing to drop database \"${name}\": not an sqlstack test database (expected prefix ${NAME_PREFIX})`\n    );\n  }\n  const admin = await connectAdmin(options);\n  try {\n    // FORCE (PG 13+) terminates lingering sessions so parallel teardown is robust.\n    await admin.query(`DROP DATABASE IF EXISTS \"${name}\" WITH (FORCE)`);\n  } catch (err) {\n    throw new TestPostgresServerError(\n      `Failed to drop test database \"${name}\" on ${redact(resolveAdminUrl(options))}: ${(err as Error).message}`\n    );\n  } finally {\n    await admin.end().catch(() => undefined);\n  }\n}\n"]}

package/dist/esm/testing/postgres/database.js

@@ -0,0 +1,36 @@
+import { dropDatabase } from './allocator.js';
+import { loadPg, TestPostgresServerError } from './server.js';
+/**
+ * Connect a helper pool to an allocated database and produce the handle.
+ * The handle owns exactly this database and drops it on dispose.
+ */
+export async function createDatabaseHandle(owned, options = {}) {
+    const pg = await loadPg();
+    const Pool = pg.Pool ?? pg.default?.Pool;
+    const pool = new Pool({ connectionString: owned.url, max: 4 });
+    let disposed = false;
+    return {
+        url: owned.url,
+        _pool: pool,
+        async query(sql, params = []) {
+            if (disposed) {
+                throw new TestPostgresServerError(`Test database "${owned.name}" has been disposed; no further queries are possible.`);
+            }
+            const res = await pool.query(sql, params);
+            return res.rows;
+        },
+        async dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            try {
+                await pool.end();
+            }
+            catch {
+                /* pool may already be closed */
+            }
+            await dropDatabase(owned.name, options);
+        },
+    };
+}
+//# sourceMappingURL=database.js.map

package/dist/esm/testing/postgres/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../../src/testing/postgres/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,uBAAuB,EAAqB,MAAM,UAAU,CAAC;AAgB9E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAoB,EACpB,UAA6B,EAAE;IAE/B,MAAM,EAAE,GAAG,MAAM,MAAM,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,gBAAgB,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/D,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO;QACL,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,KAAK,EAAE,IAAI;QACX,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,SAA6B,EAAE;YACtD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,uBAAuB,CAC/B,kBAAkB,KAAK,CAAC,IAAI,uDAAuD,CACpF,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,MAAmB,CAAC,CAAC;YACvD,OAAO,GAAG,CAAC,IAAI,CAAC;QAClB,CAAC;QACD,KAAK,CAAC,OAAO;YACX,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;YACnB,CAAC;YAAC,MAAM,CAAC;gBACP,gCAAgC;YAClC,CAAC;YACD,MAAM,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { dropDatabase } from './allocator';\nimport { loadPg, TestPostgresServerError, TestServerOptions } from './server';\n\n/** The built test database handle. */\nexport interface TestPostgresDatabase {\n  /** Normal PostgreSQL connection string identifying only this database. */\n  readonly url: string;\n  query(sql: string, params?: readonly unknown[]): Promise<unknown>;\n  /** Close helper connections and drop the owned database. Idempotent. */\n  dispose(): Promise<void>;\n}\n\nexport interface OwnedDatabase {\n  readonly name: string;\n  readonly url: string;\n}\n\n/**\n * Connect a helper pool to an allocated database and produce the handle.\n * The handle owns exactly this database and drops it on dispose.\n */\nexport async function createDatabaseHandle(\n  owned: OwnedDatabase,\n  options: TestServerOptions = {}\n): Promise<TestPostgresDatabase & { _pool: any }> {\n  const pg = await loadPg();\n  const Pool = pg.Pool ?? pg.default?.Pool;\n  const pool = new Pool({ connectionString: owned.url, max: 4 });\n  let disposed = false;\n  return {\n    url: owned.url,\n    _pool: pool,\n    async query(sql: string, params: readonly unknown[] = []) {\n      if (disposed) {\n        throw new TestPostgresServerError(\n          `Test database \"${owned.name}\" has been disposed; no further queries are possible.`\n        );\n      }\n      const res = await pool.query(sql, params as unknown[]);\n      return res.rows;\n    },\n    async dispose() {\n      if (disposed) return;\n      disposed = true;\n      try {\n        await pool.end();\n      } catch {\n        /* pool may already be closed */\n      }\n      await dropDatabase(owned.name, options);\n    },\n  };\n}\n"]}