@message-queue-toolkit/core 24.0.0 → 25.0.0

package/dist/types/queueOptionsTypes.d.ts

@@ -4,6 +4,7 @@ import type { MessageDeduplicationConfig } from '../message-deduplication/messag
 import type { PayloadStoreConfig } from '../payload-store/payloadStoreTypes.ts';
 import type { MessageHandlerConfig } from '../queues/HandlerContainer.ts';
 import type { HandlerSpy, HandlerSpyParams } from '../queues/HandlerSpy.ts';
+import type { MessageTypeResolverConfig } from '../queues/MessageTypeResolver.ts';
 import type { MessageProcessingResult, TransactionObservabilityManager } from './MessageQueueTypes.ts';
 export type QueueDependencies = {
     errorReporter: ErrorReporter;
@@ -16,9 +17,10 @@ export type ProcessedMessageMetadata<MessagePayloadSchemas extends object = obje
      */
     messageId: string;
     /**
-     * Message type accessed by `messageTypeField`
+     * Message type resolved by `messageTypeResolver`.
+     * May be undefined if messageTypeResolver is not configured.
      */
-    messageType: string;
+    messageType?: string;
     /**
      * Processing result status
      */
@@ -60,8 +62,38 @@ export type QueueConsumerDependencies = {
     consumerErrorResolver: ErrorResolver;
     transactionObservabilityManager: TransactionObservabilityManager;
 };
+/**
+ * Common queue options for publishers and consumers.
+ *
+ * Message type resolution is configured via `messageTypeResolver`.
+ * At least one must be provided for routing to work (unless using a single handler).
+ */
 export type CommonQueueOptions = {
-    messageTypeField: string;
+    /**
+     * Configuration for resolving message types.
+     *
+     * Supports three modes:
+     * - `{ messageTypePath: string }` - field name at the root of the message
+     * - `{ literal: string }` - constant type for all messages
+     * - `{ resolver: fn }` - custom function for complex scenarios (e.g., extracting from attributes)
+     *
+     * @example
+     * // Field path - extracts type from message.type
+     * { messageTypeResolver: { messageTypePath: 'type' } }
+     *
+     * @example
+     * // Constant type - all messages treated as same type
+     * { messageTypeResolver: { literal: 'order.created' } }
+     *
+     * @example
+     * // Custom resolver for Cloud Storage notifications via PubSub
+     * {
+     *   messageTypeResolver: {
+     *     resolver: ({ messageAttributes }) => messageAttributes?.eventType as string
+     *   }
+     * }
+     */
+    messageTypeResolver?: MessageTypeResolverConfig;
     messageIdField?: string;
     messageTimestampField?: string;
     messageDeduplicationIdField?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@message-queue-toolkit/core",
-    "version": "24.0.0",
+    "version": "25.0.0",
     "license": "MIT",
     "description": "Useful utilities, interfaces and base classes for message queue handling. Supports AMQP and SQS with a common abstraction on top currently",
     "maintainers": [
@@ -28,6 +28,7 @@
         "@lokalise/node-core": "^14.2.0",
         "@lokalise/universal-ts-utils": "^4.5.1",
         "@message-queue-toolkit/schemas": "^7.0.0",
+        "dot-prop": "^10.1.0",
         "fast-equals": "^5.2.2",
         "json-stream-stringify": "^3.1.6",
         "tmp": "^0.2.3",
@@ -37,10 +38,10 @@
         "zod": ">=3.25.76 <5.0.0"
     },
     "devDependencies": {
-        "@biomejs/biome": "^2.3.6",
+        "@biomejs/biome": "^2.3.8",
         "@lokalise/biome-config": "^3.1.0",
         "@lokalise/tsconfig": "^3.0.0",
-        "@types/node": "^24.0.3",
+        "@types/node": "^24.10.1",
         "@types/tmp": "^0.2.6",
         "@vitest/coverage-v8": "^3.2.4",
         "awilix": "^12.0.5",
@@ -48,7 +49,7 @@
         "rimraf": "^6.0.1",
         "typescript": "^5.9.2",
         "vitest": "^3.2.4",
-        "zod": "^4.0.17"
+        "zod": "^4.1.13"
     },
     "homepage": "https://github.com/kibertoad/message-queue-toolkit",
     "repository": {