@contractspec/lib.contracts 1.57.0 → 1.58.0

package/dist/install.d.ts

@@ -1,74 +1,76 @@
-import { ResourceRefDescriptor } from "./resources.js";
-import { AnyOperationSpec, EmitDecl, OperationSpec } from "./operations/operation.js";
-import "./operations/index.js";
-import { HandlerCtx } from "./types.js";
-import { OperationSpecRegistry } from "./operations/registry.js";
-import { EventSpec } from "./events.js";
-import { AnySchemaModel, ZodSchemaModel } from "@contractspec/lib.schema";
-import * as z$2 from "zod";
-
-//#region src/install.d.ts
+import * as z from 'zod';
+import type { AnyOperationSpec, EmitDecl, OperationSpec } from './operations/';
+import type { ResourceRefDescriptor } from './resources';
+import type { HandlerCtx } from './types';
+import { OperationSpecRegistry } from './operations/registry';
+import type { EventSpec } from './events';
+import type { AnySchemaModel, ZodSchemaModel } from '@contractspec/lib.schema';
 /** Infer input/output types from a OperationSpec */
-type OperationSpecInput<Spec extends AnyOperationSpec> = Spec['io']['input'];
-type ZodOperationSpecInput<Spec extends AnyOperationSpec> = ZodSchemaModel<OperationSpecInput<Spec> extends null ? AnySchemaModel : NonNullable<OperationSpecInput<Spec>>>;
-type OperationSpecOutput<Spec extends AnyOperationSpec> = Spec['io']['output'];
+export type OperationSpecInput<Spec extends AnyOperationSpec> = Spec['io']['input'];
+export type ZodOperationSpecInput<Spec extends AnyOperationSpec> = ZodSchemaModel<OperationSpecInput<Spec> extends null ? AnySchemaModel : NonNullable<OperationSpecInput<Spec>>>;
+export type OperationSpecOutput<Spec extends AnyOperationSpec> = Spec['io']['output'];
 type ResourceItem<O extends ResourceRefDescriptor<boolean>> = Record<O['varName'] extends string ? O['varName'] : 'id', string | number>;
 type ResourceRefOut<O> = O extends ResourceRefDescriptor<boolean> ? O['many'] extends true ? ResourceItem<O>[] : ResourceItem<O> : never;
-type RuntimeSpecOutput<Spec extends AnyOperationSpec> = OperationSpecOutput<Spec> extends AnySchemaModel ? ZodSchemaModel<OperationSpecOutput<Spec>> : ResourceRefOut<OperationSpecOutput<Spec>>;
+export type RuntimeSpecOutput<Spec extends AnyOperationSpec> = OperationSpecOutput<Spec> extends AnySchemaModel ? ZodSchemaModel<OperationSpecOutput<Spec>> : ResourceRefOut<OperationSpecOutput<Spec>>;
 /** Handler signature derived from the Spec */
-type HandlerForOperationSpec<Spec extends AnyOperationSpec> = (args: ZodOperationSpecInput<Spec>, ctx: HandlerCtx) => Promise<RuntimeSpecOutput<Spec>>;
+export type HandlerForOperationSpec<Spec extends AnyOperationSpec> = (args: ZodOperationSpecInput<Spec>, ctx: HandlerCtx) => Promise<RuntimeSpecOutput<Spec>>;
 /** Typed event param from Spec.sideEffects.emits */
