@lssm/module.audit-trail 0.0.0-canary-20251219202229 → 0.0.0-canary-20251220002821

package/dist/libs/contracts/dist/spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"spec.js","names":[],"sources":["../../../../../../libs/contracts/dist/spec.js"],"sourcesContent":["//#region src/spec.ts\nconst isEmitDeclRef = (e) => \"ref\" in e;\n/**\n* Helper to define a Command (write operation).\n* Sets `kind: 'command'` and defaults `idempotent: false`.\n*/\nconst defineCommand = (spec) => ({\n\t...spec,\n\tmeta: {\n\t\t...spec.meta,\n\t\tkind: \"command\"\n\t},\n\tpolicy: {\n\t\t...spec.policy,\n\t\tidempotent: spec.policy?.[\"policy\"]?.idempotent ?? false\n\t}\n});\n/**\n* Helper to define a Query (read-only operation).\n* Sets `kind: 'query'` and forces `idempotent: true`.\n*/\nconst defineQuery = (spec) => ({\n\t...spec,\n\tmeta: {\n\t\t...spec.meta,\n\t\tkind: \"query\"\n\t},\n\tpolicy: {\n\t\t...spec.policy,\n\t\tidempotent: true\n\t}\n});\n\n//#endregion\nexport { defineCommand, defineQuery, isEmitDeclRef };\n//# sourceMappingURL=spec.js.map"],"mappings":";;;;;AAMA,MAAM,iBAAiB,UAAU;CAChC,GAAG;CACH,MAAM;EACL,GAAG,KAAK;EACR,MAAM;EACN;CACD,QAAQ;EACP,GAAG,KAAK;EACR,YAAY,KAAK,SAAS,WAAW,cAAc;EACnD;CACD;;;;;AAKD,MAAM,eAAe,UAAU;CAC9B,GAAG;CACH,MAAM;EACL,GAAG,KAAK;EACR,MAAM;EACN;CACD,QAAQ;EACP,GAAG,KAAK;EACR,YAAY;EACZ;CACD"}
+{"version":3,"file":"spec.js","names":[],"sources":["../../../../../../libs/contracts/dist/spec.js"],"sourcesContent":["//#region src/spec.ts\nconst isEmitDeclRef = (e) => \"ref\" in e;\n/**\n* Helper to define a Command (write operation).\n* Sets `kind: 'command'` and defaults `idempotent: false`.\n*/\nconst defineCommand = (spec) => ({\n\t...spec,\n\tmeta: {\n\t\t...spec.meta,\n\t\tkind: \"command\"\n\t},\n\tpolicy: {\n\t\t...spec.policy,\n\t\tidempotent: spec.policy?.[\"policy\"]?.idempotent ?? false\n\t}\n});\n/**\n* Helper to define a Query (read-only operation).\n* Sets `kind: 'query'` and forces `idempotent: true`.\n*/\nconst defineQuery = (spec) => ({\n\t...spec,\n\tmeta: {\n\t\t...spec.meta,\n\t\tkind: \"query\"\n\t},\n\tpolicy: {\n\t\t...spec.policy,\n\t\tidempotent: true\n\t}\n});\n\n//#endregion\nexport { defineCommand, defineQuery, isEmitDeclRef };"],"mappings":";;;;;AAMA,MAAM,iBAAiB,UAAU;CAChC,GAAG;CACH,MAAM;EACL,GAAG,KAAK;EACR,MAAM;EACN;CACD,QAAQ;EACP,GAAG,KAAK;EACR,YAAY,KAAK,SAAS,WAAW,cAAc;EACnD;CACD;;;;;AAKD,MAAM,eAAe,UAAU;CAC9B,GAAG;CACH,MAAM;EACL,GAAG,KAAK;EACR,MAAM;EACN;CACD,QAAQ;EACP,GAAG,KAAK;EACR,YAAY;EACZ;CACD"}

