@atcute/bluesky-moderation 2.0.4 → 3.0.1

package/README.md

@@ -1,167 +1,165 @@
 # @atcute/bluesky-moderation
 
-interprets Bluesky's content moderation labels.
+interpret Bluesky content moderation labels and user preferences.
 
-```ts
-import type { XRPC } from '@atcute/client';
-import type { AppBskyActorDefs, AppBskyFeedDefs, AppBskyLabelerDefs, At } from '@atcute/client/lexicons';
+```sh
+npm install @atcute/bluesky-moderation
+```
+
+evaluates posts, profiles, lists, and other content against moderation labels, mutes, blocks, and
+keyword filters to determine how they should be displayed.
+
+## usage
 
+### basic flow
+
+1. fetch user preferences and labeler definitions
+2. run moderation functions on content
+3. get display restrictions for your UI context
+
+```ts
 import {
 	DisplayContext,
 	getDisplayRestrictions,
 	interpretLabelerDefinitions,
-	interpretMutedWordPreferences,
-	LabelPreference,
 	moderatePost,
 	type ModerationPreferences,
 } from '@atcute/bluesky-moderation';
 
-declare const rpc: XRPC;
-
-// first, let's get the user's preferences
-const labelerDids = new Set<At.Did>([
-	// Bluesky moderation service
-	'did:plc:ar7c4by46qjdydhdevvrndac',
-]);
-
-const modPrefs: ModerationPreferences = {
-	adultContentEnabled: false,
-	globalLabelPrefs: {},
-	prefsByLabelers: {
-		'did:plc:ar7c4by46qjdydhdevvrndac': {
-			labelPrefs: {},
-		},
-	},
-	keywordFilters: [],
-	hiddenPosts: [],
-	temporaryMutes: [],
-};
+// 1. set up preferences (see "loading preferences" below)
+const prefs: ModerationPreferences = { ... };
+const labelDefs = interpretLabelerDefinitions(labelers);
 
