@atcute/bluesky-moderation 1.0.1

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,174 @@
+# @atcute/bluesky-moderation
+
+interprets Bluesky's content moderation labels.
+
+```ts
+import type { XRPC } from '@atcute/client';
+import type {
+	AppBskyActorDefs,
+	AppBskyFeedDefs,
+	AppBskyLabelerDefs,
+	At,
+} from '@atcute/client/lexicons';
+
+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: [],
+};
+
+{
+	const { data } = await rpc.get('app.bsky.actor.getPreferences', {});
+
+	const labelPrefs: AppBskyActorDefs.ContentLabelPref[] = [];
+
+	const globalLabelPrefs = (modPrefs.globalLabelPrefs ??= {});
+	const prefsByLabelers = (modPrefs.prefsByLabelers ??= {});
+
+	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);
+				}
+
+				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;
+			}
+		}
+	}
+
+	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 (labelerDid === undefined) {
+			globalLabelPrefs[label] = pref;
+		} else if (labelerDid in prefsByLabelers) {
+			const labelerPref = prefsByLabelers[labelerDid]!;
+
+			labelerPref.labelPrefs[label] = pref;
+		}
+	}
+}
+
+// grab labeler's definitions
+let labelers: AppBskyLabelerDefs.LabelerViewDetailed[] = [];
+
+{
+	const { data } = await rpc.get('app.bsky.labeler.getServices', {
+		params: {
+			dids: [...labelerDids],
+			detailed: true,
+		},
+	});
+
+	labelers = data.views.filter(
+		(view) => view.$type === 'app.bsky.labeler.defs#labelerViewDetailed',
+	);
+}
+
+// interpret the labeler's definitions into something the library can understand
+const labelDefs = interpretLabelerDefinitions(labelers);
+
+// then we call the appropriate moderation functions
+{
+	declare const post: AppBskyFeedDefs.PostView;
+
+	const mod = moderatePost(post, {
+		viewerDid: 'did:plc:xyz',
+		labelDefs,
+		prefs: modPrefs,
+	});
+
+	// when displaying the post in feeds...
+	{
+		const ui = getDisplayRestrictions(mod, DisplayContext.ContentList);
+
+		if (ui.filters.length > 0) {
+			// don't include the post in the feed
+		}
+
+		if (ui.blurs.length > 0) {
+			// hide the post behind a cover
+
+			if (ui.noOverride) {
+				// don't allow the cover to be removed
+			}
+		}
+
+		if (ui.alerts.length > 0 || ui.informs.length > 0) {
+			// show warning/inform badges in the post
+		}
+	}
+
+	// when displaying an expanded version of the post...
+	{
+		const ui = getDisplayRestrictions(mod, DisplayContext.ContentView);
+
+		// ...
+	}
+
+	// when displaying images/videos of a post...
+	{
+		const ui = getDisplayRestrictions(mod, DisplayContext.ProfileMedia);
+
+		// ...
+	}
+}
+```

package/dist/behaviors.d.ts

@@ -0,0 +1,41 @@
+export declare const enum LabelTarget {
+    /** label is intended for account's content */
+    Content = "content",
+    /** label is intended for account's profile */
+    Profile = "profile",
+    /** label is intended for account's content and profile */
+    Account = "account"
+}
+export declare const enum DisplayContext {
+    /** content in expanded view */
+    ContentView = "contentView",
+    /** images or video contained in content */
+    ContentMedia = "contentMedia",
+    /** content in a list/feed */
+    ContentList = "contentList",
+    /** profile in expanded view */
+    ProfileView = "profileView",
+    /** profile's avatar or banner */
+    ProfileMedia = "profileMedia",
+    /** profile in a list */
+    ProfileList = "profileList"
+}
+export declare const enum ModerationAction {
+    /** should cause blurring */
+    Blur = "blur",
+    /** should cause an alert */
+    Alert = "alert",
+    /** should cause a notice */
+    Inform = "inform"
+}
+export type BehaviorMapping = {
+    [C in DisplayContext]?: ModerationAction;
+};
+export type LabelBehaviorMatrix = {
+    [T in LabelTarget]: BehaviorMapping;
+};
+export declare const BLOCK_BEHAVIOR: BehaviorMapping;
+export declare const MUTE_BEHAVIOR: BehaviorMapping;
+export declare const KEYWORD_MUTE_BEHAVIOR: BehaviorMapping;
+export declare const HIDE_BEHAVIOR: BehaviorMapping;
+export declare const NOOP_BEHAVIOR: BehaviorMapping;

