@squadbase/server 0.2.1 → 0.2.2-beta.0

package/dist/index.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  createConnectionClient: () => createConnectionClient,
   createServerClient: () => createServerClient
 });
 module.exports = __toCommonJS(index_exports);
@@ -33,6 +34,7 @@ var PREVIEW_SESSION_COOKIE_NAME = "squadbase-preview-session";
 var APP_BASE_DOMAIN = "squadbase.app";
 var PREVIEW_BASE_DOMAIN = "preview.app.squadbase.dev";
 var SANDBOX_ID_ENV_NAME = "INTERNAL_SQUADBASE_SANDBOX_ID";
+var MACHINE_CREDENTIAL_ENV_NAME = "INTERNAL_SQUADBASE_OAUTH_MACHINE_CREDENTIAL";
 
 // src/types.ts
 var import_zod = require("zod");
@@ -115,7 +117,83 @@ var ServerClient = class {
   }
 };
 var createServerClient = (options) => new ServerClient(options);
+
+// src/connection-client.ts
+var import_cookie2 = require("cookie");
+var ConnectionClient = class {
+  constructor(options) {
+    this.options = options;
+  }
+  async fetch(url, fetchOptions) {
+    const proxyUrl = this.resolveProxyUrl();
+    const authHeaders = await this.resolveAuthHeaders();
+    const response = await fetch(proxyUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...authHeaders
+      },
+      body: JSON.stringify({
+        url,
+        method: fetchOptions?.method,
+        headers: fetchOptions?.headers,
+        body: fetchOptions?.body,
+        timeoutMs: fetchOptions?.timeoutMs
+      })
+    });
+    if (!response.ok) {
+      throw new Error(
+        `Connection proxy request failed with status ${response.status}`
+      );
+    }
+    return await response.json();
+  }
+  get projectIdOrThrow() {
+    const projectId = this.options.projectId ?? process.env["SQUADBASE_PROJECT_ID"];
+    if (!projectId) {
+      throw new Error(
+        "Project ID is required. Please set SQUADBASE_PROJECT_ID environment variable or provide projectId in ConnectionClient options."
+      );
+    }
+    return projectId;
+  }
+  get connectionPath() {
+    return `/_sqcore/connections/${this.options.connectionId}/request`;
+  }
+  resolveProxyUrl() {
+    const sandboxId = process.env[SANDBOX_ID_ENV_NAME];
+    if (sandboxId) {
+      const baseDomain2 = this.options._internal?.preview_base_domain ?? PREVIEW_BASE_DOMAIN;
+      return `https://${sandboxId}.${baseDomain2}${this.connectionPath}`;
+    }
+    const baseDomain = this.options._internal?.app_base_domain ?? APP_BASE_DOMAIN;
+    return `https://${this.projectIdOrThrow}.${baseDomain}${this.connectionPath}`;
+  }
+  async resolveAuthHeaders() {
+    const machineCredential = process.env[MACHINE_CREDENTIAL_ENV_NAME];
+    if (machineCredential) {
+      return { Authorization: `Bearer ${machineCredential}` };
+    }
+    const cookieString = await this.options.cookieOptions.getCookie() ?? "";
+    const cookie = (0, import_cookie2.parse)(cookieString);
+    const previewSessionToken = cookie[PREVIEW_SESSION_COOKIE_NAME];
+    if (previewSessionToken) {
+      return {
+        Cookie: `${PREVIEW_SESSION_COOKIE_NAME}=${previewSessionToken}`
+      };
+    }
+    const appSessionToken = cookie[APP_SESSION_COOKIE_NAME];
+    if (appSessionToken) {
+      return { Authorization: `Bearer ${appSessionToken}` };
+    }
+    throw new Error(
+      "No authentication method available for connection proxy. Expected one of: INTERNAL_SQUADBASE_OAUTH_MACHINE_CREDENTIAL env var, preview session cookie, or app session cookie."
+    );
+  }
+};
+var createConnectionClient = (options) => new ConnectionClient(options);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  createConnectionClient,
   createServerClient
 });

package/dist/index.d.cts

@@ -54,4 +54,38 @@ declare class ServerClient {
 }
 declare const createServerClient: (options: ServerClientOptions) => ServerClient;
 
-export { type GetCookie, ServerClient, type ServerClientOptions, type User, createServerClient };
+type ConnectionClientOptions = {
+    connectionId: string;
+    projectId?: string;
+    cookieOptions: {
+        getCookie: GetCookie;
+    };
+    _internal?: {
+        app_base_domain?: string;
+        preview_base_domain?: string;
+    };
+};
+type ConnectionFetchOptions = {
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    body?: unknown;
+    timeoutMs?: number;
+};
+type ConnectionFetchResponse = {
+    status: number;
+    headers: Record<string, string>;
+    body: unknown;
+    isBase64Encoded: boolean;
+};
+declare class ConnectionClient {
+    private readonly options;
+    constructor(options: ConnectionClientOptions);
+    fetch(url: string, fetchOptions?: ConnectionFetchOptions): Promise<ConnectionFetchResponse>;
+    private get projectIdOrThrow();
+    private get connectionPath();
+    private resolveProxyUrl;
+    private resolveAuthHeaders;
+}
+declare const createConnectionClient: (options: ConnectionClientOptions) => ConnectionClient;
+
+export { ConnectionClient, type ConnectionClientOptions, type ConnectionFetchOptions, type ConnectionFetchResponse, type GetCookie, ServerClient, type ServerClientOptions, type User, createConnectionClient, createServerClient };

