whale-code 6.5.6 → 6.5.8

package/dist/server/handlers/analytics.test.js

@@ -0,0 +1,280 @@
+// analytics.test.ts — Tests for handleAnalytics handler (summary, by_location, detailed, by_category, product_sales, employee)
+
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { HAS_TEST_DB, getTestClient, cleanup, TEST_STORE } from "./__test-utils__/test-db.js";
+import { handleAnalytics } from "./analytics.js";
+const sb = getTestClient();
+
+/** Helper: spy on sb.rpc to intercept specific RPC calls */
+function stubRpc(rpcName, returnValue, error) {
+  const originalRpc = sb.rpc.bind(sb);
+  const current = vi.mocked(sb.rpc);
+  // If already spied, chain on to existing mock
+  if (current && typeof current.mockImplementation === "function") {
+    const prev = current.getMockImplementation();
+    current.mockImplementation((fn, params) => {
+      if (fn === rpcName) {
+        if (error) return Promise.resolve({
+          data: null,
+          error
+        });
+        return Promise.resolve({
+          data: returnValue,
+          error: null
+        });
+      }
+      if (prev) return prev(fn, params);
+      return originalRpc(fn, params);
+    });
+  } else {
+    vi.spyOn(sb, "rpc").mockImplementation((fn, params) => {
+      if (fn === rpcName) {
+        if (error) return Promise.resolve({
+          data: null,
+          error
+        });
+        return Promise.resolve({
+          data: returnValue,
+          error: null
+        });
+      }
+      return originalRpc(fn, params);
+    });
+  }
+}
+
+/** Stub multiple RPCs at once */
+function stubRpcs(stubs) {
+  const originalRpc = sb.rpc.bind(sb);
+  vi.spyOn(sb, "rpc").mockImplementation((fn, params) => {
+    if (fn in stubs) {
+      const s = stubs[fn];
+      if (s.error) return Promise.resolve({
+        data: null,
+        error: s.error
+      });
+      return Promise.resolve({
+        data: s.data ?? null,
+        error: null
+      });
+    }
+    return originalRpc(fn, params);
+  });
+}
+describe.skipIf(!HAS_TEST_DB)("handleAnalytics", () => {
+  beforeEach(() => {
+    vi.restoreAllMocks();
+  });
+  afterEach(async () => {
+    vi.restoreAllMocks();
+    await cleanup();
+  });
+
+  // ========================================================================
+  // SUMMARY
+  // ========================================================================
+
+  describe("action: summary", () => {
+    it("returns sales summary via RPC", async () => {
+      stubRpc("get_sales_analytics", {
+        total_revenue: 50000,
+        total_orders: 250,
+        avg_order_value: 200
+      });
+      const result = await handleAnalytics(sb, {
+        action: "summary"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+      expect(result.data).toBeDefined();
+      expect(result.data.total_revenue).toBe(50000);
+    });
+    it("returns error when RPC fails", async () => {
+      stubRpc("get_sales_analytics", null, {
+        message: "Analytics service unavailable"
+      });
+      const result = await handleAnalytics(sb, {
+        action: "summary"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toBe("Analytics service unavailable");
+    });
+  });
+
+  // ========================================================================
+  // BY LOCATION
+  // ========================================================================
+
+  describe("action: by_location", () => {
+    it("returns revenue grouped by location", async () => {
+      // v_daily_sales is a VIEW — stub the from() chain instead of seeding
+      const originalFrom = sb.from.bind(sb);
+      vi.spyOn(sb, "from").mockImplementation(table => {
+        if (table === "v_daily_sales") {
+          const mockResult = Promise.resolve({
+            data: [{
+              location_id: "l1",
+              sale_date: "2026-01-15",
+              net_sales: 1000,
+              order_count: 10
+            }, {
+              location_id: "l1",
+              sale_date: "2026-01-16",
+              net_sales: 1500,
+              order_count: 12
+            }, {
+              location_id: "l2",
+              sale_date: "2026-01-15",
+              net_sales: 800,
+              order_count: 8
+            }],
+            error: null
+          });
+          const chainEnd = {
+            limit: () => mockResult,
+            then: mockResult.then.bind(mockResult)
+          };
+          return {
+            select: () => ({
+              eq: () => ({
+                gte: () => ({
+                  lte: () => chainEnd
+                })
+              })
+            })
+          };
+        }
+        return originalFrom(table);
+      });
+      const result = await handleAnalytics(sb, {
+        action: "by_location"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+      expect(Array.isArray(result.data)).toBe(true);
+    });
+  });
+
+  // ========================================================================
+  // DETAILED
+  // ========================================================================
+
+  describe("action: detailed", () => {
+    it("returns daily sales rows", async () => {
+      // v_daily_sales is a VIEW — stub the from() chain instead of seeding
+      const originalFrom = sb.from.bind(sb);
+      vi.spyOn(sb, "from").mockImplementation(table => {
+        if (table === "v_daily_sales") {
+          const mockResult = Promise.resolve({
+            data: [{
+              sale_date: "2026-01-15",
+              net_sales: 2000,
+              order_count: 15
+            }, {
+              sale_date: "2026-01-16",
+              net_sales: 2500,
+              order_count: 20
+            }],
+            error: null
+          });
+          const chainEnd = {
+            limit: () => mockResult,
+            then: mockResult.then.bind(mockResult)
+          };
+          return {
+            select: () => ({
+              eq: () => ({
+                gte: () => ({
+                  lte: () => ({
+                    order: () => chainEnd
+                  })
+                })
+              })
+            })
+          };
+        }
+        return originalFrom(table);
+      });
+      const result = await handleAnalytics(sb, {
+        action: "detailed"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+      expect(Array.isArray(result.data)).toBe(true);
+    });
+  });
+
+  // ========================================================================
+  // BY CATEGORY
+  // ========================================================================
+
+  describe("action: by_category", () => {
+    it("returns category performance via RPC", async () => {
+      stubRpc("get_category_performance", [{
+        category_id: "cat-1",
+        category_name: "Edibles",
+        order_count: 50,
+        total_revenue: 5000,
+        revenue_share: 0.45
+      }, {
+        category_id: "cat-2",
+        category_name: "Flower",
+        order_count: 80,
+        total_revenue: 6000,
+        revenue_share: 0.55
+      }]);
+      const result = await handleAnalytics(sb, {
+        action: "by_category"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+      expect(result.data.categories).toHaveLength(2);
+      expect(result.data.days).toBe(30); // default
+    });
+    it("uses custom days_back", async () => {
+      stubRpc("get_category_performance", []);
+      const result = await handleAnalytics(sb, {
+        action: "by_category",
+        days_back: 7
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+      expect(result.data.days).toBe(7);
+    });
+  });
+
+  // ========================================================================
+  // PRODUCT SALES
+  // ========================================================================
+
+  describe("action: product_sales", () => {
+    it("returns product velocity data", async () => {
+      stubRpc("get_product_velocity", [{
+        product_id: "p1",
+        product_name: "Widget",
+        units_sold: 100,
+        revenue: 5000,
+        daily_velocity: 3.3
+      }]);
+      const result = await handleAnalytics(sb, {
+        action: "product_sales"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+      expect(result.data.products).toHaveLength(1);
+      expect(result.data.products[0].name).toBe("Widget");
+    });
+  });
+
+  // ========================================================================
+  // EMPLOYEE
+  // ========================================================================
+
+  describe("action: employee", () => {
+    it("returns employee analytics via RPC", async () => {
+      stubRpc("employee_analytics", [{
+        employee_name: "Alice",
+        total_sales: 15000,
+        order_count: 75
+      }]);
+      const result = await handleAnalytics(sb, {
+        action: "employee"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+    });
+  });
+});

package/dist/server/handlers/api-docs-examples-ext.d.ts

@@ -0,0 +1,9 @@
+import type { ExampleSet } from "./api-docs-examples.js";
+export declare const ordersExamples: ExampleSet;
+export declare const customersExamples: ExampleSet;
+export declare const inventoryExamples: ExampleSet;
+export declare const analyticsExamples: ExampleSet;
+export declare const locationsExamples: ExampleSet;
+export declare const storefrontExamples: ExampleSet;
+export declare const coaExamples: ExampleSet;
+export declare const portalExamples: ExampleSet;

package/dist/server/handlers/api-docs-examples-ext.js

@@ -0,0 +1,278 @@
+// api-docs-examples-ext.ts — Code examples for orders, customers, inventory,
+// analytics, locations, storefront, COA, portal. Extracted from api-docs.ts.
+
+const BASE = "https://whale-gateway.fly.dev";
+const SV = "${STORE_ID}";
+const KV = "${API_KEY}";
+export const ordersExamples = {
+  raw_fetch: `// List orders
+const { data: orders } = await fetch("${BASE}/v1/stores/${SV}/orders?limit=25", {
+  headers: { "x-api-key": "${KV}" }
+}).then(r => r.json());
+
+// Get order details
+const order = await fetch("${BASE}/v1/stores/${SV}/orders/\${orderId}", {
+  headers: { "x-api-key": "${KV}" }
+}).then(r => r.json());
+
+// Update order status
+await fetch("${BASE}/v1/stores/${SV}/orders/\${orderId}", {
+  method: "PATCH",
+  headers: { "x-api-key": "${KV}", "Content-Type": "application/json" },
+  body: JSON.stringify({ status: "shipped" })
+});`,
+  nextjs_ssr: `// app/orders/page.tsx (Server Component)
+async function getOrders() {
+  const res = await fetch(
+    \`${BASE}/v1/stores/\${process.env.WHALE_STORE_ID}/orders?limit=50\`,
+    { headers: { "x-api-key": process.env.WHALE_API_KEY! }, next: { revalidate: 30 } }
+  );
+  return res.json();
+}
+
+export default async function OrdersPage() {
+  const { data: orders } = await getOrders();
+  return (
+    <table>
+      <thead><tr><th>Order</th><th>Status</th><th>Total</th><th>Date</th></tr></thead>
+      <tbody>
+        {orders.map((o: any) => (
+          <tr key={o.id}>
+            <td><a href={\`/orders/\${o.id}\`}>{o.order_number}</a></td>
+            <td>{o.status}</td>
+            <td>\${o.total}</td>
+            <td>{new Date(o.created_at).toLocaleDateString()}</td>
+          </tr>
+        ))}
+      </tbody>
+    </table>
+  );
+}`,
+  react_client: `// hooks/useOrders.ts
+import useSWR from "swr";
+
+const fetcher = (url: string) => fetch(url).then(r => r.json());
+
+export function useOrders() {
+  const { data, error, isLoading } = useSWR("/api/orders", fetcher);
+  return { orders: data?.data ?? [], error, isLoading };
+}`
+};
+export const customersExamples = {
+  raw_fetch: `// Search customers
+const { data: customers } = await fetch("${BASE}/v1/stores/${SV}/customers?search=john", {
+  headers: { "x-api-key": "${KV}" }
+}).then(r => r.json());
+
+// Create customer
+const customer = await fetch("${BASE}/v1/stores/${SV}/customers", {
+  method: "POST",
+  headers: { "x-api-key": "${KV}", "Content-Type": "application/json" },
+  body: JSON.stringify({ first_name: "John", last_name: "Doe", email: "john@example.com" })
+}).then(r => r.json());`,
+  nextjs_ssr: `// app/api/customers/route.ts
+import { NextRequest, NextResponse } from "next/server";
+const headers = { "x-api-key": process.env.WHALE_API_KEY! };
+const base = \`${BASE}/v1/stores/\${process.env.WHALE_STORE_ID}\`;
+
+export async function GET(req: NextRequest) {
+  const search = req.nextUrl.searchParams.get("q") || "";
+  const res = await fetch(\`\${base}/customers?search=\${encodeURIComponent(search)}\`, { headers });
+  return NextResponse.json(await res.json());
+}`,
+  react_client: `// hooks/useCustomers.ts
+import useSWR from "swr";
+export function useCustomers(search: string) {
+  const { data, isLoading } = useSWR(
+    search ? \`/api/customers?q=\${encodeURIComponent(search)}\` : null,
+    (url) => fetch(url).then(r => r.json())
+  );
+  return { customers: data?.data ?? [], isLoading };
+}`
+};
+export const inventoryExamples = {
+  raw_fetch: `// Get inventory summary
+const summary = await fetch("${BASE}/v1/stores/${SV}/inventory/summary", {
+  headers: { "x-api-key": "${KV}" }
+}).then(r => r.json());
+
+// Adjust stock
+await fetch("${BASE}/v1/stores/${SV}/inventory/adjust", {
+  method: "POST",
+  headers: { "x-api-key": "${KV}", "Content-Type": "application/json" },
+  body: JSON.stringify({ product_id: "...", location_id: "...", adjustment: -5, reason: "Sold offline" })
+});`,
+  nextjs_ssr: `// app/inventory/page.tsx
+async function getInventory() {
+  const res = await fetch(
+    \`${BASE}/v1/stores/\${process.env.WHALE_STORE_ID}/inventory/summary\`,
+    { headers: { "x-api-key": process.env.WHALE_API_KEY! }, next: { revalidate: 60 } }
+  );
+  return res.json();
+}
+export default async function InventoryPage() {
+  const summary = await getInventory();
+  return (<div>{summary.locations.map((loc: any) => (
+    <div key={loc.id}><h3>{loc.name}</h3><p>{loc.total_products} products, {loc.total_units} units</p></div>
+  ))}</div>);
+}`,
+  react_client: `// hooks/useInventory.ts
+import useSWR from "swr";
+export function useInventorySummary() {
+  const { data, isLoading } = useSWR("/api/inventory/summary", (url) => fetch(url).then(r => r.json()));
+  return { summary: data, isLoading };
+}`
+};
+export const analyticsExamples = {
+  raw_fetch: `// Sales analytics
+const sales = await fetch("${BASE}/v1/stores/${SV}/analytics/sales?period=last_30", {
+  headers: { "x-api-key": "${KV}" }
+}).then(r => r.json());
+// Daily breakdown
+const daily = await fetch("${BASE}/v1/stores/${SV}/analytics/sales/daily?period=last_7", {
+  headers: { "x-api-key": "${KV}" }
+}).then(r => r.json());
+// Product performance
+const topProducts = await fetch("${BASE}/v1/stores/${SV}/analytics/products?limit=10", {
+  headers: { "x-api-key": "${KV}" }
+}).then(r => r.json());`,
+  nextjs_ssr: `// app/dashboard/page.tsx
+async function getDashboard() {
+  const base = \`${BASE}/v1/stores/\${process.env.WHALE_STORE_ID}/analytics\`;
+  const headers = { "x-api-key": process.env.WHALE_API_KEY! };
+  const opts = { headers, next: { revalidate: 300 } as any };
+  const [sales, daily, products] = await Promise.all([
+    fetch(\`\${base}/sales?period=last_30\`, opts).then(r => r.json()),
+    fetch(\`\${base}/sales/daily?period=last_7\`, opts).then(r => r.json()),
+    fetch(\`\${base}/products?limit=5\`, opts).then(r => r.json()),
+  ]);
+  return { sales, daily, products };
+}
+export default async function DashboardPage() {
+  const { sales } = await getDashboard();
+  return (<div><h1>Dashboard</h1><div>Revenue: \${sales.total_revenue}, Orders: {sales.total_orders}</div></div>);
+}`,
+  react_client: `// hooks/useAnalytics.ts
+import useSWR from "swr";
+export function useSalesAnalytics(period = "last_30") {
+  const { data, isLoading } = useSWR(\`/api/analytics/sales?period=\${period}\`, (url) => fetch(url).then(r => r.json()));
+  return { sales: data, isLoading };
+}`
+};
+export const locationsExamples = {
+  raw_fetch: `// List all locations
+const { data: locations } = await fetch("${BASE}/v1/stores/${SV}/locations", {
+  headers: { "x-api-key": "${KV}" }
+}).then(r => r.json());`,
+  nextjs_ssr: `// lib/api.ts — shared helper
+export async function getLocations() {
+  const res = await fetch(\`${BASE}/v1/stores/\${process.env.WHALE_STORE_ID}/locations\`,
+    { headers: { "x-api-key": process.env.WHALE_API_KEY! }, next: { revalidate: 3600 } });
+  return res.json().then(r => r.data);
+}`,
+  react_client: `// hooks/useLocations.ts
+import useSWR from "swr";
+export function useLocations() {
+  const { data } = useSWR("/api/locations", (url) => fetch(url).then(r => r.json()));
+  return data?.data ?? [];
+}`
+};
+export const storefrontExamples = {
+  raw_fetch: `// Track page view event
+await fetch("${BASE}/v1/stores/${SV}/storefront/events", {
+  method: "POST",
+  headers: { "x-api-key": "${KV}", "Content-Type": "application/json" },
+  body: JSON.stringify({ session_id: sessionId, event_type: "page_view", event_data: { url: "/products/blue-dream" } })
+});
+// Send OTP for customer login
+await fetch("${BASE}/v1/stores/${SV}/storefront/auth/send-code", {
+  method: "POST",
+  headers: { "x-api-key": "${KV}", "Content-Type": "application/json" },
+  body: JSON.stringify({ email: "customer@example.com" })
+});`,
+  nextjs_ssr: `// app/api/auth/send-code/route.ts
+import { NextRequest, NextResponse } from "next/server";
+export async function POST(req: NextRequest) {
+  const { email } = await req.json();
+  const res = await fetch(\`${BASE}/v1/stores/\${process.env.WHALE_STORE_ID}/storefront/auth/send-code\`, {
+    method: "POST",
+    headers: { "x-api-key": process.env.WHALE_API_KEY!, "Content-Type": "application/json" },
+    body: JSON.stringify({ email }),
+  });
+  return NextResponse.json(await res.json(), { status: res.status });
+}`,
+  react_client: `// hooks/useAuth.ts
+import { useState } from "react";
+export function useStorefrontAuth() {
+  const [loading, setLoading] = useState(false);
+  const sendCode = async (email: string) => {
+    setLoading(true);
+    await fetch("/api/auth/send-code", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ email }) });
+    setLoading(false);
+  };
+  return { sendCode, loading };
+}`
+};
+export const coaExamples = {
+  raw_fetch: `// List COAs
+const { data: coas } = await fetch("${BASE}/v1/stores/${SV}/coa?limit=50", {
+  headers: { "x-api-key": "${KV}" }
+}).then(r => r.json());
+// Verify by sample ID
+const verified = await fetch("${BASE}/v1/stores/${SV}/coa/verify?sample_id=LAB-2026-001", {
+  headers: { "x-api-key": "${KV}" }
+}).then(r => r.json());`,
+  nextjs_ssr: `// app/products/[id]/coa/page.tsx
+async function getCOAEmbed(coaId: string) {
+  const res = await fetch(\`${BASE}/v1/stores/\${process.env.WHALE_STORE_ID}/coa/\${coaId}/embed\`,
+    { headers: { "x-api-key": process.env.WHALE_API_KEY! }, next: { revalidate: 3600 } });
+  return res.json();
+}
+export default async function COAPage({ params }: { params: { id: string } }) {
+  const { html, data } = await getCOAEmbed(params.id);
+  return (<div><h1>Certificate of Analysis — {data.product_name}</h1><div dangerouslySetInnerHTML={{ __html: html }} /></div>);
+}`,
+  react_client: `// components/COAViewer.tsx
+"use client";
+import { useEffect, useState } from "react";
+export function COAViewer({ coaId }: { coaId: string }) {
+  const [html, setHtml] = useState("");
+  useEffect(() => { fetch(\`/api/coa/\${coaId}/embed\`).then(r => r.json()).then(d => setHtml(d.html)); }, [coaId]);
+  return <div dangerouslySetInnerHTML={{ __html: html }} />;
+}`
+};
+export const portalExamples = {
+  raw_fetch: `// B2B portal login
+await fetch("${BASE}/v1/stores/${SV}/portal/auth/send-code", {
+  method: "POST",
+  headers: { "x-api-key": "${KV}", "Content-Type": "application/json" },
+  body: JSON.stringify({ email: "buyer@dispensary.com" })
+});
+// Verify and get session
+const session = await fetch("${BASE}/v1/stores/${SV}/portal/auth/verify", {
+  method: "POST",
+  headers: { "x-api-key": "${KV}", "Content-Type": "application/json" },
+  body: JSON.stringify({ email: "buyer@dispensary.com", code: "123456" })
+}).then(r => r.json());`,
+  nextjs_ssr: `// app/portal/layout.tsx — server-side session check
+import { cookies } from "next/headers";
+import { redirect } from "next/navigation";
+export default async function PortalLayout({ children }: { children: React.ReactNode }) {
+  const token = cookies().get("portal_token")?.value;
+  if (!token) redirect("/portal/login");
+  return <div className="portal-layout">{children}</div>;
+}`,
+  react_client: `// hooks/usePortal.ts
+import { useState } from "react";
+export function usePortal() {
+  const [token, setToken] = useState<string | null>(null);
+  const login = async (email: string, code: string) => {
+    const res = await fetch("/api/portal/verify", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ email, code }) });
+    const data = await res.json();
+    setToken(data.token);
+    return data;
+  };
+  return { token, login };
+}`
+};
+//# sourceMappingURL=api-docs-examples-ext.js.map

package/dist/server/handlers/api-docs-examples-ext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-docs-examples-ext.js","names":["BASE","SV","KV","ordersExamples","raw_fetch","nextjs_ssr","react_client","customersExamples","inventoryExamples","analyticsExamples","locationsExamples","storefrontExamples","coaExamples","portalExamples"],"sources":["../../../src/server/handlers/api-docs-examples-ext.ts"],"sourcesContent":["// api-docs-examples-ext.ts — Code examples for orders, customers, inventory,\n// analytics, locations, storefront, COA, portal. Extracted from api-docs.ts.\nimport type { ExampleSet } from \"./api-docs-examples.js\";\n\nconst BASE = \"https://whale-gateway.fly.dev\";\nconst SV = \"${STORE_ID}\";\nconst KV = \"${API_KEY}\";\n\nexport const ordersExamples: ExampleSet = {\n  raw_fetch: `// List orders\nconst { data: orders } = await fetch(\"${BASE}/v1/stores/${SV}/orders?limit=25\", {\n  headers: { \"x-api-key\": \"${KV}\" }\n}).then(r => r.json());\n\n// Get order details\nconst order = await fetch(\"${BASE}/v1/stores/${SV}/orders/\\${orderId}\", {\n  headers: { \"x-api-key\": \"${KV}\" }\n}).then(r => r.json());\n\n// Update order status\nawait fetch(\"${BASE}/v1/stores/${SV}/orders/\\${orderId}\", {\n  method: \"PATCH\",\n  headers: { \"x-api-key\": \"${KV}\", \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({ status: \"shipped\" })\n});`,\n\n  nextjs_ssr: `// app/orders/page.tsx (Server Component)\nasync function getOrders() {\n  const res = await fetch(\n    \\`${BASE}/v1/stores/\\${process.env.WHALE_STORE_ID}/orders?limit=50\\`,\n    { headers: { \"x-api-key\": process.env.WHALE_API_KEY! }, next: { revalidate: 30 } }\n  );\n  return res.json();\n}\n\nexport default async function OrdersPage() {\n  const { data: orders } = await getOrders();\n  return (\n    <table>\n      <thead><tr><th>Order</th><th>Status</th><th>Total</th><th>Date</th></tr></thead>\n      <tbody>\n        {orders.map((o: any) => (\n          <tr key={o.id}>\n            <td><a href={\\`/orders/\\${o.id}\\`}>{o.order_number}</a></td>\n            <td>{o.status}</td>\n            <td>\\${o.total}</td>\n            <td>{new Date(o.created_at).toLocaleDateString()}</td>\n          </tr>\n        ))}\n      </tbody>\n    </table>\n  );\n}`,\n\n  react_client: `// hooks/useOrders.ts\nimport useSWR from \"swr\";\n\nconst fetcher = (url: string) => fetch(url).then(r => r.json());\n\nexport function useOrders() {\n  const { data, error, isLoading } = useSWR(\"/api/orders\", fetcher);\n  return { orders: data?.data ?? [], error, isLoading };\n}`,\n};\nexport const customersExamples: ExampleSet = {\n  raw_fetch: `// Search customers\nconst { data: customers } = await fetch(\"${BASE}/v1/stores/${SV}/customers?search=john\", {\n  headers: { \"x-api-key\": \"${KV}\" }\n}).then(r => r.json());\n\n// Create customer\nconst customer = await fetch(\"${BASE}/v1/stores/${SV}/customers\", {\n  method: \"POST\",\n  headers: { \"x-api-key\": \"${KV}\", \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({ first_name: \"John\", last_name: \"Doe\", email: \"john@example.com\" })\n}).then(r => r.json());`,\n\n  nextjs_ssr: `// app/api/customers/route.ts\nimport { NextRequest, NextResponse } from \"next/server\";\nconst headers = { \"x-api-key\": process.env.WHALE_API_KEY! };\nconst base = \\`${BASE}/v1/stores/\\${process.env.WHALE_STORE_ID}\\`;\n\nexport async function GET(req: NextRequest) {\n  const search = req.nextUrl.searchParams.get(\"q\") || \"\";\n  const res = await fetch(\\`\\${base}/customers?search=\\${encodeURIComponent(search)}\\`, { headers });\n  return NextResponse.json(await res.json());\n}`,\n\n  react_client: `// hooks/useCustomers.ts\nimport useSWR from \"swr\";\nexport function useCustomers(search: string) {\n  const { data, isLoading } = useSWR(\n    search ? \\`/api/customers?q=\\${encodeURIComponent(search)}\\` : null,\n    (url) => fetch(url).then(r => r.json())\n  );\n  return { customers: data?.data ?? [], isLoading };\n}`,\n};\nexport const inventoryExamples: ExampleSet = {\n  raw_fetch: `// Get inventory summary\nconst summary = await fetch(\"${BASE}/v1/stores/${SV}/inventory/summary\", {\n  headers: { \"x-api-key\": \"${KV}\" }\n}).then(r => r.json());\n\n// Adjust stock\nawait fetch(\"${BASE}/v1/stores/${SV}/inventory/adjust\", {\n  method: \"POST\",\n  headers: { \"x-api-key\": \"${KV}\", \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({ product_id: \"...\", location_id: \"...\", adjustment: -5, reason: \"Sold offline\" })\n});`,\n\n  nextjs_ssr: `// app/inventory/page.tsx\nasync function getInventory() {\n  const res = await fetch(\n    \\`${BASE}/v1/stores/\\${process.env.WHALE_STORE_ID}/inventory/summary\\`,\n    { headers: { \"x-api-key\": process.env.WHALE_API_KEY! }, next: { revalidate: 60 } }\n  );\n  return res.json();\n}\nexport default async function InventoryPage() {\n  const summary = await getInventory();\n  return (<div>{summary.locations.map((loc: any) => (\n    <div key={loc.id}><h3>{loc.name}</h3><p>{loc.total_products} products, {loc.total_units} units</p></div>\n  ))}</div>);\n}`,\n\n  react_client: `// hooks/useInventory.ts\nimport useSWR from \"swr\";\nexport function useInventorySummary() {\n  const { data, isLoading } = useSWR(\"/api/inventory/summary\", (url) => fetch(url).then(r => r.json()));\n  return { summary: data, isLoading };\n}`,\n};\n\nexport const analyticsExamples: ExampleSet = {\n  raw_fetch: `// Sales analytics\nconst sales = await fetch(\"${BASE}/v1/stores/${SV}/analytics/sales?period=last_30\", {\n  headers: { \"x-api-key\": \"${KV}\" }\n}).then(r => r.json());\n// Daily breakdown\nconst daily = await fetch(\"${BASE}/v1/stores/${SV}/analytics/sales/daily?period=last_7\", {\n  headers: { \"x-api-key\": \"${KV}\" }\n}).then(r => r.json());\n// Product performance\nconst topProducts = await fetch(\"${BASE}/v1/stores/${SV}/analytics/products?limit=10\", {\n  headers: { \"x-api-key\": \"${KV}\" }\n}).then(r => r.json());`,\n\n  nextjs_ssr: `// app/dashboard/page.tsx\nasync function getDashboard() {\n  const base = \\`${BASE}/v1/stores/\\${process.env.WHALE_STORE_ID}/analytics\\`;\n  const headers = { \"x-api-key\": process.env.WHALE_API_KEY! };\n  const opts = { headers, next: { revalidate: 300 } as any };\n  const [sales, daily, products] = await Promise.all([\n    fetch(\\`\\${base}/sales?period=last_30\\`, opts).then(r => r.json()),\n    fetch(\\`\\${base}/sales/daily?period=last_7\\`, opts).then(r => r.json()),\n    fetch(\\`\\${base}/products?limit=5\\`, opts).then(r => r.json()),\n  ]);\n  return { sales, daily, products };\n}\nexport default async function DashboardPage() {\n  const { sales } = await getDashboard();\n  return (<div><h1>Dashboard</h1><div>Revenue: \\${sales.total_revenue}, Orders: {sales.total_orders}</div></div>);\n}`,\n\n  react_client: `// hooks/useAnalytics.ts\nimport useSWR from \"swr\";\nexport function useSalesAnalytics(period = \"last_30\") {\n  const { data, isLoading } = useSWR(\\`/api/analytics/sales?period=\\${period}\\`, (url) => fetch(url).then(r => r.json()));\n  return { sales: data, isLoading };\n}`,\n};\n\nexport const locationsExamples: ExampleSet = {\n  raw_fetch: `// List all locations\nconst { data: locations } = await fetch(\"${BASE}/v1/stores/${SV}/locations\", {\n  headers: { \"x-api-key\": \"${KV}\" }\n}).then(r => r.json());`,\n\n  nextjs_ssr: `// lib/api.ts — shared helper\nexport async function getLocations() {\n  const res = await fetch(\\`${BASE}/v1/stores/\\${process.env.WHALE_STORE_ID}/locations\\`,\n    { headers: { \"x-api-key\": process.env.WHALE_API_KEY! }, next: { revalidate: 3600 } });\n  return res.json().then(r => r.data);\n}`,\n\n  react_client: `// hooks/useLocations.ts\nimport useSWR from \"swr\";\nexport function useLocations() {\n  const { data } = useSWR(\"/api/locations\", (url) => fetch(url).then(r => r.json()));\n  return data?.data ?? [];\n}`,\n};\n\nexport const storefrontExamples: ExampleSet = {\n  raw_fetch: `// Track page view event\nawait fetch(\"${BASE}/v1/stores/${SV}/storefront/events\", {\n  method: \"POST\",\n  headers: { \"x-api-key\": \"${KV}\", \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({ session_id: sessionId, event_type: \"page_view\", event_data: { url: \"/products/blue-dream\" } })\n});\n// Send OTP for customer login\nawait fetch(\"${BASE}/v1/stores/${SV}/storefront/auth/send-code\", {\n  method: \"POST\",\n  headers: { \"x-api-key\": \"${KV}\", \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({ email: \"customer@example.com\" })\n});`,\n\n  nextjs_ssr: `// app/api/auth/send-code/route.ts\nimport { NextRequest, NextResponse } from \"next/server\";\nexport async function POST(req: NextRequest) {\n  const { email } = await req.json();\n  const res = await fetch(\\`${BASE}/v1/stores/\\${process.env.WHALE_STORE_ID}/storefront/auth/send-code\\`, {\n    method: \"POST\",\n    headers: { \"x-api-key\": process.env.WHALE_API_KEY!, \"Content-Type\": \"application/json\" },\n    body: JSON.stringify({ email }),\n  });\n  return NextResponse.json(await res.json(), { status: res.status });\n}`,\n\n  react_client: `// hooks/useAuth.ts\nimport { useState } from \"react\";\nexport function useStorefrontAuth() {\n  const [loading, setLoading] = useState(false);\n  const sendCode = async (email: string) => {\n    setLoading(true);\n    await fetch(\"/api/auth/send-code\", { method: \"POST\", headers: { \"Content-Type\": \"application/json\" }, body: JSON.stringify({ email }) });\n    setLoading(false);\n  };\n  return { sendCode, loading };\n}`,\n};\n\nexport const coaExamples: ExampleSet = {\n  raw_fetch: `// List COAs\nconst { data: coas } = await fetch(\"${BASE}/v1/stores/${SV}/coa?limit=50\", {\n  headers: { \"x-api-key\": \"${KV}\" }\n}).then(r => r.json());\n// Verify by sample ID\nconst verified = await fetch(\"${BASE}/v1/stores/${SV}/coa/verify?sample_id=LAB-2026-001\", {\n  headers: { \"x-api-key\": \"${KV}\" }\n}).then(r => r.json());`,\n\n  nextjs_ssr: `// app/products/[id]/coa/page.tsx\nasync function getCOAEmbed(coaId: string) {\n  const res = await fetch(\\`${BASE}/v1/stores/\\${process.env.WHALE_STORE_ID}/coa/\\${coaId}/embed\\`,\n    { headers: { \"x-api-key\": process.env.WHALE_API_KEY! }, next: { revalidate: 3600 } });\n  return res.json();\n}\nexport default async function COAPage({ params }: { params: { id: string } }) {\n  const { html, data } = await getCOAEmbed(params.id);\n  return (<div><h1>Certificate of Analysis — {data.product_name}</h1><div dangerouslySetInnerHTML={{ __html: html }} /></div>);\n}`,\n\n  react_client: `// components/COAViewer.tsx\n\"use client\";\nimport { useEffect, useState } from \"react\";\nexport function COAViewer({ coaId }: { coaId: string }) {\n  const [html, setHtml] = useState(\"\");\n  useEffect(() => { fetch(\\`/api/coa/\\${coaId}/embed\\`).then(r => r.json()).then(d => setHtml(d.html)); }, [coaId]);\n  return <div dangerouslySetInnerHTML={{ __html: html }} />;\n}`,\n};\n\nexport const portalExamples: ExampleSet = {\n  raw_fetch: `// B2B portal login\nawait fetch(\"${BASE}/v1/stores/${SV}/portal/auth/send-code\", {\n  method: \"POST\",\n  headers: { \"x-api-key\": \"${KV}\", \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({ email: \"buyer@dispensary.com\" })\n});\n// Verify and get session\nconst session = await fetch(\"${BASE}/v1/stores/${SV}/portal/auth/verify\", {\n  method: \"POST\",\n  headers: { \"x-api-key\": \"${KV}\", \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({ email: \"buyer@dispensary.com\", code: \"123456\" })\n}).then(r => r.json());`,\n\n  nextjs_ssr: `// app/portal/layout.tsx — server-side session check\nimport { cookies } from \"next/headers\";\nimport { redirect } from \"next/navigation\";\nexport default async function PortalLayout({ children }: { children: React.ReactNode }) {\n  const token = cookies().get(\"portal_token\")?.value;\n  if (!token) redirect(\"/portal/login\");\n  return <div className=\"portal-layout\">{children}</div>;\n}`,\n\n  react_client: `// hooks/usePortal.ts\nimport { useState } from \"react\";\nexport function usePortal() {\n  const [token, setToken] = useState<string | null>(null);\n  const login = async (email: string, code: string) => {\n    const res = await fetch(\"/api/portal/verify\", { method: \"POST\", headers: { \"Content-Type\": \"application/json\" }, body: JSON.stringify({ email, code }) });\n    const data = await res.json();\n    setToken(data.token);\n    return data;\n  };\n  return { token, login };\n}`,\n};\n"],"mappings":"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","ignoreList":[]}

package/dist/server/handlers/api-docs-examples.d.ts

@@ -0,0 +1,8 @@
+export type ExampleSet = {
+    raw_fetch: string;
+    nextjs_ssr: string;
+    react_client: string;
+};
+export declare const productsExamples: ExampleSet;
+export declare const cartExamples: ExampleSet;
+export declare const checkoutExamples: ExampleSet;