@nwire/forge 0.7.1 → 0.8.17
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +169 -79
- package/dist/__tests__/action-hooks.test.d.ts +8 -0
- package/dist/__tests__/action-hooks.test.d.ts.map +1 -0
- package/dist/__tests__/action-hooks.test.js +95 -0
- package/dist/__tests__/action-hooks.test.js.map +1 -0
- package/dist/__tests__/actor-workflow-hooks.test.d.ts +8 -0
- package/dist/__tests__/actor-workflow-hooks.test.d.ts.map +1 -0
- package/dist/__tests__/actor-workflow-hooks.test.js +106 -0
- package/dist/__tests__/actor-workflow-hooks.test.js.map +1 -0
- package/dist/__tests__/lifecycle-logging.test.js +4 -2
- package/dist/__tests__/lifecycle-logging.test.js.map +1 -1
- package/dist/__tests__/plugin-app-narrow.test.d.ts +12 -0
- package/dist/__tests__/plugin-app-narrow.test.d.ts.map +1 -0
- package/dist/__tests__/plugin-app-narrow.test.js +77 -0
- package/dist/__tests__/plugin-app-narrow.test.js.map +1 -0
- package/dist/__tests__/plugin-stress.test.d.ts +21 -0
- package/dist/__tests__/plugin-stress.test.d.ts.map +1 -0
- package/dist/__tests__/plugin-stress.test.js +203 -0
- package/dist/__tests__/plugin-stress.test.js.map +1 -0
- package/dist/__tests__/public-marker.test.js +7 -3
- package/dist/__tests__/public-marker.test.js.map +1 -1
- package/dist/actor-store.d.ts +24 -0
- package/dist/actor-store.d.ts.map +1 -1
- package/dist/actor-store.js +29 -0
- package/dist/actor-store.js.map +1 -1
- package/dist/create-app.d.ts +16 -1
- package/dist/create-app.d.ts.map +1 -1
- package/dist/create-app.js +126 -19
- package/dist/create-app.js.map +1 -1
- package/dist/define-action.d.ts +75 -9
- package/dist/define-action.d.ts.map +1 -1
- package/dist/define-action.js +103 -26
- package/dist/define-action.js.map +1 -1
- package/dist/define-actor.d.ts +3 -1
- package/dist/define-actor.d.ts.map +1 -1
- package/dist/define-actor.js +11 -4
- package/dist/define-actor.js.map +1 -1
- package/dist/define-handler.d.ts +39 -3
- package/dist/define-handler.d.ts.map +1 -1
- package/dist/define-handler.js +10 -1
- package/dist/define-handler.js.map +1 -1
- package/dist/define-module.d.ts +3 -0
- package/dist/define-module.d.ts.map +1 -1
- package/dist/define-module.js +3 -0
- package/dist/define-module.js.map +1 -1
- package/dist/define-plugin.d.ts +25 -1
- package/dist/define-plugin.d.ts.map +1 -1
- package/dist/define-plugin.js +100 -14
- package/dist/define-plugin.js.map +1 -1
- package/dist/define-projection.d.ts +3 -1
- package/dist/define-projection.d.ts.map +1 -1
- package/dist/define-projection.js +3 -0
- package/dist/define-projection.js.map +1 -1
- package/dist/define-query.d.ts +69 -13
- package/dist/define-query.d.ts.map +1 -1
- package/dist/define-query.js +48 -17
- package/dist/define-query.js.map +1 -1
- package/dist/define-workflow.d.ts +19 -1
- package/dist/define-workflow.d.ts.map +1 -1
- package/dist/define-workflow.js +4 -0
- package/dist/define-workflow.js.map +1 -1
- package/dist/dev-logger.d.ts.map +1 -1
- package/dist/dev-logger.js +22 -1
- package/dist/dev-logger.js.map +1 -1
- package/dist/event-message.d.ts +9 -2
- package/dist/event-message.d.ts.map +1 -1
- package/dist/event-message.js +10 -3
- package/dist/event-message.js.map +1 -1
- package/dist/framework-events.d.ts +1 -64
- package/dist/framework-events.d.ts.map +1 -1
- package/dist/framework-events.js +3 -0
- package/dist/framework-events.js.map +1 -1
- package/dist/idempotency-store.d.ts +35 -0
- package/dist/idempotency-store.d.ts.map +1 -0
- package/dist/idempotency-store.js +32 -0
- package/dist/idempotency-store.js.map +1 -0
- package/dist/index.d.ts +3 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/runtime.d.ts +205 -5
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +518 -48
- package/dist/runtime.js.map +1 -1
- package/package.json +11 -10
package/dist/define-actor.d.ts
CHANGED
|
@@ -44,7 +44,7 @@
|
|
|
44
44
|
* - `ADR-007-declarative-state-via-assign.md` — why `assign` returns partials
|
|
45
45
|
*/
|
|
46
46
|
import type { z } from "zod";
|
|
47
|
-
import type { ZodTypeAny } from "@nwire/messages";
|
|
47
|
+
import type { ZodTypeAny, SourceLocation } from "@nwire/messages";
|
|
48
48
|
import type { EventDefinition } from "@nwire/messages";
|
|
49
49
|
import { type SchemaDefinition } from "./define-schema.js";
|
|
50
50
|
/**
|
|
@@ -224,6 +224,8 @@ export interface ActorDefinition<TSchema extends ZodTypeAny = ZodTypeAny, TMetho
|
|
|
224
224
|
payload: unknown;
|
|
225
225
|
}>;
|
|
226
226
|
};
|
|
227
|
+
/** Where the actor was declared. Studio uses this for IDE-open links. */
|
|
228
|
+
readonly $source?: SourceLocation;
|
|
227
229
|
}
|
|
228
230
|
/**
|
|
229
231
|
* The shape returned by `ctx.use(Actor, id)`: the loaded `state` plus every
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"define-actor.d.ts","sourceRoot":"","sources":["../src/define-actor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"define-actor.d.ts","sourceRoot":"","sources":["../src/define-actor.ts"],"names":[],"mappings":"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"}
|
package/dist/define-actor.js
CHANGED
|
@@ -43,32 +43,39 @@
|
|
|
43
43
|
* - `ADR-006-actors-vs-reactions.md` — when to use defineActor vs `when`
|
|
44
44
|
* - `ADR-007-declarative-state-via-assign.md` — why `assign` returns partials
|
|
45
45
|
*/
|
|
46
|
+
import { captureSourceLocation } from "@nwire/messages";
|
|
46
47
|
import { isSchemaDefinition } from "./define-schema.js";
|
|
47
48
|
export function defineActor(
|
|
48
49
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
49
50
|
...args) {
|
|
51
|
+
const $source = captureSourceLocation();
|
|
50
52
|
// Three signatures:
|
|
51
53
|
// (name: string, options: ActorOptions) → classic
|
|
52
54
|
// (options: ActorOptionsBound) → schema-bound object form
|
|
53
55
|
// (schema: SchemaDefinition, body: (ctx) => methods, options?: {...}) → closure form
|
|
54
56
|
const [first, second, third] = args;
|
|
57
|
+
const attach = (def) => Object.defineProperty(def, "$source", {
|
|
58
|
+
value: $source,
|
|
59
|
+
enumerable: false,
|
|
60
|
+
configurable: true,
|
|
61
|
+
});
|
|
55
62
|
// Closure form: first arg is a SchemaDefinition, second is a function.
|
|
56
63
|
if (isSchemaDefinition(first) && typeof second === "function") {
|
|
57
|
-
return defineActorClosure(first,
|
|
64
|
+
return attach(defineActorClosure(first,
|
|
58
65
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
59
|
-
second, (third ?? {}));
|
|
66
|
+
second, (third ?? {})));
|
|
60
67
|
}
|
|
61
68
|
// Schema-bound object form: first arg is an options object with a schema field.
|
|
62
69
|
if (typeof first === "object" &&
|
|
63
70
|
first !== null &&
|
|
64
71
|
isSchemaDefinition(first.schema)) {
|
|
65
|
-
return defineActorBound(first);
|
|
72
|
+
return attach(defineActorBound(first));
|
|
66
73
|
}
|
|
67
74
|
// Classic form.
|
|
68
75
|
if (typeof first !== "string" || !second) {
|
|
69
76
|
throw new Error("defineActor: signatures are (name, options) | (boundOptions) | (schema, closure, options?).");
|
|
70
77
|
}
|
|
71
|
-
return defineActorClassic(first, second);
|
|
78
|
+
return attach(defineActorClassic(first, second));
|
|
72
79
|
}
|
|
73
80
|
/**
|
|
74
81
|
* Closure-form implementation.
|
package/dist/define-actor.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"define-actor.js","sourceRoot":"","sources":["../src/define-actor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAKH,OAAO,EAAE,kBAAkB,EAAyB,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"define-actor.js","sourceRoot":"","sources":["../src/define-actor.ts"],"names":[],"mappings":"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"}
|
package/dist/define-handler.d.ts
CHANGED
|
@@ -18,9 +18,16 @@
|
|
|
18
18
|
* returned events route to actors + workflows and commit atomically.
|
|
19
19
|
*
|
|
20
20
|
* If the handler does pure side effects (no events to commit), return `void`.
|
|
21
|
+
*
|
|
22
|
+
* For CRUD-style handlers that don't emit events but want to surface a small
|
|
23
|
+
* record to the caller (e.g. `{ userId }` for the HTTP layer to echo back),
|
|
24
|
+
* return a plain object. The runtime treats it as a non-event return: nothing
|
|
25
|
+
* is published, and the value flows through `runtime.dispatch`'s return + the
|
|
26
|
+
* `ActionCompleted` framework event. Events vs records are disambiguated by
|
|
27
|
+
* the `eventName` + `payload` shape — plain objects pass straight through.
|
|
21
28
|
*/
|
|
22
29
|
import type { z } from "zod";
|
|
23
|
-
import type { ZodTypeAny } from "@nwire/messages";
|
|
30
|
+
import type { ZodTypeAny, SourceLocation } from "@nwire/messages";
|
|
24
31
|
import type { Container } from "@nwire/container";
|
|
25
32
|
import type { MessageEnvelope } from "@nwire/envelope";
|
|
26
33
|
import type { EventMessage } from "./event-message.js";
|
|
@@ -34,6 +41,23 @@ export interface HandlerContext {
|
|
|
34
41
|
readonly envelope: MessageEnvelope;
|
|
35
42
|
/** Convenience getter — equivalent to `envelope.messageId`. */
|
|
36
43
|
readonly requestId: string;
|
|
44
|
+
/**
|
|
45
|
+
* Cancellation signal for this dispatch. Linked to the caller (e.g.
|
|
46
|
+
* the HTTP request); when the caller closes the connection mid-flight
|
|
47
|
+
* the wire layer aborts the controller and this signal flips.
|
|
48
|
+
*
|
|
49
|
+
* Observation is opt-in — handlers may call `ctx.signal.throwIfAborted()`
|
|
50
|
+
* at await points to bail early. The runtime itself checks
|
|
51
|
+
* `signal.aborted` between retry attempts and skips remaining retries
|
|
52
|
+
* + DLQ when the caller has already given up.
|
|
53
|
+
*
|
|
54
|
+
* When `runtime.dispatch` is invoked without an explicit `signal`, this
|
|
55
|
+
* exposes an `AbortSignal` from a controller the runtime owns — never
|
|
56
|
+
* aborted, so existing handlers see the same "always runs to completion"
|
|
57
|
+
* behavior. Adding `{ signal }` to the dispatch call is the migration
|
|
58
|
+
* point.
|
|
59
|
+
*/
|
|
60
|
+
readonly signal: AbortSignal;
|
|
37
61
|
/** Look up a dependency by name. Shortcut for `container.resolve(name)`. */
|
|
38
62
|
resolve<T = unknown>(name: string): T;
|
|
39
63
|
/**
|
|
@@ -88,11 +112,23 @@ export interface HandlerContext {
|
|
|
88
112
|
*/
|
|
89
113
|
externalCall<TRequest extends ZodTypeAny, TResponse extends ZodTypeAny>(call: ExternalCallDefinition<TRequest, TResponse>, request: z.output<TRequest>): Promise<z.output<TResponse>>;
|
|
90
114
|
}
|
|
91
|
-
|
|
115
|
+
/**
|
|
116
|
+
* What a handler may return.
|
|
117
|
+
*
|
|
118
|
+
* - `void` / `null` / `undefined` — pure side-effect handler, nothing to publish.
|
|
119
|
+
* - `EventMessage` / `EventMessage[]` — events the runtime publishes atomically.
|
|
120
|
+
* - `Record<string, unknown>` — a plain data record (e.g. `{ userId }`) that
|
|
121
|
+
* is NOT published. It flows out via `runtime.dispatch`'s return value and
|
|
122
|
+
* the `ActionCompleted` framework event. Distinguished from `EventMessage`
|
|
123
|
+
* at runtime by the missing `eventName` + `payload` shape.
|
|
124
|
+
*/
|
|
125
|
+
export type HandlerReturn = void | EventMessage | EventMessage[] | Record<string, unknown> | null;
|
|
92
126
|
export interface HandlerDefinition<TSchema extends ZodTypeAny = ZodTypeAny> {
|
|
93
|
-
readonly $kind: "
|
|
127
|
+
readonly $kind: "handler";
|
|
94
128
|
readonly action: ActionDefinition<TSchema>;
|
|
95
129
|
readonly handler: (input: z.output<TSchema>, ctx: HandlerContext) => Promise<HandlerReturn> | HandlerReturn;
|
|
130
|
+
/** Where the handler was declared. Studio uses this for IDE-open links. */
|
|
131
|
+
readonly $source?: SourceLocation;
|
|
96
132
|
}
|
|
97
133
|
export declare function defineHandler<TSchema extends ZodTypeAny>(action: ActionDefinition<TSchema>, handler: HandlerDefinition<TSchema>["handler"]): HandlerDefinition<TSchema>;
|
|
98
134
|
//# sourceMappingURL=define-handler.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"define-handler.d.ts","sourceRoot":"","sources":["../src/define-handler.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"define-handler.d.ts","sourceRoot":"","sources":["../src/define-handler.ts"],"names":[],"mappings":"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"}
|
package/dist/define-handler.js
CHANGED
|
@@ -18,12 +18,21 @@
|
|
|
18
18
|
* returned events route to actors + workflows and commit atomically.
|
|
19
19
|
*
|
|
20
20
|
* If the handler does pure side effects (no events to commit), return `void`.
|
|
21
|
+
*
|
|
22
|
+
* For CRUD-style handlers that don't emit events but want to surface a small
|
|
23
|
+
* record to the caller (e.g. `{ userId }` for the HTTP layer to echo back),
|
|
24
|
+
* return a plain object. The runtime treats it as a non-event return: nothing
|
|
25
|
+
* is published, and the value flows through `runtime.dispatch`'s return + the
|
|
26
|
+
* `ActionCompleted` framework event. Events vs records are disambiguated by
|
|
27
|
+
* the `eventName` + `payload` shape — plain objects pass straight through.
|
|
21
28
|
*/
|
|
29
|
+
import { captureSourceLocation } from "@nwire/messages";
|
|
22
30
|
export function defineHandler(action, handler) {
|
|
23
31
|
return {
|
|
24
|
-
$kind: "
|
|
32
|
+
$kind: "handler",
|
|
25
33
|
action,
|
|
26
34
|
handler,
|
|
35
|
+
$source: captureSourceLocation(),
|
|
27
36
|
};
|
|
28
37
|
}
|
|
29
38
|
//# sourceMappingURL=define-handler.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"define-handler.js","sourceRoot":"","sources":["../src/define-handler.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"define-handler.js","sourceRoot":"","sources":["../src/define-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAwHxD,MAAM,UAAU,aAAa,CAC3B,MAAiC,EACjC,OAA8C;IAE9C,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,MAAM;QACN,OAAO;QACP,OAAO,EAAE,qBAAqB,EAAE;KACjC,CAAC;AACJ,CAAC"}
|
package/dist/define-module.d.ts
CHANGED
|
@@ -17,6 +17,7 @@
|
|
|
17
17
|
* find every surface in the module. The module is what `createApp` registers
|
|
18
18
|
* with the runtime.
|
|
19
19
|
*/
|
|
20
|
+
import { type SourceLocation } from "@nwire/messages";
|
|
20
21
|
import type { ActionDefinition } from "./define-action.js";
|
|
21
22
|
import type { ActorDefinition } from "./define-actor.js";
|
|
22
23
|
import type { HandlerDefinition } from "./define-handler.js";
|
|
@@ -152,6 +153,8 @@ export interface ModuleDefinition {
|
|
|
152
153
|
readonly name: string;
|
|
153
154
|
readonly manifest: ModuleManifest;
|
|
154
155
|
readonly publicSurface: ModulePublicSurface;
|
|
156
|
+
/** Where the module was declared. Studio uses this for IDE-open links. */
|
|
157
|
+
readonly $source?: SourceLocation;
|
|
155
158
|
}
|
|
156
159
|
export declare function defineModule(name: string, manifest: ModuleManifest): ModuleDefinition;
|
|
157
160
|
//# sourceMappingURL=define-module.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"define-module.d.ts","sourceRoot":"","sources":["../src/define-module.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"define-module.d.ts","sourceRoot":"","sources":["../src/define-module.ts"],"names":[],"mappings":"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"}
|
package/dist/define-module.js
CHANGED
|
@@ -17,6 +17,7 @@
|
|
|
17
17
|
* find every surface in the module. The module is what `createApp` registers
|
|
18
18
|
* with the runtime.
|
|
19
19
|
*/
|
|
20
|
+
import { captureSourceLocation } from "@nwire/messages";
|
|
20
21
|
function namesOf(items) {
|
|
21
22
|
const out = new Set();
|
|
22
23
|
for (const it of items ?? []) {
|
|
@@ -26,6 +27,7 @@ function namesOf(items) {
|
|
|
26
27
|
return out;
|
|
27
28
|
}
|
|
28
29
|
export function defineModule(name, manifest) {
|
|
30
|
+
const $source = captureSourceLocation();
|
|
29
31
|
// If the user split events into domainEvents + integrationEvents, auto-merge
|
|
30
32
|
// into `events` so downstream registries find them. If the user provided
|
|
31
33
|
// their own `events` too, prefer the explicit value.
|
|
@@ -55,6 +57,7 @@ export function defineModule(name, manifest) {
|
|
|
55
57
|
name,
|
|
56
58
|
manifest: { ...manifest, events },
|
|
57
59
|
publicSurface,
|
|
60
|
+
$source,
|
|
58
61
|
};
|
|
59
62
|
}
|
|
60
63
|
//# sourceMappingURL=define-module.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"define-module.js","sourceRoot":"","sources":["../src/define-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;
|
|
1
|
+
{"version":3,"file":"define-module.js","sourceRoot":"","sources":["../src/define-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,qBAAqB,EAAuB,MAAM,iBAAiB,CAAC;AAwJ7E,SAAS,OAAO,CACd,KAA+B;IAE/B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,EAAE,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAC7B,IAAI,EAAE,CAAC,OAAO,KAAK,IAAI;YAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,QAAwB;IACjE,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;IACxC,6EAA6E;IAC7E,yEAAyE;IACzE,qDAAqD;IACrD,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,CAAC;IACxF,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEzE,0EAA0E;IAC1E,mEAAmE;IACnE,yEAAyE;IACzE,qCAAqC;IACrC,MAAM,aAAa,GAAwB;QACzC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;QAClC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;QAClC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;QACtC,MAAM,EAAE,CAAC,GAAG,EAAE;YACZ,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1B,KAAK,MAAM,CAAC,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;gBAC7B,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI;oBAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;qBACjC,IAAK,CAA6B,CAAC,UAAU,KAAK,QAAQ;oBAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACjF,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,EAAE;KACL,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,IAAI;QACJ,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE;QACjC,aAAa;QACb,OAAO;KACR,CAAC;AACJ,CAAC"}
|
package/dist/define-plugin.d.ts
CHANGED
|
@@ -46,12 +46,14 @@
|
|
|
46
46
|
* stop: shutdown plugins in reverse → shutdown providers in reverse
|
|
47
47
|
*/
|
|
48
48
|
import type { Container } from "@nwire/container";
|
|
49
|
+
import { type SourceLocation } from "@nwire/messages";
|
|
49
50
|
import type { DispatchMiddleware, Runtime } from "./runtime.js";
|
|
50
51
|
import type { EventMessage } from "./event-message.js";
|
|
51
52
|
import type { ActorDefinition } from "./define-actor.js";
|
|
52
53
|
import type { MessageEnvelope } from "@nwire/envelope";
|
|
53
54
|
import type { FrameworkEventDefinition } from "./framework-events.js";
|
|
54
55
|
import type { FrameworkEventHandler } from "./framework-event-bus.js";
|
|
56
|
+
import type { AppPluginDefinition } from "@nwire/app";
|
|
55
57
|
/** Hook fired by the runtime after an actor transitions to a new state. */
|
|
56
58
|
export type ActorTransitionHook = (actor: ActorDefinition, key: string, fromState: string, toState: string, event: EventMessage, envelope: MessageEnvelope) => Promise<void> | void;
|
|
57
59
|
export interface PluginActorHooks {
|
|
@@ -141,6 +143,8 @@ export interface PluginDefinition {
|
|
|
141
143
|
readonly middleware?: readonly DispatchMiddleware[];
|
|
142
144
|
/** Actor lifecycle hooks the plugin contributes. */
|
|
143
145
|
readonly actorHooks?: PluginActorHooks;
|
|
146
|
+
/** Call-site of `definePlugin(...)` — Studio + scan render this. */
|
|
147
|
+
readonly $source?: SourceLocation;
|
|
144
148
|
}
|
|
145
149
|
export interface PluginOptions {
|
|
146
150
|
readonly register?: (container: Container) => void;
|
|
@@ -163,9 +167,29 @@ export declare function definePlugin(name: string, options: PluginOptions): Plug
|
|
|
163
167
|
* createApp's plugin-register loop. Returns the bound API + the lists of
|
|
164
168
|
* boot/shutdown functions for createApp to wire into its lifecycle.
|
|
165
169
|
*/
|
|
166
|
-
export declare function buildPluginContext(container: Container, runtime: Runtime, config: Record<string, any
|
|
170
|
+
export declare function buildPluginContext(container: Container, runtime: Runtime, config: Record<string, any>, pluginName?: string): {
|
|
167
171
|
readonly api: PluginContext;
|
|
168
172
|
readonly boots: Array<() => Promise<void> | void>;
|
|
169
173
|
readonly shutdowns: Array<() => Promise<void> | void>;
|
|
170
174
|
};
|
|
175
|
+
/**
|
|
176
|
+
* Adapt a narrow `@nwire/app` plugin into the rich forge `PluginDefinition`
|
|
177
|
+
* createApp expects. The narrow shape (provide / on / boot / shutdown) is a
|
|
178
|
+
* strict subset of the rich shape, so the adaptation is straight forwarding:
|
|
179
|
+
*
|
|
180
|
+
* - `provide(name, lifecycle)` becomes a `bind` whose factory invokes the
|
|
181
|
+
* lifecycle's `boot()` once, plus a shutdown step that runs
|
|
182
|
+
* `lifecycle.shutdown(value)` against the resolved value if it was ever
|
|
183
|
+
* materialized. Lazy resolution matches the rich `bind` contract — a
|
|
184
|
+
* value nobody asks for is never booted (and therefore never torn down).
|
|
185
|
+
* - `on(FrameworkEvent, handler, prio?)` maps 1:1 onto `runtime.onFramework`,
|
|
186
|
+
* which is what the rich `api.on` already does internally.
|
|
187
|
+
* - `boot(fn)` / `shutdown(fn)` map 1:1.
|
|
188
|
+
*
|
|
189
|
+
* The narrow plugin's `setup` may be async; we honor that by returning a
|
|
190
|
+
* Promise from the rich setup. createApp's sync register loop rejects async
|
|
191
|
+
* rich setups today, so app-plugin authors who need async work should put it
|
|
192
|
+
* inside `api.boot(...)` — same rule as forge's closure form.
|
|
193
|
+
*/
|
|
194
|
+
export declare function adaptAppPlugin(app: AppPluginDefinition): PluginDefinition;
|
|
171
195
|
//# sourceMappingURL=define-plugin.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"define-plugin.d.ts","sourceRoot":"","sources":["../src/define-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;
|
|
1
|
+
{"version":3,"file":"define-plugin.d.ts","sourceRoot":"","sources":["../src/define-plugin.ts"],"names":[],"mappings":"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"}
|
package/dist/define-plugin.js
CHANGED
|
@@ -45,13 +45,15 @@
|
|
|
45
45
|
* start: plugin register / setup (sync) → providers boot → plugin boot
|
|
46
46
|
* stop: shutdown plugins in reverse → shutdown providers in reverse
|
|
47
47
|
*/
|
|
48
|
-
import {
|
|
48
|
+
import { captureSourceLocation } from "@nwire/messages";
|
|
49
49
|
export function definePlugin(name, setupOrOptions) {
|
|
50
|
+
const $source = captureSourceLocation();
|
|
50
51
|
if (typeof setupOrOptions === "function") {
|
|
51
52
|
return {
|
|
52
53
|
$kind: "plugin",
|
|
53
54
|
name,
|
|
54
55
|
setup: setupOrOptions,
|
|
56
|
+
$source,
|
|
55
57
|
};
|
|
56
58
|
}
|
|
57
59
|
const opts = setupOrOptions;
|
|
@@ -63,6 +65,7 @@ export function definePlugin(name, setupOrOptions) {
|
|
|
63
65
|
shutdown: opts.shutdown,
|
|
64
66
|
middleware: opts.middleware,
|
|
65
67
|
actorHooks: opts.actorHooks,
|
|
68
|
+
$source,
|
|
66
69
|
};
|
|
67
70
|
}
|
|
68
71
|
/**
|
|
@@ -73,7 +76,7 @@ export function definePlugin(name, setupOrOptions) {
|
|
|
73
76
|
*/
|
|
74
77
|
export function buildPluginContext(container, runtime,
|
|
75
78
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
76
|
-
config) {
|
|
79
|
+
config, pluginName = "anonymous") {
|
|
77
80
|
const boots = [];
|
|
78
81
|
const shutdowns = [];
|
|
79
82
|
const api = {
|
|
@@ -101,20 +104,37 @@ config) {
|
|
|
101
104
|
runtime.onFramework(event, handler, priority);
|
|
102
105
|
},
|
|
103
106
|
before(actionName, handler) {
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
107
|
+
// Register a chain step on the per-action `action.before:<name>`
|
|
108
|
+
// hook. Each plugin's contribution gets its own named step so taps
|
|
109
|
+
// emit a distinct `hook.step` record — the chain is now a first-
|
|
110
|
+
// class observable surface (listHooks() / Studio / OTel see it).
|
|
111
|
+
// Returning false from the handler sets the veto flag the runtime
|
|
112
|
+
// checks immediately after the hook resolves.
|
|
113
|
+
const stepName = `plugin#${pluginName ?? "?"}.before`;
|
|
114
|
+
runtime.ensureActionBeforeHook(actionName).use(async (hctx, next) => {
|
|
115
|
+
const decision = await handler({
|
|
116
|
+
action: hctx.action,
|
|
117
|
+
input: hctx.input,
|
|
118
|
+
ctx: hctx.ctx,
|
|
119
|
+
});
|
|
120
|
+
if (decision === false) {
|
|
121
|
+
hctx.vetoed = true;
|
|
122
|
+
return; // skip `next()` — downstream steps shouldn't run on veto
|
|
123
|
+
}
|
|
124
|
+
await next();
|
|
125
|
+
}, { name: stepName });
|
|
110
126
|
},
|
|
111
127
|
after(actionName, handler) {
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
128
|
+
const stepName = `plugin#${pluginName ?? "?"}.after`;
|
|
129
|
+
runtime.ensureActionAfterHook(actionName).use(async (hctx, next) => {
|
|
130
|
+
await handler({
|
|
131
|
+
action: hctx.action,
|
|
132
|
+
input: hctx.input,
|
|
133
|
+
result: hctx.result,
|
|
134
|
+
durationMs: hctx.durationMs,
|
|
135
|
+
});
|
|
136
|
+
await next();
|
|
137
|
+
}, { name: stepName });
|
|
118
138
|
},
|
|
119
139
|
middleware(mw) {
|
|
120
140
|
runtime.use(mw);
|
|
@@ -131,4 +151,70 @@ config) {
|
|
|
131
151
|
};
|
|
132
152
|
return { api, boots, shutdowns };
|
|
133
153
|
}
|
|
154
|
+
/**
|
|
155
|
+
* Adapt a narrow `@nwire/app` plugin into the rich forge `PluginDefinition`
|
|
156
|
+
* createApp expects. The narrow shape (provide / on / boot / shutdown) is a
|
|
157
|
+
* strict subset of the rich shape, so the adaptation is straight forwarding:
|
|
158
|
+
*
|
|
159
|
+
* - `provide(name, lifecycle)` becomes a `bind` whose factory invokes the
|
|
160
|
+
* lifecycle's `boot()` once, plus a shutdown step that runs
|
|
161
|
+
* `lifecycle.shutdown(value)` against the resolved value if it was ever
|
|
162
|
+
* materialized. Lazy resolution matches the rich `bind` contract — a
|
|
163
|
+
* value nobody asks for is never booted (and therefore never torn down).
|
|
164
|
+
* - `on(FrameworkEvent, handler, prio?)` maps 1:1 onto `runtime.onFramework`,
|
|
165
|
+
* which is what the rich `api.on` already does internally.
|
|
166
|
+
* - `boot(fn)` / `shutdown(fn)` map 1:1.
|
|
167
|
+
*
|
|
168
|
+
* The narrow plugin's `setup` may be async; we honor that by returning a
|
|
169
|
+
* Promise from the rich setup. createApp's sync register loop rejects async
|
|
170
|
+
* rich setups today, so app-plugin authors who need async work should put it
|
|
171
|
+
* inside `api.boot(...)` — same rule as forge's closure form.
|
|
172
|
+
*/
|
|
173
|
+
export function adaptAppPlugin(app) {
|
|
174
|
+
return {
|
|
175
|
+
$kind: "plugin",
|
|
176
|
+
name: app.name,
|
|
177
|
+
$source: app.$source,
|
|
178
|
+
setup(ctx) {
|
|
179
|
+
// bus is exposed on the narrow context for advanced cases (the rich
|
|
180
|
+
// `on` only covers framework events). runtime.frameworkEvents is the
|
|
181
|
+
// same bus the rich api.on writes to, so passing it through is safe.
|
|
182
|
+
const narrow = {
|
|
183
|
+
container: ctx.container,
|
|
184
|
+
bus: ctx.runtime.frameworkEvents,
|
|
185
|
+
provide(name, lifecycle) {
|
|
186
|
+
let booted = false;
|
|
187
|
+
let value;
|
|
188
|
+
ctx.bind(name, () => {
|
|
189
|
+
// The narrow contract permits async boot; bind's factory is
|
|
190
|
+
// sync. We synchronously kick the promise (if any) — consumers
|
|
191
|
+
// resolving an async-provided binding get the Promise back,
|
|
192
|
+
// mirroring what they'd get if they implemented `bind` directly.
|
|
193
|
+
const result = lifecycle.boot();
|
|
194
|
+
booted = true;
|
|
195
|
+
value = result;
|
|
196
|
+
return result;
|
|
197
|
+
});
|
|
198
|
+
if (lifecycle.shutdown) {
|
|
199
|
+
ctx.shutdown(async () => {
|
|
200
|
+
if (!booted)
|
|
201
|
+
return;
|
|
202
|
+
await lifecycle.shutdown(value);
|
|
203
|
+
});
|
|
204
|
+
}
|
|
205
|
+
},
|
|
206
|
+
on(event, handler, priority) {
|
|
207
|
+
ctx.on(event, handler, priority);
|
|
208
|
+
},
|
|
209
|
+
boot(fn) {
|
|
210
|
+
ctx.boot(fn);
|
|
211
|
+
},
|
|
212
|
+
shutdown(fn) {
|
|
213
|
+
ctx.shutdown(fn);
|
|
214
|
+
},
|
|
215
|
+
};
|
|
216
|
+
return app.setup(narrow);
|
|
217
|
+
},
|
|
218
|
+
};
|
|
219
|
+
}
|
|
134
220
|
//# sourceMappingURL=define-plugin.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"define-plugin.js","sourceRoot":"","sources":["../src/define-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;
|
|
1
|
+
{"version":3,"file":"define-plugin.js","sourceRoot":"","sources":["../src/define-plugin.ts"],"names":[],"mappings":"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"}
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
* Side effects (notifications, external sync) belong in `when` reactions, not
|
|
25
25
|
* in projections — projections are pure folds, like `assign`.
|
|
26
26
|
*/
|
|
27
|
-
import type { EventDefinition, EventPayload } from "@nwire/messages";
|
|
27
|
+
import type { EventDefinition, EventPayload, SourceLocation } from "@nwire/messages";
|
|
28
28
|
export type ProjectionReducer<TState, E extends EventDefinition = EventDefinition> = (state: TState, event: EventPayload<E>) => TState;
|
|
29
29
|
/** Studio-aware: declared read-model freshness target. */
|
|
30
30
|
export interface ProjectionFreshness {
|
|
@@ -51,6 +51,8 @@ export interface ProjectionDefinition<TState = unknown> {
|
|
|
51
51
|
readonly on: Readonly<Record<string, ProjectionReducer<TState>>>;
|
|
52
52
|
readonly description?: string;
|
|
53
53
|
readonly freshness?: ProjectionFreshness;
|
|
54
|
+
/** Where the projection was declared. Studio uses this for IDE-open links. */
|
|
55
|
+
readonly $source?: SourceLocation;
|
|
54
56
|
}
|
|
55
57
|
export declare function defineProjection<TState>(name: string, options: ProjectionOptions<TState>): ProjectionDefinition<TState>;
|
|
56
58
|
//# sourceMappingURL=define-projection.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"define-projection.d.ts","sourceRoot":"","sources":["../src/define-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"define-projection.d.ts","sourceRoot":"","sources":["../src/define-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGrF,MAAM,MAAM,iBAAiB,CAAC,MAAM,EAAE,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI,CACnF,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,KACnB,MAAM,CAAC;AAEZ,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB,CAAC,MAAM;IACvC,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,MAAM,CAAC;IAC/B,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACjE,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;CAC1C;AAED,MAAM,WAAW,oBAAoB,CAAC,MAAM,GAAG,OAAO;IACpD,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IACzC,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CACnC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,GACjC,oBAAoB,CAAC,MAAM,CAAC,CAoB9B"}
|
|
@@ -24,7 +24,9 @@
|
|
|
24
24
|
* Side effects (notifications, external sync) belong in `when` reactions, not
|
|
25
25
|
* in projections — projections are pure folds, like `assign`.
|
|
26
26
|
*/
|
|
27
|
+
import { captureSourceLocation } from "@nwire/messages";
|
|
27
28
|
export function defineProjection(name, options) {
|
|
29
|
+
const $source = captureSourceLocation();
|
|
28
30
|
// Validate that every listened event has a reducer.
|
|
29
31
|
for (const event of options.listens) {
|
|
30
32
|
if (!options.on[event.name]) {
|
|
@@ -39,6 +41,7 @@ export function defineProjection(name, options) {
|
|
|
39
41
|
on: options.on,
|
|
40
42
|
description: options.description,
|
|
41
43
|
freshness: options.freshness,
|
|
44
|
+
$source,
|
|
42
45
|
};
|
|
43
46
|
}
|
|
44
47
|
//# sourceMappingURL=define-projection.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"define-projection.js","sourceRoot":"","sources":["../src/define-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;
|
|
1
|
+
{"version":3,"file":"define-projection.js","sourceRoot":"","sources":["../src/define-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAsCxD,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,OAAkC;IAElC,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;IACxC,oDAAoD;IACpD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,qBAAqB,IAAI,cAAc,KAAK,CAAC,IAAI,+CAA+C,CACjG,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO;QACL,KAAK,EAAE,YAAY;QACnB,IAAI;QACJ,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO;KACR,CAAC;AACJ,CAAC"}
|