@contractspec/bundle.library 1.11.1 → 1.13.0

package/dist/components/docs/integrations/IntegrationsCircuitBreakersPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IntegrationsCircuitBreakersPage.js","names":[],"sources":["../../../../src/components/docs/integrations/IntegrationsCircuitBreakersPage.tsx"],"sourcesContent":["// export const metadata: Metadata = {\n//   title: 'Circuit Breakers for Integrations | ContractSpec',\n//   description: 'How to wrap external integrations with circuit breakers.',\n// };\n\nexport function IntegrationsCircuitBreakersPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Integration Circuit Breakers</h1>\n        <p className=\"text-muted-foreground text-lg\">\n          External APIs are the most common source of instability. Wrap every\n          integration call in a circuit breaker to protect your system.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Pattern</h2>\n        <p>\n          Create a dedicated circuit breaker instance for each external service.\n          This ensures that a failure in Stripe doesn't trigger the circuit\n          breaker for Twilio.\n        </p>\n        <pre className=\"bg-muted rounded-lg border p-4 text-sm\">\n          {`// integrations/stripe.ts\nimport { CircuitBreaker } from '@contractspec/lib.resilience/circuit-breaker';\n\nconst stripeBreaker = new CircuitBreaker({\n  failureThreshold: 10,\n  resetTimeoutMs: 60000,\n});\n\nexport async function createCharge(amount: number) {\n  return stripeBreaker.execute(() => stripe.charges.create({ amount }));\n}`}\n        </pre>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;AAKA,SAAgB,kCAAkC;AAChD,QACE,qBAAC;EAAI,WAAU;aACb,qBAAC;GAAI,WAAU;cACb,oBAAC;IAAG,WAAU;cAAqB;KAAiC,EACpE,oBAAC;IAAE,WAAU;cAAgC;KAGzC;IACA,EAEN,qBAAC;GAAI,WAAU;;IACb,oBAAC;KAAG,WAAU;eAAqB;MAAY;IAC/C,oBAAC,iBAAE,iKAIC;IACJ,oBAAC;KAAI,WAAU;eACZ;;;;;;;;;;;MAWG;;IACF;GACF"}

package/dist/components/docs/integrations/IntegrationsElevenLabsPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IntegrationsElevenLabsPage.js","names":[],"sources":["../../../../src/components/docs/integrations/IntegrationsElevenLabsPage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\n// export const metadata = {\n//   title: 'ElevenLabs Integration: ContractSpec Docs',\n//   description:\n//     'Generate realistic text-to-speech audio with ElevenLabs in ContractSpec.',\n// };\n\nexport function IntegrationsElevenLabsPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">ElevenLabs</h1>\n        <p className=\"text-muted-foreground\">\n          ElevenLabs provides state-of-the-art text-to-speech and voice cloning\n          technology. Create natural-sounding voiceovers, audiobooks, and voice\n          assistants.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Setup</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`# .env\nELEVENLABS_API_KEY=...`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Text-to-Speech</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`capabilityId: elevenlabs-tts\nprovider:\n  type: elevenlabs\n  operation: textToSpeech\n\ninputs:\n  text:\n    type: string\n  voiceId:\n    type: string\n    default: \"21m00Tcm4TlvDq8ikWAM\"\n  modelId:\n    type: string\n    default: \"eleven_monolingual_v1\"\n\noutputs:\n  audioUrl:\n    type: string\n  audioData:\n    type: buffer`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Use cases</h2>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>Generate voiceovers for videos</li>\n          <li>Create audio versions of articles</li>\n          <li>Build voice assistants</li>\n          <li>Produce audiobooks</li>\n        </ul>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/integrations/openai\" className=\"btn-ghost\">\n          Previous: OpenAI\n        </Link>\n        <Link href=\"/docs/integrations/qdrant\" className=\"btn-primary\">\n          Next: Qdrant <ChevronRight size={16} />\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;AASA,SAAgB,6BAA6B;AAC3C,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAe,EAClD,oBAAC;KAAE,WAAU;eAAwB;MAIjC;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAU,EAC7C,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;0BACc;MAChB;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAmB,EACtD,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;oBAmBQ;MACV;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAc,EACjD,qBAAC;KAAG,WAAU;;MACZ,oBAAC,kBAAG,mCAAmC;MACvC,oBAAC,kBAAG,sCAAsC;MAC1C,oBAAC,kBAAG,2BAA2B;MAC/B,oBAAC,kBAAG,uBAAuB;;MACxB;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAK,MAAK;KAA4B,WAAU;eAAY;MAEtD,EACP,qBAAC;KAAK,MAAK;KAA4B,WAAU;gBAAc,iBAChD,oBAAC,gBAAa,MAAM,KAAM;MAClC;KACH;;GACF"}

package/dist/components/docs/integrations/IntegrationsGmailPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IntegrationsGmailPage.js","names":[],"sources":["../../../../src/components/docs/integrations/IntegrationsGmailPage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\n// export const metadata = {\n//   title: 'Gmail API Integration: ContractSpec Docs',\n//   description:\n//     'Process inbound emails and manage threads with Gmail API in ContractSpec.',\n// };\n\nexport function IntegrationsGmailPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Gmail API</h1>\n        <p className=\"text-muted-foreground\">\n          The Gmail API integration allows you to read inbound emails, manage\n          threads, and build email-based workflows. Perfect for support tickets,\n          email parsing, and automated responses.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Setup</h2>\n        <p className=\"text-muted-foreground\">\n          Configure OAuth 2.0 credentials in Google Cloud Console:\n        </p>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`# .env\nGOOGLE_CLIENT_ID=...\nGOOGLE_CLIENT_SECRET=...\nGOOGLE_REDIRECT_URI=https://your-app.com/auth/google/callback`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Reading emails</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`capabilityId: gmail-list-messages\nprovider:\n  type: gmail\n  operation: listMessages\n\ninputs:\n  query:\n    type: string\n    description: \"Gmail search query\"\n  maxResults:\n    type: number\n    default: 10\n\noutputs:\n  messages:\n    type: array\n    items:\n      type: object\n      properties:\n        id: string\n        threadId: string\n        snippet: string`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Use cases</h2>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>Parse support emails and create tickets</li>\n          <li>Extract attachments and process them</li>\n          <li>Build email-to-task workflows</li>\n          <li>Monitor specific email threads</li>\n        </ul>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/integrations/resend\" className=\"btn-ghost\">\n          Previous: Resend\n        </Link>\n        <Link href=\"/docs/integrations/google-calendar\" className=\"btn-primary\">\n          Next: Google Calendar <ChevronRight size={16} />\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;AASA,SAAgB,wBAAwB;AACtC,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAc,EACjD,oBAAC;KAAE,WAAU;eAAwB;MAIjC;KACA;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAU;KAC7C,oBAAC;MAAE,WAAU;gBAAwB;OAEjC;KACJ,oBAAC;MAAI,WAAU;gBACb,oBAAC,mBAAK;;;iEAGqD;OACvD;;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAmB,EACtD,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;2BAqBe;MACjB;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAc,EACjD,qBAAC;KAAG,WAAU;;MACZ,oBAAC,kBAAG,4CAA4C;MAChD,oBAAC,kBAAG,yCAAyC;MAC7C,oBAAC,kBAAG,kCAAkC;MACtC,oBAAC,kBAAG,mCAAmC;;MACpC;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAK,MAAK;KAA4B,WAAU;eAAY;MAEtD,EACP,qBAAC;KAAK,MAAK;KAAqC,WAAU;gBAAc,0BAChD,oBAAC,gBAAa,MAAM,KAAM;MAC3C;KACH;;GACF"}

package/dist/components/docs/integrations/IntegrationsGoogleCalendarPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IntegrationsGoogleCalendarPage.js","names":[],"sources":["../../../../src/components/docs/integrations/IntegrationsGoogleCalendarPage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\n// export const metadata = {\n//   title: 'Google Calendar Integration: ContractSpec Docs',\n//   description:\n//     'Schedule events and manage calendars with Google Calendar API in ContractSpec.',\n// };\n\nexport function IntegrationsGoogleCalendarPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Google Calendar</h1>\n        <p className=\"text-muted-foreground\">\n          Integrate Google Calendar to schedule appointments, manage\n          availability, and sync events with your application.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Setup</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`# .env\nGOOGLE_CLIENT_ID=...\nGOOGLE_CLIENT_SECRET=...\nGOOGLE_CALENDAR_ID=primary`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Creating events</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`capabilityId: calendar-create-event\nprovider:\n  type: google-calendar\n  operation: createEvent\n\ninputs:\n  summary:\n    type: string\n  description:\n    type: string\n    optional: true\n  startTime:\n    type: timestamp\n  endTime:\n    type: timestamp\n  attendees:\n    type: array\n    items:\n      type: string\n\noutputs:\n  eventId:\n    type: string\n  htmlLink:\n    type: string`}</pre>\n        </div>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/integrations/gmail\" className=\"btn-ghost\">\n          Previous: Gmail API\n        </Link>\n        <Link href=\"/docs/integrations/openai\" className=\"btn-primary\">\n          Next: OpenAI <ChevronRight size={16} />\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;AASA,SAAgB,iCAAiC;AAC/C,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAoB,EACvD,oBAAC;KAAE,WAAU;eAAwB;MAGjC;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAU,EAC7C,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;8BAGkB;MACpB;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAoB,EACvD,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;;;;oBAwBQ;MACV;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAK,MAAK;KAA2B,WAAU;eAAY;MAErD,EACP,qBAAC;KAAK,MAAK;KAA4B,WAAU;gBAAc,iBAChD,oBAAC,gBAAa,MAAM,KAAM;MAClC;KACH;;GACF"}

package/dist/components/docs/integrations/IntegrationsOpenAIPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IntegrationsOpenAIPage.js","names":[],"sources":["../../../../src/components/docs/integrations/IntegrationsOpenAIPage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\n// export const metadata = {\n//   title: 'OpenAI Integration: ContractSpec Docs',\n//   description:\n//     'Use GPT models, embeddings, and Whisper speech-to-text with OpenAI in ContractSpec.',\n// };\n\nexport function IntegrationsOpenAIPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">OpenAI</h1>\n        <p className=\"text-muted-foreground\">\n          Integrate OpenAI's powerful AI models for chat completion, embeddings,\n          and speech-to-text. Build intelligent features with GPT-4, generate\n          embeddings for semantic search, and transcribe audio with Whisper.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Setup</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`# .env\nOPENAI_API_KEY=sk-...\nOPENAI_ORGANIZATION=org-...`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Chat completions</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`capabilityId: openai-chat\nprovider:\n  type: openai\n  operation: chatCompletion\n\ninputs:\n  messages:\n    type: array\n    items:\n      type: object\n      properties:\n        role: string\n        content: string\n  model:\n    type: string\n    default: \"gpt-4\"\n  temperature:\n    type: number\n    default: 0.7\n    optional: true\n\noutputs:\n  content:\n    type: string\n  usage:\n    type: object`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Embeddings</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`capabilityId: openai-embeddings\nprovider:\n  type: openai\n  operation: createEmbedding\n\ninputs:\n  text:\n    type: string\n  model:\n    type: string\n    default: \"text-embedding-3-small\"\n\noutputs:\n  embedding:\n    type: array\n    items:\n      type: number`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Whisper (Speech-to-Text)</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`capabilityId: openai-transcribe\nprovider:\n  type: openai\n  operation: transcribe\n\ninputs:\n  audioFile:\n    type: file\n  language:\n    type: string\n    optional: true\n\noutputs:\n  text:\n    type: string\n  language:\n    type: string`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Best practices</h2>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>Use streaming for real-time chat responses</li>\n          <li>Cache embeddings to reduce API costs</li>\n          <li>Implement rate limiting to avoid quota issues</li>\n          <li>Store conversation history for context</li>\n          <li>Monitor token usage and costs</li>\n        </ul>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/integrations/google-calendar\" className=\"btn-ghost\">\n          Previous: Google Calendar\n        </Link>\n        <Link href=\"/docs/integrations/elevenlabs\" className=\"btn-primary\">\n          Next: ElevenLabs <ChevronRight size={16} />\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;AASA,SAAgB,yBAAyB;AACvC,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAW,EAC9C,oBAAC;KAAE,WAAU;eAAwB;MAIjC;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAU,EAC7C,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;+BAEmB;MACrB;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAqB,EACxD,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;;;;;oBAyBQ;MACV;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAe,EAClD,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;sBAgBU;MACZ;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAA6B,EAChE,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;oBAgBQ;MACV;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAmB,EACtD,qBAAC;KAAG,WAAU;;MACZ,oBAAC,kBAAG,+CAA+C;MACnD,oBAAC,kBAAG,yCAAyC;MAC7C,oBAAC,kBAAG,kDAAkD;MACtD,oBAAC,kBAAG,2CAA2C;MAC/C,oBAAC,kBAAG,kCAAkC;;MACnC;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAK,MAAK;KAAqC,WAAU;eAAY;MAE/D,EACP,qBAAC;KAAK,MAAK;KAAgC,WAAU;gBAAc,qBAChD,oBAAC,gBAAa,MAAM,KAAM;MACtC;KACH;;GACF"}

