applesauce-core 0.9.0 → 0.11.0

package/dist/helpers/__tests__/comment.test.js

@@ -0,0 +1,235 @@
+import { describe, expect, it } from "vitest";
+import { getCommentAddressPointer, getCommentEventPointer, getCommentExternalPointer, getCommentReplyPointer, getCommentRootPointer, } from "../comment.js";
+import { FakeUser } from "../../__tests__/fixtures.js";
+const user = new FakeUser();
+describe("getCommentRootPointer", () => {
+    it("should throw if event is not a comment", () => {
+        expect(() => {
+            getCommentRootPointer(user.note("testing"));
+        }).toThrow("Event is not a comment");
+    });
+});
+describe("getCommentReplyPointer", () => {
+    it("should throw if event is not a comment", () => {
+        expect(() => {
+            getCommentReplyPointer(user.note("testing"));
+        }).toThrow("Event is not a comment");
+    });
+});
+describe("getCommentEventPointer", () => {
+    it("should get pubkey from P tag when root=true", () => {
+        const tags = [
+            ["E", "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f"],
+            ["K", "1621"],
+            ["P", "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10"],
+            ["k", "1621"],
+            ["p", "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10"],
+            ["e", "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f"],
+        ];
+        expect(getCommentEventPointer(tags, true)).toEqual({
+            id: "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f",
+            kind: 1621,
+            pubkey: "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10",
+            relay: undefined,
+        });
+    });
+    it("should default to pubkey in E tag when root pubkey do not match", () => {
+        const tags = [
+            [
+                "E",
+                "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f",
+                "",
+                "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10",
+            ],
+            ["K", "1621"],
+            ["P", "bad-pubkey"],
+        ];
+        expect(getCommentEventPointer(tags, true)).toEqual({
+            id: "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f",
+            kind: 1621,
+            pubkey: "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10",
+            relay: undefined,
+        });
+    });
+    it("should get pubkey from E tag", () => {
+        const tags = [
+            [
+                "E",
+                "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f",
+                "",
+                "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10",
+            ],
+            ["K", "1621"],
+        ];
+        expect(getCommentEventPointer(tags, true)).toEqual({
+            id: "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f",
+            kind: 1621,
+            pubkey: "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10",
+            relay: undefined,
+        });
+    });
+    it("should get relay from E tag", () => {
+        const tags = [
+            ["E", "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f", "wss://relay.io/"],
+            ["K", "1621"],
+            ["P", "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10"],
+        ];
+        expect(getCommentEventPointer(tags, true)).toEqual({
+            id: "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f",
+            kind: 1621,
+            pubkey: "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10",
+            relay: "wss://relay.io/",
+        });
+    });
+    it("should throw if K tag is missing", () => {
+        const tags = [
+            ["E", "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f", "wss://relay.io/"],
+            ["P", "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10"],
+        ];
+        expect(() => {
+            getCommentEventPointer(tags, true);
+        }).toThrow("Missing kind tag");
+    });
+    it("should return null if missing E tag", () => {
+        const tags = [
+            ["K", "1621"],
+            ["P", "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10"],
+        ];
+        expect(getCommentEventPointer(tags, true)).toBe(null);
+        expect(getCommentEventPointer(tags)).toBe(null);
+    });
+});
+describe("getCommentAddressPointer", () => {
+    it("should get event id from E tag", () => {
+        // root
+        expect(getCommentAddressPointer([
+            ["A", "30000:e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10:list"],
+            ["E", "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f"],
+            ["K", "30000"],
+        ], true)).toEqual({
+            id: "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f",
+            kind: 30000,
+            pubkey: "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10",
+            identifier: "list",
+        });
+        // reply
+        expect(getCommentAddressPointer([
+            ["a", "30000:e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10:list"],
+            ["e", "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f"],
+            ["k", "30000"],
+        ])).toEqual({
+            id: "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f",
+            kind: 30000,
+            pubkey: "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10",
+            identifier: "list",
+        });
+    });
+    it("should get relay from A tag", () => {
+        // root
+        expect(getCommentAddressPointer([
+            ["A", "30000:e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10:list", "wss://relay.io/"],
+            ["K", "30000"],
+        ], true)).toEqual({
+            kind: 30000,
+            pubkey: "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10",
+            identifier: "list",
+            relay: "wss://relay.io/",
+        });
+        // reply
+        expect(getCommentAddressPointer([
+            ["a", "30000:e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10:list", "wss://relay.io/"],
+            ["k", "30000"],
+        ])).toEqual({
+            kind: 30000,
+            pubkey: "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10",
+            identifier: "list",
+            relay: "wss://relay.io/",
+        });
+    });
+    it("should get relay from E tag", () => {
+        // root
+        expect(getCommentAddressPointer([
+            ["A", "30000:e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10:list"],
+            ["E", "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f", "wss://relay.io/"],
+            ["K", "30000"],
+        ], true)).toEqual({
+            id: "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f",
+            kind: 30000,
+            pubkey: "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10",
+            identifier: "list",
+            relay: "wss://relay.io/",
+        });
+        // reply
+        expect(getCommentAddressPointer([
+            ["a", "30000:e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10:list"],
+            ["e", "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f", "wss://relay.io/"],
+            ["k", "30000"],
+        ])).toEqual({
+            id: "86c0b95589b016ffb703bfc080d49e54106e74e2d683295119c3453e494dbe6f",
+            kind: 30000,
+            pubkey: "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10",
+            identifier: "list",
+            relay: "wss://relay.io/",
+        });
+    });
+    it("should return A tag kind over K tag", () => {
+        // root
+        expect(getCommentAddressPointer([
+            ["A", "30010:e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10:list"],
+            ["K", "30000"],
+        ], true)).toEqual({
+            kind: 30010,
+            pubkey: "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10",
+            identifier: "list",
+        });
+        // reply
+        expect(getCommentAddressPointer([
+            ["a", "30010:e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10:list"],
+            ["k", "30000"],
+        ])).toEqual({
+            kind: 30010,
+            pubkey: "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10",
+            identifier: "list",
+        });
+    });
+    it("should throw if missing K tag", () => {
+        // root
+        expect(() => getCommentAddressPointer([["A", "30010:e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10:list"]], true)).toThrow("Missing kind tag");
+        // reply
+        expect(() => getCommentAddressPointer([["a", "30010:e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10:list"]])).toThrow("Missing kind tag");
+    });
+    it("should return null if missing A tag", () => {
+        const tags = [
+            ["K", "1621"],
+            ["P", "e4336cd525df79fa4d3af364fd9600d4b10dce4215aa4c33ed77ea0842344b10"],
+        ];
+        expect(getCommentEventPointer(tags, true)).toBe(null);
+        expect(getCommentEventPointer(tags)).toBe(null);
+    });
+});
+describe("getCommentExternalPointer", () => {
+    it("should get kind prefix from I tag", () => {
+        // root
+        expect(getCommentExternalPointer([
+            ["I", "podcast:item:guid:d98d189b-dc7b-45b1-8720-d4b98690f31f"],
+            ["K", "podcast:item:guid"],
+        ], true)).toEqual({
+            identifier: "podcast:item:guid:d98d189b-dc7b-45b1-8720-d4b98690f31f",
+            kind: "podcast:item:guid",
+        });
+        // reply
+        expect(getCommentExternalPointer([
+            ["i", "podcast:item:guid:d98d189b-dc7b-45b1-8720-d4b98690f31f"],
+            ["k", "podcast:item:guid"],
+        ])).toEqual({
+            identifier: "podcast:item:guid:d98d189b-dc7b-45b1-8720-d4b98690f31f",
+            kind: "podcast:item:guid",
+        });
+    });
+    it("should throw if missing K tag", () => {
+        // root
+        expect(() => getCommentExternalPointer([["I", "podcast:item:guid:d98d189b-dc7b-45b1-8720-d4b98690f31f"]], true)).toThrow("Missing kind tag");
+        // reply
+        expect(() => getCommentExternalPointer([["i", "podcast:item:guid:d98d189b-dc7b-45b1-8720-d4b98690f31f"]])).toThrow("Missing kind tag");
+    });
+});

