@lssm/example.integration-hub 1.41.1 → 1.42.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,8 @@
 # @lssm/example.integration-hub
 
+Website: https://contractspec.lssm.tech/
+
+
 A comprehensive integration hub example demonstrating ContractSpec principles for data synchronization.
 
 ## Features
@@ -141,3 +144,13 @@ const run = await executeContract(TriggerSyncContract, {
 
 
 
+
+
+
+
+
+
+
+
+
+

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.enum.d.ts","names":[],"sources":["../../src/connection/connection.enum.ts"],"sourcesContent":[],"mappings":";;;;;;AAKa,cAAA,oBAMX,EAAA,iBAAA,CAN+B,QAAA,CAAA,CAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA"}

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 "@lssm/lib.schema";
+
+//#region src/connection/connection.enum.ts
+/**
+* Connection status enum.
+*/
+const ConnectionStatusEnum = defineEnum("ConnectionStatus", [
+	"PENDING",
+	"CONNECTED",
+	"DISCONNECTED",
+	"ERROR",
+	"EXPIRED"
+]);
+
+//#endregion
+export { ConnectionStatusEnum };
+//# sourceMappingURL=connection.enum.js.map

package/dist/connection/connection.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.enum.js","names":[],"sources":["../../src/connection/connection.enum.ts"],"sourcesContent":["import { defineEnum } from '@lssm/lib.schema';\n\n/**\n * Connection status enum.\n */\nexport const ConnectionStatusEnum = defineEnum('ConnectionStatus', [\n  'PENDING',\n  'CONNECTED',\n  'DISCONNECTED',\n  'ERROR',\n  'EXPIRED',\n]);\n"],"mappings":";;;;;;AAKA,MAAa,uBAAuB,WAAW,oBAAoB;CACjE;CACA;CACA;CACA;CACA;CACD,CAAC"}

package/dist/connection/connection.operation.d.ts

@@ -0,0 +1,107 @@
+import * as _lssm_lib_contracts0 from "@lssm/lib.contracts";
+import * as _lssm_lib_schema0 from "@lssm/lib.schema";
+
+//#region src/connection/connection.operation.d.ts
+/**
+ * Create a connection to an external system.
+ */
+declare const CreateConnectionContract: _lssm_lib_contracts0.OperationSpec<_lssm_lib_schema0.SchemaModel<{
+  integrationId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  authType: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  credentials: {
+    type: _lssm_lib_schema0.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+}>, _lssm_lib_schema0.SchemaModel<{
+  id: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  integrationId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _lssm_lib_schema0.EnumType<[string, string, string, string, string]>;
+    isOptional: false;
+  };
+  authType: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  externalAccountName: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  connectedAt: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  lastHealthCheck: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  healthStatus: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, {
+  key: string;
+  version: number;
+  when: string;
+  payload: _lssm_lib_schema0.SchemaModel<{
+    id: {
+      type: _lssm_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    integrationId: {
+      type: _lssm_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    name: {
+      type: _lssm_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    status: {
+      type: _lssm_lib_schema0.EnumType<[string, string, string, string, string]>;
+      isOptional: false;
+    };
+    authType: {
+      type: _lssm_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    externalAccountName: {
+      type: _lssm_lib_schema0.FieldType<string, string>;
+      isOptional: true;
+    };
+    connectedAt: {
+      type: _lssm_lib_schema0.FieldType<Date, string>;
+      isOptional: true;
+    };
+    lastHealthCheck: {
+      type: _lssm_lib_schema0.FieldType<Date, string>;
+      isOptional: true;
+    };
+    healthStatus: {
+      type: _lssm_lib_schema0.FieldType<string, string>;
+      isOptional: true;
+    };
+  }>;
+}[]>;
+//#endregion
+export { CreateConnectionContract };
+//# sourceMappingURL=connection.operation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.operation.d.ts","names":[],"sources":["../../src/connection/connection.operation.ts"],"sourcesContent":[],"mappings":";;;;;;;cAWa,+CAAwB,gCAAA;EAAxB,aAAA,EAAA;IAiDX,IAAA,EAAA,iBAAA,CAAA,SAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;qCAjDmC,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;;;;;;UAAA,iBAAA,CAAA;;;;;;;;;;;;oCAAA,CAAA,CAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA;IAAA,UAAA,EAAA,KAAA"}

package/dist/connection/connection.operation.js

@@ -0,0 +1,63 @@
+import { ConnectionModel, CreateConnectionInputModel } from "./connection.schema.js";
+import { defineCommand } from "@lssm/lib.contracts/operations";
+
+//#region src/connection/connection.operation.ts
+const OWNERS = ["@example.integration-hub"];
+/**
+* Create a connection to an external system.
+*/
+const CreateConnectionContract = defineCommand({
+	meta: {
+		key: "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: [{
+			key: "integration.connection.created",
+			version: 1,
+			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"
+			}
+		}]
+	}
+});
+
+//#endregion
+export { CreateConnectionContract };
+//# sourceMappingURL=connection.operation.js.map

package/dist/connection/connection.operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.operation.js","names":[],"sources":["../../src/connection/connection.operation.ts"],"sourcesContent":["import { defineCommand } from '@lssm/lib.contracts/operations';\nimport {\n  ConnectionModel,\n  CreateConnectionInputModel,\n} from './connection.schema';\n\nconst OWNERS = ['@example.integration-hub'] as const;\n\n/**\n * Create a connection to an external system.\n */\nexport const CreateConnectionContract = defineCommand({\n  meta: {\n    key: 'integration.connection.create',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['integration', 'connection', 'create'],\n    description: 'Create a connection to an external system.',\n    goal: 'Authenticate with external systems.',\n    context: 'Connection setup.',\n  },\n  io: { input: CreateConnectionInputModel, output: ConnectionModel },\n  policy: { auth: 'user' },\n  sideEffects: {\n    emits: [\n      {\n        key: 'integration.connection.created',\n        version: 1,\n        when: 'Connection created',\n        payload: ConnectionModel,\n      },\n    ],\n    audit: ['integration.connection.created'],\n  },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'create-connection-happy-path',\n        given: ['User is authenticated'],\n        when: ['User creates connection with valid credentials'],\n        then: ['Connection is created', 'ConnectionCreated event is emitted'],\n      },\n    ],\n    examples: [\n      {\n        key: 'connect-crm',\n        input: {\n          name: 'Salesforce Prod',\n          integrationId: 'salesforce',\n          credentials: { clientId: 'xxx' },\n        },\n        output: {\n          id: 'conn-123',\n          status: 'connected',\n          connectedAt: '2025-01-01T12:00:00Z',\n        },\n      },\n    ],\n  },\n});\n"],"mappings":";;;;AAMA,MAAM,SAAS,CAAC,2BAA2B;;;;AAK3C,MAAa,2BAA2B,cAAc;CACpD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM;GAAC;GAAe;GAAc;GAAS;EAC7C,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EAAE,OAAO;EAA4B,QAAQ;EAAiB;CAClE,QAAQ,EAAE,MAAM,QAAQ;CACxB,aAAa;EACX,OAAO,CACL;GACE,KAAK;GACL,SAAS;GACT,MAAM;GACN,SAAS;GACV,CACF;EACD,OAAO,CAAC,iCAAiC;EAC1C;CACD,YAAY;EACV,WAAW,CACT;GACE,KAAK;GACL,OAAO,CAAC,wBAAwB;GAChC,MAAM,CAAC,iDAAiD;GACxD,MAAM,CAAC,yBAAyB,qCAAqC;GACtE,CACF;EACD,UAAU,CACR;GACE,KAAK;GACL,OAAO;IACL,MAAM;IACN,eAAe;IACf,aAAa,EAAE,UAAU,OAAO;IACjC;GACD,QAAQ;IACN,IAAI;IACJ,QAAQ;IACR,aAAa;IACd;GACF,CACF;EACF;CACF,CAAC"}

package/dist/connection/connection.presentation.d.ts

@@ -0,0 +1,8 @@
+import { PresentationSpec } from "@lssm/lib.contracts";
+
+//#region src/connection/connection.presentation.d.ts
+declare const ConnectionListPresentation: PresentationSpec;
+declare const ConnectionSetupPresentation: PresentationSpec;
+//#endregion
+export { ConnectionListPresentation, ConnectionSetupPresentation };
+//# sourceMappingURL=connection.presentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.presentation.d.ts","names":[],"sources":["../../src/connection/connection.presentation.ts"],"sourcesContent":[],"mappings":";;;cAIa,4BAA4B;cAyB5B,6BAA6B"}

package/dist/connection/connection.presentation.js

@@ -1 +1,60 @@
-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";
+import { StabilityEnum } from "@lssm/lib.contracts";
+
+//#region src/connection/connection.presentation.ts
+const ConnectionListPresentation = {
+	meta: {
+		key: "integration.connection.list",
+		version: 1,
+		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"] }
+};
+const ConnectionSetupPresentation = {
+	meta: {
+		key: "integration.connection.setup",
+		version: 1,
+		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"] }
+};
+
+//#endregion
+export { ConnectionListPresentation, ConnectionSetupPresentation };
+//# sourceMappingURL=connection.presentation.js.map

package/dist/connection/connection.presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.presentation.js","names":["ConnectionListPresentation: PresentationSpec","ConnectionSetupPresentation: PresentationSpec"],"sources":["../../src/connection/connection.presentation.ts"],"sourcesContent":["import type { PresentationSpec } from '@lssm/lib.contracts';\nimport { StabilityEnum } from '@lssm/lib.contracts';\nimport { ConnectionModel } from './connection.schema';\n\nexport const ConnectionListPresentation: PresentationSpec = {\n  meta: {\n    key: 'integration.connection.list',\n    version: 1,\n    title: 'Connection List',\n    description: 'List of integration connections',\n    domain: 'integration',\n    owners: ['@integration-team'],\n    tags: ['integration', 'connection', 'list'],\n    stability: StabilityEnum.Experimental,\n    goal: 'Provide an overview of all established integration connections.',\n    context: 'The primary management view for integration hubs.',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'ConnectionList',\n    props: ConnectionModel,\n  },\n  targets: ['react', 'markdown'],\n  policy: {\n    flags: ['integration.enabled'],\n  },\n};\n\nexport const ConnectionSetupPresentation: PresentationSpec = {\n  meta: {\n    key: 'integration.connection.setup',\n    version: 1,\n    title: 'Connection Setup',\n    description: 'Setup wizard for creating integration connections',\n    domain: 'integration',\n    owners: ['@integration-team'],\n    tags: ['integration', 'connection', 'setup'],\n    stability: StabilityEnum.Experimental,\n    goal: 'Guide users through the multi-step process of connecting to a new integration.',\n    context: 'The onboarding flow for new integrations.',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'ConnectionSetup',\n    props: ConnectionModel,\n  },\n  targets: ['react'],\n  policy: {\n    flags: ['integration.enabled'],\n  },\n};\n"],"mappings":";;;;AAIA,MAAaA,6BAA+C;CAC1D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,oBAAoB;EAC7B,MAAM;GAAC;GAAe;GAAc;GAAO;EAC3C,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACd,OAAO;EACR;CACD,SAAS,CAAC,SAAS,WAAW;CAC9B,QAAQ,EACN,OAAO,CAAC,sBAAsB,EAC/B;CACF;AAED,MAAaC,8BAAgD;CAC3D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,oBAAoB;EAC7B,MAAM;GAAC;GAAe;GAAc;GAAQ;EAC5C,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACd,OAAO;EACR;CACD,SAAS,CAAC,QAAQ;CAClB,QAAQ,EACN,OAAO,CAAC,sBAAsB,EAC/B;CACF"}

package/dist/connection/connection.schema.d.ts

@@ -0,0 +1,68 @@
+import * as _lssm_lib_schema66 from "@lssm/lib.schema";
+
+//#region src/connection/connection.schema.d.ts
+/**
+ * A connection to an external system.
+ */
+declare const ConnectionModel: _lssm_lib_schema66.SchemaModel<{
+  id: {
+    type: _lssm_lib_schema66.FieldType<string, string>;
+    isOptional: false;
+  };
+  integrationId: {
+    type: _lssm_lib_schema66.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _lssm_lib_schema66.FieldType<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _lssm_lib_schema66.EnumType<[string, string, string, string, string]>;
+    isOptional: false;
+  };
+  authType: {
+    type: _lssm_lib_schema66.FieldType<string, string>;
+    isOptional: false;
+  };
+  externalAccountName: {
+    type: _lssm_lib_schema66.FieldType<string, string>;
+    isOptional: true;
+  };
+  connectedAt: {
+    type: _lssm_lib_schema66.FieldType<Date, string>;
+    isOptional: true;
+  };
+  lastHealthCheck: {
+    type: _lssm_lib_schema66.FieldType<Date, string>;
+    isOptional: true;
+  };
+  healthStatus: {
+    type: _lssm_lib_schema66.FieldType<string, string>;
+    isOptional: true;
+  };
+}>;
+/**
+ * Input for creating a connection.
+ */
+declare const CreateConnectionInputModel: _lssm_lib_schema66.SchemaModel<{
+  integrationId: {
+    type: _lssm_lib_schema66.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _lssm_lib_schema66.FieldType<string, string>;
+    isOptional: false;
+  };
+  authType: {
+    type: _lssm_lib_schema66.FieldType<string, string>;
+    isOptional: false;
+  };
+  credentials: {
+    type: _lssm_lib_schema66.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+}>;
+//#endregion
+export { ConnectionModel, CreateConnectionInputModel };
+//# sourceMappingURL=connection.schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.schema.d.ts","names":[],"sources":["../../src/connection/connection.schema.ts"],"sourcesContent":[],"mappings":";;;;;;AAMa,cAAA,eAmBX,qBAnB0B,WAmB1B,CAAA;EAAA,EAAA,EAAA;UAAA,kBAAA,CAAA;;;;;;;;;;;EAnB0B,MAAA,EAAA;IAwBf,IAAA,6BAWX,CAAA,CAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;gBAXqC,KAAA;EAAA,CAAA;;;;;;;;;;;;;;;;;;;;;cAA1B,+CAA0B;;UAWrC,kBAAA,CAAA"}

package/dist/connection/connection.schema.js

@@ -1 +1,76 @@
-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 { ConnectionStatusEnum } from "./connection.enum.js";
+import { ScalarTypeEnum, defineSchemaModel } from "@lssm/lib.schema";
+
+//#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 };
+//# sourceMappingURL=connection.schema.js.map

package/dist/connection/connection.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.schema.js","names":[],"sources":["../../src/connection/connection.schema.ts"],"sourcesContent":["import { defineSchemaModel, ScalarTypeEnum } from '@lssm/lib.schema';\nimport { ConnectionStatusEnum } from './connection.enum';\n\n/**\n * A connection to an external system.\n */\nexport const ConnectionModel = defineSchemaModel({\n  name: 'ConnectionModel',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    integrationId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    status: { type: ConnectionStatusEnum, isOptional: false },\n    authType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    externalAccountName: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    connectedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    lastHealthCheck: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\n/**\n * Input for creating a connection.\n */\nexport const CreateConnectionInputModel = defineSchemaModel({\n  name: 'CreateConnectionInput',\n  fields: {\n    integrationId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n    authType: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true },\n  },\n});\n"],"mappings":";;;;;;;AAMA,MAAa,kBAAkB,kBAAkB;CAC/C,MAAM;CACN,QAAQ;EACN,IAAI;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACjE,eAAe;GACb,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,MAAM;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACnE,QAAQ;GAAE,MAAM;GAAsB,YAAY;GAAO;EACzD,UAAU;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACvE,qBAAqB;GACnB,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,aAAa;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAM;EAClE,iBAAiB;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAM;EACtE,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EAC3E;CACF,CAAC;;;;AAKF,MAAa,6BAA6B,kBAAkB;CAC1D,MAAM;CACN,QAAQ;EACN,eAAe;GACb,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,MAAM;GAAE,MAAM,eAAe,gBAAgB;GAAE,YAAY;GAAO;EAClE,UAAU;GAAE,MAAM,eAAe,gBAAgB;GAAE,YAAY;GAAO;EACtE,aAAa;GAAE,MAAM,eAAe,MAAM;GAAE,YAAY;GAAM;EAC/D;CACF,CAAC"}

package/dist/connection/index.d.ts

@@ -0,0 +1,4 @@
+import { ConnectionStatusEnum } from "./connection.enum.js";
+import { CreateConnectionContract } from "./connection.operation.js";
+import { ConnectionModel, CreateConnectionInputModel } from "./connection.schema.js";
+export { ConnectionModel, ConnectionStatusEnum, CreateConnectionContract, 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.operation.js";
+
+export { ConnectionModel, ConnectionStatusEnum, CreateConnectionContract, CreateConnectionInputModel };

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

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

package/dist/docs/integration-hub.docblock.d.ts

@@ -0,0 +1 @@
+export { };

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

@@ -1,4 +1,21 @@
-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 "@lssm/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.
@@ -22,7 +39,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 +59,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 +81,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 +107,9 @@ 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
+//# 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 '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '@lssm/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"}