package/dist/components/docs/integrations/IntegrationsOverviewPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IntegrationsOverviewPage.js","names":[],"sources":["../../../../src/components/docs/integrations/IntegrationsOverviewPage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\n// export const metadata = {\n//   title: 'Integrations: ContractSpec Docs',\n//   description:\n//     'Connect ContractSpec to payments, email, AI, storage, and other services through built-in integrations.',\n// };\n\nexport function IntegrationsOverviewPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Integrations</h1>\n        <p className=\"text-muted-foreground\">\n          ContractSpec provides first-class integration support through a\n          spec-first architecture. Integrations are defined globally, connected\n          per-tenant, and bound to apps through typed specifications, ensuring\n          type-safe, policy-enforced access to external services.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Spec-first architecture</h2>\n        <p className=\"text-muted-foreground\">\n          Integrations in ContractSpec follow a three-layer model:\n        </p>\n        <div className=\"space-y-3\">\n          <div className=\"card-subtle p-4\">\n            <h3 className=\"mb-2 font-semibold\">1. IntegrationSpec (Global)</h3>\n            <p className=\"text-muted-foreground text-sm\">\n              Defines what an integration provides: capabilities, configuration\n              schema, secrets, webhooks, and requirements.\n            </p>\n            <Link\n              href=\"/docs/integrations/spec-model\"\n              className=\"mt-2 inline-block text-sm text-violet-400 hover:text-violet-300\"\n            >\n              Learn more →\n            </Link>\n          </div>\n          <div className=\"card-subtle p-4\">\n            <h3 className=\"mb-2 font-semibold\">\n              2. IntegrationConnection (Per-Tenant)\n            </h3>\n            <p className=\"text-muted-foreground text-sm\">\n              A tenant's configured connection with credentials, environment\n              (sandbox/production), and health status.\n            </p>\n            <Link\n              href=\"/docs/architecture/integration-binding\"\n              className=\"mt-2 inline-block text-sm text-violet-400 hover:text-violet-300\"\n            >\n              Learn more →\n            </Link>\n          </div>\n          <div className=\"card-subtle p-4\">\n            <h3 className=\"mb-2 font-semibold\">\n              3. AppIntegrationBinding (Per-App)\n            </h3>\n            <p className=\"text-muted-foreground text-sm\">\n              Maps tenant connections to app capabilities and workflows,\n              defining which operations can use which integrations.\n            </p>\n            <Link\n              href=\"/docs/architecture/integration-binding\"\n              className=\"mt-2 inline-block text-sm text-violet-400 hover:text-violet-300\"\n            >\n              Learn more →\n            </Link>\n          </div>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Integration categories</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`type IntegrationCategory =\n  | \"payments\"      // Stripe\n  | \"email\"         // Postmark, Resend, Gmail\n  | \"calendar\"      // Google Calendar\n  | \"sms\"           // Twilio\n  | \"ai-llm\"        // OpenAI\n  | \"ai-voice\"      // ElevenLabs\n  | \"speech-to-text\" // OpenAI Whisper\n  | \"vector-db\"     // Qdrant\n  | \"storage\"       // S3-compatible\n  | \"open-banking\"  // Powens (read-only)\n  | \"accounting\"    // Coming soon\n  | \"crm\"           // Coming soon\n  | \"helpdesk\"      // Coming soon\n  | \"custom\";       // User-defined`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Available integrations</h2>\n        <div className=\"space-y-6\">\n          {/* Payments */}\n          <div className=\"space-y-3\">\n            <h3 className=\"text-xl font-semibold\">Payments</h3>\n            <div className=\"grid gap-4 md:grid-cols-2\">\n              <Link\n                href=\"/docs/integrations/stripe\"\n                className=\"card-subtle group p-4 transition-colors hover:border-violet-500/50\"\n              >\n                <h4 className=\"font-bold transition-colors group-hover:text-violet-400\">\n                  Stripe\n                </h4>\n                <p className=\"text-muted-foreground mt-1 text-sm\">\n                  Payment processing, subscriptions, and invoicing\n                </p>\n              </Link>\n            </div>\n          </div>\n\n          {/* Open Banking */}\n          <div className=\"space-y-3\">\n            <h3 className=\"text-xl font-semibold\">Open Banking</h3>\n            <div className=\"grid gap-4 md:grid-cols-2\">\n              <Link\n                href=\"/docs/integrations/powens\"\n                className=\"card-subtle group p-4 transition-colors hover:border-violet-500/50\"\n              >\n                <h4 className=\"font-bold transition-colors group-hover:text-violet-400\">\n                  Powens (Read-Only)\n                </h4>\n                <p className=\"text-muted-foreground mt-1 text-sm\">\n                  Account, transaction, and balance synchronisation via Powens\n                  with tenant-owned credentials.\n                </p>\n              </Link>\n            </div>\n          </div>\n\n          {/* Email */}\n          <div className=\"space-y-3\">\n            <h3 className=\"text-xl font-semibold\">Email</h3>\n            <div className=\"grid gap-4 md:grid-cols-2\">\n              <Link\n                href=\"/docs/integrations/postmark\"\n                className=\"card-subtle group p-4 transition-colors hover:border-violet-500/50\"\n              >\n                <h4 className=\"font-bold transition-colors group-hover:text-violet-400\">\n                  Postmark\n                </h4>\n                <p className=\"text-muted-foreground mt-1 text-sm\">\n                  Transactional email delivery with high deliverability\n                </p>\n              </Link>\n              <Link\n                href=\"/docs/integrations/resend\"\n                className=\"card-subtle group p-4 transition-colors hover:border-violet-500/50\"\n              >\n                <h4 className=\"font-bold transition-colors group-hover:text-violet-400\">\n                  Resend\n                </h4>\n                <p className=\"text-muted-foreground mt-1 text-sm\">\n                  Modern email API for developers\n                </p>\n              </Link>\n              <Link\n                href=\"/docs/integrations/gmail\"\n                className=\"card-subtle group p-4 transition-colors hover:border-violet-500/50\"\n              >\n                <h4 className=\"font-bold transition-colors group-hover:text-violet-400\">\n                  Gmail API\n                </h4>\n                <p className=\"text-muted-foreground mt-1 text-sm\">\n                  Inbound email processing and thread management\n                </p>\n              </Link>\n            </div>\n          </div>\n\n          {/* Calendar & Scheduling */}\n          <div className=\"space-y-3\">\n            <h3 className=\"text-xl font-semibold\">Calendar & Scheduling</h3>\n            <div className=\"grid gap-4 md:grid-cols-2\">\n              <Link\n                href=\"/docs/integrations/google-calendar\"\n                className=\"card-subtle group p-4 transition-colors hover:border-violet-500/50\"\n              >\n                <h4 className=\"font-bold transition-colors group-hover:text-violet-400\">\n                  Google Calendar\n                </h4>\n                <p className=\"text-muted-foreground mt-1 text-sm\">\n                  Event scheduling and calendar management\n                </p>\n              </Link>\n            </div>\n          </div>\n\n          {/* AI & Machine Learning */}\n          <div className=\"space-y-3\">\n            <h3 className=\"text-xl font-semibold\">AI & Machine Learning</h3>\n            <div className=\"grid gap-4 md:grid-cols-2\">\n              <Link\n                href=\"/docs/integrations/openai\"\n                className=\"card-subtle group p-4 transition-colors hover:border-violet-500/50\"\n              >\n                <h4 className=\"font-bold transition-colors group-hover:text-violet-400\">\n                  OpenAI\n                </h4>\n                <p className=\"text-muted-foreground mt-1 text-sm\">\n                  LLMs, embeddings, and Whisper speech-to-text\n                </p>\n              </Link>\n              <Link\n                href=\"/docs/integrations/elevenlabs\"\n                className=\"card-subtle group p-4 transition-colors hover:border-violet-500/50\"\n              >\n                <h4 className=\"font-bold transition-colors group-hover:text-violet-400\">\n                  ElevenLabs\n                </h4>\n                <p className=\"text-muted-foreground mt-1 text-sm\">\n                  Text-to-speech and voice synthesis\n                </p>\n              </Link>\n              <Link\n                href=\"/docs/integrations/qdrant\"\n                className=\"card-subtle group p-4 transition-colors hover:border-violet-500/50\"\n              >\n                <h4 className=\"font-bold transition-colors group-hover:text-violet-400\">\n                  Qdrant\n                </h4>\n                <p className=\"text-muted-foreground mt-1 text-sm\">\n                  Vector database for semantic search and RAG\n                </p>\n              </Link>\n            </div>\n          </div>\n\n          {/* Storage */}\n          <div className=\"space-y-3\">\n            <h3 className=\"text-xl font-semibold\">Storage</h3>\n            <div className=\"grid gap-4 md:grid-cols-2\">\n              <Link\n                href=\"/docs/integrations/s3\"\n                className=\"card-subtle group p-4 transition-colors hover:border-violet-500/50\"\n              >\n                <h4 className=\"font-bold transition-colors group-hover:text-violet-400\">\n                  S3-Compatible Storage\n                </h4>\n                <p className=\"text-muted-foreground mt-1 text-sm\">\n                  Object storage (AWS S3, Scaleway, MinIO, etc.)\n                </p>\n              </Link>\n            </div>\n          </div>\n\n          {/* SMS */}\n          <div className=\"space-y-3\">\n            <h3 className=\"text-xl font-semibold\">SMS & Messaging</h3>\n            <div className=\"grid gap-4 md:grid-cols-2\">\n              <Link\n                href=\"/docs/integrations/twilio\"\n                className=\"card-subtle group p-4 transition-colors hover:border-violet-500/50\"\n              >\n                <h4 className=\"font-bold transition-colors group-hover:text-violet-400\">\n                  Twilio\n                </h4>\n                <p className=\"text-muted-foreground mt-1 text-sm\">\n                  SMS notifications and messaging\n                </p>\n              </Link>\n            </div>\n          </div>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">How integrations work</h2>\n        <p className=\"text-muted-foreground\">\n          ContractSpec integrations are implemented as{' '}\n          <Link\n            href=\"/docs/specs/capabilities\"\n            className=\"text-violet-400 hover:text-violet-300\"\n          >\n            capability providers\n          </Link>\n          . This means:\n        </p>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>\n            <strong>Type safety</strong> – All API calls are type-checked by\n            TypeScript and validated at runtime via Zod\n          </li>\n          <li>\n            <strong>Policy enforcement</strong> – Access to external services is\n            governed by your{' '}\n            <Link\n              href=\"/docs/specs/policy\"\n              className=\"text-violet-400 hover:text-violet-300\"\n            >\n              PolicySpecs\n            </Link>\n          </li>\n          <li>\n            <strong>Audit logging</strong> – All integration calls are\n            automatically logged\n          </li>\n          <li>\n            <strong>Error handling</strong> – Built-in retries and fallback\n            strategies\n          </li>\n          <li>\n            <strong>Environment-based config</strong> – API keys and secrets are\n            managed through environment variables\n          </li>\n        </ul>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Secret management</h2>\n        <p className=\"text-muted-foreground\">\n          Secrets are resolved through a layered secret provider manager. It\n          checks lightweight environment overrides first, then falls back to a\n          managed vault (Google Cloud Secret Manager) for production.\n        </p>\n        <div className=\"grid gap-4 md:grid-cols-2\">\n          <div className=\"card-subtle p-4\">\n            <h3 className=\"text-xl font-semibold\">Environment variables</h3>\n            <p className=\"text-muted-foreground mt-2 text-sm\">\n              Perfect for local development and secure staging overrides. Use\n              the <code>env://</code> scheme or append <code>?env=</code> to\n              another reference to map an explicit variable.\n            </p>\n            <div className=\"bg-background/60 border-border mt-3 overflow-auto rounded-lg border p-3 font-mono text-xs\">\n              <pre className=\"whitespace-pre-wrap\">{`# Override a production secret locally\nCONTRACTSPEC__SECRET__STRIPE=sk_test_123\n\n# Reference\nenv://CONTRACTSPEC__SECRET__STRIPE`}</pre>\n            </div>\n          </div>\n          <div className=\"card-subtle p-4\">\n            <h3 className=\"text-xl font-semibold\">GCP Secret Manager</h3>\n            <p className=\"text-muted-foreground mt-2 text-sm\">\n              Used in production to store versioned credentials with rotation\n              support. References follow the{' '}\n              <code>gcp://projects/.../secrets/.../versions/latest</code>{' '}\n              format.\n            </p>\n            <div className=\"bg-background/60 border-border mt-3 overflow-auto rounded-lg border p-3 font-mono text-xs\">\n              <pre className=\"whitespace-pre-wrap\">{`# Production reference\ngcp://projects/tenant/secrets/stripe-secret-key/versions/latest`}</pre>\n            </div>\n          </div>\n        </div>\n        <p className=\"text-muted-foreground text-sm\">\n          The secret manager chooses the first provider that can resolve a\n          reference, so local environment variables can override the managed\n          vault without changing blueprints or tenant configs.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Configuration</h2>\n        <p className=\"text-muted-foreground\">\n          Integrations are configured through environment variables and secret\n          references. Here's a typical setup:\n        </p>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`# .env\nSTRIPE_SECRET_KEY=sk_test_...\nSTRIPE_WEBHOOK_SECRET=whsec_...\n\nPOSTMARK_API_TOKEN=...\nPOSTMARK_FROM_EMAIL=noreply@example.com\n\nOPENAI_API_KEY=sk-...\nOPENAI_ORGANIZATION=org-...\n\nQDRANT_URL=https://...\nQDRANT_API_KEY=...\n\nS3_ENDPOINT=https://s3.fr-par.scw.cloud\nS3_ACCESS_KEY_ID=...\nS3_SECRET_ACCESS_KEY=...\nS3_BUCKET=my-bucket\nS3_REGION=fr-par\n\n# Secret references\nSTRIPE_SECRET_REF=gcp://projects/tenant/secrets/stripe-secret-key/versions/latest\nSTRIPE_SECRET_OVERRIDE=env://STRIPE_SECRET_KEY`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Integration categories</h2>\n        <p className=\"text-muted-foreground\">\n          ContractSpec supports the following integration categories:\n        </p>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`type IntegrationCategory =\n  | \"payments\"        // Stripe, PayPal, etc.\n  | \"email\"           // Postmark, Resend, Gmail\n  | \"calendar\"        // Google Calendar, Outlook\n  | \"sms\"             // Twilio, MessageBird\n  | \"ai-llm\"          // OpenAI, Anthropic, Cohere\n  | \"ai-voice\"        // ElevenLabs, Google TTS\n  | \"speech-to-text\"  // OpenAI Whisper, Google STT\n  | \"vector-db\"       // Qdrant, Pinecone, Weaviate\n  | \"storage\"         // S3, GCS, Azure Blob\n  | \"accounting\"      // QuickBooks, Xero (coming soon)\n  | \"crm\"             // Salesforce, HubSpot (coming soon)\n  | \"helpdesk\"        // Zendesk, Intercom (coming soon)\n  | \"custom\";         // Your own integrations`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Custom integrations</h2>\n        <p className=\"text-muted-foreground\">\n          You can create custom integrations by implementing a capability\n          provider. See the{' '}\n          <Link\n            href=\"/docs/advanced/custom-providers\"\n            className=\"text-violet-400 hover:text-violet-300\"\n          >\n            Custom Providers\n          </Link>{' '}\n          guide for details.\n        </p>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/integrations/stripe\" className=\"btn-primary\">\n          Get Started with Stripe <ChevronRight size={16} />\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/components/docs/integrations/IntegrationsPostmarkPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IntegrationsPostmarkPage.js","names":[],"sources":["../../../../src/components/docs/integrations/IntegrationsPostmarkPage.tsx"],"sourcesContent":["/* eslint-disable no-useless-escape */\nimport Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\n// export const metadata = {\n//   title: 'Postmark Integration: ContractSpec Docs',\n//   description:\n//     'Send transactional emails with high deliverability using Postmark in ContractSpec.',\n// };\n\nexport function IntegrationsPostmarkPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Postmark</h1>\n        <p className=\"text-muted-foreground\">\n          Postmark is a transactional email service with industry-leading\n          deliverability. Use it to send order confirmations, password resets,\n          notifications, and other critical emails.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Setup</h2>\n        <p className=\"text-muted-foreground\">\n          Add your Postmark credentials to your environment variables:\n        </p>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`# .env\nPOSTMARK_API_TOKEN=...\nPOSTMARK_FROM_EMAIL=noreply@example.com\nPOSTMARK_FROM_NAME=\"Your App Name\"`}</pre>\n        </div>\n        <p className=\"text-muted-foreground text-sm\">\n          Get your API token from the{' '}\n          <a\n            href=\"https://account.postmarkapp.com/servers\"\n            target=\"_blank\"\n            rel=\"noopener noreferrer\"\n            className=\"text-violet-400 hover:text-violet-300\"\n          >\n            Postmark Dashboard\n          </a>\n          .\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Sending emails</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`capabilityId: send-email\nprovider:\n  type: postmark\n  operation: sendEmail\n\ninputs:\n  to:\n    type: string\n    description: \"Recipient email address\"\n  subject:\n    type: string\n  htmlBody:\n    type: string\n    optional: true\n  textBody:\n    type: string\n    optional: true\n  templateId:\n    type: string\n    optional: true\n  templateData:\n    type: object\n    optional: true\n\noutputs:\n  messageId:\n    type: string\n  submittedAt:\n    type: timestamp`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Using templates</h2>\n        <p className=\"text-muted-foreground\">\n          Postmark templates allow you to design emails in their dashboard and\n          populate them with data:\n        </p>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`capabilityId: send-welcome-email\nprovider:\n  type: postmark\n  operation: sendEmail\n\ninputs:\n  to:\n    type: string\n  userName:\n    type: string\n\nconfig:\n  templateId: \"welcome-email\"\n  templateData:\n    user_name: \\$\\{input.userName\\}\n    login_url: \"https://app.example.com/login\"`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Webhooks</h2>\n        <p className=\"text-muted-foreground\">\n          Postmark can notify your app about delivery, bounces, and opens:\n        </p>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`https://your-app.com/api/webhooks/postmark`}</pre>\n        </div>\n        <p className=\"text-muted-foreground\">\n          ContractSpec automatically processes these webhook events:\n        </p>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>\n            <strong>Delivery</strong> – Email was successfully delivered\n          </li>\n          <li>\n            <strong>Bounce</strong> – Email bounced (hard or soft)\n          </li>\n          <li>\n            <strong>SpamComplaint</strong> – Recipient marked email as spam\n          </li>\n          <li>\n            <strong>Open</strong> – Recipient opened the email\n          </li>\n          <li>\n            <strong>Click</strong> – Recipient clicked a link\n          </li>\n        </ul>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Best practices</h2>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>Use templates for consistent branding</li>\n          <li>Always provide both HTML and plain text versions</li>\n          <li>Monitor bounce rates and remove invalid addresses</li>\n          <li>Use message streams to separate different email types</li>\n          <li>Test emails in the Postmark sandbox before going live</li>\n          <li>Set up DKIM and SPF records for your domain</li>\n        </ul>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/integrations/stripe\" className=\"btn-ghost\">\n          Previous: Stripe\n        </Link>\n        <Link href=\"/docs/integrations/resend\" className=\"btn-primary\">\n          Next: Resend <ChevronRight size={16} />\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;AAUA,SAAgB,2BAA2B;AACzC,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAa,EAChD,oBAAC;KAAE,WAAU;eAAwB;MAIjC;KACA;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAU;KAC7C,oBAAC;MAAE,WAAU;gBAAwB;OAEjC;KACJ,oBAAC;MAAI,WAAU;gBACb,oBAAC,mBAAK;;;sCAG0B;OAC5B;KACN,qBAAC;MAAE,WAAU;;OAAgC;OACf;OAC5B,oBAAC;QACC,MAAK;QACL,QAAO;QACP,KAAI;QACJ,WAAU;kBACX;SAEG;;;OAEF;;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAmB,EACtD,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA4BW;MACb;KACF;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAoB;KACvD,oBAAC;MAAE,WAAU;gBAAwB;OAGjC;KACJ,oBAAC;MAAI,WAAU;gBACb,oBAAC,mBAAK;;;;;;;;;;;;;;;kDAesC;OACxC;;KACF;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAa;KAChD,oBAAC;MAAE,WAAU;gBAAwB;OAEjC;KACJ,oBAAC;MAAI,WAAU;gBACb,oBAAC,mBAAK,+CAAmD;OACrD;KACN,oBAAC;MAAE,WAAU;gBAAwB;OAEjC;KACJ,qBAAC;MAAG,WAAU;;OACZ,qBAAC,mBACC,oBAAC,sBAAO,aAAiB,2CACtB;OACL,qBAAC,mBACC,oBAAC,sBAAO,WAAe,uCACpB;OACL,qBAAC,mBACC,oBAAC,sBAAO,kBAAsB,yCAC3B;OACL,qBAAC,mBACC,oBAAC,sBAAO,SAAa,qCAClB;OACL,qBAAC,mBACC,oBAAC,sBAAO,UAAc,mCACnB;;OACF;;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAmB,EACtD,qBAAC;KAAG,WAAU;;MACZ,oBAAC,kBAAG,0CAA0C;MAC9C,oBAAC,kBAAG,qDAAqD;MACzD,oBAAC,kBAAG,sDAAsD;MAC1D,oBAAC,kBAAG,0DAA0D;MAC9D,oBAAC,kBAAG,0DAA0D;MAC9D,oBAAC,kBAAG,gDAAgD;;MACjD;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAK,MAAK;KAA4B,WAAU;eAAY;MAEtD,EACP,qBAAC;KAAK,MAAK;KAA4B,WAAU;gBAAc,iBAChD,oBAAC,gBAAa,MAAM,KAAM;MAClC;KACH;;GACF"}

