@embassys/ambassador 0.0.0 → 0.2.7

package/dist/local-tool-result.d.ts

@@ -0,0 +1,4 @@
+export declare class LocalToolResultTooLarge extends Error {
+    constructor();
+}
+export declare function serializeLocalToolResult(result: Record<string, unknown>): string;

package/dist/local-tool-result.js

@@ -0,0 +1,17 @@
+// The MCP SDK mirrors this JSON as structured content and an escaped text item.
+// This cap keeps both copies and a maximum-size request ID below the 4 MiB transport limit.
+const MAX_LOCAL_TOOL_RESULT_BYTES = 512 * 1024;
+export class LocalToolResultTooLarge extends Error {
+    constructor() {
+        super("Local tool result exceeded its size limit");
+        this.name = "LocalToolResultTooLarge";
+    }
+}
+export function serializeLocalToolResult(result) {
+    const serialized = JSON.stringify(result);
+    if (Buffer.byteLength(serialized, "utf8") > MAX_LOCAL_TOOL_RESULT_BYTES) {
+        throw new LocalToolResultTooLarge();
+    }
+    return serialized;
+}
+//# sourceMappingURL=local-tool-result.js.map

package/dist/local-tool-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-tool-result.js","sourceRoot":"","sources":["../src/local-tool-result.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,4FAA4F;AAC5F,MAAM,2BAA2B,GAAG,GAAG,GAAG,IAAI,CAAC;AAE/C,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD;QACE,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,UAAU,wBAAwB,CAAC,MAA+B;IACtE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,2BAA2B,EAAE,CAAC;QACxE,MAAM,IAAI,uBAAuB,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/mcp-contract.d.ts

@@ -0,0 +1,10 @@
+export declare class McpContractError extends Error {
+    constructor();
+}
+export interface CentralToolDefinition {
+    readonly name: string;
+    readonly description?: string;
+    readonly inputSchema: Record<string, unknown>;
+}
+export declare function safeLocalToolArguments(value: unknown): Record<string, unknown>;
+export declare function assertSafeUpstreamResult(value: unknown, centralToken?: string): void;

package/dist/mcp-contract.js

