@sdxc/activitypub 0.0.0-pre.1

package/dist/fixtures/gotosocial.js

@@ -0,0 +1,115 @@
+/**
+ * Documents in the shapes GoToSocial emits: members sorted by name, one-entry lists
+ * written as a single value, a key id without a fragment, and `interactionPolicy`. Ids
+ * are made up; the members are GoToSocial's.
+ *
+ * @author [Sergio Xalambrí](https://sergiodxa.com)
+ * @copyright Sergio Xalambrí 2026
+ */
+import { FAKE_PUBLIC_KEY_PEM, LOCAL_ACTOR, LOCAL_ARTICLE } from "./shared.js";
+/** A GoToSocial account that approves followers by hand. */
+export const GOTOSOCIAL_ACTOR = {
+    "@context": [
+        "https://w3id.org/security/v1",
+        "https://www.w3.org/ns/activitystreams",
+        {
+            discoverable: "toot:discoverable",
+            featured: { "@id": "toot:featured", "@type": "@id" },
+            manuallyApprovesFollowers: "as:manuallyApprovesFollowers",
+            toot: "http://joinmastodon.org/ns#",
+        },
+    ],
+    discoverable: true,
+    endpoints: { sharedInbox: "https://gts.superseriousbusiness.org/sharedInbox" },
+    featured: "https://gts.superseriousbusiness.org/users/erin/collections/featured",
+    followers: "https://gts.superseriousbusiness.org/users/erin/followers",
+    following: "https://gts.superseriousbusiness.org/users/erin/following",
+    icon: {
+        mediaType: "image/webp",
+        type: "Image",
+        url: "https://gts.superseriousbusiness.org/fileserver/01H0000000/attachment/original/01H0000001.webp",
+    },
+    id: "https://gts.superseriousbusiness.org/users/erin",
+    inbox: "https://gts.superseriousbusiness.org/users/erin/inbox",
+    manuallyApprovesFollowers: true,
+    name: "Erin",
+    outbox: "https://gts.superseriousbusiness.org/users/erin/outbox",
+    preferredUsername: "erin",
+    publicKey: {
+        id: "https://gts.superseriousbusiness.org/users/erin/main-key",
+        owner: "https://gts.superseriousbusiness.org/users/erin",
+        publicKeyPem: FAKE_PUBLIC_KEY_PEM,
+    },
+    published: "2023-01-10T12:00:00Z",
+    summary: "<p>Small server, big opinions.</p>",
+    tag: [],
+    type: "Person",
+    url: "https://gts.superseriousbusiness.org/@erin",
+};
+/** A reply addressed to one audience entry each, written as plain values. */
+export const GOTOSOCIAL_CREATE_NOTE = {
+    "@context": [
+        "https://gotosocial.org/ns",
+        "https://www.w3.org/ns/activitystreams",
+        { sensitive: "as:sensitive" },
+    ],
+    actor: "https://gts.superseriousbusiness.org/users/erin",
+    cc: "https://gts.superseriousbusiness.org/users/erin/followers",
+    id: "https://gts.superseriousbusiness.org/users/erin/statuses/01J9Z8Y7X6W5V4T3S2R1Q0P9N8/activity",
+    object: {
+        attachment: [],
+        attributedTo: "https://gts.superseriousbusiness.org/users/erin",
+        cc: ["https://gts.superseriousbusiness.org/users/erin/followers", LOCAL_ACTOR],
+        content: "<p>Agreed with most of this.</p>",
+        contentMap: { en: "<p>Agreed with most of this.</p>" },
+        id: "https://gts.superseriousbusiness.org/users/erin/statuses/01J9Z8Y7X6W5V4T3S2R1Q0P9N8",
+        inReplyTo: LOCAL_ARTICLE,
+        interactionPolicy: {
+            canAnnounce: {
+                always: ["https://www.w3.org/ns/activitystreams#Public"],
+                approvalRequired: [],
+            },
+            canLike: { always: ["https://www.w3.org/ns/activitystreams#Public"], approvalRequired: [] },
+            canReply: { always: ["https://www.w3.org/ns/activitystreams#Public"], approvalRequired: [] },
+        },
+        published: "2026-10-04T07:15:00Z",
+        replies: {
+            first: {
+                id: "https://gts.superseriousbusiness.org/users/erin/statuses/01J9Z8Y7X6W5V4T3S2R1Q0P9N8/replies?page=true",
+                next: "https://gts.superseriousbusiness.org/users/erin/statuses/01J9Z8Y7X6W5V4T3S2R1Q0P9N8/replies?only_other_accounts=false&page=true",
+                partOf: "https://gts.superseriousbusiness.org/users/erin/statuses/01J9Z8Y7X6W5V4T3S2R1Q0P9N8/replies",
+                type: "CollectionPage",
+            },
+            id: "https://gts.superseriousbusiness.org/users/erin/statuses/01J9Z8Y7X6W5V4T3S2R1Q0P9N8/replies",
+            type: "Collection",
+        },
+        sensitive: false,
+        summary: "",
+        tag: { href: LOCAL_ACTOR, name: "@hello@letters.blog", type: "Mention" },
+        to: "https://www.w3.org/ns/activitystreams#Public",
+        type: "Note",
+        url: "https://gts.superseriousbusiness.org/@erin/statuses/01J9Z8Y7X6W5V4T3S2R1Q0P9N8",
+    },
+    published: "2026-10-04T07:15:00Z",
+    to: "https://www.w3.org/ns/activitystreams#Public",
+    type: "Create",
+};
+/** A follow of the local actor, written with a string `@context`. */
+export const GOTOSOCIAL_FOLLOW = {
+    "@context": "https://www.w3.org/ns/activitystreams",
+    actor: "https://gts.superseriousbusiness.org/users/erin",
+    id: "https://gts.superseriousbusiness.org/users/erin/follow/01J9Z9A0B1C2D3E4F5G6H7J8K9",
+    object: LOCAL_ACTOR,
+    type: "Follow",
+};
+/** Pinned posts: an ordered collection whose items are IRIs. */
+export const GOTOSOCIAL_FEATURED = {
+    "@context": "https://www.w3.org/ns/activitystreams",
+    id: "https://gts.superseriousbusiness.org/users/erin/collections/featured",
+    orderedItems: [
+        "https://gts.superseriousbusiness.org/users/erin/statuses/01J9Z8Y7X6W5V4T3S2R1Q0P9N8",
+        "https://gts.superseriousbusiness.org/users/erin/statuses/01J0000000000000000000000",
+    ],
+    totalItems: 2,
+    type: "OrderedCollection",
+};

