sqlstack 3.3.0 → 3.5.0-dev.0

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

@@ -1 +1 @@
-{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../../src/testing/sqlite/builder.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'node:fs';\nimport { generateDdl } from '../schema/ddl';\nimport { parseTestSchema } from '../schema/parser';\nimport type { NormalizedTestSchema, ParseTestSchemaOptions } from '../schema/types';\nimport { createDatabaseHandle, TestSqliteDatabase, TestSqliteError } from './database';\nimport { composeRows, DataOperation, insertRows, Row, toOperations } from './loadData';\n\nexport interface TestSqliteOptions extends ParseTestSchemaOptions {\n  /**\n   * Storage for the test database. Defaults to `'file'`: an owned temporary\n   * file, removed on `dispose()`. Pass `'memory'` to opt back into an isolated\n   * `:memory:` database — only worth it for a test that opens many databases\n   * and never touches restart behavior.\n   */\n  mode?: 'memory' | 'file';\n  /** Legacy alias for `mode`. `false` selects `:memory:`. */\n  fileBacked?: boolean;\n  /** Legacy alias for `mode`. `false` selects `:memory:`. */\n  tempFile?: boolean;\n}\n\nexport interface TestSqliteBuilder {\n  readonly schema: NormalizedTestSchema;\n  readonly ops: readonly DataOperation[];\n  data(rows: Record<string, Row[]>): TestSqliteBuilder;\n  build(): Promise<TestSqliteDatabase>;\n}\n\ninterface BuilderState {\n  readonly schema: NormalizedTestSchema;\n  readonly ops: readonly DataOperation[];\n  readonly options: Readonly<TestSqliteOptions>;\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 TestSqliteError(\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\nasync function executeRaw(handle: TestSqliteDatabase, sql: string): Promise<void> {\n  const conn = handle.conn as { exec?: (sql: string) => unknown };\n  if (typeof conn?.exec === 'function') {\n    await conn.exec(sql);\n  } else {\n    await handle.db.query(sql, []);\n  }\n}\n\nfunction makeBuilder(state: BuilderState): TestSqliteBuilder {\n  return {\n    schema: state.schema,\n    ops: state.ops,\n    data(rows: Record<string, Row[]>): TestSqliteBuilder {\n      return makeBuilder({\n        ...state,\n        ops: [...state.ops, ...toOperations(state.schema, rows)],\n      });\n    },\n    async build(): Promise<TestSqliteDatabase> {\n      const rawSql = readRawSql(state.schema);\n      const ddl = generateDdl(state.schema);\n      const effective = composeRows(state.schema, state.ops);\n      const fileBacked = state.options.mode\n        ? state.options.mode === 'file'\n        : state.options.fileBacked !== false && state.options.tempFile !== false;\n      const handle = await createDatabaseHandle(fileBacked);\n      try {\n        for (const statement of ddl) {\n          try {\n            await handle.db.query(statement, []);\n          } catch (err) {\n            throw new TestSqliteError(\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            await executeRaw(handle, entry.sql);\n          } catch (err) {\n            throw new TestSqliteError(\n              `Failed to apply raw ${entry.label} from ${state.schema.source}: ${(err as Error).message}`\n            );\n          }\n        }\n        await insertRows((sql, params) => handle.db.query(sql, params), state.schema, effective);\n        return handle;\n      } catch (err) {\n        await handle.dispose();\n        throw err;\n      }\n    },\n  };\n}\n\nexport function testSqlite(\n  schema: string | object,\n  options: TestSqliteOptions = {}\n): TestSqliteBuilder {\n  const normalized = isNormalizedSchema(schema)\n    ? schema\n    : parseTestSchema(schema as string | object, options);\n  if (normalized.dialect !== 'sqlite') {\n    throw new TestSqliteError(\n      `testSqlite requires a schema with dialect: sqlite (received: ${normalized.dialect})`\n    );\n  }\n  return makeBuilder({\n    schema: normalized,\n    ops: [],\n    options: Object.freeze({ ...options }),\n  });\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"]}
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../../src/testing/sqlite/builder.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'node:fs';\nimport { adoptFixtureResource, TestDatabaseBuildError } from '../resource';\nimport { assertFixtureSqlFile } from '../fixture-provenance';\nimport { generateDdl } from '../schema/ddl';\nimport { parseTestSchema } from '../schema/parser';\nimport type { NormalizedTestSchema, ParseTestSchemaOptions } from '../schema/types';\nimport { createDatabaseHandle, TestSqliteDatabase, TestSqliteError } from './database';\nimport { composeRows, DataOperation, insertRows, Row, toOperations } from './loadData';\n\nexport interface TestSqliteOptions extends ParseTestSchemaOptions {\n  /**\n   * Storage for the test database. Defaults to `'file'`: an owned temporary\n   * file, removed on `dispose()`. Pass `'memory'` to opt back into an isolated\n   * `:memory:` database — only worth it for a test that opens many databases\n   * and never touches restart behavior.\n   */\n  mode?: 'memory' | 'file';\n  /** Legacy alias for `mode`. `false` selects `:memory:`. */\n  fileBacked?: boolean;\n  /** Legacy alias for `mode`. `false` selects `:memory:`. */\n  tempFile?: boolean;\n}\n\nexport interface TestSqliteBuilder {\n  readonly schema: NormalizedTestSchema;\n  readonly ops: readonly DataOperation[];\n  data(rows: Record<string, Row[]>): TestSqliteBuilder;\n  build(): Promise<TestSqliteDatabase>;\n}\n\ninterface BuilderState {\n  readonly schema: NormalizedTestSchema;\n  readonly ops: readonly DataOperation[];\n  readonly options: Readonly<TestSqliteOptions>;\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      assertFixtureSqlFile(entry.resolvedPath);\n      return {\n        label: `sql entry #${entry.index} (${entry.sourcePath})`,\n        sql: fs.readFileSync(entry.resolvedPath, 'utf8'),\n      };\n    } catch (err) {\n      throw new TestSqliteError(\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\nasync function executeRaw(handle: TestSqliteDatabase, sql: string): Promise<void> {\n  const conn = handle.conn as { exec?: (sql: string) => unknown };\n  if (typeof conn?.exec === 'function') {\n    await conn.exec(sql);\n  } else {\n    await handle.db.query(sql, []);\n  }\n}\n\nfunction makeBuilder(state: BuilderState): TestSqliteBuilder {\n  return {\n    schema: state.schema,\n    ops: state.ops,\n    data(rows: Record<string, Row[]>): TestSqliteBuilder {\n      return makeBuilder({\n        ...state,\n        ops: [...state.ops, ...toOperations(state.schema, rows)],\n      });\n    },\n    async build(): Promise<TestSqliteDatabase> {\n      const rawSql = readRawSql(state.schema);\n      const ddl = generateDdl(state.schema);\n      const effective = composeRows(state.schema, state.ops);\n      const fileBacked = state.options.mode\n        ? state.options.mode === 'file'\n        : state.options.fileBacked !== false && state.options.tempFile !== false;\n      const handle = await createDatabaseHandle(fileBacked);\n      try {\n        for (const statement of ddl) {\n          try {\n            await handle.db.query(statement, []);\n          } catch (err) {\n            throw new TestSqliteError(\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            await executeRaw(handle, entry.sql);\n          } catch (err) {\n            throw new TestSqliteError(\n              `Failed to apply raw ${entry.label} from ${state.schema.source}: ${(err as Error).message}`\n            );\n          }\n        }\n        await insertRows((sql, params) => handle.db.query(sql, params), state.schema, effective);\n        return adoptFixtureResource(handle);\n      } catch (err) {\n        try { await handle.dispose(); }\n        catch (cleanup) { throw new TestDatabaseBuildError('SQLite fixture build and cleanup failed', err, cleanup); }\n        throw err;\n      }\n    },\n  };\n}\n\nexport function testSqlite(\n  schema: string | object,\n  options: TestSqliteOptions = {}\n): TestSqliteBuilder {\n  const normalized = isNormalizedSchema(schema)\n    ? schema\n    : parseTestSchema(schema as string | object, options);\n  if (normalized.dialect !== 'sqlite') {\n    throw new TestSqliteError(\n      `testSqlite requires a schema with dialect: sqlite (received: ${normalized.dialect})`\n    );\n  }\n  return makeBuilder({\n    schema: normalized,\n    ops: [],\n    options: Object.freeze({ ...options }),\n  });\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/sqlite/database.js

@@ -3,6 +3,7 @@ import * as os from 'node:os';
 import * as path from 'node:path';
 import { createSqliteDb } from '../../adapters/sqlite.js';
 import { SqlStackError } from '../../core/errors.js';
+import { mintResourceId, registerResource, retireResource, runCleanupSteps, TestDatabaseDisposeError } from '../resource.js';
 export class TestSqliteError extends SqlStackError {
     constructor(message) {
         super(message);
@@ -32,6 +33,12 @@ function trackDirectory(directory) {
         }
     });
 }
+/** Remove exactly the SQLStack-owned temp directory; never a caller path. */
+function removeOwnedDirectory(directory) {
+    fs.rmSync(directory, { recursive: true, force: true });
+    // Keep failed paths in the owned inventory for the exit cleanup retry.
+    abandonedDirectories.delete(directory);
+}
 export async function createDatabaseHandle(fileBacked) {
     let directory;
     let filename = ':memory:';
@@ -46,8 +53,12 @@ export async function createDatabaseHandle(fileBacked) {
     }
     catch (err) {
         if (directory) {
-            fs.rmSync(directory, { recursive: true, force: true });
-            abandonedDirectories.delete(directory);
+            try {
+                removeOwnedDirectory(directory);
+            }
+            catch (cleanup) {
+                throw Object.assign(new TestDatabaseDisposeError('SQLite test allocation failed and owned cleanup failed', [err, cleanup]), { cause: err });
+            }
         }
         const message = err.message;
         if (message.includes('No SQLite driver available')) {
@@ -55,31 +66,34 @@ export async function createDatabaseHandle(fileBacked) {
         }
         throw new TestSqliteError(`Failed to create SQLite test database: ${message}`);
     }
-    let disposed = false;
-    return {
+    const storage = fileBacked ? 'file' : 'memory';
+    const resourceId = mintResourceId('sqlite');
+    const ownedDirectory = directory;
+    let disposal;
+    const handle = {
+        engine: 'sqlite',
+        resourceId,
+        storage,
         db,
         conn: db.conn,
         path: fileBacked ? filename : undefined,
         async query(sql, params = []) {
-            if (disposed)
+            if (disposal)
                 throw new TestSqliteError('Test SQLite database has been disposed.');
             return db.query(sql, [...params]);
         },
-        async dispose() {
-            if (disposed)
-                return;
-            disposed = true;
-            try {
-                await db.close();
-            }
-            catch {
-                /* connection may already be closed */
-            }
-            if (directory) {
-                fs.rmSync(directory, { recursive: true, force: true });
-                abandonedDirectories.delete(directory);
+        dispose() {
+            if (!disposal) {
+                retireResource(handle);
+                const steps = [() => db.close()];
+                if (ownedDirectory)
+                    steps.push(() => removeOwnedDirectory(ownedDirectory));
+                disposal = Promise.resolve().then(() => runCleanupSteps(`Test SQLite database (${storage})`, steps));
             }
+            return disposal;
         },
     };
+    registerResource(handle, { engine: 'sqlite', resourceId, storage });
+    return handle;
 }
 //# sourceMappingURL=database.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../../src/testing/sqlite/database.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'node:fs';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\nimport { createSqliteDb } from '../../adapters/sqlite';\nimport { SqlStackError } from '../../core/errors';\nimport type { Database } from '../../registry';\n\nexport class TestSqliteError extends SqlStackError {\n  constructor(message: string) {\n    super(message);\n    this.name = 'TestSqliteError';\n  }\n}\n\nexport interface TestSqliteDatabase {\n  /** The live sqlstack SQLite adapter, suitable for direct injection. */\n  readonly db: Database;\n  /** The underlying better-sqlite3 (or sqlite3) connection. */\n  readonly conn: unknown;\n  /** Absolute database path in file mode; undefined for :memory:. */\n  readonly path?: string;\n  query(sql: string, params?: readonly unknown[]): Promise<unknown>;\n  /** Close the connection and remove owned temporary files. Idempotent. */\n  dispose(): Promise<void>;\n}\n\n/**\n * Temp directories for file-backed handles that were never disposed. Tests are\n * expected to call `dispose()`, but a failed assertion can skip it; this keeps\n * an abandoned directory from outliving the worker process.\n */\nconst abandonedDirectories = new Set<string>();\nlet exitCleanupRegistered = false;\n\nfunction trackDirectory(directory: string): void {\n  abandonedDirectories.add(directory);\n  if (exitCleanupRegistered) return;\n  exitCleanupRegistered = true;\n  process.once('exit', () => {\n    for (const dir of abandonedDirectories) {\n      try {\n        fs.rmSync(dir, { recursive: true, force: true });\n      } catch {\n        /* best-effort cleanup */\n      }\n    }\n  });\n}\n\nexport async function createDatabaseHandle(\n  fileBacked: boolean\n): Promise<TestSqliteDatabase> {\n  let directory: string | undefined;\n  let filename = ':memory:';\n  if (fileBacked) {\n    directory = fs.mkdtempSync(path.join(os.tmpdir(), 'sqlstack-test-'));\n    filename = path.join(directory, 'database.sqlite');\n    trackDirectory(directory);\n  }\n\n  let db: Database;\n  try {\n    db = await createSqliteDb(filename);\n  } catch (err) {\n    if (directory) {\n      fs.rmSync(directory, { recursive: true, force: true });\n      abandonedDirectories.delete(directory);\n    }\n    const message = (err as Error).message;\n    if (message.includes('No SQLite driver available')) {\n      throw new TestSqliteError('testSqlite requires the optional peer \"better-sqlite3\".');\n    }\n    throw new TestSqliteError(`Failed to create SQLite test database: ${message}`);\n  }\n\n  let disposed = false;\n  return {\n    db,\n    conn: db.conn,\n    path: fileBacked ? filename : undefined,\n    async query(sql: string, params: readonly unknown[] = []) {\n      if (disposed) throw new TestSqliteError('Test SQLite database has been disposed.');\n      return db.query(sql, [...params]);\n    },\n    async dispose() {\n      if (disposed) return;\n      disposed = true;\n      try {\n        await db.close();\n      } catch {\n        /* connection may already be closed */\n      }\n      if (directory) {\n        fs.rmSync(directory, { recursive: true, force: true });\n        abandonedDirectories.delete(directory);\n      }\n    },\n  };\n}\n"]}
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../../src/testing/sqlite/database.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'node:fs';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\nimport { createSqliteDb } from '../../adapters/sqlite';\nimport { SqlStackError } from '../../core/errors';\nimport type { Database } from '../../registry';\nimport { mintResourceId, registerResource, retireResource, runCleanupSteps, TestDatabaseDisposeError } from '../resource';\n\nexport class TestSqliteError extends SqlStackError {\n  constructor(message: string) {\n    super(message);\n    this.name = 'TestSqliteError';\n  }\n}\n\nexport interface TestSqliteDatabase {\n  /** Engine discriminator for SQLStack-minted disposable test databases. */\n  readonly engine: 'sqlite';\n  /** Fresh per-allocation identifier; never reused within a process. */\n  readonly resourceId: string;\n  /** Explicit storage: an owned temporary file, or an isolated `:memory:` db. */\n  readonly storage: 'memory' | 'file';\n  /** The live sqlstack SQLite adapter, suitable for direct injection. */\n  readonly db: Database;\n  /** The underlying better-sqlite3 (or sqlite3) connection. */\n  readonly conn: unknown;\n  /** Absolute database path in file mode; undefined for :memory:. */\n  readonly path?: string;\n  query(sql: string, params?: readonly unknown[]): Promise<unknown>;\n  /**\n   * Close the connection and remove owned temporary files. Idempotent:\n   * concurrent and repeated calls share one outcome. Every cleanup step is\n   * attempted; failures are aggregated into a `TestDatabaseDisposeError`.\n   */\n  dispose(): Promise<void>;\n}\n\n/**\n * Temp directories for file-backed handles that were never disposed. Tests are\n * expected to call `dispose()`, but a failed assertion can skip it; this keeps\n * an abandoned directory from outliving the worker process.\n */\nconst abandonedDirectories = new Set<string>();\nlet exitCleanupRegistered = false;\n\nfunction trackDirectory(directory: string): void {\n  abandonedDirectories.add(directory);\n  if (exitCleanupRegistered) return;\n  exitCleanupRegistered = true;\n  process.once('exit', () => {\n    for (const dir of abandonedDirectories) {\n      try {\n        fs.rmSync(dir, { recursive: true, force: true });\n      } catch {\n        /* best-effort cleanup */\n      }\n    }\n  });\n}\n\n/** Remove exactly the SQLStack-owned temp directory; never a caller path. */\nfunction removeOwnedDirectory(directory: string): void {\n  fs.rmSync(directory, { recursive: true, force: true });\n  // Keep failed paths in the owned inventory for the exit cleanup retry.\n  abandonedDirectories.delete(directory);\n}\n\nexport async function createDatabaseHandle(\n  fileBacked: boolean\n): Promise<TestSqliteDatabase> {\n  let directory: string | undefined;\n  let filename = ':memory:';\n  if (fileBacked) {\n    directory = fs.mkdtempSync(path.join(os.tmpdir(), 'sqlstack-test-'));\n    filename = path.join(directory, 'database.sqlite');\n    trackDirectory(directory);\n  }\n\n  let db: Database;\n  try {\n    db = await createSqliteDb(filename);\n  } catch (err) {\n    if (directory) {\n      try { removeOwnedDirectory(directory); }\n      catch (cleanup) {\n        throw Object.assign(new TestDatabaseDisposeError('SQLite test allocation failed and owned cleanup failed', [err, cleanup]), { cause: err });\n      }\n    }\n    const message = (err as Error).message;\n    if (message.includes('No SQLite driver available')) {\n      throw new TestSqliteError('testSqlite requires the optional peer \"better-sqlite3\".');\n    }\n    throw new TestSqliteError(`Failed to create SQLite test database: ${message}`);\n  }\n\n  const storage: 'memory' | 'file' = fileBacked ? 'file' : 'memory';\n  const resourceId = mintResourceId('sqlite');\n  const ownedDirectory = directory;\n  let disposal: Promise<void> | undefined;\n\n  const handle: TestSqliteDatabase = {\n    engine: 'sqlite',\n    resourceId,\n    storage,\n    db,\n    conn: db.conn,\n    path: fileBacked ? filename : undefined,\n    async query(sql: string, params: readonly unknown[] = []) {\n      if (disposal) throw new TestSqliteError('Test SQLite database has been disposed.');\n      return db.query(sql, [...params]);\n    },\n    dispose() {\n      if (!disposal) {\n        retireResource(handle);\n        const steps: (() => Promise<void> | void)[] = [() => db.close()];\n        if (ownedDirectory) steps.push(() => removeOwnedDirectory(ownedDirectory));\n        disposal = Promise.resolve().then(() => runCleanupSteps(`Test SQLite database (${storage})`, steps));\n      }\n      return disposal;\n    },\n  };\n  registerResource(handle, { engine: 'sqlite', resourceId, storage });\n  return handle;\n}\n"]}