@depup/angular-devkit__architect 0.2102.2-depup.0

package/src/jobs/api.d.ts

@@ -0,0 +1,332 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { JsonObject, JsonValue, schema } from '@angular-devkit/core';
+import { Observable, Observer } from 'rxjs';
+import { DeepReadonly } from './types';
+/**
+ * A job name is just a string (needs to be serializable).
+ */
+export type JobName = string;
+/**
+ * The job handler function, which is a method that's executed for the job.
+ */
+export interface JobHandler<ArgT extends JsonValue, InputT extends JsonValue, OutputT extends JsonValue> {
+    (argument: ArgT, context: JobHandlerContext<ArgT, InputT, OutputT>): Observable<JobOutboundMessage<OutputT>>;
+    jobDescription: Partial<JobDescription>;
+}
+/**
+ * The context in which the job is run.
+ */
+export interface JobHandlerContext<MinimumArgumentValueT extends JsonValue = JsonValue, MinimumInputValueT extends JsonValue = JsonValue, MinimumOutputValueT extends JsonValue = JsonValue> {
+    readonly description: JobDescription;
+    readonly scheduler: Scheduler<JsonValue, JsonValue, JsonValue>;
+    readonly dependencies: Job<JsonValue, JsonValue, JsonValue>[];
+    readonly inboundBus: Observable<JobInboundMessage<MinimumInputValueT>>;
+}
+/**
+ * Metadata associated with a job.
+ */
+export interface JobDescription extends JsonObject {
+    readonly name: JobName;
+    readonly argument: DeepReadonly<schema.JsonSchema>;
+    readonly input: DeepReadonly<schema.JsonSchema>;
+    readonly output: DeepReadonly<schema.JsonSchema>;
+}
+/**
+ * Messages that can be sent TO a job. The job needs to listen to those.
+ */
+export declare enum JobInboundMessageKind {
+    Ping = "ip",
+    Stop = "is",
+    Input = "in"
+}
+/** Base interface for the all job inbound messages. */
+export interface JobInboundMessageBase extends JsonObject {
+    /**
+     * The kind of message this is.
+     */
+    readonly kind: JobInboundMessageKind;
+}
+/**
+ * A ping to the job. The job should reply with a pong as soon as possible.
+ */
+export interface JobInboundMessagePing extends JobInboundMessageBase {
+    readonly kind: JobInboundMessageKind.Ping;
+    /**
+     * An ID that should be returned in the corresponding Pong.
+     */
+    readonly id: number;
+}
+/**
+ * Stop the job. This is handled by the job itself and jobs might not handle it. It will also
+ * unsubscribe from the Observable<>.
+ * This is equivalent to SIGTERM.
+ */
+export interface JobInboundMessageStop extends JobInboundMessageBase {
+    readonly kind: JobInboundMessageKind.Stop;
+}
+/**
+ * A Job wants to send a message to a channel. This can be marshaled, and the Job object
+ * has helpers to transform this into an observable. The context also can create RxJS subjects that
+ * marshall messages through a channel.
+ */
+export interface JobInboundMessageInput<InputT extends JsonValue> extends JobInboundMessageBase {
+    readonly kind: JobInboundMessageKind.Input;
+    /**
+     * The input being sent to the job.
+     */
+    readonly value: InputT;
+}
+export type JobInboundMessage<InputT extends JsonValue> = JobInboundMessagePing | JobInboundMessageStop | JobInboundMessageInput<InputT>;
+/**
+ * Kind of messages that can be outputted from a job.
+ */
+export declare enum JobOutboundMessageKind {
+    OnReady = "c",
+    Start = "s",
+    End = "e",
+    Pong = "p",
+    Output = "o",
+    ChannelCreate = "cn",
+    ChannelMessage = "cm",
+    ChannelError = "ce",
+    ChannelComplete = "cc"
+}
+/** Base interface for the all job messages. */
+export interface JobOutboundMessageBase {
+    /**
+     * The job description.
+     */
+    readonly description: JobDescription;
+    /**
+     * The kind of message this is.
+     */
+    readonly kind: JobOutboundMessageKind;
+}
+/**
+ * The job has been created and will validate its input.
+ */
+export interface JobOutboundMessageOnReady extends JobOutboundMessageBase {
+    readonly kind: JobOutboundMessageKind.OnReady;
+}
+/**
+ * The job started. This is done by the job itself.
+ */
+export interface JobOutboundMessageStart extends JobOutboundMessageBase {
+    readonly kind: JobOutboundMessageKind.Start;
+}
+/**
+ * An output value is available.
+ */
+export interface JobOutboundMessageOutput<OutputT extends JsonValue> extends JobOutboundMessageBase {
+    readonly kind: JobOutboundMessageKind.Output;
+    /**
+     * The message being outputted from the job.
+     */
+    readonly value: OutputT;
+}
+/**
+ * Base interface for all job message related to channels.
+ */
+export interface JobOutboundMessageChannelBase extends JobOutboundMessageBase {
+    /**
+     * The name of the channel.
+     */
+    readonly name: string;
+}
+/**
+ * A job wants to send a message to a channel. This can be marshaled, and the Job object
+ * has helpers to transform this into an observable. The context also can create RxJS subjects that
+ * marshall messages through a channel.
+ */
+export interface JobOutboundMessageChannelMessage extends JobOutboundMessageChannelBase {
+    readonly kind: JobOutboundMessageKind.ChannelMessage;
+    /**
+     * The message being sent to the channel.
+     */
+    readonly message: JsonValue;
+}
+/**
+ * A job wants to send an error to one of its channel. This is the equivalent of throwing through
+ * an Observable. The side channel will not receive any more messages after this, and will not
+ * complete.
+ */
+export interface JobOutboundMessageChannelError extends JobOutboundMessageChannelBase {
+    readonly kind: JobOutboundMessageKind.ChannelError;
+    /**
+     * The error message being sent to the channel.
+     */
+    readonly error: JsonValue;
+}
+/**
+ * A job wants to create a new channel.
+ */
+export interface JobOutboundMessageChannelCreate extends JobOutboundMessageChannelBase {
+    readonly kind: JobOutboundMessageKind.ChannelCreate;
+}
+/**
+ * A job wants to close the channel, as completed. This is done automatically when the job ends,
+ * or can be done from the job to close it. A closed channel might be reopened, but the user
+ * need to recall getChannel().
+ */
+export interface JobOutboundMessageChannelComplete extends JobOutboundMessageChannelBase {
+    readonly kind: JobOutboundMessageKind.ChannelComplete;
+}
+/**
+ * OnEnd of the job run.
+ */
+export interface JobOutboundMessageEnd extends JobOutboundMessageBase {
+    readonly kind: JobOutboundMessageKind.End;
+}
+/**
+ * A pong response from a ping input. The id is the same as the one passed in.
+ */
+export interface JobOutboundMessagePong extends JobOutboundMessageBase {
+    readonly kind: JobOutboundMessageKind.Pong;
+    /**
+     * The ID that was passed in the `Ping` messages.
+     */
+    readonly id: number;
+}
+/**
+ * Generic message type.
+ */
+export type JobOutboundMessage<OutputT extends JsonValue> = JobOutboundMessageOnReady | JobOutboundMessageStart | JobOutboundMessageOutput<OutputT> | JobOutboundMessageChannelCreate | JobOutboundMessageChannelMessage | JobOutboundMessageChannelError | JobOutboundMessageChannelComplete | JobOutboundMessageEnd | JobOutboundMessagePong;
+/**
+ * The state of a job. These are changed as the job reports a new state through its messages.
+ */
+export declare enum JobState {
+    /**
+     * The job was queued and is waiting to start.
+     */
+    Queued = "queued",
+    /**
+     * The job description was found, its dependencies (see "Synchronizing and Dependencies")
+     * are done running, and the job's argument is validated and the job's code will be executed.
+     */
+    Ready = "ready",
+    /**
+     * The job has been started. The job implementation is expected to send this as soon as its
+     * work is starting.
+     */
+    Started = "started",
+    /**
+     * The job has ended and is done running.
+     */
+    Ended = "ended",
+    /**
+     * An error occured and the job stopped because of internal state.
+     */
+    Errored = "errored"
+}
+/**
+ * A Job instance, returned from scheduling a job. A Job instance is _not_ serializable.
+ */
+export interface Job<ArgumentT extends JsonValue = JsonValue, InputT extends JsonValue = JsonValue, OutputT extends JsonValue = JsonValue> {
+    /**
+     * Description of the job. Resolving the job's description can be done asynchronously, so this
+     * is an observable that will resolve when it's ready.
+     */
+    readonly description: Observable<JobDescription>;
+    /**
+     * Argument sent when scheduling the job. This is a copy of the argument.
+     */
+    readonly argument: ArgumentT;
+    /**
+     * The input to the job. This goes through the input channel as messages.
+     */
+    readonly input: Observer<InputT>;
+    /**
+     * Outputs of this job.
+     */
+    readonly output: Observable<OutputT>;
+    /**
+     * The current state of the job.
+     */
+    readonly state: JobState;
+    /**
+     * Get a channel that validates against the schema. Messages will be filtered by the schema.
+     * @param name The name of the channel.
+     * @param schema A schema to use to validate messages.
+     */
+    getChannel<T extends JsonValue>(name: string, schema?: schema.JsonSchema): Observable<T>;
+    /**
+     * Pings the job and wait for the resulting Pong before completing.
+     */
+    ping(): Observable<never>;
+    /**
+     * Stops the job from running. This is different than unsubscribing from the output as in it
+     * sends the JobInboundMessageKind.Stop raw input to the job.
+     */
+    stop(): void;
+    /**
+     * The JobInboundMessage messages TO the job.
+     */
+    readonly inboundBus: Observer<JobInboundMessage<InputT>>;
+    /**
+     * The JobOutboundMessage FROM the job.
+     */
+    readonly outboundBus: Observable<JobOutboundMessage<OutputT>>;
+}
+/**
+ * Options for scheduling jobs.
+ */
+export interface ScheduleJobOptions {
+    /**
+     * Jobs that need to finish before scheduling this job. These dependencies will be passed
+     * to the job itself in its context.
+     */
+    dependencies?: Job | Job[];
+}
+export interface Registry<MinimumArgumentValueT extends JsonValue = JsonValue, MinimumInputValueT extends JsonValue = JsonValue, MinimumOutputValueT extends JsonValue = JsonValue> {
+    /**
+     * Get a job handler.
+     * @param name The name of the job to get a handler from.
+     */
+    get<A extends MinimumArgumentValueT, I extends MinimumInputValueT, O extends MinimumOutputValueT>(name: JobName): Observable<JobHandler<A, I, O> | null>;
+}
+/**
+ * An interface that can schedule jobs.
+ */
+export interface Scheduler<MinimumArgumentValueT extends JsonValue = JsonValue, MinimumInputValueT extends JsonValue = JsonValue, MinimumOutputValueT extends JsonValue = JsonValue> {
+    /**
+     * Get a job description for a named job.
+     *
+     * @param name The name of the job.
+     * @returns A description, or null if no description is available for this job.
+     */
+    getDescription(name: JobName): Observable<JobDescription | null>;
+    /**
+     * Returns true if the job name has been registered.
+     * @param name The name of the job.
+     * @returns True if the job exists, false otherwise.
+     */
+    has(name: JobName): Observable<boolean>;
+    /**
+     * Pause the scheduler, temporary queueing _new_ jobs. Returns a resume function that should be
+     * used to resume execution. If multiple `pause()` were called, all their resume functions must
+     * be called before the Scheduler actually starts new jobs. Additional calls to the same resume
+     * function will have no effect.
+     *
+     * Jobs already running are NOT paused. This is pausing the scheduler only.
+     *
+     * @returns A function that can be run to resume the scheduler. If multiple `pause()` calls
+     *          were made, all their return function must be called (in any order) before the
+     *          scheduler can resume.
+     */
+    pause(): () => void;
+    /**
+     * Schedule a job to be run, using its name.
+     * @param name The name of job to be run.
+     * @param argument The argument to send to the job when starting it.
+     * @param options Scheduling options.
+     * @returns The job being run.
+     */
+    schedule<A extends MinimumArgumentValueT, I extends MinimumInputValueT, O extends MinimumOutputValueT>(name: JobName, argument: A, options?: ScheduleJobOptions): Job<A, I, O>;
+}
+export declare function isJobHandler<A extends JsonValue, I extends JsonValue, O extends JsonValue>(value: unknown): value is JobHandler<A, I, O>;