package/dist/fixtures/index.d.ts

@@ -0,0 +1,15 @@
+export * from "./gotosocial.js";
+export * from "./mastodon.js";
+export * from "./misskey.js";
+export * from "./pixelfed.js";
+export * from "./shared.js";
+export * from "./threads.js";
+/** One captured-shape document and the reader that must accept it. */
+export interface Fixture {
+    /** `<implementation> <what>`, for a test name. */
+    name: string;
+    kind: "activity" | "actor" | "collection";
+    document: unknown;
+}
+/** Every fixture, grouped by implementation. */
+export declare const FIXTURES: Fixture[];

package/dist/fixtures/index.js

@@ -0,0 +1,50 @@
+/**
+ * Every captured-shape document, labelled with the implementation that emits it and the
+ * reader it is for, so one test can run each `parse*` over all of them and later suites
+ * reuse the same documents as inbound traffic.
+ *
+ * @author [Sergio Xalambrí](https://sergiodxa.com)
+ * @copyright Sergio Xalambrí 2026
+ */
+import { GOTOSOCIAL_ACTOR, GOTOSOCIAL_CREATE_NOTE, GOTOSOCIAL_FEATURED, GOTOSOCIAL_FOLLOW, } from "./gotosocial.js";
+import { MASTODON_ACCEPT, MASTODON_ACTOR, MASTODON_ANNOUNCE, MASTODON_CREATE_NOTE, MASTODON_DELETE_ACTOR, MASTODON_DELETE_NOTE, MASTODON_FOLLOW, MASTODON_FOLLOWERS, MASTODON_LIKE, MASTODON_OUTBOX_PAGE, MASTODON_QUOTE, MASTODON_REPLIES, MASTODON_UNDO_FOLLOW, } from "./mastodon.js";
+import { MISSKEY_ACTOR, MISSKEY_CREATE_NOTE, MISSKEY_FOLLOW, MISSKEY_QUOTE, MISSKEY_REACTION, } from "./misskey.js";
+import { PIXELFED_ACTOR, PIXELFED_CREATE_NOTE, PIXELFED_LIKE } from "./pixelfed.js";
+import { THREADS_ACTOR, THREADS_CREATE_NOTE, THREADS_LIKE } from "./threads.js";
+export * from "./gotosocial.js";
+export * from "./mastodon.js";
+export * from "./misskey.js";
+export * from "./pixelfed.js";
+export * from "./shared.js";
+export * from "./threads.js";
+/** Every fixture, grouped by implementation. */
+export const FIXTURES = [
+    { name: "Mastodon actor", kind: "actor", document: MASTODON_ACTOR },
+    { name: "Mastodon Create/Note", kind: "activity", document: MASTODON_CREATE_NOTE },
+    { name: "Mastodon Like", kind: "activity", document: MASTODON_LIKE },
+    { name: "Mastodon Announce", kind: "activity", document: MASTODON_ANNOUNCE },
+    { name: "Mastodon Follow", kind: "activity", document: MASTODON_FOLLOW },
+    { name: "Mastodon Undo/Follow", kind: "activity", document: MASTODON_UNDO_FOLLOW },
+    { name: "Mastodon Accept/Follow", kind: "activity", document: MASTODON_ACCEPT },
+    { name: "Mastodon Delete/Tombstone", kind: "activity", document: MASTODON_DELETE_NOTE },
+    { name: "Mastodon Delete/actor", kind: "activity", document: MASTODON_DELETE_ACTOR },
+    { name: "Mastodon 4.5 quote", kind: "activity", document: MASTODON_QUOTE },
+    { name: "Mastodon followers", kind: "collection", document: MASTODON_FOLLOWERS },
+    { name: "Mastodon outbox page", kind: "collection", document: MASTODON_OUTBOX_PAGE },
+    { name: "Mastodon replies", kind: "collection", document: MASTODON_REPLIES },
+    { name: "Misskey actor", kind: "actor", document: MISSKEY_ACTOR },
+    { name: "Misskey Create/Note", kind: "activity", document: MISSKEY_CREATE_NOTE },
+    { name: "Misskey reaction", kind: "activity", document: MISSKEY_REACTION },
+    { name: "Misskey quote", kind: "activity", document: MISSKEY_QUOTE },
+    { name: "Misskey Follow", kind: "activity", document: MISSKEY_FOLLOW },
+    { name: "Pixelfed actor", kind: "actor", document: PIXELFED_ACTOR },
+    { name: "Pixelfed Create/Note", kind: "activity", document: PIXELFED_CREATE_NOTE },
+    { name: "Pixelfed Like", kind: "activity", document: PIXELFED_LIKE },
+    { name: "GoToSocial actor", kind: "actor", document: GOTOSOCIAL_ACTOR },
+    { name: "GoToSocial Create/Note", kind: "activity", document: GOTOSOCIAL_CREATE_NOTE },
+    { name: "GoToSocial Follow", kind: "activity", document: GOTOSOCIAL_FOLLOW },
+    { name: "GoToSocial featured", kind: "collection", document: GOTOSOCIAL_FEATURED },
+    { name: "Threads actor", kind: "actor", document: THREADS_ACTOR },
+    { name: "Threads Create/Note", kind: "activity", document: THREADS_CREATE_NOTE },
+    { name: "Threads Like", kind: "activity", document: THREADS_LIKE },
+];