package/dist/helpers/__tests__/emoji.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/helpers/__tests__/emoji.test.js

@@ -0,0 +1,15 @@
+import { describe, expect, it } from "vitest";
+import { getEmojiTag } from "../emoji.js";
+import { FakeUser } from "../../__tests__/fixtures.js";
+const user = new FakeUser();
+describe("getEmojiTag", () => {
+    it("Should find emoji tag", () => {
+        expect(getEmojiTag(user.note("hello :custom:", { tags: [["emoji", "custom", "https://cdn.example.com/reaction1.png"]] }), "custom")).toEqual(["emoji", "custom", "https://cdn.example.com/reaction1.png"]);
+    });
+    it("Should custom leading and trailing :", () => {
+        expect(getEmojiTag(user.note("hello :custom:", { tags: [["emoji", "custom", "https://cdn.example.com/reaction1.png"]] }), ":custom:")).toEqual(["emoji", "custom", "https://cdn.example.com/reaction1.png"]);
+    });
+    it("Should convert to lowercase", () => {
+        expect(getEmojiTag(user.note("hello :custom:", { tags: [["emoji", "custom", "https://cdn.example.com/reaction1.png"]] }), "CustoM")).toEqual(["emoji", "custom", "https://cdn.example.com/reaction1.png"]);
+    });
+});

