@lssm/example.integration-hub 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217072406

package/dist/connection/connection.contracts.d.ts

@@ -1,5 +1,5 @@
-import * as _lssm_lib_contracts8 from "@lssm/lib.contracts";
 import * as _lssm_lib_schema40 from "@lssm/lib.schema";
+import * as _lssm_lib_contracts8 from "@lssm/lib.contracts";
 
 //#region src/connection/connection.contracts.d.ts
 /**

package/dist/connection/connection.contracts.js

@@ -1 +1,41 @@
-import{ConnectionModel as e,CreateConnectionInputModel as t}from"./connection.schema.js";import{defineCommand as n}from"@lssm/lib.contracts/spec";const r=n({meta:{name:`integration.connection.create`,version:1,stability:`stable`,owners:[...[`@example.integration-hub`]],tags:[`integration`,`connection`,`create`],description:`Create a connection to an external system.`,goal:`Authenticate with external systems.`,context:`Connection setup.`},io:{input:t,output:e},policy:{auth:`user`},sideEffects:{emits:[{name:`integration.connection.created`,version:1,when:`Connection created`,payload:e}],audit:[`integration.connection.created`]}});export{r as CreateConnectionContract};
+import { defineCommand } from "../libs/contracts/dist/spec.js";
+import { ConnectionModel, CreateConnectionInputModel } from "./connection.schema.js";
+
+//#region src/connection/connection.contracts.ts
+const OWNERS = ["@example.integration-hub"];
+/**
+* Create a connection to an external system.
+*/
+const CreateConnectionContract = defineCommand({
+	meta: {
+		name: "integration.connection.create",
+		version: 1,
+		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: [{
+			name: "integration.connection.created",
+			version: 1,
+			when: "Connection created",
+			payload: ConnectionModel
+		}],
+		audit: ["integration.connection.created"]
+	}
+});
+
+//#endregion
+export { CreateConnectionContract };

package/dist/connection/connection.enum.d.ts

@@ -1,9 +1,9 @@
-import * as _lssm_lib_schema88 from "@lssm/lib.schema";
+import * as _lssm_lib_schema65 from "@lssm/lib.schema";
 
 //#region src/connection/connection.enum.d.ts
 /**
  * Connection status enum.
  */
-declare const ConnectionStatusEnum: _lssm_lib_schema88.EnumType<[string, string, string, string, string]>;
+declare const ConnectionStatusEnum: _lssm_lib_schema65.EnumType<[string, string, string, string, string]>;
 //#endregion
 export { ConnectionStatusEnum };

package/dist/connection/connection.enum.js

@@ -1 +1,17 @@
-import{defineEnum as e}from"@lssm/lib.schema";const t=e(`ConnectionStatus`,[`PENDING`,`CONNECTED`,`DISCONNECTED`,`ERROR`,`EXPIRED`]);export{t as ConnectionStatusEnum};
+import { defineEnum } from "../libs/schema/dist/EnumType.js";
+import "../libs/schema/dist/index.js";
+
+//#region src/connection/connection.enum.ts
+/**
+* Connection status enum.
+*/
+const ConnectionStatusEnum = defineEnum("ConnectionStatus", [
+	"PENDING",
+	"CONNECTED",
+	"DISCONNECTED",
+	"ERROR",
+	"EXPIRED"
+]);
+
+//#endregion
+export { ConnectionStatusEnum };

package/dist/connection/connection.presentation.js

@@ -1 +1,50 @@
-import{ConnectionModel as e}from"./connection.schema.js";const t={meta:{name:`integration.connection.list`,version:1,description:`List of integration connections`,domain:`integration`,owners:[`@integration-team`],tags:[`integration`,`connection`,`list`]},source:{type:`component`,framework:`react`,componentKey:`ConnectionList`,props:e},targets:[`react`,`markdown`],policy:{flags:[`integration.enabled`]}},n={meta:{name:`integration.connection.setup`,version:1,description:`Setup wizard for creating integration connections`,domain:`integration`,owners:[`@integration-team`],tags:[`integration`,`connection`,`setup`]},source:{type:`component`,framework:`react`,componentKey:`ConnectionSetup`,props:e},targets:[`react`],policy:{flags:[`integration.enabled`]}};export{t as ConnectionListPresentation,n as ConnectionSetupPresentation};
+import { ConnectionModel } from "./connection.schema.js";
+
+//#region src/connection/connection.presentation.ts
+const ConnectionListPresentation = {
+	meta: {
+		name: "integration.connection.list",
+		version: 1,
+		description: "List of integration connections",
+		domain: "integration",
+		owners: ["@integration-team"],
+		tags: [
+			"integration",
+			"connection",
+			"list"
+		]
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "ConnectionList",
+		props: ConnectionModel
+	},
+	targets: ["react", "markdown"],
+	policy: { flags: ["integration.enabled"] }
+};
+const ConnectionSetupPresentation = {
+	meta: {
+		name: "integration.connection.setup",
+		version: 1,
+		description: "Setup wizard for creating integration connections",
+		domain: "integration",
+		owners: ["@integration-team"],
+		tags: [
+			"integration",
+			"connection",
+			"setup"
+		]
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "ConnectionSetup",
+		props: ConnectionModel
+	},
+	targets: ["react"],
+	policy: { flags: ["integration.enabled"] }
+};
+
+//#endregion
+export { ConnectionListPresentation, ConnectionSetupPresentation };

