@contractspec/example.integration-hub 3.8.8 → 3.8.10

package/dist/node/connection/connection.presentation.js

@@ -1,125 +1 @@
-// src/connection/connection.enum.ts
-import { defineEnum } from "@contractspec/lib.schema";
-var ConnectionStatusEnum = defineEnum("ConnectionStatus", [
-  "PENDING",
-  "CONNECTED",
-  "DISCONNECTED",
-  "ERROR",
-  "EXPIRED"
-]);
-var AuthTypeEnum = defineEnum("AuthType", [
-  "api_key",
-  "oauth2",
-  "bearer",
-  "header",
-  "basic",
-  "webhook_signing",
-  "service_account"
-]);
-var TransportTypeEnum = defineEnum("TransportType", [
-  "rest",
-  "mcp",
-  "webhook",
-  "sdk"
-]);
-
-// src/connection/connection.schema.ts
-import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-var ConnectionModel = defineSchemaModel({
-  name: "ConnectionModel",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    integrationId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false
-    },
-    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    status: { type: ConnectionStatusEnum, isOptional: false },
-    authType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    externalAccountName: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: true
-    },
-    connectedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    lastHealthCheck: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    transport: { type: TransportTypeEnum, isOptional: true },
-    authMethod: { type: AuthTypeEnum, isOptional: true },
-    apiVersion: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
-  }
-});
-var CreateConnectionInputModel = defineSchemaModel({
-  name: "CreateConnectionInput",
-  fields: {
-    integrationId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false
-    },
-    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    authType: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true },
-    transport: { type: TransportTypeEnum, isOptional: true },
-    authMethod: { type: AuthTypeEnum, isOptional: true },
-    apiVersion: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
-  }
-});
-
-// src/connection/connection.presentation.ts
-import {
-  definePresentation,
-  StabilityEnum
-} from "@contractspec/lib.contracts-spec";
-var ConnectionListPresentation = definePresentation({
-  meta: {
-    key: "integration.connection.list",
-    version: "1.0.0",
-    title: "Connection List",
-    description: "List of integration connections",
-    domain: "integration",
-    owners: ["@integration-team"],
-    tags: ["integration", "connection", "list"],
-    stability: StabilityEnum.Experimental,
-    goal: "Provide an overview of all established integration connections.",
-    context: "The primary management view for integration hubs."
-  },
-  source: {
-    type: "component",
-    framework: "react",
-    componentKey: "ConnectionList",
-    props: ConnectionModel
-  },
-  targets: ["react", "markdown"],
-  policy: {
-    flags: ["integration.enabled"]
-  }
-});
-var ConnectionSetupPresentation = definePresentation({
-  meta: {
-    key: "integration.connection.setup",
-    version: "1.0.0",
-    title: "Connection Setup",
-    description: "Setup wizard for creating integration connections",
-    domain: "integration",
-    owners: ["@integration-team"],
-    tags: ["integration", "connection", "setup"],
-    stability: StabilityEnum.Experimental,
-    goal: "Guide users through the multi-step process of connecting to a new integration.",
-    context: "The onboarding flow for new integrations."
-  },
-  source: {
-    type: "component",
-    framework: "react",
-    componentKey: "ConnectionSetup",
-    props: ConnectionModel
-  },
-  targets: ["react"],
-  policy: {
-    flags: ["integration.enabled"]
-  }
-});
-export {
-  ConnectionSetupPresentation,
-  ConnectionListPresentation
-};
+import{defineEnum as k}from"@contractspec/lib.schema";var B=k("ConnectionStatus",["PENDING","CONNECTED","DISCONNECTED","ERROR","EXPIRED"]),q=k("AuthType",["api_key","oauth2","bearer","header","basic","webhook_signing","service_account"]),v=k("TransportType",["rest","mcp","webhook","sdk"]);import{defineSchemaModel as D,ScalarTypeEnum as j}from"@contractspec/lib.schema";var z=D({name:"ConnectionModel",fields:{id:{type:j.String_unsecure(),isOptional:!1},integrationId:{type:j.String_unsecure(),isOptional:!1},name:{type:j.String_unsecure(),isOptional:!1},status:{type:B,isOptional:!1},authType:{type:j.String_unsecure(),isOptional:!1},externalAccountName:{type:j.String_unsecure(),isOptional:!0},connectedAt:{type:j.DateTime(),isOptional:!0},lastHealthCheck:{type:j.DateTime(),isOptional:!0},healthStatus:{type:j.String_unsecure(),isOptional:!0},transport:{type:v,isOptional:!0},authMethod:{type:q,isOptional:!0},apiVersion:{type:j.String_unsecure(),isOptional:!0},ownershipMode:{type:j.String_unsecure(),isOptional:!0}}}),N=D({name:"CreateConnectionInput",fields:{integrationId:{type:j.String_unsecure(),isOptional:!1},name:{type:j.NonEmptyString(),isOptional:!1},authType:{type:j.NonEmptyString(),isOptional:!1},credentials:{type:j.JSON(),isOptional:!0},transport:{type:v,isOptional:!0},authMethod:{type:q,isOptional:!0},apiVersion:{type:j.String_unsecure(),isOptional:!0},ownershipMode:{type:j.String_unsecure(),isOptional:!0}}});import{definePresentation as F,StabilityEnum as G}from"@contractspec/lib.contracts-spec";var U=F({meta:{key:"integration.connection.list",version:"1.0.0",title:"Connection List",description:"List of integration connections",domain:"integration",owners:["@integration-team"],tags:["integration","connection","list"],stability:G.Experimental,goal:"Provide an overview of all established integration connections.",context:"The primary management view for integration hubs."},source:{type:"component",framework:"react",componentKey:"ConnectionList",props:z},targets:["react","markdown"],policy:{flags:["integration.enabled"]}}),V=F({meta:{key:"integration.connection.setup",version:"1.0.0",title:"Connection Setup",description:"Setup wizard for creating integration connections",domain:"integration",owners:["@integration-team"],tags:["integration","connection","setup"],stability:G.Experimental,goal:"Guide users through the multi-step process of connecting to a new integration.",context:"The onboarding flow for new integrations."},source:{type:"component",framework:"react",componentKey:"ConnectionSetup",props:z},targets:["react"],policy:{flags:["integration.enabled"]}});export{V as ConnectionSetupPresentation,U as ConnectionListPresentation};

