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

package/dist/connectors/shopify.js

@@ -44,43 +44,284 @@ var ParameterDefinition = class {
 
 // ../connectors/src/connectors/shopify/parameters.ts
 var parameters = {
-  accessToken: new ParameterDefinition({
-    slug: "access-token",
-    name: "Shopify Admin API Access Token",
-    description: "The Shopify Admin API access token for authentication (starts with shpat_).",
-    envVarBaseKey: "SHOPIFY_ACCESS_TOKEN",
-    type: "text",
-    secret: true,
-    required: true
-  }),
   storeDomain: new ParameterDefinition({
     slug: "store-domain",
-    name: "Shopify Store Domain",
-    description: "Your Shopify store domain (e.g., mystore.myshopify.com).",
+    name: "Shop Name",
+    description: 'Your Shopify store name (the subdomain part of your .myshopify.com URL, e.g., "mystore" for mystore.myshopify.com).',
     envVarBaseKey: "SHOPIFY_STORE_DOMAIN",
     type: "text",
     secret: false,
     required: true
+  }),
+  clientId: new ParameterDefinition({
+    slug: "client-id",
+    name: "Client ID",
+    description: "The Client ID (API Key) of your Shopify Custom App.",
+    envVarBaseKey: "SHOPIFY_CLIENT_ID",
+    type: "text",
+    secret: false,
+    required: true
+  }),
+  clientSecret: new ParameterDefinition({
+    slug: "client-secret",
+    name: "Client Secret",
+    description: "The Client Secret (API Secret Key) of your Shopify Custom App.",
+    envVarBaseKey: "SHOPIFY_CLIENT_SECRET",
+    type: "text",
+    secret: true,
+    required: true
   })
 };
 
 // ../connectors/src/connectors/shopify/sdk/index.ts
-function createClient(params) {
-  const accessToken = params[parameters.accessToken.slug];
-  const storeDomain = params[parameters.storeDomain.slug];
-  if (!accessToken) {
+var API_VERSION = "2024-10";
+async function fetchAccessToken(storeDomain, clientId, clientSecret) {
+  const res = await fetch(
+    `https://${storeDomain}/admin/oauth/access_token`,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        client_id: clientId,
+        client_secret: clientSecret
+      })
+    }
+  );
+  if (!res.ok) {
+    const body = await res.text().catch(() => "(unreadable body)");
     throw new Error(
-      `shopify: missing required parameter: ${parameters.accessToken.slug}`
+      `shopify: failed to obtain access token: ${res.status} ${res.statusText} \u2014 ${body}`
     );
   }
+  const json = await res.json();
+  if (!json.access_token) {
+    throw new Error("shopify: access_token not found in token response");
+  }
+  return json.access_token;
+}
+function createClient(params) {
+  const storeDomain = params[parameters.storeDomain.slug];
+  const clientId = params[parameters.clientId.slug];
+  const clientSecret = params[parameters.clientSecret.slug];
   if (!storeDomain) {
     throw new Error(
       `shopify: missing required parameter: ${parameters.storeDomain.slug}`
     );
   }
-  return { accessToken, storeDomain };
+  if (!clientId) {
+    throw new Error(
+      `shopify: missing required parameter: ${parameters.clientId.slug}`
+    );
+  }
+  if (!clientSecret) {
+    throw new Error(
+      `shopify: missing required parameter: ${parameters.clientSecret.slug}`
+    );
+  }
+  const baseUrl = `https://${storeDomain}`;
+  async function getToken() {
+    return fetchAccessToken(storeDomain, clientId, clientSecret);
+  }
+  async function authHeaders(extra) {
+    const token = await getToken();
+    const headers = new Headers(extra);
+    headers.set("X-Shopify-Access-Token", token);
+    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(
+        `shopify ${label}: ${res.status} ${res.statusText} \u2014 ${body}`
+      );
+    }
+  }
+  function buildQuery(params2) {
+    if (!params2) return "";
+    const entries = Object.entries(params2).filter(
+      ([, v]) => v !== void 0 && v !== ""
+    );
+    if (entries.length === 0) return "";
+    const sp = new URLSearchParams();
+    for (const [k, v] of entries) sp.set(k, String(v));
+    return `?${sp.toString()}`;
+  }
+  return {
+    async request(path2, init) {
+      const url = `${baseUrl}${path2}`;
+      const token = await getToken();
+      const headers = new Headers(init?.headers);
+      headers.set("X-Shopify-Access-Token", token);
+      headers.set("Content-Type", "application/json");
+      return fetch(url, { ...init, headers });
+    },
+    async listProducts(options) {
+      const qs = buildQuery({
+        limit: options?.limit,
+        page_info: options?.pageInfo,
+        fields: options?.fields,
+        status: options?.status,
+        created_at_min: options?.createdAtMin,
+        created_at_max: options?.createdAtMax,
+        updated_at_min: options?.updatedAtMin,
+        updated_at_max: options?.updatedAtMax
+      });
+      const res = await fetch(
+        `${baseUrl}/admin/api/${API_VERSION}/products.json${qs}`,
+        { method: "GET", headers: await authHeaders() }
+      );
+      await assertOk(res, "listProducts");
+      const json = await res.json();
+      return {
+        products: json.products ?? []
+      };
+    },
+    async getProduct(productId) {
+      const res = await fetch(
+        `${baseUrl}/admin/api/${API_VERSION}/products/${encodeURIComponent(String(productId))}.json`,
+        { method: "GET", headers: await authHeaders() }
+      );
+      await assertOk(res, "getProduct");
+      const json = await res.json();
+      return { product: json.product };
+    },
+    async listOrders(options) {
+      const qs = buildQuery({
+        limit: options?.limit,
+        page_info: options?.pageInfo,
+        fields: options?.fields,
+        status: options?.status,
+        financial_status: options?.financialStatus,
+        fulfillment_status: options?.fulfillmentStatus,
+        created_at_min: options?.createdAtMin,
+        created_at_max: options?.createdAtMax,
+        updated_at_min: options?.updatedAtMin,
+        updated_at_max: options?.updatedAtMax
+      });
+      const res = await fetch(
+        `${baseUrl}/admin/api/${API_VERSION}/orders.json${qs}`,
+        { method: "GET", headers: await authHeaders() }
+      );
+      await assertOk(res, "listOrders");
+      const json = await res.json();
+      return {
+        orders: json.orders ?? []
+      };
+    },
+    async getOrder(orderId) {
+      const res = await fetch(
+        `${baseUrl}/admin/api/${API_VERSION}/orders/${encodeURIComponent(String(orderId))}.json`,
+        { method: "GET", headers: await authHeaders() }
+      );
+      await assertOk(res, "getOrder");
+      const json = await res.json();
+      return { order: json.order };
+    },
+    async listCustomers(options) {
+      const qs = buildQuery({
+        limit: options?.limit,
+        page_info: options?.pageInfo,
+        fields: options?.fields,
+        created_at_min: options?.createdAtMin,
+        created_at_max: options?.createdAtMax,
+        updated_at_min: options?.updatedAtMin,
+        updated_at_max: options?.updatedAtMax
+      });
+      const res = await fetch(
+        `${baseUrl}/admin/api/${API_VERSION}/customers.json${qs}`,
+        { method: "GET", headers: await authHeaders() }
+      );
+      await assertOk(res, "listCustomers");
+      const json = await res.json();
+      return {
+        customers: json.customers ?? []
+      };
+    },
+    async getCustomer(customerId) {
+      const res = await fetch(
+        `${baseUrl}/admin/api/${API_VERSION}/customers/${encodeURIComponent(String(customerId))}.json`,
+        { method: "GET", headers: await authHeaders() }
+      );
+      await assertOk(res, "getCustomer");
+      const json = await res.json();
+      return { customer: json.customer };
+    },
+    async listCustomCollections(options) {
+      const qs = buildQuery({
+        limit: options?.limit,
+        page_info: options?.pageInfo
+      });
+      const res = await fetch(
+        `${baseUrl}/admin/api/${API_VERSION}/custom_collections.json${qs}`,
+        { method: "GET", headers: await authHeaders() }
+      );
+      await assertOk(res, "listCustomCollections");
+      const json = await res.json();
+      return {
+        custom_collections: json.custom_collections ?? []
+      };
+    },
+    async listSmartCollections(options) {
+      const qs = buildQuery({
+        limit: options?.limit,
+        page_info: options?.pageInfo
+      });
+      const res = await fetch(
+        `${baseUrl}/admin/api/${API_VERSION}/smart_collections.json${qs}`,
+        { method: "GET", headers: await authHeaders() }
+      );
+      await assertOk(res, "listSmartCollections");
+      const json = await res.json();
+      return {
+        smart_collections: json.smart_collections ?? []
+      };
+    }
+  };
 }
 
