@nwire/forge 0.13.1 → 0.13.2

package/dist/helpers/validate.d.ts

@@ -23,7 +23,9 @@
  */
 export declare class InvariantError extends Error {
     readonly failures: readonly string[];
-    constructor(failures: readonly string[]);
+    /** Accepts a single failure message or an array — `new InvariantError("…")`
+     * and `new InvariantError(["…", "…"])` both work. */
+    constructor(failures: string | readonly string[]);
 }
 /** A predicate: returns `true` if the invariant holds, or a failure message string. */
 export type Invariant<TInput, TState = unknown> = (input: TInput, state: TState) => true | string;

package/dist/helpers/validate.js

@@ -23,10 +23,13 @@
  */
 export class InvariantError extends Error {
     failures;
+    /** Accepts a single failure message or an array — `new InvariantError("…")`
+     * and `new InvariantError(["…", "…"])` both work. */
     constructor(failures) {
-        super(`Invariant failed: ${failures.join("; ")}`);
+        const list = typeof failures === "string" ? [failures] : failures;
+        super(`Invariant failed: ${list.join("; ")}`);
         this.name = "InvariantError";
-        this.failures = failures;
+        this.failures = list;
     }
 }
 export function validate(input, predicates, state) {

package/dist/plugins/actors-plugin.d.ts

@@ -33,4 +33,4 @@ export interface ActorsPluginOptions {
     /** Override the actor store. Defaults to `InMemoryActorStore`. */
     readonly actorStore?: ActorStore;
 }
-export declare function actorsPlugin(actorTypes: readonly ActorDefinition[], opts?: ActorsPluginOptions): PluginDefinition;
+export declare function actorsPlugin(actorTypes?: readonly ActorDefinition[], opts?: ActorsPluginOptions): PluginDefinition;

package/dist/plugins/actors-plugin.js

@@ -30,7 +30,7 @@ import { ActorChainRunner } from "./actors-chain.js";
 import { FORGE_PUBLISH_BINDING } from "./actions-plugin.js";
 export const FORGE_ACTOR_CHAIN_BINDING = "forge.actorChain";
 export const FORGE_ACTOR_STORE_BINDING = "forge.actorStore";
-export function actorsPlugin(actorTypes, opts = {}) {
+export function actorsPlugin(actorTypes = [], opts = {}) {
     return {
         name: "forge.actors",
         register({ bind }) {
@@ -40,7 +40,16 @@ export function actorsPlugin(actorTypes, opts = {}) {
         setup({ runtime, container }) {
             const store = container.resolve(FORGE_ACTOR_STORE_BINDING);
             const chain = new ActorChainRunner(runtime, store);
-            for (const actor of actorTypes)
+            // The app registers every actor via `runtime.register`; scan the by-kind
+            // registry and merge any explicitly-passed actors (explicit wins on
+            // name). `actorsPlugin()` picks up everything discovered; `actorsPlugin([X])`
+            // still adds X.
+            const byName = new Map();
+            for (const a of runtime.byKind("actor"))
+                byName.set(a.name, a);
+            for (const a of actorTypes)
+                byName.set(a.name, a);
+            for (const actor of byName.values())
                 chain.register(actor);
             container.register(FORGE_ACTOR_CHAIN_BINDING, chain);
             runtime.hooks.LocalDelivery.use(async (payload, next) => {

package/dist/plugins/projections-plugin.d.ts

@@ -33,4 +33,4 @@ export interface ProjectionsPluginOptions {
     /** Override the projection store. Defaults to `InMemoryProjectionStore`. */
     readonly projectionStore?: ProjectionStore;
 }
-export declare function projectionsPlugin(projections: readonly ProjectionDefinition<any>[], opts?: ProjectionsPluginOptions): PluginDefinition;
+export declare function projectionsPlugin(projections?: readonly ProjectionDefinition<any>[], opts?: ProjectionsPluginOptions): PluginDefinition;

package/dist/plugins/projections-plugin.js

@@ -31,7 +31,7 @@ export const FORGE_PROJECTION_CHAIN_BINDING = "forge.projectionChain";
 export const FORGE_PROJECTION_STORE_BINDING = "forge.projectionStore";
 export function projectionsPlugin(
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
-projections, opts = {}) {
+projections = [], opts = {}) {
     return {
         name: "forge.projections",
         register({ bind }) {
@@ -41,9 +41,16 @@ projections, opts = {}) {
         setup({ runtime, container }) {
             const store = container.resolve(FORGE_PROJECTION_STORE_BINDING);
             const chain = new ProjectionChainRunner(runtime, store);
-            for (const projection of projections) {
-                chain.register(projection);
+            // Scan the by-kind registry; merge explicitly-passed projections (explicit
+            // wins on name). `projectionsPlugin()` picks up everything discovered.
+            const byName = new Map();
+            for (const p of runtime.byKind("projection")) {
+                byName.set(p.name, p);
             }
+            for (const p of projections)
+                byName.set(p.name, p);
+            for (const projection of byName.values())
+                chain.register(projection);
             container.register(FORGE_PROJECTION_CHAIN_BINDING, chain);
             runtime.hooks.LocalDelivery.use(async (payload, next) => {
                 await chain.apply({ eventName: payload.eventName, payload: payload.payload }, payload.envelope);

package/dist/plugins/queries-plugin.d.ts

@@ -24,4 +24,13 @@
  */
 import type { PluginDefinition } from "@nwire/app";
 export declare const FORGE_QUERY_RUNNER_BINDING: "forge.queryRunner";
+declare module "@nwire/handler" {
+    interface CtxCapabilities {
+        /** Read through a projection-backed (or handler-form) query by its
+         * definition: `await ctx.query(getUser, input)`. */
+        query<TResult = unknown>(query: {
+            readonly name: string;
+        }, input?: unknown): Promise<TResult>;
+    }
+}
 export declare function queriesPlugin(): PluginDefinition;

package/dist/plugins/workflows-plugin.d.ts

@@ -44,4 +44,4 @@ export interface WorkflowsPluginOptions {
      */
     readonly bus?: EventBus;
 }
-export declare function workflowsPlugin(workflows: readonly WorkflowDefinition[], opts?: WorkflowsPluginOptions): PluginDefinition;
+export declare function workflowsPlugin(workflows?: readonly WorkflowDefinition[], opts?: WorkflowsPluginOptions): PluginDefinition;

package/dist/plugins/workflows-plugin.js

@@ -34,7 +34,7 @@ import { EVENT_PUBLISHING_PRIORITIES } from "../framework-events.js";
 import { WorkflowChainRunner } from "./workflows-chain.js";
 export const FORGE_WORKFLOW_CHAIN_BINDING = "forge.workflowChain";
 export const FORGE_WORKFLOW_TIMER_STORE_BINDING = "forge.workflowTimerStore";
-export function workflowsPlugin(workflows, opts = {}) {
+export function workflowsPlugin(workflows = [], opts = {}) {
     return {
         name: "forge.workflows",
         register({ bind }) {
@@ -61,7 +61,15 @@ export function workflowsPlugin(workflows, opts = {}) {
                 };
                 return effects;
             });
-            for (const workflow of workflows)
+            // Scan the by-kind registry; merge explicitly-passed workflows (explicit
+            // wins on name). `workflowsPlugin()` picks up everything discovered.
+            const byName = new Map();
+            for (const w of runtime.byKind("workflow")) {
+                byName.set(w.name, w);
+            }
+            for (const w of workflows)
+                byName.set(w.name, w);
+            for (const workflow of byName.values())
                 chain.register(workflow);
             container.register(FORGE_WORKFLOW_CHAIN_BINDING, chain);
             runtime.hooks.LocalDelivery.use(async (payload, next) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nwire/forge",
-  "version": "0.13.1",
+  "version": "0.13.2",
   "description": "Nwire — the CQRS battery. Actors, projections, workflows, queries, and the action pipeline, plus outbox/inbox/cron, invariants, and DLQ wiring — installed via forgePlugins / withForge. Opt-in; an app boots without it. The runtime is the bus.",
   "keywords": [
     "actions",
@@ -34,16 +34,16 @@
     "emittery": "1.0.1",
     "koa": "^2.16.4",
     "zod": "^4.0.0",
-    "@nwire/envelope": "0.13.1",
-    "@nwire/dead-letter": "0.13.1",
-    "@nwire/container": "0.13.1",
-    "@nwire/app": "0.13.1",
-    "@nwire/logger": "0.13.1",
-    "@nwire/wires": "0.13.1",
-    "@nwire/bus": "0.13.1",
-    "@nwire/hooks": "0.13.1",
-    "@nwire/messages": "0.13.1",
-    "@nwire/handler": "0.13.1"
+    "@nwire/app": "0.13.2",
+    "@nwire/envelope": "0.13.2",
+    "@nwire/bus": "0.13.2",
+    "@nwire/handler": "0.13.2",
+    "@nwire/dead-letter": "0.13.2",
+    "@nwire/logger": "0.13.2",
+    "@nwire/messages": "0.13.2",
+    "@nwire/wires": "0.13.2",
+    "@nwire/container": "0.13.2",
+    "@nwire/hooks": "0.13.2"
   },
   "devDependencies": {
     "@types/koa": "^2.15.0",