@squadbase/vite-server 0.1.2 → 0.1.3-dev.0

package/dist/connectors/airtable-oauth.js

@@ -365,9 +365,13 @@ var airtableOauthConnector = new ConnectorPlugin({
     ]
   },
   systemPrompt: {
-    en: `### Airtable API (OAuth)
+    en: `### Tools
 
-### Available Endpoints
+- \`airtable-oauth_request\`: The only way to call the Airtable REST API. Use it to list tables, query/create/update/delete records. Authentication is configured automatically via OAuth. The {baseId} placeholder in paths is automatically replaced with the configured default base ID.
+
+### Airtable API Reference
+
+#### Available Endpoints
 - GET \`/meta/bases/{baseId}/tables\` \u2014 List tables in a base
 - GET \`/{baseId}/{tableIdOrName}\` \u2014 List records in a table
 - GET \`/{baseId}/{tableIdOrName}/{recordId}\` \u2014 Get a single record
@@ -409,9 +413,13 @@ const data = await res.json();
 const records = await airtable.request("/{baseId}/Tasks?maxRecords=100");
 const recordsData = await records.json();
 \`\`\``,
-    ja: `### Airtable API (OAuth)
+    ja: `### \u30C4\u30FC\u30EB
+
+- \`airtable-oauth_request\`: Airtable REST API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30C6\u30FC\u30D6\u30EB\u4E00\u89A7\u306E\u53D6\u5F97\u3001\u30EC\u30B3\u30FC\u30C9\u306E\u691C\u7D22\u30FB\u4F5C\u6210\u30FB\u66F4\u65B0\u30FB\u524A\u9664\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{baseId}\u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u306F\u8A2D\u5B9A\u6E08\u307F\u306E\u30C7\u30D5\u30A9\u30EB\u30C8\u30D9\u30FC\u30B9ID\u3067\u81EA\u52D5\u7684\u306B\u7F6E\u63DB\u3055\u308C\u307E\u3059\u3002
+
+### Airtable API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
 
-### \u5229\u7528\u53EF\u80FD\u306A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
+#### \u5229\u7528\u53EF\u80FD\u306A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
 - GET \`/meta/bases/{baseId}/tables\` \u2014 \u30D9\u30FC\u30B9\u5185\u306E\u30C6\u30FC\u30D6\u30EB\u4E00\u89A7\u3092\u53D6\u5F97
 - GET \`/{baseId}/{tableIdOrName}\` \u2014 \u30C6\u30FC\u30D6\u30EB\u5185\u306E\u30EC\u30B3\u30FC\u30C9\u4E00\u89A7\u3092\u53D6\u5F97
 - GET \`/{baseId}/{tableIdOrName}/{recordId}\` \u2014 \u5358\u4E00\u30EC\u30B3\u30FC\u30C9\u3092\u53D6\u5F97

package/dist/connectors/amplitude.js

@@ -61,6 +61,15 @@ var parameters = {
     type: "text",
     secret: true,
     required: true
+  }),
+  region: new ParameterDefinition({
+    slug: "region",
+    name: "Region",
+    description: 'Amplitude data region. Set to "eu" if your Amplitude project is hosted in the EU. Leave empty for US (default).',
+    envVarBaseKey: "AMPLITUDE_REGION",
+    type: "text",
+    secret: false,
+    required: false
   })
 };
 
@@ -68,6 +77,7 @@ var parameters = {
 function createClient(params) {
   const apiKey = params[parameters.apiKey.slug];
   const secretKey = params[parameters.secretKey.slug];
+  const region = params[parameters.region.slug] ?? "us";
   if (!apiKey) {
     throw new Error(
       `amplitude: missing required parameter: ${parameters.apiKey.slug}`
@@ -78,9 +88,117 @@ function createClient(params) {
       `amplitude: missing required parameter: ${parameters.secretKey.slug}`
     );
   }
-  return { apiKey, secretKey };
+  const baseUrl = region === "eu" ? "https://analytics.eu.amplitude.com" : "https://amplitude.com";
+  const authToken = btoa(`${apiKey}:${secretKey}`);
+  function authHeaders(extra) {
+    const headers = new Headers(extra);
+    headers.set("Authorization", `Basic ${authToken}`);
+    return headers;
+  }
+  async function assertOk(res, label) {
+    if (!res.ok) {
+      const body = await res.text().catch(() => "(unreadable body)");
+      throw new Error(
+        `amplitude ${label}: ${res.status} ${res.statusText} \u2014 ${body}`
+      );
+    }
+  }
+  return {
+    request(url, init) {
+      const headers = new Headers(init?.headers);
+      headers.set("Authorization", `Basic ${authToken}`);
+      return fetch(url, { ...init, headers });
+    },
+    async listEventTypes() {
+      const res = await fetch(
+        `${baseUrl}/api/2/events/list`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "listEventTypes");
+      return await res.json();
+    },
+    async eventSegmentation(options) {
+      const params2 = new URLSearchParams();
+      params2.set("e", JSON.stringify(options.e));
+      params2.set("start", options.start);
+      params2.set("end", options.end);
+      if (options.m) params2.set("m", options.m);
+      if (options.i !== void 0) params2.set("i", String(options.i));
+      if (options.g) params2.set("g", options.g);
+      const res = await fetch(
+        `${baseUrl}/api/2/events/segmentation?${params2.toString()}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "eventSegmentation");
+      return await res.json();
+    },
+    async userSearch(query) {
+      const params2 = new URLSearchParams({ user: query });
+      const res = await fetch(
+        `${baseUrl}/api/2/usersearch?${params2.toString()}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "userSearch");
+      return await res.json();
+    },
+    async userActivity(amplitudeId, options) {
+      const params2 = new URLSearchParams({ user: amplitudeId });
+      if (options?.offset !== void 0)
+        params2.set("offset", String(options.offset));
+      if (options?.limit !== void 0)
+        params2.set("limit", String(options.limit));
+      const res = await fetch(
+        `${baseUrl}/api/2/useractivity?${params2.toString()}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "userActivity");
+      return await res.json();
+    }
+  };
 }
 
