@fedify/postgres 0.1.0-dev.2

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright 2024 Hong Minhee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,69 @@
+<!-- deno-fmt-ignore-file -->
+
+@fedify/postgres: PostgreSQL drivers for Fedify
+===============================================
+
+[![JSR][JSR badge]][JSR]
+[![npm][npm badge]][npm]
+[![GitHub Actions][GitHub Actions badge]][GitHub Actions]
+
+This package provides [Fedify]'s [`KvStore`] and [`MessageQueue`]
+implementations for PostgreSQL:
+
+ -  [`PostgresKvStore`]
+ -  [`PostgresMessageQueue`]
+
+~~~~ typescript
+import { createFederation } from "@fedify/fedify";
+import { PostgresKvStore, PostgresMessageQueue } from "@fedify/postgres";
+import postgres from "postgres";
+
+const sql = postgres("postgresql://user:password@localhost/dbname");
+
+const federation = createFederation({
+  kv: new PostgresKvStore(sql),
+  queue: new PostgresMessageQueue(sql),
+});
+~~~~
+
+[JSR]: https://jsr.io/@fedify/postgres
+[JSR badge]: https://jsr.io/badges/@fedify/postgres
+[npm]: https://www.npmjs.com/package/@fedify/postgres
+[npm badge]: https://img.shields.io/npm/v/@fedify/postgres?logo=npm
+[GitHub Actions]: https://github.com/dahlia/fedify-postgres/actions/workflows/main.yaml
+[GitHub Actions badge]: https://github.com/dahlia/fedify-postgres/actions/workflows/main.yaml/badge.svg
+[Fedify]: https://fedify.dev/
+[`KvStore`]: https://jsr.io/@fedify/fedify/doc/federation/~/KvStore
+[`MessageQueue`]: https://jsr.io/@fedify/fedify/doc/federation/~/MessageQueue
+[`PostgresKvStore`]: https://jsr.io/@fedify/postgres/doc/federation/~/PostgresKvStore
+[`PostgresMessageQueue`]: https://jsr.io/@fedify/postgres/doc/federation/~/PostgresMessageQueue
+
+
+Installation
+------------
+
+### Deno
+
+~~~~ sh
+deno add @fedify/postgres
+~~~~
+
+### Node.js
+
+~~~~ sh
+npm install @fedify/postgres
+~~~~
+
+### Bun
+
+~~~~ sh
+bun add @fedify/postgres
+~~~~
+
+
+Changelog
+---------
+
+### Version 0.1.0
+
+To be released.

package/esm/_dnt.shims.js

@@ -0,0 +1,64 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+import { Temporal as Temporal } from "@js-temporal/polyfill";
+export { Temporal as Temporal } from "@js-temporal/polyfill";
+const dntGlobals = {
+    Deno,
+    Temporal,
+};
+export const dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
+function createMergeProxy(baseObj, extObj) {
+    return new Proxy(baseObj, {
+        get(_target, prop, _receiver) {
+            if (prop in extObj) {
+                return extObj[prop];
+            }
+            else {
+                return baseObj[prop];
+            }
+        },
+        set(_target, prop, value) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            baseObj[prop] = value;
+            return true;
+        },
+        deleteProperty(_target, prop) {
+            let success = false;
+            if (prop in extObj) {
+                delete extObj[prop];
+                success = true;
+            }
+            if (prop in baseObj) {
+                delete baseObj[prop];
+                success = true;
+            }
+            return success;
+        },
+        ownKeys(_target) {
+            const baseKeys = Reflect.ownKeys(baseObj);
+            const extKeys = Reflect.ownKeys(extObj);
+            const extKeysSet = new Set(extKeys);
+            return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
+        },
+        defineProperty(_target, prop, desc) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            Reflect.defineProperty(baseObj, prop, desc);
+            return true;
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (prop in extObj) {
+                return Reflect.getOwnPropertyDescriptor(extObj, prop);
+            }
+            else {
+                return Reflect.getOwnPropertyDescriptor(baseObj, prop);
+            }
+        },
+        has(_target, prop) {
+            return prop in extObj || prop in baseObj;
+        },
+    });
+}

package/esm/mod.js

@@ -0,0 +1 @@
+export * from "./src/mod.js";

package/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/esm/src/kv.js

