@basaltkit/search 1.0.0 → 1.2.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Machize Contributors
+Copyright (c) 2026 Basalt Contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/index.d.ts

@@ -103,6 +103,9 @@ declare class MeilisearchError extends BasaltError {
     readonly httpStatus: number;
     constructor(httpStatus: number, message: string);
 }
+declare class SearchFilterFieldError extends BasaltError {
+    constructor(field: string);
+}
 interface MeilisearchDriverOptions {
     host: string;
     apiKey?: string;
@@ -156,7 +159,14 @@ interface SearchPluginOptions {
     indexes?: IndexDefinition[];
     /** Rules keeping indexes in sync with domain hooks. */
     sync?: SyncRule[];
+    /**
+     * Throw if an index fails to register at boot. Default `false`: a search
+     * backend that's down or misconfigured logs a warning and the app boots
+     * anyway (search stays degraded until the backend is reachable), so an outage
+     * never blocks unrelated work — including CLI commands that don't use search.
+     */
+    failOnRegisterError?: boolean;
 }
 declare function searchPlugin(options?: SearchPluginOptions): _basaltkit_core.BasaltPlugin<unknown>;
 
-export { type IndexDefinition, MeilisearchDriver, type MeilisearchDriverOptions, MeilisearchError, MemorySearchDriver, SEARCH, Search, type SearchDocument, type SearchDriver, type SearchHit, type SearchOptions, type SearchPluginOptions, type SearchQuery, type SearchResult, type SyncRule, TenantRequiredError, defineIndex, searchPlugin, syncRule };
+export { type IndexDefinition, MeilisearchDriver, type MeilisearchDriverOptions, MeilisearchError, MemorySearchDriver, SEARCH, Search, type SearchDocument, type SearchDriver, SearchFilterFieldError, type SearchHit, type SearchOptions, type SearchPluginOptions, type SearchQuery, type SearchResult, type SyncRule, TenantRequiredError, defineIndex, searchPlugin, syncRule };

package/dist/index.js

@@ -128,6 +128,12 @@ var MeilisearchError = class extends BasaltError2 {
   }
   httpStatus;
 };
+var SearchFilterFieldError = class extends BasaltError2 {
+  constructor(field) {
+    super("SEARCH_INVALID_FILTER_FIELD", `Invalid filter field name: ${JSON.stringify(field)}.`);
+  }
+};
+var SAFE_FILTER_FIELD = /^[A-Za-z_][A-Za-z0-9_]*(\.[A-Za-z_][A-Za-z0-9_]*)*$/;
 var primaryKey = (tenantId, id) => Buffer.from(`${tenantId}::${id}`).toString("base64url");
 var quote = (value) => JSON.stringify(value);
 var MeilisearchDriver = class {
@@ -182,6 +188,7 @@ var MeilisearchDriver = class {
   buildFilter(tenantId, filters) {
     const parts = [`tenantId = ${quote(tenantId)}`];
     for (const [field, value] of Object.entries(filters ?? {})) {
+      if (!SAFE_FILTER_FIELD.test(field)) throw new SearchFilterFieldError(field);
       parts.push(Array.isArray(value) ? `${field} IN [${value.map(quote).join(", ")}]` : `${field} = ${quote(value)}`);
     }
     return parts.join(" AND ");
@@ -221,7 +228,18 @@ function searchPlugin(options = {}) {
     async boot({ container, hooks }) {
       const search = container.get(SEARCH);
       if (driver.register) {
-        for (const index of options.indexes ?? []) await driver.register(index);
+        for (const index of options.indexes ?? []) {
+          try {
+            await driver.register(index);
+          } catch (error) {
+            if (options.failOnRegisterError) throw error;
+            console.warn(
+              `[basalt:search] could not register index "${index.name}": ${String(
+                error?.message ?? error
+              )} \u2014 search is degraded until the backend is reachable.`
+            );
+          }
+        }
       }
       for (const rule of options.sync ?? []) {
         hooks.on(rule.hook, async (payload) => {
@@ -243,6 +261,7 @@ export {
   MemorySearchDriver,
   SEARCH,
   Search,
+  SearchFilterFieldError,
   TenantRequiredError,
   defineIndex,
   searchPlugin,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basaltkit/search",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Full-text search for Basalt: tenant-scoped indexing and querying with a pluggable driver (in-memory for dev/test, Meilisearch for production) and automatic sync from domain events.",
   "license": "MIT",
   "type": "module",