@seriousme/opifex 1.11.3 → 2.1.0

package/dist/persistence/memory/memoryStorage.js

@@ -0,0 +1,143 @@
+import { PacketDirection } from "../storage.js";
+import { getOrInsert, joinTopicFilter, topicFilterToRegExp } from "../deps.js";
+export class MemoryStorage {
+    seqId = 1;
+    sessionTable = new Map();
+    subscriptionTable = new Map();
+    pendingIncomingTable = new Map();
+    pendingOutgoingTable = new Map();
+    pendingAckOutgoingTable = new Map();
+    retainedTable = new Map();
+    initialize() {
+        return Promise.resolve();
+    }
+    // --- Sessions ---
+    saveSession(clientId, session) {
+        this.sessionTable.set(clientId, session);
+        return Promise.resolve();
+    }
+    getSession(clientId) {
+        return Promise.resolve(this.sessionTable.get(clientId) ?? null);
+    }
+    deleteSession(clientId) {
+        this.sessionTable.delete(clientId);
+        this.pendingIncomingTable.delete(clientId);
+        this.pendingOutgoingTable.delete(clientId);
+        this.pendingAckOutgoingTable.delete(clientId);
+        this.subscriptionTable.delete(clientId);
+        return Promise.resolve();
+    }
+    async *listAllSessions() {
+        for (const [clientId, session] of this.sessionTable.entries()) {
+            yield { clientId, session };
+        }
+    }
+    // --- Subscriptions ---
+    saveSubscription(clientId, sub) {
+        const key = joinTopicFilter(sub.topicFilter, sub.shareName);
+        const clientSubs = getOrInsert(this.subscriptionTable, clientId, new Map());
+        clientSubs.set(key, sub);
+        return Promise.resolve();
+    }
+    deleteSubscription(clientId, topicFilter, shareName) {
+        const key = joinTopicFilter(topicFilter, shareName);
+        this.subscriptionTable.get(clientId)?.delete(key);
+        return Promise.resolve();
+    }
+    async *listSubscriptions(clientId) {
+        const clientSubs = this.subscriptionTable.get(clientId);
+        if (clientSubs) {
+            for (const sub of clientSubs.values()) {
+                yield sub;
+            }
+        }
+    }
+    async *listAllSubscriptions() {
+        for (const [clientId, clientSubs] of this.subscriptionTable.entries()) {
+            for (const sub of clientSubs.values()) {
+                yield { ...sub, clientId };
+            }
+        }
+    }
+    // --- Pending Packets (Incoming & Outgoing) ---
+    getPacketTable(clientId, direction) {
+        const table = direction === PacketDirection.Incoming
+            ? this.pendingIncomingTable
+            : this.pendingOutgoingTable;
+        return getOrInsert(table, clientId, new Map());
+    }
+    savePendingPacket(clientId, direction, packet) {
+        const createdAtMs = Date.now();
+        if (packet.id !== undefined) {
+            this.getPacketTable(clientId, direction).set(packet.id, {
+                seqId: this.seqId++,
+                packet,
+                createdAtMs,
+            });
+        }
+        return Promise.resolve();
+    }
+    getPendingPacket(clientId, direction, packetId) {
+        const entry = this.getPacketTable(clientId, direction).get(packetId);
+        return Promise.resolve(entry?.packet ?? null);
+    }
+    updatePendingPacket(clientId, direction, packetId, dup) {
+        const entry = this.getPacketTable(clientId, direction).get(packetId);
+        if (entry !== undefined) {
+            entry.packet.dup = dup;
+        }
+        return Promise.resolve(entry !== undefined);
+    }
+    deletePendingPacket(clientId, direction, packetId) {
+        const deleted = this.getPacketTable(clientId, direction).delete(packetId);
+        return Promise.resolve(deleted);
+    }
+    async *listPendingPackets(clientId, direction) {
+        const queue = this.getPacketTable(clientId, direction);
+        if (!queue)
+            return;
+        for (const entry of queue.values()) {
+            yield entry.packet;
+        }
+    }
+    // --- ACKs ---
+    getAckSet(clientId) {
+        return getOrInsert(this.pendingAckOutgoingTable, clientId, new Set());
+    }
+    savePendingAck(clientId, packetId) {
+        this.getAckSet(clientId).add(packetId);
+        return Promise.resolve();
+    }
+    hasPendingAck(clientId, packetId) {
+        const hasAck = this.getAckSet(clientId).has(packetId);
+        return Promise.resolve(hasAck);
+    }
+    deletePendingAck(clientId, packetId) {
+        const deleted = this.getAckSet(clientId).delete(packetId);
+        return Promise.resolve(deleted);
+    }
+    async *listPendingAcks(clientId) {
+        const ackSet = this.getAckSet(clientId);
+        for (const packetId of ackSet) {
+            yield packetId;
+        }
+    }
+    // --- Retained Messages ---
+    saveRetained(topic, packet) {
+        this.retainedTable.set(topic, packet);
+        return Promise.resolve();
+    }
+    deleteRetained(topic) {
+        this.retainedTable.delete(topic);
+        return Promise.resolve();
+    }
+    async *listRetainedMatches(topicFilter) {
+        const regex = topicFilterToRegExp(topicFilter);
+        for (const [topic, packet] of this.retainedTable.entries()) {
+            if (regex.test(topic)) {
+                yield packet;
+            }
+        }
+    }
+}
+//# sourceMappingURL=memoryStorage.js.map

