@lssm/example.integration-hub 1.41.0 → 1.42.1

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

@@ -0,0 +1,109 @@
+//#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 };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/sync-engine/index.ts"],"sourcesContent":[],"mappings":";;AAQA;AAWA;AAMA;AAYA;AAUiB,UAvCA,YAAA,CA+CP;EAGO,WAAA,EAAS,MAAA;EAOT,WAAA,EAAA,MAAY;EAMZ,WAAA,EAAA,QAAY,GAAA,WAEf,GAAA,QAAA,GAAA,UAAA,GAAA,UAAA;EAMG,mBAAW,CAAA,EAAA,MAAA;EAIZ,YAAA,CAAA,EAtEC,YAsED;EAAsB,aAAA,CAAA,EAAA,OAAA;EAAR,UAAA,EAAA,OAAA;EAMZ,YAAA,CAAA,EAAA,OAAA;;AAEL,UAxEI,YAAA,CAwEJ;EACR,YAAA,EAAA,MAAA;EAMO,WAAA,EAAA,MAAA;EACE,WAAA,EAAA,MAAA;;AAC0B,UA3EvB,UAAA,CA2EuB;EAKvB,EAAA,EAAA,MAAA;EAIJ,SAAA,EAAA,SAAA,GAAA,UAAsB,GAAW,eAAA;EAoDjC,YAAA,EAAA,MAAgB;EAGD,YAAA,EAAA,MAAA;EAIL,aAAA,EA1IN,YA0IM,EAAA;EAAsB,SAAA,EAAA,OAAA;EAAR,cAAA,EAAA,OAAA;EAuBnB,aAAA,EAAA,OAAA;EACJ,YAAA,CAAA,EA9JG,MA8JH,CAAA,MAAA,EAAA,OAAA,CAAA;;AAET,UA7JY,WAAA,CA6JZ;EAgEO,KAAA,EAAA,MAAA;EACE,MAAA,EA5NJ,UA4NI;EACiB,UAAA,EAAA;IAnGS,EAAA,EAAA,MAAA;IAAW,QAAA,EAAA,MAAA;IAoLnC,WAAA,CAAA,EA1SE,MA0Sc,CAAA,MAAe,EAAA,OAAA,CAAA;EAM/B,CAAA;AAahB;UAzTiB,UAAA;;;;;;;;UAQP;;UAGO,SAAA;;;;;;UAOA,YAAA;;QAET;;;UAIS,YAAA;;QAET;;;UAMS,WAAA;;;;gBAID,cAAc,QAAQ;;;;gCAMpB,wBACJ,yBACD,cACR;;;;yBAMO,wBACE;;YACiB;;;UAKd,iBAAA;;;cAIJ,qBAAA,YAAiC;;;cAoDjC,eAAA,YAA2B;;4BAGZ;iBAIL,cAAc,QAAQ;gCAuB3B,wBACJ,0BACA,cACT;yBAgEO,wBACE;;YACiB;;;;;;iBAiFf,gBAAA,eAA+B,oBAAoB;iBAMnD,eAAA,OAAsB;iBAatB,UAAA"}

package/dist/sync-engine/index.js

