@seriousme/opifex 1.11.3 → 2.0.3

package/dist/persistence/sqlite/sqliteDatabase.d.ts

@@ -0,0 +1,46 @@
+import sqlite from "node:sqlite";
+import type { ClientId } from "../../mqttPacket/types.ts";
+/**
+ * Instantiates the physical relational structures and schemas required by the persistence engine.
+ * @param filename Filepath location or memory target specifier.
+ */
+export declare function initializeDatabase(filename: string): sqlite.DatabaseSync;
+export type AllStatements = {
+    saveSession: sqlite.StatementSync;
+    getSession: sqlite.StatementSync;
+    listAllSessions: sqlite.StatementSync;
+    saveSubscription: sqlite.StatementSync;
+    deleteSubscription: sqlite.StatementSync;
+    listSubscriptions: sqlite.StatementSync;
+    listAllSubscriptions: sqlite.StatementSync;
+    saveIncoming: sqlite.StatementSync;
+    getIncoming: sqlite.StatementSync;
+    updateIncomingDup: sqlite.StatementSync;
+    deleteIncoming: sqlite.StatementSync;
+    listIncoming: sqlite.StatementSync;
+    saveOutgoing: sqlite.StatementSync;
+    getOutgoing: sqlite.StatementSync;
+    updateOutgoingDup: sqlite.StatementSync;
+    deleteOutgoing: sqlite.StatementSync;
+    listOutgoing: sqlite.StatementSync;
+    saveAck: sqlite.StatementSync;
+    hasAck: sqlite.StatementSync;
+    deleteAck: sqlite.StatementSync;
+    listAcks: sqlite.StatementSync;
+    saveRetained: sqlite.StatementSync;
+    deleteRetained: sqlite.StatementSync;
+    getRetainedExact: sqlite.StatementSync;
+    listRetainedLike: sqlite.StatementSync;
+};
+/**
+ * Instantiates the physical relational structures and schemas required by the persistence engine.
+ * @param db  the database for which to prepare the statements
+ */
+export declare function prepareAllStatements(db: sqlite.DatabaseSync): AllStatements;
+/**
+ * Truncates and drops relational state assignments under targeted clients inside atomic scopes.
+ * @param db Connection reference context.
+ * @param clientId Specific target client ID tracking token.
+ */
+export declare function deleteClientState(db: sqlite.DatabaseSync, clientId: ClientId): void;
+//# sourceMappingURL=sqliteDatabase.d.ts.map

package/dist/persistence/sqlite/sqliteDatabase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteDatabase.d.ts","sourceRoot":"","sources":["../../../persistence/sqlite/sqliteDatabase.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,CAoDxE;AAED,MAAM,MAAM,aAAa,GAAG;IAE1B,WAAW,EAAE,MAAM,CAAC,aAAa,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC,aAAa,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC,aAAa,CAAC;IAGtC,gBAAgB,EAAE,MAAM,CAAC,aAAa,CAAC;IACvC,kBAAkB,EAAE,MAAM,CAAC,aAAa,CAAC;IACzC,iBAAiB,EAAE,MAAM,CAAC,aAAa,CAAC;IACxC,oBAAoB,EAAE,MAAM,CAAC,aAAa,CAAC;IAG3C,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC,aAAa,CAAC;IAClC,iBAAiB,EAAE,MAAM,CAAC,aAAa,CAAC;IACxC,cAAc,EAAE,MAAM,CAAC,aAAa,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC;IAGnC,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC,aAAa,CAAC;IAClC,iBAAiB,EAAE,MAAM,CAAC,aAAa,CAAC;IACxC,cAAc,EAAE,MAAM,CAAC,aAAa,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC;IAGnC,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC,aAAa,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC,aAAa,CAAC;IAG/B,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC,aAAa,CAAC;IACrC,gBAAgB,EAAE,MAAM,CAAC,aAAa,CAAC;IACvC,gBAAgB,EAAE,MAAM,CAAC,aAAa,CAAC;CACxC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,CAAC,YAAY,GAAG,aAAa,CAiK3E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,CAAC,YAAY,EACvB,QAAQ,EAAE,QAAQ,GACjB,IAAI,CAkBN"}

