@squadbase/vite-server 0.1.3-dev.15 → 0.1.3-dev.16

package/dist/connectors/google-docs.js

@@ -0,0 +1,585 @@
+// ../connectors/src/connectors/google-docs/sdk/index.ts
+var DOCS_BASE_URL = "https://docs.googleapis.com/v1/documents";
+function createClient(_params, fetchFn = fetch) {
+  function request(path2, init) {
+    const url = `${DOCS_BASE_URL}${path2 === "" || path2.startsWith("/") ? "" : "/"}${path2}`;
+    return fetchFn(url, init);
+  }
+  async function getDocument(documentId) {
+    const url = `${DOCS_BASE_URL}/${documentId}`;
+    const response = await fetchFn(url);
+    if (!response.ok) {
+      const body = await response.text();
+      throw new Error(
+        `google-docs: getDocument failed (${response.status}): ${body}`
+      );
+    }
+    return await response.json();
+  }
+  async function batchUpdate(documentId, requests) {
+    const url = `${DOCS_BASE_URL}/${documentId}:batchUpdate`;
+    const response = await fetchFn(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ requests })
+    });
+    if (!response.ok) {
+      const body = await response.text();
+      throw new Error(
+        `google-docs: batchUpdate failed (${response.status}): ${body}`
+      );
+    }
+    return await response.json();
+  }
+  async function createDocument(title) {
+    const url = DOCS_BASE_URL;
+    const response = await fetchFn(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ title })
+    });
+    if (!response.ok) {
+      const body = await response.text();
+      throw new Error(
+        `google-docs: createDocument failed (${response.status}): ${body}`
+      );
+    }
+    return await response.json();
+  }
+  return {
+    request,
+    getDocument,
+    batchUpdate,
+    createDocument
+  };
+}
+
+// ../connectors/src/connector-onboarding.ts
+var ConnectorOnboarding = class {
+  /** Phase 1: Connection setup instructions (optional — some connectors don't need this) */
+  connectionSetupInstructions;
+  /** Phase 2: Data overview instructions */
+  dataOverviewInstructions;
+  constructor(config) {
+    this.connectionSetupInstructions = config.connectionSetupInstructions;
+    this.dataOverviewInstructions = config.dataOverviewInstructions;
+  }
+  getConnectionSetupPrompt(language) {
+    return this.connectionSetupInstructions?.[language] ?? null;
+  }
+  getDataOverviewInstructions(language) {
+    return this.dataOverviewInstructions[language];
+  }
+};
+
+// ../connectors/src/connector-tool.ts
+var ConnectorTool = class {
+  name;
+  description;
+  inputSchema;
+  outputSchema;
+  _execute;
+  constructor(config) {
+    this.name = config.name;
+    this.description = config.description;
+    this.inputSchema = config.inputSchema;
+    this.outputSchema = config.outputSchema;
+    this._execute = config.execute;
+  }
+  createTool(connections, config) {
+    return {
+      description: this.description,
+      inputSchema: this.inputSchema,
+      outputSchema: this.outputSchema,
+      execute: (input) => this._execute(input, connections, config)
+    };
+  }
+};
+
+// ../connectors/src/connector-plugin.ts
+var ConnectorPlugin = class _ConnectorPlugin {
+  slug;
+  authType;
+  name;
+  description;
+  iconUrl;
+  parameters;
+  releaseFlag;
+  proxyPolicy;
+  experimentalAttributes;
+  onboarding;
+  systemPrompt;
+  tools;
+  query;
+  checkConnection;
+  constructor(config) {
+    this.slug = config.slug;
+    this.authType = config.authType;
+    this.name = config.name;
+    this.description = config.description;
+    this.iconUrl = config.iconUrl;
+    this.parameters = config.parameters;
+    this.releaseFlag = config.releaseFlag;
+    this.proxyPolicy = config.proxyPolicy;
+    this.experimentalAttributes = config.experimentalAttributes;
+    this.onboarding = config.onboarding;
+    this.systemPrompt = config.systemPrompt;
+    this.tools = config.tools;
+    this.query = config.query;
+    this.checkConnection = config.checkConnection;
+  }
+  get connectorKey() {
+    return _ConnectorPlugin.deriveKey(this.slug, this.authType);
+  }
+  /**
+   * Create tools for connections that belong to this connector.
+   * Filters connections by connectorKey internally.
+   * Returns tools keyed as `${connectorKey}_${toolName}`.
+   */
+  createTools(connections, config, opts) {
+    const myConnections = connections.filter(
+      (c) => _ConnectorPlugin.deriveKey(c.connector.slug, c.connector.authType) === this.connectorKey
+    );
+    const result = {};
+    for (const t of Object.values(this.tools)) {
+      const tool = t.createTool(myConnections, config);
+      const originalToModelOutput = tool.toModelOutput;
+      result[`${this.connectorKey}_${t.name}`] = {
+        ...tool,
+        toModelOutput: async (options) => {
+          if (!originalToModelOutput) {
+            return opts.truncateOutput(options.output);
+          }
+          const modelOutput = await originalToModelOutput(options);
+          if (modelOutput.type === "text" || modelOutput.type === "json") {
+            return opts.truncateOutput(modelOutput.value);
+          }
+          return modelOutput;
+        }
+      };
+    }
+    return result;
+  }
+  static deriveKey(slug, authType) {
+    return authType ? `${slug}-${authType}` : slug;
+  }
+};
+
+// ../connectors/src/auth-types.ts
+var AUTH_TYPES = {
+  OAUTH: "oauth",
+  API_KEY: "api-key",
+  JWT: "jwt",
+  SERVICE_ACCOUNT: "service-account",
+  PAT: "pat",
+  USER_PASSWORD: "user-password"
+};
+
+// ../connectors/src/connectors/google-docs/setup.ts
+var googleDocsOnboarding = new ConnectorOnboarding({
+  dataOverviewInstructions: {
+    en: `1. Create a new document with google-docs_request (POST with body { title: "..." }) or use an existing document ID.
+2. Call google-docs_request with GET /{documentId} to fetch the document's content and metadata.`,
+    ja: `1. google-docs_request \u3092 POST\uFF08Body: { title: "..." }\uFF09\u3067\u547C\u3073\u51FA\u3057\u3066\u65B0\u3057\u3044\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u3092\u4F5C\u6210\u3059\u308B\u304B\u3001\u65E2\u5B58\u306E\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8ID\u3092\u5229\u7528\u3057\u307E\u3059\u3002
+2. google-docs_request \u3067 GET /{documentId} \u3092\u547C\u3073\u51FA\u3057\u3001\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u306E\u5185\u5BB9\u3068\u30E1\u30BF\u30C7\u30FC\u30BF\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002`
+  }
+});
+
+// ../connectors/src/connectors/google-docs/parameters.ts
+var parameters = {};
+
+// ../connectors/src/connectors/google-docs/tools/request.ts
+import { z } from "zod";
+var DOCS_BASE_URL2 = "https://docs.googleapis.com/v1/documents";
+var REQUEST_TIMEOUT_MS = 6e4;
+var cachedToken = null;
+async function getProxyToken(config) {
+  if (cachedToken && cachedToken.expiresAt > Date.now() + 6e4) {
+    return cachedToken.token;
+  }
+  const url = `${config.appApiBaseUrl}/v0/database/${config.projectId}/environment/${config.environmentId}/oauth-request-proxy-token`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "x-api-key": config.appApiKey,
+      "project-id": config.projectId
+    },
+    body: JSON.stringify({
+      sandboxId: config.sandboxId,
+      issuedBy: "coding-agent"
+    })
+  });
+  if (!res.ok) {
+    const errorText = await res.text().catch(() => res.statusText);
+    throw new Error(
+      `Failed to get proxy token: HTTP ${res.status} ${errorText}`
+    );
+  }
+  const data = await res.json();
+  cachedToken = {
+    token: data.token,
+    expiresAt: new Date(data.expiresAt).getTime()
+  };
+  return data.token;
+}
+var inputSchema = z.object({
+  toolUseIntent: z.string().optional().describe(
+    "Brief description of what you intend to accomplish with this tool call"
+  ),
+  connectionId: z.string().describe("ID of the Google Docs connection to use"),
+  method: z.enum(["GET", "POST"]).describe("HTTP method"),
+  path: z.string().describe(
+    "API path appended to https://docs.googleapis.com/v1/documents (e.g., '', '/{documentId}', '/{documentId}:batchUpdate')."
+  ),
+  body: z.record(z.string(), z.unknown()).optional().describe("JSON request body for POST requests"),
+  queryParams: z.record(z.string(), z.string()).optional().describe("Query parameters to append to the URL")
+});
+var outputSchema = z.discriminatedUnion("success", [
+  z.object({
+    success: z.literal(true),
+    status: z.number(),
+    data: z.record(z.string(), z.unknown())
+  }),
+  z.object({
+    success: z.literal(false),
+    error: z.string()
+  })
+]);
+var requestTool = new ConnectorTool({
+  name: "request",
+  description: `Send authenticated requests to the Google Docs API v1.
+Supports GET (read) and POST (create/update) methods.
+Authentication is handled automatically via OAuth proxy.`,
+  inputSchema,
+  outputSchema,
+  async execute({ connectionId, method, path: path2, body, queryParams }, connections, config) {
+    const connection2 = connections.find((c) => c.id === connectionId);
+    if (!connection2) {
+      return {
+        success: false,
+        error: `Connection ${connectionId} not found`
+      };
+    }
+    console.log(
+      `[connector-request] google-docs/${connection2.name}: ${method} ${path2}`
+    );
+    try {
+      let url = `${DOCS_BASE_URL2}${path2 === "" || path2.startsWith("/") ? "" : "/"}${path2}`;
+      if (queryParams) {
+        const searchParams = new URLSearchParams(queryParams);
+        url += `?${searchParams.toString()}`;
+      }
+      const token = await getProxyToken(config.oauthProxy);
+      const proxyUrl = `https://${config.oauthProxy.sandboxId}.${config.oauthProxy.previewBaseDomain}/_sqcore/connections/${connectionId}/request`;
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+      try {
+        const response = await fetch(proxyUrl, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${token}`
+          },
+          body: JSON.stringify({
+            url,
+            method,
+            ...body != null ? { body: JSON.stringify(body) } : {}
+          }),
+          signal: controller.signal
+        });
+        const data = await response.json();
+        if (!response.ok) {
+          const errorMessage = typeof data?.error === "string" ? data.error : typeof data?.message === "string" ? data.message : `HTTP ${response.status} ${response.statusText}`;
+          return { success: false, error: errorMessage };
+        }
+        return { success: true, status: response.status, data };
+      } finally {
+        clearTimeout(timeout);
+      }
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return { success: false, error: msg };
+    }
+  }
+});
+
+// ../connectors/src/connectors/google-docs/index.ts
+var tools = { request: requestTool };
+var googleDocsConnector = new ConnectorPlugin({
+  slug: "google-docs",
+  authType: AUTH_TYPES.OAUTH,
+  name: "Google Docs",
+  description: "Connect to Google Docs for document data access and creation using OAuth.",
+  iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/4oyF4yTRpemMA43X49masx/e1582d25e3b4c9a63ba83df2147c1968/google_slide.png",
+  parameters,
+  releaseFlag: { dev1: true, dev2: false, prod: false },
+  onboarding: googleDocsOnboarding,
+  proxyPolicy: {
+    allowlist: [
+      {
+        host: "docs.googleapis.com",
+        methods: ["GET", "POST"]
+      }
+    ]
+  },
+  systemPrompt: {
+    en: `### Tools
+
+- \`google-docs_request\`: The way to call the Google Docs API. Supports read and write operations. Use it to get document content, create new documents, and modify document content via batchUpdate. Authentication is configured automatically via OAuth.
+
+### Google Docs API Reference
+
+#### Read Endpoints
+- GET \`/{documentId}\` \u2014 Get the document's content and metadata (title, body, revisionId, styles)
+
+#### Write Endpoints
+- POST \`\` (empty path, with body) \u2014 Create a new document. Body: \`{ "title": "My Document" }\`
+- POST \`/{documentId}:batchUpdate\` \u2014 Apply multiple updates to a document. Body: \`{ "requests": [...] }\`
+
+#### Common batchUpdate Request Types
+- \`insertText\` \u2014 Insert text at a location: \`{ "insertText": { "location": { "index": 1 }, "text": "Hello" } }\`
+- \`deleteContentRange\` \u2014 Delete a range of content: \`{ "deleteContentRange": { "range": { "startIndex": 1, "endIndex": 5 } } }\`
+- \`replaceAllText\` \u2014 Find & replace text: \`{ "replaceAllText": { "containsText": { "text": "old" }, "replaceText": "new" } }\`
+- \`updateTextStyle\` \u2014 Style text (bold, color, font): \`{ "updateTextStyle": { "range": { "startIndex": 1, "endIndex": 5 }, "textStyle": { "bold": true }, "fields": "bold" } }\`
+- \`updateParagraphStyle\` \u2014 Update paragraph style (alignment, indentation, etc.)
+- \`insertTable\` \u2014 Insert a table: \`{ "insertTable": { "location": { "index": 1 }, "rows": 3, "columns": 2 } }\`
+- \`insertInlineImage\` \u2014 Insert an image: \`{ "insertInlineImage": { "location": { "index": 1 }, "uri": "https://..." } }\`
+- \`createParagraphBullets\` / \`deleteParagraphBullets\` \u2014 Add or remove bullets
+
+### Tips
+- Indexes in the Docs API are 1-based and reference the document body positions (including newlines)
+- To explore a document, first GET the document to get its body structure and element indexes
+- batchUpdate requests are applied in order \u2014 use this for complex multi-step modifications
+- Sharing (permissions) cannot be done via this connector; only the OAuth user has access to the created documents
+
+### Business Logic
+
+The business logic type for this connector is "typescript". Write handler code using the connector SDK shown below. Do NOT access credentials directly from environment variables.
+
+#### Example
+
+\`\`\`ts
+import { connection } from "@squadbase/vite-server/connectors/google-docs";
+
+const docs = connection("<connectionId>");
+
+// Create a new document
+const newDoc = await docs.createDocument("Quarterly Report");
+const documentId = newDoc.documentId;
+
+// Get document metadata and content
+const document = await docs.getDocument(documentId);
+console.log(document.title);
+
+// Insert text and style it
+await docs.batchUpdate(documentId, [
+  { insertText: { location: { index: 1 }, text: "Hello, World!" } },
+  { updateTextStyle: {
+      range: { startIndex: 1, endIndex: 13 },
+      textStyle: { bold: true },
+      fields: "bold",
+    }
+  },
+]);
+\`\`\``,
+    ja: `### \u30C4\u30FC\u30EB
+
+- \`google-docs_request\`: Google Docs API\u3092\u547C\u3073\u51FA\u3059\u624B\u6BB5\u3067\u3059\u3002\u8AAD\u307F\u53D6\u308A\u3068\u66F8\u304D\u8FBC\u307F\u306E\u4E21\u65B9\u3092\u30B5\u30DD\u30FC\u30C8\u3057\u307E\u3059\u3002\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u5185\u5BB9\u306E\u53D6\u5F97\u3001\u65B0\u3057\u3044\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u306E\u4F5C\u6210\u3001batchUpdate \u306B\u3088\u308B\u5185\u5BB9\u5909\u66F4\u306A\u3069\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002OAuth\u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
+
+### Google Docs API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
+
+#### \u8AAD\u307F\u53D6\u308A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
+- GET \`/{documentId}\` \u2014 \u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u306E\u5185\u5BB9\u3068\u30E1\u30BF\u30C7\u30FC\u30BF\uFF08\u30BF\u30A4\u30C8\u30EB\u3001body\u3001revisionId\u3001\u30B9\u30BF\u30A4\u30EB\uFF09\u3092\u53D6\u5F97
+
+#### \u66F8\u304D\u8FBC\u307F\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
+- POST \`\`\uFF08\u7A7A\u30D1\u30B9\u3001\u30DC\u30C7\u30A3\u4ED8\u304D\uFF09\u2014 \u65B0\u3057\u3044\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u3092\u4F5C\u6210\u3002Body: \`{ "title": "\u30DE\u30A4\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8" }\`
+- POST \`/{documentId}:batchUpdate\` \u2014 \u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u306B\u8907\u6570\u306E\u66F4\u65B0\u3092\u9069\u7528\u3002Body: \`{ "requests": [...] }\`
+
+#### \u4E3B\u306A batchUpdate \u30EA\u30AF\u30A8\u30B9\u30C8\u30BF\u30A4\u30D7
+- \`insertText\` \u2014 \u6307\u5B9A\u4F4D\u7F6E\u306B\u30C6\u30AD\u30B9\u30C8\u3092\u633F\u5165: \`{ "insertText": { "location": { "index": 1 }, "text": "Hello" } }\`
+- \`deleteContentRange\` \u2014 \u7BC4\u56F2\u306E\u5185\u5BB9\u3092\u524A\u9664: \`{ "deleteContentRange": { "range": { "startIndex": 1, "endIndex": 5 } } }\`
+- \`replaceAllText\` \u2014 \u30C6\u30AD\u30B9\u30C8\u306E\u691C\u7D22\u3068\u7F6E\u63DB: \`{ "replaceAllText": { "containsText": { "text": "\u53E4\u3044" }, "replaceText": "\u65B0\u3057\u3044" } }\`
+- \`updateTextStyle\` \u2014 \u30C6\u30AD\u30B9\u30C8\u306E\u30B9\u30BF\u30A4\u30EB\u8A2D\u5B9A\uFF08\u592A\u5B57\u3001\u8272\u3001\u30D5\u30A9\u30F3\u30C8\uFF09: \`{ "updateTextStyle": { "range": { "startIndex": 1, "endIndex": 5 }, "textStyle": { "bold": true }, "fields": "bold" } }\`
+- \`updateParagraphStyle\` \u2014 \u6BB5\u843D\u30B9\u30BF\u30A4\u30EB\u3092\u66F4\u65B0\uFF08\u914D\u7F6E\u3001\u30A4\u30F3\u30C7\u30F3\u30C8\u7B49\uFF09
+- \`insertTable\` \u2014 \u30C6\u30FC\u30D6\u30EB\u3092\u633F\u5165: \`{ "insertTable": { "location": { "index": 1 }, "rows": 3, "columns": 2 } }\`
+- \`insertInlineImage\` \u2014 \u753B\u50CF\u3092\u633F\u5165: \`{ "insertInlineImage": { "location": { "index": 1 }, "uri": "https://..." } }\`
+- \`createParagraphBullets\` / \`deleteParagraphBullets\` \u2014 \u7B87\u6761\u66F8\u304D\u306E\u8FFD\u52A0\u30FB\u524A\u9664
+
+### \u30D2\u30F3\u30C8
+- Docs API \u306E\u30A4\u30F3\u30C7\u30C3\u30AF\u30B9\u306F 1-based \u3067\u3001\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u672C\u6587\u306E\u4F4D\u7F6E\uFF08\u6539\u884C\u3082\u542B\u3080\uFF09\u3092\u53C2\u7167\u3057\u307E\u3059
+- \u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u3092\u63A2\u7D22\u3059\u308B\u306B\u306F\u3001\u307E\u305A GET \u3067\u53D6\u5F97\u3057\u3066\u672C\u6587\u69CB\u9020\u3068\u8981\u7D20\u30A4\u30F3\u30C7\u30C3\u30AF\u30B9\u3092\u78BA\u8A8D\u3057\u307E\u3059
+- batchUpdate \u30EA\u30AF\u30A8\u30B9\u30C8\u306F\u9806\u756A\u306B\u9069\u7528\u3055\u308C\u307E\u3059 \u2014 \u8907\u96D1\u306A\u8907\u6570\u30B9\u30C6\u30C3\u30D7\u306E\u5909\u66F4\u306B\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044
+- \u5171\u6709\uFF08permissions\uFF09\u306F\u3053\u306E\u30B3\u30CD\u30AF\u30BF\u7D4C\u7531\u3067\u306F\u884C\u3048\u307E\u305B\u3093\u3002\u4F5C\u6210\u3057\u305F\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u3078\u306F\u63A5\u7D9A\u3057\u305FOAuth\u30E6\u30FC\u30B6\u30FC\u306E\u307F\u304C\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u3067\u3059
+
+### Business Logic
+
+\u3053\u306E\u30B3\u30CD\u30AF\u30BF\u306E\u30D3\u30B8\u30CD\u30B9\u30ED\u30B8\u30C3\u30AF\u30BF\u30A4\u30D7\u306F "typescript" \u3067\u3059\u3002\u4EE5\u4E0B\u306B\u793A\u3059\u30B3\u30CD\u30AF\u30BFSDK\u3092\u4F7F\u7528\u3057\u3066\u30CF\u30F3\u30C9\u30E9\u30B3\u30FC\u30C9\u3092\u8A18\u8FF0\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u74B0\u5883\u5909\u6570\u304B\u3089\u76F4\u63A5\u8A8D\u8A3C\u60C5\u5831\u306B\u30A2\u30AF\u30BB\u30B9\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002
+
+#### Example
+
+\`\`\`ts
+import { connection } from "@squadbase/vite-server/connectors/google-docs";
+
+const docs = connection("<connectionId>");
+
+// \u65B0\u3057\u3044\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u3092\u4F5C\u6210
+const newDoc = await docs.createDocument("\u56DB\u534A\u671F\u30EC\u30DD\u30FC\u30C8");
+const documentId = newDoc.documentId;
+
+// \u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u306E\u30E1\u30BF\u30C7\u30FC\u30BF\u3068\u5185\u5BB9\u3092\u53D6\u5F97
+const document = await docs.getDocument(documentId);
+console.log(document.title);
+
+// \u30C6\u30AD\u30B9\u30C8\u3092\u633F\u5165\u3057\u3066\u30B9\u30BF\u30A4\u30EB\u3092\u9069\u7528
+await docs.batchUpdate(documentId, [
+  { insertText: { location: { index: 1 }, text: "Hello, World!" } },
+  { updateTextStyle: {
+      range: { startIndex: 1, endIndex: 13 },
+      textStyle: { bold: true },
+      fields: "bold",
+    }
+  },
+]);
+\`\`\``
+  },
+  tools
+});
+
+// src/connectors/create-connector-sdk.ts
+import { readFileSync } from "fs";
+import path from "path";
+
+// src/connector-client/env.ts
+function resolveEnvVar(entry, key, connectionId) {
+  const envVarName = entry.envVars[key];
+  if (!envVarName) {
+    throw new Error(`Connection "${connectionId}" is missing envVars mapping for key "${key}"`);
+  }
+  const value = process.env[envVarName];
+  if (!value) {
+    throw new Error(`Environment variable "${envVarName}" (for connection "${connectionId}", key "${key}") is not set`);
+  }
+  return value;
+}
+function resolveEnvVarOptional(entry, key) {
+  const envVarName = entry.envVars[key];
+  if (!envVarName) return void 0;
+  return process.env[envVarName] || void 0;
+}
+
+// src/connector-client/proxy-fetch.ts
+import { getContext } from "hono/context-storage";
+import { getCookie } from "hono/cookie";
+var APP_SESSION_COOKIE_NAME = "__Host-squadbase-session";
+function createSandboxProxyFetch(connectionId) {
+  return async (input, init) => {
+    const token = process.env.INTERNAL_SQUADBASE_OAUTH_MACHINE_CREDENTIAL;
+    const sandboxId = process.env.INTERNAL_SQUADBASE_SANDBOX_ID;
+    if (!token || !sandboxId) {
+      throw new Error(
+        "Connection proxy is not configured. Please check your deployment settings."
+      );
+    }
+    const originalUrl = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+    const originalMethod = init?.method ?? "GET";
+    const originalBody = init?.body ? JSON.parse(init.body) : void 0;
+    const baseDomain = process.env["SQUADBASE_PREVIEW_BASE_DOMAIN"] ?? "preview.app.squadbase.dev";
+    const proxyUrl = `https://${sandboxId}.${baseDomain}/_sqcore/connections/${connectionId}/request`;
+    return fetch(proxyUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${token}`
+      },
+      body: JSON.stringify({
+        url: originalUrl,
+        method: originalMethod,
+        body: originalBody
+      })
+    });
+  };
+}
+function createDeployedAppProxyFetch(connectionId) {
+  const projectId = process.env["SQUADBASE_PROJECT_ID"];
+  if (!projectId) {
+    throw new Error(
+      "Connection proxy is not configured. Please check your deployment settings."
+    );
+  }
+  const baseDomain = process.env["SQUADBASE_APP_BASE_DOMAIN"] ?? "squadbase.app";
+  const proxyUrl = `https://${projectId}.${baseDomain}/_sqcore/connections/${connectionId}/request`;
+  return async (input, init) => {
+    const originalUrl = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+    const originalMethod = init?.method ?? "GET";
+    const originalBody = init?.body ? JSON.parse(init.body) : void 0;
+    const c = getContext();
+    const appSession = getCookie(c, APP_SESSION_COOKIE_NAME);
+    if (!appSession) {
+      throw new Error(
+        "No authentication method available for connection proxy."
+      );
+    }
+    return fetch(proxyUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${appSession}`
+      },
+      body: JSON.stringify({
+        url: originalUrl,
+        method: originalMethod,
+        body: originalBody
+      })
+    });
+  };
+}
+function createProxyFetch(connectionId) {
+  if (process.env.INTERNAL_SQUADBASE_SANDBOX_ID) {
+    return createSandboxProxyFetch(connectionId);
+  }
+  return createDeployedAppProxyFetch(connectionId);
+}
+
+// src/connectors/create-connector-sdk.ts
+function loadConnectionsSync() {
+  const filePath = process.env.CONNECTIONS_PATH ?? path.join(process.cwd(), ".squadbase/connections.json");
+  try {
+    const raw = readFileSync(filePath, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+function createConnectorSdk(plugin, createClient2) {
+  return (connectionId) => {
+    const connections = loadConnectionsSync();
+    const entry = connections[connectionId];
+    if (!entry) {
+      throw new Error(
+        `Connection "${connectionId}" not found in .squadbase/connections.json`
+      );
+    }
+    if (entry.connector.slug !== plugin.slug) {
+      throw new Error(
+        `Connection "${connectionId}" is not a ${plugin.slug} connection (got "${entry.connector.slug}")`
+      );
+    }
+    const params = {};
+    for (const param of Object.values(plugin.parameters)) {
+      if (param.required) {
+        params[param.slug] = resolveEnvVar(entry, param.slug, connectionId);
+      } else {
+        const val = resolveEnvVarOptional(entry, param.slug);
+        if (val !== void 0) params[param.slug] = val;
+      }
+    }
+    return createClient2(params, createProxyFetch(connectionId));
+  };
+}
+
+// src/connectors/entries/google-docs.ts
+var connection = createConnectorSdk(googleDocsConnector, createClient);
+export {
+  connection
+};

package/dist/connectors/google-drive.d.ts

@@ -1,5 +1,5 @@
 import * as _squadbase_connectors_sdk from '@squadbase/connectors/sdk';
 
-declare const connection: (connectionId: string) => _squadbase_connectors_sdk.GoogleDriveServiceAccountConnectorSdk;
+declare const connection: (connectionId: string) => _squadbase_connectors_sdk.GoogleDriveConnectorSdk;
 
 export { connection };