package/src/jobs/api.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobState = exports.JobOutboundMessageKind = exports.JobInboundMessageKind = void 0;
+exports.isJobHandler = isJobHandler;
+/**
+ * Messages that can be sent TO a job. The job needs to listen to those.
+ */
+var JobInboundMessageKind;
+(function (JobInboundMessageKind) {
+    JobInboundMessageKind["Ping"] = "ip";
+    JobInboundMessageKind["Stop"] = "is";
+    // Channel specific messages.
+    JobInboundMessageKind["Input"] = "in";
+    // Input channel does not allow completion / error. Erroring this will just close the Subject
+    // but not notify the job.
+})(JobInboundMessageKind || (exports.JobInboundMessageKind = JobInboundMessageKind = {}));
+/**
+ * Kind of messages that can be outputted from a job.
+ */
+var JobOutboundMessageKind;
+(function (JobOutboundMessageKind) {
+    // Lifecycle specific messages.
+    JobOutboundMessageKind["OnReady"] = "c";
+    JobOutboundMessageKind["Start"] = "s";
+    JobOutboundMessageKind["End"] = "e";
+    JobOutboundMessageKind["Pong"] = "p";
+    // Feedback messages.
+    JobOutboundMessageKind["Output"] = "o";
+    // Channel specific messages.
+    JobOutboundMessageKind["ChannelCreate"] = "cn";
+    JobOutboundMessageKind["ChannelMessage"] = "cm";
+    JobOutboundMessageKind["ChannelError"] = "ce";
+    JobOutboundMessageKind["ChannelComplete"] = "cc";
+})(JobOutboundMessageKind || (exports.JobOutboundMessageKind = JobOutboundMessageKind = {}));
+/**
+ * The state of a job. These are changed as the job reports a new state through its messages.
+ */
+var JobState;
+(function (JobState) {
+    /**
+     * The job was queued and is waiting to start.
+     */
+    JobState["Queued"] = "queued";
+    /**
+     * The job description was found, its dependencies (see "Synchronizing and Dependencies")
+     * are done running, and the job's argument is validated and the job's code will be executed.
+     */
+    JobState["Ready"] = "ready";
+    /**
+     * The job has been started. The job implementation is expected to send this as soon as its
+     * work is starting.
+     */
+    JobState["Started"] = "started";
+    /**
+     * The job has ended and is done running.
+     */
+    JobState["Ended"] = "ended";
+    /**
+     * An error occured and the job stopped because of internal state.
+     */
+    JobState["Errored"] = "errored";
+})(JobState || (exports.JobState = JobState = {}));
+function isJobHandler(value) {
+    const job = value;
+    return (typeof job == 'function' && typeof job.jobDescription == 'object' && job.jobDescription !== null);
+}
+//# sourceMappingURL=api.js.map

