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

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

@@ -1,103 +1,103 @@
-import * as _lssm_lib_schema17 from "@lssm/lib.schema";
-import * as _lssm_lib_contracts0 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
 /**
  * Create a connection to an external system.
  */
-declare const CreateConnectionContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema17.SchemaModel<{
+declare const CreateConnectionContract: _lssm_lib_contracts8.ContractSpec<_lssm_lib_schema40.SchemaModel<{
   integrationId: {
-    type: _lssm_lib_schema17.FieldType<string, string>;
+    type: _lssm_lib_schema40.FieldType<string, string>;
     isOptional: false;
   };
   name: {
-    type: _lssm_lib_schema17.FieldType<string, string>;
+    type: _lssm_lib_schema40.FieldType<string, string>;
     isOptional: false;
   };
   authType: {
-    type: _lssm_lib_schema17.FieldType<string, string>;
+    type: _lssm_lib_schema40.FieldType<string, string>;
     isOptional: false;
   };
   credentials: {
-    type: _lssm_lib_schema17.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema40.FieldType<unknown, unknown>;
     isOptional: true;
   };
-}>, _lssm_lib_schema17.SchemaModel<{
+}>, _lssm_lib_schema40.SchemaModel<{
   id: {
-    type: _lssm_lib_schema17.FieldType<string, string>;
+    type: _lssm_lib_schema40.FieldType<string, string>;
     isOptional: false;
   };
   integrationId: {
-    type: _lssm_lib_schema17.FieldType<string, string>;
+    type: _lssm_lib_schema40.FieldType<string, string>;
     isOptional: false;
   };
   name: {
-    type: _lssm_lib_schema17.FieldType<string, string>;
+    type: _lssm_lib_schema40.FieldType<string, string>;
     isOptional: false;
   };
   status: {
-    type: _lssm_lib_schema17.EnumType<[string, string, string, string, string]>;
+    type: _lssm_lib_schema40.EnumType<[string, string, string, string, string]>;
     isOptional: false;
   };
   authType: {
-    type: _lssm_lib_schema17.FieldType<string, string>;
+    type: _lssm_lib_schema40.FieldType<string, string>;
     isOptional: false;
   };
   externalAccountName: {
-    type: _lssm_lib_schema17.FieldType<string, string>;
+    type: _lssm_lib_schema40.FieldType<string, string>;
     isOptional: true;
   };
   connectedAt: {
-    type: _lssm_lib_schema17.FieldType<Date, string>;
+    type: _lssm_lib_schema40.FieldType<Date, string>;
     isOptional: true;
   };
   lastHealthCheck: {
-    type: _lssm_lib_schema17.FieldType<Date, string>;
+    type: _lssm_lib_schema40.FieldType<Date, string>;
     isOptional: true;
   };
   healthStatus: {
-    type: _lssm_lib_schema17.FieldType<string, string>;
+    type: _lssm_lib_schema40.FieldType<string, string>;
     isOptional: true;
   };
 }>, {
   name: string;
   version: number;
   when: string;
-  payload: _lssm_lib_schema17.SchemaModel<{
+  payload: _lssm_lib_schema40.SchemaModel<{
     id: {
-      type: _lssm_lib_schema17.FieldType<string, string>;
+      type: _lssm_lib_schema40.FieldType<string, string>;
       isOptional: false;
     };
     integrationId: {
-      type: _lssm_lib_schema17.FieldType<string, string>;
+      type: _lssm_lib_schema40.FieldType<string, string>;
       isOptional: false;
     };
     name: {
-      type: _lssm_lib_schema17.FieldType<string, string>;
+      type: _lssm_lib_schema40.FieldType<string, string>;
       isOptional: false;
     };
     status: {
-      type: _lssm_lib_schema17.EnumType<[string, string, string, string, string]>;
+      type: _lssm_lib_schema40.EnumType<[string, string, string, string, string]>;
       isOptional: false;
     };
     authType: {
-      type: _lssm_lib_schema17.FieldType<string, string>;
+      type: _lssm_lib_schema40.FieldType<string, string>;
       isOptional: false;
     };
     externalAccountName: {
-      type: _lssm_lib_schema17.FieldType<string, string>;
+      type: _lssm_lib_schema40.FieldType<string, string>;
       isOptional: true;
     };
     connectedAt: {
-      type: _lssm_lib_schema17.FieldType<Date, string>;
+      type: _lssm_lib_schema40.FieldType<Date, string>;
       isOptional: true;
     };
     lastHealthCheck: {
-      type: _lssm_lib_schema17.FieldType<Date, string>;
+      type: _lssm_lib_schema40.FieldType<Date, string>;
       isOptional: true;
     };
     healthStatus: {
-      type: _lssm_lib_schema17.FieldType<string, string>;
+      type: _lssm_lib_schema40.FieldType<string, string>;
       isOptional: true;
     };
   }>;

package/dist/connection/connection.contracts.js

@@ -1 +1,41 @@
-import{t as e}from"../libs/contracts/dist/spec.js";import{ConnectionModel as t,CreateConnectionInputModel as n}from"./connection.schema.js";const r=e({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:n,output:t},policy:{auth:`user`},sideEffects:{emits:[{name:`integration.connection.created`,version:1,when:`Connection created`,payload:t}],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_schema206 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_schema206.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{r as e}from"../libs/schema/dist/EnumType.js";import"../libs/schema/dist/index.js";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.d.ts

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

package/dist/connection/connection.schema.js

@@ -1 +1,77 @@
-import{l as e}from"../libs/schema/dist/ScalarTypeEnum.js";import{n as t}from"../libs/schema/dist/SchemaModel.js";import"../libs/schema/dist/index.js";import{ConnectionStatusEnum as n}from"./connection.enum.js";const r=t({name:`ConnectionModel`,fields:{id:{type:e.String_unsecure(),isOptional:!1},integrationId:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},status:{type:n,isOptional:!1},authType:{type:e.String_unsecure(),isOptional:!1},externalAccountName:{type:e.String_unsecure(),isOptional:!0},connectedAt:{type:e.DateTime(),isOptional:!0},lastHealthCheck:{type:e.DateTime(),isOptional:!0},healthStatus:{type:e.String_unsecure(),isOptional:!0}}}),i=t({name:`CreateConnectionInput`,fields:{integrationId:{type:e.String_unsecure(),isOptional:!1},name:{type:e.NonEmptyString(),isOptional:!1},authType:{type:e.NonEmptyString(),isOptional:!1},credentials:{type:e.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{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contracts/dist/docs/index.js";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{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contr
 
 - 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{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contr
 
 ## 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{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contr
 ## 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{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contr
 ## 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