@contractspec/example.integration-hub 1.44.0

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

@@ -0,0 +1,115 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/integration-hub.docblock.ts
+registerDocBlocks([
+	{
+		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.
+
+## Contracts
+
+- \`integration.create\`, \`integration.connect\`, \`integration.configureSync\`, \`integration.mapFields\`, \`integration.runSync\`.
+- Uses Jobs module for scheduled syncs and retries; Files module for payload archives.
+
+## Events
+
+- sync.started/completed/failed, connection.connected/disconnected, mapping.updated.
+- Forward to Notifications and Audit for observability.
+
+## UI / Presentations
+
+- Dashboard, integration list, connection detail, sync config editor.
+- Templates registered as \`integration-hub\` in Template Registry.
+
+## Notes
+
+- Providers remain agnostic; keep mappings declarative for safe regeneration.
+- Feature flags can gate specific providers; metering can track sync volume.
+`
+	},
+	{
+		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.
+
+## Business/Product goal
+- Model connectors, connections, sync jobs, and mappings with governance and retries.
+- Support staged provider rollouts via Feature Flags and observability via Audit/Notifications.
+
+## 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
+1) Seed integrations/connections (if available) or create connector definitions.
+2) Configure sync jobs with Jobs module; store payload archives via Files.
+
+## Extend & regenerate
+1) Add mapping fields or provider configs in the spec; include validation and PII paths.
+2) Regenerate to align UI/API/events/logs; verify Notifications/Audit hooks.
+3) Gate risky providers behind Feature Flags; meter sync volume if needed.
+
+## 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
+- 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.
+
+## PII & Payloads
+- Treat payload archives as potentially sensitive; mark policy.pii paths.
+- For MCP/web, avoid exposing raw credentials/tokens; store via provider adapters only.
+
+## 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.`
+	}
+]);
+
+//#endregion
+//# sourceMappingURL=integration-hub.docblock.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"integration-hub.docblock.js","names":[],"sources":["../../src/docs/integration-hub.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst integrationHubDocBlocks: DocBlock[] = [\n  {\n    id: 'docs.examples.integration-hub',\n    title: 'Integration Hub',\n    summary:\n      'Generic integration center with connectors, connections, sync configs, field mappings, and sync logs.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/integration-hub',\n    tags: ['integrations', 'sync', 'etl', 'connectors'],\n    body: `## Entities\n\n- Integration, Connection, SyncConfig, FieldMapping, SyncLog.\n- Sync engine config lives in \\`src/sync-engine\\` to map remote <-> local entities.\n\n## Contracts\n\n- \\`integration.create\\`, \\`integration.connect\\`, \\`integration.configureSync\\`, \\`integration.mapFields\\`, \\`integration.runSync\\`.\n- Uses Jobs module for scheduled syncs and retries; Files module for payload archives.\n\n## Events\n\n- sync.started/completed/failed, connection.connected/disconnected, mapping.updated.\n- Forward to Notifications and Audit for observability.\n\n## UI / Presentations\n\n- Dashboard, integration list, connection detail, sync config editor.\n- Templates registered as \\`integration-hub\\` in Template Registry.\n\n## Notes\n\n- Providers remain agnostic; keep mappings declarative for safe regeneration.\n- Feature flags can gate specific providers; metering can track sync volume.\n`,\n  },\n  {\n    id: 'docs.examples.integration-hub.goal',\n    title: 'Integration Hub — Goal',\n    summary: 'Why this integration hub exists and what success looks like.',\n    kind: 'goal',\n    visibility: 'public',\n    route: '/docs/examples/integration-hub/goal',\n    tags: ['integrations', 'goal'],\n    body: `## Why it matters\n- Gives a regenerable, provider-agnostic integration hub with explicit mappings.\n- Prevents drift between sync configs, mappings, and event/log outputs.\n\n## Business/Product goal\n- Model connectors, connections, sync jobs, and mappings with governance and retries.\n- Support staged provider rollouts via Feature Flags and observability via Audit/Notifications.\n\n## Success criteria\n- Connections and mappings regenerate safely after spec edits.\n- Sync events and logs provide auditability; payloads are stored and PII-scoped.`,\n  },\n  {\n    id: 'docs.examples.integration-hub.usage',\n    title: 'Integration Hub — Usage',\n    summary: 'How to configure connectors, mappings, and scheduled syncs.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/integration-hub/usage',\n    tags: ['integrations', 'usage'],\n    body: `## Setup\n1) Seed integrations/connections (if available) or create connector definitions.\n2) Configure sync jobs with Jobs module; store payload archives via Files.\n\n## Extend & regenerate\n1) Add mapping fields or provider configs in the spec; include validation and PII paths.\n2) Regenerate to align UI/API/events/logs; verify Notifications/Audit hooks.\n3) Gate risky providers behind Feature Flags; meter sync volume if needed.\n\n## Guardrails\n- Keep mappings declarative; avoid hardcoded transforms.\n- Emit events for sync lifecycle; persist logs for audit.\n- Redact sensitive payload paths in presentations.`,\n  },\n  {\n    id: 'docs.examples.integration-hub.constraints',\n    title: 'Integration Hub — Constraints & Safety',\n    summary:\n      'Internal guidance for sync lifecycle, mappings, and regeneration safety.',\n    kind: 'reference',\n    visibility: 'internal',\n    route: '/docs/examples/integration-hub/constraints',\n    tags: ['integrations', 'constraints', 'internal'],\n    body: `## Constraints\n- Mappings and sync states must remain declarative in spec; no hidden code transforms.\n- Events to emit at minimum: sync.started, sync.completed, sync.failed; connection.connected/disconnected.\n- Regeneration should not alter retry/backoff semantics without explicit spec change.\n\n## PII & Payloads\n- Treat payload archives as potentially sensitive; mark policy.pii paths.\n- For MCP/web, avoid exposing raw credentials/tokens; store via provider adapters only.\n\n## Verification\n- Include fixtures for mapping changes and sync retries.\n- Validate that scheduled jobs (cron) are spec-driven; Jobs module wiring intact.\n- Ensure Audit/Notifications receive sync lifecycle events.`,\n  },\n];\n\nregisterDocBlocks(integrationHubDocBlocks);\n"],"mappings":";;;AA0GA,kBAvG4C;CAC1C;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAgB;GAAQ;GAAO;GAAa;EACnD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;EAyBP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,gBAAgB,OAAO;EAC9B,MAAM;;;;;;;;;;;EAWP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,gBAAgB,QAAQ;EAC/B,MAAM;;;;;;;;;;;;;EAaP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAgB;GAAe;GAAW;EACjD,MAAM;;;;;;;;;;;;;EAaP;CACF,CAEyC"}