@@ -0,0 +1,63 @@
+const FORBIDDEN_LOCAL_NAMES = new Set([
+    "access_token",
+    "authorization",
+    "dpop",
+    "jwt",
+    "private_key",
+    "proof",
+    "token",
+]);
+const FORBIDDEN_RESULT_NAMES = new Set([
+    "access_token",
+    "authorization",
+    "dpop",
+    "jwt",
+    "private_key",
+    "proof",
+    "token",
+]);
+export class McpContractError extends Error {
+    constructor() {
+        super("The local MCP contract is invalid");
+        this.name = "McpContractError";
+    }
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function assertNoNames(value, forbidden) {
+    if (Array.isArray(value)) {
+        for (const item of value)
+            assertNoNames(item, forbidden);
+        return;
+    }
+    if (!isRecord(value))
+        return;
+    for (const [name, nested] of Object.entries(value)) {
+        if (forbidden.has(name.toLowerCase()))
+            throw new McpContractError();
+        assertNoNames(nested, forbidden);
+    }
+}
+function containsBytes(value, bytes) {
+    if (typeof value === "string")
+        return value.includes(bytes);
+    if (Array.isArray(value))
+        return value.some((item) => containsBytes(item, bytes));
+    if (!isRecord(value))
+        return false;
+    return Object.entries(value).some(([name, nested]) => name.includes(bytes) || containsBytes(nested, bytes));
+}
+export function safeLocalToolArguments(value) {
+    if (!isRecord(value))
+        throw new McpContractError();
+    assertNoNames(value, FORBIDDEN_LOCAL_NAMES);
+    return value;
+}
+export function assertSafeUpstreamResult(value, centralToken) {
+    assertNoNames(value, FORBIDDEN_RESULT_NAMES);
+    if (centralToken !== undefined && containsBytes(value, centralToken)) {
+        throw new McpContractError();
+    }
+}
+//# sourceMappingURL=mcp-contract.js.map

package/dist/mcp-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-contract.js","sourceRoot":"","sources":["../src/mcp-contract.ts"],"names":[],"mappings":"AAAA,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,cAAc;IACd,eAAe;IACf,MAAM;IACN,KAAK;IACL,aAAa;IACb,OAAO;IACP,OAAO;CACR,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,cAAc;IACd,eAAe;IACf,MAAM;IACN,KAAK;IACL,aAAa;IACb,OAAO;IACP,OAAO;CACR,CAAC,CAAC;AAEH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC;QACE,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAQD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,aAAa,CAAC,KAAc,EAAE,SAA8B;IACnE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACzD,OAAO;IACT,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO;IAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAAE,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACpE,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAc,EAAE,KAAa;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAClF,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAC/B,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CACzE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,gBAAgB,EAAE,CAAC;IACnD,aAAa,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc,EAAE,YAAqB;IAC5E,aAAa,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC;IAC7C,IAAI,YAAY,KAAK,SAAS,IAAI,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,gBAAgB,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/notification-journal.d.ts

@@ -0,0 +1,24 @@
+export type NotificationDeliveryState = "pending" | "delivering" | "accepted" | "completed" | "acknowledging";
+export interface NotificationDeliveryRecord {
+    readonly messageId: string;
+    readonly deliveryState: NotificationDeliveryState;
+}
+export interface NotificationIngestResult {
+    readonly inserted: number;
+    readonly duplicates: number;
+}
+export declare function validateNotificationId(value: unknown): string;
+export declare class NotificationJournal {
+    #private;
+    constructor(path: string);
+    close(): void;
+    ingest(messageIds: readonly string[]): NotificationIngestResult;
+    get(messageId: string): NotificationDeliveryRecord | undefined;
+    count(): number;
+    discardUndelivered(): number;
+    recoverableAcknowledgements(): NotificationDeliveryRecord[];
+    beginDelivery(messageId: string): void;
+    recordDelivered(messageId: string, state: "accepted" | "completed"): void;
+    beginAcknowledgement(messageId: string): void;
+    removeAcknowledged(messageId: string): void;
+}

package/dist/notification-journal.js

@@ -0,0 +1,194 @@
+import Database from "better-sqlite3";
+import { preparePrivateSqliteArtifact } from "./sqlite-artifact.js";
+const SCHEMA_VERSION = 1;
+const BUSY_TIMEOUT_MS = 5_000;
+const TABLE_SQL = `
+  CREATE TABLE notification_delivery (
+    message_id TEXT PRIMARY KEY CHECK (
+      length(message_id) BETWEEN 1 AND 128
+      AND message_id NOT GLOB '*[^A-Za-z0-9._~-]*'
+    ),
+    delivery_state TEXT NOT NULL CHECK (
+      delivery_state IN ('pending', 'delivering', 'accepted', 'completed', 'acknowledging')
+    )
+  ) STRICT
+`;
+const journalResources = new WeakMap();
+export function validateNotificationId(value) {
+    if (typeof value !== "string" ||
+        value.length < 1 ||
+        value.length > 128 ||
+        !/^[A-Za-z0-9._~-]+$/u.test(value)) {
+        throw new TypeError("notification ID must use 1 to 128 URI-unreserved ASCII characters");
+    }
+    return value;
+}
+function resourcesFor(journal) {
+    const resources = journalResources.get(journal);
+    if (resources === undefined)
+        throw new Error("notification journal is not initialized");
+    return resources;
+}
+function safeInteger(value) {
+    if (typeof value === "bigint") {
+        if (value < 0n || value > BigInt(Number.MAX_SAFE_INTEGER))
+            throw new Error("invalid count");
+        return Number(value);
+    }
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) {
+        throw new Error("invalid count");
+    }
+    return value;
+}
+function deliveryState(value) {
+    if (["pending", "delivering", "accepted", "completed", "acknowledging"].includes(value)) {
+        return value;
+    }
+    throw new Error("notification journal contains an invalid delivery state");
+}
+function record(row) {
+    return {
+        messageId: validateNotificationId(row.message_id),
+        deliveryState: deliveryState(row.delivery_state),
+    };
+}
+function normalizedSql(value) {
+    return value.replaceAll(/\s+/gu, " ").trim().toLowerCase();
+}
+function initialize(database) {
+    database
+        .transaction(() => {
+        const version = safeInteger(database.pragma("user_version", { simple: true }));
+        if (version > SCHEMA_VERSION)
+            throw new Error("notification journal schema is too new");
+        if (version === 0) {
+            const row = database
+                .prepare("SELECT count(*) AS count FROM sqlite_schema WHERE name NOT LIKE 'sqlite_%'")
+                .get();
+            if (row === undefined || safeInteger(row.count) !== 0) {
+                throw new Error("notification journal has an obsolete or unversioned schema");
+            }
+            database.exec(`${TABLE_SQL};`);
+            database.pragma(`user_version = ${SCHEMA_VERSION}`);
+        }
+        const rows = database
+            .prepare("SELECT name, sql FROM sqlite_schema WHERE name NOT LIKE 'sqlite_%' ORDER BY name")
+            .all();
+        if (rows.length !== 1 ||
+            rows[0]?.name !== "notification_delivery" ||
+            rows[0].sql === null ||
+            normalizedSql(rows[0].sql) !== normalizedSql(TABLE_SQL)) {
+            throw new Error("notification journal schema is invalid");
+        }
+    })
+        .immediate();
+}
+export class NotificationJournal {
+    constructor(path) {
+        const artifact = preparePrivateSqliteArtifact(path, () => new Error("Invalid journal path"));
+        let database;
+        try {
+            database = new Database(path, { timeout: BUSY_TIMEOUT_MS });
+            artifact.validate();
+            artifact.releaseFile();
+            database.defaultSafeIntegers(true);
+            database.pragma("journal_mode = WAL");
+            database.pragma("synchronous = FULL");
+            database.pragma("foreign_keys = ON");
+            database.pragma(`busy_timeout = ${BUSY_TIMEOUT_MS}`);
+            database.pragma("trusted_schema = OFF");
+            initialize(database);
+            artifact.validateDirectory();
+            journalResources.set(this, { database });
+        }
+        catch (error) {
+            database?.close();
+            throw error;
+        }
+        finally {
+            artifact.close();
+        }
+    }
+    close() {
+        const { database } = resourcesFor(this);
+        if (database.open)
+            database.close();
+    }
+    ingest(messageIds) {
+        const unique = new Set();
+        let duplicates = 0;
+        for (const value of messageIds) {
+            const id = validateNotificationId(value);
+            if (unique.has(id))
+                duplicates += 1;
+            else
+                unique.add(id);
+        }
+        const database = resourcesFor(this).database;
+        return database
+            .transaction(() => {
+            const insert = database.prepare("INSERT INTO notification_delivery (message_id, delivery_state) VALUES (?, 'pending') ON CONFLICT(message_id) DO NOTHING");
+            let inserted = 0;
+            for (const id of unique) {
+                const changes = safeInteger(insert.run(id).changes);
+                inserted += changes;
+                if (changes === 0)
+                    duplicates += 1;
+            }
+            return { inserted, duplicates };
+        })
+            .immediate();
+    }
+    get(messageId) {
+        const row = resourcesFor(this)
+            .database.prepare("SELECT message_id, delivery_state FROM notification_delivery WHERE message_id = ?")
+            .get(validateNotificationId(messageId));
+        return row === undefined ? undefined : record(row);
+    }
+    count() {
+        const row = resourcesFor(this)
+            .database.prepare("SELECT count(*) AS count FROM notification_delivery")
+            .get();
+        if (row === undefined)
+            throw new Error("notification journal count failed");
+        return safeInteger(row.count);
+    }
+    discardUndelivered() {
+        return safeInteger(resourcesFor(this)
+            .database.prepare("DELETE FROM notification_delivery WHERE delivery_state IN ('pending', 'delivering')")
+            .run().changes);
+    }
+    recoverableAcknowledgements() {
+        return resourcesFor(this)
+            .database.prepare("SELECT message_id, delivery_state FROM notification_delivery WHERE delivery_state IN ('accepted', 'completed') ORDER BY message_id")
+            .all()
+            .map(record);
+    }
+    beginDelivery(messageId) {
+        this.#transition(messageId, ["pending"], "delivering");
+    }
+    recordDelivered(messageId, state) {
+        this.#transition(messageId, ["delivering"], state);
+    }
+    beginAcknowledgement(messageId) {
+        this.#transition(messageId, ["accepted", "completed"], "acknowledging");
+    }
+    removeAcknowledged(messageId) {
+        const id = validateNotificationId(messageId);
+        const changes = safeInteger(resourcesFor(this)
+            .database.prepare("DELETE FROM notification_delivery WHERE message_id = ? AND delivery_state = 'acknowledging'")
+            .run(id).changes);
+        if (changes !== 1)
+            throw new Error("notification acknowledgement removal failed");
+    }
+    #transition(messageId, from, to) {
+        const id = validateNotificationId(messageId);
+        const placeholders = from.map(() => "?").join(", ");
+        const changes = safeInteger(resourcesFor(this)
+            .database.prepare(`UPDATE notification_delivery SET delivery_state = ? WHERE message_id = ? AND delivery_state IN (${placeholders})`)
+            .run(to, id, ...from).changes);
+        if (changes !== 1)
+            throw new Error("notification journal transition failed");
+    }
+}
+//# sourceMappingURL=notification-journal.js.map