package/dist/persistence/sqlite/sqliteDatabase.js

@@ -0,0 +1,215 @@
+import sqlite from "node:sqlite";
+/**
+ * Instantiates the physical relational structures and schemas required by the persistence engine.
+ * @param filename Filepath location or memory target specifier.
+ */
+export function initializeDatabase(filename) {
+    const db = new sqlite.DatabaseSync(filename);
+    db.exec(`
+    PRAGMA journal_mode = WAL;
+    PRAGMA synchronous = NORMAL;
+    
+    CREATE TABLE IF NOT EXISTS client_sessions (
+      client_id    TEXT PRIMARY KEY,
+      session_data TEXT NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS subscriptions (
+      client_id         TEXT NOT NULL,
+      topic             TEXT NOT NULL,
+      share_name        TEXT NOT NULL,
+      subscription_data TEXT NOT NULL,
+      PRIMARY KEY (client_id, topic, share_name)
+    );
+
+    CREATE TABLE IF NOT EXISTS pending_incoming (
+      seq_id     INTEGER PRIMARY KEY AUTOINCREMENT, -- Guarantees absolute insertion order
+      client_id  TEXT NOT NULL,
+      packet_id  INTEGER NOT NULL,
+      packet     TEXT NOT NULL,
+      payload    BLOB,
+      created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+      UNIQUE (client_id, packet_id)
+    );
+
+    CREATE TABLE IF NOT EXISTS pending_outgoing (
+      seq_id     INTEGER PRIMARY KEY AUTOINCREMENT, -- Guarantees absolute insertion order
+      client_id  TEXT NOT NULL,
+      packet_id  INTEGER NOT NULL,
+      packet     TEXT NOT NULL,
+      payload    BLOB,
+      created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+      UNIQUE (client_id, packet_id)
+    );
+
+    CREATE TABLE IF NOT EXISTS pending_ack_outgoing (
+      client_id TEXT NOT NULL,
+      packet_id INTEGER NOT NULL,
+      PRIMARY KEY (client_id, packet_id)
+    );
+
+    CREATE TABLE IF NOT EXISTS retained (
+      topic   TEXT PRIMARY KEY,
+      packet  TEXT NOT NULL,
+      payload BLOB
+    );
+  `);
+    return db;
+}
+/**
+ * Instantiates the physical relational structures and schemas required by the persistence engine.
+ * @param db  the database for which to prepare the statements
+ */
+export function prepareAllStatements(db) {
+    return {
+        // Sessions
+        saveSession: db.prepare(`
+      INSERT INTO client_sessions (client_id, session_data) 
+      VALUES (?, ?)
+      ON CONFLICT(client_id) DO UPDATE SET 
+        session_data = excluded.session_data
+    `),
+        getSession: db.prepare(`
+      SELECT session_data 
+      FROM client_sessions 
+      WHERE client_id = ?
+    `),
+        listAllSessions: db.prepare(`
+      SELECT client_id, session_data 
+      FROM client_sessions 
+    `),
+        // Subscriptions
+        saveSubscription: db.prepare(`
+      INSERT INTO subscriptions (client_id, topic, share_name, subscription_data) 
+      VALUES (?, ?, ?, ?)
+      ON CONFLICT(client_id, topic, share_name) DO UPDATE SET 
+        subscription_data = excluded.subscription_data
+    `),
+        deleteSubscription: db.prepare(`
+      DELETE FROM subscriptions 
+      WHERE client_id = ? AND topic = ? AND share_name = ?
+    `),
+        listSubscriptions: db.prepare(`
+      SELECT topic, share_name, subscription_data 
+      FROM subscriptions 
+      WHERE client_id = ?
+    `),
+        listAllSubscriptions: db.prepare(`
+      SELECT client_id, topic, share_name, subscription_data 
+      FROM subscriptions
+    `),
+        // Pending Incoming Packets
+        saveIncoming: db.prepare(`
+      INSERT INTO pending_incoming (client_id, packet_id, packet, payload)
+      VALUES (?, ?, ?, ?)
+      ON CONFLICT(client_id, packet_id) DO UPDATE SET 
+        packet = excluded.packet, 
+        payload = excluded.payload
+    `),
+        getIncoming: db.prepare(`
+      SELECT packet, payload
+      FROM pending_incoming 
+      WHERE client_id = ? AND packet_id = ?
+    `),
+        updateIncomingDup: db.prepare(`
+      UPDATE pending_incoming 
+      SET packet = json_set(packet, '$.dup', json(?)) 
+      WHERE client_id = ? AND packet_id = ?
+    `),
+        deleteIncoming: db.prepare(`
+      DELETE FROM pending_incoming 
+      WHERE client_id = ? AND packet_id = ?
+    `),
+        listIncoming: db.prepare(`
+      SELECT packet, payload
+      FROM pending_incoming 
+      WHERE client_id = ? 
+      ORDER BY seq_id ASC
+    `),
+        // Pending Outgoing Packets
+        saveOutgoing: db.prepare(`
+      INSERT INTO pending_outgoing (client_id, packet_id, packet, payload)
+      VALUES (?, ?, ?, ?)
+      ON CONFLICT(client_id, packet_id) DO UPDATE SET 
+        packet = excluded.packet, 
+        payload = excluded.payload
+    `),
+        getOutgoing: db.prepare(`
+      SELECT packet, payload
+      FROM pending_outgoing 
+      WHERE client_id = ? AND packet_id = ?
+    `),
+        updateOutgoingDup: db.prepare(`
+      UPDATE pending_outgoing 
+      SET packet = json_set(packet, '$.dup', json(?)) 
+      WHERE client_id = ? AND packet_id = ?
+    `),
+        deleteOutgoing: db.prepare(`
+      DELETE FROM pending_outgoing 
+      WHERE client_id = ? AND packet_id = ?
+    `),
+        listOutgoing: db.prepare(`
+      SELECT packet, payload
+      FROM pending_outgoing 
+      WHERE client_id = ? 
+      ORDER BY seq_id ASC
+    `),
+        // ACKs
+        saveAck: db.prepare(`
+      INSERT INTO pending_ack_outgoing (client_id, packet_id)
+      VALUES (?, ?)
+      ON CONFLICT(client_id, packet_id) DO NOTHING
+    `),
+        hasAck: db.prepare(`
+      SELECT 1 
+      FROM pending_ack_outgoing 
+      WHERE client_id = ? AND packet_id = ?
+    `),
+        deleteAck: db.prepare(`
+      DELETE FROM pending_ack_outgoing 
+      WHERE client_id = ? AND packet_id = ?
+    `),
+        listAcks: db.prepare(`
+      SELECT packet_id 
+      FROM pending_ack_outgoing 
+      WHERE client_id = ?
+    `),
+        // Retained Messages
+        saveRetained: db.prepare(`
+      INSERT INTO retained (topic, packet, payload)
+      VALUES (?, ?, ?)
+      ON CONFLICT(topic) DO UPDATE SET 
+        packet = excluded.packet, 
+        payload = excluded.payload
+    `),
+        deleteRetained: db.prepare(`
+      DELETE FROM retained 
+      WHERE topic = ?
+    `),
+        getRetainedExact: db.prepare(`
+      SELECT packet, payload 
+      FROM retained 
+      WHERE topic = ?
+    `),
+        listRetainedLike: db.prepare(`
+      SELECT topic, packet, payload 
+      FROM retained 
+      WHERE topic LIKE ?
+    `),
+    };
+}
+/**
+ * Truncates and drops relational state assignments under targeted clients inside atomic scopes.
+ * @param db Connection reference context.
+ * @param clientId Specific target client ID tracking token.
+ */
+export function deleteClientState(db, clientId) {
+    db.exec("begin;");
+    db.prepare("delete from subscriptions where client_id = ?").run(clientId);
+    db.prepare("delete from pending_incoming where client_id = ?").run(clientId);
+    db.prepare("delete from pending_outgoing where client_id = ?").run(clientId);
+    db.prepare("delete from pending_ack_outgoing where client_id = ?").run(clientId);
+    db.prepare("delete from client_sessions where client_id = ?").run(clientId);
+    db.exec("commit;");
+}
+//# sourceMappingURL=sqliteDatabase.js.map

