@fusebase/fusebase-gate-sdk 2.2.2-sdk.22 → 2.2.2-sdk.23
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/apis/IsolatedStoresApi.d.ts +8 -5
- package/dist/apis/IsolatedStoresApi.js +5 -4
- package/dist/types/isolated-store/isolated-store.d.ts +2 -0
- package/package.json +1 -1
- package/release-notes/2.2.2-sdk.23.md +9 -0
- package/release-notes/latest.md +3 -3
- package/release-notes/2.2.2-sdk.22.md +0 -9
|
@@ -5,13 +5,13 @@
|
|
|
5
5
|
* Domain: isolated-stores
|
|
6
6
|
*/
|
|
7
7
|
import type { Client } from "../runtime/transport";
|
|
8
|
-
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, orgIdInPathRequired, PutIsolatedStoreNoSqlDocumentRequestContract, PutIsolatedStoreNoSqlDocumentResponseContract, QueryIsolatedStoreNoSqlDocumentsRequestContract, QueryIsolatedStoreNoSqlDocumentsResponseContract, RestoreIsolatedStoreRevisionResponseContract } from "../types";
|
|
8
|
+
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";
|
|
9
9
|
export declare class IsolatedStoresApi {
|
|
10
10
|
private client;
|
|
11
11
|
constructor(client: Client);
|
|
12
12
|
/**
|
|
13
13
|
* Apply SQL migrations
|
|
14
|
-
* 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.
|
|
14
|
+
* 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.
|
|
15
15
|
*/
|
|
16
16
|
applyIsolatedStoreSqlMigrations(params: {
|
|
17
17
|
path: {
|
|
@@ -127,7 +127,7 @@ export declare class IsolatedStoresApi {
|
|
|
127
127
|
}): Promise<IsolatedStoreSqlDeleteResponseContract>;
|
|
128
128
|
/**
|
|
129
129
|
* Delete isolated store stage
|
|
130
|
-
* 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.
|
|
130
|
+
* 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.
|
|
131
131
|
*/
|
|
132
132
|
deleteIsolatedStoreStage(params: {
|
|
133
133
|
path: {
|
|
@@ -155,7 +155,7 @@ export declare class IsolatedStoresApi {
|
|
|
155
155
|
}): Promise<IsolatedStoreSqlDescribeTableResponseContract>;
|
|
156
156
|
/**
|
|
157
157
|
* Run writable SQL statement
|
|
158
|
-
* Runs a single SQL statement with execute access against the postgres binding of the selected isolated store stage instance.
|
|
158
|
+
* 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.
|
|
159
159
|
*/
|
|
160
160
|
executeIsolatedStoreSql(params: {
|
|
161
161
|
path: {
|
|
@@ -305,12 +305,15 @@ export declare class IsolatedStoresApi {
|
|
|
305
305
|
}): Promise<IsolatedStoreRevisionListResponseContract>;
|
|
306
306
|
/**
|
|
307
307
|
* List isolated stores
|
|
308
|
-
* Returns the isolated store registry for the organization. This is a control-plane endpoint behind FEATURE_FLAGS=isolated_stores.
|
|
308
|
+
* 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.
|
|
309
309
|
*/
|
|
310
310
|
listIsolatedStores(params: {
|
|
311
311
|
path: {
|
|
312
312
|
orgId: orgIdInPathRequired;
|
|
313
313
|
};
|
|
314
|
+
query?: {
|
|
315
|
+
clientId?: ListIsolatedStoresClientIdInQueryOptional;
|
|
316
|
+
};
|
|
314
317
|
headers?: Record<string, string>;
|
|
315
318
|
}): Promise<IsolatedStoreListResponseContract>;
|
|
316
319
|
/**
|
|
@@ -13,7 +13,7 @@ class IsolatedStoresApi {
|
|
|
13
13
|
}
|
|
14
14
|
/**
|
|
15
15
|
* Apply SQL migrations
|
|
16
|
-
* 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.
|
|
16
|
+
* 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.
|
|
17
17
|
*/
|
|
18
18
|
async applyIsolatedStoreSqlMigrations(params) {
|
|
19
19
|
return this.client.request({
|
|
@@ -147,7 +147,7 @@ class IsolatedStoresApi {
|
|
|
147
147
|
}
|
|
148
148
|
/**
|
|
149
149
|
* Delete isolated store stage
|
|
150
|
-
* 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.
|
|
150
|
+
* 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.
|
|
151
151
|
*/
|
|
152
152
|
async deleteIsolatedStoreStage(params) {
|
|
153
153
|
return this.client.request({
|
|
@@ -176,7 +176,7 @@ class IsolatedStoresApi {
|
|
|
176
176
|
}
|
|
177
177
|
/**
|
|
178
178
|
* Run writable SQL statement
|
|
179
|
-
* Runs a single SQL statement with execute access against the postgres binding of the selected isolated store stage instance.
|
|
179
|
+
* 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.
|
|
180
180
|
*/
|
|
181
181
|
async executeIsolatedStoreSql(params) {
|
|
182
182
|
return this.client.request({
|
|
@@ -350,13 +350,14 @@ class IsolatedStoresApi {
|
|
|
350
350
|
}
|
|
351
351
|
/**
|
|
352
352
|
* List isolated stores
|
|
353
|
-
* Returns the isolated store registry for the organization. This is a control-plane endpoint behind FEATURE_FLAGS=isolated_stores.
|
|
353
|
+
* 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.
|
|
354
354
|
*/
|
|
355
355
|
async listIsolatedStores(params) {
|
|
356
356
|
return this.client.request({
|
|
357
357
|
method: "GET",
|
|
358
358
|
path: "/:orgId/isolated-stores",
|
|
359
359
|
pathParams: params.path,
|
|
360
|
+
query: params.query,
|
|
360
361
|
headers: params.headers,
|
|
361
362
|
opId: "listIsolatedStores",
|
|
362
363
|
expectedContentType: "application/json",
|
|
@@ -292,6 +292,8 @@ export interface CreateIsolatedStoreResponseContract {
|
|
|
292
292
|
export interface IsolatedStoreListResponseContract {
|
|
293
293
|
stores: IsolatedStoreContract[];
|
|
294
294
|
}
|
|
295
|
+
/** Optional `clientId` query for `listIsolatedStores`; matches `app` source scope `sourceId`. */
|
|
296
|
+
export type ListIsolatedStoresClientIdInQueryOptional = string | null;
|
|
295
297
|
export interface IsolatedStoreResponseContract {
|
|
296
298
|
store: IsolatedStoreContract;
|
|
297
299
|
}
|
package/package.json
CHANGED
package/release-notes/latest.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
# Release Notes 2.2.2-sdk.
|
|
1
|
+
# Release Notes 2.2.2-sdk.23
|
|
2
2
|
|
|
3
3
|
- Current ref: `HEAD`
|
|
4
|
-
- Previous tag: `v2.2.2-sdk.
|
|
5
|
-
- Generated at: 2026-04-
|
|
4
|
+
- Previous tag: `v2.2.2-sdk.23`
|
|
5
|
+
- Generated at: 2026-04-04T20:19:21.907Z
|
|
6
6
|
|
|
7
7
|
## Included Drafts
|
|
8
8
|
|