@contractspec/lib.runtime-sandbox 2.7.6 → 2.7.9

package/src/web/runtime/services.ts

@@ -4,26 +4,24 @@
  * Uses lazy-loading for PGLite to avoid bundle bloat.
  */
 import type { DatabasePort } from '@contractspec/lib.runtime-sandbox';
-
+import { SANDBOX_MIGRATIONS } from '../database/migrations';
 import { LocalEventBus } from '../events/local-pubsub';
 import { LocalGraphQLClient } from '../graphql/local-client';
 import { LocalStorageService } from '../storage/indexeddb';
 
-import { SANDBOX_MIGRATIONS } from '../database/migrations';
-
 export type TemplateId = string;
 
 export interface LocalRuntimeInitOptions {
-  /**
-   * Data directory for IndexedDB persistence (optional).
-   * If omitted, uses in-memory database.
-   */
-  dataDir?: string;
+	/**
+	 * Data directory for IndexedDB persistence (optional).
+	 * If omitted, uses in-memory database.
+	 */
+	dataDir?: string;
 }
 
 export interface TemplateSeedOptions {
-  templateId: TemplateId;
-  projectId?: string;
+	templateId: TemplateId;
+	projectId?: string;
 }
 
 const DEFAULT_PROJECT_ID = 'local-project' as const;
