@fusebase/fusebase-gate-sdk 2.2.2-sdk.21 → 2.2.2-sdk.23

package/dist/apis/IsolatedStoresApi.d.ts

@@ -5,10 +5,23 @@
  * Domain: isolated-stores
  */
 import type { Client } from "../runtime/transport";
-import type { CountIsolatedStoreNoSqlDocumentsRequestContract, CountIsolatedStoreNoSqlDocumentsResponseContract, CreateIsolatedStoreCheckpointRequestContract, CreateIsolatedStoreCheckpointResponseContract, CreateIsolatedStoreNoSqlCollectionRequestContract, CreateIsolatedStoreNoSqlCollectionResponseContract, CreateIsolatedStoreRequestContract, CreateIsolatedStoreResponseContract, DeleteIsolatedStoreNoSqlDocumentResponseContract, DeleteIsolatedStoreStageResponseContract, ImportIsolatedStoreNoSqlDocumentsRequestContract, ImportIsolatedStoreNoSqlDocumentsResponseContract, InitIsolatedStoreStageRequestContract, InitIsolatedStoreStageResponseContract, IsolatedStoreIdInPathRequired, IsolatedStoreListResponseContract, IsolatedStoreNoSqlCollectionNameInPathRequired, IsolatedStoreNoSqlDocumentIdInPathRequired, IsolatedStoreNoSqlDocumentResponseContract, IsolatedStoreNoSqlListCollectionsResponseContract, IsolatedStoreNoSqlStatsResponseContract, IsolatedStoreResponseContract, IsolatedStoreRevisionIdInPathRequired, IsolatedStoreRevisionListResponseContract, IsolatedStoreSqlBatchInsertRequestContract, IsolatedStoreSqlBatchInsertResponseContract, IsolatedStoreSqlCountRequestContract, IsolatedStoreSqlCountResponseContract, IsolatedStoreSqlDeleteRequestContract, IsolatedStoreSqlDeleteResponseContract, IsolatedStoreSqlDescribeTableResponseContract, IsolatedStoreSqlExecuteRequestContract, IsolatedStoreSqlExecuteResponseContract, IsolatedStoreSqlImportRequestContract, IsolatedStoreSqlImportResponseContract, IsolatedStoreSqlInsertRequestContract, IsolatedStoreSqlInsertResponseContract, IsolatedStoreSqlListTablesResponseContract, IsolatedStoreSqlQueryRequestContract, IsolatedStoreSqlQueryResponseContract, IsolatedStoreSqlSchemaNameInQueryOptional, IsolatedStoreSqlSelectRequestContract, IsolatedStoreSqlSelectResponseContract, IsolatedStoreSqlStatsResponseContract, IsolatedStoreSqlTableNameInPathRequired, IsolatedStoreSqlUpdateRequestContract, IsolatedStoreSqlUpdateResponseContract, IsolatedStoreStageInPathRequired, IsolatedStoreStageListResponseContract, orgIdInPathRequired, PutIsolatedStoreNoSqlDocumentRequestContract, PutIsolatedStoreNoSqlDocumentResponseContract, QueryIsolatedStoreNoSqlDocumentsRequestContract, QueryIsolatedStoreNoSqlDocumentsResponseContract, RestoreIsolatedStoreRevisionResponseContract } from "../types";
+import type { ApplyIsolatedStoreSqlMigrationsRequestContract, ApplyIsolatedStoreSqlMigrationsResponseContract, CountIsolatedStoreNoSqlDocumentsRequestContract, CountIsolatedStoreNoSqlDocumentsResponseContract, CreateIsolatedStoreCheckpointRequestContract, CreateIsolatedStoreCheckpointResponseContract, CreateIsolatedStoreNoSqlCollectionRequestContract, CreateIsolatedStoreNoSqlCollectionResponseContract, CreateIsolatedStoreRequestContract, CreateIsolatedStoreResponseContract, DeleteIsolatedStoreNoSqlDocumentResponseContract, DeleteIsolatedStoreStageResponseContract, GetIsolatedStoreSqlMigrationStatusRequestContract, ImportIsolatedStoreNoSqlDocumentsRequestContract, ImportIsolatedStoreNoSqlDocumentsResponseContract, InitIsolatedStoreStageRequestContract, InitIsolatedStoreStageResponseContract, IsolatedStoreIdInPathRequired, IsolatedStoreListResponseContract, IsolatedStoreNoSqlCollectionNameInPathRequired, IsolatedStoreNoSqlDocumentIdInPathRequired, IsolatedStoreNoSqlDocumentResponseContract, IsolatedStoreNoSqlListCollectionsResponseContract, IsolatedStoreNoSqlStatsResponseContract, IsolatedStoreResponseContract, IsolatedStoreRevisionIdInPathRequired, IsolatedStoreRevisionListResponseContract, IsolatedStoreSqlBatchInsertRequestContract, IsolatedStoreSqlBatchInsertResponseContract, IsolatedStoreSqlCountRequestContract, IsolatedStoreSqlCountResponseContract, IsolatedStoreSqlDeleteRequestContract, IsolatedStoreSqlDeleteResponseContract, IsolatedStoreSqlDescribeTableResponseContract, IsolatedStoreSqlExecuteRequestContract, IsolatedStoreSqlExecuteResponseContract, IsolatedStoreSqlImportRequestContract, IsolatedStoreSqlImportResponseContract, IsolatedStoreSqlInsertRequestContract, IsolatedStoreSqlInsertResponseContract, IsolatedStoreSqlListTablesResponseContract, IsolatedStoreSqlMigrationStatusContract, IsolatedStoreSqlQueryRequestContract, IsolatedStoreSqlQueryResponseContract, IsolatedStoreSqlSchemaNameInQueryOptional, IsolatedStoreSqlSelectRequestContract, IsolatedStoreSqlSelectResponseContract, IsolatedStoreSqlStatsResponseContract, IsolatedStoreSqlTableNameInPathRequired, IsolatedStoreSqlUpdateRequestContract, IsolatedStoreSqlUpdateResponseContract, IsolatedStoreStageInPathRequired, IsolatedStoreStageListResponseContract, ListIsolatedStoresClientIdInQueryOptional, orgIdInPathRequired, PutIsolatedStoreNoSqlDocumentRequestContract, PutIsolatedStoreNoSqlDocumentResponseContract, QueryIsolatedStoreNoSqlDocumentsRequestContract, QueryIsolatedStoreNoSqlDocumentsResponseContract, RestoreIsolatedStoreRevisionResponseContract } from "../types";
 export declare class IsolatedStoresApi {
     private client;
     constructor(client: Client);
+    /**
+     * Apply SQL migrations
+     * Applies pending postgres migrations from an ordered migration bundle into the selected stage database. For prod, gate creates a checkpoint automatically before applying pending migrations. Applied history must match the bundle prefix exactly; drifted stages are rejected. MCP clients often cap tool_call JSON body size (on the order of a few thousand characters); the request includes full SQL text for every bundle version cumulatively, so large bundles may fail or truncate in chat-only MCP. For schema work under tight limits prefer executeIsolatedStoreSql with one statement per call and keep canonical SQL plus a manifest for apply from SDK or non-MCP callers.
+     */
+    applyIsolatedStoreSqlMigrations(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            storeId: IsolatedStoreIdInPathRequired;
+            stage: IsolatedStoreStageInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: ApplyIsolatedStoreSqlMigrationsRequestContract;
+    }): Promise<ApplyIsolatedStoreSqlMigrationsResponseContract>;
     /**
      * Batch insert rows
      * Inserts multiple rows into a postgres table with a shared column set. Row cap per request is floor(65535 / columnCount) (Postgres bind-parameter limit). For very large loads use importIsolatedStoreSqlRows (COPY FROM STDIN).
@@ -114,7 +127,7 @@ export declare class IsolatedStoresApi {
     }): Promise<IsolatedStoreSqlDeleteResponseContract>;
     /**
      * Delete isolated store stage
-     * Removes the stage instance and its revisions. When the stage was auto-provisioned on the isolated Postgres or isolated Mongo server, gate also drops the provisioned database after registry rows are removed.
+     * Removes the stage instance and its revisions. When the stage was auto-provisioned on the isolated Postgres or isolated Mongo server, gate also drops the provisioned database after registry rows are removed. After deletion the stage no longer appears in listIsolatedStoreStages; recreate it with initIsolatedStoreStage using the same stage name.
      */
     deleteIsolatedStoreStage(params: {
         path: {
@@ -142,7 +155,7 @@ export declare class IsolatedStoresApi {
     }): Promise<IsolatedStoreSqlDescribeTableResponseContract>;
     /**
      * Run writable SQL statement
-     * Runs a single SQL statement with execute access against the postgres binding of the selected isolated store stage instance.
+     * Runs a single SQL statement with execute access against the postgres binding of the selected isolated store stage instance. Unlike applyIsolatedStoreSqlMigrations, this does not record entries in the stage migration journal (fusebase_schema_migrations); after DDL applied only via execute, that table may be absent until a proper migration apply runs.
      */
     executeIsolatedStoreSql(params: {
         path: {
@@ -190,6 +203,19 @@ export declare class IsolatedStoresApi {
         };
         headers?: Record<string, string>;
     }): Promise<IsolatedStoreNoSqlStatsResponseContract>;
+    /**
+     * Get SQL migration status
+     * Compares an ordered SQL migration bundle with the migration journal stored inside the selected postgres stage database. Returns applied migrations, pending migrations, and drift issues when the applied history no longer matches the bundle prefix.
+     */
+    getIsolatedStoreSqlMigrationStatus(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            storeId: IsolatedStoreIdInPathRequired;
+            stage: IsolatedStoreStageInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: GetIsolatedStoreSqlMigrationStatusRequestContract;
+    }): Promise<IsolatedStoreSqlMigrationStatusContract>;
     /**
      * Get SQL stats
      * Returns table-level stats for the selected isolated postgres stage, including tables, columns, row counts, and relation-size hints.
@@ -279,12 +305,15 @@ export declare class IsolatedStoresApi {
     }): Promise<IsolatedStoreRevisionListResponseContract>;
     /**
      * List isolated stores
-     * Returns the isolated store registry for the organization. This is a control-plane endpoint behind FEATURE_FLAGS=isolated_stores.
+     * Returns the isolated store registry for the organization. Optional query `clientId` limits results to stores whose `app` source scope `sourceId` matches (same identifier as the token `client` scope for app-owned stores). Omit or leave empty to list all org stores. This is a control-plane endpoint behind FEATURE_FLAGS=isolated_stores.
      */
     listIsolatedStores(params: {
         path: {
             orgId: orgIdInPathRequired;
         };
+        query?: {
+            clientId?: ListIsolatedStoresClientIdInQueryOptional;
+        };
         headers?: Record<string, string>;
     }): Promise<IsolatedStoreListResponseContract>;
     /**

package/dist/apis/IsolatedStoresApi.js

@@ -11,6 +11,21 @@ class IsolatedStoresApi {
     constructor(client) {
         this.client = client;
     }
+    /**
+     * Apply SQL migrations
+     * Applies pending postgres migrations from an ordered migration bundle into the selected stage database. For prod, gate creates a checkpoint automatically before applying pending migrations. Applied history must match the bundle prefix exactly; drifted stages are rejected. MCP clients often cap tool_call JSON body size (on the order of a few thousand characters); the request includes full SQL text for every bundle version cumulatively, so large bundles may fail or truncate in chat-only MCP. For schema work under tight limits prefer executeIsolatedStoreSql with one statement per call and keep canonical SQL plus a manifest for apply from SDK or non-MCP callers.
+     */
+    async applyIsolatedStoreSqlMigrations(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/isolated-stores/:storeId/stages/:stage/sql/migrations/apply",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "applyIsolatedStoreSqlMigrations",
+            expectedContentType: "application/json",
+        });
+    }
     /**
      * Batch insert rows
      * Inserts multiple rows into a postgres table with a shared column set. Row cap per request is floor(65535 / columnCount) (Postgres bind-parameter limit). For very large loads use importIsolatedStoreSqlRows (COPY FROM STDIN).
@@ -132,7 +147,7 @@ class IsolatedStoresApi {
     }
     /**
      * Delete isolated store stage
-     * Removes the stage instance and its revisions. When the stage was auto-provisioned on the isolated Postgres or isolated Mongo server, gate also drops the provisioned database after registry rows are removed.
+     * Removes the stage instance and its revisions. When the stage was auto-provisioned on the isolated Postgres or isolated Mongo server, gate also drops the provisioned database after registry rows are removed. After deletion the stage no longer appears in listIsolatedStoreStages; recreate it with initIsolatedStoreStage using the same stage name.
      */
     async deleteIsolatedStoreStage(params) {
         return this.client.request({
@@ -161,7 +176,7 @@ class IsolatedStoresApi {
     }
     /**
      * Run writable SQL statement
-     * Runs a single SQL statement with execute access against the postgres binding of the selected isolated store stage instance.
+     * Runs a single SQL statement with execute access against the postgres binding of the selected isolated store stage instance. Unlike applyIsolatedStoreSqlMigrations, this does not record entries in the stage migration journal (fusebase_schema_migrations); after DDL applied only via execute, that table may be absent until a proper migration apply runs.
      */
     async executeIsolatedStoreSql(params) {
         return this.client.request({
@@ -216,6 +231,21 @@ class IsolatedStoresApi {
             expectedContentType: "application/json",
         });
     }
+    /**
+     * Get SQL migration status
+     * Compares an ordered SQL migration bundle with the migration journal stored inside the selected postgres stage database. Returns applied migrations, pending migrations, and drift issues when the applied history no longer matches the bundle prefix.
+     */
+    async getIsolatedStoreSqlMigrationStatus(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/isolated-stores/:storeId/stages/:stage/sql/migrations/status",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "getIsolatedStoreSqlMigrationStatus",
+            expectedContentType: "application/json",
+        });
+    }
     /**
      * Get SQL stats
      * Returns table-level stats for the selected isolated postgres stage, including tables, columns, row counts, and relation-size hints.
@@ -320,13 +350,14 @@ class IsolatedStoresApi {
     }
     /**
      * List isolated stores
-     * Returns the isolated store registry for the organization. This is a control-plane endpoint behind FEATURE_FLAGS=isolated_stores.
+     * Returns the isolated store registry for the organization. Optional query `clientId` limits results to stores whose `app` source scope `sourceId` matches (same identifier as the token `client` scope for app-owned stores). Omit or leave empty to list all org stores. This is a control-plane endpoint behind FEATURE_FLAGS=isolated_stores.
      */
     async listIsolatedStores(params) {
         return this.client.request({
             method: "GET",
             path: "/:orgId/isolated-stores",
             pathParams: params.path,
+            query: params.query,
             headers: params.headers,
             opId: "listIsolatedStores",
             expectedContentType: "application/json",

package/dist/types/isolated-store/isolated-store.d.ts

@@ -115,6 +115,51 @@ export interface IsolatedStoreSqlStatsResponseContract {
     totalBytes?: number | null;
     tables: IsolatedStoreSqlTableStatsContract[];
 }
+export interface IsolatedStoreSqlMigrationBundleEntryContract {
+    version: number;
+    name: string;
+    checksum: string;
+    sql: string;
+}
+export interface IsolatedStoreSqlMigrationBundleContract {
+    bundleVersion?: string | null;
+    migrations: IsolatedStoreSqlMigrationBundleEntryContract[];
+}
+export interface IsolatedStoreSqlAppliedMigrationContract {
+    version: number;
+    name: string;
+    checksum: string;
+    bundleVersion?: string | null;
+    appliedAt: string;
+    appliedBy: string;
+}
+export interface IsolatedStoreSqlMigrationStatusContract {
+    databaseName: string;
+    schemaName: string;
+    journalTableName: string;
+    currentVersion?: number | null;
+    bundleHeadVersion?: number | null;
+    appliedCount: number;
+    pendingCount: number;
+    isDrifted: boolean;
+    issues: string[];
+    appliedMigrations: IsolatedStoreSqlAppliedMigrationContract[];
+    pendingMigrations: IsolatedStoreSqlMigrationBundleEntryContract[];
+}
+export interface GetIsolatedStoreSqlMigrationStatusRequestContract {
+    schemaName?: IsolatedStoreSqlSchemaNameInQueryOptional;
+    bundle: IsolatedStoreSqlMigrationBundleContract;
+}
+export interface ApplyIsolatedStoreSqlMigrationsRequestContract {
+    schemaName?: IsolatedStoreSqlSchemaNameInQueryOptional;
+    bundle: IsolatedStoreSqlMigrationBundleContract;
+}
+export interface ApplyIsolatedStoreSqlMigrationsResponseContract {
+    appliedCount: number;
+    appliedVersions: number[];
+    checkpointRevision?: IsolatedStoreRevisionContract | null;
+    status: IsolatedStoreSqlMigrationStatusContract;
+}
 export interface IsolatedStoreSqlListTablesResponseContract {
     tables: IsolatedStoreSqlTableContract[];
 }
@@ -247,6 +292,8 @@ export interface CreateIsolatedStoreResponseContract {
 export interface IsolatedStoreListResponseContract {
     stores: IsolatedStoreContract[];
 }
+/** Optional `clientId` query for `listIsolatedStores`; matches `app` source scope `sourceId`. */
+export type ListIsolatedStoresClientIdInQueryOptional = string | null;
 export interface IsolatedStoreResponseContract {
     store: IsolatedStoreContract;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusebase/fusebase-gate-sdk",
-  "version": "2.2.2-sdk.21",
+  "version": "2.2.2-sdk.23",
   "description": "TypeScript SDK for Fusebase Gate APIs - Generated from contract introspection",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/release-notes/2.2.2-sdk.23.md

@@ -0,0 +1,9 @@
+# Release Notes 2.2.2-sdk.23
+
+- Current ref: `HEAD`
+- Previous tag: `v2.2.2-sdk.23`
+- Generated at: 2026-04-04T20:19:21.907Z
+
+## Included Drafts
+
+- None

package/release-notes/latest.md

@@ -1,8 +1,8 @@
-# Release Notes 2.2.2-sdk.21
+# Release Notes 2.2.2-sdk.23
 
 - Current ref: `HEAD`
-- Previous tag: `v2.2.2-sdk.21`
-- Generated at: 2026-04-04T17:29:28.929Z
+- Previous tag: `v2.2.2-sdk.23`
+- Generated at: 2026-04-04T20:19:21.907Z
 
 ## Included Drafts
 

package/release-notes/2.2.2-sdk.21.md

@@ -1,9 +0,0 @@
-# Release Notes 2.2.2-sdk.21
-
-- Current ref: `HEAD`
-- Previous tag: `v2.2.2-sdk.21`
-- Generated at: 2026-04-04T17:29:28.929Z
-
-## Included Drafts
-
-- None