package/dist/behaviors.js

@@ -0,0 +1,56 @@
+export var LabelTarget;
+(function (LabelTarget) {
+    /** label is intended for account's content */
+    LabelTarget["Content"] = "content";
+    /** label is intended for account's profile */
+    LabelTarget["Profile"] = "profile";
+    /** label is intended for account's content and profile */
+    LabelTarget["Account"] = "account";
+})(LabelTarget || (LabelTarget = {}));
+export var DisplayContext;
+(function (DisplayContext) {
+    /** content in expanded view */
+    DisplayContext["ContentView"] = "contentView";
+    /** images or video contained in content */
+    DisplayContext["ContentMedia"] = "contentMedia";
+    /** content in a list/feed */
+    DisplayContext["ContentList"] = "contentList";
+    /** profile in expanded view */
+    DisplayContext["ProfileView"] = "profileView";
+    /** profile's avatar or banner */
+    DisplayContext["ProfileMedia"] = "profileMedia";
+    /** profile in a list */
+    DisplayContext["ProfileList"] = "profileList";
+})(DisplayContext || (DisplayContext = {}));
+export var ModerationAction;
+(function (ModerationAction) {
+    /** should cause blurring */
+    ModerationAction["Blur"] = "blur";
+    /** should cause an alert */
+    ModerationAction["Alert"] = "alert";
+    /** should cause a notice */
+    ModerationAction["Inform"] = "inform";
+})(ModerationAction || (ModerationAction = {}));
+export const BLOCK_BEHAVIOR = {
+    [DisplayContext.ProfileList]: ModerationAction.Blur,
+    [DisplayContext.ProfileView]: ModerationAction.Alert,
+    [DisplayContext.ProfileMedia]: ModerationAction.Blur,
+    [DisplayContext.ContentList]: ModerationAction.Blur,
+    [DisplayContext.ContentView]: ModerationAction.Blur,
+};
+export const MUTE_BEHAVIOR = {
+    [DisplayContext.ProfileList]: ModerationAction.Inform,
+    [DisplayContext.ProfileView]: ModerationAction.Alert,
+    [DisplayContext.ContentList]: ModerationAction.Blur,
+    [DisplayContext.ContentView]: ModerationAction.Inform,
+};
+export const KEYWORD_MUTE_BEHAVIOR = {
+    [DisplayContext.ContentList]: ModerationAction.Blur,
+    [DisplayContext.ContentView]: ModerationAction.Blur,
+};
+export const HIDE_BEHAVIOR = {
+    [DisplayContext.ContentList]: ModerationAction.Blur,
+    [DisplayContext.ContentView]: ModerationAction.Blur,
+};
+export const NOOP_BEHAVIOR = {};
+//# sourceMappingURL=behaviors.js.map

package/dist/behaviors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"behaviors.js","sourceRoot":"","sources":["../lib/behaviors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAkB,WAOjB;AAPD,WAAkB,WAAW;IAC5B,8CAA8C;IAC9C,kCAAmB,CAAA;IACnB,8CAA8C;IAC9C,kCAAmB,CAAA;IACnB,0DAA0D;IAC1D,kCAAmB,CAAA;AACpB,CAAC,EAPiB,WAAW,KAAX,WAAW,QAO5B;AAED,MAAM,CAAN,IAAkB,cAcjB;AAdD,WAAkB,cAAc;IAC/B,+BAA+B;IAC/B,6CAA2B,CAAA;IAC3B,2CAA2C;IAC3C,+CAA6B,CAAA;IAC7B,6BAA6B;IAC7B,6CAA2B,CAAA;IAE3B,+BAA+B;IAC/B,6CAA2B,CAAA;IAC3B,iCAAiC;IACjC,+CAA6B,CAAA;IAC7B,wBAAwB;IACxB,6CAA2B,CAAA;AAC5B,CAAC,EAdiB,cAAc,KAAd,cAAc,QAc/B;AAED,MAAM,CAAN,IAAkB,gBAOjB;AAPD,WAAkB,gBAAgB;IACjC,4BAA4B;IAC5B,iCAAa,CAAA;IACb,4BAA4B;IAC5B,mCAAe,CAAA;IACf,4BAA4B;IAC5B,qCAAiB,CAAA;AAClB,CAAC,EAPiB,gBAAgB,KAAhB,gBAAgB,QAOjC;AAKD,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC9C,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,IAAI;IACnD,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,KAAK;IACpD,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC,IAAI;IAEpD,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,IAAI;IACnD,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,IAAI;CACnD,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAoB;IAC7C,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,MAAM;IACrD,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,KAAK;IAEpD,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,IAAI;IACnD,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,MAAM;CACrD,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAoB;IACrD,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,IAAI;IACnD,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,IAAI;CACnD,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAoB;IAC7C,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,IAAI;IACnD,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,IAAI;CACnD,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAoB,EAAE,CAAC"}

