@atproto/api 0.10.5-next.0 → 0.11.0-next

package/tests/moderation.test.ts

@@ -1,5 +1,10 @@
-import { moderateProfile, moderatePost } from '../src'
-import { mock } from './util'
+import {
+  moderateProfile,
+  moderatePost,
+  mock,
+  interpretLabelValueDefinition,
+} from '../src'
+import './util/moderation-behavior'
 
 describe('Moderation', () => {
   it('Applies self-labels on profiles according to the global preferences', () => {
@@ -19,25 +24,17 @@ describe('Moderation', () => {
       }),
       {
         userDid: 'did:web:alice.test',
-        adultContentEnabled: true,
-        labels: {
-          porn: 'hide',
+        prefs: {
+          adultContentEnabled: true,
+          labels: {
+            porn: 'hide',
+          },
+          mods: [],
         },
-        labelers: [],
       },
     )
-    expect(res1.account).toBeModerationResult(
-      {},
-      'post content',
-      JSON.stringify(res1, null, 2),
-    )
-    expect(res1.profile).toBeModerationResult(
-      {},
-      'post content',
-      JSON.stringify(res1, null, 2),
-    )
-    expect(res1.avatar).toBeModerationResult(
-      { blur: true },
+    expect(res1.ui('avatar')).toBeModerationResult(
+      ['blur'],
       'post avatar',
       JSON.stringify(res1, null, 2),
       true,
@@ -59,46 +56,32 @@ describe('Moderation', () => {
       }),
       {
         userDid: 'did:web:alice.test',
-        adultContentEnabled: true,
-        labels: {
-          porn: 'ignore',
+        prefs: {
+          adultContentEnabled: true,
+          labels: {
+            porn: 'ignore',
+          },
+          mods: [],
         },
-        labelers: [],
       },
     )
-    expect(res2.account).toBeModerationResult(
-      {},
-      'post content',
-      JSON.stringify(res2, null, 2),
-    )
-    expect(res2.profile).toBeModerationResult(
-      {},
-      'post content',
-      JSON.stringify(res2, null, 2),
-    )
-    expect(res2.avatar).toBeModerationResult(
-      {},
+    expect(res2.ui('avatar')).toBeModerationResult(
+      [],
       'post avatar',
-      JSON.stringify(res2, null, 2),
+      JSON.stringify(res1, null, 2),
       true,
     )
   })
 
-  it('Applies self-labels on posts according to the global preferences', () => {
-    // porn (hide)
-    const res1 = moderatePost(
-      mock.postView({
-        record: {
-          text: 'Hello',
-          createdAt: new Date().toISOString(),
-        },
-        author: mock.profileViewBasic({
-          handle: 'bob.test',
-          displayName: 'Bob',
-        }),
+  it('Ignores labels from unsubscribed moderators or ignored labels for a moderator', () => {
+    // porn (moderator disabled)
+    const res1 = moderateProfile(
+      mock.profileViewBasic({
+        handle: 'bob.test',
+        displayName: 'Bob',
         labels: [
           {
-            src: 'did:web:bob.test',
+            src: 'did:web:labeler.test',
             uri: 'at://did:web:bob.test/app.bsky.actor.profile/self',
             val: 'porn',
             cts: new Date().toISOString(),
@@ -107,32 +90,82 @@ describe('Moderation', () => {
       }),
       {
         userDid: 'did:web:alice.test',
-        adultContentEnabled: true,
-        labels: {
-          porn: 'hide',
+        prefs: {
+          adultContentEnabled: true,
+          labels: {
+            porn: 'hide',
+          },
+          mods: [],
         },
-        labelers: [],
       },
     )
-    expect(res1.content).toBeModerationResult(
-      { cause: 'label:porn', filter: true },
-      'post content',
-      JSON.stringify(res1, null, 2),
-    )
-    expect(res1.embed).toBeModerationResult(
-      { cause: 'label:porn', blur: true },
-      'post content',
-      JSON.stringify(res1, null, 2),
-    )
-    expect(res1.avatar).toBeModerationResult(
-      {},
-      'post avatar',
-      JSON.stringify(res1, null, 2),
-      true,
+    for (const k of [
+      'profileList',
+      'profileView',
+      'avatar',
+      'banner',
+      'displayName',
+      'contentList',
+      'contentView',
+      'contentMedia',
+    ]) {
+      expect(res1.ui(k)).toBeModerationResult(
+        [],
+        k,
+        JSON.stringify(res1, null, 2),
+      )
+    }
+
+    // porn (label group disabled)
+    const res2 = moderateProfile(
+      mock.profileViewBasic({
+        handle: 'bob.test',
+        displayName: 'Bob',
+        labels: [
+          {
+            src: 'did:web:labeler.test',
+            uri: 'at://did:web:bob.test/app.bsky.actor.profile/self',
+            val: 'porn',
+            cts: new Date().toISOString(),
+          },
+        ],
+      }),
+      {
+        userDid: 'did:web:alice.test',
+        prefs: {
+          adultContentEnabled: true,
+          labels: {
+            porn: 'ignore',
+          },
+          mods: [
+            {
+              did: 'did:web:labeler.test',
+              labels: { porn: 'ignore' },
+            },
+          ],
+        },
+      },
     )
+    for (const k of [
+      'profileList',
+      'profileView',
+      'avatar',
+      'banner',
+      'displayName',
+      'contentList',
+      'contentView',
+      'contentMedia',
+    ]) {
+      expect(res2.ui(k)).toBeModerationResult(
+        [],
+        k,
+        JSON.stringify(res2, null, 2),
+      )
+    }
+  })
 
-    // porn (ignore)
-    const res2 = moderatePost(
+  it('Can manually apply hiding', () => {
+    const res1 = moderatePost(
       mock.postView({
         record: {
           text: 'Hello',
@@ -142,192 +175,262 @@ describe('Moderation', () => {
           handle: 'bob.test',
           displayName: 'Bob',
         }),
-        labels: [
-          {
-            src: 'did:web:bob.test',
-            uri: 'at://did:web:bob.test/app.bsky.actor.profile/self',
-            val: 'porn',
-            cts: new Date().toISOString(),
-          },
-        ],
+        labels: [],
       }),
       {
         userDid: 'did:web:alice.test',
-        adultContentEnabled: true,
-        labels: {
-          porn: 'ignore',
+        prefs: {
+          adultContentEnabled: true,
+          labels: {},
+          mods: [
+            {
+              did: 'did:web:labeler.test',
+              labels: {},
+            },
+          ],
         },
-        labelers: [],
       },
     )
-    expect(res2.content).toBeModerationResult(
-      {},
-      'post content',
-      JSON.stringify(res2, null, 2),
-    )
-    expect(res2.embed).toBeModerationResult(
-      {},
-      'post content',
-      JSON.stringify(res2, null, 2),
-    )
-    expect(res2.avatar).toBeModerationResult(
-      {},
-      'post avatar',
-      JSON.stringify(res2, null, 2),
-      true,
+    res1.addHidden(true)
+    expect(res1.ui('contentList')).toBeModerationResult(
+      ['filter', 'blur'],
+      'contentList',
     )
+    expect(res1.ui('contentView')).toBeModerationResult(['blur'], 'contentView')
   })
 
-  it('Applies labeler labels according to the per-labeler then global preferences', () => {
-    // porn (ignore for labeler, hide for global)
-    const res1 = moderateProfile(
-      mock.profileViewBasic({
-        handle: 'bob.test',
-        displayName: 'Bob',
+  it('Prioritizes filters and blurs correctly on merge', () => {
+    const res1 = moderatePost(
+      mock.postView({
+        record: {
+          text: 'Hello',
+          createdAt: new Date().toISOString(),
+        },
+        author: mock.profileViewBasic({
+          handle: 'bob.test',
+          displayName: 'Bob',
+        }),
         labels: [
           {
             src: 'did:web:labeler.test',
-            uri: 'at://did:web:bob.test/app.bsky.actor.profile/self',
+            uri: 'at://did:web:bob.test/app.bsky.post/fake',
             val: 'porn',
             cts: new Date().toISOString(),
           },
+          {
+            src: 'did:web:labeler.test',
+            uri: 'at://did:web:bob.test/app.bsky.post/fake',
+            val: '!hide',
+            cts: new Date().toISOString(),
+          },
         ],
       }),
       {
         userDid: 'did:web:alice.test',
-        adultContentEnabled: true,
-        labels: {
-          porn: 'hide',
-        },
-        labelers: [
-          {
-            labeler: {
+        prefs: {
+          adultContentEnabled: true,
+          labels: {
+            porn: 'hide',
+          },
+          mods: [
+            {
               did: 'did:web:labeler.test',
-              displayName: 'Labeler',
+              labels: {},
             },
-            labels: {
-              porn: 'ignore',
-            },
-          },
-        ],
+          ],
+        },
       },
     )
-    expect(res1.avatar).toBeModerationResult(
-      {},
-      'post avatar',
-      JSON.stringify(res1, null, 2),
-      true,
-    )
+    expect(res1.ui('contentList').filters[0].label.val).toBe('!hide')
+    expect(res1.ui('contentList').filters[1].label.val).toBe('porn')
+    expect(res1.ui('contentList').blurs[0].label.val).toBe('!hide')
+    expect(res1.ui('contentMedia').blurs[0].label.val).toBe('porn')
+  })
 
-    // porn (hide for labeler, ignore for global)
-    const res2 = moderateProfile(
-      mock.profileViewBasic({
-        handle: 'bob.test',
-        displayName: 'Bob',
+  it('Prioritizes custom label definitions', () => {
+    const modOpts = {
+      userDid: 'did:web:alice.test',
+      prefs: {
+        adultContentEnabled: true,
+        labels: { porn: 'warn' },
+        mods: [
+          {
+            did: 'did:web:labeler.test',
+            labels: { porn: 'warn' },
+          },
+        ],
+      },
+      labelDefs: {
+        'did:web:labeler.test': [
+          interpretLabelValueDefinition({
+            identifier: 'porn',
+            blurs: 'none',
+            severity: 'inform',
+            defaultSetting: 'warn',
+            locales: [],
+          }),
+        ],
+      },
+    }
+    const res = moderatePost(
+      mock.postView({
+        record: {
+          text: 'Hello',
+          createdAt: new Date().toISOString(),
+        },
+        author: mock.profileViewBasic({
+          handle: 'bob.test',
+          displayName: 'Bob',
+        }),
         labels: [
           {
             src: 'did:web:labeler.test',
-            uri: 'at://did:web:bob.test/app.bsky.actor.profile/self',
+            uri: 'at://did:web:bob.test/app.bsky.post/fake',
             val: 'porn',
             cts: new Date().toISOString(),
           },
         ],
       }),
-      {
-        userDid: 'did:web:alice.test',
+      modOpts,
+    )
+    expect(res.ui('profileList')).toBeModerationResult([])
+    expect(res.ui('profileView')).toBeModerationResult([])
+    expect(res.ui('avatar')).toBeModerationResult([])
+    expect(res.ui('banner')).toBeModerationResult([])
+    expect(res.ui('displayName')).toBeModerationResult([])
+    expect(res.ui('contentList')).toBeModerationResult(['inform'])
+    expect(res.ui('contentView')).toBeModerationResult(['inform'])
+    expect(res.ui('contentMedia')).toBeModerationResult([])
+  })
+
+  it('Doesnt allow custom behaviors to override imperative labels', () => {
+    const modOpts = {
+      userDid: 'did:web:alice.test',
+      prefs: {
         adultContentEnabled: true,
-        labels: {
-          porn: 'ignore',
-        },
-        labelers: [
+        labels: {},
+        mods: [
           {
-            labeler: {
-              did: 'did:web:labeler.test',
-              displayName: 'Labeler',
-            },
-            labels: {
-              porn: 'hide',
-            },
+            did: 'did:web:labeler.test',
+            labels: {},
           },
         ],
       },
-    )
-    expect(res2.avatar).toBeModerationResult(
-      { blur: true },
-      'post avatar',
-      JSON.stringify(res2, null, 2),
-      true,
-    )
-
-    // porn (unspecified for labeler, hide for global)
-    const res3 = moderateProfile(
-      mock.profileViewBasic({
-        handle: 'bob.test',
-        displayName: 'Bob',
+      labelDefs: {
+        'did:web:labeler.test': [
+          interpretLabelValueDefinition({
+            identifier: '!hide',
+            blurs: 'none',
+            severity: 'inform',
+            defaultSetting: 'warn',
+            locales: [],
+          }),
+        ],
+      },
+    }
+    const res = moderatePost(
+      mock.postView({
+        record: {
+          text: 'Hello',
+          createdAt: new Date().toISOString(),
+        },
+        author: mock.profileViewBasic({
+          handle: 'bob.test',
+          displayName: 'Bob',
+        }),
         labels: [
           {
             src: 'did:web:labeler.test',
-            uri: 'at://did:web:bob.test/app.bsky.actor.profile/self',
-            val: 'porn',
+            uri: 'at://did:web:bob.test/app.bsky.post/fake',
+            val: '!hide',
             cts: new Date().toISOString(),
           },
         ],
       }),
-      {
-        userDid: 'did:web:alice.test',
+      modOpts,
+    )
+
+    expect(res.ui('profileList')).toBeModerationResult(['filter'])
+    expect(res.ui('profileView')).toBeModerationResult([])
+    expect(res.ui('avatar')).toBeModerationResult([])
+    expect(res.ui('banner')).toBeModerationResult([])
+    expect(res.ui('displayName')).toBeModerationResult([])
+    expect(res.ui('contentList')).toBeModerationResult([
+      'filter',
+      'blur',
+      'noOverride',
+    ])
+    expect(res.ui('contentView')).toBeModerationResult(['blur', 'noOverride'])
+    expect(res.ui('contentMedia')).toBeModerationResult([])
+  })
+
+  it('Ignores invalid label value names', () => {
+    const modOpts = {
+      userDid: 'did:web:alice.test',
+      prefs: {
         adultContentEnabled: true,
-        labels: {
-          porn: 'hide',
-        },
-        labelers: [
+        labels: {},
+        mods: [
           {
-            labeler: {
-              did: 'did:web:labeler.test',
-              displayName: 'Labeler',
-            },
-            labels: {},
+            did: 'did:web:labeler.test',
+            labels: { BadLabel: 'hide', 'bad/label': 'hide' },
           },
         ],
       },
-    )
-    expect(res3.avatar).toBeModerationResult(
-      { blur: true },
-      'post avatar',
-      JSON.stringify(res3, null, 2),
-      true,
-    )
-  })
-
-  /*
-  TODO enable when 3P labeler support is added
-  it('Ignores labels from unknown labelers', () => {
-    const res1 = moderateProfile(
-      mock.profileViewBasic({
-        handle: 'bob.test',
-        displayName: 'Bob',
+      labelDefs: {
+        'did:web:labeler.test': [
+          interpretLabelValueDefinition({
+            identifier: 'BadLabel',
+            blurs: 'content',
+            severity: 'inform',
+            defaultSetting: 'warn',
+            locales: [],
+          }),
+          interpretLabelValueDefinition({
+            identifier: 'bad/label',
+            blurs: 'content',
+            severity: 'inform',
+            defaultSetting: 'warn',
+            locales: [],
+          }),
+        ],
+      },
+    }
+    const res = moderatePost(
+      mock.postView({
+        record: {
+          text: 'Hello',
+          createdAt: new Date().toISOString(),
+        },
+        author: mock.profileViewBasic({
+          handle: 'bob.test',
+          displayName: 'Bob',
+        }),
         labels: [
           {
-            src: 'did:web:rando.test',
-            uri: 'at://did:web:bob.test/app.bsky.actor.profile/self',
-            val: 'porn',
+            src: 'did:web:labeler.test',
+            uri: 'at://did:web:bob.test/app.bsky.post/fake',
+            val: 'BadLabel',
+            cts: new Date().toISOString(),
+          },
+          {
+            src: 'did:web:labeler.test',
+            uri: 'at://did:web:bob.test/app.bsky.post/fake',
+            val: 'bad/label',
             cts: new Date().toISOString(),
           },
         ],
       }),
-      {
-        userDid: 'did:web:alice.test',
-        adultContentEnabled: true,
-        labels: {
-          porn: 'hide',
-        },
-        labelers: [],
-      },
+      modOpts,
     )
-    expect(res1.avatar).toBeModerationResult(
-      {},
-      'post avatar',
-      JSON.stringify(res1, null, 2),
-      true,
-    )
-  })*/
+
+    expect(res.ui('profileList')).toBeModerationResult([])
+    expect(res.ui('profileView')).toBeModerationResult([])
+    expect(res.ui('avatar')).toBeModerationResult([])
+    expect(res.ui('banner')).toBeModerationResult([])
+    expect(res.ui('displayName')).toBeModerationResult([])
+    expect(res.ui('contentList')).toBeModerationResult([])
+    expect(res.ui('contentView')).toBeModerationResult([])
+    expect(res.ui('contentMedia')).toBeModerationResult([])
+  })
 })

package/tests/util/echo-server.ts

@@ -0,0 +1,21 @@
+import http from 'node:http'
+
+export async function createHeaderEchoServer(port: number) {
+  return new Promise<http.Server>((resolve) => {
+    const server = http.createServer()
+
+    server
+      .on('request', (request, response) => {
+        response.setHeader('content-type', 'application/json')
+        response.end(
+          JSON.stringify({
+            ...request.headers,
+            did: 'did:web:fake.com',
+            availableUserDomains: [],
+          }),
+        )
+      })
+      .on('listening', () => resolve(server))
+      .listen(port)
+  })
+}