@forge/sql 4.0.5-next.0 → 4.0.5-next.1-experimental-e9e08bb

package/CHANGELOG.md

@@ -0,0 +1,912 @@
+# @forge/sql
+
+## 4.0.5-next.1-experimental-e9e08bb
+
+### Patch Changes
+
+- 067c20a: Add manifest-driven Docker local storage, seeding, reset, status, persistent lifecycle, and local
+  SDK routing for Forge tunnels. Simplify `forge storage entities indexes list` to
+  `forge storage indexes list`.
+- 01e9f12: Include package changelogs in published artifacts.
+  - @forge/api@8.0.5-next.1-experimental-e9e08bb
+
+## 4.0.5-next.1
+
+### Patch Changes
+
+- 01e9f12: Include package changelogs in published artifacts.
+
+## 4.0.5-next.0
+
+### Patch Changes
+
+- @forge/api@8.0.5-next.0
+
+## 4.0.4
+
+### Patch Changes
+
+- @forge/api@8.0.4
+
+## 4.0.4-next.0
+
+### Patch Changes
+
+- @forge/api@8.0.4-next.0
+
+## 4.0.3
+
+### Patch Changes
+
+- @forge/api@8.0.3
+
+## 4.0.3-next.0
+
+### Patch Changes
+
+- @forge/api@8.0.3-next.0
+
+## 4.0.2
+
+### Patch Changes
+
+- @forge/api@8.0.2
+
+## 4.0.2-next.0
+
+### Patch Changes
+
+- @forge/api@8.0.2-next.0
+
+## 4.0.1
+
+### Patch Changes
+
+- @forge/api@8.0.1
+
+## 4.0.1-next.0
+
+### Patch Changes
+
+- @forge/api@8.0.1-next.0
+
+## 4.0.0
+
+### Major Changes
+
+- 78fcb7f: Adds support for TypeScript 5
+
+### Patch Changes
+
+- Updated dependencies [561f8f4]
+- Updated dependencies [78fcb7f]
+  - @forge/api@8.0.0
+
+## 4.0.0-next.1
+
+### Major Changes
+
+- 78fcb7f: Adds support for TypeScript 5
+
+### Patch Changes
+
+- Updated dependencies [78fcb7f]
+  - @forge/api@8.0.0-next.2
+
+## 3.0.27-next.0
+
+### Patch Changes
+
+- Updated dependencies [561f8f4]
+  - @forge/api@8.0.0-next.0
+
+## 3.0.26
+
+### Patch Changes
+
+- @forge/api@7.2.2
+
+## 3.0.26-next.0
+
+### Patch Changes
+
+- @forge/api@7.2.2-next.0
+
+## 3.0.25
+
+### Patch Changes
+
+- @forge/api@7.2.1
+
+## 3.0.25-next.0
+
+### Patch Changes
+
+- @forge/api@7.2.1-next.0
+
+## 3.0.24
+
+### Patch Changes
+
+- Updated dependencies [7d660c1]
+- Updated dependencies [56e38e9]
+  - @forge/api@7.2.0
+
+## 3.0.24-next.0
+
+### Patch Changes
+
+- Updated dependencies [56e38e9]
+  - @forge/api@7.2.0-next.0
+
+## 3.0.23
+
+### Patch Changes
+
+- @forge/api@7.1.4
+
+## 3.0.23-next.0
+
+### Patch Changes
+
+- @forge/api@7.1.4-next.0
+
+## 3.0.22
+
+### Patch Changes
+
+- @forge/api@7.1.3
+
+## 3.0.22-next.0
+
+### Patch Changes
+
+- @forge/api@7.1.3-next.0
+
+## 3.0.21
+
+### Patch Changes
+
+- @forge/api@7.1.2
+
+## 3.0.21-next.0
+
+### Patch Changes
+
+- @forge/api@7.1.2-next.0
+
+## 3.0.20
+
+### Patch Changes
+
+- @forge/api@7.1.1
+
+## 3.0.20-next.0
+
+### Patch Changes
+
+- @forge/api@7.1.1-next.0
+
+## 3.0.19
+
+### Patch Changes
+
+- Updated dependencies [16a4b01]
+- Updated dependencies [6f9a570]
+  - @forge/api@7.1.0
+
+## 3.0.19-next.1
+
+### Patch Changes
+
+- Updated dependencies [16a4b01]
+  - @forge/api@7.1.0-next.2
+
+## 3.0.19-next.0
+
+### Patch Changes
+
+- @forge/api@7.0.3-next.0
+
+## 3.0.18
+
+### Patch Changes
+
+- @forge/api@7.0.2
+
+## 3.0.18-next.0
+
+### Patch Changes
+
+- @forge/api@7.0.2-next.0
+
+## 3.0.17
+
+### Patch Changes
+
+- Updated dependencies [63d29ca]
+  - @forge/api@7.0.1
+
+## 3.0.17-next.0
+
+### Patch Changes
+
+- @forge/api@7.0.1-next.0
+
+## 3.0.16
+
+### Patch Changes
+
+- Updated dependencies [69e97f1]
+- Updated dependencies [8f24ce1]
+  - @forge/api@7.0.0
+
+## 3.0.16-next.1
+
+### Patch Changes
+
+- Updated dependencies [8f24ce1]
+  - @forge/api@7.0.0-next.3
+
+## 3.0.16-next.0
+
+### Patch Changes
+
+- @forge/api@6.4.4-next.0
+
+## 3.0.15
+
+### Patch Changes
+
+- @forge/api@6.4.3
+
+## 3.0.15-next.0
+
+### Patch Changes
+
+- @forge/api@6.4.3-next.0
+
+## 3.0.14
+
+### Patch Changes
+
+- Updated dependencies [16e7d61]
+  - @forge/api@6.4.2
+
+## 3.0.14-next.0
+
+### Patch Changes
+
+- @forge/api@6.4.2-next.0
+
+## 3.0.13
+
+### Patch Changes
+
+- Updated dependencies [6f348d9]
+  - @forge/api@6.4.1
+
+## 3.0.13-next.0
+
+### Patch Changes
+
+- @forge/api@6.4.1-next.0
+
+## 3.0.12
+
+### Patch Changes
+
+- Updated dependencies [5e160b1]
+- Updated dependencies [9989c3d]
+  - @forge/api@6.4.0
+
+## 3.0.12-next.0
+
+### Patch Changes
+
+- Updated dependencies [5e160b1]
+  - @forge/api@6.4.0-next.0
+
+## 3.0.11
+
+### Patch Changes
+
+- Updated dependencies [def4ec3]
+  - @forge/api@6.3.0
+
+## 3.0.11-next.1
+
+### Patch Changes
+
+- Updated dependencies [def4ec3]
+  - @forge/api@6.3.0-next.2
+
+## 3.0.11-next.0
+
+### Patch Changes
+
+- @forge/api@6.2.1-next.0
+
+## 3.0.10
+
+### Patch Changes
+
+- Updated dependencies [0af355f]
+  - @forge/api@6.2.0
+
+## 3.0.10-next.1
+
+### Patch Changes
+
+- Updated dependencies [0af355f]
+  - @forge/api@6.2.0-next.1
+
+## 3.0.10-next.0
+
+### Patch Changes
+
+- @forge/api@6.1.6-next.0
+
+## 3.0.9
+
+### Patch Changes
+
+- Updated dependencies [94243f1]
+  - @forge/api@6.1.5
+
+## 3.0.9-next.0
+
+### Patch Changes
+
+- Updated dependencies [94243f1]
+  - @forge/api@6.1.5-next.0
+
+## 3.0.8
+
+### Patch Changes
+
+- @forge/api@6.1.4
+
+## 3.0.8-next.0
+
+### Patch Changes
+
+- @forge/api@6.1.4-next.0
+
+## 3.0.7
+
+### Patch Changes
+
+- @forge/api@6.1.3
+
+## 3.0.7-next.0
+
+### Patch Changes
+
+- @forge/api@6.1.3-next.0
+
+## 3.0.6
+
+### Patch Changes
+
+- Updated dependencies [504cd62]
+  - @forge/api@6.1.2
+
+## 3.0.6-next.0
+
+### Patch Changes
+
+- Updated dependencies [504cd62]
+  - @forge/api@6.1.2-next.0
+
+## 3.0.5
+
+### Patch Changes
+
+- Updated dependencies [ad46892]
+  - @forge/api@6.1.1
+
+## 3.0.5-next.0
+
+### Patch Changes
+
+- Updated dependencies [ad46892]
+  - @forge/api@6.1.1-next.0
+
+## 3.0.4
+
+### Patch Changes
+
+- Updated dependencies [6392355]
+- Updated dependencies [518c490]
+  - @forge/api@6.1.0
+
+## 3.0.4-next.0
+
+### Patch Changes
+
+- Updated dependencies [518c490]
+  - @forge/api@6.1.0-next.0
+
+## 3.0.3
+
+### Patch Changes
+
+- @forge/api@6.0.3
+
+## 3.0.3-next.0
+
+### Patch Changes
+
+- @forge/api@6.0.3-next.0
+
+## 3.0.2
+
+### Patch Changes
+
+- 7abca30: Remove SDK dependency on @atlassian/ari
+- Updated dependencies [7abca30]
+- Updated dependencies [8916328]
+- Updated dependencies [e118b07]
+- Updated dependencies [ebad936]
+  - @forge/api@6.0.2
+
+## 3.0.2-next.0
+
+### Patch Changes
+
+- 7abca30: Remove SDK dependency on @atlassian/ari
+- Updated dependencies [7abca30]
+  - @forge/api@6.0.2-next.0
+
+## 3.0.1
+
+### Patch Changes
+
+- 195411c: patch dependencies
+- Updated dependencies [195411c]
+  - @forge/api@6.0.1
+
+## 3.0.1-next.0
+
+### Patch Changes
+
+- 195411c: patch dependencies
+- Updated dependencies [195411c]
+  - @forge/api@6.0.1-next.0
+
+## 3.0.0
+
+### Major Changes
+
+- 8f2a3c9: Update the package to build on Node 20
+
+### Patch Changes
+
+- Updated dependencies [8f2a3c9]
+  - @forge/api@6.0.0
+
+## 3.0.0-next.0
+
+### Major Changes
+
+- 8f2a3c9: Update the package to build on Node 20
+
+### Patch Changes
+
+- Updated dependencies [8f2a3c9]
+  - @forge/api@6.0.0-next.0
+
+## 2.5.2
+
+### Patch Changes
+
+- Updated dependencies [908388a]
+  - @forge/api@5.3.0
+
+## 2.5.2-next.0
+
+### Patch Changes
+
+- Updated dependencies [908388a]
+  - @forge/api@5.3.0-next.0
+
+## 2.5.1
+
+### Patch Changes
+
+- 984c454: Forcing patch bump to update internal registry
+- Updated dependencies [984c454]
+  - @forge/api@5.2.1
+
+## 2.5.1-next.0
+
+### Patch Changes
+
+- 984c454: Forcing patch bump to update internal registry
+- Updated dependencies [984c454]
+  - @forge/api@5.2.1-next.0
+
+## 2.5.0
+
+### Minor Changes
+
+- d2d1ee3: Deprecate `sql._provision()` helper
+
+  This was used during EAP, and no longer has any function. We are deprecating this helper and will remove it in next major version
+
+### Patch Changes
+
+- Updated dependencies [04ab98e]
+  - @forge/api@5.2.0
+
+## 2.5.0-next.1
+
+### Minor Changes
+
+- d2d1ee3: Deprecate `sql._provision()` helper
+
+  This was used during EAP, and no longer has any function. We are deprecating this helper and will remove it in next major version
+
+## 2.4.3-next.0
+
+### Patch Changes
+
+- Updated dependencies [04ab98e]
+  - @forge/api@5.2.0-next.0
+
+## 2.4.2
+
+### Patch Changes
+
+- Updated dependencies [576da26]
+  - @forge/api@5.1.1
+
+## 2.4.2-next.0
+
+### Patch Changes
+
+- Updated dependencies [576da26]
+  - @forge/api@5.1.1-next.0
+
+## 2.4.1
+
+### Patch Changes
+
+- fa77f8d: Revert the package registry change for the package
+- 503e60e: Add publish config
+- 2086b3d: Remove node-fetch as a dependency
+- 1de89c1: Upgrade dependencies
+- Updated dependencies [fa77f8d]
+- Updated dependencies [fa82e2a]
+- Updated dependencies [a72008e]
+- Updated dependencies [503e60e]
+- Updated dependencies [2086b3d]
+- Updated dependencies [55d56f7]
+  - @forge/api@5.1.0
+
+## 2.4.1-next.5
+
+### Patch Changes
+
+- fa77f8d: Revert the package registry change for the package
+- Updated dependencies [fa77f8d]
+  - @forge/api@5.1.0-next.9
+
+## 2.4.1-next.4
+
+### Patch Changes
+
+- 503e60e: Add publish config
+- Updated dependencies [503e60e]
+  - @forge/api@5.1.0-next.8
+
+## 2.4.1-next.3
+
+### Patch Changes
+
+- 2086b3d: Remove node-fetch as a dependency
+- Updated dependencies [2086b3d]
+  - @forge/api@5.1.0-next.7
+
+## 2.4.1-next.2
+
+### Patch Changes
+
+- Updated dependencies [a72008e]
+  - @forge/api@5.1.0-next.2
+
+## 2.4.1-next.1
+
+### Patch Changes
+
+- 1de89c1: Upgrade dependencies
+
+## 2.4.1-next.0
+
+### Patch Changes
+
+- Updated dependencies [55d56f7]
+  - @forge/api@5.0.2-next.0
+
+## 2.4.0
+
+### Minor Changes
+
+- 5330def: Updating dependencies
+
+### Patch Changes
+
+- a5e7647: Update license for Forge public packages
+- Updated dependencies [a5e7647]
+  - @forge/api@5.0.1
+
+## 2.4.0-next.2
+
+### Minor Changes
+
+- 5330def: Updating dependencies
+
+## 2.3.4-next.1
+
+### Patch Changes
+
+- a5e7647: Update license for Forge public packages
+- Updated dependencies [a5e7647]
+  - @forge/api@5.0.1-next.3
+
+## 2.3.4-next.0
+
+### Patch Changes
+
+- @forge/api@5.0.1-next.0
+
+## 2.3.3
+
+### Patch Changes
+
+- a5a6cfb: Replacing node-fetch client with Undici for HTTP requests
+- Updated dependencies [a5a6cfb]
+- Updated dependencies [05f0f1a]
+  - @forge/api@5.0.0
+
+## 2.3.3-next.0
+
+### Patch Changes
+
+- a5a6cfb: Replacing node-fetch client with Undici for HTTP requests
+- Updated dependencies [a5a6cfb]
+  - @forge/api@5.0.0-next.0
+
+## 2.3.2
+
+### Patch Changes
+
+- Updated dependencies [e23f188]
+- Updated dependencies [7e6baa1]
+  - @forge/api@4.3.0
+
+## 2.3.2-next.1
+
+### Patch Changes
+
+- Updated dependencies [e23f188]
+  - @forge/api@4.3.0-next.1
+
+## 2.3.2-next.0
+
+### Patch Changes
+
+- Updated dependencies [7e6baa1]
+  - @forge/api@4.2.1-next.0
+
+## 2.3.1
+
+### Patch Changes
+
+- Updated dependencies [c0f4d43]
+  - @forge/api@4.2.0
+
+## 2.3.1-next.0
+
+### Patch Changes
+
+- Updated dependencies [c0f4d43]
+  - @forge/api@4.2.0-next.0
+
+## 2.3.0
+
+### Minor Changes
+
+- 7c93596: Add a new endpoint /execute/ddl to execute ddl query
+- f11ed8f: Add error details with migration error
+
+## 2.3.0-next.1
+
+### Minor Changes
+
+- f11ed8f: Add error details with migration error
+
+## 2.3.0-next.0
+
+### Minor Changes
+
+- 7c93596: Add a new endpoint /execute/ddl to execute ddl query
+
+## 2.2.3
+
+### Patch Changes
+
+- Updated dependencies [01f334b]
+  - @forge/api@4.1.2
+
+## 2.2.3-next.0
+
+### Patch Changes
+
+- Updated dependencies [01f334b]
+  - @forge/api@4.1.2-next.0
+
+## 2.2.2
+
+### Patch Changes
+
+- @forge/api@4.1.1
+
+## 2.2.2-next.0
+
+### Patch Changes
+
+- @forge/api@4.1.1-next.0
+
+## 2.2.1
+
+### Patch Changes
+
+- 7dda52e:
+
+## 2.2.1-next.0
+
+### Patch Changes
+
+- 7dda52e:
+
+## 2.2.0
+
+### Minor Changes
+
+- 226ad1b: Add Generic type to SQL helpers
+
+  You can now pass a Generic type to the `prepare` and `executeRaw` functions to specify the row result type.
+
+  ```typescript
+  const statement = sql.prepare<{
+    id: number;
+    text: string;
+    modifiedAt: string;
+  }>('SELECT * FROM example WHERE id = ?');
+
+  const { rows } = statement.bindParams(42).execute();
+
+  rows;
+  // ^? Array<{ id: number, text: string, modifiedAt: string }>
+  ```
+
+### Patch Changes
+
+- 8e408f5: Fix response parsing bug for successive use of SqlClient.\_provision() helper
+
+  This adds new Error handling classes for SQL extending `ForgeSQLError`, though not fully used within the SDK yet
+
+- a431d3d: fix: Generic type for result supporting update response as a single value instead of array
+- Updated dependencies [a989ae4]
+  - @forge/api@4.1.0
+
+## 2.2.0-next.3
+
+### Patch Changes
+
+- 8e408f5: Fix response parsing bug for successive use of SqlClient.\_provision() helper
+
+  This adds new Error handling classes for SQL extending `ForgeSQLError`, though not fully used within the SDK yet
+
+## 2.2.0-next.2
+
+### Patch Changes
+
+- Updated dependencies [a989ae4]
+  - @forge/api@4.1.0-next.0
+
+## 2.2.0-next.1
+
+### Patch Changes
+
+- a431d3d: fix: Generic type for result supporting update response as a single value instead of array
+
+## 2.2.0-next.0
+
+### Minor Changes
+
+- 226ad1b: Add Generic type to SQL helpers
+
+  You can now pass a Generic type to the `prepare` and `executeRaw` functions to specify the row result type.
+
+  ```typescript
+  const statement = sql.prepare<{
+    id: number;
+    text: string;
+    modifiedAt: string;
+  }>('SELECT * FROM example WHERE id = ?');
+
+  const { rows } = statement.bindParams(42).execute();
+
+  rows;
+  // ^? Array<{ id: number, text: string, modifiedAt: string }>
+  ```
+
+## 2.1.0
+
+### Minor Changes
+
+- a41411c: Adds schema migrations helpers for Forge SQL
+
+### Patch Changes
+
+- Updated dependencies [a17ae69]
+- Updated dependencies [e069ff4]
+- Updated dependencies [7e05319]
+  - @forge/api@4.0.0
+
+## 2.1.0-next.2
+
+### Minor Changes
+
+- a41411c: Adds schema migrations helpers for Forge SQL
+
+## 2.0.1-next.1
+
+### Patch Changes
+
+- Updated dependencies [7e05319]
+  - @forge/api@4.0.0-next.1
+
+## 2.0.1-next.0
+
+### Patch Changes
+
+- Updated dependencies [a17ae69]
+  - @forge/api@3.10.0-next.0
+
+## 2.0.0
+
+### Major Changes
+
+- 5db2da9: \* handle schema provisioning error
+  - v1.0.0 stable release
+
+## 2.0.0-next.0
+
+### Major Changes
+
+- 5db2da9: \* handle schema provisioning error
+  - v1.0.0 stable release
+
+## 0.1.0
+
+### Minor Changes
+
+- 01516bb: rename execute to executeRaw
+
+### Patch Changes
+
+- 0f75e93: Forge SQL SDK added
+- Updated dependencies [d3e9d37]
+- Updated dependencies [fbb27ea]
+- Updated dependencies [0f75e93]
+  - @forge/api@3.9.2
+
+## 0.1.0-next.1
+
+### Minor Changes
+
+- 01516bb: rename execute to executeRaw

