@ddd-ts-kit/di 0.0.0-stage → 0.1.0

package/dist/discovery/role-files-of.js

@@ -0,0 +1,63 @@
+import { readdir } from 'node:fs/promises';
+import path from 'node:path';
+import { WiringError } from '../errors/wiring-error.js';
+import { ROLE_RULES } from './role-rule.js';
+const SCANNED_LAYERS = ['application', 'infrastructure'];
+/** The role files of a context, sorted by path, so that two machines and two runs wire it in the same order. */
+export async function roleFilesOf(root, selection) {
+    const byStem = new Map();
+    for (const relative of await sourcesOf(root)) {
+        const candidate = candidateOf(root, relative, selection.extensions);
+        if (candidate === undefined || selection.ignore?.(relative) === true) {
+            continue;
+        }
+        const known = byStem.get(candidate.stem);
+        if (known === undefined || candidate.rank < known.rank) {
+            byStem.set(candidate.stem, candidate);
+        }
+    }
+    return [...byStem.values()].sort((left, right) => compare(left.relative, right.relative));
+}
+async function sourcesOf(root) {
+    const layers = await Promise.all(SCANNED_LAYERS.map((layer) => filesUnder(root, layer)));
+    if (layers.every((layer) => layer === undefined)) {
+        throw new WiringError('DISCOVERY_FAILED', `${root} holds neither application/ nor infrastructure/: it is not the directory of a bounded context.`);
+    }
+    return layers.flatMap((layer) => layer ?? []);
+}
+async function filesUnder(root, layer) {
+    try {
+        const entries = await readdir(path.join(root, layer), { recursive: true, withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isFile())
+            .map((entry) => path.relative(root, path.join(entry.parentPath, entry.name)).split(path.sep).join('/'));
+    }
+    catch (error) {
+        if (isMissing(error)) {
+            return undefined;
+        }
+        throw error;
+    }
+}
+function isMissing(error) {
+    return typeof error === 'object' && error !== null && 'code' in error && error.code === 'ENOENT';
+}
+function candidateOf(root, relative, extensions) {
+    const rank = extensions.findIndex((extension) => relative.endsWith(extension));
+    if (rank === -1 || /\.d\.[cm]?ts$/.test(relative)) {
+        return undefined;
+    }
+    const stem = relative.slice(0, -String(extensions[rank]).length);
+    const rule = ROLE_RULES.find(({ suffix }) => stem.endsWith(`.${suffix}`));
+    if (rule === undefined) {
+        return undefined;
+    }
+    return { absolute: path.join(root, relative), relative, rule, stem, rank };
+}
+function compare(left, right) {
+    if (left === right) {
+        return 0;
+    }
+    return left < right ? -1 : 1;
+}
+//# sourceMappingURL=role-files-of.js.map

package/dist/discovery/role-files-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-files-of.js","sourceRoot":"","sources":["../../src/discovery/role-files-of.ts"],"names":[],"mappings":"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"}

package/dist/discovery/role-rule.d.ts

@@ -0,0 +1,10 @@
+import type { Declaration } from '@ddd-ts-kit/kernel/declarations';
+/** What a file name says of the classes it holds: `*.handler.ts` holds handlers, in their folders. */
+export interface RoleRule {
+    readonly suffix: string;
+    /** Folders of the context, relative to it, the files of this suffix belong in. */
+    readonly folders: readonly string[];
+    readonly roles: readonly Declaration['role'][];
+}
+export declare const ROLE_RULES: readonly RoleRule[];
+//# sourceMappingURL=role-rule.d.ts.map

package/dist/discovery/role-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-rule.d.ts","sourceRoot":"","sources":["../../src/discovery/role-rule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE,sGAAsG;AACtG,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;CAChD;AAED,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAqBzC,CAAC"}

package/dist/discovery/role-rule.js

@@ -0,0 +1,23 @@
+export const ROLE_RULES = [
+    { suffix: 'command', folders: ['application/commands'], roles: ['message'] },
+    { suffix: 'query', folders: ['application/queries'], roles: ['message'] },
+    {
+        suffix: 'handler',
+        folders: ['application/commands', 'application/queries'],
+        roles: ['command-handler', 'query-handler'],
+    },
+    {
+        suffix: 'integration-handler',
+        folders: ['application/integration/handlers'],
+        roles: ['integration-event-handler'],
+    },
+    { suffix: 'publisher', folders: ['application/integration/publishers'], roles: ['domain-event-handler'] },
+    { suffix: 'event-handler', folders: ['application/event-handlers'], roles: ['domain-event-handler'] },
+    { suffix: 'policy', folders: ['application/authorization'], roles: ['policy'] },
+    { suffix: 'job', folders: ['application/scheduling'], roles: ['job'] },
+    { suffix: 'projection', folders: ['application/projections'], roles: ['projection'] },
+    { suffix: 'repository', folders: ['infrastructure/persistence'], roles: ['repository'] },
+    { suffix: 'gateway', folders: ['infrastructure'], roles: ['gateway'] },
+    { suffix: 'adapter', folders: ['infrastructure'], roles: ['adapter'] },
+];
+//# sourceMappingURL=role-rule.js.map

package/dist/discovery/role-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-rule.js","sourceRoot":"","sources":["../../src/discovery/role-rule.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,UAAU,GAAwB;IAC7C,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,sBAAsB,CAAC,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE;IAC5E,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE;IACzE;QACE,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,CAAC,sBAAsB,EAAE,qBAAqB,CAAC;QACxD,KAAK,EAAE,CAAC,iBAAiB,EAAE,eAAe,CAAC;KAC5C;IACD;QACE,MAAM,EAAE,qBAAqB;QAC7B,OAAO,EAAE,CAAC,kCAAkC,CAAC;QAC7C,KAAK,EAAE,CAAC,2BAA2B,CAAC;KACrC;IACD,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,oCAAoC,CAAC,EAAE,KAAK,EAAE,CAAC,sBAAsB,CAAC,EAAE;IACzG,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,4BAA4B,CAAC,EAAE,KAAK,EAAE,CAAC,sBAAsB,CAAC,EAAE;IACrG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,2BAA2B,CAAC,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE;IAC/E,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,wBAAwB,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE;IACtE,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,yBAAyB,CAAC,EAAE,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE;IACrF,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,4BAA4B,CAAC,EAAE,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE;IACxF,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE;IACtE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE;CACvE,CAAC"}

package/dist/discovery.d.ts

@@ -0,0 +1,2 @@
+export { discoverContext, type DiscoveryOptions } from './discovery/discover-context.js';
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/discovery.js

@@ -0,0 +1,2 @@
+export { discoverContext } from './discovery/discover-context.js';
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAyB,MAAM,iCAAiC,CAAC"}

package/dist/errors/wiring-error.d.ts

@@ -0,0 +1,7 @@
+export type WiringErrorCode = 'DUPLICATE_BINDING' | 'INCOMPLETE_BINDING' | 'NOTHING_TO_REBIND' | 'INVALID_PORT' | 'UNBOUND_DEPENDENCY' | 'UNBOUND_TOKEN' | 'DEPENDENCY_CYCLE' | 'DUPLICATE_HANDLER' | 'DUPLICATE_CONSUMER' | 'BUS_WITHOUT_REGISTER' | 'UNKNOWN_FAKE' | 'UNDECLARED_AUTHORIZATION' | 'AUTHORIZATION_NOT_ENFORCED' | 'UNDECLARED_CLASS' | 'DISCOVERY_FAILED' | 'NOTHING_DECLARED' | 'MISPLACED_DECLARATION' | 'DUPLICATE_JOB' | 'UNKNOWN_JOB' | 'INVALID_JOB_SETTINGS' | 'DUPLICATE_PROJECTION';
+/** A mistake in the composition root. Never a business failure, hence not a DomainError. */
+export declare class WiringError extends Error {
+    readonly code: WiringErrorCode;
+    constructor(code: WiringErrorCode, message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=wiring-error.d.ts.map

package/dist/errors/wiring-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiring-error.d.ts","sourceRoot":"","sources":["../../src/errors/wiring-error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,mBAAmB,GACnB,oBAAoB,GACpB,mBAAmB,GACnB,cAAc,GACd,oBAAoB,GACpB,eAAe,GACf,kBAAkB,GAClB,mBAAmB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,cAAc,GACd,0BAA0B,GAC1B,4BAA4B,GAC5B,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,uBAAuB,GACvB,eAAe,GACf,aAAa,GACb,sBAAsB,GACtB,sBAAsB,CAAC;AAE3B,4FAA4F;AAC5F,qBAAa,WAAY,SAAQ,KAAK;IAElC,QAAQ,CAAC,IAAI,EAAE,eAAe;IADhC,YACW,IAAI,EAAE,eAAe,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,EAIvB;CACF"}

package/dist/errors/wiring-error.js

@@ -0,0 +1,10 @@
+/** A mistake in the composition root. Never a business failure, hence not a DomainError. */
+export class WiringError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.code = code;
+        this.name = 'WiringError';
+    }
+}
+//# sourceMappingURL=wiring-error.js.map

package/dist/errors/wiring-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiring-error.js","sourceRoot":"","sources":["../../src/errors/wiring-error.ts"],"names":[],"mappings":"AAuBA,4FAA4F;AAC5F,MAAM,OAAO,WAAY,SAAQ,KAAK;IAEzB,IAAI;IADf,YACW,IAAqB,EAC9B,OAAe,EACf,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAJf,IAAI;QAKb,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+import 'reflect-metadata';
+export { describeToken, tokenIdentity, type Token } from '@ddd-ts-kit/kernel/declarations';
+export { WiringError, type WiringErrorCode } from './errors/wiring-error.js';
+export type { DependencyKind } from '@ddd-ts-kit/kernel';
+export type { BindingAspect, BindingAspectInfo, DependencyList, DependencyTokens, EventContract, IntegrationEventHandler, MessageHandler, PermissionRef, ResourcePointer, } from '@ddd-ts-kit/kernel/declarations';
+export type { BindingOptions } from './module/binding-options.js';
+export type { BindingTarget } from './module/binding-target.js';
+export type { ContextModule } from './module/context-module.js';
+export { defineContextModule } from './module/define-context-module.js';
+export type { HandlerTarget } from './module/handler-target.js';
+export type { ModuleBuilder } from './module/module-builder.js';
+export type { ModuleContext } from './module/module-context.js';
+export type { ProtectedUseCaseTarget } from './module/protected-use-case-target.js';
+export type { UseCaseTarget } from './module/use-case-target.js';
+export type { ValueBindingOptions } from './module/value-binding-options.js';
+export type { BindingSource } from './wiring/binding-source.js';
+export type { Declarer } from './wiring/declarer.js';
+export type { Lifetime } from './wiring/lifetime.js';
+export type { PolicyBinding } from './wiring/policy-binding.js';
+export type { Resolve } from './wiring/resolve.js';
+export { contextModule } from './declared/context-module.js';
+export type { DeclaredSource } from './declared/declared-source.js';
+export type { ConsumerOptions } from './consumer/consumer-options.js';
+export type { ConsumerRuntime } from './consumer/consumer-runtime.js';
+export { UnreadableEventError } from './consumer/unreadable-event-error.js';
+export type { JobsOptions } from './jobs/jobs-options.js';
+export type { ApplicationOptions } from './application/application-options.js';
+export type { Application } from './application/application.js';
+export type { BindingInfo } from './application/binding-info.js';
+export { createApplication } from './application/create-application.js';
+export type { Decorate } from './application/decorate.js';
+export { overrideForTests } from './application/override-for-tests.js';
+export { override, type Override } from './application/override.js';
+export type { AppliedEventDescription, BindingDescription, DomainEventHandlerDescription, HandlerDescription, IntegrationEventHandlerDescription, OriginDescription, PolicyDescription, ProjectionDescription, ScheduledJobDescription, WiringDescription, } from './description/wiring-description.js';
+export type { AuthorizationMode } from './authorization/authorization-mode.js';
+export { DeclaredPolicies } from './authorization/declared-policies.js';
+export type { RequirementOptions } from './authorization/requirement-options.js';
+export type { UseCaseAccess } from './authorization/use-case-access.js';
+export type { UseCaseDeclaration } from './authorization/use-case-declaration.js';
+export { UseCaseDeclarations } from './authorization/use-case-declarations.js';
+export { UseCaseGuard } from './authorization/use-case-guard.js';
+export { Instrumentation, type InstrumentedConsumer, type InstrumentedJob } from './kernel/instrumentation.js';
+export type { KernelModuleOptions } from './kernel/kernel-module-options.js';
+export { kernelModule } from './kernel/kernel-module.js';
+export type { Provided } from './kernel/provided.js';
+export { createTestApplication } from './testing/create-test-application.js';
+export { fake } from './testing/fake.js';
+export type { TestApplicationOptions } from './testing/test-application-options.js';
+export type { TestApplication } from './testing/test-application.js';
+export type { TestJobs } from './testing/test-jobs.js';
+export type { TestKernel } from './testing/test-kernel.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":"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"}

package/dist/index.js

@@ -0,0 +1,20 @@
+// tsyringe 4.10 throws while loading when the Reflect metadata polyfill is absent, even
+// though this package never uses decorators. Importing it here, before tsyringe, spares
+// consumers a line they would otherwise have to remember in every entry point and test.
+import 'reflect-metadata';
+export { describeToken, tokenIdentity } from '@ddd-ts-kit/kernel/declarations';
+export { WiringError } from './errors/wiring-error.js';
+export { defineContextModule } from './module/define-context-module.js';
+export { contextModule } from './declared/context-module.js';
+export { UnreadableEventError } from './consumer/unreadable-event-error.js';
+export { createApplication } from './application/create-application.js';
+export { overrideForTests } from './application/override-for-tests.js';
+export { override } from './application/override.js';
+export { DeclaredPolicies } from './authorization/declared-policies.js';
+export { UseCaseDeclarations } from './authorization/use-case-declarations.js';
+export { UseCaseGuard } from './authorization/use-case-guard.js';
+export { Instrumentation } from './kernel/instrumentation.js';
+export { kernelModule } from './kernel/kernel-module.js';
+export { createTestApplication } from './testing/create-test-application.js';
+export { fake } from './testing/fake.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,wFAAwF;AACxF,wFAAwF;AACxF,wFAAwF;AACxF,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAc,MAAM,iCAAiC,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAwB,MAAM,0BAA0B,CAAC;AAgB7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAYxE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAI7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAK5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAiB,MAAM,2BAA2B,CAAC;AAcpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAIxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAmD,MAAM,6BAA6B,CAAC;AAE/G,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/jobs/definition-of.d.ts

@@ -0,0 +1,7 @@
+import type { JobDefinition } from '@ddd-ts-kit/kernel';
+import type { Instrumentation } from '../kernel/instrumentation.js';
+import type { Resolve } from '../wiring/resolve.js';
+import type { EffectiveJob } from './effective-job.js';
+/** What a scheduler is given: the job is built on its first run, so a job that cannot be built fails that run. */
+export declare function definitionOf(job: EffectiveJob, resolve: Resolve, instrument?: Instrumentation['job']): JobDefinition;
+//# sourceMappingURL=definition-of.d.ts.map

package/dist/jobs/definition-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-of.d.ts","sourceRoot":"","sources":["../../src/jobs/definition-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,kHAAkH;AAClH,wBAAgB,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,GAAG,aAAa,CASpH"}

package/dist/jobs/definition-of.js

@@ -0,0 +1,11 @@
+/** What a scheduler is given: the job is built on its first run, so a job that cannot be built fails that run. */
+export function definitionOf(job, resolve, instrument) {
+    const run = async (execution) => resolve(job.job).run(execution);
+    return {
+        name: job.name,
+        schedule: job.schedule,
+        ...job.policy,
+        run: instrument === undefined ? run : instrument(run, { name: job.name, context: job.module }),
+    };
+}
+//# sourceMappingURL=definition-of.js.map

package/dist/jobs/definition-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-of.js","sourceRoot":"","sources":["../../src/jobs/definition-of.ts"],"names":[],"mappings":"AAKA,kHAAkH;AAClH,MAAM,UAAU,YAAY,CAAC,GAAiB,EAAE,OAAgB,EAAE,UAAmC;IACnG,MAAM,GAAG,GAAyB,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAEvF,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,GAAG,GAAG,CAAC,MAAM;QACb,GAAG,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;KAC/F,CAAC;AACJ,CAAC"}

package/dist/jobs/effective-job.d.ts

@@ -0,0 +1,7 @@
+import type { JobPolicy } from '@ddd-ts-kit/kernel';
+import type { JobRegistration } from '../wiring/job-registration.js';
+/** A declared job with the settings of the application applied and the defaults filled in. */
+export interface EffectiveJob extends JobRegistration {
+    readonly policy: JobPolicy;
+}
+//# sourceMappingURL=effective-job.d.ts.map

package/dist/jobs/effective-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-job.d.ts","sourceRoot":"","sources":["../../src/jobs/effective-job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,8FAA8F;AAC9F,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC5B"}

package/dist/jobs/effective-job.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=effective-job.js.map

package/dist/jobs/effective-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-job.js","sourceRoot":"","sources":["../../src/jobs/effective-job.ts"],"names":[],"mappings":""}

package/dist/jobs/effective-jobs.d.ts

@@ -0,0 +1,6 @@
+import type { Wiring } from '../wiring/wiring.js';
+import type { EffectiveJob } from './effective-job.js';
+import type { JobsOptions } from './jobs-options.js';
+/** Every declared job as it will run. Throws before anything is instantiated. */
+export declare function effectiveJobs(wiring: Wiring, options?: JobsOptions): EffectiveJob[];
+//# sourceMappingURL=effective-jobs.d.ts.map

package/dist/jobs/effective-jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-jobs.d.ts","sourceRoot":"","sources":["../../src/jobs/effective-jobs.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,YAAY,EAAE,CAMvF"}

package/dist/jobs/effective-jobs.js

@@ -0,0 +1,33 @@
+import { isJobName, jobPolicy, jobScheduleOf, } from '@ddd-ts-kit/kernel';
+import { WiringError } from '../errors/wiring-error.js';
+import { whereOf } from '../wiring/where-of.js';
+import { readable } from './readable.js';
+/** Every declared job as it will run. Throws before anything is instantiated. */
+export function effectiveJobs(wiring, options = {}) {
+    const settings = options.settings ?? {};
+    assertSettingsNameJobs(wiring, Object.keys(settings));
+    return wiring.jobs.map((registration) => applied(registration, settings[registration.name] ?? {}));
+}
+function assertSettingsNameJobs({ jobs }, configured) {
+    const unknown = configured.find((name) => jobs.every((job) => job.name !== name));
+    if (unknown === undefined) {
+        return;
+    }
+    const declared = jobs.length === 0 ? 'none' : jobs.map((job) => `"${job.name}"`).join(', ');
+    throw new WiringError('UNKNOWN_JOB', `Settings are given for the job "${unknown}", which no module declares. Declared jobs: ${declared}.`);
+}
+function applied(registration, settings) {
+    const { name } = registration;
+    if (!isJobName(name)) {
+        throw new WiringError('INVALID_JOB_SETTINGS', `"${name}", declared in ${whereOf(registration)}, is not a job name: write <context>.<job-name> in lower case, words separated by dashes.`);
+    }
+    const { schedule: configured, ...overrides } = settings;
+    const options = { ...registration.options, ...written(overrides) };
+    const schedule = configured === undefined ? registration.schedule : readable(name, () => jobScheduleOf(configured));
+    return { ...registration, schedule, options, policy: readable(name, () => jobPolicy(options)) };
+}
+/** A key a configuration left undefined does not erase what the job declared. */
+function written(overrides) {
+    return Object.fromEntries(Object.entries(overrides).filter(([, value]) => value !== undefined));
+}
+//# sourceMappingURL=effective-jobs.js.map

package/dist/jobs/effective-jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-jobs.js","sourceRoot":"","sources":["../../src/jobs/effective-jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,SAAS,EACT,aAAa,GAId,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAIhD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,OAAO,GAAgB,EAAE;IACrE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;IAExC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEtD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACrG,CAAC;AAED,SAAS,sBAAsB,CAAC,EAAE,IAAI,EAAU,EAAE,UAA6B;IAC7E,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC;IAElF,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5F,MAAM,IAAI,WAAW,CACnB,aAAa,EACb,mCAAmC,OAAO,+CAA+C,QAAQ,GAAG,CACrG,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,YAA6B,EAAE,QAAqB;IACnE,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,CAAC;IAE9B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,WAAW,CACnB,sBAAsB,EACtB,IAAI,IAAI,kBAAkB,OAAO,CAAC,YAAY,CAAC,2FAA2F,CAC3I,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,SAAS,EAAE,GAAG,QAAQ,CAAC;IACxD,MAAM,OAAO,GAAe,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;IAE/E,MAAM,QAAQ,GACZ,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IAErG,OAAO,EAAE,GAAG,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;AAClG,CAAC;AAED,iFAAiF;AACjF,SAAS,OAAO,CAAC,SAAqB;IACpC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC;AAClG,CAAC"}

package/dist/jobs/jobs-options.d.ts

@@ -0,0 +1,16 @@
+import type { JobSettings } from '@ddd-ts-kit/kernel';
+export interface JobsOptions {
+    /**
+     * `false`: the jobs are registered, described and run on demand with `runNow`, and
+     * `start()` never starts the scheduler. For the process that serves requests next to a worker
+     * that runs the jobs. Default `true`.
+     */
+    readonly start?: boolean;
+    /**
+     * What configuration changes of a declared job, by job name: `enabled`, the schedule, any
+     * option. A name no module declares is refused, so a renamed job cannot stay switched on by a
+     * stale key.
+     */
+    readonly settings?: Readonly<Record<string, JobSettings>>;
+}
+//# sourceMappingURL=jobs-options.d.ts.map

package/dist/jobs/jobs-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs-options.d.ts","sourceRoot":"","sources":["../../src/jobs/jobs-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;CAC3D"}

package/dist/jobs/jobs-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=jobs-options.js.map

package/dist/jobs/jobs-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs-options.js","sourceRoot":"","sources":["../../src/jobs/jobs-options.ts"],"names":[],"mappings":""}

package/dist/jobs/readable.d.ts

@@ -0,0 +1,3 @@
+/** Reads a schedule or a policy of the job, and says which job when it cannot be read. */
+export declare function readable<T>(job: string, read: () => T): T;
+//# sourceMappingURL=readable.d.ts.map

package/dist/jobs/readable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readable.d.ts","sourceRoot":"","sources":["../../src/jobs/readable.ts"],"names":[],"mappings":"AAGA,0FAA0F;AAC1F,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAUzD"}

package/dist/jobs/readable.js

@@ -0,0 +1,15 @@
+import { InvalidJobScheduleError } from '@ddd-ts-kit/kernel';
+import { WiringError } from '../errors/wiring-error.js';
+/** Reads a schedule or a policy of the job, and says which job when it cannot be read. */
+export function readable(job, read) {
+    try {
+        return read();
+    }
+    catch (error) {
+        if (!(error instanceof InvalidJobScheduleError)) {
+            throw error;
+        }
+        throw new WiringError('INVALID_JOB_SETTINGS', `Job "${job}": ${error.message}`, { cause: error });
+    }
+}
+//# sourceMappingURL=readable.js.map

package/dist/jobs/readable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readable.js","sourceRoot":"","sources":["../../src/jobs/readable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,0FAA0F;AAC1F,MAAM,UAAU,QAAQ,CAAI,GAAW,EAAE,IAAa;IACpD,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,uBAAuB,CAAC,EAAE,CAAC;YAChD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,IAAI,WAAW,CAAC,sBAAsB,EAAE,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACpG,CAAC;AACH,CAAC"}

package/dist/jobs/written-job.d.ts

@@ -0,0 +1,11 @@
+import { type ScheduledJob } from '@ddd-ts-kit/kernel';
+import type { ScheduledOptions, Token } from '@ddd-ts-kit/kernel/declarations';
+import type { JobRegistration } from '../wiring/job-registration.js';
+interface Located {
+    readonly module: string;
+    readonly job: Token<ScheduledJob>;
+}
+/** The job of an explicit module: `builder.job('billing.send-reminders', { every: '15m' })`. */
+export declare function writtenJob(name: string, settings: ScheduledOptions, located: Located): JobRegistration;
+export {};
+//# sourceMappingURL=written-job.d.ts.map

package/dist/jobs/written-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"written-job.d.ts","sourceRoot":"","sources":["../../src/jobs/written-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGrE,UAAU,OAAO;IACf,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;CACnC;AAED,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,GAAG,eAAe,CAItG"}

package/dist/jobs/written-job.js

@@ -0,0 +1,8 @@
+import { jobScheduleOf } from '@ddd-ts-kit/kernel';
+import { readable } from './readable.js';
+/** The job of an explicit module: `builder.job('billing.send-reminders', { every: '15m' })`. */
+export function writtenJob(name, settings, located) {
+    const { every: _every, cron: _cron, timeZone: _timeZone, ...options } = settings;
+    return { name, schedule: readable(name, () => jobScheduleOf(settings)), options, ...located };
+}
+//# sourceMappingURL=written-job.js.map

package/dist/jobs/written-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"written-job.js","sourceRoot":"","sources":["../../src/jobs/written-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAqB,MAAM,oBAAoB,CAAC;AAGtE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAOzC,gGAAgG;AAChG,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,QAA0B,EAAE,OAAgB;IACnF,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,GAAG,QAAQ,CAAC;IAEjF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;AAChG,CAAC"}

package/dist/kernel/guarded-query-bus.d.ts

@@ -0,0 +1,5 @@
+import { InMemoryQueryBus, type BusMiddleware } from '@ddd-ts-kit/kernel';
+import type { Resolve } from '../wiring/resolve.js';
+/** What observes the use cases comes after the guard: a refused query never started. */
+export declare function guardedQueryBus(resolve: Resolve, observed?: BusMiddleware): InMemoryQueryBus;
+//# sourceMappingURL=guarded-query-bus.d.ts.map

package/dist/kernel/guarded-query-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guarded-query-bus.d.ts","sourceRoot":"","sources":["../../src/kernel/guarded-query-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGpD,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,gBAAgB,CAI5F"}

package/dist/kernel/guarded-query-bus.js

@@ -0,0 +1,9 @@
+import { InMemoryQueryBus } from '@ddd-ts-kit/kernel';
+import { useCaseGuardMiddleware } from '../authorization/use-case-guard-middleware.js';
+import { reportedFailures } from './reported-failures.js';
+/** What observes the use cases comes after the guard: a refused query never started. */
+export function guardedQueryBus(resolve, observed) {
+    const bus = new InMemoryQueryBus().use(reportedFailures(resolve)).use(useCaseGuardMiddleware(resolve));
+    return observed === undefined ? bus : bus.use(observed);
+}
+//# sourceMappingURL=guarded-query-bus.js.map

package/dist/kernel/guarded-query-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guarded-query-bus.js","sourceRoot":"","sources":["../../src/kernel/guarded-query-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAsB,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AAEvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,wFAAwF;AACxF,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,QAAwB;IACxE,MAAM,GAAG,GAAG,IAAI,gBAAgB,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;IAEvG,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC1D,CAAC"}

package/dist/kernel/instrumentation.d.ts

@@ -0,0 +1,37 @@
+import type { BusMiddleware, DomainEventDispatcher, ErrorReporter, ExecutionScope, IntegrationEventCallback, IntegrationEventPublisher, JobExecution } from '@ddd-ts-kit/kernel';
+import type { BindingAspect } from '@ddd-ts-kit/kernel/declarations';
+/** The consumer a handler of integration events is subscribed as. */
+export interface InstrumentedConsumer {
+    readonly consumer: string;
+    /** Name of the module that declared it. */
+    readonly context: string;
+    readonly type: string;
+}
+/** The job a run belongs to. */
+export interface InstrumentedJob {
+    readonly name: string;
+    /** Name of the module that declared it. */
+    readonly context: string;
+}
+/**
+ * What an observability adapter puts around the application, from outside: every member is a
+ * wrapper the kernel module applies where the thing is built, and none is required. An object
+ * of `@ddd-ts-kit/tracing` (`traceApplication()`) fits as it is; this package knows no tracer.
+ */
+export declare abstract class Instrumentation {
+    static readonly tokenKey = "di.Instrumentation";
+    /** Around every instance of a binding declared with a kind, outside the dispatch of domain events and the aspects of the binding. */
+    abstract readonly binding?: BindingAspect;
+    /** On both buses, after the use case guard and outside the unit of work. */
+    abstract readonly useCase?: BusMiddleware;
+    abstract readonly publisher?: (publisher: IntegrationEventPublisher) => IntegrationEventPublisher;
+    /** Around what each consumer is subscribed with: the function the provider calls at each delivery. */
+    abstract readonly consumer?: (handler: IntegrationEventCallback, consumer: InstrumentedConsumer) => IntegrationEventCallback;
+    abstract readonly domainEvents?: (dispatcher: DomainEventDispatcher) => DomainEventDispatcher;
+    /** Around each run of a declared job, inside its execution scope. */
+    abstract readonly job?: (run: (execution: JobExecution) => Promise<void>, job: InstrumentedJob) => (execution: JobExecution) => Promise<void>;
+    abstract readonly errorReporter?: (reporter: ErrorReporter) => ErrorReporter;
+    /** Told the execution scope of the application once it is built. */
+    abstract readonly executionScope?: (scope: ExecutionScope) => void;
+}
+//# sourceMappingURL=instrumentation.d.ts.map

package/dist/kernel/instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/kernel/instrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,8BAAsB,eAAe;IACnC,MAAM,CAAC,QAAQ,CAAC,QAAQ,wBAAwB;IAEhD,qIAAqI;IACrI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IAE1C,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IAE1C,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,yBAAyB,KAAK,yBAAyB,CAAC;IAElG,sGAAsG;IACtG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAC3B,OAAO,EAAE,wBAAwB,EACjC,QAAQ,EAAE,oBAAoB,KAC3B,wBAAwB,CAAC;IAE9B,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,qBAAqB,KAAK,qBAAqB,CAAC;IAE9F,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CACtB,GAAG,EAAE,CAAC,SAAS,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,EAC/C,GAAG,EAAE,eAAe,KACjB,CAAC,SAAS,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,aAAa,CAAC;IAE7E,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CACpE"}

package/dist/kernel/instrumentation.js

@@ -0,0 +1,9 @@
+/**
+ * What an observability adapter puts around the application, from outside: every member is a
+ * wrapper the kernel module applies where the thing is built, and none is required. An object
+ * of `@ddd-ts-kit/tracing` (`traceApplication()`) fits as it is; this package knows no tracer.
+ */
+export class Instrumentation {
+    static tokenKey = 'di.Instrumentation';
+}
+//# sourceMappingURL=instrumentation.js.map

package/dist/kernel/instrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../../src/kernel/instrumentation.ts"],"names":[],"mappings":"AA0BA;;;;GAIG;AACH,MAAM,OAAgB,eAAe;IACnC,MAAM,CAAU,QAAQ,GAAG,oBAAoB,CAAC;CA4BjD"}

package/dist/kernel/kernel-module-options.d.ts

@@ -0,0 +1,57 @@
+import type { ActorContext, Cache, Clock, CommandBus, DomainEventDispatcher, ErrorReporter, EventBus, EventSubscribers, ExecutionScope, IdGenerator, IntegrationEventPublisher, IntegrationEventSubscriber, JobScheduler, Lock, Logger, Metrics, ProcessedEventStore, QueryBus, RateLimiter, UnitOfWork } from '@ddd-ts-kit/kernel';
+import type { Instrumentation } from './instrumentation.js';
+import type { Provided } from './provided.js';
+export interface KernelModuleOptions {
+    readonly clock?: Provided<Clock>;
+    readonly ids?: Provided<IdGenerator>;
+    readonly unitOfWork?: Provided<UnitOfWork>;
+    /** Handlers declared with `builder.command(...)` need a bus with `register`, such as the default. */
+    readonly commandBus?: Provided<CommandBus>;
+    readonly queryBus?: Provided<QueryBus>;
+    readonly eventBus?: Provided<EventBus>;
+    /** Defaults to the event bus. An outbox goes here. */
+    readonly eventPublisher?: Provided<IntegrationEventPublisher>;
+    /** Defaults to the event bus. A broker adapter goes here. */
+    readonly eventSubscriber?: Provided<IntegrationEventSubscriber>;
+    /**
+     * Defaults to `eventSubscriber` for every context. A broker that gives each consuming context
+     * its own subscriber goes here: `{ forContext: (name) => bus.forConsumer(name) }`.
+     */
+    readonly eventSubscribers?: Provided<EventSubscribers>;
+    readonly processedEvents?: Provided<ProcessedEventStore>;
+    /** Defaults to a dispatcher inside this process, which the declared domain event handlers are attached to. */
+    readonly domainEvents?: Provided<DomainEventDispatcher>;
+    /** Defaults to the actor of the execution scope, so the two cannot disagree. */
+    readonly actorContext?: Provided<ActorContext>;
+    /** Defaults to one following the asynchronous call chain of each unit of work. */
+    readonly executionScope?: Provided<ExecutionScope>;
+    /** Defaults to a logger that writes nothing. The application flushes it when it stops, after the error reporter. */
+    readonly logger?: Provided<Logger>;
+    /** Defaults to metrics that measure nothing. */
+    readonly metrics?: Provided<Metrics>;
+    /**
+     * Defaults to a reporter that reports nothing. The default buses and the default job scheduler
+     * hand it their unexpected failures, and the application flushes it when it stops.
+     */
+    readonly errorReporter?: Provided<ErrorReporter>;
+    /** Defaults to a bounded cache in the memory of the process, expiring by `Clock`. */
+    readonly cache?: Provided<Cache>;
+    /** Defaults to a lock inside this process, expiring by `Clock`: several instances exclude nothing between them. */
+    readonly lock?: Provided<Lock>;
+    /** Defaults to a limiter inside this process, counting by `Clock`: several instances each allow the limit. */
+    readonly rateLimiter?: Provided<RateLimiter>;
+    /**
+     * Defaults to a scheduler inside this process, on `Clock`, `Lock`, `ExecutionScope`,
+     * `IdGenerator`, `Logger`, `Metrics` and `ErrorReporter`: with the default lock, several instances
+     * each run every job.
+     */
+    readonly jobScheduler?: Provided<JobScheduler>;
+    /**
+     * What observes the application from outside, typically `traceApplication()` of
+     * `@ddd-ts-kit/tracing`: the default buses, the event publisher, the consumers, the domain event
+     * dispatcher, the jobs, the error reporter and every binding declared with a kind are wrapped
+     * by it. A port given through an option above is wrapped too; one rebound by a later module is not.
+     */
+    readonly instrumentation?: Instrumentation;
+}
+//# sourceMappingURL=kernel-module-options.d.ts.map

package/dist/kernel/kernel-module-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-module-options.d.ts","sourceRoot":"","sources":["../../src/kernel/kernel-module-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,KAAK,EACL,KAAK,EACL,UAAU,EACV,qBAAqB,EACrB,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,yBAAyB,EACzB,0BAA0B,EAC1B,YAAY,EACZ,IAAI,EACJ,MAAM,EACN,OAAO,EACP,mBAAmB,EACnB,QAAQ,EACR,WAAW,EACX,UAAU,EACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC3C,qGAAqG;IACrG,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACvC,sDAAsD;IACtD,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,yBAAyB,CAAC,CAAC;IAC9D,6DAA6D;IAC7D,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,0BAA0B,CAAC,CAAC;IAChE;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IACvD,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IACzD,8GAA8G;IAC9G,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IACxD,gFAAgF;IAChF,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC/C,kFAAkF;IAClF,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACnD,oHAAoH;IACpH,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnC,gDAAgD;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IACjD,qFAAqF;IACrF,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,mHAAmH;IACnH,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/B,8GAA8G;IAC9G,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC/C;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;CAC5C"}

package/dist/kernel/kernel-module-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=kernel-module-options.js.map