package/dist/persistence/sqlite/sqliteDatabase.js.map

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

package/dist/persistence/sqlite/sqlitePersistence.d.ts

@@ -0,0 +1,16 @@
+import { MqttPersistence } from "../basicPersistence.ts";
+import type sqlite from "node:sqlite";
+export declare class SqlitePersistence extends MqttPersistence {
+    private storageInstance;
+    constructor(db?: string | sqlite.DatabaseSync);
+    /**
+     * Convenient lifecycle method combining instance creation and initialization.
+     */
+    static start(db?: string | sqlite.DatabaseSync): Promise<SqlitePersistence>;
+    /**
+     * Overrides close to make sure the underlying database file
+     * handle is cleaned up correctly when the persistence is halted.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=sqlitePersistence.d.ts.map

package/dist/persistence/sqlite/sqlitePersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlitePersistence.d.ts","sourceRoot":"","sources":["../../../persistence/sqlite/sqlitePersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAItC,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,OAAO,CAAC,eAAe,CAAgB;IAEvC,YAAY,EAAE,GAAE,MAAM,GAAG,MAAM,CAAC,YAAkC,EAIjE;IAED;;OAEG;IACH,OAAa,KAAK,CAChB,EAAE,GAAE,MAAM,GAAG,MAAM,CAAC,YAAkC,GACrD,OAAO,CAAC,iBAAiB,CAAC,CAI5B;IAED;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAI3B;CACF"}

package/dist/persistence/sqlite/sqlitePersistence.js

@@ -0,0 +1,29 @@
+import { MqttPersistence } from "../basicPersistence.js";
+import { SqliteStorage } from "./sqliteStorage.js";
+const SQLITE_DATABASE_URL = ":memory:";
+export class SqlitePersistence extends MqttPersistence {
+    storageInstance;
+    constructor(db = SQLITE_DATABASE_URL) {
+        const storage = new SqliteStorage(db);
+        super(storage);
+        this.storageInstance = storage;
+    }
+    /**
+     * Convenient lifecycle method combining instance creation and initialization.
+     */
+    static async start(db = SQLITE_DATABASE_URL) {
+        const persistence = new SqlitePersistence(db);
+        await persistence.initialize();
+        return persistence;
+    }
+    /**
+     * Overrides close to make sure the underlying database file
+     * handle is cleaned up correctly when the persistence is halted.
+     */
+    async close() {
+        if (this.storageInstance.close) {
+            await this.storageInstance.close();
+        }
+    }
+}
+//# sourceMappingURL=sqlitePersistence.js.map