package/dist/storage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/storage/index.ts"],"sourcesContent":[],"mappings":";;;;;;AASA;AAWiB,UAXA,yBAAA,SAAkC,iBAWd,CAAA;EAEpB,UAAA,CAAA,EAAA,MAAA;EAAoC,QAAA,CAAA,EAAA,MAAA;EAAR,SAAA,CAAA,EAAA,MAAA;EAG3B,OAAA,CAAA,EAAA,YAAA,GAAA,YAAA;EAAL,QAAA,CAAA,EAAA,KAAA,GAAA,MAAA;;;;;AAKoB,UAVhB,mBAAA,SAA4B,YAUZ,CAAA;EAET;EAAO,KAAA,CAAA,OAAA,EAVd,yBAUc,CAAA,EAVc,OAUd,CAVsB,WAUtB,EAAA,CAAA;EAZc;EAAY,KAAA,CAAA,OAAA,EAK5C,IAL4C,CAKvC,yBALuC,EAAA,OAAA,GAAA,QAAA,CAAA,CAAA,EAMpD,OANoD,CAAA,MAAA,CAAA;EAkB5C;EAGS,OAAA,CAAA,EAAA,EAAA,MAAA,CAAA,EAbC,OAaD,CAbS,WAaT,GAAA,IAAA,CAAA;EAAc;EAIb,YAAA,CAAA,OAAA,EAAA,MAAA,CAAA,EAfU,OAeV,CAfkB,WAelB,EAAA,CAAA;EAAoC;EAAR,eAAA,CAAA,IAAA,EAb3B,IAa2B,CAAA,EAbpB,OAaoB,CAAA,MAAA,CAAA;;;;;AAsEtB,cA7EhB,oBAAA,YAAgC,mBA6EhB,CAAA;EAIkB,QAAA,OAAA;EAAR,KAAA,CAAA,MAAA,EA9EjB,WA8EiB,CAAA,EA9EH,OA8EG,CAAA,IAAA,CAAA;EAIT,KAAA,CAAA,OAAA,EA9EP,yBA8EO,CAAA,EA9EqB,OA8ErB,CA9E6B,WA8E7B,EAAA,CAAA;EAAO,KAAA,CAAA,OAAA,EAdxB,IAcwB,CAdnB,yBAcmB,EAAA,OAAA,GAAA,QAAA,CAAA,CAAA,EAbhC,OAagC,CAAA,MAAA,CAAA;EASzB,OAAA,CAAA,EAAA,EAAA,MAAA,CAAA,EAjBiB,OAiBjB,CAjByB,WAiBzB,GAAA,IAAA,CAAA;EA9FiC,YAAA,CAAA,OAAA,EAAA,MAAA,CAAA,EAiFN,OAjFM,CAiFE,WAjFF,EAAA,CAAA;EAAmB,eAAA,CAAA,IAAA,EAqFlC,IArFkC,CAAA,EAqF3B,OArF2B,CAAA,MAAA,CAAA;EA6G/C;AAYjB;;EAMkB,MAAA,CAAA,CAAA,EAjCN,WAiCM,EAAA;EASI;;;EAU8B,KAAA,CAAA,CAAA,EAAA,IAAA;AAYpD;;;;UAjDiB,qBAAA;;;;;;;;;;;cAYJ,eAAA;;sBAC0B;;;;kBAKrB;;;;sBASI;;;;iBAUC,sBAAsB;;;;;;;iBAY7B,0BAAA,CAAA,GAA8B"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/storage/index.ts"],"sourcesContent":[],"mappings":";;;;;;AASA;AAWiB,UAXA,yBAAA,SAAkC,iBAWd,CAAA;EAEpB,UAAA,CAAA,EAAA,MAAA;EAAoC,QAAA,CAAA,EAAA,MAAA;EAAR,SAAA,CAAA,EAAA,MAAA;EAG3B,OAAA,CAAA,EAAA,YAAA,GAAA,YAAA;EAAL,QAAA,CAAA,EAAA,KAAA,GAAA,MAAA;;;;;AAKoB,UAVhB,mBAAA,SAA4B,YAUZ,CAAA;EAET;EAAO,KAAA,CAAA,OAAA,EAVd,yBAUc,CAAA,EAVc,OAUd,CAVsB,WAUtB,EAAA,CAAA;EAZc;EAAY,KAAA,CAAA,OAAA,EAK5C,IAL4C,CAKvC,yBALuC,EAAA,OAAA,GAAA,QAAA,CAAA,CAAA,EAMpD,OANoD,CAAA,MAAA,CAAA;EAkB5C;EAGS,OAAA,CAAA,EAAA,EAAA,MAAA,CAAA,EAbC,OAaD,CAbS,WAaT,GAAA,IAAA,CAAA;EAAc;EAIb,YAAA,CAAA,OAAA,EAAA,MAAA,CAAA,EAfU,OAeV,CAfkB,WAelB,EAAA,CAAA;EAAoC;EAAR,eAAA,CAAA,IAAA,EAb3B,IAa2B,CAAA,EAbpB,OAaoB,CAAA,MAAA,CAAA;;;;;AAwEtB,cA/EhB,oBAAA,YAAgC,mBA+EhB,CAAA;EAIkB,QAAA,OAAA;EAAR,KAAA,CAAA,MAAA,EAhFjB,WAgFiB,CAAA,EAhFH,OAgFG,CAAA,IAAA,CAAA;EAIT,KAAA,CAAA,OAAA,EAhFP,yBAgFO,CAAA,EAhFqB,OAgFrB,CAhF6B,WAgF7B,EAAA,CAAA;EAAO,KAAA,CAAA,OAAA,EAdxB,IAcwB,CAdnB,yBAcmB,EAAA,OAAA,GAAA,QAAA,CAAA,CAAA,EAbhC,OAagC,CAAA,MAAA,CAAA;EASzB,OAAA,CAAA,EAAA,EAAA,MAAA,CAAA,EAjBiB,OAiBjB,CAjByB,WAiBzB,GAAA,IAAA,CAAA;EAhGiC,YAAA,CAAA,OAAA,EAAA,MAAA,CAAA,EAmFN,OAnFM,CAmFE,WAnFF,EAAA,CAAA;EAAmB,eAAA,CAAA,IAAA,EAuFlC,IAvFkC,CAAA,EAuF3B,OAvF2B,CAAA,MAAA,CAAA;EA+G/C;AAYjB;;EAMkB,MAAA,CAAA,CAAA,EAjCN,WAiCM,EAAA;EASI;;;EAU8B,KAAA,CAAA,CAAA,EAAA,IAAA;AAYpD;;;;UAjDiB,qBAAA;;;;;;;;;;;cAYJ,eAAA;;sBAC0B;;;;kBAKrB;;;;sBASI;;;;iBAUC,sBAAsB;;;;;;;iBAY7B,0BAAA,CAAA,GAA8B"}