package/dist/helpers/__tests__/event.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/helpers/__tests__/event.test.js

@@ -0,0 +1,36 @@
+import { describe, expect, it } from "vitest";
+import { EventIndexableTagsSymbol, getIndexableTags, getTagValue } from "../event.js";
+const event = {
+    content: "",
+    created_at: 1732889913,
+    id: "2d53511f321cc82dd13eedfb597c9fe834d12d271c10d8068e9d8cfb8f58d1b4",
+    kind: 30000,
+    pubkey: "266815e0c9210dfa324c6cba3573b14bee49da4209a9456f9484e5106cd408a5",
+    sig: "e6a442487ef44a8a00ec1e0a852e547991fcd5cbf19aa1a4219fa65d6f41022675e0745207649f4b16fe9a6c5c7c3693dc3e13966ffa5b2891634867c874cf22",
+    tags: [
+        ["d", "qRxLhBbTfRlxsvKSu0iUl"],
+        ["title", "Musicians"],
+        ["client", "noStrudel", "31990:266815e0c9210dfa324c6cba3573b14bee49da4209a9456f9484e5106cd408a5:1686066542546"],
+        ["p", "2842e34860c59dfacd5df48ba7a65065e6760d08c35f779553d83c2c2310b493"],
+        ["p", "28ca019b78b494c25a9da2d645975a8501c7e99b11302e5cbe748ee593fcb2cc"],
+        ["p", "f46192b8b9be1b43fc30ea27c7cb16210aede17252b3aa9692fbb3f2ba153199"],
+    ],
+};
+describe("getIndexableTags", () => {
+    it("should return a set of indexable tags for event", () => {
+        expect(Array.from(getIndexableTags(event))).toEqual(expect.arrayContaining([
+            "p:2842e34860c59dfacd5df48ba7a65065e6760d08c35f779553d83c2c2310b493",
+            "p:28ca019b78b494c25a9da2d645975a8501c7e99b11302e5cbe748ee593fcb2cc",
+            "p:f46192b8b9be1b43fc30ea27c7cb16210aede17252b3aa9692fbb3f2ba153199",
+        ]));
+    });
+    it("should cache value on EventIndexableTagsSymbol", () => {
+        getIndexableTags(event);
+        expect(Reflect.has(event, EventIndexableTagsSymbol)).toBe(true);
+    });
+});
+describe("getTagValue", () => {
+    it("should return value of tag if present", () => {
+        expect(getTagValue(event, "title")).toBe("Musicians");
+    });
+});