package/dist/events.d.ts

@@ -0,0 +1,153 @@
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
+import * as _contractspec_lib_schema0 from "@contractspec/lib.schema";
+
+//#region src/events.d.ts
+declare const IntegrationCreatedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+  integrationId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  type: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  createdAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+declare const ConnectionCreatedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+  connectionId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  integrationId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  createdAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+declare const ConnectionStatusChangedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+  connectionId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  previousStatus: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  newStatus: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  changedAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+declare const SyncConfigCreatedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+  syncConfigId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  connectionId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  createdAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+declare const SyncStartedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+  syncRunId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  syncConfigId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  startedAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+declare const SyncCompletedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+  syncRunId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  syncConfigId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  recordsProcessed: {
+    type: _contractspec_lib_schema0.FieldType<number, number>;
+    isOptional: false;
+  };
+  completedAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+declare const SyncFailedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+  syncRunId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  syncConfigId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  error: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  failedAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+declare const RecordSyncedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+  syncRunId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  recordId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  sourceId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  targetId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+}>>;
+declare const FieldMappingAddedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+  syncConfigId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  sourceField: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  targetField: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+}>>;
+//#endregion
+export { ConnectionCreatedEvent, ConnectionStatusChangedEvent, FieldMappingAddedEvent, IntegrationCreatedEvent, RecordSyncedEvent, SyncCompletedEvent, SyncConfigCreatedEvent, SyncFailedEvent, SyncStartedEvent };
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","names":[],"sources":["../src/events.ts"],"sourcesContent":[],"mappings":";;;;cAiBa,yBAAuB,4BAAA,CAAA,oCAAA;;UAUlC,yBAAA,CAAA;;EAVW,CAAA;EAUX,IAAA,EAAA;;;;;IAVkC,IAAA,qCAAA,KAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EA2BvB,CAAA;CAUX,CAAA,CAAA;cAVW,wBAAsB,4BAAA,CAAA,oCAAA;;UAUjC,yBAAA,CAAA;;;EAViC,aAAA,EAAA;IAAA,IAAA,qCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IA0BtB,UAAA,EAAA,KAAA;EAUX,CAAA;;;;;;IAVuC,IAAA,qCAAA,KAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAuB5B,CAAA;CAUX,CAAA,CAAA;cAjCW,8BAA4B,4BAAA,CAAA,oCAAA;;UAUvC,yBAAA,CAAA;;EAaiC,CAAA;EAAA,cAAA,EAAA;IAuBtB,IAAA,qCAUX,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;EAV2B,CAAA;EAAA,SAAA,EAAA;IA0BhB,IAAA,qCAUX,KAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;cA3DW,wBAAsB,4BAAA,CAAA,oCAAA;;UAUjC,yBAAA,CAAA,SAuC6B,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAAA,CAAA;EAuBlB,YAAA,EAAA;IAUX,IAAA,qCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;EAV0B,CAAA;CAAA,CAAA,CAAA;AAuBf,cAxEA,gBAkFX,EAlF2B,4BAAA,CAAA,SAkF3B,2BAlF2B,WAkF3B,CAAA;EAAA,SAAA,EAAA;UAxEA,yBAAA,CAAA;;;;IA8D4B,IAAA,qCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAsBjB,CAAA;EAUX,SAAA,EAAA;;;;CAViC,CAAA,CAAA;AAAA,cApEtB,kBAoEsB,EApEJ,4BAAA,CAAA,SAoEI,2BApEJ,WAoEI,CAAA;;UA1DjC,yBAAA,CAAA;;;;;;;;;;;;;;;;cAaW,iBAAe,4BAAA,CAAA,oCAAA;;UAU1B,yBAAA,CAAA;;;;;;;;;;;;;;;;cAaW,mBAAiB,4BAAA,CAAA,oCAAA;;UAU5B,yBAAA,CAAA;;;;;;;;;;;;;;;;cAYW,wBAAsB,4BAAA,CAAA,oCAAA;;UAUjC,yBAAA,CAAA"}