package/dist/components/docs/integrations/IntegrationsPowensPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IntegrationsPowensPage.js","names":[],"sources":["../../../../src/components/docs/integrations/IntegrationsPowensPage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\n// export const metadata = {\n//   title: 'Powens Open Banking: ContractSpec Docs',\n//   description:\n//     'Synchronise bank accounts, transactions, and balances with Powens in read-only mode for the Pocket Family Office vertical.',\n// };\n\nexport function IntegrationsPowensPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Powens Open Banking</h1>\n        <p className=\"text-muted-foreground\">\n          Powens provides read-only open banking connectivity for ContractSpec\n          applications. The reference integration powers Pocket Family Office by\n          synchronising household bank accounts, transactions, and balances\n          while keeping all raw PII protected.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Setup</h2>\n        <p className=\"text-muted-foreground\">\n          Create a Powens BYOK project, then store the credentials in your\n          secret manager. The ContractSpec integration expects the following\n          fields:\n        </p>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`{\n  \"clientId\": \"powens-client-id\",\n  \"clientSecret\": \"powens-client-secret\",\n  \"apiKey\": \"optional-api-key\",\n  \"webhookSecret\": \"optional-webhook-secret\"\n}`}</pre>\n        </div>\n        <p className=\"text-muted-foreground text-sm\">\n          Configure non-secret settings on the integration connection:\n        </p>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`environment: sandbox | production\nbaseUrl?: https://api-sandbox.powens.com/v2\nregion?: eu-west-1\npollingIntervalMs?: 300000`}</pre>\n        </div>\n        <p className=\"text-muted-foreground text-sm\">\n          See the{' '}\n          <a\n            href=\"https://docs.powens.com/documentation/integration-guides/quick-start/api-overview\"\n            target=\"_blank\"\n            rel=\"noopener noreferrer\"\n            className=\"text-violet-400 hover:text-violet-300\"\n          >\n            Powens API documentation\n          </a>{' '}\n          for information on generating credentials and managing BYOK projects.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Capabilities</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`capabilityId: openbanking.accounts.read\nprovider:\n  type: openbanking.powens\n  operation: listAccounts\n\noutputs:\n  accounts:\n    type: BankAccountRecord[]\n    description: \"Canonical bank account metadata (institution, currency, balances)\"\n\n---\n\ncapabilityId: openbanking.transactions.read\nprovider:\n  type: openbanking.powens\n  operation: listTransactions\n\ninputs:\n  accountId:\n    type: string\n  from?:\n    type: string\n    description: \"ISO timestamp lower bound\"\n  to?:\n    type: string\n\noutputs:\n  transactions:\n    type: BankTransactionRecord[]\n    description: \"Canonical transaction ledger entries\"\n\n---\n\ncapabilityId: openbanking.balances.read\nprovider:\n  type: openbanking.powens\n  operation: getBalances\n\ninputs:\n  accountId:\n    type: string\n  balanceTypes?:\n    type: string[]\n\noutputs:\n  balances:\n    type: AccountBalanceRecord[]\n    description: \"Current/available balances with timestamps\"`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Primary workflows</h2>\n        <div className=\"space-y-3\">\n          <h3 className=\"text-lg font-semibold\">Account sync</h3>\n          <p className=\"text-muted-foreground\">\n            The workflow{' '}\n            <code className=\"bg-background/50 rounded px-2 py-1\">\n              pfo.workflow.sync-openbanking-accounts\n            </code>{' '}\n            refreshes account metadata, then surfaces canonical records to other\n            automations.\n          </p>\n        </div>\n        <div className=\"space-y-3\">\n          <h3 className=\"text-lg font-semibold\">Transaction sync</h3>\n          <p className=\"text-muted-foreground\">\n            <code className=\"bg-background/50 rounded px-2 py-1\">\n              pfo.workflow.sync-openbanking-transactions\n            </code>{' '}\n            ingests incremental transactions for each linked account and stores\n            them in the canonical ledger.\n          </p>\n        </div>\n        <div className=\"space-y-3\">\n          <h3 className=\"text-lg font-semibold\">Balance refresh</h3>\n          <p className=\"text-muted-foreground\">\n            <code className=\"bg-background/50 rounded px-2 py-1\">\n              pfo.workflow.refresh-openbanking-balances\n            </code>{' '}\n            retrieves current and available balances to power dashboards and\n            anomaly detection.\n          </p>\n        </div>\n        <div className=\"space-y-3\">\n          <h3 className=\"text-lg font-semibold\">Derived financial overview</h3>\n          <p className=\"text-muted-foreground\">\n            <code className=\"bg-background/50 rounded px-2 py-1\">\n              pfo.workflow.generate-openbanking-overview\n            </code>{' '}\n            aggregates balances, category breakdowns, and cashflow trends into\n            the <code>knowledge.financial-overview</code> space. Only derived\n            summaries are exposed to LLMs.\n          </p>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Telemetry & guardrails</h2>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>\n            Telemetry events such as{' '}\n            <code className=\"bg-background/50 rounded px-2 py-1\">\n              openbanking.accounts.synced\n            </code>{' '}\n            and{' '}\n            <code className=\"bg-background/50 rounded px-2 py-1\">\n              openbanking.transactions.synced\n            </code>{' '}\n            are emitted automatically with tenant, slot, and config metadata.\n          </li>\n          <li>\n            Guard helpers ensure the{' '}\n            <code className=\"bg-background/50 rounded px-2 py-1\">\n              primaryOpenBanking\n            </code>{' '}\n            slot is bound and healthy before workflows execute.\n          </li>\n          <li>\n            PII fields (IBAN, counterparty names, descriptions) are redacted via{' '}\n            <code className=\"bg-background/50 rounded px-2 py-1\">\n              redactOpenBankingTelemetryPayload\n            </code>{' '}\n            before logging or sending telemetry.\n          </li>\n        </ul>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Best practices</h2>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>\n            Use BYOK credentials per tenant to avoid cross-tenant exposure.\n          </li>\n          <li>\n            Store only canonical entities (BankAccountRecord,\n            BankTransactionRecord). Never persist raw Powens payloads or\n            customer PII in logs.\n          </li>\n          <li>\n            Run the transaction sync on a schedule appropriate for banking SLAs\n            (e.g. every 15 minutes for cashflow dashboards).\n          </li>\n          <li>\n            Pair ledger updates with derived summaries to feed the knowledge\n            layer instead of exposing raw transactions to agents.\n          </li>\n          <li>\n            Monitor telemetry for{' '}\n            <code className=\"bg-background/50 rounded px-2 py-1\">\n              openbanking.*.sync_failed\n            </code>{' '}\n            events to detect credential issues early.\n          </li>\n        </ul>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/integrations\" className=\"btn-ghost\">\n          Back to Integrations\n        </Link>\n        <Link href=\"/docs/integrations/stripe\" className=\"btn-primary\">\n          Next: Stripe <ChevronRight size={16} />\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;AASA,SAAgB,yBAAyB;AACvC,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAwB,EAC3D,oBAAC;KAAE,WAAU;eAAwB;MAKjC;KACA;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAU;KAC7C,oBAAC;MAAE,WAAU;gBAAwB;OAIjC;KACJ,oBAAC;MAAI,WAAU;gBACb,oBAAC,mBAAK;;;;;KAKP;OACK;KACN,oBAAC;MAAE,WAAU;gBAAgC;OAEzC;KACJ,oBAAC;MAAI,WAAU;gBACb,oBAAC,mBAAK;;;8BAGkB;OACpB;KACN,qBAAC;MAAE,WAAU;;OAAgC;OACnC;OACR,oBAAC;QACC,MAAK;QACL,QAAO;QACP,KAAI;QACJ,WAAU;kBACX;SAEG;OAAC;OAAI;;OAEP;;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAiB,EACpD,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iEA+CqD;MACvD;KACF;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAsB;KACzD,qBAAC;MAAI,WAAU;iBACb,oBAAC;OAAG,WAAU;iBAAwB;QAAiB,EACvD,qBAAC;OAAE,WAAU;;QAAwB;QACtB;QACb,oBAAC;SAAK,WAAU;mBAAqC;UAE9C;QAAC;QAAI;;QAGV;OACA;KACN,qBAAC;MAAI,WAAU;iBACb,oBAAC;OAAG,WAAU;iBAAwB;QAAqB,EAC3D,qBAAC;OAAE,WAAU;;QACX,oBAAC;SAAK,WAAU;mBAAqC;UAE9C;QAAC;QAAI;;QAGV;OACA;KACN,qBAAC;MAAI,WAAU;iBACb,oBAAC;OAAG,WAAU;iBAAwB;QAAoB,EAC1D,qBAAC;OAAE,WAAU;;QACX,oBAAC;SAAK,WAAU;mBAAqC;UAE9C;QAAC;QAAI;;QAGV;OACA;KACN,qBAAC;MAAI,WAAU;iBACb,oBAAC;OAAG,WAAU;iBAAwB;QAA+B,EACrE,qBAAC;OAAE,WAAU;;QACX,oBAAC;SAAK,WAAU;mBAAqC;UAE9C;QAAC;QAAI;QAER,oBAAC,oBAAK,iCAAmC;;;QAE3C;OACA;;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAA2B,EAC9D,qBAAC;KAAG,WAAU;;MACZ,qBAAC;OAAG;OACuB;OACzB,oBAAC;QAAK,WAAU;kBAAqC;SAE9C;OAAC;OAAI;OACR;OACJ,oBAAC;QAAK,WAAU;kBAAqC;SAE9C;OAAC;OAAI;UAET;MACL,qBAAC;OAAG;OACuB;OACzB,oBAAC;QAAK,WAAU;kBAAqC;SAE9C;OAAC;OAAI;UAET;MACL,qBAAC;OAAG;OACmE;OACrE,oBAAC;QAAK,WAAU;kBAAqC;SAE9C;OAAC;OAAI;UAET;;MACF;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAmB,EACtD,qBAAC;KAAG,WAAU;;MACZ,oBAAC,kBAAG,oEAEC;MACL,oBAAC,kBAAG,yIAIC;MACL,oBAAC,kBAAG,yHAGC;MACL,oBAAC,kBAAG,2HAGC;MACL,qBAAC;OAAG;OACoB;OACtB,oBAAC;QAAK,WAAU;kBAAqC;SAE9C;OAAC;OAAI;UAET;;MACF;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAK,MAAK;KAAqB,WAAU;eAAY;MAE/C,EACP,qBAAC;KAAK,MAAK;KAA4B,WAAU;gBAAc,iBAChD,oBAAC,gBAAa,MAAM,KAAM;MAClC;KACH;;GACF"}

package/dist/components/docs/integrations/IntegrationsQdrantPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IntegrationsQdrantPage.js","names":[],"sources":["../../../../src/components/docs/integrations/IntegrationsQdrantPage.tsx"],"sourcesContent":["/* eslint-disable no-useless-escape */\nimport Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\n// export const metadata = {\n//   title: 'Qdrant Integration: ContractSpec Docs',\n//   description:\n//     'Build semantic search and RAG applications with Qdrant vector database in ContractSpec.',\n// };\n\nexport function IntegrationsQdrantPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Qdrant</h1>\n        <p className=\"text-muted-foreground\">\n          Qdrant is a high-performance vector database for semantic search,\n          recommendations, and RAG (Retrieval-Augmented Generation)\n          applications.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Setup</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`# .env\nQDRANT_URL=https://...\nQDRANT_API_KEY=...\nQDRANT_COLLECTION=documents`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Storing vectors</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`capabilityId: qdrant-upsert\nprovider:\n  type: qdrant\n  operation: upsert\n\ninputs:\n  collection:\n    type: string\n  points:\n    type: array\n    items:\n      type: object\n      properties:\n        id: string\n        vector: array\n        payload: object\n\noutputs:\n  status:\n    type: string`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Semantic search</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`capabilityId: qdrant-search\nprovider:\n  type: qdrant\n  operation: search\n\ninputs:\n  collection:\n    type: string\n  vector:\n    type: array\n    items:\n      type: number\n  limit:\n    type: number\n    default: 10\n\noutputs:\n  results:\n    type: array\n    items:\n      type: object\n      properties:\n        id: string\n        score: number\n        payload: object`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">RAG workflow example</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`workflowId: rag-query\nversion: '1.0.0'.0.0\n\nsteps:\n  - id: generate-embedding\n    capability: openai-embeddings\n    inputs:\n      text: \\$\\{input.query\\}\n\n  - id: search-documents\n    capability: qdrant-search\n    inputs:\n      collection: \"documents\"\n      vector: \\$\\{steps.generate-embedding.output.embedding\\}\n      limit: 5\n\n  - id: generate-answer\n    capability: openai-chat\n    inputs:\n      messages:\n        - role: \"system\"\n          content: \"Answer based on the context provided\"\n        - role: \"user\"\n          content: |\n            Context: \\$\\{steps.search-documents.output.results\\}\n            Question: \\$\\{input.query\\}`}</pre>\n        </div>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/integrations/elevenlabs\" className=\"btn-ghost\">\n          Previous: ElevenLabs\n        </Link>\n        <Link href=\"/docs/integrations/s3\" className=\"btn-primary\">\n          Next: S3 Storage <ChevronRight size={16} />\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;AAUA,SAAgB,yBAAyB;AACvC,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAW,EAC9C,oBAAC;KAAE,WAAU;eAAwB;MAIjC;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAU,EAC7C,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;+BAGmB;MACrB;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAoB,EACvD,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;oBAmBQ;MACV;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAoB,EACvD,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;;;;2BAwBe;MACjB;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAyB,EAC5D,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;;;;;2CAyB+B;MACjC;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAK,MAAK;KAAgC,WAAU;eAAY;MAE1D,EACP,qBAAC;KAAK,MAAK;KAAwB,WAAU;gBAAc,qBACxC,oBAAC,gBAAa,MAAM,KAAM;MACtC;KACH;;GACF"}

package/dist/components/docs/integrations/IntegrationsResendPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IntegrationsResendPage.js","names":[],"sources":["../../../../src/components/docs/integrations/IntegrationsResendPage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\n// export const metadata = {\n//   title: 'Resend Integration: ContractSpec Docs',\n//   description:\n//     \"Send transactional emails with Resend's modern API in ContractSpec.\",\n// };\n\nexport function IntegrationsResendPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Resend</h1>\n        <p className=\"text-muted-foreground\">\n          Resend is a modern email API built for developers. It provides a\n          simple, reliable way to send transactional emails with React Email\n          templates.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Setup</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`# .env\nRESEND_API_KEY=re_...\nRESEND_FROM_EMAIL=onboarding@resend.dev`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Sending emails</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`capabilityId: resend-send-email\nprovider:\n  type: resend\n  operation: sendEmail\n\ninputs:\n  to:\n    type: string\n  subject:\n    type: string\n  html:\n    type: string\n  text:\n    type: string\n    optional: true\n  replyTo:\n    type: string\n    optional: true\n\noutputs:\n  id:\n    type: string`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Best practices</h2>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>Use React Email for type-safe templates</li>\n          <li>Verify your domain for better deliverability</li>\n          <li>Monitor email analytics in the Resend dashboard</li>\n        </ul>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/integrations/postmark\" className=\"btn-ghost\">\n          Previous: Postmark\n        </Link>\n        <Link href=\"/docs/integrations/gmail\" className=\"btn-primary\">\n          Next: Gmail API <ChevronRight size={16} />\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;AASA,SAAgB,yBAAyB;AACvC,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAW,EAC9C,oBAAC;KAAE,WAAU;eAAwB;MAIjC;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAU,EAC7C,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;2CAE+B;MACjC;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAmB,EACtD,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;oBAqBQ;MACV;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAmB,EACtD,qBAAC;KAAG,WAAU;;MACZ,oBAAC,kBAAG,4CAA4C;MAChD,oBAAC,kBAAG,iDAAiD;MACrD,oBAAC,kBAAG,oDAAoD;;MACrD;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAK,MAAK;KAA8B,WAAU;eAAY;MAExD,EACP,qBAAC;KAAK,MAAK;KAA2B,WAAU;gBAAc,oBAC5C,oBAAC,gBAAa,MAAM,KAAM;MACrC;KACH;;GACF"}

package/dist/components/docs/integrations/IntegrationsS3Page.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IntegrationsS3Page.js","names":[],"sources":["../../../../src/components/docs/integrations/IntegrationsS3Page.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\n// export const metadata = {\n//   title: 'S3-Compatible Storage Integration: ContractSpec Docs',\n//   description:\n//     'Store and retrieve files with S3-compatible object storage in ContractSpec.',\n// };\n\nexport function IntegrationsS3Page() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">S3-Compatible Storage</h1>\n        <p className=\"text-muted-foreground\">\n          Store files, images, and documents using any S3-compatible object\n          storage service including AWS S3, Scaleway Object Storage, MinIO,\n          DigitalOcean Spaces, and more.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Setup</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`# .env\nS3_ENDPOINT=https://s3.fr-par.scw.cloud\nS3_ACCESS_KEY_ID=...\nS3_SECRET_ACCESS_KEY=...\nS3_BUCKET=my-bucket\nS3_REGION=fr-par`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Uploading files</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`capabilityId: s3-upload\nprovider:\n  type: s3\n  operation: upload\n\ninputs:\n  key:\n    type: string\n    description: \"File path in bucket\"\n  file:\n    type: file\n  contentType:\n    type: string\n    optional: true\n  metadata:\n    type: object\n    optional: true\n\noutputs:\n  url:\n    type: string\n  etag:\n    type: string`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Generating presigned URLs</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`capabilityId: s3-presigned-url\nprovider:\n  type: s3\n  operation: getPresignedUrl\n\ninputs:\n  key:\n    type: string\n  expiresIn:\n    type: number\n    default: 3600\n    description: \"Expiration in seconds\"\n\noutputs:\n  url:\n    type: string`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Best practices</h2>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>Use presigned URLs for secure, temporary access</li>\n          <li>Set appropriate CORS policies for browser uploads</li>\n          <li>Enable versioning for important files</li>\n          <li>Use lifecycle policies to archive old files</li>\n          <li>Organize files with a clear key structure</li>\n        </ul>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/integrations/qdrant\" className=\"btn-ghost\">\n          Previous: Qdrant\n        </Link>\n        <Link href=\"/docs/integrations/twilio\" className=\"btn-primary\">\n          Next: Twilio <ChevronRight size={16} />\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;AASA,SAAgB,qBAAqB;AACnC,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAA0B,EAC7D,oBAAC;KAAE,WAAU;eAAwB;MAIjC;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAU,EAC7C,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;oBAKQ;MACV;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAoB,EACvD,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;;oBAsBQ;MACV;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAA8B,EACjE,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;;;;;;;;;;;oBAeQ;MACV;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAmB,EACtD,qBAAC;KAAG,WAAU;;MACZ,oBAAC,kBAAG,oDAAoD;MACxD,oBAAC,kBAAG,sDAAsD;MAC1D,oBAAC,kBAAG,0CAA0C;MAC9C,oBAAC,kBAAG,gDAAgD;MACpD,oBAAC,kBAAG,8CAA8C;;MAC/C;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAK,MAAK;KAA4B,WAAU;eAAY;MAEtD,EACP,qBAAC;KAAK,MAAK;KAA4B,WAAU;gBAAc,iBAChD,oBAAC,gBAAa,MAAM,KAAM;MAClC;KACH;;GACF"}