-type EventParam<S extends OperationSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>> = S extends {
-  sideEffects?: {
-    emits?: readonly (infer E)[];
-  };
+export type EventParam<S extends OperationSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>> = S extends {
+    sideEffects?: {
+        emits?: readonly (infer E)[];
+    };
 } ? E extends {
-  key: string;
-  version: string;
-  payload: AnySchemaModel;
+    key: string;
+    version: string;
+    payload: AnySchemaModel;
 } ? {
-  key: E['key'];
-  version: E['version'];
-  payload: z$2.infer<ReturnType<E['payload']['getZod']>>;
+    key: E['key'];
+    version: E['version'];
+    payload: z.infer<ReturnType<E['payload']['getZod']>>;
 } : never : never;
 /** Build a type union of allowed events for a spec */
 type AllowedEventUnion<S extends OperationSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>> = S['sideEffects'] extends {
-  emits: readonly EmitDecl[];
-} ? { [K in keyof S['sideEffects']['emits']]: S['sideEffects']['emits'][K] extends {
-  ref: EventSpec<infer P>;
+    emits: readonly EmitDecl[];
 } ? {
-  key: S['sideEffects']['emits'][K]['ref']['meta']['key'];
-  version: S['sideEffects']['emits'][K]['ref']['meta']['version'];
-  payload: z$2.infer<ReturnType<P['getZod']>>;
-} : S['sideEffects']['emits'][K] extends {
-  key: infer N extends string;
-  version: infer V extends string;
-  payload: infer Q extends AnySchemaModel;
-} ? {
-  key: N;
-  version: V;
-  payload: z$2.infer<ReturnType<Q['getZod']>>;
-} : never }[number] : never;
+    [K in keyof S['sideEffects']['emits']]: S['sideEffects']['emits'][K] extends {
+        ref: EventSpec<infer P>;
+    } ? {
+        key: S['sideEffects']['emits'][K]['ref']['meta']['key'];
+        version: S['sideEffects']['emits'][K]['ref']['meta']['version'];
+        payload: z.infer<ReturnType<P['getZod']>>;
+    } : S['sideEffects']['emits'][K] extends {
+        key: infer N extends string;
+        version: infer V extends string;
+        payload: infer Q extends AnySchemaModel;
+    } ? {
+        key: N;
+        version: V;
+        payload: z.infer<ReturnType<Q['getZod']>>;
+    } : never;
+}[number] : never;
 /** Typed emit for a given spec (validates at runtime through ctx.__emitGuard__). */
