@rotorsoft/act 1.9.0 → 1.10.0

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.
Files changed (39) hide show
  1. package/dist/.tsbuildinfo +1 -1
  2. package/dist/@types/act.d.ts +34 -2
  3. package/dist/@types/act.d.ts.map +1 -1
  4. package/dist/@types/builders/act-builder.d.ts.map +1 -1
  5. package/dist/@types/builders/state-builder.d.ts +31 -1
  6. package/dist/@types/builders/state-builder.d.ts.map +1 -1
  7. package/dist/@types/internal/event-sourcing.d.ts +7 -2
  8. package/dist/@types/internal/event-sourcing.d.ts.map +1 -1
  9. package/dist/@types/internal/index.d.ts +1 -0
  10. package/dist/@types/internal/index.d.ts.map +1 -1
  11. package/dist/@types/internal/reactions.d.ts +5 -4
  12. package/dist/@types/internal/reactions.d.ts.map +1 -1
  13. package/dist/@types/internal/sensitive.d.ts +147 -0
  14. package/dist/@types/internal/sensitive.d.ts.map +1 -0
  15. package/dist/@types/internal/tracing.d.ts.map +1 -1
  16. package/dist/@types/types/action.d.ts +57 -0
  17. package/dist/@types/types/action.d.ts.map +1 -1
  18. package/dist/@types/types/registry.d.ts +9 -1
  19. package/dist/@types/types/registry.d.ts.map +1 -1
  20. package/dist/@types/types/schemas.d.ts +36 -0
  21. package/dist/@types/types/schemas.d.ts.map +1 -1
  22. package/dist/{chunk-F4S2JOPN.js → chunk-3ZTFNAY7.js} +2 -2
  23. package/dist/chunk-XSBT63QX.js +267 -0
  24. package/dist/chunk-XSBT63QX.js.map +1 -0
  25. package/dist/index.cjs +291 -78
  26. package/dist/index.cjs.map +1 -1
  27. package/dist/index.js +155 -32
  28. package/dist/index.js.map +1 -1
  29. package/dist/test/index.cjs +62 -56
  30. package/dist/test/index.cjs.map +1 -1
  31. package/dist/test/index.js +11 -11
  32. package/dist/test/index.js.map +1 -1
  33. package/dist/types/index.cjs +52 -34
  34. package/dist/types/index.cjs.map +1 -1
  35. package/dist/types/index.js +9 -3
  36. package/package.json +1 -1
  37. package/dist/chunk-PMAZTOSO.js +0 -164
  38. package/dist/chunk-PMAZTOSO.js.map +0 -1
  39. /package/dist/{chunk-F4S2JOPN.js.map → chunk-3ZTFNAY7.js.map} +0 -0
@@ -9,6 +9,42 @@ import { type ZodObject, type ZodRawShape, z } from "zod";
9
9
  * An empty Zod schema (no properties).
10
10
  */
11
11
  export declare const ZodEmpty: z.ZodRecord<z.ZodString, z.ZodNever>;
12
+ /**
13
+ * Sentinel placed in `event.data[field]` when the caller isn't authorized to
14
+ * see the sensitive field — either `.discloses(predicate)` returned `false`,
15
+ * or no predicate was declared (framework default-deny). Recoverable: a
16
+ * properly-authorized read returns the plaintext.
17
+ *
18
+ * Part of the sensitive-data foundation (#855 / epic #566).
19
+ */
20
+ export { REDACTED, SHREDDED } from "../internal/sensitive.js";
21
+ /**
22
+ * Mark a Zod schema as sensitive. Returns the same schema instance — the
23
+ * marker is registered out-of-band so the static type is preserved and the
24
+ * call site reads as a pure annotation.
25
+ *
26
+ * Idempotent: re-wrapping an already-sensitive schema is a no-op.
27
+ *
28
+ * The marker is what the orchestrator inspects to split event payloads into
29
+ * `data` + `pii` on commit, gate reads via `.discloses`, and strip handler
30
+ * payloads. Part of the sensitive-data foundation (#855 / epic #566).
31
+ *
32
+ * @example
33
+ * ```ts
34
+ * import { z } from "zod";
35
+ * import { state, sensitive } from "@rotorsoft/act";
36
+ *
37
+ * const UserRegistered = z.object({
38
+ * email: sensitive(z.string()),
39
+ * name: sensitive(z.string()),
40
+ * plan: z.enum(["free", "pro"]), // not sensitive — stays in events.data
41
+ * });
42
+ * ```
43
+ *
44
+ * @param schema - The Zod schema to mark sensitive.
45
+ * @returns The same schema instance, unmodified at the type level.
46
+ */
47
+ export declare function sensitive<T extends z.ZodType>(schema: T): T;
12
48
  /**
13
49
  * Zod schema for an actor (user, system, etc.).
14
50
  */
@@ -1 +1 @@
1
- {"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/types/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE1D;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ,sCAAkC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,WAAW;;;kBAMX,CAAC;AAEd;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;kBAOZ,CAAC;AAEd;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;iBAI/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;kBAQf,CAAC;AAEd;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;kBAQnB,CAAC;AAEd;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,OAAO,QAAQ,CAAC,CAAC;IACjE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,OAAO,QAAQ,CAAC,CAAC;IAClE,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;CAC/B,CAAC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;kBAcX,CAAC"}
1
+ {"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/types/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAO1D;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ,sCAAkC,CAAC;AAExD;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAG3D;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;kBAMX,CAAC;AAEd;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;kBAOZ,CAAC;AAEd;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;iBAI/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;kBAQf,CAAC;AAEd;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;kBAQnB,CAAC;AAEd;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,OAAO,QAAQ,CAAC,CAAC;IACjE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,OAAO,QAAQ,CAAC,CAAC;IAClE,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;CAC/B,CAAC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;kBAcX,CAAC"}
@@ -3,7 +3,7 @@ import {
3
3
  Environments,
4
4
  LogLevels,
5
5
  ValidationError
6
- } from "./chunk-PMAZTOSO.js";
6
+ } from "./chunk-XSBT63QX.js";
7
7
 
