keri 0.0.0-dev.5e5dc7c → 0.0.0-dev.6094afc

package/dist/mailbox/mailbox.d.ts

@@ -0,0 +1,27 @@
+import { Message } from "#keri/cesr";
+import { KeyEventLog } from "#keri/core";
+import type { MailboxServerStorage } from "#keri/storage";
+import { type Logger } from "./logger.ts";
+export interface MailboxOptions {
+    storage: MailboxServerStorage;
+    privateKey?: Uint8Array;
+    url?: string;
+    logger?: Logger;
+}
+export interface MailboxEvent {
+    readonly message: Message;
+    readonly timestamp: Date;
+}
+export interface MailboxReply {
+    readonly id: number;
+    readonly topic: string;
+    readonly message: Message;
+}
+export declare class Mailbox {
+    #private;
+    readonly events: readonly MailboxEvent[];
+    static createKEL(privateKey: Uint8Array): KeyEventLog;
+    get aid(): string;
+    constructor(options: MailboxOptions);
+    handleMessage(message: Message): AsyncGenerator<MailboxReply>;
+}

package/dist/mailbox/mailbox.js

@@ -0,0 +1,101 @@
+import { ed25519 } from "@noble/curves/ed25519.js";
+import { encodeText, Indexer, Matter, Message } from "#keri/cesr";
+import { KeyEventLog, keri } from "#keri/core";
+import { noopLogger } from "./logger.js";
+export class Mailbox {
+    #storage;
+    #privateKey;
+    #kel;
+    #log;
+    events;
+    static createKEL(privateKey) {
+        const publicKey = encodeText(new Matter({ code: Matter.Code.Ed25519N, raw: ed25519.getPublicKey(privateKey) }));
+        const icp = keri.incept({ signingKeys: [publicKey], nextKeys: [] });
+        icp.attachments = {
+            ControllerIdxSigs: [encodeText(Indexer.crypto.ed25519_sig(ed25519.sign(icp.raw, privateKey), 0))],
+        };
+        return KeyEventLog.from([icp]);
+    }
+    get aid() {
+        return this.#kel.state.identifier;
+    }
+    constructor(options) {
+        this.#storage = options.storage;
+        this.#privateKey = options.privateKey ?? ed25519.utils.randomSecretKey();
+        this.#kel = Mailbox.createKEL(this.#privateKey);
+        this.#log = options.logger ?? noopLogger;
+        const events = [{ message: this.#kel.events[0], timestamp: new Date() }];
+        if (options.url) {
+            const url = new URL(options.url);
+            const scheme = url.protocol.replace(":", "");
+            const location = keri.reply({
+                r: "/loc/scheme",
+                a: { eid: this.aid, scheme, url: options.url },
+            });
+            const endrole = keri.reply({
+                r: "/end/role/add",
+                a: { cid: this.aid, role: "mailbox", eid: this.aid },
+            });
+            location.attachments = {
+                NonTransReceiptCouples: [{ prefix: this.aid, sig: this.#sign(location) }],
+            };
+            endrole.attachments = {
+                NonTransReceiptCouples: [{ prefix: this.aid, sig: this.#sign(endrole) }],
+            };
+            events.push({ message: location, timestamp: new Date() });
+            events.push({ message: endrole, timestamp: new Date() });
+        }
+        this.events = events;
+    }
+    async *handleMessage(message) {
+        const { t, r } = message.body;
+        if (t === "exn" && r === "/fwd") {
+            this.#log.debug("handling exn /fwd");
+            this.#handleForward(message);
+            return;
+        }
+        if (t === "qry" && r === "mbx") {
+            this.#log.debug("handling qry mbx");
+            yield* this.#handleQuery(message);
+            return;
+        }
+        this.#log.debug("ignoring message", { t, r });
+    }
+    #handleForward(message) {
+        const { q, e } = message.body;
+        const pre = q.pre;
+        const topic = q.topic;
+        if (!pre || !topic) {
+            this.#log.warn("ignoring forward: missing q.pre or q.topic");
+            return;
+        }
+        const evtBody = e?.evt;
+        if (!evtBody) {
+            this.#log.warn("ignoring forward: missing e.evt", { pre, topic });
+            return;
+        }
+        const evtCouple = message.attachments.PathedMaterialCouples.find((c) => c.path === "-e-evt");
+        const innerMessage = new Message(evtBody, evtCouple?.attachments);
+        this.#log.debug("saving mailbox entry", { pre, topic });
+        this.#storage.saveMailboxEntry(pre, topic, innerMessage);
+    }
+    *#handleQuery(message) {
+        const { i, topics } = message.body.q;
+        if (!i || !topics) {
+            this.#log.warn("ignoring query: missing q.i or q.topics");
+            return;
+        }
+        this.#log.debug("querying mailbox", { aid: i, topics });
+        for (const [topicPath, offset] of Object.entries(topics)) {
+            const storageTopic = topicPath.replace(/^\//, "");
+            for (const entry of this.#storage.getMailboxEntries(i, storageTopic, offset)) {
+                yield { id: entry.id, topic: topicPath, message: entry.message };
+            }
+        }
+    }
+    #sign(message) {
+        const rawSignature = ed25519.sign(message.raw, this.#privateKey);
+        return encodeText(new Matter({ code: Matter.Code.Ed25519_Sig, raw: rawSignature }));
+    }
+}
+//# sourceMappingURL=mailbox.js.map

package/dist/mailbox/mailbox.js.map

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

package/dist/mailbox/main.d.ts

@@ -0,0 +1,3 @@
+export type { Logger } from "./logger.ts";
+export { Mailbox } from "./mailbox.ts";
+export { createRouter as createMailboxRouter, type RouterOptions } from "./mailbox-router.ts";

package/dist/mailbox/main.js

@@ -0,0 +1,3 @@
+export { Mailbox } from "./mailbox.js";
+export { createRouter as createMailboxRouter } from "./mailbox-router.js";
+//# sourceMappingURL=main.js.map

package/dist/mailbox/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/mailbox/main.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,YAAY,IAAI,mBAAmB,EAAsB,MAAM,qBAAqB,CAAC"}

package/dist/nodejs-utils/logger.d.ts

@@ -0,0 +1,8 @@
+export interface Logger {
+    trace(msg: string, meta?: object): void;
+    debug(msg: string, meta?: object): void;
+    info(msg: string, meta?: object): void;
+    warn(msg: string, meta?: object): void;
+    error(msg: string, meta?: object): void;
+}
+export declare const noopLogger: Logger;

package/dist/nodejs-utils/logger.js

@@ -0,0 +1,8 @@
+export const noopLogger = {
+    trace: () => { },
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+//# sourceMappingURL=logger.js.map

package/dist/nodejs-utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/nodejs-utils/logger.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,UAAU,GAAW;IAChC,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAC"}

package/dist/nodejs-utils/main.d.ts

@@ -0,0 +1,2 @@
+export { type Logger, noopLogger } from "./logger.ts";
+export { createListener, type ListenerOptions } from "./serve.ts";

package/dist/nodejs-utils/main.js

@@ -0,0 +1,3 @@
+export { noopLogger } from "./logger.js";
+export { createListener } from "./serve.js";
+//# sourceMappingURL=main.js.map

package/dist/nodejs-utils/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/nodejs-utils/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,cAAc,EAAwB,MAAM,YAAY,CAAC"}

package/dist/nodejs-utils/serve.d.ts

@@ -0,0 +1,6 @@
+import type { RequestListener } from "node:http";
+import { type Logger } from "./logger.ts";
+export interface ListenerOptions {
+    logger?: Logger;
+}
+export declare function createListener(handler: (request: Request) => Promise<Response>, options?: ListenerOptions): RequestListener;

package/dist/nodejs-utils/serve.js

@@ -0,0 +1,68 @@
+import { Readable } from "node:stream";
+import { noopLogger } from "./logger.js";
+function toWebRequest(req) {
+    const host = req.headers.host ?? "0.0.0.0";
+    const protocol = req.headers["x-forwarded-proto"] ?? "http";
+    const url = new URL(req.url ?? "/", `${protocol}://${host}`);
+    const headers = new Headers();
+    for (const [key, headerValue] of Object.entries(req.headers)) {
+        if (headerValue !== undefined) {
+            if (Array.isArray(headerValue)) {
+                for (const value of headerValue) {
+                    headers.append(key, value);
+                }
+            }
+            else {
+                headers.set(key, headerValue);
+            }
+        }
+    }
+    let body = null;
+    if (!["GET", "HEAD"].includes(req.method ?? "")) {
+        body = Readable.toWeb(req);
+    }
+    return new Request(url, {
+        method: req.method,
+        headers,
+        body,
+        duplex: "half",
+        // Cast required because DOM types omit `duplex`, but Node.js undici fetch requires it when body is a stream
+    });
+}
+export function createListener(handler, options = {}) {
+    const log = options.logger ?? noopLogger;
+    return async (req, res) => {
+        const start = Date.now();
+        const method = req.method ?? "GET";
+        const url = req.url ?? "/";
+        res.on("finish", () => {
+            const durationMs = Date.now() - start;
+            log.info(`${method} ${url} ${res.statusCode} ${durationMs}ms`, {
+                method,
+                url,
+                status: res.statusCode,
+                durationMs,
+            });
+        });
+        try {
+            const response = await handler(toWebRequest(req));
+            res.writeHead(response.status, Object.fromEntries(response.headers.entries()));
+            if (response.body) {
+                const reader = response.body.getReader();
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    res.write(value);
+                }
+            }
+            res.end();
+        }
+        catch (err) {
+            log.error("handler threw", { method, url, error: err instanceof Error ? err.message : String(err) });
+            res.statusCode = 500;
+            res.end("Internal Server Error");
+        }
+    };
+}
+//# sourceMappingURL=serve.js.map

package/dist/nodejs-utils/serve.js.map

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

package/dist/storage/credential-storage.d.ts

@@ -0,0 +1,8 @@
+import type { CredentialBody, IssueEvent, Message, RegistryInceptEventBody, RevokeEvent } from "#keri/core";
+export interface CredentialStorage {
+    getCredentialEvents(id: string): Generator<Message<IssueEvent | RevokeEvent>>;
+    getRegistry(id: string): Message<RegistryInceptEventBody> | null;
+    getRegistriesByOwner(owner: string): Generator<Message<RegistryInceptEventBody>>;
+    getCredential(id: string): CredentialBody | null;
+    getCredentialsByRegistry(registryId: string): CredentialBody[];
+}

package/dist/storage/credential-storage.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=credential-storage.js.map

package/dist/storage/credential-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-storage.js","sourceRoot":"","sources":["../../src/storage/credential-storage.ts"],"names":[],"mappings":""}

package/dist/storage/key-event-storage.d.ts

@@ -0,0 +1,10 @@
+import type { KeyEvent, Message, ReplyEventBody } from "#keri/core";
+export interface KeyEventStorage {
+    saveMessage(message: Message): void;
+    getKeyEvents(prefix: string): Generator<KeyEvent>;
+    getReplies(filter?: {
+        route?: string;
+        eid?: string;
+        cid?: string;
+    }): Generator<Message<ReplyEventBody>>;
+}

package/dist/storage/key-event-storage.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=key-event-storage.js.map

package/dist/storage/key-event-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-event-storage.js","sourceRoot":"","sources":["../../src/storage/key-event-storage.ts"],"names":[],"mappings":""}

package/dist/storage/mailbox-server-storage.d.ts

@@ -0,0 +1,9 @@
+import type { Message } from "#keri/cesr";
+export interface MailboxEntry {
+    id: number;
+    message: Message;
+}
+export interface MailboxServerStorage {
+    saveMailboxEntry(pre: string, topic: string, message: Message): void;
+    getMailboxEntries(pre: string, topic: string, offset: number): Generator<MailboxEntry>;
+}

package/dist/storage/mailbox-server-storage.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mailbox-server-storage.js.map

package/dist/storage/mailbox-server-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-server-storage.js","sourceRoot":"","sources":["../../src/storage/mailbox-server-storage.ts"],"names":[],"mappings":""}

package/dist/storage/mailbox-storage.d.ts

@@ -0,0 +1,4 @@
+export interface MailboxStorage {
+    getMailboxOffset(prefix: string, topic: string): number;
+    saveMailboxOffset(prefix: string, topic: string, offset: number): void;
+}

package/dist/storage/mailbox-storage.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mailbox-storage.js.map

package/dist/storage/mailbox-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-storage.js","sourceRoot":"","sources":["../../src/storage/mailbox-storage.ts"],"names":[],"mappings":""}

package/dist/storage/main.d.ts

@@ -0,0 +1,5 @@
+export type { CredentialStorage } from "./credential-storage.ts";
+export type { KeyEventStorage } from "./key-event-storage.ts";
+export type { MailboxEntry, MailboxServerStorage } from "./mailbox-server-storage.ts";
+export type { MailboxStorage } from "./mailbox-storage.ts";
+export type { PrivateKeyStorage } from "./private-key-storage.ts";

package/dist/storage/main.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=main.js.map

package/dist/storage/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/storage/main.ts"],"names":[],"mappings":""}

package/dist/storage/private-key-storage.d.ts

@@ -0,0 +1,5 @@
+export interface PrivateKeyStorage {
+    saveKey(publicKey: string, digest: string, encryptedPrivKey: string): void;
+    getEncryptedPrivateKey(publicKey: string): string;
+    getPublicKeyByDigest(digest: string): string;
+}

package/dist/storage/private-key-storage.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=private-key-storage.js.map

package/dist/storage/private-key-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"private-key-storage.js","sourceRoot":"","sources":["../../src/storage/private-key-storage.ts"],"names":[],"mappings":""}

package/dist/storage/sqlite/schema.js

@@ -1,28 +1,46 @@
 const migrations = [
     // Migration 1: initial schema
     [
-        `CREATE TABLE IF NOT EXISTS event (
-      event_id    TEXT PRIMARY KEY,
-      protocol    TEXT NOT NULL,
-      type        TEXT NOT NULL,
-      sn          INTEGER,
-      event_json  JSON NOT NULL,
-      attachments TEXT
-    )`,
-        `CREATE TABLE IF NOT EXISTS key_info (
-      public_key            TEXT PRIMARY KEY,
-      public_key_digest     TEXT NOT NULL,
-      encrypted_private_key TEXT NOT NULL
-    )`,
+        [
+            "CREATE TABLE IF NOT EXISTS event (",
+            "  event_id    TEXT PRIMARY KEY,",
+            "  protocol    TEXT NOT NULL,",
+            "  type        TEXT NOT NULL,",
+            "  sn          INTEGER,",
+            "  event_json  JSON NOT NULL,",
+            "  attachments TEXT",
+            ")",
+        ].join("\n"),
+        [
+            "CREATE TABLE IF NOT EXISTS key_info (",
+            "  public_key            TEXT PRIMARY KEY,",
+            "  public_key_digest     TEXT NOT NULL,",
+            "  encrypted_private_key TEXT NOT NULL",
+            ")",
+        ].join("\n"),
     ],
     // Migration 2: mailbox cursor
     [
-        `CREATE TABLE IF NOT EXISTS mailbox_cursor (
-      prefix TEXT NOT NULL,
-      topic  TEXT NOT NULL,
-      offset INTEGER NOT NULL DEFAULT 0,
-      PRIMARY KEY (prefix, topic)
-    )`,
+        [
+            "CREATE TABLE IF NOT EXISTS mailbox_cursor (",
+            "  prefix TEXT NOT NULL,",
+            "  topic  TEXT NOT NULL,",
+            "  offset INTEGER NOT NULL DEFAULT 0,",
+            "  PRIMARY KEY (prefix, topic)",
+            ")",
+        ].join("\n"),
+    ],
+    // Migration 3: mailbox entry (server-side message store)
+    [
+        [
+            "CREATE TABLE IF NOT EXISTS mailbox_entry (",
+            "  id          INTEGER PRIMARY KEY AUTOINCREMENT,",
+            "  pre         TEXT NOT NULL,",
+            "  topic       TEXT NOT NULL,",
+            "  event_json  JSON NOT NULL,",
+            "  attachments TEXT",
+            ")",
+        ].join("\n"),
     ],
 ];
 export function migrate(db) {

package/dist/storage/sqlite/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/storage/sqlite/schema.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAe;IAC7B,8BAA8B;IAC9B;QACE;;;;;;;MAOE;QACF;;;;MAIE;KACH;IACD,8BAA8B;IAC9B;QACE;;;;;MAKE;KACH;CACF,CAAC;AAEF,MAAM,UAAU,OAAO,CAAC,EAAY;IAClC,EAAE,CAAC,OAAO,CAAC,sEAAsE,CAAC,CAAC;IACnF,EAAE,CAAC,OAAO,CAAC,+FAA+F,CAAC,CAAC;IAE5G,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,IAAI,OAAO,GAAG,OAAO,GAAG,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjE,KAAK,IAAI,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC;YACH,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtC,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;YACD,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3D,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/storage/sqlite/schema.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAe;IAC7B,8BAA8B;IAC9B;QACE;YACE,oCAAoC;YACpC,iCAAiC;YACjC,8BAA8B;YAC9B,8BAA8B;YAC9B,wBAAwB;YACxB,8BAA8B;YAC9B,oBAAoB;YACpB,GAAG;SACJ,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ;YACE,uCAAuC;YACvC,2CAA2C;YAC3C,wCAAwC;YACxC,uCAAuC;YACvC,GAAG;SACJ,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;IACD,8BAA8B;IAC9B;QACE;YACE,6CAA6C;YAC7C,yBAAyB;YACzB,yBAAyB;YACzB,sCAAsC;YACtC,+BAA+B;YAC/B,GAAG;SACJ,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;IACD,yDAAyD;IACzD;QACE;YACE,4CAA4C;YAC5C,kDAAkD;YAClD,8BAA8B;YAC9B,8BAA8B;YAC9B,8BAA8B;YAC9B,oBAAoB;YACpB,GAAG;SACJ,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;CACF,CAAC;AAEF,MAAM,UAAU,OAAO,CAAC,EAAY;IAClC,EAAE,CAAC,OAAO,CAAC,sEAAsE,CAAC,CAAC;IACnF,EAAE,CAAC,OAAO,CAAC,+FAA+F,CAAC,CAAC;IAE5G,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,IAAI,OAAO,GAAG,OAAO,GAAG,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjE,KAAK,IAAI,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC;YACH,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtC,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;YACD,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3D,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/storage/sqlite/storage-sqlite.d.ts

@@ -1,26 +1,32 @@
 import type { Database } from "./sqlite-database.ts";
 export { NodeSqliteDatabase } from "./node-sqlite.ts";
 export type { Database, Params, Row, SQLValue } from "./sqlite-database.ts";
-import type { ControllerStorage } from "../../controller/controller.ts";
-import { type CredentialBody, type IssueEvent, type KeyEvent, Message, type RegistryInceptEvent, type ReplyEvent, type RevokeEvent } from "../../core/main.ts";
-export declare class SqliteControllerStorage implements ControllerStorage {
+import { type CredentialBody, type IssueEvent, type KeyEvent, Message, type RegistryInceptEventBody, type ReplyEventBody, type RevokeEvent } from "#keri/core";
+import type { CredentialStorage } from "../credential-storage.ts";
+import type { KeyEventStorage } from "../key-event-storage.ts";
+import type { MailboxEntry, MailboxServerStorage } from "../mailbox-server-storage.ts";
+import type { MailboxStorage } from "../mailbox-storage.ts";
+import type { PrivateKeyStorage } from "../private-key-storage.ts";
+export declare class SqliteControllerStorage implements KeyEventStorage, PrivateKeyStorage, CredentialStorage, MailboxStorage, MailboxServerStorage {
     #private;
     constructor(db: Database);
     saveKey(publicKey: string, digest: string, encryptedPrivKey: string): void;
-    getKey(publicKey: string): string;
+    getEncryptedPrivateKey(publicKey: string): string;
     getPublicKeyByDigest(digest: string): string;
     saveMessage(message: Message): void;
     getReplies(filter?: {
         route?: string;
         eid?: string;
         cid?: string;
-    }): Generator<Message<ReplyEvent>>;
+    }): Generator<Message<ReplyEventBody>>;
     getKeyEvents(prefix: string): Generator<KeyEvent>;
     getCredentialEvents(id: string): Generator<Message<IssueEvent | RevokeEvent>>;
-    getRegistry(id: string): Message<RegistryInceptEvent> | null;
-    getRegistriesByOwner(owner: string): Generator<Message<RegistryInceptEvent>>;
+    getRegistry(id: string): Message<RegistryInceptEventBody> | null;
+    getRegistriesByOwner(owner: string): Generator<Message<RegistryInceptEventBody>>;
     getCredential(id: string): CredentialBody | null;
     getCredentialsByRegistry(registryId: string): CredentialBody[];
     getMailboxOffset(prefix: string, topic: string): number;
     saveMailboxOffset(prefix: string, topic: string, offset: number): void;
+    saveMailboxEntry(pre: string, topic: string, message: Message): void;
+    getMailboxEntries(pre: string, topic: string, offset: number): Generator<MailboxEntry>;
 }

package/dist/storage/sqlite/storage-sqlite.js

@@ -1,6 +1,7 @@
 import { migrate } from "./schema.js";
 export { NodeSqliteDatabase } from "./node-sqlite.js";
-import { Attachments, Message, } from "../../core/main.js";
+import { encodeText } from "#keri/cesr";
+import { Attachments, Message, } from "#keri/core";
 function parseRow(result) {
     if (!("event_json" in result) || typeof result.event_json !== "string") {
         throw new Error("Row does not contain event_json");
@@ -21,7 +22,7 @@ function prepareRow(message) {
             type: "credential",
             sn: null,
             event_json: JSON.stringify(body),
-            attachments: message.attachments.text(),
+            attachments: encodeText(message.attachments.frames()),
         };
     }
     switch (message.body.t) {
@@ -35,7 +36,7 @@ function prepareRow(message) {
                 type: body.t,
                 sn: parseInt(body.s, 16),
                 event_json: JSON.stringify(body),
-                attachments: message.attachments.text(),
+                attachments: encodeText(message.attachments.frames()),
             };
         }
         case "vcp": {
@@ -46,7 +47,7 @@ function prepareRow(message) {
                 type: body.t,
                 sn: null,
                 event_json: JSON.stringify(body),
-                attachments: message.attachments.text(),
+                attachments: encodeText(message.attachments.frames()),
             };
         }
         case "iss":
@@ -58,7 +59,7 @@ function prepareRow(message) {
                 type: body.t,
                 sn: null,
                 event_json: JSON.stringify(body),
-                attachments: message.attachments.text(),
+                attachments: encodeText(message.attachments.frames()),
             };
         }
         default: {
@@ -69,7 +70,7 @@ function prepareRow(message) {
                 type: typeof body.t === "string" ? body.t : null,
                 sn: null,
                 event_json: JSON.stringify(body),
-                attachments: message.attachments.text(),
+                attachments: encodeText(message.attachments.frames()),
             };
         }
     }
@@ -96,7 +97,7 @@ export class SqliteControllerStorage {
             encrypted_private_key: encryptedPrivKey,
         });
     }
-    getKey(publicKey) {
+    getEncryptedPrivateKey(publicKey) {
         const statement = ["SELECT encrypted_private_key FROM key_info", "WHERE public_key = $public_key", "LIMIT 1"].join("\n");
         const result = this.#queryOne(statement, { public_key: publicKey });
         if (!result || typeof result.encrypted_private_key !== "string") {
@@ -113,10 +114,11 @@ export class SqliteControllerStorage {
         return result.public_key;
     }
     saveMessage(message) {
+        // TODO: Should we use a flag to indicate "upsert" or "insert" ?
         const statement = [
             "INSERT INTO event(event_id, protocol, type, sn, event_json, attachments)",
             "VALUES ($event_id, $protocol, $type, $sn, $event_json, $attachments)",
-            "ON CONFLICT(event_id) DO NOTHING",
+            "ON CONFLICT(event_id) DO UPDATE SET attachments = excluded.attachments",
         ].join("\n");
         this.#db.execute(statement, prepareRow(message));
     }
@@ -209,5 +211,27 @@ export class SqliteControllerStorage {
         this.#db.execute("INSERT INTO mailbox_cursor(prefix, topic, offset) VALUES ($prefix, $topic, $offset) " +
             "ON CONFLICT(prefix, topic) DO UPDATE SET offset = $offset", { prefix, topic, offset });
     }
+    saveMailboxEntry(pre, topic, message) {
+        this.#db.execute("INSERT INTO mailbox_entry(pre, topic, event_json, attachments) VALUES ($pre, $topic, $event_json, $attachments)", {
+            pre,
+            topic,
+            event_json: JSON.stringify(message.body),
+            attachments: encodeText(message.attachments.frames()),
+        });
+    }
+    *getMailboxEntries(pre, topic, offset) {
+        const statement = [
+            "SELECT id, event_json, attachments FROM mailbox_entry",
+            "WHERE pre = $pre AND topic = $topic AND id > $offset",
+            "ORDER BY id ASC",
+        ].join("\n");
+        for (const row of this.#db.iterate(statement, { pre, topic, offset })) {
+            const id = row.id;
+            if (typeof id !== "number") {
+                throw new Error("mailbox_entry.id missing or not a number");
+            }
+            yield { id, message: parseRow(row) };
+        }
+    }
 }
 //# sourceMappingURL=storage-sqlite.js.map