package/dist/node/connection/connection.schema.js

@@ -1,71 +1 @@
-// src/connection/connection.enum.ts
-import { defineEnum } from "@contractspec/lib.schema";
-var ConnectionStatusEnum = defineEnum("ConnectionStatus", [
-  "PENDING",
-  "CONNECTED",
-  "DISCONNECTED",
-  "ERROR",
-  "EXPIRED"
-]);
-var AuthTypeEnum = defineEnum("AuthType", [
-  "api_key",
-  "oauth2",
-  "bearer",
-  "header",
-  "basic",
-  "webhook_signing",
-  "service_account"
-]);
-var TransportTypeEnum = defineEnum("TransportType", [
-  "rest",
-  "mcp",
-  "webhook",
-  "sdk"
-]);
-
-// src/connection/connection.schema.ts
-import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-var ConnectionModel = defineSchemaModel({
-  name: "ConnectionModel",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    integrationId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false
-    },
-    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    status: { type: ConnectionStatusEnum, isOptional: false },
-    authType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    externalAccountName: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: true
-    },
-    connectedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    lastHealthCheck: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    transport: { type: TransportTypeEnum, isOptional: true },
-    authMethod: { type: AuthTypeEnum, isOptional: true },
-    apiVersion: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
-  }
-});
-var CreateConnectionInputModel = defineSchemaModel({
-  name: "CreateConnectionInput",
-  fields: {
-    integrationId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false
-    },
-    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    authType: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true },
-    transport: { type: TransportTypeEnum, isOptional: true },
-    authMethod: { type: AuthTypeEnum, isOptional: true },
-    apiVersion: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
-  }
-});
-export {
-  CreateConnectionInputModel,
-  ConnectionModel
-};
+import{defineEnum as k}from"@contractspec/lib.schema";var z=k("ConnectionStatus",["PENDING","CONNECTED","DISCONNECTED","ERROR","EXPIRED"]),q=k("AuthType",["api_key","oauth2","bearer","header","basic","webhook_signing","service_account"]),v=k("TransportType",["rest","mcp","webhook","sdk"]);import{defineSchemaModel as B,ScalarTypeEnum as j}from"@contractspec/lib.schema";var J=B({name:"ConnectionModel",fields:{id:{type:j.String_unsecure(),isOptional:!1},integrationId:{type:j.String_unsecure(),isOptional:!1},name:{type:j.String_unsecure(),isOptional:!1},status:{type:z,isOptional:!1},authType:{type:j.String_unsecure(),isOptional:!1},externalAccountName:{type:j.String_unsecure(),isOptional:!0},connectedAt:{type:j.DateTime(),isOptional:!0},lastHealthCheck:{type:j.DateTime(),isOptional:!0},healthStatus:{type:j.String_unsecure(),isOptional:!0},transport:{type:v,isOptional:!0},authMethod:{type:q,isOptional:!0},apiVersion:{type:j.String_unsecure(),isOptional:!0},ownershipMode:{type:j.String_unsecure(),isOptional:!0}}}),K=B({name:"CreateConnectionInput",fields:{integrationId:{type:j.String_unsecure(),isOptional:!1},name:{type:j.NonEmptyString(),isOptional:!1},authType:{type:j.NonEmptyString(),isOptional:!1},credentials:{type:j.JSON(),isOptional:!0},transport:{type:v,isOptional:!0},authMethod:{type:q,isOptional:!0},apiVersion:{type:j.String_unsecure(),isOptional:!0},ownershipMode:{type:j.String_unsecure(),isOptional:!0}}});export{K as CreateConnectionInputModel,J as ConnectionModel};

