@cqrs-ddd/pipeline-job-context 0.5.0

package/dist/helpers/with-job-context.js

@@ -0,0 +1,46 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+import { MissingJobContextError } from '../errors/missing-job-context.error.js';
+import { toReference } from './principal-reference.js';
+import { activeRegistration } from './registration.js';
+/**
+ * Stamps the current execution context onto a job payload: the tenant and
+ * correlation id of the registered sources (a new one from the correlation
+ * source's `create()` when none is active), and the principal the registered `IJobPrincipal`
+ * captures, reduced to its identity. The processor restores it with
+ * `@InJobContext`.
+ *
+ * @param data - The payload. Must be a plain object; a shallow copy is returned.
+ * @returns A copy of `data` with `jobContext` added.
+ * @throws {TypeError} When `data` is not a plain object.
+ * @throws {MissingJobContextError} Without a `registerJobContext` registration, a
+ *   current tenant, or a current principal.
+ *
+ * @example
+ * ```ts
+ * await queue.add('send', withJobContext({ userId, email }));
+ * ```
+ */
+export function withJobContext(data) {
+    const prototype = data !== null && typeof data === 'object'
+        ? Object.getPrototypeOf(data)
+        : undefined;
+    if (prototype !== Object.prototype && prototype !== null) {
+        throw new TypeError('withJobContext(data) requires a plain object payload. Wrap arrays and class instances in a plain object first.');
+    }
+    const { principal, sources } = activeRegistration();
+    const tenantId = sources.tenantId.current();
+    if (tenantId === undefined)
+        throw new MissingJobContextError('tenant');
+    const captured = principal.capture();
+    if (captured === undefined)
+        throw new MissingJobContextError('principal');
+    return {
+        ...data,
+        jobContext: {
+            tenantId,
+            correlationId: sources.correlationId.current() ?? sources.correlationId.create(),
+            principal: toReference(captured),
+        },
+    };
+}
+//# sourceMappingURL=with-job-context.js.map

package/dist/helpers/with-job-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-job-context.js","sourceRoot":"","sources":["../../src/helpers/with-job-context.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAEhF,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAO;IAEP,MAAM,SAAS,GACb,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QACvC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC;QAC7B,CAAC,CAAC,SAAS,CAAC;IAChB,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACzD,MAAM,IAAI,SAAS,CACjB,gHAAgH,CACjH,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC5C,IAAI,QAAQ,KAAK,SAAS;QAAE,MAAM,IAAI,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;IACrC,IAAI,QAAQ,KAAK,SAAS;QAAE,MAAM,IAAI,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAC1E,OAAO;QACL,GAAG,IAAI;QACP,UAAU,EAAE;YACV,QAAQ;YACR,aAAa,EACX,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE;YACnE,SAAS,EAAE,WAAW,CAAC,QAAQ,CAAC;SACjC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { AsSystem, type AsSystemOptions, } from './decorators/as-system.decorator.js';
+export { InJobContext, type InJobContextOptions, } from './decorators/in-job-context.decorator.js';
+export { InvalidJobContextError } from './errors/invalid-job-context.error.js';
+export { MissingJobContextError } from './errors/missing-job-context.error.js';
+export { withJobContext } from './helpers/with-job-context.js';
+export type { ContextSource, CorrelationSource, JobContextSources, } from './interfaces/context-source.interface.js';
+export type { JobContext, WithJobContext, } from './interfaces/job-context.interface.js';
+export type { IJobPrincipal } from './interfaces/job-principal.interface.js';
+export type { PrincipalReference } from './interfaces/principal-reference.interface.js';
+export { type JobContextOptions, registerJobContext, } from './register-job-context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,GACrB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,GACzB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,0CAA0C,CAAC;AAClD,YAAY,EACV,UAAU,EACV,cAAc,GACf,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,EACL,KAAK,iBAAiB,EACtB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+export { AsSystem, } from './decorators/as-system.decorator.js';
+export { InJobContext, } from './decorators/in-job-context.decorator.js';
+export { InvalidJobContextError } from './errors/invalid-job-context.error.js';
+export { MissingJobContextError } from './errors/missing-job-context.error.js';
+export { withJobContext } from './helpers/with-job-context.js';
+export { registerJobContext, } from './register-job-context.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EACL,QAAQ,GAET,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,YAAY,GAEb,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAY/D,OAAO,EAEL,kBAAkB,GACnB,MAAM,2BAA2B,CAAC"}

package/dist/interfaces/context-source.interface.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A value kept for the current execution by the package that owns it, such as
+ * `tenantSource` of `@cqrs-ddd/pipeline-tenant`.
+ */
+export interface ContextSource {
+    /** The value of the current execution, or `undefined` for none. */
+    current(): string | undefined;
+    /** Runs `fn` with `value` as the current value for everything it calls. */
+    run<T>(value: string | undefined, fn: () => T): T;
+}
+/** A correlation id source that also makes new ids and judges ids received from outside. */
+export interface CorrelationSource extends ContextSource {
+    /** A new correlation id. */
+    create(): string;
+    /** Whether `id`, read from a job payload, is a well-formed correlation id. */
+    accepts(id: string): boolean;
+}
+/** The tenant and correlation id a job carries and restores. */
+export interface JobContextSources {
+    readonly tenantId: ContextSource;
+    readonly correlationId: CorrelationSource;
+}
+//# sourceMappingURL=context-source.interface.d.ts.map