package/dist/storage/index.js

@@ -19,8 +19,14 @@ var InMemoryAuditStorage = class {
 		if (options.targetType) results = results.filter((r) => r.metadata?.targetType === options.targetType);
 		if (options.orgId) results = results.filter((r) => r.metadata?.orgId === options.orgId);
 		if (options.traceId) results = results.filter((r) => r.traceId === options.traceId);
-		if (options.from) results = results.filter((r) => new Date(r.occurredAt) >= options.from);
-		if (options.to) results = results.filter((r) => new Date(r.occurredAt) <= options.to);
+		if (options.from) {
+			const fromDate = options.from;
+			results = results.filter((r) => new Date(r.occurredAt) >= fromDate);
+		}
+		if (options.to) {
+			const toDate = options.to;
+			results = results.filter((r) => new Date(r.occurredAt) <= toDate);
+		}
 		const orderBy = options.orderBy ?? "occurredAt";
 		const orderDir = options.orderDir ?? "desc";
 		results.sort((a, b) => {

package/dist/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["config: RetentionPolicyConfig"],"sources":["../../src/storage/index.ts"],"sourcesContent":["import type {\n  AuditRecord,\n  AuditQueryOptions,\n  AuditStorage,\n} from '@lssm/lib.bus';\n\n/**\n * Extended query options for audit storage.\n */\nexport interface ExtendedAuditQueryOptions extends AuditQueryOptions {\n  targetType?: string;\n  clientIp?: string;\n  sessionId?: string;\n  orderBy?: 'occurredAt' | 'recordedAt';\n  orderDir?: 'asc' | 'desc';\n}\n\n/**\n * Audit storage adapter interface with extended capabilities.\n */\nexport interface AuditStorageAdapter extends AuditStorage {\n  /** Query audit records with extended options */\n  query(options: ExtendedAuditQueryOptions): Promise<AuditRecord[]>;\n  /** Count matching records */\n  count(\n    options: Omit<ExtendedAuditQueryOptions, 'limit' | 'offset'>\n  ): Promise<number>;\n  /** Get a single record by ID */\n  getById(id: string): Promise<AuditRecord | null>;\n  /** Get all records for a trace */\n  getByTraceId(traceId: string): Promise<AuditRecord[]>;\n  /** Delete old records (for retention) */\n  deleteOlderThan(date: Date): Promise<number>;\n}\n\n/**\n * In-memory audit storage for development/testing.\n */\nexport class InMemoryAuditStorage implements AuditStorageAdapter {\n  private records: AuditRecord[] = [];\n\n  async store(record: AuditRecord): Promise<void> {\n    this.records.push(record);\n  }\n\n  async query(options: ExtendedAuditQueryOptions): Promise<AuditRecord[]> {\n    let results = [...this.records];\n\n    // Apply filters\n    if (options.eventName) {\n      const pattern = options.eventName.replace(/\\*/g, '.*');\n      const regex = new RegExp(`^${pattern}$`);\n      results = results.filter((r) => regex.test(r.eventName));\n    }\n\n    if (options.actorId) {\n      results = results.filter((r) => r.metadata?.actorId === options.actorId);\n    }\n\n    if (options.targetId) {\n      results = results.filter(\n        (r) => r.metadata?.targetId === options.targetId\n      );\n    }\n\n    if (options.targetType) {\n      results = results.filter(\n        (r) => r.metadata?.targetType === options.targetType\n      );\n    }\n\n    if (options.orgId) {\n      results = results.filter((r) => r.metadata?.orgId === options.orgId);\n    }\n\n    if (options.traceId) {\n      results = results.filter((r) => r.traceId === options.traceId);\n    }\n\n    if (options.from) {\n      results = results.filter((r) => new Date(r.occurredAt) >= options.from!);\n    }\n\n    if (options.to) {\n      results = results.filter((r) => new Date(r.occurredAt) <= options.to!);\n    }\n\n    // Sort\n    const orderBy = options.orderBy ?? 'occurredAt';\n    const orderDir = options.orderDir ?? 'desc';\n    results.sort((a, b) => {\n      const aTime =\n        orderBy === 'occurredAt'\n          ? new Date(a.occurredAt).getTime()\n          : a.recordedAt.getTime();\n      const bTime =\n        orderBy === 'occurredAt'\n          ? new Date(b.occurredAt).getTime()\n          : b.recordedAt.getTime();\n      return orderDir === 'desc' ? bTime - aTime : aTime - bTime;\n    });\n\n    // Paginate\n    const offset = options.offset ?? 0;\n    const limit = options.limit ?? 100;\n    return results.slice(offset, offset + limit);\n  }\n\n  async count(\n    options: Omit<ExtendedAuditQueryOptions, 'limit' | 'offset'>\n  ): Promise<number> {\n    const results = await this.query({ ...options, limit: Infinity });\n    return results.length;\n  }\n\n  async getById(id: string): Promise<AuditRecord | null> {\n    return this.records.find((r) => r.id === id) ?? null;\n  }\n\n  async getByTraceId(traceId: string): Promise<AuditRecord[]> {\n    return this.query({ traceId });\n  }\n\n  async deleteOlderThan(date: Date): Promise<number> {\n    const before = this.records.length;\n    this.records = this.records.filter((r) => new Date(r.occurredAt) >= date);\n    return before - this.records.length;\n  }\n\n  /**\n   * Get all records (for testing).\n   */\n  getAll(): AuditRecord[] {\n    return [...this.records];\n  }\n\n  /**\n   * Clear all records (for testing).\n   */\n  clear(): void {\n    this.records = [];\n  }\n}\n\n/**\n * Retention policy configuration.\n */\nexport interface RetentionPolicyConfig {\n  /** Days to keep detailed logs */\n  hotRetentionDays: number;\n  /** Days to keep archived logs (for compliance) */\n  archiveRetentionDays?: number;\n  /** Cron expression for cleanup schedule */\n  cleanupSchedule?: string;\n}\n\n/**\n * Retention policy manager.\n */\nexport class RetentionPolicy {\n  constructor(private readonly config: RetentionPolicyConfig) {}\n\n  /**\n   * Get the cutoff date for hot storage.\n   */\n  getHotCutoff(): Date {\n    const cutoff = new Date();\n    cutoff.setDate(cutoff.getDate() - this.config.hotRetentionDays);\n    return cutoff;\n  }\n\n  /**\n   * Get the cutoff date for archive storage.\n   */\n  getArchiveCutoff(): Date | null {\n    if (!this.config.archiveRetentionDays) return null;\n    const cutoff = new Date();\n    cutoff.setDate(cutoff.getDate() - this.config.archiveRetentionDays);\n    return cutoff;\n  }\n\n  /**\n   * Apply retention policy to storage.\n   */\n  async apply(storage: AuditStorageAdapter): Promise<{\n    deletedCount: number;\n  }> {\n    const cutoff = this.getHotCutoff();\n    const deletedCount = await storage.deleteOlderThan(cutoff);\n    return { deletedCount };\n  }\n}\n\n/**\n * Create an in-memory audit storage.\n */\nexport function createInMemoryAuditStorage(): InMemoryAuditStorage {\n  return new InMemoryAuditStorage();\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["config: RetentionPolicyConfig"],"sources":["../../src/storage/index.ts"],"sourcesContent":["import type {\n  AuditRecord,\n  AuditQueryOptions,\n  AuditStorage,\n} from '@lssm/lib.bus';\n\n/**\n * Extended query options for audit storage.\n */\nexport interface ExtendedAuditQueryOptions extends AuditQueryOptions {\n  targetType?: string;\n  clientIp?: string;\n  sessionId?: string;\n  orderBy?: 'occurredAt' | 'recordedAt';\n  orderDir?: 'asc' | 'desc';\n}\n\n/**\n * Audit storage adapter interface with extended capabilities.\n */\nexport interface AuditStorageAdapter extends AuditStorage {\n  /** Query audit records with extended options */\n  query(options: ExtendedAuditQueryOptions): Promise<AuditRecord[]>;\n  /** Count matching records */\n  count(\n    options: Omit<ExtendedAuditQueryOptions, 'limit' | 'offset'>\n  ): Promise<number>;\n  /** Get a single record by ID */\n  getById(id: string): Promise<AuditRecord | null>;\n  /** Get all records for a trace */\n  getByTraceId(traceId: string): Promise<AuditRecord[]>;\n  /** Delete old records (for retention) */\n  deleteOlderThan(date: Date): Promise<number>;\n}\n\n/**\n * In-memory audit storage for development/testing.\n */\nexport class InMemoryAuditStorage implements AuditStorageAdapter {\n  private records: AuditRecord[] = [];\n\n  async store(record: AuditRecord): Promise<void> {\n    this.records.push(record);\n  }\n\n  async query(options: ExtendedAuditQueryOptions): Promise<AuditRecord[]> {\n    let results = [...this.records];\n\n    // Apply filters\n    if (options.eventName) {\n      const pattern = options.eventName.replace(/\\*/g, '.*');\n      const regex = new RegExp(`^${pattern}$`);\n      results = results.filter((r) => regex.test(r.eventName));\n    }\n\n    if (options.actorId) {\n      results = results.filter((r) => r.metadata?.actorId === options.actorId);\n    }\n\n    if (options.targetId) {\n      results = results.filter(\n        (r) => r.metadata?.targetId === options.targetId\n      );\n    }\n\n    if (options.targetType) {\n      results = results.filter(\n        (r) => r.metadata?.targetType === options.targetType\n      );\n    }\n\n    if (options.orgId) {\n      results = results.filter((r) => r.metadata?.orgId === options.orgId);\n    }\n\n    if (options.traceId) {\n      results = results.filter((r) => r.traceId === options.traceId);\n    }\n\n    if (options.from) {\n      const fromDate = options.from;\n      results = results.filter((r) => new Date(r.occurredAt) >= fromDate);\n    }\n\n    if (options.to) {\n      const toDate = options.to;\n      results = results.filter((r) => new Date(r.occurredAt) <= toDate);\n    }\n\n    // Sort\n    const orderBy = options.orderBy ?? 'occurredAt';\n    const orderDir = options.orderDir ?? 'desc';\n    results.sort((a, b) => {\n      const aTime =\n        orderBy === 'occurredAt'\n          ? new Date(a.occurredAt).getTime()\n          : a.recordedAt.getTime();\n      const bTime =\n        orderBy === 'occurredAt'\n          ? new Date(b.occurredAt).getTime()\n          : b.recordedAt.getTime();\n      return orderDir === 'desc' ? bTime - aTime : aTime - bTime;\n    });\n\n    // Paginate\n    const offset = options.offset ?? 0;\n    const limit = options.limit ?? 100;\n    return results.slice(offset, offset + limit);\n  }\n\n  async count(\n    options: Omit<ExtendedAuditQueryOptions, 'limit' | 'offset'>\n  ): Promise<number> {\n    const results = await this.query({ ...options, limit: Infinity });\n    return results.length;\n  }\n\n  async getById(id: string): Promise<AuditRecord | null> {\n    return this.records.find((r) => r.id === id) ?? null;\n  }\n\n  async getByTraceId(traceId: string): Promise<AuditRecord[]> {\n    return this.query({ traceId });\n  }\n\n  async deleteOlderThan(date: Date): Promise<number> {\n    const before = this.records.length;\n    this.records = this.records.filter((r) => new Date(r.occurredAt) >= date);\n    return before - this.records.length;\n  }\n\n  /**\n   * Get all records (for testing).\n   */\n  getAll(): AuditRecord[] {\n    return [...this.records];\n  }\n\n  /**\n   * Clear all records (for testing).\n   */\n  clear(): void {\n    this.records = [];\n  }\n}\n\n/**\n * Retention policy configuration.\n */\nexport interface RetentionPolicyConfig {\n  /** Days to keep detailed logs */\n  hotRetentionDays: number;\n  /** Days to keep archived logs (for compliance) */\n  archiveRetentionDays?: number;\n  /** Cron expression for cleanup schedule */\n  cleanupSchedule?: string;\n}\n\n/**\n * Retention policy manager.\n */\nexport class RetentionPolicy {\n  constructor(private readonly config: RetentionPolicyConfig) {}\n\n  /**\n   * Get the cutoff date for hot storage.\n   */\n  getHotCutoff(): Date {\n    const cutoff = new Date();\n    cutoff.setDate(cutoff.getDate() - this.config.hotRetentionDays);\n    return cutoff;\n  }\n\n  /**\n   * Get the cutoff date for archive storage.\n   */\n  getArchiveCutoff(): Date | null {\n    if (!this.config.archiveRetentionDays) return null;\n    const cutoff = new Date();\n    cutoff.setDate(cutoff.getDate() - this.config.archiveRetentionDays);\n    return cutoff;\n  }\n\n  /**\n   * Apply retention policy to storage.\n   */\n  async apply(storage: AuditStorageAdapter): Promise<{\n    deletedCount: number;\n  }> {\n    const cutoff = this.getHotCutoff();\n    const deletedCount = await storage.deleteOlderThan(cutoff);\n    return { deletedCount };\n  }\n}\n\n/**\n * Create an in-memory audit storage.\n */\nexport function createInMemoryAuditStorage(): InMemoryAuditStorage {\n  return new InMemoryAuditStorage();\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/module.audit-trail",
-  "version": "0.0.0-canary-20251219202229",
+  "version": "0.0.0-canary-20251220002821",
   "description": "Audit trail module for tracking and querying system events",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,14 +18,14 @@
     "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.schema": "0.0.0-canary-20251220002821",
+    "@lssm/lib.contracts": "0.0.0-canary-20251220002821",
+    "@lssm/lib.bus": "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": {
@@ -50,7 +50,13 @@
       "./entities": "./dist/entities/index.js",
       "./storage": "./dist/storage/index.js",
       "./*": "./*"
-    }
+    },
+    "registry": "https://registry.npmjs.org/"
   },
-  "license": "MIT"
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/modules/audit-trail"
+  }
 }