package/dist/persistence/sqlite/sqlitePersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlitePersistence.js","sourceRoot":"","sources":["../../../persistence/sqlite/sqlitePersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAEvC,MAAM,OAAO,iBAAkB,SAAQ,eAAe;IAC5C,eAAe,CAAgB;IAEvC,YAAY,EAAE,GAAiC,mBAAmB;QAChE,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,EAAE,CAAC,CAAC;QACtC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,CAChB,EAAE,GAAiC,mBAAmB;QAEtD,MAAM,WAAW,GAAG,IAAI,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,WAAW,CAAC,UAAU,EAAE,CAAC;QAC/B,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QACrC,CAAC;IACH,CAAC;CACF"}

package/dist/persistence/sqlite/sqliteStorage.d.ts

@@ -0,0 +1,36 @@
+import type sqlite from "node:sqlite";
+import type { ClientId, PacketId, Topic, TopicFilter } from "../deps.ts";
+import type { ClientRegistrationResult, ClientSubscription, ExtPublishPacket, ShareName } from "../persistence.ts";
+import { PacketDirection } from "../storage.ts";
+import type { IStorageProvider, StoredSubscription } from "../storage.ts";
+export declare class SqliteStorage implements IStorageProvider {
+    private db;
+    private statements;
+    constructor(db?: string | sqlite.DatabaseSync);
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    saveSession(clientId: ClientId, session: ClientRegistrationResult): Promise<void>;
+    getSession(clientId: ClientId): Promise<ClientRegistrationResult | null>;
+    deleteSession(clientId: ClientId): Promise<void>;
+    listAllSessions(): AsyncIterableIterator<{
+        clientId: ClientId;
+        session: ClientRegistrationResult;
+    }>;
+    saveSubscription(clientId: ClientId, sub: ClientSubscription): Promise<void>;
+    deleteSubscription(clientId: ClientId, topicFilter: TopicFilter, shareName: ShareName): Promise<void>;
+    listSubscriptions(clientId: ClientId): AsyncIterableIterator<ClientSubscription>;
+    listAllSubscriptions(): AsyncIterableIterator<StoredSubscription>;
+    savePendingPacket(clientId: ClientId, direction: PacketDirection, packet: ExtPublishPacket): Promise<void>;
+    getPendingPacket(clientId: ClientId, direction: PacketDirection, packetId: PacketId): Promise<ExtPublishPacket | null>;
+    updatePendingPacket(clientId: ClientId, direction: PacketDirection, packetId: PacketId, dup: boolean): Promise<boolean>;
+    deletePendingPacket(clientId: ClientId, direction: PacketDirection, packetId: PacketId): Promise<boolean>;
+    listPendingPackets(clientId: ClientId, direction: PacketDirection): AsyncIterableIterator<ExtPublishPacket>;
+    savePendingAck(clientId: ClientId, packetId: PacketId): Promise<void>;
+    hasPendingAck(clientId: ClientId, packetId: PacketId): Promise<boolean>;
+    deletePendingAck(clientId: ClientId, packetId: PacketId): Promise<boolean>;
+    listPendingAcks(clientId: ClientId): AsyncIterableIterator<PacketId>;
+    saveRetained(topic: Topic, packet: ExtPublishPacket): Promise<void>;
+    deleteRetained(topic: Topic): Promise<void>;
+    listRetainedMatches(topicFilter: TopicFilter): AsyncIterableIterator<ExtPublishPacket>;
+}
+//# sourceMappingURL=sqliteStorage.d.ts.map