package/dist/persistence/memory/memoryStorage.js.map

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

package/dist/persistence/mod.d.ts

@@ -2,8 +2,8 @@
  * @module persistence
  * @description Module for handling MQTT message persistence and client management
  */
-export type { IStore, PacketIdStore, PacketStore, SubscriptionStore, } from "./store.ts";
 export type { ClientId, PacketId, PublishPacket, QoS, Topic, TopicFilter, } from "./deps.ts";
-export type { Client, Handler, IPersistence, RetainStore, } from "./persistence.ts";
-export { maxPacketId } from "./persistence.ts";
+export type { ClientRegistrationResult, Handler, Persistence, } from "./persistence.ts";
+export { MAX_PACKET_ID } from "./persistence.ts";
+export { SqlitePersistence } from "./sqlite/sqlitePersistence.ts";
 //# sourceMappingURL=mod.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../persistence/mod.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EACV,MAAM,EACN,aAAa,EACb,WAAW,EACX,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,GAAG,EACH,KAAK,EACL,WAAW,GACZ,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,MAAM,EACN,OAAO,EACP,YAAY,EACZ,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../persistence/mod.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,GAAG,EACH,KAAK,EACL,WAAW,GACZ,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,wBAAwB,EACxB,OAAO,EACP,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/persistence/mod.js

@@ -1,2 +1,7 @@
-export { maxPacketId } from "./persistence.js";
+/**
+ * @module persistence
+ * @description Module for handling MQTT message persistence and client management
+ */
+export { MAX_PACKET_ID } from "./persistence.js";
+export { SqlitePersistence } from "./sqlite/sqlitePersistence.js";
 //# sourceMappingURL=mod.js.map

package/dist/persistence/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../persistence/mod.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../persistence/mod.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/persistence/persistence.d.ts

@@ -2,85 +2,60 @@
  * @module persistence
  * @description Module for handling MQTT message persistence and client management
  */
-import type { ClientId, PublishPacket, QoS, Topic } from "./deps.ts";
-import type { IStore } from "./store.ts";
+import type { ClientId, PacketId, PublishPacketV5, QoS, RetainHandling, TopicFilter } from "./deps.ts";
 /**
- * Maximum packet ID value for MQTT messages (0xffff/65535)
- * @constant {number}
- */
-export declare const maxPacketId = 65535;
-/**
- * Handler function type for processing publish packets
- * @callback Handler
- * @param {PublishPacket} packet - The MQTT publish packet to handle
+ * extended publish packet also contains meta data
  */
-export type Handler = (packet: PublishPacket) => void;
+export type ExtPublishPacket = PublishPacketV5 & {
+    expiresAtMs?: number;
+};
 /**
- * Store type for retained messages mapped by topic
- * @typedef {Map<Topic, PublishPacket>} RetainStore
+ * The MQTT topic share to subscribe/unsubscribe to
  */
-export type RetainStore = Map<Topic, PublishPacket>;
+export type ShareName = string;
+export type ClientSubscription = {
+    topicFilter: TopicFilter;
+    shareName: ShareName;
+    qos: QoS;
+    noLocal?: boolean;
+    retainAsPublished?: boolean;
+    retainHandling?: RetainHandling;
+    subscriptionIdentifier?: number;
+};
 /**
- * Client type containing message store and packet handler
- * @typedef {Object} Client
- * @property {IStore} store - The client's message store
- * @property {Handler} handler - The client's packet handler function
+ * Maximum packet ID value for MQTT messages (0xffff/65535)
  */