package/out/__test__/sql.test.js

@@ -9,6 +9,9 @@ describe('SqlClient', () => {
     let sqlClient;
     let mockFetch;
     beforeEach(() => {
+        for (const key of Object.keys(process.env).filter((key) => key.startsWith('FORGE_LOCAL_')))
+            delete process.env[key];
+        delete global.__forge_local_fetch__;
         sqlClient = new sql_1.SqlClient();
         mockFetch = jest.fn();
         api_1.__fetchProduct.mockReturnValue(mockFetch);
@@ -107,6 +110,57 @@ describe('SqlClient', () => {
             await expect(sqlClient['sendRequest'](path)).rejects.toThrow(mockError);
             expect(mockFetch).toHaveBeenCalledWith(path, expect.any(Object));
         });
+        it('routes local-storage requests directly to loopback without calling hosted Forge SQL', async () => {
+            Object.assign(process.env, {
+                FORGE_LOCAL_STORAGE: '1',
+                FORGE_LOCAL_SQL_URL: 'http://127.0.0.1:18091',
+                FORGE_LOCAL_STORAGE_APP_ID: 'local-app',
+                FORGE_LOCAL_STORAGE_ENVIRONMENT_ID: 'local-environment',
+                FORGE_LOCAL_STORAGE_INSTALLATION_ID: 'local-installation'
+            });
+            const localFetch = jest.fn().mockResolvedValue(new Response(JSON.stringify({ rows: [] }), { status: 200 }));
+            global.__forge_local_fetch__ = localFetch;
+            await sqlClient['sendRequest']('/api/v1/execute', { method: 'POST' });
+            expect(localFetch).toHaveBeenCalledWith(new URL('http://127.0.0.1:18091/api/v1/execute'), expect.objectContaining({
+                method: 'POST',
+                headers: expect.objectContaining({
+                    'x-forge-app-id': 'local-app',
+                    'x-forge-environment-id': 'local-environment',
+                    'x-forge-installation-id': 'local-installation',
+                    'x-atlassian-forgeapp-app-id': 'local-app',
+                    'x-atlassian-forgeapp-environment-id': 'local-environment',
+                    'x-atlassian-forgeapp-installation-id': 'local-installation'
+                })
+            }));
+            expect(api_1.__fetchProduct).not.toHaveBeenCalled();
+            delete global.__forge_local_fetch__;
+        });
+        it('fails closed for incomplete or non-loopback local SQL routing', async () => {
+            process.env.FORGE_LOCAL_STORAGE = '1';
+            process.env.FORGE_LOCAL_SQL_URL = 'http://127.0.0.1:18091';
+            await expect(sqlClient['sendRequest']('/api/v1/execute')).rejects.toThrow('local namespace is incomplete');
+            expect(api_1.__fetchProduct).not.toHaveBeenCalled();
+            Object.assign(process.env, {
+                FORGE_LOCAL_STORAGE_APP_ID: 'local-app',
+                FORGE_LOCAL_STORAGE_ENVIRONMENT_ID: 'local-environment',
+                FORGE_LOCAL_STORAGE_INSTALLATION_ID: 'local-installation',
+                FORGE_LOCAL_SQL_URL: 'https://example.com'
+            });
+            await expect(sqlClient['sendRequest']('/api/v1/execute')).rejects.toThrow('must be http://127.0.0.1:18091');
+            expect(api_1.__fetchProduct).not.toHaveBeenCalled();
+        });
+        it('fails closed when local SQL routing has no tunnel local-fetch bridge', async () => {
+            Object.assign(process.env, {
+                FORGE_LOCAL_STORAGE: '1',
+                FORGE_LOCAL_SQL_URL: 'http://127.0.0.1:18091',
+                FORGE_LOCAL_STORAGE_APP_ID: 'local-app',
+                FORGE_LOCAL_STORAGE_ENVIRONMENT_ID: 'local-environment',
+                FORGE_LOCAL_STORAGE_INSTALLATION_ID: 'local-installation'
+            });
+            delete global.__forge_local_fetch__;
+            await expect(sqlClient['sendRequest']('/api/v1/execute')).rejects.toThrow('requires the tunnel local-fetch bridge');
+            expect(api_1.__fetchProduct).not.toHaveBeenCalled();
+        });
     });
     describe('prepare', () => {
         it('should return a SqlStatement instance with query', () => {

package/out/sql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../src/sql.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAgC,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAI7E,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AAEX,KAAK,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAElF,qBAAa,SAAS;YACN,WAAW;YAYX,UAAU;YAsBV,qBAAqB;IAYnC,OAAO,CAAC,QAAQ,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,eAA2C,GACpD,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAU3B,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAQ9D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;CAGrE;AAED,eAAO,MAAM,GAAG,WAAkB,CAAC"}
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../src/sql.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAgC,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAI7E,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AAEX,KAAK,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAElF,qBAAa,SAAS;YACN,WAAW;YAcX,UAAU;YAsBV,qBAAqB;IAYnC,OAAO,CAAC,QAAQ,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,eAA2C,GACpD,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAU3B,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAQ9D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;CAGrE;AAED,eAAO,MAAM,GAAG,WAAkB,CAAC"}

package/out/sql.js

@@ -11,15 +11,18 @@ exports.SQL_API_ENDPOINTS = {
 };
 class SqlClient {
     async sendRequest(path, options) {
-        const response = await (0, api_1.__fetchProduct)({ provider: 'app', remote: 'sql', type: 'sql' })(path, {
+        const requestOptions = {
             ...options,
             redirect: 'follow',
             headers: {
                 ...options?.headers,
                 'Content-Type': 'application/json'
             }
-        });
-        return response;
+        };
+        const localClient = getLocalSqlFetchClient();
+        if (localClient)
+            return localClient(path, requestOptions);
+        return (0, api_1.__fetchProduct)({ provider: 'app', remote: 'sql', type: 'sql' })(path, requestOptions);
     }
     async storageApi(query, params = [], method = 'all', endpoint = exports.SQL_API_ENDPOINTS.EXECUTE) {
         const response = await this.sendRequest(endpoint, {
@@ -55,3 +58,34 @@ class SqlClient {
 }
 exports.SqlClient = SqlClient;
 exports.sql = new SqlClient();
+function getLocalSqlFetchClient() {
+    if (process.env.FORGE_LOCAL_STORAGE !== '1')
+        return undefined;
+    const baseUrl = process.env.FORGE_LOCAL_SQL_URL;
+    const appId = process.env.FORGE_LOCAL_STORAGE_APP_ID;
+    const environmentId = process.env.FORGE_LOCAL_STORAGE_ENVIRONMENT_ID;
+    const installationId = process.env.FORGE_LOCAL_STORAGE_INSTALLATION_ID;
+    if (!baseUrl || !appId || !environmentId || !installationId) {
+        throw new Error('Forge local SQL routing is enabled but its local namespace is incomplete.');
+    }
+    if (baseUrl !== 'http://127.0.0.1:18091') {
+        throw new Error('Forge local SQL endpoint must be http://127.0.0.1:18091.');
+    }
+    const fetchImplementation = globalThis.__forge_local_fetch__;
+    if (typeof fetchImplementation !== 'function') {
+        throw new Error('Forge local SQL routing requires the tunnel local-fetch bridge.');
+    }
+    const endpoint = new URL(baseUrl);
+    return async (requestPath, options) => (await fetchImplementation(new URL(requestPath, endpoint), {
+        ...options,
+        headers: {
+            ...options?.headers,
+            'x-forge-app-id': appId,
+            'x-forge-environment-id': environmentId,
+            'x-forge-installation-id': installationId,
+            'x-atlassian-forgeapp-app-id': appId,
+            'x-atlassian-forgeapp-environment-id': environmentId,
+            'x-atlassian-forgeapp-installation-id': installationId
+        }
+    }));
+}

package/package.json

@@ -1,14 +1,11 @@
 {
   "name": "@forge/sql",
-  "version": "4.0.5-next.0",
+  "version": "4.0.5-next.1-experimental-e9e08bb",
   "description": "Forge SQL sdk",
   "author": "Atlassian",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "out/index.js",
   "types": "out/index.d.ts",
-  "files": [
-    "out"
-  ],
   "scripts": {
     "build": "yarn run clean && yarn run compile",
     "clean": "rm -rf ./out && rm -f tsconfig.tsbuildinfo",
@@ -21,7 +18,7 @@
     "typescript": "5.9.2"
   },
   "dependencies": {
-    "@forge/api": "^8.0.5-next.0"
+    "@forge/api": "^8.0.5-next.1-experimental-e9e08bb"
   },
   "publishConfig": {
     "registry": "https://packages.atlassian.com/api/npm/npm-public/"