@venizia/ignis-connectors 0.4.7-4 → 0.4.7-6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/README.md +2 -2
  2. package/dist/esm/common/driver-data-source.js +1 -1
  3. package/dist/esm/common/driver-data-source.js.map +1 -1
  4. package/dist/esm/relational/sqlite/datasources/common/index.d.ts +0 -1
  5. package/dist/esm/relational/sqlite/datasources/common/index.d.ts.map +1 -1
  6. package/dist/esm/relational/sqlite/datasources/common/index.js +0 -1
  7. package/dist/esm/relational/sqlite/datasources/common/index.js.map +1 -1
  8. package/dist/esm/search/core/connector.d.ts +25 -2
  9. package/dist/esm/search/core/connector.d.ts.map +1 -1
  10. package/dist/esm/search/core/connector.js.map +1 -1
  11. package/dist/esm/search/core/controllers/factory.d.ts +1 -0
  12. package/dist/esm/search/core/controllers/factory.d.ts.map +1 -1
  13. package/dist/esm/search/core/internal/search-connector-internal.d.ts +19 -0
  14. package/dist/esm/search/core/internal/search-connector-internal.d.ts.map +1 -1
  15. package/dist/esm/search/core/internal/search-connector-internal.js +72 -1
  16. package/dist/esm/search/core/internal/search-connector-internal.js.map +1 -1
  17. package/dist/esm/search/core/repositories/common/constants.d.ts +1 -0
  18. package/dist/esm/search/core/repositories/common/constants.d.ts.map +1 -1
  19. package/dist/esm/search/core/repositories/common/constants.js +3 -1
  20. package/dist/esm/search/core/repositories/common/constants.js.map +1 -1
  21. package/dist/esm/search/core/repositories/core/readable.d.ts +38 -1
  22. package/dist/esm/search/core/repositories/core/readable.d.ts.map +1 -1
  23. package/dist/esm/search/core/repositories/core/readable.js +96 -1
  24. package/dist/esm/search/core/repositories/core/readable.js.map +1 -1
  25. package/dist/esm/search/meilisearch/internal/connector-internal.d.ts +6 -1
  26. package/dist/esm/search/meilisearch/internal/connector-internal.d.ts.map +1 -1
  27. package/dist/esm/search/meilisearch/internal/connector-internal.js +36 -1
  28. package/dist/esm/search/meilisearch/internal/connector-internal.js.map +1 -1
  29. package/dist/esm/search/meilisearch/repositories/dialect/query-dialect.d.ts.map +1 -1
  30. package/dist/esm/search/meilisearch/repositories/dialect/query-dialect.js +4 -0
  31. package/dist/esm/search/meilisearch/repositories/dialect/query-dialect.js.map +1 -1
  32. package/dist/esm/search/typesense/common/types/client.d.ts +2 -0
  33. package/dist/esm/search/typesense/common/types/client.d.ts.map +1 -1
  34. package/dist/esm/search/typesense/common/types/client.js.map +1 -1
  35. package/dist/esm/search/typesense/common/types/options.d.ts +19 -1
  36. package/dist/esm/search/typesense/common/types/options.d.ts.map +1 -1
  37. package/dist/esm/search/typesense/common/types/options.js.map +1 -1
  38. package/dist/esm/search/typesense/connector.d.ts +54 -7
  39. package/dist/esm/search/typesense/connector.d.ts.map +1 -1
  40. package/dist/esm/search/typesense/connector.js +139 -30
  41. package/dist/esm/search/typesense/connector.js.map +1 -1
  42. package/dist/esm/search/typesense/internal/connector-internal.d.ts +22 -0
  43. package/dist/esm/search/typesense/internal/connector-internal.d.ts.map +1 -1
  44. package/dist/esm/search/typesense/internal/connector-internal.js +54 -0
  45. package/dist/esm/search/typesense/internal/connector-internal.js.map +1 -1
  46. package/dist/esm/search/typesense/internal/mappers.d.ts +7 -1
  47. package/dist/esm/search/typesense/internal/mappers.d.ts.map +1 -1
  48. package/dist/esm/search/typesense/internal/mappers.js +54 -1
  49. package/dist/esm/search/typesense/internal/mappers.js.map +1 -1
  50. package/dist/esm/search/typesense/repositories/common/types.d.ts +27 -2
  51. package/dist/esm/search/typesense/repositories/common/types.d.ts.map +1 -1
  52. package/dist/esm/search/typesense/repositories/common/types.js.map +1 -1
  53. package/dist/esm/search/typesense/repositories/dialect/query-dialect.d.ts.map +1 -1
  54. package/dist/esm/search/typesense/repositories/dialect/query-dialect.js +87 -1
  55. package/dist/esm/search/typesense/repositories/dialect/query-dialect.js.map +1 -1
  56. package/dist/esm/testing/transaction-double.d.ts +27 -11
  57. package/dist/esm/testing/transaction-double.d.ts.map +1 -1
  58. package/dist/esm/testing/transaction-double.js +13 -1
  59. package/dist/esm/testing/transaction-double.js.map +1 -1
  60. package/package.json +6 -6
  61. package/dist/esm/relational/sqlite/datasources/common/guards.d.ts +0 -8
  62. package/dist/esm/relational/sqlite/datasources/common/guards.d.ts.map +0 -1
  63. package/dist/esm/relational/sqlite/datasources/common/guards.js +0 -9
  64. package/dist/esm/relational/sqlite/datasources/common/guards.js.map +0 -1
package/README.md CHANGED
@@ -130,8 +130,8 @@ entry and name its class in `@datasource({ driver })`.
130
130
  ## Where it sits
131
131
 
132
132
  Depends on `@venizia/ignis-kernel`, `@venizia/ignis-filter`, `@venizia/ignis-helpers` and
133
- `@venizia/ignis-inversion`. Used by `@venizia/ignis`, which re-exports every sub-path under the same
134
- name (`@venizia/ignis/postgres`, ...) except `/http`. Its root re-exports `/postgres`.
133
+ `@venizia/ignis-inversion`. Used by `@venizia/ignis`, whose root re-exports `/postgres`. Every other sub-path is imported from this
134
+ package, so an app that uses one lists `@venizia/ignis-connectors` as a dependency.
135
135
 
136
136
  ## Links
137
137
 