package/dist/persistence/sqlite/sqliteStorage.d.ts.map

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

package/dist/persistence/sqlite/sqliteStorage.js

@@ -0,0 +1,194 @@
+import { PacketDirection } from "../storage.js";
+import { topicFilterToRegExp } from "../deps.js";
+import { deleteClientState, initializeDatabase, prepareAllStatements, } from "./sqliteDatabase.js";
+const SQLITE_DATABASE_URL = ":memory:";
+function serializePacket(packet) {
+    const packetJson = JSON.stringify({ ...packet, payload: undefined });
+    const payloadBlob = packet.payload ? packet.payload : null;
+    return { packetJson, payloadBlob };
+}
+function deserializePacket(packetJson, payloadBlob) {
+    const packet = JSON.parse(packetJson);
+    if (payloadBlob) {
+        packet.payload = payloadBlob;
+    }
+    return packet;
+}
+export class SqliteStorage {
+    db;
+    statements;
+    constructor(db = SQLITE_DATABASE_URL) {
+        if (typeof db === "string") {
+            this.db = initializeDatabase(db);
+        }
+        else {
+            this.db = db;
+        }
+        this.statements = prepareAllStatements(this.db);
+    }
+    initialize() {
+        return Promise.resolve();
+    }
+    close() {
+        this.db.close();
+        return Promise.resolve();
+    }
+    // --- Sessions ---
+    saveSession(clientId, session) {
+        this.statements.saveSession.run(clientId, JSON.stringify(session));
+        return Promise.resolve();
+    }
+    getSession(clientId) {
+        const row = this.statements.getSession.get(clientId);
+        return Promise.resolve(row ? JSON.parse(row.session_data) : null);
+    }
+    deleteSession(clientId) {
+        deleteClientState(this.db, clientId);
+        return Promise.resolve();
+    }
+    async *listAllSessions() {
+        for (const row of this.statements.listAllSessions
+            .iterate()) {
+            yield {
+                clientId: row.client_id,
+                session: JSON.parse(row.session_data),
+            };
+        }
+    }
+    // --- Subscriptions ---
+    saveSubscription(clientId, sub) {
+        const subData = {
+            qos: sub.qos,
+            noLocal: sub.noLocal,
+            retainAsPublished: sub.retainAsPublished,
+            retainHandling: sub.retainHandling,
+            subscriptionIdentifier: sub.subscriptionIdentifier,
+        };
+        this.statements.saveSubscription.run(clientId, sub.topicFilter, sub.shareName, JSON.stringify(subData));
+        return Promise.resolve();
+    }
+    deleteSubscription(clientId, topicFilter, shareName) {
+        this.statements.deleteSubscription.run(clientId, topicFilter, shareName);
+        return Promise.resolve();
+    }
+    async *listSubscriptions(clientId) {
+        const rows = this.statements.listSubscriptions.all(clientId);
+        for (const row of rows) {
+            const sub = JSON.parse(row.subscription_data);
+            sub.topicFilter = row.topic;
+            sub.shareName = row.share_name;
+            yield sub;
+        }
+    }
+    async *listAllSubscriptions() {
+        const rows = this.statements.listAllSubscriptions.all();
+        for (const row of rows) {
+            const sub = JSON.parse(row.subscription_data);
+            sub.topicFilter = row.topic;
+            sub.shareName = row.share_name;
+            sub.clientId = row.client_id;
+            yield sub;
+        }
+    }
+    // --- Pending Packets (Incoming & Outgoing) ---
+    savePendingPacket(clientId, direction, packet) {
+        if (packet.id === undefined)
+            return Promise.resolve();
+        const { packetJson, payloadBlob } = serializePacket(packet);
+        const stmt = direction === PacketDirection.Incoming
+            ? this.statements.saveIncoming
+            : this.statements.saveOutgoing;
+        stmt.run(clientId, packet.id, packetJson, payloadBlob);
+        return Promise.resolve();
+    }
+    getPendingPacket(clientId, direction, packetId) {
+        const stmt = direction === PacketDirection.Incoming
+            ? this.statements.getIncoming
+            : this.statements.getOutgoing;
+        const row = stmt.get(clientId, packetId);
+        if (!row)
+            return Promise.resolve(null);
+        // Filter out expired packets
+        if (row.expires_at !== null && row.expires_at <= Date.now()) {
+            return Promise.resolve(null);
+        }
+        return Promise.resolve(deserializePacket(row.packet, row.payload));
+    }
+    updatePendingPacket(clientId, direction, packetId, dup) {
+        const stmt = direction === PacketDirection.Incoming
+            ? this.statements.updateIncomingDup
+            : this.statements.updateOutgoingDup;
+        // Pass "true" of "false" as JSON literal , passing a boolean would make it 1 or 0
+        const info = stmt.run(dup ? "true" : "false", clientId, packetId);
+        // info.changes returns number of updated records
+        return Promise.resolve(info.changes > 0);
+    }
+    deletePendingPacket(clientId, direction, packetId) {
+        const stmt = direction === PacketDirection.Incoming
+            ? this.statements.deleteIncoming
+            : this.statements.deleteOutgoing;
+        const info = stmt.run(clientId, packetId);
+        return Promise.resolve(info.changes > 0);
+    }
+    async *listPendingPackets(clientId, direction) {
+        const stmt = direction === PacketDirection.Incoming
+            ? this.statements.listIncoming
+            : this.statements.listOutgoing;
+        const rows = stmt.all(clientId);
+        for (const row of rows) {
+            yield deserializePacket(row.packet, row.payload);
+        }
+    }
+    // --- ACKs ---
+    savePendingAck(clientId, packetId) {
+        this.statements.saveAck.run(clientId, packetId);
+        return Promise.resolve();
+    }
+    hasPendingAck(clientId, packetId) {
+        const row = this.statements.hasAck.get(clientId, packetId);
+        return Promise.resolve(row !== undefined);
+    }
+    deletePendingAck(clientId, packetId) {
+        const info = this.statements.deleteAck.run(clientId, packetId);
+        return Promise.resolve(info.changes > 0);
+    }
+    async *listPendingAcks(clientId) {
+        const rows = this.statements.listAcks.all(clientId);
+        for (const row of rows) {
+            yield row.packet_id;
+        }
+    }
+    // --- Retained Messages ---
+    saveRetained(topic, packet) {
+        const { packetJson, payloadBlob } = serializePacket(packet);
+        this.statements.saveRetained.run(topic, packetJson, payloadBlob);
+        return Promise.resolve();
+    }
+    deleteRetained(topic) {
+        this.statements.deleteRetained.run(topic);
+        return Promise.resolve();
+    }
+    async *listRetainedMatches(topicFilter) {
+        let hasWildcards = false;
+        const sqlLike = topicFilter.replace(/\/#|#|\+/g, () => {
+            hasWildcards = true;
+            return "%";
+        });
+        if (!hasWildcards) {
+            const rows = this.statements.getRetainedExact.all(topicFilter);
+            for (const row of rows) {
+                yield deserializePacket(row.packet, row.payload);
+            }
+        }
+        else {
+            const rows = this.statements.listRetainedLike.all(sqlLike);
+            const regex = topicFilterToRegExp(topicFilter);
+            for (const row of rows) {
+                if (regex.test(row.topic)) {
+                    yield deserializePacket(row.packet, row.payload);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=sqliteStorage.js.map

package/dist/persistence/sqlite/sqliteStorage.js.map

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

package/dist/persistence/storage.d.ts

@@ -0,0 +1,38 @@
+import type { ClientId, PacketId, Topic, TopicFilter } from "./deps.ts";
+import type { ClientRegistrationResult, ClientSubscription, ExtPublishPacket, ShareName } from "./persistence.ts";
+export type StoredSubscription = ClientSubscription & {
+    clientId: ClientId;
+};
+export declare const PacketDirection: {
+    readonly Incoming: 0;
+    readonly Outgoing: 1;
+};
+export type PacketDirection = typeof PacketDirection[keyof typeof PacketDirection];
+export interface IStorageProvider {
+    initialize(): Promise<void>;
+    close?(): Promise<void>;
+    saveSession(clientId: ClientId, session: ClientRegistrationResult): Promise<void>;
+    getSession(clientId: ClientId): Promise<ClientRegistrationResult | null>;
+    deleteSession(clientId: ClientId): Promise<void>;
+    listAllSessions(): AsyncIterableIterator<{
+        clientId: ClientId;
+        session: ClientRegistrationResult;
+    }>;
+    saveSubscription(clientId: ClientId, sub: ClientSubscription): Promise<void>;
+    deleteSubscription(clientId: ClientId, topicFilter: TopicFilter, shareName: ShareName): Promise<void>;
+    listSubscriptions(clientId: ClientId): AsyncIterableIterator<ClientSubscription>;
+    listAllSubscriptions(): AsyncIterableIterator<StoredSubscription>;
+    savePendingPacket(clientId: ClientId, direction: PacketDirection, packet: ExtPublishPacket): Promise<void>;
+    getPendingPacket(clientId: ClientId, direction: PacketDirection, packetId: PacketId): Promise<ExtPublishPacket | null>;
+    updatePendingPacket(clientId: ClientId, direction: PacketDirection, packetId: PacketId, dup: boolean): Promise<boolean>;
+    deletePendingPacket(clientId: ClientId, direction: PacketDirection, packetId: PacketId): Promise<boolean>;
+    listPendingPackets(clientId: ClientId, direction: PacketDirection): AsyncIterableIterator<ExtPublishPacket>;
+    savePendingAck(clientId: ClientId, packetId: PacketId): Promise<void>;
+    hasPendingAck(clientId: ClientId, packetId: PacketId): Promise<boolean>;
+    deletePendingAck(clientId: ClientId, packetId: PacketId): Promise<boolean>;
+    listPendingAcks(clientId: ClientId): AsyncIterableIterator<PacketId>;
+    saveRetained(topic: Topic, packet: ExtPublishPacket): Promise<void>;
+    deleteRetained(topic: Topic): Promise<void>;
+    listRetainedMatches(topicFilter: TopicFilter): AsyncIterableIterator<ExtPublishPacket>;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/persistence/storage.d.ts.map

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

package/dist/persistence/storage.js

@@ -0,0 +1,5 @@
+export const PacketDirection = {
+    Incoming: 0,
+    Outgoing: 1,
+};
+//# sourceMappingURL=storage.js.map

package/dist/persistence/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../persistence/storage.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;CACH,CAAC"}