@granular-software/sdk 0.4.4 → 0.4.6

package/dist/index.mjs

@@ -4555,7 +4555,8 @@ var Session = class {
    * ```typescript
    * import { Author, Book, global_search } from './sandbox-tools';
    *
-   * const tolkien = await Author.find({ id: 'tolkien' });
+   * const authors = await Author.list({ limit: 10, saveAs: 'recent_authors' });
+   * const tolkien = await Author.get({ path: 'author_tolkien' });
    * const bio = await tolkien.get_bio({ detailed: true });
    * const books = await tolkien.get_books();
    * ```
@@ -5067,7 +5068,7 @@ var JobImplementation = class {
 
 // src/endpoints.ts
 var LOCAL_API_URL = "ws://localhost:8787/granular";
-var PRODUCTION_API_URL = "wss://api.granular.dev/v2/ws";
+var PRODUCTION_API_URL = "wss://cf-api-gateway.arthur6084.workers.dev/granular";
 function readEnv(name) {
   if (typeof process === "undefined" || !process.env) return void 0;
   return process.env[name];
@@ -5154,6 +5155,26 @@ function buildEffectHostUrl(apiUrl, sandboxId, effectClientId, clientId) {
   url.searchParams.set("clientId", clientId);
   return url.toString();
 }
+function createEmptyHeapSnapshot(now = Date.now()) {
+  return {
+    entriesByPath: {},
+    listsByName: {},
+    variablesByName: {},
+    updatedAt: now
+  };
+}
+function normalizeHeapSnapshot(raw) {
+  if (!raw || typeof raw !== "object") {
+    return createEmptyHeapSnapshot();
+  }
+  const heap = raw;
+  return {
+    entriesByPath: heap.entriesByPath && typeof heap.entriesByPath === "object" ? JSON.parse(JSON.stringify(heap.entriesByPath)) : {},
+    listsByName: heap.listsByName && typeof heap.listsByName === "object" ? JSON.parse(JSON.stringify(heap.listsByName)) : {},
+    variablesByName: heap.variablesByName && typeof heap.variablesByName === "object" ? JSON.parse(JSON.stringify(heap.variablesByName)) : {},
+    updatedAt: typeof heap.updatedAt === "number" ? heap.updatedAt : Date.now()
+  };
+}
 var Environment = class _Environment extends Session {
   envData;
   _apiKey;
@@ -5184,6 +5205,16 @@ var Environment = class _Environment extends Session {
   get apiEndpoint() {
     return this._apiEndpoint;
   }
+  /**
+   * Return a plain JS snapshot of the synced session heap.
+   *
+   * The heap lives in the Automerge document, so this method does not perform
+   * any extra network roundtrip.
+   */
+  getHeap() {
+    const doc = this.document;
+    return normalizeHeapSnapshot(doc?.heap);
+  }
   getRuntimeBaseUrl() {
     try {
       const endpoint = new URL(this._apiEndpoint);
@@ -6045,7 +6076,8 @@ var Granular = class {
       method: "POST",
       body: JSON.stringify({
         environmentId: envData.environmentId,
-        clientId
+        clientId,
+        initialHeap: options.initialHeap
       })
     });
     const client = new WSClient({
@@ -6096,7 +6128,21 @@ var Granular = class {
     const effects = Array.from(this.getSandboxEffectMap(host.sandboxId).values()).map(
       (effect) => this.serializeEffect(effect)
     );
-    await host.wsClient.call("effects.publishCatalog", { effects });
+    const result = await host.wsClient.call("effects.publishCatalog", { effects });
+    const acceptedCount = typeof result?.acceptedCount === "number" ? result.acceptedCount : 0;
+    const rejected = Array.isArray(result?.rejected) ? result.rejected : [];
+    if (acceptedCount === 0 && rejected.length > 0) {
+      const detail = rejected.map((entry) => `${entry.name || "unknown"}: ${entry.reason || "rejected"}`).join("; ");
+      throw new Error(
+        `Failed to publish live effects for sandbox ${host.sandboxId}: ${detail}`
+      );
+    }
+    if (rejected.length > 0) {
+      console.warn(
+        `[Granular] Some live effects were rejected for sandbox ${host.sandboxId}:`,
+        rejected
+      );
+    }
   }
   async syncSandboxEffectCatalog(sandboxId) {
     const host = await this.ensureSandboxEffectHost(sandboxId);
@@ -6262,6 +6308,22 @@ var Granular = class {
     }
     await this.syncSandboxEffectCatalog(sandboxId);
   }
+  /**
+   * Disconnect one sandbox-scoped effect host, or all of them when no sandbox is provided.
+   *
+   * This is primarily useful for long-lived helper processes such as generated
+   * `granular-effects.ts` scripts that need to shut down cleanly on SIGINT/SIGTERM.
+   */
+  async disconnectEffects(sandboxNameOrId) {
+    if (sandboxNameOrId) {
+      const sandbox = await this.findOrCreateSandbox(sandboxNameOrId);
+      this.disconnectSandboxEffectHost(sandbox.sandboxId);
+      return;
+    }
+    for (const sandboxId of Array.from(this.sandboxEffectHosts.keys())) {
+      this.disconnectSandboxEffectHost(sandboxId);
+    }
+  }
   /**
    * Unregister all effects for a sandbox.
    */