@@ -1 +1,148 @@
-var e=class{transform(e,t){try{if(t.startsWith(`uppercase`))return typeof e==`string`?e.toUpperCase():e;if(t.startsWith(`lowercase`))return typeof e==`string`?e.toLowerCase():e;if(t.startsWith(`trim`))return typeof e==`string`?e.trim():e;if(t.startsWith(`default:`)){let n=t.replace(`default:`,``);return e??JSON.parse(n)}if(t.startsWith(`concat:`)){let n=t.replace(`concat:`,``)||` `;return Array.isArray(e)?e.join(n):e}if(t.startsWith(`split:`)){let n=t.replace(`split:`,``)||`,`;return typeof e==`string`?e.split(n):e}return t.startsWith(`number`)?Number(e):t.startsWith(`boolean`)?!!e:t.startsWith(`string`)?String(e):e}catch{return e}}},t=class{transformer;constructor(t){this.transformer=t??new e}async sync(e){return{success:!0,recordsProcessed:0,recordsCreated:0,recordsUpdated:0,recordsDeleted:0,recordsFailed:0,recordsSkipped:0,errors:[]}}transformRecord(e,t,n){let r={};for(let n of t){let t;switch(n.mappingType){case`DIRECT`:t=this.getNestedValue(e.data,n.sourceField);break;case`TRANSFORM`:let r=this.getNestedValue(e.data,n.sourceField);t=n.transformExpression?this.transformer.transform(r,n.transformExpression):r;break;case`CONSTANT`:t=n.constantValue;break;case`LOOKUP`:t=this.getNestedValue(e.data,n.sourceField);break;case`COMPUTED`:t=n.transformExpression?this.evaluateComputed(e.data,n.transformExpression):null;break;default:t=this.getNestedValue(e.data,n.sourceField)}t??=n.defaultValue,this.setNestedValue(r,n.targetField,t)}return{id:e.id,data:r}}validateRecord(e,t){let n=[];for(let r of t)r.isRequired&&(this.getNestedValue(e.data,r.targetField)??n.push({recordId:e.id,field:r.targetField,message:`Required field ${r.targetField} is missing`,code:`REQUIRED_FIELD_MISSING`}));return{valid:n.length===0,errors:n}}getNestedValue(e,t){let n=t.split(`.`),r=e;for(let e of n){if(r==null)return;r=r[e]}return r}setNestedValue(e,t,n){let r=t.split(`.`),i=e;for(let e=0;e<r.length-1;e++){let t=r[e];t!==void 0&&(t in i||(i[t]={}),i=i[t])}let a=r[r.length-1];a!==void 0&&(i[a]=n)}evaluateComputed(e,t){try{return t.replace(/\$\{([^}]+)\}/g,(t,n)=>{let r=this.getNestedValue(e,n);return String(r??``)})}catch{return null}}};function n(e){return new t(e)}function r(e){let t=JSON.stringify(e,Object.keys(e).sort()),n=0;for(let e=0;e<t.length;e++){let r=t.charCodeAt(e);n=(n<<5)-n+r,n&=n}return n.toString(16)}function i(e,t){return!e||!t?!0:e!==t}export{e as BasicFieldTransformer,t as BasicSyncEngine,r as computeChecksum,n as createSyncEngine,i as hasChanges};
+//#region src/sync-engine/index.ts
+var BasicFieldTransformer = class {
+	transform(value, expression) {
+		try {
+			if (expression.startsWith("uppercase")) return typeof value === "string" ? value.toUpperCase() : value;
+			if (expression.startsWith("lowercase")) return typeof value === "string" ? value.toLowerCase() : value;
+			if (expression.startsWith("trim")) return typeof value === "string" ? value.trim() : value;
+			if (expression.startsWith("default:")) {
+				const defaultVal = expression.replace("default:", "");
+				return value ?? JSON.parse(defaultVal);
+			}
+			if (expression.startsWith("concat:")) {
+				const separator = expression.replace("concat:", "") || " ";
+				if (Array.isArray(value)) return value.join(separator);
+				return value;
+			}
+			if (expression.startsWith("split:")) {
+				const separator = expression.replace("split:", "") || ",";
+				if (typeof value === "string") return value.split(separator);
+				return value;
+			}
+			if (expression.startsWith("number")) return Number(value);
+			if (expression.startsWith("boolean")) return Boolean(value);
+			if (expression.startsWith("string")) return String(value);
+			return value;
+		} catch {
+			return value;
+		}
+	}
+};
+var BasicSyncEngine = class {
+	transformer;
+	constructor(transformer) {
+		this.transformer = transformer ?? new BasicFieldTransformer();
+	}
+	async sync(_context) {
+		return {
+			success: true,
+			recordsProcessed: 0,
+			recordsCreated: 0,
+			recordsUpdated: 0,
+			recordsDeleted: 0,
+			recordsFailed: 0,
+			recordsSkipped: 0,
+			errors: []
+		};
+	}
+	transformRecord(sourceRecord, mappings, _context) {
+		const targetData = {};
+		for (const mapping of mappings) {
+			let value;
+			let sourceValue;
+			switch (mapping.mappingType) {
+				case "DIRECT":
+					value = this.getNestedValue(sourceRecord.data, mapping.sourceField);
+					break;
+				case "TRANSFORM":
+					sourceValue = this.getNestedValue(sourceRecord.data, mapping.sourceField);
+					value = mapping.transformExpression ? this.transformer.transform(sourceValue, mapping.transformExpression) : sourceValue;
+					break;
+				case "CONSTANT":
+					value = mapping.constantValue;
+					break;
+				case "LOOKUP":
+					value = this.getNestedValue(sourceRecord.data, mapping.sourceField);
+					break;
+				case "COMPUTED":
+					value = mapping.transformExpression ? this.evaluateComputed(sourceRecord.data, mapping.transformExpression) : null;
+					break;
+				default: value = this.getNestedValue(sourceRecord.data, mapping.sourceField);
+			}
+			if (value === void 0 || value === null) value = mapping.defaultValue;
+			this.setNestedValue(targetData, mapping.targetField, value);
+		}
+		return {
+			id: sourceRecord.id,
+			data: targetData
+		};
+	}
+	validateRecord(record, mappings) {
+		const errors = [];
+		for (const mapping of mappings) if (mapping.isRequired) {
+			const value = this.getNestedValue(record.data, mapping.targetField);
+			if (value === void 0 || value === null) errors.push({
+				recordId: record.id,
+				field: mapping.targetField,
+				message: `Required field ${mapping.targetField} is missing`,
+				code: "REQUIRED_FIELD_MISSING"
+			});
+		}
+		return {
+			valid: errors.length === 0,
+			errors
+		};
+	}
+	getNestedValue(obj, path) {
+		const parts = path.split(".");
+		let current = obj;
+		for (const part of parts) {
+			if (current === null || current === void 0) return;
+			current = current[part];
+		}
+		return current;
+	}
+	setNestedValue(obj, path, value) {
+		const parts = path.split(".");
+		let current = obj;
+		for (let i = 0; i < parts.length - 1; i++) {
+			const part = parts[i];
+			if (part === void 0) continue;
+			if (!(part in current)) current[part] = {};
+			current = current[part];
+		}
+		const lastPart = parts[parts.length - 1];
+		if (lastPart !== void 0) current[lastPart] = value;
+	}
+	evaluateComputed(data, expression) {
+		try {
+			return expression.replace(/\$\{([^}]+)\}/g, (_, path) => {
+				const value = this.getNestedValue(data, path);
+				return String(value ?? "");
+			});
+		} catch {
+			return null;
+		}
+	}
+};
+function createSyncEngine(transformer) {
+	return new BasicSyncEngine(transformer);
+}
+function computeChecksum(data) {
+	const str = JSON.stringify(data, Object.keys(data).sort());
+	let hash = 0;
+	for (let i = 0; i < str.length; i++) {
+		const char = str.charCodeAt(i);
+		hash = (hash << 5) - hash + char;
+		hash = hash & hash;
+	}
+	return hash.toString(16);
+}
+function hasChanges(sourceChecksum, targetChecksum) {
+	if (!sourceChecksum || !targetChecksum) return true;
+	return sourceChecksum !== targetChecksum;
+}
+
+//#endregion
+export { BasicFieldTransformer, BasicSyncEngine, computeChecksum, createSyncEngine, hasChanges };
+//# sourceMappingURL=index.js.map

