@defai.digital/contracts 13.0.3

package/dist/cross-cutting/v1/idempotency.d.ts

@@ -0,0 +1,222 @@
+/**
+ * Idempotency Contract V1
+ *
+ * Provides contracts for preventing duplicate request processing.
+ * Enables safe retries and exactly-once semantics.
+ *
+ * Invariants:
+ * - INV-ID-001: Same idempotency key returns cached response
+ * - INV-ID-002: Different request with same key is rejected (conflict)
+ * - INV-ID-003: Cache entries expire after TTL
+ */
+import { z } from 'zod';
+/**
+ * Idempotency check status
+ */
+export declare const IdempotencyStatusSchema: z.ZodEnum<["new", "cached", "processing", "conflict"]>;
+export type IdempotencyStatus = z.infer<typeof IdempotencyStatusSchema>;
+/**
+ * Idempotency cache entry status
+ */
+export declare const CacheEntryStatusSchema: z.ZodEnum<["processing", "completed", "failed"]>;
+export type CacheEntryStatus = z.infer<typeof CacheEntryStatusSchema>;
+/**
+ * Idempotency cache entry
+ */
+export declare const IdempotencyCacheEntrySchema: z.ZodObject<{
+    /** Idempotency key */
+    key: z.ZodString;
+    /** Hash of original request */
+    requestHash: z.ZodString;
+    /** Cached response (if completed) */
+    response: z.ZodUnknown;
+    /** Entry creation timestamp */
+    createdAt: z.ZodString;
+    /** Entry expiration timestamp */
+    expiresAt: z.ZodString;
+    /** Current status */
+    status: z.ZodEnum<["processing", "completed", "failed"]>;
+    /** Error message if failed */
+    error: z.ZodOptional<z.ZodString>;
+    /** Request metadata */
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** Last update timestamp */
+    updatedAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "completed" | "failed" | "processing";
+    createdAt: string;
+    key: string;
+    expiresAt: string;
+    requestHash: string;
+    metadata?: Record<string, unknown> | undefined;
+    error?: string | undefined;
+    updatedAt?: string | undefined;
+    response?: unknown;
+}, {
+    status: "completed" | "failed" | "processing";
+    createdAt: string;
+    key: string;
+    expiresAt: string;
+    requestHash: string;
+    metadata?: Record<string, unknown> | undefined;
+    error?: string | undefined;
+    updatedAt?: string | undefined;
+    response?: unknown;
+}>;
+export type IdempotencyCacheEntry = z.infer<typeof IdempotencyCacheEntrySchema>;
+/**
+ * Idempotency configuration
+ */
+export declare const IdempotencyConfigSchema: z.ZodObject<{
+    /** Enable idempotency checking */
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    /** TTL for cached responses in seconds */
+    ttlSeconds: z.ZodDefault<z.ZodNumber>;
+    /** Maximum cached entries */
+    maxEntries: z.ZodDefault<z.ZodNumber>;
+    /** Cleanup interval in seconds */
+    cleanupIntervalSeconds: z.ZodDefault<z.ZodNumber>;
+    /** Lock timeout for processing state in ms */
+    lockTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    /** Include request body in hash */
+    hashRequestBody: z.ZodDefault<z.ZodBoolean>;
+    /** Include specific headers in hash */
+    hashHeaders: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    maxEntries: number;
+    ttlSeconds: number;
+    cleanupIntervalSeconds: number;
+    lockTimeoutMs: number;
+    hashRequestBody: boolean;
+    hashHeaders: string[];
+}, {
+    enabled?: boolean | undefined;
+    maxEntries?: number | undefined;
+    ttlSeconds?: number | undefined;
+    cleanupIntervalSeconds?: number | undefined;
+    lockTimeoutMs?: number | undefined;
+    hashRequestBody?: boolean | undefined;
+    hashHeaders?: string[] | undefined;
+}>;
+export type IdempotencyConfig = z.infer<typeof IdempotencyConfigSchema>;
+/**
+ * Idempotency check result
+ */
+export declare const IdempotencyCheckResultSchema: z.ZodObject<{
+    /** Result status */
+    status: z.ZodEnum<["new", "cached", "processing", "conflict"]>;
+    /** Cached response (if status is 'cached') */
+    response: z.ZodOptional<z.ZodUnknown>;
+    /** When response was cached (if cached) */
+    cachedAt: z.ZodOptional<z.ZodString>;
+    /** Error message (if status is 'conflict') */
+    error: z.ZodOptional<z.ZodString>;
+    /** Time until lock expires (if processing) */
+    lockExpiresInMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    status: "cached" | "new" | "processing" | "conflict";
+    error?: string | undefined;
+    response?: unknown;
+    cachedAt?: string | undefined;
+    lockExpiresInMs?: number | undefined;
+}, {
+    status: "cached" | "new" | "processing" | "conflict";
+    error?: string | undefined;
+    response?: unknown;
+    cachedAt?: string | undefined;
+    lockExpiresInMs?: number | undefined;
+}>;
+export type IdempotencyCheckResult = z.infer<typeof IdempotencyCheckResultSchema>;
+/**
+ * Idempotency statistics
+ */
+export declare const IdempotencyStatsSchema: z.ZodObject<{
+    /** Total cached entries */
+    totalEntries: z.ZodNumber;
+    /** Entries by status */
+    byStatus: z.ZodObject<{
+        processing: z.ZodNumber;
+        completed: z.ZodNumber;
+        failed: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        completed: number;
+        failed: number;
+        processing: number;
+    }, {
+        completed: number;
+        failed: number;
+        processing: number;
+    }>;
+    /** Cache hit rate (0-1) */
+    hitRate: z.ZodNumber;
+    /** Total hits */
+    totalHits: z.ZodNumber;
+    /** Total misses */
+    totalMisses: z.ZodNumber;
+    /** Total conflicts */
+    totalConflicts: z.ZodNumber;
+    /** Oldest entry timestamp */
+    oldestEntry: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    totalEntries: number;
+    hitRate: number;
+    byStatus: {
+        completed: number;
+        failed: number;
+        processing: number;
+    };
+    totalHits: number;
+    totalMisses: number;
+    totalConflicts: number;
+    oldestEntry?: string | undefined;
+}, {
+    totalEntries: number;
+    hitRate: number;
+    byStatus: {
+        completed: number;
+        failed: number;
+        processing: number;
+    };
+    totalHits: number;
+    totalMisses: number;
+    totalConflicts: number;
+    oldestEntry?: string | undefined;
+}>;
+export type IdempotencyStats = z.infer<typeof IdempotencyStatsSchema>;
+/**
+ * Idempotency error codes
+ */
+export declare const IdempotencyErrorCodes: {
+    readonly KEY_CONFLICT: "IDEMPOTENCY_KEY_CONFLICT";
+    readonly LOCK_TIMEOUT: "IDEMPOTENCY_LOCK_TIMEOUT";
+    readonly CACHE_FULL: "IDEMPOTENCY_CACHE_FULL";
+    readonly INVALID_KEY: "IDEMPOTENCY_INVALID_KEY";
+    readonly ENTRY_EXPIRED: "IDEMPOTENCY_ENTRY_EXPIRED";
+};
+export type IdempotencyErrorCode = (typeof IdempotencyErrorCodes)[keyof typeof IdempotencyErrorCodes];
+/**
+ * Validates idempotency configuration
+ */
+export declare function validateIdempotencyConfig(data: unknown): IdempotencyConfig;
+/**
+ * Validates idempotency cache entry
+ */
+export declare function validateIdempotencyCacheEntry(data: unknown): IdempotencyCacheEntry;
+/**
+ * Creates default idempotency configuration
+ */
+export declare function createDefaultIdempotencyConfig(): IdempotencyConfig;
+/**
+ * Generates request hash from request data
+ */
+export declare function generateRequestHash(method: string, path: string, body?: unknown, headers?: Record<string, string>): string;
+/**
+ * Calculates expiration timestamp
+ */
+export declare function calculateExpiration(ttlSeconds: number): string;
+/**
+ * Checks if entry is expired
+ */
+export declare function isEntryExpired(entry: IdempotencyCacheEntry): boolean;
+//# sourceMappingURL=idempotency.d.ts.map