package/dist/events.js

@@ -0,0 +1,289 @@
+import { defineEvent } from "@contractspec/lib.contracts";
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+
+//#region src/events.ts
+const IntegrationCreatedPayload = defineSchemaModel({
+	name: "IntegrationCreatedPayload",
+	description: "Payload when an integration is created",
+	fields: {
+		integrationId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		type: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const IntegrationCreatedEvent = defineEvent({
+	meta: {
+		key: "integration.created",
+		version: 1,
+		description: "Fired when a new integration is created",
+		stability: "experimental",
+		owners: ["@integration-team"],
+		tags: ["integration"]
+	},
+	payload: IntegrationCreatedPayload
+});
+const ConnectionCreatedPayload = defineSchemaModel({
+	name: "ConnectionCreatedPayload",
+	description: "Payload when a connection is established",
+	fields: {
+		connectionId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		integrationId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		status: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const ConnectionCreatedEvent = defineEvent({
+	meta: {
+		key: "integration.connection.created",
+		version: 1,
+		description: "Fired when a new connection is established",
+		stability: "experimental",
+		owners: ["@integration-team"],
+		tags: ["integration", "connection"]
+	},
+	payload: ConnectionCreatedPayload
+});
+const ConnectionStatusChangedPayload = defineSchemaModel({
+	name: "ConnectionStatusChangedPayload",
+	description: "Payload when a connection status changes",
+	fields: {
+		connectionId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		previousStatus: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		newStatus: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		changedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const ConnectionStatusChangedEvent = defineEvent({
+	meta: {
+		key: "integration.connection.statusChanged",
+		version: 1,
+		description: "Fired when a connection status changes",
+		stability: "experimental",
+		owners: ["@integration-team"],
+		tags: ["integration", "connection"]
+	},
+	payload: ConnectionStatusChangedPayload
+});
+const SyncConfigCreatedPayload = defineSchemaModel({
+	name: "SyncConfigCreatedPayload",
+	description: "Payload when a sync configuration is created",
+	fields: {
+		syncConfigId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		connectionId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const SyncConfigCreatedEvent = defineEvent({
+	meta: {
+		key: "integration.syncConfig.created",
+		version: 1,
+		description: "Fired when a sync configuration is created",
+		stability: "experimental",
+		owners: ["@integration-team"],
+		tags: ["integration", "sync"]
+	},
+	payload: SyncConfigCreatedPayload
+});
+const SyncStartedPayload = defineSchemaModel({
+	name: "SyncStartedPayload",
+	description: "Payload when a sync run starts",
+	fields: {
+		syncRunId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		syncConfigId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		startedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const SyncStartedEvent = defineEvent({
+	meta: {
+		key: "integration.sync.started",
+		version: 1,
+		description: "Fired when a sync run starts",
+		stability: "experimental",
+		owners: ["@integration-team"],
+		tags: ["integration", "sync"]
+	},
+	payload: SyncStartedPayload
+});
+const SyncCompletedPayload = defineSchemaModel({
+	name: "SyncCompletedPayload",
+	description: "Payload when a sync run completes successfully",
+	fields: {
+		syncRunId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		syncConfigId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		recordsProcessed: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		completedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const SyncCompletedEvent = defineEvent({
+	meta: {
+		key: "integration.sync.completed",
+		version: 1,
+		description: "Fired when a sync run completes successfully",
+		stability: "experimental",
+		owners: ["@integration-team"],
+		tags: ["integration", "sync"]
+	},
+	payload: SyncCompletedPayload
+});
+const SyncFailedPayload = defineSchemaModel({
+	name: "SyncFailedPayload",
+	description: "Payload when a sync run fails",
+	fields: {
+		syncRunId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		syncConfigId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		error: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		failedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const SyncFailedEvent = defineEvent({
+	meta: {
+		key: "integration.sync.failed",
+		version: 1,
+		description: "Fired when a sync run fails",
+		stability: "experimental",
+		owners: ["@integration-team"],
+		tags: ["integration", "sync"]
+	},
+	payload: SyncFailedPayload
+});
+const RecordSyncedPayload = defineSchemaModel({
+	name: "RecordSyncedPayload",
+	description: "Payload when a single record is synced",
+	fields: {
+		syncRunId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		recordId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		sourceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		targetId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const RecordSyncedEvent = defineEvent({
+	meta: {
+		key: "integration.record.synced",
+		version: 1,
+		description: "Fired when a single record is synced",
+		stability: "experimental",
+		owners: ["@integration-team"],
+		tags: ["integration", "sync"]
+	},
+	payload: RecordSyncedPayload
+});
+const FieldMappingAddedPayload = defineSchemaModel({
+	name: "FieldMappingAddedPayload",
+	description: "Payload when a field mapping is added to a sync config",
+	fields: {
+		syncConfigId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		sourceField: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		targetField: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const FieldMappingAddedEvent = defineEvent({
+	meta: {
+		key: "integration.fieldMapping.added",
+		version: 1,
+		description: "Fired when a field mapping is added to a sync config",
+		stability: "experimental",
+		owners: ["@integration-team"],
+		tags: ["integration", "sync"]
+	},
+	payload: FieldMappingAddedPayload
+});
+
+//#endregion
+export { ConnectionCreatedEvent, ConnectionStatusChangedEvent, FieldMappingAddedEvent, IntegrationCreatedEvent, RecordSyncedEvent, SyncCompletedEvent, SyncConfigCreatedEvent, SyncFailedEvent, SyncStartedEvent };
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../src/events.ts"],"sourcesContent":["import { defineEvent } from '@contractspec/lib.contracts';\nimport { ScalarTypeEnum, defineSchemaModel } from '@contractspec/lib.schema';\n\n// Integration events\nconst IntegrationCreatedPayload = defineSchemaModel({\n  name: 'IntegrationCreatedPayload',\n  description: 'Payload when an integration is created',\n  fields: {\n    integrationId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    type: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nexport const IntegrationCreatedEvent = defineEvent({\n  meta: {\n    key: 'integration.created',\n    version: 1,\n    description: 'Fired when a new integration is created',\n    stability: 'experimental',\n    owners: ['@integration-team'],\n    tags: ['integration'],\n  },\n  payload: IntegrationCreatedPayload,\n});\n\n// Connection events\nconst ConnectionCreatedPayload = defineSchemaModel({\n  name: 'ConnectionCreatedPayload',\n  description: 'Payload when a connection is established',\n  fields: {\n    connectionId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    integrationId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nexport const ConnectionCreatedEvent = defineEvent({\n  meta: {\n    key: 'integration.connection.created',\n    version: 1,\n    description: 'Fired when a new connection is established',\n    stability: 'experimental',\n    owners: ['@integration-team'],\n    tags: ['integration', 'connection'],\n  },\n  payload: ConnectionCreatedPayload,\n});\n\nconst ConnectionStatusChangedPayload = defineSchemaModel({\n  name: 'ConnectionStatusChangedPayload',\n  description: 'Payload when a connection status changes',\n  fields: {\n    connectionId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    previousStatus: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    newStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    changedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nexport const ConnectionStatusChangedEvent = defineEvent({\n  meta: {\n    key: 'integration.connection.statusChanged',\n    version: 1,\n    description: 'Fired when a connection status changes',\n    stability: 'experimental',\n    owners: ['@integration-team'],\n    tags: ['integration', 'connection'],\n  },\n  payload: ConnectionStatusChangedPayload,\n});\n\n// Sync config events\nconst SyncConfigCreatedPayload = defineSchemaModel({\n  name: 'SyncConfigCreatedPayload',\n  description: 'Payload when a sync configuration is created',\n  fields: {\n    syncConfigId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    connectionId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nexport const SyncConfigCreatedEvent = defineEvent({\n  meta: {\n    key: 'integration.syncConfig.created',\n    version: 1,\n    description: 'Fired when a sync configuration is created',\n    stability: 'experimental',\n    owners: ['@integration-team'],\n    tags: ['integration', 'sync'],\n  },\n  payload: SyncConfigCreatedPayload,\n});\n\n// Sync run events\nconst SyncStartedPayload = defineSchemaModel({\n  name: 'SyncStartedPayload',\n  description: 'Payload when a sync run starts',\n  fields: {\n    syncRunId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    syncConfigId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nexport const SyncStartedEvent = defineEvent({\n  meta: {\n    key: 'integration.sync.started',\n    version: 1,\n    description: 'Fired when a sync run starts',\n    stability: 'experimental',\n    owners: ['@integration-team'],\n    tags: ['integration', 'sync'],\n  },\n  payload: SyncStartedPayload,\n});\n\nconst SyncCompletedPayload = defineSchemaModel({\n  name: 'SyncCompletedPayload',\n  description: 'Payload when a sync run completes successfully',\n  fields: {\n    syncRunId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    syncConfigId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    recordsProcessed: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: false,\n    },\n    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nexport const SyncCompletedEvent = defineEvent({\n  meta: {\n    key: 'integration.sync.completed',\n    version: 1,\n    description: 'Fired when a sync run completes successfully',\n    stability: 'experimental',\n    owners: ['@integration-team'],\n    tags: ['integration', 'sync'],\n  },\n  payload: SyncCompletedPayload,\n});\n\nconst SyncFailedPayload = defineSchemaModel({\n  name: 'SyncFailedPayload',\n  description: 'Payload when a sync run fails',\n  fields: {\n    syncRunId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    syncConfigId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    error: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    failedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nexport const SyncFailedEvent = defineEvent({\n  meta: {\n    key: 'integration.sync.failed',\n    version: 1,\n    description: 'Fired when a sync run fails',\n    stability: 'experimental',\n    owners: ['@integration-team'],\n    tags: ['integration', 'sync'],\n  },\n  payload: SyncFailedPayload,\n});\n\nconst RecordSyncedPayload = defineSchemaModel({\n  name: 'RecordSyncedPayload',\n  description: 'Payload when a single record is synced',\n  fields: {\n    syncRunId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    recordId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    sourceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    targetId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const RecordSyncedEvent = defineEvent({\n  meta: {\n    key: 'integration.record.synced',\n    version: 1,\n    description: 'Fired when a single record is synced',\n    stability: 'experimental',\n    owners: ['@integration-team'],\n    tags: ['integration', 'sync'],\n  },\n  payload: RecordSyncedPayload,\n});\n\nconst FieldMappingAddedPayload = defineSchemaModel({\n  name: 'FieldMappingAddedPayload',\n  description: 'Payload when a field mapping is added to a sync config',\n  fields: {\n    syncConfigId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    sourceField: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    targetField: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const FieldMappingAddedEvent = defineEvent({\n  meta: {\n    key: 'integration.fieldMapping.added',\n    version: 1,\n    description: 'Fired when a field mapping is added to a sync config',\n    stability: 'experimental',\n    owners: ['@integration-team'],\n    tags: ['integration', 'sync'],\n  },\n  payload: FieldMappingAddedPayload,\n});\n"],"mappings":"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"}

package/dist/example.d.ts

@@ -0,0 +1,40 @@
+//#region src/example.d.ts
+declare const example: {
+  readonly id: "integration-hub";
+  readonly title: "Integration Hub";
+  readonly summary: "Provider-agnostic integration center with connectors, connections, field mappings, and sync logs.";
+  readonly tags: readonly ["integrations", "sync", "etl", "connectors"];
+  readonly kind: "template";
+  readonly visibility: "public";
+  readonly docs: {
+    readonly rootDocId: "docs.examples.integration-hub";
+    readonly goalDocId: "docs.examples.integration-hub.goal";
+    readonly usageDocId: "docs.examples.integration-hub.usage";
+    readonly constraintsDocId: "docs.examples.integration-hub.constraints";
+  };
+  readonly entrypoints: {
+    readonly packageName: "@contractspec/example.integration-hub";
+    readonly feature: "./feature";
+    readonly contracts: "./contracts";
+    readonly presentations: "./presentations";
+    readonly handlers: "./handlers";
+    readonly docs: "./docs";
+  };
+  readonly surfaces: {
+    readonly templates: true;
+    readonly sandbox: {
+      readonly enabled: true;
+      readonly modes: readonly ["playground", "specs", "builder", "markdown", "evolution"];
+    };
+    readonly studio: {
+      readonly enabled: true;
+      readonly installable: true;
+    };
+    readonly mcp: {
+      readonly enabled: true;
+    };
+  };
+};
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";cAAM;EAAA,SAAA,EA+BI,EAAA,iBAAA"}