@contractspec/lib.runtime-sandbox 0.12.0 → 0.14.0

package/dist/ports/database.port.d.ts

@@ -1,6 +1,4 @@
-import { DatabaseInitOptions, DbRow, DbValue, Migration, QueryResult, TransactionContext } from "../types/database.types.js";
-
-//#region src/ports/database.port.d.ts
+import type { DatabaseInitOptions, DbRow, DbValue, Migration, QueryResult, TransactionContext } from '../types/database.types';
 /**
  * Database port interface for sandbox runtime.
  *
@@ -11,59 +9,57 @@ import { DatabaseInitOptions, DbRow, DbValue, Migration, QueryResult, Transactio
  *
  * All implementations must be lazy-loadable to avoid bundle bloat.
  */
-interface DatabasePort {
-  /**
-   * Initialize the database connection and run migrations.
-   */
-  init(options?: DatabaseInitOptions): Promise<void>;
-  /**
-   * Close the database connection and release resources.
-   */
-  close(): Promise<void>;
-  /**
-   * Check if the database is initialized.
-   */
-  isInitialized(): boolean;
-  /**
-   * Execute a SELECT query and return rows.
-   *
-   * @param sql - SQL query string with $1, $2, etc. placeholders
-   * @param params - Query parameters
-   * @returns Query result with typed rows
-   */
-  query<T = DbRow>(sql: string, params?: DbValue[]): Promise<QueryResult<T>>;
-  /**
-   * Execute an INSERT/UPDATE/DELETE statement.
-   *
-   * @param sql - SQL statement with $1, $2, etc. placeholders
-   * @param params - Statement parameters
-   */
-  execute(sql: string, params?: DbValue[]): Promise<void>;
-  /**
-   * Run a callback within a database transaction.
-   * Automatically commits on success, rolls back on error.
-   *
-   * @param callback - Function to execute within transaction
-   * @returns Result of the callback
-   */
-  transaction<T>(callback: (ctx: TransactionContext) => Promise<T>): Promise<T>;
-  /**
-   * Run schema migrations.
-   *
-   * @param migrations - Array of migrations to apply
-   */
-  migrate(migrations: Migration[]): Promise<void>;
-  /**
-   * Export the current database state as a binary blob.
-   * Useful for backup/restore in browser context.
-   */
-  export(): Promise<Uint8Array>;
+export interface DatabasePort {
+    /**
+     * Initialize the database connection and run migrations.
+     */
+    init(options?: DatabaseInitOptions): Promise<void>;
+    /**
+     * Close the database connection and release resources.
+     */
+    close(): Promise<void>;
+    /**
+     * Check if the database is initialized.
+     */
+    isInitialized(): boolean;
+    /**
+     * Execute a SELECT query and return rows.
+     *
+     * @param sql - SQL query string with $1, $2, etc. placeholders
+     * @param params - Query parameters
+     * @returns Query result with typed rows
+     */
+    query<T = DbRow>(sql: string, params?: DbValue[]): Promise<QueryResult<T>>;
+    /**
+     * Execute an INSERT/UPDATE/DELETE statement.
+     *
+     * @param sql - SQL statement with $1, $2, etc. placeholders
+     * @param params - Statement parameters
+     */
+    execute(sql: string, params?: DbValue[]): Promise<void>;
+    /**
+     * Run a callback within a database transaction.
+     * Automatically commits on success, rolls back on error.
+     *
+     * @param callback - Function to execute within transaction
+     * @returns Result of the callback
+     */
+    transaction<T>(callback: (ctx: TransactionContext) => Promise<T>): Promise<T>;
+    /**
+     * Run schema migrations.
+     *
+     * @param migrations - Array of migrations to apply
+     */
+    migrate(migrations: Migration[]): Promise<void>;
+    /**
+     * Export the current database state as a binary blob.
+     * Useful for backup/restore in browser context.
+     */
+    export(): Promise<Uint8Array>;
 }
 /**
  * Factory function type for creating database adapters.
  * Used for lazy-loading adapters.
  */
-type DatabaseAdapterFactory = (options?: DatabaseInitOptions) => Promise<DatabasePort>;
-//#endregion
-export { DatabaseAdapterFactory, DatabasePort };
+export type DatabaseAdapterFactory = (options?: DatabaseInitOptions) => Promise<DatabasePort>;
 //# sourceMappingURL=database.port.d.ts.map

package/dist/ports/database.port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database.port.d.ts","names":[],"sources":["../../src/ports/database.port.ts"],"mappings":";;;;;AAmBA;;;;;;;;UAAiB,YAAA;EAuB4C;;;EAnB3D,IAAA,CAAK,OAAA,GAAU,mBAAA,GAAsB,OAAA;EAoCN;;;EA/B/B,KAAA,IAAS,OAAA;EA+B0D;;;EA1BnE,aAAA;EAuCU;;;;;;;EA9BV,KAAA,KAAU,KAAA,EAAO,GAAA,UAAa,MAAA,GAAS,OAAA,KAAY,OAAA,CAAQ,WAAA,CAAY,CAAA;EAd9D;;;;;;EAsBT,OAAA,CAAQ,GAAA,UAAa,MAAA,GAAS,OAAA,KAAY,OAAA;EARZ;;;;;;;EAiB9B,WAAA,IAAe,QAAA,GAAW,GAAA,EAAK,kBAAA,KAAuB,OAAA,CAAQ,CAAA,IAAK,OAAA,CAAQ,CAAA;EATjC;;;;;EAgB1C,OAAA,CAAQ,UAAA,EAAY,SAAA,KAAc,OAAA;EAP4B;;;;EAa9D,MAAA,IAAU,OAAA,CAAQ,UAAA;AAAA;;;;;KAOR,sBAAA,IACV,OAAA,GAAU,mBAAA,KACP,OAAA,CAAQ,YAAA"}
+{"version":3,"file":"database.port.d.ts","sourceRoot":"","sources":["../../src/ports/database.port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,KAAK,EACL,OAAO,EACP,SAAS,EACT,WAAW,EACX,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC;IAEzB;;;;;;OAMG;IACH,KAAK,CAAC,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3E;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;;;;;OAMG;IACH,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE9E;;;;OAIG;IACH,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACnC,OAAO,CAAC,EAAE,mBAAmB,KAC1B,OAAO,CAAC,YAAY,CAAC,CAAC"}

package/dist/ports/index.d.ts

@@ -0,0 +1,2 @@
+export { type DatabaseAdapterFactory, type DatabasePort, } from './database.port';
+//# sourceMappingURL=index.d.ts.map

package/dist/ports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ports/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC"}

package/dist/types/database.types.d.ts

@@ -1,47 +1,44 @@
-//#region src/types/database.types.d.ts
 /**
  * Database value types supported by the sandbox runtime
  */
-type DbValue = string | number | boolean | null | Uint8Array | Date | undefined;
+export type DbValue = string | number | boolean | null | Uint8Array | Date | undefined;
 /**
  * Generic row type for database results
  */
-type DbRow = Record<string, DbValue>;
+export type DbRow = Record<string, DbValue>;
 /**
  * Options for initializing a database adapter
  */
-interface DatabaseInitOptions {
-  /**
-   * Data directory for persistence (optional).
-   * - Browser: uses IndexedDB when specified
-   * - Node/Bun: uses file system when specified
-   * - If omitted, uses in-memory storage
-   */
-  dataDir?: string;
+export interface DatabaseInitOptions {
+    /**
+     * Data directory for persistence (optional).
+     * - Browser: uses IndexedDB when specified
+     * - Node/Bun: uses file system when specified
+     * - If omitted, uses in-memory storage
+     */
+    dataDir?: string;
 }
 /**
  * Query builder result type
  */
-interface QueryResult<T = DbRow> {
-  rows: T[];
-  rowCount: number;
+export interface QueryResult<T = DbRow> {
+    rows: T[];
+    rowCount: number;
 }
 /**
  * Transaction context for atomic operations
  */
-interface TransactionContext {
-  /**
-   * Execute raw SQL within the transaction
-   */
-  execute(sql: string, params?: DbValue[]): Promise<void>;
+export interface TransactionContext {
+    /**
+     * Execute raw SQL within the transaction
+     */
+    execute(sql: string, params?: DbValue[]): Promise<void>;
 }
 /**
  * Migration definition
  */
-interface Migration {
-  id: string;
-  sql: string;
+export interface Migration {
+    id: string;
+    sql: string;
 }
-//#endregion
-export { DatabaseInitOptions, DbRow, DbValue, Migration, QueryResult, TransactionContext };
 //# sourceMappingURL=database.types.d.ts.map

package/dist/types/database.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database.types.d.ts","names":[],"sources":["../../src/types/database.types.ts"],"mappings":";;AAGA;;KAAY,OAAA,sCAKR,UAAA,GACA,IAAA;;;AAMJ;KAAY,KAAA,GAAQ,MAAA,SAAe,OAAA;;;;UAKlB,mBAAA;EAAmB;;;;AAapC;;EANE,OAAA;AAAA;;;;UAMe,WAAA,KAAgB,KAAA;EAC/B,IAAA,EAAM,CAAA;EACN,QAAA;AAAA;AAMF;;;AAAA,UAAiB,kBAAA;EAIf;;;EAAA,OAAA,CAAQ,GAAA,UAAa,MAAA,GAAS,OAAA,KAAY,OAAA;AAAA;;;AAM5C;UAAiB,SAAA;EACf,EAAA;EACA,GAAA;AAAA"}
+{"version":3,"file":"database.types.d.ts","sourceRoot":"","sources":["../../src/types/database.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,OAAO,GACf,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,UAAU,GACV,IAAI,GACJ,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,KAAK;IACpC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './database.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/web/database/migrations.d.ts

@@ -1,11 +1,13 @@
-import { Migration } from "@contractspec/lib.runtime-sandbox";
-
-//#region src/web/database/migrations.d.ts
+/**
+ * Schema migrations for PGLite sandbox runtime.
+ *
+ * These migrations create all tables defined in schema.ts.
+ * Using raw SQL for migrations to work with DatabasePort interface.
+ */
+import type { Migration } from '@contractspec/lib.runtime-sandbox';
 /**
  * All migrations for the sandbox runtime database.
  * Each migration should be idempotent (CREATE TABLE IF NOT EXISTS).
  */
-declare const SANDBOX_MIGRATIONS: Migration[];
-//#endregion
-export { SANDBOX_MIGRATIONS };
+export declare const SANDBOX_MIGRATIONS: Migration[];
 //# sourceMappingURL=migrations.d.ts.map

package/dist/web/database/migrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.d.ts","names":[],"sources":["../../../src/web/database/migrations.ts"],"mappings":";;;;;;;cAYa,kBAAA,EAAoB,SAAA"}
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../src/web/database/migrations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,EA2uBzC,CAAC"}