whale-code 6.5.10 → 6.6.0

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

@@ -1,278 +0,0 @@
-// 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

@@ -1 +0,0 @@
-{"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

@@ -1,8 +0,0 @@
-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;

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

@@ -1,221 +0,0 @@
-// api-docs-examples.ts — Code examples for products, cart, checkout
-// Extracted from api-docs.ts for file size management.
-
-const BASE = "https://whale-gateway.fly.dev";
-const SV = "${STORE_ID}";
-const KV = "${API_KEY}";
-export const productsExamples = {
-  raw_fetch: `// List products
-const res = await fetch("${BASE}/v1/stores/${SV}/products?limit=25&status=published", {
-  headers: { "x-api-key": "${KV}" }
-});
-const { data: products, has_more } = await res.json();
-
-// Get single product
-const product = await fetch("${BASE}/v1/stores/${SV}/products/\${productId}", {
-  headers: { "x-api-key": "${KV}" }
-}).then(r => r.json());`,
-  nextjs_ssr: `// app/products/page.tsx (Next.js App Router — Server Component)
-const API_KEY = process.env.WHALE_API_KEY!;
-const STORE_ID = process.env.WHALE_STORE_ID!;
-const BASE = "${BASE}";
-
-async function getProducts(page?: string) {
-  const params = new URLSearchParams({ limit: "25", status: "published" });
-  if (page) params.set("starting_after", page);
-
-  const res = await fetch(\`\${BASE}/v1/stores/\${STORE_ID}/products?\${params}\`, {
-    headers: { "x-api-key": API_KEY },
-    next: { revalidate: 60 }, // ISR: revalidate every 60s
-  });
-
-  if (!res.ok) throw new Error("Failed to fetch products");
-  return res.json();
-}
-
-export default async function ProductsPage({ searchParams }: { searchParams: { after?: string } }) {
-  const { data: products, has_more } = await getProducts(searchParams.after);
-
-  return (
-    <div className="grid grid-cols-3 gap-4">
-      {products.map((p: any) => (
-        <div key={p.id} className="border rounded p-4">
-          {p.featured_image && <img src={p.featured_image} alt={p.name} />}
-          <h2>{p.name}</h2>
-          <p>{p.pricing_data?.tiers?.[0]?.price ? \`$\${p.pricing_data.tiers[0].price}\` : "Contact for pricing"}</p>
-        </div>
-      ))}
-      {has_more && <a href={\`?after=\${products.at(-1)?.id}\`}>Next page →</a>}
-    </div>
-  );
-}`,
-  react_client: `// hooks/useProducts.ts (React client-side)
-import { useState, useEffect } from "react";
-
-const BASE = "${BASE}";
-
-export function useProducts(storeId: string, apiKey: string) {
-  const [products, setProducts] = useState([]);
-  const [loading, setLoading] = useState(true);
-
-  useEffect(() => {
-    fetch(\`\${BASE}/v1/stores/\${storeId}/products?status=published&limit=50\`, {
-      headers: { "x-api-key": apiKey },
-    })
-      .then(r => r.json())
-      .then(({ data }) => setProducts(data))
-      .finally(() => setLoading(false));
-  }, [storeId, apiKey]);
-
-  return { products, loading };
-}`
-};
-export const cartExamples = {
-  raw_fetch: `// Create cart
-const cart = await fetch("${BASE}/v1/stores/${SV}/cart", {
-  method: "POST",
-  headers: { "x-api-key": "${KV}", "Content-Type": "application/json" },
-  body: JSON.stringify({ customer_id: customerId })
-}).then(r => r.json());
-
-// Add item
-await fetch("${BASE}/v1/stores/${SV}/cart/\${cart.id}/items", {
-  method: "POST",
-  headers: { "x-api-key": "${KV}", "Content-Type": "application/json" },
-  body: JSON.stringify({ product_id: "...", quantity: 2 })
-}).then(r => r.json());
-
-// View cart
-const fullCart = await fetch("${BASE}/v1/stores/${SV}/cart/\${cart.id}", {
-  headers: { "x-api-key": "${KV}" }
-}).then(r => r.json());`,
-  nextjs_ssr: `// app/api/cart/route.ts (Next.js Route Handler — server-side proxy)
-import { NextRequest, NextResponse } from "next/server";
-
-const API_KEY = process.env.WHALE_API_KEY!;
-const STORE_ID = process.env.WHALE_STORE_ID!;
-const BASE = "${BASE}";
-
-export async function POST(req: NextRequest) {
-  const body = await req.json();
-  const res = await fetch(\`\${BASE}/v1/stores/\${STORE_ID}/cart\`, {
-    method: "POST",
-    headers: { "x-api-key": API_KEY, "Content-Type": "application/json" },
-    body: JSON.stringify(body),
-  });
-  return NextResponse.json(await res.json());
-}`,
-  react_client: `// hooks/useCart.ts
-import { useState, useCallback } from "react";
-
-export function useCart(storeId: string, apiKey: string) {
-  const [cart, setCart] = useState<any>(null);
-  const BASE = "${BASE}";
-  const headers = { "x-api-key": apiKey, "Content-Type": "application/json" };
-
-  const createCart = useCallback(async () => {
-    const res = await fetch(\`\${BASE}/v1/stores/\${storeId}/cart\`, {
-      method: "POST", headers,
-    });
-    const data = await res.json();
-    setCart(data);
-    return data;
-  }, [storeId]);
-
-  const addItem = useCallback(async (productId: string, quantity: number) => {
-    if (!cart) return;
-    const res = await fetch(\`\${BASE}/v1/stores/\${storeId}/cart/\${cart.id}/items\`, {
-      method: "POST", headers,
-      body: JSON.stringify({ product_id: productId, quantity }),
-    });
-    const data = await res.json();
-    setCart(data);
-    return data;
-  }, [storeId, cart]);
-
-  const removeItem = useCallback(async (itemId: string) => {
-    if (!cart) return;
-    const res = await fetch(\`\${BASE}/v1/stores/\${storeId}/cart/\${cart.id}/items/\${itemId}\`, {
-      method: "DELETE", headers,
-    });
-    const data = await res.json();
-    setCart(data);
-    return data;
-  }, [storeId, cart]);
-
-  return { cart, createCart, addItem, removeItem };
-}`
-};
-export const checkoutExamples = {
-  raw_fetch: `// E-commerce checkout (convert cart to order)
-const order = await fetch("${BASE}/v1/stores/${SV}/checkout", {
-  method: "POST",
-  headers: { "x-api-key": "${KV}", "Content-Type": "application/json" },
-  body: JSON.stringify({
-    cart_id: cartId,
-    payment_method: "card",
-    shipping_address: { street: "123 Main St", city: "Charlotte", state: "NC", zip: "28202" }
-  })
-}).then(r => r.json());
-
-// POS payment intent flow
-const intent = await fetch("${BASE}/v1/stores/${SV}/checkout/intents", {
-  method: "POST",
-  headers: { "x-api-key": "${KV}", "Content-Type": "application/json" },
-  body: JSON.stringify({ cart_id: cartId, amount: 49.99 })
-}).then(r => r.json());
-
-// Capture after authorization
-await fetch("${BASE}/v1/stores/${SV}/checkout/intents/\${intent.id}/capture", {
-  method: "POST",
-  headers: { "x-api-key": "${KV}" }
-});`,
-  nextjs_ssr: `// app/api/checkout/route.ts (Server-side checkout — keep API key secret)
-import { NextRequest, NextResponse } from "next/server";
-
-const API_KEY = process.env.WHALE_API_KEY!;
-const STORE_ID = process.env.WHALE_STORE_ID!;
-const BASE = "${BASE}";
-
-export async function POST(req: NextRequest) {
-  const { cart_id, shipping_address } = await req.json();
-
-  const res = await fetch(\`\${BASE}/v1/stores/\${STORE_ID}/checkout\`, {
-    method: "POST",
-    headers: { "x-api-key": API_KEY, "Content-Type": "application/json" },
-    body: JSON.stringify({ cart_id, shipping_address }),
-  });
-
-  if (!res.ok) {
-    const err = await res.json();
-    return NextResponse.json(err, { status: res.status });
-  }
-
-  return NextResponse.json(await res.json());
-}`,
-  react_client: `// components/CheckoutButton.tsx
-"use client";
-import { useState } from "react";
-
-export function CheckoutButton({ cartId }: { cartId: string }) {
-  const [loading, setLoading] = useState(false);
-
-  const handleCheckout = async () => {
-    setLoading(true);
-    try {
-      const res = await fetch("/api/checkout", {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ cart_id: cartId }),
-      });
-      const order = await res.json();
-      if (order.id) window.location.href = \`/orders/\${order.id}/confirmation\`;
-    } finally {
-      setLoading(false);
-    }
-  };
-
-  return <button onClick={handleCheckout} disabled={loading}>{loading ? "Processing..." : "Checkout"}</button>;
-}`
-};
-//# sourceMappingURL=api-docs-examples.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"api-docs-examples.js","names":["BASE","SV","KV","productsExamples","raw_fetch","nextjs_ssr","react_client","cartExamples","checkoutExamples"],"sources":["../../../src/server/handlers/api-docs-examples.ts"],"sourcesContent":["// api-docs-examples.ts — Code examples for products, cart, checkout\n// Extracted from api-docs.ts for file size management.\n\nconst BASE = \"https://whale-gateway.fly.dev\";\nconst SV = \"${STORE_ID}\";\nconst KV = \"${API_KEY}\";\n\nexport type ExampleSet = { raw_fetch: string; nextjs_ssr: string; react_client: string };\n\nexport const productsExamples: ExampleSet = {\n  raw_fetch: `// List products\nconst res = await fetch(\"${BASE}/v1/stores/${SV}/products?limit=25&status=published\", {\n  headers: { \"x-api-key\": \"${KV}\" }\n});\nconst { data: products, has_more } = await res.json();\n\n// Get single product\nconst product = await fetch(\"${BASE}/v1/stores/${SV}/products/\\${productId}\", {\n  headers: { \"x-api-key\": \"${KV}\" }\n}).then(r => r.json());`,\n\n  nextjs_ssr: `// app/products/page.tsx (Next.js App Router — Server Component)\nconst API_KEY = process.env.WHALE_API_KEY!;\nconst STORE_ID = process.env.WHALE_STORE_ID!;\nconst BASE = \"${BASE}\";\n\nasync function getProducts(page?: string) {\n  const params = new URLSearchParams({ limit: \"25\", status: \"published\" });\n  if (page) params.set(\"starting_after\", page);\n\n  const res = await fetch(\\`\\${BASE}/v1/stores/\\${STORE_ID}/products?\\${params}\\`, {\n    headers: { \"x-api-key\": API_KEY },\n    next: { revalidate: 60 }, // ISR: revalidate every 60s\n  });\n\n  if (!res.ok) throw new Error(\"Failed to fetch products\");\n  return res.json();\n}\n\nexport default async function ProductsPage({ searchParams }: { searchParams: { after?: string } }) {\n  const { data: products, has_more } = await getProducts(searchParams.after);\n\n  return (\n    <div className=\"grid grid-cols-3 gap-4\">\n      {products.map((p: any) => (\n        <div key={p.id} className=\"border rounded p-4\">\n          {p.featured_image && <img src={p.featured_image} alt={p.name} />}\n          <h2>{p.name}</h2>\n          <p>{p.pricing_data?.tiers?.[0]?.price ? \\`$\\${p.pricing_data.tiers[0].price}\\` : \"Contact for pricing\"}</p>\n        </div>\n      ))}\n      {has_more && <a href={\\`?after=\\${products.at(-1)?.id}\\`}>Next page →</a>}\n    </div>\n  );\n}`,\n\n  react_client: `// hooks/useProducts.ts (React client-side)\nimport { useState, useEffect } from \"react\";\n\nconst BASE = \"${BASE}\";\n\nexport function useProducts(storeId: string, apiKey: string) {\n  const [products, setProducts] = useState([]);\n  const [loading, setLoading] = useState(true);\n\n  useEffect(() => {\n    fetch(\\`\\${BASE}/v1/stores/\\${storeId}/products?status=published&limit=50\\`, {\n      headers: { \"x-api-key\": apiKey },\n    })\n      .then(r => r.json())\n      .then(({ data }) => setProducts(data))\n      .finally(() => setLoading(false));\n  }, [storeId, apiKey]);\n\n  return { products, loading };\n}`,\n};\n\nexport const cartExamples: ExampleSet = {\n  raw_fetch: `// Create cart\nconst cart = await fetch(\"${BASE}/v1/stores/${SV}/cart\", {\n  method: \"POST\",\n  headers: { \"x-api-key\": \"${KV}\", \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({ customer_id: customerId })\n}).then(r => r.json());\n\n// Add item\nawait fetch(\"${BASE}/v1/stores/${SV}/cart/\\${cart.id}/items\", {\n  method: \"POST\",\n  headers: { \"x-api-key\": \"${KV}\", \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({ product_id: \"...\", quantity: 2 })\n}).then(r => r.json());\n\n// View cart\nconst fullCart = await fetch(\"${BASE}/v1/stores/${SV}/cart/\\${cart.id}\", {\n  headers: { \"x-api-key\": \"${KV}\" }\n}).then(r => r.json());`,\n\n  nextjs_ssr: `// app/api/cart/route.ts (Next.js Route Handler — server-side proxy)\nimport { NextRequest, NextResponse } from \"next/server\";\n\nconst API_KEY = process.env.WHALE_API_KEY!;\nconst STORE_ID = process.env.WHALE_STORE_ID!;\nconst BASE = \"${BASE}\";\n\nexport async function POST(req: NextRequest) {\n  const body = await req.json();\n  const res = await fetch(\\`\\${BASE}/v1/stores/\\${STORE_ID}/cart\\`, {\n    method: \"POST\",\n    headers: { \"x-api-key\": API_KEY, \"Content-Type\": \"application/json\" },\n    body: JSON.stringify(body),\n  });\n  return NextResponse.json(await res.json());\n}`,\n\n  react_client: `// hooks/useCart.ts\nimport { useState, useCallback } from \"react\";\n\nexport function useCart(storeId: string, apiKey: string) {\n  const [cart, setCart] = useState<any>(null);\n  const BASE = \"${BASE}\";\n  const headers = { \"x-api-key\": apiKey, \"Content-Type\": \"application/json\" };\n\n  const createCart = useCallback(async () => {\n    const res = await fetch(\\`\\${BASE}/v1/stores/\\${storeId}/cart\\`, {\n      method: \"POST\", headers,\n    });\n    const data = await res.json();\n    setCart(data);\n    return data;\n  }, [storeId]);\n\n  const addItem = useCallback(async (productId: string, quantity: number) => {\n    if (!cart) return;\n    const res = await fetch(\\`\\${BASE}/v1/stores/\\${storeId}/cart/\\${cart.id}/items\\`, {\n      method: \"POST\", headers,\n      body: JSON.stringify({ product_id: productId, quantity }),\n    });\n    const data = await res.json();\n    setCart(data);\n    return data;\n  }, [storeId, cart]);\n\n  const removeItem = useCallback(async (itemId: string) => {\n    if (!cart) return;\n    const res = await fetch(\\`\\${BASE}/v1/stores/\\${storeId}/cart/\\${cart.id}/items/\\${itemId}\\`, {\n      method: \"DELETE\", headers,\n    });\n    const data = await res.json();\n    setCart(data);\n    return data;\n  }, [storeId, cart]);\n\n  return { cart, createCart, addItem, removeItem };\n}`,\n};\n\nexport const checkoutExamples: ExampleSet = {\n  raw_fetch: `// E-commerce checkout (convert cart to order)\nconst order = await fetch(\"${BASE}/v1/stores/${SV}/checkout\", {\n  method: \"POST\",\n  headers: { \"x-api-key\": \"${KV}\", \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({\n    cart_id: cartId,\n    payment_method: \"card\",\n    shipping_address: { street: \"123 Main St\", city: \"Charlotte\", state: \"NC\", zip: \"28202\" }\n  })\n}).then(r => r.json());\n\n// POS payment intent flow\nconst intent = await fetch(\"${BASE}/v1/stores/${SV}/checkout/intents\", {\n  method: \"POST\",\n  headers: { \"x-api-key\": \"${KV}\", \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({ cart_id: cartId, amount: 49.99 })\n}).then(r => r.json());\n\n// Capture after authorization\nawait fetch(\"${BASE}/v1/stores/${SV}/checkout/intents/\\${intent.id}/capture\", {\n  method: \"POST\",\n  headers: { \"x-api-key\": \"${KV}\" }\n});`,\n\n  nextjs_ssr: `// app/api/checkout/route.ts (Server-side checkout — keep API key secret)\nimport { NextRequest, NextResponse } from \"next/server\";\n\nconst API_KEY = process.env.WHALE_API_KEY!;\nconst STORE_ID = process.env.WHALE_STORE_ID!;\nconst BASE = \"${BASE}\";\n\nexport async function POST(req: NextRequest) {\n  const { cart_id, shipping_address } = await req.json();\n\n  const res = await fetch(\\`\\${BASE}/v1/stores/\\${STORE_ID}/checkout\\`, {\n    method: \"POST\",\n    headers: { \"x-api-key\": API_KEY, \"Content-Type\": \"application/json\" },\n    body: JSON.stringify({ cart_id, shipping_address }),\n  });\n\n  if (!res.ok) {\n    const err = await res.json();\n    return NextResponse.json(err, { status: res.status });\n  }\n\n  return NextResponse.json(await res.json());\n}`,\n\n  react_client: `// components/CheckoutButton.tsx\n\"use client\";\nimport { useState } from \"react\";\n\nexport function CheckoutButton({ cartId }: { cartId: string }) {\n  const [loading, setLoading] = useState(false);\n\n  const handleCheckout = async () => {\n    setLoading(true);\n    try {\n      const res = await fetch(\"/api/checkout\", {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ cart_id: cartId }),\n      });\n      const order = await res.json();\n      if (order.id) window.location.href = \\`/orders/\\${order.id}/confirmation\\`;\n    } finally {\n      setLoading(false);\n    }\n  };\n\n  return <button onClick={handleCheckout} disabled={loading}>{loading ? \"Processing...\" : \"Checkout\"}</button>;\n}`,\n};\n"],"mappings":"AAAA;AACA;;AAEA,MAAMA,IAAI,GAAG,+BAA+B;AAC5C,MAAMC,EAAE,GAAG,aAAa;AACxB,MAAMC,EAAE,GAAG,YAAY;AAIvB,OAAO,MAAMC,gBAA4B,GAAG;EAC1CC,SAAS,EAAE;AACb,2BAA2BJ,IAAI,cAAcC,EAAE;AAC/C,6BAA6BC,EAAE;AAC/B;AACA;AACA;AACA;AACA,+BAA+BF,IAAI,cAAcC,EAAE;AACnD,6BAA6BC,EAAE;AAC/B,wBAAwB;EAEtBG,UAAU,EAAE;AACd;AACA;AACA,gBAAgBL,IAAI;AACpB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE;EAEAM,YAAY,EAAE;AAChB;AACA;AACA,gBAAgBN,IAAI;AACpB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMO,YAAwB,GAAG;EACtCH,SAAS,EAAE;AACb,4BAA4BJ,IAAI,cAAcC,EAAE;AAChD;AACA,6BAA6BC,EAAE;AAC/B;AACA;AACA;AACA;AACA,eAAeF,IAAI,cAAcC,EAAE;AACnC;AACA,6BAA6BC,EAAE;AAC/B;AACA;AACA;AACA;AACA,gCAAgCF,IAAI,cAAcC,EAAE;AACpD,6BAA6BC,EAAE;AAC/B,wBAAwB;EAEtBG,UAAU,EAAE;AACd;AACA;AACA;AACA;AACA,gBAAgBL,IAAI;AACpB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE;EAEAM,YAAY,EAAE;AAChB;AACA;AACA;AACA;AACA,kBAAkBN,IAAI;AACtB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMQ,gBAA4B,GAAG;EAC1CJ,SAAS,EAAE;AACb,6BAA6BJ,IAAI,cAAcC,EAAE;AACjD;AACA,6BAA6BC,EAAE;AAC/B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,8BAA8BF,IAAI,cAAcC,EAAE;AAClD;AACA,6BAA6BC,EAAE;AAC/B;AACA;AACA;AACA;AACA,eAAeF,IAAI,cAAcC,EAAE;AACnC;AACA,6BAA6BC,EAAE;AAC/B,IAAI;EAEFG,UAAU,EAAE;AACd;AACA;AACA;AACA;AACA,gBAAgBL,IAAI;AACpB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE;EAEAM,YAAY,EAAE;AAChB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC","ignoreList":[]}

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

@@ -1,2 +0,0 @@
-import type { Section } from "./api-docs-sections.js";
-export declare const customersSections: Record<string, Section>;