package/dist/decision.d.ts

@@ -0,0 +1,85 @@
+import type { AppBskyGraphDefs, At } from '@atcute/client/lexicons';
+import { type BehaviorMapping, type LabelTarget } from './behaviors.js';
+import type { Label, ModerationOptions } from './types.js';
+import type { KeywordFilter } from './keyword-filter.js';
+import { LabelPreference, type InterpretedLabelDefinition } from './label.js';
+export declare const enum ModerationCauseType {
+    /** caused by a label */
+    Label = 1,
+    /** caused by viewer blocking the subject */
+    Blocking = 2,
+    /** caused by subject blocking the viewer */
+    BlockedBy = 3,
+    /** caused by viewer having a (permanent) mute on subject */
+    MutedPermanent = 4,
+    /** caused by a temporary mute */
+    MutedTemporary = 5,
+    /** caused by a keyword mute */
+    MutedKeyword = 6,
+    /** caused by a hidden post */
+    Hidden = 7
+}
+export interface BlockingModerationCause {
+    type: ModerationCauseType.Blocking;
+    priority: 3;
+    source: AppBskyGraphDefs.ListViewBasic | null;
+    downgraded: boolean;
+}
+export interface BlockedByModerationCause {
+    type: ModerationCauseType.BlockedBy;
+    priority: 4;
+    downgraded: boolean;
+}
+export interface HiddenModerationCause {
+    type: ModerationCauseType.Hidden;
+    priority: 6;
+    downgraded: boolean;
+}
+export interface LabelModerationCause {
+    type: ModerationCauseType.Label;
+    priority: 1 | 2 | 5 | 7 | 8;
+    source: At.Did | null;
+    label: Label;
+    labelDef: InterpretedLabelDefinition;
+    target: LabelTarget;
+    pref: LabelPreference;
+    behavior: BehaviorMapping;
+    noOverride: boolean;
+    downgraded: boolean;
+}
+export interface MutedPermanentModerationCause {
+    type: ModerationCauseType.MutedPermanent;
+    priority: 6;
+    source: AppBskyGraphDefs.ListViewBasic | null;
+    downgraded: boolean;
+}
+export interface MutedTemporaryModerationCause {
+    type: ModerationCauseType.MutedTemporary;
+    priority: 6;
+    downgraded: boolean;
+}
+export interface MutedKeywordModerationCause {
+    type: ModerationCauseType.MutedKeyword;
+    priority: 6;
+    source: KeywordFilter;
+    downgraded: boolean;
+}
+export type ModerationCause = BlockedByModerationCause | BlockingModerationCause | HiddenModerationCause | LabelModerationCause | MutedKeywordModerationCause | MutedPermanentModerationCause | MutedTemporaryModerationCause;
+export interface ModerationDecision {
+    authorDid: At.Did;
+    isMe: boolean;
+    causes: ModerationCause[];
+}
+export declare const createModerationDecision: (authorDid: At.Did, { viewerDid }: ModerationOptions) => ModerationDecision;
+type FalsyValue = 0 | '' | false | null | undefined;
+export declare const mergeModerationDecisions: (sources_0: ModerationDecision, sources_1: ModerationDecision | FalsyValue, ...sources: (ModerationDecision | FalsyValue)[]) => ModerationDecision;
+export declare const considerHidden: (decision: ModerationDecision) => void;
+export declare const considerBlocking: (decision: ModerationDecision, source: AppBskyGraphDefs.ListViewBasic | null) => void;
+export declare const considerBlockedBy: (decision: ModerationDecision) => void;
+export declare const considerPermanentMute: (decision: ModerationDecision, source: AppBskyGraphDefs.ListViewBasic | null) => void;
+export declare const considerTemporaryMute: (decision: ModerationDecision, { prefs }: ModerationOptions) => void;
+export declare const considerKeywordMute: (decision: ModerationDecision, source: KeywordFilter) => void;
+export declare const considerLabels: (decision: ModerationDecision, target: LabelTarget, labels: Label[] | undefined, opts: ModerationOptions) => void;
+export declare const considerLabel: (decision: ModerationDecision, target: LabelTarget, label: Label, { viewerDid, prefs, labelDefs }: ModerationOptions) => void;
+export declare const downgradeDecision: <T extends ModerationDecision | undefined>(decision: T) => T;
+export {};

