@lssm/example.integration-hub 0.0.0-canary-20251210171026 → 0.0.0-canary-20251212210835

package/dist/docs/index.js

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

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

@@ -0,0 +1,59 @@
+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
+
+- 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.`}]);

package/dist/index.js

@@ -1 +1 @@
-import{ConnectionCreatedEvent as e,ConnectionStatusChangedEvent as t,IntegrationCreatedEvent as n,IntegrationHubEvents as r,RecordSyncedEvent as i,SyncCompletedEvent as a,SyncConfigCreatedEvent as o,SyncFailedEvent as s,SyncStartedEvent as c}from"./events.js";import{IntegrationHubFeature as l}from"./feature.js";import{ConnectionEntity as u,ConnectionStatusEnum as d,FieldMappingEntity as f,IntegrationEntity as p,IntegrationStatusEnum as m,MappingTypeEnum as h,SyncConfigEntity as g,SyncDirectionEnum as _,SyncLogEntity as v,SyncRecordEntity as y,SyncRunEntity as b,SyncStatusEnum as x,integrationHubEntities as S,integrationHubSchemaContribution as C}from"./entities/index.js";import{AddFieldMappingContract as w,AddFieldMappingInputModel as T,ConnectionModel as E,CreateConnectionContract as D,CreateConnectionInputModel as O,CreateIntegrationContract as k,CreateIntegrationInputModel as A,CreateSyncConfigContract as j,CreateSyncConfigInputModel as M,FieldMappingModel as N,IntegrationModel as P,ListSyncRunsContract as F,ListSyncRunsInputModel as I,ListSyncRunsOutputModel as L,SyncConfigModel as ee,SyncRunModel as R,TriggerSyncContract as z,TriggerSyncInputModel as B}from"./contracts/index.js";import{handleAddFieldMapping as V,handleCreateConnection as H,handleCreateIntegration as U,handleCreateSyncConfig as W,handleListSyncRuns as G,handleTriggerSync as K,mockIntegrationStore as q}from"./handlers/index.js";import{ConnectionListPresentation as J,ConnectionSetupPresentation as Y,FieldMappingEditorPresentation as X,IntegrationDetailPresentation as Z,IntegrationHealthPresentation as Q,IntegrationHubPresentations as $,IntegrationListPresentation as te,SyncActivityPresentation as ne,SyncConfigEditorPresentation as re,SyncConfigListPresentation as ie,SyncRunDetailPresentation as ae,SyncRunListPresentation as oe}from"./presentations/index.js";import{BasicFieldTransformer as se,BasicSyncEngine as ce,computeChecksum as le,createSyncEngine as ue,hasChanges as de}from"./sync-engine/index.js";import{identityRbacSchemaContribution as fe}from"@lssm/lib.identity-rbac";import{auditTrailSchemaContribution as pe}from"@lssm/module.audit-trail";import{featureFlagsSchemaContribution as me}from"@lssm/lib.feature-flags";import{filesSchemaContribution as he}from"@lssm/lib.files";import{jobsSchemaContribution as ge}from"@lssm/lib.jobs";const _e={modules:[fe,pe,me,he,ge,C],provider:`postgresql`,outputPath:`./prisma/schema/generated.prisma`};export{w as AddFieldMappingContract,T as AddFieldMappingInputModel,se as BasicFieldTransformer,ce as BasicSyncEngine,e as ConnectionCreatedEvent,u as ConnectionEntity,J as ConnectionListPresentation,E as ConnectionModel,Y as ConnectionSetupPresentation,t as ConnectionStatusChangedEvent,d as ConnectionStatusEnum,D as CreateConnectionContract,O as CreateConnectionInputModel,k as CreateIntegrationContract,A as CreateIntegrationInputModel,j as CreateSyncConfigContract,M as CreateSyncConfigInputModel,X as FieldMappingEditorPresentation,f as FieldMappingEntity,N as FieldMappingModel,n as IntegrationCreatedEvent,Z as IntegrationDetailPresentation,p as IntegrationEntity,Q as IntegrationHealthPresentation,r as IntegrationHubEvents,l as IntegrationHubFeature,$ as IntegrationHubPresentations,te as IntegrationListPresentation,P as IntegrationModel,m as IntegrationStatusEnum,F as ListSyncRunsContract,I as ListSyncRunsInputModel,L as ListSyncRunsOutputModel,h as MappingTypeEnum,i as RecordSyncedEvent,ne as SyncActivityPresentation,a as SyncCompletedEvent,o as SyncConfigCreatedEvent,re as SyncConfigEditorPresentation,g as SyncConfigEntity,ie as SyncConfigListPresentation,ee as SyncConfigModel,_ as SyncDirectionEnum,s as SyncFailedEvent,v as SyncLogEntity,y as SyncRecordEntity,ae as SyncRunDetailPresentation,b as SyncRunEntity,oe as SyncRunListPresentation,R as SyncRunModel,c as SyncStartedEvent,x as SyncStatusEnum,z as TriggerSyncContract,B as TriggerSyncInputModel,le as computeChecksum,ue as createSyncEngine,V as handleAddFieldMapping,H as handleCreateConnection,U as handleCreateIntegration,W as handleCreateSyncConfig,G as handleListSyncRuns,K as handleTriggerSync,de as hasChanges,S as integrationHubEntities,C as integrationHubSchemaContribution,q as mockIntegrationStore,_e as schemaComposition};
+import{ConnectionCreatedEvent as e,ConnectionStatusChangedEvent as t,IntegrationCreatedEvent as n,IntegrationHubEvents as r,RecordSyncedEvent as i,SyncCompletedEvent as a,SyncConfigCreatedEvent as o,SyncFailedEvent as s,SyncStartedEvent as c}from"./events.js";import{IntegrationHubFeature as l}from"./feature.js";import{ConnectionEntity as u,ConnectionStatusEnum as d,FieldMappingEntity as f,IntegrationEntity as p,IntegrationStatusEnum as m,MappingTypeEnum as h,SyncConfigEntity as g,SyncDirectionEnum as _,SyncLogEntity as v,SyncRecordEntity as y,SyncRunEntity as b,SyncStatusEnum as x,integrationHubEntities as S,integrationHubSchemaContribution as C}from"./entities/index.js";import{AddFieldMappingContract as w,AddFieldMappingInputModel as T,ConnectionModel as E,CreateConnectionContract as D,CreateConnectionInputModel as O,CreateIntegrationContract as k,CreateIntegrationInputModel as A,CreateSyncConfigContract as j,CreateSyncConfigInputModel as M,FieldMappingModel as N,IntegrationModel as P,ListSyncRunsContract as F,ListSyncRunsInputModel as I,ListSyncRunsOutputModel as L,SyncConfigModel as ee,SyncRunModel as R,TriggerSyncContract as z,TriggerSyncInputModel as B}from"./contracts/index.js";import{handleAddFieldMapping as V,handleCreateConnection as H,handleCreateIntegration as U,handleCreateSyncConfig as W,handleListSyncRuns as G,handleTriggerSync as K,mockIntegrationStore as q}from"./handlers/index.js";import{ConnectionListPresentation as J,ConnectionSetupPresentation as Y,FieldMappingEditorPresentation as X,IntegrationDetailPresentation as Z,IntegrationHealthPresentation as Q,IntegrationHubPresentations as $,IntegrationListPresentation as te,SyncActivityPresentation as ne,SyncConfigEditorPresentation as re,SyncConfigListPresentation as ie,SyncRunDetailPresentation as ae,SyncRunListPresentation as oe}from"./presentations/index.js";import{BasicFieldTransformer as se,BasicSyncEngine as ce,computeChecksum as le,createSyncEngine as ue,hasChanges as de}from"./sync-engine/index.js";import"./docs/index.js";import{identityRbacSchemaContribution as fe}from"@lssm/lib.identity-rbac";import{auditTrailSchemaContribution as pe}from"@lssm/module.audit-trail";import{featureFlagsSchemaContribution as me}from"@lssm/lib.feature-flags";import{filesSchemaContribution as he}from"@lssm/lib.files";import{jobsSchemaContribution as ge}from"@lssm/lib.jobs";const _e={modules:[fe,pe,me,he,ge,C],provider:`postgresql`,outputPath:`./prisma/schema/generated.prisma`};export{w as AddFieldMappingContract,T as AddFieldMappingInputModel,se as BasicFieldTransformer,ce as BasicSyncEngine,e as ConnectionCreatedEvent,u as ConnectionEntity,J as ConnectionListPresentation,E as ConnectionModel,Y as ConnectionSetupPresentation,t as ConnectionStatusChangedEvent,d as ConnectionStatusEnum,D as CreateConnectionContract,O as CreateConnectionInputModel,k as CreateIntegrationContract,A as CreateIntegrationInputModel,j as CreateSyncConfigContract,M as CreateSyncConfigInputModel,X as FieldMappingEditorPresentation,f as FieldMappingEntity,N as FieldMappingModel,n as IntegrationCreatedEvent,Z as IntegrationDetailPresentation,p as IntegrationEntity,Q as IntegrationHealthPresentation,r as IntegrationHubEvents,l as IntegrationHubFeature,$ as IntegrationHubPresentations,te as IntegrationListPresentation,P as IntegrationModel,m as IntegrationStatusEnum,F as ListSyncRunsContract,I as ListSyncRunsInputModel,L as ListSyncRunsOutputModel,h as MappingTypeEnum,i as RecordSyncedEvent,ne as SyncActivityPresentation,a as SyncCompletedEvent,o as SyncConfigCreatedEvent,re as SyncConfigEditorPresentation,g as SyncConfigEntity,ie as SyncConfigListPresentation,ee as SyncConfigModel,_ as SyncDirectionEnum,s as SyncFailedEvent,v as SyncLogEntity,y as SyncRecordEntity,ae as SyncRunDetailPresentation,b as SyncRunEntity,oe as SyncRunListPresentation,R as SyncRunModel,c as SyncStartedEvent,x as SyncStatusEnum,z as TriggerSyncContract,B as TriggerSyncInputModel,le as computeChecksum,ue as createSyncEngine,V as handleAddFieldMapping,H as handleCreateConnection,U as handleCreateIntegration,W as handleCreateSyncConfig,G as handleListSyncRuns,K as handleTriggerSync,de as hasChanges,S as integrationHubEntities,C as integrationHubSchemaContribution,q as mockIntegrationStore,_e as schemaComposition};