@gadicc/loom 1.18.0 → 1.19.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.
- package/README.md +60 -2
- package/esm/src/cli/mod.d.ts.map +1 -1
- package/esm/src/cli/mod.js +10 -1
- package/esm/src/jobs/controller.d.ts +14 -1
- package/esm/src/jobs/controller.d.ts.map +1 -1
- package/esm/src/jobs/controller.js +54 -3
- package/esm/src/jobs/events.d.ts +9 -1
- package/esm/src/jobs/events.d.ts.map +1 -1
- package/esm/src/jobs/events.js +15 -2
- package/esm/src/jobs/mod.d.ts +1 -0
- package/esm/src/jobs/mod.d.ts.map +1 -1
- package/esm/src/jobs/mod.js +1 -0
- package/esm/src/jobs/run.d.ts +20 -1
- package/esm/src/jobs/run.d.ts.map +1 -1
- package/esm/src/jobs/run.js +29 -4
- package/esm/src/jobs/sanitize.d.ts +30 -0
- package/esm/src/jobs/sanitize.d.ts.map +1 -0
- package/esm/src/jobs/sanitize.js +91 -0
- package/esm/src/mail/postal.d.ts.map +1 -1
- package/esm/src/mail/postal.js +25 -20
- package/esm/src/mail/sender.d.ts +5 -0
- package/esm/src/mail/sender.d.ts.map +1 -0
- package/esm/src/mail/sender.js +48 -0
- package/esm/src/mail/service.d.ts.map +1 -1
- package/esm/src/mail/service.js +7 -5
- package/esm/src/next/jobs/route.d.ts.map +1 -1
- package/esm/src/next/jobs/route.js +1 -1
- package/package.json +2 -2
- package/script/src/cli/mod.d.ts.map +1 -1
- package/script/src/cli/mod.js +10 -1
- package/script/src/jobs/controller.d.ts +14 -1
- package/script/src/jobs/controller.d.ts.map +1 -1
- package/script/src/jobs/controller.js +54 -3
- package/script/src/jobs/events.d.ts +9 -1
- package/script/src/jobs/events.d.ts.map +1 -1
- package/script/src/jobs/events.js +15 -2
- package/script/src/jobs/mod.d.ts +1 -0
- package/script/src/jobs/mod.d.ts.map +1 -1
- package/script/src/jobs/mod.js +1 -0
- package/script/src/jobs/run.d.ts +20 -1
- package/script/src/jobs/run.d.ts.map +1 -1
- package/script/src/jobs/run.js +29 -4
- package/script/src/jobs/sanitize.d.ts +30 -0
- package/script/src/jobs/sanitize.d.ts.map +1 -0
- package/script/src/jobs/sanitize.js +97 -0
- package/script/src/mail/postal.d.ts.map +1 -1
- package/script/src/mail/postal.js +25 -20
- package/script/src/mail/sender.d.ts +5 -0
- package/script/src/mail/sender.d.ts.map +1 -0
- package/script/src/mail/sender.js +52 -0
- package/script/src/mail/service.d.ts.map +1 -1
- package/script/src/mail/service.js +7 -5
- package/script/src/next/jobs/route.d.ts.map +1 -1
- package/script/src/next/jobs/route.js +1 -1
- package/skills/loom/SKILL.md +4 -1
- package/skills/loom-jobs/SKILL.md +27 -0
- package/skills/loom-mail/SKILL.md +14 -3
package/README.md
CHANGED
|
@@ -103,8 +103,11 @@ documented in [`docs/project-tooling.md`](docs/project-tooling.md).
|
|
|
103
103
|
orchestration and memory test adapters. `@gadicc/loom/mail/postal` owns the
|
|
104
104
|
Postal HTTP and webhook contract, `@gadicc/loom/next/mail` owns the raw-body
|
|
105
105
|
route handler, and `@gadicc/loom/mui/mail` owns optional serializable admin
|
|
106
|
-
views.
|
|
107
|
-
|
|
106
|
+
views. Keep the default sender structured with the required bare address
|
|
107
|
+
`POSTAL_FROM_EMAIL=noreply@example.com` and optional display name
|
|
108
|
+
`POSTAL_FROM_NAME=Example App`. Configure Postal webhook verification with a
|
|
109
|
+
JSON array of RSA public JWKs in `POSTAL_WEBHOOK_PUBLIC_KEYS`; shared-secret
|
|
110
|
+
emulation is unsupported.
|
|
108
111
|
- `loom files r2 setup` creates or reuses private Cloudflare R2 buckets for
|
|
109
112
|
Production and Preview, records the explicit Cloudflare account and storage
|
|
110
113
|
policy in `loom.json`, replaces only the untouched generated storage stub,
|
|
@@ -447,6 +450,61 @@ import { testMeta } from "./indexWithMetaOnly";
|
|
|
447
450
|
export const test = createLazyJob(testMeta, () => import("./test"));
|
|
448
451
|
```
|
|
449
452
|
|
|
453
|
+
Job output can be sanitized once at the execution boundary so the same policy
|
|
454
|
+
applies to NDJSON, text, HTML, direct runners, HTTP responses, and app-provided
|
|
455
|
+
formatters:
|
|
456
|
+
|
|
457
|
+
```ts
|
|
458
|
+
import { createJobOutputRedactor, type Job } from "@gadicc/loom/jobs";
|
|
459
|
+
import { createJobsRouteHandler } from "@gadicc/loom/next/jobs/route";
|
|
460
|
+
|
|
461
|
+
const providerToken = process.env.PROVIDER_TOKEN;
|
|
462
|
+
if (!providerToken) throw new Error("PROVIDER_TOKEN is required");
|
|
463
|
+
|
|
464
|
+
const outputSanitizer = createJobOutputRedactor(
|
|
465
|
+
new Map<string | RegExp, true | string>([
|
|
466
|
+
[providerToken, true],
|
|
467
|
+
[/Bearer\s+\S+/gi, "Bearer [REDACTED]"],
|
|
468
|
+
]),
|
|
469
|
+
);
|
|
470
|
+
|
|
471
|
+
export const jobsRouteHandler = createJobsRouteHandler({
|
|
472
|
+
catalog: jobs as readonly Job[],
|
|
473
|
+
handlerErrorMessage: "Job execution failed.",
|
|
474
|
+
outputSanitizer,
|
|
475
|
+
});
|
|
476
|
+
```
|
|
477
|
+
|
|
478
|
+
Redaction rules run in map insertion order, each against the preceding rule's
|
|
479
|
+
result. Exact strings match wherever they occur. RegExp rules replace every
|
|
480
|
+
match without using the caller's `lastIndex`, even when the expression is
|
|
481
|
+
non-global or sticky. A `true` replacement means `[REDACTED]`; string
|
|
482
|
+
replacements are literal, so `$&`, `$1`, and `$$` are not expanded. Empty exact
|
|
483
|
+
matchers are rejected without printing configured match or replacement values.
|
|
484
|
+
|
|
485
|
+
The sanitizer visits every string value emitted through `job.log()`, all other
|
|
486
|
+
log levels, and `job.json()` while retaining normal JSON behavior for arrays,
|
|
487
|
+
objects, dates, numbers, booleans, and null. Inputs are not mutated. If a
|
|
488
|
+
sanitizer throws or returns a non-string, Loom fails the execution closed and
|
|
489
|
+
emits only `Job output sanitation failed.` for that failure.
|
|
490
|
+
|
|
491
|
+
Output redaction and unexpected-error disclosure are separate. Omitting
|
|
492
|
+
`handlerErrorMessage` retains Loom's existing full-stack fatal event; supplying
|
|
493
|
+
a string emits that exact generic literal instead. Deferred-task errors keep
|
|
494
|
+
their own `deferredTaskErrorHandler`, and the additive
|
|
495
|
+
`runDeferredTasksWithResult()` method returns a failure count while
|
|
496
|
+
`runDeferredTasks()` keeps its legacy `Promise<void>` contract. Consumers that
|
|
497
|
+
run deferred tasks inline can emit a generic event from that callback; tasks run
|
|
498
|
+
after a response stream closes should report through a separate safe sink.
|
|
499
|
+
`cancellationMessage: false` suppresses the legacy `Job cancelled` event when
|
|
500
|
+
cancellation must only set the controller flag.
|
|
501
|
+
|
|
502
|
+
This boundary protects Loom job-event output only. It does not sanitize
|
|
503
|
+
`console.*`, provider or framework logs, audit metadata, request URLs, thrown
|
|
504
|
+
values retained in `execution.result`, or external logging systems. Object
|
|
505
|
+
property names are JSON structure rather than string values and are not
|
|
506
|
+
rewritten; do not place secrets in keys.
|
|
507
|
+
|
|
450
508
|
For the strongest Next.js deployment boundary, mount jobs in static route files
|
|
451
509
|
with `createJobRouteHandler({ job })`. A dynamic `[id]` route is one serverless
|
|
452
510
|
function and therefore still traces every implementation reachable from its
|
package/esm/src/cli/mod.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/cli/mod.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/cli/mod.ts"],"names":[],"mappings":"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"}
|
package/esm/src/cli/mod.js
CHANGED
|
@@ -4491,6 +4491,11 @@ export function getDefaultMailFromEmail() {
|
|
|
4491
4491
|
return requireEnv("POSTAL_FROM_EMAIL");
|
|
4492
4492
|
}
|
|
4493
4493
|
|
|
4494
|
+
/** Reads the optional default sender display name from the app environment. */
|
|
4495
|
+
export function getDefaultMailFromName() {
|
|
4496
|
+
return process.env.POSTAL_FROM_NAME?.trim() || undefined;
|
|
4497
|
+
}
|
|
4498
|
+
|
|
4494
4499
|
export function getPostalWebhookPublicKeys(): PostalWebhookPublicKey[] {
|
|
4495
4500
|
const raw = process.env.POSTAL_WEBHOOK_PUBLIC_KEYS?.trim();
|
|
4496
4501
|
if (!raw) throw new Error("POSTAL_WEBHOOK_PUBLIC_KEYS is not set.");
|
|
@@ -4516,6 +4521,7 @@ function mailServiceTemplate(config) {
|
|
|
4516
4521
|
import { mailRepository } from "${toAliasImportPath(config.modules.repositoryModule)}";
|
|
4517
4522
|
import {
|
|
4518
4523
|
getDefaultMailFromEmail,
|
|
4524
|
+
getDefaultMailFromName,
|
|
4519
4525
|
mailTransport,
|
|
4520
4526
|
} from "${toAliasImportPath(config.modules.transportModule)}";
|
|
4521
4527
|
|
|
@@ -4523,6 +4529,9 @@ export const mailService = createLoomMailService({
|
|
|
4523
4529
|
get defaultFromEmail() {
|
|
4524
4530
|
return getDefaultMailFromEmail();
|
|
4525
4531
|
},
|
|
4532
|
+
get defaultFromName() {
|
|
4533
|
+
return getDefaultMailFromName();
|
|
4534
|
+
},
|
|
4526
4535
|
repository: mailRepository,
|
|
4527
4536
|
transport: mailTransport,
|
|
4528
4537
|
});
|
|
@@ -7518,7 +7527,7 @@ async function applyMailFeature(cwd, framework, manifest, activate) {
|
|
|
7518
7527
|
changedFiles.push(...materialized.changedFiles);
|
|
7519
7528
|
notes.push(...materialized.notes);
|
|
7520
7529
|
config.schema = materialized.schema;
|
|
7521
|
-
notes.push("No migration was generated. Review the mail schema diff, then create and apply the app-local migration deliberately.", "Configure POSTAL_API_KEY, POSTAL_HOST,
|
|
7530
|
+
notes.push("No migration was generated. Review the mail schema diff, then create and apply the app-local migration deliberately.", "Configure POSTAL_API_KEY, POSTAL_HOST, and POSTAL_WEBHOOK_PUBLIC_KEYS before sending mail or receiving webhooks.", "Set POSTAL_FROM_EMAIL=noreply@example.com to a bare default sender address; optionally set POSTAL_FROM_NAME=Example App.");
|
|
7522
7531
|
}
|
|
7523
7532
|
const scaffolds = [
|
|
7524
7533
|
[config.modules.accessModule, mailAccessTemplate(), "admin access policy"],
|
|
@@ -1,9 +1,15 @@
|
|
|
1
|
+
import { type JobOutputSanitizer } from "./sanitize.js";
|
|
1
2
|
import type { DeferredTask } from "./types.js";
|
|
2
3
|
export interface DeferredTaskErrorContext {
|
|
4
|
+
controller: JobController;
|
|
3
5
|
deferred: DeferredTask;
|
|
4
6
|
error: unknown;
|
|
5
7
|
}
|
|
6
8
|
export type DeferredTaskErrorHandler = (context: DeferredTaskErrorContext) => void;
|
|
9
|
+
/** Aggregate result for one pass over a controller's deferred tasks. */
|
|
10
|
+
export interface DeferredTaskRunResult {
|
|
11
|
+
failureCount: number;
|
|
12
|
+
}
|
|
7
13
|
export declare function defaultDeferredTaskErrorHandler(context: DeferredTaskErrorContext): void;
|
|
8
14
|
export declare class JobController {
|
|
9
15
|
static readonly _logLevels: readonly ["fatal", "error", "warn", "info", "log", "debug", "trace"];
|
|
@@ -12,8 +18,13 @@ export declare class JobController {
|
|
|
12
18
|
_cancelled: boolean;
|
|
13
19
|
_deferred: DeferredTask[];
|
|
14
20
|
_maxLogLevel: number;
|
|
15
|
-
|
|
21
|
+
_outputSanitationFailed: boolean;
|
|
22
|
+
_outputSanitationFailureEmitted: boolean;
|
|
23
|
+
_outputSanitizer?: JobOutputSanitizer;
|
|
24
|
+
constructor(controller: ReadableStreamDefaultController<string>, maxLogLevel?: number, outputSanitizer?: JobOutputSanitizer);
|
|
16
25
|
json<T>(obj: T): void;
|
|
26
|
+
/** @internal Emit one fixed failure event without invoking a failed policy. */
|
|
27
|
+
_emitOutputSanitationFailure(): void;
|
|
17
28
|
_log(levelInt: number, args: unknown[]): void;
|
|
18
29
|
fatal(...args: unknown[]): void;
|
|
19
30
|
error(...args: unknown[]): void;
|
|
@@ -24,5 +35,7 @@ export declare class JobController {
|
|
|
24
35
|
trace(...args: unknown[]): void;
|
|
25
36
|
defer(task: () => Promise<void> | void, label?: string): void;
|
|
26
37
|
runDeferredTasks(onError?: DeferredTaskErrorHandler): Promise<void>;
|
|
38
|
+
/** Run deferred tasks while reporting an additive aggregate failure count. */
|
|
39
|
+
runDeferredTasksWithResult(onError?: DeferredTaskErrorHandler): Promise<DeferredTaskRunResult>;
|
|
27
40
|
}
|
|
28
41
|
//# sourceMappingURL=controller.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../src/src/jobs/controller.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,wBAAwB,GAAG,CACrC,OAAO,EAAE,wBAAwB,KAC9B,IAAI,CAAC;AAEV,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,wBAAwB,QAYlC;AAED,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,UAAU,uEAAkB;IAC5C,MAAM,CAAC,QAAQ,CAAC,aAAa,4FAAwB;IAErD,WAAW,EAAE,+BAA+B,CAAC,MAAM,CAAC,CAAC;IACrD,UAAU,UAAS;IACnB,SAAS,EAAE,YAAY,EAAE,CAAM;IAC/B,YAAY,SAA6B;
|
|
1
|
+
{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../src/src/jobs/controller.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,aAAa,CAAC;IAC1B,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,wBAAwB,GAAG,CACrC,OAAO,EAAE,wBAAwB,KAC9B,IAAI,CAAC;AAEV,wEAAwE;AACxE,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,wBAAwB,QAYlC;AAED,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,UAAU,uEAAkB;IAC5C,MAAM,CAAC,QAAQ,CAAC,aAAa,4FAAwB;IAErD,WAAW,EAAE,+BAA+B,CAAC,MAAM,CAAC,CAAC;IACrD,UAAU,UAAS;IACnB,SAAS,EAAE,YAAY,EAAE,CAAM;IAC/B,YAAY,SAA6B;IACzC,uBAAuB,UAAS;IAChC,+BAA+B,UAAS;IACxC,gBAAgB,CAAC,EAAE,kBAAkB,CAAC;gBAGpC,UAAU,EAAE,+BAA+B,CAAC,MAAM,CAAC,EACnD,WAAW,CAAC,EAAE,MAAM,EACpB,eAAe,CAAC,EAAE,kBAAkB;IAStC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;IAed,+EAA+E;IAC/E,4BAA4B;IAc5B,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE;IAMtC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAIxB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAIxB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAIvB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAIvB,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAItB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAIxB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAIxB,KAAK,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM;IAIhD,gBAAgB,CACpB,OAAO,GAAE,wBAA0D,GAClE,OAAO,CAAC,IAAI,CAAC;IAIhB,8EAA8E;IACxE,0BAA0B,CAC9B,OAAO,GAAE,wBAA0D,GAClE,OAAO,CAAC,qBAAqB,CAAC;CAYlC"}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { JOB_LOG_LEVEL_TO_INT, JOB_LOG_LEVELS, serializeJobEvent, } from "./events.js";
|
|
2
|
+
import { JOB_OUTPUT_SANITATION_FAILURE_MESSAGE, JobOutputSanitationError, } from "./sanitize.js";
|
|
2
3
|
export function defaultDeferredTaskErrorHandler(context) {
|
|
3
4
|
const prefix = context.deferred.label
|
|
4
5
|
? `Deferred task "${context.deferred.label}" failed`
|
|
@@ -8,7 +9,7 @@ export function defaultDeferredTaskErrorHandler(context) {
|
|
|
8
9
|
: context.error);
|
|
9
10
|
}
|
|
10
11
|
export class JobController {
|
|
11
|
-
constructor(controller, maxLogLevel) {
|
|
12
|
+
constructor(controller, maxLogLevel, outputSanitizer) {
|
|
12
13
|
Object.defineProperty(this, "_controller", {
|
|
13
14
|
enumerable: true,
|
|
14
15
|
configurable: true,
|
|
@@ -33,13 +34,56 @@ export class JobController {
|
|
|
33
34
|
writable: true,
|
|
34
35
|
value: JOB_LOG_LEVELS.length - 1
|
|
35
36
|
});
|
|
37
|
+
Object.defineProperty(this, "_outputSanitationFailed", {
|
|
38
|
+
enumerable: true,
|
|
39
|
+
configurable: true,
|
|
40
|
+
writable: true,
|
|
41
|
+
value: false
|
|
42
|
+
});
|
|
43
|
+
Object.defineProperty(this, "_outputSanitationFailureEmitted", {
|
|
44
|
+
enumerable: true,
|
|
45
|
+
configurable: true,
|
|
46
|
+
writable: true,
|
|
47
|
+
value: false
|
|
48
|
+
});
|
|
49
|
+
Object.defineProperty(this, "_outputSanitizer", {
|
|
50
|
+
enumerable: true,
|
|
51
|
+
configurable: true,
|
|
52
|
+
writable: true,
|
|
53
|
+
value: void 0
|
|
54
|
+
});
|
|
36
55
|
this._controller = controller;
|
|
37
56
|
if (typeof maxLogLevel === "number") {
|
|
38
57
|
this._maxLogLevel = maxLogLevel;
|
|
39
58
|
}
|
|
59
|
+
this._outputSanitizer = outputSanitizer;
|
|
40
60
|
}
|
|
41
61
|
json(obj) {
|
|
42
|
-
this.
|
|
62
|
+
if (this._outputSanitationFailed) {
|
|
63
|
+
throw new JobOutputSanitationError();
|
|
64
|
+
}
|
|
65
|
+
try {
|
|
66
|
+
this._controller.enqueue(serializeJobEvent(obj, this._outputSanitizer));
|
|
67
|
+
}
|
|
68
|
+
catch (error) {
|
|
69
|
+
if (error instanceof JobOutputSanitationError) {
|
|
70
|
+
this._outputSanitationFailed = true;
|
|
71
|
+
}
|
|
72
|
+
throw error;
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
/** @internal Emit one fixed failure event without invoking a failed policy. */
|
|
76
|
+
_emitOutputSanitationFailure() {
|
|
77
|
+
if (this._outputSanitationFailureEmitted)
|
|
78
|
+
return;
|
|
79
|
+
this._outputSanitationFailureEmitted = true;
|
|
80
|
+
this._controller.enqueue(serializeJobEvent({
|
|
81
|
+
_log: [
|
|
82
|
+
Date.now(),
|
|
83
|
+
JobController._logLevelsInt.fatal,
|
|
84
|
+
JOB_OUTPUT_SANITATION_FAILURE_MESSAGE,
|
|
85
|
+
],
|
|
86
|
+
}));
|
|
43
87
|
}
|
|
44
88
|
_log(levelInt, args) {
|
|
45
89
|
if (levelInt <= this._maxLogLevel) {
|
|
@@ -71,14 +115,21 @@ export class JobController {
|
|
|
71
115
|
this._deferred.push({ label, task });
|
|
72
116
|
}
|
|
73
117
|
async runDeferredTasks(onError = defaultDeferredTaskErrorHandler) {
|
|
118
|
+
await this.runDeferredTasksWithResult(onError);
|
|
119
|
+
}
|
|
120
|
+
/** Run deferred tasks while reporting an additive aggregate failure count. */
|
|
121
|
+
async runDeferredTasksWithResult(onError = defaultDeferredTaskErrorHandler) {
|
|
122
|
+
let failureCount = 0;
|
|
74
123
|
for (const deferred of this._deferred) {
|
|
75
124
|
try {
|
|
76
125
|
await deferred.task();
|
|
77
126
|
}
|
|
78
127
|
catch (error) {
|
|
79
|
-
|
|
128
|
+
failureCount++;
|
|
129
|
+
onError({ controller: this, deferred, error });
|
|
80
130
|
}
|
|
81
131
|
}
|
|
132
|
+
return { failureCount };
|
|
82
133
|
}
|
|
83
134
|
}
|
|
84
135
|
Object.defineProperty(JobController, "_logLevels", {
|
package/esm/src/jobs/events.d.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { type JobOutputSanitizer } from "./sanitize.js";
|
|
1
2
|
export declare const JOB_LOG_LEVELS: readonly ["fatal", "error", "warn", "info", "log", "debug", "trace"];
|
|
2
3
|
export type JobLogLevel = (typeof JOB_LOG_LEVELS)[number];
|
|
3
4
|
export declare const JOB_LOG_LEVEL_TO_INT: Readonly<Record<JobLogLevel, number>>;
|
|
@@ -8,7 +9,14 @@ export interface JobLogEvent {
|
|
|
8
9
|
_log: [timestamp: number, levelInt: number, ...args: unknown[]];
|
|
9
10
|
}
|
|
10
11
|
export type JobStreamEvent = JobLifecycleEvent | JobLogEvent | Record<string, unknown>;
|
|
11
|
-
|
|
12
|
+
/**
|
|
13
|
+
* Serialize one job event, optionally sanitizing every string value.
|
|
14
|
+
*
|
|
15
|
+
* JSON's replacer traversal preserves its normal handling of arrays, objects,
|
|
16
|
+
* dates, primitives, `toJSON`, omitted object values, and array holes without
|
|
17
|
+
* mutating the input value.
|
|
18
|
+
*/
|
|
19
|
+
export declare function serializeJobEvent(event: unknown, outputSanitizer?: JobOutputSanitizer): string;
|
|
12
20
|
export declare function parseJobEvent(line: string): JobStreamEvent;
|
|
13
21
|
export declare function isJobLifecycleEvent(event: JobStreamEvent): event is JobLifecycleEvent;
|
|
14
22
|
export declare function isJobLogEvent(event: JobStreamEvent): event is JobLogEvent;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/src/jobs/events.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,sEAQjB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAQtE,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;CACjE;AAED,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,WAAW,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B,wBAAgB,iBAAiB,
|
|
1
|
+
{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/src/jobs/events.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EAExB,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,cAAc,sEAQjB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAQtE,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;CACjE;AAED,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,WAAW,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,eAAe,CAAC,EAAE,kBAAkB,GACnC,MAAM,CAWR;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAE1D;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,GACpB,KAAK,IAAI,iBAAiB,CAE5B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,KAAK,IAAI,WAAW,CAEzE"}
|
package/esm/src/jobs/events.js
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { sanitizeJobOutputString, } from "./sanitize.js";
|
|
1
2
|
export const JOB_LOG_LEVELS = [
|
|
2
3
|
"fatal",
|
|
3
4
|
"error",
|
|
@@ -16,8 +17,20 @@ export const JOB_LOG_LEVEL_TO_INT = {
|
|
|
16
17
|
debug: 5,
|
|
17
18
|
trace: 6,
|
|
18
19
|
};
|
|
19
|
-
|
|
20
|
-
|
|
20
|
+
/**
|
|
21
|
+
* Serialize one job event, optionally sanitizing every string value.
|
|
22
|
+
*
|
|
23
|
+
* JSON's replacer traversal preserves its normal handling of arrays, objects,
|
|
24
|
+
* dates, primitives, `toJSON`, omitted object values, and array holes without
|
|
25
|
+
* mutating the input value.
|
|
26
|
+
*/
|
|
27
|
+
export function serializeJobEvent(event, outputSanitizer) {
|
|
28
|
+
const serialized = outputSanitizer
|
|
29
|
+
? JSON.stringify(event, (_key, value) => typeof value === "string"
|
|
30
|
+
? sanitizeJobOutputString(outputSanitizer, value)
|
|
31
|
+
: value)
|
|
32
|
+
: JSON.stringify(event);
|
|
33
|
+
return `${serialized}\n`;
|
|
21
34
|
}
|
|
22
35
|
export function parseJobEvent(line) {
|
|
23
36
|
return JSON.parse(line);
|
package/esm/src/jobs/mod.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/jobs/mod.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}
|
|
1
|
+
{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/jobs/mod.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}
|
package/esm/src/jobs/mod.js
CHANGED
package/esm/src/jobs/run.d.ts
CHANGED
|
@@ -1,7 +1,10 @@
|
|
|
1
|
-
import { JobController } from "./controller.js";
|
|
1
|
+
import { type DeferredTaskErrorHandler, JobController } from "./controller.js";
|
|
2
|
+
import { type JobOutputSanitizer } from "./sanitize.js";
|
|
2
3
|
import type { JobDefinition, JobParams } from "./types.js";
|
|
3
4
|
export interface JobRunResult<TJob extends JobDefinition = JobDefinition> {
|
|
4
5
|
controller: JobController;
|
|
6
|
+
/** Present on Loom-created executions; optional for legacy result adapters. */
|
|
7
|
+
deferredTaskFailureCount?: number;
|
|
5
8
|
error: unknown | null;
|
|
6
9
|
job: TJob;
|
|
7
10
|
params: JobParams;
|
|
@@ -12,8 +15,24 @@ export interface JobExecution<TJob extends JobDefinition = JobDefinition> {
|
|
|
12
15
|
getController: () => JobController | null;
|
|
13
16
|
}
|
|
14
17
|
export interface CreateJobExecutionOptions {
|
|
18
|
+
/**
|
|
19
|
+
* Message deliberately emitted when the job handler throws. Omit it to keep
|
|
20
|
+
* Loom's legacy full-stack output behavior.
|
|
21
|
+
*/
|
|
22
|
+
handlerErrorMessage?: string;
|
|
23
|
+
/** Maximum log level included in the event stream. */
|
|
15
24
|
maxLogLevel?: number;
|
|
25
|
+
/** Sanitize every string value emitted through the job controller. */
|
|
26
|
+
outputSanitizer?: JobOutputSanitizer;
|
|
27
|
+
/** Run deferred tasks before the end event instead of leaving them pending. */
|
|
16
28
|
runDeferredTasks?: boolean;
|
|
29
|
+
/** Handle deferred-task errors independently from handler error disclosure. */
|
|
30
|
+
deferredTaskErrorHandler?: DeferredTaskErrorHandler;
|
|
31
|
+
/**
|
|
32
|
+
* Message emitted when a consumer cancels the stream. Set to `false` to keep
|
|
33
|
+
* cancellation silent. Omit it to preserve the legacy "Job cancelled" log.
|
|
34
|
+
*/
|
|
35
|
+
cancellationMessage?: string | false;
|
|
17
36
|
}
|
|
18
37
|
export declare function formatJobError(error: unknown): string;
|
|
19
38
|
export declare function createJobExecution<TJob extends JobDefinition>(job: TJob, params?: JobParams, options?: CreateJobExecutionOptions): JobExecution<TJob>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/src/jobs/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/src/jobs/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,wBAAwB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE/E,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE3D,MAAM,WAAW,YAAY,CAAC,IAAI,SAAS,aAAa,GAAG,aAAa;IACtE,UAAU,EAAE,aAAa,CAAC;IAC1B,+EAA+E;IAC/E,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,GAAG,EAAE,IAAI,CAAC;IACV,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,YAAY,CAAC,IAAI,SAAS,aAAa,GAAG,aAAa;IACtE,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,aAAa,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+EAA+E;IAC/E,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IACpD;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CACtC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUrD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,SAAS,aAAa,EAC3D,GAAG,EAAE,IAAI,EACT,MAAM,GAAE,SAAc,EACtB,OAAO,GAAE,yBAA8B,GACtC,YAAY,CAAC,IAAI,CAAC,CAgFpB"}
|
package/esm/src/jobs/run.js
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { JobController } from "./controller.js";
|
|
2
2
|
import { serializeJobEvent } from "./events.js";
|
|
3
|
+
import { JobOutputSanitationError, } from "./sanitize.js";
|
|
3
4
|
export function formatJobError(error) {
|
|
4
5
|
if (error instanceof Error) {
|
|
5
6
|
return error.stack ?? error.toString();
|
|
@@ -20,22 +21,44 @@ export function createJobExecution(job, params = {}, options = {}) {
|
|
|
20
21
|
const stream = new ReadableStream({
|
|
21
22
|
async start(controller) {
|
|
22
23
|
controller.enqueue(serializeJobEvent({ _job: "start" }));
|
|
23
|
-
jobController = new JobController(controller, options.maxLogLevel);
|
|
24
|
+
jobController = new JobController(controller, options.maxLogLevel, options.outputSanitizer);
|
|
24
25
|
let error = null;
|
|
26
|
+
let deferredTaskFailureCount = 0;
|
|
25
27
|
try {
|
|
26
28
|
await job.handler(jobController, params);
|
|
29
|
+
if (jobController._outputSanitationFailed) {
|
|
30
|
+
throw new JobOutputSanitationError();
|
|
31
|
+
}
|
|
27
32
|
if (options.runDeferredTasks) {
|
|
28
|
-
await jobController.
|
|
33
|
+
const deferredResult = await jobController.runDeferredTasksWithResult(options.deferredTaskErrorHandler);
|
|
34
|
+
deferredTaskFailureCount = deferredResult.failureCount;
|
|
29
35
|
}
|
|
30
36
|
}
|
|
31
37
|
catch (caught) {
|
|
32
38
|
error = caught;
|
|
33
|
-
|
|
39
|
+
if (caught instanceof JobOutputSanitationError ||
|
|
40
|
+
jobController._outputSanitationFailed) {
|
|
41
|
+
jobController._emitOutputSanitationFailure();
|
|
42
|
+
}
|
|
43
|
+
else {
|
|
44
|
+
try {
|
|
45
|
+
jobController.fatal(options.handlerErrorMessage ?? formatJobError(caught));
|
|
46
|
+
}
|
|
47
|
+
catch (reportingError) {
|
|
48
|
+
if (reportingError instanceof JobOutputSanitationError) {
|
|
49
|
+
jobController._emitOutputSanitationFailure();
|
|
50
|
+
}
|
|
51
|
+
else {
|
|
52
|
+
throw reportingError;
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
}
|
|
34
56
|
}
|
|
35
57
|
controller.enqueue(serializeJobEvent({ _job: "end" }));
|
|
36
58
|
controller.close();
|
|
37
59
|
resolveResult({
|
|
38
60
|
controller: jobController,
|
|
61
|
+
deferredTaskFailureCount,
|
|
39
62
|
error,
|
|
40
63
|
job,
|
|
41
64
|
params,
|
|
@@ -45,7 +68,9 @@ export function createJobExecution(job, params = {}, options = {}) {
|
|
|
45
68
|
if (!jobController) {
|
|
46
69
|
throw new Error("Job cancelled but job controller not set.");
|
|
47
70
|
}
|
|
48
|
-
|
|
71
|
+
if (options.cancellationMessage !== false) {
|
|
72
|
+
jobController.log(options.cancellationMessage ?? "Job cancelled");
|
|
73
|
+
}
|
|
49
74
|
jobController._cancelled = true;
|
|
50
75
|
},
|
|
51
76
|
});
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/** Default literal used when a redaction rule has `true` as its replacement. */
|
|
2
|
+
export declare const DEFAULT_JOB_OUTPUT_REDACTION = "[REDACTED]";
|
|
3
|
+
/** Safe event text emitted when a configured output sanitizer cannot run. */
|
|
4
|
+
export declare const JOB_OUTPUT_SANITATION_FAILURE_MESSAGE = "Job output sanitation failed.";
|
|
5
|
+
/** Transform one string value before it enters a serialized job event. */
|
|
6
|
+
export type JobOutputSanitizer = (value: string) => string;
|
|
7
|
+
/** Ordered exact-string and regular-expression output redaction rules. */
|
|
8
|
+
export type JobOutputRedactionRules = ReadonlyMap<string | RegExp, true | string>;
|
|
9
|
+
/**
|
|
10
|
+
* Fixed, input-independent error raised when output sanitation fails.
|
|
11
|
+
*
|
|
12
|
+
* The original sanitizer error is deliberately not attached because its
|
|
13
|
+
* message or cause may include the value that was being sanitized.
|
|
14
|
+
*/
|
|
15
|
+
export declare class JobOutputSanitationError extends Error {
|
|
16
|
+
constructor();
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Create a deterministic string redactor from ordered exact and RegExp rules.
|
|
20
|
+
*
|
|
21
|
+
* Rules run in map insertion order and each rule receives the result of the
|
|
22
|
+
* previous rule. Exact strings are replaced everywhere. RegExp rules replace
|
|
23
|
+
* every match regardless of their original `g`, `y`, or `lastIndex` state.
|
|
24
|
+
* Replacement strings are always literal, so `$&`, `$1`, and `$$` have no
|
|
25
|
+
* special meaning. The rules are snapshotted when this function is called.
|
|
26
|
+
*/
|
|
27
|
+
export declare function createJobOutputRedactor(rules: JobOutputRedactionRules): JobOutputSanitizer;
|
|
28
|
+
/** @internal Apply a sanitizer while replacing all failures with a safe error. */
|
|
29
|
+
export declare function sanitizeJobOutputString(sanitizer: JobOutputSanitizer, value: string): string;
|
|
30
|
+
//# sourceMappingURL=sanitize.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../../src/src/jobs/sanitize.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,eAAO,MAAM,4BAA4B,eAAe,CAAC;AAEzD,6EAA6E;AAC7E,eAAO,MAAM,qCAAqC,kCACjB,CAAC;AAElC,0EAA0E;AAC1E,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AAE3D,0EAA0E;AAC1E,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAC/C,MAAM,GAAG,MAAM,EACf,IAAI,GAAG,MAAM,CACd,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;;CAKlD;AAuBD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,uBAAuB,GAC7B,kBAAkB,CA+DpB;AAED,kFAAkF;AAClF,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,kBAAkB,EAC7B,KAAK,EAAE,MAAM,GACZ,MAAM,CAUR"}
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
/** Default literal used when a redaction rule has `true` as its replacement. */
|
|
2
|
+
export const DEFAULT_JOB_OUTPUT_REDACTION = "[REDACTED]";
|
|
3
|
+
/** Safe event text emitted when a configured output sanitizer cannot run. */
|
|
4
|
+
export const JOB_OUTPUT_SANITATION_FAILURE_MESSAGE = "Job output sanitation failed.";
|
|
5
|
+
/**
|
|
6
|
+
* Fixed, input-independent error raised when output sanitation fails.
|
|
7
|
+
*
|
|
8
|
+
* The original sanitizer error is deliberately not attached because its
|
|
9
|
+
* message or cause may include the value that was being sanitized.
|
|
10
|
+
*/
|
|
11
|
+
export class JobOutputSanitationError extends Error {
|
|
12
|
+
constructor() {
|
|
13
|
+
super(JOB_OUTPUT_SANITATION_FAILURE_MESSAGE);
|
|
14
|
+
this.name = "JobOutputSanitationError";
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
function compileRegExpFlags(flags) {
|
|
18
|
+
// A redaction rule always scans the full string. `lastIndex`, `g`, and `y`
|
|
19
|
+
// therefore cannot make matching depend on prior calls or an initial offset.
|
|
20
|
+
return `${flags.replaceAll("g", "").replaceAll("y", "")}g`;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Create a deterministic string redactor from ordered exact and RegExp rules.
|
|
24
|
+
*
|
|
25
|
+
* Rules run in map insertion order and each rule receives the result of the
|
|
26
|
+
* previous rule. Exact strings are replaced everywhere. RegExp rules replace
|
|
27
|
+
* every match regardless of their original `g`, `y`, or `lastIndex` state.
|
|
28
|
+
* Replacement strings are always literal, so `$&`, `$1`, and `$$` have no
|
|
29
|
+
* special meaning. The rules are snapshotted when this function is called.
|
|
30
|
+
*/
|
|
31
|
+
export function createJobOutputRedactor(rules) {
|
|
32
|
+
const compiled = [];
|
|
33
|
+
let index = 0;
|
|
34
|
+
for (const [matcher, configuredReplacement] of rules) {
|
|
35
|
+
index++;
|
|
36
|
+
const replacement = configuredReplacement === true
|
|
37
|
+
? DEFAULT_JOB_OUTPUT_REDACTION
|
|
38
|
+
: configuredReplacement;
|
|
39
|
+
if (typeof replacement !== "string") {
|
|
40
|
+
throw new TypeError(`Job output redaction rule ${index} has an invalid replacement.`);
|
|
41
|
+
}
|
|
42
|
+
if (typeof matcher === "string") {
|
|
43
|
+
if (matcher.length === 0) {
|
|
44
|
+
throw new TypeError(`Job output redaction rule ${index} has an empty exact-string matcher.`);
|
|
45
|
+
}
|
|
46
|
+
compiled.push({ kind: "exact", replacement, search: matcher });
|
|
47
|
+
continue;
|
|
48
|
+
}
|
|
49
|
+
if (!(matcher instanceof RegExp)) {
|
|
50
|
+
throw new TypeError(`Job output redaction rule ${index} has an invalid matcher.`);
|
|
51
|
+
}
|
|
52
|
+
try {
|
|
53
|
+
compiled.push({
|
|
54
|
+
flags: compileRegExpFlags(matcher.flags),
|
|
55
|
+
kind: "regexp",
|
|
56
|
+
replacement,
|
|
57
|
+
source: matcher.source,
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
catch {
|
|
61
|
+
throw new TypeError(`Job output redaction rule ${index} has an invalid regular expression.`);
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
return (value) => {
|
|
65
|
+
let sanitized = value;
|
|
66
|
+
for (const rule of compiled) {
|
|
67
|
+
if (rule.kind === "exact") {
|
|
68
|
+
sanitized = sanitized.split(rule.search).join(rule.replacement);
|
|
69
|
+
continue;
|
|
70
|
+
}
|
|
71
|
+
// Create a fresh matcher per application so no RegExp state can cross
|
|
72
|
+
// values, rules, executions, or concurrent consumers.
|
|
73
|
+
const matcher = new RegExp(rule.source, rule.flags);
|
|
74
|
+
sanitized = sanitized.replace(matcher, () => rule.replacement);
|
|
75
|
+
}
|
|
76
|
+
return sanitized;
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
/** @internal Apply a sanitizer while replacing all failures with a safe error. */
|
|
80
|
+
export function sanitizeJobOutputString(sanitizer, value) {
|
|
81
|
+
try {
|
|
82
|
+
const sanitized = sanitizer(value);
|
|
83
|
+
if (typeof sanitized !== "string") {
|
|
84
|
+
throw new JobOutputSanitationError();
|
|
85
|
+
}
|
|
86
|
+
return sanitized;
|
|
87
|
+
}
|
|
88
|
+
catch {
|
|
89
|
+
throw new JobOutputSanitationError();
|
|
90
|
+
}
|
|
91
|
+
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"postal.d.ts","sourceRoot":"","sources":["../../../src/src/mail/postal.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAA0B,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"postal.d.ts","sourceRoot":"","sources":["../../../src/src/mail/postal.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAA0B,MAAM,aAAa,CAAC;AAKpE,OAAO,KAAK,EAEV,qBAAqB,EACrB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE;QACL,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CACf,MAAM,EACN;YAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CACjE,CAAC;QACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAuB,SAAQ,UAAU;IACxD,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAKxE;AAyDD,8EAA8E;AAC9E,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,iBAAiB,CAgFnB;AAoBD,0EAA0E;AAC1E,wBAAsB,4BAA4B,CAAC,OAAO,EAAE;IAC1D,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,SAAS,sBAAsB,EAAE,CAAC;CAC/C;;GAsDA;AA2DD,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CA0BtE"}
|