package/dist/helpers/__tests__/file-metadata.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/helpers/__tests__/file-metadata.test.js

@@ -0,0 +1,103 @@
+import { describe, expect, it } from "vitest";
+import { getFileMetadataFromImetaTag, parseFileMetadataTags } from "../file-metadata.js";
+describe("file metadata helpers", () => {
+    describe("parseFileMetadataTags", () => {
+        it("should parse a simple 1060 event", () => {
+            const tags = [
+                ["url", "https://image.nostr.build/30696696e57a2732d4e9f1b15ff4d4d4eaa64b759df6876863f436ff5d736eae.gif"],
+                ["ox", "30696696e57a2732d4e9f1b15ff4d4d4eaa64b759df6876863f436ff5d736eae"],
+                ["fallback", "https://media.tenor.com/wpvrkjn192gAAAAC/daenerys-targaryen.gif"],
+                ["x", "77fcf42b2b720babcdbe686eff67273d8a68862d74a2672db672bc48439a3ea5"],
+                ["m", "image/gif"],
+                ["dim", "360x306"],
+                ["bh", "L38zleNL00~W^kRj0L-p0KM_^kx]"],
+                ["blurhash", "L38zleNL00~W^kRj0L-p0KM_^kx]"],
+                [
+                    "thumb",
+                    "https://image.nostr.build/thumb/30696696e57a2732d4e9f1b15ff4d4d4eaa64b759df6876863f436ff5d736eae.gif",
+                ],
+                ["t", "gifbuddy"],
+                ["summary", "Khaleesi call dragons Daenerys Targaryen"],
+                ["alt", "a woman with blonde hair and a brooch on her shoulder"],
+                [
+                    "thumb",
+                    "https://media.tenor.com/wpvrkjn192gAAAAx/daenerys-targaryen.webp",
+                    "5d92423664fc15874b1d26c70a05a541ec09b5c438bf157977a87c8e64b31463",
+                ],
+                [
+                    "image",
+                    "https://media.tenor.com/wpvrkjn192gAAAAe/daenerys-targaryen.png",
+                    "5d92423664fc15874b1d26c70a05a541ec09b5c438bf157977a87c8e64b31463",
+                ],
+            ];
+            expect(parseFileMetadataTags(tags)).toEqual({
+                url: "https://image.nostr.build/30696696e57a2732d4e9f1b15ff4d4d4eaa64b759df6876863f436ff5d736eae.gif",
+                type: "image/gif",
+                dimensions: "360x306",
+                blurhash: "L38zleNL00~W^kRj0L-p0KM_^kx]",
+                sha256: "77fcf42b2b720babcdbe686eff67273d8a68862d74a2672db672bc48439a3ea5",
+                originalSha256: "30696696e57a2732d4e9f1b15ff4d4d4eaa64b759df6876863f436ff5d736eae",
+                thumbnail: "https://media.tenor.com/wpvrkjn192gAAAAx/daenerys-targaryen.webp",
+                image: "https://media.tenor.com/wpvrkjn192gAAAAe/daenerys-targaryen.png",
+                summary: "Khaleesi call dragons Daenerys Targaryen",
+                fallback: ["https://media.tenor.com/wpvrkjn192gAAAAC/daenerys-targaryen.gif"],
+                alt: "a woman with blonde hair and a brooch on her shoulder",
+            });
+        });
+    });
+    describe("getFileMetadataFromImetaTag", () => {
+        it("should parse simple imeta tag", () => {
+            expect(getFileMetadataFromImetaTag([
+                "imeta",
+                "url https://blossom.primal.net/3f4dbf2797ac4e90b00bcfe2728e5c8367ed909c48230ac454cc325f1993646c.jpg",
+                "x 3f4dbf2797ac4e90b00bcfe2728e5c8367ed909c48230ac454cc325f1993646c",
+                "dim 1024x1024",
+                "m image/jpeg",
+                "blurhash ggH{Aws:RPWBRjaeay?^ozV@aeRjaej[$gt7kCofWVofkCrrofxuofa|ozbHx]s:tRofaet7ay",
+            ])).toEqual({
+                url: "https://blossom.primal.net/3f4dbf2797ac4e90b00bcfe2728e5c8367ed909c48230ac454cc325f1993646c.jpg",
+                sha256: "3f4dbf2797ac4e90b00bcfe2728e5c8367ed909c48230ac454cc325f1993646c",
+                dimensions: "1024x1024",
+                type: "image/jpeg",
+                blurhash: "ggH{Aws:RPWBRjaeay?^ozV@aeRjaej[$gt7kCofWVofkCrrofxuofa|ozbHx]s:tRofaet7ay",
+            });
+        });
+        it("should parse thumbnail url", () => {
+            expect(getFileMetadataFromImetaTag([
+                "imeta",
+                "url https://blossom.primal.net/3f4dbf2797ac4e90b00bcfe2728e5c8367ed909c48230ac454cc325f1993646c.jpg",
+                "x 3f4dbf2797ac4e90b00bcfe2728e5c8367ed909c48230ac454cc325f1993646c",
+                "dim 1024x1024",
+                "m image/jpeg",
+                "blurhash ggH{Aws:RPWBRjaeay?^ozV@aeRjaej[$gt7kCofWVofkCrrofxuofa|ozbHx]s:tRofaet7ay",
+                "thumb https://exmaple.com/thumb.jpg",
+            ])).toEqual({
+                url: "https://blossom.primal.net/3f4dbf2797ac4e90b00bcfe2728e5c8367ed909c48230ac454cc325f1993646c.jpg",
+                sha256: "3f4dbf2797ac4e90b00bcfe2728e5c8367ed909c48230ac454cc325f1993646c",
+                dimensions: "1024x1024",
+                type: "image/jpeg",
+                blurhash: "ggH{Aws:RPWBRjaeay?^ozV@aeRjaej[$gt7kCofWVofkCrrofxuofa|ozbHx]s:tRofaet7ay",
+                thumbnail: "https://exmaple.com/thumb.jpg",
+            });
+        });
+        it("should parse multiple fallback urls", () => {
+            expect(getFileMetadataFromImetaTag([
+                "imeta",
+                "url https://blossom.primal.net/3f4dbf2797ac4e90b00bcfe2728e5c8367ed909c48230ac454cc325f1993646c.jpg",
+                "x 3f4dbf2797ac4e90b00bcfe2728e5c8367ed909c48230ac454cc325f1993646c",
+                "dim 1024x1024",
+                "m image/jpeg",
+                "blurhash ggH{Aws:RPWBRjaeay?^ozV@aeRjaej[$gt7kCofWVofkCrrofxuofa|ozbHx]s:tRofaet7ay",
+                "fallback https://exmaple.com/image2.jpg",
+                "fallback https://exmaple.com/image3.jpg",
+            ])).toEqual({
+                url: "https://blossom.primal.net/3f4dbf2797ac4e90b00bcfe2728e5c8367ed909c48230ac454cc325f1993646c.jpg",
+                sha256: "3f4dbf2797ac4e90b00bcfe2728e5c8367ed909c48230ac454cc325f1993646c",
+                dimensions: "1024x1024",
+                type: "image/jpeg",
+                blurhash: "ggH{Aws:RPWBRjaeay?^ozV@aeRjaej[$gt7kCofWVofkCrrofxuofa|ozbHx]s:tRofaet7ay",
+                fallback: ["https://exmaple.com/image2.jpg", "https://exmaple.com/image3.jpg"],
+            });
+        });
+    });
+});