package/dist/fixtures/mastodon.d.ts

@@ -0,0 +1,489 @@
+/** A Mastodon account: profile fields, featured collection, a shared inbox and `#main-key`. */
+export declare const MASTODON_ACTOR: {
+    "@context": (string | {
+        manuallyApprovesFollowers: string;
+        toot: string;
+        featured: {
+            "@id": string;
+            "@type": string;
+        };
+        featuredTags: {
+            "@id": string;
+            "@type": string;
+        };
+        alsoKnownAs: {
+            "@id": string;
+            "@type": string;
+        };
+        movedTo: {
+            "@id": string;
+            "@type": string;
+        };
+        schema: string;
+        PropertyValue: string;
+        value: string;
+        discoverable: string;
+        suspended: string;
+        memorial: string;
+        indexable: string;
+        attributionDomains: {
+            "@id": string;
+            "@type": string;
+        };
+        focalPoint: {
+            "@container": string;
+            "@id": string;
+        };
+    })[];
+    id: string;
+    type: string;
+    following: string;
+    followers: string;
+    inbox: string;
+    outbox: string;
+    featured: string;
+    featuredTags: string;
+    preferredUsername: string;
+    name: string;
+    summary: string;
+    url: string;
+    manuallyApprovesFollowers: boolean;
+    discoverable: boolean;
+    indexable: boolean;
+    published: string;
+    memorial: boolean;
+    devices: string;
+    alsoKnownAs: string[];
+    publicKey: {
+        id: string;
+        owner: string;
+        publicKeyPem: string;
+    };
+    tag: {
+        id: string;
+        type: string;
+        name: string;
+        updated: string;
+        icon: {
+            type: string;
+            mediaType: string;
+            url: string;
+        };
+    }[];
+    attachment: {
+        type: string;
+        name: string;
+        value: string;
+    }[];
+    endpoints: {
+        sharedInbox: string;
+    };
+    icon: {
+        type: string;
+        mediaType: string;
+        url: string;
+    };
+    image: {
+        type: string;
+        mediaType: string;
+        url: string;
+    };
+};
+/** A public reply to a local article, with an image, a mention, a hashtag and an emoji. */
+export declare const MASTODON_CREATE_NOTE: {
+    "@context": (string | {
+        ostatus: string;
+        atomUri: string;
+        inReplyToAtomUri: string;
+        conversation: string;
+        sensitive: string;
+        toot: string;
+        votersCount: string;
+        blurhash: string;
+        focalPoint: {
+            "@container": string;
+            "@id": string;
+        };
+        Hashtag: string;
+        Emoji: string;
+        quote: {
+            "@id": string;
+            "@type": string;
+        };
+        quoteUri: string;
+        _misskey_quote: string;
+    })[];
+    id: string;
+    type: string;
+    actor: string;
+    published: string;
+    to: string[];
+    cc: string[];
+    object: {
+        id: string;
+        type: string;
+        summary: null;
+        inReplyTo: string;
+        published: string;
+        url: string;
+        attributedTo: string;
+        to: string[];
+        cc: string[];
+        sensitive: boolean;
+        atomUri: string;
+        inReplyToAtomUri: string;
+        conversation: string;
+        content: string;
+        contentMap: {
+            en: string;
+        };
+        updated: string;
+        attachment: {
+            type: string;
+            mediaType: string;
+            url: string;
+            name: string;
+            blurhash: string;
+            focalPoint: number[];
+            width: number;
+            height: number;
+        }[];
+        tag: ({
+            type: string;
+            href: string;
+            name: string;
+            id?: undefined;
+            updated?: undefined;
+            icon?: undefined;
+        } | {
+            id: string;
+            type: string;
+            name: string;
+            updated: string;
+            icon: {
+                type: string;
+                mediaType: string;
+                url: string;
+            };
+            href?: undefined;
+        })[];
+        replies: {
+            id: string;
+            type: string;
+            first: {
+                type: string;
+                next: string;
+                partOf: string;
+                items: never[];
+            };
+        };
+        likes: {
+            id: string;
+            type: string;
+            totalItems: number;
+        };
+        shares: {
+            id: string;
+            type: string;
+            totalItems: number;
+        };
+    };
+    signature: {
+        type: string;
+        creator: string;
+        created: string;
+        signatureValue: string;
+    };
+};
+/** A favourite of a local article; Mastodon's Like ids are fragments of the actor. */
+export declare const MASTODON_LIKE: {
+    "@context": string;
+    id: string;
+    type: string;
+    actor: string;
+    object: string;
+};
+/** A boost of a local article. */
+export declare const MASTODON_ANNOUNCE: {
+    "@context": string;
+    id: string;
+    type: string;
+    actor: string;
+    published: string;
+    to: string[];
+    cc: string[];
+    object: string;
+};
+/** A follow of the local actor; Mastodon ids a Follow with a bare UUID path. */
+export declare const MASTODON_FOLLOW: {
+    "@context": string;
+    id: string;
+    type: string;
+    actor: string;
+    object: string;
+};
+/** An unfollow, embedding the Follow it undoes. */
+export declare const MASTODON_UNDO_FOLLOW: {
+    "@context": string;
+    id: string;
+    type: string;
+    actor: string;
+    object: {
+        id: string;
+        type: string;
+        actor: string;
+        object: string;
+    };
+};
+/** Mastodon accepting a follow the local actor sent, with the Follow embedded. */
+export declare const MASTODON_ACCEPT: {
+    "@context": string;
+    id: string;
+    type: string;
+    actor: string;
+    object: {
+        id: string;
+        type: string;
+        actor: string;
+        object: string;
+    };
+};
+/** A deleted status, sent as a Delete of its Tombstone. */
+export declare const MASTODON_DELETE_NOTE: {
+    "@context": (string | {
+        ostatus: string;
+        atomUri: string;
+    })[];
+    id: string;
+    type: string;
+    actor: string;
+    to: string[];
+    object: {
+        id: string;
+        type: string;
+        atomUri: string;
+    };
+};
+/** A deleted account, which Mastodon sends to every server it ever talked to. */
+export declare const MASTODON_DELETE_ACTOR: {
+    "@context": string;
+    id: string;
+    type: string;
+    actor: string;
+    to: string[];
+    object: string;
+};
+/** A Mastodon 4.5 quote post, with the FEP-044f `quote` and the names older servers read. */
+export declare const MASTODON_QUOTE: {
+    "@context": (string | {
+        ostatus: string;
+        atomUri: string;
+        inReplyToAtomUri: string;
+        conversation: string;
+        sensitive: string;
+        toot: string;
+        votersCount: string;
+        blurhash: string;
+        focalPoint: {
+            "@container": string;
+            "@id": string;
+        };
+        Hashtag: string;
+        Emoji: string;
+        quote: {
+            "@id": string;
+            "@type": string;
+        };
+        quoteUri: string;
+        _misskey_quote: string;
+    })[];
+    id: string;
+    type: string;
+    actor: string;
+    published: string;
+    to: string[];
+    cc: string[];
+    object: {
+        id: string;
+        type: string;
+        summary: null;
+        inReplyTo: null;
+        published: string;
+        url: string;
+        attributedTo: string;
+        to: string[];
+        cc: string[];
+        sensitive: boolean;
+        content: string;
+        contentMap: {
+            en: string;
+        };
+        quote: string;
+        _misskey_quote: string;
+        quoteUri: string;
+        attachment: never[];
+        tag: never[];
+    };
+};
+/** A followers collection that shows its count and pages its members. */
+export declare const MASTODON_FOLLOWERS: {
+    "@context": string;
+    id: string;
+    type: string;
+    totalItems: number;
+    first: string;
+};
+/** The first page of an outbox, its items each a Create with the Note embedded. */
+export declare const MASTODON_OUTBOX_PAGE: {
+    "@context": (string | {
+        ostatus: string;
+        atomUri: string;
+        inReplyToAtomUri: string;
+        conversation: string;
+        sensitive: string;
+        toot: string;
+        votersCount: string;
+        blurhash: string;
+        focalPoint: {
+            "@container": string;
+            "@id": string;
+        };
+        Hashtag: string;
+        Emoji: string;
+        quote: {
+            "@id": string;
+            "@type": string;
+        };
+        quoteUri: string;
+        _misskey_quote: string;
+    })[];
+    id: string;
+    type: string;
+    next: string;
+    prev: string;
+    partOf: string;
+    orderedItems: ({
+        "@context": (string | {
+            ostatus: string;
+            atomUri: string;
+            inReplyToAtomUri: string;
+            conversation: string;
+            sensitive: string;
+            toot: string;
+            votersCount: string;
+            blurhash: string;
+            focalPoint: {
+                "@container": string;
+                "@id": string;
+            };
+            Hashtag: string;
+            Emoji: string;
+            quote: {
+                "@id": string;
+                "@type": string;
+            };
+            quoteUri: string;
+            _misskey_quote: string;
+        })[];
+        id: string;
+        type: string;
+        actor: string;
+        published: string;
+        to: string[];
+        cc: string[];
+        object: {
+            id: string;
+            type: string;
+            summary: null;
+            inReplyTo: string;
+            published: string;
+            url: string;
+            attributedTo: string;
+            to: string[];
+            cc: string[];
+            sensitive: boolean;
+            atomUri: string;
+            inReplyToAtomUri: string;
+            conversation: string;
+            content: string;
+            contentMap: {
+                en: string;
+            };
+            updated: string;
+            attachment: {
+                type: string;
+                mediaType: string;
+                url: string;
+                name: string;
+                blurhash: string;
+                focalPoint: number[];
+                width: number;
+                height: number;
+            }[];
+            tag: ({
+                type: string;
+                href: string;
+                name: string;
+                id?: undefined;
+                updated?: undefined;
+                icon?: undefined;
+            } | {
+                id: string;
+                type: string;
+                name: string;
+                updated: string;
+                icon: {
+                    type: string;
+                    mediaType: string;
+                    url: string;
+                };
+                href?: undefined;
+            })[];
+            replies: {
+                id: string;
+                type: string;
+                first: {
+                    type: string;
+                    next: string;
+                    partOf: string;
+                    items: never[];
+                };
+            };
+            likes: {
+                id: string;
+                type: string;
+                totalItems: number;
+            };
+            shares: {
+                id: string;
+                type: string;
+                totalItems: number;
+            };
+        };
+        signature: {
+            type: string;
+            creator: string;
+            created: string;
+            signatureValue: string;
+        };
+    } | {
+        id: string;
+        type: string;
+        actor: string;
+        published: string;
+        to: string[];
+        cc: string[];
+        object: string;
+    })[];
+};
+/** A status's replies: a Collection whose first page is embedded without an id. */
+export declare const MASTODON_REPLIES: {
+    id: string;
+    type: string;
+    first: {
+        type: string;
+        next: string;
+        partOf: string;
+        items: never[];
+    };
+};