package/dist/node/connection/index.js

@@ -1,127 +1 @@
-// src/connection/connection.enum.ts
-import { defineEnum } from "@contractspec/lib.schema";
-var ConnectionStatusEnum = defineEnum("ConnectionStatus", [
-  "PENDING",
-  "CONNECTED",
-  "DISCONNECTED",
-  "ERROR",
-  "EXPIRED"
-]);
-var AuthTypeEnum = defineEnum("AuthType", [
-  "api_key",
-  "oauth2",
-  "bearer",
-  "header",
-  "basic",
-  "webhook_signing",
-  "service_account"
-]);
-var TransportTypeEnum = defineEnum("TransportType", [
-  "rest",
-  "mcp",
-  "webhook",
-  "sdk"
-]);
-
-// src/connection/connection.schema.ts
-import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-var ConnectionModel = defineSchemaModel({
-  name: "ConnectionModel",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    integrationId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false
-    },
-    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    status: { type: ConnectionStatusEnum, isOptional: false },
-    authType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    externalAccountName: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: true
-    },
-    connectedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    lastHealthCheck: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    transport: { type: TransportTypeEnum, isOptional: true },
-    authMethod: { type: AuthTypeEnum, isOptional: true },
-    apiVersion: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
-  }
-});
-var CreateConnectionInputModel = defineSchemaModel({
-  name: "CreateConnectionInput",
-  fields: {
-    integrationId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false
-    },
-    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    authType: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true },
-    transport: { type: TransportTypeEnum, isOptional: true },
-    authMethod: { type: AuthTypeEnum, isOptional: true },
-    apiVersion: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
-  }
-});
-
-// src/connection/connection.operation.ts
-import { defineCommand } from "@contractspec/lib.contracts-spec/operations";
-var OWNERS = ["@example.integration-hub"];
-var CreateConnectionContract = defineCommand({
-  meta: {
-    key: "integration.connection.create",
-    version: "1.0.0",
-    stability: "stable",
-    owners: [...OWNERS],
-    tags: ["integration", "connection", "create"],
-    description: "Create a connection to an external system.",
-    goal: "Authenticate with external systems.",
-    context: "Connection setup."
-  },
-  io: { input: CreateConnectionInputModel, output: ConnectionModel },
-  policy: { auth: "user" },
-  sideEffects: {
-    emits: [
-      {
-        key: "integration.connection.created",
-        version: "1.0.0",
-        when: "Connection created",
-        payload: ConnectionModel
-      }
-    ],
-    audit: ["integration.connection.created"]
-  },
-  acceptance: {
-    scenarios: [
-      {
-        key: "create-connection-happy-path",
-        given: ["User is authenticated"],
-        when: ["User creates connection with valid credentials"],
-        then: ["Connection is created", "ConnectionCreated event is emitted"]
-      }
-    ],
-    examples: [
-      {
-        key: "connect-crm",
-        input: {
-          name: "Salesforce Prod",
-          integrationId: "salesforce",
-          credentials: { clientId: "xxx" }
-        },
-        output: {
-          id: "conn-123",
-          status: "connected",
-          connectedAt: "2025-01-01T12:00:00Z"
-        }
-      }
-    ]
-  }
-});
-export {
-  CreateConnectionInputModel,
-  CreateConnectionContract,
-  ConnectionStatusEnum,
-  ConnectionModel
-};
+import{defineEnum as j}from"@contractspec/lib.schema";var k=j("ConnectionStatus",["PENDING","CONNECTED","DISCONNECTED","ERROR","EXPIRED"]),q=j("AuthType",["api_key","oauth2","bearer","header","basic","webhook_signing","service_account"]),v=j("TransportType",["rest","mcp","webhook","sdk"]);import{defineSchemaModel as B,ScalarTypeEnum as C}from"@contractspec/lib.schema";var x=B({name:"ConnectionModel",fields:{id:{type:C.String_unsecure(),isOptional:!1},integrationId:{type:C.String_unsecure(),isOptional:!1},name:{type:C.String_unsecure(),isOptional:!1},status:{type:k,isOptional:!1},authType:{type:C.String_unsecure(),isOptional:!1},externalAccountName:{type:C.String_unsecure(),isOptional:!0},connectedAt:{type:C.DateTime(),isOptional:!0},lastHealthCheck:{type:C.DateTime(),isOptional:!0},healthStatus:{type:C.String_unsecure(),isOptional:!0},transport:{type:v,isOptional:!0},authMethod:{type:q,isOptional:!0},apiVersion:{type:C.String_unsecure(),isOptional:!0},ownershipMode:{type:C.String_unsecure(),isOptional:!0}}}),z=B({name:"CreateConnectionInput",fields:{integrationId:{type:C.String_unsecure(),isOptional:!1},name:{type:C.NonEmptyString(),isOptional:!1},authType:{type:C.NonEmptyString(),isOptional:!1},credentials:{type:C.JSON(),isOptional:!0},transport:{type:v,isOptional:!0},authMethod:{type:q,isOptional:!0},apiVersion:{type:C.String_unsecure(),isOptional:!0},ownershipMode:{type:C.String_unsecure(),isOptional:!0}}});import{defineCommand as D}from"@contractspec/lib.contracts-spec/operations";var F=["@example.integration-hub"],G=D({meta:{key:"integration.connection.create",version:"1.0.0",stability:"stable",owners:[...F],tags:["integration","connection","create"],description:"Create a connection to an external system.",goal:"Authenticate with external systems.",context:"Connection setup."},io:{input:z,output:x},policy:{auth:"user"},sideEffects:{emits:[{key:"integration.connection.created",version:"1.0.0",when:"Connection created",payload:x}],audit:["integration.connection.created"]},acceptance:{scenarios:[{key:"create-connection-happy-path",given:["User is authenticated"],when:["User creates connection with valid credentials"],then:["Connection is created","ConnectionCreated event is emitted"]}],examples:[{key:"connect-crm",input:{name:"Salesforce Prod",integrationId:"salesforce",credentials:{clientId:"xxx"}},output:{id:"conn-123",status:"connected",connectedAt:"2025-01-01T12:00:00Z"}}]}});export{z as CreateConnectionInputModel,G as CreateConnectionContract,k as ConnectionStatusEnum,x as ConnectionModel};