package/dist/helpers/__tests__/hidden-tags.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/helpers/__tests__/hidden-tags.test.js

@@ -0,0 +1,29 @@
+import { describe, beforeEach, it, expect } from "vitest";
+import { finalizeEvent, generateSecretKey, getPublicKey, kinds, nip04 } from "nostr-tools";
+import { getHiddenTags, unlockHiddenTags } from "../hidden-tags.js";
+import { unixNow } from "../time.js";
+const key = generateSecretKey();
+const pubkey = getPublicKey(key);
+const signer = {
+    nip04: {
+        encrypt: (pubkey, plaintext) => nip04.encrypt(key, pubkey, plaintext),
+        decrypt: (pubkey, ciphertext) => nip04.decrypt(key, pubkey, ciphertext),
+    },
+};
+describe("Private Lists", () => {
+    describe("unlockHiddenTags", () => {
+        let list;
+        beforeEach(async () => {
+            list = finalizeEvent({
+                kind: kinds.Mutelist,
+                created_at: unixNow(),
+                content: await nip04.encrypt(key, pubkey, JSON.stringify([["p", "npub1ye5ptcxfyyxl5vjvdjar2ua3f0hynkjzpx552mu5snj3qmx5pzjscpknpr"]])),
+                tags: [],
+            }, key);
+        });
+        it("should unlock hidden tags", async () => {
+            await unlockHiddenTags(list, signer);
+            expect(getHiddenTags(list)).toEqual(expect.arrayContaining([["p", "npub1ye5ptcxfyyxl5vjvdjar2ua3f0hynkjzpx552mu5snj3qmx5pzjscpknpr"]]));
+        });
+    });
+});