package/dist/connection/connection.schema.js

@@ -1 +1,77 @@
-import{ConnectionStatusEnum as e}from"./connection.enum.js";import{ScalarTypeEnum as t,defineSchemaModel as n}from"@lssm/lib.schema";const r=n({name:`ConnectionModel`,fields:{id:{type:t.String_unsecure(),isOptional:!1},integrationId:{type:t.String_unsecure(),isOptional:!1},name:{type:t.String_unsecure(),isOptional:!1},status:{type:e,isOptional:!1},authType:{type:t.String_unsecure(),isOptional:!1},externalAccountName:{type:t.String_unsecure(),isOptional:!0},connectedAt:{type:t.DateTime(),isOptional:!0},lastHealthCheck:{type:t.DateTime(),isOptional:!0},healthStatus:{type:t.String_unsecure(),isOptional:!0}}}),i=n({name:`CreateConnectionInput`,fields:{integrationId:{type:t.String_unsecure(),isOptional:!1},name:{type:t.NonEmptyString(),isOptional:!1},authType:{type:t.NonEmptyString(),isOptional:!1},credentials:{type:t.JSON(),isOptional:!0}}});export{r as ConnectionModel,i as CreateConnectionInputModel};
+import { ScalarTypeEnum } from "../libs/schema/dist/ScalarTypeEnum.js";
+import { defineSchemaModel } from "../libs/schema/dist/SchemaModel.js";
+import "../libs/schema/dist/index.js";
+import { ConnectionStatusEnum } from "./connection.enum.js";
+
+//#region src/connection/connection.schema.ts
+/**
+* A connection to an external system.
+*/
+const 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
+		}
+	}
+});
+/**
+* Input for creating a connection.
+*/
+const 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
+		}
+	}
+});
+
+//#endregion
+export { ConnectionModel, CreateConnectionInputModel };

package/dist/connection/index.js

@@ -1 +1,5 @@
-import{ConnectionStatusEnum as e}from"./connection.enum.js";import{ConnectionModel as t,CreateConnectionInputModel as n}from"./connection.schema.js";import{CreateConnectionContract as r}from"./connection.contracts.js";export{t as ConnectionModel,e as ConnectionStatusEnum,r as CreateConnectionContract,n as CreateConnectionInputModel};
+import { ConnectionStatusEnum } from "./connection.enum.js";
+import { ConnectionModel, CreateConnectionInputModel } from "./connection.schema.js";
+import { CreateConnectionContract } from "./connection.contracts.js";
+
+export { ConnectionModel, ConnectionStatusEnum, CreateConnectionContract, CreateConnectionInputModel };

package/dist/docs/index.js

@@ -1 +1 @@
-import"./integration-hub.docblock.js";
+import "./integration-hub.docblock.js";

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