@@ -0,0 +1,106 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _PostgresKvStore_instances, _PostgresKvStore_sql, _PostgresKvStore_tableName, _PostgresKvStore_initialized, _PostgresKvStore_expire;
+/**
+ * A key-value store that uses PostgreSQL as the underlying storage.
+ *
+ * @example
+ * ```ts
+ * import { createFederation } from "@fedify/fedify";
+ * import { PostgresKvStore } from "@fedify/postgres";
+ * import postgres from "postgres";
+ *
+ * const federation = createFederation({
+ *   // ...
+ *   kv: new PostgresKvStore(postgres("postgres://user:pass@localhost/db")),
+ * });
+ * ```
+ */
+export class PostgresKvStore {
+    /**
+     * Creates a new PostgreSQL key-value store.
+     * @param sql The PostgreSQL client to use.
+     * @param options The options for the key-value store.
+     */
+    constructor(
+    // deno-lint-ignore ban-types
+    sql, options = {}) {
+        _PostgresKvStore_instances.add(this);
+        // deno-lint-ignore ban-types
+        _PostgresKvStore_sql.set(this, void 0);
+        _PostgresKvStore_tableName.set(this, void 0);
+        _PostgresKvStore_initialized.set(this, void 0);
+        __classPrivateFieldSet(this, _PostgresKvStore_sql, sql, "f");
+        __classPrivateFieldSet(this, _PostgresKvStore_tableName, options.tableName ?? "fedify_kv", "f");
+        __classPrivateFieldSet(this, _PostgresKvStore_initialized, options.initialized ?? false, "f");
+    }
+    async get(key) {
+        await this.initialize();
+        const result = await __classPrivateFieldGet(this, _PostgresKvStore_sql, "f").bind(this) `
+      SELECT value
+      FROM ${__classPrivateFieldGet(this, _PostgresKvStore_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresKvStore_tableName, "f"))}
+      WHERE key = ${key} AND (ttl IS NULL OR created + ttl > CURRENT_TIMESTAMP);
+    `;
+        if (result.length < 1)
+            return undefined;
+        return JSON.parse(result[0].value);
+    }
+    async set(key, value, options) {
+        await this.initialize();
+        const ttl = options?.ttl == null ? null : options.ttl.toString();
+        await __classPrivateFieldGet(this, _PostgresKvStore_sql, "f").bind(this) `
+      INSERT INTO ${__classPrivateFieldGet(this, _PostgresKvStore_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresKvStore_tableName, "f"))} (key, value, ttl)
+      VALUES (${key}, ${JSON.stringify(value)}, ${ttl})
+      ON CONFLICT (key)
+        DO UPDATE SET value = EXCLUDED.value, ttl = EXCLUDED.ttl;
+    `;
+        await __classPrivateFieldGet(this, _PostgresKvStore_instances, "m", _PostgresKvStore_expire).call(this);
+    }
+    async delete(key) {
+        await this.initialize();
+        await __classPrivateFieldGet(this, _PostgresKvStore_sql, "f").bind(this) `
+      DELETE FROM ${__classPrivateFieldGet(this, _PostgresKvStore_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresKvStore_tableName, "f"))}
+      WHERE key = ${key};
+    `;
+        await __classPrivateFieldGet(this, _PostgresKvStore_instances, "m", _PostgresKvStore_expire).call(this);
+    }
+    /**
+     * Creates the table used by the key-value store if it does not already exist.
+     * Does nothing if the table already exists.
+     */
+    async initialize() {
+        if (__classPrivateFieldGet(this, _PostgresKvStore_initialized, "f"))
+            return;
+        await __classPrivateFieldGet(this, _PostgresKvStore_sql, "f").bind(this) `
+      CREATE UNLOGGED TABLE IF NOT EXISTS ${__classPrivateFieldGet(this, _PostgresKvStore_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresKvStore_tableName, "f"))} (
+        key text[] PRIMARY KEY,
+        value jsonb NOT NULL,
+        created timestamp with time zone DEFAULT CURRENT_TIMESTAMP,
+        ttl interval
+      );
+    `;
+        __classPrivateFieldSet(this, _PostgresKvStore_initialized, true, "f");
+    }
+    /**
+     * Drops the table used by the key-value store.  Does nothing if the table
+     * does not exist.
+     */
+    async drop() {
+        await __classPrivateFieldGet(this, _PostgresKvStore_sql, "f").bind(this) `DROP TABLE IF EXISTS ${__classPrivateFieldGet(this, _PostgresKvStore_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresKvStore_tableName, "f"))};`;
+    }
+}
+_PostgresKvStore_sql = new WeakMap(), _PostgresKvStore_tableName = new WeakMap(), _PostgresKvStore_initialized = new WeakMap(), _PostgresKvStore_instances = new WeakSet(), _PostgresKvStore_expire = async function _PostgresKvStore_expire() {
+    await __classPrivateFieldGet(this, _PostgresKvStore_sql, "f").bind(this) `
+      DELETE FROM ${__classPrivateFieldGet(this, _PostgresKvStore_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresKvStore_tableName, "f"))}
+      WHERE ttl IS NOT NULL AND created + ttl < CURRENT_TIMESTAMP;
+    `;
+};

