@fusebase/fusebase-gate-sdk 2.2.2-sdk.34 → 2.2.2-sdk.36

package/dist/apis/IsolatedStoresApi.d.ts

@@ -5,10 +5,23 @@
  * Domain: isolated-stores
  */
 import type { Client } from "../runtime/transport";
-import type { ApplyIsolatedStoreSqlMigrationsRequestContract, ApplyIsolatedStoreSqlMigrationsResponseContract, CountIsolatedStoreNoSqlDocumentsRequestContract, CountIsolatedStoreNoSqlDocumentsResponseContract, CreateIsolatedStoreCheckpointRequestContract, CreateIsolatedStoreCheckpointResponseContract, CreateIsolatedStoreNoSqlCollectionRequestContract, CreateIsolatedStoreNoSqlCollectionResponseContract, CreateIsolatedStoreRequestContract, CreateIsolatedStoreResponseContract, DeleteIsolatedStoreNoSqlDocumentResponseContract, DeleteIsolatedStoreResponseContract, 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";
+import type { AdoptIsolatedStoreSqlMigrationBaselineRequestContract, AdoptIsolatedStoreSqlMigrationBaselineResponseContract, ApplyIsolatedStoreSqlMigrationsRequestContract, ApplyIsolatedStoreSqlMigrationsResponseContract, CountIsolatedStoreNoSqlDocumentsRequestContract, CountIsolatedStoreNoSqlDocumentsResponseContract, CreateIsolatedStoreCheckpointRequestContract, CreateIsolatedStoreCheckpointResponseContract, CreateIsolatedStoreNoSqlCollectionRequestContract, CreateIsolatedStoreNoSqlCollectionResponseContract, CreateIsolatedStoreRequestContract, CreateIsolatedStoreResponseContract, DeleteIsolatedStoreNoSqlDocumentResponseContract, DeleteIsolatedStoreResponseContract, 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);
+    /**
+     * Adopt existing SQL schema as migration baseline
+     * Records the supplied ordered migration bundle as already applied in the stage journal without executing SQL. Use this only for legacy or demo-created stages where schema objects already exist but the migration journal is empty or missing.
+     */
+    adoptIsolatedStoreSqlMigrationBaseline(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            storeId: IsolatedStoreIdInPathRequired;
+            stage: IsolatedStoreStageInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: AdoptIsolatedStoreSqlMigrationBaselineRequestContract;
+    }): Promise<AdoptIsolatedStoreSqlMigrationBaselineResponseContract>;
     /**
      * Apply SQL migrations
      * Workflow: call `getIsolatedStoreSqlMigrationStatus` with the **same** bundle, confirm `canApply` and expected `pendingCount`, then apply. Applies pending postgres migrations from an ordered 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; drift returns HTTP 409 with `data.issues` (version/name/checksum, journal vs bundle). Optional `dryRun: true` performs the same prefix + optimistic-lock checks as apply but does not run SQL or write the journal (returns `dryRun: true` and the computed status). Optional `expectedLastAppliedVersion` / `expectedLastAppliedChecksum` reject with HTTP 409 before migrations run when the journal tail changed since the client's last status snapshot. Never change name, checksum, or sql for migrations already in the journal — ship fixes as new higher versions (see MCP prompt isolatedSqlMigrationDiscipline). 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. Keep canonical SQL plus a manifest for apply from SDK, CLI, or any non-MCP caller without a tight body-size limit.

package/dist/apis/IsolatedStoresApi.js

@@ -11,6 +11,21 @@ class IsolatedStoresApi {
     constructor(client) {
         this.client = client;
     }
+    /**
+     * Adopt existing SQL schema as migration baseline
+     * Records the supplied ordered migration bundle as already applied in the stage journal without executing SQL. Use this only for legacy or demo-created stages where schema objects already exist but the migration journal is empty or missing.
+     */
+    async adoptIsolatedStoreSqlMigrationBaseline(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/isolated-stores/:storeId/stages/:stage/sql/migrations/adopt-baseline",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "adoptIsolatedStoreSqlMigrationBaseline",
+            expectedContentType: "application/json",
+        });
+    }
     /**
      * Apply SQL migrations
      * Workflow: call `getIsolatedStoreSqlMigrationStatus` with the **same** bundle, confirm `canApply` and expected `pendingCount`, then apply. Applies pending postgres migrations from an ordered 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; drift returns HTTP 409 with `data.issues` (version/name/checksum, journal vs bundle). Optional `dryRun: true` performs the same prefix + optimistic-lock checks as apply but does not run SQL or write the journal (returns `dryRun: true` and the computed status). Optional `expectedLastAppliedVersion` / `expectedLastAppliedChecksum` reject with HTTP 409 before migrations run when the journal tail changed since the client's last status snapshot. Never change name, checksum, or sql for migrations already in the journal — ship fixes as new higher versions (see MCP prompt isolatedSqlMigrationDiscipline). 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. Keep canonical SQL plus a manifest for apply from SDK, CLI, or any non-MCP caller without a tight body-size limit.

package/dist/extras/sqlMigrationBundle.d.ts

@@ -0,0 +1,13 @@
+import type { IsolatedStoreSqlMigrationBundleContract } from "../types";
+export interface BuildSqlMigrationBundleEntryInput {
+    version: number;
+    name: string;
+    sql: string;
+    expectedChecksum?: string | null;
+}
+export interface BuildSqlMigrationBundleInput {
+    bundleVersion?: string | null;
+    migrations: BuildSqlMigrationBundleEntryInput[];
+}
+export declare function calculateSqlMigrationChecksum(sql: string): Promise<string>;
+export declare function buildSqlMigrationBundle(input: BuildSqlMigrationBundleInput): Promise<IsolatedStoreSqlMigrationBundleContract>;

package/dist/extras/sqlMigrationBundle.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateSqlMigrationChecksum = calculateSqlMigrationChecksum;
+exports.buildSqlMigrationBundle = buildSqlMigrationBundle;
+function normalizePositiveInteger(value, field) {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new Error(`${field} must be a positive integer`);
+    }
+    return value;
+}
+function normalizeNonEmptyString(value, field) {
+    const normalized = value.trim();
+    if (normalized.length === 0) {
+        throw new Error(`${field} must be a non-empty string`);
+    }
+    return normalized;
+}
+function toSha256Hex(buffer) {
+    return Array.from(new Uint8Array(buffer))
+        .map((byte) => byte.toString(16).padStart(2, "0"))
+        .join("");
+}
+async function calculateSqlMigrationChecksum(sql) {
+    if (typeof globalThis.crypto === "undefined" ||
+        typeof globalThis.crypto.subtle === "undefined") {
+        throw new Error("SQL migration checksum requires globalThis.crypto.subtle (available in modern browsers and Node.js 20+)");
+    }
+    const bytes = new TextEncoder().encode(sql);
+    const digest = await globalThis.crypto.subtle.digest("SHA-256", bytes);
+    return toSha256Hex(digest);
+}
+async function buildSqlMigrationBundle(input) {
+    const bundleVersion = input.bundleVersion == null ? undefined : input.bundleVersion.trim();
+    const entries = [...input.migrations].sort((left, right) => {
+        return left.version - right.version;
+    });
+    if (entries.length === 0) {
+        throw new Error("migrations must contain at least one entry");
+    }
+    let previousVersion = 0;
+    const migrations = [];
+    for (const [index, entry] of entries.entries()) {
+        const version = normalizePositiveInteger(entry.version, `migrations[${index}].version`);
+        if (version === previousVersion) {
+            throw new Error(`Duplicate migration version ${String(version)}`);
+        }
+        if (version < previousVersion) {
+            throw new Error(`Migrations must be strictly increasing by version; got ${String(version)} after ${String(previousVersion)}`);
+        }
+        const name = normalizeNonEmptyString(entry.name, `migrations[${index}].name`);
+        const sql = entry.sql;
+        const checksum = await calculateSqlMigrationChecksum(sql);
+        const expectedChecksum = entry.expectedChecksum == null ? null : entry.expectedChecksum.trim();
+        if (expectedChecksum !== null && expectedChecksum !== checksum) {
+            throw new Error(`Checksum mismatch for migration v${String(version)} ${name}: expected ${expectedChecksum}, got ${checksum}`);
+        }
+        migrations.push({
+            version,
+            name,
+            checksum,
+            sql,
+        });
+        previousVersion = version;
+    }
+    return {
+        ...(bundleVersion && bundleVersion.length > 0 ? { bundleVersion } : {}),
+        migrations,
+    };
+}

package/dist/index.d.ts

@@ -18,3 +18,4 @@ export { SystemApi } from "./apis/SystemApi";
 export { TokensApi } from "./apis/TokensApi";
 export { WorkspacesApi } from "./apis/WorkspacesApi";
 export * from "./extras/fetchWithRetry";
+export * from "./extras/sqlMigrationBundle";

package/dist/index.js

@@ -47,3 +47,4 @@ Object.defineProperty(exports, "TokensApi", { enumerable: true, get: function ()
 var WorkspacesApi_1 = require("./apis/WorkspacesApi");
 Object.defineProperty(exports, "WorkspacesApi", { enumerable: true, get: function () { return WorkspacesApi_1.WorkspacesApi; } });
 __exportStar(require("./extras/fetchWithRetry"), exports);
+__exportStar(require("./extras/sqlMigrationBundle"), exports);

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

@@ -133,8 +133,8 @@ export interface IsolatedStoreSqlAppliedMigrationContract {
     appliedAt: string;
     appliedBy: string;
 }
-export type IsolatedStoreSqlMigrationIssueCodeContract = "isolated_sql_journal_longer_than_bundle" | "isolated_sql_version_mismatch" | "isolated_sql_name_mismatch" | "isolated_sql_checksum_mismatch" | "isolated_sql_journal_head_mismatch";
-export type IsolatedStoreSqlMigrationIssueFieldContract = "history_length" | "version" | "name" | "checksum" | "journal_head";
+export type IsolatedStoreSqlMigrationIssueCodeContract = "isolated_sql_journal_longer_than_bundle" | "isolated_sql_version_mismatch" | "isolated_sql_name_mismatch" | "isolated_sql_checksum_mismatch" | "isolated_sql_schema_exists_without_journal" | "isolated_sql_journal_head_mismatch";
+export type IsolatedStoreSqlMigrationIssueFieldContract = "history_length" | "version" | "name" | "checksum" | "bootstrap" | "journal_head";
 /** Machine-readable drift detail; omits raw SQL (only safe fingerprints). */
 export interface IsolatedStoreSqlMigrationIssueContract {
     code: IsolatedStoreSqlMigrationIssueCodeContract;
@@ -173,6 +173,8 @@ export interface IsolatedStoreSqlMigrationStatusContract {
     appliedCount: number;
     pendingCount: number;
     isDrifted: boolean;
+    /** True when the stage already has schema objects but no matching journaled migration history. */
+    requiresBaselineAdoption: boolean;
     /** True when the bundle prefix matches the journal and pending migrations may run. */
     canApply: boolean;
     issues: string[];
@@ -214,6 +216,19 @@ export interface ApplyIsolatedStoreSqlMigrationsResponseContract {
     /** Present and true when the request used `dryRun` and no migrations were executed. */
     dryRun?: boolean | null;
 }
+export interface AdoptIsolatedStoreSqlMigrationBaselineRequestContract {
+    schemaName?: IsolatedStoreSqlSchemaNameInQueryOptional;
+    bundle: IsolatedStoreSqlMigrationBundleContract;
+    /** Validate eligibility and return the projected post-adoption status without writing the journal. */
+    dryRun?: boolean | null;
+}
+export interface AdoptIsolatedStoreSqlMigrationBaselineResponseContract {
+    adoptedCount: number;
+    adoptedVersions: number[];
+    checkpointRevision?: IsolatedStoreRevisionContract | null;
+    status: IsolatedStoreSqlMigrationStatusContract;
+    dryRun?: boolean | null;
+}
 /** Documented shape of JSON error responses for migration state conflicts (HTTP 409). */
 export interface IsolatedStoreSqlMigrationConflictErrorBodyContract {
     success: false;
@@ -524,6 +539,7 @@ export declare const IsolatedStoreSqlMigrationIssueCodeContract: {
     readonly IsolatedSqlVersionMismatch: "isolated_sql_version_mismatch";
     readonly IsolatedSqlNameMismatch: "isolated_sql_name_mismatch";
     readonly IsolatedSqlChecksumMismatch: "isolated_sql_checksum_mismatch";
+    readonly IsolatedSqlSchemaExistsWithoutJournal: "isolated_sql_schema_exists_without_journal";
     readonly IsolatedSqlJournalHeadMismatch: "isolated_sql_journal_head_mismatch";
 };
 export declare const IsolatedStoreSqlMigrationIssueFieldContract: {
@@ -531,6 +547,7 @@ export declare const IsolatedStoreSqlMigrationIssueFieldContract: {
     readonly Version: "version";
     readonly Name: "name";
     readonly Checksum: "checksum";
+    readonly Bootstrap: "bootstrap";
     readonly JournalHead: "journal_head";
 };
 export declare const IsolatedStoreSqlFilterOperatorContract: {

package/dist/types/isolated-store/isolated-store.js

@@ -39,6 +39,7 @@ exports.IsolatedStoreSqlMigrationIssueCodeContract = {
     IsolatedSqlVersionMismatch: "isolated_sql_version_mismatch",
     IsolatedSqlNameMismatch: "isolated_sql_name_mismatch",
     IsolatedSqlChecksumMismatch: "isolated_sql_checksum_mismatch",
+    IsolatedSqlSchemaExistsWithoutJournal: "isolated_sql_schema_exists_without_journal",
     IsolatedSqlJournalHeadMismatch: "isolated_sql_journal_head_mismatch"
 };
 exports.IsolatedStoreSqlMigrationIssueFieldContract = {
@@ -46,6 +47,7 @@ exports.IsolatedStoreSqlMigrationIssueFieldContract = {
     Version: "version",
     Name: "name",
     Checksum: "checksum",
+    Bootstrap: "bootstrap",
     JournalHead: "journal_head"
 };
 exports.IsolatedStoreSqlFilterOperatorContract = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusebase/fusebase-gate-sdk",
-  "version": "2.2.2-sdk.34",
+  "version": "2.2.2-sdk.36",
   "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.36.md

@@ -0,0 +1,9 @@
+# Release Notes 2.2.2-sdk.36
+
+- Current ref: `HEAD`
+- Previous tag: `v2.2.2-sdk.36`
+- Generated at: 2026-04-10T03:07:09.796Z
+
+## Included Drafts
+
+- None

package/release-notes/latest.md

@@ -1,8 +1,8 @@
-# Release Notes 2.2.2-sdk.34
+# Release Notes 2.2.2-sdk.36
 
 - Current ref: `HEAD`
-- Previous tag: `v2.2.2-sdk.34`
-- Generated at: 2026-04-08T11:54:01.164Z
+- Previous tag: `v2.2.2-sdk.36`
+- Generated at: 2026-04-10T03:07:09.796Z
 
 ## Included Drafts
 

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

@@ -1,9 +0,0 @@
-# Release Notes 2.2.2-sdk.34
-
-- Current ref: `HEAD`
-- Previous tag: `v2.2.2-sdk.34`
-- Generated at: 2026-04-08T11:54:01.164Z
-
-## Included Drafts
-
-- None