package/dist/index.d.ts

@@ -54,4 +54,38 @@ declare class ServerClient {
 }
 declare const createServerClient: (options: ServerClientOptions) => ServerClient;
 
-export { type GetCookie, ServerClient, type ServerClientOptions, type User, createServerClient };
+type ConnectionClientOptions = {
+    connectionId: string;
+    projectId?: string;
+    cookieOptions: {
+        getCookie: GetCookie;
+    };
+    _internal?: {
+        app_base_domain?: string;
+        preview_base_domain?: string;
+    };
+};
+type ConnectionFetchOptions = {
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    body?: unknown;
+    timeoutMs?: number;
+};
+type ConnectionFetchResponse = {
+    status: number;
+    headers: Record<string, string>;
+    body: unknown;
+    isBase64Encoded: boolean;
+};
+declare class ConnectionClient {
+    private readonly options;
+    constructor(options: ConnectionClientOptions);
+    fetch(url: string, fetchOptions?: ConnectionFetchOptions): Promise<ConnectionFetchResponse>;
+    private get projectIdOrThrow();
+    private get connectionPath();
+    private resolveProxyUrl;
+    private resolveAuthHeaders;
+}
+declare const createConnectionClient: (options: ConnectionClientOptions) => ConnectionClient;
+
+export { ConnectionClient, type ConnectionClientOptions, type ConnectionFetchOptions, type ConnectionFetchResponse, type GetCookie, ServerClient, type ServerClientOptions, type User, createConnectionClient, createServerClient };

package/dist/index.js

@@ -7,6 +7,7 @@ var PREVIEW_SESSION_COOKIE_NAME = "squadbase-preview-session";
 var APP_BASE_DOMAIN = "squadbase.app";
 var PREVIEW_BASE_DOMAIN = "preview.app.squadbase.dev";
 var SANDBOX_ID_ENV_NAME = "INTERNAL_SQUADBASE_SANDBOX_ID";
+var MACHINE_CREDENTIAL_ENV_NAME = "INTERNAL_SQUADBASE_OAUTH_MACHINE_CREDENTIAL";
 
 // src/types.ts
 import { z } from "zod";
@@ -89,6 +90,82 @@ var ServerClient = class {
   }
 };
 var createServerClient = (options) => new ServerClient(options);
+
+// src/connection-client.ts
+import { parse as parseCookie2 } from "cookie";
+var ConnectionClient = class {
+  constructor(options) {
+    this.options = options;
+  }
+  async fetch(url, fetchOptions) {
+    const proxyUrl = this.resolveProxyUrl();
+    const authHeaders = await this.resolveAuthHeaders();
+    const response = await fetch(proxyUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...authHeaders
+      },
+      body: JSON.stringify({
+        url,
+        method: fetchOptions?.method,
+        headers: fetchOptions?.headers,
+        body: fetchOptions?.body,
+        timeoutMs: fetchOptions?.timeoutMs
+      })
+    });
+    if (!response.ok) {
+      throw new Error(
+        `Connection proxy request failed with status ${response.status}`
+      );
+    }
+    return await response.json();
+  }
+  get projectIdOrThrow() {
+    const projectId = this.options.projectId ?? process.env["SQUADBASE_PROJECT_ID"];
+    if (!projectId) {
+      throw new Error(
+        "Project ID is required. Please set SQUADBASE_PROJECT_ID environment variable or provide projectId in ConnectionClient options."
+      );
+    }
+    return projectId;
+  }
+  get connectionPath() {
+    return `/_sqcore/connections/${this.options.connectionId}/request`;
+  }
+  resolveProxyUrl() {
+    const sandboxId = process.env[SANDBOX_ID_ENV_NAME];
+    if (sandboxId) {
+      const baseDomain2 = this.options._internal?.preview_base_domain ?? PREVIEW_BASE_DOMAIN;
+      return `https://${sandboxId}.${baseDomain2}${this.connectionPath}`;
+    }
+    const baseDomain = this.options._internal?.app_base_domain ?? APP_BASE_DOMAIN;
+    return `https://${this.projectIdOrThrow}.${baseDomain}${this.connectionPath}`;
+  }
+  async resolveAuthHeaders() {
+    const machineCredential = process.env[MACHINE_CREDENTIAL_ENV_NAME];
+    if (machineCredential) {
+      return { Authorization: `Bearer ${machineCredential}` };
+    }
+    const cookieString = await this.options.cookieOptions.getCookie() ?? "";
+    const cookie = parseCookie2(cookieString);
+    const previewSessionToken = cookie[PREVIEW_SESSION_COOKIE_NAME];
+    if (previewSessionToken) {
+      return {
+        Cookie: `${PREVIEW_SESSION_COOKIE_NAME}=${previewSessionToken}`
+      };
+    }
+    const appSessionToken = cookie[APP_SESSION_COOKIE_NAME];
+    if (appSessionToken) {
+      return { Authorization: `Bearer ${appSessionToken}` };
+    }
+    throw new Error(
+      "No authentication method available for connection proxy. Expected one of: INTERNAL_SQUADBASE_OAUTH_MACHINE_CREDENTIAL env var, preview session cookie, or app session cookie."
+    );
+  }
+};
+var createConnectionClient = (options) => new ConnectionClient(options);
 export {
+  createConnectionClient,
   createServerClient
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squadbase/server",
-  "version": "0.2.1",
+  "version": "0.2.2-beta.0",
   "description": "Server-side SDK for Squadbase",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",