@nwire/messages 0.7.1 → 0.8.0

package/dist/message-contracts.d.ts

@@ -1,4 +1,5 @@
 import type { z, ZodType } from "zod";
+import { type SourceLocation } from "./source-location.js";
 /**
  * Workspace alias for "any zod schema". Zod 4 dropped the `ZodTypeAny`
  * export; this alias keeps the rest of the codebase reading naturally
@@ -102,6 +103,8 @@ export interface EventMessageOf<TSchema extends ZodTypeAny> {
 export type EventDefinition<TSchema extends ZodTypeAny = ZodTypeAny> = EventDefinitionMeta<TSchema> & ((payload: z.output<TSchema>) => EventMessageOf<TSchema>) & {
     /** Module-manifest visibility marker. See `defineWorkflow.public()` notes. */
     readonly $public?: true;
+    /** Where the event was declared. Studio uses this for IDE-open links. */
+    readonly $source?: SourceLocation;
     /** Return a callable event clone with `$public: true`. */
     public: () => EventDefinition<TSchema>;
 };

package/dist/message-contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-contracts.d.ts","sourceRoot":"","sources":["../src/message-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEtC;;;;;;;;GAQG;AAEH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;AAEtC,MAAM,WAAW,iBAAiB,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAE3E;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC;AAElD,MAAM,WAAW,mBAAmB,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,8BAA8B;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,UAAU;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;CACrC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,eAAe,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU,IACjE,mBAAmB,CAAC,OAAO,CAAC,GAC1B,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC,GAAG;IAC1D,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;IACxB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;CACxC,CAAC;AAEN,wBAAgB,aAAa,CAAC,OAAO,SAAS,UAAU,EACtD,GAAG,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAC9B,iBAAiB,CAAC,OAAO,CAAC,CAE5B;AAED,wBAAgB,WAAW,CAAC,OAAO,SAAS,UAAU,EACpD,GAAG,EAAE,mBAAmB,CAAC,OAAO,CAAC,GAChC,eAAe,CAAC,OAAO,CAAC,CAgD1B;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAC3F,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC"}
+{"version":3,"file":"message-contracts.d.ts","sourceRoot":"","sources":["../src/message-contracts.ts"],"names":[],"mappings":"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"}

package/dist/message-contracts.js

@@ -1,7 +1,9 @@
+import { captureSourceLocation } from "./source-location.js";
 export function defineCommand(def) {
     return def;
 }
 export function defineEvent(def) {
+    const $source = captureSourceLocation();
     // Infer scope from visibility when not explicit.
     const scope = def.scope ??
         (def.visibility === "internal"
@@ -41,6 +43,7 @@ export function defineEvent(def) {
         version: { value: def.version, enumerable: true },
         toString: { value: () => def.name, enumerable: false },
         public: { value: publicMethod, enumerable: false, configurable: true },
+        $source: { value: $source, enumerable: false, configurable: true },
     });
     return factory;
 }