@@ -126,7 +126,7 @@ export class AbstractDriverDataSource extends AbstractDataSource {
126
126
  const savedClient = this.client;
127
127
  const savedSettings = { ...this.settings };
128
128
  // Rotation only takes effect through this.settings + configure(); a configure() that
129
- // hard-codes its connection string or reads Envs directly rebuilds with stale credentials.
129
+ // hard-codes its connection string or reads the environment directly rebuilds with stale credentials.
130
130
  Object.assign(this.settings, this.mapSecretToSettings({ secret: opts.secret }));
131
131
  // configure() overwrites this.client, so the new pool is captured
132
132
  // into a local and the old client restored at once - live fields
@@ -1 +1 @@
1
- {"version":3,"file":"driver-data-source.js","sourceRoot":"","sources":["../../../src/common/driver-data-source.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';\nimport { AbstractDataSource } from '@venizia/ignis-kernel/repository';\nimport { MetadataRegistry } from '@venizia/ignis-kernel/metadata';\nimport type { AnyObject, AnyType, TClass } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { IConnectorDriver } from './driver';\n\n/**\n * A datasource that holds one client and a connector built over it through a driver: the lifecycle\n * every connector family that talks to an external engine shares - wiring the driver named by\n * `@datasource({ driver })`, closing once, soft-evicting the client after a secret rotation, draining\n * a client by whichever verb its engine spells it with. No SQL members: the relational family adds\n * its dialect, executor and transactions in `AbstractRelationalDataSource`, a raw-SQL engine adds\n * nothing (`BaseRawSqlDataSource`). Transactions stay NotSupported, as in `AbstractDataSource`.\n *\n * `mapSecretToSettings` is a driver-config convention, not Postgres SQL, so it belongs on this\n * neutral base - do not move it down into a family.\n */\nexport abstract class AbstractDriverDataSource<\n Settings extends object = {},\n Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema,\n ConfigurableOptions extends object = {},\n Client = unknown,\n TConnector = unknown,\n TDriver extends IConnectorDriver<TConnector, AnyType> = IConnectorDriver<TConnector, Client>,\n> extends AbstractDataSource<Settings, Schema, ConfigurableOptions> {\n connector: TConnector;\n\n protected client?: Client;\n protected driver?: TDriver;\n\n private closePromise?: Promise<void>;\n\n /**\n * Lazy and idempotent: builds the driver named by `@datasource({ driver })` over the client\n * `configure()` assigned, then the connector from it.\n */\n protected wireDriverFromMetadata(): void {\n if (this.connector) {\n return;\n }\n\n if (this.driver) {\n this.connector = this.driver.createConnector({ schema: this.getSchema() });\n return;\n }\n\n if (!this.client) {\n throw getError({\n message: `[${this.constructor.name}][wireDriverFromMetadata] No driver and no client | Assign this.client in configure(), or wire a custom driver with useDriver()`,\n });\n }\n\n const DriverClass = this.resolveDriverClass();\n this.useDriver({ driver: new DriverClass({ client: this.client }) });\n }\n\n /**\n * Rejects a driver-name string from untyped JS\n * callers: a string carries no module into the bundle.\n */\n protected resolveDriverClass(): TClass<TDriver> {\n const metadata = MetadataRegistry.getInstance().getDataSourceMetadata({\n target: this.constructor,\n });\n const driver = metadata?.driver;\n\n if (typeof driver !== 'function') {\n throw getError({\n message: `[${this.constructor.name}][resolveDriverClass] @datasource({ driver }) must name a driver CLASS | Got: ${String(driver)} | Use \\`@datasource({ driver: NodePostgresDriver })\\` with \\`import { NodePostgresDriver } from '@venizia/ignis-connectors/postgres/node-postgres'\\`, or wire a custom driver with useDriver()`,\n });\n }\n\n return driver as TClass<TDriver>;\n }\n\n protected resolveDriver(): TDriver {\n this.wireDriverFromMetadata();\n return this.driver as TDriver;\n }\n\n /**\n * Assigns `this.driver` AND builds `this.connector` in one step - a\n * driver without its connector is silently bypassed on pooled queries.\n */\n protected useDriver(opts: { driver: TDriver; schema?: Schema }): void {\n this.driver = opts.driver;\n this.connector = opts.driver.createConnector({ schema: opts.schema ?? this.getSchema() });\n }\n\n /** Wires the driver on first use, so a `configure()` that only builds `this.client` is enough. */\n getConnector(): TConnector {\n this.wireDriverFromMetadata();\n return this.connector;\n }\n\n /**\n * Raw driver client (`pg.Pool` / `Sql`). Throws rather\n * than handing back an `undefined` typed as `Client`.\n */\n getClient(): Client {\n if (this.driver) {\n return this.driver.getClient() as Client;\n }\n\n if (!this.client) {\n throw getError({\n message: `[${this.constructor.name}][getClient] No driver and no client | Assign this.driver in configure()`,\n });\n }\n\n return this.client;\n }\n\n /**\n * Ends the connection `configure()` opened. Runs once: every later call returns the first call's\n * promise. Goes through the driver, wired now if nothing queried yet, because its `end()` is the\n * engine's whole teardown - PGlite also clears the exit status it plants on the host process.\n */\n override close(): Promise<void> {\n this.closePromise ??= this.endConnection();\n return this.closePromise;\n }\n\n private async endConnection(): Promise<void> {\n if (!this.driver && this.client === undefined) {\n return;\n }\n\n let driver: TDriver;\n try {\n driver = this.resolveDriver();\n } catch (error) {\n this.logger\n .for(this.close.name)\n .warn('No driver to end the connection with | draining the client | error: %s', error);\n await this.drainClient({ client: this.client });\n return;\n }\n\n // A hand-made driver cast past `IConnectorDriver` can lack the `end()` its type promises.\n if (typeof driver.end !== 'function') {\n this.logger.for(this.close.name).warn('The driver has no end() | draining the client');\n await this.drainClient({ client: this.client });\n return;\n }\n\n await driver.end();\n }\n\n /**\n * Soft-evicts the pool after a secret rotation: rebuilds against the rotated credentials without\n * touching live fields, swaps atomically, then drains the old pool. On failure live state is\n * restored, any half-built pool drained, and the error rethrown.\n */\n async onSecretRotated(opts: { key: string; secret: Record<string, string> }): Promise<void> {\n const logger = this.logger.for(this.onSecretRotated.name);\n const oldClient = this.getClient() as AnyType;\n\n // Snapshot so a failed rebuild restores the datasource verbatim;\n // `settings` is copied because rotation mutates it in place.\n const savedClient = this.client;\n const savedSettings = { ...(this.settings as AnyObject) };\n\n // Rotation only takes effect through this.settings + configure(); a configure() that\n // hard-codes its connection string or reads Envs directly rebuilds with stale credentials.\n Object.assign(this.settings as AnyObject, this.mapSecretToSettings({ secret: opts.secret }));\n\n // configure() overwrites this.client, so the new pool is captured\n // into a local and the old client restored at once - live fields\n // are never nulled and the old pool keeps serving until the swap.\n let newClient: Client;\n try {\n await this.configure();\n newClient = this.client as Client;\n } catch (error) {\n const halfBuilt = this.client as AnyType;\n this.client = savedClient;\n this.restoreSettings({ saved: savedSettings });\n\n if (halfBuilt && halfBuilt !== savedClient) {\n await this.drainClient({ client: halfBuilt });\n }\n\n logger.error('Secret rotation failed in configure(); kept old pool | key: %s', opts.key);\n throw error;\n }\n\n this.client = savedClient;\n\n // Wired into locals: live state must stay on the old pool until the swap below.\n let newDriver: TDriver;\n let newConnector: TConnector;\n try {\n const DriverClass = this.resolveDriverClass();\n newDriver = new DriverClass({ client: newClient as AnyType });\n newConnector = newDriver.createConnector({ schema: this.getSchema() });\n } catch (error) {\n this.restoreSettings({ saved: savedSettings });\n await this.drainClient({ client: newClient });\n\n logger.error('Secret rotation failed while wiring driver; kept old pool | key: %s', opts.key);\n throw error;\n }\n\n // Commit the live fields in one synchronous step so there is no null window,\n // then soft-evict the old pool so its in-flight transactions can finish.\n this.client = newClient as AnyType;\n this.driver = newDriver;\n this.connector = newConnector as AnyType;\n\n const isDrained = await this.drainClient({ client: oldClient });\n if (isDrained) {\n logger.info('Old pool drained after secret rotation | key: %s', opts.key);\n }\n }\n\n /** Puts `settings` back to the snapshot: a key the failed rotation added (the rotated `password`) is removed, not left behind. */\n private restoreSettings(opts: { saved: AnyObject }): void {\n const settings = this.settings as AnyObject;\n\n for (const key of Object.keys(settings)) {\n if (!(key in opts.saved)) {\n delete settings[key];\n }\n }\n\n Object.assign(settings, opts.saved);\n }\n\n /**\n * Shuts a client down by whichever verb its engine spells it with -\n * `pg.Pool` and postgres.js have `end()`, PGlite and libsql only `close()`.\n * Probed rather than type-tested: this tier must not name an engine, and a\n * client left undrained keeps a WASM instance or file handle alive forever.\n */\n protected async drainClient(opts: { client: unknown }): Promise<boolean> {\n const client = opts.client as AnyType;\n\n const drain = typeof client?.end === 'function' ? client.end : client?.close;\n\n if (typeof drain !== 'function') {\n this.logger\n .for(this.drainClient.name)\n .warn('Client exposes neither end() nor close(); nothing to drain');\n return false;\n }\n\n await drain.call(client);\n\n return true;\n }\n\n /** Vault's database engine returns `{ username, password }`; pg expects `{ user, password }`. */\n protected mapSecretToSettings(opts: { secret: Record<string, string> }): AnyObject {\n const { username, password } = opts.secret;\n const mapped: AnyObject = {};\n\n if (username !== undefined) {\n mapped.user = username;\n }\n if (password !== undefined) {\n mapped.password = password;\n }\n\n return mapped;\n }\n}\n"]}
1
+ {"version":3,"file":"driver-data-source.js","sourceRoot":"","sources":["../../../src/common/driver-data-source.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';\nimport { AbstractDataSource } from '@venizia/ignis-kernel/repository';\nimport { MetadataRegistry } from '@venizia/ignis-kernel/metadata';\nimport type { AnyObject, AnyType, TClass } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { IConnectorDriver } from './driver';\n\n/**\n * A datasource that holds one client and a connector built over it through a driver: the lifecycle\n * every connector family that talks to an external engine shares - wiring the driver named by\n * `@datasource({ driver })`, closing once, soft-evicting the client after a secret rotation, draining\n * a client by whichever verb its engine spells it with. No SQL members: the relational family adds\n * its dialect, executor and transactions in `AbstractRelationalDataSource`, a raw-SQL engine adds\n * nothing (`BaseRawSqlDataSource`). Transactions stay NotSupported, as in `AbstractDataSource`.\n *\n * `mapSecretToSettings` is a driver-config convention, not Postgres SQL, so it belongs on this\n * neutral base - do not move it down into a family.\n */\nexport abstract class AbstractDriverDataSource<\n Settings extends object = {},\n Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema,\n ConfigurableOptions extends object = {},\n Client = unknown,\n TConnector = unknown,\n TDriver extends IConnectorDriver<TConnector, AnyType> = IConnectorDriver<TConnector, Client>,\n> extends AbstractDataSource<Settings, Schema, ConfigurableOptions> {\n connector: TConnector;\n\n protected client?: Client;\n protected driver?: TDriver;\n\n private closePromise?: Promise<void>;\n\n /**\n * Lazy and idempotent: builds the driver named by `@datasource({ driver })` over the client\n * `configure()` assigned, then the connector from it.\n */\n protected wireDriverFromMetadata(): void {\n if (this.connector) {\n return;\n }\n\n if (this.driver) {\n this.connector = this.driver.createConnector({ schema: this.getSchema() });\n return;\n }\n\n if (!this.client) {\n throw getError({\n message: `[${this.constructor.name}][wireDriverFromMetadata] No driver and no client | Assign this.client in configure(), or wire a custom driver with useDriver()`,\n });\n }\n\n const DriverClass = this.resolveDriverClass();\n this.useDriver({ driver: new DriverClass({ client: this.client }) });\n }\n\n /**\n * Rejects a driver-name string from untyped JS\n * callers: a string carries no module into the bundle.\n */\n protected resolveDriverClass(): TClass<TDriver> {\n const metadata = MetadataRegistry.getInstance().getDataSourceMetadata({\n target: this.constructor,\n });\n const driver = metadata?.driver;\n\n if (typeof driver !== 'function') {\n throw getError({\n message: `[${this.constructor.name}][resolveDriverClass] @datasource({ driver }) must name a driver CLASS | Got: ${String(driver)} | Use \\`@datasource({ driver: NodePostgresDriver })\\` with \\`import { NodePostgresDriver } from '@venizia/ignis-connectors/postgres/node-postgres'\\`, or wire a custom driver with useDriver()`,\n });\n }\n\n return driver as TClass<TDriver>;\n }\n\n protected resolveDriver(): TDriver {\n this.wireDriverFromMetadata();\n return this.driver as TDriver;\n }\n\n /**\n * Assigns `this.driver` AND builds `this.connector` in one step - a\n * driver without its connector is silently bypassed on pooled queries.\n */\n protected useDriver(opts: { driver: TDriver; schema?: Schema }): void {\n this.driver = opts.driver;\n this.connector = opts.driver.createConnector({ schema: opts.schema ?? this.getSchema() });\n }\n\n /** Wires the driver on first use, so a `configure()` that only builds `this.client` is enough. */\n getConnector(): TConnector {\n this.wireDriverFromMetadata();\n return this.connector;\n }\n\n /**\n * Raw driver client (`pg.Pool` / `Sql`). Throws rather\n * than handing back an `undefined` typed as `Client`.\n */\n getClient(): Client {\n if (this.driver) {\n return this.driver.getClient() as Client;\n }\n\n if (!this.client) {\n throw getError({\n message: `[${this.constructor.name}][getClient] No driver and no client | Assign this.driver in configure()`,\n });\n }\n\n return this.client;\n }\n\n /**\n * Ends the connection `configure()` opened. Runs once: every later call returns the first call's\n * promise. Goes through the driver, wired now if nothing queried yet, because its `end()` is the\n * engine's whole teardown - PGlite also clears the exit status it plants on the host process.\n */\n override close(): Promise<void> {\n this.closePromise ??= this.endConnection();\n return this.closePromise;\n }\n\n private async endConnection(): Promise<void> {\n if (!this.driver && this.client === undefined) {\n return;\n }\n\n let driver: TDriver;\n try {\n driver = this.resolveDriver();\n } catch (error) {\n this.logger\n .for(this.close.name)\n .warn('No driver to end the connection with | draining the client | error: %s', error);\n await this.drainClient({ client: this.client });\n return;\n }\n\n // A hand-made driver cast past `IConnectorDriver` can lack the `end()` its type promises.\n if (typeof driver.end !== 'function') {\n this.logger.for(this.close.name).warn('The driver has no end() | draining the client');\n await this.drainClient({ client: this.client });\n return;\n }\n\n await driver.end();\n }\n\n /**\n * Soft-evicts the pool after a secret rotation: rebuilds against the rotated credentials without\n * touching live fields, swaps atomically, then drains the old pool. On failure live state is\n * restored, any half-built pool drained, and the error rethrown.\n */\n async onSecretRotated(opts: { key: string; secret: Record<string, string> }): Promise<void> {\n const logger = this.logger.for(this.onSecretRotated.name);\n const oldClient = this.getClient() as AnyType;\n\n // Snapshot so a failed rebuild restores the datasource verbatim;\n // `settings` is copied because rotation mutates it in place.\n const savedClient = this.client;\n const savedSettings = { ...(this.settings as AnyObject) };\n\n // Rotation only takes effect through this.settings + configure(); a configure() that\n // hard-codes its connection string or reads the environment directly rebuilds with stale credentials.\n Object.assign(this.settings as AnyObject, this.mapSecretToSettings({ secret: opts.secret }));\n\n // configure() overwrites this.client, so the new pool is captured\n // into a local and the old client restored at once - live fields\n // are never nulled and the old pool keeps serving until the swap.\n let newClient: Client;\n try {\n await this.configure();\n newClient = this.client as Client;\n } catch (error) {\n const halfBuilt = this.client as AnyType;\n this.client = savedClient;\n this.restoreSettings({ saved: savedSettings });\n\n if (halfBuilt && halfBuilt !== savedClient) {\n await this.drainClient({ client: halfBuilt });\n }\n\n logger.error('Secret rotation failed in configure(); kept old pool | key: %s', opts.key);\n throw error;\n }\n\n this.client = savedClient;\n\n // Wired into locals: live state must stay on the old pool until the swap below.\n let newDriver: TDriver;\n let newConnector: TConnector;\n try {\n const DriverClass = this.resolveDriverClass();\n newDriver = new DriverClass({ client: newClient as AnyType });\n newConnector = newDriver.createConnector({ schema: this.getSchema() });\n } catch (error) {\n this.restoreSettings({ saved: savedSettings });\n await this.drainClient({ client: newClient });\n\n logger.error('Secret rotation failed while wiring driver; kept old pool | key: %s', opts.key);\n throw error;\n }\n\n // Commit the live fields in one synchronous step so there is no null window,\n // then soft-evict the old pool so its in-flight transactions can finish.\n this.client = newClient as AnyType;\n this.driver = newDriver;\n this.connector = newConnector as AnyType;\n\n const isDrained = await this.drainClient({ client: oldClient });\n if (isDrained) {\n logger.info('Old pool drained after secret rotation | key: %s', opts.key);\n }\n }\n\n /** Puts `settings` back to the snapshot: a key the failed rotation added (the rotated `password`) is removed, not left behind. */\n private restoreSettings(opts: { saved: AnyObject }): void {\n const settings = this.settings as AnyObject;\n\n for (const key of Object.keys(settings)) {\n if (!(key in opts.saved)) {\n delete settings[key];\n }\n }\n\n Object.assign(settings, opts.saved);\n }\n\n /**\n * Shuts a client down by whichever verb its engine spells it with -\n * `pg.Pool` and postgres.js have `end()`, PGlite and libsql only `close()`.\n * Probed rather than type-tested: this tier must not name an engine, and a\n * client left undrained keeps a WASM instance or file handle alive forever.\n */\n protected async drainClient(opts: { client: unknown }): Promise<boolean> {\n const client = opts.client as AnyType;\n\n const drain = typeof client?.end === 'function' ? client.end : client?.close;\n\n if (typeof drain !== 'function') {\n this.logger\n .for(this.drainClient.name)\n .warn('Client exposes neither end() nor close(); nothing to drain');\n return false;\n }\n\n await drain.call(client);\n\n return true;\n }\n\n /** Vault's database engine returns `{ username, password }`; pg expects `{ user, password }`. */\n protected mapSecretToSettings(opts: { secret: Record<string, string> }): AnyObject {\n const { username, password } = opts.secret;\n const mapped: AnyObject = {};\n\n if (username !== undefined) {\n mapped.user = username;\n }\n if (password !== undefined) {\n mapped.password = password;\n }\n\n return mapped;\n }\n}\n"]}
@@ -1,3 +1,2 @@
1
- export * from './guards.js';
2
1
  export * from './types.js';
3
2
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/datasources/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/datasources/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}
@@ -1,3 +1,2 @@
1
- export * from './guards.js';
2
1
  export * from './types.js';