package/src/jobs/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["api.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAsbH,oCAQC;AAvYD;;GAEG;AACH,IAAY,qBAQX;AARD,WAAY,qBAAqB;IAC/B,oCAAW,CAAA;IACX,oCAAW,CAAA;IAEX,6BAA6B;IAC7B,qCAAY,CAAA;IACZ,6FAA6F;IAC7F,0BAA0B;AAC5B,CAAC,EARW,qBAAqB,qCAArB,qBAAqB,QAQhC;AAkDD;;GAEG;AACH,IAAY,sBAeX;AAfD,WAAY,sBAAsB;IAChC,+BAA+B;IAC/B,uCAAa,CAAA;IACb,qCAAW,CAAA;IACX,mCAAS,CAAA;IACT,oCAAU,CAAA;IAEV,qBAAqB;IACrB,sCAAY,CAAA;IAEZ,6BAA6B;IAC7B,8CAAoB,CAAA;IACpB,+CAAqB,CAAA;IACrB,6CAAmB,CAAA;IACnB,gDAAsB,CAAA;AACxB,CAAC,EAfW,sBAAsB,sCAAtB,sBAAsB,QAejC;AAiID;;GAEG;AACH,IAAY,QA2BX;AA3BD,WAAY,QAAQ;IAClB;;OAEG;IACH,6BAAiB,CAAA;IAEjB;;;OAGG;IACH,2BAAe,CAAA;IAEf;;;OAGG;IACH,+BAAmB,CAAA;IAEnB;;OAEG;IACH,2BAAe,CAAA;IAEf;;OAEG;IACH,+BAAmB,CAAA;AACrB,CAAC,EA3BW,QAAQ,wBAAR,QAAQ,QA2BnB;AAiJD,SAAgB,YAAY,CAC1B,KAAc;IAEd,MAAM,GAAG,GAAG,KAA4B,CAAC;IAEzC,OAAO,CACL,OAAO,GAAG,IAAI,UAAU,IAAI,OAAO,GAAG,CAAC,cAAc,IAAI,QAAQ,IAAI,GAAG,CAAC,cAAc,KAAK,IAAI,CACjG,CAAC;AACJ,CAAC"}