package/dist/decision.js

@@ -0,0 +1,214 @@
+import { DisplayContext, ModerationAction } from './behaviors.js';
+import { BUILTIN_LABELS, isCustomLabelValue, LabelFlags, LabelPreference, } from './label.js';
+var ModerationSeverity;
+(function (ModerationSeverity) {
+    ModerationSeverity[ModerationSeverity["High"] = 1] = "High";
+    ModerationSeverity[ModerationSeverity["Medium"] = 2] = "Medium";
+    ModerationSeverity[ModerationSeverity["Low"] = 3] = "Low";
+})(ModerationSeverity || (ModerationSeverity = {}));
+export var ModerationCauseType;
+(function (ModerationCauseType) {
+    /** caused by a label */
+    ModerationCauseType[ModerationCauseType["Label"] = 1] = "Label";
+    /** caused by viewer blocking the subject */
+    ModerationCauseType[ModerationCauseType["Blocking"] = 2] = "Blocking";
+    /** caused by subject blocking the viewer */
+    ModerationCauseType[ModerationCauseType["BlockedBy"] = 3] = "BlockedBy";
+    /** caused by viewer having a (permanent) mute on subject */
+    ModerationCauseType[ModerationCauseType["MutedPermanent"] = 4] = "MutedPermanent";
+    /** caused by a temporary mute */
+    ModerationCauseType[ModerationCauseType["MutedTemporary"] = 5] = "MutedTemporary";
+    /** caused by a keyword mute */
+    ModerationCauseType[ModerationCauseType["MutedKeyword"] = 6] = "MutedKeyword";
+    /** caused by a hidden post */
+    ModerationCauseType[ModerationCauseType["Hidden"] = 7] = "Hidden";
+})(ModerationCauseType || (ModerationCauseType = {}));
+export const createModerationDecision = (authorDid, { viewerDid }) => {
+    return {
+        authorDid: authorDid,
+        isMe: authorDid === viewerDid,
+        causes: [],
+    };
+};
+export const mergeModerationDecisions = (...sources) => {
+    return {
+        authorDid: sources[0].authorDid,
+        isMe: sources[0].isMe,
+        causes: sources.filter((source) => !!source).flatMap((source) => source.causes),
+    };
+};
+export const considerHidden = (decision) => {
+    decision.causes.push({
+        type: ModerationCauseType.Hidden,
+        priority: 6,
+        downgraded: false,
+    });
+};
+export const considerBlocking = (decision, source) => {
+    if (decision.isMe) {
+        return;
+    }
+    decision.causes.push({
+        type: ModerationCauseType.Blocking,
+        priority: 3,
+        source: source,
+        downgraded: false,
+    });
+};
+export const considerBlockedBy = (decision) => {
+    if (decision.isMe) {
+        return;
+    }
+    decision.causes.push({
+        type: ModerationCauseType.BlockedBy,
+        priority: 4,
+        downgraded: false,
+    });
+};
+export const considerPermanentMute = (decision, source) => {
+    if (decision.isMe) {
+        return;
+    }
+    decision.causes.push({
+        type: ModerationCauseType.MutedPermanent,
+        priority: 6,
+        source: source,
+        downgraded: false,
+    });
+};
+export const considerTemporaryMute = (decision, { prefs }) => {
+    if (decision.isMe) {
+        return;
+    }
+    if (prefs.temporaryMutes?.includes(decision.authorDid)) {
+        decision.causes.push({
+            type: ModerationCauseType.MutedTemporary,
+            priority: 6,
+            downgraded: false,
+        });
+    }
+};
+export const considerKeywordMute = (decision, source) => {
+    decision.causes.push({
+        type: ModerationCauseType.MutedKeyword,
+        priority: 6,
+        source: source,
+        downgraded: false,
+    });
+};
+export const considerLabels = (decision, target, labels, opts) => {
+    if (labels?.length) {
+        for (let idx = 0, len = labels.length; idx < len; idx++) {
+            considerLabel(decision, target, labels[idx], opts);
+        }
+    }
+};
+export const considerLabel = (decision, target, label, { viewerDid, prefs, labelDefs }) => {
+    const { src, val } = label;
+    /// 1. grab the label definition
+    let labelDef;
+    if (isCustomLabelValue(val)) {
+        labelDef = labelDefs?.[src]?.[val];
+    }
+    if (labelDef === undefined) {
+        labelDef = BUILTIN_LABELS[val];
+    }
+    if (labelDef === undefined) {
+        return;
+    }
+    /// 2. check applicability
+    if (labelDef.flags & LabelFlags.UnauthenticatedOnly && viewerDid !== undefined) {
+        // skip if label is only for signed-out users
+        return;
+    }
+    const isConfigurable = !(labelDef.flags & LabelFlags.NoConfigurable);
+    const isAdultOnly = !!(labelDef.flags & LabelFlags.AdultOnly);
+    const isSelfApplied = src === decision.authorDid;
+    let labelerPref;
+    if (!isSelfApplied) {
+        labelerPref = prefs.prefsByLabelers?.[src];
+        if (labelerPref === undefined) {
+            // skip if we're looking at an unconfigured labeler
+            return;
+        }
+    }
+    else {
+        if (labelDef.flags & LabelFlags.NoSelf) {
+            // skip if label is not allowed to be self-applied
+            return;
+        }
+    }
+    let pref;
+    if (isConfigurable) {
+        if (isAdultOnly && !prefs.adultContentEnabled) {
+            pref = LabelPreference.Hide;
+        }
+        else {
+            pref = labelerPref?.labelPrefs[val] ?? prefs.globalLabelPrefs?.[val] ?? labelDef.defaultPref;
+        }
+    }
+    else {
+        pref = labelDef.defaultPref;
+    }
+    // skip if label is configured to ignore
+    if (pref === LabelPreference.Ignore) {
+        return;
+    }
+    const behavior = labelDef.behavior[target];
+    const severity = getModerationSeverity(behavior);
+    let priority;
+    if (labelDef.flags & LabelFlags.NoOverride || (isAdultOnly && !prefs.adultContentEnabled)) {
+        priority = 1;
+    }
+    else if (pref === LabelPreference.Hide) {
+        priority = 2;
+    }
+    else if (severity === ModerationSeverity.High) {
+        priority = 5;
+    }
+    else if (severity === ModerationSeverity.Medium) {
+        priority = 7;
+    }
+    else {
+        priority = 8;
+    }
+    let noOverride = false;
+    if (labelDef.flags & LabelFlags.NoOverride || (isAdultOnly && !prefs.adultContentEnabled)) {
+        noOverride = true;
+    }
+    decision.causes.push({
+        type: ModerationCauseType.Label,
+        priority,
+        source: isSelfApplied ? label.src : null,
+        label: label,
+        labelDef: labelDef,
+        target: target,
+        pref: pref,
+        behavior: behavior,
+        noOverride: noOverride,
+        downgraded: false,
+    });
+};
+const getModerationSeverity = (behavior) => {
+    if (behavior[DisplayContext.ProfileView] === ModerationAction.Blur ||
+        behavior[DisplayContext.ContentView] === ModerationAction.Blur) {
+        return ModerationSeverity.High;
+    }
+    if (behavior[DisplayContext.ContentList] === ModerationAction.Blur ||
+        behavior[DisplayContext.ContentMedia] === ModerationAction.Blur) {
+        return ModerationSeverity.Medium;
+    }
+    return ModerationSeverity.Low;
+};
+export const downgradeDecision = (decision) => {
+    if (decision === undefined) {
+        return decision;
+    }
+    const causes = decision.causes;
+    for (let idx = 0, len = causes.length; idx < len; idx++) {
+        const cause = causes[idx];
+        cause.downgraded = true;
+    }
+    return decision;
+};
+//# sourceMappingURL=decision.js.map

