@squadbase/vite-server 0.1.3-dev.5 → 0.1.3-dev.7

package/dist/connectors/google-calendar.js

@@ -56,6 +56,15 @@ var parameters = {
     secret: true,
     required: true
   }),
+  impersonateEmail: new ParameterDefinition({
+    slug: "impersonate-email",
+    name: "User Email Address",
+    description: "The email address of the Google Workspace user whose calendar will be accessed via Domain-wide Delegation (e.g., 'user@example.com'). The service account will act on behalf of this user.",
+    envVarBaseKey: "GOOGLE_CALENDAR_IMPERSONATE_EMAIL",
+    type: "text",
+    secret: false,
+    required: true
+  }),
   calendarId: new ParameterDefinition({
     slug: "calendar-id",
     name: "Default Calendar ID",
@@ -75,17 +84,19 @@ function base64url(input) {
   const buf = typeof input === "string" ? Buffer.from(input) : input;
   return buf.toString("base64url");
 }
-function buildJwt(clientEmail, privateKey, nowSec) {
+function buildJwt(clientEmail, privateKey, nowSec, subject) {
   const header = base64url(JSON.stringify({ alg: "RS256", typ: "JWT" }));
-  const payload = base64url(
-    JSON.stringify({
-      iss: clientEmail,
-      scope: SCOPE,
-      aud: TOKEN_URL,
-      iat: nowSec,
-      exp: nowSec + 3600
-    })
-  );
+  const claims = {
+    iss: clientEmail,
+    scope: SCOPE,
+    aud: TOKEN_URL,
+    iat: nowSec,
+    exp: nowSec + 3600
+  };
+  if (subject) {
+    claims.sub = subject;
+  }
+  const payload = base64url(JSON.stringify(claims));
   const signingInput = `${header}.${payload}`;
   const sign = crypto.createSign("RSA-SHA256");
   sign.update(signingInput);
@@ -93,14 +104,20 @@ function buildJwt(clientEmail, privateKey, nowSec) {
   const signature = base64url(sign.sign(privateKey));
   return `${signingInput}.${signature}`;
 }
-function createClient(params) {
+function createClient(params, options) {
   const serviceAccountKeyJsonBase64 = params[parameters.serviceAccountKeyJsonBase64.slug];
+  const impersonateEmail = params[parameters.impersonateEmail.slug];
   const defaultCalendarId = params[parameters.calendarId.slug] ?? "primary";
   if (!serviceAccountKeyJsonBase64) {
     throw new Error(
       `google-calendar: missing required parameter: ${parameters.serviceAccountKeyJsonBase64.slug}`
     );
   }
+  if (!impersonateEmail && !options?.subject) {
+    throw new Error(
+      `google-calendar: missing required parameter: ${parameters.impersonateEmail.slug}`
+    );
+  }
   let serviceAccountKey;
   try {
     const decoded = Buffer.from(
@@ -118,6 +135,7 @@ function createClient(params) {
       "google-calendar: service account key JSON must contain client_email and private_key"
     );
   }
+  const subject = options?.subject ?? impersonateEmail;
   let cachedToken = null;
   let tokenExpiresAt = 0;
   async function getAccessToken() {
@@ -128,7 +146,8 @@ function createClient(params) {
     const jwt = buildJwt(
       serviceAccountKey.client_email,
       serviceAccountKey.private_key,
-      nowSec
+      nowSec,
+      subject
     );
     const response = await fetch(TOKEN_URL, {
       method: "POST",
@@ -177,18 +196,18 @@ function createClient(params) {
       const data = await response.json();
       return data.items ?? [];
     },
-    async listEvents(options, calendarId) {
+    async listEvents(options2, calendarId) {
       const cid = resolveCalendarId(calendarId);
       const searchParams = new URLSearchParams();
-      if (options?.timeMin) searchParams.set("timeMin", options.timeMin);
-      if (options?.timeMax) searchParams.set("timeMax", options.timeMax);
-      if (options?.maxResults)
-        searchParams.set("maxResults", String(options.maxResults));
-      if (options?.q) searchParams.set("q", options.q);
-      if (options?.singleEvents != null)
-        searchParams.set("singleEvents", String(options.singleEvents));
-      if (options?.orderBy) searchParams.set("orderBy", options.orderBy);
-      if (options?.pageToken) searchParams.set("pageToken", options.pageToken);
+      if (options2?.timeMin) searchParams.set("timeMin", options2.timeMin);
+      if (options2?.timeMax) searchParams.set("timeMax", options2.timeMax);
+      if (options2?.maxResults)
+        searchParams.set("maxResults", String(options2.maxResults));
+      if (options2?.q) searchParams.set("q", options2.q);
+      if (options2?.singleEvents != null)
+        searchParams.set("singleEvents", String(options2.singleEvents));
+      if (options2?.orderBy) searchParams.set("orderBy", options2.orderBy);
+      if (options2?.pageToken) searchParams.set("pageToken", options2.pageToken);
       const qs = searchParams.toString();
       const path2 = `/calendars/${encodeURIComponent(cid)}/events${qs ? `?${qs}` : ""}`;
       const response = await this.request(path2, { method: "GET" });
@@ -327,6 +346,34 @@ var AUTH_TYPES = {
 
 // ../connectors/src/connectors/google-calendar/setup.ts
 var googleCalendarOnboarding = new ConnectorOnboarding({
+  connectionSetupInstructions: {
+    ja: `\u4EE5\u4E0B\u306E\u624B\u9806\u3067Google Calendar\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306E\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3092\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002
+
+1. \u30E6\u30FC\u30B6\u30FC\u306B\u300C\u30AB\u30EC\u30F3\u30C0\u30FC\u306B\u30A2\u30AF\u30BB\u30B9\u3057\u305F\u3044Google Workspace\u30A2\u30AB\u30A6\u30F3\u30C8\u306E\u30E1\u30FC\u30EB\u30A2\u30C9\u30EC\u30B9\u3092\u6559\u3048\u3066\u304F\u3060\u3055\u3044\uFF08\u4F8B: user@example.com\uFF09\u300D\u3068\u4F1D\u3048\u308B
+2. \u30E6\u30FC\u30B6\u30FC\u304C\u30E1\u30FC\u30EB\u30A2\u30C9\u30EC\u30B9\u3092\u63D0\u4F9B\u3057\u305F\u3089\u3001\`updateConnectionParameters\` \u3092\u547C\u3073\u51FA\u3059:
+   - \`parameterSlug\`: \`"impersonate-email"\`
+   - \`value\`: \u30E6\u30FC\u30B6\u30FC\u304C\u63D0\u4F9B\u3057\u305F\u30E1\u30FC\u30EB\u30A2\u30C9\u30EC\u30B9
+3. \`updateConnectionContext\` \u3092\u547C\u3073\u51FA\u3057\u3066\u3001\u5BFE\u8C61\u30E6\u30FC\u30B6\u30FC\u306E\u60C5\u5831\u3092\u8A18\u9332\u3059\u308B:
+   - \`user\`: \u8A2D\u5B9A\u3057\u305F\u30E1\u30FC\u30EB\u30A2\u30C9\u30EC\u30B9
+   - \`note\`: \u300CDomain-wide Delegation\u3067 {email} \u306E\u30AB\u30EC\u30F3\u30C0\u30FC\u306B\u30A2\u30AF\u30BB\u30B9\u300D\u306A\u3069\u306E\u8AAC\u660E
+
+#### \u5236\u7D04
+- **\u30B5\u30FC\u30D3\u30B9\u30A2\u30AB\u30A6\u30F3\u30C8\u306E\u30C9\u30E1\u30A4\u30F3\u5168\u4F53\u306E\u59D4\u4EFB\u8A2D\u5B9A\u304C\u5FC5\u8981\u3067\u3059**\u3002\u30A2\u30AF\u30BB\u30B9\u6A29\u9650\u30A8\u30E9\u30FC\u304C\u51FA\u308B\u5834\u5408\u3001Google Workspace\u7BA1\u7406\u8005\u306BDomain-wide Delegation\u306E\u8A2D\u5B9A\u78BA\u8A8D\u3092\u4FC3\u3057\u3066\u304F\u3060\u3055\u3044
+- \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 Calendar connection.
+
+1. Ask the user for the Google Workspace email address whose calendar should be accessed (e.g., user@example.com)
+2. When the user provides an email, call \`updateConnectionParameters\`:
+   - \`parameterSlug\`: \`"impersonate-email"\`
+   - \`value\`: The email provided by the user
+3. Call \`updateConnectionContext\` to record the target user:
+   - \`user\`: The configured email address
+   - \`note\`: A description such as "Accessing {email}'s calendar via Domain-wide Delegation"
+
+#### Constraints
+- **Domain-wide Delegation must be configured on the service account**. If access errors occur, ask the user to verify the Domain-wide Delegation setup with their Google Workspace administrator
+- Write only 1 sentence between tool calls, then immediately call the next tool. Skip unnecessary explanations and proceed efficiently`
+  },
   dataOverviewInstructions: {
     en: `1. Call google-calendar_request with GET /calendars/{calendarId} to get the default calendar's metadata
 2. Call google-calendar_request with GET /users/me/calendarList to list all accessible calendars
@@ -351,7 +398,10 @@ var inputSchema = z.object({
     "API path appended to https://www.googleapis.com/calendar/v3 (e.g., '/calendars/{calendarId}/events'). {calendarId} is automatically replaced."
   ),
   queryParams: z.record(z.string(), z.string()).optional().describe("Query parameters to append to the URL"),
-  body: z.record(z.string(), z.unknown()).optional().describe("Request body (JSON) for POST/PUT/PATCH methods")
+  body: z.record(z.string(), z.unknown()).optional().describe("Request body (JSON) for POST/PUT/PATCH methods"),
+  subject: z.string().optional().describe(
+    "Override the email address of the user to impersonate via Domain-wide Delegation. If omitted, the connection's configured user email is used."
+  )
 });
 var outputSchema = z.discriminatedUnion("success", [
   z.object({
@@ -371,7 +421,7 @@ Authentication is handled automatically using a service account.
 {calendarId} in the path is automatically replaced with the connection's default calendar ID.`,
   inputSchema,
   outputSchema,
-  async execute({ connectionId, method, path: path2, queryParams, body }, connections) {
+  async execute({ connectionId, method, path: path2, queryParams, body, subject }, connections) {
     const connection2 = connections.find((c) => c.id === connectionId);
     if (!connection2) {
       return {
@@ -385,7 +435,15 @@ Authentication is handled automatically using a service account.
     try {
       const { GoogleAuth } = await import("google-auth-library");
       const keyJsonBase64 = parameters.serviceAccountKeyJsonBase64.getValue(connection2);
+      const impersonateEmail = parameters.impersonateEmail.tryGetValue(connection2);
       const calendarId = parameters.calendarId.tryGetValue(connection2) ?? "primary";
+      const resolvedSubject = subject ?? impersonateEmail;
+      if (!resolvedSubject) {
+        return {
+          success: false,
+          error: `Missing required parameter: ${parameters.impersonateEmail.slug}. Configure the user email for this connection.`
+        };
+      }
       const credentials = JSON.parse(
         Buffer.from(keyJsonBase64, "base64").toString("utf-8")
       );
@@ -394,7 +452,8 @@ Authentication is handled automatically using a service account.
         scopes: [
           "https://www.googleapis.com/auth/calendar.readonly",
           "https://www.googleapis.com/auth/calendar.events.readonly"
-        ]
+        ],
+        clientOptions: { subject: resolvedSubject }
       });
       const token = await auth.getAccessToken();
       if (!token) {
@@ -454,25 +513,33 @@ var googleCalendarConnector = new ConnectorPlugin({
   authType: AUTH_TYPES.SERVICE_ACCOUNT,
   name: "Google Calendar",
   description: "Connect to Google Calendar for calendar and event data access using a service account.",
-  iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/5D9eTiMxiL7MaezWXyAaLG/dbcf25e1d51ab877548b3d77e4b02c6d/google-calendar.svg",
+  iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/2YsqoBEpdELmfDeFcyGHyE/4494c633b5ae15e562cb739cd85442c1/google-calendar.png",
   parameters,
   releaseFlag: { dev1: true, dev2: true, prod: true },
   onboarding: googleCalendarOnboarding,
   systemPrompt: {
     en: `### Tools
 
-- \`google-calendar_request\`: The only way to call the Google Calendar API. Use it to list calendars, get events, and manage calendar data. Authentication is handled automatically using a service account. The {calendarId} placeholder in paths is automatically replaced with the configured default calendar ID.
+- \`google-calendar_request\`: The only way to call the Google Calendar API. Use it to list calendars, get events, and manage calendar data. Authentication is handled automatically using a service account with Domain-wide Delegation \u2014 the service account impersonates the user configured on the connection (\`impersonate-email\` parameter). The {calendarId} placeholder in paths is automatically replaced with the configured default calendar ID. Pass an optional \`subject\` only if you need to override the configured user for a specific request.
 
 ### Business Logic
 
 The business logic type for this connector is "typescript". Use the connector SDK in your handler. Do NOT read credentials from environment variables.
 
-SDK methods (client created via \`connection(connectionId)\`):
+SDK methods (client created via \`connection(connectionId)\` \u2014 the connection's \`impersonate-email\` parameter is used automatically for Domain-wide Delegation):
 - \`client.listCalendars()\` \u2014 list all accessible calendars
 - \`client.listEvents(options?, calendarId?)\` \u2014 list events with optional filters
 - \`client.getEvent(eventId, calendarId?)\` \u2014 get a single event by ID
 - \`client.request(path, init?)\` \u2014 low-level authenticated fetch
 
+#### Domain-wide Delegation
+
+The target user email is configured on the connection (\`impersonate-email\` parameter), so \`connection()\` automatically uses it. Pass \`subject\` only to override it:
+
+\`\`\`ts
+const calendar = connection("<connectionId>", { subject: "other-user@example.com" });
+\`\`\`
+
 \`\`\`ts
 import type { Context } from "hono";
 import { connection } from "@squadbase/vite-server/connectors/google-calendar";
@@ -524,18 +591,26 @@ export default async function handler(c: Context) {
 - The default calendar ID is "primary" if not configured`,
     ja: `### \u30C4\u30FC\u30EB
 
-- \`google-calendar_request\`: Google Calendar API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30AB\u30EC\u30F3\u30C0\u30FC\u306E\u4E00\u89A7\u53D6\u5F97\u3001\u30A4\u30D9\u30F3\u30C8\u306E\u53D6\u5F97\u3001\u30AB\u30EC\u30F3\u30C0\u30FC\u30C7\u30FC\u30BF\u306E\u7BA1\u7406\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u30B5\u30FC\u30D3\u30B9\u30A2\u30AB\u30A6\u30F3\u30C8\u3092\u4F7F\u7528\u3057\u3066\u8A8D\u8A3C\u306F\u81EA\u52D5\u7684\u306B\u51E6\u7406\u3055\u308C\u307E\u3059\u3002\u30D1\u30B9\u5185\u306E{calendarId}\u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u306F\u8A2D\u5B9A\u6E08\u307F\u306E\u30C7\u30D5\u30A9\u30EB\u30C8\u30AB\u30EC\u30F3\u30C0\u30FCID\u3067\u81EA\u52D5\u7684\u306B\u7F6E\u63DB\u3055\u308C\u307E\u3059\u3002
+- \`google-calendar_request\`: Google Calendar API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30AB\u30EC\u30F3\u30C0\u30FC\u306E\u4E00\u89A7\u53D6\u5F97\u3001\u30A4\u30D9\u30F3\u30C8\u306E\u53D6\u5F97\u3001\u30AB\u30EC\u30F3\u30C0\u30FC\u30C7\u30FC\u30BF\u306E\u7BA1\u7406\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u30B5\u30FC\u30D3\u30B9\u30A2\u30AB\u30A6\u30F3\u30C8\uFF0BDomain-wide Delegation\u3067\u8A8D\u8A3C\u304C\u81EA\u52D5\u7684\u306B\u51E6\u7406\u3055\u308C\u3001\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306B\u8A2D\u5B9A\u3055\u308C\u305F\u30E6\u30FC\u30B6\u30FC\uFF08\`impersonate-email\`\u30D1\u30E9\u30E1\u30FC\u30BF\uFF09\u3068\u3057\u3066\u52D5\u4F5C\u3057\u307E\u3059\u3002\u30D1\u30B9\u5185\u306E{calendarId}\u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u306F\u8A2D\u5B9A\u6E08\u307F\u306E\u30C7\u30D5\u30A9\u30EB\u30C8\u30AB\u30EC\u30F3\u30C0\u30FCID\u3067\u81EA\u52D5\u7684\u306B\u7F6E\u63DB\u3055\u308C\u307E\u3059\u3002\u7279\u5B9A\u30EA\u30AF\u30A8\u30B9\u30C8\u3067\u8A2D\u5B9A\u30E6\u30FC\u30B6\u30FC\u3092\u4E0A\u66F8\u304D\u3057\u305F\u3044\u5834\u5408\u306E\u307F\u3001\u30AA\u30D7\u30B7\u30E7\u30F3\u306E\`subject\`\u30D1\u30E9\u30E1\u30FC\u30BF\u3092\u6E21\u3057\u3066\u304F\u3060\u3055\u3044\u3002
 
 ### 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\u30CF\u30F3\u30C9\u30E9\u5185\u3067\u306F\u30B3\u30CD\u30AF\u30BFSDK\u3092\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u74B0\u5883\u5909\u6570\u304B\u3089\u8A8D\u8A3C\u60C5\u5831\u3092\u8AAD\u307F\u53D6\u3089\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002
 
-SDK\u30E1\u30BD\u30C3\u30C9 (\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8):
+SDK\u30E1\u30BD\u30C3\u30C9 (\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8 \u2014 \u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306E\`impersonate-email\`\u30D1\u30E9\u30E1\u30FC\u30BF\u304C\u81EA\u52D5\u7684\u306BDomain-wide Delegation\u306Esubject\u3068\u3057\u3066\u4F7F\u308F\u308C\u307E\u3059):
 - \`client.listCalendars()\` \u2014 \u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u5168\u30AB\u30EC\u30F3\u30C0\u30FC\u306E\u4E00\u89A7\u53D6\u5F97
 - \`client.listEvents(options?, calendarId?)\` \u2014 \u30D5\u30A3\u30EB\u30BF\u30FC\u4ED8\u304D\u30A4\u30D9\u30F3\u30C8\u4E00\u89A7\u53D6\u5F97
 - \`client.getEvent(eventId, calendarId?)\` \u2014 ID\u306B\u3088\u308B\u5358\u4E00\u30A4\u30D9\u30F3\u30C8\u53D6\u5F97
 - \`client.request(path, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u306E\u8A8D\u8A3C\u4ED8\u304Dfetch
 
+#### Domain-wide Delegation
+
+\u5BFE\u8C61\u30E6\u30FC\u30B6\u30FC\u306E\u30E1\u30FC\u30EB\u30A2\u30C9\u30EC\u30B9\u306F\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\uFF08\`impersonate-email\`\u30D1\u30E9\u30E1\u30FC\u30BF\uFF09\u306B\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u308B\u305F\u3081\u3001\`connection()\`\u306F\u81EA\u52D5\u7684\u306B\u305D\u308C\u3092\u4F7F\u3044\u307E\u3059\u3002\u4E0A\u66F8\u304D\u3057\u305F\u3044\u5834\u5408\u306E\u307F\`subject\`\u3092\u6E21\u3057\u307E\u3059\uFF1A
+
+\`\`\`ts
+const calendar = connection("<connectionId>", { subject: "other-user@example.com" });
+\`\`\`
+
 \`\`\`ts
 import type { Context } from "hono";
 import { connection } from "@squadbase/vite-server/connectors/google-calendar";
@@ -649,7 +724,16 @@ function createConnectorSdk(plugin, createClient2) {
 }
 
 // src/connectors/entries/google-calendar.ts
-var connection = createConnectorSdk(googleCalendarConnector, createClient);
+var baseConnection = createConnectorSdk(googleCalendarConnector, createClient);
+var connection = (connectionId, options) => {
+  if (options) {
+    return createConnectorSdk(
+      googleCalendarConnector,
+      (params) => createClient(params, options)
+    )(connectionId);
+  }
+  return baseConnection(connectionId);
+};
 export {
   connection
 };

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

@@ -1,3 +1,42 @@
+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;
@@ -44,11 +83,11 @@ var ParameterDefinition = class {
 
 // ../connectors/src/connectors/google-sheets-oauth/parameters.ts
 var parameters = {
-  spreadsheetId: new ParameterDefinition({
-    slug: "spreadsheet-id",
-    name: "Default Spreadsheet ID",
-    description: "The ID of the default Google Spreadsheet. Can be found in the spreadsheet URL: https://docs.google.com/spreadsheets/d/{spreadsheetId}/edit",
-    envVarBaseKey: "GOOGLE_SHEETS_OAUTH_SPREADSHEET_ID",
+  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
@@ -56,9 +95,11 @@ var parameters = {
 };
 
 // ../connectors/src/connectors/google-sheets-oauth/sdk/index.ts
+init_utils2();
 var BASE_URL = "https://sheets.googleapis.com/v4/spreadsheets";
 function createClient(params, fetchFn = fetch) {
-  const defaultSpreadsheetId = params[parameters.spreadsheetId.slug];
+  const spreadsheetUrl = params[parameters.spreadsheetUrl.slug];
+  const defaultSpreadsheetId = spreadsheetUrl ? extractSpreadsheetId(spreadsheetUrl) : void 0;
   function resolveSpreadsheetId(override) {
     const id = override ?? defaultSpreadsheetId;
     if (!id) {
@@ -233,6 +274,7 @@ var AUTH_TYPES = {
 
 // ../connectors/src/connectors/google-sheets-oauth/tools/request.ts
 import { z } from "zod";
+init_utils2();
 var BASE_URL2 = "https://sheets.googleapis.com/v4/spreadsheets";
 var REQUEST_TIMEOUT_MS = 6e4;
 var cachedToken = null;
@@ -307,7 +349,8 @@ Authentication is handled automatically via OAuth proxy.
       `[connector-request] google-sheets-oauth/${connection2.name}: ${method} ${path2}`
     );
     try {
-      const spreadsheetId = parameters.spreadsheetId.tryGetValue(connection2);
+      const spreadsheetUrl = parameters.spreadsheetUrl.tryGetValue(connection2);
+      const spreadsheetId = spreadsheetUrl ? extractSpreadsheetId(spreadsheetUrl) : void 0;
       const resolvedPath = spreadsheetId ? path2.replace(/\{spreadsheetId\}/g, spreadsheetId) : path2;
       let url = `${BASE_URL2}${resolvedPath.startsWith("/") ? "" : "/"}${resolvedPath}`;
       if (queryParams) {
@@ -354,15 +397,14 @@ var googleSheetsOnboarding = new ConnectorOnboarding({
     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
 
 1. \u30E6\u30FC\u30B6\u30FC\u306B\u300C\u4F7F\u7528\u3059\u308BGoogle Sheets\u306EURL\u3092\u8CBC\u308A\u4ED8\u3051\u3066\u304F\u3060\u3055\u3044\uFF08\u4F8B: https://docs.google.com/spreadsheets/d/xxxxx/edit\uFF09\u300D\u3068\u4F1D\u3048\u308B
-2. \u30E6\u30FC\u30B6\u30FC\u304CURL\u307E\u305F\u306F\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8ID\u3092\u63D0\u4F9B\u3057\u305F\u3089\u3001URL\u304B\u3089ID\u3092\u62BD\u51FA\u3059\u308B\uFF08\`/d/\` \u3068 \`/edit\` \u306E\u9593\u306E\u6587\u5B57\u5217\uFF09
-3. \`updateConnectionParameters\` \u3092\u547C\u3073\u51FA\u3059:
-   - \`parameterSlug\`: \`"spreadsheet-id"\`
-   - \`value\`: \u62BD\u51FA\u3057\u305F\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8ID
-4. \`${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:
+2. \u30E6\u30FC\u30B6\u30FC\u304CURL\u3092\u63D0\u4F9B\u3057\u305F\u3089\u3001\`updateConnectionParameters\` \u3092\u547C\u3073\u51FA\u3059:
+   - \`parameterSlug\`: \`"spreadsheet-url"\`
+   - \`value\`: \u30E6\u30FC\u30B6\u30FC\u304C\u63D0\u4F9B\u3057\u305FURL\uFF08\u305D\u306E\u307E\u307E\u4FDD\u5B58\u3002ID\u306E\u62BD\u51FA\u306F\u81EA\u52D5\u3067\u884C\u308F\u308C\u307E\u3059\uFF09
+3. \`${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"\`
-5. \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
-6. \`updateConnectionContext\` \u3092\u547C\u3073\u51FA\u3059:
+4. \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
+5. \`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
@@ -373,15 +415,14 @@ var googleSheetsOnboarding = new ConnectorOnboarding({
     en: `Follow these steps to set up the Google Sheets connection.
 
 1. Ask the user to paste the Google Sheets URL (e.g., https://docs.google.com/spreadsheets/d/xxxxx/edit)
-2. When the user provides a URL or spreadsheet ID, extract the ID from the URL (the string between \`/d/\` and \`/edit\`)
-3. Call \`updateConnectionParameters\`:
-   - \`parameterSlug\`: \`"spreadsheet-id"\`
-   - \`value\`: The extracted spreadsheet ID
-4. Call \`${requestToolName}\` to fetch spreadsheet metadata:
+2. When the user provides a URL, call \`updateConnectionParameters\`:
+   - \`parameterSlug\`: \`"spreadsheet-url"\`
+   - \`value\`: The URL provided by the user (save as-is; the spreadsheet ID is extracted automatically)
+3. Call \`${requestToolName}\` to fetch spreadsheet metadata:
    - \`method\`: \`"GET"\`
    - \`path\`: \`"/{spreadsheetId}?fields=spreadsheetId,properties.title,sheets.properties.title"\`
-5. If an error is returned, ask the user to check the spreadsheet sharing settings
-6. Call \`updateConnectionContext\`:
+4. If an error is returned, ask the user to check the spreadsheet sharing settings
+5. Call \`updateConnectionContext\`:
    - \`spreadsheet\`: The spreadsheet title
    - \`sheets\`: Sheet names (comma-separated)
    - \`note\`: Brief description of the setup
@@ -518,10 +559,12 @@ batch.valueRanges.forEach(vr => console.log(vr.range, vr.values));
   tools,
   async checkConnection(params, config) {
     const { proxyFetch } = config;
-    const spreadsheetId = params[parameters.spreadsheetId.slug];
-    if (!spreadsheetId) {
+    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" });

package/dist/connectors/google-sheets.js

@@ -1,3 +1,25 @@
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+
+// ../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/parameter-definition.ts
 var ParameterDefinition = class {
   slug;
@@ -56,11 +78,11 @@ var parameters = {
     secret: true,
     required: true
   }),
-  spreadsheetId: new ParameterDefinition({
-    slug: "spreadsheet-id",
-    name: "Default Spreadsheet ID",
-    description: "The ID of the default Google Spreadsheet. Can be found in the spreadsheet URL: https://docs.google.com/spreadsheets/d/{spreadsheetId}/edit",
-    envVarBaseKey: "GOOGLE_SHEETS_SPREADSHEET_ID",
+  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_SPREADSHEET_URL",
     type: "text",
     secret: false,
     required: false
@@ -68,6 +90,7 @@ var parameters = {
 };
 
 // ../connectors/src/connectors/google-sheets/sdk/index.ts
+init_utils();
 var TOKEN_URL = "https://oauth2.googleapis.com/token";
 var BASE_URL = "https://sheets.googleapis.com/v4/spreadsheets";
 var SCOPE = "https://www.googleapis.com/auth/spreadsheets.readonly";
@@ -95,7 +118,8 @@ function buildJwt(clientEmail, privateKey, nowSec) {
 }
 function createClient(params) {
   const serviceAccountKeyJsonBase64 = params[parameters.serviceAccountKeyJsonBase64.slug];
-  const defaultSpreadsheetId = params[parameters.spreadsheetId.slug];
+  const spreadsheetUrl = params[parameters.spreadsheetUrl.slug];
+  const defaultSpreadsheetId = spreadsheetUrl ? extractSpreadsheetId(spreadsheetUrl) : void 0;
   if (!serviceAccountKeyJsonBase64) {
     throw new Error(
       `google-sheets: missing required parameter: ${parameters.serviceAccountKeyJsonBase64.slug}`
@@ -335,6 +359,7 @@ var googleSheetsOnboarding = new ConnectorOnboarding({
 
 // ../connectors/src/connectors/google-sheets/tools/request.ts
 import { z } from "zod";
+init_utils();
 var BASE_URL2 = "https://sheets.googleapis.com/v4/spreadsheets";
 var REQUEST_TIMEOUT_MS = 6e4;
 var inputSchema = z.object({
@@ -380,7 +405,8 @@ Authentication is handled automatically using a service account.
     try {
       const { GoogleAuth } = await import("google-auth-library");
       const keyJsonBase64 = parameters.serviceAccountKeyJsonBase64.getValue(connection2);
-      const spreadsheetId = parameters.spreadsheetId.tryGetValue(connection2);
+      const spreadsheetUrl = parameters.spreadsheetUrl.tryGetValue(connection2);
+      const spreadsheetId = spreadsheetUrl ? extractSpreadsheetId(spreadsheetUrl) : void 0;
       const credentials = JSON.parse(
         Buffer.from(keyJsonBase64, "base64").toString("utf-8")
       );

package/dist/connectors/grafana.d.ts

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