package/dist/sync-engine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["targetData: Record<string, unknown>","value: unknown","sourceValue: unknown","errors: SyncError[]","current: unknown"],"sources":["../../src/sync-engine/index.ts"],"sourcesContent":["/**\n * Sync Engine\n *\n * Core sync logic for the Integration Hub.\n */\n\n// ============ Types ============\n\nexport interface FieldMapping {\n  sourceField: string;\n  targetField: string;\n  mappingType: 'DIRECT' | 'TRANSFORM' | 'LOOKUP' | 'CONSTANT' | 'COMPUTED';\n  transformExpression?: string;\n  lookupConfig?: LookupConfig;\n  constantValue?: unknown;\n  isRequired: boolean;\n  defaultValue?: unknown;\n}\n\nexport interface LookupConfig {\n  sourceObject: string;\n  lookupField: string;\n  returnField: string;\n}\n\nexport interface SyncConfig {\n  id: string;\n  direction: 'INBOUND' | 'OUTBOUND' | 'BIDIRECTIONAL';\n  sourceObject: string;\n  targetObject: string;\n  fieldMappings: FieldMapping[];\n  createNew: boolean;\n  updateExisting: boolean;\n  deleteRemoved: boolean;\n  sourceFilter?: Record<string, unknown>;\n}\n\nexport interface SyncContext {\n  runId: string;\n  config: SyncConfig;\n  connection: {\n    id: string;\n    authType: string;\n    credentials?: Record<string, unknown>;\n  };\n}\n\nexport interface SyncResult {\n  success: boolean;\n  recordsProcessed: number;\n  recordsCreated: number;\n  recordsUpdated: number;\n  recordsDeleted: number;\n  recordsFailed: number;\n  recordsSkipped: number;\n  errors: SyncError[];\n}\n\nexport interface SyncError {\n  recordId?: string;\n  field?: string;\n  message: string;\n  code: string;\n}\n\nexport interface SourceRecord {\n  id: string;\n  data: Record<string, unknown>;\n  checksum?: string;\n}\n\nexport interface TargetRecord {\n  id: string;\n  data: Record<string, unknown>;\n  checksum?: string;\n}\n\n// ============ Sync Engine Interface ============\n\nexport interface ISyncEngine {\n  /**\n   * Execute a sync operation.\n   */\n  sync(context: SyncContext): Promise<SyncResult>;\n\n  /**\n   * Transform a source record to target format.\n   */\n  transformRecord(\n    sourceRecord: SourceRecord,\n    mappings: FieldMapping[],\n    context: SyncContext\n  ): TargetRecord;\n\n  /**\n   * Validate a transformed record.\n   */\n  validateRecord(\n    record: TargetRecord,\n    mappings: FieldMapping[]\n  ): { valid: boolean; errors: SyncError[] };\n}\n\n// ============ Field Transformer ============\n\nexport interface IFieldTransformer {\n  transform(value: unknown, expression: string): unknown;\n}\n\nexport class BasicFieldTransformer implements IFieldTransformer {\n  transform(value: unknown, expression: string): unknown {\n    // Simple expression evaluation\n    // In production, use a proper expression language\n    try {\n      if (expression.startsWith('uppercase')) {\n        return typeof value === 'string' ? value.toUpperCase() : value;\n      }\n      if (expression.startsWith('lowercase')) {\n        return typeof value === 'string' ? value.toLowerCase() : value;\n      }\n      if (expression.startsWith('trim')) {\n        return typeof value === 'string' ? value.trim() : value;\n      }\n      if (expression.startsWith('default:')) {\n        const defaultVal = expression.replace('default:', '');\n        return value ?? JSON.parse(defaultVal);\n      }\n      if (expression.startsWith('concat:')) {\n        const separator = expression.replace('concat:', '') || ' ';\n        if (Array.isArray(value)) {\n          return value.join(separator);\n        }\n        return value;\n      }\n      if (expression.startsWith('split:')) {\n        const separator = expression.replace('split:', '') || ',';\n        if (typeof value === 'string') {\n          return value.split(separator);\n        }\n        return value;\n      }\n      if (expression.startsWith('number')) {\n        return Number(value);\n      }\n      if (expression.startsWith('boolean')) {\n        return Boolean(value);\n      }\n      if (expression.startsWith('string')) {\n        return String(value);\n      }\n\n      // Return as-is if no transformation matches\n      return value;\n    } catch {\n      return value;\n    }\n  }\n}\n\n// ============ Basic Sync Engine ============\n\nexport class BasicSyncEngine implements ISyncEngine {\n  private transformer: IFieldTransformer;\n\n  constructor(transformer?: IFieldTransformer) {\n    this.transformer = transformer ?? new BasicFieldTransformer();\n  }\n\n  async sync(_context: SyncContext): Promise<SyncResult> {\n    const result: SyncResult = {\n      success: true,\n      recordsProcessed: 0,\n      recordsCreated: 0,\n      recordsUpdated: 0,\n      recordsDeleted: 0,\n      recordsFailed: 0,\n      recordsSkipped: 0,\n      errors: [],\n    };\n\n    // In a real implementation, this would:\n    // 1. Fetch records from source\n    // 2. Transform each record\n    // 3. Validate each record\n    // 4. Upsert to target\n    // 5. Track sync records for deduplication\n\n    return result;\n  }\n\n  transformRecord(\n    sourceRecord: SourceRecord,\n    mappings: FieldMapping[],\n    _context: SyncContext\n  ): TargetRecord {\n    const targetData: Record<string, unknown> = {};\n\n    for (const mapping of mappings) {\n      let value: unknown;\n      let sourceValue: unknown;\n\n      switch (mapping.mappingType) {\n        case 'DIRECT':\n          value = this.getNestedValue(sourceRecord.data, mapping.sourceField);\n          break;\n\n        case 'TRANSFORM':\n          sourceValue = this.getNestedValue(\n            sourceRecord.data,\n            mapping.sourceField\n          );\n          value = mapping.transformExpression\n            ? this.transformer.transform(\n                sourceValue,\n                mapping.transformExpression\n              )\n            : sourceValue;\n          break;\n\n        case 'CONSTANT':\n          value = mapping.constantValue;\n          break;\n\n        case 'LOOKUP':\n          // In production, this would fetch from a lookup table\n          value = this.getNestedValue(sourceRecord.data, mapping.sourceField);\n          break;\n\n        case 'COMPUTED':\n          // In production, this would evaluate a computed expression\n          value = mapping.transformExpression\n            ? this.evaluateComputed(\n                sourceRecord.data,\n                mapping.transformExpression\n              )\n            : null;\n          break;\n\n        default:\n          value = this.getNestedValue(sourceRecord.data, mapping.sourceField);\n      }\n\n      // Apply default value if needed\n      if (value === undefined || value === null) {\n        value = mapping.defaultValue;\n      }\n\n      // Set the target field\n      this.setNestedValue(targetData, mapping.targetField, value);\n    }\n\n    return {\n      id: sourceRecord.id,\n      data: targetData,\n    };\n  }\n\n  validateRecord(\n    record: TargetRecord,\n    mappings: FieldMapping[]\n  ): { valid: boolean; errors: SyncError[] } {\n    const errors: SyncError[] = [];\n\n    for (const mapping of mappings) {\n      if (mapping.isRequired) {\n        const value = this.getNestedValue(record.data, mapping.targetField);\n        if (value === undefined || value === null) {\n          errors.push({\n            recordId: record.id,\n            field: mapping.targetField,\n            message: `Required field ${mapping.targetField} is missing`,\n            code: 'REQUIRED_FIELD_MISSING',\n          });\n        }\n      }\n    }\n\n    return {\n      valid: errors.length === 0,\n      errors,\n    };\n  }\n\n  private getNestedValue(obj: Record<string, unknown>, path: string): unknown {\n    const parts = path.split('.');\n    let current: unknown = obj;\n\n    for (const part of parts) {\n      if (current === null || current === undefined) {\n        return undefined;\n      }\n      current = (current as Record<string, unknown>)[part];\n    }\n\n    return current;\n  }\n\n  private setNestedValue(\n    obj: Record<string, unknown>,\n    path: string,\n    value: unknown\n  ): void {\n    const parts = path.split('.');\n    let current = obj;\n\n    for (let i = 0; i < parts.length - 1; i++) {\n      const part = parts[i];\n      if (part === undefined) continue;\n      if (!(part in current)) {\n        current[part] = {};\n      }\n      current = current[part] as Record<string, unknown>;\n    }\n\n    const lastPart = parts[parts.length - 1];\n    if (lastPart !== undefined) {\n      current[lastPart] = value;\n    }\n  }\n\n  private evaluateComputed(\n    data: Record<string, unknown>,\n    expression: string\n  ): unknown {\n    // Simple computed field evaluation\n    // In production, use a proper expression evaluator\n    try {\n      // Support simple field references like ${field.path}\n      const result = expression.replace(/\\$\\{([^}]+)\\}/g, (_, path) => {\n        const value = this.getNestedValue(data, path);\n        return String(value ?? '');\n      });\n      return result;\n    } catch {\n      return null;\n    }\n  }\n}\n\n// ============ Factory ============\n\nexport function createSyncEngine(transformer?: IFieldTransformer): ISyncEngine {\n  return new BasicSyncEngine(transformer);\n}\n\n// ============ Checksum Utilities ============\n\nexport function computeChecksum(data: Record<string, unknown>): string {\n  // Simple checksum based on JSON serialization\n  // In production, use a proper hash function\n  const str = JSON.stringify(data, Object.keys(data).sort());\n  let hash = 0;\n  for (let i = 0; i < str.length; i++) {\n    const char = str.charCodeAt(i);\n    hash = (hash << 5) - hash + char;\n    hash = hash & hash;\n  }\n  return hash.toString(16);\n}\n\nexport function hasChanges(\n  sourceChecksum: string | undefined,\n  targetChecksum: string | undefined\n): boolean {\n  if (!sourceChecksum || !targetChecksum) {\n    return true;\n  }\n  return sourceChecksum !== targetChecksum;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@lssm/example.integration-hub",
-  "version": "1.41.0",
+  "version": "1.42.1",
   "description": "Integration Hub example with sync engine and field mappings for ContractSpec",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "type": "module",
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
-    "build": "bun build:bundle && bun build:types",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
     "build:bundle": "tsdown",
     "build:types": "tsc --noEmit",
     "dev": "bun build:bundle --watch",
@@ -17,45 +18,45 @@
     "lint:check": "eslint src"
   },
   "dependencies": {
-    "@lssm/lib.schema": "workspace:*",
-    "@lssm/lib.contracts": "workspace:*",
-    "@lssm/lib.bus": "workspace:*",
-    "@lssm/lib.identity-rbac": "workspace:*",
-    "@lssm/lib.files": "workspace:*",
-    "@lssm/lib.feature-flags": "workspace:*",
-    "@lssm/lib.jobs": "workspace:*",
-    "@lssm/module.audit-trail": "workspace:*",
-    "@lssm/module.notifications": "workspace:*",
+    "@lssm/lib.schema": "1.42.1",
+    "@lssm/lib.contracts": "1.42.1",
+    "@lssm/lib.bus": "1.42.1",
+    "@lssm/lib.identity-rbac": "1.42.1",
+    "@lssm/lib.files": "1.42.1",
+    "@lssm/lib.feature-flags": "1.42.1",
+    "@lssm/lib.jobs": "1.42.1",
+    "@lssm/module.audit-trail": "1.42.1",
+    "@lssm/module.notifications": "1.42.1",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.typescript": "workspace:*",
-    "@lssm/tool.tsdown": "workspace:*",
+    "@lssm/tool.typescript": "1.42.1",
+    "@lssm/tool.tsdown": "1.42.1",
     "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.enum": "./dist/connection/connection.enum.js",
+    "./connection/connection.operation": "./dist/connection/connection.operation.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.enum": "./dist/integration/integration.enum.js",
+    "./integration/integration.operations": "./dist/integration/integration.operations.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.enum": "./dist/sync/sync.enum.js",
+    "./sync/sync.operations": "./dist/sync/sync.operations.js",
+    "./sync/sync.presentation": "./dist/sync/sync.presentation.js",
+    "./sync/sync.schema": "./dist/sync/sync.schema.js",
     "./*": "./*"
   },
   "module": "./dist/index.js",