package/dist/node/docs/index.js

@@ -1,15 +1,4 @@
-// src/docs/integration-hub.docblock.ts
-import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
-var integrationHubDocBlocks = [
-  {
-    id: "docs.examples.integration-hub",
-    title: "Integration Hub",
-    summary: "Generic integration center with connectors, connections, sync configs, field mappings, and sync logs.",
-    kind: "reference",
-    visibility: "public",
-    route: "/docs/examples/integration-hub",
-    tags: ["integrations", "sync", "etl", "connectors"],
-    body: `## Entities
+import{registerDocBlocks as m}from"@contractspec/lib.contracts-spec/docs";var f=[{id:"docs.examples.integration-hub",title:"Integration Hub",summary:"Generic integration center with connectors, connections, sync configs, field mappings, and sync logs.",kind:"reference",visibility:"public",route:"/docs/examples/integration-hub",tags:["integrations","sync","etl","connectors"],body:`## Entities
 
 - Integration, Connection, SyncConfig, FieldMapping, SyncLog.
 - Sync engine config lives in \`src/sync-engine\` to map remote <-> local entities.
@@ -35,17 +24,7 @@ var integrationHubDocBlocks = [
 - Seed data includes voice integrations for \`ai-voice.gradium\` and \`ai-voice.fal\`.
 - Feature flags can gate specific providers; metering can track sync volume.
 - The dashboard tables demonstrate client-mode sorting, pagination, visibility, pinning, resizing, and row expansion on the shared table stack.
-`
-  },
-  {
-    id: "docs.examples.integration-hub.goal",
-    title: "Integration Hub — Goal",
-    summary: "Why this integration hub exists and what success looks like.",
-    kind: "goal",
-    visibility: "public",
-    route: "/docs/examples/integration-hub/goal",
-    tags: ["integrations", "goal"],
-    body: `## Why it matters
+`},{id:"docs.examples.integration-hub.goal",title:"Integration Hub — Goal",summary:"Why this integration hub exists and what success looks like.",kind:"goal",visibility:"public",route:"/docs/examples/integration-hub/goal",tags:["integrations","goal"],body:`## Why it matters
 - Gives a regenerable, provider-agnostic integration hub with explicit mappings.
 - Prevents drift between sync configs, mappings, and event/log outputs.
 
@@ -55,17 +34,7 @@ var integrationHubDocBlocks = [
 
 ## Success criteria
 - Connections and mappings regenerate safely after spec edits.
-- Sync events and logs provide auditability; payloads are stored and PII-scoped.`
-  },
-  {
-    id: "docs.examples.integration-hub.usage",
-    title: "Integration Hub — Usage",
-    summary: "How to configure connectors, mappings, and scheduled syncs.",
-    kind: "usage",
-    visibility: "public",
-    route: "/docs/examples/integration-hub/usage",
-    tags: ["integrations", "usage"],
-    body: `## Setup
+- Sync events and logs provide auditability; payloads are stored and PII-scoped.`},{id:"docs.examples.integration-hub.usage",title:"Integration Hub — Usage",summary:"How to configure connectors, mappings, and scheduled syncs.",kind:"usage",visibility:"public",route:"/docs/examples/integration-hub/usage",tags:["integrations","usage"],body:`## Setup
 1) Seed integrations/connections (if available) or create connector definitions.
 2) Configure sync jobs with Jobs module; store payload archives via Files.
 3) Use \`src/run-mcp.ts\` to validate MCP connectivity for provider adapters.
@@ -78,17 +47,7 @@ var integrationHubDocBlocks = [
 ## Guardrails
 - Keep mappings declarative; avoid hardcoded transforms.
 - Emit events for sync lifecycle; persist logs for audit.
-- Redact sensitive payload paths in presentations.`
-  },
-  {
-    id: "docs.examples.integration-hub.constraints",
-    title: "Integration Hub — Constraints & Safety",
-    summary: "Internal guidance for sync lifecycle, mappings, and regeneration safety.",
-    kind: "reference",
-    visibility: "internal",
-    route: "/docs/examples/integration-hub/constraints",
-    tags: ["integrations", "constraints", "internal"],
-    body: `## Constraints
+- Redact sensitive payload paths in presentations.`},{id:"docs.examples.integration-hub.constraints",title:"Integration Hub — Constraints & Safety",summary:"Internal guidance for sync lifecycle, mappings, and regeneration safety.",kind:"reference",visibility:"internal",route:"/docs/examples/integration-hub/constraints",tags:["integrations","constraints","internal"],body:`## Constraints
 - Mappings and sync states must remain declarative in spec; no hidden code transforms.
 - Events to emit at minimum: sync.started, sync.completed, sync.failed; connection.connected/disconnected.
 - Regeneration should not alter retry/backoff semantics without explicit spec change.
@@ -101,7 +60,4 @@ var integrationHubDocBlocks = [
 ## Verification
 - Include fixtures for mapping changes and sync retries.
 - Validate that scheduled jobs (cron) are spec-driven; Jobs module wiring intact.
-- Ensure Audit/Notifications receive sync lifecycle events.`
-  }
-];
-registerDocBlocks(integrationHubDocBlocks);
+- Ensure Audit/Notifications receive sync lifecycle events.`}];m(f);

package/dist/node/docs/integration-hub.docblock.js

@@ -1,15 +1,4 @@
-// src/docs/integration-hub.docblock.ts
-import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
-var integrationHubDocBlocks = [
-  {
-    id: "docs.examples.integration-hub",
-    title: "Integration Hub",
-    summary: "Generic integration center with connectors, connections, sync configs, field mappings, and sync logs.",
-    kind: "reference",
-    visibility: "public",
-    route: "/docs/examples/integration-hub",
-    tags: ["integrations", "sync", "etl", "connectors"],
-    body: `## Entities
+import{registerDocBlocks as f}from"@contractspec/lib.contracts-spec/docs";var h=[{id:"docs.examples.integration-hub",title:"Integration Hub",summary:"Generic integration center with connectors, connections, sync configs, field mappings, and sync logs.",kind:"reference",visibility:"public",route:"/docs/examples/integration-hub",tags:["integrations","sync","etl","connectors"],body:`## Entities
 
 - Integration, Connection, SyncConfig, FieldMapping, SyncLog.
 - Sync engine config lives in \`src/sync-engine\` to map remote <-> local entities.
@@ -35,17 +24,7 @@ var integrationHubDocBlocks = [
 - Seed data includes voice integrations for \`ai-voice.gradium\` and \`ai-voice.fal\`.
 - Feature flags can gate specific providers; metering can track sync volume.
 - The dashboard tables demonstrate client-mode sorting, pagination, visibility, pinning, resizing, and row expansion on the shared table stack.
-`
-  },
-  {
-    id: "docs.examples.integration-hub.goal",
-    title: "Integration Hub — Goal",
-    summary: "Why this integration hub exists and what success looks like.",
-    kind: "goal",
-    visibility: "public",
-    route: "/docs/examples/integration-hub/goal",
-    tags: ["integrations", "goal"],
-    body: `## Why it matters
+`},{id:"docs.examples.integration-hub.goal",title:"Integration Hub — Goal",summary:"Why this integration hub exists and what success looks like.",kind:"goal",visibility:"public",route:"/docs/examples/integration-hub/goal",tags:["integrations","goal"],body:`## Why it matters
 - Gives a regenerable, provider-agnostic integration hub with explicit mappings.
 - Prevents drift between sync configs, mappings, and event/log outputs.
 
@@ -55,17 +34,7 @@ var integrationHubDocBlocks = [
 
 ## Success criteria
 - Connections and mappings regenerate safely after spec edits.
-- Sync events and logs provide auditability; payloads are stored and PII-scoped.`
-  },
-  {
-    id: "docs.examples.integration-hub.usage",
-    title: "Integration Hub — Usage",
-    summary: "How to configure connectors, mappings, and scheduled syncs.",
-    kind: "usage",
-    visibility: "public",
-    route: "/docs/examples/integration-hub/usage",
-    tags: ["integrations", "usage"],
-    body: `## Setup
+- Sync events and logs provide auditability; payloads are stored and PII-scoped.`},{id:"docs.examples.integration-hub.usage",title:"Integration Hub — Usage",summary:"How to configure connectors, mappings, and scheduled syncs.",kind:"usage",visibility:"public",route:"/docs/examples/integration-hub/usage",tags:["integrations","usage"],body:`## Setup
 1) Seed integrations/connections (if available) or create connector definitions.
 2) Configure sync jobs with Jobs module; store payload archives via Files.
 3) Use \`src/run-mcp.ts\` to validate MCP connectivity for provider adapters.
@@ -78,17 +47,7 @@ var integrationHubDocBlocks = [
 ## Guardrails
 - Keep mappings declarative; avoid hardcoded transforms.
 - Emit events for sync lifecycle; persist logs for audit.
-- Redact sensitive payload paths in presentations.`
-  },
-  {
-    id: "docs.examples.integration-hub.constraints",
-    title: "Integration Hub — Constraints & Safety",
-    summary: "Internal guidance for sync lifecycle, mappings, and regeneration safety.",
-    kind: "reference",
-    visibility: "internal",
-    route: "/docs/examples/integration-hub/constraints",
-    tags: ["integrations", "constraints", "internal"],
-    body: `## Constraints
+- Redact sensitive payload paths in presentations.`},{id:"docs.examples.integration-hub.constraints",title:"Integration Hub — Constraints & Safety",summary:"Internal guidance for sync lifecycle, mappings, and regeneration safety.",kind:"reference",visibility:"internal",route:"/docs/examples/integration-hub/constraints",tags:["integrations","constraints","internal"],body:`## Constraints
 - Mappings and sync states must remain declarative in spec; no hidden code transforms.
 - Events to emit at minimum: sync.started, sync.completed, sync.failed; connection.connected/disconnected.
 - Regeneration should not alter retry/backoff semantics without explicit spec change.
@@ -101,7 +60,4 @@ var integrationHubDocBlocks = [
 ## Verification
 - Include fixtures for mapping changes and sync retries.
 - Validate that scheduled jobs (cron) are spec-driven; Jobs module wiring intact.
-- Ensure Audit/Notifications receive sync lifecycle events.`
-  }
-];
-registerDocBlocks(integrationHubDocBlocks);
+- Ensure Audit/Notifications receive sync lifecycle events.`}];f(h);