package/src/jobs/create-job-handler.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { BaseException, JsonValue, logging } from '@angular-devkit/core';
+import { Observable, Observer } from 'rxjs';
+import { JobDescription, JobHandler, JobHandlerContext } from './api';
+export declare class ChannelAlreadyExistException extends BaseException {
+    constructor(name: string);
+}
+/**
+ * Interface for the JobHandler context that is used when using `createJobHandler()`. It extends
+ * the basic `JobHandlerContext` with additional functionality.
+ */
+export interface SimpleJobHandlerContext<A extends JsonValue, I extends JsonValue, O extends JsonValue> extends JobHandlerContext<A, I, O> {
+    createChannel: (name: string) => Observer<JsonValue>;
+    input: Observable<I>;
+    addTeardown(teardown: () => Promise<void> | void): void;
+}
+/**
+ * A simple version of the JobHandler. This simplifies a lot of the interaction with the job
+ * scheduler and registry. For example, instead of returning a JobOutboundMessage observable, you
+ * can directly return an output.
+ */
+export type SimpleJobHandlerFn<A extends JsonValue, I extends JsonValue, O extends JsonValue> = (input: A, context: SimpleJobHandlerContext<A, I, O>) => O | Promise<O> | Observable<O>;
+/**
+ * Make a simple job handler that sets start and end from a function that's synchronous.
+ *
+ * @param fn The function to create a handler for.
+ * @param options An optional set of properties to set on the handler. Some fields might be
+ *   required by registry or schedulers.
+ */
+export declare function createJobHandler<A extends JsonValue, I extends JsonValue, O extends JsonValue>(fn: SimpleJobHandlerFn<A, I, O>, options?: Partial<JobDescription>): JobHandler<A, I, O>;
+/**
+ * Lazily create a job using a function.
+ * @param loader A factory function that returns a promise/observable of a JobHandler.
+ * @param options Same options as createJob.
+ */
+export declare function createJobFactory<A extends JsonValue, I extends JsonValue, O extends JsonValue>(loader: () => Promise<JobHandler<A, I, O>>, options?: Partial<JobDescription>): JobHandler<A, I, O>;
+/**
+ * Creates a job that logs out input/output messages of another Job. The messages are still
+ * propagated to the other job.
+ */
+export declare function createLoggerJob<A extends JsonValue, I extends JsonValue, O extends JsonValue>(job: JobHandler<A, I, O>, logger: logging.LoggerApi): JobHandler<A, I, O>;