package/dist/notification-journal.js.map

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

package/dist/notification-relay.d.ts

@@ -0,0 +1,31 @@
+import type { CentralMessage } from "./central-rest.js";
+import { type NotificationJournal } from "./notification-journal.js";
+export type DeliveryResult = {
+    readonly status: "accepted" | "completed";
+};
+export interface DeliveryTarget {
+    deliver(message: CentralMessage, signal: AbortSignal): Promise<DeliveryResult>;
+    close(): Promise<void>;
+}
+export type NotificationRelayErrorCode = "already_running" | "invalid_configuration" | "invalid_notification_response" | "journal_failed" | "relay_failed";
+export declare class NotificationRelayError extends Error {
+    readonly code: NotificationRelayErrorCode;
+    constructor(code: NotificationRelayErrorCode);
+}
+export declare class RetryableNotificationReceiveError extends Error {
+    readonly retryAfterMs?: number | undefined;
+    constructor(retryAfterMs?: number | undefined);
+}
+export interface NotificationRelayOptions {
+    readonly journal: NotificationJournal;
+    readonly deliveryTarget: DeliveryTarget;
+    readonly receiveMessages: (signal: AbortSignal) => Promise<readonly CentralMessage[]>;
+    readonly acknowledgeMessage: (messageId: string, signal: AbortSignal) => Promise<void>;
+    readonly retryDelayMs?: number;
+}
+export declare class NotificationRelay {
+    #private;
+    constructor(options: NotificationRelayOptions);
+    run(signal: AbortSignal): Promise<void>;
+    shutdown(): Promise<void>;
+}

