@strav/search 0.3.20 → 0.3.22

package/src/drivers/postgres/types.ts

@@ -0,0 +1,53 @@
+import type { SQL } from 'bun'
+import type { DriverConfig, IndexSettings } from '../../types.ts'
+
+export type TypoToleranceMode = 'off' | 'auto'
+
+export interface TypoToleranceSettings {
+  /** Minimum token length to consider for fuzzy expansion (default 4). */
+  minTokenLength?: number
+  /** Maximum Levenshtein distance to tolerate (default 1; 2 is supported but slower). */
+  maxDistance?: number
+  /** pg_trgm similarity threshold (default 0.4). Higher = stricter. */
+  similarity?: number
+}
+
+export interface PostgresFtsConfig extends DriverConfig {
+  driver: string
+  /**
+   * Bun SQL connection. If omitted, the driver falls back to
+   * `Database.raw` from `@strav/database` (must be bootstrapped first).
+   */
+  connection?: SQL
+  /** Postgres schema for index tables. Default 'strav_search'. */
+  schema?: string
+  /** Default text-search configuration ('english', 'french', ...). */
+  language?: string
+  /** Typo tolerance: 'off' disables; 'auto' uses defaults; object for fine-grained control. */
+  typoTolerance?: TypoToleranceMode | TypoToleranceSettings
+  /** GIN index tuning. */
+  gin?: {
+    /** Default false — better tail latency for read-heavy search. */
+    fastupdate?: boolean
+  }
+  /** Per-search-transaction work_mem hint, e.g. '64MB'. Set to null/empty to skip. */
+  workMem?: string | null
+}
+
+/** Resolved typo tolerance settings (after defaults applied). */
+export interface ResolvedTypoTolerance {
+  enabled: boolean
+  minTokenLength: number
+  maxDistance: number
+  similarity: number
+}
+
+/** Per-index extra settings stored in `_meta`. */
+export interface PgIndexSettings extends IndexSettings {
+  language?: string
+  /**
+   * Per-attribute weight tier override. Keys must appear in `searchableAttributes`.
+   * Values: 'A' | 'B' | 'C' | 'D'. Default = positional (1st=A, 2nd=B, ...).
+   */
+  weights?: Record<string, 'A' | 'B' | 'C' | 'D'>
+}

package/src/index.ts

@@ -12,6 +12,17 @@ export { MeilisearchDriver } from './drivers/meilisearch_driver.ts'
 export { TypesenseDriver } from './drivers/typesense_driver.ts'
 export { AlgoliaDriver } from './drivers/algolia_driver.ts'
 export { NullDriver } from './drivers/null_driver.ts'
+export { EmbeddedDriver } from './drivers/embedded/index.ts'
+export type {
+  EmbeddedConfig,
+  TypoToleranceMode,
+  TypoToleranceSettings,
+} from './drivers/embedded/index.ts'
+export { PostgresFtsDriver } from './drivers/postgres/index.ts'
+export type {
+  PostgresFtsConfig,
+  PgIndexSettings,
+} from './drivers/postgres/index.ts'
 
 // Mixin
 export { searchable } from './searchable.ts'

package/src/search_manager.ts

@@ -5,6 +5,8 @@ import { MeilisearchDriver } from './drivers/meilisearch_driver.ts'
 import { TypesenseDriver } from './drivers/typesense_driver.ts'
 import { AlgoliaDriver } from './drivers/algolia_driver.ts'
 import { NullDriver } from './drivers/null_driver.ts'
+import { EmbeddedDriver } from './drivers/embedded/index.ts'
+import { PostgresFtsDriver } from './drivers/postgres/index.ts'
 
 @inject
 export default class SearchManager {
@@ -86,6 +88,11 @@ export default class SearchManager {
         return new TypesenseDriver(config)
       case 'algolia':
         return new AlgoliaDriver(config)
+      case 'embedded':
+        return new EmbeddedDriver(config)
+      case 'postgres-fts':
+      case 'postgres':
+        return new PostgresFtsDriver(config)
       case 'null':
         return new NullDriver()
       default:

package/stubs/config/search.ts

@@ -28,5 +28,30 @@ export default {
       appId: env('ALGOLIA_APP_ID', ''),
       apiKey: env('ALGOLIA_SECRET', ''),
     },
+
+    embedded: {
+      driver: 'embedded',
+      /** Directory holding per-index `.sqlite` files. Use ':memory:' for tests. */
+      path: env('SEARCH_PATH', './storage/search'),
+      /** SQLite synchronous pragma. NORMAL is crash-safe with sub-second-of-writes loss. */
+      synchronous: env('SEARCH_SYNCHRONOUS', 'NORMAL'),
+      /** Typo tolerance: 'off' to disable, 'auto' for defaults, or { minTokenLength, maxDistance }. */
+      typoTolerance: env('SEARCH_TYPO_TOLERANCE', 'auto'),
+    },
+
+    postgres: {
+      driver: 'postgres-fts',
+      /** Postgres schema for index tables. */
+      schema: env('SEARCH_PG_SCHEMA', 'strav_search'),
+      /** Default text-search configuration ('english', 'french', ...). */
+      language: env('SEARCH_PG_LANGUAGE', 'english'),
+      /** Typo tolerance: 'off' to disable, 'auto' for defaults, or { minTokenLength, maxDistance, similarity }. */
+      typoTolerance: env('SEARCH_TYPO_TOLERANCE', 'auto'),
+      /** Per-search work_mem hint. Set to null/empty to skip. */
+      workMem: env('SEARCH_PG_WORK_MEM', '64MB'),
+      /** GIN index tuning — fastupdate=off improves read tail latency. */
+      gin: { fastupdate: false },
+      // `connection` (Bun SQL instance) is resolved from @strav/database at runtime.
+    },
   },
 }