package/dist/message-contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-contracts.js","sourceRoot":"","sources":["../src/message-contracts.ts"],"names":[],"mappings":"AAuHA,MAAM,UAAU,aAAa,CAC3B,GAA+B;IAE/B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,GAAiC;IAEjC,iDAAiD;IACjD,MAAM,KAAK,GACT,GAAG,CAAC,KAAK;QACT,CAAC,GAAG,CAAC,UAAU,KAAK,UAAU;YAC5B,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,GAAG,CAAC,UAAU,KAAK,QAAQ;gBAC3B,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,SAAS,CAAC,CAAC;IACnB,2CAA2C;IAC3C,IAAI,KAAK,KAAK,aAAa,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CACb,gBAAgB,GAAG,CAAC,IAAI,4DAA4D,CACrF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,OAA0B,EAA2B,EAAE,CAAC,CAAC;QACxE,SAAS,EAAE,GAAG,CAAC,IAAI;QACnB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAsB;KACxD,CAAC,CAAC;IAEH,kEAAkE;IAClE,uEAAuE;IACvE,oEAAoE;IACpE,MAAM,YAAY,GAAG,SAAS,YAAY;QACxC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE;YACvC,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE;QAC/B,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE;QAC/D,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE;QAC/C,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE;QACzD,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE;QACvD,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE;QACjD,cAAc,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,cAAc,EAAE,UAAU,EAAE,IAAI,EAAE;QAC/D,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE;QACnD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;QACzC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE;QACjD,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE;QACtD,MAAM,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE;KACvE,CAAC,CAAC;IACH,OAAO,OAAmC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"message-contracts.js","sourceRoot":"","sources":["../src/message-contracts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAuB,MAAM,mBAAmB,CAAC;AAyH/E,MAAM,UAAU,aAAa,CAC3B,GAA+B;IAE/B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,GAAiC;IAEjC,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;IACxC,iDAAiD;IACjD,MAAM,KAAK,GACT,GAAG,CAAC,KAAK;QACT,CAAC,GAAG,CAAC,UAAU,KAAK,UAAU;YAC5B,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,GAAG,CAAC,UAAU,KAAK,QAAQ;gBAC3B,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,SAAS,CAAC,CAAC;IACnB,2CAA2C;IAC3C,IAAI,KAAK,KAAK,aAAa,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CACb,gBAAgB,GAAG,CAAC,IAAI,4DAA4D,CACrF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,OAA0B,EAA2B,EAAE,CAAC,CAAC;QACxE,SAAS,EAAE,GAAG,CAAC,IAAI;QACnB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAsB;KACxD,CAAC,CAAC;IAEH,kEAAkE;IAClE,uEAAuE;IACvE,oEAAoE;IACpE,MAAM,YAAY,GAAG,SAAS,YAAY;QACxC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE;YACvC,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE;QAC/B,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE;QAC/D,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE;QAC/C,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE;QACzD,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE;QACvD,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE;QACjD,cAAc,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,cAAc,EAAE,UAAU,EAAE,IAAI,EAAE;QAC/D,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE;QACnD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;QACzC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE;QACjD,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE;QACtD,MAAM,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE;QACtE,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE;KACnE,CAAC,CAAC;IACH,OAAO,OAAmC,CAAC;AAC7C,CAAC"}

package/dist/messages.d.ts

@@ -10,4 +10,6 @@
 export { defineCommand, defineEvent, type CommandDefinition, type EventDefinition, type EventDefinitionMeta, type EventMessageOf, type CommandPayload, type EventPayload, type EventVisibility, type EventOutcome, type EventScope, type ZodTypeAny, } from "./message-contracts.js";
 export { NoopCommand } from "./commands/noop.command.js";
 export { ServiceBootedEvent } from "./events/service-booted.event.js";
+export { captureSourceLocation, type SourceLocation } from "./source-location.js";
+export { VALIDATED, markValidated, isValidated, type Validated } from "./validated.js";
 //# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,aAAa,EACb,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,aAAa,EACb,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EAAE,qBAAqB,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE/E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/messages.js

@@ -10,4 +10,6 @@
 export { defineCommand, defineEvent, } from "./message-contracts.js";
 export { NoopCommand } from "./commands/noop.command.js";
 export { ServiceBootedEvent } from "./events/service-booted.event.js";
+export { captureSourceLocation } from "./source-location.js";
+export { VALIDATED, markValidated, isValidated } from "./validated.js";
 //# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,aAAa,EACb,WAAW,GAWZ,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,aAAa,EACb,WAAW,GAWZ,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EAAE,qBAAqB,EAAuB,MAAM,mBAAmB,CAAC;AAE/E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAkB,MAAM,aAAa,CAAC"}