package/src/jobs/create-job-handler.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChannelAlreadyExistException = void 0;
+exports.createJobHandler = createJobHandler;
+exports.createJobFactory = createJobFactory;
+exports.createLoggerJob = createLoggerJob;
+const core_1 = require("@angular-devkit/core");
+const rxjs_1 = require("rxjs");
+const api_1 = require("./api");
+class ChannelAlreadyExistException extends core_1.BaseException {
+    constructor(name) {
+        super(`Channel ${JSON.stringify(name)} already exist.`);
+    }
+}
+exports.ChannelAlreadyExistException = ChannelAlreadyExistException;
+/**
+ * Make a simple job handler that sets start and end from a function that's synchronous.
+ *
+ * @param fn The function to create a handler for.
+ * @param options An optional set of properties to set on the handler. Some fields might be
+ *   required by registry or schedulers.
+ */
+function createJobHandler(fn, options = {}) {
+    const handler = (argument, context) => {
+        const description = context.description;
+        const inboundBus = context.inboundBus;
+        const inputChannel = new rxjs_1.Subject();
+        let subscription;
+        const teardownLogics = [];
+        let tearingDown = false;
+        return new rxjs_1.Observable((subject) => {
+            function complete() {
+                if (subscription) {
+                    subscription.unsubscribe();
+                }
+                subject.next({ kind: api_1.JobOutboundMessageKind.End, description });
+                subject.complete();
+                inputChannel.complete();
+            }
+            // Handle input.
+            const inboundSub = inboundBus.subscribe((message) => {
+                switch (message.kind) {
+                    case api_1.JobInboundMessageKind.Ping:
+                        subject.next({ kind: api_1.JobOutboundMessageKind.Pong, description, id: message.id });
+                        break;
+                    case api_1.JobInboundMessageKind.Stop:
+                        // Run teardown logic then complete.
+                        tearingDown = true;
+                        if (teardownLogics.length) {
+                            Promise.all(teardownLogics.map((fn) => fn())).then(() => complete(), () => complete());
+                        }
+                        else {
+                            complete();
+                        }
+                        break;
+                    case api_1.JobInboundMessageKind.Input:
+                        if (!tearingDown) {
+                            inputChannel.next(message.value);
+                        }
+                        break;
+                }
+            });
+            // Execute the function with the additional context.
+            const channels = new Map();
+            const newContext = {
+                ...context,
+                input: inputChannel.asObservable(),
+                addTeardown(teardown) {
+                    teardownLogics.push(teardown);
+                },
+                createChannel(name) {
+                    if (channels.has(name)) {
+                        throw new ChannelAlreadyExistException(name);
+                    }
+                    const channelSubject = new rxjs_1.Subject();
+                    const channelSub = channelSubject.subscribe((message) => {
+                        subject.next({
+                            kind: api_1.JobOutboundMessageKind.ChannelMessage,
+                            description,
+                            name,
+                            message,
+                        });
+                    }, (error) => {
+                        subject.next({ kind: api_1.JobOutboundMessageKind.ChannelError, description, name, error });
+                        // This can be reopened.
+                        channels.delete(name);
+                    }, () => {
+                        subject.next({ kind: api_1.JobOutboundMessageKind.ChannelComplete, description, name });
+                        // This can be reopened.
+                        channels.delete(name);
+                    });
+                    channels.set(name, channelSubject);
+                    if (subscription) {
+                        subscription.add(channelSub);
+                    }
+                    return channelSubject;
+                },
+            };
+            subject.next({ kind: api_1.JobOutboundMessageKind.Start, description });
+            let result = fn(argument, newContext);
+            // If the result is a promise, simply wait for it to complete before reporting the result.
+            if ((0, core_1.isPromise)(result)) {
+                result = (0, rxjs_1.from)(result);
+            }
+            else if (!(0, rxjs_1.isObservable)(result)) {
+                result = (0, rxjs_1.of)(result);
+            }
+            subscription = result.subscribe((value) => subject.next({ kind: api_1.JobOutboundMessageKind.Output, description, value }), (error) => subject.error(error), () => complete());
+            subscription.add(inboundSub);
+            return subscription;
+        });
+    };
+    return Object.assign(handler, { jobDescription: options });
+}
+/**
+ * Lazily create a job using a function.
+ * @param loader A factory function that returns a promise/observable of a JobHandler.
+ * @param options Same options as createJob.
+ */
+function createJobFactory(loader, options = {}) {
+    const handler = (argument, context) => {
+        return (0, rxjs_1.from)(loader()).pipe((0, rxjs_1.switchMap)((fn) => fn(argument, context)));
+    };
+    return Object.assign(handler, { jobDescription: options });
+}
+/**
+ * Creates a job that logs out input/output messages of another Job. The messages are still
+ * propagated to the other job.
+ */
+function createLoggerJob(job, logger) {
+    const handler = (argument, context) => {
+        context.inboundBus
+            .pipe((0, rxjs_1.tap)((message) => logger.info(`Input: ${JSON.stringify(message)}`)))
+            .subscribe();
+        return job(argument, context).pipe((0, rxjs_1.tap)((message) => logger.info(`Message: ${JSON.stringify(message)}`), (error) => logger.warn(`Error: ${JSON.stringify(error)}`), () => logger.info(`Completed`)));
+    };
+    return Object.assign(handler, job);
+}
+//# sourceMappingURL=create-job-handler.js.map