package/dist/components/docs/integrations/IntegrationsSpecModelPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IntegrationsSpecModelPage.js","names":[],"sources":["../../../../src/components/docs/integrations/IntegrationsSpecModelPage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\n// export const metadata = {\n//   title: 'Integration Spec Model: ContractSpec Docs',\n//   description:\n//     'Learn about IntegrationSpec and IntegrationConnection in ContractSpec.',\n// };\n\nexport function IntegrationsSpecModelPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Integration Spec Model</h1>\n        <p className=\"text-muted-foreground\">\n          Integrations in ContractSpec are defined through typed specifications\n          that declare capabilities, configuration requirements, and connection\n          details. This page covers IntegrationSpec and IntegrationConnection.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">IntegrationSpec</h2>\n        <p className=\"text-muted-foreground\">\n          The <strong>IntegrationSpec</strong> is a global definition of an\n          integration provider. It declares what the integration provides and\n          what it requires.\n        </p>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`type IntegrationSpec = {\n  id: string;\n  label: string;\n  description: string;\n  category: IntegrationCategory;\n  \n  // Capabilities this integration provides\n  providesCapabilities: {\n    capabilityId: string;\n    operation: string;\n    description: string;\n  }[];\n  \n  // Dependencies\n  requirements: {\n    capabilities?: string[];  // e.g., [\"billing.core\", \"auth.session\"]\n    minVersion?: string;\n  };\n  \n  // Configuration schema (non-secret)\n  configSchema: {\n    [key: string]: {\n      type: string;\n      description: string;\n      required?: boolean;\n      default?: unknown;\n    };\n  };\n  \n  // Secret schema (for keys, tokens)\n  secretSchema: {\n    [key: string]: {\n      type: string;\n      description: string;\n      required: boolean;\n    };\n  };\n  \n  // Webhook support\n  webhooks?: {\n    supported: boolean;\n    events: string[];\n    signatureHeader?: string;\n  };\n  \n  // Documentation\n  docsUrl?: string;\n  setupGuideUrl?: string;\n  \n  // Metadata\n  version: string;\n  createdAt: string;\n  updatedAt: string;\n};`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Example: Stripe IntegrationSpec</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`{\n  id: \"stripe\",\n  label: \"Stripe\",\n  description: \"Payment processing and subscription management\",\n  category: \"payments\",\n  \n  providesCapabilities: [\n    {\n      capabilityId: \"payments.createPaymentIntent\",\n      operation: \"createPaymentIntent\",\n      description: \"Create a payment intent for checkout\"\n    },\n    {\n      capabilityId: \"payments.createSubscription\",\n      operation: \"createSubscription\",\n      description: \"Create a recurring subscription\"\n    },\n    {\n      capabilityId: \"payments.refund\",\n      operation: \"refund\",\n      description: \"Refund a payment\"\n    }\n  ],\n  \n  requirements: {\n    capabilities: [\"billing.core\"],\n    minVersion: \"1.0.0\"\n  },\n  \n  configSchema: {\n    webhookUrl: {\n      type: \"string\",\n      description: \"URL to receive Stripe webhooks\",\n      required: false\n    }\n  },\n  \n  secretSchema: {\n    apiKey: {\n      type: \"string\",\n      description: \"Stripe secret API key (sk_...)\",\n      required: true\n    },\n    webhookSecret: {\n      type: \"string\",\n      description: \"Webhook signing secret (whsec_...)\",\n      required: false\n    }\n  },\n  \n  webhooks: {\n    supported: true,\n    events: [\n      \"payment_intent.succeeded\",\n      \"payment_intent.payment_failed\",\n      \"customer.subscription.created\",\n      \"customer.subscription.updated\",\n      \"customer.subscription.deleted\"\n    ],\n    signatureHeader: \"stripe-signature\"\n  },\n  \n  docsUrl: \"https://docs.contractspec.com/integrations/stripe\",\n  setupGuideUrl: \"https://stripe.com/docs/keys\",\n  version: \"1.0.0\"\n}`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">IntegrationConnection</h2>\n        <p className=\"text-muted-foreground\">\n          An <strong>IntegrationConnection</strong> is a per-tenant instance of\n          an integration with configured credentials and environment settings.\n        </p>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`type IntegrationConnection = {\n  id: string;\n  tenantId: string;\n  integrationId: string;\n  \n  // Environment\n  environment: \"sandbox\" | \"production\";\n  \n  // Configuration (non-secret)\n  config: Record<string, unknown>;\n  \n  // Secret reference (encrypted, never exposed)\n  secretRef: string;\n  \n  // Status\n  status: \"connected\" | \"disconnected\" | \"error\";\n  lastHealthCheck?: string;\n  lastHealthCheckStatus?: \"success\" | \"failure\";\n  lastErrorMessage?: string;\n  \n  // Metadata\n  createdAt: string;\n  updatedAt: string;\n  createdBy: string;\n};`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">\n          Example: Stripe IntegrationConnection\n        </h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`// Production connection\n{\n  id: \"conn_stripe_acme_prod\",\n  tenantId: \"acme-corp\",\n  integrationId: \"stripe\",\n  environment: \"production\",\n  config: {\n    webhookUrl: \"https://acme.app/webhooks/stripe\"\n  },\n  secretRef: \"secret_stripe_acme_prod_v1\",\n  status: \"connected\",\n  lastHealthCheck: \"2025-01-15T10:30:00Z\",\n  lastHealthCheckStatus: \"success\",\n  createdAt: \"2025-01-01T00:00:00Z\",\n  updatedAt: \"2025-01-15T10:30:00Z\",\n  createdBy: \"admin@acme.com\"\n}\n\n// Sandbox connection\n{\n  id: \"conn_stripe_acme_test\",\n  tenantId: \"acme-corp\",\n  integrationId: \"stripe\",\n  environment: \"sandbox\",\n  config: {\n    webhookUrl: \"https://sandbox.acme.app/webhooks/stripe\"\n  },\n  secretRef: \"secret_stripe_acme_test_v1\",\n  status: \"connected\",\n  lastHealthCheck: \"2025-01-15T10:25:00Z\",\n  lastHealthCheckStatus: \"success\",\n  createdAt: \"2025-01-01T00:00:00Z\",\n  updatedAt: \"2025-01-15T10:25:00Z\",\n  createdBy: \"dev@acme.com\"\n}`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Health checks</h2>\n        <p className=\"text-muted-foreground\">\n          IntegrationConnections are periodically health-checked to ensure they\n          remain valid:\n        </p>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>\n            <strong>API key validation</strong> - Test that credentials are\n            still valid\n          </li>\n          <li>\n            <strong>Connectivity check</strong> - Verify network access to the\n            provider\n          </li>\n          <li>\n            <strong>Permission verification</strong> - Ensure required scopes\n            are granted\n          </li>\n          <li>\n            <strong>Webhook validation</strong> - Test webhook endpoint\n            reachability\n          </li>\n        </ul>\n        <p className=\"text-muted-foreground\">\n          Failed health checks update the connection status to \"error\" and\n          trigger alerts.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Secret management</h2>\n        <p className=\"text-muted-foreground\">\n          Secrets (API keys, tokens) are never stored in plaintext:\n        </p>\n        <ol className=\"text-muted-foreground list-inside list-decimal space-y-2\">\n          <li>User provides secrets through secure UI or API</li>\n          <li>Secrets are encrypted using tenant-specific keys</li>\n          <li>\n            Encrypted secrets are stored in secure vault (e.g., AWS Secrets\n            Manager)\n          </li>\n          <li>IntegrationConnection stores only a reference (secretRef)</li>\n          <li>At runtime, secrets are decrypted on-demand and never logged</li>\n        </ol>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Best practices</h2>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>Always maintain separate sandbox and production connections</li>\n          <li>\n            Use descriptive connection IDs that include tenant and environment\n          </li>\n          <li>Monitor health check status and set up alerts for failures</li>\n          <li>Rotate secrets regularly and update secretRef accordingly</li>\n          <li>Document the purpose and ownership of each connection</li>\n          <li>Test connections in sandbox before enabling in production</li>\n        </ul>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/integrations\" className=\"btn-ghost\">\n          Back to Integrations\n        </Link>\n        <Link\n          href=\"/docs/architecture/integration-binding\"\n          className=\"btn-primary\"\n        >\n          Integration Binding <ChevronRight size={16} />\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;AASA,SAAgB,4BAA4B;AAC1C,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAA2B,EAC9D,oBAAC;KAAE,WAAU;eAAwB;MAIjC;KACA;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAoB;KACvD,qBAAC;MAAE,WAAU;;OAAwB;OAC/B,oBAAC,sBAAO,oBAAwB;;;OAGlC;KACJ,oBAAC;MAAI,WAAU;gBACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAqDN;OACI;;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAoC,EACvE,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiEP;MACK;KACF;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAA0B;KAC7D,qBAAC;MAAE,WAAU;;OAAwB;OAChC,oBAAC,sBAAO,0BAA8B;;;OAEvC;KACJ,oBAAC;MAAI,WAAU;gBACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;;;;MAwBN;OACI;;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAE9B,EACL,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkCP;MACK;KACF;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAkB;KACrD,oBAAC;MAAE,WAAU;gBAAwB;OAGjC;KACJ,qBAAC;MAAG,WAAU;;OACZ,qBAAC,mBACC,oBAAC,sBAAO,uBAA2B,gDAEhC;OACL,qBAAC,mBACC,oBAAC,sBAAO,uBAA2B,gDAEhC;OACL,qBAAC,mBACC,oBAAC,sBAAO,4BAAgC,6CAErC;OACL,qBAAC,mBACC,oBAAC,sBAAO,uBAA2B,6CAEhC;;OACF;KACL,oBAAC;MAAE,WAAU;gBAAwB;OAGjC;;KACA;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAsB;KACzD,oBAAC;MAAE,WAAU;gBAAwB;OAEjC;KACJ,qBAAC;MAAG,WAAU;;OACZ,oBAAC,kBAAG,mDAAmD;OACvD,oBAAC,kBAAG,qDAAqD;OACzD,oBAAC,kBAAG,6EAGC;OACL,oBAAC,kBAAG,8DAA8D;OAClE,oBAAC,kBAAG,iEAAiE;;OAClE;;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAmB,EACtD,qBAAC;KAAG,WAAU;;MACZ,oBAAC,kBAAG,gEAAgE;MACpE,oBAAC,kBAAG,uEAEC;MACL,oBAAC,kBAAG,+DAA+D;MACnE,oBAAC,kBAAG,8DAA8D;MAClE,oBAAC,kBAAG,0DAA0D;MAC9D,oBAAC,kBAAG,8DAA8D;;MAC/D;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAK,MAAK;KAAqB,WAAU;eAAY;MAE/C,EACP,qBAAC;KACC,MAAK;KACL,WAAU;gBACX,wBACqB,oBAAC,gBAAa,MAAM,KAAM;MACzC;KACH;;GACF"}

package/dist/components/docs/integrations/IntegrationsStripePage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IntegrationsStripePage.js","names":[],"sources":["../../../../src/components/docs/integrations/IntegrationsStripePage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\n// export const metadata = {\n//   title: 'Stripe Integration: ContractSpec Docs',\n//   description:\n//     'Accept payments, manage subscriptions, and handle invoicing with Stripe in ContractSpec.',\n// };\n\nexport function IntegrationsStripePage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Stripe</h1>\n        <p className=\"text-muted-foreground\">\n          The Stripe integration enables payment processing, subscription\n          management, and invoicing in your ContractSpec applications. All\n          Stripe operations are type-safe, policy-enforced, and automatically\n          logged.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Setup</h2>\n        <p className=\"text-muted-foreground\">\n          Add your Stripe credentials to your environment variables:\n        </p>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`# .env\nSTRIPE_SECRET_KEY=sk_test_...\nSTRIPE_PUBLISHABLE_KEY=pk_test_...\nSTRIPE_WEBHOOK_SECRET=whsec_...`}</pre>\n        </div>\n        <p className=\"text-muted-foreground text-sm\">\n          Get your API keys from the{' '}\n          <a\n            href=\"https://dashboard.stripe.com/apikeys\"\n            target=\"_blank\"\n            rel=\"noopener noreferrer\"\n            className=\"text-violet-400 hover:text-violet-300\"\n          >\n            Stripe Dashboard\n          </a>\n          .\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Available capabilities</h2>\n        <div className=\"space-y-3\">\n          <h3 className=\"text-lg font-semibold\">Payment Intents</h3>\n          <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n            <pre>{`capabilityId: stripe-create-payment-intent\nprovider:\n  type: stripe\n  operation: createPaymentIntent\n\ninputs:\n  amount:\n    type: number\n    description: \"Amount in cents\"\n  currency:\n    type: string\n    default: \"usd\"\n  customerId:\n    type: string\n    optional: true\n  metadata:\n    type: object\n    optional: true\n\noutputs:\n  paymentIntentId:\n    type: string\n  clientSecret:\n    type: string\n  status:\n    type: string`}</pre>\n          </div>\n        </div>\n\n        <div className=\"space-y-3\">\n          <h3 className=\"text-lg font-semibold\">Customers</h3>\n          <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n            <pre>{`capabilityId: stripe-create-customer\nprovider:\n  type: stripe\n  operation: createCustomer\n\ninputs:\n  email:\n    type: string\n  name:\n    type: string\n    optional: true\n  metadata:\n    type: object\n    optional: true\n\noutputs:\n  customerId:\n    type: string\n  email:\n    type: string`}</pre>\n          </div>\n        </div>\n\n        <div className=\"space-y-3\">\n          <h3 className=\"text-lg font-semibold\">Subscriptions</h3>\n          <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n            <pre>{`capabilityId: stripe-create-subscription\nprovider:\n  type: stripe\n  operation: createSubscription\n\ninputs:\n  customerId:\n    type: string\n  priceId:\n    type: string\n  trialDays:\n    type: number\n    optional: true\n\noutputs:\n  subscriptionId:\n    type: string\n  status:\n    type: string\n  currentPeriodEnd:\n    type: timestamp`}</pre>\n          </div>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Webhooks</h2>\n        <p className=\"text-muted-foreground\">\n          ContractSpec automatically handles Stripe webhooks. Configure your\n          webhook endpoint in the Stripe Dashboard:\n        </p>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`https://your-app.com/api/webhooks/stripe`}</pre>\n        </div>\n        <p className=\"text-muted-foreground\">Subscribe to these events:</p>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>\n            <code className=\"bg-background/50 rounded px-2 py-1\">\n              payment_intent.succeeded\n            </code>\n          </li>\n          <li>\n            <code className=\"bg-background/50 rounded px-2 py-1\">\n              payment_intent.payment_failed\n            </code>\n          </li>\n          <li>\n            <code className=\"bg-background/50 rounded px-2 py-1\">\n              customer.subscription.created\n            </code>\n          </li>\n          <li>\n            <code className=\"bg-background/50 rounded px-2 py-1\">\n              customer.subscription.updated\n            </code>\n          </li>\n          <li>\n            <code className=\"bg-background/50 rounded px-2 py-1\">\n              customer.subscription.deleted\n            </code>\n          </li>\n        </ul>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Example workflow</h2>\n        <p className=\"text-muted-foreground\">\n          Here's a complete payment workflow using Stripe:\n        </p>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`workflowId: process-payment\nversion: '1.0.0'.0.0\n\nsteps:\n  - id: create-customer\n    capability: stripe-create-customer\n    inputs:\n      email: $\\{input.customerEmail}\n      name: $\\{input.customerName}\n    onSuccess: create-payment-intent\n    onFailure: notify-error\n\n  - id: create-payment-intent\n    capability: stripe-create-payment-intent\n    inputs:\n      amount: $\\{input.amount}\n      currency: \"usd\"\n      customerId: $\\{steps.create-customer.output.customerId}\n    onSuccess: send-payment-link\n    onFailure: notify-error\n\n  - id: send-payment-link\n    capability: send-email\n    inputs:\n      to: $\\{input.customerEmail}\n      template: \"payment-link\"\n      data:\n        clientSecret: $\\{steps.create-payment-intent.output.clientSecret}\n        amount: $\\{input.amount}\n\n  - id: notify-error\n    capability: send-email\n    inputs:\n      to: \"admin@example.com\"\n      template: \"payment-error\"\n      data:\n        error: $\\{error.message}`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Testing</h2>\n        <p className=\"text-muted-foreground\">\n          Use Stripe's test cards for development:\n        </p>\n        <div className=\"border-border/50 overflow-x-auto rounded-lg border\">\n          <table className=\"w-full text-left text-sm\">\n            <thead className=\"bg-card/50\">\n              <tr className=\"border-border/50 border-b\">\n                <th className=\"px-4 py-3 font-semibold\">Card Number</th>\n                <th className=\"px-4 py-3 font-semibold\">Scenario</th>\n              </tr>\n            </thead>\n            <tbody className=\"divide-border/50 divide-y\">\n              <tr>\n                <td className=\"px-4 py-3 font-mono\">4242 4242 4242 4242</td>\n                <td className=\"px-4 py-3\">Successful payment</td>\n              </tr>\n              <tr>\n                <td className=\"px-4 py-3 font-mono\">4000 0000 0000 9995</td>\n                <td className=\"px-4 py-3\">Insufficient funds</td>\n              </tr>\n              <tr>\n                <td className=\"px-4 py-3 font-mono\">4000 0000 0000 0002</td>\n                <td className=\"px-4 py-3\">Card declined</td>\n              </tr>\n            </tbody>\n          </table>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Best practices</h2>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>Always use test mode during development</li>\n          <li>Verify webhook signatures to prevent fraud</li>\n          <li>Handle idempotency for payment operations</li>\n          <li>Store customer IDs for recurring payments</li>\n          <li>\n            Use metadata to link Stripe objects to your application records\n          </li>\n          <li>Monitor failed payments and retry logic</li>\n        </ul>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/integrations\" className=\"btn-ghost\">\n          Back to Integrations\n        </Link>\n        <Link href=\"/docs/integrations/postmark\" className=\"btn-primary\">\n          Next: Postmark <ChevronRight size={16} />\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/components/docs/integrations/IntegrationsTwilioPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IntegrationsTwilioPage.js","names":[],"sources":["../../../../src/components/docs/integrations/IntegrationsTwilioPage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\n\n// export const metadata = {\n//   title: 'Twilio Integration: ContractSpec Docs',\n//   description:\n//     'Send SMS notifications and messages with Twilio in ContractSpec.',\n// };\n\nexport function IntegrationsTwilioPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Twilio</h1>\n        <p className=\"text-muted-foreground\">\n          Send SMS notifications, alerts, and two-factor authentication codes\n          using Twilio's reliable messaging platform.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Setup</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`# .env\nTWILIO_ACCOUNT_SID=...\nTWILIO_AUTH_TOKEN=...\nTWILIO_PHONE_NUMBER=+1234567890`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Sending SMS</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`capabilityId: twilio-send-sms\nprovider:\n  type: twilio\n  operation: sendSMS\n\ninputs:\n  to:\n    type: string\n    description: \"Phone number in E.164 format\"\n  body:\n    type: string\n    description: \"Message content (max 1600 chars)\"\n\noutputs:\n  messageSid:\n    type: string\n  status:\n    type: string`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Use cases</h2>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>Order confirmations and shipping updates</li>\n          <li>Two-factor authentication codes</li>\n          <li>Appointment reminders</li>\n          <li>Alert notifications</li>\n        </ul>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Best practices</h2>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>Always use E.164 format for phone numbers (+1234567890)</li>\n          <li>Keep messages under 160 characters to avoid splitting</li>\n          <li>Implement rate limiting to prevent spam</li>\n          <li>Handle delivery failures gracefully</li>\n          <li>Respect opt-out requests</li>\n        </ul>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/integrations/s3\" className=\"btn-ghost\">\n          Previous: S3 Storage\n        </Link>\n        <Link href=\"/docs/integrations\" className=\"btn-primary\">\n          Back to Integrations\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;AAQA,SAAgB,yBAAyB;AACvC,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAW,EAC9C,oBAAC;KAAE,WAAU;eAAwB;MAGjC;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAU,EAC7C,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;mCAGuB;MACzB;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAgB,EACnD,oBAAC;KAAI,WAAU;eACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;oBAiBQ;MACV;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAc,EACjD,qBAAC;KAAG,WAAU;;MACZ,oBAAC,kBAAG,6CAA6C;MACjD,oBAAC,kBAAG,oCAAoC;MACxC,oBAAC,kBAAG,0BAA0B;MAC9B,oBAAC,kBAAG,wBAAwB;;MACzB;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAmB,EACtD,qBAAC;KAAG,WAAU;;MACZ,oBAAC,kBAAG,4DAA4D;MAChE,oBAAC,kBAAG,0DAA0D;MAC9D,oBAAC,kBAAG,4CAA4C;MAChD,oBAAC,kBAAG,wCAAwC;MAC5C,oBAAC,kBAAG,6BAA6B;;MAC9B;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAK,MAAK;KAAwB,WAAU;eAAY;MAElD,EACP,oBAAC;KAAK,MAAK;KAAqB,WAAU;eAAc;MAEjD;KACH;;GACF"}