package/dist/helpers/__tests__/mailboxes.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/helpers/{mailboxes.test.js → __tests__/mailboxes.test.js}

@@ -1,4 +1,5 @@
-import { getInboxes, getOutboxes } from "./mailboxes.js";
+import { describe, test, expect } from "vitest";
+import { getInboxes, getOutboxes } from "../mailboxes.js";
 const emptyEvent = {
     kind: 10002,
     content: "",
@@ -14,33 +15,33 @@ describe("Mailboxes", () => {
             expect(Array.from(getInboxes({
                 ...emptyEvent,
                 tags: [["r", "wss://inbox.com"]],
-            }))).toIncludeAllMembers(["wss://inbox.com/"]);
+            }))).toEqual(expect.arrayContaining(["wss://inbox.com/"]));
         });
         test("should remove bad urls", () => {
             expect(Array.from(getInboxes({
                 ...emptyEvent,
                 tags: [["r", "bad://inbox.com"]],
-            }))).toBeArrayOfSize(0);
+            }))).toHaveLength(0);
             expect(Array.from(getInboxes({
                 ...emptyEvent,
                 tags: [["r", "something that is not a url"]],
-            }))).toBeArrayOfSize(0);
+            }))).toHaveLength(0);
             expect(Array.from(getInboxes({
                 ...emptyEvent,
                 tags: [["r", "wss://inbox.com,wss://inbox.org"]],
-            }))).toBeArrayOfSize(0);
+            }))).toHaveLength(0);
         });
         test("without marker", () => {
             expect(Array.from(getInboxes({
                 ...emptyEvent,
                 tags: [["r", "wss://inbox.com/"]],
-            }))).toIncludeAllMembers(["wss://inbox.com/"]);
+            }))).toEqual(expect.arrayContaining(["wss://inbox.com/"]));
         });
         test("with marker", () => {
             expect(Array.from(getInboxes({
                 ...emptyEvent,
                 tags: [["r", "wss://inbox.com/", "read"]],
-            }))).toIncludeAllMembers(["wss://inbox.com/"]);
+            }))).toEqual(expect.arrayContaining(["wss://inbox.com/"]));
         });
     });
     describe("getOutboxes", () => {
@@ -48,33 +49,33 @@ describe("Mailboxes", () => {
             expect(Array.from(getOutboxes({
                 ...emptyEvent,
                 tags: [["r", "wss://outbox.com"]],
-            }))).toIncludeAllMembers(["wss://outbox.com/"]);
+            }))).toEqual(expect.arrayContaining(["wss://outbox.com/"]));
         });
         test("should remove bad urls", () => {
             expect(Array.from(getOutboxes({
                 ...emptyEvent,
                 tags: [["r", "bad://inbox.com"]],
-            }))).toBeArrayOfSize(0);
+            }))).toHaveLength(0);
             expect(Array.from(getOutboxes({
                 ...emptyEvent,
                 tags: [["r", "something that is not a url"]],
-            }))).toBeArrayOfSize(0);
+            }))).toHaveLength(0);
             expect(Array.from(getOutboxes({
                 ...emptyEvent,
                 tags: [["r", "wss://outbox.com,wss://inbox.org"]],
-            }))).toBeArrayOfSize(0);
+            }))).toHaveLength(0);
         });
         test("without marker", () => {
             expect(Array.from(getOutboxes({
                 ...emptyEvent,
                 tags: [["r", "wss://outbox.com/"]],
-            }))).toIncludeAllMembers(["wss://outbox.com/"]);
+            }))).toEqual(expect.arrayContaining(["wss://outbox.com/"]));
         });
         test("with marker", () => {
             expect(Array.from(getOutboxes({
                 ...emptyEvent,
                 tags: [["r", "wss://outbox.com/", "write"]],
-            }))).toIncludeAllMembers(["wss://outbox.com/"]);
+            }))).toEqual(expect.arrayContaining(["wss://outbox.com/"]));
         });
     });
 });

