@atcute/bluesky-threading 1.0.0

package/LICENSE

@@ -0,0 +1,17 @@
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# @atcute/bluesky-threading
+
+create Bluesky threads containing multiple posts with one write.
+
+```ts
+import { XRPC } from '@atcute/client';
+import { AtpAuth } from '@atcute/client/middlewares/auth';
+
+import RichTextBuilder from '@atcute/bluesky-richtext-builder';
+import { publishThread } from '@atcute/bluesky-threading';
+
+const rpc = new XRPC({ service: 'https://bsky.social' });
+const auth = new AtpAuth(rpc);
+
+await auth.login({ identifier: '...', password: '...' });
+
+await publishThread(rpc, {
+	author: 'did:plc:ia76kvnndjutgedggx2ibrem',
+	languages: ['en'],
+	posts: [
+		{
+			content: new RichTextBuilder()
+				.addText('Hello, please visit my website! ')
+				.addLink('example.com', 'https://example.com'),
+		},
+		{
+			content: {
+				text: `Here's the second post!`,
+			},
+		},
+		{
+			content: {
+				text: `Third post for good measure.`,
+			},
+		},
+	],
+});
+```

package/dist/cbor.d.ts

@@ -0,0 +1,3 @@
+export declare function serializeRecordCid(record: {
+    $type: string;
+}): Promise<string>;

package/dist/cbor.js

@@ -0,0 +1,12 @@
+import { encode } from '@atcute/cbor';
+import { create, format } from '@atcute/cid';
+// Sanity-check by requiring a $type here, this is because the records are
+// expected to be encoded with it, even though the PDS accepts record writes
+// without the field.
+export async function serializeRecordCid(record) {
+    const bytes = encode(record);
+    const cid = await create(0x71, bytes);
+    const serialized = format(cid);
+    return serialized;
+}
+//# sourceMappingURL=cbor.js.map

package/dist/cbor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cbor.js","sourceRoot":"","sources":["../lib/cbor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE7C,0EAA0E;AAC1E,4EAA4E;AAC5E,qBAAqB;AACrB,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAyB;IACjE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAE7B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAE/B,OAAO,UAAU,CAAC;AACnB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import '@atcute/bluesky/lexicons';
+import { type XRPC } from '@atcute/client';
+import type { Brand, ComAtprotoRepoApplyWrites } from '@atcute/client/lexicons';
+import type { ComposedThread } from './types.js';
+export type * from './types.js';
+/**
+ * Create post records and publish them
+ * @param rpc An authenticated Bluesky RPC client
+ * @param thread Composed thread
+ * @returns An array of post records that were published
+ */
+export declare function publishThread(rpc: XRPC, thread: Omit<ComposedThread, 'rpc'>): Promise<Brand.Union<ComAtprotoRepoApplyWrites.Create>[]>;
+/**
+ * Create post records without publishing, allows you to do it yourself.
+ * @param thread Composed thread
+ * @returns An array of post records
+ */
+export declare function createThread(thread: ComposedThread): Promise<Brand.Union<ComAtprotoRepoApplyWrites.Create>[]>;

package/dist/index.js

@@ -0,0 +1,306 @@
+import '@atcute/bluesky/lexicons';
+import { XRPCError } from '@atcute/client';
+import * as TID from '@atcute/tid';
+import { serializeRecordCid } from './cbor.js';
+import { getNow } from './time.js';
+/**
+ * Create post records and publish them
+ * @param rpc An authenticated Bluesky RPC client
+ * @param thread Composed thread
+ * @returns An array of post records that were published
+ */
+export async function publishThread(rpc, thread) {
+    const records = await createThread({ ...thread, rpc });
+    await rpc.call('com.atproto.repo.applyWrites', {
+        signal: thread.signal,
+        data: {
+            repo: thread.author,
+            writes: records,
+        },
+    });
+    return records;
+}
+/**
+ * Create post records without publishing, allows you to do it yourself.
+ * @param thread Composed thread
+ * @returns An array of post records
+ */
+export async function createThread(thread) {
+    const rpc = thread.rpc;
+    const signal = thread.signal;
+    const did = thread.author;
+    const posts = thread.posts;
+    const threadgate = thread.gate;
+    const languages = thread.languages;
+    const writes = [];
+    const now = thread.createdAt !== undefined ? new Date(thread.createdAt) : new Date(getNow());
+    assert(!Number.isNaN(now.getTime()), `provided createdAt value is invalid`);
+    let reply;
+    let rkey;
+    if (thread.reply) {
+        let post = thread.reply;
+        if (typeof post === 'string') {
+            // AT-URI being passed
+            assertXrpc(rpc, `ComposedThread.reply`);
+            post = await getPost(post);
+        }
+        let root;
+        let ref;
+        if ('record' in post) {
+            // AppBskyFeedDefs.PostView being passed
+            root = post.record.reply?.root;
+            ref = { uri: post.uri, cid: post.cid };
+        }
+        else if ('value' in post) {
+            // AppBskyEmbedRecord.ViewRecord being passed
+            root = post.value.reply?.root;
+            ref = { uri: post.uri, cid: post.cid };
+        }
+        else {
+            assert(false, `Unexpected end of code`);
+        }
+        reply = {
+            root: root ? { uri: root.uri, cid: root.cid } : ref,
+            parent: ref,
+        };
+    }
+    assert(!reply || !threadgate, `threadgate and reply are mutually exclusive`);
+    for (let idx = 0, len = posts.length; idx < len; idx++) {
+        // Get the record key for this post
+        rkey = TID.createRaw(now.getTime(), Math.floor(Math.random() * 1023));
+        const post = posts[idx];
+        const uri = `at://${did}/app.bsky.feed.post/${rkey}`;
+        // Resolve embeds
+        let embed;
+        if (post.embed !== undefined) {
+            embed = await resolveEmbed(post.embed);
+        }
+        // Get the self-labels
+        const labels = getEmbedLabels(post.embed);
+        let selfLabels;
+        if (labels?.length) {
+            selfLabels = {
+                $type: 'com.atproto.label.defs#selfLabels',
+                values: labels.map((val) => ({ val })),
+            };
+        }
+        // Now form the record
+        const content = post.content;
+        const record = {
+            // IMPORTANT: $type has to exist, CID is calculated with the `$type` field
+            // present and will produce the wrong CID if you omit it.
+            // `createRecord` and `applyWrites` currently lets you omit this and it'll
+            // add it for you, but we want to avoid that here.
+            $type: 'app.bsky.feed.post',
+            createdAt: now.toISOString(),
+            text: content.text,
+            facets: content.facets,
+            reply: reply,
+            embed: embed,
+            langs: post.languages ?? languages,
+            labels: selfLabels,
+        };
+        writes.push({
+            $type: 'com.atproto.repo.applyWrites#create',
+            collection: 'app.bsky.feed.post',
+            rkey: rkey,
+            value: record,
+        });
+        // If this is the first post, and we have a threadgate set, create one now.
+        if (idx === 0 && threadgate) {
+            const threadgateRecord = {
+                createdAt: now.toISOString(),
+                post: uri,
+                allow: resolveThreadgate(threadgate),
+            };
+            writes.push({
+                $type: 'com.atproto.repo.applyWrites#create',
+                collection: 'app.bsky.feed.threadgate',
+                rkey: rkey,
+                value: threadgateRecord,
+            });
+        }
+        if (idx !== len - 1) {
+            // Retrieve the next reply reference
+            const serialized = await serializeRecordCid(record);
+            const ref = {
+                cid: serialized,
+                uri: uri,
+            };
+            reply = {
+                root: reply ? reply.root : ref,
+                parent: ref,
+            };
+            // Posts are not guaranteed to be shown in the correct order if they are
+            // all posted with the same timestamp.
+            now.setMilliseconds(now.getMilliseconds() + 1);
+        }
+    }
+    return writes;
+    async function resolveEmbed(root) {
+        const type = root.type;
+        if (type === 'recordWithMedia') {
+            return {
+                $type: 'app.bsky.embed.recordWithMedia',
+                record: await resolveRecordEmbed(root.record),
+                media: await resolveMediaEmbed(root.media),
+            };
+        }
+        else if (type === 'image' || type === 'external') {
+            return await resolveMediaEmbed(root);
+        }
+        else {
+            return await resolveRecordEmbed(root);
+        }
+        async function resolveMediaEmbed(embed) {
+            const type = embed.type;
+            if (type === 'external') {
+                const rawThumb = embed.thumbnail;
+                let thumb;
+                if (rawThumb !== undefined) {
+                    if (rawThumb instanceof Blob) {
+                        assertXrpc(rpc, `PostExternalEmbed.thumbnail`);
+                        thumb = await uploadBlob(rawThumb);
+                    }
+                    else {
+                        thumb = rawThumb;
+                    }
+                }
+                return {
+                    $type: 'app.bsky.embed.external',
+                    external: {
+                        uri: embed.uri,
+                        title: embed.title,
+                        description: embed.description ?? '',
+                        thumb: thumb,
+                    },
+                };
+            }
+            if (type === 'image') {
+                const images = [];
+                for (const image of embed.images) {
+                    const aspectRatio = image.aspectRatio;
+                    const rawBlob = image.blob;
+                    let blob;
+                    if (rawBlob instanceof Blob) {
+                        assertXrpc(rpc, `PostImageEmbed.images[].blob`);
+                        blob = await uploadBlob(rawBlob);
+                    }
+                    else {
+                        blob = rawBlob;
+                    }
+                    images.push({
+                        image: blob,
+                        alt: image.alt ?? '',
+                        aspectRatio: aspectRatio ? { width: aspectRatio.width, height: aspectRatio.height } : undefined,
+                    });
+                }
+                return {
+                    $type: 'app.bsky.embed.images',
+                    images: images,
+                };
+            }
+            assert(false, `Unexpected end of code`);
+        }
+        async function resolveRecordEmbed(embed) {
+            const uri = embed.uri;
+            let cid = embed.cid;
+            if (cid === undefined) {
+                const type = embed.type;
+                if (type === 'quote') {
+                    assertXrpc(rpc, 'PostQuoteEmbed');
+                    const post = await getPost(uri);
+                    cid = post.cid;
+                }
+                else if (type === 'feed') {
+                    assertXrpc(rpc, 'PostFeedEmbed');
+                    const { data } = await rpc.get('app.bsky.feed.getFeedGenerator', {
+                        signal: signal,
+                        params: { feed: uri },
+                    });
+                    cid = data.view.cid;
+                }
+                else if (type === 'list') {
+                    assertXrpc(rpc, 'PostListEmbed');
+                    const { data } = await rpc.get('app.bsky.graph.getList', {
+                        signal: signal,
+                        params: { list: uri, limit: 1 },
+                    });
+                    cid = data.list.cid;
+                }
+                else if (type === 'starterpack') {
+                    assertXrpc(rpc, 'PostStarterpackEmbed');
+                    const { data } = await rpc.get('app.bsky.graph.getStarterPack', {
+                        signal: signal,
+                        params: { starterPack: uri },
+                    });
+                    cid = data.starterPack.cid;
+                }
+                else {
+                    assert(false, `Unexpected end of code`);
+                }
+            }
+            return {
+                $type: 'app.bsky.embed.record',
+                record: {
+                    uri: uri,
+                    cid: cid,
+                },
+            };
+        }
+    }
+    async function uploadBlob(blob) {
+        // `rpc` intentionally non-null asserted.
+        const { data } = await rpc.call('com.atproto.repo.uploadBlob', {
+            signal: signal,
+            data: blob,
+        });
+        return data.blob;
+    }
+    async function getPost(uri) {
+        // `rpc` intentionally non-null asserted.
+        const { data } = await rpc.get('app.bsky.feed.getPosts', {
+            signal: signal,
+            params: {
+                uris: [uri],
+            },
+        });
+        const post = data.posts[0];
+        if (!post) {
+            throw new XRPCError(400, { kind: 'NotFound', message: `Post not found: ${uri}` });
+        }
+        return post;
+    }
+}
+function resolveThreadgate(gate) {
+    const rules = [];
+    if (gate.follows) {
+        rules.push({ $type: 'app.bsky.feed.threadgate#followingRule' });
+    }
+    if (gate.mentions) {
+        rules.push({ $type: 'app.bsky.feed.threadgate#mentionRule' });
+    }
+    for (const listUri of gate.listUris ?? []) {
+        rules.push({ $type: 'app.bsky.feed.threadgate#listRule', list: listUri });
+    }
+    return rules;
+}
+function getEmbedLabels(embed) {
+    if (embed !== undefined) {
+        const type = embed.type;
+        if (type === 'image' || type === 'external') {
+            return embed.labels;
+        }
+    }
+}
+function assert(condition, message) {
+    if (!condition) {
+        throw new Error(message);
+    }
+}
+function assertXrpc(rpc, thing) {
+    if (rpc === undefined) {
+        throw new Error(`${thing} requires supplying RPC instance`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/time.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Return the current time, make sure that each call never returns same value
+ * so that posts sent at the same time from different accounts don't end up
+ * colliding with each other potentially causing them to not be shown.
+ */
+export declare function getNow(): number;

package/dist/time.js

@@ -0,0 +1,15 @@
+let lastTimestamp = 0;
+/**
+ * Return the current time, make sure that each call never returns same value
+ * so that posts sent at the same time from different accounts don't end up
+ * colliding with each other potentially causing them to not be shown.
+ */
+export function getNow() {
+    let timestamp = Math.max(Date.now(), lastTimestamp);
+    if (timestamp === lastTimestamp) {
+        // 30 ms apart seems reasonable, the expectation is <=25 posts per thread.
+        timestamp += 30;
+    }
+    return (lastTimestamp = timestamp);
+}
+//# sourceMappingURL=time.js.map

package/dist/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../lib/time.ts"],"names":[],"mappings":"AAAA,IAAI,aAAa,GAAW,CAAC,CAAC;AAE9B;;;;GAIG;AACH,MAAM,UAAU,MAAM;IACrB,IAAI,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,aAAa,CAAC,CAAC;IACpD,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;QACjC,0EAA0E;QAC1E,SAAS,IAAI,EAAE,CAAC;IACjB,CAAC;IAED,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;AACpC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,165 @@
+import type { XRPC } from '@atcute/client';
+import type { AppBskyEmbedRecord, AppBskyFeedDefs, AppBskyRichtextFacet, At } from '@atcute/client/lexicons';
+/** An embed that links to an external page */
+export interface PostExternalEmbed {
+    type: 'external';
+    /** Link to the page */
+    uri: string;
+    /** Page title */
+    title: string;
+    /** Page description */
+    description?: string;
+    /**
+     * Page thumbnail, accepts either a Web Blob instance or a blob returned from
+     * the `com.atproto.repo.uploadBlob` procedure. Supplying the former requires
+     * you to also supply an authenticated RPC instance for it to be able to make
+     * procedure calls.
+     */
+    thumbnail?: Blob | At.Blob;
+    /** Labels to describe this external embed */
+    labels?: string[];
+}
+/** An image within the image embed */
+export interface ComposedImage {
+    /**
+     * The image data, accepts either a Web Blob instance or a blob returned from
+     * the `com.atproto.repo.uploadBlob` procedure. Supplying the former requires
+     * you to also supply an authenticated RPC instance for it to be able to make
+     * procedure calls.
+     */
+    blob: Blob | At.Blob;
+    /**
+     * Alternative text for this image, helps describe images for low-vision users
+     * and provide context for everyone.
+     */
+    alt?: string;
+    /**
+     * Aspect ratio of the image, supplying this is recommended as clients makes
+     * use of it to properly display images.
+     */
+    aspectRatio?: {
+        /** Height of the image */
+        height: number;
+        /** Width of the image */
+        width: number;
+    };
+}
+/** An embed that displays images */
+export interface PostImageEmbed {
+    type: 'image';
+    /** An array of images */
+    images: ComposedImage[];
+    /** Labels to describe this image embed */
+    labels?: string[];
+}
+/** Union type of media embeds */
+export type PostMediaEmbed = PostExternalEmbed | PostImageEmbed;
+/** An embed that displays a feed card */
+export interface PostFeedEmbed {
+    type: 'feed';
+    /** AT-URI of the feed */
+    uri: At.Uri;
+    /**
+     * CID of the feed, if not supplied, requires you to also supply an RPC
+     * instance for it to be able to make query calls.
+     */
+    cid?: string;
+}
+/** An embed that displays a user/moderation list card */
+export interface PostListEmbed {
+    type: 'list';
+    /** AT-URI of the list */
+    uri: string;
+    /**
+     * CID of the list, if not supplied, requires you to also supply an RPC
+     * instance for it to be able to make query calls.
+     */
+    cid?: string;
+}
+/** An embed that displays a post card (quote post/repost with quote) */
+export interface PostQuoteEmbed {
+    type: 'quote';
+    /** AT-URI of the post */
+    uri: string;
+    /**
+     * CID of the post, if not supplied, requires you to also supply an RPC
+     * instance for it to be able to make query calls.
+     */
+    cid?: string;
+}
+/** An embed that displays a starter pack card */
+export interface PostStarterpackEmbed {
+    type: 'starterpack';
+    /** AT-URI of the post */
+    uri: string;
+    /**
+     * CID of the starter pack, if not supplied, requires you to also supply an
+     * RPC instance for it to be able to make query calls.
+     */
+    cid?: string;
+}
+/** Union type of "record" embeds */
+export type PostRecordEmbed = PostFeedEmbed | PostListEmbed | PostQuoteEmbed | PostStarterpackEmbed;
+/** An embed that displays a media and a "record" embed */
+export interface PostRecordWithMediaEmbed {
+    type: 'recordWithMedia';
+    /** The "record" embed */
+    record: PostRecordEmbed;
+    /** The media embed */
+    media: PostMediaEmbed;
+}
+/** Union type of embeds that can be assigned to a post */
+export type PostEmbed = PostMediaEmbed | PostRecordEmbed | PostRecordWithMediaEmbed;
+/** The post being composed */
+export interface ComposedPost {
+    /** The language that this post is in */
+    languages?: string[];
+    /** The content of the post */
+    content: {
+        /** Post text */
+        text: string;
+        /** Decorations applied to the text */
+        facets?: AppBskyRichtextFacet.Main[];
+    };
+    /** Embed assigned to this post */
+    embed?: PostEmbed;
+}
+/** Reply gating options, leave this empty to deny everyone from replying */
+export interface ComposedThreadgate {
+    /** Allow replies from users you follow */
+    follows?: boolean;
+    /** Allow replies from users mentioned in the post */
+    mentions?: boolean;
+    /** Allow replies from users that are in these user lists */
+    listUris?: At.Uri[];
+}
+/** Base interface for the thread being composed */
+export interface ComposedThread {
+    /** An RPC instance, necessary for some options that takes action on your behalf */
+    rpc?: XRPC;
+    /** Abort signal */
+    signal?: AbortSignal;
+    /** Author of the thread */
+    author: At.DID;
+    /**
+     * The "creation time" for this thread,
+     * if not supplied, the current time is used
+     */
+    createdAt?: string | number | Date;
+    /**
+     * The post it should reply to, accepts either an AT-URI of the post, a view
+     * of the post, or an embed view of the post. Supplying an AT-URI requires you
+     * to also supply an PRC instance for it to be able to make query calls.
+     */
+    reply?: string | AppBskyFeedDefs.PostView | AppBskyEmbedRecord.ViewRecord;
+    /**
+     * Thread gating to apply on this thread, this option can't be set if this is
+     * a reply, especially to another user's thread. Leave this undefined to allow
+     * everyone to reply to the thread, supply an empty object to deny everyone.
+     */
+    gate?: ComposedThreadgate;
+    /** The language that all the posts are in, can be overridden per-post */
+    languages?: string[];
+    /** An array of posts */
+    posts: ComposedPost[];
+}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "type": "module",
+  "name": "@atcute/bluesky-threading",
+  "version": "1.0.0",
+  "description": "create Bluesky threads containing multiple posts with one write",
+  "license": "MIT",
+  "repository": {
+    "url": "https://codeberg.org/mary-ext/atcute"
+  },
+  "files": [
+    "dist/"
+  ],
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "sideEffects": false,
+  "peerDependencies": {
+    "@atcute/bluesky": "^1.0.0",
+    "@atcute/client": "^1.0.0"
+  },
+  "dependencies": {
+    "@atcute/cbor": "^1.0.0",
+    "@atcute/tid": "^1.0.0",
+    "@atcute/cid": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.1.6",
+    "@atcute/bluesky-richtext-builder": "^1.0.0",
+    "@atcute/bluesky": "^1.0.0",
+    "@atcute/client": "^1.0.0"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "test": "bun test --coverage",
+    "prepublish": "rm -rf dist; pnpm run build"
+  }
+}