-export type Client = {
-    store: IStore;
-    handler: Handler;
+export declare const MAX_PACKET_ID = 65535;
+export type Handler = (packet: ExtPublishPacket) => void | Promise<void>;
+export type ClientRegistrationResult = {
+    existingSession: boolean;
 };
 /**
  * Interface for persistence implementations to store messages and subscriptions
- * @interface IPersistence
  */
-export interface IPersistence {
-    /**
-     * Map of connected clients by client ID
-     * @type {Map<ClientId, Client>}
-     */
-    clientList: Map<ClientId, Client>;
-    /**
-     * Map of retained messages by topic
-     * @type {RetainStore}
-     */
-    retained: RetainStore;
-    /**
-     * Register a new client with the persistence layer
-     * @param {ClientId} clientId - Unique identifier for the client
-     * @param {Handler} handler - Packet handler function for the client
-     * @param {boolean} clean - Whether to start with a clean session
-     * @returns {IStore} The client's message store
-     */
-    registerClient(clientId: ClientId, handler: Handler, clean: boolean): IStore;
-    /**
-     * Remove a client from the persistence layer
-     * @param {ClientId} clientId - ID of client to deregister
-     */
-    deregisterClient(clientId: ClientId): void;
-    /**
-     * Publish a message to all subscribed clients
-     * @param {Topic} topic - Topic to publish to
-     * @param {PublishPacket} packet - Packet containing the message
-     */
-    publish(topic: Topic, packet: PublishPacket): void;
-    /**
-     * Subscribe a client to a topic
-     * @param {IStore} store - Client's message store
-     * @param {Topic} topic - Topic to subscribe to
-     * @param {QoS} qos - Quality of Service level
-     */
-    subscribe(store: IStore, topic: Topic, qos: QoS): void;
-    /**
-     * Unsubscribe a client from a topic
-     * @param {IStore} store - Client's message store
-     * @param {Topic} topic - Topic to unsubscribe from
-     */
-    unsubscribe(store: IStore, topic: Topic): void;
-    /**
-     * Send retained messages to a client
-     * @param {ClientId} clientId - ID of client to send retained messages to
-     */
-    handleRetained(clientId: ClientId): void;
+export interface Persistence {
+    initialize(): Promise<void>;
+    registerClient(clientId: ClientId, handler: Handler): Promise<ClientRegistrationResult>;
+    deregisterClient(clientId: ClientId): Promise<void>;
+    disconnectClient(clientId: ClientId): Promise<void>;
+    subscribe(clientId: ClientId, subscription: ClientSubscription): Promise<void>;
+    unsubscribe(clientId: ClientId, topicFilter: TopicFilter, shareName: ShareName): Promise<void>;
+    listSubscriptions(clientId: ClientId): AsyncIterableIterator<ClientSubscription>;
+    addPendingIncomingPacket(clientId: ClientId, packet: ExtPublishPacket): Promise<void>;
+    getPendingIncomingPacket(clientId: ClientId, packetId: PacketId): Promise<ExtPublishPacket | null>;
+    listPendingIncomingPackets(clientId: ClientId): AsyncIterableIterator<ExtPublishPacket>;
+    deletePendingIncomingPacket(clientId: ClientId, packetId: PacketId): Promise<boolean>;
+    addPendingOutgoingPacket(clientId: ClientId, packet: ExtPublishPacket): Promise<void>;
+    getPendingOutgoingPacket(clientId: ClientId, packetId: PacketId): Promise<ExtPublishPacket | null>;
+    updatePendingOutgoingPacket(clientId: ClientId, packetId: PacketId, dup: boolean): Promise<boolean>;
+    listPendingOutgoingPackets(clientId: ClientId): AsyncIterableIterator<ExtPublishPacket>;
+    deletePendingOutgoingPacket(clientId: ClientId, packetId: PacketId): Promise<boolean>;
+    addPendingAck(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>;
+    publish(clientId: ClientId, packet: ExtPublishPacket): Promise<void>;
+    handleRetained(clientId: ClientId, subscriptions: ClientSubscription[]): Promise<void>;
+    nextPacketId(clientId: ClientId): Promise<PacketId>;
 }
 //# sourceMappingURL=persistence.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../persistence/persistence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAS,CAAC;AAClC;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAElC;;;OAGG;IACH,QAAQ,EAAE,WAAW,CAAC;IAEtB;;;;;;OAMG;IACH,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IAE7E;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAE3C;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAEnD;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;IAEvD;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAE/C;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC1C"}
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../persistence/persistence.ts"],"names":[],"mappings":"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"}

package/dist/persistence/persistence.js

@@ -1,6 +1,5 @@
 /**
  * Maximum packet ID value for MQTT messages (0xffff/65535)
- * @constant {number}
  */
-export const maxPacketId = 0xffff;
+export const MAX_PACKET_ID = 0xffff;
 //# sourceMappingURL=persistence.js.map

package/dist/persistence/persistence.js.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../persistence/persistence.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC"}
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../persistence/persistence.ts"],"names":[],"mappings":"AAmCA;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC"}

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"}