@lssm/example.integration-hub 0.0.0-canary-20251219202229 → 0.0.0-canary-20251220002821

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

@@ -1 +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;EAIN,aAAA,EA1IL,YA0IK,EAAA;EAAsB,SAAA,EAAA,OAAA;EAAR,cAAA,EAAA,OAAA;EAuBlB,aAAA,EAAA,OAAA;EACJ,YAAA,CAAA,EA9JG,MA8JH,CAAA,MAAA,EAAA,OAAA,CAAA;;AAET,UA7JY,WAAA,CA6JZ;EA+DO,KAAA,EAAA,MAAA;EACE,MAAA,EA3NJ,UA2NI;EACiB,UAAA,EAAA;IAlGS,EAAA,EAAA,MAAA;IAAW,QAAA,EAAA,MAAA;IAmLnC,WAAA,CAAA,EAzSE,MAySc,CAAA,MAAe,EAAA,OAAA,CAAA;EAM/B,CAAA;AAahB;UAxTiB,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;gBAIN,cAAc,QAAQ;gCAuB1B,wBACJ,0BACA,cACT;yBA+DO,wBACE;;YACiB;;;;;;iBAiFf,gBAAA,eAA+B,oBAAoB;iBAMnD,eAAA,OAAsB;iBAatB,UAAA"}
+{"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

@@ -33,7 +33,7 @@ var BasicSyncEngine = class {
 	constructor(transformer) {
 		this.transformer = transformer ?? new BasicFieldTransformer();
 	}
-	async sync(context) {
+	async sync(_context) {
 		return {
 			success: true,
 			recordsProcessed: 0,
@@ -49,12 +49,13 @@ var BasicSyncEngine = class {
 		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":
-					const sourceValue = this.getNestedValue(sourceRecord.data, mapping.sourceField);
+					sourceValue = this.getNestedValue(sourceRecord.data, mapping.sourceField);
 					value = mapping.transformExpression ? this.transformer.transform(sourceValue, mapping.transformExpression) : sourceValue;
 					break;
 				case "CONSTANT":

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["targetData: Record<string, unknown>","value: 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\n      switch (mapping.mappingType) {\n        case 'DIRECT':\n          value = this.getNestedValue(sourceRecord.data, mapping.sourceField);\n          break;\n\n        case 'TRANSFORM':\n          const 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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"}
+{"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,6 +1,6 @@
 {
   "name": "@lssm/example.integration-hub",
-  "version": "0.0.0-canary-20251219202229",
+  "version": "0.0.0-canary-20251220002821",
   "description": "Integration Hub example with sync engine and field mappings for ContractSpec",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,20 +18,20 @@
     "lint:check": "eslint src"
   },
   "dependencies": {
-    "@lssm/lib.schema": "0.0.0-canary-20251219202229",
-    "@lssm/lib.contracts": "0.0.0-canary-20251219202229",
-    "@lssm/lib.bus": "0.0.0-canary-20251219202229",
-    "@lssm/lib.identity-rbac": "0.0.0-canary-20251219202229",
-    "@lssm/lib.files": "0.0.0-canary-20251219202229",
-    "@lssm/lib.feature-flags": "0.0.0-canary-20251219202229",
-    "@lssm/lib.jobs": "0.0.0-canary-20251219202229",
-    "@lssm/module.audit-trail": "0.0.0-canary-20251219202229",
-    "@lssm/module.notifications": "0.0.0-canary-20251219202229",
+    "@lssm/lib.schema": "0.0.0-canary-20251220002821",
+    "@lssm/lib.contracts": "0.0.0-canary-20251220002821",
+    "@lssm/lib.bus": "0.0.0-canary-20251220002821",
+    "@lssm/lib.identity-rbac": "0.0.0-canary-20251220002821",
+    "@lssm/lib.files": "0.0.0-canary-20251220002821",
+    "@lssm/lib.feature-flags": "0.0.0-canary-20251220002821",
+    "@lssm/lib.jobs": "0.0.0-canary-20251220002821",
+    "@lssm/module.audit-trail": "0.0.0-canary-20251220002821",
+    "@lssm/module.notifications": "0.0.0-canary-20251220002821",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.typescript": "0.0.0-canary-20251219202229",
-    "@lssm/tool.tsdown": "0.0.0-canary-20251219202229",
+    "@lssm/tool.typescript": "0.0.0-canary-20251220002821",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251220002821",
     "typescript": "^5.9.3"
   },
   "exports": {
@@ -90,7 +90,13 @@
       "./sync/sync.presentation": "./dist/sync/sync.presentation.js",
       "./sync/sync.schema": "./dist/sync/sync.schema.js",
       "./*": "./*"
-    }
+    },
+    "registry": "https://registry.npmjs.org/"
   },
-  "license": "MIT"
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/integration-hub"
+  }
 }