+// ../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;
@@ -139,8 +257,110 @@ var ConnectorPlugin = class _ConnectorPlugin {
   }
 };
 
+// ../connectors/src/connectors/amplitude/setup.ts
+var amplitudeOnboarding = new ConnectorOnboarding({
+  dataOverviewInstructions: {
+    en: `1. Check the connection's region parameter: use https://analytics.eu.amplitude.com for EU, https://amplitude.com for US (default)
+2. Call amplitude_request with GET {baseUrl}/api/2/events/list to list available event types
+3. Call amplitude_request with GET {baseUrl}/api/2/export?start=YYYYMMDDTHH&end=YYYYMMDDTHH to export raw event data for a time range
+4. Use GET {baseUrl}/api/2/usersearch?user=QUERY and GET {baseUrl}/api/2/useractivity?user=AMPLITUDE_ID to explore user-level data
+NOTE: The Dashboard REST API endpoints (events/segmentation, funnels, retention, etc.) require a paid Growth or Enterprise plan. If you get a 403 Forbidden error, fall back to the Export API (/api/2/export) to retrieve raw events and perform aggregation in code instead.`,
+    ja: `1. \u63A5\u7D9A\u306Eregion\u30D1\u30E9\u30E1\u30FC\u30BF\u3092\u78BA\u8A8D\uFF1AEU\u306E\u5834\u5408\u306F https://analytics.eu.amplitude.com\u3001US\uFF08\u30C7\u30D5\u30A9\u30EB\u30C8\uFF09\u306E\u5834\u5408\u306F https://amplitude.com \u3092\u4F7F\u7528
+2. amplitude_request \u3067 GET {baseUrl}/api/2/events/list \u3092\u547C\u3073\u51FA\u3057\u3001\u5229\u7528\u53EF\u80FD\u306A\u30A4\u30D9\u30F3\u30C8\u30BF\u30A4\u30D7\u4E00\u89A7\u3092\u53D6\u5F97
+3. amplitude_request \u3067 GET {baseUrl}/api/2/export?start=YYYYMMDDTHH&end=YYYYMMDDTHH \u3092\u547C\u3073\u51FA\u3057\u3001\u6307\u5B9A\u671F\u9593\u306E\u751F\u30A4\u30D9\u30F3\u30C8\u30C7\u30FC\u30BF\u3092\u30A8\u30AF\u30B9\u30DD\u30FC\u30C8
+4. GET {baseUrl}/api/2/usersearch?user=QUERY \u3084 GET {baseUrl}/api/2/useractivity?user=AMPLITUDE_ID \u3067\u30E6\u30FC\u30B6\u30FC\u30EC\u30D9\u30EB\u306E\u30C7\u30FC\u30BF\u3092\u63A2\u7D22
+\u6CE8\u610F: Dashboard REST API\uFF08events/segmentation\u3001funnels\u3001retention\u7B49\uFF09\u306F\u6709\u6599\u306EGrowth\u307E\u305F\u306FEnterprise\u30D7\u30E9\u30F3\u304C\u5FC5\u8981\u3067\u3059\u3002403 Forbidden\u30A8\u30E9\u30FC\u304C\u8FD4\u3055\u308C\u305F\u5834\u5408\u306F\u3001Export API\uFF08/api/2/export\uFF09\u3067\u751F\u30A4\u30D9\u30F3\u30C8\u3092\u53D6\u5F97\u3057\u3001\u30B3\u30FC\u30C9\u4E0A\u3067\u96C6\u8A08\u3092\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002`
+  }
+});
+
+// ../connectors/src/connectors/amplitude/tools/request.ts
+import { z } from "zod";
+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 Amplitude connection to use"),
+  method: z.enum(["GET", "POST"]).describe(
+    "HTTP method. GET for most read endpoints (events/list, export, usersearch, useractivity). POST is rarely needed."
+  ),
+  url: z.string().describe(
+    "Full URL including query parameters (e.g., 'https://amplitude.com/api/2/events/list', 'https://amplitude.com/api/2/export?start=20240101T00&end=20240102T00')"
+  ),
+  body: z.record(z.string(), z.unknown()).optional().describe("Request body (JSON) for POST requests")
+});
+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 Amplitude REST API.
+Authentication is handled automatically using Basic auth (API Key + Secret Key).
+Provide the full URL including any query parameters.
+Base URL by region: US \u2192 https://amplitude.com, EU \u2192 https://analytics.eu.amplitude.com. Check the connection's region parameter to determine which base URL to use.
+
+Recommended endpoints (available on all plans):
+- GET {baseUrl}/api/2/events/list \u2014 list event types
+- GET {baseUrl}/api/2/export?start=YYYYMMDDTHH&end=YYYYMMDDTHH \u2014 export raw events
+- GET {baseUrl}/api/2/usersearch?user=QUERY \u2014 search users
+- GET {baseUrl}/api/2/useractivity?user=AMPLITUDE_ID \u2014 user activity
+
+IMPORTANT: Dashboard REST API endpoints (events/segmentation, funnels, retention, revenue, etc.) require a paid Growth or Enterprise plan and will return 403 Forbidden on free plans. Always try the Export API first and aggregate data in code.`,
+  inputSchema,
+  outputSchema,
+  async execute({ connectionId, method, url, body }, connections) {
+    const connection2 = connections.find((c) => c.id === connectionId);
+    if (!connection2) {
+      return {
+        success: false,
+        error: `Connection ${connectionId} not found`
+      };
+    }
+    console.log(
+      `[connector-request] amplitude/${connection2.name}: ${method} ${url}`
+    );
+    try {
+      const apiKey = parameters.apiKey.getValue(connection2);
+      const secretKey = parameters.secretKey.getValue(connection2);
+      const authToken = btoa(`${apiKey}:${secretKey}`);
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+      try {
+        const response = await fetch(url, {
+          method,
+          headers: {
+            Authorization: `Basic ${authToken}`,
+            "Content-Type": "application/json"
+          },
+          body: body ? JSON.stringify(body) : void 0,
+          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/amplitude/index.ts
-var tools = {};
+var tools = { request: requestTool };
 var amplitudeConnector = new ConnectorPlugin({
   slug: "amplitude",
   authType: null,
@@ -149,53 +369,136 @@ var amplitudeConnector = new ConnectorPlugin({
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/2UBJSdRlFJaLq52WUCTBEB/308b59b374cf6c662ac70989860bffd7/amplitude-icon.svg",
   parameters,
   releaseFlag: { dev1: true, dev2: false, prod: false },
+  onboarding: amplitudeOnboarding,
   systemPrompt: {
-    en: `### Amplitude SDK (TypeScript handler)
-Use the Amplitude connector via the SDK in TypeScript handlers:
+    en: `### Tools
+
+- \`amplitude_request\`: The only way to call the Amplitude REST API. Use it for event segmentation, listing event types, user search, user activity, and data export. Authentication (Basic auth with API Key + Secret Key) is configured automatically. Provide the full URL including query parameters \u2014 the base URL varies by endpoint.
+
+### 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)\`):
+- \`client.request(url, init?)\` \u2014 low-level authenticated fetch (provide full URL)
+- \`client.listEventTypes()\` \u2014 list all event types
+- \`client.eventSegmentation(options)\` \u2014 run event segmentation query (e, start, end, m?, i?, g?)
+- \`client.userSearch(query)\` \u2014 search users by user or amplitude ID
+- \`client.userActivity(amplitudeId, options?)\` \u2014 get user activity by amplitude ID
 
 \`\`\`ts
+import type { Context } from "hono";
 import { connection } from "@squadbase/vite-server/connectors/amplitude";
 
-const { apiKey, secretKey } = connection("<connectionId>");
+const amp = connection("<connectionId>");
 
-// Use the Amplitude REST API with Basic auth (apiKey:secretKey)
-const res = await fetch("https://amplitude.com/api/2/events/segmentation", {
-  headers: {
-    Authorization: "Basic " + btoa(apiKey + ":" + secretKey),
-  },
-});
-const data = await res.json();
+export default async function handler(c: Context) {
+  const { eventType, start, end } = await c.req.json<{
+    eventType: string;
+    start: string;
+    end: string;
+  }>();
+
+  const result = await amp.eventSegmentation({
+    e: { event_type: eventType },
+    start,
+    end,
+  });
+
+  return c.json(result);
+}
 \`\`\`
 
-### Common Endpoints
-- GET \`https://amplitude.com/api/2/events/segmentation\` \u2014 Event segmentation
+### Amplitude REST API Reference
+
+- Authentication: Basic auth (API Key:Secret Key, handled automatically)
+- All timestamps use YYYYMMDD format for date parameters
+
+#### Endpoints Available on All Plans
 - GET \`https://amplitude.com/api/2/events/list\` \u2014 List event types
-- GET \`https://amplitude.com/api/2/usersearch\` \u2014 Search users
-- GET \`https://amplitude.com/api/2/useractivity\` \u2014 User activity
-- POST \`https://amplitude.com/api/2/export\` \u2014 Export raw events`,
-    ja: `### Amplitude SDK\uFF08TypeScript\u30CF\u30F3\u30C9\u30E9\u30FC\uFF09
-TypeScript\u30CF\u30F3\u30C9\u30E9\u30FC\u3067Amplitude\u30B3\u30CD\u30AF\u30BF\u30FC\u3092SDK\u7D4C\u7531\u3067\u4F7F\u7528\u3057\u307E\u3059\uFF1A
+- GET \`https://amplitude.com/api/2/export?start=YYYYMMDDTHH&end=YYYYMMDDTHH\` \u2014 Export raw events
+- GET \`https://amplitude.com/api/2/usersearch?user=QUERY\` \u2014 Search users
+- GET \`https://amplitude.com/api/2/useractivity?user=AMPLITUDE_ID\` \u2014 User activity
+
+#### Endpoints Requiring Growth or Enterprise Plan (will return 403 on free/Starter plans)
+- GET \`https://amplitude.com/api/2/events/segmentation\` \u2014 Event segmentation
+- GET \`https://amplitude.com/api/2/funnels\` \u2014 Funnel analysis
+- GET \`https://amplitude.com/api/2/retention\` \u2014 Retention analysis
+- GET \`https://amplitude.com/api/2/revenue\` \u2014 Revenue analysis
+
+IMPORTANT: Always start with the endpoints available on all plans. If you need aggregated analytics, use the Export API to retrieve raw events and aggregate in code. Only attempt the Dashboard REST API endpoints (segmentation, funnels, retention, revenue) if specifically requested, and handle 403 errors gracefully by falling back to the Export API.
+
+#### Event Segmentation Query Parameters (Growth/Enterprise only)
+- \`e\` \u2014 JSON-encoded event definition (e.g., \`{"event_type":"Click"}\`)
+- \`start\` \u2014 Start date (YYYYMMDD)
+- \`end\` \u2014 End date (YYYYMMDD)
+- \`m\` \u2014 Metric type (uniques, totals, avg, etc.)
+- \`i\` \u2014 Interval (1=daily, 7=weekly, 30=monthly)
+- \`g\` \u2014 Group by property`,
+    ja: `### \u30C4\u30FC\u30EB
+
+- \`amplitude_request\`: Amplitude REST API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30A4\u30D9\u30F3\u30C8\u30BB\u30B0\u30E1\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u3001\u30A4\u30D9\u30F3\u30C8\u30BF\u30A4\u30D7\u4E00\u89A7\u3001\u30E6\u30FC\u30B6\u30FC\u691C\u7D22\u3001\u30E6\u30FC\u30B6\u30FC\u30A2\u30AF\u30C6\u30A3\u30D3\u30C6\u30A3\u3001\u30C7\u30FC\u30BF\u30A8\u30AF\u30B9\u30DD\u30FC\u30C8\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\uFF08API Key + Secret Key\u306B\u3088\u308BBasic\u8A8D\u8A3C\uFF09\u306F\u81EA\u52D5\u7684\u306B\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF\u3092\u542B\u3080\u5B8C\u5168\u306AURL\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044 \u2014 \u30D9\u30FC\u30B9URL\u306F\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u306B\u3088\u3063\u3066\u7570\u306A\u308A\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):
+- \`client.request(url, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u306E\u8A8D\u8A3C\u4ED8\u304Dfetch\uFF08\u5B8C\u5168\u306AURL\u3092\u6307\u5B9A\uFF09
+- \`client.listEventTypes()\` \u2014 \u5168\u30A4\u30D9\u30F3\u30C8\u30BF\u30A4\u30D7\u306E\u4E00\u89A7
+- \`client.eventSegmentation(options)\` \u2014 \u30A4\u30D9\u30F3\u30C8\u30BB\u30B0\u30E1\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u30AF\u30A8\u30EA\u306E\u5B9F\u884C\uFF08e, start, end, m?, i?, g?\uFF09
+- \`client.userSearch(query)\` \u2014 \u30E6\u30FC\u30B6\u30FC\u307E\u305F\u306Famplitude ID\u3067\u30E6\u30FC\u30B6\u30FC\u3092\u691C\u7D22
+- \`client.userActivity(amplitudeId, options?)\` \u2014 amplitude ID\u3067\u30E6\u30FC\u30B6\u30FC\u30A2\u30AF\u30C6\u30A3\u30D3\u30C6\u30A3\u3092\u53D6\u5F97
 
 \`\`\`ts
+import type { Context } from "hono";
 import { connection } from "@squadbase/vite-server/connectors/amplitude";
 
-const { apiKey, secretKey } = connection("<connectionId>");
+const amp = connection("<connectionId>");
 
-// Amplitude REST API\u3092Basic\u8A8D\u8A3C\uFF08apiKey:secretKey\uFF09\u3067\u4F7F\u7528
-const res = await fetch("https://amplitude.com/api/2/events/segmentation", {
-  headers: {
-    Authorization: "Basic " + btoa(apiKey + ":" + secretKey),
-  },
-});
-const data = await res.json();
+export default async function handler(c: Context) {
+  const { eventType, start, end } = await c.req.json<{
+    eventType: string;
+    start: string;
+    end: string;
+  }>();
+
+  const result = await amp.eventSegmentation({
+    e: { event_type: eventType },
+    start,
+    end,
+  });
+
+  return c.json(result);
+}
 \`\`\`
 
-### \u4E3B\u8981\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
-- GET \`https://amplitude.com/api/2/events/segmentation\` \u2014 \u30A4\u30D9\u30F3\u30C8\u30BB\u30B0\u30E1\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3
+### Amplitude REST API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
+
+- \u8A8D\u8A3C: Basic\u8A8D\u8A3C\uFF08API Key:Secret Key\u3001\u81EA\u52D5\u8A2D\u5B9A\uFF09
+- \u65E5\u4ED8\u30D1\u30E9\u30E1\u30FC\u30BF\u306F\u3059\u3079\u3066YYYYMMDD\u5F62\u5F0F\u306E\u30BF\u30A4\u30E0\u30B9\u30BF\u30F3\u30D7\u3092\u4F7F\u7528
+
+#### \u5168\u30D7\u30E9\u30F3\u3067\u5229\u7528\u53EF\u80FD\u306A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
 - GET \`https://amplitude.com/api/2/events/list\` \u2014 \u30A4\u30D9\u30F3\u30C8\u30BF\u30A4\u30D7\u4E00\u89A7
-- GET \`https://amplitude.com/api/2/usersearch\` \u2014 \u30E6\u30FC\u30B6\u30FC\u691C\u7D22
-- GET \`https://amplitude.com/api/2/useractivity\` \u2014 \u30E6\u30FC\u30B6\u30FC\u30A2\u30AF\u30C6\u30A3\u30D3\u30C6\u30A3
-- POST \`https://amplitude.com/api/2/export\` \u2014 \u751F\u30A4\u30D9\u30F3\u30C8\u306E\u30A8\u30AF\u30B9\u30DD\u30FC\u30C8`
+- GET \`https://amplitude.com/api/2/export?start=YYYYMMDDTHH&end=YYYYMMDDTHH\` \u2014 \u751F\u30A4\u30D9\u30F3\u30C8\u306E\u30A8\u30AF\u30B9\u30DD\u30FC\u30C8
+- GET \`https://amplitude.com/api/2/usersearch?user=QUERY\` \u2014 \u30E6\u30FC\u30B6\u30FC\u691C\u7D22
+- GET \`https://amplitude.com/api/2/useractivity?user=AMPLITUDE_ID\` \u2014 \u30E6\u30FC\u30B6\u30FC\u30A2\u30AF\u30C6\u30A3\u30D3\u30C6\u30A3
+
+#### Growth\u307E\u305F\u306FEnterprise\u30D7\u30E9\u30F3\u304C\u5FC5\u8981\u306A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\uFF08\u7121\u6599/Starter\u30D7\u30E9\u30F3\u3067\u306F403\u30A8\u30E9\u30FC\uFF09
+- GET \`https://amplitude.com/api/2/events/segmentation\` \u2014 \u30A4\u30D9\u30F3\u30C8\u30BB\u30B0\u30E1\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3
+- GET \`https://amplitude.com/api/2/funnels\` \u2014 \u30D5\u30A1\u30CD\u30EB\u5206\u6790
+- GET \`https://amplitude.com/api/2/retention\` \u2014 \u30EA\u30C6\u30F3\u30B7\u30E7\u30F3\u5206\u6790
+- GET \`https://amplitude.com/api/2/revenue\` \u2014 \u53CE\u76CA\u5206\u6790
+
+\u91CD\u8981: \u307E\u305A\u5168\u30D7\u30E9\u30F3\u3067\u5229\u7528\u53EF\u80FD\u306A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u3092\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u96C6\u8A08\u5206\u6790\u304C\u5FC5\u8981\u306A\u5834\u5408\u306F\u3001Export API\u3067\u751F\u30A4\u30D9\u30F3\u30C8\u3092\u53D6\u5F97\u3057\u3001\u30B3\u30FC\u30C9\u4E0A\u3067\u96C6\u8A08\u3092\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002Dashboard REST API\uFF08segmentation\u3001funnels\u3001retention\u3001revenue\uFF09\u306F\u660E\u793A\u7684\u306B\u8981\u6C42\u3055\u308C\u305F\u5834\u5408\u306E\u307F\u8A66\u884C\u3057\u3001403\u30A8\u30E9\u30FC\u304C\u8FD4\u3055\u308C\u305F\u5834\u5408\u306FExport API\u306B\u30D5\u30A9\u30FC\u30EB\u30D0\u30C3\u30AF\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+
+#### \u30A4\u30D9\u30F3\u30C8\u30BB\u30B0\u30E1\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF\uFF08Growth/Enterprise\u30D7\u30E9\u30F3\u306E\u307F\uFF09
+- \`e\` \u2014 JSON\u30A8\u30F3\u30B3\u30FC\u30C9\u3055\u308C\u305F\u30A4\u30D9\u30F3\u30C8\u5B9A\u7FA9\uFF08\u4F8B: \`{"event_type":"Click"}\`\uFF09
+- \`start\` \u2014 \u958B\u59CB\u65E5\uFF08YYYYMMDD\uFF09
+- \`end\` \u2014 \u7D42\u4E86\u65E5\uFF08YYYYMMDD\uFF09
+- \`m\` \u2014 \u30E1\u30C8\u30EA\u30AF\u30B9\u30BF\u30A4\u30D7\uFF08uniques, totals, avg\u306A\u3069\uFF09
+- \`i\` \u2014 \u30A4\u30F3\u30BF\u30FC\u30D0\u30EB\uFF081=\u65E5\u6B21\u30017=\u9031\u6B21\u300130=\u6708\u6B21\uFF09
+- \`g\` \u2014 \u30B0\u30EB\u30FC\u30D7\u5316\u30D7\u30ED\u30D1\u30C6\u30A3`
   },
   tools
 });