package/src/jobs/create-job-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-job-handler.js","sourceRoot":"","sources":["create-job-handler.ts"],"names":[],"mappings":"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"}

package/src/jobs/dispatcher.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { JsonValue } from '@angular-devkit/core';
+import { JobDescription, JobHandler, JobName } from './api';
+import { Readwrite } from './types';
+/**
+ * A JobDispatcher can be used to dispatch between multiple jobs.
+ */
+export interface JobDispatcher<A extends JsonValue, I extends JsonValue, O extends JsonValue> extends JobHandler<A, I, O> {
+    /**
+     * Set the default job if all conditionals failed.
+     * @param name The default name if all conditions are false.
+     */
+    setDefaultJob(name: JobName | null | JobHandler<JsonValue, JsonValue, JsonValue>): void;
+    /**
+     * Add a conditional job that will be selected if the input fits a predicate.
+     * @param predicate
+     * @param name
+     */
+    addConditionalJob(predicate: (args: A) => boolean, name: string): void;
+}
+/**
+ * OnReady a dispatcher that can dispatch to a sub job, depending on conditions.
+ * @param options
+ */
+export declare function createDispatcher<A extends JsonValue, I extends JsonValue, O extends JsonValue>(options?: Partial<Readwrite<JobDescription>>): JobDispatcher<A, I, O>;