package/dist/cross-cutting/v1/idempotency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../../../src/cross-cutting/v1/idempotency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB;;GAEG;AACH,eAAO,MAAM,uBAAuB,wDAKlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,sBAAsB,kDAIjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,2BAA2B;IACtC,sBAAsB;;IAGtB,+BAA+B;;IAG/B,qCAAqC;;IAGrC,+BAA+B;;IAG/B,iCAAiC;;IAGjC,qBAAqB;;IAGrB,8BAA8B;;IAG9B,uBAAuB;;IAGvB,4BAA4B;;;;;;;;;;;;;;;;;;;;;;EAE5B,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,uBAAuB;IAClC,kCAAkC;;IAGlC,0CAA0C;;IAG1C,6BAA6B;;IAG7B,kCAAkC;;IAGlC,8CAA8C;;IAG9C,mCAAmC;;IAGnC,uCAAuC;;;;;;;;;;;;;;;;;;EAEvC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,4BAA4B;IACvC,oBAAoB;;IAGpB,8CAA8C;;IAG9C,2CAA2C;;IAG3C,8CAA8C;;IAG9C,8CAA8C;;;;;;;;;;;;;;EAE9C,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC,2BAA2B;;IAG3B,wBAAwB;;;;;;;;;;;;;;IAOxB,2BAA2B;;IAG3B,iBAAiB;;IAGjB,mBAAmB;;IAGnB,sBAAsB;;IAGtB,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;EAE7B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;CAMxB,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAC9B,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAC;AAErE;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,CAE1E;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,GAAG,qBAAqB,CAElF;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,iBAAiB,CAElE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAgBR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAEpE"}