8
8
  // src/adapters/console-logger.ts
9
9
  var LEVEL_VALUES = {
@@ -1133,4 +1133,4 @@ export {
1133
1133
  TOMBSTONE_EVENT,
1134
1134
  DEFAULT_LANE
1135
1135
  };
1136
- //# sourceMappingURL=chunk-F4S2JOPN.js.map
1136
+ //# sourceMappingURL=chunk-3ZTFNAY7.js.map
@@ -0,0 +1,267 @@
1
+ // src/types/errors.ts
2
+ var Errors = {
3
+ ValidationError: "ERR_VALIDATION",
4
+ InvariantError: "ERR_INVARIANT",
5
+ ConcurrencyError: "ERR_CONCURRENCY",
6
+ StreamClosedError: "ERR_STREAM_CLOSED",
7
+ NonRetryableError: "ERR_NON_RETRYABLE"
8
+ };
9
+ var ValidationError = class extends Error {
10
+ /** The type of target being validated (e.g., "action", "event") */
11
+ target;
12
+ /** The invalid payload that failed validation */
13
+ payload;
14
+ /** Zod validation error details */
15
+ details;
16
+ constructor(target, payload, details) {
17
+ super(`Invalid ${target} payload`);
18
+ this.name = Errors.ValidationError;
19
+ this.target = target;
20
+ this.payload = payload;
21
+ this.details = details;
22
+ }
23
+ };
24
+ var InvariantError = class extends Error {
25
+ /** The action that was attempted */
26
+ action;
27
+ /** The action payload that was provided */
28
+ payload;
29
+ /** The target stream and actor context */
30
+ target;
31
+ /** The current state snapshot when invariant was checked */
32
+ snapshot;
33
+ /** Human-readable description of why the invariant failed */
34
+ description;
35
+ constructor(action, payload, target, snapshot, description) {
36
+ super(`${action} failed invariant: ${description}`);
37
+ this.name = Errors.InvariantError;
38
+ this.action = action;
39
+ this.payload = payload;
40
+ this.target = target;
41
+ this.snapshot = snapshot;
42
+ this.description = description;
43
+ }
44
+ };
45
+ var ConcurrencyError = class extends Error {
46
+ /** The stream that had the concurrent modification */
47
+ stream;
48
+ /** The actual current version in the store */
49
+ lastVersion;
50
+ /** The events that were being committed */
51
+ events;
52
+ /** The version number that was expected */
53
+ expectedVersion;
54
+ constructor(stream, lastVersion, events, expectedVersion) {
55
+ super(
56
+ `Concurrency error committing "${events.map((e) => `${stream}.${e.name}`).join(
57
+ ", "
58
+ )}". Expected version ${expectedVersion} but found version ${lastVersion}.`
59
+ );
60
+ this.name = Errors.ConcurrencyError;
61
+ this.stream = stream;
62
+ this.lastVersion = lastVersion;
63
+ this.events = events;
64
+ this.expectedVersion = expectedVersion;
65
+ }
66
+ };
67
+ var StreamClosedError = class extends Error {
68
+ /** The stream that is closed */
69
+ stream;
70
+ constructor(stream) {
71
+ super(`Stream "${stream}" is closed (tombstoned)`);
72
+ this.name = Errors.StreamClosedError;
73
+ this.stream = stream;
74
+ }
75
+ };
76
+ var NonRetryableError = class extends Error {
77
+ /** The original failure, if any. Mirrors the standard `Error.cause` shape. */
78
+ cause;
79
+ constructor(message, options) {
80
+ super(message);
81
+ this.name = Errors.NonRetryableError;
82
+ this.cause = options?.cause;
83
+ }
84
+ };
85
+
86
+ // src/types/schemas.ts
87
+ import { z as z2 } from "zod";
88
+
89
+ // src/internal/sensitive.ts
90
+ import { z } from "zod";
91
+ var REDACTED = "[REDACTED]";
92
+ var SHREDDED = "[SHREDDED]";
93
+ var _registry = z.registry();
94
+ function is_pii(schema) {
95
+ let cur = schema;
96
+ while (true) {
97
+ if (_registry.has(cur)) return true;
98
+ const inner = cur._def?.innerType;
99
+ if (!inner || inner === cur) return false;
100
+ cur = inner;
101
+ }
102
+ }
103
+ function pii_fields(schema) {
104
+ const shape = schema.shape;
105
+ if (!shape || typeof shape !== "object") return [];
106
+ const fields = [];
107
+ for (const key of Object.keys(shape)) {
108
+ if (is_pii(shape[key])) fields.push(key);
109
+ }
110
+ return fields;
111
+ }
112
+ function pii_split(emitted, fields) {
113
+ const rec = emitted.data;
114
+ const clean = {};
115
+ const pii = {};
116
+ for (const k of Object.keys(rec)) {
117
+ if (fields.includes(k)) pii[k] = rec[k];
118
+ else clean[k] = rec[k];
119
+ }
120
+ return { name: emitted.name, data: clean, pii };
121
+ }
122
+ function pii_merge(event, fields) {
123
+ const data = event.data;
124
+ const pii = event.pii;
125
+ if (pii != null) {
126
+ return {
127
+ ...event,
128
+ data: { ...data, ...pii }
129
+ };
130
+ }
131
+ const shredded = { ...data };
132
+ for (const f of fields) shredded[f] = SHREDDED;
133
+ return {
134
+ ...event,
135
+ data: shredded
136
+ };
137
+ }
138
+ function pii_gate(event, fields, predicate, actor) {
139
+ const data = event.data;
140
+ if (event.pii == null) {
141
+ const shredded = { ...data };
142
+ for (const f of fields) shredded[f] = SHREDDED;
143
+ return {
144
+ ...event,
145
+ data: shredded
146
+ };
147
+ }
148
+ const allowed = !!actor && !!predicate && predicate(event, actor);
149
+ if (allowed) {
150
+ return {
151
+ ...event,
152
+ data: {
153
+ ...data,
154
+ ...event.pii
155
+ }
156
+ };
157
+ }
158
+ const redacted = { ...data };
159
+ for (const f of fields) redacted[f] = REDACTED;
160
+ return {
161
+ ...event,
162
+ data: redacted
163
+ };
164
+ }
165
+ function pii_strip(event, fields) {
166
+ const data = event.data;
167
+ const stripped = {};
168
+ for (const k of Object.keys(data)) {
169
+ if (!fields.includes(k)) stripped[k] = data[k];
170
+ }
171
+ const { pii: _drop_pii, ...rest } = event;
172
+ return {
173
+ ...rest,
174
+ data: stripped
175
+ };
176
+ }
177
+
178
+ // src/types/schemas.ts
179
+ var ZodEmpty = z2.record(z2.string(), z2.never());
180
+ function sensitive(schema) {
181
+ _registry.add(schema, { sensitive: true });
182
+ return schema;
183
+ }
184
+ var ActorSchema = z2.object({
185
+ id: z2.string(),
186
+ name: z2.string()
187
+ }).loose().readonly();
188
+ var TargetSchema = z2.object({
189
+ stream: z2.string(),
190
+ actor: ActorSchema,
191
+ expectedVersion: z2.number().optional()
192
+ }).loose().readonly();
193
+ var CausationEventSchema = z2.object({
194
+ id: z2.number(),
195
+ name: z2.string(),
196
+ stream: z2.string()
197
+ });
198
+ var EventMetaSchema = z2.object({
199
+ correlation: z2.string(),
200
+ causation: z2.object({
201
+ action: TargetSchema.and(z2.object({ name: z2.string() })).optional(),
202
+ event: CausationEventSchema.optional()
203
+ })
204
+ }).readonly();
205
+ var CommittedMetaSchema = z2.object({
206
+ id: z2.number(),
207
+ stream: z2.string(),
208
+ version: z2.number(),
209
+ created: z2.date(),
210
+ meta: EventMetaSchema
211
+ }).readonly();
212
+ var QuerySchema = z2.object({
213
+ stream: z2.string().optional(),
214
+ names: z2.string().array().optional(),
215
+ before: z2.number().optional(),
216
+ after: z2.number().optional(),
217
+ limit: z2.number().optional(),
218
+ created_before: z2.date().optional(),
219
+ created_after: z2.date().optional(),
220
+ backward: z2.boolean().optional(),
221
+ correlation: z2.string().optional(),
222
+ with_snaps: z2.boolean().optional(),
223
+ stream_exact: z2.boolean().optional()
224
+ }).readonly();
225
+
226
+ // src/types/index.ts
227
+ var Environments = [
228
+ "development",
229
+ "test",
230
+ "staging",
231
+ "production"
232
+ ];
233
+ var LogLevels = [
234
+ "fatal",
235
+ "error",
236
+ "warn",
237
+ "info",
238
+ "debug",
239
+ "trace"
240
+ ];
241
+
242
+ export {
243
+ Errors,
244
+ ValidationError,
245
+ InvariantError,
246
+ ConcurrencyError,
247
+ StreamClosedError,
248
+ NonRetryableError,
249
+ REDACTED,
250
+ SHREDDED,
251
+ pii_fields,
252
+ pii_split,
253
+ pii_merge,
254
+ pii_gate,
255
+ pii_strip,
256
+ ZodEmpty,
257
+ sensitive,
258
+ ActorSchema,
259
+ TargetSchema,
260
+ CausationEventSchema,
261
+ EventMetaSchema,
262
+ CommittedMetaSchema,
263
+ QuerySchema,
264
+ Environments,
265
+ LogLevels
266
+ };
267
+ //# sourceMappingURL=chunk-XSBT63QX.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/types/errors.ts","../src/types/schemas.ts","../src/internal/sensitive.ts","../src/types/index.ts"],"sourcesContent":["import type {\n Actor,\n Message,\n Schema,\n Schemas,\n Snapshot,\n Target,\n} from \"./action.js\";\n\n/**\n * @packageDocumentation\n * @module act/types\n * @category Types\n * Application error type constants and error classes for the Act Framework.\n *\n * - `ERR_VALIDATION`: Schema validation error\n * - `ERR_INVARIANT`: Invariant validation error\n * - `ERR_CONCURRENCY`: Optimistic concurrency validation error on commits\n */\nexport const Errors = {\n ValidationError: \"ERR_VALIDATION\",\n InvariantError: \"ERR_INVARIANT\",\n ConcurrencyError: \"ERR_CONCURRENCY\",\n StreamClosedError: \"ERR_STREAM_CLOSED\",\n NonRetryableError: \"ERR_NON_RETRYABLE\",\n} as const;\n\n/**\n * Thrown when an action or event payload fails Zod schema validation.\n *\n * This error indicates that data doesn't match the expected schema defined\n * for an action or event. The `details` property contains the Zod validation\n * error with specific information about what failed.\n *\n * @example Catching validation errors\n * ```typescript\n * import { ValidationError } from \"@rotorsoft/act\";\n *\n * try {\n * await app.do(\"createUser\", target, {\n * email: \"invalid-email\", // Missing @ symbol\n * age: -5 // Negative age\n * });\n * } catch (error) {\n * if (error instanceof ValidationError) {\n * console.error(\"Validation failed for:\", error.target);\n * console.error(\"Invalid payload:\", error.payload);\n * console.error(\"Validation details:\", error.details);\n * // details contains Zod error with field-level info\n * }\n * }\n * ```\n *\n * @example Logging validation details\n * ```typescript\n * try {\n * await app.do(\"updateProfile\", target, payload);\n * } catch (error) {\n * if (error instanceof ValidationError) {\n * error.details.errors.forEach((err) => {\n * console.error(`Field ${err.path.join(\".\")}: ${err.message}`);\n * });\n * }\n * }\n * ```\n *\n * @see {@link https://zod.dev | Zod documentation} for validation details\n */\nexport class ValidationError extends Error {\n /** The type of target being validated (e.g., \"action\", \"event\") */\n public readonly target: string;\n /** The invalid payload that failed validation */\n public readonly payload: any;\n /** Zod validation error details */\n public readonly details: any;\n\n constructor(target: string, payload: any, details: any) {\n super(`Invalid ${target} payload`);\n this.name = Errors.ValidationError;\n this.target = target;\n this.payload = payload;\n this.details = details;\n }\n}\n\n/**\n * Thrown when a business rule (invariant) is violated during action execution.\n *\n * Invariants are conditions that must hold true for an action to succeed.\n * They're checked after loading the current state but before emitting events.\n * This error provides complete context about what action was attempted and\n * why it was rejected.\n *\n * @template TState - State schema type\n * @template TEvents - Event schemas type\n * @template TActions - Action schemas type\n * @template TKey - Action name\n * @template TActor - Actor type extending base Actor\n *\n * @example Catching invariant violations\n * ```typescript\n * import { InvariantError } from \"@rotorsoft/act\";\n *\n * try {\n * await app.do(\"withdraw\",\n * { stream: \"account-123\", actor: { id: \"user1\", name: \"Alice\" } },\n * { amount: 1000 }\n * );\n * } catch (error) {\n * if (error instanceof InvariantError) {\n * console.error(\"Action:\", error.action);\n * console.error(\"Reason:\", error.description);\n * console.error(\"Current state:\", error.snapshot.state);\n * console.error(\"Attempted payload:\", error.payload);\n * }\n * }\n * ```\n *\n * @example User-friendly error messages\n * ```typescript\n * try {\n * await app.do(\"closeTicket\", target, payload);\n * } catch (error) {\n * if (error instanceof InvariantError) {\n * // Present friendly message to user\n * if (error.description === \"Ticket must be open\") {\n * return { error: \"This ticket is already closed\" };\n * } else if (error.description === \"Not authorized\") {\n * return { error: \"You don't have permission to close this ticket\" };\n * }\n * }\n * }\n * ```\n *\n * @example Logging with context\n * ```typescript\n * try {\n * await app.do(\"transfer\", target, { to: \"account2\", amount: 500 });\n * } catch (error) {\n * if (error instanceof InvariantError) {\n * logger.error({\n * action: error.action,\n * stream: error.target.stream,\n * actor: error.target.actor,\n * reason: error.description,\n * balance: error.snapshot.state.balance,\n * attempted: error.payload.amount\n * }, \"Invariant violation\");\n * }\n * }\n * ```\n *\n * @see {@link Invariant} for defining business rules\n */\nexport class InvariantError<\n TState extends Schema,\n TEvents extends Schemas,\n TActions extends Schemas,\n TKey extends keyof TActions,\n TActor extends Actor = Actor,\n> extends Error {\n /** The action that was attempted */\n readonly action: TKey;\n /** The action payload that was provided */\n readonly payload: Readonly<TActions[TKey]>;\n /** The target stream and actor context */\n readonly target: Target<TActor>;\n /** The current state snapshot when invariant was checked */\n readonly snapshot: Snapshot<TState, TEvents>;\n /** Human-readable description of why the invariant failed */\n readonly description: string;\n\n constructor(\n action: TKey,\n payload: Readonly<TActions[TKey]>,\n target: Target<TActor>,\n snapshot: Snapshot<TState, TEvents>,\n description: string\n ) {\n super(`${action as string} failed invariant: ${description}`);\n this.name = Errors.InvariantError;\n this.action = action;\n this.payload = payload;\n this.target = target;\n this.snapshot = snapshot;\n this.description = description;\n }\n}\n\n/**\n * Thrown when optimistic concurrency control detects a conflict.\n *\n * This error occurs when trying to commit events to a stream that has been\n * modified by another process since it was last loaded. The version number\n * doesn't match expectations, indicating a concurrent modification.\n *\n * This is a normal occurrence in distributed systems and should be handled\n * by reloading the current state and retrying the action.\n *\n * @example Handling concurrency conflicts with retry\n * ```typescript\n * import { ConcurrencyError } from \"@rotorsoft/act\";\n *\n * async function transferWithRetry(from, to, amount, maxRetries = 3) {\n * for (let attempt = 0; attempt < maxRetries; attempt++) {\n * try {\n * await app.do(\"transfer\",\n * { stream: from, actor: currentUser },\n * { to, amount }\n * );\n * return { success: true };\n * } catch (error) {\n * if (error instanceof ConcurrencyError) {\n * if (attempt < maxRetries - 1) {\n * console.log(`Concurrent modification detected, retrying... (${attempt + 1}/${maxRetries})`);\n * await sleep(100 * Math.pow(2, attempt)); // Exponential backoff\n * continue;\n * }\n * }\n * throw error;\n * }\n * }\n * return { success: false, reason: \"Too many concurrent modifications\" };\n * }\n * ```\n *\n * @example Logging concurrency conflicts\n * ```typescript\n * try {\n * await app.do(\"updateInventory\", target, payload);\n * } catch (error) {\n * if (error instanceof ConcurrencyError) {\n * logger.warn({\n * stream: error.stream,\n * expectedVersion: error.expectedVersion,\n * actualVersion: error.lastVersion,\n * events: error.events.map(e => e.name)\n * }, \"Concurrent modification detected\");\n * }\n * }\n * ```\n *\n * @example User feedback for conflicts\n * ```typescript\n * try {\n * await app.do(\"editDocument\", target, { content: newContent });\n * } catch (error) {\n * if (error instanceof ConcurrencyError) {\n * return {\n * error: \"This document was modified by another user. Please refresh and try again.\",\n * code: \"CONCURRENT_MODIFICATION\"\n * };\n * }\n * }\n * ```\n *\n * @see {@link Store.commit} for version checking details\n */\nexport class ConcurrencyError extends Error {\n /** The stream that had the concurrent modification */\n public readonly stream: string;\n /** The actual current version in the store */\n public readonly lastVersion: number;\n /** The events that were being committed */\n public readonly events: Message<Schemas, keyof Schemas>[];\n /** The version number that was expected */\n public readonly expectedVersion: number;\n\n constructor(\n stream: string,\n lastVersion: number,\n events: Message<Schemas, keyof Schemas>[],\n expectedVersion: number\n ) {\n // Message lists stream + event names only. Payloads remain accessible\n // via `error.events` for callers who need them — keeping them out of\n // the message avoids MB-scale strings on contended writes and keeps\n // potentially-sensitive data out of log streams.\n super(\n `Concurrency error committing \"${events\n .map((e) => `${stream}.${e.name}`)\n .join(\n \", \"\n )}\". Expected version ${expectedVersion} but found version ${lastVersion}.`\n );\n this.name = Errors.ConcurrencyError;\n this.stream = stream;\n this.lastVersion = lastVersion;\n this.events = events;\n this.expectedVersion = expectedVersion;\n }\n}\n\n/**\n * Thrown when attempting to write to a stream that has been closed\n * with a tombstone event.\n *\n * A tombstoned stream is permanently closed — no further actions can\n * be executed against it. The only way to reopen a tombstoned stream\n * is through `Act.close()` with a `restart` callback.\n *\n * @example\n * ```typescript\n * import { StreamClosedError } from \"@rotorsoft/act\";\n *\n * try {\n * await app.do(\"updateTicket\", target, payload);\n * } catch (error) {\n * if (error instanceof StreamClosedError) {\n * console.error(`Stream ${error.stream} is closed`);\n * }\n * }\n * ```\n *\n * @see {@link Act.close} for closing streams\n */\nexport class StreamClosedError extends Error {\n /** The stream that is closed */\n public readonly stream: string;\n\n constructor(stream: string) {\n super(`Stream \"${stream}\" is closed (tombstoned)`);\n this.name = Errors.StreamClosedError;\n this.stream = stream;\n }\n}\n\n/**\n * Thrown by a reaction handler to signal that the failure is permanent\n * and the drain pipeline should block the stream immediately, without\n * consuming the rest of the `maxRetries` budget.\n *\n * The drain finalizer detects `instanceof NonRetryableError` and forces\n * `block = options.blockOnError` regardless of `lease.retry`. When\n * `blockOnError` is `false`, behavior is unchanged (drain keeps retrying\n * forever) — the class never overrides the operator's explicit \"never\n * block\" choice.\n *\n * Use this for failures the handler *knows* won't get better on retry:\n * a 4xx from a webhook, a `ZodError` on malformed input, a \"user\n * deleted\" 404 from a downstream API. Use regular `Error` (or a\n * subclass) for transient failures so the existing retry-with-backoff\n * loop applies.\n *\n * @example Wrapping a permanent downstream error\n * ```typescript\n * import { NonRetryableError } from \"@rotorsoft/act\";\n *\n * .on(\"OrderConfirmed\")\n * .do(async (event) => {\n * const res = await fetch(url, ...);\n * if (res.status >= 400 && res.status < 500) {\n * throw new NonRetryableError(\n * `webhook ${url} responded ${res.status}`,\n * { cause: await res.text() }\n * );\n * }\n * if (!res.ok) throw new Error(`webhook ${url} responded ${res.status}`);\n * })\n * ```\n *\n * @example Marking validation failures as non-retryable\n * ```typescript\n * .on(\"PaymentReceived\")\n * .do(async (event) => {\n * const parsed = Schema.safeParse(event.data);\n * if (!parsed.success) {\n * throw new NonRetryableError(\"payment payload failed validation\", {\n * cause: parsed.error,\n * });\n * }\n * // ... handle parsed payload\n * })\n * ```\n */\nexport class NonRetryableError extends Error {\n /** The original failure, if any. Mirrors the standard `Error.cause` shape. */\n public override readonly cause?: unknown;\n\n constructor(message: string, options?: { cause?: unknown }) {\n super(message);\n this.name = Errors.NonRetryableError;\n this.cause = options?.cause;\n }\n}\n","import { type ZodObject, type ZodRawShape, z } from \"zod\";\n// Deep-path import (vs `../internal/index.js`) is deliberate — `_registry` is\n// a side-effect-free leaf, and going through the internal barrel would pull\n// tracing.ts → config.ts in at type-schema load time and crash on TDZ when a\n// test imports a public schema before config is initialized.\nimport { _registry } from \"../internal/sensitive.js\";\n\n/**\n * @packageDocumentation\n * @module act/types\n * @category Types\n * Zod schemas and helpers for the Act Framework.\n */\n\n/**\n * An empty Zod schema (no properties).\n */\nexport const ZodEmpty = z.record(z.string(), z.never());\n\n/**\n * Sentinel placed in `event.data[field]` when the caller isn't authorized to\n * see the sensitive field — either `.discloses(predicate)` returned `false`,\n * or no predicate was declared (framework default-deny). Recoverable: a\n * properly-authorized read returns the plaintext.\n *\n * Part of the sensitive-data foundation (#855 / epic #566).\n */\nexport { REDACTED, SHREDDED } from \"../internal/sensitive.js\";\n\n/**\n * Mark a Zod schema as sensitive. Returns the same schema instance — the\n * marker is registered out-of-band so the static type is preserved and the\n * call site reads as a pure annotation.\n *\n * Idempotent: re-wrapping an already-sensitive schema is a no-op.\n *\n * The marker is what the orchestrator inspects to split event payloads into\n * `data` + `pii` on commit, gate reads via `.discloses`, and strip handler\n * payloads. Part of the sensitive-data foundation (#855 / epic #566).\n *\n * @example\n * ```ts\n * import { z } from \"zod\";\n * import { state, sensitive } from \"@rotorsoft/act\";\n *\n * const UserRegistered = z.object({\n * email: sensitive(z.string()),\n * name: sensitive(z.string()),\n * plan: z.enum([\"free\", \"pro\"]), // not sensitive — stays in events.data\n * });\n * ```\n *\n * @param schema - The Zod schema to mark sensitive.\n * @returns The same schema instance, unmodified at the type level.\n */\nexport function sensitive<T extends z.ZodType>(schema: T): T {\n _registry.add(schema, { sensitive: true });\n return schema;\n}\n\n/**\n * Zod schema for an actor (user, system, etc.).\n */\nexport const ActorSchema = z\n .object({\n id: z.string(),\n name: z.string(),\n })\n .loose()\n .readonly();\n\n/**\n * Zod schema for a target (stream and actor info).\n */\nexport const TargetSchema = z\n .object({\n stream: z.string(),\n actor: ActorSchema,\n expectedVersion: z.number().optional(),\n })\n .loose()\n .readonly();\n\n/**\n * Zod schema for causation event metadata.\n */\nexport const CausationEventSchema = z.object({\n id: z.number(),\n name: z.string(),\n stream: z.string(),\n});\n\n/**\n * Zod schema for event metadata (correlation and causation).\n */\nexport const EventMetaSchema = z\n .object({\n correlation: z.string(),\n causation: z.object({\n action: TargetSchema.and(z.object({ name: z.string() })).optional(),\n event: CausationEventSchema.optional(),\n }),\n })\n .readonly();\n\n/**\n * Zod schema for committed event metadata (id, stream, version, created, meta).\n */\nexport const CommittedMetaSchema = z\n .object({\n id: z.number(),\n stream: z.string(),\n version: z.number(),\n created: z.date(),\n meta: EventMetaSchema,\n })\n .readonly();\n\n/**\n * Type representing the full state schema for a domain.\n * @property events - Map of event names to Zod schemas.\n * @property actions - Map of action names to Zod schemas.\n * @property state - Zod schema for the state object.\n */\nexport type StateSchema = Readonly<{\n events: Record<string, ZodObject<ZodRawShape> | typeof ZodEmpty>;\n actions: Record<string, ZodObject<ZodRawShape> | typeof ZodEmpty>;\n state: ZodObject<ZodRawShape>;\n}>;\n\n/**\n * Query options for event store queries.\n */\nexport const QuerySchema = z\n .object({\n stream: z.string().optional(),\n names: z.string().array().optional(),\n before: z.number().optional(),\n after: z.number().optional(),\n limit: z.number().optional(),\n created_before: z.date().optional(),\n created_after: z.date().optional(),\n backward: z.boolean().optional(),\n correlation: z.string().optional(),\n with_snaps: z.boolean().optional(),\n stream_exact: z.boolean().optional(),\n })\n .readonly();\n","/**\n * @module sensitive\n * @category Internal\n *\n * Internal mechanics for the sensitive-data foundation (#855 / epic #566).\n * The public surface (`sensitive(zodType)`) lives at `libs/act/src/sensitive.ts`\n * and re-exports `REDACTED` / `SHREDDED` from here; this module holds the\n * registry plus the helpers the orchestrator calls during commit, load, and\n * handler dispatch.\n *\n * - `_registry` — process-global `z.registry<{ sensitive: true }>()`. Public\n * `sensitive()` adds to it; the helpers in this module read it.\n * - `pii_fields(schema)` — walk a Zod schema's top-level shape, return the\n * keys marked via `sensitive(...)`.\n * - `pii_merge(event, fields)` — produce the reducer view (pii merged\n * into data; `[SHREDDED]` if pii column is null).\n * - `pii_gate(event, fields, predicate, actor)` — produce the external\n * view: plaintext when authorized, `[REDACTED]` when not, `[SHREDDED]`\n * when the underlying pii column is null.\n * - `pii_strip(event, fields)` — remove sensitive keys entirely\n * before invoking projection / reaction handlers.\n *\n * @internal\n */\n\nimport { z } from \"zod\";\nimport type { Actor, Committed, Schemas } from \"../types/index.js\";\n\n/**\n * Sentinel placed in `event.data[field]` when the caller isn't authorized to\n * see the sensitive field — either `.discloses(predicate)` returned `false`,\n * or no predicate was declared (framework default-deny). Recoverable: a\n * properly-authorized read returns the plaintext.\n *\n * Re-exported from `libs/act/src/sensitive.ts` as part of the public surface.\n */\nexport const REDACTED = \"[REDACTED]\" as const;\n\n/**\n * Sentinel placed in `event.data[field]` when the underlying PII payload has\n * been wiped via `Store.forget_pii(stream)` — the row's pii column is `NULL`\n * and the original plaintext is gone forever. Irrecoverable.\n *\n * Re-exported from `libs/act/src/sensitive.ts` as part of the public surface.\n */\nexport const SHREDDED = \"[SHREDDED]\" as const;\n\n/**\n * Process-global registry holding every Zod schema marked sensitive. Backed\n * by a `WeakMap`, so wrapper-created instances (`.optional()`, `.nullable()`,\n * `.default()`) that chain off a marked schema produce *new* schema instances\n * the registry doesn't track; the field walker handles those via unwrap.\n *\n * Exported so the public `sensitive(zodType)` wrapper can call `_registry.add`.\n * Underscore prefix marks \"framework-private, don't touch from user code.\"\n *\n * @internal\n */\nexport const _registry = z.registry<{ sensitive: true }>();\n\n/**\n * True when the given schema was marked via `sensitive(...)`.\n *\n * Walks through Zod wrapper layers (`.optional()`, `.nullable()`,\n * `.default()`, `.readonly()`) by following `_def.innerType` until it reaches\n * a non-wrapper schema, then checks the registry. Wrappers create new schema\n * instances; the marker lives on the *inner* schema the user wrapped, so we\n * test that one.\n *\n * @internal\n */\nfunction is_pii(schema: z.ZodType): boolean {\n let cur: z.ZodType = schema;\n while (true) {\n if (_registry.has(cur)) return true;\n const inner = (cur as { _def?: { innerType?: z.ZodType } })._def?.innerType;\n if (!inner || inner === cur) return false;\n cur = inner;\n }\n}\n\n/**\n * Derive the list of sensitive field names from an event's Zod schema.\n *\n * Walks the top-level shape of a `z.object({...})` and returns the keys whose\n * schema (after unwrapping optional/nullable/default wrappers) was marked via\n * `sensitive(...)`. Returns an empty array for non-object schemas or events\n * with no sensitive fields — the common-case zero-cost path.\n *\n * Only the top-level shape is walked. Sensitive fields nested inside a\n * `z.object` declared inside the event payload would require recursive\n * descent; that's deferred until a real callsite needs it.\n *\n * @internal — consumed by the registry's `sensitive_fields(eventName)` lookup.\n */\nexport function pii_fields(schema: z.ZodType): readonly string[] {\n const shape = (schema as { shape?: Record<string, z.ZodType> }).shape;\n if (!shape || typeof shape !== \"object\") return [];\n const fields: string[] = [];\n for (const key of Object.keys(shape)) {\n if (is_pii(shape[key])) fields.push(key);\n }\n return fields;\n}\n\n/**\n * Split an emitted event's `data` into `data` (non-sensitive) + `pii`\n * (sensitive) using the field list precomputed at build time. Used by the\n * State's `_pii_split` decorator just before `Store.commit`.\n *\n * Single forward pass over `Object.keys(validated)` — same shape as the\n * spread-and-delete-free implementation in slice 3, just hoisted out of the\n * orchestrator hot path so it's only invoked when the State actually has a\n * sensitive event.\n *\n * @internal\n */\nexport function pii_split(\n emitted: { name: unknown; data: unknown },\n fields: readonly string[]\n): { name: unknown; data: unknown; pii: Record<string, unknown> } {\n const rec = emitted.data as Record<string, unknown>;\n const clean: Record<string, unknown> = {};\n const pii: Record<string, unknown> = {};\n for (const k of Object.keys(rec)) {\n if (fields.includes(k)) pii[k] = rec[k];\n else clean[k] = rec[k];\n }\n return { name: emitted.name, data: clean, pii };\n}\n\n/**\n * Build the **reducer view** of a committed event — sensitive fields merged\n * back into `data` so per-state reducers always see plaintext.\n *\n * - Event with no `pii` payload AND no schema-declared sensitive fields →\n * return the event unchanged (zero-cost path).\n * - Event with a `pii` payload → merge into `data` (plaintext for the reducer).\n * - Event whose schema *declares* sensitive fields but `pii` is null/undefined\n * (post-`forget_pii`) → substitute {@link SHREDDED} for each declared field.\n *\n * Used inside `load()` before invoking the reducer chain. Reducer-visible PII\n * is by design — the reducer is the source of truth for derived state. The\n * external view returned to callers is separately gated by {@link pii_gate}.\n *\n * @internal\n */\nexport function pii_merge<\n TEvents extends Schemas,\n TKey extends keyof TEvents & string,\n>(\n event: Committed<TEvents, TKey>,\n fields: readonly string[]\n): Committed<TEvents, TKey> {\n // Contract: `fields` is non-empty. Callers (the State's `_pii_merge`\n // decorator) filter on `fields_by_event.get(name)` before invocation, so the\n // empty-fields short-circuit lives at the caller, not here.\n const data = event.data as Record<string, unknown>;\n const pii = event.pii;\n if (pii != null) {\n return {\n ...event,\n data: { ...data, ...pii } as Committed<TEvents, TKey>[\"data\"],\n };\n }\n // Schema declared sensitive fields but the pii payload is gone — shredded.\n const shredded: Record<string, unknown> = { ...data };\n for (const f of fields) shredded[f] = SHREDDED;\n return {\n ...event,\n data: shredded as Committed<TEvents, TKey>[\"data\"],\n };\n}\n\n/**\n * Build the **external view** of a committed event — the form returned by\n * `load()`, `query()`, `query_array()`, and the snapshot in `do()`'s reply.\n *\n * - Event with no schema-declared sensitive fields → returned unchanged\n * (zero-cost path).\n * - Event whose `pii` payload is null/undefined AND schema declares sensitive\n * fields → substitute {@link SHREDDED} for each declared field. Irrecoverable,\n * so no predicate check.\n * - Event with a `pii` payload, predicate returns `true` → merge `pii` into\n * `data` (plaintext).\n * - Event with a `pii` payload, predicate returns `false` OR no predicate\n * declared (framework default-deny) → substitute {@link REDACTED} for each\n * declared field.\n *\n * @internal\n */\nexport function pii_gate<\n TEvents extends Schemas,\n TKey extends keyof TEvents & string,\n>(\n event: Committed<TEvents, TKey>,\n fields: readonly string[],\n predicate: ((event: any, actor: Actor) => boolean) | null,\n actor: Actor | undefined\n): Committed<TEvents, TKey> {\n // Contract: `fields` is non-empty. The State's `_pii_gate` decorator\n // filters on `fields_by_event.get(name)` before invocation.\n const data = event.data as Record<string, unknown>;\n if (event.pii == null) {\n const shredded: Record<string, unknown> = { ...data };\n for (const f of fields) shredded[f] = SHREDDED;\n return {\n ...event,\n data: shredded as Committed<TEvents, TKey>[\"data\"],\n };\n }\n // Plaintext path requires both an actor AND a predicate that allows. Missing\n // either → default-deny → REDACTED.\n const allowed = !!actor && !!predicate && predicate(event, actor);\n if (allowed) {\n return {\n ...event,\n data: {\n ...data,\n ...(event.pii as Record<string, unknown>),\n } as Committed<TEvents, TKey>[\"data\"],\n };\n }\n const redacted: Record<string, unknown> = { ...data };\n for (const f of fields) redacted[f] = REDACTED;\n return {\n ...event,\n data: redacted as Committed<TEvents, TKey>[\"data\"],\n };\n}\n\n/**\n * Build the **handler view** — sensitive keys removed entirely from `data`\n * and the `pii` field dropped from the event. Used before invoking projection\n * handlers and reaction handlers, which never see PII by framework rule.\n *\n * Different from {@link pii_gate} (which substitutes {@link REDACTED} or\n * {@link SHREDDED}) — projection tables and reaction sinks shouldn't even\n * structurally observe the keys, so a handler that mistakenly writes\n * `event.data.email` into a column would get `undefined`, not a sentinel\n * string that looks like real data. The strictness is deliberate.\n *\n * Reactions that genuinely need PII (e.g. a welcome-email reaction reading\n * `email`) opt back in by explicitly calling `app.load(stream, { actor:\n * systemActor })` inside the handler — pulling PII through the gate at the\n * call site makes the security-relevant path visible in code review.\n *\n * @internal\n */\nexport function pii_strip<\n TEvents extends Schemas,\n TKey extends keyof TEvents & string,\n>(\n event: Committed<TEvents, TKey>,\n fields: readonly string[]\n): Committed<TEvents, TKey> {\n // Contract: `fields` is non-empty. `buildHandle` / `buildHandleBatch`\n // filter on `fields.length > 0` before invocation.\n const data = event.data as Record<string, unknown>;\n const stripped: Record<string, unknown> = {};\n for (const k of Object.keys(data)) {\n if (!fields.includes(k)) stripped[k] = data[k];\n }\n const { pii: _drop_pii, ...rest } = event as Committed<TEvents, TKey> & {\n pii?: unknown;\n };\n return {\n ...rest,\n data: stripped as Committed<TEvents, TKey>[\"data\"],\n } as Committed<TEvents, TKey>;\n}\n","/**\n * @packageDocumentation\n * @module act/types\n * Barrel file for Act Framework core types.\n *\n * Re-exports all major type definitions for actions, errors, ports, reactions, registries, and schemas.\n * Also defines common environment and log level types/constants for configuration and logging.\n *\n * @remarks\n * Import from this module to access all core framework types in one place.\n */\nexport type * from \"./action.js\";\nexport type * from \"./audit.js\";\nexport * from \"./errors.js\";\nexport type * from \"./ports.js\";\nexport type * from \"./reaction.js\";\nexport type * from \"./registry.js\";\nexport * from \"./schemas.js\";\n\n/**\n * Supported runtime environments for the framework.\n * - `development`: Local development\n * - `test`: Automated testing\n * - `staging`: Pre-production\n * - `production`: Live/production\n */\nexport const Environments = [\n \"development\",\n \"test\",\n \"staging\",\n \"production\",\n] as const;\n\n/**\n * Type representing a valid environment string.\n */\nexport type Environment = (typeof Environments)[number];\n\n/**\n * Supported log levels for framework logging.\n * - `fatal`, `error`, `warn`, `info`, `debug`, `trace`\n */\nexport const LogLevels = [\n \"fatal\",\n \"error\",\n \"warn\",\n \"info\",\n \"debug\",\n \"trace\",\n] as const;\n\n/**\n * Type representing a valid log level string.\n */\nexport type LogLevel = (typeof LogLevels)[number];\n"],"mappings":"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","names":["z","z"]}