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

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

@@ -60,7 +60,7 @@ var parameters = {
     envVarBaseKey: "GOOGLE_ADS_DEVELOPER_TOKEN",
     type: "text",
     secret: true,
-    required: false
+    required: true
   })
 };
 

package/dist/connectors/google-analytics.js

@@ -59,11 +59,11 @@ var parameters = {
   propertyId: new ParameterDefinition({
     slug: "property-id",
     name: "Google Analytics Property ID",
-    description: "The Google Analytics 4 property ID (e.g., 123456789).",
+    description: "The Google Analytics 4 property ID (e.g., 123456789). Set during connection setup.",
     envVarBaseKey: "GA_PROPERTY_ID",
     type: "text",
     secret: false,
-    required: true
+    required: false
   })
 };
 
@@ -125,7 +125,7 @@ function createClient(params) {
   }
   let cachedToken = null;
   let tokenExpiresAt = 0;
-  async function getAccessToken() {
+  async function getAccessToken2() {
     const nowSec = Math.floor(Date.now() / 1e3);
     if (cachedToken && nowSec < tokenExpiresAt - 60) {
       return cachedToken;
@@ -156,7 +156,7 @@ function createClient(params) {
   }
   return {
     async request(path2, init) {
-      const accessToken = await getAccessToken();
+      const accessToken = await getAccessToken2();
       const resolvedPath = path2.replace(/\{propertyId\}/g, propertyId);
       const url = `${BASE_URL.replace(/\/+$/, "")}/${resolvedPath.replace(/^\/+/, "")}`;
       const headers = new Headers(init?.headers);
@@ -331,8 +331,230 @@ var AUTH_TYPES = {
   USER_PASSWORD: "user-password"
 };
 
+// ../connectors/src/connectors/google-analytics/tools/list-accounts.ts
+import { z } from "zod";
+
+// ../connectors/src/connectors/google-analytics/tools/auth.ts
+var SCOPES = [
+  "https://www.googleapis.com/auth/analytics.readonly"
+];
+async function getAccessToken(connection2) {
+  const { GoogleAuth } = await import("google-auth-library");
+  const keyJsonBase64 = parameters.serviceAccountKeyJsonBase64.getValue(connection2);
+  const credentials = JSON.parse(
+    Buffer.from(keyJsonBase64, "base64").toString("utf-8")
+  );
+  const auth = new GoogleAuth({
+    credentials,
+    scopes: SCOPES
+  });
+  const token = await auth.getAccessToken();
+  if (!token) {
+    throw new Error("Failed to obtain access token");
+  }
+  return token;
+}
+
+// ../connectors/src/connectors/google-analytics/tools/list-accounts.ts
+var ADMIN_BASE_URL = "https://analyticsadmin.googleapis.com/v1beta/";
+var REQUEST_TIMEOUT_MS = 6e4;
+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 Analytics connection to use")
+});
+var outputSchema = z.discriminatedUnion("success", [
+  z.object({
+    success: z.literal(true),
+    accounts: z.array(
+      z.object({
+        name: z.string(),
+        displayName: z.string()
+      })
+    )
+  }),
+  z.object({
+    success: z.literal(false),
+    error: z.string()
+  })
+]);
+var listAccountsTool = new ConnectorTool({
+  name: "listAccounts",
+  description: "List Google Analytics accounts accessible with the service account credentials. Returns account names and display names.",
+  inputSchema,
+  outputSchema,
+  async execute({ connectionId }, connections) {
+    const connection2 = connections.find((c) => c.id === connectionId);
+    if (!connection2) {
+      return {
+        success: false,
+        error: `Connection ${connectionId} not found`
+      };
+    }
+    console.log(
+      `[connector-request] google-analytics/${connection2.name}: listAccounts`
+    );
+    try {
+      const token = await getAccessToken(connection2);
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+      try {
+        const response = await fetch(`${ADMIN_BASE_URL}accounts`, {
+          method: "GET",
+          headers: {
+            Authorization: `Bearer ${token}`
+          },
+          signal: controller.signal
+        });
+        const data = await response.json();
+        if (!response.ok) {
+          const errorMessage = data?.error?.message ?? `HTTP ${response.status} ${response.statusText}`;
+          return { success: false, error: errorMessage };
+        }
+        const accounts = (data.accounts ?? []).map((a) => ({
+          name: a.name ?? "",
+          displayName: a.displayName ?? ""
+        }));
+        return { success: true, accounts };
+      } finally {
+        clearTimeout(timeout);
+      }
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return { success: false, error: msg };
+    }
+  }
+});
+
+// ../connectors/src/connectors/google-analytics/tools/list-properties.ts
+import { z as z2 } from "zod";
+var ADMIN_BASE_URL2 = "https://analyticsadmin.googleapis.com/v1beta/";
+var REQUEST_TIMEOUT_MS2 = 6e4;
+var inputSchema2 = z2.object({
+  toolUseIntent: z2.string().optional().describe(
+    "Brief description of what you intend to accomplish with this tool call"
+  ),
+  connectionId: z2.string().describe("ID of the Google Analytics connection to use"),
+  accountName: z2.string().describe(
+    "The account resource name (e.g., 'accounts/123456'). Obtained from the listAccounts tool."
+  )
+});
+var outputSchema2 = z2.discriminatedUnion("success", [
+  z2.object({
+    success: z2.literal(true),
+    properties: z2.array(
+      z2.object({
+        name: z2.string(),
+        displayName: z2.string(),
+        propertyId: z2.string()
+      })
+    )
+  }),
+  z2.object({
+    success: z2.literal(false),
+    error: z2.string()
+  })
+]);
+var listPropertiesTool = new ConnectorTool({
+  name: "listProperties",
+  description: "List GA4 properties for a given Google Analytics account. Returns property names, display names, and property IDs.",
+  inputSchema: inputSchema2,
+  outputSchema: outputSchema2,
+  async execute({ connectionId, accountName }, connections) {
+    const connection2 = connections.find((c) => c.id === connectionId);
+    if (!connection2) {
+      return {
+        success: false,
+        error: `Connection ${connectionId} not found`
+      };
+    }
+    console.log(
+      `[connector-request] google-analytics/${connection2.name}: listProperties for ${accountName}`
+    );
+    try {
+      const token = await getAccessToken(connection2);
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS2);
+      try {
+        const filter = encodeURIComponent(`parent:${accountName}`);
+        const response = await fetch(
+          `${ADMIN_BASE_URL2}properties?filter=${filter}`,
+          {
+            method: "GET",
+            headers: {
+              Authorization: `Bearer ${token}`
+            },
+            signal: controller.signal
+          }
+        );
+        const data = await response.json();
+        if (!response.ok) {
+          const errorMessage = data?.error?.message ?? `HTTP ${response.status} ${response.statusText}`;
+          return { success: false, error: errorMessage };
+        }
+        const properties = (data.properties ?? []).map((p) => {
+          const name = p.name ?? "";
+          const propertyId = name.replace(/^properties\//, "");
+          return {
+            name,
+            displayName: p.displayName ?? "",
+            propertyId
+          };
+        });
+        return { success: true, properties };
+      } finally {
+        clearTimeout(timeout);
+      }
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return { success: false, error: msg };
+    }
+  }
+});
+
 // ../connectors/src/connectors/google-analytics/setup.ts
+var listAccountsToolName = `google-analytics_${listAccountsTool.name}`;
+var listPropertiesToolName = `google-analytics_${listPropertiesTool.name}`;
 var googleAnalyticsOnboarding = new ConnectorOnboarding({
+  connectionSetupInstructions: {
+    ja: `\u4EE5\u4E0B\u306E\u624B\u9806\u3067Google Analytics (Service Account) \u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306E\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3092\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002
+
+1. \`${listAccountsToolName}\` \u3092\u547C\u3073\u51FA\u3057\u3066\u3001Service Account\u3067\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306AGoogle Analytics\u30A2\u30AB\u30A6\u30F3\u30C8\u4E00\u89A7\u3092\u53D6\u5F97\u3059\u308B
+2. \u300C\u4F7F\u7528\u3059\u308B\u30A2\u30AB\u30A6\u30F3\u30C8\u3092\u9078\u629E\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u300D\u3068\u30E6\u30FC\u30B6\u30FC\u306B\u4F1D\u3048\u305F\u4E0A\u3067\u3001\`askUserQuestion\` \u3092\u547C\u3073\u51FA\u3059:
+   - \`options\`: \u30A2\u30AB\u30A6\u30F3\u30C8\u4E00\u89A7\u3002\u5404 option \u306E \`label\` \u306F \`\u8868\u793A\u540D (name)\` \u306E\u5F62\u5F0F
+3. \`${listPropertiesToolName}\` \u3092\u547C\u3073\u51FA\u3057\u3066\u3001\u9078\u629E\u3055\u308C\u305F\u30A2\u30AB\u30A6\u30F3\u30C8\u306E\u30D7\u30ED\u30D1\u30C6\u30A3\u4E00\u89A7\u3092\u53D6\u5F97\u3059\u308B
+4. \`updateConnectionParameters\` \u3092\u547C\u3073\u51FA\u3059:
+   - \`parameterSlug\`: \`"property-id"\`
+   - \`options\`: \u30D7\u30ED\u30D1\u30C6\u30A3\u4E00\u89A7\u3002\u5404 option \u306E \`label\` \u306F \`\u8868\u793A\u540D (id: \u30D7\u30ED\u30D1\u30C6\u30A3ID)\` \u306E\u5F62\u5F0F\u3001\`value\` \u306F\u30D7\u30ED\u30D1\u30C6\u30A3ID
+5. \u30E6\u30FC\u30B6\u30FC\u304C\u9078\u629E\u3057\u305F\u30D7\u30ED\u30D1\u30C6\u30A3\u306E \`label\` \u304C\u30E1\u30C3\u30BB\u30FC\u30B8\u3068\u3057\u3066\u5C4A\u304F\u306E\u3067\u3001\u6B21\u306E\u30B9\u30C6\u30C3\u30D7\u306B\u9032\u3080
+6. \`updateConnectionContext\` \u3092\u547C\u3073\u51FA\u3059:
+   - \`property\`: \u9078\u629E\u3055\u308C\u305F\u30D7\u30ED\u30D1\u30C6\u30A3\u306E\u8868\u793A\u540D
+   - \`propertyId\`: \u9078\u629E\u3055\u308C\u305F\u30D7\u30ED\u30D1\u30C6\u30A3ID
+   - \`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\u30EC\u30DD\u30FC\u30C8\u30C7\u30FC\u30BF\u3092\u53D6\u5F97\u3057\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\u306E\u307F
+- \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 Analytics (Service Account) connection.
+
+1. Call \`${listAccountsToolName}\` to get the list of Google Analytics accounts accessible with the service account credentials
+2. Tell the user "Please select an account.", then call \`askUserQuestion\`:
+   - \`options\`: The account list. Each option's \`label\` should be \`Display Name (name)\`
+3. Call \`${listPropertiesToolName}\` to get the list of properties for the selected account
+4. Call \`updateConnectionParameters\`:
+   - \`parameterSlug\`: \`"property-id"\`
+   - \`options\`: The property list. Each option's \`label\` should be \`Display Name (id: propertyId)\`, \`value\` should be the property ID
+5. The \`label\` of the user's selected property will arrive as a message. Proceed to the next step
+6. Call \`updateConnectionContext\`:
+   - \`property\`: The selected property's display name
+   - \`propertyId\`: The selected property ID
+   - \`note\`: Brief description of the setup
+
+#### Constraints
+- **Do NOT fetch report data during setup**. Only the metadata requests specified in the steps above are allowed
+- Write only 1 sentence between tool calls, then immediately call the next tool. Skip unnecessary explanations and proceed efficiently`
+  },
   dataOverviewInstructions: {
     en: `1. Call google-analytics_request with GET properties/{propertyId}/metadata to list available dimensions and metrics
 2. Call google-analytics_request with POST properties/{propertyId}:runReport using a small date range and basic metrics to verify data availability`,
@@ -342,25 +564,25 @@ var googleAnalyticsOnboarding = new ConnectorOnboarding({
 });
 
 // ../connectors/src/connectors/google-analytics/tools/request.ts
-import { z } from "zod";
+import { z as z3 } from "zod";
 var BASE_URL2 = "https://analyticsdata.googleapis.com/v1beta/";
-var REQUEST_TIMEOUT_MS = 6e4;
-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 Analytics connection to use"),
-  method: z.enum(["GET", "POST"]).describe("HTTP method"),
-  path: z.string().describe("API path (e.g., 'properties/{propertyId}:runReport'). {propertyId} is automatically replaced."),
-  body: z.record(z.string(), z.unknown()).optional().describe("POST request body (JSON)")
+var REQUEST_TIMEOUT_MS3 = 6e4;
+var inputSchema3 = z3.object({
+  toolUseIntent: z3.string().optional().describe("Brief description of what you intend to accomplish with this tool call"),
+  connectionId: z3.string().describe("ID of the Google Analytics connection to use"),
+  method: z3.enum(["GET", "POST"]).describe("HTTP method"),
+  path: z3.string().describe("API path (e.g., 'properties/{propertyId}:runReport'). {propertyId} is automatically replaced."),
+  body: z3.record(z3.string(), z3.unknown()).optional().describe("POST request body (JSON)")
 });
-var outputSchema = z.discriminatedUnion("success", [
-  z.object({
-    success: z.literal(true),
-    status: z.number(),
-    data: z.record(z.string(), z.unknown())
+var outputSchema3 = z3.discriminatedUnion("success", [
+  z3.object({
+    success: z3.literal(true),
+    status: z3.number(),
+    data: z3.record(z3.string(), z3.unknown())
   }),
-  z.object({
-    success: z.literal(false),
-    error: z.string()
+  z3.object({
+    success: z3.literal(false),
+    error: z3.string()
   })
 ]);
 var requestTool = new ConnectorTool({
@@ -368,8 +590,8 @@ var requestTool = new ConnectorTool({
   description: `Send authenticated requests to the Google Analytics Data API.
 Authentication is handled automatically using a service account.
 {propertyId} in the path is automatically replaced with the connection's property-id.`,
-  inputSchema,
-  outputSchema,
+  inputSchema: inputSchema3,
+  outputSchema: outputSchema3,
   async execute({ connectionId, method, path: path2, body }, connections) {
     const connection2 = connections.find((c) => c.id === connectionId);
     if (!connection2) {
@@ -379,7 +601,7 @@ Authentication is handled automatically using a service account.
     try {
       const { GoogleAuth } = await import("google-auth-library");
       const keyJsonBase64 = parameters.serviceAccountKeyJsonBase64.getValue(connection2);
-      const propertyId = parameters.propertyId.getValue(connection2);
+      const propertyId = parameters.propertyId.tryGetValue(connection2);
       const credentials = JSON.parse(
         Buffer.from(keyJsonBase64, "base64").toString("utf-8")
       );
@@ -391,10 +613,10 @@ Authentication is handled automatically using a service account.
       if (!token) {
         return { success: false, error: "Failed to obtain access token" };
       }
-      const resolvedPath = path2.replace(/\{propertyId\}/g, propertyId);
+      const resolvedPath = propertyId ? path2.replace(/\{propertyId\}/g, propertyId) : path2;
       const url = `${BASE_URL2}${resolvedPath}`;
       const controller = new AbortController();
-      const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+      const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS3);
       try {
         const response = await fetch(url, {
           method,
@@ -425,7 +647,11 @@ Authentication is handled automatically using a service account.
 });
 
 // ../connectors/src/connectors/google-analytics/index.ts
-var tools = { request: requestTool };
+var tools = {
+  request: requestTool,
+  listAccounts: listAccountsTool,
+  listProperties: listPropertiesTool
+};
 var googleAnalyticsConnector = new ConnectorPlugin({
   slug: "google-analytics",
   authType: AUTH_TYPES.SERVICE_ACCOUNT,
@@ -439,6 +665,8 @@ var googleAnalyticsConnector = new ConnectorPlugin({
     en: `### Tools
 
 - \`google-analytics_request\`: The only way to call the GA4 Data API. Use it to fetch metadata, run reports, or run realtime reports. See the GA4 Data API Reference below for available endpoints and request bodies.
+- \`google-analytics_listAccounts\`: List accessible Google Analytics accounts. Use during setup to discover available accounts.
+- \`google-analytics_listProperties\`: List GA4 properties for a given account. Use during setup to select the target property.
 
 ### Business Logic
 
@@ -507,6 +735,8 @@ activeUsers, sessions, screenPageViews, bounceRate, averageSessionDuration, conv
     ja: `### \u30C4\u30FC\u30EB
 
 - \`google-analytics_request\`: GA4 Data API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30E1\u30BF\u30C7\u30FC\u30BF\u306E\u53D6\u5F97\u3001\u30EC\u30DD\u30FC\u30C8\u306E\u5B9F\u884C\u3001\u30EA\u30A2\u30EB\u30BF\u30A4\u30E0\u30EC\u30DD\u30FC\u30C8\u306E\u5B9F\u884C\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u5229\u7528\u53EF\u80FD\u306A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u3068\u30EA\u30AF\u30A8\u30B9\u30C8\u30DC\u30C7\u30A3\u306F\u4E0B\u90E8\u306E\u300CGA4 Data API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9\u300D\u3092\u53C2\u7167\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+- \`google-analytics_listAccounts\`: \u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306AGoogle Analytics\u30A2\u30AB\u30A6\u30F3\u30C8\u306E\u4E00\u89A7\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306B\u5229\u7528\u53EF\u80FD\u306A\u30A2\u30AB\u30A6\u30F3\u30C8\u3092\u78BA\u8A8D\u3059\u308B\u305F\u3081\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002
+- \`google-analytics_listProperties\`: \u6307\u5B9A\u30A2\u30AB\u30A6\u30F3\u30C8\u306EGA4\u30D7\u30ED\u30D1\u30C6\u30A3\u4E00\u89A7\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306B\u30BF\u30FC\u30B2\u30C3\u30C8\u30D7\u30ED\u30D1\u30C6\u30A3\u3092\u9078\u629E\u3059\u308B\u305F\u3081\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002
 
 ### Business Logic
 

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

@@ -1,5 +1,12 @@
 import * as _squadbase_connectors_sdk from '@squadbase/connectors/sdk';
+import { GoogleCalendarClientOptions } from '@squadbase/connectors/sdk';
 
-declare const connection: (connectionId: string) => _squadbase_connectors_sdk.GoogleCalendarConnectorSdk;
+/**
+ * Create a Google Calendar SDK client for the given connection.
+ *
+ * @param connectionId - The connection ID from .squadbase/connections.json
+ * @param options - Optional configuration (e.g., subject for Domain-wide Delegation)
+ */
+declare const connection: (connectionId: string, options?: GoogleCalendarClientOptions) => _squadbase_connectors_sdk.GoogleCalendarConnectorSdk;
 
 export { connection };

package/dist/connectors/google-calendar.js

@@ -75,17 +75,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,7 +95,7 @@ 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 defaultCalendarId = params[parameters.calendarId.slug] ?? "primary";
   if (!serviceAccountKeyJsonBase64) {
@@ -118,6 +120,7 @@ function createClient(params) {
       "google-calendar: service account key JSON must contain client_email and private_key"
     );
   }
+  const subject = options?.subject;
   let cachedToken = null;
   let tokenExpiresAt = 0;
   async function getAccessToken() {
@@ -128,7 +131,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 +181,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" });
@@ -351,7 +355,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(
+    "Email address of the user to impersonate via Domain-wide Delegation. When set, the service account acts on behalf of this user."
+  )
 });
 var outputSchema = z.discriminatedUnion("success", [
   z.object({
@@ -371,7 +378,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 {
@@ -394,7 +401,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"
-        ]
+        ],
+        ...subject ? { clientOptions: { subject } } : {}
       });
       const token = await auth.getAccessToken();
       if (!token) {
@@ -461,18 +469,26 @@ var googleCalendarConnector = new ConnectorPlugin({
   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. The {calendarId} placeholder in paths is automatically replaced with the configured default calendar ID. Supports Domain-wide Delegation via the optional \`subject\` parameter to impersonate a user.
 
 ### 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)\` or \`connection(connectionId, { subject })\`):
 - \`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
+
+To access a user's calendar via Domain-wide Delegation, pass \`subject\` (the user's email) as the second argument to \`connection()\`:
+
+\`\`\`ts
+const calendar = connection("<connectionId>", { subject: "user@example.com" });
+\`\`\`
+
 \`\`\`ts
 import type { Context } from "hono";
 import { connection } from "@squadbase/vite-server/connectors/google-calendar";
@@ -524,18 +540,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\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\u3002Domain-wide Delegation\u3092\u4F7F\u7528\u3059\u308B\u5834\u5408\u3001\u30AA\u30D7\u30B7\u30E7\u30F3\u306E\`subject\`\u30D1\u30E9\u30E1\u30FC\u30BF\u3067\u30E6\u30FC\u30B6\u30FC\u3092\u507D\u88C5\u3067\u304D\u307E\u3059\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)\` \u307E\u305F\u306F \`connection(connectionId, { subject })\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8):
 - \`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
+
+Domain-wide Delegation\u3067\u30E6\u30FC\u30B6\u30FC\u306E\u30AB\u30EC\u30F3\u30C0\u30FC\u306B\u30A2\u30AF\u30BB\u30B9\u3059\u308B\u306B\u306F\u3001\`connection()\`\u306E\u7B2C2\u5F15\u6570\u306B\`subject\`\uFF08\u30E6\u30FC\u30B6\u30FC\u306E\u30E1\u30FC\u30EB\u30A2\u30C9\u30EC\u30B9\uFF09\u3092\u6E21\u3057\u307E\u3059\uFF1A
+
+\`\`\`ts
+const calendar = connection("<connectionId>", { subject: "user@example.com" });
+\`\`\`
+
 \`\`\`ts
 import type { Context } from "hono";
 import { connection } from "@squadbase/vite-server/connectors/google-calendar";
@@ -649,7 +673,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
 };