@contractspec/bundle.library 1.12.0 → 1.14.0

package/dist/node/components/docs/libraries/LibrariesGraphQLPage.js

@@ -0,0 +1,186 @@
+// src/components/docs/libraries/LibrariesGraphQLPage.tsx
+import Link from "@contractspec/lib.ui-link";
+import { ChevronRight } from "lucide-react";
+import { CodeBlock, InstallCommand } from "@contractspec/lib.design-system";
+import { jsxDEV } from "react/jsx-dev-runtime";
+function LibrariesGraphQLPage() {
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "space-y-8",
+    children: [
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h1", {
+            className: "text-4xl font-bold",
+            children: "GraphQL Libraries"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground",
+            children: "This suite of libraries enables seamless GraphQL integration, transforming your ContractSpecs into a type-safe Pothos schema, connecting with Prisma, and enabling Apollo Federation."
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Libraries"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "grid gap-4 md:grid-cols-1",
+            children: [
+              /* @__PURE__ */ jsxDEV("div", {
+                className: "card-subtle p-6",
+                children: [
+                  /* @__PURE__ */ jsxDEV("h3", {
+                    className: "text-lg font-bold",
+                    children: "@contractspec/lib.graphql-core"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV("p", {
+                    className: "text-muted-foreground mt-2 text-sm",
+                    children: "The foundation. Provides a configured Pothos builder, common scalars (JSON, DateTime), and utilities for mapping ContractSpec I/O to Pothos types."
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV("div", {
+                className: "card-subtle p-6",
+                children: [
+                  /* @__PURE__ */ jsxDEV("h3", {
+                    className: "text-lg font-bold",
+                    children: "@contractspec/lib.graphql-prisma"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV("p", {
+                    className: "text-muted-foreground mt-2 text-sm",
+                    children: "Connects Pothos to Prisma. Automatically generates GraphQL types from your Prisma schema and optimizes queries to prevent N+1 issues."
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV("div", {
+                className: "card-subtle p-6",
+                children: [
+                  /* @__PURE__ */ jsxDEV("h3", {
+                    className: "text-lg font-bold",
+                    children: "@contractspec/lib.graphql-federation"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV("p", {
+                    className: "text-muted-foreground mt-2 text-sm",
+                    children: "Adds Apollo Federation V2 support. Allows your subgraph to define keys and entities, making it ready for a supergraph."
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Installation"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(InstallCommand, {
+            package: [
+              "@contractspec/lib.graphql-core",
+              "@contractspec/lib.graphql-prisma",
+              "@contractspec/lib.graphql-federation"
+            ]
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Usage: Building a Schema"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground",
+            children: "Here's how to assemble a federated GraphQL schema from your specs:"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "typescript",
+            code: `import { builder } from '@contractspec/lib.graphql-core';
+import { registerContractsOnBuilder } from '@contractspec/lib.contracts/server/graphql-pothos';
+import { OperationSpecRegistry } from '@contractspec/lib.contracts';
+import { MySpecs } from './specs';
+
+// 1. Register contracts
+const registry = new OperationSpecRegistry();
+registry.register(MySpecs);
+
+// 2. Mount specs onto Pothos builder
+registerContractsOnBuilder(builder, registry);
+
+// 3. Build and print schema
+const schema = builder.toSchema();
+console.log(printSchema(schema));`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Features"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("ul", {
+            className: "text-muted-foreground list-inside list-disc space-y-2",
+            children: [
+              /* @__PURE__ */ jsxDEV("li", {
+                children: [
+                  /* @__PURE__ */ jsxDEV("strong", {
+                    children: "Code-First"
+                  }, undefined, false, undefined, this),
+                  ": Define schema in TypeScript (Pothos), get SDL as artifact."
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: [
+                  /* @__PURE__ */ jsxDEV("strong", {
+                    children: "Spec Integration"
+                  }, undefined, false, undefined, this),
+                  ": `registerContractsOnBuilder` automatically converts Command/Query specs into Mutations/Queries."
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: [
+                  /* @__PURE__ */ jsxDEV("strong", {
+                    children: "Federation Ready"
+                  }, undefined, false, undefined, this),
+                  ": Just add `provider: 'federation'` to your config."
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "flex items-center gap-4 pt-4",
+        children: [
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/libraries/data-backend",
+            className: "btn-primary",
+            children: [
+              "Next: Data & Backend ",
+              /* @__PURE__ */ jsxDEV(ChevronRight, {
+                size: 16
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/libraries",
+            className: "btn-ghost",
+            children: "Back to Libraries"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  LibrariesGraphQLPage
+};

package/dist/node/components/docs/libraries/LibrariesGrowthPage.js

@@ -0,0 +1,116 @@
+// src/components/docs/libraries/LibrariesGrowthPage.tsx
+import { CodeBlock, InstallCommand } from "@contractspec/lib.design-system";
+import Link from "@contractspec/lib.ui-link";
+import { ChevronRight } from "lucide-react";
+import { jsxDEV } from "react/jsx-dev-runtime";
+function LibrariesGrowthPage() {
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "space-y-8",
+    children: [
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h1", {
+            className: "text-4xl font-bold",
+            children: "@contractspec/lib.growth"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground text-lg",
+            children: "Launch experiments without third-party SDKs. Register variants, assign users deterministically, track exposures, and compute significance."
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Installation"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(InstallCommand, {
+            package: "@contractspec/lib.growth"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-3",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Register + assign"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "typescript",
+            code: `import { ExperimentRegistry, ExperimentRunner } from '@contractspec/lib.growth/experiments';
+
+const registry = new ExperimentRegistry().register({
+  key: 'pricing.cta',
+  version: '1.0.0',
+  goal: 'Increase demo bookings',
+  variants: [
+    { id: 'A', weight: 1 },
+    { id: 'B', weight: 1 },
+  ],
+  primaryMetric: 'demo_booked',
+});
+
+const runner = new ExperimentRunner();
+const assignment = runner.assign(registry.get('pricing.cta')!, 'user_123');`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-3",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Track + analyze"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "typescript",
+            code: `import { ExperimentTracker } from '@contractspec/lib.growth/tracker';
+import { StatsEngine } from '@contractspec/lib.growth/stats';
+
+const tracker = new ExperimentTracker(new InMemoryTrackerStore());
+await tracker.recordAssignment(assignment);
+await tracker.recordSample({
+  experimentKey: assignment.experimentKey,
+  variantId: assignment.variantId,
+  metric: 'demo_booked',
+  value: 1,
+  timestamp: new Date(),
+});
+
+const stats = new StatsEngine().summarize(
+  await tracker.getSamples(assignment.experimentKey, 'demo_booked'),
+  'demo_booked'
+);`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "flex items-center gap-4 pt-4",
+        children: [
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/libraries",
+            className: "btn-ghost",
+            children: "Back to Libraries"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/libraries/analytics",
+            className: "btn-primary",
+            children: [
+              "Next: Analytics ",
+              /* @__PURE__ */ jsxDEV(ChevronRight, {
+                size: 16
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  LibrariesGrowthPage
+};

package/dist/node/components/docs/libraries/LibrariesMultiTenancyPage.js

@@ -0,0 +1,118 @@
+// src/components/docs/libraries/LibrariesMultiTenancyPage.tsx
+import { CodeBlock, InstallCommand } from "@contractspec/lib.design-system";
+import Link from "@contractspec/lib.ui-link";
+import { ChevronRight } from "lucide-react";
+import { jsxDEV } from "react/jsx-dev-runtime";
+function LibrariesMultiTenancyPage() {
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "space-y-8",
+    children: [
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h1", {
+            className: "text-4xl font-bold",
+            children: "Multi-Tenancy Library"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground text-lg",
+            children: [
+              "The ",
+              /* @__PURE__ */ jsxDEV("code", {
+                children: "@contractspec/lib.multi-tenancy"
+              }, undefined, false, undefined, this),
+              " library provides the core building blocks for secure SaaS applications."
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Installation"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(InstallCommand, {
+            package: "@contractspec/lib.multi-tenancy"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Prisma RLS Middleware"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground",
+            children: [
+              "Automatically injects ",
+              /* @__PURE__ */ jsxDEV("code", {
+                children: "tenantId"
+              }, undefined, false, undefined, this),
+              " into all queries."
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "typescript",
+            code: `import { createRlsMiddleware } from '@contractspec/lib.multi-tenancy/rls';
+import { prisma } from './db';
+import { getTenantId } from './context';
+
+prisma.$use(createRlsMiddleware(() => getTenantId()));`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Provisioning Service"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground",
+            children: "Automates the creation of new tenants, including database setup and default user creation."
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "typescript",
+            code: `import { TenantProvisioningService } from '@contractspec/lib.multi-tenancy/provisioning';
+
+const service = new TenantProvisioningService({ db: prisma });
+await service.provision({
+  id: 'acme',
+  name: 'Acme Corp',
+  slug: 'acme',
+  ownerEmail: 'admin@acme.com'
+});`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "flex items-center gap-4 pt-4",
+        children: [
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/libraries",
+            className: "btn-ghost",
+            children: "Back to Libraries"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/libraries/progressive-delivery",
+            className: "btn-primary",
+            children: [
+              "Next: Progressive Delivery ",
+              /* @__PURE__ */ jsxDEV(ChevronRight, {
+                size: 16
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  LibrariesMultiTenancyPage
+};

package/dist/node/components/docs/libraries/LibrariesObservabilityPage.js

@@ -0,0 +1,149 @@
+// src/components/docs/libraries/LibrariesObservabilityPage.tsx
+import { CodeBlock, InstallCommand } from "@contractspec/lib.design-system";
+import Link from "@contractspec/lib.ui-link";
+import { ChevronRight } from "lucide-react";
+import { jsxDEV } from "react/jsx-dev-runtime";
+function LibrariesObservabilityPage() {
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "space-y-8",
+    children: [
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h1", {
+            className: "text-4xl font-bold",
+            children: "Observability Library"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground text-lg",
+            children: [
+              "The ",
+              /* @__PURE__ */ jsxDEV("code", {
+                children: "@contractspec/lib.observability"
+              }, undefined, false, undefined, this),
+              " library provides a thin wrapper around OpenTelemetry to simplify instrumentation."
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Installation"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(InstallCommand, {
+            package: "@contractspec/lib.observability"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Tracing"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "typescript",
+            code: `import { traceAsync, traceSync } from '@contractspec/lib.observability/tracing';
+
+await traceAsync('process_order', async (span) => {
+  span.setAttribute('order_id', order.id);
+  await db.save(order);
+});`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Metrics"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "typescript",
+            code: `import { createCounter, createHistogram } from '@contractspec/lib.observability/metrics';
+
+const ordersCounter = createCounter('orders_total');
+const latencyHistogram = createHistogram('request_duration_seconds');
+
+ordersCounter.add(1, { status: 'success' });
+latencyHistogram.record(0.123);`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Middleware"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground",
+            children: "Automatically instrument your HTTP handlers:"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "typescript",
+            code: `import { createTracingMiddleware } from '@contractspec/lib.observability/tracing/middleware';
+
+app.use(createTracingMiddleware());`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Anomaly Detection"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground text-sm",
+            children: "Includes baseline calculation and anomaly detection helpers for auto-rollback without writing custom math."
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "typescript",
+            code: `import { AnomalyDetector, RootCauseAnalyzer, AlertManager } from '@contractspec/lib.observability';
+
+const detector = new AnomalyDetector({ errorRateDelta: 0.4 });
+const analyzer = new RootCauseAnalyzer();
+const alertManager = new AlertManager({ transport: sendOpsAlert });
+
+const signals = detector.evaluate(point);
+signals.forEach((signal) => {
+  const analysis = analyzer.analyze(signal, recentDeployments);
+  alertManager.notify(signal, analysis);
+});`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "flex items-center gap-4 pt-4",
+        children: [
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/libraries",
+            className: "btn-ghost",
+            children: "Back to Libraries"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/libraries/slo",
+            className: "btn-primary",
+            children: [
+              "Next: SLO ",
+              /* @__PURE__ */ jsxDEV(ChevronRight, {
+                size: 16
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  LibrariesObservabilityPage
+};