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

package/dist/connectors/google-sheets-oauth.js

@@ -1,821 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-// ../connectors/src/connectors/google-sheets/utils.ts
-function extractSpreadsheetId(urlOrId) {
-  const trimmed = urlOrId.trim();
-  const match = trimmed.match(SPREADSHEET_URL_PATTERN);
-  if (match) {
-    return match[1];
-  }
-  return trimmed;
-}
-var SPREADSHEET_URL_PATTERN;
-var init_utils = __esm({
-  "../connectors/src/connectors/google-sheets/utils.ts"() {
-    "use strict";
-    SPREADSHEET_URL_PATTERN = /docs\.google\.com\/spreadsheets\/d\/([a-zA-Z0-9_-]+)/;
-  }
-});
-
-// ../connectors/src/connectors/google-sheets-oauth/utils.ts
-var utils_exports = {};
-__export(utils_exports, {
-  extractSpreadsheetId: () => extractSpreadsheetId
-});
-var init_utils2 = __esm({
-  "../connectors/src/connectors/google-sheets-oauth/utils.ts"() {
-    "use strict";
-    init_utils();
-  }
-});
-
-// ../connectors/src/parameter-definition.ts
-var ParameterDefinition = class {
-  slug;
-  name;
-  description;
-  envVarBaseKey;
-  type;
-  secret;
-  required;
-  constructor(config) {
-    this.slug = config.slug;
-    this.name = config.name;
-    this.description = config.description;
-    this.envVarBaseKey = config.envVarBaseKey;
-    this.type = config.type;
-    this.secret = config.secret;
-    this.required = config.required;
-  }
-  /**
-   * Get the parameter value from a ConnectorConnectionObject.
-   */
-  getValue(connection2) {
-    const param = connection2.parameters.find(
-      (p) => p.parameterSlug === this.slug
-    );
-    if (!param || param.value == null) {
-      throw new Error(
-        `Parameter "${this.slug}" not found or has no value in connection "${connection2.id}"`
-      );
-    }
-    return param.value;
-  }
-  /**
-   * Try to get the parameter value. Returns undefined if not found (for optional params).
-   */
-  tryGetValue(connection2) {
-    const param = connection2.parameters.find(
-      (p) => p.parameterSlug === this.slug
-    );
-    if (!param || param.value == null) return void 0;
-    return param.value;
-  }
-};
-
-// ../connectors/src/connectors/google-sheets-oauth/parameters.ts
-var parameters = {
-  spreadsheetUrl: new ParameterDefinition({
-    slug: "spreadsheet-url",
-    name: "Google Spreadsheet URL",
-    description: "The URL of the Google Spreadsheet (e.g., https://docs.google.com/spreadsheets/d/xxxxx/edit). The spreadsheet ID is automatically extracted from the URL.",
-    envVarBaseKey: "GOOGLE_SHEETS_OAUTH_SPREADSHEET_URL",
-    type: "text",
-    secret: false,
-    required: false
-  })
-};
-
-// ../connectors/src/connectors/google-sheets-oauth/sdk/index.ts
-init_utils2();
-var SHEETS_BASE_URL = "https://sheets.googleapis.com/v4/spreadsheets";
-function createClient(params, fetchFn = fetch) {
-  const spreadsheetUrl = params[parameters.spreadsheetUrl.slug];
-  const defaultSpreadsheetId = spreadsheetUrl ? extractSpreadsheetId(spreadsheetUrl) : void 0;
-  function resolveSpreadsheetId(override) {
-    const id = override ?? defaultSpreadsheetId;
-    if (!id) {
-      throw new Error(
-        "google-sheets: spreadsheetId is required. Either configure a default or pass it explicitly."
-      );
-    }
-    return id;
-  }
-  function request(path2, init) {
-    const resolvedPath = defaultSpreadsheetId ? path2.replace(/\{spreadsheetId\}/g, defaultSpreadsheetId) : path2;
-    const url = `${SHEETS_BASE_URL}${resolvedPath.startsWith("/") ? "" : "/"}${resolvedPath}`;
-    return fetchFn(url, init);
-  }
-  async function getSpreadsheet(spreadsheetId) {
-    const id = resolveSpreadsheetId(spreadsheetId);
-    const url = `${SHEETS_BASE_URL}/${id}?fields=spreadsheetId,properties,sheets.properties`;
-    const response = await fetchFn(url);
-    if (!response.ok) {
-      const body = await response.text();
-      throw new Error(
-        `google-sheets: getSpreadsheet failed (${response.status}): ${body}`
-      );
-    }
-    return await response.json();
-  }
-  async function getValues(range, spreadsheetId) {
-    const id = resolveSpreadsheetId(spreadsheetId);
-    const url = `${SHEETS_BASE_URL}/${id}/values/${encodeURIComponent(range)}`;
-    const response = await fetchFn(url);
-    if (!response.ok) {
-      const body = await response.text();
-      throw new Error(
-        `google-sheets: getValues failed (${response.status}): ${body}`
-      );
-    }
-    return await response.json();
-  }
-  async function batchGetValues(ranges, spreadsheetId) {
-    const id = resolveSpreadsheetId(spreadsheetId);
-    const searchParams = new URLSearchParams();
-    for (const range of ranges) {
-      searchParams.append("ranges", range);
-    }
-    const url = `${SHEETS_BASE_URL}/${id}/values:batchGet?${searchParams.toString()}`;
-    const response = await fetchFn(url);
-    if (!response.ok) {
-      const body = await response.text();
-      throw new Error(
-        `google-sheets: batchGetValues failed (${response.status}): ${body}`
-      );
-    }
-    return await response.json();
-  }
-  async function updateValues(range, values, spreadsheetId) {
-    const id = resolveSpreadsheetId(spreadsheetId);
-    const url = `${SHEETS_BASE_URL}/${id}/values/${encodeURIComponent(range)}?valueInputOption=USER_ENTERED`;
-    const response = await fetchFn(url, {
-      method: "PUT",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ range, majorDimension: "ROWS", values })
-    });
-    if (!response.ok) {
-      const body = await response.text();
-      throw new Error(
-        `google-sheets: updateValues failed (${response.status}): ${body}`
-      );
-    }
-    return await response.json();
-  }
-  async function appendValues(range, values, spreadsheetId) {
-    const id = resolveSpreadsheetId(spreadsheetId);
-    const url = `${SHEETS_BASE_URL}/${id}/values/${encodeURIComponent(range)}:append?valueInputOption=USER_ENTERED&insertDataOption=INSERT_ROWS`;
-    const response = await fetchFn(url, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ range, majorDimension: "ROWS", values })
-    });
-    if (!response.ok) {
-      const body = await response.text();
-      throw new Error(
-        `google-sheets: appendValues failed (${response.status}): ${body}`
-      );
-    }
-    return await response.json();
-  }
-  async function createSpreadsheet(title, sheetTitles) {
-    const sheets = sheetTitles && sheetTitles.length > 0 ? sheetTitles.map((t) => ({ properties: { title: t } })) : void 0;
-    const url = `${SHEETS_BASE_URL}`;
-    const response = await fetchFn(url, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        properties: { title },
-        ...sheets ? { sheets } : {}
-      })
-    });
-    if (!response.ok) {
-      const body = await response.text();
-      throw new Error(
-        `google-sheets: createSpreadsheet failed (${response.status}): ${body}`
-      );
-    }
-    return await response.json();
-  }
-  return {
-    request,
-    getSpreadsheet,
-    getValues,
-    batchGetValues,
-    updateValues,
-    appendValues,
-    createSpreadsheet
-  };
-}
-
-// ../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) {
-    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)) {
-      result[`${this.connectorKey}_${t.name}`] = t.createTool(
-        myConnections,
-        config
-      );
-    }
-    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-sheets-oauth/tools/request.ts
-import { z } from "zod";
-init_utils2();
-var SHEETS_BASE_URL2 = "https://sheets.googleapis.com/v4/spreadsheets";
-var DRIVE_BASE_URL = "https://www.googleapis.com/drive/v3/files";
-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 Sheets OAuth connection to use"),
-  method: z.enum(["GET", "POST", "PUT"]).describe("HTTP method"),
-  path: z.string().describe(
-    "API path appended to https://sheets.googleapis.com/v4/spreadsheets (e.g., '/{spreadsheetId}', '/{spreadsheetId}/values/Sheet1!A1:D10'). Use 'drive://files' prefix for Google Drive API calls (e.g., creating new spreadsheets). {spreadsheetId} is automatically replaced if a default is configured."
-  ),
-  body: z.record(z.string(), z.unknown()).optional().describe("JSON request body for POST/PUT 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 Sheets API v4.
-Supports GET (read), POST (create/append), and PUT (update) methods.
-Authentication is handled automatically via OAuth proxy.
-{spreadsheetId} in the path is automatically replaced with the connection's default spreadsheet ID if configured.`,
-  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-sheets-oauth/${connection2.name}: ${method} ${path2}`
-    );
-    try {
-      const spreadsheetUrl = parameters.spreadsheetUrl.tryGetValue(connection2);
-      const spreadsheetId = spreadsheetUrl ? extractSpreadsheetId(spreadsheetUrl) : void 0;
-      let url;
-      if (path2.startsWith("drive://")) {
-        const drivePath = path2.slice("drive://".length);
-        url = `${DRIVE_BASE_URL}${drivePath.startsWith("/") ? "" : "/"}${drivePath}`;
-      } else {
-        const resolvedPath = spreadsheetId ? path2.replace(/\{spreadsheetId\}/g, spreadsheetId) : path2;
-        url = `${SHEETS_BASE_URL2}${resolvedPath.startsWith("/") ? "" : "/"}${resolvedPath}`;
-      }
-      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-sheets-oauth/setup.ts
-var requestToolName = `google-sheets-oauth_${requestTool.name}`;
-var googleSheetsOnboarding = new ConnectorOnboarding({
-  connectionSetupInstructions: {
-    ja: `\u4EE5\u4E0B\u306E\u624B\u9806\u3067Google Sheets\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306E\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3092\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8URL\u306F\u63A5\u7D9A\u30D1\u30E9\u30E1\u30FC\u30BF\u3068\u3057\u3066\u65E2\u306B\u767B\u9332\u6E08\u307F\u3067\u3059\u3002\u30E6\u30FC\u30B6\u30FC\u306B\u805E\u304D\u8FD4\u3055\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002
-
-1. \`${requestToolName}\` \u3092\u547C\u3073\u51FA\u3057\u3066\u3001\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u306E\u30E1\u30BF\u30C7\u30FC\u30BF\u3092\u53D6\u5F97\u3059\u308B:
-   - \`method\`: \`"GET"\`
-   - \`path\`: \`"/{spreadsheetId}?fields=spreadsheetId,properties.title,sheets.properties.title"\`
-2. \u30A8\u30E9\u30FC\u304C\u8FD4\u3055\u308C\u305F\u5834\u5408\u3001\u30E6\u30FC\u30B6\u30FC\u306B\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u306E\u5171\u6709\u8A2D\u5B9A\u3092\u78BA\u8A8D\u3059\u308B\u3088\u3046\u4F1D\u3048\u308B
-3. \`updateConnectionContext\` \u3092\u547C\u3073\u51FA\u3059:
-   - \`spreadsheet\`: \u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u306E\u30BF\u30A4\u30C8\u30EB
-   - \`sheets\`: \u30B7\u30FC\u30C8\u540D\u4E00\u89A7\uFF08\u30AB\u30F3\u30DE\u533A\u5207\u308A\uFF09
-   - \`note\`: \u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u5185\u5BB9\u306E\u7C21\u5358\u306A\u8AAC\u660E
-
-#### \u5236\u7D04
-- **\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u4E2D\u306B\u30B7\u30FC\u30C8\u306E\u30C7\u30FC\u30BF\u3092\u8AAD\u307F\u53D6\u3089\u306A\u3044\u3053\u3068**\u3002\u5B9F\u884C\u3057\u3066\u3088\u3044\u306E\u306F\u4E0A\u8A18\u624B\u9806\u3067\u6307\u5B9A\u3055\u308C\u305F\u30E1\u30BF\u30C7\u30FC\u30BF\u53D6\u5F97\u30EA\u30AF\u30A8\u30B9\u30C8\u306E\u307F
-- \u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8URL\u3092\u30E6\u30FC\u30B6\u30FC\u306B\u805E\u304D\u8FD4\u3055\u306A\u3044\u3053\u3068\uFF08\u767B\u9332\u6E08\u307F\u30D1\u30E9\u30E1\u30FC\u30BF\u3092\u305D\u306E\u307E\u307E\u4F7F\u7528\u3059\u308B\uFF09
-- \u30C4\u30FC\u30EB\u9593\u306F1\u6587\u3060\u3051\u66F8\u3044\u3066\u5373\u6B21\u306E\u30C4\u30FC\u30EB\u547C\u3073\u51FA\u3057\u3002\u4E0D\u8981\u306A\u8AAC\u660E\u306F\u7701\u7565\u3057\u3001\u52B9\u7387\u7684\u306B\u9032\u3081\u308B`,
-    en: `Follow these steps to set up the Google Sheets connection. The spreadsheet URL is already registered as a connection parameter \u2014 do NOT ask the user for it again.
-
-1. Call \`${requestToolName}\` to fetch spreadsheet metadata:
-   - \`method\`: \`"GET"\`
-   - \`path\`: \`"/{spreadsheetId}?fields=spreadsheetId,properties.title,sheets.properties.title"\`
-2. If an error is returned, ask the user to check the spreadsheet sharing settings
-3. Call \`updateConnectionContext\`:
-   - \`spreadsheet\`: The spreadsheet title
-   - \`sheets\`: Sheet names (comma-separated)
-   - \`note\`: Brief description of the setup
-
-#### Constraints
-- **Do NOT read sheet data during setup**. Only the metadata request specified in the steps above is allowed
-- Do NOT ask the user for the spreadsheet URL \u2014 it is already stored as a connection parameter
-- Write only 1 sentence between tool calls, then immediately call the next tool. Skip unnecessary explanations and proceed efficiently`
-  },
-  dataOverviewInstructions: {
-    en: `1. Call google-sheets-oauth_request with GET /{spreadsheetId} to get spreadsheet metadata (sheet names and properties)
-2. Call google-sheets-oauth_request with GET /{spreadsheetId}/values/{sheetName}!A1:Z5 to sample data from key sheets`,
-    ja: `1. google-sheets-oauth_request \u3067 GET /{spreadsheetId} \u3092\u547C\u3073\u51FA\u3057\u3001\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u306E\u30E1\u30BF\u30C7\u30FC\u30BF\uFF08\u30B7\u30FC\u30C8\u540D\u3068\u30D7\u30ED\u30D1\u30C6\u30A3\uFF09\u3092\u53D6\u5F97
-2. google-sheets-oauth_request \u3067 GET /{spreadsheetId}/values/{sheetName}!A1:Z5 \u3092\u547C\u3073\u51FA\u3057\u3001\u4E3B\u8981\u30B7\u30FC\u30C8\u306E\u30C7\u30FC\u30BF\u3092\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0`
-  }
-});
-
-// ../connectors/src/connectors/google-sheets-oauth/index.ts
-var tools = { request: requestTool };
-var googleSheetsOauthConnector = new ConnectorPlugin({
-  slug: "google-sheets",
-  authType: AUTH_TYPES.OAUTH,
-  name: "Google Sheets",
-  description: "Connect to Google Sheets for spreadsheet data access and creation using OAuth.",
-  iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/1UPQuggyiZmbb26CuaSr2h/032770e8739b183fa00b7625f024e536/google-sheets.svg",
-  parameters,
-  releaseFlag: { dev1: true, dev2: false, prod: false },
-  onboarding: googleSheetsOnboarding,
-  proxyPolicy: {
-    allowlist: [
-      {
-        host: "sheets.googleapis.com",
-        methods: ["GET", "POST", "PUT"]
-      },
-      {
-        host: "www.googleapis.com",
-        methods: ["POST"],
-        pathPrefix: "/drive/v3/files"
-      }
-    ]
-  },
-  systemPrompt: {
-    en: `### Tools
-
-- \`google-sheets-oauth_request\`: The way to call the Google Sheets API. Supports read and write operations. Use it to get/update spreadsheet metadata, cell values, create new spreadsheets, and more. Authentication is configured automatically via OAuth. The {spreadsheetId} placeholder in paths is automatically replaced with the configured default spreadsheet ID.
-
-### Google Sheets API Reference
-
-#### Read Endpoints
-- GET \`/{spreadsheetId}\` \u2014 Get spreadsheet metadata (title, sheets, properties)
-- GET \`/{spreadsheetId}/values/{range}\` \u2014 Get cell values for a range
-- GET \`/{spreadsheetId}/values:batchGet?ranges={range1}&ranges={range2}\` \u2014 Get values for multiple ranges
-
-#### Write Endpoints
-- POST \`\` (empty path, with body) \u2014 Create a new spreadsheet. Body: \`{ "properties": { "title": "My Sheet" }, "sheets": [{ "properties": { "title": "Sheet1" } }] }\`
-- PUT \`/{spreadsheetId}/values/{range}?valueInputOption=USER_ENTERED\` \u2014 Update cell values for a range. Body: \`{ "range": "Sheet1!A1:B2", "majorDimension": "ROWS", "values": [["a","b"],["c","d"]] }\`
-- POST \`/{spreadsheetId}/values/{range}:append?valueInputOption=USER_ENTERED&insertDataOption=INSERT_ROWS\` \u2014 Append rows after the last row. Body: \`{ "range": "Sheet1!A1", "majorDimension": "ROWS", "values": [["a","b"]] }\`
-- POST \`/{spreadsheetId}:batchUpdate\` \u2014 Apply multiple updates (formatting, add sheets, merge cells, etc.). Body: \`{ "requests": [...] }\`
-
-### Range Notation (A1 notation)
-- \`Sheet1!A1:D10\` \u2014 Specific range on Sheet1
-- \`Sheet1!A:A\` \u2014 Entire column A on Sheet1
-- \`Sheet1!1:3\` \u2014 Rows 1 to 3 on Sheet1
-- \`Sheet1\` \u2014 All data on Sheet1
-- \`A1:D10\` \u2014 Range on the first sheet (when only one sheet exists)
-
-### Tips
-- Use \`{spreadsheetId}\` placeholder in paths \u2014 it is automatically replaced with the configured default spreadsheet ID
-- To explore a spreadsheet, first get metadata to see available sheet names
-- Use \`valueRenderOption=FORMATTED_VALUE\` query param to get display values
-- Use \`valueRenderOption=UNFORMATTED_VALUE\` for raw numeric values
-- Use \`majorDimension=COLUMNS\` to get data organized by columns instead of rows
-- For write operations, always use \`valueInputOption=USER_ENTERED\` so values are parsed as if typed by a user (dates, numbers, formulas are auto-detected)
-
-### 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-sheets-oauth";
-
-const sheets = connection("<connectionId>");
-
-// Get spreadsheet metadata
-const metadata = await sheets.getSpreadsheet();
-console.log(metadata.properties.title, metadata.sheets.map(s => s.properties.title));
-
-// Get cell values
-const values = await sheets.getValues("Sheet1!A1:D10");
-console.log(values.values); // 2D array
-
-// Get multiple ranges at once
-const batch = await sheets.batchGetValues(["Sheet1!A1:B5", "Sheet2!A1:C3"]);
-batch.valueRanges.forEach(vr => console.log(vr.range, vr.values));
-
-// Update cell values
-await sheets.updateValues("Sheet1!A1:B2", [["Name", "Score"], ["Alice", "100"]]);
-
-// Append rows
-await sheets.appendValues("Sheet1!A1", [["Bob", "95"], ["Charlie", "88"]]);
-
-// Create a new spreadsheet
-const newSheet = await sheets.createSpreadsheet("Sales Report", ["Q1", "Q2", "Q3", "Q4"]);
-console.log(newSheet.spreadsheetId, newSheet.spreadsheetUrl);
-\`\`\``,
-    ja: `### \u30C4\u30FC\u30EB
-
-- \`google-sheets-oauth_request\`: Google Sheets 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\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u306E\u30E1\u30BF\u30C7\u30FC\u30BF\u30FB\u30BB\u30EB\u5024\u306E\u53D6\u5F97/\u66F4\u65B0\u3001\u65B0\u3057\u3044\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u306E\u4F5C\u6210\u306A\u3069\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002OAuth\u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002\u30D1\u30B9\u5185\u306E{spreadsheetId}\u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u306F\u8A2D\u5B9A\u6E08\u307F\u306E\u30C7\u30D5\u30A9\u30EB\u30C8\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8ID\u3067\u81EA\u52D5\u7684\u306B\u7F6E\u63DB\u3055\u308C\u307E\u3059\u3002
-
-### Google Sheets API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
-
-#### \u8AAD\u307F\u53D6\u308A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
-- GET \`/{spreadsheetId}\` \u2014 \u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u306E\u30E1\u30BF\u30C7\u30FC\u30BF\u3092\u53D6\u5F97\uFF08\u30BF\u30A4\u30C8\u30EB\u3001\u30B7\u30FC\u30C8\u3001\u30D7\u30ED\u30D1\u30C6\u30A3\uFF09
-- GET \`/{spreadsheetId}/values/{range}\` \u2014 \u7BC4\u56F2\u306E\u30BB\u30EB\u5024\u3092\u53D6\u5F97
-- GET \`/{spreadsheetId}/values:batchGet?ranges={range1}&ranges={range2}\` \u2014 \u8907\u6570\u7BC4\u56F2\u306E\u5024\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\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u3092\u4F5C\u6210\u3002Body: \`{ "properties": { "title": "\u30DE\u30A4\u30B7\u30FC\u30C8" }, "sheets": [{ "properties": { "title": "Sheet1" } }] }\`
-- PUT \`/{spreadsheetId}/values/{range}?valueInputOption=USER_ENTERED\` \u2014 \u7BC4\u56F2\u306E\u30BB\u30EB\u5024\u3092\u66F4\u65B0\u3002Body: \`{ "range": "Sheet1!A1:B2", "majorDimension": "ROWS", "values": [["a","b"],["c","d"]] }\`
-- POST \`/{spreadsheetId}/values/{range}:append?valueInputOption=USER_ENTERED&insertDataOption=INSERT_ROWS\` \u2014 \u6700\u7D42\u884C\u306E\u5F8C\u306B\u884C\u3092\u8FFD\u52A0\u3002Body: \`{ "range": "Sheet1!A1", "majorDimension": "ROWS", "values": [["a","b"]] }\`
-- POST \`/{spreadsheetId}:batchUpdate\` \u2014 \u8907\u6570\u306E\u66F4\u65B0\u3092\u9069\u7528\uFF08\u66F8\u5F0F\u8A2D\u5B9A\u3001\u30B7\u30FC\u30C8\u8FFD\u52A0\u3001\u30BB\u30EB\u7D50\u5408\u306A\u3069\uFF09\u3002Body: \`{ "requests": [...] }\`
-
-### \u7BC4\u56F2\u306E\u8868\u8A18\u6CD5\uFF08A1\u8868\u8A18\u6CD5\uFF09
-- \`Sheet1!A1:D10\` \u2014 Sheet1\u4E0A\u306E\u7279\u5B9A\u7BC4\u56F2
-- \`Sheet1!A:A\` \u2014 Sheet1\u306EA\u5217\u5168\u4F53
-- \`Sheet1!1:3\` \u2014 Sheet1\u306E1\u884C\u76EE\u304B\u30893\u884C\u76EE
-- \`Sheet1\` \u2014 Sheet1\u306E\u5168\u30C7\u30FC\u30BF
-- \`A1:D10\` \u2014 \u6700\u521D\u306E\u30B7\u30FC\u30C8\u306E\u7BC4\u56F2\uFF08\u30B7\u30FC\u30C8\u304C1\u3064\u306E\u307F\u306E\u5834\u5408\uFF09
-
-### \u30D2\u30F3\u30C8
-- \u30D1\u30B9\u306B \`{spreadsheetId}\` \u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u3092\u4F7F\u7528 \u2014 \u8A2D\u5B9A\u6E08\u307F\u306E\u30C7\u30D5\u30A9\u30EB\u30C8\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8ID\u3067\u81EA\u52D5\u7684\u306B\u7F6E\u63DB\u3055\u308C\u307E\u3059
-- \u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u3092\u63A2\u7D22\u3059\u308B\u306B\u306F\u3001\u307E\u305A\u30E1\u30BF\u30C7\u30FC\u30BF\u3092\u53D6\u5F97\u3057\u3066\u5229\u7528\u53EF\u80FD\u306A\u30B7\u30FC\u30C8\u540D\u3092\u78BA\u8A8D\u3057\u307E\u3059
-- \u8868\u793A\u5024\u3092\u53D6\u5F97\u3059\u308B\u306B\u306F \`valueRenderOption=FORMATTED_VALUE\` \u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF\u3092\u4F7F\u7528\u3057\u307E\u3059
-- \u751F\u306E\u6570\u5024\u3092\u53D6\u5F97\u3059\u308B\u306B\u306F \`valueRenderOption=UNFORMATTED_VALUE\` \u3092\u4F7F\u7528\u3057\u307E\u3059
-- \u5217\u3054\u3068\u306B\u30C7\u30FC\u30BF\u3092\u53D6\u5F97\u3059\u308B\u306B\u306F \`majorDimension=COLUMNS\` \u3092\u4F7F\u7528\u3057\u307E\u3059
-- \u66F8\u304D\u8FBC\u307F\u64CD\u4F5C\u3067\u306F\u5E38\u306B \`valueInputOption=USER_ENTERED\` \u3092\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u5024\u304C\u30E6\u30FC\u30B6\u30FC\u5165\u529B\u306E\u3088\u3046\u306B\u89E3\u6790\u3055\u308C\u307E\u3059\uFF08\u65E5\u4ED8\u3001\u6570\u5024\u3001\u6570\u5F0F\u304C\u81EA\u52D5\u691C\u51FA\uFF09
-
-### 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-sheets-oauth";
-
-const sheets = connection("<connectionId>");
-
-// \u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u306E\u30E1\u30BF\u30C7\u30FC\u30BF\u3092\u53D6\u5F97
-const metadata = await sheets.getSpreadsheet();
-console.log(metadata.properties.title, metadata.sheets.map(s => s.properties.title));
-
-// \u30BB\u30EB\u5024\u3092\u53D6\u5F97
-const values = await sheets.getValues("Sheet1!A1:D10");
-console.log(values.values); // 2D array
-
-// \u8907\u6570\u7BC4\u56F2\u306E\u5024\u3092\u4E00\u5EA6\u306B\u53D6\u5F97
-const batch = await sheets.batchGetValues(["Sheet1!A1:B5", "Sheet2!A1:C3"]);
-batch.valueRanges.forEach(vr => console.log(vr.range, vr.values));
-
-// \u30BB\u30EB\u5024\u3092\u66F4\u65B0
-await sheets.updateValues("Sheet1!A1:B2", [["\u540D\u524D", "\u30B9\u30B3\u30A2"], ["Alice", "100"]]);
-
-// \u884C\u3092\u8FFD\u52A0
-await sheets.appendValues("Sheet1!A1", [["Bob", "95"], ["Charlie", "88"]]);
-
-// \u65B0\u3057\u3044\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u3092\u4F5C\u6210
-const newSheet = await sheets.createSpreadsheet("\u58F2\u4E0A\u30EC\u30DD\u30FC\u30C8", ["Q1", "Q2", "Q3", "Q4"]);
-console.log(newSheet.spreadsheetId, newSheet.spreadsheetUrl);
-\`\`\``
-  },
-  tools,
-  async checkConnection(params, config) {
-    const { proxyFetch } = config;
-    const spreadsheetUrl = params[parameters.spreadsheetUrl.slug];
-    if (!spreadsheetUrl) {
-      return { success: true };
-    }
-    const { extractSpreadsheetId: extractSpreadsheetId2 } = await Promise.resolve().then(() => (init_utils2(), utils_exports));
-    const spreadsheetId = extractSpreadsheetId2(spreadsheetUrl);
-    const url = `https://sheets.googleapis.com/v4/spreadsheets/${spreadsheetId}?fields=spreadsheetId,properties.title`;
-    try {
-      const res = await proxyFetch(url, { method: "GET" });
-      if (!res.ok) {
-        const errorText = await res.text().catch(() => res.statusText);
-        return {
-          success: false,
-          error: `Google Sheets API failed: HTTP ${res.status} ${errorText}`
-        };
-      }
-      return { success: true };
-    } catch (error) {
-      return {
-        success: false,
-        error: error instanceof Error ? error.message : String(error)
-      };
-    }
-  }
-});
-
-// 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-sheets-oauth.ts
-var connection = createConnectorSdk(googleSheetsOauthConnector, createClient);
-export {
-  connection
-};