@owlmeans/queue 0.1.18-rc.4 → 0.1.18-rc.41

package/build/errors.d.ts

@@ -0,0 +1,68 @@
+import { ResilientError } from '@owlmeans/error';
+export declare class QueueError extends ResilientError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/**
+ * The caller stopped waiting. The job is untouched — it may still be queued, running, or already
+ * finished; only the wait ended. Read the job back to learn which.
+ */
+export declare class QueueTimeout extends QueueError {
+    static typeName: string;
+    constructor(msg: string);
+}
+/** No job with that id in this queue — it never existed, or it was removed after completing. */
+export declare class UnknownJob extends QueueError {
+    static typeName: string;
+    constructor(msg: string);
+}
+/**
+ * A job name the queue does not declare. Declaring every job a queue accepts is what keeps an
+ * enqueue from succeeding into a queue where nothing can ever process it.
+ */
+export declare class UnknownJobName extends QueueError {
+    static typeName: string;
+    constructor(msg: string);
+}
+/** A queue asked for that no declaration names. */
+export declare class UnknownQueue extends QueueError {
+    static typeName: string;
+    constructor(msg: string);
+}
+/**
+ * This process was asked to consume a queue it does not listen to. Which queues a process
+ * consumes is configuration (`cfg.queue.listen`), so this is a deployment question, not a code
+ * one — the same binary is a producer or a worker depending on it.
+ */
+export declare class QueueNotListening extends QueueError {
+    static typeName: string;
+    constructor(msg: string);
+}
+/**
+ * The job named an entrypoint this process does not serve. Unlike a missing queue this is not a
+ * declaration problem: the alias exists, but nothing here bound it, so the job was taken by a
+ * worker that cannot run it.
+ */
+export declare class JobNotServed extends QueueError {
+    static typeName: string;
+    constructor(msg: string);
+}
+/**
+ * The signed envelope is older than the configured lifetime. Freshness is judged from when the
+ * producer enqueued the job, not from when a worker picked it up, so a long backlog does not
+ * invalidate work that was legitimate when it was submitted.
+ */
+export declare class EnvelopeExpired extends QueueError {
+    static typeName: string;
+    constructor(msg: string);
+}
+/**
+ * A schedule the broker could not carry out as written: no id, both or neither of `every` and
+ * `pattern`, an option that only means something for the other one, or a job option the broker
+ * owns for a scheduled run. The message names the schedule id and the reason.
+ */
+export declare class ScheduleMisdeclared extends QueueError {
+    static typeName: string;
+    constructor(msg: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/build/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,qBAAa,UAAW,SAAQ,cAAc;IAC5C,OAAuB,QAAQ,SAAe;IAE9C,YAAY,OAAO,GAAE,MAAgB,EAEpC;CACF;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAC1C,OAAuB,QAAQ,SAAkC;IAEjE,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF;AAED,gGAAgG;AAChG,qBAAa,UAAW,SAAQ,UAAU;IACxC,OAAuB,QAAQ,SAAqC;IAEpE,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C,OAAuB,QAAQ,SAAyC;IAExE,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF;AAED,mDAAmD;AACnD,qBAAa,YAAa,SAAQ,UAAU;IAC1C,OAAuB,QAAQ,SAAuC;IAEtE,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,OAAuB,QAAQ,SAAuC;IAEtE,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF;AAED;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAC1C,OAAuB,QAAQ,SAAuC;IAEtE,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF;AAED;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,OAAuB,QAAQ,SAA0C;IAEzE,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,OAAuB,QAAQ,SAA8C;IAE7E,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF"}

package/build/errors.js

@@ -0,0 +1,103 @@
+import { ResilientError } from '@owlmeans/error';
+export class QueueError extends ResilientError {
+    static typeName = 'QueueError';
+    constructor(message = 'error') {
+        super(QueueError.typeName, `queue:${message}`);
+    }
+}
+/**
+ * The caller stopped waiting. The job is untouched — it may still be queued, running, or already
+ * finished; only the wait ended. Read the job back to learn which.
+ */
+export class QueueTimeout extends QueueError {
+    static typeName = `${QueueError.typeName}Timeout`;
+    constructor(msg) {
+        super(`timeout:${msg}`);
+        this.type = QueueTimeout.typeName;
+    }
+}
+/** No job with that id in this queue — it never existed, or it was removed after completing. */
+export class UnknownJob extends QueueError {
+    static typeName = `${QueueError.typeName}UnknownJob`;
+    constructor(msg) {
+        super(`unknown-job:${msg}`);
+        this.type = UnknownJob.typeName;
+    }
+}
+/**
+ * A job name the queue does not declare. Declaring every job a queue accepts is what keeps an
+ * enqueue from succeeding into a queue where nothing can ever process it.
+ */
+export class UnknownJobName extends QueueError {
+    static typeName = `${QueueError.typeName}UnknownJobName`;
+    constructor(msg) {
+        super(`unknown-job-name:${msg}`);
+        this.type = UnknownJobName.typeName;
+    }
+}
+/** A queue asked for that no declaration names. */
+export class UnknownQueue extends QueueError {
+    static typeName = `${QueueError.typeName}UnknownQueue`;
+    constructor(msg) {
+        super(`unknown-queue:${msg}`);
+        this.type = UnknownQueue.typeName;
+    }
+}
+/**
+ * This process was asked to consume a queue it does not listen to. Which queues a process
+ * consumes is configuration (`cfg.queue.listen`), so this is a deployment question, not a code
+ * one — the same binary is a producer or a worker depending on it.
+ */
+export class QueueNotListening extends QueueError {
+    static typeName = `${QueueError.typeName}NotListening`;
+    constructor(msg) {
+        super(`not-listening:${msg}`);
+        this.type = QueueNotListening.typeName;
+    }
+}
+/**
+ * The job named an entrypoint this process does not serve. Unlike a missing queue this is not a
+ * declaration problem: the alias exists, but nothing here bound it, so the job was taken by a
+ * worker that cannot run it.
+ */
+export class JobNotServed extends QueueError {
+    static typeName = `${QueueError.typeName}JobNotServed`;
+    constructor(msg) {
+        super(`job-not-served:${msg}`);
+        this.type = JobNotServed.typeName;
+    }
+}
+/**
+ * The signed envelope is older than the configured lifetime. Freshness is judged from when the
+ * producer enqueued the job, not from when a worker picked it up, so a long backlog does not
+ * invalidate work that was legitimate when it was submitted.
+ */
+export class EnvelopeExpired extends QueueError {
+    static typeName = `${QueueError.typeName}EnvelopeExpired`;
+    constructor(msg) {
+        super(`envelope-expired:${msg}`);
+        this.type = EnvelopeExpired.typeName;
+    }
+}
+/**
+ * A schedule the broker could not carry out as written: no id, both or neither of `every` and
+ * `pattern`, an option that only means something for the other one, or a job option the broker
+ * owns for a scheduled run. The message names the schedule id and the reason.
+ */
+export class ScheduleMisdeclared extends QueueError {
+    static typeName = `${QueueError.typeName}ScheduleMisdeclared`;
+    constructor(msg) {
+        super(`schedule-misdeclared:${msg}`);
+        this.type = ScheduleMisdeclared.typeName;
+    }
+}
+ResilientError.registerErrorClass(QueueError);
+ResilientError.registerErrorClass(QueueTimeout);
+ResilientError.registerErrorClass(UnknownJob);
+ResilientError.registerErrorClass(UnknownJobName);
+ResilientError.registerErrorClass(UnknownQueue);
+ResilientError.registerErrorClass(QueueNotListening);
+ResilientError.registerErrorClass(JobNotServed);
+ResilientError.registerErrorClass(EnvelopeExpired);
+ResilientError.registerErrorClass(ScheduleMisdeclared);
+//# sourceMappingURL=errors.js.map

package/build/errors.js.map

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

package/build/index.d.ts

@@ -1 +1,19 @@
+export * from './types.js';
+export type * from './queue-config/types.js';
+export type * from './bridge/types.js';
+export type * from './queue-route/types.js';
+export type * from './protocol/types.js';
+export type * from './entrypoint-jobs/types.js';
+export * from './consts.js';
+export * from './utils.js';
+export * from './errors.js';
+export * from './config.js';
+export * from './queue-config.js';
+export * from './transport.js';
+export * from './bridge.js';
+export * from './entrypoint-jobs.js';
+export * from './worker.js';
+export * from './protocol.js';
+export * from './route.js';
+export * from './queue-route.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,mBAAmB,yBAAyB,CAAA;AAC5C,mBAAmB,mBAAmB,CAAA;AACtC,mBAAmB,wBAAwB,CAAA;AAC3C,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,4BAA4B,CAAA;AAC/C,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA"}

package/build/index.js

@@ -1,2 +1,14 @@
-"use strict";
+export * from './types.js';
+export * from './consts.js';
+export * from './utils.js';
+export * from './errors.js';
+export * from './config.js';
+export * from './queue-config.js';
+export * from './transport.js';
+export * from './bridge.js';
+export * from './entrypoint-jobs.js';
+export * from './worker.js';
+export * from './protocol.js';
+export * from './route.js';
+export * from './queue-route.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAM1B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA"}

package/build/protocol/types.d.ts

@@ -0,0 +1,12 @@
+import type { EntrypointProtocolDeclaration, RequestOf, ResponseOf } from '@owlmeans/entrypoint';
+import type { JobEnvelope, JobOptions, JobRecord, JobReply } from '../types.js';
+/** Enqueueing and awaiting QUEUE protocols in one context, with their exact types kept. */
+export interface QueueProtocolHelper {
+    /** Enqueue an immutable QUEUE protocol while preserving its exact request and response types. */
+    enqueue: <Protocol extends EntrypointProtocolDeclaration>(declaration: Protocol, request: RequestOf<Protocol>, options?: JobOptions) => Promise<JobRecord<JobEnvelope, JobReply<ResponseOf<Protocol>>>>;
+    /** Wait for a protocol job and unwrap the typed entrypoint reply. */
+    waitFor: <Protocol extends EntrypointProtocolDeclaration>(declaration: Protocol, job: string | JobRecord<JobEnvelope, JobReply<ResponseOf<Protocol>>>, options?: {
+        timeout?: number;
+    }) => Promise<ResponseOf<Protocol>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/protocol/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAChG,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE/E,2FAA2F;AAC3F,MAAM,WAAW,mBAAmB;IAClC,iGAAiG;IACjG,OAAO,EAAE,CAAC,QAAQ,SAAS,6BAA6B,EACtD,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,EAAE,UAAU,KACtE,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;IACpE,qEAAqE;IACrE,OAAO,EAAE,CAAC,QAAQ,SAAS,6BAA6B,EACtD,WAAW,EAAE,QAAQ,EACrB,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,EACpE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAC3B,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAA;CACnC"}

package/build/protocol/types.js

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

package/build/protocol/types.js.map

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

package/build/protocol.d.ts

@@ -0,0 +1,13 @@
+import { type EntrypointProtocolDeclaration, type RequestOf, type ResponseOf } from '@owlmeans/entrypoint';
+import type { JobEnvelope, JobOptions, JobRecord, JobReply } from './types.js';
+import type { QueueContext } from './types.js';
+import type { QueueProtocolHelper } from './protocol/types.js';
+export declare const makeQueueProtocolHelper: (context: QueueContext) => QueueProtocolHelper;
+export declare const queueProtocolOf: (target: QueueContext) => QueueProtocolHelper;
+/** @deprecated compat:factory-refactor — use `queueProtocolOf(ctx).enqueue(…)` */
+export declare const enqueueProtocol: <Protocol extends EntrypointProtocolDeclaration>(context: QueueContext, declaration: Protocol, request: RequestOf<Protocol>, options?: JobOptions) => Promise<JobRecord<JobEnvelope, JobReply<ResponseOf<Protocol>>>>;
+/** @deprecated compat:factory-refactor — use `queueProtocolOf(ctx).waitFor(…)` */
+export declare const waitForProtocol: <Protocol extends EntrypointProtocolDeclaration>(context: QueueContext, declaration: Protocol, job: string | JobRecord<JobEnvelope, JobReply<ResponseOf<Protocol>>>, options?: {
+    timeout?: number;
+}) => Promise<ResponseOf<Protocol>>;
+//# sourceMappingURL=protocol.d.ts.map

package/build/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,6BAA6B,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAwB,MAAM,sBAAsB,CAAA;AAMhI,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAE9D,eAAO,MAAM,uBAAuB,YAAa,YAAY,KAAG,mBAiE/D,CAAA;AAED,eAAO,MAAM,eAAe,+CAA8C,CAAA;AAE1E,kFAAkF;AAClF,eAAO,MAAM,eAAe,GAAU,QAAQ,SAAS,6BAA6B,WACzE,YAAY,eACR,QAAQ,WACZ,SAAS,CAAC,QAAQ,CAAC,YAClB,UAAU,KACnB,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CACM,CAAA;AAEvE,kFAAkF;AAClF,eAAO,MAAM,eAAe,GAAU,QAAQ,SAAS,6BAA6B,WACzE,YAAY,eACR,QAAQ,OAChB,MAAM,GAAG,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,YAC1D;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAC7B,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAsE,CAAA"}

package/build/protocol.js

@@ -0,0 +1,63 @@
+import { isEntrypointProtocol } from '@owlmeans/entrypoint';
+import { memoHelper } from '@owlmeans/context';
+import { ResilientError } from '@owlmeans/error';
+import { queueConfigOf } from './queue-config.js';
+import { UnknownQueue } from './errors.js';
+import { queueRouteHelper } from './queue-route.js';
+export const makeQueueProtocolHelper = (context) => {
+    const queueFor = (declaration) => {
+        if (declaration == null || typeof declaration !== 'object' || !isEntrypointProtocol(declaration)) {
+            throw new UnknownQueue('protocol declaration required');
+        }
+        if (!queueRouteHelper.isQueueRoute(declaration.route)) {
+            throw new UnknownQueue(`${declaration.alias}: not a queue protocol`);
+        }
+        const { queue } = queueRouteHelper.queueRouteOptions(declaration.route);
+        const configured = queueConfigOf(context.cfg).queueOf(queue);
+        if (!configured.jobs.includes(declaration.alias)) {
+            throw new UnknownQueue(`${queue}:${declaration.alias}`);
+        }
+        return { protocol: declaration, queue };
+    };
+    const enqueue = async (declaration, request, options) => {
+        const { protocol, queue } = queueFor(declaration);
+        const shaped = (request ?? {});
+        const envelope = {
+            alias: protocol.alias,
+            params: shaped.params,
+            body: shaped.body,
+            query: shaped.query,
+            headers: shaped.headers,
+            enqueuedAt: new Date().toISOString(),
+        };
+        return await context.jobs(queue).create({
+            queue,
+            name: protocol.alias,
+            data: envelope,
+            opts: options,
+        });
+    };
+    const waitFor = async (declaration, job, options) => {
+        const { protocol, queue } = queueFor(declaration);
+        if (typeof job !== 'string' && (job.queue !== queue || job.name !== protocol.alias)) {
+            throw new UnknownQueue(`${job.queue}:${job.name}`);
+        }
+        const id = typeof job === 'string' ? job : job.id;
+        if (id == null) {
+            throw new UnknownQueue(`${queue}:${protocol.alias}: missing job id`);
+        }
+        const reply = await context.jobs(queue)
+            .wait(id, options);
+        if (reply.error != null) {
+            throw ResilientError.ensure(reply.error);
+        }
+        return reply.value;
+    };
+    return { enqueue, waitFor };
+};
+export const queueProtocolOf = memoHelper.oncePer(makeQueueProtocolHelper);
+/** @deprecated compat:factory-refactor — use `queueProtocolOf(ctx).enqueue(…)` */
+export const enqueueProtocol = async (context, declaration, request, options) => await queueProtocolOf(context).enqueue(declaration, request, options);
+/** @deprecated compat:factory-refactor — use `queueProtocolOf(ctx).waitFor(…)` */
+export const waitForProtocol = async (context, declaration, job, options) => await queueProtocolOf(context).waitFor(declaration, job, options);
+//# sourceMappingURL=protocol.js.map

package/build/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChI,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAKnD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,OAAqB,EAAuB,EAAE;IACpF,MAAM,QAAQ,GAAG,CAAC,WAAoB,EAGpC,EAAE;QACF,IAAI,WAAW,IAAI,IAAI,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,EAAE,CAAC;YACjG,MAAM,IAAI,YAAY,CAAC,+BAA+B,CAAC,CAAA;QACzD,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,YAAY,CAAC,GAAG,WAAW,CAAC,KAAK,wBAAwB,CAAC,CAAA;QACtE,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QACvE,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC5D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,YAAY,CAAC,GAAG,KAAK,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC,CAAA;QACzD,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,CAAA;IACzC,CAAC,CAAA;IAED,MAAM,OAAO,GAAG,KAAK,EACnB,WAAqB,EACrB,OAA4B,EAC5B,OAAoB,EAC6C,EAAE;QACnE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAA;QACjD,MAAM,MAAM,GAAG,CAAC,OAAO,IAAI,EAAE,CAAuC,CAAA;QACpE,MAAM,QAAQ,GAAgB;YAC5B,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,MAAM,EAAE,MAAM,CAAC,MAA6C;YAC5D,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAA4C;YAC1D,OAAO,EAAE,MAAM,CAAC,OAAyD;YACzE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAA;QAED,OAAO,MAAM,OAAO,CAAC,IAAI,CAA8C,KAAK,CAAC,CAAC,MAAM,CAAC;YACnF,KAAK;YACL,IAAI,EAAE,QAAQ,CAAC,KAAK;YACpB,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,OAAO;SACd,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,MAAM,OAAO,GAAG,KAAK,EACnB,WAAqB,EACrB,GAAoE,EACpE,OAA8B,EACC,EAAE;QACjC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAA;QACjD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpF,MAAM,IAAI,YAAY,CAAC,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;QACpD,CAAC;QACD,MAAM,EAAE,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAA;QACjD,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,YAAY,CAAC,GAAG,KAAK,IAAI,QAAQ,CAAC,KAAK,kBAAkB,CAAC,CAAA;QACtE,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAA8C,KAAK,CAAC;aACjF,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QACpB,IAAI,KAAK,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;YACxB,MAAM,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,KAAuB,CAAC,CAAA;QAC5D,CAAC;QACD,OAAO,KAAK,CAAC,KAA6B,CAAA;IAC5C,CAAC,CAAA;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;AAC7B,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAA;AAE1E,kFAAkF;AAClF,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,OAAqB,EACrB,WAAqB,EACrB,OAA4B,EAC5B,OAAoB,EAC6C,EAAE,CACnE,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AAEvE,kFAAkF;AAClF,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,OAAqB,EACrB,WAAqB,EACrB,GAAoE,EACpE,OAA8B,EACC,EAAE,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA"}

package/build/queue-config/types.d.ts

@@ -0,0 +1,29 @@
+import type { QueueDeclaration, ScheduleDeclaration } from '../types.js';
+/** What one configuration declares about its queues and schedules, read and checked. */
+export interface QueueConfigHelper {
+    /**
+     * @throws {UnknownQueue}
+     */
+    queueOf: (name: string) => QueueDeclaration;
+    queueOfJob: (job: string) => QueueDeclaration | undefined;
+    isListening: (name: string) => boolean;
+    /**
+     * Whether the broker can carry a schedule out as written. Nothing is recorded or changed.
+     *
+     * @throws {ScheduleMisdeclared} naming the schedule id and the reason.
+     * @throws {UnknownQueue} when the schedule's queue is not declared.
+     * @throws {UnknownJobName} when that queue does not accept the schedule's job name — a scheduled
+     * run of a name nothing declares would fail on every tick instead of once, at declaration.
+     */
+    assertSchedule: (schedule: ScheduleDeclaration) => void;
+    /** The declared schedules, of one queue when it is named. */
+    schedulesOf: (queue?: string) => ScheduleDeclaration[];
+    /**
+     * Check every declared schedule, including any written into the configuration without
+     * `declareSchedule`, and refuse two under one id.
+     *
+     * @throws {ScheduleMisdeclared} / {UnknownQueue} / {UnknownJobName} for the first one that fails.
+     */
+    assertSchedules: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/queue-config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/queue-config/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAExE,wFAAwF;AACxF,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,CAAA;IAC3C,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAA;IACzD,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IACtC;;;;;;;OAOG;IACH,cAAc,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAA;IACvD,6DAA6D;IAC7D,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,mBAAmB,EAAE,CAAA;IACtD;;;;;OAKG;IACH,eAAe,EAAE,MAAM,IAAI,CAAA;CAC5B"}

package/build/queue-config/types.js

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

package/build/queue-config/types.js.map

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

package/build/queue-config.d.ts

@@ -0,0 +1,9 @@
+import type { Config } from './types.js';
+import type { QueueConfigHelper } from './queue-config/types.js';
+/**
+ * The queue configuration of one `cfg`. It reads `cfg.queue` on every call, so declarations made
+ * after it was built are seen.
+ */
+export declare const makeQueueConfigHelper: (cfg: Config) => QueueConfigHelper;
+export declare const queueConfigOf: (target: Config) => QueueConfigHelper;
+//# sourceMappingURL=queue-config.d.ts.map

package/build/queue-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-config.d.ts","sourceRoot":"","sources":["../src/queue-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAqD,MAAM,YAAY,CAAA;AAC3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAGhE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAS,MAAM,KAAG,iBA0FnD,CAAA;AAED,eAAO,MAAM,aAAa,uCAA4C,CAAA"}

package/build/queue-config.js

@@ -0,0 +1,83 @@
+import { memoHelper } from '@owlmeans/context';
+import { ScheduleMisdeclared, UnknownJobName, UnknownQueue } from './errors.js';
+/**
+ * The queue configuration of one `cfg`. It reads `cfg.queue` on every call, so declarations made
+ * after it was built are seen.
+ */
+export const makeQueueConfigHelper = (cfg) => {
+    const queueOf = (name) => {
+        const queue = cfg.queue?.queues?.find(declared => declared.name === name);
+        if (queue == null) {
+            throw new UnknownQueue(name);
+        }
+        return queue;
+    };
+    const queueOfJob = (job) => cfg.queue?.queues?.find(declared => declared.jobs.includes(job));
+    const isListening = (name) => cfg.queue?.listen?.includes(name) === true;
+    /** A date option the broker can read — a `Date`, epoch milliseconds or a parsable string. */
+    const isInstant = (value) => Number.isFinite((value instanceof Date ? value : new Date(value)).getTime());
+    const assertSchedule = (schedule) => {
+        const { id } = schedule;
+        if (typeof id !== 'string' || id.trim() === '') {
+            throw new ScheduleMisdeclared('(empty):id');
+        }
+        const queue = queueOf(schedule.queue);
+        if (!queue.jobs.includes(schedule.name)) {
+            throw new UnknownJobName(`${schedule.queue}:${schedule.name}`);
+        }
+        const every = schedule.every != null;
+        const pattern = schedule.pattern != null;
+        if (every === pattern) {
+            throw new ScheduleMisdeclared(`${id}:every-or-pattern`);
+        }
+        if (every && !(Number.isSafeInteger(schedule.every) && schedule.every > 0)) {
+            throw new ScheduleMisdeclared(`${id}:every`);
+        }
+        if (pattern && (typeof schedule.pattern !== 'string' || schedule.pattern.trim() === '')) {
+            throw new ScheduleMisdeclared(`${id}:pattern`);
+        }
+        // Both only mean something to a cron pattern: an interval has no wall clock to read in a time
+        // zone, and its first run is immediate already.
+        if (!pattern && schedule.tz != null) {
+            throw new ScheduleMisdeclared(`${id}:tz`);
+        }
+        if (!pattern && schedule.immediately === true) {
+            throw new ScheduleMisdeclared(`${id}:immediately`);
+        }
+        if (schedule.immediately === true && schedule.startDate != null) {
+            throw new ScheduleMisdeclared(`${id}:immediately-start-date`);
+        }
+        if (schedule.limit != null && !(Number.isSafeInteger(schedule.limit) && schedule.limit > 0)) {
+            throw new ScheduleMisdeclared(`${id}:limit`);
+        }
+        if (schedule.startDate != null && !isInstant(schedule.startDate)) {
+            throw new ScheduleMisdeclared(`${id}:start-date`);
+        }
+        if (schedule.endDate != null && !isInstant(schedule.endDate)) {
+            throw new ScheduleMisdeclared(`${id}:end-date`);
+        }
+        // The type already omits both; a declaration assembled at runtime still reaches this check. The
+        // broker names every run itself and places it on the schedule, so either would be overridden.
+        const opts = schedule.opts;
+        if (opts?.id != null) {
+            throw new ScheduleMisdeclared(`${id}:opts-id`);
+        }
+        if (opts?.delay != null) {
+            throw new ScheduleMisdeclared(`${id}:opts-delay`);
+        }
+    };
+    const schedulesOf = (queue) => (cfg.queue?.schedules ?? []).filter(schedule => queue == null || schedule.queue === queue);
+    const assertSchedules = () => {
+        const seen = new Set();
+        for (const schedule of schedulesOf()) {
+            assertSchedule(schedule);
+            if (seen.has(schedule.id)) {
+                throw new ScheduleMisdeclared(`${schedule.id}:duplicate`);
+            }
+            seen.add(schedule.id);
+        }
+    };
+    return { queueOf, queueOfJob, isListening, assertSchedule, schedulesOf, assertSchedules };
+};
+export const queueConfigOf = memoHelper.oncePer(makeQueueConfigHelper);
+//# sourceMappingURL=queue-config.js.map

package/build/queue-config.js.map

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

package/build/queue-route/types.d.ts

@@ -0,0 +1,14 @@
+import type { RouteDeclaration, RouteModel } from '@owlmeans/route';
+import type { QueueRouteOptions } from '../types.js';
+/** Reads a route declaration as one carried by the queue transport. */
+export interface QueueRouteHelper {
+    /** Whether a declaration belongs to the queue transport. */
+    isQueueRoute: (route: RouteDeclaration | RouteModel) => boolean;
+    /**
+     * Read and validate queue-owned route options.
+     *
+     * @throws {UnknownQueue} for a route of another protocol, or queue options that do not validate
+     */
+    queueRouteOptions: (route: RouteDeclaration | RouteModel) => Pick<QueueRouteOptions, 'queue' | 'reply'>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/queue-route/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/queue-route/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpD,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,YAAY,EAAE,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,KAAK,OAAO,CAAA;IAC/D;;;;OAIG;IACH,iBAAiB,EAAE,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,KAAK,IAAI,CAAC,iBAAiB,EAAE,OAAO,GAAG,OAAO,CAAC,CAAA;CACxG"}

package/build/queue-route/types.js

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

package/build/queue-route/types.js.map

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

package/build/queue-route.d.ts

@@ -0,0 +1,4 @@
+import type { QueueRouteHelper } from './queue-route/types.js';
+export declare const createQueueRouteHelper: () => QueueRouteHelper;
+export declare const queueRouteHelper: QueueRouteHelper;
+//# sourceMappingURL=queue-route.d.ts.map

package/build/queue-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-route.d.ts","sourceRoot":"","sources":["../src/queue-route.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,eAAO,MAAM,sBAAsB,QAAO,gBAwBzC,CAAA;AAED,eAAO,MAAM,gBAAgB,kBAA2B,CAAA"}

package/build/queue-route.js

@@ -0,0 +1,24 @@
+import { UnknownQueue } from './errors.js';
+import { QUEUE_PROTOCOL } from './consts.js';
+export const createQueueRouteHelper = () => {
+    const isQueueRoute = (route) => ('route' in route ? route.route : route).protocol === QUEUE_PROTOCOL;
+    const queueRouteOptions = (route) => {
+        const declaration = 'route' in route ? route.route : route;
+        if (declaration.protocol !== QUEUE_PROTOCOL
+            || declaration.protocolOptions == null
+            || typeof declaration.protocolOptions !== 'object') {
+            throw new UnknownQueue(`${declaration.alias}: not a queue protocol`);
+        }
+        const options = declaration.protocolOptions;
+        if (typeof options.queue !== 'string' || options.queue.trim() === '') {
+            throw new UnknownQueue(`${declaration.alias}: route declares no queue`);
+        }
+        if (options.reply != null && typeof options.reply !== 'boolean') {
+            throw new UnknownQueue(`${declaration.alias}: invalid queue reply option`);
+        }
+        return { queue: options.queue, reply: options.reply };
+    };
+    return { isQueueRoute, queueRouteOptions };
+};
+export const queueRouteHelper = createQueueRouteHelper();
+//# sourceMappingURL=queue-route.js.map

package/build/queue-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-route.js","sourceRoot":"","sources":["../src/queue-route.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAI5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAqB,EAAE;IAC3D,MAAM,YAAY,GAAG,CAAC,KAAoC,EAAW,EAAE,CACrE,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,KAAK,cAAc,CAAA;IAEtE,MAAM,iBAAiB,GAAG,CACxB,KAAoC,EACQ,EAAE;QAC9C,MAAM,WAAW,GAAG,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAA;QAC1D,IAAI,WAAW,CAAC,QAAQ,KAAK,cAAc;eACtC,WAAW,CAAC,eAAe,IAAI,IAAI;eACnC,OAAO,WAAW,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,IAAI,YAAY,CAAC,GAAG,WAAW,CAAC,KAAK,wBAAwB,CAAC,CAAA;QACtE,CAAC;QACD,MAAM,OAAO,GAAG,WAAW,CAAC,eAA0C,CAAA;QACtE,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACrE,MAAM,IAAI,YAAY,CAAC,GAAG,WAAW,CAAC,KAAK,2BAA2B,CAAC,CAAA;QACzE,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,IAAI,IAAI,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChE,MAAM,IAAI,YAAY,CAAC,GAAG,WAAW,CAAC,KAAK,8BAA8B,CAAC,CAAA;QAC5E,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAA4B,EAAE,CAAA;IAC9E,CAAC,CAAA;IAED,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAA;AAC5C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,EAAE,CAAA"}

package/build/route.d.ts

@@ -0,0 +1,9 @@
+import { type RouteDeclaration, type RouteModel, type RouteOptions } from '@owlmeans/route';
+import type { QueueRouteOptions } from './types.js';
+/** Declare a backend route carried by a queue. */
+export declare const job: (opts: QueueRouteOptions, secondary?: Omit<QueueRouteOptions, 'queue'>) => Partial<RouteOptions>;
+/** @deprecated compat:factory-refactor — use `queueRouteHelper.isQueueRoute(…)` */
+export declare const isQueueRoute: (route: RouteDeclaration | RouteModel) => boolean;
+/** @deprecated compat:factory-refactor — use `queueRouteHelper.queueRouteOptions(…)` */
+export declare const queueRouteOptions: (route: RouteDeclaration | RouteModel) => Pick<QueueRouteOptions, 'queue' | 'reply'>;
+//# sourceMappingURL=route.d.ts.map

package/build/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../src/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAGnD,kDAAkD;AAClD,eAAO,MAAM,GAAG,SACR,iBAAiB,cACX,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,KAC3C,OAAO,CAAC,YAAY,CAMtB,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,YAAY,UAAW,gBAAgB,GAAG,UAAU,KAAG,OAA+C,CAAA;AAEnH,wFAAwF;AACxF,eAAO,MAAM,iBAAiB,UAAW,gBAAgB,GAAG,UAAU,KAAG,IAAI,CAAC,iBAAiB,EAAE,OAAO,GAAG,OAAO,CACvE,CAAA"}

package/build/route.js

@@ -0,0 +1,16 @@
+import { backend } from '@owlmeans/route';
+import { QUEUE_PROTOCOL } from './consts.js';
+import { queueRouteHelper } from './queue-route.js';
+/** Declare a backend route carried by a queue. */
+export const job = (opts, secondary) => {
+    const { queue, reply, ...routeOptions } = { ...opts, ...secondary };
+    const declaration = backend(routeOptions);
+    declaration.protocol = QUEUE_PROTOCOL;
+    declaration.protocolOptions = { queue, ...(reply == null ? {} : { reply }) };
+    return declaration;
+};
+/** @deprecated compat:factory-refactor — use `queueRouteHelper.isQueueRoute(…)` */
+export const isQueueRoute = (route) => queueRouteHelper.isQueueRoute(route);
+/** @deprecated compat:factory-refactor — use `queueRouteHelper.queueRouteOptions(…)` */
+export const queueRouteOptions = (route) => queueRouteHelper.queueRouteOptions(route);
+//# sourceMappingURL=route.js.map

package/build/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../src/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA6D,MAAM,iBAAiB,CAAA;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEnD,kDAAkD;AAClD,MAAM,CAAC,MAAM,GAAG,GAAG,CACjB,IAAuB,EACvB,SAA4C,EACrB,EAAE;IACzB,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,EAAE,CAAA;IACnE,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACzC,WAAW,CAAC,QAAQ,GAAG,cAAc,CAAA;IACrC,WAAW,CAAC,eAAe,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;IAC5E,OAAO,WAAW,CAAA;AACpB,CAAC,CAAA;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAoC,EAAW,EAAE,CAAC,gBAAgB,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;AAEnH,wFAAwF;AACxF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAoC,EAA8C,EAAE,CACpH,gBAAgB,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAA"}

package/build/transport.d.ts

@@ -0,0 +1,15 @@
+import { type EntrypointTransport } from '@owlmeans/entrypoint';
+import type { Config, Context } from './types.js';
+/**
+ * The producing half of the bridge: it turns a call on a QUEUE entrypoint into a job, and the
+ * job's outcome back into a reply.
+ *
+ * Registering it is the whole opt-in. `apiHandler` looks up a transport by the route's protocol,
+ * so a consumer writes `ep.call(...)` against a declaration it shares with every other kind of
+ * entrypoint and never learns which one carried it. That is also why the envelope is built from
+ * the request rather than from the entrypoint: the far side rebuilds a request, and anything only
+ * HTTP understands would not survive the trip anyway.
+ */
+export declare const makeQueueTransport: (alias?: string) => EntrypointTransport;
+export declare const appendQueueTransport: <C extends Config, T extends Context<C> = Context<C>>(context: T, alias?: string) => T;
+//# sourceMappingURL=transport.d.ts.map

package/build/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AACA,OAAO,EAA+C,KAAK,mBAAmB,EAA4D,MAAM,sBAAsB,CAAA;AAEtK,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAsC,MAAM,YAAY,CAAA;AAIrF;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,WAAW,MAAM,KAAoC,mBAiDnF,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,WAC7E,CAAC,UAAU,MAAM,KACzB,CAMF,CAAA"}