package/dist/interfaces/context-source.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-source.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/context-source.interface.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,OAAO,IAAI,MAAM,GAAG,SAAS,CAAC;IAC9B,2EAA2E;IAC3E,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;CACnD;AAED,4FAA4F;AAC5F,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,4BAA4B;IAC5B,MAAM,IAAI,MAAM,CAAC;IACjB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAC9B;AAED,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C"}

package/dist/interfaces/context-source.interface.js

@@ -0,0 +1,3 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+export {};
+//# sourceMappingURL=context-source.interface.js.map

package/dist/interfaces/context-source.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-source.interface.js","sourceRoot":"","sources":["../../src/interfaces/context-source.interface.ts"],"names":[],"mappings":"AAAA,sEAAsE"}

package/dist/interfaces/job-context.interface.d.ts

@@ -0,0 +1,12 @@
+import type { PrincipalReference } from './principal-reference.interface.js';
+/** Execution context a job payload carries from the request that enqueued it. */
+export interface JobContext {
+    readonly tenantId: string;
+    readonly correlationId: string;
+    readonly principal: PrincipalReference;
+}
+/** A job payload stamped by `withJobContext`. */
+export type WithJobContext<T extends Record<string, unknown>> = T & {
+    jobContext: JobContext;
+};
+//# sourceMappingURL=job-context.interface.d.ts.map

package/dist/interfaces/job-context.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-context.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/job-context.interface.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;CACxC;AAED,iDAAiD;AACjD,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG;IAClE,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC"}

package/dist/interfaces/job-context.interface.js

@@ -0,0 +1,3 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+export {};
+//# sourceMappingURL=job-context.interface.js.map

package/dist/interfaces/job-context.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-context.interface.js","sourceRoot":"","sources":["../../src/interfaces/job-context.interface.ts"],"names":[],"mappings":"AAAA,sEAAsE"}

package/dist/interfaces/job-principal.interface.d.ts

@@ -0,0 +1,28 @@
+import type { PrincipalReference } from './principal-reference.interface.js';
+/**
+ * Application port that reads the current principal when a job is enqueued and
+ * binds it again when the job runs. The application implements it over its own
+ * authentication state; register the implementation with
+ * `registerJobContext`.
+ *
+ * @typeParam TGrant - The application's grant type, as declared in `@AsSystem`.
+ */
+export interface IJobPrincipal<TGrant = unknown> {
+    /**
+     * The principal of the current execution, or `undefined` when there is none.
+     * Only `id`, `type` and `sessionId` of the result are kept.
+     */
+    capture(): PrincipalReference | undefined;
+    /**
+     * Re-checks `principal` against current state and runs `work` with it as the
+     * current principal. It runs inside the job's tenant and correlation id.
+     * Throw to refuse the job, for example for a revoked session or a deleted
+     * principal; the job then fails without running.
+     *
+     * @param grants - Set only for `@AsSystem` work: the complete grants its code
+     *   declares. For a job payload it is `undefined`, and the principal's
+     *   authorization must be resolved from current state.
+     */
+    restore<T>(principal: PrincipalReference, work: () => Promise<T>, grants?: readonly TGrant[]): Promise<T>;
+}
+//# sourceMappingURL=job-principal.interface.d.ts.map

package/dist/interfaces/job-principal.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-principal.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/job-principal.interface.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa,CAAC,MAAM,GAAG,OAAO;IAC7C;;;OAGG;IACH,OAAO,IAAI,kBAAkB,GAAG,SAAS,CAAC;IAE1C;;;;;;;;;OASG;IACH,OAAO,CAAC,CAAC,EACP,SAAS,EAAE,kBAAkB,EAC7B,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,CAAC,CAAC,CAAC;CACf"}

package/dist/interfaces/job-principal.interface.js

@@ -0,0 +1,3 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+export {};
+//# sourceMappingURL=job-principal.interface.js.map

package/dist/interfaces/job-principal.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-principal.interface.js","sourceRoot":"","sources":["../../src/interfaces/job-principal.interface.ts"],"names":[],"mappings":"AAAA,sEAAsE"}

package/dist/interfaces/principal-reference.interface.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Identity of the principal a job acts for. It carries no grants: what the
+ * principal may do is resolved again when the job runs.
+ */
+export interface PrincipalReference {
+    readonly id: string;
+    /** Application-defined classification, such as `'user'` or `'service'`. */
+    readonly type: string;
+    /** Login session the principal authenticated with; absent when it has none. */
+    readonly sessionId?: string;
+}
+//# sourceMappingURL=principal-reference.interface.d.ts.map