+// ../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 +380,124 @@ var ConnectorPlugin = class _ConnectorPlugin {
   }
 };
 
+// ../connectors/src/connectors/shopify/setup.ts
+var shopifyOnboarding = new ConnectorOnboarding({
+  dataOverviewInstructions: {
+    en: `1. Call shopify_request with GET /admin/api/2024-10/products.json?limit=5 to explore products structure
+2. Call shopify_request with GET /admin/api/2024-10/orders.json?limit=5&status=any to explore orders structure
+3. Explore other endpoints (customers, inventory, collections) as needed`,
+    ja: `1. shopify_request \u3067 GET /admin/api/2024-10/products.json?limit=5 \u3092\u547C\u3073\u51FA\u3057\u3001\u5546\u54C1\u306E\u69CB\u9020\u3092\u78BA\u8A8D
+2. shopify_request \u3067 GET /admin/api/2024-10/orders.json?limit=5&status=any \u3092\u547C\u3073\u51FA\u3057\u3001\u6CE8\u6587\u306E\u69CB\u9020\u3092\u78BA\u8A8D
+3. \u5FC5\u8981\u306B\u5FDC\u3058\u3066\u4ED6\u306E\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\uFF08\u9867\u5BA2\u3001\u5728\u5EAB\u3001\u30B3\u30EC\u30AF\u30B7\u30E7\u30F3\uFF09\u3092\u63A2\u7D22`
+  }
+});
+
+// ../connectors/src/connectors/shopify/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 Shopify connection to use"),
+  method: z.enum(["GET", "POST", "PUT", "DELETE"]).describe(
+    "HTTP method. GET for reading resources (products, orders, customers), POST for creating, PUT for updating, DELETE for removing."
+  ),
+  path: z.string().describe(
+    "API path including version (e.g., '/admin/api/2024-10/products.json', '/admin/api/2024-10/orders.json?limit=50')"
+  ),
+  body: z.record(z.string(), z.unknown()).optional().describe("Request body (JSON) for POST/PUT 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 Shopify Admin REST API.
+Authentication is handled automatically using Custom App credentials (Client ID + Client Secret). An access token is obtained on each request.
+The store domain is resolved from the connection \u2014 only provide the path starting with /admin/api/.
+Use this tool for all Shopify API interactions: listing products, orders, customers, inventory, collections, and more.`,
+  inputSchema,
+  outputSchema,
+  async execute({ connectionId, method, path: path2, body }, connections) {
+    const connection2 = connections.find((c) => c.id === connectionId);
+    if (!connection2) {
+      return {
+        success: false,
+        error: `Connection ${connectionId} not found`
+      };
+    }
+    console.log(
+      `[connector-request] shopify/${connection2.name}: ${method} ${path2}`
+    );
+    try {
+      const storeDomain = parameters.storeDomain.getValue(connection2);
+      const clientId = parameters.clientId.getValue(connection2);
+      const clientSecret = parameters.clientSecret.getValue(connection2);
+      const tokenRes = await fetch(
+        `https://${storeDomain}/admin/oauth/access_token`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({
+            client_id: clientId,
+            client_secret: clientSecret
+          })
+        }
+      );
+      if (!tokenRes.ok) {
+        const tokenBody = await tokenRes.text().catch(() => "(unreadable body)");
+        return {
+          success: false,
+          error: `Failed to obtain access token: ${tokenRes.status} ${tokenRes.statusText} \u2014 ${tokenBody}`
+        };
+      }
+      const tokenJson = await tokenRes.json();
+      if (!tokenJson.access_token) {
+        return {
+          success: false,
+          error: "access_token not found in token response"
+        };
+      }
+      const url = `https://${storeDomain}${path2}`;
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+      try {
+        const response = await fetch(url, {
+          method,
+          headers: {
+            "X-Shopify-Access-Token": tokenJson.access_token,
+            "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?.errors === "string" ? 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/shopify/index.ts
-var tools = {};
+var tools = { request: requestTool };
 var shopifyConnector = new ConnectorPlugin({
   slug: "shopify",
   authType: null,
@@ -149,89 +506,152 @@ var shopifyConnector = new ConnectorPlugin({
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/57KEjZCBskKgSxgKyU4Sm0/117d681a410f48dc36f97cdd9c0593c5/shopify-icon.svg",
   parameters,
   releaseFlag: { dev1: true, dev2: false, prod: false },
+  onboarding: shopifyOnboarding,
   systemPrompt: {
-    en: `### Shopify SDK (TypeScript handler)
-Use the Shopify connector via the SDK in TypeScript handlers:
+    en: `### Tools
+
+- \`shopify_request\`: The only way to call the Shopify Admin REST API. Use it to query products, orders, customers, inventory, collections, and more. Authentication (Custom App Client ID + Client Secret) is configured automatically \u2014 an access token is obtained on each request. Only provide the path starting with \`/admin/api/\`. Shopify uses cursor-based pagination via the \`page_info\` query parameter (obtained from the Link header in the response).
+
+### 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.listProducts(options?)\` \u2014 list products with filters (status, date range) and pagination
+- \`client.getProduct(productId)\` \u2014 fetch a single product
+- \`client.listOrders(options?)\` \u2014 list orders with filters (status, financial_status, fulfillment_status, date range)
+- \`client.getOrder(orderId)\` \u2014 fetch a single order
+- \`client.listCustomers(options?)\` \u2014 list customers with filters and pagination
+- \`client.getCustomer(customerId)\` \u2014 fetch a single customer
+- \`client.listCustomCollections(options?)\` \u2014 list custom collections
+- \`client.listSmartCollections(options?)\` \u2014 list smart collections
 
 \`\`\`ts
+import type { Context } from "hono";
 import { connection } from "@squadbase/vite-server/connectors/shopify";
 
-const { accessToken, storeDomain } = connection("<connectionId>");
+const shopify = connection("<connectionId>");
 
-// Use the Shopify Admin REST API
-const res = await fetch(
-  \`https://\${storeDomain}/admin/api/2024-10/products.json\`,
-  {
-    headers: {
-      "X-Shopify-Access-Token": accessToken,
-      "Content-Type": "application/json",
-    },
-  },
-);
-const data = await res.json();
+export default async function handler(c: Context) {
+  const { status = "active", limit = 50 } = await c.req.json<{
+    status?: "active" | "draft" | "archived";
+    limit?: number;
+  }>();
+
+  const { products } = await shopify.listProducts({ status, limit });
+
+  return c.json({
+    products: products.map((p: Record<string, unknown>) => ({
+      id: p.id,
+      title: p.title,
+      status: p.status,
+      vendor: p.vendor,
+      created_at: p.created_at,
+    })),
+  });
+}
 \`\`\`
 
-### Common Endpoints (Base URL: https://{storeDomain}/admin/api/2024-10)
-- GET \`/products.json\` \u2014 List products
-- GET \`/products/{id}.json\` \u2014 Get a product
-- GET \`/orders.json\` \u2014 List orders
-- GET \`/orders/{id}.json\` \u2014 Get an order
-- GET \`/customers.json\` \u2014 List customers
-- GET \`/customers/{id}.json\` \u2014 Get a customer
-- GET \`/inventory_items.json?ids={ids}\` \u2014 List inventory items
-- GET \`/locations.json\` \u2014 List locations
-- GET \`/collects.json\` \u2014 List collects
-- GET \`/custom_collections.json\` \u2014 List custom collections
-- GET \`/smart_collections.json\` \u2014 List smart collections
-
-### Query Parameters
+### Shopify Admin REST API Reference
+
+- Base URL: \`https://{storeDomain}/admin/api/2024-10\`
+- Authentication: Custom App (Client ID + Client Secret \u2192 access token obtained per request)
+- Pagination: cursor-based via \`page_info\` query parameter (from Link header)
+- Max 250 records per page
+
+#### Common Endpoints
+- GET \`/admin/api/2024-10/products.json\` \u2014 List products
+- GET \`/admin/api/2024-10/products/{id}.json\` \u2014 Get a product
+- GET \`/admin/api/2024-10/orders.json\` \u2014 List orders
+- GET \`/admin/api/2024-10/orders/{id}.json\` \u2014 Get an order
+- GET \`/admin/api/2024-10/customers.json\` \u2014 List customers
+- GET \`/admin/api/2024-10/customers/{id}.json\` \u2014 Get a customer
+- GET \`/admin/api/2024-10/inventory_items.json?ids={ids}\` \u2014 List inventory items
+- GET \`/admin/api/2024-10/locations.json\` \u2014 List locations
+- GET \`/admin/api/2024-10/collects.json\` \u2014 List collects
+- GET \`/admin/api/2024-10/custom_collections.json\` \u2014 List custom collections
+- GET \`/admin/api/2024-10/smart_collections.json\` \u2014 List smart collections
+
+#### Common Query Parameters
 - \`limit\` \u2014 Max records per page (max 250)
 - \`page_info\` \u2014 Cursor for pagination (from Link header)
 - \`fields\` \u2014 Comma-separated list of fields to return
-- \`created_at_min\`, \`created_at_max\` \u2014 Date filters
-- \`updated_at_min\`, \`updated_at_max\` \u2014 Date filters
-- \`status\` \u2014 Filter by status (e.g., active, draft, archived for products)`,
-    ja: `### Shopify SDK\uFF08TypeScript\u30CF\u30F3\u30C9\u30E9\u30FC\uFF09
-TypeScript\u30CF\u30F3\u30C9\u30E9\u30FC\u3067Shopify\u30B3\u30CD\u30AF\u30BF\u30FC\u3092SDK\u7D4C\u7531\u3067\u4F7F\u7528\u3057\u307E\u3059\uFF1A
+- \`created_at_min\`, \`created_at_max\` \u2014 Date filters (ISO 8601)
+- \`updated_at_min\`, \`updated_at_max\` \u2014 Date filters (ISO 8601)
+- \`status\` \u2014 Filter by status (e.g., active, draft, archived for products; open, closed, cancelled, any for orders)`,
+    ja: `### \u30C4\u30FC\u30EB
+
+- \`shopify_request\`: Shopify Admin REST API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u5546\u54C1\u3001\u6CE8\u6587\u3001\u9867\u5BA2\u3001\u5728\u5EAB\u3001\u30B3\u30EC\u30AF\u30B7\u30E7\u30F3\u306A\u3069\u306E\u30AF\u30A8\u30EA\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\uFF08\u30AB\u30B9\u30BF\u30E0\u30A2\u30D7\u30EA\u306E Client ID + Client Secret\uFF09\u306F\u81EA\u52D5\u7684\u306B\u8A2D\u5B9A\u3055\u308C\u3001\u30EA\u30AF\u30A8\u30B9\u30C8\u3054\u3068\u306B\u30A2\u30AF\u30BB\u30B9\u30C8\u30FC\u30AF\u30F3\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002\`/admin/api/\` \u304B\u3089\u59CB\u307E\u308B\u30D1\u30B9\u306E\u307F\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\u3002Shopify\u306F\u30EC\u30B9\u30DD\u30F3\u30B9\u306E Link \u30D8\u30C3\u30C0\u30FC\u304B\u3089\u53D6\u5F97\u3059\u308B \`page_info\` \u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF\u306B\u3088\u308B\u30AB\u30FC\u30BD\u30EB\u30D9\u30FC\u30B9\u306E\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u3092\u4F7F\u7528\u3057\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.listProducts(options?)\` \u2014 \u30D5\u30A3\u30EB\u30BF\uFF08\u30B9\u30C6\u30FC\u30BF\u30B9\u3001\u65E5\u4ED8\u7BC4\u56F2\uFF09\u3068\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u4ED8\u304D\u3067\u5546\u54C1\u3092\u4E00\u89A7\u53D6\u5F97
+- \`client.getProduct(productId)\` \u2014 \u5358\u4E00\u5546\u54C1\u3092\u53D6\u5F97
+- \`client.listOrders(options?)\` \u2014 \u30D5\u30A3\u30EB\u30BF\uFF08\u30B9\u30C6\u30FC\u30BF\u30B9\u3001\u652F\u6255\u3044\u72B6\u6CC1\u3001\u914D\u9001\u72B6\u6CC1\u3001\u65E5\u4ED8\u7BC4\u56F2\uFF09\u4ED8\u304D\u3067\u6CE8\u6587\u3092\u4E00\u89A7\u53D6\u5F97
+- \`client.getOrder(orderId)\` \u2014 \u5358\u4E00\u6CE8\u6587\u3092\u53D6\u5F97
+- \`client.listCustomers(options?)\` \u2014 \u30D5\u30A3\u30EB\u30BF\u3068\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u4ED8\u304D\u3067\u9867\u5BA2\u3092\u4E00\u89A7\u53D6\u5F97
+- \`client.getCustomer(customerId)\` \u2014 \u5358\u4E00\u9867\u5BA2\u3092\u53D6\u5F97
+- \`client.listCustomCollections(options?)\` \u2014 \u30AB\u30B9\u30BF\u30E0\u30B3\u30EC\u30AF\u30B7\u30E7\u30F3\u3092\u4E00\u89A7\u53D6\u5F97
+- \`client.listSmartCollections(options?)\` \u2014 \u30B9\u30DE\u30FC\u30C8\u30B3\u30EC\u30AF\u30B7\u30E7\u30F3\u3092\u4E00\u89A7\u53D6\u5F97
 
 \`\`\`ts
+import type { Context } from "hono";
 import { connection } from "@squadbase/vite-server/connectors/shopify";
 
-const { accessToken, storeDomain } = connection("<connectionId>");
+const shopify = connection("<connectionId>");
 
-// Shopify Admin REST API\u3092\u4F7F\u7528
-const res = await fetch(
-  \`https://\${storeDomain}/admin/api/2024-10/products.json\`,
-  {
-    headers: {
-      "X-Shopify-Access-Token": accessToken,
-      "Content-Type": "application/json",
-    },
-  },
-);
-const data = await res.json();
+export default async function handler(c: Context) {
+  const { status = "active", limit = 50 } = await c.req.json<{
+    status?: "active" | "draft" | "archived";
+    limit?: number;
+  }>();
+
+  const { products } = await shopify.listProducts({ status, limit });
+
+  return c.json({
+    products: products.map((p: Record<string, unknown>) => ({
+      id: p.id,
+      title: p.title,
+      status: p.status,
+      vendor: p.vendor,
+      created_at: p.created_at,
+    })),
+  });
+}
 \`\`\`
 
-### \u4E3B\u8981\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\uFF08\u30D9\u30FC\u30B9URL: https://{storeDomain}/admin/api/2024-10\uFF09
-- GET \`/products.json\` \u2014 \u5546\u54C1\u4E00\u89A7
-- GET \`/products/{id}.json\` \u2014 \u5546\u54C1\u306E\u53D6\u5F97
-- GET \`/orders.json\` \u2014 \u6CE8\u6587\u4E00\u89A7
-- GET \`/orders/{id}.json\` \u2014 \u6CE8\u6587\u306E\u53D6\u5F97
-- GET \`/customers.json\` \u2014 \u9867\u5BA2\u4E00\u89A7
-- GET \`/customers/{id}.json\` \u2014 \u9867\u5BA2\u306E\u53D6\u5F97
-- GET \`/inventory_items.json?ids={ids}\` \u2014 \u5728\u5EAB\u30A2\u30A4\u30C6\u30E0\u4E00\u89A7
-- GET \`/locations.json\` \u2014 \u30ED\u30B1\u30FC\u30B7\u30E7\u30F3\u4E00\u89A7
-- GET \`/collects.json\` \u2014 \u30B3\u30EC\u30AF\u30C8\u4E00\u89A7
-- GET \`/custom_collections.json\` \u2014 \u30AB\u30B9\u30BF\u30E0\u30B3\u30EC\u30AF\u30B7\u30E7\u30F3\u4E00\u89A7
-- GET \`/smart_collections.json\` \u2014 \u30B9\u30DE\u30FC\u30C8\u30B3\u30EC\u30AF\u30B7\u30E7\u30F3\u4E00\u89A7
-
-### \u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF
+### Shopify Admin REST API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
+
+- \u30D9\u30FC\u30B9URL: \`https://{storeDomain}/admin/api/2024-10\`
+- \u8A8D\u8A3C: \u30AB\u30B9\u30BF\u30E0\u30A2\u30D7\u30EA\uFF08Client ID + Client Secret \u2192 \u30EA\u30AF\u30A8\u30B9\u30C8\u3054\u3068\u306B\u30A2\u30AF\u30BB\u30B9\u30C8\u30FC\u30AF\u30F3\u53D6\u5F97\uFF09
+- \u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3: Link \u30D8\u30C3\u30C0\u30FC\u304B\u3089\u306E \`page_info\` \u306B\u3088\u308B\u30AB\u30FC\u30BD\u30EB\u30D9\u30FC\u30B9
+- \u30DA\u30FC\u30B8\u3042\u305F\u308A\u6700\u5927250\u30EC\u30B3\u30FC\u30C9
+
+#### \u4E3B\u8981\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
+- GET \`/admin/api/2024-10/products.json\` \u2014 \u5546\u54C1\u4E00\u89A7
+- GET \`/admin/api/2024-10/products/{id}.json\` \u2014 \u5546\u54C1\u306E\u53D6\u5F97
+- GET \`/admin/api/2024-10/orders.json\` \u2014 \u6CE8\u6587\u4E00\u89A7
+- GET \`/admin/api/2024-10/orders/{id}.json\` \u2014 \u6CE8\u6587\u306E\u53D6\u5F97
+- GET \`/admin/api/2024-10/customers.json\` \u2014 \u9867\u5BA2\u4E00\u89A7
+- GET \`/admin/api/2024-10/customers/{id}.json\` \u2014 \u9867\u5BA2\u306E\u53D6\u5F97
+- GET \`/admin/api/2024-10/inventory_items.json?ids={ids}\` \u2014 \u5728\u5EAB\u30A2\u30A4\u30C6\u30E0\u4E00\u89A7
+- GET \`/admin/api/2024-10/locations.json\` \u2014 \u30ED\u30B1\u30FC\u30B7\u30E7\u30F3\u4E00\u89A7
+- GET \`/admin/api/2024-10/collects.json\` \u2014 \u30B3\u30EC\u30AF\u30C8\u4E00\u89A7
+- GET \`/admin/api/2024-10/custom_collections.json\` \u2014 \u30AB\u30B9\u30BF\u30E0\u30B3\u30EC\u30AF\u30B7\u30E7\u30F3\u4E00\u89A7
+- GET \`/admin/api/2024-10/smart_collections.json\` \u2014 \u30B9\u30DE\u30FC\u30C8\u30B3\u30EC\u30AF\u30B7\u30E7\u30F3\u4E00\u89A7
+
+#### \u4E3B\u8981\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF
 - \`limit\` \u2014 \u30DA\u30FC\u30B8\u3042\u305F\u308A\u306E\u6700\u5927\u30EC\u30B3\u30FC\u30C9\u6570\uFF08\u6700\u5927250\uFF09
 - \`page_info\` \u2014 \u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u7528\u30AB\u30FC\u30BD\u30EB\uFF08Link\u30D8\u30C3\u30C0\u30FC\u304B\u3089\u53D6\u5F97\uFF09
 - \`fields\` \u2014 \u8FD4\u5374\u3059\u308B\u30D5\u30A3\u30FC\u30EB\u30C9\u306E\u30AB\u30F3\u30DE\u533A\u5207\u308A\u30EA\u30B9\u30C8
-- \`created_at_min\`, \`created_at_max\` \u2014 \u4F5C\u6210\u65E5\u30D5\u30A3\u30EB\u30BF\u30FC
-- \`updated_at_min\`, \`updated_at_max\` \u2014 \u66F4\u65B0\u65E5\u30D5\u30A3\u30EB\u30BF\u30FC
-- \`status\` \u2014 \u30B9\u30C6\u30FC\u30BF\u30B9\u3067\u30D5\u30A3\u30EB\u30BF\u30FC\uFF08\u4F8B: \u5546\u54C1\u306E\u5834\u5408 active, draft, archived\uFF09`
+- \`created_at_min\`, \`created_at_max\` \u2014 \u4F5C\u6210\u65E5\u30D5\u30A3\u30EB\u30BF\u30FC\uFF08ISO 8601\uFF09
+- \`updated_at_min\`, \`updated_at_max\` \u2014 \u66F4\u65B0\u65E5\u30D5\u30A3\u30EB\u30BF\u30FC\uFF08ISO 8601\uFF09
+- \`status\` \u2014 \u30B9\u30C6\u30FC\u30BF\u30B9\u3067\u30D5\u30A3\u30EB\u30BF\u30FC\uFF08\u4F8B: \u5546\u54C1\u306E\u5834\u5408 active, draft, archived\u3001\u6CE8\u6587\u306E\u5834\u5408 open, closed, cancelled, any\uFF09`
   },
   tools
 });