package/dist/cross-cutting/v1/idempotency.js

@@ -0,0 +1,170 @@
+/**
+ * Idempotency Contract V1
+ *
+ * Provides contracts for preventing duplicate request processing.
+ * Enables safe retries and exactly-once semantics.
+ *
+ * Invariants:
+ * - INV-ID-001: Same idempotency key returns cached response
+ * - INV-ID-002: Different request with same key is rejected (conflict)
+ * - INV-ID-003: Cache entries expire after TTL
+ */
+import { z } from 'zod';
+import { IDEMPOTENCY_TTL_SECONDS, LIMIT_STORE_ENTRIES, CLEANUP_INTERVAL_SECONDS, TIMEOUT_SAGA_DEFAULT, } from '../../constants.js';
+/**
+ * Idempotency check status
+ */
+export const IdempotencyStatusSchema = z.enum([
+    'new', // New request, proceed with processing
+    'cached', // Cached response available
+    'processing', // Request currently being processed
+    'conflict', // Different request with same key
+]);
+/**
+ * Idempotency cache entry status
+ */
+export const CacheEntryStatusSchema = z.enum([
+    'processing', // Request is being processed
+    'completed', // Request completed successfully
+    'failed', // Request failed (allows retry)
+]);
+/**
+ * Idempotency cache entry
+ */
+export const IdempotencyCacheEntrySchema = z.object({
+    /** Idempotency key */
+    key: z.string().uuid(),
+    /** Hash of original request */
+    requestHash: z.string(),
+    /** Cached response (if completed) */
+    response: z.unknown(),
+    /** Entry creation timestamp */
+    createdAt: z.string().datetime(),
+    /** Entry expiration timestamp */
+    expiresAt: z.string().datetime(),
+    /** Current status */
+    status: CacheEntryStatusSchema,
+    /** Error message if failed */
+    error: z.string().optional(),
+    /** Request metadata */
+    metadata: z.record(z.string(), z.unknown()).optional(),
+    /** Last update timestamp */
+    updatedAt: z.string().datetime().optional(),
+});
+/**
+ * Idempotency configuration
+ */
+export const IdempotencyConfigSchema = z.object({
+    /** Enable idempotency checking */
+    enabled: z.boolean().default(true),
+    /** TTL for cached responses in seconds */
+    ttlSeconds: z.number().int().min(60).max(86400).default(IDEMPOTENCY_TTL_SECONDS),
+    /** Maximum cached entries */
+    maxEntries: z.number().int().min(100).max(100000).default(LIMIT_STORE_ENTRIES),
+    /** Cleanup interval in seconds */
+    cleanupIntervalSeconds: z.number().int().min(60).max(3600).default(CLEANUP_INTERVAL_SECONDS),
+    /** Lock timeout for processing state in ms */
+    lockTimeoutMs: z.number().int().min(1000).max(300000).default(TIMEOUT_SAGA_DEFAULT),
+    /** Include request body in hash */
+    hashRequestBody: z.boolean().default(true),
+    /** Include specific headers in hash */
+    hashHeaders: z.array(z.string()).default([]),
+});
+/**
+ * Idempotency check result
+ */
+export const IdempotencyCheckResultSchema = z.object({
+    /** Result status */
+    status: IdempotencyStatusSchema,
+    /** Cached response (if status is 'cached') */
+    response: z.unknown().optional(),
+    /** When response was cached (if cached) */
+    cachedAt: z.string().datetime().optional(),
+    /** Error message (if status is 'conflict') */
+    error: z.string().optional(),
+    /** Time until lock expires (if processing) */
+    lockExpiresInMs: z.number().int().min(0).optional(),
+});
+/**
+ * Idempotency statistics
+ */
+export const IdempotencyStatsSchema = z.object({
+    /** Total cached entries */
+    totalEntries: z.number().int().min(0),
+    /** Entries by status */
+    byStatus: z.object({
+        processing: z.number().int().min(0),
+        completed: z.number().int().min(0),
+        failed: z.number().int().min(0),
+    }),
+    /** Cache hit rate (0-1) */
+    hitRate: z.number().min(0).max(1),
+    /** Total hits */
+    totalHits: z.number().int().min(0),
+    /** Total misses */
+    totalMisses: z.number().int().min(0),
+    /** Total conflicts */
+    totalConflicts: z.number().int().min(0),
+    /** Oldest entry timestamp */
+    oldestEntry: z.string().datetime().optional(),
+});
+/**
+ * Idempotency error codes
+ */
+export const IdempotencyErrorCodes = {
+    KEY_CONFLICT: 'IDEMPOTENCY_KEY_CONFLICT',
+    LOCK_TIMEOUT: 'IDEMPOTENCY_LOCK_TIMEOUT',
+    CACHE_FULL: 'IDEMPOTENCY_CACHE_FULL',
+    INVALID_KEY: 'IDEMPOTENCY_INVALID_KEY',
+    ENTRY_EXPIRED: 'IDEMPOTENCY_ENTRY_EXPIRED',
+};
+/**
+ * Validates idempotency configuration
+ */
+export function validateIdempotencyConfig(data) {
+    return IdempotencyConfigSchema.parse(data);
+}
+/**
+ * Validates idempotency cache entry
+ */
+export function validateIdempotencyCacheEntry(data) {
+    return IdempotencyCacheEntrySchema.parse(data);
+}
+/**
+ * Creates default idempotency configuration
+ */
+export function createDefaultIdempotencyConfig() {
+    return IdempotencyConfigSchema.parse({});
+}
+/**
+ * Generates request hash from request data
+ */
+export function generateRequestHash(method, path, body, headers) {
+    const data = JSON.stringify({
+        method,
+        path,
+        body,
+        headers,
+    });
+    // Simple hash - in production use crypto
+    let hash = 0;
+    for (let i = 0; i < data.length; i++) {
+        const char = data.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash = hash & hash;
+    }
+    return Math.abs(hash).toString(16).padStart(8, '0');
+}
+/**
+ * Calculates expiration timestamp
+ */
+export function calculateExpiration(ttlSeconds) {
+    return new Date(Date.now() + ttlSeconds * 1000).toISOString();
+}
+/**
+ * Checks if entry is expired
+ */
+export function isEntryExpired(entry) {
+    return new Date(entry.expiresAt) < new Date();
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/cross-cutting/v1/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../../../src/cross-cutting/v1/idempotency.ts"],"names":[],"mappings":"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"}

package/dist/cross-cutting/v1/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Cross-Cutting Contracts V1
+ *
+ * Contracts for cross-cutting concerns including:
+ * - Dead Letter Queue (DLQ)
+ * - Saga Pattern
+ * - Data Retention
+ * - Idempotency
+ */
+export { DeadLetterStatusSchema, DeadLetterErrorSchema, DeadLetterEntrySchema, DLQConfigSchema, DLQProcessResultSchema, DLQListOptionsSchema, DLQStatsSchema, DLQErrorCodes, validateDLQConfig, validateDeadLetterEntry, createDefaultDLQConfig, calculateRetryDelay, type DeadLetterStatus, type DeadLetterError, type DeadLetterEntry, type DLQConfig, type DLQProcessResult, type DLQListOptions, type DLQStats, type DLQErrorCode, } from './dead-letter.js';
+export { CompensationActionTypeSchema, CompensationActionSchema, SagaFailureStrategySchema, CompensationOrderSchema, SagaDefinitionSchema, SagaStatusSchema, CompensationErrorSchema, SagaStateSchema, SagaResultSchema, SagaStepSchema, SagaContextSchema, SagaErrorCodes, SAGA_STATE_TRANSITIONS, validateSagaDefinition, validateSagaState, isValidSagaTransition, createInitialSagaState, type CompensationActionType, type CompensationAction, type SagaFailureStrategy, type CompensationOrder, type SagaDefinition, type SagaStatus, type CompensationError, type SagaState, type SagaResult, type SagaStep, type SagaContext, type SagaErrorCode, } from './saga.js';
+export { RetentionDataTypeSchema, RetentionConditionsSchema, RetentionPolicySchema, RetentionRunResultSchema, RetentionSummarySchema, ArchiveEntrySchema, RetentionErrorCodes, validateRetentionPolicy, validateRetentionRunResult, createDefaultRetentionPolicy, calculateRetentionCutoff, type RetentionDataType, type RetentionConditions, type RetentionPolicy, type RetentionRunResult, type RetentionSummary, type ArchiveEntry, type RetentionErrorCode, } from './retention.js';
+export { IdempotencyStatusSchema, CacheEntryStatusSchema, IdempotencyCacheEntrySchema, IdempotencyConfigSchema, IdempotencyCheckResultSchema, IdempotencyStatsSchema, IdempotencyErrorCodes, validateIdempotencyConfig, validateIdempotencyCacheEntry, createDefaultIdempotencyConfig, generateRequestHash, calculateExpiration, isEntryExpired, type IdempotencyStatus, type CacheEntryStatus, type IdempotencyCacheEntry, type IdempotencyConfig, type IdempotencyCheckResult, type IdempotencyStats, type IdempotencyErrorCode, } from './idempotency.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cross-cutting/v1/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cross-cutting/v1/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,YAAY,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,EAC5B,wBAAwB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,EAC5B,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,EAC7B,8BAA8B,EAC9B,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC"}

package/dist/cross-cutting/v1/index.js

@@ -0,0 +1,18 @@
+/**
+ * Cross-Cutting Contracts V1
+ *
+ * Contracts for cross-cutting concerns including:
+ * - Dead Letter Queue (DLQ)
+ * - Saga Pattern
+ * - Data Retention
+ * - Idempotency
+ */
+// Dead Letter Queue
+export { DeadLetterStatusSchema, DeadLetterErrorSchema, DeadLetterEntrySchema, DLQConfigSchema, DLQProcessResultSchema, DLQListOptionsSchema, DLQStatsSchema, DLQErrorCodes, validateDLQConfig, validateDeadLetterEntry, createDefaultDLQConfig, calculateRetryDelay, } from './dead-letter.js';
+// Saga Pattern
+export { CompensationActionTypeSchema, CompensationActionSchema, SagaFailureStrategySchema, CompensationOrderSchema, SagaDefinitionSchema, SagaStatusSchema, CompensationErrorSchema, SagaStateSchema, SagaResultSchema, SagaStepSchema, SagaContextSchema, SagaErrorCodes, SAGA_STATE_TRANSITIONS, validateSagaDefinition, validateSagaState, isValidSagaTransition, createInitialSagaState, } from './saga.js';
+// Data Retention
+export { RetentionDataTypeSchema, RetentionConditionsSchema, RetentionPolicySchema, RetentionRunResultSchema, RetentionSummarySchema, ArchiveEntrySchema, RetentionErrorCodes, validateRetentionPolicy, validateRetentionRunResult, createDefaultRetentionPolicy, calculateRetentionCutoff, } from './retention.js';
+// Idempotency
+export { IdempotencyStatusSchema, CacheEntryStatusSchema, IdempotencyCacheEntrySchema, IdempotencyConfigSchema, IdempotencyCheckResultSchema, IdempotencyStatsSchema, IdempotencyErrorCodes, validateIdempotencyConfig, validateIdempotencyCacheEntry, createDefaultIdempotencyConfig, generateRequestHash, calculateExpiration, isEntryExpired, } from './idempotency.js';
+//# sourceMappingURL=index.js.map

package/dist/cross-cutting/v1/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cross-cutting/v1/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oBAAoB;AACpB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,GASpB,MAAM,kBAAkB,CAAC;AAE1B,eAAe;AACf,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,GAavB,MAAM,WAAW,CAAC;AAEnB,iBAAiB;AACjB,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,EAC5B,wBAAwB,GAQzB,MAAM,gBAAgB,CAAC;AAExB,cAAc;AACd,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,EAC5B,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,EAC7B,8BAA8B,EAC9B,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,GAQf,MAAM,kBAAkB,CAAC"}