Add advanced search UI (#10992)

2026-06-26 16:16:48 -07:00
parent c5b3810229
commit 248290e0b3
36 changed files with 3929 additions and 261 deletions
@@ -0,0 +1,199 @@
+import {describe, expect, it} from '@jest/globals'
+
+import {
+  buildSearchPostsV2Filters,
+  extractSearchPostsParams,
+} from '#/state/queries/search-posts-params'
+
+describe(`extractSearchPostsParams`, () => {
+  const tests: {
+    name: string
+    input: string
+    output: ReturnType<typeof extractSearchPostsParams>
+  }[] = [
+    {
+      name: `passes bare text through untouched`,
+      input: `hello world`,
+      output: {q: `hello world`},
+    },
+    {
+      name: `lifts from: into author and strips it from q`,
+      input: `cats from:alice`,
+      output: {q: `cats`, author: `alice`},
+    },
+    {
+      name: `lifts to: into mentions (alias) and strips it from q`,
+      input: `cats to:alice`,
+      output: {q: `cats`, mentions: `alice`},
+    },
+    {
+      name: `accumulates multiple hashtags into tag[]`,
+      input: `#cats #dogs`,
+      output: {q: ``, tag: [`cats`, `dogs`]},
+    },
+    {
+      name: `keeps quoted phrases in q`,
+      input: `"no clues" from:alice`,
+      output: {q: `"no clues"`, author: `alice`},
+    },
+    {
+      name: `keeps OR groups in q`,
+      input: `(cats OR dogs) lang:en`,
+      output: {q: `(cats OR dogs)`, lang: `en`},
+    },
+    {
+      name: `extracts a valid since date`,
+      input: `cats since:2024-01-01`,
+      output: {q: `cats`, since: `2024-01-01`},
+    },
+    {
+      name: `leaves an invalid since date in q`,
+      input: `cats since:garbage`,
+      output: {q: `cats since:garbage`},
+    },
+    {
+      name: `leaves unsupported operators in q`,
+      input: `cats replies:only media:true`,
+      output: {q: `cats replies:only media:true`},
+    },
+    {
+      name: `lifts all supported operators at once`,
+      input: `term from:alice mentions:bob domain:bsky.app url:bsky.app/x lang:en since:2024-01-01 until:2024-02-01 #tag`,
+      output: {
+        q: `term`,
+        author: `alice`,
+        mentions: `bob`,
+        domain: `bsky.app`,
+        url: `bsky.app/x`,
+        lang: `en`,
+        since: `2024-01-01`,
+        until: `2024-02-01`,
+        tag: [`tag`],
+      },
+    },
+    {
+      name: `keeps the first value for a repeated singular operator`,
+      input: `from:alice from:bob`,
+      output: {q: ``, author: `alice`},
+    },
+    // CJK (and other space-free scripts) carries no whitespace, so the
+    // whitespace-based tokenizer must keep it intact as bare query text.
+    {
+      name: `passes bare CJK text through untouched`,
+      input: `東京`,
+      output: {q: `東京`},
+    },
+    {
+      name: `lifts an operator from a CJK query and keeps the CJK text`,
+      input: `東京 from:alice`,
+      output: {q: `東京`, author: `alice`},
+    },
+    {
+      name: `treats a whole CJK phrase as a single token`,
+      input: `寿司 ラーメン`,
+      output: {q: `寿司 ラーメン`},
+    },
+    {
+      name: `lifts a CJK hashtag into tag[]`,
+      input: `#日本 ramen`,
+      output: {q: `ramen`, tag: [`日本`]},
+    },
+  ]
+
+  it.each(tests)(`$name`, ({input, output}) => {
+    expect(extractSearchPostsParams(input)).toEqual(output)
+  })
+})
+
+describe(`buildSearchPostsV2Filters`, () => {
+  it(`maps embedded operators alone into v2 plural params`, () => {
+    expect(
+      buildSearchPostsV2Filters({
+        author: `alice`,
+        domain: `bsky.app`,
+        lang: `en`,
+        tag: [`cats`],
+      }),
+    ).toEqual({
+      authors: [`alice`],
+      domains: [`bsky.app`],
+      languages: [`en`],
+      hashtags: [`cats`],
+    })
+  })
+
+  it(`maps dialog filters alone, including v2-only booleans`, () => {
+    expect(
+      buildSearchPostsV2Filters(
+        {},
+        {author: `bob carol`, media: `true`, replies: `none`},
+      ),
+    ).toEqual({
+      authors: [`bob`, `carol`],
+      hasMedia: true,
+      excludeReplies: true,
+    })
+  })
+
+  it(`unions list values from both sources without clobbering`, () => {
+    expect(
+      buildSearchPostsV2Filters(
+        {author: `alice`, tag: [`cats`]},
+        {author: `bob carol`, tag: `dogs`},
+      ),
+    ).toEqual({
+      authors: [`alice`, `bob`, `carol`],
+      hashtags: [`cats`, `dogs`],
+    })
+  })
+
+  it(`dedupes overlapping values across sources`, () => {
+    expect(
+      buildSearchPostsV2Filters({author: `alice`}, {author: `alice bob`}),
+    ).toEqual({
+      authors: [`alice`, `bob`],
+    })
+  })
+
+  it(`prefers the dialog filter for scalar fields, falling back to embedded`, () => {
+    expect(
+      buildSearchPostsV2Filters(
+        {lang: `en`, since: `2024-01-01`},
+        {lang: `ja`},
+      ),
+    ).toEqual({
+      languages: [`ja`],
+      since: `2024-01-01T00:00:00Z`,
+    })
+  })
+
+  it(`normalizes date-only since/until to midnight UTC timestamps`, () => {
+    expect(
+      buildSearchPostsV2Filters({}, {since: `2024-01-01`, until: `2024-02-01`}),
+    ).toEqual({
+      since: `2024-01-01T00:00:00Z`,
+      until: `2024-02-01T00:00:00Z`,
+    })
+  })
+
+  it(`leaves a timestamp with an explicit time component unchanged`, () => {
+    expect(
+      buildSearchPostsV2Filters({}, {until: `2024-02-01T12:30:00Z`}),
+    ).toEqual({
+      until: `2024-02-01T12:30:00Z`,
+    })
+  })
+
+  it(`passes exclude lists through from dialog filters`, () => {
+    expect(
+      buildSearchPostsV2Filters(
+        {author: `alice`},
+        {excludeAuthor: `bob carol`, excludeTag: `spam`},
+      ),
+    ).toEqual({
+      authors: [`alice`],
+      excludeAuthors: [`bob`, `carol`],
+      excludeHashtags: [`spam`],
+    })
+  })
+})