package/dist/interfaces/principal-reference.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"principal-reference.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/principal-reference.interface.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/interfaces/principal-reference.interface.js

@@ -0,0 +1,3 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+export {};
+//# sourceMappingURL=principal-reference.interface.js.map

package/dist/interfaces/principal-reference.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"principal-reference.interface.js","sourceRoot":"","sources":["../../src/interfaces/principal-reference.interface.ts"],"names":[],"mappings":"AAAA,sEAAsE"}

package/dist/register-job-context.d.ts

@@ -0,0 +1,34 @@
+import type { JobContextSources } from './interfaces/context-source.interface.js';
+import type { IJobPrincipal } from './interfaces/job-principal.interface.js';
+/** What {@link registerJobContext} makes the job context of the process. */
+export interface JobContextOptions {
+    /** Restores and re-checks the principal of a job, and declares system principals. */
+    principal: IJobPrincipal;
+    /** The tenants a job may run in; a job that names another is refused. */
+    tenants: readonly string[];
+    /**
+     * Where the tenant and the correlation id are stamped from and restored into, such as
+     * `tenantSource` of `@cqrs-ddd/pipeline-tenant` and `correlationSource` of
+     * `@cqrs-ddd/pipeline-correlation`.
+     */
+    sources: JobContextSources;
+}
+/**
+ * Makes `options` the job context of this process: `withJobContext` stamps payloads
+ * with it, `@InJobContext()` restores it, and `@AsSystem` declares system principals
+ * through it. One application registers it once, at startup.
+ *
+ * @returns A function that removes this registration, for shutdown.
+ * @throws TypeError when `tenants` is empty.
+ * @example
+ * ```ts
+ * const unregister = registerJobContext({
+ *   principal: new SessionJobPrincipal(sessions),
+ *   tenants: ['acme', 'globex'],
+ *   sources: { tenantId: tenantSource, correlationId: correlationSource },
+ * });
+ * process.on('SIGTERM', unregister);
+ * ```
+ */
+export declare function registerJobContext(options: JobContextOptions): () => void;
+//# sourceMappingURL=register-job-context.d.ts.map

package/dist/register-job-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-job-context.d.ts","sourceRoot":"","sources":["../src/register-job-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAE7E,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,qFAAqF;IACrF,SAAS,EAAE,aAAa,CAAC;IACzB,yEAAyE;IACzE,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B;;;;OAIG;IACH,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,IAAI,CAWzE"}

package/dist/register-job-context.js

@@ -0,0 +1,32 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+import { register, unregister } from './helpers/registration.js';
+/**
+ * Makes `options` the job context of this process: `withJobContext` stamps payloads
+ * with it, `@InJobContext()` restores it, and `@AsSystem` declares system principals
+ * through it. One application registers it once, at startup.
+ *
+ * @returns A function that removes this registration, for shutdown.
+ * @throws TypeError when `tenants` is empty.
+ * @example
+ * ```ts
+ * const unregister = registerJobContext({
+ *   principal: new SessionJobPrincipal(sessions),
+ *   tenants: ['acme', 'globex'],
+ *   sources: { tenantId: tenantSource, correlationId: correlationSource },
+ * });
+ * process.on('SIGTERM', unregister);
+ * ```
+ */
+export function registerJobContext(options) {
+    if (options.tenants.length === 0) {
+        throw new TypeError('registerJobContext needs at least one tenant.');
+    }
+    const registration = {
+        principal: options.principal,
+        tenants: [...options.tenants],
+        sources: options.sources,
+    };
+    register(registration);
+    return () => unregister(registration);
+}
+//# sourceMappingURL=register-job-context.js.map

package/dist/register-job-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-job-context.js","sourceRoot":"","sources":["../src/register-job-context.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAkBjE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA0B;IAC3D,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,YAAY,GAAG;QACnB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;QAC7B,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;IACF,QAAQ,CAAC,YAAY,CAAC,CAAC;IACvB,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACxC,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@cqrs-ddd/pipeline-job-context",
+  "version": "0.5.0",
+  "description": "Carries the tenant, correlation id and principal of a request into the queue jobs it enqueues, and gives system-started work an explicit context",
+  "author": "Aristotelis",
+  "license": "SEE LICENSE IN LICENSE",
+  "type": "module",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aristoteliss/ddd-cqrs.git",
+    "directory": "packages/pipeline-job-context"
+  },
+  "homepage": "https://aristoteliss.github.io/ddd-cqrs/packages/pipeline-job-context/",
+  "bugs": {
+    "url": "https://github.com/aristoteliss/ddd-cqrs/issues"
+  },
+  "keywords": [
+    "nestjs",
+    "cqrs",
+    "pipeline",
+    "multi-tenancy",
+    "queue",
+    "jobs",
+    "authorization",
+    "correlation-id"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "COMMERCIAL_LICENSE.txt"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^5.0.3",
+    "vitest": "^5.0.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:watch": "tsc -p tsconfig.build.json --watch",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "rebuild": "pnpm run clean && pnpm run build",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}