@lssm/example.integration-hub 0.0.0-canary-20251217054315 → 0.0.0-canary-20251217060804

package/dist/sync/sync.schema.d.ts

@@ -0,0 +1,355 @@
+import * as _lssm_lib_schema209 from "@lssm/lib.schema";
+
+//#region src/sync/sync.schema.d.ts
+/**
+ * A field mapping configuration.
+ */
+declare const FieldMappingModel: _lssm_lib_schema209.SchemaModel<{
+  id: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  sourceField: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  targetField: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  mappingType: {
+    type: _lssm_lib_schema209.EnumType<[string, string, string, string, string]>;
+    isOptional: false;
+  };
+  transformExpression: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: true;
+  };
+  isRequired: {
+    type: _lssm_lib_schema209.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+}>;
+/**
+ * A sync configuration.
+ */
+declare const SyncConfigModel: _lssm_lib_schema209.SchemaModel<{
+  id: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  integrationId: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  connectionId: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  direction: {
+    type: _lssm_lib_schema209.EnumType<[string, string, string]>;
+    isOptional: false;
+  };
+  sourceObject: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  targetObject: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  scheduleEnabled: {
+    type: _lssm_lib_schema209.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  scheduleCron: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: true;
+  };
+  isActive: {
+    type: _lssm_lib_schema209.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  lastSyncAt: {
+    type: _lssm_lib_schema209.FieldType<Date, string>;
+    isOptional: true;
+  };
+  fieldMappings: {
+    type: _lssm_lib_schema209.SchemaModel<{
+      id: {
+        type: _lssm_lib_schema209.FieldType<string, string>;
+        isOptional: false;
+      };
+      sourceField: {
+        type: _lssm_lib_schema209.FieldType<string, string>;
+        isOptional: false;
+      };
+      targetField: {
+        type: _lssm_lib_schema209.FieldType<string, string>;
+        isOptional: false;
+      };
+      mappingType: {
+        type: _lssm_lib_schema209.EnumType<[string, string, string, string, string]>;
+        isOptional: false;
+      };
+      transformExpression: {
+        type: _lssm_lib_schema209.FieldType<string, string>;
+        isOptional: true;
+      };
+      isRequired: {
+        type: _lssm_lib_schema209.FieldType<boolean, boolean>;
+        isOptional: false;
+      };
+    }>;
+    isArray: true;
+    isOptional: true;
+  };
+}>;
+/**
+ * A sync run.
+ */
+declare const SyncRunModel: _lssm_lib_schema209.SchemaModel<{
+  id: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  syncConfigId: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _lssm_lib_schema209.EnumType<[string, string, string, string, string]>;
+    isOptional: false;
+  };
+  direction: {
+    type: _lssm_lib_schema209.EnumType<[string, string, string]>;
+    isOptional: false;
+  };
+  trigger: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  recordsProcessed: {
+    type: _lssm_lib_schema209.FieldType<number, number>;
+    isOptional: false;
+  };
+  recordsCreated: {
+    type: _lssm_lib_schema209.FieldType<number, number>;
+    isOptional: false;
+  };
+  recordsUpdated: {
+    type: _lssm_lib_schema209.FieldType<number, number>;
+    isOptional: false;
+  };
+  recordsFailed: {
+    type: _lssm_lib_schema209.FieldType<number, number>;
+    isOptional: false;
+  };
+  errorMessage: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: true;
+  };
+  startedAt: {
+    type: _lssm_lib_schema209.FieldType<Date, string>;
+    isOptional: true;
+  };
+  completedAt: {
+    type: _lssm_lib_schema209.FieldType<Date, string>;
+    isOptional: true;
+  };
+  createdAt: {
+    type: _lssm_lib_schema209.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>;
+/**
+ * Input for creating a sync config.
+ */
+declare const CreateSyncConfigInputModel: _lssm_lib_schema209.SchemaModel<{
+  integrationId: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  connectionId: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  direction: {
+    type: _lssm_lib_schema209.EnumType<[string, string, string]>;
+    isOptional: false;
+  };
+  sourceObject: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  targetObject: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  scheduleEnabled: {
+    type: _lssm_lib_schema209.FieldType<boolean, boolean>;
+    isOptional: true;
+  };
+  scheduleCron: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: true;
+  };
+}>;
+/**
+ * Input for adding a field mapping.
+ */
+declare const AddFieldMappingInputModel: _lssm_lib_schema209.SchemaModel<{
+  syncConfigId: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  sourceField: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  targetField: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  mappingType: {
+    type: _lssm_lib_schema209.EnumType<[string, string, string, string, string]>;
+    isOptional: false;
+  };
+  transformExpression: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: true;
+  };
+  lookupConfig: {
+    type: _lssm_lib_schema209.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+  constantValue: {
+    type: _lssm_lib_schema209.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+  isRequired: {
+    type: _lssm_lib_schema209.FieldType<boolean, boolean>;
+    isOptional: true;
+  };
+  defaultValue: {
+    type: _lssm_lib_schema209.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+}>;
+/**
+ * Input for triggering a sync.
+ */
+declare const TriggerSyncInputModel: _lssm_lib_schema209.SchemaModel<{
+  syncConfigId: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  direction: {
+    type: _lssm_lib_schema209.EnumType<[string, string, string]>;
+    isOptional: true;
+  };
+  fullSync: {
+    type: _lssm_lib_schema209.FieldType<boolean, boolean>;
+    isOptional: true;
+  };
+}>;
+/**
+ * Input for listing sync runs.
+ */
+declare const ListSyncRunsInputModel: _lssm_lib_schema209.SchemaModel<{
+  syncConfigId: {
+    type: _lssm_lib_schema209.FieldType<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _lssm_lib_schema209.EnumType<[string, string, string, string, string]>;
+    isOptional: true;
+  };
+  limit: {
+    type: _lssm_lib_schema209.FieldType<number, number>;
+    isOptional: true;
+    defaultValue: number;
+  };
+  offset: {
+    type: _lssm_lib_schema209.FieldType<number, number>;
+    isOptional: true;
+    defaultValue: number;
+  };
+}>;
+/**
+ * Output for listing sync runs.
+ */
+declare const ListSyncRunsOutputModel: _lssm_lib_schema209.SchemaModel<{
+  runs: {
+    type: _lssm_lib_schema209.SchemaModel<{
+      id: {
+        type: _lssm_lib_schema209.FieldType<string, string>;
+        isOptional: false;
+      };
+      syncConfigId: {
+        type: _lssm_lib_schema209.FieldType<string, string>;
+        isOptional: false;
+      };
+      status: {
+        type: _lssm_lib_schema209.EnumType<[string, string, string, string, string]>;
+        isOptional: false;
+      };
+      direction: {
+        type: _lssm_lib_schema209.EnumType<[string, string, string]>;
+        isOptional: false;
+      };
+      trigger: {
+        type: _lssm_lib_schema209.FieldType<string, string>;
+        isOptional: false;
+      };
+      recordsProcessed: {
+        type: _lssm_lib_schema209.FieldType<number, number>;
+        isOptional: false;
+      };
+      recordsCreated: {
+        type: _lssm_lib_schema209.FieldType<number, number>;
+        isOptional: false;
+      };
+      recordsUpdated: {
+        type: _lssm_lib_schema209.FieldType<number, number>;
+        isOptional: false;
+      };
+      recordsFailed: {
+        type: _lssm_lib_schema209.FieldType<number, number>;
+        isOptional: false;
+      };
+      errorMessage: {
+        type: _lssm_lib_schema209.FieldType<string, string>;
+        isOptional: true;
+      };
+      startedAt: {
+        type: _lssm_lib_schema209.FieldType<Date, string>;
+        isOptional: true;
+      };
+      completedAt: {
+        type: _lssm_lib_schema209.FieldType<Date, string>;
+        isOptional: true;
+      };
+      createdAt: {
+        type: _lssm_lib_schema209.FieldType<Date, string>;
+        isOptional: false;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+  total: {
+    type: _lssm_lib_schema209.FieldType<number, number>;
+    isOptional: false;
+  };
+}>;
+//#endregion
+export { AddFieldMappingInputModel, CreateSyncConfigInputModel, FieldMappingModel, ListSyncRunsInputModel, ListSyncRunsOutputModel, SyncConfigModel, SyncRunModel, TriggerSyncInputModel };

package/dist/sync-engine/index.d.ts

@@ -0,0 +1,108 @@
+//#region src/sync-engine/index.d.ts
+/**
+ * Sync Engine
+ *
+ * Core sync logic for the Integration Hub.
+ */
+interface FieldMapping {
+  sourceField: string;
+  targetField: string;
+  mappingType: 'DIRECT' | 'TRANSFORM' | 'LOOKUP' | 'CONSTANT' | 'COMPUTED';
+  transformExpression?: string;
+  lookupConfig?: LookupConfig;
+  constantValue?: unknown;
+  isRequired: boolean;
+  defaultValue?: unknown;
+}
+interface LookupConfig {
+  sourceObject: string;
+  lookupField: string;
+  returnField: string;
+}
+interface SyncConfig {
+  id: string;
+  direction: 'INBOUND' | 'OUTBOUND' | 'BIDIRECTIONAL';
+  sourceObject: string;
+  targetObject: string;
+  fieldMappings: FieldMapping[];
+  createNew: boolean;
+  updateExisting: boolean;
+  deleteRemoved: boolean;
+  sourceFilter?: Record<string, unknown>;
+}
+interface SyncContext {
+  runId: string;
+  config: SyncConfig;
+  connection: {
+    id: string;
+    authType: string;
+    credentials?: Record<string, unknown>;
+  };
+}
+interface SyncResult {
+  success: boolean;
+  recordsProcessed: number;
+  recordsCreated: number;
+  recordsUpdated: number;
+  recordsDeleted: number;
+  recordsFailed: number;
+  recordsSkipped: number;
+  errors: SyncError[];
+}
+interface SyncError {
+  recordId?: string;
+  field?: string;
+  message: string;
+  code: string;
+}
+interface SourceRecord {
+  id: string;
+  data: Record<string, unknown>;
+  checksum?: string;
+}
+interface TargetRecord {
+  id: string;
+  data: Record<string, unknown>;
+  checksum?: string;
+}
+interface ISyncEngine {
+  /**
+   * Execute a sync operation.
+   */
+  sync(context: SyncContext): Promise<SyncResult>;
+  /**
+   * Transform a source record to target format.
+   */
+  transformRecord(sourceRecord: SourceRecord, mappings: FieldMapping[], context: SyncContext): TargetRecord;
+  /**
+   * Validate a transformed record.
+   */
+  validateRecord(record: TargetRecord, mappings: FieldMapping[]): {
+    valid: boolean;
+    errors: SyncError[];
+  };
+}
+interface IFieldTransformer {
+  transform(value: unknown, expression: string): unknown;
+}
+declare class BasicFieldTransformer implements IFieldTransformer {
+  transform(value: unknown, expression: string): unknown;
+}
+declare class BasicSyncEngine implements ISyncEngine {
+  private transformer;
+  constructor(transformer?: IFieldTransformer);
+  sync(context: SyncContext): Promise<SyncResult>;
+  transformRecord(sourceRecord: SourceRecord, mappings: FieldMapping[], _context: SyncContext): TargetRecord;
+  validateRecord(record: TargetRecord, mappings: FieldMapping[]): {
+    valid: boolean;
+    errors: SyncError[];
+  };
+  private getNestedValue;
+  private setNestedValue;
+  private evaluateComputed;
+}
+declare function createSyncEngine(transformer?: IFieldTransformer): ISyncEngine;
+declare function computeChecksum(data: Record<string, unknown>): string;
+declare function hasChanges(sourceChecksum: string | undefined, targetChecksum: string | undefined): boolean;
+//#endregion
+export { BasicFieldTransformer, BasicSyncEngine, FieldMapping, IFieldTransformer, ISyncEngine, LookupConfig, SourceRecord, SyncConfig, SyncContext, SyncError, SyncResult, TargetRecord, computeChecksum, createSyncEngine, hasChanges };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.integration-hub",
-  "version": "0.0.0-canary-20251217054315",
+  "version": "0.0.0-canary-20251217060804",
   "description": "Integration Hub example with sync engine and field mappings for ContractSpec",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,45 +18,45 @@
     "lint:check": "eslint src"
   },
   "dependencies": {
-    "@lssm/lib.schema": "0.0.0-canary-20251217054315",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217054315",
-    "@lssm/lib.bus": "0.0.0-canary-20251217054315",
-    "@lssm/lib.identity-rbac": "0.0.0-canary-20251217054315",
-    "@lssm/lib.files": "0.0.0-canary-20251217054315",
-    "@lssm/lib.feature-flags": "0.0.0-canary-20251217054315",
-    "@lssm/lib.jobs": "0.0.0-canary-20251217054315",
-    "@lssm/module.audit-trail": "0.0.0-canary-20251217054315",
-    "@lssm/module.notifications": "0.0.0-canary-20251217054315",
+    "@lssm/lib.schema": "0.0.0-canary-20251217060804",
+    "@lssm/lib.contracts": "0.0.0-canary-20251217060804",
+    "@lssm/lib.bus": "0.0.0-canary-20251217060804",
+    "@lssm/lib.identity-rbac": "0.0.0-canary-20251217060804",
+    "@lssm/lib.files": "0.0.0-canary-20251217060804",
+    "@lssm/lib.feature-flags": "0.0.0-canary-20251217060804",
+    "@lssm/lib.jobs": "0.0.0-canary-20251217060804",
+    "@lssm/module.audit-trail": "0.0.0-canary-20251217060804",
+    "@lssm/module.notifications": "0.0.0-canary-20251217060804",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.typescript": "0.0.0-canary-20251217054315",
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217054315",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217060804",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217060804",
     "typescript": "^5.9.3"
   },
   "exports": {
-    ".": "./src/index.ts",
-    "./connection": "./src/connection/index.ts",
-    "./connection/connection.contracts": "./src/connection/connection.contracts.ts",
-    "./connection/connection.enum": "./src/connection/connection.enum.ts",
-    "./connection/connection.presentation": "./src/connection/connection.presentation.ts",
-    "./connection/connection.schema": "./src/connection/connection.schema.ts",
-    "./docs": "./src/docs/index.ts",
-    "./docs/integration-hub.docblock": "./src/docs/integration-hub.docblock.ts",
-    "./events": "./src/events.ts",
-    "./example": "./src/example.ts",
-    "./integration": "./src/integration/index.ts",
-    "./integration-hub.feature": "./src/integration-hub.feature.ts",
-    "./integration/integration.contracts": "./src/integration/integration.contracts.ts",
-    "./integration/integration.enum": "./src/integration/integration.enum.ts",
-    "./integration/integration.presentation": "./src/integration/integration.presentation.ts",
-    "./integration/integration.schema": "./src/integration/integration.schema.ts",
-    "./sync": "./src/sync/index.ts",
-    "./sync-engine": "./src/sync-engine/index.ts",
-    "./sync/sync.contracts": "./src/sync/sync.contracts.ts",
-    "./sync/sync.enum": "./src/sync/sync.enum.ts",
-    "./sync/sync.presentation": "./src/sync/sync.presentation.ts",
-    "./sync/sync.schema": "./src/sync/sync.schema.ts",
+    ".": "./dist/index.js",
+    "./connection": "./dist/connection/index.js",
+    "./connection/connection.contracts": "./dist/connection/connection.contracts.js",
+    "./connection/connection.enum": "./dist/connection/connection.enum.js",
+    "./connection/connection.presentation": "./dist/connection/connection.presentation.js",
+    "./connection/connection.schema": "./dist/connection/connection.schema.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/integration-hub.docblock": "./dist/docs/integration-hub.docblock.js",
+    "./events": "./dist/events.js",
+    "./example": "./dist/example.js",
+    "./integration": "./dist/integration/index.js",
+    "./integration-hub.feature": "./dist/integration-hub.feature.js",
+    "./integration/integration.contracts": "./dist/integration/integration.contracts.js",
+    "./integration/integration.enum": "./dist/integration/integration.enum.js",
+    "./integration/integration.presentation": "./dist/integration/integration.presentation.js",
+    "./integration/integration.schema": "./dist/integration/integration.schema.js",
+    "./sync": "./dist/sync/index.js",
+    "./sync-engine": "./dist/sync-engine/index.js",
+    "./sync/sync.contracts": "./dist/sync/sync.contracts.js",
+    "./sync/sync.enum": "./dist/sync/sync.enum.js",
+    "./sync/sync.presentation": "./dist/sync/sync.presentation.js",
+    "./sync/sync.schema": "./dist/sync/sync.schema.js",
     "./*": "./*"
   },
   "module": "./dist/index.js",