package/dist/helpers/__tests__/relays.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/helpers/__tests__/relays.test.js

@@ -0,0 +1,21 @@
+import { describe, expect, it } from "vitest";
+import { isSafeRelayURL } from "../relays.js";
+describe("isSafeRelayURL", () => {
+    it("should correctly filter URLs", () => {
+        // safe URLs
+        expect(isSafeRelayURL("wss://relay.damus.io/")).toBe(true);
+        expect(isSafeRelayURL("wss://nostrue.com")).toBe(true);
+        expect(isSafeRelayURL("ws://192.168.0.194:8080")).toBe(true);
+        expect(isSafeRelayURL("ws://localhost:4869/ws")).toBe(true);
+        expect(isSafeRelayURL("ws://localhost/testing")).toBe(true);
+        expect(isSafeRelayURL("ws://437fqnfqtcaquzvs5sd43ugznw7dsoatvtskoowgnpn6q5vqkljcrsyd.onion")).toBe(true);
+        expect(isSafeRelayURL("ws://hypr1fk4trjnhjf62r6hhkpettmvxhxx2uvkkg4u4ea44va2fvxvfkl4s82m6dy.hyper")).toBe(true);
+        // bad URLs
+        expect(isSafeRelayURL("")).toBe(false);
+        expect(isSafeRelayURL("bad")).toBe(false);
+        expect(isSafeRelayURL("bad wss://nostr.wine")).toBe(false);
+        expect(isSafeRelayURL("http://nostr.wine")).toBe(false);
+        expect(isSafeRelayURL("http://cache-relay.com")).toBe(false);
+        expect(isSafeRelayURL("wss://nostr.wine,wss://relayable.com")).toBe(false);
+    });
+});

package/dist/helpers/__tests__/tags.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/helpers/__tests__/tags.test.js