package/dist/source-location.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Capture the source location of a `defineX` call so Studio can show
+ * "open in IDE" links next to every primitive.
+ *
+ * Walks the V8 stack at call time, skips frames inside `@nwire/*` and
+ * `packages/nwire-*` (the framework's own files), and returns the first
+ * user-code frame as `{ file, line, column }`.
+ *
+ * Cost: one synthetic `Error` per `defineX` call, paid once at module
+ * load. Negligible.
+ */
+export interface SourceLocation {
+    /** Absolute filesystem path, as V8 emits it. */
+    readonly file: string;
+    readonly line: number;
+    readonly column?: number;
+}
+/**
+ * Returns the caller's source location, skipping `skipFrames` immediate
+ * frames (default 1 — the caller itself) and any frame inside an `@nwire/*`
+ * package. Returns `undefined` if no user frame can be parsed (rare; happens
+ * inside REPLs and minified bundles).
+ */
+export declare function captureSourceLocation(skipFrames?: number): SourceLocation | undefined;
+//# sourceMappingURL=source-location.d.ts.map

package/dist/source-location.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-location.d.ts","sourceRoot":"","sources":["../src/source-location.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAWD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,SAAI,GAAG,cAAc,GAAG,SAAS,CAuBhF"}

package/dist/source-location.js

@@ -0,0 +1,52 @@
+/**
+ * Capture the source location of a `defineX` call so Studio can show
+ * "open in IDE" links next to every primitive.
+ *
+ * Walks the V8 stack at call time, skips frames inside `@nwire/*` and
+ * `packages/nwire-*` (the framework's own files), and returns the first
+ * user-code frame as `{ file, line, column }`.
+ *
+ * Cost: one synthetic `Error` per `defineX` call, paid once at module
+ * load. Negligible.
+ */
+// `[\\/]` matches either POSIX (`/`) or Windows (`\`) path separators —
+// V8 stack frames emit native separators per-platform, so the regex must
+// accept both. Without this, every Win stack frame slipped past the filter
+// and Studio's "open in IDE" link pointed at framework source.
+const NWIRE_FRAME_RE = /(node_modules[\\/](@nwire[\\/]|\.pnpm[\\/]@nwire\+)|packages[\\/]nwire-)/;
+const PAREN_RE = /\(([^()]+):(\d+):(\d+)\)\s*$/; // at someFn (/path:42:17)
+const PLAIN_RE = /\s+at\s+([^()\s]+):(\d+):(\d+)\s*$/; // at /path:42:17 (anon)
+/**
+ * Returns the caller's source location, skipping `skipFrames` immediate
+ * frames (default 1 — the caller itself) and any frame inside an `@nwire/*`
+ * package. Returns `undefined` if no user frame can be parsed (rare; happens
+ * inside REPLs and minified bundles).
+ */
+export function captureSourceLocation(skipFrames = 1) {
+    const origLimit = Error.stackTraceLimit;
+    Error.stackTraceLimit = 30;
+    const err = new Error();
+    Error.stackTraceLimit = origLimit;
+    if (!err.stack)
+        return undefined;
+    // Drop the first line ("Error") + however many frames the caller asked to skip.
+    const lines = err.stack.split("\n").slice(1 + skipFrames);
+    for (const raw of lines) {
+        if (NWIRE_FRAME_RE.test(raw))
+            continue;
+        const m = raw.match(PAREN_RE) ?? raw.match(PLAIN_RE);
+        if (!m)
+            continue;
+        const file = m[1];
+        // Internal frames sometimes show up as `node:internal/...` — skip.
+        if (file.startsWith("node:"))
+            continue;
+        return {
+            file,
+            line: Number(m[2]),
+            column: Number(m[3]),
+        };
+    }
+    return undefined;
+}
+//# sourceMappingURL=source-location.js.map

package/dist/source-location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-location.js","sourceRoot":"","sources":["../src/source-location.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,wEAAwE;AACxE,yEAAyE;AACzE,2EAA2E;AAC3E,+DAA+D;AAC/D,MAAM,cAAc,GAAG,0EAA0E,CAAC;AAElG,MAAM,QAAQ,GAAI,8BAA8B,CAAC,CAAG,0BAA0B;AAC9E,MAAM,QAAQ,GAAI,oCAAoC,CAAC,CAAC,wBAAwB;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAU,GAAG,CAAC;IAClD,MAAM,SAAS,GAAG,KAAK,CAAC,eAAe,CAAC;IACxC,KAAK,CAAC,eAAe,GAAG,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;IACxB,KAAK,CAAC,eAAe,GAAG,SAAS,CAAC;IAClC,IAAI,CAAC,GAAG,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAEjC,gFAAgF;IAChF,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;IAC1D,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,SAAS;QACvC,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACnB,mEAAmE;QACnE,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,SAAS;QACvC,OAAO;YACL,IAAI;YACJ,IAAI,EAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;YACrB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;SACtB,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/validated.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `Validated<T>` — a brand marker for data already validated against its
+ * action / query / event schema.
+ *
+ * The framework parses input at trust boundaries (HTTP `parseAndValidate`,
+ * queue worker consume, bus inbound). The same data then flows into
+ * `runtime.dispatch`, which historically re-parses it against
+ * `action.schema`. That second parse is dead work — the data already
+ * matches `z.output<TSchema>`.
+ *
+ * This brand lets a boundary stamp its output as "trust me, I already
+ * parsed this" so the runtime can skip the redundant parse. Untrusted
+ * call sites (a user calling `runtime.dispatch(action, rawJson)` from
+ * application code) still hit the parse path because their input is
+ * unbranded.
+ *
+ * Design choices:
+ * - Symbol key, not a string field: cannot be accidentally serialized
+ *   over the wire. A branded object that's JSON.stringified loses the
+ *   brand — exactly what we want for cross-process boundaries.
+ * - Non-enumerable property: `Object.assign`, spread, and JSON
+ *   serialization all drop the marker, so a re-shaped object loses
+ *   its validation claim and the runtime safely re-parses.
+ * - Type brand is a phantom field on `T & { [VALIDATED]?: true }`,
+ *   not a wrapper — boundary code passes the same object through, just
+ *   tagged. Zero allocation for the type, one defineProperty for the tag.
+ */
+export declare const VALIDATED: unique symbol;
+export type Validated<T> = T & {
+    readonly [VALIDATED]?: true;
+};
+/**
+ * Tag `value` as already validated. The brand survives identity but not
+ * structural copies — by design, so `{...validated}` or `JSON.parse` drops
+ * the claim and forces re-parse at the next boundary.
+ *
+ * Returns the same object reference (for primitives, returns the
+ * primitive unchanged — primitives can't carry brands, and the runtime
+ * detection falls back to the parse path).
+ */
+export declare function markValidated<T>(value: T): Validated<T>;
+/** True if `value` carries the validated brand. */
+export declare function isValidated(value: unknown): boolean;
+//# sourceMappingURL=validated.d.ts.map

package/dist/validated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validated.d.ts","sourceRoot":"","sources":["../src/validated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,eAAO,MAAM,SAAS,EAAE,OAAO,MAAgD,CAAC;AAEhF,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAE/D;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAWvD;AAED,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMnD"}

package/dist/validated.js

@@ -0,0 +1,56 @@
+/**
+ * `Validated<T>` — a brand marker for data already validated against its
+ * action / query / event schema.
+ *
+ * The framework parses input at trust boundaries (HTTP `parseAndValidate`,
+ * queue worker consume, bus inbound). The same data then flows into
+ * `runtime.dispatch`, which historically re-parses it against
+ * `action.schema`. That second parse is dead work — the data already
+ * matches `z.output<TSchema>`.
+ *
+ * This brand lets a boundary stamp its output as "trust me, I already
+ * parsed this" so the runtime can skip the redundant parse. Untrusted
+ * call sites (a user calling `runtime.dispatch(action, rawJson)` from
+ * application code) still hit the parse path because their input is
+ * unbranded.
+ *
+ * Design choices:
+ * - Symbol key, not a string field: cannot be accidentally serialized
+ *   over the wire. A branded object that's JSON.stringified loses the
+ *   brand — exactly what we want for cross-process boundaries.
+ * - Non-enumerable property: `Object.assign`, spread, and JSON
+ *   serialization all drop the marker, so a re-shaped object loses
+ *   its validation claim and the runtime safely re-parses.
+ * - Type brand is a phantom field on `T & { [VALIDATED]?: true }`,
+ *   not a wrapper — boundary code passes the same object through, just
+ *   tagged. Zero allocation for the type, one defineProperty for the tag.
+ */
+export const VALIDATED = Symbol.for("@nwire/messages/validated");
+/**
+ * Tag `value` as already validated. The brand survives identity but not
+ * structural copies — by design, so `{...validated}` or `JSON.parse` drops
+ * the claim and forces re-parse at the next boundary.
+ *
+ * Returns the same object reference (for primitives, returns the
+ * primitive unchanged — primitives can't carry brands, and the runtime
+ * detection falls back to the parse path).
+ */
+export function markValidated(value) {
+    if (value === null || (typeof value !== "object" && typeof value !== "function")) {
+        return value;
+    }
+    Object.defineProperty(value, VALIDATED, {
+        value: true,
+        enumerable: false,
+        configurable: true,
+        writable: false,
+    });
+    return value;
+}
+/** True if `value` carries the validated brand. */
+export function isValidated(value) {
+    return (value !== null &&
+        (typeof value === "object" || typeof value === "function") &&
+        value[VALIDATED] === true);
+}
+//# sourceMappingURL=validated.js.map

package/dist/validated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validated.js","sourceRoot":"","sources":["../src/validated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,MAAM,CAAC,MAAM,SAAS,GAAkB,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAIhF;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAI,KAAQ;IACvC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,EAAE,CAAC;QACjF,OAAO,KAAqB,CAAC;IAC/B,CAAC;IACD,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE;QACtC,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,KAAK;QACjB,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,OAAO,KAAqB,CAAC;AAC/B,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,KAAK,KAAK,IAAI;QACd,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;QACzD,KAAiC,CAAC,SAAS,CAAC,KAAK,IAAI,CACvD,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nwire/messages",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "Nwire — typed command and event contracts. defineCommand, defineEvent with public/internal visibility. Zod-validated; shareable across the backend, frontends, BFFs.",
   "keywords": [
     "commands",