@nimbus-cqrs/core 2.1.1 → 2.2.0

package/README.md

@@ -13,7 +13,7 @@ Refer to the [Nimbus main repository](https://github.com/overlap-dev/Nimbus) or
 
 ```bash
 # Deno
-deno add jsr:@nimbus-cqrs/core
+deno add npm:@nimbus-cqrs/core
 
 # NPM
 npm install @nimbus-cqrs/core
@@ -30,17 +30,13 @@ For detailed documentation, please refer to the [Nimbus documentation](https://n
 
 ## Command
 
-A **Command** asks the system to *do* something (a write). You declare a [Zod](https://zod.dev/) schema that extends Nimbus' built-in `commandSchema`, write a handler, and register both on the router. Incoming messages are validated against the schema before they reach your handler.
+A **Command** asks the system to _do_ something (a write). You declare a [Zod](https://zod.dev/) schema that extends Nimbus' built-in `commandSchema`, write a handler, and register both on the router. Incoming messages are validated against the schema before they reach your handler.
 
 ```typescript
-import {
-    commandSchema,
-    createCommand,
-    getRouter,
-} from '@nimbus-cqrs/core';
-import { z } from 'zod';
+import { commandSchema, createCommand, getRouter } from "@nimbus-cqrs/core";
+import { z } from "zod";
 
-const ADD_TODO = 'com.example.todo.add';
+const ADD_TODO = "com.example.todo.add";
 
 const addTodoSchema = commandSchema.extend({
     type: z.literal(ADD_TODO),
@@ -52,7 +48,7 @@ type AddTodoCommand = z.infer<typeof addTodoSchema>;
 
 const handleAddTodo = async (cmd: AddTodoCommand) => {
     // ...persist the todo here...
-    return { id: 'todo-1', title: cmd.data.title, status: 'open' };
+    return { id: "todo-1", title: cmd.data.title, status: "open" };
 };
 
 const router = getRouter();
@@ -61,9 +57,9 @@ router.register(ADD_TODO, handleAddTodo, addTodoSchema);
 const result = await router.route(
     createCommand<AddTodoCommand>({
         type: ADD_TODO,
-        source: 'https://app.example.com',
-        data: { title: 'Write the README' },
-    }),
+        source: "https://app.example.com",
+        data: { title: "Write the README" },
+    })
 );
 
 console.log(result);
@@ -74,13 +70,13 @@ console.log(result);
 
 ## Query
 
-A **Query** asks the system to *read* something. Mechanically it is identical to a Command — same router, same validation, same shape — only the intent differs.
+A **Query** asks the system to _read_ something. Mechanically it is identical to a Command — same router, same validation, same shape — only the intent differs.
 
 ```typescript
-import { createQuery, getRouter, querySchema } from '@nimbus-cqrs/core';
-import { z } from 'zod';
+import { createQuery, getRouter, querySchema } from "@nimbus-cqrs/core";
+import { z } from "zod";
 
-const GET_TODO = 'com.example.todo.get';
+const GET_TODO = "com.example.todo.get";
 
 const getTodoSchema = querySchema.extend({
     type: z.literal(GET_TODO),
@@ -90,7 +86,7 @@ type GetTodoQuery = z.infer<typeof getTodoSchema>;
 
 const handleGetTodo = async (q: GetTodoQuery) => {
     // ...load the todo from your read model...
-    return { id: q.data.id, title: 'Write the README', status: 'open' };
+    return { id: q.data.id, title: "Write the README", status: "open" };
 };
 
 const router = getRouter();
@@ -99,25 +95,21 @@ router.register(GET_TODO, handleGetTodo, getTodoSchema);
 const todo = await router.route(
     createQuery<GetTodoQuery>({
         type: GET_TODO,
-        source: 'https://app.example.com',
-        data: { id: 'todo-1' },
-    }),
+        source: "https://app.example.com",
+        data: { id: "todo-1" },
+    })
 );
 ```
 
 ## Event
 
-An **Event** announces that something *has happened*. Events are published to the in-process EventBus, which delivers them to every matching subscriber asynchronously, with exponential-backoff retries on handler errors and built-in OpenTelemetry traces and metrics.
+An **Event** announces that something _has happened_. Events are published to the in-process EventBus, which delivers them to every matching subscriber asynchronously, with exponential-backoff retries on handler errors and built-in OpenTelemetry traces and metrics.
 
 ```typescript
-import {
-    createEvent,
-    eventSchema,
-    getEventBus,
-} from '@nimbus-cqrs/core';
-import { z } from 'zod';
+import { createEvent, eventSchema, getEventBus } from "@nimbus-cqrs/core";
+import { z } from "zod";
 
-const TODO_ADDED = 'com.example.todo.added';
+const TODO_ADDED = "com.example.todo.added";
 
 const todoAddedSchema = eventSchema.extend({
     type: z.literal(TODO_ADDED),
@@ -143,10 +135,10 @@ eventBus.subscribeEvent<TodoAddedEvent>({
 eventBus.putEvent(
     createEvent<TodoAddedEvent>({
         type: TODO_ADDED,
-        source: 'https://app.example.com',
-        subject: '/todos/todo-1',
-        data: { id: 'todo-1', title: 'Write the README' },
-    }),
+        source: "https://app.example.com",
+        subject: "/todos/todo-1",
+        data: { id: "todo-1", title: "Write the README" },
+    })
 );
 ```
 
@@ -157,27 +149,27 @@ A typical flow is to publish an event from inside a command handler once the wri
 A typical app configures a single named router at startup with cross-cutting concerns (logging, correlation IDs, …) and then resolves it from anywhere via `getRouter()`.
 
 ```typescript
-import { getLogger, getRouter, setupRouter } from '@nimbus-cqrs/core';
+import { getLogger, getRouter, setupRouter } from "@nimbus-cqrs/core";
 
-setupRouter('default', {
+setupRouter("default", {
     logInput: (input) => {
         getLogger().debug({
-            category: 'Router',
+            category: "Router",
             message: `Routing ${input.type}`,
             correlationId: input.correlationid,
         });
     },
     logOutput: (output) => {
         getLogger().debug({
-            category: 'Router',
-            message: 'Handler completed',
+            category: "Router",
+            message: "Handler completed",
             data: { output },
         });
     },
 });
 
 // Anywhere else in your app:
-const router = getRouter('default');
+const router = getRouter("default");
 router.register(/* type, handler, schema */);
 await router.route(/* command or query */);
 ```

package/esm/lib/exception/exception.d.ts

@@ -5,6 +5,6 @@ export declare class Exception extends Error {
     details?: Record<string, unknown>;
     statusCode?: number;
     constructor(name: string, message: string, details?: Record<string, unknown>, statusCode?: number);
-    fromError(error: Error): Exception;
+    fromError(error: Error): this;
 }
 //# sourceMappingURL=exception.d.ts.map

package/esm/lib/exception/exception.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exception.d.ts","sourceRoot":"","sources":["../../../src/lib/exception/exception.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,UAAU,CAAC,EAAE,MAAM;IAmBhB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS;CAM5C"}
+{"version":3,"file":"exception.d.ts","sourceRoot":"","sources":["../../../src/lib/exception/exception.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,UAAU,CAAC,EAAE,MAAM;IAmBhB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;CAMvC"}

package/esm/lib/exception/invalidInputException.d.ts

@@ -13,6 +13,6 @@ export declare class InvalidInputException extends Exception {
      *
      * @returns {InvalidInputException} The InvalidInputException.
      */
-    fromZodError(error: ZodError): InvalidInputException;
+    fromZodError(error: ZodError): this;
 }
 //# sourceMappingURL=invalidInputException.d.ts.map

package/esm/lib/exception/invalidInputException.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invalidInputException.d.ts","sourceRoot":"","sources":["../../../src/lib/exception/invalidInputException.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,SAAS;gBACpC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAS/D;;;;;;;OAOG;IACI,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,qBAAqB;CAa9D"}
+{"version":3,"file":"invalidInputException.d.ts","sourceRoot":"","sources":["../../../src/lib/exception/invalidInputException.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,SAAS;gBACpC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAS/D;;;;;;;OAOG;IACI,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;CAa7C"}

package/esm/lib/message/command.d.ts

@@ -20,6 +20,12 @@ import { z } from 'zod';
  * @property {string} datacontenttype - A MIME type that indicates the format that the data is in (optional).
  * @property {string} dataschema - An absolute URL to the schema that the data adheres to (optional).
  *
+ * Commands may include additional CloudEvents extension attributes such as
+ * `metadata` or `authcontext`. Define them on a command-specific schema via
+ * {@link commandSchema.extend} or as an intersection type.
+ *
+ * @see https://github.com/cloudevents/spec/blob/main/cloudevents/spec.md#extension-context-attributes
+ *
  * @template TData - The type of the data.
  *
  * @example
@@ -49,6 +55,10 @@ export type Command<TData = unknown> = {
     datacontenttype?: string;
     dataschema?: string;
 };
+/**
+ * Known command properties handled by {@link createCommand}.
+ */
+type CommandKnownProperty = 'specversion' | 'id' | 'correlationid' | 'time' | 'source' | 'type' | 'subject' | 'data' | 'datacontenttype' | 'dataschema';
 /**
  * Type alias for the command data field schema.
  */
@@ -90,7 +100,7 @@ export declare const commandSchema: CommandSchemaType;
  * the input is validated against that type. This means fields like
  * `type` and `data` must match the narrower types of `TCommand`.
  */
-export type CreateCommandInput<TCommand extends Command = Command> = Partial<Pick<TCommand, 'id' | 'correlationid' | 'time' | 'subject' | 'datacontenttype' | 'dataschema'>> & Pick<TCommand, 'type' | 'source' | 'data'>;
+export type CreateCommandInput<TCommand extends Command = Command> = Partial<Pick<TCommand, 'id' | 'correlationid' | 'time' | 'subject' | 'datacontenttype' | 'dataschema'>> & Pick<TCommand, 'type' | 'source' | 'data'> & Partial<Omit<TCommand, CommandKnownProperty>>;
 /**
  * Creates a command based on input data with the convenience
  * to skip properties and use the defaults for the rest.

package/esm/lib/message/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/lib/message/command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,MAAM,OAAO,CAAC,KAAK,GAAG,OAAO,IAAI;IACnC,WAAW,EAAE,KAAK,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,KAAK,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,KAAK,iBAAiB,GAAG,CAAC,CAAC,QAAQ,CAC/B;IACI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC;IACtC,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;IACxB,CAAC,CAAC,UAAU;CACf,CACJ,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,SAAS,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC;IAChB,aAAa,EAAE,CAAC,CAAC,SAAS,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC;IACpB,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC;IAClB,OAAO,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,EAAE,iBAAiB,CAAC;IACxB,eAAe,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;CACvC,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,iBAiB1B,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,CAAC,QAAQ,SAAS,OAAO,GAAG,OAAO,IAC3D,OAAO,CACL,IAAI,CACA,QAAQ,EACN,IAAI,GACJ,eAAe,GACf,MAAM,GACN,SAAS,GACT,iBAAiB,GACjB,YAAY,CACjB,CACJ,GACC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,SAAS,OAAO,EAClD,OAAO,kBAAkB,CAAC,QAAQ,CAAC,KACpC,QAeF,CAAC"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/lib/message/command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,MAAM,OAAO,CAAC,KAAK,GAAG,OAAO,IAAI;IACnC,WAAW,EAAE,KAAK,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,KAAK,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,KAAK,oBAAoB,GACnB,aAAa,GACb,IAAI,GACJ,eAAe,GACf,MAAM,GACN,QAAQ,GACR,MAAM,GACN,SAAS,GACT,MAAM,GACN,iBAAiB,GACjB,YAAY,CAAC;AAEnB;;GAEG;AACH,KAAK,iBAAiB,GAAG,CAAC,CAAC,QAAQ,CAC/B;IACI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC;IACtC,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;IACxB,CAAC,CAAC,UAAU;CACf,CACJ,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,SAAS,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC;IAChB,aAAa,EAAE,CAAC,CAAC,SAAS,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC;IACpB,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC;IAClB,OAAO,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,EAAE,iBAAiB,CAAC;IACxB,eAAe,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;CACvC,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,iBAiBL,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,CAAC,QAAQ,SAAS,OAAO,GAAG,OAAO,IAC3D,OAAO,CACL,IAAI,CACA,QAAQ,EACN,IAAI,GACJ,eAAe,GACf,MAAM,GACN,SAAS,GACT,iBAAiB,GACjB,YAAY,CACjB,CACJ,GACC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC,GAC1C,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,SAAS,OAAO,EAClD,OAAO,kBAAkB,CAAC,QAAQ,CAAC,KACpC,QAuCF,CAAC"}

package/esm/lib/message/command.js

@@ -1,5 +1,6 @@
 import { ulid } from '../../deps/jsr.io/@std/ulid/1.0.0/mod.js';
 import { z } from 'zod';
+import { warnOnInvalidExtensionAttributeNames } from './message.js';
 /**
  * The Zod schema matching the Command type.
  *
@@ -8,7 +9,7 @@ import { z } from 'zod';
  * We do not infer the Command type from this schema because of
  * slow type issues see https://jsr.io/docs/about-slow-types for more details.
  */
-export const commandSchema = z.object({
+export const commandSchema = z.looseObject({
     specversion: z.literal('1.0'),
     id: z.string(),
     correlationid: z.string(),
@@ -31,17 +32,23 @@ export const commandSchema = z.object({
  * to skip properties and use the defaults for the rest.
  */
 export const createCommand = (input) => {
+    const { id, correlationid, time, source, type, subject, data, datacontenttype, dataschema, ...extensions } = input;
+    const correlationIdWithFallback = correlationid ?? ulid();
+    if (Object.keys(extensions).length > 0) {
+        warnOnInvalidExtensionAttributeNames(extensions, correlationIdWithFallback, createCommand);
+    }
     const command = {
         specversion: '1.0',
-        id: input.id ?? ulid(),
-        correlationid: input.correlationid ?? ulid(),
-        time: input.time ?? new Date().toISOString(),
-        source: input.source,
-        type: input.type,
-        ...(input.subject && { subject: input.subject }),
-        data: input.data,
-        datacontenttype: input.datacontenttype ?? 'application/json',
-        ...(input.dataschema && { dataschema: input.dataschema }),
+        id: id ?? ulid(),
+        correlationid: correlationIdWithFallback,
+        time: time ?? new Date().toISOString(),
+        source,
+        type,
+        ...(subject && { subject }),
+        data,
+        datacontenttype: datacontenttype ?? 'application/json',
+        ...(dataschema && { dataschema }),
+        ...extensions,
     };
     return command;
 };

package/esm/lib/message/event.d.ts

@@ -20,6 +20,12 @@ import { z } from 'zod';
  * @property {string} datacontenttype - A MIME type that indicates the format that the data is in (optional).
  * @property {string} dataschema - An absolute URL to the schema that the data adheres to (optional).
  *
+ * Events may include additional CloudEvents extension attributes such as
+ * `metadata` or `authcontext`. Define them on an event-specific schema via
+ * {@link eventSchema.extend} or as an intersection type.
+ *
+ * @see https://github.com/cloudevents/spec/blob/main/cloudevents/spec.md#extension-context-attributes
+ *
  * @template TData - The type of the data.
  *
  * @example
@@ -52,6 +58,10 @@ export type Event<TData = unknown> = {
     datacontenttype?: string;
     dataschema?: string;
 };
+/**
+ * Known event properties handled by {@link createEvent}.
+ */
+type EventKnownProperty = 'specversion' | 'id' | 'correlationid' | 'time' | 'source' | 'type' | 'subject' | 'data' | 'datacontenttype' | 'dataschema';
 /**
  * Type alias for the event data field schema.
  */
@@ -93,7 +103,7 @@ export declare const eventSchema: EventSchemaType;
  * the input is validated against that type. This means fields like
  * `type` and `data` must match the narrower types of `TEvent`.
  */
-export type CreateEventInput<TEvent extends Event = Event> = Partial<Pick<TEvent, 'id' | 'correlationid' | 'time' | 'datacontenttype' | 'dataschema'>> & Pick<TEvent, 'type' | 'source' | 'subject' | 'data'>;
+export type CreateEventInput<TEvent extends Event = Event> = Partial<Pick<TEvent, 'id' | 'correlationid' | 'time' | 'datacontenttype' | 'dataschema'>> & Pick<TEvent, 'type' | 'source' | 'subject' | 'data'> & Partial<Omit<TEvent, EventKnownProperty>>;
 /**
  * Creates an event based on input data with the convenience
  * to skip properties and use the defaults for the rest.

package/esm/lib/message/event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../../src/lib/message/event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,MAAM,KAAK,CAAC,KAAK,GAAG,OAAO,IAAI;IACjC,WAAW,EAAE,KAAK,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,KAAK,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,KAAK,eAAe,GAAG,CAAC,CAAC,QAAQ,CAC7B;IACI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC;IACtC,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;IACxB,CAAC,CAAC,UAAU;CACf,CACJ,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,SAAS,CAAC;IACtC,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC;IAChB,aAAa,EAAE,CAAC,CAAC,SAAS,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC;IACpB,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC;IAClB,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC;IACrB,IAAI,EAAE,eAAe,CAAC;IACtB,eAAe,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;CACvC,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,eAiBxB,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,CAAC,MAAM,SAAS,KAAK,GAAG,KAAK,IACnD,OAAO,CACL,IAAI,CACA,MAAM,EACN,IAAI,GAAG,eAAe,GAAG,MAAM,GAAG,iBAAiB,GAAG,YAAY,CACrE,CACJ,GACC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,SAAS,KAAK,EAC5C,OAAO,gBAAgB,CAAC,MAAM,CAAC,KAChC,MAeF,CAAC"}
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../../src/lib/message/event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,MAAM,KAAK,CAAC,KAAK,GAAG,OAAO,IAAI;IACjC,WAAW,EAAE,KAAK,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,KAAK,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,KAAK,kBAAkB,GACjB,aAAa,GACb,IAAI,GACJ,eAAe,GACf,MAAM,GACN,QAAQ,GACR,MAAM,GACN,SAAS,GACT,MAAM,GACN,iBAAiB,GACjB,YAAY,CAAC;AAEnB;;GAEG;AACH,KAAK,eAAe,GAAG,CAAC,CAAC,QAAQ,CAC7B;IACI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC;IACtC,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;IACxB,CAAC,CAAC,UAAU;CACf,CACJ,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,SAAS,CAAC;IACtC,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC;IAChB,aAAa,EAAE,CAAC,CAAC,SAAS,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC;IACpB,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC;IAClB,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC;IACrB,IAAI,EAAE,eAAe,CAAC;IACtB,eAAe,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;CACvC,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,eAiBL,CAAC;AAEtB;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,CAAC,MAAM,SAAS,KAAK,GAAG,KAAK,IACnD,OAAO,CACL,IAAI,CACA,MAAM,EACN,IAAI,GAAG,eAAe,GAAG,MAAM,GAAG,iBAAiB,GAAG,YAAY,CACrE,CACJ,GACC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC,GACpD,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,SAAS,KAAK,EAC5C,OAAO,gBAAgB,CAAC,MAAM,CAAC,KAChC,MAuCF,CAAC"}

package/esm/lib/message/event.js

@@ -1,5 +1,6 @@
 import { ulid } from '../../deps/jsr.io/@std/ulid/1.0.0/mod.js';
 import { z } from 'zod';
+import { warnOnInvalidExtensionAttributeNames } from './message.js';
 /**
  * The Zod schema matching the Event type.
  *
@@ -8,7 +9,7 @@ import { z } from 'zod';
  * We do not infer the Event type from this schema because of
  * slow type issues see https://jsr.io/docs/about-slow-types for more details.
  */
-export const eventSchema = z.object({
+export const eventSchema = z.looseObject({
     specversion: z.literal('1.0'),
     id: z.string(),
     correlationid: z.string(),
@@ -31,17 +32,23 @@ export const eventSchema = z.object({
  * to skip properties and use the defaults for the rest.
  */
 export const createEvent = (input) => {
+    const { id, correlationid, time, source, type, subject, data, datacontenttype, dataschema, ...extensions } = input;
+    const correlationIdWithFallback = correlationid ?? ulid();
+    if (Object.keys(extensions).length > 0) {
+        warnOnInvalidExtensionAttributeNames(extensions, correlationIdWithFallback, createEvent);
+    }
     const event = {
         specversion: '1.0',
-        id: input.id ?? ulid(),
-        correlationid: input.correlationid ?? ulid(),
-        time: input.time ?? new Date().toISOString(),
-        source: input.source,
-        type: input.type,
-        subject: input.subject,
-        data: input.data,
-        datacontenttype: input.datacontenttype ?? 'application/json',
-        ...(input.dataschema && { dataschema: input.dataschema }),
+        id: id ?? ulid(),
+        correlationid: correlationIdWithFallback,
+        time: time ?? new Date().toISOString(),
+        source,
+        type,
+        subject,
+        data,
+        datacontenttype: datacontenttype ?? 'application/json',
+        ...(dataschema && { dataschema }),
+        ...extensions,
     };
     return event;
 };

package/esm/lib/message/message.d.ts

@@ -15,4 +15,18 @@ import type { Query } from './query.js';
  * @template TData - The type of the data.
  */
 export type Message<TData = unknown> = Command<TData> | Event<TData> | Query<TData>;
+/**
+ * Validates CloudEvents extension attribute names and logs a warning when invalid.
+ *
+ * Called by {@link createCommand}, {@link createEvent}, and {@link createQuery}
+ * to check extension attributes against the CloudEvents naming rules. Invalid
+ * names are logged with a stack trace anchored at the caller function.
+ *
+ * @see https://github.com/cloudevents/spec/blob/main/cloudevents/spec.md#extension-context-attributes
+ *
+ * @param {Record<string, unknown>} extensions - Extension attributes to validate, excluding known CloudEvents context attributes.
+ * @param {string | undefined} correlationId - Optional correlation ID included in the warning log for tracing.
+ * @param {(...args: never[]) => unknown} stackTraceAnchor - Function used to anchor the warning stack trace at the message factory caller (for example {@link createCommand}).
+ */
+export declare const warnOnInvalidExtensionAttributeNames: (extensions: Record<string, unknown>, correlationId: string | undefined, stackTraceAnchor: (...args: never[]) => unknown) => void;
 //# sourceMappingURL=message.d.ts.map

package/esm/lib/message/message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/lib/message/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,OAAO,CAAC,KAAK,GAAG,OAAO,IAC7B,OAAO,CAAC,KAAK,CAAC,GACd,KAAK,CAAC,KAAK,CAAC,GACZ,KAAK,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/lib/message/message.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,OAAO,CAAC,KAAK,GAAG,OAAO,IAC7B,OAAO,CAAC,KAAK,CAAC,GACd,KAAK,CAAC,KAAK,CAAC,GACZ,KAAK,CAAC,KAAK,CAAC,CAAC;AAsCnB;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oCAAoC,GAC7C,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,eAAe,MAAM,GAAG,SAAS,EACjC,kBAAkB,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,KAChD,IAkBF,CAAC"}

package/esm/lib/message/message.js

@@ -1 +1,47 @@
-export {};
+import { getLogger } from '../log/logger.js';
+/**
+ * CloudEvents extension context attribute names must consist of lowercase
+ * ASCII letters or digits.
+ *
+ * @see https://github.com/cloudevents/spec/blob/main/cloudevents/spec.md#extension-context-attributes
+ */
+const getInvalidExtensionAttributeNames = (extensions) => {
+    const EXTENSION_ATTRIBUTE_NAME_PATTERN = /^[a-z0-9]+$/;
+    return Object.keys(extensions).filter((name) => !EXTENSION_ATTRIBUTE_NAME_PATTERN.test(name));
+};
+/**
+ * Create an error object to capture the stack trace for better debugging.
+ */
+const createInvalidExtensionAttributeNamesError = (invalidNames, stackTraceAnchor) => {
+    const error = new Error(`Invalid CloudEvents extension attribute names: ${invalidNames.join(', ')}`);
+    if (typeof Error.captureStackTrace === 'function') {
+        Error.captureStackTrace(error, stackTraceAnchor);
+    }
+    return error;
+};
+/**
+ * Validates CloudEvents extension attribute names and logs a warning when invalid.
+ *
+ * Called by {@link createCommand}, {@link createEvent}, and {@link createQuery}
+ * to check extension attributes against the CloudEvents naming rules. Invalid
+ * names are logged with a stack trace anchored at the caller function.
+ *
+ * @see https://github.com/cloudevents/spec/blob/main/cloudevents/spec.md#extension-context-attributes
+ *
+ * @param {Record<string, unknown>} extensions - Extension attributes to validate, excluding known CloudEvents context attributes.
+ * @param {string | undefined} correlationId - Optional correlation ID included in the warning log for tracing.
+ * @param {(...args: never[]) => unknown} stackTraceAnchor - Function used to anchor the warning stack trace at the message factory caller (for example {@link createCommand}).
+ */
+export const warnOnInvalidExtensionAttributeNames = (extensions, correlationId, stackTraceAnchor) => {
+    const invalidNames = getInvalidExtensionAttributeNames(extensions);
+    if (invalidNames.length === 0) {
+        return;
+    }
+    getLogger().warn({
+        category: 'Nimbus',
+        message: 'Extension attribute names must use lowercase ASCII letters or digits only per CloudEvents specification.',
+        data: { invalidAttributeNames: invalidNames },
+        error: createInvalidExtensionAttributeNamesError(invalidNames, stackTraceAnchor),
+        ...(correlationId && { correlationId }),
+    });
+};

package/esm/lib/message/query.d.ts

@@ -18,6 +18,12 @@ import { z } from 'zod';
  * @property {string} datacontenttype - A MIME type that indicates the format that the data is in (optional).
  * @property {string} dataschema - An absolute URL to the schema that the data adheres to (optional).
  *
+ * Queries may include additional CloudEvents extension attributes such as
+ * `metadata` or `authcontext`. Define them on a query-specific schema via
+ * {@link querySchema.extend} or as an intersection type.
+ *
+ * @see https://github.com/cloudevents/spec/blob/main/cloudevents/spec.md#extension-context-attributes
+ *
  * @template TData - The type of the data.
  *
  * @example
@@ -45,6 +51,10 @@ export type Query<TData = unknown> = {
     datacontenttype?: string;
     dataschema?: string;
 };
+/**
+ * Known query properties handled by {@link createQuery}.
+ */
+type QueryKnownProperty = 'specversion' | 'id' | 'correlationid' | 'time' | 'source' | 'type' | 'data' | 'datacontenttype' | 'dataschema';
 /**
  * Type alias for the query data field schema.
  */
@@ -85,7 +95,7 @@ export declare const querySchema: QuerySchemaType;
  * the input is validated against that type. This means fields like
  * `type` and `data` must match the narrower types of `TQuery`.
  */
-export type CreateQueryInput<TQuery extends Query = Query> = Partial<Pick<TQuery, 'id' | 'correlationid' | 'time' | 'datacontenttype' | 'dataschema'>> & Pick<TQuery, 'type' | 'source' | 'data'>;
+export type CreateQueryInput<TQuery extends Query = Query> = Partial<Pick<TQuery, 'id' | 'correlationid' | 'time' | 'datacontenttype' | 'dataschema'>> & Pick<TQuery, 'type' | 'source' | 'data'> & Partial<Omit<TQuery, QueryKnownProperty>>;
 /**
  * Creates a query based on input data with the convenience
  * to skip properties and use the defaults for the rest.

package/esm/lib/message/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/lib/message/query.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,MAAM,KAAK,CAAC,KAAK,GAAG,OAAO,IAAI;IACjC,WAAW,EAAE,KAAK,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,KAAK,eAAe,GAAG,CAAC,CAAC,QAAQ,CAC7B;IACI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC;IACtC,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;IACxB,CAAC,CAAC,UAAU;CACf,CACJ,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,SAAS,CAAC;IACtC,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC;IAChB,aAAa,EAAE,CAAC,CAAC,SAAS,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC;IACpB,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC;IAClB,IAAI,EAAE,eAAe,CAAC;IACtB,eAAe,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;CACvC,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,eAgBxB,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,CAAC,MAAM,SAAS,KAAK,GAAG,KAAK,IACnD,OAAO,CACL,IAAI,CACA,MAAM,EACN,IAAI,GAAG,eAAe,GAAG,MAAM,GAAG,iBAAiB,GAAG,YAAY,CACrE,CACJ,GACC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,SAAS,KAAK,EAC5C,OAAO,gBAAgB,CAAC,MAAM,CAAC,KAChC,MAcF,CAAC"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/lib/message/query.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,MAAM,KAAK,CAAC,KAAK,GAAG,OAAO,IAAI;IACjC,WAAW,EAAE,KAAK,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,KAAK,kBAAkB,GACjB,aAAa,GACb,IAAI,GACJ,eAAe,GACf,MAAM,GACN,QAAQ,GACR,MAAM,GACN,MAAM,GACN,iBAAiB,GACjB,YAAY,CAAC;AAEnB;;GAEG;AACH,KAAK,eAAe,GAAG,CAAC,CAAC,QAAQ,CAC7B;IACI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC;IACtC,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;IACxB,CAAC,CAAC,UAAU;CACf,CACJ,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,SAAS,CAAC;IACtC,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC;IAChB,aAAa,EAAE,CAAC,CAAC,SAAS,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC;IACpB,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC;IAClB,IAAI,EAAE,eAAe,CAAC;IACtB,eAAe,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;CACvC,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,eAgBL,CAAC;AAEtB;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,CAAC,MAAM,SAAS,KAAK,GAAG,KAAK,IACnD,OAAO,CACL,IAAI,CACA,MAAM,EACN,IAAI,GAAG,eAAe,GAAG,MAAM,GAAG,iBAAiB,GAAG,YAAY,CACrE,CACJ,GACC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,SAAS,KAAK,EAC5C,OAAO,gBAAgB,CAAC,MAAM,CAAC,KAChC,MAqCF,CAAC"}

package/esm/lib/message/query.js

@@ -1,5 +1,6 @@
 import { ulid } from '../../deps/jsr.io/@std/ulid/1.0.0/mod.js';
 import { z } from 'zod';
+import { warnOnInvalidExtensionAttributeNames } from './message.js';
 /**
  * The Zod schema matching the Query type.
  *
@@ -8,7 +9,7 @@ import { z } from 'zod';
  * We do not infer the Query type from this schema because of
  * slow type issues see https://jsr.io/docs/about-slow-types for more details.
  */
-export const querySchema = z.object({
+export const querySchema = z.looseObject({
     specversion: z.literal('1.0'),
     id: z.string(),
     correlationid: z.string(),
@@ -30,16 +31,22 @@ export const querySchema = z.object({
  * to skip properties and use the defaults for the rest.
  */
 export const createQuery = (input) => {
+    const { id, correlationid, time, source, type, data, datacontenttype, dataschema, ...extensions } = input;
+    const correlationIdWithFallback = correlationid ?? ulid();
+    if (Object.keys(extensions).length > 0) {
+        warnOnInvalidExtensionAttributeNames(extensions, correlationIdWithFallback, createQuery);
+    }
     const query = {
         specversion: '1.0',
-        id: input.id ?? ulid(),
-        correlationid: input.correlationid ?? ulid(),
-        time: input.time ?? new Date().toISOString(),
-        source: input.source,
-        type: input.type,
-        data: input.data,
-        datacontenttype: input.datacontenttype ?? 'application/json',
-        ...(input.dataschema && { dataschema: input.dataschema }),
+        id: id ?? ulid(),
+        correlationid: correlationIdWithFallback,
+        time: time ?? new Date().toISOString(),
+        source,
+        type,
+        data,
+        datacontenttype: datacontenttype ?? 'application/json',
+        ...(dataschema && { dataschema }),
+        ...extensions,
     };
     return query;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimbus-cqrs/core",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "description": "Simplify Event-Driven Applications - Core building blocks of the Nimbus framework.",
   "keywords": [
     "nimbus",
@@ -34,7 +34,7 @@
   },
   "dependencies": {
     "@opentelemetry/api": "^1.9.1",
-    "zod": "^4.3.6"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"