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

package/dist/connectors/customerio.js

@@ -0,0 +1,633 @@
+// ../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/customerio/parameters.ts
+var parameters = {
+  appApiKey: new ParameterDefinition({
+    slug: "app-api-key",
+    name: "App API Key",
+    description: "Your Customer.io App API Key. Used for Bearer authentication. Found under Settings > API Credentials. Note: shown only once when created.",
+    envVarBaseKey: "CUSTOMERIO_API_KEY",
+    type: "text",
+    secret: true,
+    required: true
+  }),
+  region: new ParameterDefinition({
+    slug: "region",
+    name: "Region",
+    description: 'Set to "eu" for EU region. Leave empty for US/Global region (default).',
+    envVarBaseKey: "CUSTOMERIO_REGION",
+    type: "text",
+    secret: false,
+    required: false
+  })
+};
+
+// ../connectors/src/connectors/customerio/sdk/index.ts
+function getBaseUrl(region) {
+  return region === "eu" ? "https://api-eu.customer.io" : "https://api.customer.io";
+}
+function createClient(params) {
+  const appApiKey = params[parameters.appApiKey.slug];
+  const region = params[parameters.region.slug];
+  if (!appApiKey) {
+    throw new Error(
+      `customerio: missing required parameter: ${parameters.appApiKey.slug}`
+    );
+  }
+  const baseUrl = getBaseUrl(region);
+  function authHeaders(extra) {
+    const headers = new Headers(extra);
+    headers.set("Authorization", `Bearer ${appApiKey}`);
+    headers.set("Content-Type", "application/json");
+    return headers;
+  }
+  async function assertOk(res, label) {
+    if (!res.ok) {
+      const body = await res.text().catch(() => "(unreadable body)");
+      throw new Error(
+        `customerio ${label}: ${res.status} ${res.statusText} \u2014 ${body}`
+      );
+    }
+  }
+  return {
+    request(path2, init) {
+      const url = `${baseUrl}${path2.startsWith("/") ? "" : "/"}${path2}`;
+      const headers = new Headers(init?.headers);
+      headers.set("Authorization", `Bearer ${appApiKey}`);
+      headers.set("Content-Type", "application/json");
+      return fetch(url, { ...init, headers });
+    },
+    async getCustomers(options) {
+      const sp = new URLSearchParams();
+      if (options?.start) sp.set("start", options.start);
+      if (options?.limit) sp.set("limit", String(options.limit));
+      const qs = sp.toString() ? `?${sp.toString()}` : "";
+      const res = await fetch(`${baseUrl}/v1/customers${qs}`, {
+        method: "GET",
+        headers: authHeaders()
+      });
+      await assertOk(res, "getCustomers");
+      return await res.json();
+    },
+    async getCustomer(identifier) {
+      const res = await fetch(
+        `${baseUrl}/v1/customers/${encodeURIComponent(identifier)}/attributes`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "getCustomer");
+      return await res.json();
+    },
+    async getSegments() {
+      const res = await fetch(`${baseUrl}/v1/segments`, {
+        method: "GET",
+        headers: authHeaders()
+      });
+      await assertOk(res, "getSegments");
+      return await res.json();
+    },
+    async getSegmentMembership(segmentId) {
+      const res = await fetch(
+        `${baseUrl}/v1/segments/${segmentId}/membership`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "getSegmentMembership");
+      return await res.json();
+    },
+    async getCampaigns() {
+      const res = await fetch(`${baseUrl}/v1/campaigns`, {
+        method: "GET",
+        headers: authHeaders()
+      });
+      await assertOk(res, "getCampaigns");
+      return await res.json();
+    },
+    async getCampaign(campaignId) {
+      const res = await fetch(`${baseUrl}/v1/campaigns/${campaignId}`, {
+        method: "GET",
+        headers: authHeaders()
+      });
+      await assertOk(res, "getCampaign");
+      return await res.json();
+    },
+    async sendEmail(emailParams) {
+      const res = await fetch(`${baseUrl}/v1/send/email`, {
+        method: "POST",
+        headers: authHeaders(),
+        body: JSON.stringify(emailParams)
+      });
+      await assertOk(res, "sendEmail");
+      return await res.json();
+    },
+    async triggerBroadcast(broadcastId, broadcastParams) {
+      const res = await fetch(
+        `${baseUrl}/v1/campaigns/${broadcastId}/triggers`,
+        {
+          method: "POST",
+          headers: authHeaders(),
+          body: JSON.stringify(broadcastParams ?? {})
+        }
+      );
+      await assertOk(res, "triggerBroadcast");
+      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;
+  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/connectors/customerio/setup.ts
+var customerioOnboarding = new ConnectorOnboarding({
+  dataOverviewInstructions: {
+    en: `1. Call customerio_request with GET /v1/segments to list all segments
+2. Call customerio_request with GET /v1/campaigns to list all campaigns
+3. Pick a segment and call GET /v1/segments/{segment_id}/membership to view member IDs
+4. Pick a customer ID and call GET /v1/customers/{id}/attributes to view customer attributes`,
+    ja: `1. customerio_request \u3067 GET /v1/segments \u3092\u547C\u3073\u51FA\u3057\u3001\u5168\u30BB\u30B0\u30E1\u30F3\u30C8\u4E00\u89A7\u3092\u53D6\u5F97
+2. customerio_request \u3067 GET /v1/campaigns \u3092\u547C\u3073\u51FA\u3057\u3001\u5168\u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u4E00\u89A7\u3092\u53D6\u5F97
+3. \u30BB\u30B0\u30E1\u30F3\u30C8\u3092\u9078\u629E\u3057 GET /v1/segments/{segment_id}/membership \u3067\u30E1\u30F3\u30D0\u30FCID\u3092\u78BA\u8A8D
+4. \u9867\u5BA2ID\u3092\u9078\u629E\u3057 GET /v1/customers/{id}/attributes \u3067\u9867\u5BA2\u5C5E\u6027\u3092\u78BA\u8A8D`
+  }
+});
+
+// ../connectors/src/connectors/customerio/tools/request.ts
+import { z } from "zod";
+var REQUEST_TIMEOUT_MS = 6e4;
+function getBaseUrl2(region) {
+  return region === "eu" ? "https://api-eu.customer.io" : "https://api.customer.io";
+}
+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 Customer.io connection to use"),
+  method: z.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]).describe("HTTP method"),
+  path: z.string().describe(
+    "API path (e.g., '/v1/customers', '/v1/segments', '/v1/campaigns', '/v1/send/email')"
+  ),
+  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 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 Customer.io App API.
+Authentication is handled automatically using the App API Key (Bearer token).
+Use this tool for reading customer data, managing campaigns, segments, broadcasts, sending transactional messages, and retrieving delivery information.
+The App API is the read and management path for Customer.io data.`,
+  inputSchema,
+  outputSchema,
+  async execute({ connectionId, method, path: path2, queryParams, body }, connections) {
+    const connection2 = connections.find((c) => c.id === connectionId);
+    if (!connection2) {
+      return {
+        success: false,
+        error: `Connection ${connectionId} not found`
+      };
+    }
+    console.log(
+      `[connector-request] customerio/${connection2.name}: ${method} ${path2}`
+    );
+    try {
+      const appApiKey = parameters.appApiKey.getValue(connection2);
+      const region = parameters.region.tryGetValue(connection2);
+      const baseUrl = getBaseUrl2(region);
+      let url = `${baseUrl}${path2.startsWith("/") ? "" : "/"}${path2}`;
+      if (queryParams) {
+        const searchParams = new URLSearchParams(queryParams);
+        url += `?${searchParams.toString()}`;
+      }
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+      try {
+        const response = await fetch(url, {
+          method,
+          headers: {
+            Authorization: `Bearer ${appApiKey}`,
+            "Content-Type": "application/json"
+          },
+          body: body ? JSON.stringify(body) : void 0,
+          signal: controller.signal
+        });
+        let data = {};
+        const text = await response.text();
+        if (text) {
+          try {
+            data = JSON.parse(text);
+          } catch {
+            data = { raw: text };
+          }
+        }
+        if (!response.ok) {
+          const meta = typeof data?.meta === "object" && data.meta !== null ? data.meta : null;
+          const errorMessage = typeof meta?.error === "string" ? meta.error : typeof data?.errors === "object" ? JSON.stringify(data.errors) : typeof data?.error === "string" ? data.error : `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/customerio/index.ts
+var tools = { request: requestTool };
+var customerioConnector = new ConnectorPlugin({
+  slug: "customerio",
+  authType: null,
+  name: "Customer.io",
+  description: "Connect to Customer.io App API for reading customer data, managing campaigns, segments, and sending transactional messages.",
+  iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/6VPGKA8I2MqzaBgULLj4WQ/a4a4a4a4a4a4a4a4a4a4a4a4a4a4a4a4/customerio.svg",
+  parameters,
+  releaseFlag: { dev1: true, dev2: false, prod: false },
+  onboarding: customerioOnboarding,
+  systemPrompt: {
+    en: `### Tools
+
+- \`customerio_request\`: The only way to call the Customer.io App API. Use it to read customer data, manage campaigns and segments, send transactional messages, and trigger broadcasts. Authentication (Bearer token with App API Key) is configured automatically.
+
+### 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(path, init?)\` \u2014 low-level authenticated fetch
+- \`client.getCustomers(options?)\` \u2014 list customers
+- \`client.getCustomer(identifier)\` \u2014 get customer attributes
+- \`client.getSegments()\` \u2014 list all segments
+- \`client.getSegmentMembership(segmentId)\` \u2014 get segment member IDs
+- \`client.getCampaigns()\` \u2014 list all campaigns
+- \`client.getCampaign(campaignId)\` \u2014 get campaign details
+- \`client.sendEmail(params)\` \u2014 send a transactional email
+- \`client.triggerBroadcast(broadcastId, params?)\` \u2014 trigger a broadcast
+
+\`\`\`ts
+import type { Context } from "hono";
+import { connection } from "@squadbase/vite-server/connectors/customerio";
+
+const cio = connection("<connectionId>");
+
+export default async function handler(c: Context) {
+  const { segments } = await cio.getSegments();
+  const { campaigns } = await cio.getCampaigns();
+
+  return c.json({ segments, campaigns });
+}
+\`\`\`
+
+### Customer.io App API Reference
+
+- Base URL: \`https://api.customer.io\` (US/Global) or \`https://api-eu.customer.io\` (EU)
+- Authentication: Bearer token (\`Authorization: Bearer {app_api_key}\`)
+- The App API is the read and management path \u2014 use it to retrieve data and trigger messages
+
+#### Customers
+- GET \`/v1/customers/{identifier}/attributes\` \u2014 Get customer attributes
+- GET \`/v1/customers/{identifier}/segments\` \u2014 Get customer's segments
+- GET \`/v1/customers/{identifier}/messages\` \u2014 Get customer's messages
+- GET \`/v1/customers/{identifier}/activities\` \u2014 Get customer's activities
+
+#### Segments
+- GET \`/v1/segments\` \u2014 List all segments
+- GET \`/v1/segments/{segment_id}\` \u2014 Get segment details
+- GET \`/v1/segments/{segment_id}/membership\` \u2014 Get segment member IDs
+
+#### Campaigns
+- GET \`/v1/campaigns\` \u2014 List all campaigns
+- GET \`/v1/campaigns/{campaign_id}\` \u2014 Get campaign details
+- GET \`/v1/campaigns/{campaign_id}/actions\` \u2014 Get campaign actions
+- GET \`/v1/campaigns/{campaign_id}/metrics\` \u2014 Get campaign metrics
+
+#### Newsletters
+- GET \`/v1/newsletters\` \u2014 List all newsletters
+- GET \`/v1/newsletters/{newsletter_id}\` \u2014 Get newsletter details
+- GET \`/v1/newsletters/{newsletter_id}/metrics\` \u2014 Get newsletter metrics
+
+#### Broadcasts
+- GET \`/v1/campaigns/{broadcast_id}/triggers\` \u2014 List broadcast triggers
+- POST \`/v1/campaigns/{broadcast_id}/triggers\` \u2014 Trigger a broadcast
+
+#### Transactional Messages
+- POST \`/v1/send/email\` \u2014 Send a transactional email
+- POST \`/v1/send/push\` \u2014 Send a transactional push notification
+
+#### Message Info
+- GET \`/v1/messages/{message_id}\` \u2014 Get message details
+- GET \`/v1/messages/{message_id}/deliveries\` \u2014 Get delivery attempts
+
+#### Exports
+- POST \`/v1/exports/customers\` \u2014 Export customer data
+- POST \`/v1/exports/deliveries\` \u2014 Export delivery data
+- GET \`/v1/exports/{export_id}\` \u2014 Get export status
+- GET \`/v1/exports/{export_id}/download\` \u2014 Download export
+
+### Tips
+- App API keys are shown only once when created \u2014 store them securely
+- Segment membership returns an array of customer IDs
+- Use the exports endpoints for bulk data retrieval
+- Pagination uses cursor-based \`start\` parameter for customer listing`,
+    ja: `### \u30C4\u30FC\u30EB
+
+- \`customerio_request\`: Customer.io App API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u9867\u5BA2\u30C7\u30FC\u30BF\u306E\u8AAD\u307F\u53D6\u308A\u3001\u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u3084\u30BB\u30B0\u30E1\u30F3\u30C8\u306E\u7BA1\u7406\u3001\u30C8\u30E9\u30F3\u30B6\u30AF\u30B7\u30E7\u30F3\u30E1\u30C3\u30BB\u30FC\u30B8\u306E\u9001\u4FE1\u3001\u30D6\u30ED\u30FC\u30C9\u30AD\u30E3\u30B9\u30C8\u306E\u30C8\u30EA\u30AC\u30FC\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\uFF08App API\u30AD\u30FC\u306B\u3088\u308BBearer\u30C8\u30FC\u30AF\u30F3\uFF09\u306F\u81EA\u52D5\u7684\u306B\u8A2D\u5B9A\u3055\u308C\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(path, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u306E\u8A8D\u8A3C\u4ED8\u304Dfetch
+- \`client.getCustomers(options?)\` \u2014 \u9867\u5BA2\u4E00\u89A7
+- \`client.getCustomer(identifier)\` \u2014 \u9867\u5BA2\u5C5E\u6027\u306E\u53D6\u5F97
+- \`client.getSegments()\` \u2014 \u5168\u30BB\u30B0\u30E1\u30F3\u30C8\u306E\u4E00\u89A7
+- \`client.getSegmentMembership(segmentId)\` \u2014 \u30BB\u30B0\u30E1\u30F3\u30C8\u30E1\u30F3\u30D0\u30FCID\u306E\u53D6\u5F97
+- \`client.getCampaigns()\` \u2014 \u5168\u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u306E\u4E00\u89A7
+- \`client.getCampaign(campaignId)\` \u2014 \u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u8A73\u7D30\u306E\u53D6\u5F97
+- \`client.sendEmail(params)\` \u2014 \u30C8\u30E9\u30F3\u30B6\u30AF\u30B7\u30E7\u30F3\u30E1\u30FC\u30EB\u306E\u9001\u4FE1
+- \`client.triggerBroadcast(broadcastId, params?)\` \u2014 \u30D6\u30ED\u30FC\u30C9\u30AD\u30E3\u30B9\u30C8\u306E\u30C8\u30EA\u30AC\u30FC
+
+\`\`\`ts
+import type { Context } from "hono";
+import { connection } from "@squadbase/vite-server/connectors/customerio";
+
+const cio = connection("<connectionId>");
+
+export default async function handler(c: Context) {
+  const { segments } = await cio.getSegments();
+  const { campaigns } = await cio.getCampaigns();
+
+  return c.json({ segments, campaigns });
+}
+\`\`\`
+
+### Customer.io App API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
+
+- \u30D9\u30FC\u30B9URL: \`https://api.customer.io\`\uFF08US/Global\uFF09\u307E\u305F\u306F \`https://api-eu.customer.io\`\uFF08EU\uFF09
+- \u8A8D\u8A3C: Bearer\u30C8\u30FC\u30AF\u30F3 (\`Authorization: Bearer {app_api_key}\`)
+- App API\u306F\u8AAD\u307F\u53D6\u308A\u3068\u7BA1\u7406\u30D1\u30B9\u3067\u3059 \u2014 \u30C7\u30FC\u30BF\u306E\u53D6\u5F97\u3068\u30E1\u30C3\u30BB\u30FC\u30B8\u306E\u30C8\u30EA\u30AC\u30FC\u306B\u4F7F\u7528\u3057\u307E\u3059
+
+#### \u9867\u5BA2
+- GET \`/v1/customers/{identifier}/attributes\` \u2014 \u9867\u5BA2\u5C5E\u6027\u306E\u53D6\u5F97
+- GET \`/v1/customers/{identifier}/segments\` \u2014 \u9867\u5BA2\u306E\u30BB\u30B0\u30E1\u30F3\u30C8\u53D6\u5F97
+- GET \`/v1/customers/{identifier}/messages\` \u2014 \u9867\u5BA2\u306E\u30E1\u30C3\u30BB\u30FC\u30B8\u53D6\u5F97
+- GET \`/v1/customers/{identifier}/activities\` \u2014 \u9867\u5BA2\u306E\u30A2\u30AF\u30C6\u30A3\u30D3\u30C6\u30A3\u53D6\u5F97
+
+#### \u30BB\u30B0\u30E1\u30F3\u30C8
+- GET \`/v1/segments\` \u2014 \u5168\u30BB\u30B0\u30E1\u30F3\u30C8\u306E\u4E00\u89A7
+- GET \`/v1/segments/{segment_id}\` \u2014 \u30BB\u30B0\u30E1\u30F3\u30C8\u306E\u8A73\u7D30
+- GET \`/v1/segments/{segment_id}/membership\` \u2014 \u30BB\u30B0\u30E1\u30F3\u30C8\u30E1\u30F3\u30D0\u30FCID\u306E\u53D6\u5F97
+
+#### \u30AD\u30E3\u30F3\u30DA\u30FC\u30F3
+- GET \`/v1/campaigns\` \u2014 \u5168\u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u306E\u4E00\u89A7
+- GET \`/v1/campaigns/{campaign_id}\` \u2014 \u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u306E\u8A73\u7D30
+- GET \`/v1/campaigns/{campaign_id}/actions\` \u2014 \u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u30A2\u30AF\u30B7\u30E7\u30F3\u306E\u53D6\u5F97
+- GET \`/v1/campaigns/{campaign_id}/metrics\` \u2014 \u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u30E1\u30C8\u30EA\u30AF\u30B9\u306E\u53D6\u5F97
+
+#### \u30CB\u30E5\u30FC\u30B9\u30EC\u30BF\u30FC
+- GET \`/v1/newsletters\` \u2014 \u5168\u30CB\u30E5\u30FC\u30B9\u30EC\u30BF\u30FC\u306E\u4E00\u89A7
+- GET \`/v1/newsletters/{newsletter_id}\` \u2014 \u30CB\u30E5\u30FC\u30B9\u30EC\u30BF\u30FC\u306E\u8A73\u7D30
+- GET \`/v1/newsletters/{newsletter_id}/metrics\` \u2014 \u30CB\u30E5\u30FC\u30B9\u30EC\u30BF\u30FC\u30E1\u30C8\u30EA\u30AF\u30B9\u306E\u53D6\u5F97
+
+#### \u30D6\u30ED\u30FC\u30C9\u30AD\u30E3\u30B9\u30C8
+- GET \`/v1/campaigns/{broadcast_id}/triggers\` \u2014 \u30D6\u30ED\u30FC\u30C9\u30AD\u30E3\u30B9\u30C8\u30C8\u30EA\u30AC\u30FC\u4E00\u89A7
+- POST \`/v1/campaigns/{broadcast_id}/triggers\` \u2014 \u30D6\u30ED\u30FC\u30C9\u30AD\u30E3\u30B9\u30C8\u306E\u30C8\u30EA\u30AC\u30FC
+
+#### \u30C8\u30E9\u30F3\u30B6\u30AF\u30B7\u30E7\u30F3\u30E1\u30C3\u30BB\u30FC\u30B8
+- POST \`/v1/send/email\` \u2014 \u30C8\u30E9\u30F3\u30B6\u30AF\u30B7\u30E7\u30F3\u30E1\u30FC\u30EB\u306E\u9001\u4FE1
+- POST \`/v1/send/push\` \u2014 \u30C8\u30E9\u30F3\u30B6\u30AF\u30B7\u30E7\u30F3\u30D7\u30C3\u30B7\u30E5\u901A\u77E5\u306E\u9001\u4FE1
+
+#### \u30E1\u30C3\u30BB\u30FC\u30B8\u60C5\u5831
+- GET \`/v1/messages/{message_id}\` \u2014 \u30E1\u30C3\u30BB\u30FC\u30B8\u306E\u8A73\u7D30
+- GET \`/v1/messages/{message_id}/deliveries\` \u2014 \u914D\u4FE1\u8A66\u884C\u306E\u53D6\u5F97
+
+#### \u30A8\u30AF\u30B9\u30DD\u30FC\u30C8
+- POST \`/v1/exports/customers\` \u2014 \u9867\u5BA2\u30C7\u30FC\u30BF\u306E\u30A8\u30AF\u30B9\u30DD\u30FC\u30C8
+- POST \`/v1/exports/deliveries\` \u2014 \u914D\u4FE1\u30C7\u30FC\u30BF\u306E\u30A8\u30AF\u30B9\u30DD\u30FC\u30C8
+- GET \`/v1/exports/{export_id}\` \u2014 \u30A8\u30AF\u30B9\u30DD\u30FC\u30C8\u72B6\u614B\u306E\u53D6\u5F97
+- GET \`/v1/exports/{export_id}/download\` \u2014 \u30A8\u30AF\u30B9\u30DD\u30FC\u30C8\u306E\u30C0\u30A6\u30F3\u30ED\u30FC\u30C9
+
+### \u30D2\u30F3\u30C8
+- App API\u30AD\u30FC\u306F\u4F5C\u6210\u6642\u306B\u4E00\u5EA6\u3060\u3051\u8868\u793A\u3055\u308C\u308B \u2014 \u5B89\u5168\u306B\u4FDD\u7BA1\u3059\u308B\u3053\u3068
+- \u30BB\u30B0\u30E1\u30F3\u30C8\u30E1\u30F3\u30D0\u30FC\u30B7\u30C3\u30D7\u306F\u9867\u5BA2ID\u306E\u914D\u5217\u3092\u8FD4\u5374
+- \u5927\u91CF\u30C7\u30FC\u30BF\u53D6\u5F97\u306B\u306Fexports\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u3092\u4F7F\u7528
+- \u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u306F\u9867\u5BA2\u4E00\u89A7\u3067\u30AB\u30FC\u30BD\u30EB\u30D9\u30FC\u30B9\u306E\`start\`\u30D1\u30E9\u30E1\u30FC\u30BF\u3092\u4F7F\u7528`
+  },
+  tools
+});
+
+// src/connectors/create-connector-sdk.ts
+import { readFileSync } from "fs";
+import path from "path";
+
+// src/connector-client/env.ts
+function resolveEnvVar(entry, key, connectionId) {
+  const envVarName = entry.envVars[key];
+  if (!envVarName) {
+    throw new Error(`Connection "${connectionId}" is missing envVars mapping for key "${key}"`);
+  }
+  const value = process.env[envVarName];
+  if (!value) {
+    throw new Error(`Environment variable "${envVarName}" (for connection "${connectionId}", key "${key}") is not set`);
+  }
+  return value;
+}
+function resolveEnvVarOptional(entry, key) {
+  const envVarName = entry.envVars[key];
+  if (!envVarName) return void 0;
+  return process.env[envVarName] || void 0;
+}
+
+// src/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);
+  };
+}
+
+// src/connectors/entries/customerio.ts
+var connection = createConnectorSdk(customerioConnector, createClient);
+export {
+  connection
+};

package/dist/connectors/gmail-oauth.d.ts

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