package/dist/components/docs/intent/ContractFirstApiPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ContractFirstApiPage.js","names":[],"sources":["../../../../src/components/docs/intent/ContractFirstApiPage.tsx"],"sourcesContent":["import type { Metadata } from 'next';\nimport { contractFirstApiBrief } from '@contractspec/bundle.library/components/docs/intent/intent-pages.docblocks';\nimport { SeoOptimizer } from '@contractspec/lib.content-gen/seo';\nimport { CodeBlock } from '@contractspec/lib.design-system';\nimport Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\nexport const metadata: Metadata = new SeoOptimizer().optimize(\n  contractFirstApiBrief\n);\n\nexport function ContractFirstApiPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-3\">\n        <h1 className=\"text-4xl font-bold\">{contractFirstApiBrief.title}</h1>\n        <p className=\"text-muted-foreground text-lg\">\n          {contractFirstApiBrief.summary}\n        </p>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">Problems Solved</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {contractFirstApiBrief.problems.map((problem, index) => (\n            <li key={index}>{problem}</li>\n          ))}\n        </ul>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">Solutions</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {contractFirstApiBrief.solutions.map((solution, index) => (\n            <li key={index}>{solution}</li>\n          ))}\n        </ul>\n      </div>\n\n      <div className=\"space-y-6\">\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Quick Start</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Define your first API contract and generate consistent\n            implementations.\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"src/contracts/user-create.operation.ts\"\n            code={`import { defineOperation } from '@contractspec/lib.contracts/operations';\nimport { SchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\n\nexport const CreateUserOperation = defineOperation({\n  goal: 'Create a new user account with validation',\n  context: 'Used by frontend registration forms and internal admin tools',\n  input: new SchemaModel({\n    type: 'object',\n    properties: {\n      email: {\n        type: 'string',\n        format: 'email',\n        required: true,\n      },\n      password: {\n        type: 'string',\n        minLength: 8,\n        required: true,\n      },\n    },\n  }),\n  output: new SchemaModel({\n    type: 'object',\n    properties: {\n      id: { type: 'string', required: true },\n      email: { type: 'string', required: true },\n      createdAt: { type: 'string', format: 'date-time', required: true },\n    },\n  }),\n  metadata: {\n    name: 'createUser',\n    tags: ['users', 'auth'],\n    description: 'Create a new user account with email and password',\n  },\n});`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Generate OpenAPI</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Export OpenAPI documentation directly from your contracts.\n          </p>\n          <CodeBlock\n            language=\"bash\"\n            filename=\"export-openapi\"\n            code={`contractspec openapi export \\\\\n  --registry ./src/contracts/registry.ts \\\\\n  --out ./openapi.json`}\n          />\n        </div>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/guides/nextjs-one-endpoint\" className=\"btn-primary\">\n          Next.js Guide <ChevronRight size={16} />\n        </Link>\n        <Link href=\"/docs/intent/spec-driven-development\" className=\"btn-ghost\">\n          Spec-driven Development\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;AAOA,MAAa,WAAqB,IAAI,cAAc,CAAC,SACnD,sBACD;AAED,SAAgB,uBAAuB;AACrC,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAsB,sBAAsB;MAAW,EACrE,oBAAC;KAAE,WAAU;eACV,sBAAsB;MACrB;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAoB,EACvD,oBAAC;KAAG,WAAU;eACX,sBAAsB,SAAS,KAAK,SAAS,UAC5C,oBAAC,kBAAgB,WAAR,MAAqB,CAC9B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAc,EACjD,oBAAC;KAAG,WAAU;eACX,sBAAsB,UAAU,KAAK,UAAU,UAC9C,oBAAC,kBAAgB,YAAR,MAAsB,CAC/B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,qBAAC;KAAI,WAAU;;MACb,oBAAC;OAAG,WAAU;iBAAqB;QAAgB;MACnD,oBAAC;OAAE,WAAU;iBAAgC;QAGzC;MACJ,oBAAC;OACC,UAAS;OACT,UAAS;OACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAmCN;;MACE,EAEN,qBAAC;KAAI,WAAU;;MACb,oBAAC;OAAG,WAAU;iBAAqB;QAAqB;MACxD,oBAAC;OAAE,WAAU;iBAAgC;QAEzC;MACJ,oBAAC;OACC,UAAS;OACT,UAAS;OACT,MAAM;;;QAGN;;MACE;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,qBAAC;KAAK,MAAK;KAAmC,WAAU;gBAAc,kBACtD,oBAAC,gBAAa,MAAM,KAAM;MACnC,EACP,oBAAC;KAAK,MAAK;KAAuC,WAAU;eAAY;MAEjE;KACH;;GACF"}

package/dist/components/docs/intent/DeterministicCodegenPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"DeterministicCodegenPage.js","names":[],"sources":["../../../../src/components/docs/intent/DeterministicCodegenPage.tsx"],"sourcesContent":["import type { Metadata } from 'next';\nimport { deterministicCodegenBrief } from '@contractspec/bundle.library/components/docs/intent/intent-pages.docblocks';\nimport { SeoOptimizer } from '@contractspec/lib.content-gen/seo';\n\nexport const metadata: Metadata = new SeoOptimizer().optimize(\n  deterministicCodegenBrief\n);\nimport { CodeBlock } from '@contractspec/lib.design-system';\nimport Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\nexport function DeterministicCodegenPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-3\">\n        <h1 className=\"text-4xl font-bold\">\n          {deterministicCodegenBrief.title}\n        </h1>\n        <p className=\"text-muted-foreground text-lg\">\n          {deterministicCodegenBrief.summary}\n        </p>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">Regeneration Challenges</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {deterministicCodegenBrief.problems.map((problem, index) => (\n            <li key={index}>{problem}</li>\n          ))}\n        </ul>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">Deterministic Solutions</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {deterministicCodegenBrief.solutions.map((solution, index) => (\n            <li key={index}>{solution}</li>\n          ))}\n        </ul>\n      </div>\n\n      <div className=\"space-y-6\">\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Protected Zones</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Separate generated code from hand-written business logic with clear\n            boundaries.\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"src/handlers/user-handlers.ts\"\n            code={`// Hand-written business logic (protected from regeneration)\nexport class UserService {\n  async createUser(input: CreateUserInput): Promise<CreateUserOutput> {\n    // Custom validation and business rules\n    if (await this.emailExists(input.email)) {\n      throw new Error('Email already exists');\n    }\n    \n    // Persistence logic\n    const user = await this.repository.create({\n      email: input.email,\n      name: input.name,\n      password: await this.hashPassword(input.password),\n    });\n    \n    return {\n      id: user.id,\n      email: user.email,\n      name: user.name,\n      createdAt: user.createdAt.toISOString(),\n    };\n  }\n  \n  private async emailExists(email: string): Promise<boolean> {\n    // Custom business validation\n    return !!(await this.repository.findByEmail(email));\n  }\n}\n\n// Generated handler wrapper (can be regenerated safely)\nexport const createUserHandler = wrapOperationHandler(\n  UserService.prototype.createUser,\n  {\n    serviceName: 'UserService',\n    operationName: 'createUser',\n    errorMapper: mapToStandardErrors,\n  }\n);`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Incremental Regeneration</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Regenerate only what changed while preserving custom logic.\n          </p>\n          <CodeBlock\n            language=\"bash\"\n            filename=\"incremental-regen\"\n            code={`contractspec generate \\\\\n  --incremental \\\\\n  --preserve-zones ./src/handlers/*.ts \\\\\n  --input ./src/contracts/ \\\\\n  --output ./generated/`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Conflict Detection</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Automatically detect and report conflicts during regeneration.\n          </p>\n          <CodeBlock\n            language=\"bash\"\n            filename=\"check-conflicts\"\n            code={`contractspec generate \\\\\n  --check-conflicts \\\\\n  --report-conflicts ./conflicts.json`}\n          />\n        </div>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link\n          href=\"/docs/guides/generate-docs-clients-schemas\"\n          className=\"btn-primary\"\n        >\n          Client Generation <ChevronRight size={16} />\n        </Link>\n        <Link\n          href=\"/docs/intent/schema-validation-typescript\"\n          className=\"btn-ghost\"\n        >\n          Type Safety\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;AAIA,MAAa,WAAqB,IAAI,cAAc,CAAC,SACnD,0BACD;AAKD,SAAgB,2BAA2B;AACzC,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eACX,0BAA0B;MACxB,EACL,oBAAC;KAAE,WAAU;eACV,0BAA0B;MACzB;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAA4B,EAC/D,oBAAC;KAAG,WAAU;eACX,0BAA0B,SAAS,KAAK,SAAS,UAChD,oBAAC,kBAAgB,WAAR,MAAqB,CAC9B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAA4B,EAC/D,oBAAC;KAAG,WAAU;eACX,0BAA0B,UAAU,KAAK,UAAU,UAClD,oBAAC,kBAAgB,YAAR,MAAsB,CAC/B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;;KACb,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAoB;OACvD,oBAAC;QAAE,WAAU;kBAAgC;SAGzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAsCN;;OACE;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAA6B;OAChE,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;SAKN;;OACE;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAuB;OAC1D,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;SAGN;;OACE;;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,qBAAC;KACC,MAAK;KACL,WAAU;gBACX,sBACmB,oBAAC,gBAAa,MAAM,KAAM;MACvC,EACP,oBAAC;KACC,MAAK;KACL,WAAU;eACX;MAEM;KACH;;GACF"}

package/dist/components/docs/intent/GenerateClientFromSchemaPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GenerateClientFromSchemaPage.js","names":[],"sources":["../../../../src/components/docs/intent/GenerateClientFromSchemaPage.tsx"],"sourcesContent":["import type { Metadata } from 'next';\nimport { generateClientFromSchemaBrief } from '@contractspec/bundle.library/components/docs/intent/intent-pages.docblocks';\nimport { SeoOptimizer } from '@contractspec/lib.content-gen/seo';\nimport { CodeBlock } from '@contractspec/lib.design-system';\nimport Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\nexport const metadata: Metadata = new SeoOptimizer().optimize(\n  generateClientFromSchemaBrief\n);\n\nexport function GenerateClientFromSchemaPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-3\">\n        <h1 className=\"text-4xl font-bold\">\n          {generateClientFromSchemaBrief.title}\n        </h1>\n        <p className=\"text-muted-foreground text-lg\">\n          {generateClientFromSchemaBrief.summary}\n        </p>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">Client Development Problems</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {generateClientFromSchemaBrief.problems.map((problem, index) => (\n            <li key={index}>{problem}</li>\n          ))}\n        </ul>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">Automated Solutions</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {generateClientFromSchemaBrief.solutions.map((solution, index) => (\n            <li key={index}>{solution}</li>\n          ))}\n        </ul>\n      </div>\n\n      <div className=\"space-y-6\">\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Contract Definition</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Define your API contract once, generate clients for any language.\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"src/contracts/api.contract.ts\"\n            code={`import { defineContract } from '@contractspec/lib.contracts';\nimport { SchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\n\nexport const ApiContract = defineContract({\n  name: 'MyAPI',\n  version: '1.0.0',\n  baseUrl: 'https://api.example.com',\n  operations: {\n    getUsers: {\n      goal: 'Retrieve paginated list of users',\n      method: 'GET',\n      path: '/users',\n      input: new SchemaModel({\n        type: 'object',\n        properties: {\n          page: { type: 'integer', minimum: 1, default: 1 },\n          limit: { type: 'integer', minimum: 1, maximum: 100, default: 20 },\n        },\n      }),\n      output: new SchemaModel({\n        type: 'object',\n        properties: {\n          users: {\n            type: 'array',\n            items: {\n              type: 'object',\n              properties: {\n                id: { type: 'string', required: true },\n                email: { type: 'string', required: true },\n                name: { type: 'string', required: true },\n              },\n            },\n          },\n          pagination: {\n            type: 'object',\n            properties: {\n              page: { type: 'integer', required: true },\n              limit: { type: 'integer', required: true },\n              total: { type: 'integer', required: true },\n            },\n          },\n        },\n      }),\n    },\n    createUser: {\n      goal: 'Create a new user account',\n      method: 'POST',\n      path: '/users',\n      input: new SchemaModel({\n        type: 'object',\n        properties: {\n          email: { type: 'string', format: 'email', required: true },\n          name: { type: 'string', minLength: 1, required: true },\n        },\n      }),\n      output: new SchemaModel({\n        type: 'object',\n        properties: {\n          id: { type: 'string', required: true },\n          email: { type: 'string', required: true },\n          name: { type: 'string', required: true },\n          createdAt: { type: 'string', format: 'date-time', required: true },\n        },\n      }),\n    },\n  },\n  metadata: {\n    description: 'User management API with authentication',\n    tags: ['users', 'authentication'],\n  },\n});`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Generate Multiple Clients</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Generate type-safe clients for any language from the same contract.\n          </p>\n          <CodeBlock\n            language=\"bash\"\n            filename=\"generate-clients\"\n            code={`# Generate all supported language clients\ncontractspec generate clients \\\\\n  --contract ./src/contracts/api.contract.ts \\\\\n  --output ./generated/clients \\\\\n  --languages typescript,python,go,java,csharp\n\n# Generate specific language client\ncontractspec generate clients \\\\\n  --contract ./src/contracts/api.contract.ts \\\\\n  --output ./generated/clients \\\\\n  --languages typescript \\\\\n  --format npm-package\n\n# Options\n# --with-types: Include TypeScript definitions\n# --with-tests: Generate client test suites\n# --with-docs: Include client documentation\n# --framework: Use specific HTTP client framework`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Generated Client Examples</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Each generated client is fully type-safe and idiomatic.\n          </p>\n\n          <div className=\"space-y-4\">\n            <div className=\"card-subtle p-4\">\n              <h4 className=\"text-lg font-semibold\">TypeScript Client</h4>\n              <CodeBlock\n                language=\"typescript\"\n                filename=\"generated/clients/typescript/index.ts\"\n                code={`import { MyAPIClient } from './client';\n\nconst client = new MyAPIClient({\n  baseUrl: 'https://api.example.com',\n  apiKey: process.env.API_KEY,\n});\n\n// Type-safe method calls\nconst users = await client.getUsers({\n  page: 1,\n  limit: 10,\n});\n\nconst newUser = await client.createUser({\n  email: 'user@example.com',\n  name: 'John Doe',\n});\n\n// Full type inference\n// users: GetUsersResponse\n// newUser: CreateUserResponse`}\n              />\n            </div>\n\n            <div className=\"card-subtle p-4\">\n              <h4 className=\"text-lg font-semibold\">Python Client</h4>\n              <CodeBlock\n                language=\"python\"\n                filename=\"generated/clients/python/index.py\"\n                code={`from myapi_client import MyAPIClient\n\nclient = MyAPIClient(\n    base_url='https://api.example.com',\n    api_key=os.getenv('API_KEY')\n)\n\n# Type-safe method calls\nusers = await client.get_users(\n    page=1,\n    limit=10\n)\n\nnew_user = await client.create_user(\n    email='user@example.com',\n    name='John Doe'\n)\n\n# Full type hints\n# users: GetUsersResponse\n# new_user: CreateUserResponse`}\n              />\n            </div>\n\n            <div className=\"card-subtle p-4\">\n              <h4 className=\"text-lg font-semibold\">Go Client</h4>\n              <CodeBlock\n                language=\"go\"\n                filename=\"generated/clients/go/client.go\"\n                code={`package main\n\nimport (\n    \"context\"\n    \"myapi_client\"\n)\n\nfunc main() {\n    client := myapi_client.NewMyAPIClient(\n        myapi_client.WithBaseURL(\"https://api.example.com\"),\n        myapi_client.WithAPIKey(os.Getenv(\"API_KEY\")),\n    )\n    \n    // Type-safe method calls\n    users, err := client.GetUsers(&myapi_client.GetUsersParams{\n        Page: 1,\n        Limit: 10,\n    })\n    \n    newUser, err := client.CreateUser(&myapi_client.CreateUserParams{\n        Email: \"user@example.com\",\n        Name:  \"John Doe\",\n    })\n    \n    // Full type checking at compile time\n    // users: *GetUsersResponse\n    // newUser: *CreateUserResponse\n}`}\n              />\n            </div>\n          </div>\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Advanced Features</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Generated clients include enterprise-grade features out of the box.\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"client-features.ts\"\n            code={`// Advanced client features\nconst client = new MyAPIClient({\n  baseUrl: 'https://api.example.com',\n  apiKey: 'your-api-key',\n  \n  // Retry configuration\n  retryConfig: {\n    maxRetries: 3,\n    backoffMultiplier: 2,\n    maxDelay: 30000,\n  },\n  \n  // Request/Response interceptors\n  interceptors: {\n    request: [(config) => {\n      // Add authentication headers\n      config.headers.Authorization = \\`Bearer \\${await getAuthToken()}\\`;\n      return config;\n    }],\n    response: [(response) => {\n      // Log API calls\n      console.log(\\`API Call: \\${response.config.method} \\${response.config.url}\\`);\n      return response;\n    }],\n  },\n  \n  // Error handling\n  errorHandler: (error) => {\n    if (error.status === 401) {\n      // Refresh token and retry\n      return refreshTokenAndRetry(error.originalRequest);\n    }\n    throw error;\n  },\n});\n\n// Automatic request deduplication\nconst user1 = client.getUser({ id: '123' });\nconst user2 = client.getUser({ id: '123' }); // Uses cached result\n\n// Request cancellation\nconst controller = new AbortController();\nconst promise = client.getUsers({ page: 1, signal: controller.signal });\ncontroller.abort(); // Cancels the request`}\n          />\n        </div>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link\n          href=\"/docs/guides/generate-docs-clients-schemas\"\n          className=\"btn-primary\"\n        >\n          Client Generation Guide <ChevronRight size={16} />\n        </Link>\n        <Link href=\"/docs/intent/contract-first-api\" className=\"btn-ghost\">\n          Contract-first API\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;AAOA,MAAa,WAAqB,IAAI,cAAc,CAAC,SACnD,8BACD;AAED,SAAgB,+BAA+B;AAC7C,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eACX,8BAA8B;MAC5B,EACL,oBAAC;KAAE,WAAU;eACV,8BAA8B;MAC7B;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAgC,EACnE,oBAAC;KAAG,WAAU;eACX,8BAA8B,SAAS,KAAK,SAAS,UACpD,oBAAC,kBAAgB,WAAR,MAAqB,CAC9B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAwB,EAC3D,oBAAC;KAAG,WAAU;eACX,8BAA8B,UAAU,KAAK,UAAU,UACtD,oBAAC,kBAAgB,YAAR,MAAsB,CAC/B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;;KACb,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAwB;OAC3D,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAuEN;;OACE;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAA8B;OACjE,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;;;;;;;;;;;;;;SAkBN;;OACE;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAA8B;OACjE,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OAEJ,qBAAC;QAAI,WAAU;;SACb,qBAAC;UAAI,WAAU;qBACb,oBAAC;WAAG,WAAU;qBAAwB;YAAsB,EAC5D,oBAAC;WACC,UAAS;WACT,UAAS;WACT,MAAM;;;;;;;;;;;;;;;;;;;;;YAqBN;WACE;SAEN,qBAAC;UAAI,WAAU;qBACb,oBAAC;WAAG,WAAU;qBAAwB;YAAkB,EACxD,oBAAC;WACC,UAAS;WACT,UAAS;WACT,MAAM;;;;;;;;;;;;;;;;;;;;;YAqBN;WACE;SAEN,qBAAC;UAAI,WAAU;qBACb,oBAAC;WAAG,WAAU;qBAAwB;YAAc,EACpD,oBAAC;WACC,UAAS;WACT,UAAS;WACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA4BN;WACE;;SACF;;OACF;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAsB;OACzD,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SA4CN;;OACE;;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,qBAAC;KACC,MAAK;KACL,WAAU;gBACX,4BACyB,oBAAC,gBAAa,MAAM,KAAM;MAC7C,EACP,oBAAC;KAAK,MAAK;KAAkC,WAAU;eAAY;MAE5D;KACH;;GACF"}