-declare function makeEmit<S extends AnyOperationSpec>(_spec: S, ctx: HandlerCtx): {
-  /** Le plus sûr : typé via EventSpec (pas besoin de tuple dans le spec) */ref: <T extends AnySchemaModel>(ev: EventSpec<T>, payload: ZodSchemaModel<T>) => Promise<void>; /** Nom/version explicites (runtime-checked par la guard) */
-  key: (key: string, version: string, payload: unknown) => Promise<void>; /** Compat : objet (bénéficie du typing si votre spec a un tuple `as const`) */
-  object: (evt: AllowedEventUnion<S>) => Promise<void>;
+export declare function makeEmit<S extends AnyOperationSpec>(_spec: S, ctx: HandlerCtx): {
+    /** Le plus sûr : typé via EventSpec (pas besoin de tuple dans le spec) */
+    ref: <T extends AnySchemaModel>(ev: EventSpec<T>, payload: ZodSchemaModel<T>) => Promise<void>;
+    /** Nom/version explicites (runtime-checked par la guard) */
+    key: (key: string, version: string, payload: unknown) => Promise<void>;
+    /** Compat : objet (bénéficie du typing si votre spec a un tuple `as const`) */
+    object: (evt: AllowedEventUnion<S>) => Promise<void>;
 };
 /**
  * Register the Spec and bind the handler in one call, with full type inference.
  * Returns the registry for chaining.
  */
-declare function installOp<S extends AnyOperationSpec>(reg: OperationSpecRegistry, spec: S, handler: HandlerForOperationSpec<S>): OperationSpecRegistry;
+export declare function installOp<S extends AnyOperationSpec>(reg: OperationSpecRegistry, spec: S, handler: HandlerForOperationSpec<S>): OperationSpecRegistry;
 /**
  * Curried variant if you prefer building a module installer.
  *   const install = op(BeginSignupSpec, handler);
  *   install(reg);
  */
-declare function op<S extends AnyOperationSpec>(spec: S, handler: HandlerForOperationSpec<AnyOperationSpec>): {
-  spec: S;
-  handler: HandlerForOperationSpec<AnyOperationSpec>;
-  install: (reg: OperationSpecRegistry) => OperationSpecRegistry;
+export declare function op<S extends AnyOperationSpec>(spec: S, handler: HandlerForOperationSpec<AnyOperationSpec>): {
+    spec: S;
+    handler: HandlerForOperationSpec<AnyOperationSpec>;
+    install: (reg: OperationSpecRegistry) => OperationSpecRegistry;
 };
-//#endregion
-export { EventParam, HandlerForOperationSpec, OperationSpecInput, OperationSpecOutput, RuntimeSpecOutput, ZodOperationSpecInput, installOp, makeEmit, op };
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"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"}

package/dist/install.js

@@ -1,40 +1,60 @@
-import "./operations/registry.js";
-import "zod";
+// @bun
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
 
-//#region src/install.ts
-/** Typed emit for a given spec (validates at runtime through ctx.__emitGuard__). */
+// src/install.ts
 function makeEmit(_spec, ctx) {
-	return {
-		ref: async (ev, payload) => {
-			await ctx.__emitGuard__?.(ev.meta.key, ev.meta.version, payload);
-		},
-		key: async (key, version, payload) => {
-			await ctx.__emitGuard__?.(key, version, payload);
-		},
-		object: async (evt) => {
-			await ctx.__emitGuard__?.(evt.key, evt.version, evt.payload);
-		}
-	};
+  return {
+    ref: async (ev, payload) => {
+      await ctx.__emitGuard__?.(ev.meta.key, ev.meta.version, payload);
+    },
+    key: async (key, version, payload) => {
+      await ctx.__emitGuard__?.(key, version, payload);
+    },
+    object: async (evt) => {
+      await ctx.__emitGuard__?.(evt.key, evt.version, evt.payload);
+    }
+  };
 }
-/**
-* Register the Spec and bind the handler in one call, with full type inference.
-* Returns the registry for chaining.
-*/
 function installOp(reg, spec, handler) {
-	return reg.register(spec).bind(spec, handler);
+  return reg.register(spec).bind(spec, handler);
 }
-/**
-* Curried variant if you prefer building a module installer.
-*   const install = op(BeginSignupSpec, handler);
-*   install(reg);
-*/
 function op(spec, handler) {
-	return {
-		spec,
-		handler,
-		install: (reg) => installOp(reg, spec, handler)
-	};
+  return {
+    spec,
+    handler,
+    install: (reg) => installOp(reg, spec, handler)
+  };
 }
-
-//#endregion
-export { installOp, makeEmit, op };
+export {
+  op,
+  makeEmit,
+  installOp
+};

package/dist/integrations/binding.d.ts

@@ -1,17 +1,15 @@
-//#region src/integrations/binding.d.ts
-interface AppIntegrationBinding {
-  /** Which slot this binding satisfies. */
-  slotId: string;
-  /** Which IntegrationConnection to use. */
-  connectionId: string;
-  /** Optional: scope to specific workflows/features. */
-  scope?: {
-    workflows?: string[];
-    features?: string[];
-    operations?: string[];
-  };
-  /** Priority when multiple connections provide same capability. */
-  priority?: number;
+export interface AppIntegrationBinding {
+    /** Which slot this binding satisfies. */
+    slotId: string;
+    /** Which IntegrationConnection to use. */
+    connectionId: string;
+    /** Optional: scope to specific workflows/features. */
+    scope?: {
+        workflows?: string[];
+        features?: string[];
+        operations?: string[];
+    };
+    /** Priority when multiple connections provide same capability. */
+    priority?: number;
 }
-//#endregion
-export { AppIntegrationBinding };
+//# sourceMappingURL=binding.d.ts.map

package/dist/integrations/binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/integrations/binding.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,KAAK,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/integrations/binding.js

@@ -0,0 +1 @@
+// @bun

package/dist/integrations/connection.d.ts

@@ -1,51 +1,48 @@
-import { IntegrationOwnershipMode } from "./spec.js";
-
-//#region src/integrations/connection.d.ts
-type ConnectionStatus = 'connected' | 'disconnected' | 'error' | 'unknown';
-interface IntegrationConnectionHealth {
-  status: ConnectionStatus;
-  checkedAt?: Date;
-  latencyMs?: number;
-  errorCode?: string;
-  errorMessage?: string;
+import type { IntegrationOwnershipMode } from './spec';
+export type ConnectionStatus = 'connected' | 'disconnected' | 'error' | 'unknown';
+export interface IntegrationConnectionHealth {
+    status: ConnectionStatus;
+    checkedAt?: Date;
+    latencyMs?: number;
+    errorCode?: string;
+    errorMessage?: string;
 }
-interface IntegrationUsageMetrics {
-  requestCount?: number;
-  successCount?: number;
-  errorCount?: number;
-  lastUsed?: Date;
-  lastSuccessAt?: Date;
-  lastErrorAt?: Date;
-  lastErrorCode?: string;
+export interface IntegrationUsageMetrics {
+    requestCount?: number;
+    successCount?: number;
+    errorCount?: number;
+    lastUsed?: Date;
+    lastSuccessAt?: Date;
+    lastErrorAt?: Date;
+    lastErrorCode?: string;
 }
-interface IntegrationConnectionMeta {
-  id: string;
-  tenantId: string;
-  /** Reference to IntegrationSpec. */
-  integrationKey: string;
-  integrationVersion: string;
-  /** Human-readable label (e.g., "Production Stripe"). */
-  label: string;
-  environment?: string;
-  createdAt: string | Date;
-  updatedAt: string | Date;
+export interface IntegrationConnectionMeta {
+    id: string;
+    tenantId: string;
+    /** Reference to IntegrationSpec. */
+    integrationKey: string;
+    integrationVersion: string;
+    /** Human-readable label (e.g., "Production Stripe"). */
+    label: string;
+    environment?: string;
+    createdAt: string | Date;
+    updatedAt: string | Date;
 }
-interface IntegrationConnection {
-  meta: IntegrationConnectionMeta;
-  /** Ownership mode indicating who controls credentials. */
-  ownershipMode: IntegrationOwnershipMode;
-  /** External provider account/project identifier (BYOK scenarios). */
-  externalAccountId?: string;
-  /** Encrypted configuration matching IntegrationSpec.configSchema. */
-  config: Record<string, unknown>;
-  /** Reference to external secret store entry containing credentials. */
-  secretProvider: string;
-  secretRef: string;
-  status: ConnectionStatus;
-  /** Last health check result. */
-  health?: IntegrationConnectionHealth;
-  /** Usage tracking. */
-  usage?: IntegrationUsageMetrics;
+export interface IntegrationConnection {
+    meta: IntegrationConnectionMeta;
+    /** Ownership mode indicating who controls credentials. */
+    ownershipMode: IntegrationOwnershipMode;
+    /** External provider account/project identifier (BYOK scenarios). */
+    externalAccountId?: string;
+    /** Encrypted configuration matching IntegrationSpec.configSchema. */
+    config: Record<string, unknown>;
+    /** Reference to external secret store entry containing credentials. */
+    secretProvider: string;
+    secretRef: string;
+    status: ConnectionStatus;
+    /** Last health check result. */
+    health?: IntegrationConnectionHealth;
+    /** Usage tracking. */
+    usage?: IntegrationUsageMetrics;
 }
-//#endregion
-export { ConnectionStatus, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationUsageMetrics };
+//# sourceMappingURL=connection.d.ts.map

package/dist/integrations/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/integrations/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,QAAQ,CAAC;AAEvD,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,cAAc,GACd,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,yBAAyB,CAAC;IAChC,0DAA0D;IAC1D,aAAa,EAAE,wBAAwB,CAAC;IACxC,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,uEAAuE;IACvE,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,gCAAgC;IAChC,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,sBAAsB;IACtB,KAAK,CAAC,EAAE,uBAAuB,CAAC;CACjC"}

package/dist/integrations/connection.js

@@ -0,0 +1 @@
+// @bun

package/dist/integrations/docs/integrations.docblock.d.ts

@@ -1,6 +1,3 @@
-import { DocBlock } from "@contractspec/lib.contracts/docs";
-
-//#region src/integrations/docs/integrations.docblock.d.ts
-declare const tech_contracts_integrations_DocBlocks: DocBlock[];
-//#endregion
-export { tech_contracts_integrations_DocBlocks };
+import type { DocBlock } from '@contractspec/lib.contracts/docs';
+export declare const tech_contracts_integrations_DocBlocks: DocBlock[];
+//# sourceMappingURL=integrations.docblock.d.ts.map

package/dist/integrations/docs/integrations.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.docblock.d.ts","sourceRoot":"","sources":["../../../src/integrations/docs/integrations.docblock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAGjE,eAAO,MAAM,qCAAqC,EAAE,QAAQ,EAuG3D,CAAC"}

package/dist/integrations/docs/integrations.docblock.js

@@ -1,29 +1,171 @@
-import { registerDocBlocks } from "../../docs/registry.js";
-
-//#region src/integrations/docs/integrations.docblock.ts
-const tech_contracts_integrations_DocBlocks = [{
-	id: "docs.tech.contracts.integrations",
-	title: "ContractSpec Integrations",
-	summary: "Provider-agnostic integration contracts: specs, connections, secrets, health checks, and runtime guards.",
-	kind: "reference",
-	visibility: "public",
-	route: "/docs/tech/contracts/integrations",
-	tags: [
-		"tech",
-		"contracts",
-		"integrations"
-	],
-	body: `# ContractSpec Integrations
+// @bun
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
+
+// src/docs/presentations.ts
+var DEFAULT_TARGETS = [
+  "markdown",
+  "react"
+];
+function normalizeRoute(route) {
+  if (!route.length)
+    return "/";
+  const withLeading = route.startsWith("/") ? route : `/${route}`;
+  return withLeading === "/" ? "/" : withLeading.replace(/\/+$/, "");
+}
+function deriveRoute(block, routePrefix) {
+  if (block.route)
+    return normalizeRoute(block.route);
+  const prefix = routePrefix ?? "/docs";
+  const slug = block.id.replace(/^docs\.?/, "").replace(/\./g, "/").replace(/\/+/g, "/");
+  const path = slug.startsWith("/") ? slug : `${prefix}/${slug}`;
+  return normalizeRoute(path);
+}
+function buildName(block, namespace) {
+  return namespace ? `${namespace}.${block.id}` : block.id;
+}
+function docBlockToPresentationSpec(block, options) {
+  const targets = options?.defaultTargets ?? DEFAULT_TARGETS;
+  const version = block.version ?? options?.defaultVersion ?? "1.0.0";
+  const stability = block.stability ?? options?.defaultStability ?? "stable";
+  return {
+    meta: {
+      key: buildName(block, options?.namespace),
+      title: block.title,
+      version,
+      description: block.summary ?? block.title,
+      tags: block.tags || [],
+      owners: block.owners || [],
+      domain: block.domain || "",
+      stability,
+      goal: `Documentation of: ${block.summary}`,
+      context: `Auto-generated`
+    },
+    policy: block.visibility && block.visibility !== "public" ? { flags: [block.visibility] } : undefined,
+    source: {
+      type: "blocknotejs",
+      docJson: block.body
+    },
+    targets
+  };
+}
+function docBlocksToPresentationRoutes(blocks, options) {
+  return blocks.map((block) => ({
+    block,
+    route: deriveRoute(block, options?.routePrefix),
+    descriptor: docBlockToPresentationSpec(block, options)
+  }));
+}
+function docBlocksToPresentationSpecs(blocks, options) {
+  return blocks.map((block) => docBlockToPresentationSpec(block, options));
+}
+function mapDocRoutes(routes) {
+  return routes.map(({ route, descriptor }) => [route, descriptor]);
+}
+
+// src/docs/registry.ts
+class DocRegistry {
+  routes = new Map;
+  constructor(blocks = [], options) {
+    blocks.forEach((block) => this.register(block, options));
+  }
+  register(block, options) {
+    const [route] = docBlocksToPresentationRoutes([block], options);
+    if (route) {
+      this.routes.set(block.id, route);
+    }
+    return this;
+  }
+  list() {
+    return [...this.routes.values()];
+  }
+  get(id) {
+    return this.routes.get(id);
+  }
+  toRouteTuples() {
+    return this.list().map(({ route, descriptor }) => [route, descriptor]);
+  }
+  toPresentationSpecs(options) {
+    return this.list().map(({ block }) => docBlockToPresentationSpec(block, options));
+  }
+}
+var requiredFields = [
+  "id",
+  "title",
+  "body",
+  "kind",
+  "visibility",
+  "route"
+];
+var defaultDocRegistry = new DocRegistry;
+function registerDocBlocks(blocks) {
+  for (const block of blocks) {
+    for (const field of requiredFields) {
+      if (!block[field]) {
+        throw new Error(`DocBlock ${block.id ?? "<missing id>"} missing field ${String(field)}`);
+      }
+    }
+    defaultDocRegistry.register(block);
+  }
+}
+function listRegisteredDocBlocks() {
+  return defaultDocRegistry.list().map((r) => r.block);
+}
+function docId(id) {
+  const found = defaultDocRegistry.get(id);
+  if (!found)
+    throw new Error(`DocBlock not registered: ${id}`);
+  return id;
+}
+
+// src/integrations/docs/integrations.docblock.ts
+var tech_contracts_integrations_DocBlocks = [
+  {
+    id: "docs.tech.contracts.integrations",
+    title: "ContractSpec Integrations",
+    summary: "Provider-agnostic integration contracts: specs, connections, secrets, health checks, and runtime guards.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/tech/contracts/integrations",
+    tags: ["tech", "contracts", "integrations"],
+    body: `# ContractSpec Integrations
 
 This document describes the integration architecture that powers ContractSpec-based apps. It focuses on provider-agnostic contracts, secret management, health checks, and runtime guards.
 
 ## Core Concepts
 
-- **IntegrationSpec** – declarative description of a provider that lists supported ownership modes, capability mappings, configuration schema, secret schema, health check policy, and documentation metadata.
-- **IntegrationConnection** – tenant/environment binding to a provider (\`meta\` + ownership mode + config + \`secretRef\`). Secrets are never embedded in specs or configs.
-- **AppIntegrationSlot** – blueprint-level requirement that declares which integration categories/capabilities must be satisfied at runtime (e.g. \`primaryLLM\`, \`primaryVectorDb\`).
-- **AppIntegrationBinding** – tenant-level slot → connection mapping.
-- **ResolvedIntegration** – runtime view containing slot metadata, connection details, and the resolved IntegrationSpec.
+- **IntegrationSpec** \u2013 declarative description of a provider that lists supported ownership modes, capability mappings, configuration schema, secret schema, health check policy, and documentation metadata.
+- **IntegrationConnection** \u2013 tenant/environment binding to a provider (\`meta\` + ownership mode + config + \`secretRef\`). Secrets are never embedded in specs or configs.
+- **AppIntegrationSlot** \u2013 blueprint-level requirement that declares which integration categories/capabilities must be satisfied at runtime (e.g. \`primaryLLM\`, \`primaryVectorDb\`).
+- **AppIntegrationBinding** \u2013 tenant-level slot \u2192 connection mapping.
+- **ResolvedIntegration** \u2013 runtime view containing slot metadata, connection details, and the resolved IntegrationSpec.
 
 ## Registered Providers
 
@@ -49,7 +191,7 @@ The contracts library ships twenty-two priority providers in \`packages/libs/con
 | project-management | Linear       | \`project-management.linear\` | Issues, project tracking, and team tasks          |
 | project-management | Jira Cloud   | \`project-management.jira\`   | Work item sync for Jira Cloud                     |
 | project-management | Notion       | \`project-management.notion\` | Shared summaries and task databases               |
-| meeting-recorder | Granola       | \`meeting-recorder.granola\`  | Enterprise meeting notes + transcripts            |
+| meeting-recorder | Granola       | \`meeting-recorder.granola\`  | Meeting notes + transcripts via API or MCP        |
 | meeting-recorder | tl;dv         | \`meeting-recorder.tldv\`     | Meeting recordings, transcripts, and webhooks     |
 | meeting-recorder | Fireflies     | \`meeting-recorder.fireflies\` | GraphQL transcripts + webhook events              |
 | meeting-recorder | Fathom        | \`meeting-recorder.fathom\`   | External API meetings + webhook registration      |
@@ -76,15 +218,15 @@ To list all shipped specs at runtime, use:
 
 All integrations rely on the \`SecretProvider\` abstraction defined in \`integrations/secrets\`. Providers ship with the contracts library and are orchestrated by the \`SecretProviderManager\` composite:
 
-- **EnvSecretProvider** (\`env-secret-provider.ts\`) – high-priority, read-only overrides backed by environment variables.
+- **EnvSecretProvider** (\`env-secret-provider.ts\`) \u2013 high-priority, read-only overrides backed by environment variables.
   - Supports the \`env://VARIABLE_NAME\` scheme
   - Supports overrides for other schemes via \`?env=ALIAS\` or derived uppercase keys
-- **GcpSecretManagerProvider** (\`gcp-secret-manager.ts\`) – versioned secrets stored in Google Cloud Secret Manager.
+- **GcpSecretManagerProvider** (\`gcp-secret-manager.ts\`) \u2013 versioned secrets stored in Google Cloud Secret Manager.
   - Example: \`gcp://projects/demo/secrets/stripe-key/versions/latest\`
-- **AwsSecretsManagerProvider** (\`aws-secret-manager.ts\`) – AWS Secrets Manager backend.
+- **AwsSecretsManagerProvider** (\`aws-secret-manager.ts\`) \u2013 AWS Secrets Manager backend.
   - Example: \`aws://secretsmanager/eu-west-1/my-secret?version=AWSCURRENT\`
   - Region may be in the reference or provided via \`AWS_REGION\` / \`AWS_DEFAULT_REGION\`
-- **ScalewaySecretManagerProvider** (\`scaleway-secret-manager.ts\`) – Scaleway Secret Manager backend.
+- **ScalewaySecretManagerProvider** (\`scaleway-secret-manager.ts\`) \u2013 Scaleway Secret Manager backend.
   - Example (id): \`scw://secret-manager/fr-par/1234...-uuid?version=latest\`
   - Example (name, create+write): \`scw://secret-manager/fr-par/my-secret-name\`
   - Requires \`SCW_SECRET_KEY\` (token) and \`SCW_DEFAULT_PROJECT_ID\` when creating secrets by name
@@ -105,8 +247,9 @@ The manager attempts providers in priority order (environment first, then cloud
 
 ContractSpec Studio persists tenant \`IntegrationConnection\` records in Postgres (Prisma model \`IntegrationConnection\` in \`@contractspec/lib.database-studio\`) and exposes a platform-admin management surface (see the Studio platform admin panel).
 `
-}];
+  }
+];
 registerDocBlocks(tech_contracts_integrations_DocBlocks);
-
-//#endregion
-export { tech_contracts_integrations_DocBlocks };
+export {
+  tech_contracts_integrations_DocBlocks
+};