@@ -1,4 +1,22 @@
-import{registerDocBlocks as e}from"@lssm/lib.contracts/docs";e([{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 } from "../libs/contracts/dist/docs/registry.js";
+import "../libs/contracts/dist/docs/index.js";
+
+//#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.
@@ -22,7 +40,17 @@ import{registerDocBlocks as e}from"@lssm/lib.contracts/docs";e([{id:`docs.exampl
 
 - 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
+`
+	},
+	{
+		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.
 
@@ -32,7 +60,17 @@ import{registerDocBlocks as e}from"@lssm/lib.contracts/docs";e([{id:`docs.exampl
 
 ## 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.
 
@@ -44,7 +82,21 @@ import{registerDocBlocks as e}from"@lssm/lib.contracts/docs";e([{id:`docs.exampl
 ## 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.
@@ -56,4 +108,8 @@ import{registerDocBlocks as e}from"@lssm/lib.contracts/docs";e([{id:`docs.exampl
 ## 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.`}]);
+- Ensure Audit/Notifications receive sync lifecycle events.`
+	}
+]);
+
+//#endregion

package/dist/events.d.ts

@@ -1,5 +1,5 @@
-import * as _lssm_lib_contracts0 from "@lssm/lib.contracts";
 import * as _lssm_lib_schema0 from "@lssm/lib.schema";
+import * as _lssm_lib_contracts0 from "@lssm/lib.contracts";
 
 //#region src/events.d.ts
 declare const IntegrationCreatedEvent: _lssm_lib_contracts0.EventSpec<_lssm_lib_schema0.SchemaModel<{

package/dist/events.js

@@ -1 +1,246 @@
-import{defineEvent as e}from"@lssm/lib.contracts";import{ScalarTypeEnum as t,defineSchemaModel as n}from"@lssm/lib.schema";const r=e({name:`integration.created`,version:1,description:`Fired when a new integration is created`,payload:n({name:`IntegrationCreatedPayload`,description:`Payload when an integration is created`,fields:{integrationId:{type:t.String_unsecure(),isOptional:!1},type:{type:t.String_unsecure(),isOptional:!1},createdAt:{type:t.DateTime(),isOptional:!1}}})}),i=e({name:`integration.connection.created`,version:1,description:`Fired when a new connection is established`,payload:n({name:`ConnectionCreatedPayload`,description:`Payload when a connection is established`,fields:{connectionId:{type:t.String_unsecure(),isOptional:!1},integrationId:{type:t.String_unsecure(),isOptional:!1},status:{type:t.String_unsecure(),isOptional:!1},createdAt:{type:t.DateTime(),isOptional:!1}}})}),a=e({name:`integration.connection.statusChanged`,version:1,description:`Fired when a connection status changes`,payload:n({name:`ConnectionStatusChangedPayload`,description:`Payload when a connection status changes`,fields:{connectionId:{type:t.String_unsecure(),isOptional:!1},previousStatus:{type:t.String_unsecure(),isOptional:!1},newStatus:{type:t.String_unsecure(),isOptional:!1},changedAt:{type:t.DateTime(),isOptional:!1}}})}),o=e({name:`integration.syncConfig.created`,version:1,description:`Fired when a sync configuration is created`,payload:n({name:`SyncConfigCreatedPayload`,description:`Payload when a sync configuration is created`,fields:{syncConfigId:{type:t.String_unsecure(),isOptional:!1},connectionId:{type:t.String_unsecure(),isOptional:!1},createdAt:{type:t.DateTime(),isOptional:!1}}})}),s=e({name:`integration.sync.started`,version:1,description:`Fired when a sync run starts`,payload:n({name:`SyncStartedPayload`,description:`Payload when a sync run starts`,fields:{syncRunId:{type:t.String_unsecure(),isOptional:!1},syncConfigId:{type:t.String_unsecure(),isOptional:!1},startedAt:{type:t.DateTime(),isOptional:!1}}})}),c=e({name:`integration.sync.completed`,version:1,description:`Fired when a sync run completes successfully`,payload:n({name:`SyncCompletedPayload`,description:`Payload when a sync run completes successfully`,fields:{syncRunId:{type:t.String_unsecure(),isOptional:!1},syncConfigId:{type:t.String_unsecure(),isOptional:!1},recordsProcessed:{type:t.Int_unsecure(),isOptional:!1},completedAt:{type:t.DateTime(),isOptional:!1}}})}),l=e({name:`integration.sync.failed`,version:1,description:`Fired when a sync run fails`,payload:n({name:`SyncFailedPayload`,description:`Payload when a sync run fails`,fields:{syncRunId:{type:t.String_unsecure(),isOptional:!1},syncConfigId:{type:t.String_unsecure(),isOptional:!1},error:{type:t.String_unsecure(),isOptional:!1},failedAt:{type:t.DateTime(),isOptional:!1}}})}),u=e({name:`integration.record.synced`,version:1,description:`Fired when a single record is synced`,payload:n({name:`RecordSyncedPayload`,description:`Payload when a single record is synced`,fields:{syncRunId:{type:t.String_unsecure(),isOptional:!1},recordId:{type:t.String_unsecure(),isOptional:!1},sourceId:{type:t.String_unsecure(),isOptional:!1},targetId:{type:t.String_unsecure(),isOptional:!1}}})}),d=e({name:`integration.fieldMapping.added`,version:1,description:`Fired when a field mapping is added to a sync config`,payload:n({name:`FieldMappingAddedPayload`,description:`Payload when a field mapping is added to a sync config`,fields:{syncConfigId:{type:t.String_unsecure(),isOptional:!1},sourceField:{type:t.String_unsecure(),isOptional:!1},targetField:{type:t.String_unsecure(),isOptional:!1}}})});export{i as ConnectionCreatedEvent,a as ConnectionStatusChangedEvent,d as FieldMappingAddedEvent,r as IntegrationCreatedEvent,u as RecordSyncedEvent,c as SyncCompletedEvent,o as SyncConfigCreatedEvent,l as SyncFailedEvent,s as SyncStartedEvent};
+import { defineEvent } from "./libs/contracts/dist/events.js";
+import "./libs/contracts/dist/index.js";
+import { ScalarTypeEnum } from "./libs/schema/dist/ScalarTypeEnum.js";
+import { defineSchemaModel } from "./libs/schema/dist/SchemaModel.js";
+import "./libs/schema/dist/index.js";
+
+//#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({
+	name: "integration.created",
+	version: 1,
+	description: "Fired when a new integration is created",
+	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({
+	name: "integration.connection.created",
+	version: 1,
+	description: "Fired when a new connection is established",
+	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({
+	name: "integration.connection.statusChanged",
+	version: 1,
+	description: "Fired when a connection status changes",
+	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({
+	name: "integration.syncConfig.created",
+	version: 1,
+	description: "Fired when a sync configuration is created",
+	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({
+	name: "integration.sync.started",
+	version: 1,
+	description: "Fired when a sync run starts",
+	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({
+	name: "integration.sync.completed",
+	version: 1,
+	description: "Fired when a sync run completes successfully",
+	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({
+	name: "integration.sync.failed",
+	version: 1,
+	description: "Fired when a sync run fails",
+	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({
+	name: "integration.record.synced",
+	version: 1,
+	description: "Fired when a single record is synced",
+	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({
+	name: "integration.fieldMapping.added",
+	version: 1,
+	description: "Fired when a field mapping is added to a sync config",
+	payload: FieldMappingAddedPayload
+});
+
+//#endregion
+export { ConnectionCreatedEvent, ConnectionStatusChangedEvent, FieldMappingAddedEvent, IntegrationCreatedEvent, RecordSyncedEvent, SyncCompletedEvent, SyncConfigCreatedEvent, SyncFailedEvent, SyncStartedEvent };

package/dist/example.js

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

package/dist/index.d.ts

@@ -1,14 +1,11 @@
 import { CreateConnectionContract } from "./connection/connection.contracts.js";
 import { ConnectionStatusEnum } from "./connection/connection.enum.js";
 import { ConnectionModel, CreateConnectionInputModel } from "./connection/connection.schema.js";
-import "./connection/index.js";
 import { IntegrationStatusEnum } from "./integration/integration.enum.js";
 import { CreateIntegrationInputModel, IntegrationModel } from "./integration/integration.schema.js";
 import { CreateIntegrationContract } from "./integration/integration.contracts.js";
-import "./integration/index.js";
 import { MappingTypeEnum, SyncDirectionEnum, SyncStatusEnum } from "./sync/sync.enum.js";
 import { AddFieldMappingInputModel, CreateSyncConfigInputModel, FieldMappingModel, ListSyncRunsInputModel, ListSyncRunsOutputModel, SyncConfigModel, SyncRunModel, TriggerSyncInputModel } from "./sync/sync.schema.js";
 import { AddFieldMappingContract, CreateSyncConfigContract, ListSyncRunsContract, TriggerSyncContract } from "./sync/sync.contracts.js";
-import "./sync/index.js";
 import { BasicFieldTransformer, BasicSyncEngine, FieldMapping, IFieldTransformer, ISyncEngine, LookupConfig, SourceRecord, SyncConfig, SyncContext, SyncError, SyncResult, TargetRecord, computeChecksum, createSyncEngine, hasChanges } from "./sync-engine/index.js";
 export { AddFieldMappingContract, AddFieldMappingInputModel, BasicFieldTransformer, BasicSyncEngine, ConnectionModel, ConnectionStatusEnum, CreateConnectionContract, CreateConnectionInputModel, CreateIntegrationContract, CreateIntegrationInputModel, CreateSyncConfigContract, CreateSyncConfigInputModel, FieldMapping, FieldMappingModel, IFieldTransformer, ISyncEngine, IntegrationModel, IntegrationStatusEnum, ListSyncRunsContract, ListSyncRunsInputModel, ListSyncRunsOutputModel, LookupConfig, MappingTypeEnum, SourceRecord, SyncConfig, SyncConfigModel, SyncContext, SyncDirectionEnum, SyncError, SyncResult, SyncRunModel, SyncStatusEnum, TargetRecord, TriggerSyncContract, TriggerSyncInputModel, computeChecksum, createSyncEngine, hasChanges };