@@ -0,0 +1,24 @@
+import { describe, expect, it } from "vitest";
+import { isATag, isNameValueTag, processTags } from "../tags.js";
+import { getAddressPointerFromATag } from "../pointers.js";
+describe("isNameValueTag", () => {
+    it("should return true if tag has at least two indexes", () => {
+        expect(isNameValueTag(["a", "30000:pubkey:list"])).toBe(true);
+        expect(isNameValueTag(["title", "article", "other-value"])).toBe(true);
+    });
+    it("should ignore tags without values", () => {
+        expect(isNameValueTag(["a"])).toBe(false);
+        expect(isNameValueTag(["title"])).toBe(false);
+    });
+});
+describe("processTags", () => {
+    it("should filter out errors", () => {
+        expect(processTags([["a", "bad coordinate"], ["e"], ["a", "30000:pubkey:list"]], getAddressPointerFromATag)).toEqual([{ identifier: "list", kind: 30000, pubkey: "pubkey" }]);
+    });
+    it("should filter out undefined", () => {
+        expect(processTags([["a", "bad coordinate"], ["e"], ["a", "30000:pubkey:list"]], (tag) => isATag(tag) ? tag : undefined)).toEqual([
+            ["a", "bad coordinate"],
+            ["a", "30000:pubkey:list"],
+        ]);
+    });
+});

package/dist/helpers/__tests__/threading.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/helpers/__tests__/threading.test.js

@@ -0,0 +1,41 @@
+import { describe, expect, it } from "vitest";
+import { interpretThreadTags } from "../threading.js";
+describe("threading helpers", () => {
+    describe("interpretThreadTags", () => {
+        it("should handle legacy tags", () => {
+            expect(interpretThreadTags([
+                ["e", "root-id"],
+                ["e", "reply-id"],
+            ])).toEqual({ root: { a: undefined, e: ["e", "root-id"] }, reply: { a: undefined, e: ["e", "reply-id"] } });
+        });
+        it("should handle nip-10 tags", () => {
+            expect(interpretThreadTags([
+                ["e", "root-id", "relay", "root"],
+                ["e", "reply-id", "relay", "reply"],
+            ])).toEqual({
+                root: { a: undefined, e: ["e", "root-id", "relay", "root"] },
+                reply: { a: undefined, e: ["e", "reply-id", "relay", "reply"] },
+            });
+        });
+        it("should ignore mention nip-10 tags", () => {
+            expect(interpretThreadTags([
+                ["e", "root-id", "relay", "root"],
+                ["e", "mention-id", "relay", "mention"],
+                ["e", "reply-id", "relay", "reply"],
+            ])).toEqual({
+                root: { a: undefined, e: ["e", "root-id", "relay", "root"] },
+                reply: { a: undefined, e: ["e", "reply-id", "relay", "reply"] },
+            });
+        });
+        it("should handle single nip-10 tags", () => {
+            expect(interpretThreadTags([["e", "root-id", "relay", "root"]])).toEqual({
+                root: { a: undefined, e: ["e", "root-id", "relay", "root"] },
+                reply: { a: undefined, e: ["e", "root-id", "relay", "root"] },
+            });
+            expect(interpretThreadTags([["e", "reply-id", "relay", "reply"]])).toEqual({
+                root: { a: undefined, e: ["e", "reply-id", "relay", "reply"] },
+                reply: { a: undefined, e: ["e", "reply-id", "relay", "reply"] },
+            });
+        });
+    });
+});

package/dist/helpers/blossom.d.ts

@@ -0,0 +1,9 @@
+export declare const BLOSSOM_SERVER_LIST_KIND = 10063;
+/** Check if two servers are the same */
+export declare function areBlossomServersEqual(a: string | URL, b: string | URL): boolean;
+/** Checks if a string is a sha256 hash */
+export declare function isSha256(str: string): boolean;
+/** Returns an ordered array of servers found in a server list event (10063) */
+export declare function getBlossomServersFromList(event: {
+    tags: string[][];
+} | string[][]): URL[];