package/dist/components/docs/intent/OpenapiAlternativePage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"OpenapiAlternativePage.js","names":[],"sources":["../../../../src/components/docs/intent/OpenapiAlternativePage.tsx"],"sourcesContent":["import type { Metadata } from 'next';\nimport { openapiAlternativeBrief } from '@contractspec/bundle.library/components/docs/intent/intent-pages.docblocks';\nimport { SeoOptimizer } from '@contractspec/lib.content-gen/seo';\nimport { CodeBlock } from '@contractspec/lib.design-system';\nimport Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\nexport const metadata: Metadata = new SeoOptimizer().optimize(\n  openapiAlternativeBrief\n);\n\nexport function OpenapiAlternativePage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-3\">\n        <h1 className=\"text-4xl font-bold\">{openapiAlternativeBrief.title}</h1>\n        <p className=\"text-muted-foreground text-lg\">\n          {openapiAlternativeBrief.summary}\n        </p>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">OpenAPI Limitations</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {openapiAlternativeBrief.problems.map((problem, index) => (\n            <li key={index}>{problem}</li>\n          ))}\n        </ul>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">ContractSpec Advantages</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {openapiAlternativeBrief.solutions.map((solution, index) => (\n            <li key={index}>{solution}</li>\n          ))}\n        </ul>\n      </div>\n\n      <div className=\"space-y-6\">\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">\n            Comparison: OpenAPI vs ContractSpec\n          </h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Key differences between OpenAPI documentation and ContractSpec\n            executable contracts.\n          </p>\n\n          <div className=\"grid gap-6 md:grid-cols-2\">\n            <div className=\"card-subtle space-y-3 p-4\">\n              <h3 className=\"text-lg font-semibold\">OpenAPI</h3>\n              <ul className=\"text-muted-foreground space-y-1 text-sm\">\n                <li>• Documentation specification only</li>\n                <li>• No runtime validation</li>\n                <li>• Manual code generation</li>\n                <li>• Type safety requires tools</li>\n                <li>• Separate schemas from documentation</li>\n              </ul>\n            </div>\n\n            <div className=\"card-subtle space-y-3 p-4\">\n              <h3 className=\"text-lg font-semibold\">ContractSpec</h3>\n              <ul className=\"text-muted-foreground space-y-1 text-sm\">\n                <li>• Executable contracts</li>\n                <li>• Built-in runtime validation</li>\n                <li>• Automatic code generation</li>\n                <li>• Type-safe by default</li>\n                <li>• Unified spec and implementation</li>\n              </ul>\n            </div>\n          </div>\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Export from Contracts</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Generate OpenAPI documentation from ContractSpec for existing\n            tooling.\n          </p>\n          <CodeBlock\n            language=\"bash\"\n            filename=\"export-openapi\"\n            code={`# From ContractSpec contracts\ncontractspec openapi export \\\\\n  --registry ./src/contracts/registry.ts \\\\\n  --format yaml \\\\\n  --out ./openapi.yaml\n\n# Compare: Manual OpenAPI vs Generated\n# Manual: Write OpenAPI by hand, maintain separately\n# Generated: Single source of truth, always in sync`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Beyond Documentation</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            ContractSpec provides more than just API documentation.\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"multi-output-example.ts\"\n            code={`// One contract, multiple outputs\nimport { UserApiContract } from './contracts/user-api.contract';\n\n// Generated outputs\nexport const outputs = {\n  // API documentation (OpenAPI)\n  openapi: UserApiContract.toOpenAPI(),\n  \n  // Client SDKs (TypeScript, Python, etc.)\n  clients: UserApiContract.generateClients({\n    languages: ['typescript', 'python', 'go'],\n  }),\n  \n  // Database schemas (Prisma, Drizzle)\n  database: UserApiContract.toDatabase({\n    adapter: 'prisma',\n  }),\n  \n  // API handlers (Express, Fastify, Next.js)\n  handlers: UserApiContract.toHandlers({\n    framework: 'express',\n  }),\n  \n  // Validation middleware\n  validation: UserApiContract.toValidation({\n    library: 'zod',\n  }),\n  \n  // Type definitions\n  types: UserApiContract.toTypescript(),\n};`}\n          />\n        </div>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link\n          href=\"/docs/guides/generate-docs-clients-schemas\"\n          className=\"btn-primary\"\n        >\n          Generate from Contracts <ChevronRight size={16} />\n        </Link>\n        <Link\n          href=\"/docs/intent/generate-client-from-schema\"\n          className=\"btn-ghost\"\n        >\n          Client Generation\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;AAOA,MAAa,WAAqB,IAAI,cAAc,CAAC,SACnD,wBACD;AAED,SAAgB,yBAAyB;AACvC,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAsB,wBAAwB;MAAW,EACvE,oBAAC;KAAE,WAAU;eACV,wBAAwB;MACvB;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAwB,EAC3D,oBAAC;KAAG,WAAU;eACX,wBAAwB,SAAS,KAAK,SAAS,UAC9C,oBAAC,kBAAgB,WAAR,MAAqB,CAC9B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAA4B,EAC/D,oBAAC;KAAG,WAAU;eACX,wBAAwB,UAAU,KAAK,UAAU,UAChD,oBAAC,kBAAgB,YAAR,MAAsB,CAC/B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;;KACb,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAE9B;OACL,oBAAC;QAAE,WAAU;kBAAgC;SAGzC;OAEJ,qBAAC;QAAI,WAAU;mBACb,qBAAC;SAAI,WAAU;oBACb,oBAAC;UAAG,WAAU;oBAAwB;WAAY,EAClD,qBAAC;UAAG,WAAU;;WACZ,oBAAC,kBAAG,uCAAuC;WAC3C,oBAAC,kBAAG,4BAA4B;WAChC,oBAAC,kBAAG,6BAA6B;WACjC,oBAAC,kBAAG,iCAAiC;WACrC,oBAAC,kBAAG,0CAA0C;;WAC3C;UACD,EAEN,qBAAC;SAAI,WAAU;oBACb,oBAAC;UAAG,WAAU;oBAAwB;WAAiB,EACvD,qBAAC;UAAG,WAAU;;WACZ,oBAAC,kBAAG,2BAA2B;WAC/B,oBAAC,kBAAG,kCAAkC;WACtC,oBAAC,kBAAG,gCAAgC;WACpC,oBAAC,kBAAG,2BAA2B;WAC/B,oBAAC,kBAAG,sCAAsC;;WACvC;UACD;SACF;;OACF;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAA0B;OAC7D,oBAAC;QAAE,WAAU;kBAAgC;SAGzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;;;;;SASN;;OACE;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAyB;OAC5D,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SA+BN;;OACE;;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,qBAAC;KACC,MAAK;KACL,WAAU;gBACX,4BACyB,oBAAC,gBAAa,MAAM,KAAM;MAC7C,EACP,oBAAC;KACC,MAAK;KACL,WAAU;eACX;MAEM;KACH;;GACF"}

package/dist/components/docs/intent/SchemaValidationTypescriptPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SchemaValidationTypescriptPage.js","names":[],"sources":["../../../../src/components/docs/intent/SchemaValidationTypescriptPage.tsx"],"sourcesContent":["import type { Metadata } from 'next';\nimport { schemaValidationTypescriptBrief } from '@contractspec/bundle.library/components/docs/intent/intent-pages.docblocks';\nimport { SeoOptimizer } from '@contractspec/lib.content-gen/seo';\nimport { CodeBlock } from '@contractspec/lib.design-system';\nimport Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\nexport const metadata: Metadata = new SeoOptimizer().optimize(\n  schemaValidationTypescriptBrief\n);\n\nexport function SchemaValidationTypescriptPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-3\">\n        <h1 className=\"text-4xl font-bold\">\n          {schemaValidationTypescriptBrief.title}\n        </h1>\n        <p className=\"text-muted-foreground text-lg\">\n          {schemaValidationTypescriptBrief.summary}\n        </p>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">Validation Pain Points</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {schemaValidationTypescriptBrief.problems.map((problem, index) => (\n            <li key={index}>{problem}</li>\n          ))}\n        </ul>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">Type-safe Solutions</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {schemaValidationTypescriptBrief.solutions.map((solution, index) => (\n            <li key={index}>{solution}</li>\n          ))}\n        </ul>\n      </div>\n\n      <div className=\"space-y-6\">\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Contract Schema</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Define data models with automatic TypeScript generation.\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"src/contracts/user.schema.ts\"\n            code={`import { SchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\n\nexport const UserSchema = new SchemaModel({\n  type: 'object',\n  properties: {\n    id: {\n      type: 'string',\n      format: 'uuid',\n      required: true,\n      description: 'Unique user identifier',\n    },\n    email: {\n      type: 'string',\n      format: 'email',\n      required: true,\n      description: 'User email address',\n    },\n    name: {\n      type: 'string',\n      minLength: 1,\n      maxLength: 100,\n      required: true,\n      description: 'Display name for the user',\n    },\n    role: {\n      type: 'string',\n      enum: ['user', 'admin', 'moderator'],\n      default: 'user',\n      description: 'User role in the system',\n    },\n    createdAt: {\n      type: 'string',\n      format: 'date-time',\n      required: true,\n      description: 'Account creation timestamp',\n    },\n  },\n  required: ['id', 'email', 'name', 'createdAt'],\n  metadata: {\n    name: 'User',\n    description: 'User account information',\n  },\n});`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Generated Types</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            TypeScript types are automatically generated with proper validation.\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"generated/types/user.ts\"\n            code={`// Auto-generated from UserSchema\nexport interface User {\n  id: string;\n  email: string;\n  name: string;\n  role: 'user' | 'admin' | 'moderator';\n  createdAt: string;\n}\n\n// Auto-generated Zod schema for runtime validation\nexport const UserSchemaZod = z.object({\n  id: z.string().uuid(),\n  email: z.string().email(),\n  name: z.string().min(1).max(100),\n  role: z.enum(['user', 'admin', 'moderator']).default('user'),\n  createdAt: z.string().datetime(),\n});\n\n// Generated validation utilities\nexport function validateUser(data: unknown): User {\n  return UserSchemaZod.parse(data);\n}\n\nexport function isUser(data: unknown): data is User {\n  return UserSchemaZod.safeParse(data).success;\n}`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Runtime Validation</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Use generated validation in your API handlers with zero boilerplate.\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"src/handlers/user-handler.ts\"\n            code={`import { validateUser } from '../generated/types/user';\n\nexport async function createUserHandler(request: Request) {\n  try {\n    const input = validateUser(await request.json());\n    \n    // input is now fully typed as User\n    const user = await db.users.create({\n      data: {\n        ...input,\n        createdAt: new Date().toISOString(),\n      },\n    });\n    \n    return Response.json({ user });\n  } catch (error) {\n    if (error instanceof z.ZodError) {\n      return Response.json(\n        { \n          error: 'Validation failed',\n          details: error.errors \n        },\n        { status: 400 }\n      );\n    }\n    \n    throw error;\n  }\n}`}\n          />\n        </div>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link\n          href=\"/docs/guides/spec-validation-and-typing\"\n          className=\"btn-primary\"\n        >\n          Type Safety Guide <ChevronRight size={16} />\n        </Link>\n        <Link\n          href=\"/docs/intent/generate-client-from-schema\"\n          className=\"btn-ghost\"\n        >\n          Client Generation\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;AAOA,MAAa,WAAqB,IAAI,cAAc,CAAC,SACnD,gCACD;AAED,SAAgB,iCAAiC;AAC/C,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eACX,gCAAgC;MAC9B,EACL,oBAAC;KAAE,WAAU;eACV,gCAAgC;MAC/B;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAA2B,EAC9D,oBAAC;KAAG,WAAU;eACX,gCAAgC,SAAS,KAAK,SAAS,UACtD,oBAAC,kBAAgB,WAAR,MAAqB,CAC9B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAwB,EAC3D,oBAAC;KAAG,WAAU;eACX,gCAAgC,UAAU,KAAK,UAAU,UACxD,oBAAC,kBAAgB,YAAR,MAAsB,CAC/B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;;KACb,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAoB;OACvD,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SA2CN;;OACE;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAoB;OACvD,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;SA0BN;;OACE;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAuB;OAC1D,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SA6BN;;OACE;;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,qBAAC;KACC,MAAK;KACL,WAAU;gBACX,sBACmB,oBAAC,gBAAa,MAAM,KAAM;MACvC,EACP,oBAAC;KACC,MAAK;KACL,WAAU;eACX;MAEM;KACH;;GACF"}

