@webpieces/cloudtasks-client 0.4.893 → 0.4.895

package/src/TaskTypes.js

@@ -1,59 +1,104 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TaskInvoker = exports.TaskRequest = exports.JobReference = exports.ScheduleInfo = void 0;
+exports.TaskInvoker = exports.TaskRequest = exports.EnqueuePlan = exports.JobReference = exports.ScheduleInfo = void 0;
 /**
  * Scheduling options for an enqueued task. Travels out-of-band (via the scheduler
  * frame in RequestContext) so the shared API method signature stays `foo(req)` on
  * both the client and the controller.
  */
 class ScheduleInfo {
-    /** Absolute epoch-millis to run at; omitted = run as soon as possible. */
+    taskName;
     epochMsToRunAt;
-    /** Per-task dispatch deadline in seconds. */
     taskTimeoutSeconds;
-    /**
-     * Deterministic dedup name → the Cloud Task resource name. A second enqueue with
-     * the same name is rejected ALREADY_EXISTS (treated as success = idempotent).
-     */
-    dedupName;
-    constructor(epochMsToRunAt, taskTimeoutSeconds, dedupName) {
+    customizeTask;
+    gax;
+    constructor(
+    /** How the task is named; resolved ONCE per logical enqueue by `TaskProxyClient`. */
+    taskName, 
+    /** Absolute epoch-millis to run at; omitted = run as soon as possible. */
+    epochMsToRunAt, 
+    /** Per-task dispatch deadline in seconds (`task.dispatchDeadline`). */
+    taskTimeoutSeconds, 
+    /** The call site's {@link TaskCustomizer}; wins over `GcpTaskRegistry.setCustomizer`. */
+    customizeTask, 
+    /** The call site's gax `CallOptions`; set ⇒ the caller owns timing for this enqueue. */
+    gax) {
+        this.taskName = taskName;
         this.epochMsToRunAt = epochMsToRunAt;
         this.taskTimeoutSeconds = taskTimeoutSeconds;
-        this.dedupName = dedupName;
+        this.customizeTask = customizeTask;
+        this.gax = gax;
     }
 }
 exports.ScheduleInfo = ScheduleInfo;
-/** Handle to an enqueued task (its Cloud Tasks id), returned by the scheduler. */
+/** Handle to an enqueued task (its Cloud Tasks name), returned by the scheduler. */
 class JobReference {
     taskId;
-    constructor(taskId) {
+    alreadyExisted;
+    constructor(
+    /** The task's full resource name (`projects/.../tasks/<id>`), or the in-memory task id. */
+    taskId, 
+    /**
+     * True when the task already existed (ALREADY_EXISTS): a retry whose earlier attempt landed,
+     * or a `TaskName.dedup` collision. Reported as success, never as an error.
+     */
+    alreadyExisted) {
         this.taskId = taskId;
+        this.alreadyExisted = alreadyExisted;
     }
 }
 exports.JobReference = JobReference;
+/**
+ * What `TaskProxyClient` resolved ONCE for a logical enqueue, before any attempt: the task id every
+ * attempt carries, and the EFFECTIVE customizer and gax options (call site, else `GcpTaskRegistry`
+ * method -> API -> ALL).
+ */
+class EnqueuePlan {
+    taskId;
+    customizeTask;
+    gax;
+    constructor(
+    /** The task id (not the full path); undefined = let Cloud Tasks assign one. */
+    taskId, customizeTask, 
+    /** Set ⇒ the caller owns timing: one attempt, `createTask(request, gax)` as given. */
+    gax) {
+        this.taskId = taskId;
+        this.customizeTask = customizeTask;
+        this.gax = gax;
+    }
+}
+exports.EnqueuePlan = EnqueuePlan;
 /**
  * Everything an invoker needs to enqueue one task. Built by the enqueue proxy from
  * the shared @PubSub contract's decorators + the ambient RequestContext.
  */
 class TaskRequest {
-    /** Callee base URL (e.g. https://email-svc-123.us-central1.run.app). */
     targetUrl;
-    /** Endpoint path the task is delivered to (basePath + endpoint, e.g. /email/send). */
     path;
-    /** Cloud Tasks queue name (getQueueName: @Queue override or `${Api}-${method}`). */
     queueName;
-    /** The request DTO (serialized to the POST body on delivery). */
-    // webpieces-disable no-any-unknown -- request DTO type is erased at the task boundary
     body;
-    /** Context headers to propagate (txId/requestId/tenant…), already resolved. */
     contextHeaders;
-    /** The endpoint's auth mode — how the invoker authenticates delivery. */
     authMode;
-    /** Scheduling options (dedup name, run-at, timeout). */
     scheduleInfo;
-    constructor(targetUrl, path, queueName, 
+    plan;
+    constructor(
+    /** Callee base URL (e.g. https://email-svc-123.us-central1.run.app). */
+    targetUrl, 
+    /** Endpoint path the task is delivered to (basePath + endpoint, e.g. /email/send). */
+    path, 
+    /** Cloud Tasks queue name (getQueueName: @Queue override or `${Api}-${method}`). */
+    queueName, 
+    /** The request DTO (serialized to the POST body on delivery). */
     // webpieces-disable no-any-unknown -- request DTO type is erased at the task boundary
-    body, contextHeaders, authMode, scheduleInfo) {
+    body, 
+    /** Context headers to propagate (txId/requestId/tenant…), already resolved. */
+    contextHeaders, 
+    /** The endpoint's auth mode — how the invoker authenticates delivery. */
+    authMode, 
+    /** Scheduling options (run-at, dispatch deadline). */
+    scheduleInfo, 
+    /** The resolved name, customizer and gax for this logical enqueue. */
+    plan) {
         this.targetUrl = targetUrl;
         this.path = path;
         this.queueName = queueName;
@@ -61,6 +106,7 @@ class TaskRequest {
         this.contextHeaders = contextHeaders;
         this.authMode = authMode;
         this.scheduleInfo = scheduleInfo;
+        this.plan = plan;
     }
 }
 exports.TaskRequest = TaskRequest;
@@ -70,6 +116,10 @@ exports.TaskRequest = TaskRequest;
  * InMemoryTaskInvoker in tests/local dev. Both deliver a task the same way — a plain
  * HTTP POST to `targetUrl + path` — GcpTaskInvoker via Google Cloud Tasks, and
  * InMemoryTaskInvoker via an in-process queue that fetches the target directly.
+ *
+ * An invoker performs ONE attempt and never retries: retries belong to `CallRegistry` (webpieces'
+ * `RetryStrategy` by default) or, when `plan.gax` is set, to gax. It throws
+ * `TaskAlreadyExistsError` for a name that already exists.
  */
 class TaskInvoker {
     selectAuthentication(meta) {

package/src/TaskTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"TaskTypes.js","sourceRoot":"","sources":["../../../../../packages/cloud/cloudtasks-client/src/TaskTypes.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAa,YAAY;IACrB,0EAA0E;IAC1E,cAAc,CAAU;IACxB,6CAA6C;IAC7C,kBAAkB,CAAU;IAC5B;;;OAGG;IACH,SAAS,CAAU;IAEnB,YAAY,cAAuB,EAAE,kBAA2B,EAAE,SAAkB;QAChF,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;CACJ;AAhBD,oCAgBC;AAED,kFAAkF;AAClF,MAAa,YAAY;IACrB,MAAM,CAAS;IAEf,YAAY,MAAc;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;CACJ;AAND,oCAMC;AAED;;;GAGG;AACH,MAAa,WAAW;IACpB,wEAAwE;IACxE,SAAS,CAAS;IAClB,sFAAsF;IACtF,IAAI,CAAS;IACb,oFAAoF;IACpF,SAAS,CAAS;IAClB,iEAAiE;IACjE,sFAAsF;IACtF,IAAI,CAAU;IACd,+EAA+E;IAC/E,cAAc,CAAsB;IACpC,yEAAyE;IACzE,QAAQ,CAAW;IACnB,wDAAwD;IACxD,YAAY,CAAe;IAE3B,YACI,SAAiB,EACjB,IAAY,EACZ,SAAiB;IACjB,sFAAsF;IACtF,IAAa,EACb,cAAmC,EACnC,QAAkB,EAClB,YAA0B;QAE1B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACrC,CAAC;CACJ;AAnCD,kCAmCC;AAED;;;;;;GAMG;AACH,MAAsB,WAAW;IAC7B,oBAAoB,CAAC,IAA6C;QAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAgB,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAC7G,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IACjG,CAAC;CAGJ;AATD,kCASC","sourcesContent":["import { AuthMode } from '@webpieces/core-util';\n\n/**\n * Scheduling options for an enqueued task. Travels out-of-band (via the scheduler\n * frame in RequestContext) so the shared API method signature stays `foo(req)` on\n * both the client and the controller.\n */\nexport class ScheduleInfo {\n    /** Absolute epoch-millis to run at; omitted = run as soon as possible. */\n    epochMsToRunAt?: number;\n    /** Per-task dispatch deadline in seconds. */\n    taskTimeoutSeconds?: number;\n    /**\n     * Deterministic dedup name → the Cloud Task resource name. A second enqueue with\n     * the same name is rejected ALREADY_EXISTS (treated as success = idempotent).\n     */\n    dedupName?: string;\n\n    constructor(epochMsToRunAt?: number, taskTimeoutSeconds?: number, dedupName?: string) {\n        this.epochMsToRunAt = epochMsToRunAt;\n        this.taskTimeoutSeconds = taskTimeoutSeconds;\n        this.dedupName = dedupName;\n    }\n}\n\n/** Handle to an enqueued task (its Cloud Tasks id), returned by the scheduler. */\nexport class JobReference {\n    taskId: string;\n\n    constructor(taskId: string) {\n        this.taskId = taskId;\n    }\n}\n\n/**\n * Everything an invoker needs to enqueue one task. Built by the enqueue proxy from\n * the shared @PubSub contract's decorators + the ambient RequestContext.\n */\nexport class TaskRequest {\n    /** Callee base URL (e.g. https://email-svc-123.us-central1.run.app). */\n    targetUrl: string;\n    /** Endpoint path the task is delivered to (basePath + endpoint, e.g. /email/send). */\n    path: string;\n    /** Cloud Tasks queue name (getQueueName: @Queue override or `${Api}-${method}`). */\n    queueName: string;\n    /** The request DTO (serialized to the POST body on delivery). */\n    // webpieces-disable no-any-unknown -- request DTO type is erased at the task boundary\n    body: unknown;\n    /** Context headers to propagate (txId/requestId/tenant…), already resolved. */\n    contextHeaders: Map<string, string>;\n    /** The endpoint's auth mode — how the invoker authenticates delivery. */\n    authMode: AuthMode;\n    /** Scheduling options (dedup name, run-at, timeout). */\n    scheduleInfo: ScheduleInfo;\n\n    constructor(\n        targetUrl: string,\n        path: string,\n        queueName: string,\n        // webpieces-disable no-any-unknown -- request DTO type is erased at the task boundary\n        body: unknown,\n        contextHeaders: Map<string, string>,\n        authMode: AuthMode,\n        scheduleInfo: ScheduleInfo,\n    ) {\n        this.targetUrl = targetUrl;\n        this.path = path;\n        this.queueName = queueName;\n        this.body = body;\n        this.contextHeaders = contextHeaders;\n        this.authMode = authMode;\n        this.scheduleInfo = scheduleInfo;\n    }\n}\n\n/**\n * The transport that actually enqueues a task. Abstract class so it doubles as the\n * inversify DI token (inject by type, no Symbol). Bind GcpTaskInvoker in prod or\n * InMemoryTaskInvoker in tests/local dev. Both deliver a task the same way — a plain\n * HTTP POST to `targetUrl + path` — GcpTaskInvoker via Google Cloud Tasks, and\n * InMemoryTaskInvoker via an in-process queue that fetches the target directly.\n */\nexport abstract class TaskInvoker {\n    selectAuthentication(meta: import('@webpieces/core-util').AuthMeta): AuthMode {\n        const selected = meta.methods.find((method: AuthMode) => method.kind === 'oidc' || method.kind === 'public');\n        if (selected) return selected;\n        if (meta.methods.length === 1) return meta.methods[0];\n        throw new Error('No configured Cloud Tasks credential satisfies the declared alternatives.');\n    }\n    abstract enqueue(request: TaskRequest): Promise<JobReference>;\n    abstract delete(ref: JobReference): Promise<void>;\n}\n"]}
+{"version":3,"file":"TaskTypes.js","sourceRoot":"","sources":["../../../../../packages/cloud/cloudtasks-client/src/TaskTypes.ts"],"names":[],"mappings":";;;AAoBA;;;;GAIG;AACH,MAAa,YAAY;IAGR;IAEA;IAEA;IAEA;IAEA;IAVb;IACI,qFAAqF;IAC5E,QAAkB;IAC3B,0EAA0E;IACjE,cAAuB;IAChC,uEAAuE;IAC9D,kBAA2B;IACpC,yFAAyF;IAChF,aAA8B;IACvC,wFAAwF;IAC/E,GAAiB;QARjB,aAAQ,GAAR,QAAQ,CAAU;QAElB,mBAAc,GAAd,cAAc,CAAS;QAEvB,uBAAkB,GAAlB,kBAAkB,CAAS;QAE3B,kBAAa,GAAb,aAAa,CAAiB;QAE9B,QAAG,GAAH,GAAG,CAAc;IAC3B,CAAC;CACP;AAbD,oCAaC;AAED,oFAAoF;AACpF,MAAa,YAAY;IAGR;IAKA;IAPb;IACI,2FAA2F;IAClF,MAAc;IACvB;;;OAGG;IACM,cAAuB;QALvB,WAAM,GAAN,MAAM,CAAQ;QAKd,mBAAc,GAAd,cAAc,CAAS;IACjC,CAAC;CACP;AAVD,oCAUC;AAED;;;;GAIG;AACH,MAAa,WAAW;IAGP;IACA;IAEA;IALb;IACI,+EAA+E;IACtE,MAA0B,EAC1B,aAA8B;IACvC,sFAAsF;IAC7E,GAAiB;QAHjB,WAAM,GAAN,MAAM,CAAoB;QAC1B,kBAAa,GAAb,aAAa,CAAiB;QAE9B,QAAG,GAAH,GAAG,CAAc;IAC3B,CAAC;CACP;AARD,kCAQC;AAED;;;GAGG;AACH,MAAa,WAAW;IAGP;IAEA;IAEA;IAGA;IAEA;IAEA;IAEA;IAEA;IAjBb;IACI,wEAAwE;IAC/D,SAAiB;IAC1B,sFAAsF;IAC7E,IAAY;IACrB,oFAAoF;IAC3E,SAAiB;IAC1B,iEAAiE;IACjE,sFAAsF;IAC7E,IAAa;IACtB,+EAA+E;IACtE,cAAmC;IAC5C,yEAAyE;IAChE,QAAkB;IAC3B,sDAAsD;IAC7C,YAA0B;IACnC,sEAAsE;IAC7D,IAAiB;QAfjB,cAAS,GAAT,SAAS,CAAQ;QAEjB,SAAI,GAAJ,IAAI,CAAQ;QAEZ,cAAS,GAAT,SAAS,CAAQ;QAGjB,SAAI,GAAJ,IAAI,CAAS;QAEb,mBAAc,GAAd,cAAc,CAAqB;QAEnC,aAAQ,GAAR,QAAQ,CAAU;QAElB,iBAAY,GAAZ,YAAY,CAAc;QAE1B,SAAI,GAAJ,IAAI,CAAa;IAC3B,CAAC;CACP;AApBD,kCAoBC;AAED;;;;;;;;;;GAUG;AACH,MAAsB,WAAW;IAC7B,oBAAoB,CAAC,IAAc;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAgB,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAC7G,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IACjG,CAAC;CAYJ;AAlBD,kCAkBC","sourcesContent":["import { AuthMeta, AuthMode } from '@webpieces/core-util';\nimport type { protos } from '@google-cloud/tasks';\nimport type { CallOptions } from 'google-gax';\nimport { TaskName } from './TaskName';\n\n/** The Google `CreateTask` request: `{ parent, task }`, built by webpieces on every attempt. */\nexport type ICreateTaskRequest = protos.google.cloud.tasks.v2.ICreateTaskRequest;\n\n/**\n * Changes the Google request of ONE enqueue attempt. It runs on every attempt, LAST, on a freshly\n * built `ICreateTaskRequest` (url, body, headers, auth, name, scheduleTime and dispatchDeadline are\n * already set) and returns the request to send — the same object mutated, or a new one.\n *\n * It is Google-request-only and never touches timing: gax `CallOptions` are\n * `ScheduleOptions.gax` / `GcpTaskRegistry.setGax`. If it changes `task.name`, it must stay under the\n * same queue path and return the same name on every attempt, or webpieces' own retries can create\n * duplicates. The in-memory invoker has no Google request and ignores it.\n */\nexport type TaskCustomizer = (request: ICreateTaskRequest) => ICreateTaskRequest;\n\n/**\n * Scheduling options for an enqueued task. Travels out-of-band (via the scheduler\n * frame in RequestContext) so the shared API method signature stays `foo(req)` on\n * both the client and the controller.\n */\nexport class ScheduleInfo {\n    constructor(\n        /** How the task is named; resolved ONCE per logical enqueue by `TaskProxyClient`. */\n        readonly taskName: TaskName,\n        /** Absolute epoch-millis to run at; omitted = run as soon as possible. */\n        readonly epochMsToRunAt?: number,\n        /** Per-task dispatch deadline in seconds (`task.dispatchDeadline`). */\n        readonly taskTimeoutSeconds?: number,\n        /** The call site's {@link TaskCustomizer}; wins over `GcpTaskRegistry.setCustomizer`. */\n        readonly customizeTask?: TaskCustomizer,\n        /** The call site's gax `CallOptions`; set ⇒ the caller owns timing for this enqueue. */\n        readonly gax?: CallOptions,\n    ) {}\n}\n\n/** Handle to an enqueued task (its Cloud Tasks name), returned by the scheduler. */\nexport class JobReference {\n    constructor(\n        /** The task's full resource name (`projects/.../tasks/<id>`), or the in-memory task id. */\n        readonly taskId: string,\n        /**\n         * True when the task already existed (ALREADY_EXISTS): a retry whose earlier attempt landed,\n         * or a `TaskName.dedup` collision. Reported as success, never as an error.\n         */\n        readonly alreadyExisted: boolean,\n    ) {}\n}\n\n/**\n * What `TaskProxyClient` resolved ONCE for a logical enqueue, before any attempt: the task id every\n * attempt carries, and the EFFECTIVE customizer and gax options (call site, else `GcpTaskRegistry`\n * method -> API -> ALL).\n */\nexport class EnqueuePlan {\n    constructor(\n        /** The task id (not the full path); undefined = let Cloud Tasks assign one. */\n        readonly taskId: string | undefined,\n        readonly customizeTask?: TaskCustomizer,\n        /** Set ⇒ the caller owns timing: one attempt, `createTask(request, gax)` as given. */\n        readonly gax?: CallOptions,\n    ) {}\n}\n\n/**\n * Everything an invoker needs to enqueue one task. Built by the enqueue proxy from\n * the shared @PubSub contract's decorators + the ambient RequestContext.\n */\nexport class TaskRequest {\n    constructor(\n        /** Callee base URL (e.g. https://email-svc-123.us-central1.run.app). */\n        readonly targetUrl: string,\n        /** Endpoint path the task is delivered to (basePath + endpoint, e.g. /email/send). */\n        readonly path: string,\n        /** Cloud Tasks queue name (getQueueName: @Queue override or `${Api}-${method}`). */\n        readonly queueName: string,\n        /** The request DTO (serialized to the POST body on delivery). */\n        // webpieces-disable no-any-unknown -- request DTO type is erased at the task boundary\n        readonly body: unknown,\n        /** Context headers to propagate (txId/requestId/tenant…), already resolved. */\n        readonly contextHeaders: Map<string, string>,\n        /** The endpoint's auth mode — how the invoker authenticates delivery. */\n        readonly authMode: AuthMode,\n        /** Scheduling options (run-at, dispatch deadline). */\n        readonly scheduleInfo: ScheduleInfo,\n        /** The resolved name, customizer and gax for this logical enqueue. */\n        readonly plan: EnqueuePlan,\n    ) {}\n}\n\n/**\n * The transport that actually enqueues a task. Abstract class so it doubles as the\n * inversify DI token (inject by type, no Symbol). Bind GcpTaskInvoker in prod or\n * InMemoryTaskInvoker in tests/local dev. Both deliver a task the same way — a plain\n * HTTP POST to `targetUrl + path` — GcpTaskInvoker via Google Cloud Tasks, and\n * InMemoryTaskInvoker via an in-process queue that fetches the target directly.\n *\n * An invoker performs ONE attempt and never retries: retries belong to `CallRegistry` (webpieces'\n * `RetryStrategy` by default) or, when `plan.gax` is set, to gax. It throws\n * `TaskAlreadyExistsError` for a name that already exists.\n */\nexport abstract class TaskInvoker {\n    selectAuthentication(meta: AuthMeta): AuthMode {\n        const selected = meta.methods.find((method: AuthMode) => method.kind === 'oidc' || method.kind === 'public');\n        if (selected) return selected;\n        if (meta.methods.length === 1) return meta.methods[0];\n        throw new Error('No configured Cloud Tasks credential satisfies the declared alternatives.');\n    }\n\n    /**\n     * Enqueue ONE attempt.\n     *\n     * @param request - the task, including the resolved {@link EnqueuePlan}\n     * @param timeoutMs - this attempt's deadline (webpieces' attempt timeout, or the safety cap when\n     *   the caller owns timing); the GCP invoker sends it as the gRPC deadline\n     * @param signal - aborted when the attempt's deadline fires\n     */\n    abstract enqueue(request: TaskRequest, timeoutMs: number, signal: AbortSignal): Promise<JobReference>;\n    abstract delete(ref: JobReference): Promise<void>;\n}\n"]}

package/src/__tests__/FakeCloudTasksServer.d.ts

@@ -0,0 +1,51 @@
+/** What the fake server does with ONE createTask call. */
+export declare enum FakeBehavior {
+    /** Answer the task (named as sent, or server-assigned). */
+    OK = "ok",
+    /** UNAVAILABLE (14) — what grpc-js surfaces for a connection reset. */
+    RESET = "reset",
+    /** ALREADY_EXISTS (6). */
+    ALREADY_EXISTS = "already-exists",
+    /** Never answer: only the client's deadline can end the call. */
+    SILENT = "silent"
+}
+/** One createTask the fake server received, as it arrived on the wire. */
+export declare class ReceivedCreateTask {
+    /** `task.name` exactly as sent; '' or undefined when the client sent none. */
+    readonly taskName: string | undefined;
+    /** Milliseconds left on the gRPC deadline when the call arrived (Infinity = none sent). */
+    readonly deadlineMs: number;
+    /** `task.dispatchDeadline.seconds`, if the request carried one. */
+    readonly dispatchDeadlineSeconds: string | undefined;
+    /** `task.httpRequest.headers`. */
+    readonly headers: Record<string, string>;
+    cancelled: boolean;
+    constructor(
+    /** `task.name` exactly as sent; '' or undefined when the client sent none. */
+    taskName: string | undefined, 
+    /** Milliseconds left on the gRPC deadline when the call arrived (Infinity = none sent). */
+    deadlineMs: number, 
+    /** `task.dispatchDeadline.seconds`, if the request carried one. */
+    dispatchDeadlineSeconds: string | undefined, 
+    /** `task.httpRequest.headers`. */
+    headers: Record<string, string>);
+}
+/**
+ * A LOCAL Cloud Tasks v2 gRPC server: the real `CloudTasksClient` (and therefore real gax and real
+ * grpc-js) talks to it over a real socket, so what it records is what actually went on the wire —
+ * the task name, the gRPC deadline of EVERY attempt, the request the customizer produced.
+ *
+ * It loads the CloudTasks v2 protos shipped inside `@google-cloud/tasks` (plus gax's common protos)
+ * and implements only `CreateTask`; each call consumes the next {@link FakeBehavior} in `script`.
+ */
+export declare class FakeCloudTasksServer {
+    readonly received: ReceivedCreateTask[];
+    script: FakeBehavior[];
+    port: number;
+    private readonly server;
+    start(): Promise<void>;
+    /** Every listener and every open call closed, so the suite is clean under --detectOpenHandles. */
+    stop(): void;
+    private serviceDefinition;
+    private createTask;
+}

package/src/__tests__/FakeCloudTasksServer.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FakeCloudTasksServer = exports.ReceivedCreateTask = exports.FakeBehavior = void 0;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+const module_1 = require("module");
+const grpc = tslib_1.__importStar(require("@grpc/grpc-js"));
+const protoLoader = tslib_1.__importStar(require("@grpc/proto-loader"));
+/** What the fake server does with ONE createTask call. */
+var FakeBehavior;
+(function (FakeBehavior) {
+    /** Answer the task (named as sent, or server-assigned). */
+    FakeBehavior["OK"] = "ok";
+    /** UNAVAILABLE (14) — what grpc-js surfaces for a connection reset. */
+    FakeBehavior["RESET"] = "reset";
+    /** ALREADY_EXISTS (6). */
+    FakeBehavior["ALREADY_EXISTS"] = "already-exists";
+    /** Never answer: only the client's deadline can end the call. */
+    FakeBehavior["SILENT"] = "silent";
+})(FakeBehavior || (exports.FakeBehavior = FakeBehavior = {}));
+/** One createTask the fake server received, as it arrived on the wire. */
+class ReceivedCreateTask {
+    taskName;
+    deadlineMs;
+    dispatchDeadlineSeconds;
+    headers;
+    cancelled = false;
+    constructor(
+    /** `task.name` exactly as sent; '' or undefined when the client sent none. */
+    taskName, 
+    /** Milliseconds left on the gRPC deadline when the call arrived (Infinity = none sent). */
+    deadlineMs, 
+    /** `task.dispatchDeadline.seconds`, if the request carried one. */
+    dispatchDeadlineSeconds, 
+    /** `task.httpRequest.headers`. */
+    headers) {
+        this.taskName = taskName;
+        this.deadlineMs = deadlineMs;
+        this.dispatchDeadlineSeconds = dispatchDeadlineSeconds;
+        this.headers = headers;
+    }
+}
+exports.ReceivedCreateTask = ReceivedCreateTask;
+/* eslint-enable @typescript-eslint/no-explicit-any */
+/**
+ * A LOCAL Cloud Tasks v2 gRPC server: the real `CloudTasksClient` (and therefore real gax and real
+ * grpc-js) talks to it over a real socket, so what it records is what actually went on the wire —
+ * the task name, the gRPC deadline of EVERY attempt, the request the customizer produced.
+ *
+ * It loads the CloudTasks v2 protos shipped inside `@google-cloud/tasks` (plus gax's common protos)
+ * and implements only `CreateTask`; each call consumes the next {@link FakeBehavior} in `script`.
+ */
+class FakeCloudTasksServer {
+    received = [];
+    script = [];
+    port = 0;
+    server = new grpc.Server();
+    async start() {
+        const localRequire = (0, module_1.createRequire)(__filename);
+        // .../@google-cloud/tasks/build/cjs/src/index.cjs -> .../build/protos
+        const tasksProtos = path.resolve(path.dirname(localRequire.resolve('@google-cloud/tasks')), '../../protos');
+        // .../google-gax/build/src/index.js -> .../build/protos (google/api, google/rpc, ...)
+        const gaxProtos = path.resolve(path.dirname(localRequire.resolve('google-gax')), '../protos');
+        const definition = protoLoader.loadSync('google/cloud/tasks/v2/cloudtasks.proto', {
+            includeDirs: [tasksProtos, gaxProtos],
+            keepCase: false,
+            longs: String,
+            enums: String,
+            defaults: false,
+            oneofs: true,
+        });
+        const loaded = grpc.loadPackageDefinition(definition);
+        const service = this.serviceDefinition(loaded);
+        this.server.addService(service, {
+            createTask: (call, callback) => this.createTask(call, callback),
+        });
+        this.port = await new Promise((resolve, reject) => {
+            this.server.bindAsync('127.0.0.1:0', grpc.ServerCredentials.createInsecure(), (error, port) => (error ? reject(error) : resolve(port)));
+        });
+    }
+    /** Every listener and every open call closed, so the suite is clean under --detectOpenHandles. */
+    stop() {
+        this.server.forceShutdown();
+    }
+    serviceDefinition(loaded) {
+        const google = loaded['google'];
+        const cloud = google['cloud'];
+        const tasks = cloud['tasks'];
+        const v2 = tasks['v2'];
+        const client = v2['CloudTasks'];
+        return client.service;
+    }
+    createTask(call, callback) {
+        const deadline = call.getDeadline();
+        const deadlineMs = deadline instanceof Date ? deadline.getTime() - Date.now() : Number(deadline) - Date.now();
+        const task = call.request.task ?? {};
+        const received = new ReceivedCreateTask(task.name, Number.isFinite(deadlineMs) ? deadlineMs : Infinity, task.dispatchDeadline?.seconds, task.httpRequest?.headers ?? {});
+        this.received.push(received);
+        call.on('cancelled', () => {
+            received.cancelled = true;
+        });
+        const behavior = this.script.shift() ?? FakeBehavior.OK;
+        switch (behavior) {
+            case FakeBehavior.OK:
+                callback(null, {
+                    name: task.name || `${call.request.parent}/tasks/server-assigned-${this.received.length}`,
+                });
+                return;
+            case FakeBehavior.RESET:
+                callback({ code: grpc.status.UNAVAILABLE, details: 'read ECONNRESET' });
+                return;
+            case FakeBehavior.ALREADY_EXISTS:
+                callback({ code: grpc.status.ALREADY_EXISTS, details: 'The task cannot be created because a task with this name existed too recently.' });
+                return;
+            case FakeBehavior.SILENT:
+                return;
+        }
+    }
+}
+exports.FakeCloudTasksServer = FakeCloudTasksServer;
+//# sourceMappingURL=FakeCloudTasksServer.js.map

package/src/__tests__/FakeCloudTasksServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FakeCloudTasksServer.js","sourceRoot":"","sources":["../../../../../../packages/cloud/cloudtasks-client/src/__tests__/FakeCloudTasksServer.ts"],"names":[],"mappings":"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","sourcesContent":["import * as path from 'path';\nimport { createRequire } from 'module';\nimport * as grpc from '@grpc/grpc-js';\nimport * as protoLoader from '@grpc/proto-loader';\n\n/** What the fake server does with ONE createTask call. */\nexport enum FakeBehavior {\n    /** Answer the task (named as sent, or server-assigned). */\n    OK = 'ok',\n    /** UNAVAILABLE (14) — what grpc-js surfaces for a connection reset. */\n    RESET = 'reset',\n    /** ALREADY_EXISTS (6). */\n    ALREADY_EXISTS = 'already-exists',\n    /** Never answer: only the client's deadline can end the call. */\n    SILENT = 'silent',\n}\n\n/** One createTask the fake server received, as it arrived on the wire. */\nexport class ReceivedCreateTask {\n    cancelled = false;\n\n    constructor(\n        /** `task.name` exactly as sent; '' or undefined when the client sent none. */\n        readonly taskName: string | undefined,\n        /** Milliseconds left on the gRPC deadline when the call arrived (Infinity = none sent). */\n        readonly deadlineMs: number,\n        /** `task.dispatchDeadline.seconds`, if the request carried one. */\n        readonly dispatchDeadlineSeconds: string | undefined,\n        /** `task.httpRequest.headers`. */\n        readonly headers: Record<string, string>,\n    ) {}\n}\n\n/* eslint-disable @typescript-eslint/no-explicit-any -- grpc-js handler payloads are untyped proto objects */\n// webpieces-disable no-any-unknown -- grpc-js unary handler payloads are untyped proto-loader objects\ntype UnaryCall = grpc.ServerUnaryCall<any, any>;\n// webpieces-disable no-any-unknown -- grpc-js unary handler payloads are untyped proto-loader objects\ntype UnaryCallback = grpc.sendUnaryData<any>;\n/* eslint-enable @typescript-eslint/no-explicit-any */\n\n/**\n * A LOCAL Cloud Tasks v2 gRPC server: the real `CloudTasksClient` (and therefore real gax and real\n * grpc-js) talks to it over a real socket, so what it records is what actually went on the wire —\n * the task name, the gRPC deadline of EVERY attempt, the request the customizer produced.\n *\n * It loads the CloudTasks v2 protos shipped inside `@google-cloud/tasks` (plus gax's common protos)\n * and implements only `CreateTask`; each call consumes the next {@link FakeBehavior} in `script`.\n */\nexport class FakeCloudTasksServer {\n    readonly received: ReceivedCreateTask[] = [];\n    script: FakeBehavior[] = [];\n    port = 0;\n    private readonly server = new grpc.Server();\n\n    async start(): Promise<void> {\n        const localRequire = createRequire(__filename);\n        // .../@google-cloud/tasks/build/cjs/src/index.cjs -> .../build/protos\n        const tasksProtos = path.resolve(path.dirname(localRequire.resolve('@google-cloud/tasks')), '../../protos');\n        // .../google-gax/build/src/index.js -> .../build/protos (google/api, google/rpc, ...)\n        const gaxProtos = path.resolve(path.dirname(localRequire.resolve('google-gax')), '../protos');\n        const definition = protoLoader.loadSync('google/cloud/tasks/v2/cloudtasks.proto', {\n            includeDirs: [tasksProtos, gaxProtos],\n            keepCase: false,\n            longs: String,\n            enums: String,\n            defaults: false,\n            oneofs: true,\n        });\n        const loaded = grpc.loadPackageDefinition(definition);\n        const service = this.serviceDefinition(loaded);\n        this.server.addService(service, {\n            createTask: (call: UnaryCall, callback: UnaryCallback) => this.createTask(call, callback),\n        });\n        this.port = await new Promise<number>(\n            (resolve: (port: number) => void, reject: (error: Error) => void) => {\n                this.server.bindAsync(\n                    '127.0.0.1:0',\n                    grpc.ServerCredentials.createInsecure(),\n                    (error: Error | null, port: number) => (error ? reject(error) : resolve(port)),\n                );\n            },\n        );\n    }\n\n    /** Every listener and every open call closed, so the suite is clean under --detectOpenHandles. */\n    stop(): void {\n        this.server.forceShutdown();\n    }\n\n    private serviceDefinition(loaded: grpc.GrpcObject): grpc.ServiceDefinition {\n        const google = loaded['google'] as grpc.GrpcObject;\n        const cloud = google['cloud'] as grpc.GrpcObject;\n        const tasks = cloud['tasks'] as grpc.GrpcObject;\n        const v2 = tasks['v2'] as grpc.GrpcObject;\n        const client = v2['CloudTasks'] as grpc.ServiceClientConstructor;\n        return client.service;\n    }\n\n    private createTask(call: UnaryCall, callback: UnaryCallback): void {\n        const deadline = call.getDeadline();\n        const deadlineMs =\n            deadline instanceof Date ? deadline.getTime() - Date.now() : Number(deadline) - Date.now();\n        const task = call.request.task ?? {};\n        const received = new ReceivedCreateTask(\n            task.name,\n            Number.isFinite(deadlineMs) ? deadlineMs : Infinity,\n            task.dispatchDeadline?.seconds,\n            task.httpRequest?.headers ?? {},\n        );\n        this.received.push(received);\n        call.on('cancelled', () => {\n            received.cancelled = true;\n        });\n        const behavior = this.script.shift() ?? FakeBehavior.OK;\n        switch (behavior) {\n            case FakeBehavior.OK:\n                callback(null, {\n                    name: task.name || `${call.request.parent}/tasks/server-assigned-${this.received.length}`,\n                });\n                return;\n            case FakeBehavior.RESET:\n                callback({ code: grpc.status.UNAVAILABLE, details: 'read ECONNRESET' });\n                return;\n            case FakeBehavior.ALREADY_EXISTS:\n                callback({ code: grpc.status.ALREADY_EXISTS, details: 'The task cannot be created because a task with this name existed too recently.' });\n                return;\n            case FakeBehavior.SILENT:\n                return;\n        }\n    }\n}\n"]}

package/src/index.d.ts

@@ -6,7 +6,12 @@
  * share ONE abstract API class; calling a method enqueues a task that is later
  * delivered to the same endpoint through the full server filter chain.
  */
-export { ScheduleInfo, JobReference, TaskRequest, TaskInvoker } from './TaskTypes';
+export { ScheduleInfo, JobReference, TaskRequest, TaskInvoker, EnqueuePlan } from './TaskTypes';
+export type { TaskCustomizer, ICreateTaskRequest } from './TaskTypes';
+export { TaskName } from './TaskName';
+export { TaskAlreadyExistsError } from './TaskAlreadyExistsError';
+export { GcpTaskRegistry } from './GcpTaskRegistry';
+export { GrpcErrorMapper } from './GrpcErrorMapper';
 export { ClientCloudTasksFactory } from './ClientCloudTasksFactory';
 export { TaskProxyClient, TASK_PROXY_CLIENT_PROVIDER } from './TaskProxyClient';
 export { TaskClientConfig } from './TaskClientConfig';
@@ -14,4 +19,5 @@ export type { ApiPrototype } from './TaskClientConfig';
 export { CloudTaskScheduler, ScheduleOptions } from './CloudTaskScheduler';
 export { InMemoryTaskInvoker } from './InMemoryTaskInvoker';
 export { GcpTaskInvoker } from './GcpTaskInvoker';
+export { CloudTasksClientProvider } from './CloudTasksClientProvider';
 export { ScheduleFrame, setScheduleFrame, currentScheduleFrame, clearScheduleFrame, } from './ScheduleContext';

package/src/index.js

@@ -8,12 +8,21 @@
  * delivered to the same endpoint through the full server filter chain.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.clearScheduleFrame = exports.currentScheduleFrame = exports.setScheduleFrame = exports.ScheduleFrame = exports.GcpTaskInvoker = exports.InMemoryTaskInvoker = exports.ScheduleOptions = exports.CloudTaskScheduler = exports.TaskClientConfig = exports.TASK_PROXY_CLIENT_PROVIDER = exports.TaskProxyClient = exports.ClientCloudTasksFactory = exports.TaskInvoker = exports.TaskRequest = exports.JobReference = exports.ScheduleInfo = void 0;
+exports.clearScheduleFrame = exports.currentScheduleFrame = exports.setScheduleFrame = exports.ScheduleFrame = exports.CloudTasksClientProvider = exports.GcpTaskInvoker = exports.InMemoryTaskInvoker = exports.ScheduleOptions = exports.CloudTaskScheduler = exports.TaskClientConfig = exports.TASK_PROXY_CLIENT_PROVIDER = exports.TaskProxyClient = exports.ClientCloudTasksFactory = exports.GrpcErrorMapper = exports.GcpTaskRegistry = exports.TaskAlreadyExistsError = exports.TaskName = exports.EnqueuePlan = exports.TaskInvoker = exports.TaskRequest = exports.JobReference = exports.ScheduleInfo = void 0;
 var TaskTypes_1 = require("./TaskTypes");
 Object.defineProperty(exports, "ScheduleInfo", { enumerable: true, get: function () { return TaskTypes_1.ScheduleInfo; } });
 Object.defineProperty(exports, "JobReference", { enumerable: true, get: function () { return TaskTypes_1.JobReference; } });
 Object.defineProperty(exports, "TaskRequest", { enumerable: true, get: function () { return TaskTypes_1.TaskRequest; } });
 Object.defineProperty(exports, "TaskInvoker", { enumerable: true, get: function () { return TaskTypes_1.TaskInvoker; } });
+Object.defineProperty(exports, "EnqueuePlan", { enumerable: true, get: function () { return TaskTypes_1.EnqueuePlan; } });
+var TaskName_1 = require("./TaskName");
+Object.defineProperty(exports, "TaskName", { enumerable: true, get: function () { return TaskName_1.TaskName; } });
+var TaskAlreadyExistsError_1 = require("./TaskAlreadyExistsError");
+Object.defineProperty(exports, "TaskAlreadyExistsError", { enumerable: true, get: function () { return TaskAlreadyExistsError_1.TaskAlreadyExistsError; } });
+var GcpTaskRegistry_1 = require("./GcpTaskRegistry");
+Object.defineProperty(exports, "GcpTaskRegistry", { enumerable: true, get: function () { return GcpTaskRegistry_1.GcpTaskRegistry; } });
+var GrpcErrorMapper_1 = require("./GrpcErrorMapper");
+Object.defineProperty(exports, "GrpcErrorMapper", { enumerable: true, get: function () { return GrpcErrorMapper_1.GrpcErrorMapper; } });
 var ClientCloudTasksFactory_1 = require("./ClientCloudTasksFactory");
 Object.defineProperty(exports, "ClientCloudTasksFactory", { enumerable: true, get: function () { return ClientCloudTasksFactory_1.ClientCloudTasksFactory; } });
 var TaskProxyClient_1 = require("./TaskProxyClient");
@@ -29,6 +38,9 @@ var InMemoryTaskInvoker_1 = require("./InMemoryTaskInvoker");
 Object.defineProperty(exports, "InMemoryTaskInvoker", { enumerable: true, get: function () { return InMemoryTaskInvoker_1.InMemoryTaskInvoker; } });
 var GcpTaskInvoker_1 = require("./GcpTaskInvoker");
 Object.defineProperty(exports, "GcpTaskInvoker", { enumerable: true, get: function () { return GcpTaskInvoker_1.GcpTaskInvoker; } });
+// Process-wide CloudTasksClient settings (keepalive, endpoint): override this provider at startup.
+var CloudTasksClientProvider_1 = require("./CloudTasksClientProvider");
+Object.defineProperty(exports, "CloudTasksClientProvider", { enumerable: true, get: function () { return CloudTasksClientProvider_1.CloudTasksClientProvider; } });
 // NOTE: server-side delivery-auth is enforced by the framework AuthFilter (AuthMode-driven)
 // in @webpieces/http-routing — a client library has no server filters / routing machinery.
 var ScheduleContext_1 = require("./ScheduleContext");

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/cloud/cloudtasks-client/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,yCAAmF;AAA1E,yGAAA,YAAY,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,wGAAA,WAAW,OAAA;AAC7D,qEAAoE;AAA3D,kIAAA,uBAAuB,OAAA;AAChC,qDAAgF;AAAvE,kHAAA,eAAe,OAAA;AAAE,6HAAA,0BAA0B,OAAA;AACpD,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AAEzB,2DAA2E;AAAlE,wHAAA,kBAAkB,OAAA;AAAE,qHAAA,eAAe,OAAA;AAC5C,2FAA2F;AAC3F,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,4FAA4F;AAC5F,2FAA2F;AAC3F,qDAK2B;AAJvB,gHAAA,aAAa,OAAA;AACb,mHAAA,gBAAgB,OAAA;AAChB,uHAAA,oBAAoB,OAAA;AACpB,qHAAA,kBAAkB,OAAA","sourcesContent":["/**\n * @webpieces/cloudtasks-client\n *\n * Cloud Tasks enqueue client generated from a shared @PubSub API contract — the\n * fire-and-forget twin of @webpieces/http-client. The client and the controller\n * share ONE abstract API class; calling a method enqueues a task that is later\n * delivered to the same endpoint through the full server filter chain.\n */\n\nexport { ScheduleInfo, JobReference, TaskRequest, TaskInvoker } from './TaskTypes';\nexport { ClientCloudTasksFactory } from './ClientCloudTasksFactory';\nexport { TaskProxyClient, TASK_PROXY_CLIENT_PROVIDER } from './TaskProxyClient';\nexport { TaskClientConfig } from './TaskClientConfig';\nexport type { ApiPrototype } from './TaskClientConfig';\nexport { CloudTaskScheduler, ScheduleOptions } from './CloudTaskScheduler';\n// The two task transports (local HTTP-queue + remote GCP), both delivering over real HTTP.\nexport { InMemoryTaskInvoker } from './InMemoryTaskInvoker';\nexport { GcpTaskInvoker } from './GcpTaskInvoker';\n// NOTE: server-side delivery-auth is enforced by the framework AuthFilter (AuthMode-driven)\n// in @webpieces/http-routing — a client library has no server filters / routing machinery.\nexport {\n    ScheduleFrame,\n    setScheduleFrame,\n    currentScheduleFrame,\n    clearScheduleFrame,\n} from './ScheduleContext';\n\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/cloud/cloudtasks-client/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,yCAAgG;AAAvF,yGAAA,YAAY,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,wGAAA,WAAW,OAAA;AAE1E,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,mEAAkE;AAAzD,gIAAA,sBAAsB,OAAA;AAC/B,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,qEAAoE;AAA3D,kIAAA,uBAAuB,OAAA;AAChC,qDAAgF;AAAvE,kHAAA,eAAe,OAAA;AAAE,6HAAA,0BAA0B,OAAA;AACpD,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AAEzB,2DAA2E;AAAlE,wHAAA,kBAAkB,OAAA;AAAE,qHAAA,eAAe,OAAA;AAC5C,2FAA2F;AAC3F,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,mGAAmG;AACnG,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AACjC,4FAA4F;AAC5F,2FAA2F;AAC3F,qDAK2B;AAJvB,gHAAA,aAAa,OAAA;AACb,mHAAA,gBAAgB,OAAA;AAChB,uHAAA,oBAAoB,OAAA;AACpB,qHAAA,kBAAkB,OAAA","sourcesContent":["/**\n * @webpieces/cloudtasks-client\n *\n * Cloud Tasks enqueue client generated from a shared @PubSub API contract — the\n * fire-and-forget twin of @webpieces/http-client. The client and the controller\n * share ONE abstract API class; calling a method enqueues a task that is later\n * delivered to the same endpoint through the full server filter chain.\n */\n\nexport { ScheduleInfo, JobReference, TaskRequest, TaskInvoker, EnqueuePlan } from './TaskTypes';\nexport type { TaskCustomizer, ICreateTaskRequest } from './TaskTypes';\nexport { TaskName } from './TaskName';\nexport { TaskAlreadyExistsError } from './TaskAlreadyExistsError';\nexport { GcpTaskRegistry } from './GcpTaskRegistry';\nexport { GrpcErrorMapper } from './GrpcErrorMapper';\nexport { ClientCloudTasksFactory } from './ClientCloudTasksFactory';\nexport { TaskProxyClient, TASK_PROXY_CLIENT_PROVIDER } from './TaskProxyClient';\nexport { TaskClientConfig } from './TaskClientConfig';\nexport type { ApiPrototype } from './TaskClientConfig';\nexport { CloudTaskScheduler, ScheduleOptions } from './CloudTaskScheduler';\n// The two task transports (local HTTP-queue + remote GCP), both delivering over real HTTP.\nexport { InMemoryTaskInvoker } from './InMemoryTaskInvoker';\nexport { GcpTaskInvoker } from './GcpTaskInvoker';\n// Process-wide CloudTasksClient settings (keepalive, endpoint): override this provider at startup.\nexport { CloudTasksClientProvider } from './CloudTasksClientProvider';\n// NOTE: server-side delivery-auth is enforced by the framework AuthFilter (AuthMode-driven)\n// in @webpieces/http-routing — a client library has no server filters / routing machinery.\nexport {\n    ScheduleFrame,\n    setScheduleFrame,\n    currentScheduleFrame,\n    clearScheduleFrame,\n} from './ScheduleContext';\n\n"]}