package/dist/decision.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import '@atcute/bluesky/lexicons';
+export { DisplayContext, LabelTarget, ModerationAction, type BehaviorMapping, type LabelBehaviorMatrix, } from './behaviors.js';
+export { ModerationCauseType, type BlockedByModerationCause, type BlockingModerationCause, type HiddenModerationCause, type LabelModerationCause, type ModerationCause, type ModerationDecision, type MutedKeywordModerationCause, type MutedPermanentModerationCause, type MutedTemporaryModerationCause, } from './decision.js';
+export { createKeywordPattern, interpretMutedWordPreference, interpretMutedWordPreferences, KeywordFilterFlags, type KeywordFilter, type KeywordMatch, } from './keyword-filter.js';
+export { BlurLevel, interpretLabelerDefinition, interpretLabelerDefinitions, interpretLabelValueDefinition, isCustomLabelValue, LabelFlags, LabelPreference, SeverityLevel, type InterpretedLabelDefinition, type InterpretedLabelMapping, type LabelLocale, } from './label.js';
+export { type FeedGeneratorSubject, type Label, type LabelerPreference, type ListSubject, type ModerationOptions, type ModerationPreferences, type NotificationSubject, type PostSubject, type ProfileSubject, } from './types.js';
+export { getDisplayRestrictions, type DisplayRestrictions } from './ui.js';
+export { moderateFeedGenerator } from './subjects/feed-generator.js';
+export { moderateList } from './subjects/list.js';
+export { moderateNotification } from './subjects/notification.js';
+export { moderatePost } from './subjects/post.js';
+export { moderateProfile } from './subjects/profile.js';