package/dist/components/docs/intent/SpecDrivenDevelopmentPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SpecDrivenDevelopmentPage.js","names":[],"sources":["../../../../src/components/docs/intent/SpecDrivenDevelopmentPage.tsx"],"sourcesContent":["import type { Metadata } from 'next';\nimport { specDrivenDevelopmentBrief } from '@contractspec/bundle.library/components/docs/intent/intent-pages.docblocks';\nimport { SeoOptimizer } from '@contractspec/lib.content-gen/seo';\nimport { CodeBlock } from '@contractspec/lib.design-system';\nimport Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\nexport const metadata: Metadata = new SeoOptimizer().optimize(\n  specDrivenDevelopmentBrief\n);\n\nexport function SpecDrivenDevelopmentPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-3\">\n        <h1 className=\"text-4xl font-bold\">\n          {specDrivenDevelopmentBrief.title}\n        </h1>\n        <p className=\"text-muted-foreground text-lg\">\n          {specDrivenDevelopmentBrief.summary}\n        </p>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">Why Spec-driven?</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {specDrivenDevelopmentBrief.problems.map((problem, index) => (\n            <li key={index}>{problem}</li>\n          ))}\n        </ul>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">Benefits</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {specDrivenDevelopmentBrief.solutions.map((solution, index) => (\n            <li key={index}>{solution}</li>\n          ))}\n        </ul>\n      </div>\n\n      <div className=\"space-y-6\">\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Feature Specification Example</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Define a complete feature with operations, events, and data models.\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"src/contracts/user-management.feature.ts\"\n            code={`import { defineFeature } from '@contractspec/lib.contracts/features';\nimport { defineOperation } from '@contractspec/lib.contracts/operations';\nimport { defineEvent } from '@contractspec/lib.contracts/events';\nimport { SchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\n\nexport const UserManagementFeature = defineFeature({\n  goal: 'Complete user management system with CRUD operations',\n  context: 'Handles user lifecycle from creation to deletion with proper authorization',\n  operations: {\n    createUser: defineOperation({\n      goal: 'Create a new user account',\n      input: new SchemaModel({\n        type: 'object',\n        properties: {\n          email: { type: 'string', format: 'email', required: true },\n          name: { type: 'string', minLength: 1, required: true },\n        },\n      }),\n      output: new SchemaModel({\n        type: 'object',\n        properties: {\n          id: { type: 'string', required: true },\n          email: { type: 'string', required: true },\n          name: { type: 'string', required: true },\n        },\n      }),\n    }),\n    updateUser: defineOperation({\n      goal: 'Update existing user information',\n      input: new SchemaModel({\n        type: 'object',\n        properties: {\n          name: { type: 'string', minLength: 1 },\n        },\n      }),\n      output: new SchemaModel({\n        type: 'object',\n        properties: {\n          id: { type: 'string', required: true },\n          email: { type: 'string', required: true },\n          name: { type: 'string', required: true },\n        },\n      }),\n    }),\n  },\n  events: {\n    userCreated: defineEvent({\n      goal: 'Emit when a new user is created',\n      payload: new SchemaModel({\n        type: 'object',\n        properties: {\n          userId: { type: 'string', required: true },\n          email: { type: 'string', required: true },\n        },\n      }),\n    }),\n    userUpdated: defineEvent({\n      goal: 'Emit when user information changes',\n      payload: new SchemaModel({\n        type: 'object',\n        properties: {\n          userId: { type: 'string', required: true },\n          changes: { type: 'array', items: { type: 'string' }, required: true },\n        },\n      }),\n    }),\n  },\n  metadata: {\n    name: 'user-management',\n    version: '1.0.0',\n    description: 'Complete user management with operations and events',\n  },\n});`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">\n            Generate Type-safe Implementations\n          </h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Generate validation, types, and API handlers from your feature.\n          </p>\n          <CodeBlock\n            language=\"bash\"\n            filename=\"generate-from-feature\"\n            code={`contractspec generate \\\\\n  --input ./src/contracts/user-management.feature.ts \\\\\n  --output ./generated/user-management`}\n          />\n        </div>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link\n          href=\"/docs/guides/spec-validation-and-typing\"\n          className=\"btn-primary\"\n        >\n          Type Safety Guide <ChevronRight size={16} />\n        </Link>\n        <Link href=\"/docs/intent/deterministic-codegen\" className=\"btn-ghost\">\n          Deterministic Codegen\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;AAOA,MAAa,WAAqB,IAAI,cAAc,CAAC,SACnD,2BACD;AAED,SAAgB,4BAA4B;AAC1C,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eACX,2BAA2B;MACzB,EACL,oBAAC;KAAE,WAAU;eACV,2BAA2B;MAC1B;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAqB,EACxD,oBAAC;KAAG,WAAU;eACX,2BAA2B,SAAS,KAAK,SAAS,UACjD,oBAAC,kBAAgB,WAAR,MAAqB,CAC9B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAa,EAChD,oBAAC;KAAG,WAAU;eACX,2BAA2B,UAAU,KAAK,UAAU,UACnD,oBAAC,kBAAgB,YAAR,MAAsB,CAC/B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,qBAAC;KAAI,WAAU;;MACb,oBAAC;OAAG,WAAU;iBAAqB;QAAkC;MACrE,oBAAC;OAAE,WAAU;iBAAgC;QAEzC;MACJ,oBAAC;OACC,UAAS;OACT,UAAS;OACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAyEN;;MACE,EAEN,qBAAC;KAAI,WAAU;;MACb,oBAAC;OAAG,WAAU;iBAAqB;QAE9B;MACL,oBAAC;OAAE,WAAU;iBAAgC;QAEzC;MACJ,oBAAC;OACC,UAAS;OACT,UAAS;OACT,MAAM;;;QAGN;;MACE;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,qBAAC;KACC,MAAK;KACL,WAAU;gBACX,sBACmB,oBAAC,gBAAa,MAAM,KAAM;MACvC,EACP,oBAAC;KAAK,MAAK;KAAqC,WAAU;eAAY;MAE/D;KACH;;GACF"}

package/dist/components/docs/intent/intent-pages.docblocks.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"intent-pages.docblocks.js","names":[],"sources":["../../../../src/components/docs/intent/intent-pages.docblocks.ts"],"sourcesContent":["import type { ContentBrief } from '@contractspec/lib.content-gen';\n\nexport const contractFirstApiBrief: ContentBrief = {\n  title: 'Contract-first API',\n  summary:\n    'Design APIs by writing contracts first, then generate consistent implementations across frameworks.',\n  problems: [\n    'API drift between frontend and backend',\n    'Inconsistent error handling across endpoints',\n    'Documentation becomes outdated quickly',\n    'Manual OpenAPI maintenance is error-prone',\n  ],\n  solutions: [\n    'Single source of truth for API contracts',\n    'Generate OpenAPI and SDKs from contracts',\n    'Type-safe request/response validation',\n    'Always-in-sync documentation',\n  ],\n  audience: {\n    role: 'API developers',\n    industry: 'Software development',\n    maturity: 'scaleup',\n  },\n  callToAction: 'Start with a simple operation contract',\n  references: [\n    {\n      label: 'Next.js One Endpoint Guide',\n      url: '/docs/guides/nextjs-one-endpoint',\n    },\n    {\n      label: 'API Reference',\n      url: '/docs/api',\n    },\n  ],\n};\n\nexport const specDrivenDevelopmentBrief: ContentBrief = {\n  title: 'Spec-driven development',\n  summary:\n    'Build features by writing specifications first, then generate type-safe implementations.',\n  problems: [\n    'Feature requirements are ambiguous',\n    'Frontend and backend implementations diverge',\n    'Testing lacks clear contract definitions',\n    'Code reviews focus on style instead of behavior',\n  ],\n  solutions: [\n    'Executable specifications as single source of truth',\n    'Generate type-safe clients from specs',\n    'Automated contract testing',\n    'Clear behavior contracts for teams',\n  ],\n  audience: {\n    role: 'Development teams',\n    industry: 'Software engineering',\n    maturity: 'enterprise',\n  },\n  callToAction: 'Define your first feature spec',\n  references: [\n    {\n      label: 'Spec Validation + Typing Guide',\n      url: '/docs/guides/spec-validation-and-typing',\n    },\n    {\n      label: 'Core Contracts',\n      url: '/docs/core-contracts',\n    },\n  ],\n};\n\nexport const deterministicCodegenBrief: ContentBrief = {\n  title: 'Deterministic codegen',\n  summary:\n    'Regenerate code from contracts without breaking existing functionality or losing customizations.',\n  problems: [\n    'Generated code conflicts with manual changes',\n    'Regeneration loses custom business logic',\n    'Teams avoid regeneration after customization',\n    'Code migration between versions is risky',\n  ],\n  solutions: [\n    'Clear separation of generated vs hand-written code',\n    'Incremental regeneration with conflict detection',\n    'Protected zones for custom logic',\n    'Automatic migration paths',\n  ],\n  audience: {\n    role: 'Platform engineers',\n    industry: 'Developer tools',\n    maturity: 'scaleup',\n  },\n  callToAction: 'Try deterministic regeneration',\n  references: [\n    {\n      label: 'Generate Docs + Clients Guide',\n      url: '/docs/guides/generate-docs-clients-schemas',\n    },\n    {\n      label: 'CLI Reference',\n      url: '/docs/getting-started/cli',\n    },\n  ],\n};\n\nexport const schemaValidationTypescriptBrief: ContentBrief = {\n  title: 'Schema validation TypeScript',\n  summary:\n    'Generate TypeScript types from contracts and validate data at runtime with zero overhead.',\n  problems: [\n    'Runtime type validation is boilerplate-heavy',\n    'Type definitions drift from schemas',\n    'Validation logic scattered across codebase',\n    'Poor error messages for invalid data',\n  ],\n  solutions: [\n    'Auto-generated TypeScript from contracts',\n    'Zod schemas for runtime validation',\n    'Type-safe validation with clear errors',\n    'Single source of schema truth',\n  ],\n  audience: {\n    role: 'TypeScript developers',\n    industry: 'Web development',\n    maturity: 'early',\n  },\n  callToAction: 'Generate typed contracts now',\n  references: [\n    {\n      label: 'Type Safety Guide',\n      url: '/docs/guides/spec-validation-and-typing',\n    },\n    {\n      label: 'Schema Reference',\n      url: '/docs/schemas',\n    },\n  ],\n};\n\nexport const openapiAlternativeBrief: ContentBrief = {\n  title: 'OpenAPI alternative',\n  summary:\n    'A spec-first approach that goes beyond OpenAPI with executable contracts and code generation.',\n  problems: [\n    'OpenAPI is documentation-only',\n    'No type safety from OpenAPI specs',\n    'Manual SDK generation is complex',\n    'Cannot validate implementations against OpenAPI',\n  ],\n  solutions: [\n    'Executable contracts with validation',\n    'Generate multiple outputs from one spec',\n    'Type-safe by default',\n    'Built-in testing and validation',\n  ],\n  audience: {\n    role: 'API architects',\n    industry: 'Enterprise software',\n    maturity: 'enterprise',\n  },\n  callToAction: 'Compare with OpenAPI approach',\n  references: [\n    {\n      label: 'Generate OpenAPI from Contracts',\n      url: '/docs/guides/generate-docs-clients-schemas',\n    },\n    {\n      label: 'Contract vs OpenAPI',\n      url: '/docs/comparison/openapi',\n    },\n  ],\n};\n\nexport const generateClientFromSchemaBrief: ContentBrief = {\n  title: 'Generate client from schema',\n  summary:\n    'Automatically generate type-safe API clients in any language from your contracts.',\n  problems: [\n    'Writing API clients is repetitive',\n    'Manual clients have type mismatches',\n    'Keeping clients in sync with APIs',\n    'Language-specific client maintenance',\n  ],\n  solutions: [\n    'Generate clients for multiple languages',\n    'Type-safe request/response handling',\n    'Automatic client updates from contracts',\n    'Consistent error handling across languages',\n  ],\n  audience: {\n    role: 'Full-stack developers',\n    industry: 'Software development',\n    maturity: 'scaleup',\n  },\n  callToAction: 'Generate your first API client',\n  references: [\n    {\n      label: 'Client Generation Guide',\n      url: '/docs/guides/generate-docs-clients-schemas',\n    },\n    {\n      label: 'Supported Languages',\n      url: '/docs/integrations',\n    },\n  ],\n};\n"],"mappings":";AAEA,MAAa,wBAAsC;CACjD,OAAO;CACP,SACE;CACF,UAAU;EACR;EACA;EACA;EACA;EACD;CACD,WAAW;EACT;EACA;EACA;EACA;EACD;CACD,UAAU;EACR,MAAM;EACN,UAAU;EACV,UAAU;EACX;CACD,cAAc;CACd,YAAY,CACV;EACE,OAAO;EACP,KAAK;EACN,EACD;EACE,OAAO;EACP,KAAK;EACN,CACF;CACF;AAED,MAAa,6BAA2C;CACtD,OAAO;CACP,SACE;CACF,UAAU;EACR;EACA;EACA;EACA;EACD;CACD,WAAW;EACT;EACA;EACA;EACA;EACD;CACD,UAAU;EACR,MAAM;EACN,UAAU;EACV,UAAU;EACX;CACD,cAAc;CACd,YAAY,CACV;EACE,OAAO;EACP,KAAK;EACN,EACD;EACE,OAAO;EACP,KAAK;EACN,CACF;CACF;AAED,MAAa,4BAA0C;CACrD,OAAO;CACP,SACE;CACF,UAAU;EACR;EACA;EACA;EACA;EACD;CACD,WAAW;EACT;EACA;EACA;EACA;EACD;CACD,UAAU;EACR,MAAM;EACN,UAAU;EACV,UAAU;EACX;CACD,cAAc;CACd,YAAY,CACV;EACE,OAAO;EACP,KAAK;EACN,EACD;EACE,OAAO;EACP,KAAK;EACN,CACF;CACF;AAED,MAAa,kCAAgD;CAC3D,OAAO;CACP,SACE;CACF,UAAU;EACR;EACA;EACA;EACA;EACD;CACD,WAAW;EACT;EACA;EACA;EACA;EACD;CACD,UAAU;EACR,MAAM;EACN,UAAU;EACV,UAAU;EACX;CACD,cAAc;CACd,YAAY,CACV;EACE,OAAO;EACP,KAAK;EACN,EACD;EACE,OAAO;EACP,KAAK;EACN,CACF;CACF;AAED,MAAa,0BAAwC;CACnD,OAAO;CACP,SACE;CACF,UAAU;EACR;EACA;EACA;EACA;EACD;CACD,WAAW;EACT;EACA;EACA;EACA;EACD;CACD,UAAU;EACR,MAAM;EACN,UAAU;EACV,UAAU;EACX;CACD,cAAc;CACd,YAAY,CACV;EACE,OAAO;EACP,KAAK;EACN,EACD;EACE,OAAO;EACP,KAAK;EACN,CACF;CACF;AAED,MAAa,gCAA8C;CACzD,OAAO;CACP,SACE;CACF,UAAU;EACR;EACA;EACA;EACA;EACD;CACD,WAAW;EACT;EACA;EACA;EACA;EACD;CACD,UAAU;EACR,MAAM;EACN,UAAU;EACV,UAAU;EACX;CACD,cAAc;CACd,YAAY,CACV;EACE,OAAO;EACP,KAAK;EACN,EACD;EACE,OAAO;EACP,KAAK;EACN,CACF;CACF"}