@@ -34,99 +32,100 @@ const DEFAULT_PROJECT_ID = 'local-project' as const;
  * Provides lazy-loaded database access via DatabasePort interface.
  */
 export class LocalRuntimeServices {
-  readonly storage = new LocalStorageService();
-  readonly pubsub = new LocalEventBus();
-  #initialized = false;
-
-  private _db?: DatabasePort;
-
-  /**
-   * Get the database port (must be initialized first).
-   */
-  get db(): DatabasePort {
-    if (!this._db) {
-      throw new Error(
-        'LocalRuntimeServices not initialized. Call init() first.'
-      );
-    }
-    return this._db;
-  }
-
-  private _graphql?: LocalGraphQLClient;
-
-  /**
-   * Get the GraphQL client (must be initialized first).
-   */
-  get graphql(): LocalGraphQLClient {
-    if (!this._graphql) {
-      throw new Error(
-        'LocalRuntimeServices not initialized. Call init() first.'
-      );
-    }
-    return this._graphql;
-  }
-
-  /**
-   * Initialize the runtime services.
-   *
-   * Lazy-loads PGLite adapter to avoid bundle bloat.
-   */
-  async init(options: LocalRuntimeInitOptions = {}): Promise<void> {
-    if (this.#initialized) return;
-
-    // Lazy-load PGLite adapter
-    const { createPGLiteAdapter } =
-      await import('@contractspec/lib.runtime-sandbox');
-    this._db = await createPGLiteAdapter();
-    await this._db.init({ dataDir: options.dataDir });
-
-    // Run migrations
-    await this._db.migrate(SANDBOX_MIGRATIONS);
-
-    // Initialize storage
-    await this.storage.init();
-
-    // Initialize GraphQL client with the new database port
-    this._graphql = new LocalGraphQLClient({
-      db: this._db,
-      storage: this.storage,
-      pubsub: this.pubsub,
-    });
-
-    this.#initialized = true;
-  }
-
-  /**
-   * Check if runtime is initialized.
-   */
-  isInitialized(): boolean {
-    return this.#initialized;
-  }
-
-  /**
-   * Seed the database with deterministic defaults for a template.
-   *
-   * - No randomness
-   * - No wall-clock timestamps
-   * - Unknown templates are a no-op (safe default)
-   */
-  async seedTemplate(options: TemplateSeedOptions): Promise<void> {
-    if (!this.#initialized) {
-      throw new Error('Call init() before seeding templates.');
-    }
-
-    const projectId = options.projectId ?? DEFAULT_PROJECT_ID;
-
-    if (!this._db) {
-      throw new Error('Database not initialized');
-    }
-
-    // Lazy-load seeders to avoid bundle bloat
-    const { seedTemplate } = await import('./seeders');
-    await seedTemplate({
-      templateId: options.templateId,
-      projectId,
-      db: this._db,
-    });
-  }
+	readonly storage = new LocalStorageService();
+	readonly pubsub = new LocalEventBus();
+	#initialized = false;
+
+	private _db?: DatabasePort;
+
+	/**
+	 * Get the database port (must be initialized first).
+	 */
+	get db(): DatabasePort {
+		if (!this._db) {
+			throw new Error(
+				'LocalRuntimeServices not initialized. Call init() first.'
+			);
+		}
+		return this._db;
+	}
+
+	private _graphql?: LocalGraphQLClient;
+
+	/**
+	 * Get the GraphQL client (must be initialized first).
+	 */
+	get graphql(): LocalGraphQLClient {
+		if (!this._graphql) {
+			throw new Error(
+				'LocalRuntimeServices not initialized. Call init() first.'
+			);
+		}
+		return this._graphql;
+	}
+
+	/**
+	 * Initialize the runtime services.
+	 *
+	 * Lazy-loads PGLite adapter to avoid bundle bloat.
+	 */
+	async init(options: LocalRuntimeInitOptions = {}): Promise<void> {
+		if (this.#initialized) return;
+
+		// Lazy-load PGLite adapter
+		const { createPGLiteAdapter } = await import(
+			'@contractspec/lib.runtime-sandbox'
+		);
+		this._db = await createPGLiteAdapter();
+		await this._db.init({ dataDir: options.dataDir });
+
+		// Run migrations
+		await this._db.migrate(SANDBOX_MIGRATIONS);
+
+		// Initialize storage
+		await this.storage.init();
+
+		// Initialize GraphQL client with the new database port
+		this._graphql = new LocalGraphQLClient({
+			db: this._db,
+			storage: this.storage,
+			pubsub: this.pubsub,
+		});
+
+		this.#initialized = true;
+	}
+
+	/**
+	 * Check if runtime is initialized.
+	 */
+	isInitialized(): boolean {
+		return this.#initialized;
+	}
+
+	/**
+	 * Seed the database with deterministic defaults for a template.
+	 *
+	 * - No randomness
+	 * - No wall-clock timestamps
+	 * - Unknown templates are a no-op (safe default)
+	 */
+	async seedTemplate(options: TemplateSeedOptions): Promise<void> {
+		if (!this.#initialized) {
+			throw new Error('Call init() before seeding templates.');
+		}
+
+		const projectId = options.projectId ?? DEFAULT_PROJECT_ID;
+
+		if (!this._db) {
+			throw new Error('Database not initialized');
+		}
+
+		// Lazy-load seeders to avoid bundle bloat
+		const { seedTemplate } = await import('./seeders');
+		await seedTemplate({
+			templateId: options.templateId,
+			projectId,
+			db: this._db,
+		});
+	}
 }

package/src/web/storage/indexeddb.ts

@@ -1,7 +1,7 @@
 export interface LocalStorageOptions {
-  dbName?: string;
-  storeName?: string;
-  version?: number;
+	dbName?: string;
+	storeName?: string;
+	version?: number;
 }
 
 const DEFAULT_DB_NAME = 'contractspec-runtime';
@@ -9,108 +9,108 @@ const DEFAULT_STORE = 'kv';
 const FALLBACK_STORE = new Map<string, unknown>();
 
 export class LocalStorageService {
-  private dbPromise?: Promise<IDBDatabase | null>;
+	private dbPromise?: Promise<IDBDatabase | null>;
 
-  constructor(private readonly options: LocalStorageOptions = {}) {}
+	constructor(private readonly options: LocalStorageOptions = {}) {}
 
-  async init(): Promise<void> {
-    await this.getDb();
-  }
+	async init(): Promise<void> {
+		await this.getDb();
+	}
 
-  async get<TValue = unknown>(
-    key: string,
-    fallback?: TValue
-  ): Promise<TValue | undefined> {
-    const db = await this.getDb();
-    if (!db) {
-      return (FALLBACK_STORE.get(key) as TValue | undefined) ?? fallback;
-    }
-    return new Promise((resolve, reject) => {
-      const tx = db.transaction(this.storeName, 'readonly');
-      const store = tx.objectStore(this.storeName);
-      const request = store.get(key);
-      request.onsuccess = () => {
-        resolve((request.result as TValue | undefined) ?? fallback);
-      };
-      request.onerror = () => reject(request.error);
-    });
-  }
+	async get<TValue = unknown>(
+		key: string,
+		fallback?: TValue
+	): Promise<TValue | undefined> {
+		const db = await this.getDb();
+		if (!db) {
+			return (FALLBACK_STORE.get(key) as TValue | undefined) ?? fallback;
+		}
+		return new Promise((resolve, reject) => {
+			const tx = db.transaction(this.storeName, 'readonly');
+			const store = tx.objectStore(this.storeName);
+			const request = store.get(key);
+			request.onsuccess = () => {
+				resolve((request.result as TValue | undefined) ?? fallback);
+			};
+			request.onerror = () => reject(request.error);
+		});
+	}
 
-  async set<TValue = unknown>(key: string, value: TValue): Promise<void> {
-    const db = await this.getDb();
-    if (!db) {
-      FALLBACK_STORE.set(key, value);
-      return;
-    }
-    await new Promise<void>((resolve, reject) => {
-      const tx = db.transaction(this.storeName, 'readwrite');
-      const store = tx.objectStore(this.storeName);
-      const request = store.put(value, key);
-      request.onsuccess = () => resolve();
-      request.onerror = () => reject(request.error);
-    });
-  }
+	async set<TValue = unknown>(key: string, value: TValue): Promise<void> {
+		const db = await this.getDb();
+		if (!db) {
+			FALLBACK_STORE.set(key, value);
+			return;
+		}
+		await new Promise<void>((resolve, reject) => {
+			const tx = db.transaction(this.storeName, 'readwrite');
+			const store = tx.objectStore(this.storeName);
+			const request = store.put(value, key);
+			request.onsuccess = () => resolve();
+			request.onerror = () => reject(request.error);
+		});
+	}
 
-  async delete(key: string): Promise<void> {
-    const db = await this.getDb();
-    if (!db) {
-      FALLBACK_STORE.delete(key);
-      return;
-    }
-    await new Promise<void>((resolve, reject) => {
-      const tx = db.transaction(this.storeName, 'readwrite');
-      const store = tx.objectStore(this.storeName);
-      const request = store.delete(key);
-      request.onsuccess = () => resolve();
-      request.onerror = () => reject(request.error);
-    });
-  }
+	async delete(key: string): Promise<void> {
+		const db = await this.getDb();
+		if (!db) {
+			FALLBACK_STORE.delete(key);
+			return;
+		}
+		await new Promise<void>((resolve, reject) => {
+			const tx = db.transaction(this.storeName, 'readwrite');
+			const store = tx.objectStore(this.storeName);
+			const request = store.delete(key);
+			request.onsuccess = () => resolve();
+			request.onerror = () => reject(request.error);
+		});
+	}
 
-  async clear(): Promise<void> {
-    const db = await this.getDb();
-    if (!db) {
-      FALLBACK_STORE.clear();
-      return;
-    }
-    await new Promise<void>((resolve, reject) => {
-      const tx = db.transaction(this.storeName, 'readwrite');
-      const store = tx.objectStore(this.storeName);
-      const request = store.clear();
-      request.onsuccess = () => resolve();
-      request.onerror = () => reject(request.error);
-    });
-  }
+	async clear(): Promise<void> {
+		const db = await this.getDb();
+		if (!db) {
+			FALLBACK_STORE.clear();
+			return;
+		}
+		await new Promise<void>((resolve, reject) => {
+			const tx = db.transaction(this.storeName, 'readwrite');
+			const store = tx.objectStore(this.storeName);
+			const request = store.clear();
+			request.onsuccess = () => resolve();
+			request.onerror = () => reject(request.error);
+		});
+	}
 
-  private get storeName() {
-    return this.options.storeName ?? DEFAULT_STORE;
-  }
+	private get storeName() {
+		return this.options.storeName ?? DEFAULT_STORE;
+	}
 
-  private async getDb(): Promise<IDBDatabase | null> {
-    if (typeof indexedDB === 'undefined') {
-      return null;
-    }
-    if (!this.dbPromise) {
-      this.dbPromise = this.openDb();
-    }
-    return this.dbPromise;
-  }
+	private async getDb(): Promise<IDBDatabase | null> {
+		if (typeof indexedDB === 'undefined') {
+			return null;
+		}
+		if (!this.dbPromise) {
+			this.dbPromise = this.openDb();
+		}
+		return this.dbPromise;
+	}
 
-  private openDb(): Promise<IDBDatabase> {
-    return new Promise((resolve, reject) => {
-      const request = indexedDB.open(
-        this.options.dbName ?? DEFAULT_DB_NAME,
-        this.options.version ?? 1
-      );
-      request.onerror = () => reject(request.error);
-      request.onsuccess = () => {
-        resolve(request.result);
-      };
-      request.onupgradeneeded = () => {
-        const db = request.result;
-        if (!db.objectStoreNames.contains(this.storeName)) {
-          db.createObjectStore(this.storeName);
-        }
-      };
-    });
-  }
+	private openDb(): Promise<IDBDatabase> {
+		return new Promise((resolve, reject) => {
+			const request = indexedDB.open(
+				this.options.dbName ?? DEFAULT_DB_NAME,
+				this.options.version ?? 1
+			);
+			request.onerror = () => reject(request.error);
+			request.onsuccess = () => {
+				resolve(request.result);
+			};
+			request.onupgradeneeded = () => {
+				const db = request.result;
+				if (!db.objectStoreNames.contains(this.storeName)) {
+					db.createObjectStore(this.storeName);
+				}
+			};
+		});
+	}
 }

package/src/web/utils/id.ts

@@ -1,7 +1,7 @@
 export function generateId(prefix?: string): string {
-  const base =
-    typeof crypto !== 'undefined' && 'randomUUID' in crypto
-      ? crypto.randomUUID()
-      : Math.random().toString(36).slice(2, 10);
-  return prefix ? `${prefix}_${base}` : base;
+	const base =
+		typeof crypto !== 'undefined' && 'randomUUID' in crypto
+			? crypto.randomUUID()
+			: Math.random().toString(36).slice(2, 10);
+	return prefix ? `${prefix}_${base}` : base;
 }