@@ -68,7 +69,7 @@
     "exports": {
       ".": "./dist/index.js",
       "./connection": "./dist/connection/index.js",
-      "./connection/connection.contracts": "./dist/connection/connection.contracts.js",
+      "./connection/connection.contracts": "./dist/connection/connection.operations.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",
@@ -78,17 +79,24 @@
       "./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.contracts": "./dist/integration/integration.operations.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.contracts": "./dist/sync/sync.operations.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",
       "./*": "./*"
-    }
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/integration-hub"
   }
 }

package/dist/connection/connection.contracts.js

@@ -1 +0,0 @@
-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};

package/dist/integration/integration.contracts.js

@@ -1 +0,0 @@
-import{CreateIntegrationInputModel as e,IntegrationModel as t}from"./integration.schema.js";import{defineCommand as n}from"@lssm/lib.contracts/spec";const r=n({meta:{name:`integration.create`,version:1,stability:`stable`,owners:[...[`@example.integration-hub`]],tags:[`integration`,`create`],description:`Create a new integration.`,goal:`Allow users to set up integrations with external systems.`,context:`Integration setup.`},io:{input:e,output:t},policy:{auth:`user`},sideEffects:{emits:[{name:`integration.created`,version:1,when:`Integration created`,payload:t}],audit:[`integration.created`]}});export{r as CreateIntegrationContract};

