@thailandhosting/queue-service 0.0.0-stage → 1.1.0

package/README.md

@@ -1,3 +1,167 @@
-# Temporary Holding Version
+# ThailandHosting Queue Service — Node.js SDK
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+TypeScript/JavaScript client for ThailandHosting Queue Service: message
+queues that take slow work off your site or app. One side sends jobs,
+workers receive them, and nothing is lost when a worker fails.
+
+```
+npm install @thailandhosting/queue-service
+```
+
+Node.js 18.17+. ESM with TypeScript types. No runtime dependencies: it uses
+Node's built-in `fetch`.
+
+## Quick start
+
+```ts
+import { Client } from '@thailandhosting/queue-service';
+
+const client = new Client({
+  region: 'th-bkk-1',
+  accessKeyId: process.env.TH_QUEUE_ACCESS_KEY_ID!,
+  secretAccessKey: process.env.TH_QUEUE_SECRET_ACCESS_KEY!,
+});
+const jobs = client.queue('jobs');
+
+// Send
+await jobs.sendJSON({ orderId: 42 });
+await jobs.send('plain text', { attributes: { kind: 'email' }, delay: 30 });
+await jobs.sendBatch(['a', 'b', { body: 'c', attributes: { x: '1' } }]);
+
+// A worker: long-polls, runs the handler, deletes what it handled.
+const stop = new AbortController();
+process.on('SIGTERM', () => stop.abort());
+await jobs.process(async (m) => {
+  const { orderId } = m.json<{ orderId: number }>();
+  await ship(orderId); // throwing leaves the message to be retried
+}, { concurrency: 8, retryDelay: 30, signal: stop.signal });
+```
+
+Create access keys in the Console (Queue Service → Access keys). Reuse one
+`Client`: it keeps connections open.
+
+## Using a service account
+
+A program can use a service account's short-lived token instead of an access
+key. Get it with the identity SDK and pass `tokenProvider` in place of the key:
+
+```ts
+import { defaultCredential } from '@thailandhosting/identity';
+
+const cred = defaultCredential();
+const client = new Client({
+  region: 'th-bkk-1',
+  tokenProvider: () => cred.getToken(),
+});
+```
+
+The account needs a grant on the queue, set in the Console. Creating,
+changing and deleting queues takes an access key allowed to manage them.
+
+`tokenProvider` is called before every attempt, so a refreshed token is picked
+up. Give a key or a token provider, not both. If it fails, nothing is sent or
+retried: the call rejects with `TokenError`, and `process` stops and rejects
+with it.
+
+## Receiving by hand
+
+```ts
+const messages = await jobs.receive({ max: 10, wait: 20 });
+for (const m of messages) {
+  try {
+    await handle(m.body);
+    await jobs.delete(m.receipt);
+  } catch {
+    // handed out again after the visibility timeout
+  }
+}
+```
+
+- `wait` long-polls up to 20 seconds for a first message, so an idle worker
+  makes few requests.
+- A received message is hidden for the queue's visibility timeout (or
+  `visibilityTimeout`). Delete it with its receipt once handled; otherwise it
+  is handed out again. `m.receives` counts the deliveries.
+- `changeVisibility(receipt, seconds)` keeps a message hidden longer while
+  you work on it, or with 0 releases it at once.
+- `deleteBatch(receipts)` deletes up to 10 and reports each one in order.
+
+Delivery is **at least once**: make handlers safe to run twice (check an
+order ID before charging it, for example).
+
+## Queues
+
+```ts
+const q = await client.putQueue('jobs', {
+  visibilityTimeout: 120,
+  maxReceives: 5,
+  deadLetterQueue: 'jobs-dlq', // create it first
+});
+console.log(q.created);
+
+await client.listQueues();
+const info = await client.getQueue('jobs'); // info.messages: visible, inFlight, delayed, oldestAge
+await jobs.purge();
+await client.deleteQueue('jobs');
+```
+
+`putQueue` creates a queue or changes the given settings of an existing one
+(the key must be allowed to manage queues). After `maxReceives` deliveries a
+message moves to the dead-letter queue (or is dropped without one).
+
+| Setting (seconds) | Default | Range |
+| --- | --- | --- |
+| `visibilityTimeout` | 30 | 0 – 43200 |
+| `retention` | 345600 (4 days) | 60 – 1209600 |
+| `delay` | 0 | 0 – 900 |
+| `maxReceives` | 0 (never move) | 0 – 1000 |
+
+Limits: a message is at most 256 KiB (body and up to 10 attributes), a batch
+10 messages and 1 MiB.
+
+## Errors
+
+Error answers throw `QueueServiceError` (`NotFoundError` for 404) with the
+service's `code`:
+
+```ts
+import { NotFoundError, QueueServiceError } from '@thailandhosting/queue-service';
+
+try {
+  await client.getQueue('missing');
+} catch (e) {
+  if (e instanceof NotFoundError) console.log(e.code); // queue_not_found
+}
+```
+
+Common codes: `queue_not_found`, `forbidden`, `invalid_receipt`,
+`queue_full`, `too_many_in_flight`, `too_large`, `project_suspended`,
+`wrong_region`, `busy`. Busy or unreachable answers are retried with
+exponential backoff (`maxRetries`, default 4). Every call takes an optional
+`signal`.
+
+## Endpoint and region
+
+The default endpoint is `https://queues.thailandhosting.com`. Set `region`
+to the queues' region; without one the service finds each queue's region.
+`endpoint` may also be given with the region already in it:
+`https://queues.thailandhosting.com/th-bkk-1`.
+
+## Authentication
+
+Every request is signed with HTTP Message Signatures (RFC 9421,
+HMAC-SHA256 with the secret access key) over the method, host, path, query
+and the body's Content-Digest (RFC 9530). The secret is never sent.
+`signRequest` is exported for calling the API without the client.
+
+## Development
+
+```
+npm test        # unit tests; set TH_QUEUE_TEST_ENDPOINT, TH_QUEUE_TEST_REGION,
+                # TH_QUEUE_TEST_KEY and TH_QUEUE_TEST_SECRET for the round trip
+npm run build
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,202 @@
+export declare const VERSION = "1.0.0";
+/** The Queue Service endpoint. */
+export declare const DEFAULT_ENDPOINT = "https://queues.thailandhosting.com";
+/** The most messages one send, receive or delete takes. */
+export declare const MAX_BATCH = 10;
+/** The longest a receive waits for a first message, in seconds. */
+export declare const MAX_WAIT = 20;
+export interface ClientOptions {
+    /** A Project access key from the Console (Queue Service → Access keys). Requests are signed with
+     *  the secret (HTTP Message Signatures, RFC 9421); the secret itself is never sent.
+     *  Give this or `tokenProvider`, not both. */
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    /** Gives a service account's short-lived token, sent as `Authorization: Bearer` with no signature.
+     *  Called before every attempt, retries included, so it should cache and refresh the token. */
+    tokenProvider?: () => Promise<string> | string;
+    /** The queues' region, e.g. `th-bkk-1`, appended to the endpoint. Without one the service finds
+     *  each queue's region itself. */
+    region?: string;
+    /** Default https://queues.thailandhosting.com; it may already end in a region. */
+    endpoint?: string;
+    /** Retries after the service was busy or unreachable (default 4; 0 disables). */
+    maxRetries?: number;
+    /** Appended to the SDK's User-Agent. */
+    userAgent?: string;
+    /** A fetch implementation (default: the global fetch). */
+    fetch?: typeof fetch;
+}
+/** A queue's settings in whole seconds; left-out fields keep their value (or the default on a new queue). */
+export interface QueueSettings {
+    /** How long a received message stays hidden before it is handed out again (0–43200, default 30). */
+    visibilityTimeout?: number;
+    /** How long a message is kept (60–1209600, default 345600: 4 days). */
+    retention?: number;
+    /** Hides every new message for this long (0–900, default 0). */
+    delay?: number;
+    /** Moves a message to `deadLetterQueue` (or drops it) after this many receives (0 never, up to 1000). */
+    maxReceives?: number;
+    /** A queue of the same Project ('' for none). */
+    deadLetterQueue?: string;
+}
+export interface QueueInfo {
+    name: string;
+    region: string;
+    createdAt: Date;
+    visibilityTimeout: number;
+    retention: number;
+    delay: number;
+    maxReceives: number;
+    deadLetterQueue?: string;
+    /** The backlog (getQueue and Queue.info only). */
+    messages?: QueueStats;
+}
+export interface QueueStats {
+    /** Ready to be received. */
+    visible: number;
+    /** Received, not yet deleted. */
+    inFlight: number;
+    /** Sent with a delay still running. */
+    delayed: number;
+    bytes: number;
+    /** Age of the oldest message, in seconds. */
+    oldestAge: number;
+}
+export interface SendOptions {
+    /** Travel with the message (string keys and values, up to 10). */
+    attributes?: Record<string, string>;
+    /** Hides the message for this many seconds first (at most 900; default: the queue's delay). */
+    delay?: number;
+    signal?: AbortSignal;
+}
+export interface OutgoingMessage {
+    body: string;
+    attributes?: Record<string, string>;
+    delay?: number;
+}
+export interface ReceiveOptions {
+    /** How many messages to take, 1 to 10 (default 1). */
+    max?: number;
+    /** Hide the received messages this many seconds instead of the queue's timeout (at least 1). */
+    visibilityTimeout?: number;
+    /** Long-poll up to this many seconds (at most 20) for a first message; 0 answers at once. */
+    wait?: number;
+    signal?: AbortSignal;
+}
+/** A received message. Delete it with its receipt once handled. */
+export interface Message {
+    id: string;
+    receipt: string;
+    body: string;
+    attributes: Record<string, string>;
+    sentAt: Date;
+    /** How many times the message was handed out, this one included. */
+    receives: number;
+    firstReceivedAt: Date;
+    /** The body parsed as JSON. */
+    json<T = unknown>(): T;
+}
+export interface DeleteResult {
+    receipt: string;
+    deleted: boolean;
+    /** `invalid_receipt` or `unavailable` when not deleted. */
+    error?: string;
+}
+export interface ProcessOptions {
+    /** Messages handled at once (default 1). */
+    concurrency?: number;
+    /** Seconds each receive long-polls (default and at most 20). */
+    wait?: number;
+    /** Hide received messages this many seconds instead of the queue's timeout; make it longer than a handler takes. */
+    visibilityTimeout?: number;
+    /** Seconds a message whose handler failed stays hidden before it is handed out again
+     *  (default: until its visibility timeout ends). */
+    retryDelay?: number;
+    /** Hears about handler failures, and errors of the service the worker rode out (message undefined). */
+    onError?: (err: unknown, message?: Message) => void;
+    /** Stops the worker; it resolves once the running handlers finish. */
+    signal?: AbortSignal;
+}
+/** Talks to Queue Service with one access key or service account. Reuse it: it keeps connections open. */
+export declare class Client {
+    readonly baseUrl: string;
+    private readonly keyId;
+    private readonly secret;
+    private readonly tokenProvider?;
+    private readonly maxRetries;
+    private readonly userAgent;
+    private readonly fetch;
+    constructor(o: ClientOptions);
+    /** @internal One call: JSON in, JSON (or nothing) out. `path` is after /v1, already escaped. */
+    call<T = any>(method: string, path: string, payload?: unknown, signal?: AbortSignal): Promise<{
+        status: number;
+        data: T;
+    }>;
+    /** The queues the key can reach, by name. */
+    listQueues(opts?: {
+        signal?: AbortSignal;
+    }): Promise<QueueInfo[]>;
+    /** Creates a queue, or changes the given settings of the one by that name (the key must manage queues). */
+    putQueue(name: string, settings?: QueueSettings, opts?: {
+        signal?: AbortSignal;
+    }): Promise<QueueInfo & {
+        created: boolean;
+    }>;
+    /** A queue's settings and backlog. */
+    getQueue(name: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<QueueInfo>;
+    /** Deletes a queue with every message in it. */
+    deleteQueue(name: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /** A handle for sending and receiving on one queue (it makes no call by itself). */
+    queue(name: string): Queue;
+}
+/** Sends and receives on one queue. */
+export declare class Queue {
+    private readonly path;
+    private readonly client;
+    readonly name: string;
+    constructor(client: Client, name: string);
+    /** The queue's settings and backlog. */
+    info(opts?: {
+        signal?: AbortSignal;
+    }): Promise<QueueInfo>;
+    /** Sends one message and returns its ID. */
+    send(body: string, opts?: SendOptions): Promise<string>;
+    /** Sends a value encoded as JSON. */
+    sendJSON(value: unknown, opts?: SendOptions): Promise<string>;
+    /** Sends up to 10 messages in one request (all or none) and returns their IDs in order. */
+    sendBatch(messages: (OutgoingMessage | string)[], opts?: {
+        signal?: AbortSignal;
+    }): Promise<string[]>;
+    /** Takes up to `max` messages, hiding them for the visibility timeout; none when the queue is empty
+     *  (after waiting up to `wait` seconds). */
+    receive(opts?: ReceiveOptions): Promise<Message[]>;
+    /** Deletes a handled message by its receipt (deleting it again is not an error). */
+    delete(receipt: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /** Deletes up to 10 handled messages; each receipt gets a result, in the order given. */
+    deleteBatch(receipts: string[], opts?: {
+        signal?: AbortSignal;
+    }): Promise<DeleteResult[]>;
+    /** Hides a received message `timeout` seconds from now (to work on it longer), or with 0 hands it out again at once. */
+    changeVisibility(receipt: string, timeout: number, opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /** Removes every message of the queue. */
+    purge(opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /**
+     * A worker: receives with long polling and runs `handle` on each message, `concurrency` at a time,
+     * until `signal` aborts (it then resolves once the running handlers finish). A message whose handler
+     * resolves is deleted; one whose handler throws is left to be handed out again (after `retryDelay`
+     * when set), and after the queue's maxReceives it goes to its dead-letter queue. Busy or unreachable
+     * answers are retried with backoff; errors retrying cannot fix (a missing queue, a key that may not
+     * receive) reject.
+     */
+    process(handle: (message: Message) => unknown | Promise<unknown>, opts?: ProcessOptions): Promise<void>;
+}

package/dist/client.js

@@ -0,0 +1,284 @@
+import { NotFoundError, QueueServiceError, TokenError } from "./errors.js";
+import { contentDigest, signRequest } from "./signing.js";
+export const VERSION = '1.0.0';
+/** The Queue Service endpoint. */
+export const DEFAULT_ENDPOINT = 'https://queues.thailandhosting.com';
+/** The most messages one send, receive or delete takes. */
+export const MAX_BATCH = 10;
+/** The longest a receive waits for a first message, in seconds. */
+export const MAX_WAIT = 20;
+const RETRY_STATUSES = new Set([502, 503, 504]);
+const sleep = (ms, signal) => new Promise((resolve) => {
+    if (signal?.aborted)
+        return resolve();
+    const t = setTimeout(done, ms);
+    function done() {
+        clearTimeout(t);
+        signal?.removeEventListener('abort', done);
+        resolve();
+    }
+    signal?.addEventListener('abort', done, { once: true });
+});
+/** The pause before retry n: exponential from 100 ms, capped at 5 s, with jitter. */
+const backoff = (n) => {
+    const d = Math.min(100 * 2 ** Math.min(n, 6), 5000);
+    return d / 2 + Math.random() * (d / 2);
+};
+/** The Authorization value from a token provider; its failure is a TokenError. */
+async function bearer(provider) {
+    let token;
+    try {
+        token = await provider();
+    }
+    catch (err) {
+        throw new TokenError(`queue-service: tokenProvider failed: ${err instanceof Error ? err.message : err}`, err);
+    }
+    if (!token || typeof token !== 'string')
+        throw new TokenError('queue-service: tokenProvider gave no token');
+    return 'Bearer ' + token;
+}
+const toDate = (v) => (typeof v === 'string' ? new Date(v) : new Date(0));
+function queueFromJSON(d) {
+    return { ...d, createdAt: toDate(d.createdAt) };
+}
+function messageFromJSON(d) {
+    return {
+        id: d.id, receipt: d.receipt, body: d.body ?? '', attributes: d.attributes ?? {}, sentAt: toDate(d.sentAt),
+        receives: d.receives ?? 0, firstReceivedAt: toDate(d.firstReceivedAt),
+        json() { return JSON.parse(this.body); },
+    };
+}
+/** Talks to Queue Service with one access key or service account. Reuse it: it keeps connections open. */
+export class Client {
+    baseUrl; // up to and including /v1
+    keyId;
+    secret;
+    tokenProvider;
+    maxRetries;
+    userAgent;
+    fetch;
+    constructor(o) {
+        if (o?.tokenProvider) {
+            if (o.accessKeyId || o.secretAccessKey)
+                throw new Error('queue-service: give an access key or tokenProvider, not both');
+        }
+        else if (!o?.accessKeyId || !o?.secretAccessKey) {
+            throw new Error('queue-service: accessKeyId and secretAccessKey, or tokenProvider, are required');
+        }
+        const u = new URL((o.endpoint || DEFAULT_ENDPOINT).replace(/\/+$/, ''));
+        if (u.protocol !== 'https:' && u.protocol !== 'http:')
+            throw new Error(`queue-service: invalid endpoint ${o.endpoint}`);
+        let path = u.pathname.replace(/\/+$/, '').replace(/\/v1$/, '');
+        if (o.region)
+            path += '/' + encodeURIComponent(o.region);
+        this.baseUrl = `${u.origin}${path}/v1`;
+        this.keyId = o.accessKeyId ?? '';
+        this.secret = o.secretAccessKey ?? '';
+        this.tokenProvider = o.tokenProvider;
+        this.maxRetries = o.maxRetries ?? 4;
+        this.userAgent = `thailandhosting-queue-service-sdk-node/${VERSION}${o.userAgent ? ' ' + o.userAgent : ''}`;
+        this.fetch = o.fetch ?? globalThis.fetch.bind(globalThis);
+    }
+    /** @internal One call: JSON in, JSON (or nothing) out. `path` is after /v1, already escaped. */
+    async call(method, path, payload, signal) {
+        const url = this.baseUrl + path;
+        const body = payload === undefined ? undefined : JSON.stringify(payload);
+        for (let attempt = 0;; attempt++) {
+            const headers = { 'User-Agent': this.userAgent, Accept: 'application/json' };
+            if (body !== undefined) {
+                headers['Content-Type'] = 'application/json';
+                headers['Content-Digest'] = contentDigest(body);
+            }
+            if (this.tokenProvider)
+                headers.Authorization = await bearer(this.tokenProvider);
+            else
+                Object.assign(headers, signRequest({ method, url, accessKeyId: this.keyId, secretAccessKey: this.secret, contentDigest: headers['Content-Digest'] }));
+            let resp;
+            try {
+                resp = await this.fetch(url, { method, headers, body, signal, redirect: 'manual' });
+            }
+            catch (err) {
+                if (signal?.aborted || attempt >= this.maxRetries)
+                    throw err;
+                await sleep(backoff(attempt), signal);
+                continue;
+            }
+            if (resp.status >= 300) {
+                const text = await resp.text().catch(() => '');
+                if (RETRY_STATUSES.has(resp.status) && attempt < this.maxRetries) {
+                    const after = Number(resp.headers.get('retry-after'));
+                    await sleep(Number.isFinite(after) && after > 0 ? Math.min(after, 60) * 1000 : backoff(attempt), signal);
+                    if (!signal?.aborted)
+                        continue;
+                }
+                let p = {};
+                try {
+                    p = JSON.parse(text);
+                }
+                catch { /* not Problem Details */ }
+                const code = p.code || resp.headers.get('x-error-code') || `http_${resp.status}`;
+                const message = p.title || text.trim() || resp.statusText;
+                const problem = { type: p.type, instance: p.instance };
+                if (resp.status === 404)
+                    throw new NotFoundError(code, message, problem);
+                throw new QueueServiceError(resp.status, code, message, problem);
+            }
+            const text = await resp.text();
+            return { status: resp.status, data: (text ? JSON.parse(text) : undefined) };
+        }
+    }
+    /** The queues the key can reach, by name. */
+    async listQueues(opts = {}) {
+        const { data } = await this.call('GET', '/queues', undefined, opts.signal);
+        return (data?.queues ?? []).map(queueFromJSON);
+    }
+    /** Creates a queue, or changes the given settings of the one by that name (the key must manage queues). */
+    async putQueue(name, settings = {}, opts = {}) {
+        const { status, data } = await this.call('PUT', '/queues/' + encodeURIComponent(name), settings, opts.signal);
+        return { ...queueFromJSON(data), created: status === 201 };
+    }
+    /** A queue's settings and backlog. */
+    async getQueue(name, opts = {}) {
+        const { data } = await this.call('GET', '/queues/' + encodeURIComponent(name), undefined, opts.signal);
+        return queueFromJSON(data);
+    }
+    /** Deletes a queue with every message in it. */
+    async deleteQueue(name, opts = {}) {
+        await this.call('DELETE', '/queues/' + encodeURIComponent(name), undefined, opts.signal);
+    }
+    /** A handle for sending and receiving on one queue (it makes no call by itself). */
+    queue(name) {
+        return new Queue(this, name);
+    }
+}
+/** Sends and receives on one queue. */
+export class Queue {
+    path;
+    client;
+    name;
+    constructor(client, name) {
+        this.client = client;
+        this.name = name;
+        this.path = '/queues/' + encodeURIComponent(name);
+    }
+    /** The queue's settings and backlog. */
+    info(opts = {}) {
+        return this.client.getQueue(this.name, opts);
+    }
+    /** Sends one message and returns its ID. */
+    async send(body, opts = {}) {
+        const { data } = await this.client.call('POST', this.path + '/messages', { body, attributes: opts.attributes, delay: opts.delay || undefined }, opts.signal);
+        return data.id;
+    }
+    /** Sends a value encoded as JSON. */
+    sendJSON(value, opts = {}) {
+        return this.send(JSON.stringify(value), opts);
+    }
+    /** Sends up to 10 messages in one request (all or none) and returns their IDs in order. */
+    async sendBatch(messages, opts = {}) {
+        if (messages.length < 1 || messages.length > MAX_BATCH)
+            throw new RangeError(`queue-service: send 1 to ${MAX_BATCH} messages at once`);
+        const payload = messages.map((m) => (typeof m === 'string' ? { body: m } : { body: m.body, attributes: m.attributes, delay: m.delay || undefined }));
+        const { data } = await this.client.call('POST', this.path + '/messages', { messages: payload }, opts.signal);
+        return data.ids;
+    }
+    /** Takes up to `max` messages, hiding them for the visibility timeout; none when the queue is empty
+     *  (after waiting up to `wait` seconds). */
+    async receive(opts = {}) {
+        const payload = {};
+        if (opts.max)
+            payload.max = opts.max;
+        if (opts.visibilityTimeout)
+            payload.visibilityTimeout = Math.max(1, Math.floor(opts.visibilityTimeout));
+        if (opts.wait)
+            payload.wait = Math.min(MAX_WAIT, Math.floor(opts.wait));
+        const { data } = await this.client.call('POST', this.path + '/receive', payload, opts.signal);
+        return (data?.messages ?? []).map(messageFromJSON);
+    }
+    /** Deletes a handled message by its receipt (deleting it again is not an error). */
+    async delete(receipt, opts = {}) {
+        await this.client.call('DELETE', this.path + '/messages/' + encodeURIComponent(receipt), undefined, opts.signal);
+    }
+    /** Deletes up to 10 handled messages; each receipt gets a result, in the order given. */
+    async deleteBatch(receipts, opts = {}) {
+        if (receipts.length < 1 || receipts.length > MAX_BATCH)
+            throw new RangeError(`queue-service: delete 1 to ${MAX_BATCH} receipts at once`);
+        const { data } = await this.client.call('POST', this.path + '/delete', { receipts }, opts.signal);
+        const byReceipt = new Map();
+        for (const r of (data?.results ?? []))
+            byReceipt.set(r.receipt, [...(byReceipt.get(r.receipt) ?? []), r]);
+        return receipts.map((receipt) => byReceipt.get(receipt)?.shift() ?? { receipt, deleted: false, error: 'unavailable' });
+    }
+    /** Hides a received message `timeout` seconds from now (to work on it longer), or with 0 hands it out again at once. */
+    async changeVisibility(receipt, timeout, opts = {}) {
+        await this.client.call('POST', this.path + '/visibility', { receipt, timeout: Math.floor(timeout) }, opts.signal);
+    }
+    /** Removes every message of the queue. */
+    async purge(opts = {}) {
+        await this.client.call('POST', this.path + '/purge', {}, opts.signal);
+    }
+    /**
+     * A worker: receives with long polling and runs `handle` on each message, `concurrency` at a time,
+     * until `signal` aborts (it then resolves once the running handlers finish). A message whose handler
+     * resolves is deleted; one whose handler throws is left to be handed out again (after `retryDelay`
+     * when set), and after the queue's maxReceives it goes to its dead-letter queue. Busy or unreachable
+     * answers are retried with backoff; errors retrying cannot fix (a missing queue, a key that may not
+     * receive) reject.
+     */
+    async process(handle, opts = {}) {
+        const concurrency = Math.max(1, opts.concurrency ?? 1);
+        const wait = Math.min(MAX_WAIT, opts.wait && opts.wait > 0 ? opts.wait : MAX_WAIT);
+        const signal = opts.signal;
+        const report = (err, m) => { try {
+            opts.onError?.(err, m);
+        }
+        catch { /* ignore */ } };
+        const running = new Set();
+        let failures = 0;
+        const runOne = async (m) => {
+            try {
+                await handle(m);
+            }
+            catch (err) {
+                report(err, m);
+                if (opts.retryDelay && opts.retryDelay > 0) {
+                    await this.changeVisibility(m.receipt, opts.retryDelay).catch((e) => {
+                        if (!(e instanceof QueueServiceError && e.code === 'invalid_receipt'))
+                            report(e, m);
+                    });
+                }
+                return;
+            }
+            await this.delete(m.receipt).catch((e) => report(e, m));
+        };
+        try {
+            while (!signal?.aborted) {
+                while (running.size >= concurrency)
+                    await Promise.race(running);
+                const free = Math.min(concurrency - running.size, MAX_BATCH);
+                let messages;
+                try {
+                    messages = await this.receive({ max: free, wait, visibilityTimeout: opts.visibilityTimeout, signal });
+                }
+                catch (err) {
+                    if (signal?.aborted)
+                        break;
+                    if (err instanceof QueueServiceError && [400, 401, 403, 404, 421].includes(err.status) && err.code !== 'project_suspended')
+                        throw err;
+                    report(err);
+                    await sleep(backoff(++failures), signal);
+                    continue;
+                }
+                failures = 0;
+                for (const m of messages) {
+                    const p = runOne(m).finally(() => running.delete(p));
+                    running.add(p);
+                }
+            }
+        }
+        finally {
+            await Promise.allSettled(running);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,25 @@
+/** An error answer from the service, read from its Problem Details (RFC 9457).
+ *  `code` is the machine-readable reason, for example `queue_not_found`,
+ *  `queue_full`, `invalid_receipt` or `busy`; the message is the problem's title. */
+export declare class QueueServiceError extends Error {
+    readonly status: number;
+    readonly code: string;
+    /** The problem's `type` URI and `instance` (the request path). */
+    readonly type?: string;
+    readonly instance?: string;
+    constructor(status: number, code: string, message: string, problem?: {
+        type?: string;
+        instance?: string;
+    });
+}
+/** The `tokenProvider` failed or gave no token: nothing was sent. The provider's error is in `cause`. Not retried. */
+export declare class TokenError extends Error {
+    constructor(message: string, cause?: unknown);
+}
+/** The queue does not exist, or the key may not reach it (code `queue_not_found`). */
+export declare class NotFoundError extends QueueServiceError {
+    constructor(code: string, message: string, problem?: {
+        type?: string;
+        instance?: string;
+    });
+}

package/dist/errors.js

@@ -0,0 +1,33 @@
+/** An error answer from the service, read from its Problem Details (RFC 9457).
+ *  `code` is the machine-readable reason, for example `queue_not_found`,
+ *  `queue_full`, `invalid_receipt` or `busy`; the message is the problem's title. */
+export class QueueServiceError extends Error {
+    status;
+    code;
+    /** The problem's `type` URI and `instance` (the request path). */
+    type;
+    instance;
+    constructor(status, code, message, problem = {}) {
+        super(`${code} (HTTP ${status}): ${message}`);
+        this.name = 'QueueServiceError';
+        this.status = status;
+        this.code = code;
+        this.type = problem.type;
+        this.instance = problem.instance;
+    }
+}
+/** The `tokenProvider` failed or gave no token: nothing was sent. The provider's error is in `cause`. Not retried. */
+export class TokenError extends Error {
+    constructor(message, cause) {
+        super(message, { cause });
+        this.name = 'TokenError';
+    }
+}
+/** The queue does not exist, or the key may not reach it (code `queue_not_found`). */
+export class NotFoundError extends QueueServiceError {
+    constructor(code, message, problem) {
+        super(404, code, message, problem);
+        this.name = 'NotFoundError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;qFAEqF;AACrF,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,MAAM,CAAS;IACf,IAAI,CAAS;IACtB,kEAAkE;IACzD,IAAI,CAAU;IACd,QAAQ,CAAU;IAE3B,YAAY,MAAc,EAAE,IAAY,EAAE,OAAe,EAAE,UAAgD,EAAE;QAC3G,KAAK,CAAC,GAAG,IAAI,UAAU,MAAM,MAAM,OAAO,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnC,CAAC;CACF;AAED,sHAAsH;AACtH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,sFAAsF;AACtF,MAAM,OAAO,aAAc,SAAQ,iBAAiB;IAClD,YAAY,IAAY,EAAE,OAAe,EAAE,OAA8C;QACvF,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { Client, Queue, VERSION, DEFAULT_ENDPOINT, MAX_BATCH, MAX_WAIT, type ClientOptions, type DeleteResult, type Message, type OutgoingMessage, type ProcessOptions, type QueueInfo, type QueueSettings, type QueueStats, type ReceiveOptions, type SendOptions, } from './client.ts';
+export { NotFoundError, QueueServiceError, TokenError } from './errors.ts';
+export { contentDigest, signRequest, type SignInput } from './signing.ts';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { Client, Queue, VERSION, DEFAULT_ENDPOINT, MAX_BATCH, MAX_WAIT, } from "./client.js";
+export { NotFoundError, QueueServiceError, TokenError } from "./errors.js";
+export { contentDigest, signRequest } from "./signing.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,QAAQ,GAG9D,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,WAAW,EAAkB,MAAM,cAAc,CAAC"}

package/dist/signing.d.ts

@@ -0,0 +1,22 @@
+export interface SignInput {
+    method: string;
+    /** The full request URL, exactly as it will be sent. */
+    url: string | URL;
+    accessKeyId: string;
+    secretAccessKey: string;
+    /** The Content-Digest header sent with a body; leave out for a request without one. */
+    contentDigest?: string;
+    /** Unix seconds (default: now). */
+    created?: number;
+}
+/** The Content-Digest (RFC 9530) of a body: `sha-256=:<base64>:`. */
+export declare const contentDigest: (body: Uint8Array | string) => string;
+/** @internal The @signature-params value: Signature-Input after `th=`. */
+export declare function signatureParams(keyId: string, created: number, withDigest: boolean): string;
+/** @internal The bytes that are signed (RFC 9421 section 2.5), no trailing newline. */
+export declare function signatureBase(method: string, url: string | URL, params: string, digest?: string): string;
+/** The Signature-Input and Signature headers of one request. Sign each attempt afresh. */
+export declare function signRequest(i: SignInput): {
+    'Signature-Input': string;
+    Signature: string;
+};

package/dist/signing.js

@@ -0,0 +1,39 @@
+// Request signing: HTTP Message Signatures (RFC 9421) with HMAC-SHA256 keyed
+// with the access key's secret, so the secret itself is never sent. A body is
+// tied to the signature through its Content-Digest (RFC 9530).
+import { createHash, createHmac } from 'node:crypto';
+const LABEL = 'th';
+const ALG = 'hmac-sha256';
+const COMPONENTS = ['@method', '@authority', '@path', '@query'];
+/** The Content-Digest (RFC 9530) of a body: `sha-256=:<base64>:`. */
+export const contentDigest = (body) => `sha-256=:${createHash('sha256').update(body).digest('base64')}:`;
+const sfString = (s) => `"${s.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+/** @internal The @signature-params value: Signature-Input after `th=`. */
+export function signatureParams(keyId, created, withDigest) {
+    const covered = withDigest ? [...COMPONENTS, 'content-digest'] : COMPONENTS;
+    return `(${covered.map(sfString).join(' ')});created=${created};keyid=${sfString(keyId)};alg="${ALG}"`;
+}
+/** @internal The bytes that are signed (RFC 9421 section 2.5), no trailing newline. */
+export function signatureBase(method, url, params, digest) {
+    const u = typeof url === 'string' ? new URL(url) : url;
+    const authority = u.host.toLowerCase().replace(/:(443|80)$/, '');
+    const lines = [
+        `"@method": ${method.toUpperCase()}`,
+        `"@authority": ${authority}`,
+        `"@path": ${u.pathname || '/'}`,
+        `"@query": ?${u.search.slice(1)}`,
+    ];
+    if (digest !== undefined)
+        lines.push(`"content-digest": ${digest}`);
+    lines.push(`"@signature-params": ${params}`);
+    return lines.join('\n');
+}
+/** The Signature-Input and Signature headers of one request. Sign each attempt afresh. */
+export function signRequest(i) {
+    const created = i.created ?? Math.floor(Date.now() / 1000);
+    const params = signatureParams(i.accessKeyId, created, i.contentDigest !== undefined);
+    const base = signatureBase(i.method, i.url, params, i.contentDigest);
+    const sig = createHmac('sha256', i.secretAccessKey).update(base, 'utf8').digest('base64');
+    return { 'Signature-Input': `${LABEL}=${params}`, Signature: `${LABEL}=:${sig}:` };
+}
+//# sourceMappingURL=signing.js.map

package/dist/signing.js.map

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

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@thailandhosting/queue-service",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.1.0",
+  "description": "Node.js SDK for ThailandHosting Queue Service",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.17"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mrzack99s/thailandhosting-queue-service-sdk-node.git"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test test/*.test.ts",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "keywords": [
+    "thailandhosting",
+    "queue",
+    "message-queue",
+    "jobs",
+    "worker"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.8.0"
+  }
+}