package/esm/src/mod.js

@@ -0,0 +1,2 @@
+export * from "./kv.js";
+export * from "./mq.js";

package/esm/src/mq.js

@@ -0,0 +1,142 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _PostgresMessageQueue_sql, _PostgresMessageQueue_tableName, _PostgresMessageQueue_channelName, _PostgresMessageQueue_pollIntervalMs, _PostgresMessageQueue_initialized;
+import * as dntShim from "../_dnt.shims.js";
+/**
+ * A message queue that uses PostgreSQL as the underlying storage.
+ *
+ * @example
+ * ```ts
+ * import { createFederation } from "@fedify/fedify";
+ * import { PostgresMessageQueue } from "@fedify/postgres";
+ * import postgres from "postgres";
+ *
+ * const federation = createFederation({
+ *   // ...
+ *   queue: new PostgresMessageQueue(
+ *     postgres("postgres://user:pass@localhost/db")
+ *   ),
+ * });
+ * ```
+ */
+export class PostgresMessageQueue {
+    constructor(
+    // deno-lint-ignore ban-types
+    sql, options = {}) {
+        // deno-lint-ignore ban-types
+        _PostgresMessageQueue_sql.set(this, void 0);
+        _PostgresMessageQueue_tableName.set(this, void 0);
+        _PostgresMessageQueue_channelName.set(this, void 0);
+        _PostgresMessageQueue_pollIntervalMs.set(this, void 0);
+        _PostgresMessageQueue_initialized.set(this, void 0);
+        __classPrivateFieldSet(this, _PostgresMessageQueue_sql, sql, "f");
+        __classPrivateFieldSet(this, _PostgresMessageQueue_tableName, options?.tableName ?? "fedify_message", "f");
+        __classPrivateFieldSet(this, _PostgresMessageQueue_channelName, options?.channelName ?? "fedify_channel", "f");
+        __classPrivateFieldSet(this, _PostgresMessageQueue_pollIntervalMs, dntShim.Temporal.Duration.from(options?.pollInterval ?? { seconds: 5 }).total("millisecond"), "f");
+        __classPrivateFieldSet(this, _PostgresMessageQueue_initialized, options?.initialized ?? false, "f");
+    }
+    async enqueue(
+    // deno-lint-ignore no-explicit-any
+    message, options) {
+        await this.initialize();
+        const delay = options?.delay ?? dntShim.Temporal.Duration.from({ seconds: 0 });
+        await __classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").bind(this) `
+      INSERT INTO ${__classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresMessageQueue_tableName, "f"))} (message, delay)
+      VALUES (${JSON.stringify(message)}, ${delay.toString()});
+    `;
+        await __classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").notify(__classPrivateFieldGet(this, _PostgresMessageQueue_channelName, "f"), delay.toString());
+    }
+    async listen(
+    // deno-lint-ignore no-explicit-any
+    handler, options = {}) {
+        const { signal } = options;
+        const poll = async () => {
+            if (signal?.aborted)
+                return;
+            const query = __classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").bind(this) `
+        DELETE FROM ${__classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresMessageQueue_tableName, "f"))}
+        WHERE id = (
+          SELECT id
+          FROM ${__classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresMessageQueue_tableName, "f"))}
+          WHERE created + delay < CURRENT_TIMESTAMP
+          ORDER BY created
+          LIMIT 1
+        )
+        RETURNING message;
+      `.execute();
+            const cancel = query.cancel.bind(query);
+            signal?.addEventListener("abort", cancel);
+            for (const message of await query) {
+                if (signal?.aborted)
+                    return;
+                await handler(JSON.parse(message.message));
+            }
+            signal?.removeEventListener("abort", cancel);
+        };
+        const timeouts = new Set();
+        const listen = await __classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").listen(__classPrivateFieldGet(this, _PostgresMessageQueue_channelName, "f"), async (delay) => {
+            const duration = dntShim.Temporal.Duration.from(delay);
+            const durationMs = duration.total("millisecond");
+            if (durationMs < 1)
+                await poll();
+            else
+                timeouts.add(setTimeout(poll, durationMs));
+        }, poll);
+        signal?.addEventListener("abort", () => {
+            listen.unlisten();
+            for (const timeout of timeouts)
+                clearTimeout(timeout);
+        });
+        while (!signal?.aborted) {
+            let timeout;
+            await new Promise((resolve) => {
+                signal?.addEventListener("abort", resolve);
+                timeout = setTimeout(() => {
+                    signal?.removeEventListener("abort", resolve);
+                    resolve(0);
+                }, __classPrivateFieldGet(this, _PostgresMessageQueue_pollIntervalMs, "f"));
+                timeouts.add(timeout);
+            });
+            if (timeout != null)
+                timeouts.delete(timeout);
+            await poll();
+        }
+        await new Promise((resolve) => {
+            signal?.addEventListener("abort", () => resolve());
+            if (signal?.aborted)
+                return resolve();
+        });
+    }
+    /**
+     * Initializes the message queue table if it does not already exist.
+     */
+    async initialize() {
+        if (__classPrivateFieldGet(this, _PostgresMessageQueue_initialized, "f"))
+            return;
+        await __classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").bind(this) `
+      CREATE TABLE IF NOT EXISTS ${__classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresMessageQueue_tableName, "f"))} (
+        id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+        message jsonb NOT NULL,
+        delay interval DEFAULT '0 seconds',
+        created timestamp with time zone DEFAULT CURRENT_TIMESTAMP
+      );
+    `;
+        __classPrivateFieldSet(this, _PostgresMessageQueue_initialized, true, "f");
+    }
+    /**
+     * Drops the message queue table if it exists.
+     */
+    async drop() {
+        await __classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").bind(this) `DROP TABLE IF EXISTS ${__classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresMessageQueue_tableName, "f"))};`;
+    }
+}
+_PostgresMessageQueue_sql = new WeakMap(), _PostgresMessageQueue_tableName = new WeakMap(), _PostgresMessageQueue_channelName = new WeakMap(), _PostgresMessageQueue_pollIntervalMs = new WeakMap(), _PostgresMessageQueue_initialized = new WeakMap();

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@fedify/postgres",
+  "version": "0.1.0-dev.2+463ee4d6",
+  "description": "PostgreSQL drivers for Fedify",
+  "keywords": [
+    "fedify",
+    "postgresql",
+    "postgres"
+  ],
+  "author": {
+    "name": "Hong Minhee",
+    "email": "hong@minhee.org",
+    "url": "https://hongminhee.org/"
+  },
+  "homepage": "https://github.com/dahlia/fedify-postgres",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dahlia/fedify-postgres.git"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/dahlia/fedify-postgres/issues"
+  },
+  "main": "./script/mod.js",
+  "module": "./esm/mod.js",
+  "types": "./types/mod.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./types/mod.d.ts",
+        "default": "./esm/mod.js"
+      },
+      "require": {
+        "types": "./types/mod.d.ts",
+        "default": "./script/mod.js"
+      }
+    },
+    "./kv": {
+      "import": {
+        "types": "./types/src/kv.d.ts",
+        "default": "./esm/src/kv.js"
+      },
+      "require": {
+        "types": "./types/src/kv.d.ts",
+        "default": "./script/src/kv.js"
+      }
+    },
+    "./mq": {
+      "import": {
+        "types": "./types/src/mq.d.ts",
+        "default": "./esm/src/mq.js"
+      },
+      "require": {
+        "types": "./types/src/mq.d.ts",
+        "default": "./script/src/mq.js"
+      }
+    }
+  },
+  "funding": [
+    "https://github.com/sponsors/dahlia"
+  ],
+  "dependencies": {
+    "@fedify/fedify": "^1.0.0-dev.410+8793b61b",
+    "postgres": "^3.4.4",
+    "@deno/shim-deno": "~0.18.0",
+    "@js-temporal/polyfill": "^0.4.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.9.0"
+  },
+  "_generatedBy": "dnt@dev"
+}

package/script/_dnt.shims.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dntGlobalThis = exports.Temporal = exports.Deno = void 0;
+const shim_deno_1 = require("@deno/shim-deno");
+var shim_deno_2 = require("@deno/shim-deno");
+Object.defineProperty(exports, "Deno", { enumerable: true, get: function () { return shim_deno_2.Deno; } });
+const polyfill_1 = require("@js-temporal/polyfill");
+var polyfill_2 = require("@js-temporal/polyfill");
+Object.defineProperty(exports, "Temporal", { enumerable: true, get: function () { return polyfill_2.Temporal; } });
+const dntGlobals = {
+    Deno: shim_deno_1.Deno,
+    Temporal: polyfill_1.Temporal,
+};
+exports.dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
+function createMergeProxy(baseObj, extObj) {
+    return new Proxy(baseObj, {
+        get(_target, prop, _receiver) {
+            if (prop in extObj) {
+                return extObj[prop];
+            }
+            else {
+                return baseObj[prop];
+            }
+        },
+        set(_target, prop, value) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            baseObj[prop] = value;
+            return true;
+        },
+        deleteProperty(_target, prop) {
+            let success = false;
+            if (prop in extObj) {
+                delete extObj[prop];
+                success = true;
+            }
+            if (prop in baseObj) {
+                delete baseObj[prop];
+                success = true;
+            }
+            return success;
+        },
+        ownKeys(_target) {
+            const baseKeys = Reflect.ownKeys(baseObj);
+            const extKeys = Reflect.ownKeys(extObj);
+            const extKeysSet = new Set(extKeys);
+            return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
+        },
+        defineProperty(_target, prop, desc) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            Reflect.defineProperty(baseObj, prop, desc);
+            return true;
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (prop in extObj) {
+                return Reflect.getOwnPropertyDescriptor(extObj, prop);
+            }
+            else {
+                return Reflect.getOwnPropertyDescriptor(baseObj, prop);
+            }
+        },
+        has(_target, prop) {
+            return prop in extObj || prop in baseObj;
+        },
+    });
+}

package/script/mod.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./src/mod.js"), exports);

package/script/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/script/src/kv.js

@@ -0,0 +1,110 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _PostgresKvStore_instances, _PostgresKvStore_sql, _PostgresKvStore_tableName, _PostgresKvStore_initialized, _PostgresKvStore_expire;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresKvStore = void 0;
+/**
+ * A key-value store that uses PostgreSQL as the underlying storage.
+ *
+ * @example
+ * ```ts
+ * import { createFederation } from "@fedify/fedify";
+ * import { PostgresKvStore } from "@fedify/postgres";
+ * import postgres from "postgres";
+ *
+ * const federation = createFederation({
+ *   // ...
+ *   kv: new PostgresKvStore(postgres("postgres://user:pass@localhost/db")),
+ * });
+ * ```
+ */
+class PostgresKvStore {
+    /**
+     * Creates a new PostgreSQL key-value store.
+     * @param sql The PostgreSQL client to use.
+     * @param options The options for the key-value store.
+     */
+    constructor(
+    // deno-lint-ignore ban-types
+    sql, options = {}) {
+        _PostgresKvStore_instances.add(this);
+        // deno-lint-ignore ban-types
+        _PostgresKvStore_sql.set(this, void 0);
+        _PostgresKvStore_tableName.set(this, void 0);
+        _PostgresKvStore_initialized.set(this, void 0);
+        __classPrivateFieldSet(this, _PostgresKvStore_sql, sql, "f");
+        __classPrivateFieldSet(this, _PostgresKvStore_tableName, options.tableName ?? "fedify_kv", "f");
+        __classPrivateFieldSet(this, _PostgresKvStore_initialized, options.initialized ?? false, "f");
+    }
+    async get(key) {
+        await this.initialize();
+        const result = await __classPrivateFieldGet(this, _PostgresKvStore_sql, "f").bind(this) `
+      SELECT value
+      FROM ${__classPrivateFieldGet(this, _PostgresKvStore_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresKvStore_tableName, "f"))}
+      WHERE key = ${key} AND (ttl IS NULL OR created + ttl > CURRENT_TIMESTAMP);
+    `;
+        if (result.length < 1)
+            return undefined;
+        return JSON.parse(result[0].value);
+    }
+    async set(key, value, options) {
+        await this.initialize();
+        const ttl = options?.ttl == null ? null : options.ttl.toString();
+        await __classPrivateFieldGet(this, _PostgresKvStore_sql, "f").bind(this) `
+      INSERT INTO ${__classPrivateFieldGet(this, _PostgresKvStore_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresKvStore_tableName, "f"))} (key, value, ttl)
+      VALUES (${key}, ${JSON.stringify(value)}, ${ttl})
+      ON CONFLICT (key)
+        DO UPDATE SET value = EXCLUDED.value, ttl = EXCLUDED.ttl;
+    `;
+        await __classPrivateFieldGet(this, _PostgresKvStore_instances, "m", _PostgresKvStore_expire).call(this);
+    }
+    async delete(key) {
+        await this.initialize();
+        await __classPrivateFieldGet(this, _PostgresKvStore_sql, "f").bind(this) `
+      DELETE FROM ${__classPrivateFieldGet(this, _PostgresKvStore_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresKvStore_tableName, "f"))}
+      WHERE key = ${key};
+    `;
+        await __classPrivateFieldGet(this, _PostgresKvStore_instances, "m", _PostgresKvStore_expire).call(this);
+    }
+    /**
+     * Creates the table used by the key-value store if it does not already exist.
+     * Does nothing if the table already exists.
+     */
+    async initialize() {
+        if (__classPrivateFieldGet(this, _PostgresKvStore_initialized, "f"))
+            return;
+        await __classPrivateFieldGet(this, _PostgresKvStore_sql, "f").bind(this) `
+      CREATE UNLOGGED TABLE IF NOT EXISTS ${__classPrivateFieldGet(this, _PostgresKvStore_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresKvStore_tableName, "f"))} (
+        key text[] PRIMARY KEY,
+        value jsonb NOT NULL,
+        created timestamp with time zone DEFAULT CURRENT_TIMESTAMP,
+        ttl interval
+      );
+    `;
+        __classPrivateFieldSet(this, _PostgresKvStore_initialized, true, "f");
+    }
+    /**
+     * Drops the table used by the key-value store.  Does nothing if the table
+     * does not exist.
+     */
+    async drop() {
+        await __classPrivateFieldGet(this, _PostgresKvStore_sql, "f").bind(this) `DROP TABLE IF EXISTS ${__classPrivateFieldGet(this, _PostgresKvStore_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresKvStore_tableName, "f"))};`;
+    }
+}
+exports.PostgresKvStore = PostgresKvStore;
+_PostgresKvStore_sql = new WeakMap(), _PostgresKvStore_tableName = new WeakMap(), _PostgresKvStore_initialized = new WeakMap(), _PostgresKvStore_instances = new WeakSet(), _PostgresKvStore_expire = async function _PostgresKvStore_expire() {
+    await __classPrivateFieldGet(this, _PostgresKvStore_sql, "f").bind(this) `
+      DELETE FROM ${__classPrivateFieldGet(this, _PostgresKvStore_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresKvStore_tableName, "f"))}
+      WHERE ttl IS NOT NULL AND created + ttl < CURRENT_TIMESTAMP;
+    `;
+};

package/script/src/mod.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./kv.js"), exports);
+__exportStar(require("./mq.js"), exports);

package/script/src/mq.js

@@ -0,0 +1,169 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _PostgresMessageQueue_sql, _PostgresMessageQueue_tableName, _PostgresMessageQueue_channelName, _PostgresMessageQueue_pollIntervalMs, _PostgresMessageQueue_initialized;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresMessageQueue = void 0;
+const dntShim = __importStar(require("../_dnt.shims.js"));
+/**
+ * A message queue that uses PostgreSQL as the underlying storage.
+ *
+ * @example
+ * ```ts
+ * import { createFederation } from "@fedify/fedify";
+ * import { PostgresMessageQueue } from "@fedify/postgres";
+ * import postgres from "postgres";
+ *
+ * const federation = createFederation({
+ *   // ...
+ *   queue: new PostgresMessageQueue(
+ *     postgres("postgres://user:pass@localhost/db")
+ *   ),
+ * });
+ * ```
+ */
+class PostgresMessageQueue {
+    constructor(
+    // deno-lint-ignore ban-types
+    sql, options = {}) {
+        // deno-lint-ignore ban-types
+        _PostgresMessageQueue_sql.set(this, void 0);
+        _PostgresMessageQueue_tableName.set(this, void 0);
+        _PostgresMessageQueue_channelName.set(this, void 0);
+        _PostgresMessageQueue_pollIntervalMs.set(this, void 0);
+        _PostgresMessageQueue_initialized.set(this, void 0);
+        __classPrivateFieldSet(this, _PostgresMessageQueue_sql, sql, "f");
+        __classPrivateFieldSet(this, _PostgresMessageQueue_tableName, options?.tableName ?? "fedify_message", "f");
+        __classPrivateFieldSet(this, _PostgresMessageQueue_channelName, options?.channelName ?? "fedify_channel", "f");
+        __classPrivateFieldSet(this, _PostgresMessageQueue_pollIntervalMs, dntShim.Temporal.Duration.from(options?.pollInterval ?? { seconds: 5 }).total("millisecond"), "f");
+        __classPrivateFieldSet(this, _PostgresMessageQueue_initialized, options?.initialized ?? false, "f");
+    }
+    async enqueue(
+    // deno-lint-ignore no-explicit-any
+    message, options) {
+        await this.initialize();
+        const delay = options?.delay ?? dntShim.Temporal.Duration.from({ seconds: 0 });
+        await __classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").bind(this) `
+      INSERT INTO ${__classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresMessageQueue_tableName, "f"))} (message, delay)
+      VALUES (${JSON.stringify(message)}, ${delay.toString()});
+    `;
+        await __classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").notify(__classPrivateFieldGet(this, _PostgresMessageQueue_channelName, "f"), delay.toString());
+    }
+    async listen(
+    // deno-lint-ignore no-explicit-any
+    handler, options = {}) {
+        const { signal } = options;
+        const poll = async () => {
+            if (signal?.aborted)
+                return;
+            const query = __classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").bind(this) `
+        DELETE FROM ${__classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresMessageQueue_tableName, "f"))}
+        WHERE id = (
+          SELECT id
+          FROM ${__classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresMessageQueue_tableName, "f"))}
+          WHERE created + delay < CURRENT_TIMESTAMP
+          ORDER BY created
+          LIMIT 1
+        )
+        RETURNING message;
+      `.execute();
+            const cancel = query.cancel.bind(query);
+            signal?.addEventListener("abort", cancel);
+            for (const message of await query) {
+                if (signal?.aborted)
+                    return;
+                await handler(JSON.parse(message.message));
+            }
+            signal?.removeEventListener("abort", cancel);
+        };
+        const timeouts = new Set();
+        const listen = await __classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").listen(__classPrivateFieldGet(this, _PostgresMessageQueue_channelName, "f"), async (delay) => {
+            const duration = dntShim.Temporal.Duration.from(delay);
+            const durationMs = duration.total("millisecond");
+            if (durationMs < 1)
+                await poll();
+            else
+                timeouts.add(setTimeout(poll, durationMs));
+        }, poll);
+        signal?.addEventListener("abort", () => {
+            listen.unlisten();
+            for (const timeout of timeouts)
+                clearTimeout(timeout);
+        });
+        while (!signal?.aborted) {
+            let timeout;
+            await new Promise((resolve) => {
+                signal?.addEventListener("abort", resolve);
+                timeout = setTimeout(() => {
+                    signal?.removeEventListener("abort", resolve);
+                    resolve(0);
+                }, __classPrivateFieldGet(this, _PostgresMessageQueue_pollIntervalMs, "f"));
+                timeouts.add(timeout);
+            });
+            if (timeout != null)
+                timeouts.delete(timeout);
+            await poll();
+        }
+        await new Promise((resolve) => {
+            signal?.addEventListener("abort", () => resolve());
+            if (signal?.aborted)
+                return resolve();
+        });
+    }
+    /**
+     * Initializes the message queue table if it does not already exist.
+     */
+    async initialize() {
+        if (__classPrivateFieldGet(this, _PostgresMessageQueue_initialized, "f"))
+            return;
+        await __classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").bind(this) `
+      CREATE TABLE IF NOT EXISTS ${__classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresMessageQueue_tableName, "f"))} (
+        id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+        message jsonb NOT NULL,
+        delay interval DEFAULT '0 seconds',
+        created timestamp with time zone DEFAULT CURRENT_TIMESTAMP
+      );
+    `;
+        __classPrivateFieldSet(this, _PostgresMessageQueue_initialized, true, "f");
+    }
+    /**
+     * Drops the message queue table if it exists.
+     */
+    async drop() {
+        await __classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").bind(this) `DROP TABLE IF EXISTS ${__classPrivateFieldGet(this, _PostgresMessageQueue_sql, "f").call(this, __classPrivateFieldGet(this, _PostgresMessageQueue_tableName, "f"))};`;
+    }
+}
+exports.PostgresMessageQueue = PostgresMessageQueue;
+_PostgresMessageQueue_sql = new WeakMap(), _PostgresMessageQueue_tableName = new WeakMap(), _PostgresMessageQueue_channelName = new WeakMap(), _PostgresMessageQueue_pollIntervalMs = new WeakMap(), _PostgresMessageQueue_initialized = new WeakMap();

package/types/_dnt.shims.d.ts

@@ -0,0 +1,9 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+import { Temporal as Temporal } from "@js-temporal/polyfill";
+export { Temporal as Temporal } from "@js-temporal/polyfill";
+export declare const dntGlobalThis: Omit<typeof globalThis, "Deno" | "Temporal"> & {
+    Deno: typeof Deno;
+    Temporal: typeof Temporal;
+};
+//# sourceMappingURL=_dnt.shims.d.ts.map

package/types/_dnt.shims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.shims.d.ts","sourceRoot":"","sources":["../src/_dnt.shims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,QAAQ,IAAI,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,QAAQ,IAAI,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAM7D,eAAO,MAAM,aAAa;;;CAA2C,CAAC"}

package/types/mod.d.ts

@@ -0,0 +1,2 @@
+export * from "./src/mod.js";
+//# sourceMappingURL=mod.d.ts.map

package/types/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/types/src/kv.d.ts

@@ -0,0 +1,55 @@
+import type { KvKey, KvStore, KvStoreSetOptions } from "@fedify/fedify";
+import type { Sql } from "postgres";
+/**
+ * Options for the PostgreSQL key-value store.
+ */
+export interface PostgresKvStoreOptions {
+    /**
+     * The table name to use for the key-value store.  `"fedify_kv"` by default.
+     * @default `"fedify_kv"`
+     */
+    tableName?: string;
+    /**
+     * Whether the table has been initialized.  `false` by default.
+     * @default `false`
+     */
+    initialized?: boolean;
+}
+/**
+ * A key-value store that uses PostgreSQL as the underlying storage.
+ *
+ * @example
+ * ```ts
+ * import { createFederation } from "@fedify/fedify";
+ * import { PostgresKvStore } from "@fedify/postgres";
+ * import postgres from "postgres";
+ *
+ * const federation = createFederation({
+ *   // ...
+ *   kv: new PostgresKvStore(postgres("postgres://user:pass@localhost/db")),
+ * });
+ * ```
+ */
+export declare class PostgresKvStore implements KvStore {
+    #private;
+    /**
+     * Creates a new PostgreSQL key-value store.
+     * @param sql The PostgreSQL client to use.
+     * @param options The options for the key-value store.
+     */
+    constructor(sql: Sql<{}>, options?: PostgresKvStoreOptions);
+    get<T = unknown>(key: KvKey): Promise<T | undefined>;
+    set(key: KvKey, value: unknown, options?: KvStoreSetOptions | undefined): Promise<void>;
+    delete(key: KvKey): Promise<void>;
+    /**
+     * Creates the table used by the key-value store if it does not already exist.
+     * Does nothing if the table already exists.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Drops the table used by the key-value store.  Does nothing if the table
+     * does not exist.
+     */
+    drop(): Promise<void>;
+}
+//# sourceMappingURL=kv.d.ts.map

package/types/src/kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../../src/src/kv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAgB,YAAW,OAAO;;IAM7C;;;;OAIG;gBAGD,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,EACZ,OAAO,GAAE,sBAA2B;IAchC,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAWpD,GAAG,CACP,GAAG,EAAE,KAAK,EACV,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,iBAAiB,GAAG,SAAS,GACtC,OAAO,CAAC,IAAI,CAAC;IAYV,MAAM,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IASvC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/types/src/mod.d.ts

@@ -0,0 +1,3 @@
+export * from "./kv.js";
+export * from "./mq.js";
+//# sourceMappingURL=mod.d.ts.map

package/types/src/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/src/mod.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/types/src/mq.d.ts

@@ -0,0 +1,62 @@
+import * as dntShim from "../_dnt.shims.js";
+import type { MessageQueue, MessageQueueEnqueueOptions, MessageQueueListenOptions } from "@fedify/fedify";
+import type { Sql } from "postgres";
+/**
+ * Options for the PostgreSQL message queue.
+ */
+export interface PostgresMessageQueueOptions {
+    /**
+     * The table name to use for the message queue.
+     * `"fedify_message"` by default.
+     * @default `"fedify_message"`
+     */
+    tableName?: string;
+    /**
+     * The channel name to use for the message queue.
+     * `"fedify_channel"` by default.
+     * @default `"fedify_channel"`
+     */
+    channelName?: string;
+    /**
+     * Whether the table has been initialized.  `false` by default.
+     * @default `false`
+     */
+    initialized?: boolean;
+    /**
+     * The poll interval for the message queue.  5 seconds by default.
+     * @default `{ seconds: 5 }`
+     */
+    pollInterval?: dntShim.Temporal.Duration | dntShim.Temporal.DurationLike;
+}
+/**
+ * A message queue that uses PostgreSQL as the underlying storage.
+ *
+ * @example
+ * ```ts
+ * import { createFederation } from "@fedify/fedify";
+ * import { PostgresMessageQueue } from "@fedify/postgres";
+ * import postgres from "postgres";
+ *
+ * const federation = createFederation({
+ *   // ...
+ *   queue: new PostgresMessageQueue(
+ *     postgres("postgres://user:pass@localhost/db")
+ *   ),
+ * });
+ * ```
+ */
+export declare class PostgresMessageQueue implements MessageQueue {
+    #private;
+    constructor(sql: Sql<{}>, options?: PostgresMessageQueueOptions);
+    enqueue(message: any, options?: MessageQueueEnqueueOptions): Promise<void>;
+    listen(handler: (message: any) => void | Promise<void>, options?: MessageQueueListenOptions): Promise<void>;
+    /**
+     * Initializes the message queue table if it does not already exist.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Drops the message queue table if it exists.
+     */
+    drop(): Promise<void>;
+}
+//# sourceMappingURL=mq.d.ts.map

package/types/src/mq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mq.d.ts","sourceRoot":"","sources":["../../src/src/mq.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,EACV,YAAY,EACZ,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;CAC1E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,oBAAqB,YAAW,YAAY;;gBAUrD,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,EACZ,OAAO,GAAE,2BAAgC;IAWrC,OAAO,CAEX,OAAO,EAAE,GAAG,EACZ,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,IAAI,CAAC;IAUV,MAAM,CAEV,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC/C,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,IAAI,CAAC;IAyDhB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}