package/dist/sync/sync.contracts.js

@@ -1 +0,0 @@
-import{AddFieldMappingInputModel as e,CreateSyncConfigInputModel as t,FieldMappingModel as n,ListSyncRunsInputModel as r,ListSyncRunsOutputModel as i,SyncConfigModel as a,SyncRunModel as o,TriggerSyncInputModel as s}from"./sync.schema.js";import{defineCommand as c,defineQuery as l}from"@lssm/lib.contracts/spec";const u=[`@example.integration-hub`],d=c({meta:{name:`integration.syncConfig.create`,version:1,stability:`stable`,owners:[...u],tags:[`integration`,`sync`,`config`,`create`],description:`Create a sync configuration.`,goal:`Define how data should be synchronized.`,context:`Sync setup.`},io:{input:t,output:a},policy:{auth:`user`},sideEffects:{emits:[{name:`integration.syncConfig.created`,version:1,when:`Sync config created`,payload:a}],audit:[`integration.syncConfig.created`]}}),f=c({meta:{name:`integration.fieldMapping.add`,version:1,stability:`stable`,owners:[...u],tags:[`integration`,`mapping`,`field`],description:`Add a field mapping to a sync config.`,goal:`Map fields between systems.`,context:`Mapping configuration.`},io:{input:e,output:n},policy:{auth:`user`},sideEffects:{emits:[{name:`integration.fieldMapping.added`,version:1,when:`Mapping added`,payload:n}]}}),p=c({meta:{name:`integration.sync.trigger`,version:1,stability:`stable`,owners:[...u],tags:[`integration`,`sync`,`trigger`],description:`Trigger a manual sync.`,goal:`Start data synchronization.`,context:`Manual sync or webhook trigger.`},io:{input:s,output:o},policy:{auth:`user`},sideEffects:{emits:[{name:`integration.sync.started`,version:1,when:`Sync starts`,payload:o}],audit:[`integration.sync.triggered`]}}),m=l({meta:{name:`integration.syncRun.list`,version:1,stability:`stable`,owners:[...u],tags:[`integration`,`sync`,`run`,`list`],description:`List sync run history.`,goal:`View sync history and status.`,context:`Sync monitoring.`},io:{input:r,output:i},policy:{auth:`user`}});export{f as AddFieldMappingContract,d as CreateSyncConfigContract,m as ListSyncRunsContract,p as TriggerSyncContract};