@contractspec/bundle.library 3.7.6 → 3.8.2

package/src/components/docs/integrations/IntegrationsGithubPage.tsx

@@ -2,21 +2,21 @@ import Link from '@contractspec/lib.ui-link';
 import { ChevronRight } from 'lucide-react';
 
 export function IntegrationsGithubPage() {
-  return (
-    <div className="space-y-8">
-      <div className="space-y-4">
-        <h1 className="text-4xl font-bold">GitHub Messaging</h1>
-        <p className="text-muted-foreground">
-          Use GitHub issue and pull request comments as an AI-native messaging
-          channel with webhook verification, policy checks, and reliable
-          outbound dispatch.
-        </p>
-      </div>
+	return (
+		<div className="space-y-8">
+			<div className="space-y-4">
+				<h1 className="font-bold text-4xl">GitHub Messaging</h1>
+				<p className="text-muted-foreground">
+					Use GitHub issue and pull request comments as an AI-native messaging
+					channel with webhook verification, policy checks, and reliable
+					outbound dispatch.
+				</p>
+			</div>
 
-      <div className="space-y-4">
-        <h2 className="text-2xl font-bold">Required secrets and config</h2>
-        <div className="bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm">
-          <pre>{`// secret payload
+			<div className="space-y-4">
+				<h2 className="font-bold text-2xl">Required secrets and config</h2>
+				<div className="overflow-x-auto rounded-lg border border-border bg-background/50 p-4 font-mono text-muted-foreground text-sm">
+					<pre>{`// secret payload
 {
   "token": "ghp_...",
   "webhookSecret": "..."
@@ -28,63 +28,63 @@ export function IntegrationsGithubPage() {
   "defaultRepo": "contractspec",
   "apiBaseUrl": "https://api.github.com"
 }`}</pre>
-        </div>
-      </div>
+				</div>
+			</div>
 
-      <div className="space-y-4">
-        <h2 className="text-2xl font-bold">Webhook ingress</h2>
-        <ul className="text-muted-foreground list-inside list-disc space-y-2">
-          <li>
-            Inbound GitHub events are accepted on{' '}
-            <code className="bg-background/50 rounded px-2 py-1">
-              /webhooks/github/events
-            </code>
-            .
-          </li>
-          <li>
-            Signatures are checked using{' '}
-            <code className="bg-background/50 rounded px-2 py-1">
-              x-hub-signature-256
-            </code>{' '}
-            and the configured webhook secret.
-          </li>
-          <li>
-            Current normalization focuses on issue comment workflows and durable
-            comment dispatch.
-          </li>
-        </ul>
-      </div>
+			<div className="space-y-4">
+				<h2 className="font-bold text-2xl">Webhook ingress</h2>
+				<ul className="list-inside list-disc space-y-2 text-muted-foreground">
+					<li>
+						Inbound GitHub events are accepted on{' '}
+						<code className="rounded bg-background/50 px-2 py-1">
+							/webhooks/github/events
+						</code>
+						.
+					</li>
+					<li>
+						Signatures are checked using{' '}
+						<code className="rounded bg-background/50 px-2 py-1">
+							x-hub-signature-256
+						</code>{' '}
+						and the configured webhook secret.
+					</li>
+					<li>
+						Current normalization focuses on issue comment workflows and durable
+						comment dispatch.
+					</li>
+				</ul>
+			</div>
 
-      <div className="space-y-4">
-        <h2 className="text-2xl font-bold">Workspace mapping</h2>
-        <div className="bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm">
-          <pre>{`CHANNEL_WORKSPACE_MAP_GITHUB={"lssm-tech/contractspec":"workspace-acme"}
+			<div className="space-y-4">
+				<h2 className="font-bold text-2xl">Workspace mapping</h2>
+				<div className="overflow-x-auto rounded-lg border border-border bg-background/50 p-4 font-mono text-muted-foreground text-sm">
+					<pre>{`CHANNEL_WORKSPACE_MAP_GITHUB={"lssm-tech/contractspec":"workspace-acme"}
 
 # Optional dev fallback (off by default)
 CHANNEL_ALLOW_UNMAPPED_WORKSPACE=0`}</pre>
-        </div>
-      </div>
+				</div>
+			</div>
 
-      <div className="space-y-4">
-        <h2 className="text-2xl font-bold">Best practices</h2>
-        <ul className="text-muted-foreground list-inside list-disc space-y-2">
-          <li>Use a least-privileged token scoped for comment operations.</li>
-          <li>
-            Route repositories explicitly with workspace maps in multi-tenant
-            environments.
-          </li>
-          <li>Keep dispatch endpoints protected with token or bearer auth.</li>
-        </ul>
-      </div>
+			<div className="space-y-4">
+				<h2 className="font-bold text-2xl">Best practices</h2>
+				<ul className="list-inside list-disc space-y-2 text-muted-foreground">
+					<li>Use a least-privileged token scoped for comment operations.</li>
+					<li>
+						Route repositories explicitly with workspace maps in multi-tenant
+						environments.
+					</li>
+					<li>Keep dispatch endpoints protected with token or bearer auth.</li>
+				</ul>
+			</div>
 
-      <div className="flex items-center gap-4 pt-4">
-        <Link href="/docs/integrations/slack" className="btn-ghost">
-          Previous: Slack Messaging
-        </Link>
-        <Link href="/docs/integrations/whatsapp-meta" className="btn-primary">
-          Next: WhatsApp Meta <ChevronRight size={16} />
-        </Link>
-      </div>
-    </div>
-  );
+			<div className="flex items-center gap-4 pt-4">
+				<Link href="/docs/integrations/slack" className="btn-ghost">
+					Previous: Slack Messaging
+				</Link>
+				<Link href="/docs/integrations/whatsapp-meta" className="btn-primary">
+					Next: WhatsApp Meta <ChevronRight size={16} />
+				</Link>
+			</div>
+		</div>
+	);
 }

package/src/components/docs/integrations/IntegrationsGmailPage.tsx

@@ -8,34 +8,34 @@ import { ChevronRight } from 'lucide-react';
 // };
 
 export function IntegrationsGmailPage() {
-  return (
-    <div className="space-y-8">
-      <div className="space-y-4">
-        <h1 className="text-4xl font-bold">Gmail API</h1>
-        <p className="text-muted-foreground">
-          The Gmail API integration allows you to read inbound emails, manage
-          threads, and build email-based workflows. Perfect for support tickets,
-          email parsing, and automated responses.
-        </p>
-      </div>
+	return (
+		<div className="space-y-8">
+			<div className="space-y-4">
+				<h1 className="font-bold text-4xl">Gmail API</h1>
+				<p className="text-muted-foreground">
+					The Gmail API integration allows you to read inbound emails, manage
+					threads, and build email-based workflows. Perfect for support tickets,
+					email parsing, and automated responses.
+				</p>
+			</div>
 
-      <div className="space-y-4">
-        <h2 className="text-2xl font-bold">Setup</h2>
-        <p className="text-muted-foreground">
-          Configure OAuth 2.0 credentials in Google Cloud Console:
-        </p>
-        <div className="bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm">
-          <pre>{`# .env
+			<div className="space-y-4">
+				<h2 className="font-bold text-2xl">Setup</h2>
+				<p className="text-muted-foreground">
+					Configure OAuth 2.0 credentials in Google Cloud Console:
+				</p>
+				<div className="overflow-x-auto rounded-lg border border-border bg-background/50 p-4 font-mono text-muted-foreground text-sm">
+					<pre>{`# .env
 GOOGLE_CLIENT_ID=...
 GOOGLE_CLIENT_SECRET=...
 GOOGLE_REDIRECT_URI=https://your-app.com/auth/google/callback`}</pre>
-        </div>
-      </div>
+				</div>
+			</div>
 
-      <div className="space-y-4">
-        <h2 className="text-2xl font-bold">Reading emails</h2>
-        <div className="bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm">
-          <pre>{`capabilityId: gmail-list-messages
+			<div className="space-y-4">
+				<h2 className="font-bold text-2xl">Reading emails</h2>
+				<div className="overflow-x-auto rounded-lg border border-border bg-background/50 p-4 font-mono text-muted-foreground text-sm">
+					<pre>{`capabilityId: gmail-list-messages
 provider:
   type: gmail
   operation: listMessages
@@ -57,27 +57,27 @@ outputs:
         id: string
         threadId: string
         snippet: string`}</pre>
-        </div>
-      </div>
+				</div>
+			</div>
 
-      <div className="space-y-4">
-        <h2 className="text-2xl font-bold">Use cases</h2>
-        <ul className="text-muted-foreground list-inside list-disc space-y-2">
-          <li>Parse support emails and create tickets</li>
-          <li>Extract attachments and process them</li>
-          <li>Build email-to-task workflows</li>
-          <li>Monitor specific email threads</li>
-        </ul>
-      </div>
+			<div className="space-y-4">
+				<h2 className="font-bold text-2xl">Use cases</h2>
+				<ul className="list-inside list-disc space-y-2 text-muted-foreground">
+					<li>Parse support emails and create tickets</li>
+					<li>Extract attachments and process them</li>
+					<li>Build email-to-task workflows</li>
+					<li>Monitor specific email threads</li>
+				</ul>
+			</div>
 
-      <div className="flex items-center gap-4 pt-4">
-        <Link href="/docs/integrations/resend" className="btn-ghost">
-          Previous: Resend
-        </Link>
-        <Link href="/docs/integrations/google-calendar" className="btn-primary">
-          Next: Google Calendar <ChevronRight size={16} />
-        </Link>
-      </div>
-    </div>
-  );
+			<div className="flex items-center gap-4 pt-4">
+				<Link href="/docs/integrations/resend" className="btn-ghost">
+					Previous: Resend
+				</Link>
+				<Link href="/docs/integrations/google-calendar" className="btn-primary">
+					Next: Google Calendar <ChevronRight size={16} />
+				</Link>
+			</div>
+		</div>
+	);
 }

package/src/components/docs/integrations/IntegrationsGoogleCalendarPage.tsx

@@ -8,30 +8,30 @@ import { ChevronRight } from 'lucide-react';
 // };
 
 export function IntegrationsGoogleCalendarPage() {
-  return (
-    <div className="space-y-8">
-      <div className="space-y-4">
-        <h1 className="text-4xl font-bold">Google Calendar</h1>
-        <p className="text-muted-foreground">
-          Integrate Google Calendar to schedule appointments, manage
-          availability, and sync events with your application.
-        </p>
-      </div>
+	return (
+		<div className="space-y-8">
+			<div className="space-y-4">
+				<h1 className="font-bold text-4xl">Google Calendar</h1>
+				<p className="text-muted-foreground">
+					Integrate Google Calendar to schedule appointments, manage
+					availability, and sync events with your application.
+				</p>
+			</div>
 
-      <div className="space-y-4">
-        <h2 className="text-2xl font-bold">Setup</h2>
-        <div className="bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm">
-          <pre>{`# .env
+			<div className="space-y-4">
+				<h2 className="font-bold text-2xl">Setup</h2>
+				<div className="overflow-x-auto rounded-lg border border-border bg-background/50 p-4 font-mono text-muted-foreground text-sm">
+					<pre>{`# .env
 GOOGLE_CLIENT_ID=...
 GOOGLE_CLIENT_SECRET=...
 GOOGLE_CALENDAR_ID=primary`}</pre>
-        </div>
-      </div>
+				</div>
+			</div>
 
-      <div className="space-y-4">
-        <h2 className="text-2xl font-bold">Creating events</h2>
-        <div className="bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm">
-          <pre>{`capabilityId: calendar-create-event
+			<div className="space-y-4">
+				<h2 className="font-bold text-2xl">Creating events</h2>
+				<div className="overflow-x-auto rounded-lg border border-border bg-background/50 p-4 font-mono text-muted-foreground text-sm">
+					<pre>{`capabilityId: calendar-create-event
 provider:
   type: google-calendar
   operation: createEvent
@@ -56,17 +56,17 @@ outputs:
     type: string
   htmlLink:
     type: string`}</pre>
-        </div>
-      </div>
+				</div>
+			</div>
 
-      <div className="flex items-center gap-4 pt-4">
-        <Link href="/docs/integrations/gmail" className="btn-ghost">
-          Previous: Gmail API
-        </Link>
-        <Link href="/docs/integrations/openai" className="btn-primary">
-          Next: OpenAI <ChevronRight size={16} />
-        </Link>
-      </div>
-    </div>
-  );
+			<div className="flex items-center gap-4 pt-4">
+				<Link href="/docs/integrations/gmail" className="btn-ghost">
+					Previous: Gmail API
+				</Link>
+				<Link href="/docs/integrations/openai" className="btn-primary">
+					Next: OpenAI <ChevronRight size={16} />
+				</Link>
+			</div>
+		</div>
+	);
 }

package/src/components/docs/integrations/IntegrationsHealthRoutingPage.tsx

@@ -1,21 +1,21 @@
 import Link from '@contractspec/lib.ui-link';
 
 export function IntegrationsHealthRoutingPage() {
-  return (
-    <div className="space-y-8">
-      <div className="space-y-4">
-        <h1 className="text-4xl font-bold">Health Routing Strategy</h1>
-        <p className="text-muted-foreground">
-          Health integrations resolve providers through deterministic transport
-          strategy order with explicit capability gating and unofficial-route
-          controls.
-        </p>
-      </div>
+	return (
+		<div className="space-y-8">
+			<div className="space-y-4">
+				<h1 className="font-bold text-4xl">Health Routing Strategy</h1>
+				<p className="text-muted-foreground">
+					Health integrations resolve providers through deterministic transport
+					strategy order with explicit capability gating and unofficial-route
+					controls.
+				</p>
+			</div>
 
-      <div className="space-y-4">
-        <h2 className="text-2xl font-bold">Connection config fields</h2>
-        <div className="bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm">
-          <pre>{`{
+			<div className="space-y-4">
+				<h2 className="font-bold text-2xl">Connection config fields</h2>
+				<div className="overflow-x-auto rounded-lg border border-border bg-background/50 p-4 font-mono text-muted-foreground text-sm">
+					<pre>{`{
   "defaultTransport": "official-api",
   "strategyOrder": [
     "official-api",
@@ -30,13 +30,13 @@ export function IntegrationsHealthRoutingPage() {
   "mcpUrl": "https://mcp.provider.example",
   "oauthTokenUrl": "https://api.provider.example/oauth/token"
 }`}</pre>
-        </div>
-      </div>
+				</div>
+			</div>
 
-      <div className="space-y-4">
-        <h2 className="text-2xl font-bold">Secret payload fields</h2>
-        <div className="bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm">
-          <pre>{`{
+			<div className="space-y-4">
+				<h2 className="font-bold text-2xl">Secret payload fields</h2>
+				<div className="overflow-x-auto rounded-lg border border-border bg-background/50 p-4 font-mono text-muted-foreground text-sm">
+					<pre>{`{
   "apiKey": "...",
   "accessToken": "...",
   "refreshToken": "...",
@@ -46,67 +46,67 @@ export function IntegrationsHealthRoutingPage() {
   "mcpAccessToken": "...",
   "webhookSecret": "..."
 }`}</pre>
-        </div>
-      </div>
+				</div>
+			</div>
 
-      <div className="space-y-4">
-        <h2 className="text-2xl font-bold">Routing behavior</h2>
-        <ul className="text-muted-foreground list-inside list-disc space-y-2">
-          <li>
-            Unsupported strategies are skipped per provider capability matrix.
-          </li>
-          <li>
-            Missing credentials fail closed and fall through only when a later
-            strategy is valid.
-          </li>
-          <li>
-            Unofficial routes are disabled unless
-            <code className="bg-background/50 ml-1 rounded px-2 py-1">
-              allowUnofficial
-            </code>
-            is true.
-          </li>
-          <li>
-            When
-            <code className="bg-background/50 ml-1 rounded px-2 py-1">
-              unofficialAllowList
-            </code>
-            is set, only listed provider keys can route unofficially.
-          </li>
-          <li>
-            OAuth refresh uses
-            <code className="bg-background/50 ml-1 rounded px-2 py-1">
-              oauthTokenUrl
-            </code>
-            with refresh/client credentials when APIs return 401.
-          </li>
-        </ul>
-      </div>
+			<div className="space-y-4">
+				<h2 className="font-bold text-2xl">Routing behavior</h2>
+				<ul className="list-inside list-disc space-y-2 text-muted-foreground">
+					<li>
+						Unsupported strategies are skipped per provider capability matrix.
+					</li>
+					<li>
+						Missing credentials fail closed and fall through only when a later
+						strategy is valid.
+					</li>
+					<li>
+						Unofficial routes are disabled unless
+						<code className="ml-1 rounded bg-background/50 px-2 py-1">
+							allowUnofficial
+						</code>
+						is true.
+					</li>
+					<li>
+						When
+						<code className="ml-1 rounded bg-background/50 px-2 py-1">
+							unofficialAllowList
+						</code>
+						is set, only listed provider keys can route unofficially.
+					</li>
+					<li>
+						OAuth refresh uses
+						<code className="ml-1 rounded bg-background/50 px-2 py-1">
+							oauthTokenUrl
+						</code>
+						with refresh/client credentials when APIs return 401.
+					</li>
+				</ul>
+			</div>
 
-      <div className="space-y-4">
-        <h2 className="text-2xl font-bold">Provider guidance</h2>
-        <ul className="text-muted-foreground list-inside list-disc space-y-2">
-          <li>
-            Use official APIs when available (Whoop, Oura, Strava, Fitbit).
-          </li>
-          <li>
-            Use aggregator routing for providers without stable official APIs
-            (Garmin, MyFitnessPal, Eight Sleep, Peloton).
-          </li>
-          <li>
-            Keep unofficial automation opt-in and auditable for production.
-          </li>
-        </ul>
-      </div>
+			<div className="space-y-4">
+				<h2 className="font-bold text-2xl">Provider guidance</h2>
+				<ul className="list-inside list-disc space-y-2 text-muted-foreground">
+					<li>
+						Use official APIs when available (Whoop, Oura, Strava, Fitbit).
+					</li>
+					<li>
+						Use aggregator routing for providers without stable official APIs
+						(Garmin, MyFitnessPal, Eight Sleep, Peloton).
+					</li>
+					<li>
+						Keep unofficial automation opt-in and auditable for production.
+					</li>
+				</ul>
+			</div>
 
-      <div className="flex items-center gap-4 pt-4">
-        <Link href="/docs/integrations/whatsapp-twilio" className="btn-ghost">
-          Previous: WhatsApp Twilio
-        </Link>
-        <Link href="/docs/integrations" className="btn-primary">
-          Back to Integrations
-        </Link>
-      </div>
-    </div>
-  );
+			<div className="flex items-center gap-4 pt-4">
+				<Link href="/docs/integrations/whatsapp-twilio" className="btn-ghost">
+					Previous: WhatsApp Twilio
+				</Link>
+				<Link href="/docs/integrations" className="btn-primary">
+					Back to Integrations
+				</Link>
+			</div>
+		</div>
+	);
 }