package/dist/notification-relay.js

@@ -0,0 +1,203 @@
+import { setTimeout as delay } from "node:timers/promises";
+import { validateNotificationId } from "./notification-journal.js";
+const MAX_MESSAGES = 256;
+const MAX_RESULT_BYTES = 512 * 1024;
+const DEFAULT_RETRY_DELAY_MS = 250;
+export class NotificationRelayError extends Error {
+    code;
+    constructor(code) {
+        super("Notification relay failed");
+        this.code = code;
+        this.name = "NotificationRelayError";
+    }
+}
+export class RetryableNotificationReceiveError extends Error {
+    retryAfterMs;
+    constructor(retryAfterMs) {
+        super("Central receive may be retried");
+        this.retryAfterMs = retryAfterMs;
+        this.name = "RetryableNotificationReceiveError";
+    }
+}
+function validateMessage(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new NotificationRelayError("invalid_notification_response");
+    }
+    if (value.id !== undefined) {
+        try {
+            validateNotificationId(value.id);
+        }
+        catch {
+            throw new NotificationRelayError("invalid_notification_response");
+        }
+    }
+    let serialized;
+    try {
+        serialized = JSON.stringify(value);
+    }
+    catch {
+        throw new NotificationRelayError("invalid_notification_response");
+    }
+    if (Buffer.byteLength(serialized, "utf8") > MAX_RESULT_BYTES) {
+        throw new NotificationRelayError("invalid_notification_response");
+    }
+    return { message: value, serialized };
+}
+export class NotificationRelay {
+    #journal;
+    #deliveryTarget;
+    #receiveMessages;
+    #acknowledgeMessage;
+    #retryDelayMs;
+    #controller;
+    #running;
+    #closingTarget;
+    #shutdownRequested = false;
+    constructor(options) {
+        this.#journal = options.journal;
+        this.#deliveryTarget = options.deliveryTarget;
+        this.#receiveMessages = options.receiveMessages;
+        this.#acknowledgeMessage = options.acknowledgeMessage;
+        this.#retryDelayMs = options.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS;
+        if (!Number.isSafeInteger(this.#retryDelayMs) || this.#retryDelayMs < 1) {
+            throw new NotificationRelayError("invalid_configuration");
+        }
+    }
+    run(signal) {
+        if (this.#running !== undefined)
+            throw new NotificationRelayError("already_running");
+        const controller = new AbortController();
+        this.#controller = controller;
+        this.#shutdownRequested = false;
+        const combined = AbortSignal.any([signal, controller.signal]);
+        const running = this.#execute(combined).finally(async () => {
+            await this.#closeTarget();
+            if (this.#running === running) {
+                this.#running = undefined;
+                this.#controller = undefined;
+            }
+        });
+        this.#running = running;
+        return running;
+    }
+    async shutdown() {
+        this.#shutdownRequested = true;
+        this.#controller?.abort();
+        await this.#closeTarget();
+        await this.#running;
+    }
+    #closeTarget() {
+        this.#closingTarget ??= this.#deliveryTarget.close().catch(() => undefined);
+        return this.#closingTarget;
+    }
+    async #execute(signal) {
+        try {
+            this.#journal.discardUndelivered();
+            for (const item of this.#journal.recoverableAcknowledgements()) {
+                if (signal.aborted)
+                    return;
+                await this.#acknowledge(item.messageId, signal);
+            }
+            while (!signal.aborted) {
+                let messages;
+                try {
+                    messages = await this.#receiveMessages(signal);
+                }
+                catch (error) {
+                    if (signal.aborted)
+                        return;
+                    if (!(error instanceof RetryableNotificationReceiveError))
+                        throw error;
+                    const retryAfter = error.retryAfterMs ?? this.#retryDelayMs;
+                    if (!Number.isSafeInteger(retryAfter) || retryAfter < 1) {
+                        throw new NotificationRelayError("invalid_configuration");
+                    }
+                    await delay(retryAfter, undefined, { signal }).catch(() => undefined);
+                    continue;
+                }
+                if (messages.length > MAX_MESSAGES) {
+                    throw new NotificationRelayError("invalid_notification_response");
+                }
+                const queue = messages.map(validateMessage);
+                if (Buffer.byteLength(JSON.stringify({ messages: queue.map(({ message }) => message) }), "utf8") > MAX_RESULT_BYTES) {
+                    throw new NotificationRelayError("invalid_notification_response");
+                }
+                const byId = new Map();
+                const deliveryQueue = [];
+                for (const item of queue) {
+                    if (item.message.id === undefined) {
+                        deliveryQueue.push(item);
+                        continue;
+                    }
+                    const prior = byId.get(item.message.id);
+                    if (prior !== undefined && prior !== item.serialized) {
+                        throw new NotificationRelayError("invalid_notification_response");
+                    }
+                    if (prior === undefined)
+                        deliveryQueue.push(item);
+                    byId.set(item.message.id, item.serialized);
+                }
+                try {
+                    this.#journal.ingest([...byId.keys()]);
+                }
+                catch {
+                    throw new NotificationRelayError("journal_failed");
+                }
+                for (const item of deliveryQueue) {
+                    if (signal.aborted)
+                        return;
+                    await this.#deliver(item.message, signal);
+                }
+            }
+        }
+        catch (error) {
+            if (signal.aborted || this.#shutdownRequested)
+                return;
+            if (error instanceof NotificationRelayError)
+                throw error;
+            throw new NotificationRelayError("relay_failed");
+        }
+    }
+    async #deliver(message, signal) {
+        const id = message.id;
+        if (id !== undefined) {
+            const existing = this.#journal.get(id);
+            if (existing?.deliveryState === "accepted" || existing?.deliveryState === "completed") {
+                await this.#acknowledge(id, signal);
+                return;
+            }
+            try {
+                this.#journal.beginDelivery(id);
+            }
+            catch {
+                throw new NotificationRelayError("journal_failed");
+            }
+        }
+        const result = await this.#deliveryTarget.deliver(message, signal);
+        if (id === undefined)
+            return;
+        try {
+            this.#journal.recordDelivered(id, result.status);
+        }
+        catch {
+            throw new NotificationRelayError("journal_failed");
+        }
+        await this.#acknowledge(id, signal);
+    }
+    async #acknowledge(messageId, signal) {
+        try {
+            this.#journal.beginAcknowledgement(messageId);
+        }
+        catch {
+            throw new NotificationRelayError("journal_failed");
+        }
+        await this.#acknowledgeMessage(messageId, signal);
+        try {
+            this.#journal.removeAcknowledged(messageId);
+        }
+        catch {
+            throw new NotificationRelayError("journal_failed");
+        }
+    }
+}
+//# sourceMappingURL=notification-relay.js.map

package/dist/notification-relay.js.map

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

package/dist/process-lock.d.ts

@@ -0,0 +1,8 @@
+export declare class ProcessLock {
+    private readonly database;
+    private readonly keys;
+    private released;
+    private constructor();
+    static acquire(path: string): Promise<ProcessLock>;
+    release(): Promise<void>;
+}