3
2
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/datasources/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC","sourcesContent":["export * from './guards';\nexport * from './types';\n"]}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/datasources/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC","sourcesContent":["export * from './types';\n"]}
@@ -21,8 +21,29 @@ export interface ISearchConnectorCallbacks {
21
21
  error: unknown;
22
22
  }) => void;
23
23
  }
24
- /** Search-response envelope, read without a boundary cast. `score` scales are unrelated across engines - never compare or threshold one against another; `isFoundExact` is false when `found` is approximate. */
25
- export interface ISearchResult<DocumentType extends object = object, HighlightType = unknown, FacetCountType = unknown, GroupedHitType = unknown> {
24
+ /** One value of a facet: how many matching documents carry it. `value` is always a string, numbers included, as the engine sends it. */
25
+ export interface ISearchFacetValue {
26
+ value: string;
27
+ count: number;
28
+ highlighted?: string;
29
+ }
30
+ /** Numeric statistics an engine reports for a numeric facet field; only the members the engine returned are set. */
31
+ export interface ISearchFacetStats {
32
+ avg?: number;
33
+ max?: number;
34
+ min?: number;
35
+ sum?: number;
36
+ totalValues?: number;
37
+ }
38
+ /** The counts of one faceted field. `sampled` is set when the engine counted a sample of the matches instead of all of them. */
39
+ export interface ISearchFacetCount {
40
+ fieldName: string;
41
+ counts: ISearchFacetValue[];
42
+ sampled?: boolean;
43
+ stats?: ISearchFacetStats;
44
+ }
45
+ /** Search-response envelope, read without a boundary cast. `score` scales are unrelated across engines - never compare or threshold one against another; `isFoundExact` is false when `found` is approximate. A hit's `score` is the keyword match score in every mode, hybrid included; `rankFusionScore` and `vectorDistance` are the hybrid and vector scores, set only by an engine that reports them. */
46
+ export interface ISearchResult<DocumentType extends object = object, HighlightType = unknown, FacetCountType = ISearchFacetCount, GroupedHitType = unknown> {
26
47
  found: number;
27
48
  isFoundExact: boolean;
28
49
  outOf?: number;
@@ -32,6 +53,8 @@ export interface ISearchResult<DocumentType extends object = object, HighlightTy
32
53
  highlight?: HighlightType;
33
54
  highlights?: HighlightType[];
34
55
  score?: number;
56
+ rankFusionScore?: number;
57
+ vectorDistance?: number;
35
58
  }>;
36
59
  facetCounts?: FacetCountType[];
37
60
  groupedHits?: GroupedHitType[];
@@ -1 +1 @@
1
- {"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../../src/search/core/connector.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../../src/search/core/connector.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../../src/search/core/connector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AA8IrD,MAAM,OAAgB,mBAAoB,SAAQ,UAAU;IAC1D,YAAY,IAA2C;QACrD,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,EAAE,CAAC;IACnB,CAAC;IAES,cAAc,CAAC,IAA6D;QACpF,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACrC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,MAAM,oCAAoC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,gHAAgH;IACtG,KAAK,CAAC,aAAa,CAAI,IAIhC;QACC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,GAAG,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxC,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,0JAA0J;YAC1J,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,uBAAuB,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAKD,2IAA2I;IACjI,iBAAiB,CAAC,IAAyC;QAInE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEjC,OAAO;YACL,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAChD,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;gBACvD,uBAAuB,CAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAClE,CAAC;SACF,CAAC;IACJ,CAAC;IAED,sKAAsK;IAC5J,gBAAgB,CAAI,IAK7B;QACC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEjD,OAAO;YACL,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAChD,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;gBACxD,OAAO,QAAQ,CAAC;YAClB,CAAC;SACF,CAAC;IACJ,CAAC;CAkBF","sourcesContent":["import type { ISynonym } from '@/search/core/models';\nimport type { ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError, isApplicationError } from '@venizia/ignis-helpers/core';\nimport { SearchConnectorInternal } from './internal';\n\nexport interface IImportResult<TResponse = unknown> {\n count: { success: number; fail: number };\n responses: TResponse[];\n}\n\nexport interface IAliasInfo {\n name: string;\n collection: string;\n}\n\nexport interface ISearchConnectorCallbacks {\n onInitialized?: (opts: { name: string }) => void;\n onError?: (opts: { name: string; error: unknown }) => void;\n}\n\n/** Search-response envelope, read without a boundary cast. `score` scales are unrelated across engines - never compare or threshold one against another; `isFoundExact` is false when `found` is approximate. */\nexport interface ISearchResult<\n DocumentType extends object = object,\n HighlightType = unknown,\n FacetCountType = unknown,\n GroupedHitType = unknown,\n> {\n found: number;\n isFoundExact: boolean;\n outOf?: number;\n searchTimeMs?: number;\n hits?: Array<{\n document: DocumentType;\n highlight?: HighlightType;\n highlights?: HighlightType[];\n score?: number;\n }>;\n facetCounts?: FacetCountType[];\n groupedHits?: GroupedHitType[];\n}\n\n// Schema/field types are engine-specific, not caller-owned - hence interface-level generics filled by the engine's connector, defaulting to `unknown` so `ISearchConnector` stays engine-agnostic.\nexport interface ISearchCollectionScoped<\n CreateSchema = unknown,\n Schema = unknown,\n FieldSchema = unknown,\n> {\n create(opts: { schema: CreateSchema }): Promise<Schema | void>;\n ensure(opts: { schema: CreateSchema }): Promise<Schema>;\n get(opts: { name: string }): Promise<Schema>;\n list(): Promise<Schema[]>;\n exists(opts: { name: string }): Promise<boolean>;\n patchSchema(opts: { name: string; fields: FieldSchema[] }): Promise<void>;\n delete(opts: { name: string }): Promise<boolean>;\n}\n\n/** A named pointer to one physical collection. Engines without aliases omit this group entirely. */\nexport interface ISearchAliasScoped {\n upsert(opts: { name: string; collection: string }): Promise<void>;\n get(opts: { name: string }): Promise<IAliasInfo | null>;\n}\n\n/** Atomic exchange of two collections' documents and settings - the alias-less path to a zero-downtime reindex. */\nexport interface ISearchSwapScoped {\n indexes(opts: { pairs: Array<[string, string]> }): Promise<void>;\n}\n\n// Synonym SETS (Typesense v30+): a named item set linked to one or more collections; `ISynonym` is the item shape.\nexport interface ISearchSynonymSetScoped {\n upsert(opts: { name: string; items: ISynonym[] }): Promise<void>;\n get(opts: { name: string }): Promise<ISynonym[] | null>;\n list(): Promise<string[]>;\n delete(opts: { name: string }): Promise<boolean>;\n link(opts: { collection: string; synonymSets: string[] }): Promise<void>;\n}\n\n/** A flat per-collection synonym dictionary - no named, linkable set resource. */\nexport interface ISearchSynonymScoped {\n set(opts: { collection: string; items: ISynonym[] }): Promise<void>;\n get(opts: { collection: string }): Promise<ISynonym[]>;\n reset(opts: { collection: string }): Promise<void>;\n}\n\nexport interface ISearchDocumentScoped {\n get<T extends object>(opts: { collection: string; id: string }): Promise<T>;\n\n /** Exact count of documents matching `filterBy`. Engines whose search endpoint caps or estimates its total must answer from a document-listing endpoint instead. */\n count(opts: { collection: string; filterBy?: string }): Promise<number>;\n\n create<T extends object>(opts: { collection: string; document: T }): Promise<T>;\n\n upsert<T extends object>(opts: { collection: string; document: T }): Promise<T>;\n update<T extends object>(opts: {\n collection: string;\n id: string;\n document: Partial<T>;\n }): Promise<T>;\n updateBy<T extends object>(opts: {\n collection: string;\n document: Partial<T>;\n filterBy: string;\n }): Promise<{ updatedCount: number }>;\n\n delete(opts: { collection: string; id: string }): Promise<boolean>;\n deleteBy(opts: { collection: string; filterBy: string }): Promise<number>;\n deleteAll(opts: { collection: string }): Promise<boolean>;\n\n import<T extends object>(opts: {\n collection: string;\n documents: T[];\n batchSize?: number;\n }): Promise<IImportResult<unknown>>;\n export(opts: {\n collection: string;\n filterBy?: string;\n includeFields?: string[];\n }): Promise<string>;\n}\n\n/** The verb contract every search engine implements - an interface so tests can fake it clientless. `collection`/`document` are the true intersection; `alias`/`synonymSet`/`synonyms`/`swap` are optional since no engine has all four, so agnostic callers must write `connector.alias?.…`. */\nexport interface ISearchConnector {\n getHealth(): Promise<{ ok: boolean }>;\n ping(): Promise<boolean>;\n\n collection: ISearchCollectionScoped;\n document: ISearchDocumentScoped;\n\n alias?: ISearchAliasScoped;\n synonymSet?: ISearchSynonymSetScoped;\n synonyms?: ISearchSynonymScoped;\n swap?: ISearchSwapScoped;\n\n search<TDocument extends object = object>(opts: {\n collection: string;\n params: unknown;\n }): Promise<ISearchResult<TDocument>>;\n\n multiSearch(opts: {\n searches: unknown[];\n union?: boolean;\n commonParams?: unknown;\n options?: unknown;\n }): Promise<unknown>;\n}\n\nexport abstract class BaseSearchConnector extends BaseHelper implements ISearchConnector {\n constructor(opts: { scope: string; identifier: string }) {\n super(opts);\n }\n\n async ping(): Promise<boolean> {\n const health = await this.getHealth();\n return health.ok;\n }\n\n protected assertNonEmpty(opts: { value?: string | null; name: string; method: string }): void {\n const { value, name, method } = opts;\n if (!value || value.trim().length === 0) {\n throw getError({ message: `[${method}] Missing or empty value | name: ${name}` });\n }\n }\n\n // Runs the engine verb; tolerated errors route to the caller's branch, everything else becomes a sanitized 503.\n protected async runEngineCall<T>(opts: {\n method: string;\n run: () => ValueOrPromise<T>;\n tolerate?: { when: (error: unknown) => boolean; handle: (error: unknown) => ValueOrPromise<T> };\n }) {\n const { method, run, tolerate } = opts;\n\n try {\n const rs = await run();\n return rs;\n } catch (error) {\n if (tolerate?.when(error)) {\n const rs = await tolerate.handle(error);\n return rs;\n }\n\n // A framework ApplicationError is already sanitized and carries its own statusCode/messageCode; only raw engine failures may be wrapped as a generic 503.\n if (isApplicationError(error)) {\n throw error;\n }\n\n SearchConnectorInternal.wrapDependencyError({ method, error, logger: this.logger });\n }\n }\n\n /** Which errors mean \"not found\" is engine-specific classification; the sanitized throw and the benign fallback are not. */\n protected abstract isNotFoundError(opts: { error: unknown }): boolean;\n\n /** Tolerated-404 branch shared by getCollection/patchCollectionSchema/getDocument/updateDocument: throws the sanitized not-found error. */\n protected notFoundTolerance(opts: { method: string; subject: string }): {\n when: (error: unknown) => boolean;\n handle: (error: unknown) => never;\n } {\n const { method, subject } = opts;\n\n return {\n when: (error) => this.isNotFoundError({ error }),\n handle: () => {\n this.logger.for(method).debug('%s not found', subject);\n SearchConnectorInternal.throwNotFoundError({ method, subject });\n },\n };\n }\n\n /** Tolerated-404 branch shared by deleteCollection/getAlias/getSynonymSet/deleteSynonymSet/deleteDocument: logs and returns a benign sentinel instead of throwing. */\n protected notFoundFallback<T>(opts: {\n method: string;\n message: string;\n args?: unknown[];\n fallback: T;\n }): { when: (error: unknown) => boolean; handle: (error: unknown) => T } {\n const { method, message, args, fallback } = opts;\n\n return {\n when: (error) => this.isNotFoundError({ error }),\n handle: () => {\n this.logger.for(method).debug(message, ...(args ?? []));\n return fallback;\n },\n };\n }\n\n abstract getHealth(): Promise<{ ok: boolean }>;\n\n // Resource-scoped verb groups, each supplied by the concrete connector as a facade object; only the intersection is abstract - an engine declares its own alias/synonymSet/synonyms/swap.\n abstract collection: ISearchCollectionScoped;\n abstract document: ISearchDocumentScoped;\n\n abstract search<TDocument extends object = object>(opts: {\n collection: string;\n params: unknown;\n }): Promise<ISearchResult<TDocument>>;\n\n abstract multiSearch(opts: {\n searches: unknown[];\n union?: boolean;\n commonParams?: unknown;\n }): Promise<unknown>;\n}\n"]}
1
+ {"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../../src/search/core/connector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAwKrD,MAAM,OAAgB,mBAAoB,SAAQ,UAAU;IAC1D,YAAY,IAA2C;QACrD,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,EAAE,CAAC;IACnB,CAAC;IAES,cAAc,CAAC,IAA6D;QACpF,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACrC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,MAAM,oCAAoC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,gHAAgH;IACtG,KAAK,CAAC,aAAa,CAAI,IAIhC;QACC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,GAAG,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxC,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,0JAA0J;YAC1J,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,uBAAuB,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAKD,2IAA2I;IACjI,iBAAiB,CAAC,IAAyC;QAInE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEjC,OAAO;YACL,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAChD,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;gBACvD,uBAAuB,CAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAClE,CAAC;SACF,CAAC;IACJ,CAAC;IAED,sKAAsK;IAC5J,gBAAgB,CAAI,IAK7B;QACC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEjD,OAAO;YACL,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAChD,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;gBACxD,OAAO,QAAQ,CAAC;YAClB,CAAC;SACF,CAAC;IACJ,CAAC;CAkBF","sourcesContent":["import type { ISynonym } from '@/search/core/models';\nimport type { ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError, isApplicationError } from '@venizia/ignis-helpers/core';\nimport { SearchConnectorInternal } from './internal';\n\nexport interface IImportResult<TResponse = unknown> {\n count: { success: number; fail: number };\n responses: TResponse[];\n}\n\nexport interface IAliasInfo {\n name: string;\n collection: string;\n}\n\nexport interface ISearchConnectorCallbacks {\n onInitialized?: (opts: { name: string }) => void;\n onError?: (opts: { name: string; error: unknown }) => void;\n}\n\n/** One value of a facet: how many matching documents carry it. `value` is always a string, numbers included, as the engine sends it. */\nexport interface ISearchFacetValue {\n value: string;\n count: number;\n highlighted?: string;\n}\n\n/** Numeric statistics an engine reports for a numeric facet field; only the members the engine returned are set. */\nexport interface ISearchFacetStats {\n avg?: number;\n max?: number;\n min?: number;\n sum?: number;\n totalValues?: number;\n}\n\n/** The counts of one faceted field. `sampled` is set when the engine counted a sample of the matches instead of all of them. */\nexport interface ISearchFacetCount {\n fieldName: string;\n counts: ISearchFacetValue[];\n sampled?: boolean;\n stats?: ISearchFacetStats;\n}\n\n/** Search-response envelope, read without a boundary cast. `score` scales are unrelated across engines - never compare or threshold one against another; `isFoundExact` is false when `found` is approximate. A hit's `score` is the keyword match score in every mode, hybrid included; `rankFusionScore` and `vectorDistance` are the hybrid and vector scores, set only by an engine that reports them. */\nexport interface ISearchResult<\n DocumentType extends object = object,\n HighlightType = unknown,\n FacetCountType = ISearchFacetCount,\n GroupedHitType = unknown,\n> {\n found: number;\n isFoundExact: boolean;\n outOf?: number;\n searchTimeMs?: number;\n hits?: Array<{\n document: DocumentType;\n highlight?: HighlightType;\n highlights?: HighlightType[];\n score?: number;\n rankFusionScore?: number;\n vectorDistance?: number;\n }>;\n facetCounts?: FacetCountType[];\n groupedHits?: GroupedHitType[];\n}\n\n// Schema/field types are engine-specific, not caller-owned - hence interface-level generics filled by the engine's connector, defaulting to `unknown` so `ISearchConnector` stays engine-agnostic.\nexport interface ISearchCollectionScoped<\n CreateSchema = unknown,\n Schema = unknown,\n FieldSchema = unknown,\n> {\n create(opts: { schema: CreateSchema }): Promise<Schema | void>;\n ensure(opts: { schema: CreateSchema }): Promise<Schema>;\n get(opts: { name: string }): Promise<Schema>;\n list(): Promise<Schema[]>;\n exists(opts: { name: string }): Promise<boolean>;\n patchSchema(opts: { name: string; fields: FieldSchema[] }): Promise<void>;\n delete(opts: { name: string }): Promise<boolean>;\n}\n\n/** A named pointer to one physical collection. Engines without aliases omit this group entirely. */\nexport interface ISearchAliasScoped {\n upsert(opts: { name: string; collection: string }): Promise<void>;\n get(opts: { name: string }): Promise<IAliasInfo | null>;\n}\n\n/** Atomic exchange of two collections' documents and settings - the alias-less path to a zero-downtime reindex. */\nexport interface ISearchSwapScoped {\n indexes(opts: { pairs: Array<[string, string]> }): Promise<void>;\n}\n\n// Synonym SETS (Typesense v30+): a named item set linked to one or more collections; `ISynonym` is the item shape.\nexport interface ISearchSynonymSetScoped {\n upsert(opts: { name: string; items: ISynonym[] }): Promise<void>;\n get(opts: { name: string }): Promise<ISynonym[] | null>;\n list(): Promise<string[]>;\n delete(opts: { name: string }): Promise<boolean>;\n link(opts: { collection: string; synonymSets: string[] }): Promise<void>;\n}\n\n/** A flat per-collection synonym dictionary - no named, linkable set resource. */\nexport interface ISearchSynonymScoped {\n set(opts: { collection: string; items: ISynonym[] }): Promise<void>;\n get(opts: { collection: string }): Promise<ISynonym[]>;\n reset(opts: { collection: string }): Promise<void>;\n}\n\nexport interface ISearchDocumentScoped {\n get<T extends object>(opts: { collection: string; id: string }): Promise<T>;\n\n /** Exact count of documents matching `filterBy`. Engines whose search endpoint caps or estimates its total must answer from a document-listing endpoint instead. */\n count(opts: { collection: string; filterBy?: string }): Promise<number>;\n\n create<T extends object>(opts: { collection: string; document: T }): Promise<T>;\n\n upsert<T extends object>(opts: { collection: string; document: T }): Promise<T>;\n update<T extends object>(opts: {\n collection: string;\n id: string;\n document: Partial<T>;\n }): Promise<T>;\n updateBy<T extends object>(opts: {\n collection: string;\n document: Partial<T>;\n filterBy: string;\n }): Promise<{ updatedCount: number }>;\n\n delete(opts: { collection: string; id: string }): Promise<boolean>;\n deleteBy(opts: { collection: string; filterBy: string }): Promise<number>;\n deleteAll(opts: { collection: string }): Promise<boolean>;\n\n import<T extends object>(opts: {\n collection: string;\n documents: T[];\n batchSize?: number;\n }): Promise<IImportResult<unknown>>;\n export(opts: {\n collection: string;\n filterBy?: string;\n includeFields?: string[];\n }): Promise<string>;\n}\n\n/** The verb contract every search engine implements - an interface so tests can fake it clientless. `collection`/`document` are the true intersection; `alias`/`synonymSet`/`synonyms`/`swap` are optional since no engine has all four, so agnostic callers must write `connector.alias?.…`. */\nexport interface ISearchConnector {\n getHealth(): Promise<{ ok: boolean }>;\n ping(): Promise<boolean>;\n\n collection: ISearchCollectionScoped;\n document: ISearchDocumentScoped;\n\n alias?: ISearchAliasScoped;\n synonymSet?: ISearchSynonymSetScoped;\n synonyms?: ISearchSynonymScoped;\n swap?: ISearchSwapScoped;\n\n search<TDocument extends object = object>(opts: {\n collection: string;\n params: unknown;\n }): Promise<ISearchResult<TDocument>>;\n\n multiSearch(opts: {\n searches: unknown[];\n union?: boolean;\n commonParams?: unknown;\n options?: unknown;\n }): Promise<unknown>;\n}\n\nexport abstract class BaseSearchConnector extends BaseHelper implements ISearchConnector {\n constructor(opts: { scope: string; identifier: string }) {\n super(opts);\n }\n\n async ping(): Promise<boolean> {\n const health = await this.getHealth();\n return health.ok;\n }\n\n protected assertNonEmpty(opts: { value?: string | null; name: string; method: string }): void {\n const { value, name, method } = opts;\n if (!value || value.trim().length === 0) {\n throw getError({ message: `[${method}] Missing or empty value | name: ${name}` });\n }\n }\n\n // Runs the engine verb; tolerated errors route to the caller's branch, everything else becomes a sanitized 503.\n protected async runEngineCall<T>(opts: {\n method: string;\n run: () => ValueOrPromise<T>;\n tolerate?: { when: (error: unknown) => boolean; handle: (error: unknown) => ValueOrPromise<T> };\n }) {\n const { method, run, tolerate } = opts;\n\n try {\n const rs = await run();\n return rs;\n } catch (error) {\n if (tolerate?.when(error)) {\n const rs = await tolerate.handle(error);\n return rs;\n }\n\n // A framework ApplicationError is already sanitized and carries its own statusCode/messageCode; only raw engine failures may be wrapped as a generic 503.\n if (isApplicationError(error)) {\n throw error;\n }\n\n SearchConnectorInternal.wrapDependencyError({ method, error, logger: this.logger });\n }\n }\n\n /** Which errors mean \"not found\" is engine-specific classification; the sanitized throw and the benign fallback are not. */\n protected abstract isNotFoundError(opts: { error: unknown }): boolean;\n\n /** Tolerated-404 branch shared by getCollection/patchCollectionSchema/getDocument/updateDocument: throws the sanitized not-found error. */\n protected notFoundTolerance(opts: { method: string; subject: string }): {\n when: (error: unknown) => boolean;\n handle: (error: unknown) => never;\n } {\n const { method, subject } = opts;\n\n return {\n when: (error) => this.isNotFoundError({ error }),\n handle: () => {\n this.logger.for(method).debug('%s not found', subject);\n SearchConnectorInternal.throwNotFoundError({ method, subject });\n },\n };\n }\n\n /** Tolerated-404 branch shared by deleteCollection/getAlias/getSynonymSet/deleteSynonymSet/deleteDocument: logs and returns a benign sentinel instead of throwing. */\n protected notFoundFallback<T>(opts: {\n method: string;\n message: string;\n args?: unknown[];\n fallback: T;\n }): { when: (error: unknown) => boolean; handle: (error: unknown) => T } {\n const { method, message, args, fallback } = opts;\n\n return {\n when: (error) => this.isNotFoundError({ error }),\n handle: () => {\n this.logger.for(method).debug(message, ...(args ?? []));\n return fallback;\n },\n };\n }\n\n abstract getHealth(): Promise<{ ok: boolean }>;\n\n // Resource-scoped verb groups, each supplied by the concrete connector as a facade object; only the intersection is abstract - an engine declares its own alias/synonymSet/synonyms/swap.\n abstract collection: ISearchCollectionScoped;\n abstract document: ISearchDocumentScoped;\n\n abstract search<TDocument extends object = object>(opts: {\n collection: string;\n params: unknown;\n }): Promise<ISearchResult<TDocument>>;\n\n abstract multiSearch(opts: {\n searches: unknown[];\n union?: boolean;\n commonParams?: unknown;\n }): Promise<unknown>;\n}\n"]}
@@ -94,6 +94,7 @@ export declare class SearchControllerFactory extends BaseHelper {
94
94
  mode: z.ZodLiteral<"keyword">;
95
95
  query: z.ZodOptional<z.ZodString>;
96
96
  queryBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
97
+ highlight: z.ZodOptional<z.ZodBoolean>;
97
98
  filter: z.ZodOptional<z.ZodObject<{
98
99
  where: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>>;
99
100
  fields: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodBoolean>, z.ZodArray<z.ZodString>]>>;
@@ -1 +1 @@
1
- {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../src/search/core/controllers/factory.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../src/search/core/controllers/factory.ts"],"names":[],"mappings":"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"}
@@ -1,9 +1,28 @@
1
1
  import type { ILogger } from '@venizia/ignis-helpers/core';
2
+ import type { ApplicationError } from '@venizia/ignis-helpers/core';
2
3
  /** Engine-agnostic error plumbing shared by every search connector; backend-specific classification (what counts as 404/409) lives in each backend's own internal helper. */
3
4
  export declare class SearchConnectorInternal {
4
5
  static describeError(opts: {
5
6
  error: unknown;
6
7
  }): unknown;
8
+ /** The HTTP status an engine error carries, from whichever shape holds it: `httpStatus` (typesense-js) or `response.status` (the Meilisearch SDK). `undefined` for a transport failure (connect, DNS, timeout), which has none. */
9
+ static readHttpStatus(opts: {
10
+ error: unknown;
11
+ }): number | undefined;
12
+ /** The message the engine answered with, `undefined` when it sent none. */
13
+ static readEngineMessage(opts: {
14
+ error: unknown;
15
+ }): string | undefined;
16
+ /**
17
+ * The caller's own mistake, as the engine answered it: a 400 or 422 (the request is malformed or unprocessable), a 404
18
+ * that no verb tolerated, a 409 (a conflict). Anything else - a 5xx, a 401/403 (this server's credentials are wrong, not
19
+ * the caller's request), a 408 or 429 (try again later) - is not the caller's fault and stays a dependency failure.
20
+ */
21
+ static getClientError(opts: {
22
+ method: string;
23
+ error: unknown;
24
+ details?: Record<string, unknown>;
25
+ }): ApplicationError | undefined;
7
26
  static wrapDependencyError(opts: {
8
27
  method: string;
9
28
  error: unknown;
@@ -1 +1 @@
1
- {"version":3,"file":"search-connector-internal.d.ts","sourceRoot":"","sources":["../../../../../src/search/core/internal/search-connector-internal.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAI3D,6KAA6K;AAC7K,qBAAa,uBAAuB;IAElC,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;IAMvD,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE;QAC/B,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,GAAG,KAAK;IAuBT,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK;CAQ5E"}
1
+ {"version":3,"file":"search-connector-internal.d.ts","sourceRoot":"","sources":["../../../../../src/search/core/internal/search-connector-internal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAIpE,6KAA6K;AAC7K,qBAAa,uBAAuB;IAElC,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;IAKvD,mOAAmO;IACnO,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,GAAG,SAAS;IAiBnE,2EAA2E;IAC3E,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,GAAG,SAAS;IAmBtE;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE;QAC1B,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,GAAG,gBAAgB,GAAG,SAAS;IAsChC,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE;QAC/B,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,GAAG,KAAK;IA6BT,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK;CAQ5E"}
@@ -1,3 +1,4 @@
1
+ import { RecordUtility } from '../../../common/internal/index.js';
1
2
  import { SearchErrorCodes } from '@venizia/ignis-kernel/repository';
2
3
  import { SearchErrors } from '../common/index.js';
3
4
  import { getError } from '@venizia/ignis-helpers/core';
@@ -9,12 +10,82 @@ export class SearchConnectorInternal {
9
10
  const { error } = opts;
10
11
  return error instanceof Error ? (error.stack ?? error.message) : error;
11
12
  }
12
- // Logs the full error internally, throws a sanitized 503 with zero internal leakage; `details` is caller-actionable progress info (counts, offsets) only, never engine detail.
13
+ /** The HTTP status an engine error carries, from whichever shape holds it: `httpStatus` (typesense-js) or `response.status` (the Meilisearch SDK). `undefined` for a transport failure (connect, DNS, timeout), which has none. */
14
+ static readHttpStatus(opts) {
15
+ const { error } = opts;
16
+ if (!RecordUtility.isRecord(error)) {
17
+ return undefined;
18
+ }
19
+ if (typeof error['httpStatus'] === 'number') {
20
+ return error['httpStatus'];
21
+ }
22
+ const response = error['response'];
23
+ return RecordUtility.isRecord(response) && typeof response['status'] === 'number'
24
+ ? response['status']
25
+ : undefined;
26
+ }
27
+ /** The message the engine answered with, `undefined` when it sent none. */
28
+ static readEngineMessage(opts) {
29
+ const { error } = opts;
30
+ if (!RecordUtility.isRecord(error)) {
31
+ return undefined;
32
+ }
33
+ const message = error['message'];
34
+ if (typeof message === 'string' && message.trim() !== '') {
35
+ return message;
36
+ }
37
+ const cause = error['cause'];
38
+ const causeMessage = RecordUtility.isRecord(cause) ? cause['message'] : undefined;
39
+ return typeof causeMessage === 'string' && causeMessage.trim() !== ''
40
+ ? causeMessage
41
+ : undefined;
42
+ }
43
+ /**
44
+ * The caller's own mistake, as the engine answered it: a 400 or 422 (the request is malformed or unprocessable), a 404
45
+ * that no verb tolerated, a 409 (a conflict). Anything else - a 5xx, a 401/403 (this server's credentials are wrong, not
46
+ * the caller's request), a 408 or 429 (try again later) - is not the caller's fault and stays a dependency failure.
47
+ */
48
+ static getClientError(opts) {
49
+ const { method, error, details } = opts;
50
+ const status = SearchConnectorInternal.readHttpStatus({ error });
51
+ const engineMessage = SearchConnectorInternal.readEngineMessage({ error });
52
+ const extra = details ? { extra: { details } } : {};
53
+ const text = engineMessage ? ` ${engineMessage}` : '';
54
+ if (status === HTTP.ResultCodes.RS_4.NotFound) {
55
+ return getError({
56
+ error: SearchErrors.NOT_FOUND,
57
+ message: `[${method}] Not found in the search engine.${text}`,
58
+ ...extra,
59
+ });
60
+ }
61
+ if (status === HTTP.ResultCodes.RS_4.Conflict) {
62
+ return getError({
63
+ error: SearchErrors.ALREADY_EXISTS,
64
+ message: `[${method}] The search engine reports a conflict.${text}`,
65
+ ...extra,
66
+ });
67
+ }
68
+ if (status === HTTP.ResultCodes.RS_4.BadRequest ||
69
+ status === HTTP.ResultCodes.RS_4.UnprocessableEntity) {
70
+ return getError({
71
+ statusCode: status,
72
+ message: `[${method}] The search engine rejected the request.${text}`,
73
+ ...extra,
74
+ });
75
+ }
76
+ return undefined;
77
+ }
78
+ // Logs the full error internally and throws. An engine 400, 404, 409 or 422 is the caller's own mistake: it throws the matching 4xx with the engine's message kept, so a retry loop does not retry it. Every other failure (transport, 5xx, auth, rate limit) throws a sanitized 503 with zero internal leakage. `details` is caller-actionable progress info (counts, offsets) only, never engine detail.
13
79
  static wrapDependencyError(opts) {
14
80
  const { method, error, logger, details } = opts;
15
81
  logger
16
82
  .for(method)
17
83
  .error('Search engine dependency error | detail: %s', SearchConnectorInternal.describeError({ error }));
84
+ const clientError = SearchConnectorInternal.getClientError({ method, error, details });
85
+ if (clientError) {
86
+ Reflect.set(clientError, 'cause', error);
87
+ throw clientError;
88
+ }
18
89
  const wrapped = getError({
19
90
  statusCode: HTTP.ResultCodes.RS_5.ServiceUnavailable,
20
91
  messageCode: SearchErrorCodes.DEPENDENCY_UNAVAILABLE,
@@ -1 +1 @@
1
- {"version":3,"file":"search-connector-internal.js","sourceRoot":"","sources":["../../../../../src/search/core/internal/search-connector-internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAErD,6KAA6K;AAC7K,MAAM,OAAO,uBAAuB;IAClC,2GAA2G;IAC3G,MAAM,CAAC,aAAa,CAAC,IAAwB;QAC3C,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACzE,CAAC;IAED,+KAA+K;IAC/K,MAAM,CAAC,mBAAmB,CAAC,IAK1B;QACC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEhD,MAAM;aACH,GAAG,CAAC,MAAM,CAAC;aACX,KAAK,CACJ,6CAA6C,EAC7C,uBAAuB,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,CAAC,CACjD,CAAC;QAEJ,MAAM,OAAO,GAAG,QAAQ,CAAC;YACvB,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,kBAAkB;YACpD,WAAW,EAAE,gBAAgB,CAAC,sBAAsB;YACpD,OAAO,EAAE,IAAI,MAAM,6CAA6C;YAChE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3C,CAAC,CAAC;QAEH,yPAAyP;QACxP,OAA+B,CAAC,KAAK,GAAG,KAAK,CAAC;QAC/C,MAAM,OAAO,CAAC;IAChB,CAAC;IAED,2GAA2G;IAC3G,MAAM,CAAC,kBAAkB,CAAC,IAAyC;QACjE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEjC,MAAM,QAAQ,CAAC;YACb,KAAK,EAAE,YAAY,CAAC,SAAS;YAC7B,OAAO,EAAE,IAAI,MAAM,KAAK,OAAO,aAAa;SAC7C,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { SearchErrorCodes } from '@venizia/ignis-kernel/repository';\nimport { SearchErrors } from '@/search/core/common';\nimport type { ILogger } from '@venizia/ignis-helpers/core';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { HTTP } from '@venizia/ignis-helpers/common';\n\n/** Engine-agnostic error plumbing shared by every search connector; backend-specific classification (what counts as 404/409) lives in each backend's own internal helper. */\nexport class SearchConnectorInternal {\n // Error/stack are non-enumerable, so `%j` on a raw Error yields `{}` - extract them so logs retain detail.\n static describeError(opts: { error: unknown }): unknown {\n const { error } = opts;\n return error instanceof Error ? (error.stack ?? error.message) : error;\n }\n\n // Logs the full error internally, throws a sanitized 503 with zero internal leakage; `details` is caller-actionable progress info (counts, offsets) only, never engine detail.\n static wrapDependencyError(opts: {\n method: string;\n error: unknown;\n logger: ILogger;\n details?: Record<string, unknown>;\n }): never {\n const { method, error, logger, details } = opts;\n\n logger\n .for(method)\n .error(\n 'Search engine dependency error | detail: %s',\n SearchConnectorInternal.describeError({ error }),\n );\n\n const wrapped = getError({\n statusCode: HTTP.ResultCodes.RS_5.ServiceUnavailable,\n messageCode: SearchErrorCodes.DEPENDENCY_UNAVAILABLE,\n message: `[${method}] Search engine is temporarily unavailable.`,\n ...(details ? { extra: { details } } : {}),\n });\n\n // Keeps the engine's own code for callers to classify on (tolerating `index_already_exists`); assigned AFTER construction because `cause` via getError() lands in `extra`, which goes on the WIRE, while a plain `cause` is exposed only in development.\n (wrapped as { cause?: unknown }).cause = error;\n throw wrapped;\n }\n\n // Throws a sanitized 404; `subject` must only contain caller-provided identifiers, never engine internals.\n static throwNotFoundError(opts: { method: string; subject: string }): never {\n const { method, subject } = opts;\n\n throw getError({\n error: SearchErrors.NOT_FOUND,\n message: `[${method}] ${subject} not found.`,\n });\n }\n}\n"]}
1
+ {"version":3,"file":"search-connector-internal.js","sourceRoot":"","sources":["../../../../../src/search/core/internal/search-connector-internal.ts"],"names":[],"mappings":"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","sourcesContent":["import { RecordUtility } from '@/common/internal';\nimport { SearchErrorCodes } from '@venizia/ignis-kernel/repository';\nimport { SearchErrors } from '@/search/core/common';\nimport type { ILogger } from '@venizia/ignis-helpers/core';\nimport type { ApplicationError } from '@venizia/ignis-helpers/core';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { HTTP } from '@venizia/ignis-helpers/common';\n\n/** Engine-agnostic error plumbing shared by every search connector; backend-specific classification (what counts as 404/409) lives in each backend's own internal helper. */\nexport class SearchConnectorInternal {\n // Error/stack are non-enumerable, so `%j` on a raw Error yields `{}` - extract them so logs retain detail.\n static describeError(opts: { error: unknown }): unknown {\n const { error } = opts;\n return error instanceof Error ? (error.stack ?? error.message) : error;\n }\n\n /** The HTTP status an engine error carries, from whichever shape holds it: `httpStatus` (typesense-js) or `response.status` (the Meilisearch SDK). `undefined` for a transport failure (connect, DNS, timeout), which has none. */\n static readHttpStatus(opts: { error: unknown }): number | undefined {\n const { error } = opts;\n\n if (!RecordUtility.isRecord(error)) {\n return undefined;\n }\n\n if (typeof error['httpStatus'] === 'number') {\n return error['httpStatus'];\n }\n\n const response = error['response'];\n return RecordUtility.isRecord(response) && typeof response['status'] === 'number'\n ? response['status']\n : undefined;\n }\n\n /** The message the engine answered with, `undefined` when it sent none. */\n static readEngineMessage(opts: { error: unknown }): string | undefined {\n const { error } = opts;\n\n if (!RecordUtility.isRecord(error)) {\n return undefined;\n }\n\n const message = error['message'];\n if (typeof message === 'string' && message.trim() !== '') {\n return message;\n }\n\n const cause = error['cause'];\n const causeMessage = RecordUtility.isRecord(cause) ? cause['message'] : undefined;\n return typeof causeMessage === 'string' && causeMessage.trim() !== ''\n ? causeMessage\n : undefined;\n }\n\n /**\n * The caller's own mistake, as the engine answered it: a 400 or 422 (the request is malformed or unprocessable), a 404\n * that no verb tolerated, a 409 (a conflict). Anything else - a 5xx, a 401/403 (this server's credentials are wrong, not\n * the caller's request), a 408 or 429 (try again later) - is not the caller's fault and stays a dependency failure.\n */\n static getClientError(opts: {\n method: string;\n error: unknown;\n details?: Record<string, unknown>;\n }): ApplicationError | undefined {\n const { method, error, details } = opts;\n const status = SearchConnectorInternal.readHttpStatus({ error });\n const engineMessage = SearchConnectorInternal.readEngineMessage({ error });\n const extra = details ? { extra: { details } } : {};\n const text = engineMessage ? ` ${engineMessage}` : '';\n\n if (status === HTTP.ResultCodes.RS_4.NotFound) {\n return getError({\n error: SearchErrors.NOT_FOUND,\n message: `[${method}] Not found in the search engine.${text}`,\n ...extra,\n });\n }\n\n if (status === HTTP.ResultCodes.RS_4.Conflict) {\n return getError({\n error: SearchErrors.ALREADY_EXISTS,\n message: `[${method}] The search engine reports a conflict.${text}`,\n ...extra,\n });\n }\n\n if (\n status === HTTP.ResultCodes.RS_4.BadRequest ||\n status === HTTP.ResultCodes.RS_4.UnprocessableEntity\n ) {\n return getError({\n statusCode: status,\n message: `[${method}] The search engine rejected the request.${text}`,\n ...extra,\n });\n }\n\n return undefined;\n }\n\n // Logs the full error internally and throws. An engine 400, 404, 409 or 422 is the caller's own mistake: it throws the matching 4xx with the engine's message kept, so a retry loop does not retry it. Every other failure (transport, 5xx, auth, rate limit) throws a sanitized 503 with zero internal leakage. `details` is caller-actionable progress info (counts, offsets) only, never engine detail.\n static wrapDependencyError(opts: {\n method: string;\n error: unknown;\n logger: ILogger;\n details?: Record<string, unknown>;\n }): never {\n const { method, error, logger, details } = opts;\n\n logger\n .for(method)\n .error(\n 'Search engine dependency error | detail: %s',\n SearchConnectorInternal.describeError({ error }),\n );\n\n const clientError = SearchConnectorInternal.getClientError({ method, error, details });\n if (clientError) {\n Reflect.set(clientError, 'cause', error);\n throw clientError;\n }\n\n const wrapped = getError({\n statusCode: HTTP.ResultCodes.RS_5.ServiceUnavailable,\n messageCode: SearchErrorCodes.DEPENDENCY_UNAVAILABLE,\n message: `[${method}] Search engine is temporarily unavailable.`,\n ...(details ? { extra: { details } } : {}),\n });\n\n // Keeps the engine's own code for callers to classify on (tolerating `index_already_exists`); assigned AFTER construction because `cause` via getError() lands in `extra`, which goes on the WIRE, while a plain `cause` is exposed only in development.\n (wrapped as { cause?: unknown }).cause = error;\n throw wrapped;\n }\n\n // Throws a sanitized 404; `subject` must only contain caller-provided identifiers, never engine internals.\n static throwNotFoundError(opts: { method: string; subject: string }): never {\n const { method, subject } = opts;\n\n throw getError({\n error: SearchErrors.NOT_FOUND,\n message: `[${method}] ${subject} not found.`,\n });\n }\n}\n"]}
@@ -27,6 +27,7 @@ export declare const SearchInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
27
27
  mode: z.ZodLiteral<"keyword">;
28
28
  query: z.ZodOptional<z.ZodString>;
29
29
  queryBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
30
+ highlight: z.ZodOptional<z.ZodBoolean>;
30
31
  filter: z.ZodOptional<z.ZodObject<{
31
32
  where: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>>;
32
33
  fields: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodBoolean>, z.ZodArray<z.ZodString>]>>;
@@ -1 +1 @@
1
- {"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/common/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAQjE,oHAAoH;AACpH,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IACpC,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;IACtC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS;IAE5B,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAiE;IAE3F,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW;CAGpD;AACD,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,CAAC;AAsF1D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAK5B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE7D,+RAA+R;AAC/R,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;iBAe2B,CAAC;AAC/D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEvE,4FAA4F;AAC5F,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKsD,CAAC;AAC1F,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
1
+ {"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/common/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAQjE,oHAAoH;AACpH,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IACpC,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;IACtC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS;IAE5B,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAiE;IAE3F,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW;CAGpD;AACD,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,CAAC;AAwF1D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAK5B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE7D,+RAA+R;AAC/R,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;iBAe2B,CAAC;AAC/D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEvE,4FAA4F;AAC5F,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKsD,CAAC;AAC1F,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
@@ -41,7 +41,7 @@ const commonSearchParamsShape = {
41
41
  groupLimit: z.number().optional(),
42
42
  groupMissingValues: z.boolean().optional(),
43
43
  queryByWeights: z.array(z.number()).optional(),
44
- /** Escape hatch for engine-specific tuning: keys are the engine's OWN wire names (`num_typos`, not `numTypos`), merged verbatim and unvalidated after every neutral param. */
44
+ /** Escape hatch for engine-specific tuning, merged after every neutral param. Keys are the engine's own wire names, passed verbatim; an engine may also accept camelCase names for its documented tuning (Typesense: `ITypesenseTuning`). */
45
45
  engineParams: z.record(z.string(), z.unknown()).optional(),
46
46
  };
47
47
  const KeywordSearchSchema = z
@@ -49,6 +49,8 @@ const KeywordSearchSchema = z
49
49
  mode: z.literal(SearchModes.KEYWORD),
50
50
  query: z.string().optional(),
51
51
  queryBy: z.array(z.string()).optional(),
52
+ /** `false` returns no highlight markup. It wins over `highlightFields`. */
53
+ highlight: z.boolean().optional(),
52
54
  filter: SearchFilterSchema,
53
55
  ...commonSearchParamsShape,
54
56
  })
@@ -1 +1 @@
1
- {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/common/constants.ts"],"names":[],"mappings":"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","sourcesContent":["import { QuerySchemaFactory } from '@venizia/ignis-filter/schemas';\nimport { z } from 'zod';\nimport type { TConstValue } from '@venizia/ignis-helpers/common';\n\nconst { FieldsSchema, LimitSchema, OffsetSchema, OrderBySchema, SkipSchema, WhereSchema } =\n QuerySchemaFactory.build({\n // zod's own `.meta()`, which the OpenAPI generator reads: this layer must load without hono.\n decorate: (schema, metadata) => (schema instanceof z.ZodType ? schema.meta(metadata) : schema),\n });\n\n/** Discriminant values for `TSearchInput.mode` - which search strategy `ReadableSearchRepository.search()` runs. */\nexport class SearchModes {\n static readonly KEYWORD = 'keyword';\n static readonly SEMANTIC = 'semantic';\n static readonly HYBRID = 'hybrid';\n static readonly RAW = 'raw';\n\n static readonly SCHEME_SET = new Set([this.KEYWORD, this.SEMANTIC, this.HYBRID, this.RAW]);\n\n static isValid(input: string): input is TSearchMode {\n return this.SCHEME_SET.has(input);\n }\n}\nexport type TSearchMode = TConstValue<typeof SearchModes>;\n\n/** Reassembled from FilterSchema's atomic pieces minus `include`: search has no relations. */\nconst SearchFilterSchema = z\n .object({\n where: WhereSchema.optional(),\n fields: FieldsSchema,\n order: OrderBySchema,\n limit: LimitSchema,\n offset: OffsetSchema,\n skip: SkipSchema,\n })\n .optional()\n .describe(\n 'Search-scoped filter - same shape as the repository TFilter minus include (search has no relations)',\n );\n\n/** Shape object (NOT a z.object) so it spreads into each mode's z.object; `raw` mode skips it. Only cross-engine params live here - engine-specific tuning goes through `engineParams`. */\nconst commonSearchParamsShape = {\n facetBy: z.array(z.string()).optional(),\n facetQuery: z.string().optional(),\n maxFacetValues: z.number().optional(),\n\n highlightFields: z.array(z.string()).optional(),\n highlightFullFields: z.array(z.string()).optional(),\n highlightStartTag: z.string().optional(),\n highlightEndTag: z.string().optional(),\n snippetThreshold: z.number().optional(),\n\n groupBy: z.array(z.string()).optional(),\n groupLimit: z.number().optional(),\n groupMissingValues: z.boolean().optional(),\n\n queryByWeights: z.array(z.number()).optional(),\n\n /** Escape hatch for engine-specific tuning: keys are the engine's OWN wire names (`num_typos`, not `numTypos`), merged verbatim and unvalidated after every neutral param. */\n engineParams: z.record(z.string(), z.unknown()).optional(),\n};\n\nconst KeywordSearchSchema = z\n .object({\n mode: z.literal(SearchModes.KEYWORD),\n query: z.string().optional(),\n queryBy: z.array(z.string()).optional(),\n filter: SearchFilterSchema,\n ...commonSearchParamsShape,\n })\n .describe('Keyword full-text search');\n\nconst SemanticSearchSchema = z\n .object({\n mode: z.literal(SearchModes.SEMANTIC),\n vectorField: z.string(),\n nearVector: z.array(z.number()).optional(),\n queryText: z.string().optional(),\n k: z.number().optional(),\n filter: SearchFilterSchema,\n ...commonSearchParamsShape,\n distanceThreshold: z.number().optional(),\n ef: z.number().optional(),\n })\n .describe('Vector / semantic search');\n\nconst HybridSearchSchema = z\n .object({\n mode: z.literal(SearchModes.HYBRID),\n query: z.string(),\n queryBy: z.array(z.string()),\n vectorField: z.string(),\n nearVector: z.array(z.number()).optional(),\n alpha: z.number().optional(),\n k: z.number().optional(),\n filter: SearchFilterSchema,\n ...commonSearchParamsShape,\n distanceThreshold: z.number().optional(),\n ef: z.number().optional(),\n })\n .describe('Hybrid keyword + vector search');\n\nconst RawSearchSchema = z\n .object({\n mode: z.literal(SearchModes.RAW),\n params: z.record(z.string(), z.any()),\n })\n .describe('Raw engine passthrough');\n\nexport const SearchInputSchema = z.discriminatedUnion('mode', [\n KeywordSearchSchema,\n SemanticSearchSchema,\n HybridSearchSchema,\n RawSearchSchema,\n]);\nexport type TSearchInput = z.infer<typeof SearchInputSchema>;\n\n/** One collection's query within a multi-search - same friendly field names as `search()`. `filterBy` is a raw engine filter string because cross-collection search has no per-collection model to translate a `TFilter` against; the datasource maps entries to wire form via the dialect. */\nexport const MultiSearchEntrySchema = z\n .object({\n collection: z.string(),\n query: z.string().optional(),\n queryBy: z.array(z.string()).optional(),\n filterBy: z.string().optional(),\n sortBy: z.string().optional(),\n page: z.number().optional(),\n perPage: z.number().optional(),\n offset: z.number().optional(),\n includeFields: z.array(z.string()).optional(),\n excludeFields: z.array(z.string()).optional(),\n vectorQuery: z.string().optional(),\n ...commonSearchParamsShape,\n })\n .describe('A single collection query within a multi-search');\nexport type TMultiSearchEntry = z.infer<typeof MultiSearchEntrySchema>;\n\n/** Cross-collection multi-search input: friendly `searches` entries plus the union flag. */\nexport const MultiSearchInputSchema = z\n .object({\n searches: z.array(MultiSearchEntrySchema).min(1),\n union: z.boolean().optional(),\n })\n .describe('Cross-collection multi-search (federated by default; union merges results)');\nexport type TMultiSearchInput = z.infer<typeof MultiSearchInputSchema>;\n"]}
1
+ {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/common/constants.ts"],"names":[],"mappings":"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","sourcesContent":["import { QuerySchemaFactory } from '@venizia/ignis-filter/schemas';\nimport { z } from 'zod';\nimport type { TConstValue } from '@venizia/ignis-helpers/common';\n\nconst { FieldsSchema, LimitSchema, OffsetSchema, OrderBySchema, SkipSchema, WhereSchema } =\n QuerySchemaFactory.build({\n // zod's own `.meta()`, which the OpenAPI generator reads: this layer must load without hono.\n decorate: (schema, metadata) => (schema instanceof z.ZodType ? schema.meta(metadata) : schema),\n });\n\n/** Discriminant values for `TSearchInput.mode` - which search strategy `ReadableSearchRepository.search()` runs. */\nexport class SearchModes {\n static readonly KEYWORD = 'keyword';\n static readonly SEMANTIC = 'semantic';\n static readonly HYBRID = 'hybrid';\n static readonly RAW = 'raw';\n\n static readonly SCHEME_SET = new Set([this.KEYWORD, this.SEMANTIC, this.HYBRID, this.RAW]);\n\n static isValid(input: string): input is TSearchMode {\n return this.SCHEME_SET.has(input);\n }\n}\nexport type TSearchMode = TConstValue<typeof SearchModes>;\n\n/** Reassembled from FilterSchema's atomic pieces minus `include`: search has no relations. */\nconst SearchFilterSchema = z\n .object({\n where: WhereSchema.optional(),\n fields: FieldsSchema,\n order: OrderBySchema,\n limit: LimitSchema,\n offset: OffsetSchema,\n skip: SkipSchema,\n })\n .optional()\n .describe(\n 'Search-scoped filter - same shape as the repository TFilter minus include (search has no relations)',\n );\n\n/** Shape object (NOT a z.object) so it spreads into each mode's z.object; `raw` mode skips it. Only cross-engine params live here - engine-specific tuning goes through `engineParams`. */\nconst commonSearchParamsShape = {\n facetBy: z.array(z.string()).optional(),\n facetQuery: z.string().optional(),\n maxFacetValues: z.number().optional(),\n\n highlightFields: z.array(z.string()).optional(),\n highlightFullFields: z.array(z.string()).optional(),\n highlightStartTag: z.string().optional(),\n highlightEndTag: z.string().optional(),\n snippetThreshold: z.number().optional(),\n\n groupBy: z.array(z.string()).optional(),\n groupLimit: z.number().optional(),\n groupMissingValues: z.boolean().optional(),\n\n queryByWeights: z.array(z.number()).optional(),\n\n /** Escape hatch for engine-specific tuning, merged after every neutral param. Keys are the engine's own wire names, passed verbatim; an engine may also accept camelCase names for its documented tuning (Typesense: `ITypesenseTuning`). */\n engineParams: z.record(z.string(), z.unknown()).optional(),\n};\n\nconst KeywordSearchSchema = z\n .object({\n mode: z.literal(SearchModes.KEYWORD),\n query: z.string().optional(),\n queryBy: z.array(z.string()).optional(),\n /** `false` returns no highlight markup. It wins over `highlightFields`. */\n highlight: z.boolean().optional(),\n filter: SearchFilterSchema,\n ...commonSearchParamsShape,\n })\n .describe('Keyword full-text search');\n\nconst SemanticSearchSchema = z\n .object({\n mode: z.literal(SearchModes.SEMANTIC),\n vectorField: z.string(),\n nearVector: z.array(z.number()).optional(),\n queryText: z.string().optional(),\n k: z.number().optional(),\n filter: SearchFilterSchema,\n ...commonSearchParamsShape,\n distanceThreshold: z.number().optional(),\n ef: z.number().optional(),\n })\n .describe('Vector / semantic search');\n\nconst HybridSearchSchema = z\n .object({\n mode: z.literal(SearchModes.HYBRID),\n query: z.string(),\n queryBy: z.array(z.string()),\n vectorField: z.string(),\n nearVector: z.array(z.number()).optional(),\n alpha: z.number().optional(),\n k: z.number().optional(),\n filter: SearchFilterSchema,\n ...commonSearchParamsShape,\n distanceThreshold: z.number().optional(),\n ef: z.number().optional(),\n })\n .describe('Hybrid keyword + vector search');\n\nconst RawSearchSchema = z\n .object({\n mode: z.literal(SearchModes.RAW),\n params: z.record(z.string(), z.any()),\n })\n .describe('Raw engine passthrough');\n\nexport const SearchInputSchema = z.discriminatedUnion('mode', [\n KeywordSearchSchema,\n SemanticSearchSchema,\n HybridSearchSchema,\n RawSearchSchema,\n]);\nexport type TSearchInput = z.infer<typeof SearchInputSchema>;\n\n/** One collection's query within a multi-search - same friendly field names as `search()`. `filterBy` is a raw engine filter string because cross-collection search has no per-collection model to translate a `TFilter` against; the datasource maps entries to wire form via the dialect. */\nexport const MultiSearchEntrySchema = z\n .object({\n collection: z.string(),\n query: z.string().optional(),\n queryBy: z.array(z.string()).optional(),\n filterBy: z.string().optional(),\n sortBy: z.string().optional(),\n page: z.number().optional(),\n perPage: z.number().optional(),\n offset: z.number().optional(),\n includeFields: z.array(z.string()).optional(),\n excludeFields: z.array(z.string()).optional(),\n vectorQuery: z.string().optional(),\n ...commonSearchParamsShape,\n })\n .describe('A single collection query within a multi-search');\nexport type TMultiSearchEntry = z.infer<typeof MultiSearchEntrySchema>;\n\n/** Cross-collection multi-search input: friendly `searches` entries plus the union flag. */\nexport const MultiSearchInputSchema = z\n .object({\n searches: z.array(MultiSearchEntrySchema).min(1),\n union: z.boolean().optional(),\n })\n .describe('Cross-collection multi-search (federated by default; union merges results)');\nexport type TMultiSearchInput = z.infer<typeof MultiSearchInputSchema>;\n"]}
@@ -1,7 +1,7 @@
1
1
  import type { TNullable } from '@venizia/ignis-helpers/common';
2
2
  import type { IExtraOptions, TCount, TByIdFilter, TDataWithRange, TFields, TFilter, TFindOneOptions, TFindOptions, TFindRangeOptions, TRow, TWhere } from '@venizia/ignis-kernel';
3
3
  import type { IdType } from '@venizia/ignis-kernel';
4
- import type { ISearchResult } from '../../index.js';
4
+ import type { ISearchFacetCount, ISearchResult } from '../../index.js';
5
5
  import type { TSearchInput } from '../common/index.js';
6
6
  import { SearchModes } from '../common/index.js';
7
7
  import type { AbstractSearchDataSource } from '../../datasources/index.js';
@@ -51,6 +51,43 @@ export declare class ReadableSearchRepository<TDocument extends object = object,
51
51
  search<R extends object = TDocument>(opts: TSearchInput & {
52
52
  options?: IExtraOptions;
53
53
  }): Promise<ISearchResult<R>>;
54
+ /** The count of a text search: how many documents match `query` and `where`. Unlike `count()`, which asks the document endpoint for an exact filter-only total, this goes through search, so `isFoundExact` says whether the engine stopped early and `count` is an estimate. */
55
+ searchCount(opts: {
56
+ query: string;
57
+ queryBy?: string[];
58
+ where?: TWhere;
59
+ options?: IExtraOptions;
60
+ }): Promise<{
61
+ count: number;
62
+ isFoundExact: boolean;
63
+ }>;
64
+ /** Facet counts without hits, over the documents that match `query` (all of them when omitted) and `where`. `maxFacetValues` and `facetQuery` are for engines that take them; the others refuse them. */
65
+ facets(opts: {
66
+ facetBy: string[];
67
+ query?: string;
68
+ queryBy?: string[];
69
+ where?: TWhere;
70
+ maxFacetValues?: number;
71
+ facetQuery?: string;
72
+ options?: IExtraOptions;
73
+ }): Promise<{
74
+ facets: ISearchFacetCount[];
75
+ found: number;
76
+ isFoundExact: boolean;
77
+ }>;
78
+ /** Autocomplete: documents whose fields match `query` as typed so far. A keyword search with highlighting off and a small page (`limit`, 8 by default); the last word matches as a prefix, which both engines do by default. A blank `query` answers an empty list without asking the engine. */
79
+ suggest<R extends object = TDocument>(opts: {
80
+ query: string;
81
+ queryBy?: string[];
82
+ limit?: number;
83
+ includeFields?: string[];
84
+ where?: TWhere;
85
+ options?: IExtraOptions;
86
+ }): Promise<R[]>;
87
+ /** Documents lose their hidden fields on the way out, but a facet count or a match on one would still tell the caller what the field holds; so they are refused as `facetBy`, in `facetQuery`, as `queryBy`, as `groupBy` and in the highlight fields (a group key and a highlight snippet carry the value too). */
88
+ protected assertNoHiddenFieldsNamed(opts: {
89
+ input: TTranslatableSearchInput;
90
+ }): void;
54
91
  protected withDefaultQueryBy(opts: {
55
92
  input: TTranslatableSearchInput;
56
93
  }): TTranslatableSearchInput;