package/dist/index.js

@@ -0,0 +1,13 @@
+import '@atcute/bluesky/lexicons';
+export { DisplayContext, LabelTarget, ModerationAction, } from './behaviors.js';
+export { ModerationCauseType, } from './decision.js';
+export { createKeywordPattern, interpretMutedWordPreference, interpretMutedWordPreferences, KeywordFilterFlags, } from './keyword-filter.js';
+export { BlurLevel, interpretLabelerDefinition, interpretLabelerDefinitions, interpretLabelValueDefinition, isCustomLabelValue, LabelFlags, LabelPreference, SeverityLevel, } from './label.js';
+export {} from './types.js';
+export { getDisplayRestrictions } from './ui.js';
+export { moderateFeedGenerator } from './subjects/feed-generator.js';
+export { moderateList } from './subjects/list.js';
+export { moderateNotification } from './subjects/notification.js';
+export { moderatePost } from './subjects/post.js';
+export { moderateProfile } from './subjects/profile.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,0BAA0B,CAAC;AAElC,OAAO,EACN,cAAc,EACd,WAAW,EACX,gBAAgB,GAGhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,mBAAmB,GAUnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACN,oBAAoB,EACpB,4BAA4B,EAC5B,6BAA6B,EAC7B,kBAAkB,GAGlB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,SAAS,EACT,0BAA0B,EAC1B,2BAA2B,EAC3B,6BAA6B,EAC7B,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,aAAa,GAIb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAUN,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,sBAAsB,EAA4B,MAAM,SAAS,CAAC;AAE3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/internal/keyword-filter.d.ts

@@ -0,0 +1,8 @@
+import type { AppBskyActorDefs } from '@atcute/client/lexicons';
+import { type KeywordFilter } from '../keyword-filter.js';
+export declare const matchesKeywordFilters: ({ filters, text, tags, actor, }: {
+    filters: KeywordFilter[];
+    text: string;
+    tags?: string[];
+    actor?: AppBskyActorDefs.ProfileView | AppBskyActorDefs.ProfileViewBasic;
+}) => KeywordFilter | null;

package/dist/internal/keyword-filter.js

@@ -0,0 +1,27 @@
+import { KeywordFilterFlags } from '../keyword-filter.js';
+const EMPTY_ARRAY = [];
+export const matchesKeywordFilters = ({ filters, text, tags = EMPTY_ARRAY, actor, }) => {
+    for (let i = 0, il = filters.length; i < il; i++) {
+        const filter = filters[i];
+        if (actor && filter.flags & KeywordFilterFlags.NoFollowing) {
+            if (actor.viewer?.following) {
+                continue;
+            }
+        }
+        if (filter.flags & KeywordFilterFlags.ApplyTopic) {
+            for (let j = 0, jl = tags.length; j < jl; j++) {
+                const tag = tags[j];
+                if (filter.pattern.test(tag)) {
+                    return filter;
+                }
+            }
+        }
+        if (filter.flags & KeywordFilterFlags.ApplyContent) {
+            if (filter.pattern.test(text)) {
+                return filter;
+            }
+        }
+    }
+    return null;
+};
+//# sourceMappingURL=keyword-filter.js.map