@lindorm/iris 0.4.3 → 0.5.0

package/dist/internal/message/metadata/validate-headers.js

@@ -18,22 +18,34 @@ export const validateHeaders = (targetName, headers, fields) => {
         const field = fieldMap.get(header.key);
         if (!field) {
             throw new IrisMetadataError(`@Header on property "${header.key}" requires a @Field decorator`, {
+                code: "header_without_field",
+                title: "Header Without Field",
+                details: "A @Header decorator was applied to a property that has no @Field decorator. Add a @Field decorator to the property.",
                 debug: { target: targetName, property: header.key },
             });
         }
         if (field.type === "array" || field.type === "object") {
             throw new IrisMetadataError(`@Header cannot be used on array or object fields (field "${field.key}" has type "${field.type}")`, {
+                code: "header_unsupported_field_type",
+                title: "Header Unsupported Field Type",
+                details: "A @Header was applied to a field whose type is array or object. Headers may only be used on scalar field types.",
                 debug: { target: targetName, property: field.key, type: field.type },
             });
         }
         if (field.transform != null) {
             throw new IrisMetadataError(`@Header and @Transform cannot be used on the same field "${field.key}"`, {
+                code: "header_transform_conflict",
+                title: "Header Transform Conflict",
+                details: "A field uses both @Header and @Transform, which is not allowed. Remove one of the two decorators from the field.",
                 debug: { target: targetName, property: field.key },
             });
         }
         const normalised = header.headerName.toLowerCase();
         if (normalised.startsWith("x-iris-")) {
             throw new IrisMetadataError(`Header name '${header.headerName}' uses reserved 'x-iris-' prefix`, {
+                code: "reserved_header_prefix",
+                title: "Reserved Header Prefix",
+                details: "A custom header name uses the reserved 'x-iris-' prefix, which is owned by the transport layer. Choose a different header name.",
                 debug: {
                     target: targetName,
                     property: header.key,
@@ -43,6 +55,9 @@ export const validateHeaders = (targetName, headers, fields) => {
         }
         if (RESERVED_TRANSPORT_HEADERS.has(normalised)) {
             throw new IrisMetadataError(`Header name '${header.headerName}' conflicts with reserved transport header`, {
+                code: "reserved_transport_header",
+                title: "Reserved Transport Header",
+                details: "A custom header name collides with a reserved transport header such as content-type or message-id. Choose a different header name.",
                 debug: {
                     target: targetName,
                     property: header.key,
@@ -52,6 +67,9 @@ export const validateHeaders = (targetName, headers, fields) => {
         }
         if (seenHeaderNames.has(normalised)) {
             throw new IrisMetadataError("Duplicate header name", {
+                code: "duplicate_header_name",
+                title: "Duplicate Header Name",
+                details: "Two @Header decorators map to the same header name (case-insensitive). Give each header a unique name.",
                 debug: { target: targetName, headerName: header.headerName },
             });
         }

package/dist/internal/message/metadata/validate-headers.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-headers.js","sourceRoot":"","sources":["../../../../src/internal/message/metadata/validate-headers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validate-headers.js","sourceRoot":"","sources":["../../../../src/internal/message/metadata/validate-headers.ts"],"names":[],"mappings":"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"}

package/dist/internal/message/utils/build-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-schema.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/build-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAsD5D,eAAO,MAAM,WAAW,GAAI,UAAU,eAAe,KAAG,CAAC,CAAC,OAmDzD,CAAC"}
+{"version":3,"file":"build-schema.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/build-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AA6D5D,eAAO,MAAM,WAAW,GAAI,UAAU,eAAe,KAAG,CAAC,CAAC,OAmDzD,CAAC"}

package/dist/internal/message/utils/build-schema.js

@@ -21,7 +21,12 @@ const getValidator = (field) => {
             return z.url();
         case "enum":
             if (!field.enum) {
-                throw new IrisSerializationError(`Field "${field.key}" has type "enum" but no enum values provided`);
+                throw new IrisSerializationError(`Field "${field.key}" has type "enum" but no enum values provided`, {
+                    code: "missing_enum_values",
+                    title: "Missing Enum Values",
+                    details: "The named field is declared with type enum but no enum values were provided. Supply the enum object via the field decorator.",
+                    data: { field: field.key },
+                });
             }
             return z.nativeEnum(field.enum);
         case "date":

package/dist/internal/message/utils/build-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"build-schema.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/build-schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"build-schema.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/build-schema.ts"],"names":[],"mappings":"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"}

package/dist/internal/message/utils/compress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/compress.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAS9E,eAAO,MAAM,QAAQ,GACnB,MAAM,MAAM,EACZ,WAAW,wBAAwB,KAClC,OAAO,CAAC,MAAM,CAahB,CAAC;AAEF,eAAO,MAAM,UAAU,GACrB,MAAM,MAAM,EACZ,WAAW,wBAAwB,KAClC,OAAO,CAAC,MAAM,CAahB,CAAC"}
+{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/compress.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAS9E,eAAO,MAAM,QAAQ,GACnB,MAAM,MAAM,EACZ,WAAW,wBAAwB,KAClC,OAAO,CAAC,MAAM,CAoBhB,CAAC;AAEF,eAAO,MAAM,UAAU,GACrB,MAAM,MAAM,EACZ,WAAW,wBAAwB,KAClC,OAAO,CAAC,MAAM,CAoBhB,CAAC"}

package/dist/internal/message/utils/compress.js

@@ -16,7 +16,12 @@ export const compress = async (data, algorithm) => {
         case "brotli":
             return brotliCompressAsync(data);
         default:
-            throw new IrisSerializationError(`Unsupported compression algorithm: ${String(algorithm)}`);
+            throw new IrisSerializationError(`Unsupported compression algorithm: ${String(algorithm)}`, {
+                code: "unsupported_compression_algorithm",
+                title: "Unsupported Compression Algorithm",
+                details: "The requested compression algorithm is not supported. Use one of: gzip, deflate, or brotli.",
+                data: { algorithm },
+            });
     }
 };
 export const decompress = async (data, algorithm) => {
@@ -28,7 +33,12 @@ export const decompress = async (data, algorithm) => {
         case "brotli":
             return brotliDecompressAsync(data);
         default:
-            throw new IrisSerializationError(`Unsupported decompression algorithm: ${String(algorithm)}`);
+            throw new IrisSerializationError(`Unsupported decompression algorithm: ${String(algorithm)}`, {
+                code: "unsupported_decompression_algorithm",
+                title: "Unsupported Decompression Algorithm",
+                details: "The requested decompression algorithm is not supported. Use one of: gzip, deflate, or brotli.",
+                data: { algorithm },
+            });
     }
 };
 //# sourceMappingURL=compress.js.map

package/dist/internal/message/utils/compress.js.map

@@ -1 +1 @@
-{"version":3,"file":"compress.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/compress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,OAAO,EACP,IAAI,EACJ,MAAM,EACN,OAAO,GACR,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAGnF,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAClC,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AACtC,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;AACxC,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;AACxC,MAAM,mBAAmB,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;AACtD,MAAM,qBAAqB,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAC3B,IAAY,EACZ,SAAmC,EAClB,EAAE;IACnB,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,KAAK,QAAQ;YACX,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACnC;YACE,MAAM,IAAI,sBAAsB,CAC9B,sCAAsC,MAAM,CAAC,SAAS,CAAC,EAAE,CAC1D,CAAC;IACN,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAC7B,IAAY,EACZ,SAAmC,EAClB,EAAE;IACnB,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3B,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,KAAK,QAAQ;YACX,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACrC;YACE,MAAM,IAAI,sBAAsB,CAC9B,wCAAwC,MAAM,CAAC,SAAS,CAAC,EAAE,CAC5D,CAAC;IACN,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"compress.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/compress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,OAAO,EACP,IAAI,EACJ,MAAM,EACN,OAAO,GACR,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAGnF,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAClC,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AACtC,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;AACxC,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;AACxC,MAAM,mBAAmB,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;AACtD,MAAM,qBAAqB,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAC3B,IAAY,EACZ,SAAmC,EAClB,EAAE;IACnB,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,KAAK,QAAQ;YACX,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACnC;YACE,MAAM,IAAI,sBAAsB,CAC9B,sCAAsC,MAAM,CAAC,SAAS,CAAC,EAAE,EACzD;gBACE,IAAI,EAAE,mCAAmC;gBACzC,KAAK,EAAE,mCAAmC;gBAC1C,OAAO,EACL,6FAA6F;gBAC/F,IAAI,EAAE,EAAE,SAAS,EAAE;aACpB,CACF,CAAC;IACN,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAC7B,IAAY,EACZ,SAAmC,EAClB,EAAE;IACnB,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3B,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,KAAK,QAAQ;YACX,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACrC;YACE,MAAM,IAAI,sBAAsB,CAC9B,wCAAwC,MAAM,CAAC,SAAS,CAAC,EAAE,EAC3D;gBACE,IAAI,EAAE,qCAAqC;gBAC3C,KAAK,EAAE,qCAAqC;gBAC5C,OAAO,EACL,+FAA+F;gBACjG,IAAI,EAAE,EAAE,SAAS,EAAE;aACpB,CACF,CAAC;IACN,CAAC;AACH,CAAC,CAAC"}

package/dist/internal/message/utils/deserialise.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deserialise.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/deserialise.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,eAAO,MAAM,WAAW,GAAI,OAAO,GAAG,EAAE,MAAM,aAAa,KAAG,GA8H7D,CAAC"}
+{"version":3,"file":"deserialise.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/deserialise.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,eAAO,MAAM,WAAW,GAAI,OAAO,GAAG,EAAE,MAAM,aAAa,KAAG,GAiK7D,CAAC"}

package/dist/internal/message/utils/deserialise.js

@@ -12,7 +12,11 @@ export const deserialise = (value, type) => {
             }
             catch {
                 throw new IrisSerializationError("Cannot convert value to bigint during deserialisation", {
-                    debug: { type, value: String(value) },
+                    code: "bigint_deserialise_failed",
+                    title: "Bigint Deserialise Failed",
+                    details: "The value could not be converted to a bigint during deserialisation. Ensure the field holds an integer-compatible value.",
+                    data: { type },
+                    debug: { value: String(value) },
                 });
             }
         }
@@ -29,7 +33,11 @@ export const deserialise = (value, type) => {
             if (value instanceof Date) {
                 if (isNaN(value.getTime())) {
                     throw new IrisSerializationError("Invalid Date object during deserialisation", {
-                        debug: { type, value: String(value) },
+                        code: "invalid_date_deserialise",
+                        title: "Invalid Date Deserialise",
+                        details: "The value is a Date object representing an invalid date (NaN time) and cannot be deserialised. Provide a valid date.",
+                        data: { type },
+                        debug: { value: String(value) },
                     });
                 }
                 return value;
@@ -39,7 +47,11 @@ export const deserialise = (value, type) => {
             const date = new Date(value);
             if (isNaN(date.getTime())) {
                 throw new IrisSerializationError("Cannot convert value to date during deserialisation", {
-                    debug: { type, value: String(value) },
+                    code: "date_deserialise_failed",
+                    title: "Date Deserialise Failed",
+                    details: "The value could not be converted to a valid date during deserialisation. Ensure the field holds a parseable date value.",
+                    data: { type },
+                    debug: { value: String(value) },
                 });
             }
             return date;
@@ -52,7 +64,11 @@ export const deserialise = (value, type) => {
             const parsed = parseFloat(value);
             if (isNaN(parsed)) {
                 throw new IrisSerializationError("Cannot convert value to float during deserialisation", {
-                    debug: { type, value: String(value) },
+                    code: "float_deserialise_failed",
+                    title: "Float Deserialise Failed",
+                    details: "The value could not be converted to a float during deserialisation. Ensure the field holds a numeric value.",
+                    data: { type },
+                    debug: { value: String(value) },
                 });
             }
             return parsed;
@@ -68,7 +84,11 @@ export const deserialise = (value, type) => {
             const parsed = parseInt(value, 10);
             if (isNaN(parsed)) {
                 throw new IrisSerializationError("Cannot convert value to integer during deserialisation", {
-                    debug: { type, value: String(value) },
+                    code: "integer_deserialise_failed",
+                    title: "Integer Deserialise Failed",
+                    details: "The value could not be converted to an integer during deserialisation. Ensure the field holds a numeric value.",
+                    data: { type },
+                    debug: { value: String(value) },
                 });
             }
             return parsed;
@@ -80,7 +100,11 @@ export const deserialise = (value, type) => {
                 }
                 catch {
                     throw new IrisSerializationError("Failed to deserialise array value: invalid JSON", {
-                        debug: { type, value },
+                        code: "array_deserialise_failed",
+                        title: "Array Deserialise Failed",
+                        details: "The string value for an array field is not valid JSON and could not be parsed. Ensure array fields are serialised as valid JSON.",
+                        data: { type },
+                        debug: { value },
                     });
                 }
             }
@@ -93,7 +117,11 @@ export const deserialise = (value, type) => {
                 }
                 catch {
                     throw new IrisSerializationError("Failed to deserialise object value: invalid JSON", {
-                        debug: { type, value },
+                        code: "object_deserialise_failed",
+                        title: "Object Deserialise Failed",
+                        details: "The string value for an object field is not valid JSON and could not be parsed. Ensure object fields are serialised as valid JSON.",
+                        data: { type },
+                        debug: { value },
                     });
                 }
             }

package/dist/internal/message/utils/deserialise.js.map

@@ -1 +1 @@
-{"version":3,"file":"deserialise.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/deserialise.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deserialise.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/deserialise.ts"],"names":[],"mappings":"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"}

package/dist/internal/message/utils/encrypt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"encrypt.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/encrypt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,SAAS,QAAQ,GAAG,IAAI,GAAG,SAAS,EACpC,WAAW,gBAAgB,KAC1B,OAAO,CAAC,MAAM,CAkBhB,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,SAAS,QAAQ,GAAG,IAAI,GAAG,SAAS,KACnC,OAAO,CAAC,MAAM,CAoBhB,CAAC"}
+{"version":3,"file":"encrypt.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/encrypt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,SAAS,QAAQ,GAAG,IAAI,GAAG,SAAS,EACpC,WAAW,gBAAgB,KAC1B,OAAO,CAAC,MAAM,CA4BhB,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,SAAS,QAAQ,GAAG,IAAI,GAAG,SAAS,KACnC,OAAO,CAAC,MAAM,CA8BhB,CAAC"}

package/dist/internal/message/utils/encrypt.js

@@ -2,7 +2,11 @@ import { IrisNotSupportedError } from "../../../errors/IrisNotSupportedError.js"
 import { IrisSerializationError } from "../../../errors/IrisSerializationError.js";
 export const encryptPayload = async (data, amphora, predicate) => {
     if (!amphora) {
-        throw new IrisNotSupportedError("@Encrypted requires an Amphora instance but none was configured");
+        throw new IrisNotSupportedError("@Encrypted requires an Amphora instance but none was configured", {
+            code: "missing_amphora_instance",
+            title: "Missing Amphora Instance",
+            details: "A message marked with @Encrypted requires an Amphora instance to encrypt its payload, but none was configured on the source.",
+        });
     }
     try {
         const { AesKit } = await import("@lindorm/aes");
@@ -14,13 +18,20 @@ export const encryptPayload = async (data, amphora, predicate) => {
         if (error instanceof IrisNotSupportedError)
             throw error;
         throw new IrisSerializationError("Failed to encrypt message payload", {
+            code: "payload_encryption_failed",
+            title: "Payload Encryption Failed",
+            details: "The message payload could not be encrypted. Verify that a matching encryption key is available in the Amphora.",
             error: error instanceof Error ? error : undefined,
         });
     }
 };
 export const decryptPayload = async (data, amphora) => {
     if (!amphora) {
-        throw new IrisNotSupportedError("@Encrypted requires an Amphora instance but none was configured");
+        throw new IrisNotSupportedError("@Encrypted requires an Amphora instance but none was configured", {
+            code: "missing_amphora_instance",
+            title: "Missing Amphora Instance",
+            details: "A message marked with @Encrypted requires an Amphora instance to decrypt its payload, but none was configured on the source.",
+        });
     }
     try {
         const { AesKit, parseAes } = await import("@lindorm/aes");
@@ -34,6 +45,9 @@ export const decryptPayload = async (data, amphora) => {
         if (error instanceof IrisNotSupportedError)
             throw error;
         throw new IrisSerializationError("Failed to decrypt message payload", {
+            code: "payload_decryption_failed",
+            title: "Payload Decryption Failed",
+            details: "The message payload could not be decrypted. Verify that the key referenced by the encrypted payload is available in the Amphora.",
             error: error instanceof Error ? error : undefined,
         });
     }

package/dist/internal/message/utils/encrypt.js.map

@@ -1 +1 @@
-{"version":3,"file":"encrypt.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/encrypt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAInF,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,IAAY,EACZ,OAAoC,EACpC,SAA2B,EACV,EAAE;IACnB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,qBAAqB,CAC7B,iEAAiE,CAClE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,OAAO,EAAE,OAAc,EAAE,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,qBAAqB;YAAE,MAAM,KAAK,CAAC;QACxD,MAAM,IAAI,sBAAsB,CAAC,mCAAmC,EAAE;YACpE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SAClD,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,IAAY,EACZ,OAAoC,EACnB,EAAE;IACnB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,qBAAqB,CAC7B,iEAAiE,CAClE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QAC1D,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,OAAO,EAAE,OAAc,EAAE,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAS,IAAI,CAAC,CAAC;QAC/C,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,qBAAqB;YAAE,MAAM,KAAK,CAAC;QACxD,MAAM,IAAI,sBAAsB,CAAC,mCAAmC,EAAE;YACpE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SAClD,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"encrypt.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/encrypt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAInF,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,IAAY,EACZ,OAAoC,EACpC,SAA2B,EACV,EAAE;IACnB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,qBAAqB,CAC7B,iEAAiE,EACjE;YACE,IAAI,EAAE,0BAA0B;YAChC,KAAK,EAAE,0BAA0B;YACjC,OAAO,EACL,8HAA8H;SACjI,CACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,OAAO,EAAE,OAAc,EAAE,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,qBAAqB;YAAE,MAAM,KAAK,CAAC;QACxD,MAAM,IAAI,sBAAsB,CAAC,mCAAmC,EAAE;YACpE,IAAI,EAAE,2BAA2B;YACjC,KAAK,EAAE,2BAA2B;YAClC,OAAO,EACL,gHAAgH;YAClH,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SAClD,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,IAAY,EACZ,OAAoC,EACnB,EAAE;IACnB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,qBAAqB,CAC7B,iEAAiE,EACjE;YACE,IAAI,EAAE,0BAA0B;YAChC,KAAK,EAAE,0BAA0B;YACjC,OAAO,EACL,8HAA8H;SACjI,CACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QAC1D,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,OAAO,EAAE,OAAc,EAAE,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAS,IAAI,CAAC,CAAC;QAC/C,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,qBAAqB;YAAE,MAAM,KAAK,CAAC;QACxD,MAAM,IAAI,sBAAsB,CAAC,mCAAmC,EAAE;YACpE,IAAI,EAAE,2BAA2B;YACjC,KAAK,EAAE,2BAA2B;YAClC,OAAO,EACL,kIAAkI;YACpI,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SAClD,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC"}

package/dist/internal/message/utils/index.d.ts

@@ -8,6 +8,7 @@ export * from "./parse-field.js";
 export * from "./prepare-inbound.js";
 export * from "./prepare-outbound.js";
 export * from "./run-hooks.js";
+export * from "./resolve-consume-topic.js";
 export * from "./resolve-default-topic.js";
 export * from "./resolve-delay.js";
 export * from "./resolve-expiry.js";

package/dist/internal/message/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}

package/dist/internal/message/utils/index.js

@@ -8,6 +8,7 @@ export * from "./parse-field.js";
 export * from "./prepare-inbound.js";
 export * from "./prepare-outbound.js";
 export * from "./run-hooks.js";
+export * from "./resolve-consume-topic.js";
 export * from "./resolve-default-topic.js";
 export * from "./resolve-delay.js";
 export * from "./resolve-expiry.js";

package/dist/internal/message/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}

package/dist/internal/message/utils/parse-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-field.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/parse-field.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD,eAAO,MAAM,UAAU,GAAI,OAAO,SAAS,EAAE,SAAS,GAAG,EAAE,SAAS,GAAG,KAAG,GA6BzE,CAAC"}
+{"version":3,"file":"parse-field.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/parse-field.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD,eAAO,MAAM,UAAU,GAAI,OAAO,SAAS,EAAE,SAAS,GAAG,EAAE,SAAS,GAAG,KAAG,GAmCzE,CAAC"}

package/dist/internal/message/utils/parse-field.js

@@ -18,7 +18,12 @@ export const parseField = (field, message, options) => {
     }
     catch (error) {
         throw new IrisSerializationError(`Failed to parse field "${field.key}" of type ${field.type}`, {
-            debug: { field: field.key, value, type: typeof value, error },
+            code: "field_parse_failed",
+            title: "Field Parse Failed",
+            details: "The provided value for the named field could not be parsed into the field's declared type. Check that the value matches the expected type.",
+            data: { field: field.key, type: field.type },
+            debug: { value, valueType: typeof value },
+            error: error instanceof Error ? error : undefined,
         });
     }
 };

package/dist/internal/message/utils/parse-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse-field.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/parse-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAEnF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAgB,EAAE,OAAY,EAAE,OAAY,EAAO,EAAE;IAC9E,MAAM,iBAAiB,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC;IAC/C,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE1E,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAE1C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAGlD,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,OAAO,KAAK,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;QAC/E,CAAC;QAGD,IAAI,KAAK,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAEhC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,sBAAsB,CAC9B,0BAA0B,KAAK,CAAC,GAAG,aAAa,KAAK,CAAC,IAAI,EAAE,EAC5D;YACE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,KAAK,EAAE,KAAK,EAAE;SAC9D,CACF,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"parse-field.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/parse-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAEnF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAgB,EAAE,OAAY,EAAE,OAAY,EAAO,EAAE;IAC9E,MAAM,iBAAiB,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC;IAC/C,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE1E,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAE1C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAGlD,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,OAAO,KAAK,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;QAC/E,CAAC;QAGD,IAAI,KAAK,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAEhC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,sBAAsB,CAC9B,0BAA0B,KAAK,CAAC,GAAG,aAAa,KAAK,CAAC,IAAI,EAAE,EAC5D;YACE,IAAI,EAAE,oBAAoB;YAC1B,KAAK,EAAE,oBAAoB;YAC3B,OAAO,EACL,4IAA4I;YAC9I,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;YAC5C,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,KAAK,EAAE;YACzC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SAClD,CACF,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/dist/internal/message/utils/prepare-inbound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prepare-inbound.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/prepare-inbound.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIjD,eAAO,MAAM,cAAc,GACzB,SAAS,MAAM,GAAG,MAAM,EACxB,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,UAAU,eAAe,EACzB,UAAU,QAAQ,KACjB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCjC,CAAC"}
+{"version":3,"file":"prepare-inbound.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/prepare-inbound.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIjD,eAAO,MAAM,cAAc,GACzB,SAAS,MAAM,GAAG,MAAM,EACxB,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,UAAU,eAAe,EACzB,UAAU,QAAQ,KACjB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqDjC,CAAC"}

package/dist/internal/message/utils/prepare-inbound.js

@@ -9,16 +9,29 @@ export const prepareInbound = async (payload, headers, metadata, amphora) => {
         data = await decryptPayload(str, amphora);
     }
     if (headers["x-iris-encrypted"] === "true" && !metadata.encrypted) {
-        throw new IrisSerializationError("Received encrypted message but @Encrypted is not configured on this message class");
+        throw new IrisSerializationError("Received encrypted message but @Encrypted is not configured on this message class", {
+            code: "unexpected_encrypted_message",
+            title: "Unexpected Encrypted Message",
+            details: "An encrypted payload was received but the message class is not marked with @Encrypted. Add @Encrypted to the message class or stop encrypting the payload.",
+        });
     }
     if (headers["x-iris-encrypted"] !== "true" && metadata.encrypted) {
-        throw new IrisSerializationError("Message requires encryption but received unencrypted payload");
+        throw new IrisSerializationError("Message requires encryption but received unencrypted payload", {
+            code: "missing_encrypted_payload",
+            title: "Missing Encrypted Payload",
+            details: "The message class is marked with @Encrypted but the received payload was not encrypted. Ensure the producer encrypts this message.",
+        });
     }
     const compressionAlgorithm = headers["x-iris-compression"];
     if (compressionAlgorithm) {
         const validAlgorithms = new Set(["gzip", "deflate", "brotli"]);
         if (!validAlgorithms.has(compressionAlgorithm)) {
-            throw new IrisSerializationError(`Unsupported compression algorithm in header: "${compressionAlgorithm}"`);
+            throw new IrisSerializationError(`Unsupported compression algorithm in header: "${compressionAlgorithm}"`, {
+                code: "unsupported_compression_algorithm",
+                title: "Unsupported Compression Algorithm",
+                details: "The inbound message declares a compression algorithm that is not supported. Supported algorithms are gzip, deflate, and brotli.",
+                data: { algorithm: compressionAlgorithm },
+            });
         }
         const buf = Buffer.isBuffer(data) ? data : Buffer.from(data, "utf-8");
         data = await decompress(buf, compressionAlgorithm);

package/dist/internal/message/utils/prepare-inbound.js.map

@@ -1 +1 @@
-{"version":3,"file":"prepare-inbound.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/prepare-inbound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAGnF,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,OAAwB,EACxB,OAA+B,EAC/B,QAAyB,EACzB,OAAkB,EACgB,EAAE;IACpC,IAAI,IAAI,GAAoB,OAAO,CAAC;IAEpC,IAAI,OAAO,CAAC,kBAAkB,CAAC,KAAK,MAAM,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACjE,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClE,IAAI,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,CAAC,kBAAkB,CAAC,KAAK,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAClE,MAAM,IAAI,sBAAsB,CAC9B,mFAAmF,CACpF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,kBAAkB,CAAC,KAAK,MAAM,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACjE,MAAM,IAAI,sBAAsB,CAC9B,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC3D,IAAI,oBAAoB,EAAE,CAAC;QACzB,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,oBAAoB,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,sBAAsB,CAC9B,iDAAiD,oBAAoB,GAAG,CACzE,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtE,IAAI,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,oBAAgD,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,OAAO,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AACrD,CAAC,CAAC"}
+{"version":3,"file":"prepare-inbound.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/prepare-inbound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAGnF,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,OAAwB,EACxB,OAA+B,EAC/B,QAAyB,EACzB,OAAkB,EACgB,EAAE;IACpC,IAAI,IAAI,GAAoB,OAAO,CAAC;IAEpC,IAAI,OAAO,CAAC,kBAAkB,CAAC,KAAK,MAAM,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACjE,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClE,IAAI,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,CAAC,kBAAkB,CAAC,KAAK,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAClE,MAAM,IAAI,sBAAsB,CAC9B,mFAAmF,EACnF;YACE,IAAI,EAAE,8BAA8B;YACpC,KAAK,EAAE,8BAA8B;YACrC,OAAO,EACL,4JAA4J;SAC/J,CACF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,kBAAkB,CAAC,KAAK,MAAM,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACjE,MAAM,IAAI,sBAAsB,CAC9B,8DAA8D,EAC9D;YACE,IAAI,EAAE,2BAA2B;YACjC,KAAK,EAAE,2BAA2B;YAClC,OAAO,EACL,oIAAoI;SACvI,CACF,CAAC;IACJ,CAAC;IAED,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC3D,IAAI,oBAAoB,EAAE,CAAC;QACzB,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,oBAAoB,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,sBAAsB,CAC9B,iDAAiD,oBAAoB,GAAG,EACxE;gBACE,IAAI,EAAE,mCAAmC;gBACzC,KAAK,EAAE,mCAAmC;gBAC1C,OAAO,EACL,iIAAiI;gBACnI,IAAI,EAAE,EAAE,SAAS,EAAE,oBAAoB,EAAE;aAC1C,CACF,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtE,IAAI,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,oBAAgD,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,OAAO,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AACrD,CAAC,CAAC"}

package/dist/internal/message/utils/resolve-consume-topic.d.ts

@@ -0,0 +1,4 @@
+import type { ILogger } from "@lindorm/logger";
+import type { MessageMetadata } from "../types/metadata.js";
+export declare const resolveConsumeTopic: (metadata: MessageMetadata, logger?: ILogger, queue?: string) => string;
+//# sourceMappingURL=resolve-consume-topic.d.ts.map

package/dist/internal/message/utils/resolve-consume-topic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-consume-topic.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/resolve-consume-topic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,eAAO,MAAM,mBAAmB,GAC9B,UAAU,eAAe,EACzB,SAAS,OAAO,EAChB,QAAQ,MAAM,KACb,MAkBF,CAAC"}

package/dist/internal/message/utils/resolve-consume-topic.js

@@ -0,0 +1,11 @@
+import { resolveDefaultTopic } from "./resolve-default-topic.js";
+export const resolveConsumeTopic = (metadata, logger, queue) => {
+    if (metadata.topic?.callback) {
+        if (queue) {
+            return queue;
+        }
+        logger?.warn("Message uses a dynamic @Topic callback and no explicit queue was provided; consume() cannot resolve it statically and falls back to the namespaced message name", { message: metadata.message.name, namespace: metadata.namespace });
+    }
+    return resolveDefaultTopic(metadata);
+};
+//# sourceMappingURL=resolve-consume-topic.js.map

package/dist/internal/message/utils/resolve-consume-topic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-consume-topic.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/resolve-consume-topic.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,QAAyB,EACzB,MAAgB,EAChB,KAAc,EACN,EAAE;IACV,IAAI,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;QAM7B,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,EAAE,IAAI,CACV,iKAAiK,EACjK,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAClE,CAAC;IACJ,CAAC;IAED,OAAO,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC,CAAC"}

package/dist/internal/message/utils/run-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-hooks.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/run-hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,eAAO,MAAM,YAAY,GACvB,WAAW,iBAAiB,EAC5B,OAAO,KAAK,CAAC,QAAQ,CAAC,EACtB,SAAS,OAAO,EAChB,MAAM,YAAY,EAClB,GAAG,OAAO,KAAK,CAAC,OAAO,CAAC,KACvB,IAUF,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,WAAW,iBAAiB,EAC5B,OAAO,KAAK,CAAC,QAAQ,CAAC,EACtB,SAAS,OAAO,EAChB,MAAM,YAAY,EAClB,GAAG,OAAO,KAAK,CAAC,OAAO,CAAC,KACvB,OAAO,CAAC,IAAI,CAKd,CAAC"}
+{"version":3,"file":"run-hooks.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/run-hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,eAAO,MAAM,YAAY,GACvB,WAAW,iBAAiB,EAC5B,OAAO,KAAK,CAAC,QAAQ,CAAC,EACtB,SAAS,OAAO,EAChB,MAAM,YAAY,EAClB,GAAG,OAAO,KAAK,CAAC,OAAO,CAAC,KACvB,IAiBF,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,WAAW,iBAAiB,EAC5B,OAAO,KAAK,CAAC,QAAQ,CAAC,EACtB,SAAS,OAAO,EAChB,MAAM,YAAY,EAClB,GAAG,OAAO,KAAK,CAAC,OAAO,CAAC,KACvB,OAAO,CAAC,IAAI,CAKd,CAAC"}

package/dist/internal/message/utils/run-hooks.js

@@ -5,7 +5,12 @@ export const runHooksSync = (decorator, hooks, message, meta, ...extra) => {
             continue;
         const result = hook.callback(message, meta, ...extra);
         if (result instanceof Promise) {
-            throw new IrisError(`@${decorator} hook returned a Promise — ${decorator} hooks must be synchronous`);
+            throw new IrisError(`@${decorator} hook returned a Promise — ${decorator} hooks must be synchronous`, {
+                code: "async_sync_hook",
+                title: "Async Sync Hook",
+                details: "A synchronous lifecycle hook returned a Promise. Make the named hook's callback synchronous, or move the logic to an async hook.",
+                data: { decorator },
+            });
         }
     }
 };

package/dist/internal/message/utils/run-hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-hooks.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/run-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAKzD,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,SAA4B,EAC5B,KAAsB,EACtB,OAAgB,EAChB,IAAkB,EAClB,GAAG,KAAqB,EAClB,EAAE;IACR,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,SAAS;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC;QACtD,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,SAAS,CACjB,IAAI,SAAS,8BAA8B,SAAS,4BAA4B,CACjF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,SAA4B,EAC5B,KAAsB,EACtB,OAAgB,EAChB,IAAkB,EAClB,GAAG,KAAqB,EACT,EAAE;IACjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,SAAS;QAC3C,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"run-hooks.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/run-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAKzD,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,SAA4B,EAC5B,KAAsB,EACtB,OAAgB,EAChB,IAAkB,EAClB,GAAG,KAAqB,EAClB,EAAE;IACR,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,SAAS;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC;QACtD,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,SAAS,CACjB,IAAI,SAAS,8BAA8B,SAAS,4BAA4B,EAChF;gBACE,IAAI,EAAE,iBAAiB;gBACvB,KAAK,EAAE,iBAAiB;gBACxB,OAAO,EACL,kIAAkI;gBACpI,IAAI,EAAE,EAAE,SAAS,EAAE;aACpB,CACF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,SAA4B,EAC5B,KAAsB,EACtB,OAAgB,EAChB,IAAkB,EAClB,GAAG,KAAqB,EACT,EAAE;IACjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,SAAS;QAC3C,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC,CAAC"}

package/dist/internal/message/utils/serialize-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialize-message.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/serialize-message.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAExE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,eAAO,MAAM,gBAAgB,GAC3B,SAAS,GAAG,EACZ,UAAU,eAAe,KACxB,iBA6CF,CAAC"}
+{"version":3,"file":"serialize-message.d.ts","sourceRoot":"","sources":["../../../../src/internal/message/utils/serialize-message.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAExE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,eAAO,MAAM,gBAAgB,GAC3B,SAAS,GAAG,EACZ,UAAU,eAAe,KACxB,iBAyDF,CAAC"}

package/dist/internal/message/utils/serialize-message.js

@@ -11,6 +11,10 @@ export const serializeMessage = (message, metadata) => {
             }
             catch (error) {
                 throw new IrisSerializationError(`@Transform.to failed for field "${field.key}"`, {
+                    code: "transform_to_failed",
+                    title: "Transform To Failed",
+                    details: "The @Transform.to function threw while converting the named field during serialization. Review the transform's to() implementation.",
+                    data: { field: field.key },
                     error: error instanceof Error ? error : undefined,
                 });
             }
@@ -29,7 +33,13 @@ export const serializeMessage = (message, metadata) => {
         body = JsonKit.stringify(data);
     }
     catch (error) {
-        throw new IrisSerializationError(`Failed to serialize message "${metadata.message.name}"`, { debug: { error: error instanceof Error ? error.message : String(error) } });
+        throw new IrisSerializationError(`Failed to serialize message "${metadata.message.name}"`, {
+            code: "message_serialize_failed",
+            title: "Message Serialize Failed",
+            details: "The message body could not be serialized to JSON. A field likely holds a value that is not JSON-serializable, such as a circular reference.",
+            data: { message: metadata.message.name },
+            debug: { error: error instanceof Error ? error.message : String(error) },
+        });
     }
     return {
         body,

package/dist/internal/message/utils/serialize-message.js.map

@@ -1 +1 @@
-{"version":3,"file":"serialize-message.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/serialize-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAMnF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,OAAY,EACZ,QAAyB,EACN,EAAE;IACrB,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE/B,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,sBAAsB,CAC9B,mCAAmC,KAAK,CAAC,GAAG,GAAG,EAC/C;oBACE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;iBAClD,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,sBAAsB,CAC9B,gCAAgC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,EACxD,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAC7E,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI;QACJ,OAAO;KACR,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"serialize-message.js","sourceRoot":"","sources":["../../../../src/internal/message/utils/serialize-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAMnF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,OAAY,EACZ,QAAyB,EACN,EAAE;IACrB,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE/B,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,sBAAsB,CAC9B,mCAAmC,KAAK,CAAC,GAAG,GAAG,EAC/C;oBACE,IAAI,EAAE,qBAAqB;oBAC3B,KAAK,EAAE,qBAAqB;oBAC5B,OAAO,EACL,qIAAqI;oBACvI,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE;oBAC1B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;iBAClD,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,sBAAsB,CAC9B,gCAAgC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,EACxD;YACE,IAAI,EAAE,0BAA0B;YAChC,KAAK,EAAE,0BAA0B;YACjC,OAAO,EACL,6IAA6I;YAC/I,IAAI,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE;YACxC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SACzE,CACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI;QACJ,OAAO;KACR,CAAC;AACJ,CAAC,CAAC"}

package/dist/internal/utils/check-pipeline-results.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-pipeline-results.d.ts","sourceRoot":"","sources":["../../../src/internal/utils/check-pipeline-results.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,GAC/B,SAAS,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,KAC7C,IAQF,CAAC"}
+{"version":3,"file":"check-pipeline-results.d.ts","sourceRoot":"","sources":["../../../src/internal/utils/check-pipeline-results.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,GAC/B,SAAS,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,KAC7C,IAaF,CAAC"}

package/dist/internal/utils/check-pipeline-results.js

@@ -1,6 +1,11 @@
+import { IrisTransportError } from "../../errors/IrisTransportError.js";
 export const checkPipelineResults = (results) => {
     if (!results) {
-        throw new Error("Redis pipeline returned null results");
+        throw new IrisTransportError("Redis pipeline returned null results", {
+            code: "pipeline_null_results",
+            title: "Pipeline Null Results",
+            details: "The Redis pipeline returned null instead of a results array, indicating the pipeline did not execute. Retry the operation.",
+        });
     }
     for (const [err] of results) {
         if (err)

package/dist/internal/utils/check-pipeline-results.js.map

@@ -1 +1 @@
-{"version":3,"file":"check-pipeline-results.js","sourceRoot":"","sources":["../../../src/internal/utils/check-pipeline-results.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,OAA8C,EACxC,EAAE;IACR,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,GAAG;YAAE,MAAM,GAAG,CAAC;IACrB,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"check-pipeline-results.js","sourceRoot":"","sources":["../../../src/internal/utils/check-pipeline-results.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAExE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,OAA8C,EACxC,EAAE;IACR,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,kBAAkB,CAAC,sCAAsC,EAAE;YACnE,IAAI,EAAE,uBAAuB;YAC7B,KAAK,EAAE,uBAAuB;YAC9B,OAAO,EACL,4HAA4H;SAC/H,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,GAAG;YAAE,MAAM,GAAG,CAAC;IACrB,CAAC;AACH,CAAC,CAAC"}

package/dist/internal/utils/validate-encrypted-messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-encrypted-messages.d.ts","sourceRoot":"","sources":["../../../src/internal/utils/validate-encrypted-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAG5D,eAAO,MAAM,yBAAyB,GACpC,UAAU,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,EACtC,SAAS,QAAQ,GAAG,SAAS,KAC5B,IASF,CAAC"}
+{"version":3,"file":"validate-encrypted-messages.d.ts","sourceRoot":"","sources":["../../../src/internal/utils/validate-encrypted-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAG5D,eAAO,MAAM,yBAAyB,GACpC,UAAU,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,EACtC,SAAS,QAAQ,GAAG,SAAS,KAC5B,IAgBF,CAAC"}

package/dist/internal/utils/validate-encrypted-messages.js

@@ -4,7 +4,12 @@ export const validateEncryptedMessages = (messages, amphora) => {
     for (const target of messages) {
         const metadata = getMessageMetadata(target);
         if (metadata.encrypted && !amphora) {
-            throw new IrisSourceError(`Message "${metadata.message.name}" uses @Encrypted but no amphora instance was provided to IrisSource`);
+            throw new IrisSourceError(`Message "${metadata.message.name}" uses @Encrypted but no amphora instance was provided to IrisSource`, {
+                code: "missing_amphora_instance",
+                title: "Missing Amphora Instance",
+                details: "A registered message is marked with @Encrypted but no Amphora instance was provided to IrisSource. Provide an Amphora when constructing the source.",
+                data: { message: metadata.message.name },
+            });
         }
     }
 };