-{
-	const { data } = await rpc.get('app.bsky.actor.getPreferences', {});
+// 2. moderate content
+const decision = moderatePost(post, {
+	viewerDid: 'did:plc:...',
+	prefs,
+	labelDefs,
+});
 
-	const labelPrefs: AppBskyActorDefs.ContentLabelPref[] = [];
+// 3. get display restrictions for your context
+const ui = getDisplayRestrictions(decision, DisplayContext.ContentList);
 
-	const globalLabelPrefs = (modPrefs.globalLabelPrefs ??= {});
-	const prefsByLabelers = (modPrefs.prefsByLabelers ??= {});
+if (ui.filters.length > 0) {
+	// don't show this post in feeds
+}
 
-	for (const pref of data.preferences) {
-		switch (pref.$type) {
-			case 'app.bsky.actor.defs#adultContentPref': {
-				modPrefs.adultContentEnabled = pref.enabled;
-				break;
-			}
-			case 'app.bsky.actor.defs#labelersPref': {
-				for (const labeler of pref.labelers) {
-					prefsByLabelers[labeler.did] ??= { labelPrefs: {} };
-					labelerDids.add(labeler.did);
-				}
+if (ui.blurs.length > 0) {
+	// hide behind a content warning
 
-				break;
-			}
-			case 'app.bsky.actor.defs#contentLabelPref': {
-				labelPrefs.push(pref);
-				break;
-			}
-			case 'app.bsky.actor.defs#mutedWordsPref': {
-				modPrefs.keywordFilters = interpretMutedWordPreferences(pref);
-				break;
-			}
-			case 'app.bsky.actor.defs#hiddenPostsPref': {
-				modPrefs.hiddenPosts = pref.items as At.CanonicalResourceUri[];
-				break;
-			}
-		}
+	if (ui.noOverride) {
+		// don't allow user to reveal
 	}
+}
 
-	for (const { labelerDid, label, visibility } of labelPrefs) {
-		let pref: LabelPreference | undefined;
-		switch (visibility) {
-			case 'show':
-			case 'ignore': {
-				pref = LabelPreference.Ignore;
-				break;
-			}
-			case 'warn': {
-				pref = LabelPreference.Warn;
-				break;
-			}
-			case 'hide': {
-				pref = LabelPreference.Hide;
-				break;
-			}
-		}
+if (ui.alerts.length > 0 || ui.informs.length > 0) {
+	// show warning badges
+}
+```
 
-		if (labelerDid === undefined) {
-			globalLabelPrefs[label] = pref;
-		} else if (labelerDid in prefsByLabelers) {
-			const labelerPref = prefsByLabelers[labelerDid]!;
+### display contexts
 
-			labelerPref.labelPrefs[label] = pref;
-		}
-	}
-}
+use different contexts depending on where content appears:
 
-// grab labeler's definitions
-let labelers: AppBskyLabelerDefs.LabelerViewDetailed[] = [];
+```ts
+// content in feeds/lists
+getDisplayRestrictions(decision, DisplayContext.ContentList);
 
-{
-	const { data } = await rpc.get('app.bsky.labeler.getServices', {
-		params: {
-			dids: [...labelerDids],
-			detailed: true,
-		},
-	});
+// content in expanded view
+getDisplayRestrictions(decision, DisplayContext.ContentView);
 
-	labelers = data.views.filter((view) => view.$type === 'app.bsky.labeler.defs#labelerViewDetailed');
-}
+// images/videos in content
+getDisplayRestrictions(decision, DisplayContext.ContentMedia);
 
-// interpret the labeler's definitions into something the library can understand
-const labelDefs = interpretLabelerDefinitions(labelers);
+// profile in lists
+getDisplayRestrictions(decision, DisplayContext.ProfileList);
 
-// then we call the appropriate moderation functions
-{
-	declare const post: AppBskyFeedDefs.PostView;
+// profile in expanded view
+getDisplayRestrictions(decision, DisplayContext.ProfileView);
 
-	const mod = moderatePost(post, {
-		viewerDid: 'did:plc:xyz',
-		labelDefs,
-		prefs: modPrefs,
-	});
+// profile avatar/banner
+getDisplayRestrictions(decision, DisplayContext.ProfileMedia);
+```
 
-	// when displaying the post in feeds...
-	{
-		const ui = getDisplayRestrictions(mod, DisplayContext.ContentList);
+### loading preferences
 
-		if (ui.filters.length > 0) {
-			// don't include the post in the feed
-		}
+```ts
+import {
+	interpretLabelerDefinitions,
+	interpretMutedWordPreferences,
+	LabelPreference,
+	type ModerationPreferences,
+} from '@atcute/bluesky-moderation';
 
-		if (ui.blurs.length > 0) {
-			// hide the post behind a cover
+// fetch user preferences
+const { data } = await rpc.get('app.bsky.actor.getPreferences', {});
+
+const prefs: ModerationPreferences = {
+	adultContentEnabled: false,
+	globalLabelPrefs: {},
+	prefsByLabelers: {},
+	keywordFilters: [],
+	hiddenPosts: [],
+	temporaryMutes: [],
+};
 
-			if (ui.noOverride) {
-				// don't allow the cover to be removed
+for (const pref of data.preferences) {
+	switch (pref.$type) {
+		case 'app.bsky.actor.defs#adultContentPref':
+			prefs.adultContentEnabled = pref.enabled;
+			break;
+
+		case 'app.bsky.actor.defs#contentLabelPref':
+			// map visibility to LabelPreference
+			const labelPref =
+				pref.visibility === 'hide'
+					? LabelPreference.Hide
+					: pref.visibility === 'warn'
+						? LabelPreference.Warn
+						: LabelPreference.Ignore;
+
+			if (pref.labelerDid) {
+				prefs.prefsByLabelers[pref.labelerDid] ??= { labelPrefs: {} };
+				prefs.prefsByLabelers[pref.labelerDid].labelPrefs[pref.label] = labelPref;
+			} else {
+				prefs.globalLabelPrefs[pref.label] = labelPref;
 			}
-		}
+			break;
 
-		if (ui.alerts.length > 0 || ui.informs.length > 0) {
-			// show warning/inform badges in the post
-		}
+		case 'app.bsky.actor.defs#mutedWordsPref':
+			prefs.keywordFilters = interpretMutedWordPreferences(pref);
+			break;
+
+		case 'app.bsky.actor.defs#hiddenPostsPref':
+			prefs.hiddenPosts = pref.items;
+			break;
 	}
+}
 
-	// when displaying an expanded version of the post...
-	{
-		const ui = getDisplayRestrictions(mod, DisplayContext.ContentView);
+// fetch labeler definitions
+const { data: labelerData } = await rpc.get('app.bsky.labeler.getServices', {
+	params: { dids: [...labelerDids], detailed: true },
+});
 
-		// ...
-	}
+const labelDefs = interpretLabelerDefinitions(
+	labelerData.views.filter((v) => v.$type === 'app.bsky.labeler.defs#labelerViewDetailed'),
+);
+```
 
-	// when displaying images/videos of a post...
-	{
-		const ui = getDisplayRestrictions(mod, DisplayContext.ProfileMedia);
+### moderating different content types
 
-		// ...
-	}
-}
+```ts
+import {
+	moderateFeedGenerator,
+	moderateList,
+	moderateNotification,
+	moderatePost,
+	moderateProfile,
+} from '@atcute/bluesky-moderation';
+
+const postDecision = moderatePost(post, opts);
+const profileDecision = moderateProfile(profile, opts);
+const listDecision = moderateList(list, opts);
+const feedDecision = moderateFeedGenerator(feed, opts);
+const notifDecision = moderateNotification(notification, opts);
 ```

package/dist/_test-util/mock.d.ts

@@ -0,0 +1,58 @@
+import type { ComAtprotoLabelDefs } from '@atcute/atproto';
+import type { AppBskyActorDefs, AppBskyEmbedRecord, AppBskyFeedDefs, AppBskyFeedPost, AppBskyGraphDefs, AppBskyNotificationListNotifications } from '@atcute/bluesky';
+import type { $type, Did, GenericUri, Handle, ResourceUri } from '@atcute/lexicons';
+export declare const post: ({ text, facets, reply, embed, }: {
+    text: string;
+    facets?: AppBskyFeedPost.Main['facets'];
+    reply?: AppBskyFeedPost.ReplyRef;
+    embed?: AppBskyFeedPost.Main['embed'];
+}) => AppBskyFeedPost.Main;
+export declare const postView: ({ record, author, embed, replyCount, repostCount, likeCount, viewer, labels, }: {
+    record: AppBskyFeedPost.Main;
+    author: AppBskyActorDefs.ProfileViewBasic;
+    embed?: AppBskyFeedDefs.PostView['embed'];
+    replyCount?: number;
+    repostCount?: number;
+    likeCount?: number;
+    viewer?: AppBskyFeedDefs.ViewerState;
+    labels?: ComAtprotoLabelDefs.Label[];
+}) => $type.enforce<AppBskyFeedDefs.PostView>;
+export declare const embedRecordView: ({ record, author, labels, }: {
+    record: AppBskyFeedPost.Main;
+    author: AppBskyActorDefs.ProfileViewBasic;
+    labels?: ComAtprotoLabelDefs.Label[];
+}) => $type.enforce<AppBskyEmbedRecord.View>;
+export declare const profileView: ({ handle, displayName, viewer, labels, }: {
+    handle: Handle;
+    displayName?: string;
+    viewer?: AppBskyActorDefs.ViewerState;
+    labels?: ComAtprotoLabelDefs.Label[];
+}) => $type.omit<AppBskyActorDefs.ProfileView | AppBskyActorDefs.ProfileViewBasic>;
+export declare const actorViewerState: ({ muted, mutedByList, blockedBy, blocking, blockingByList, following, followedBy, }: {
+    muted?: boolean;
+    mutedByList?: AppBskyGraphDefs.ListViewBasic;
+    blockedBy?: boolean;
+    blocking?: ResourceUri;
+    blockingByList?: AppBskyGraphDefs.ListViewBasic;
+    following?: ResourceUri;
+    followedBy?: ResourceUri;
+}) => AppBskyActorDefs.ViewerState;
+export declare const listViewBasic: ({ name }: {
+    name: string;
+}) => AppBskyGraphDefs.ListViewBasic;
+export declare const replyNotification: ({ author, record, labels, }: {
+    record: AppBskyFeedPost.Main;
+    author: AppBskyActorDefs.ProfileView;
+    labels?: ComAtprotoLabelDefs.Label[];
+}) => AppBskyNotificationListNotifications.Notification;
+export declare const followNotification: ({ author, subjectDid, labels, }: {
+    author: AppBskyActorDefs.ProfileView;
+    subjectDid: string;
+    labels?: ComAtprotoLabelDefs.Label[];
+}) => AppBskyNotificationListNotifications.Notification;
+export declare const label: ({ val, uri, src, }: {
+    val: string;
+    uri: GenericUri;
+    src?: Did;
+}) => ComAtprotoLabelDefs.Label;
+//# sourceMappingURL=mock.d.ts.map

package/dist/_test-util/mock.d.ts.map

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

package/dist/_test-util/mock.js

@@ -0,0 +1,109 @@
+const FAKE_CID = 'bafyreiclp443lavogvhj3d2ob2cxbfuscni2k5jk7bebjzg7khl3esabwq';
+export const post = ({ text, facets, reply, embed, }) => {
+    return {
+        $type: 'app.bsky.feed.post',
+        text,
+        facets,
+        reply,
+        embed,
+        langs: ['en'],
+        createdAt: new Date().toISOString(),
+    };
+};
+export const postView = ({ record, author, embed, replyCount, repostCount, likeCount, viewer, labels, }) => {
+    return {
+        $type: 'app.bsky.feed.defs#postView',
+        uri: `at://${author.did}/app.bsky.feed.post/fake`,
+        cid: FAKE_CID,
+        author,
+        record,
+        embed,
+        replyCount,
+        repostCount,
+        likeCount,
+        indexedAt: new Date().toISOString(),
+        viewer,
+        labels,
+    };
+};
+export const embedRecordView = ({ record, author, labels, }) => {
+    return {
+        $type: 'app.bsky.embed.record#view',
+        record: {
+            $type: 'app.bsky.embed.record#viewRecord',
+            uri: `at://${author.did}/app.bsky.feed.post/fake`,
+            cid: FAKE_CID,
+            author,
+            value: record,
+            labels,
+            indexedAt: new Date().toISOString(),
+        },
+    };
+};
+export const profileView = ({ handle, displayName, viewer, labels, }) => {
+    return {
+        did: `did:web:${handle}`,
+        handle,
+        displayName,
+        viewer,
+        labels,
+    };
+};
+export const actorViewerState = ({ muted, mutedByList, blockedBy, blocking, blockingByList, following, followedBy, }) => {
+    return {
+        muted,
+        mutedByList,
+        blockedBy,
+        blocking,
+        blockingByList,
+        following,
+        followedBy,
+    };
+};
+export const listViewBasic = ({ name }) => {
+    return {
+        uri: 'at://did:plc:fake/app.bsky.graph.list/fake',
+        cid: FAKE_CID,
+        name,
+        purpose: 'app.bsky.graph.defs#modlist',
+        indexedAt: new Date().toISOString(),
+    };
+};
+export const replyNotification = ({ author, record, labels, }) => {
+    return {
+        uri: `at://${author.did}/app.bsky.feed.post/fake`,
+        cid: FAKE_CID,
+        author,
+        reason: 'reply',
+        reasonSubject: `at://${author.did}/app.bsky.feed.post/fake-parent`,
+        record,
+        isRead: false,
+        indexedAt: new Date().toISOString(),
+        labels,
+    };
+};
+export const followNotification = ({ author, subjectDid, labels, }) => {
+    return {
+        uri: `at://${author.did}/app.bsky.graph.follow/fake`,
+        cid: FAKE_CID,
+        author,
+        reason: 'follow',
+        record: {
+            $type: 'app.bsky.graph.follow',
+            createdAt: new Date().toISOString(),
+            subject: subjectDid,
+        },
+        isRead: false,
+        indexedAt: new Date().toISOString(),
+        labels,
+    };
+};
+export const label = ({ val, uri, src, }) => {
+    return {
+        src: src || 'did:plc:fake-labeler',
+        uri,
+        val,
+        cts: new Date().toISOString(),
+    };
+};
+//# sourceMappingURL=mock.js.map

package/dist/_test-util/mock.js.map

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

package/dist/_test-util/moderation-behavior.d.ts

@@ -0,0 +1,57 @@
+import { LabelPreference, type ModerationOptions } from '../index.ts';
+export type ModerationTestSuiteResultFlag = 'filter' | 'blur' | 'alert' | 'inform' | 'noOverride';
+export interface ModerationTestSuiteScenario {
+    cfg: string;
+    subject: 'post' | 'profile' | 'userlist' | 'feedgen';
+    author: string;
+    quoteAuthor?: string;
+    labels: {
+        post?: string[];
+        profile?: string[];
+        account?: string[];
+        quotedPost?: string[];
+        quotedAccount?: string[];
+    };
+    behaviors: {
+        profileList?: ModerationTestSuiteResultFlag[];
+        profileView?: ModerationTestSuiteResultFlag[];
+        profileMedia?: ModerationTestSuiteResultFlag[];
+        contentList?: ModerationTestSuiteResultFlag[];
+        contentView?: ModerationTestSuiteResultFlag[];
+        contentMedia?: ModerationTestSuiteResultFlag[];
+    };
+}
+export type SuiteUsers = Record<string, {
+    blocking: boolean;
+    blockingByList: boolean;
+    blockedBy: boolean;
+    muted: boolean;
+    mutedByList: boolean;
+}>;
+export type SuiteConfigurations = Record<string, {
+    authed?: boolean;
+    adultContentEnabled?: boolean;
+    settings?: Record<string, LabelPreference>;
+}>;
+export type SuiteScenarios = Record<string, ModerationTestSuiteScenario>;
+declare module 'vitest' {
+    interface Assertion<T = any> {
+        toBeModerationResult(expected?: ModerationTestSuiteResultFlag[], context?: string, stringifiedResult?: string, ignoreCause?: boolean): void;
+    }
+    interface AsymmetricMatchers {
+        toBeModerationResult(expected?: ModerationTestSuiteResultFlag[], context?: string, stringifiedResult?: string, ignoreCause?: boolean): any;
+    }
+}
+export declare class ModerationBehaviorSuiteRunner {
+    users: SuiteUsers;
+    configurations: SuiteConfigurations;
+    scenarios: SuiteScenarios;
+    constructor(users: SuiteUsers, configurations: SuiteConfigurations, scenarios: SuiteScenarios);
+    postScenario(scenario: ModerationTestSuiteScenario): import("@atcute/bluesky/types/app/feed/defs").PostView & {
+        $type: "app.bsky.feed.defs#postView";
+    };
+    profileScenario(scenario: ModerationTestSuiteScenario): import("@atcute/lexicons").$type.omit<import("@atcute/bluesky/types/app/actor/defs").ProfileView | import("@atcute/bluesky/types/app/actor/defs").ProfileViewBasic>;
+    profileView(name: string, scenarioLabels: ModerationTestSuiteScenario['labels']): import("@atcute/lexicons").$type.omit<import("@atcute/bluesky/types/app/actor/defs").ProfileView | import("@atcute/bluesky/types/app/actor/defs").ProfileViewBasic>;
+    moderationOptions(scenario: ModerationTestSuiteScenario): ModerationOptions;
+}
+//# sourceMappingURL=moderation-behavior.d.ts.map

package/dist/_test-util/moderation-behavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moderation-behavior.d.ts","sourceRoot":"","sources":["../../lib/_test-util/moderation-behavior.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAA4B,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIhG,MAAM,MAAM,6BAA6B,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,CAAC;AAElG,MAAM,WAAW,2BAA2B;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,SAAS,EAAE;QACV,WAAW,CAAC,EAAE,6BAA6B,EAAE,CAAC;QAC9C,WAAW,CAAC,EAAE,6BAA6B,EAAE,CAAC;QAC9C,YAAY,CAAC,EAAE,6BAA6B,EAAE,CAAC;QAC/C,WAAW,CAAC,EAAE,6BAA6B,EAAE,CAAC;QAC9C,WAAW,CAAC,EAAE,6BAA6B,EAAE,CAAC;QAC9C,YAAY,CAAC,EAAE,6BAA6B,EAAE,CAAC;KAC/C,CAAC;CACF;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAC9B,MAAM,EACN;IACC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;CACrB,CACD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,MAAM,CACvC,MAAM,EACN;IACC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC3C,CACD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;AAoFzE,OAAO,QAAQ,QAAQ,CAAC,CAAC;IAExB,UAAU,SAAS,CAAC,CAAC,GAAG,GAAG;QAC1B,oBAAoB,CACnB,QAAQ,CAAC,EAAE,6BAA6B,EAAE,EAC1C,OAAO,CAAC,EAAE,MAAM,EAChB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,WAAW,CAAC,EAAE,OAAO,GACnB,IAAI,CAAC;KACR;IAED,UAAU,kBAAkB;QAC3B,oBAAoB,CACnB,QAAQ,CAAC,EAAE,6BAA6B,EAAE,EAC1C,OAAO,CAAC,EAAE,MAAM,EAChB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,WAAW,CAAC,EAAE,OAAO,GACnB,GAAG,CAAC;KACP;CACD;AAED,qBAAa,6BAA6B;IACzC,KAAK,EAAE,UAAU,CAAC;IAClB,cAAc,EAAE,mBAAmB,CAAC;IACpC,SAAS,EAAE,cAAc,CAAC;IAE1B,YAAY,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,mBAAmB,EAAE,SAAS,EAAE,cAAc,EAI5F;IAED,YAAY,CAAC,QAAQ,EAAE,2BAA2B;;MA8BjD;IAED,eAAe,CAAC,QAAQ,EAAE,2BAA2B,uKAKpD;IAED,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,2BAA2B,CAAC,QAAQ,CAAC,uKAgC9E;IAED,iBAAiB,CAAC,QAAQ,EAAE,2BAA2B,GAAG,iBAAiB,CAgB1E;CACD"}