package/dist/components/docs/knowledge/KnowledgeCategoriesPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"KnowledgeCategoriesPage.js","names":[],"sources":["../../../../src/components/docs/knowledge/KnowledgeCategoriesPage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\n// export const metadata = {\n//   title: 'Knowledge Categories: ContractSpec Docs',\n//   description:\n//     'Understand the four knowledge categories in ContractSpec and how they affect trust and decision-making.',\n// };\n\nexport function KnowledgeCategoriesPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Knowledge Categories</h1>\n        <p className=\"text-muted-foreground\">\n          ContractSpec classifies knowledge into four categories based on trust\n          level, source authority, and intended use. This classification\n          determines how knowledge can be used in workflows, policy decisions,\n          and agent responses.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">The four categories</h2>\n        <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n          <pre>{`type KnowledgeCategory =\n  | \"canonical\"   // Internal ground truth\n  | \"operational\" // Internal operational docs\n  | \"external\"    // Third-party reference\n  | \"ephemeral\";  // Temporary context`}</pre>\n        </div>\n      </div>\n\n      <div className=\"space-y-6\">\n        <div className=\"space-y-4\">\n          <h3 className=\"text-xl font-semibold\">1. Canonical</h3>\n          <p className=\"text-muted-foreground\">\n            <strong>Trust level:</strong> Highest - Authoritative ground truth\n          </p>\n          <div className=\"space-y-3\">\n            <div>\n              <h4 className=\"mb-2 text-sm font-semibold\">What it contains:</h4>\n              <ul className=\"text-muted-foreground ml-4 list-inside list-disc space-y-1 text-sm\">\n                <li>Official product specifications and schemas</li>\n                <li>Company policies and procedures</li>\n                <li>Legal terms and compliance requirements</li>\n                <li>Pricing rules and business logic</li>\n                <li>Data classification and security policies</li>\n              </ul>\n            </div>\n            <div>\n              <h4 className=\"mb-2 text-sm font-semibold\">How it's used:</h4>\n              <ul className=\"text-muted-foreground ml-4 list-inside list-disc space-y-1 text-sm\">\n                <li>\n                  <strong>Policy decisions</strong> - Can drive PDP decisions\n                </li>\n                <li>\n                  <strong>Validation</strong> - Used to validate user inputs and\n                  operations\n                </li>\n                <li>\n                  <strong>Code generation</strong> - Source of truth for\n                  generated code\n                </li>\n                <li>\n                  <strong>Compliance</strong> - Reference for audit and\n                  regulatory checks\n                </li>\n              </ul>\n            </div>\n            <div>\n              <h4 className=\"mb-2 text-sm font-semibold\">Examples:</h4>\n              <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs\">\n                <pre>{`// Product Canon space\n{\n  id: \"product-canon\",\n  category: \"canonical\",\n  sources: [\n    \"database-schema.sql\",\n    \"product-catalog.yaml\",\n    \"pricing-rules.json\"\n  ]\n}\n\n// Policy Canon space\n{\n  id: \"policy-canon\",\n  category: \"canonical\",\n  sources: [\n    \"data-classification.yaml\",\n    \"access-policies.rego\",\n    \"compliance-requirements.md\"\n  ]\n}`}</pre>\n              </div>\n            </div>\n            <div className=\"card-subtle border-violet-500/30 bg-violet-500/10 p-3\">\n              <p className=\"text-sm text-violet-300\">\n                <strong>⚠️ Important:</strong> Canonical knowledge is immutable\n                once indexed. Changes require re-sync and versioning.\n              </p>\n            </div>\n          </div>\n        </div>\n\n        <div className=\"space-y-4\">\n          <h3 className=\"text-xl font-semibold\">2. Operational</h3>\n          <p className=\"text-muted-foreground\">\n            <strong>Trust level:</strong> High - Internal but not authoritative\n          </p>\n          <div className=\"space-y-3\">\n            <div>\n              <h4 className=\"mb-2 text-sm font-semibold\">What it contains:</h4>\n              <ul className=\"text-muted-foreground ml-4 list-inside list-disc space-y-1 text-sm\">\n                <li>Support ticket history and resolutions</li>\n                <li>Internal runbooks and playbooks</li>\n                <li>Sales materials and customer communications</li>\n                <li>Product management docs and roadmaps</li>\n                <li>Team wikis and knowledge bases</li>\n              </ul>\n            </div>\n            <div>\n              <h4 className=\"mb-2 text-sm font-semibold\">How it's used:</h4>\n              <ul className=\"text-muted-foreground ml-4 list-inside list-disc space-y-1 text-sm\">\n                <li>\n                  <strong>Context</strong> - Provides helpful context for\n                  decisions\n                </li>\n                <li>\n                  <strong>Suggestions</strong> - Informs recommendations, not\n                  requirements\n                </li>\n                <li>\n                  <strong>Learning</strong> - Helps agents learn from past\n                  interactions\n                </li>\n                <li>\n                  <strong>Troubleshooting</strong> - Guides problem-solving\n                  workflows\n                </li>\n              </ul>\n            </div>\n            <div>\n              <h4 className=\"mb-2 text-sm font-semibold\">Examples:</h4>\n              <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs\">\n                <pre>{`// Support History space\n{\n  id: \"support-history\",\n  category: \"operational\",\n  sources: [\n    \"gmail:support@company.com\",\n    \"zendesk:tickets\",\n    \"slack:support-channel\"\n  ]\n}\n\n// Internal Docs space\n{\n  id: \"internal-docs\",\n  category: \"operational\",\n  sources: [\n    \"notion:engineering-wiki\",\n    \"confluence:product-docs\",\n    \"google-drive:runbooks\"\n  ]\n}`}</pre>\n              </div>\n            </div>\n          </div>\n        </div>\n\n        <div className=\"space-y-4\">\n          <h3 className=\"text-xl font-semibold\">3. External</h3>\n          <p className=\"text-muted-foreground\">\n            <strong>Trust level:</strong> Medium - Reference only\n          </p>\n          <div className=\"space-y-3\">\n            <div>\n              <h4 className=\"mb-2 text-sm font-semibold\">What it contains:</h4>\n              <ul className=\"text-muted-foreground ml-4 list-inside list-disc space-y-1 text-sm\">\n                <li>Third-party integration documentation (Stripe, Twilio)</li>\n                <li>Regulatory and compliance documents</li>\n                <li>Industry standards and best practices</li>\n                <li>Public API documentation</li>\n                <li>External knowledge bases</li>\n              </ul>\n            </div>\n            <div>\n              <h4 className=\"mb-2 text-sm font-semibold\">How it's used:</h4>\n              <ul className=\"text-muted-foreground ml-4 list-inside list-disc space-y-1 text-sm\">\n                <li>\n                  <strong>Reference</strong> - Consulted but not authoritative\n                </li>\n                <li>\n                  <strong>Integration help</strong> - Guides external API usage\n                </li>\n                <li>\n                  <strong>Compliance context</strong> - Provides regulatory\n                  background\n                </li>\n                <li>\n                  <strong>Never for policy</strong> - Cannot drive policy\n                  decisions\n                </li>\n              </ul>\n            </div>\n            <div>\n              <h4 className=\"mb-2 text-sm font-semibold\">Examples:</h4>\n              <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs\">\n                <pre>{`// External Provider Docs space\n{\n  id: \"provider-docs\",\n  category: \"external\",\n  sources: [\n    \"url:https://stripe.com/docs\",\n    \"url:https://twilio.com/docs\",\n    \"url:https://openai.com/docs\"\n  ]\n}\n\n// Regulatory Docs space\n{\n  id: \"regulatory-docs\",\n  category: \"external\",\n  sources: [\n    \"url:https://gdpr.eu/\",\n    \"url:https://www.hhs.gov/hipaa\",\n    \"pdf:SOC2-requirements.pdf\"\n  ]\n}`}</pre>\n              </div>\n            </div>\n            <div className=\"card-subtle border-amber-500/30 bg-amber-500/10 p-3\">\n              <p className=\"text-sm text-amber-300\">\n                <strong>⚠️ Note:</strong> External knowledge should be clearly\n                marked in agent responses as \"according to [source]\" to indicate\n                it's not internal authority.\n              </p>\n            </div>\n          </div>\n        </div>\n\n        <div className=\"space-y-4\">\n          <h3 className=\"text-xl font-semibold\">4. Ephemeral</h3>\n          <p className=\"text-muted-foreground\">\n            <strong>Trust level:</strong> Low - Temporary context only\n          </p>\n          <div className=\"space-y-3\">\n            <div>\n              <h4 className=\"mb-2 text-sm font-semibold\">What it contains:</h4>\n              <ul className=\"text-muted-foreground ml-4 list-inside list-disc space-y-1 text-sm\">\n                <li>Agent conversation history and scratchpads</li>\n                <li>Session-specific context and state</li>\n                <li>Draft documents and work-in-progress</li>\n                <li>Temporary calculations and intermediate results</li>\n                <li>User-provided context for current task</li>\n              </ul>\n            </div>\n            <div>\n              <h4 className=\"mb-2 text-sm font-semibold\">How it's used:</h4>\n              <ul className=\"text-muted-foreground ml-4 list-inside list-disc space-y-1 text-sm\">\n                <li>\n                  <strong>Session continuity</strong> - Maintains conversation\n                  context\n                </li>\n                <li>\n                  <strong>Working memory</strong> - Stores intermediate results\n                </li>\n                <li>\n                  <strong>Never persisted long-term</strong> - Auto-purged after\n                  session\n                </li>\n                <li>\n                  <strong>Never for decisions</strong> - Cannot influence policy\n                  or validation\n                </li>\n              </ul>\n            </div>\n            <div>\n              <h4 className=\"mb-2 text-sm font-semibold\">Examples:</h4>\n              <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs\">\n                <pre>{`// Agent Scratchpad space\n{\n  id: \"agent-scratchpad\",\n  category: \"ephemeral\",\n  retentionPolicy: { days: 1 },\n  sources: [\n    \"session:current-conversation\",\n    \"memory:agent-working-memory\"\n  ]\n}\n\n// User Session space\n{\n  id: \"user-session\",\n  category: \"ephemeral\",\n  retentionPolicy: { days: 7 },\n  sources: [\n    \"session:user-uploads\",\n    \"session:form-drafts\"\n  ]\n}`}</pre>\n              </div>\n            </div>\n            <div className=\"card-subtle border-red-500/30 bg-red-500/10 p-3\">\n              <p className=\"text-sm text-red-300\">\n                <strong>⚠️ Critical:</strong> Ephemeral knowledge is never used\n                for policy decisions, compliance checks, or any authoritative\n                purpose.\n              </p>\n            </div>\n          </div>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Category comparison</h2>\n        <div className=\"border-border/50 overflow-x-auto rounded-lg border\">\n          <table className=\"w-full text-left text-sm\">\n            <thead className=\"bg-card/50\">\n              <tr className=\"border-border/50 border-b\">\n                <th className=\"px-4 py-3 font-semibold\">Feature</th>\n                <th className=\"px-4 py-3 font-semibold\">Canonical</th>\n                <th className=\"px-4 py-3 font-semibold\">Operational</th>\n                <th className=\"px-4 py-3 font-semibold\">External</th>\n                <th className=\"px-4 py-3 font-semibold\">Ephemeral</th>\n              </tr>\n            </thead>\n            <tbody className=\"divide-border/50 divide-y\">\n              <tr>\n                <td className=\"px-4 py-3 font-semibold\">Trust Level</td>\n                <td className=\"px-4 py-3\">Highest</td>\n                <td className=\"px-4 py-3\">High</td>\n                <td className=\"px-4 py-3\">Medium</td>\n                <td className=\"px-4 py-3\">Low</td>\n              </tr>\n              <tr>\n                <td className=\"px-4 py-3 font-semibold\">Policy Impact</td>\n                <td className=\"px-4 py-3\">✅ Can drive decisions</td>\n                <td className=\"px-4 py-3\">⚠️ Can inform</td>\n                <td className=\"px-4 py-3\">❌ Reference only</td>\n                <td className=\"px-4 py-3\">❌ Never used</td>\n              </tr>\n              <tr>\n                <td className=\"px-4 py-3 font-semibold\">Mutability</td>\n                <td className=\"px-4 py-3\">Immutable</td>\n                <td className=\"px-4 py-3\">Mutable</td>\n                <td className=\"px-4 py-3\">Mutable</td>\n                <td className=\"px-4 py-3\">Temporary</td>\n              </tr>\n              <tr>\n                <td className=\"px-4 py-3 font-semibold\">Retention</td>\n                <td className=\"px-4 py-3\">Permanent</td>\n                <td className=\"px-4 py-3\">Long-term</td>\n                <td className=\"px-4 py-3\">Long-term</td>\n                <td className=\"px-4 py-3\">Short-term</td>\n              </tr>\n              <tr>\n                <td className=\"px-4 py-3 font-semibold\">Audit Level</td>\n                <td className=\"px-4 py-3\">Full audit</td>\n                <td className=\"px-4 py-3\">Full audit</td>\n                <td className=\"px-4 py-3\">Basic audit</td>\n                <td className=\"px-4 py-3\">Minimal audit</td>\n              </tr>\n            </tbody>\n          </table>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Best practices</h2>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>\n            Use canonical for anything that affects policy, pricing, or\n            compliance\n          </li>\n          <li>\n            Use operational for context that helps but doesn't dictate decisions\n          </li>\n          <li>\n            Use external for reference material that's helpful but not\n            authoritative\n          </li>\n          <li>\n            Use ephemeral for temporary working memory that shouldn't persist\n          </li>\n          <li>\n            Never mix categories in a single knowledge space - keep them\n            separate\n          </li>\n          <li>\n            Document the category and purpose of each knowledge space clearly\n          </li>\n        </ul>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/knowledge\" className=\"btn-ghost\">\n          Back to Knowledge\n        </Link>\n        <Link href=\"/docs/knowledge/spaces\" className=\"btn-primary\">\n          Knowledge Spaces <ChevronRight size={16} />\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/components/docs/knowledge/KnowledgeExamplesPage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"KnowledgeExamplesPage.js","names":[],"sources":["../../../../src/components/docs/knowledge/KnowledgeExamplesPage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\n\n// export const metadata = {\n//   title: 'Knowledge Examples: ContractSpec Docs',\n//   description:\n//     'Real-world examples of knowledge spaces in ContractSpec applications.',\n// };\n\nexport function KnowledgeExamplesPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Knowledge Examples</h1>\n        <p className=\"text-muted-foreground\">\n          Real-world examples of how different applications use knowledge spaces\n          to power intelligent workflows and agents.\n        </p>\n      </div>\n\n      <div className=\"space-y-6\">\n        <div className=\"space-y-4\">\n          <h2 className=\"text-2xl font-bold\">\n            Example 1: ArtisanOS Support Agent\n          </h2>\n          <p className=\"text-muted-foreground\">\n            <strong>Context:</strong> ArtisanOS needs a support agent that can\n            answer product questions using official documentation and learn from\n            past support tickets.\n          </p>\n          <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n            <pre>{`// Knowledge spaces\nknowledgeSpaces: [\n  {\n    id: \"product-canon\",\n    category: \"canonical\",\n    sources: [\n      { kind: \"notion\", location: \"product-docs\" },\n      { kind: \"database-query\", location: \"SELECT * FROM features\" }\n    ]\n  },\n  {\n    id: \"support-history\",\n    category: \"operational\",\n    sources: [\n      { kind: \"email\", location: \"support@artisanos.com\" },\n      { kind: \"slack\", location: \"#support-channel\" }\n    ]\n  }\n]\n\n// Workflow\nworkflowId: answer-support-question\nsteps:\n  - id: embed-question\n    capability: openai-embeddings\n    inputs:\n      text: $\\{input.question}\n  \n  - id: search-canon\n    capability: vector.search\n    inputs:\n      collection: \"product-canon\"\n      vector: $\\{steps.embed-question.output.embedding}\n      limit: 5\n  \n  - id: search-history\n    capability: vector.search\n    inputs:\n      collection: \"support-history\"\n      vector: $\\{steps.embed-question.output.embedding}\n      limit: 3\n  \n  - id: generate-answer\n    capability: openai-chat\n    inputs:\n      messages:\n        - role: \"system\"\n          content: |\n            Answer using canonical docs as authority.\n            Use support history for helpful context.\n        - role: \"user\"\n          content: |\n            Question: $\\{input.question}\n            Docs: $\\{steps.search-canon.output.results}\n            History: $\\{steps.search-history.output.results}`}</pre>\n          </div>\n        </div>\n\n        <div className=\"space-y-4\">\n          <h2 className=\"text-2xl font-bold\">\n            Example 2: HCircle Invoice Generation\n          </h2>\n          <p className=\"text-muted-foreground\">\n            <strong>Context:</strong> HCircle needs to generate invoices using\n            house playbook rules and resident service history.\n          </p>\n          <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n            <pre>{`// Knowledge spaces\nknowledgeSpaces: [\n  {\n    id: \"house-playbook\",\n    category: \"canonical\",\n    sources: [\n      { kind: \"uploaded-document\", location: \"playbook.pdf\" },\n      { kind: \"database-query\", location: \"SELECT * FROM pricing_rules\" }\n    ]\n  },\n  {\n    id: \"resident-history\",\n    category: \"operational\",\n    sources: [\n      { kind: \"database-query\", location: \"SELECT * FROM services\" },\n      { kind: \"database-query\", location: \"SELECT * FROM invoices\" }\n    ]\n  }\n]\n\n// Workflow\nworkflowId: generate-invoice\nsteps:\n  - id: fetch-services\n    capability: database.query\n    inputs:\n      query: \"SELECT * FROM services WHERE resident_id = ?\"\n      params: [$\\{input.residentId}]\n  \n  - id: search-pricing-rules\n    capability: vector.search\n    inputs:\n      collection: \"house-playbook\"\n      query: \"pricing rules for $\\{steps.fetch-services.output.serviceType}\"\n      limit: 3\n  \n  - id: calculate-total\n    capability: calculate\n    inputs:\n      services: $\\{steps.fetch-services.output.rows}\n      rules: $\\{steps.search-pricing-rules.output.results}\n  \n  - id: create-invoice\n    capability: database.insert\n    inputs:\n      table: \"invoices\"\n      data: $\\{steps.calculate-total.output}`}</pre>\n          </div>\n        </div>\n\n        <div className=\"space-y-4\">\n          <h2 className=\"text-2xl font-bold\">\n            Example 3: Multi-tenant SaaS with External Docs\n          </h2>\n          <p className=\"text-muted-foreground\">\n            <strong>Context:</strong> A SaaS platform needs to help users\n            integrate with Stripe, using both internal guides and Stripe's\n            official documentation.\n          </p>\n          <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n            <pre>{`// Knowledge spaces\nknowledgeSpaces: [\n  {\n    id: \"integration-guides\",\n    category: \"canonical\",\n    sources: [\n      { kind: \"notion\", location: \"integration-guides\" }\n    ]\n  },\n  {\n    id: \"stripe-docs\",\n    category: \"external\",\n    sources: [\n      { kind: \"url\", location: \"https://stripe.com/docs\" }\n    ]\n  },\n  {\n    id: \"customer-questions\",\n    category: \"operational\",\n    sources: [\n      { kind: \"email\", location: \"support@saas.com\" }\n    ]\n  }\n]\n\n// Workflow\nworkflowId: answer-integration-question\nsteps:\n  - id: embed-question\n    capability: openai-embeddings\n    inputs:\n      text: $\\{input.question}\n  \n  - id: search-internal-guides\n    capability: vector.search\n    inputs:\n      collection: \"integration-guides\"\n      vector: $\\{steps.embed-question.output.embedding}\n      limit: 3\n  \n  - id: search-stripe-docs\n    capability: vector.search\n    inputs:\n      collection: \"stripe-docs\"\n      vector: $\\{steps.embed-question.output.embedding}\n      limit: 2\n  \n  - id: search-past-questions\n    capability: vector.search\n    inputs:\n      collection: \"customer-questions\"\n      vector: $\\{steps.embed-question.output.embedding}\n      limit: 2\n  \n  - id: generate-answer\n    capability: openai-chat\n    inputs:\n      messages:\n        - role: \"system\"\n          content: |\n            Prioritize internal guides (authoritative).\n            Use Stripe docs for API details (reference).\n            Use past questions for common issues (context).\n        - role: \"user\"\n          content: |\n            Question: $\\{input.question}\n            Internal: $\\{steps.search-internal-guides.output.results}\n            Stripe: $\\{steps.search-stripe-docs.output.results}\n            Past: $\\{steps.search-past-questions.output.results}`}</pre>\n          </div>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Key patterns</h2>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>\n            <strong>Canonical first</strong> - Always search canonical spaces\n            before operational or external\n          </li>\n          <li>\n            <strong>Category-aware prompts</strong> - Tell the LLM which sources\n            are authoritative vs reference\n          </li>\n          <li>\n            <strong>Multi-space queries</strong> - Combine results from multiple\n            spaces for richer context\n          </li>\n          <li>\n            <strong>Limit results</strong> - Use appropriate limits (3-5) to\n            avoid token overflow\n          </li>\n          <li>\n            <strong>Audit everything</strong> - Log all knowledge queries for\n            debugging and compliance\n          </li>\n        </ul>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/knowledge/sources\" className=\"btn-ghost\">\n          Previous: Sources\n        </Link>\n        <Link href=\"/docs/architecture/knowledge-binding\" className=\"btn-ghost\">\n          Knowledge Binding\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;AAQA,SAAgB,wBAAwB;AACtC,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAuB,EAC1D,oBAAC;KAAE,WAAU;eAAwB;MAGjC;KACA;GAEN,qBAAC;IAAI,WAAU;;KACb,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAE9B;OACL,qBAAC;QAAE,WAAU;mBACX,oBAAC,sBAAO,aAAiB;SAGvB;OACJ,oBAAC;QAAI,WAAU;kBACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEAsDkD;SACpD;;OACF;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAE9B;OACL,qBAAC;QAAE,WAAU;mBACX,oBAAC,sBAAO,aAAiB;SAEvB;OACJ,oBAAC;QAAI,WAAU;kBACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gDA8CkC;SACpC;;OACF;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAE9B;OACL,qBAAC;QAAE,WAAU;mBACX,oBAAC,sBAAO,aAAiB;SAGvB;OACJ,oBAAC;QAAI,WAAU;kBACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oEAoEsD;SACxD;;OACF;;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAiB,EACpD,qBAAC;KAAG,WAAU;;MACZ,qBAAC,mBACC,oBAAC,sBAAO,oBAAwB,wEAE7B;MACL,qBAAC,mBACC,oBAAC,sBAAO,2BAA+B,oEAEpC;MACL,qBAAC,mBACC,oBAAC,sBAAO,wBAA4B,kEAEjC;MACL,qBAAC,mBACC,oBAAC,sBAAO,kBAAsB,+DAE3B;MACL,qBAAC,mBACC,oBAAC,sBAAO,qBAAyB,iEAE9B;;MACF;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAK,MAAK;KAA0B,WAAU;eAAY;MAEpD,EACP,oBAAC;KAAK,MAAK;KAAuC,WAAU;eAAY;MAEjE;KACH;;GACF"}