@venizia/ignis-connectors 0.4.0 → 0.4.1

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 (145) hide show
  1. package/dist/cjs/http/repository.d.ts +23 -23
  2. package/dist/cjs/http/repository.d.ts.map +1 -1
  3. package/dist/cjs/http/repository.js.map +1 -1
  4. package/dist/cjs/relational/core/datasources/base.d.ts.map +1 -1
  5. package/dist/cjs/relational/core/datasources/base.js +1 -1
  6. package/dist/cjs/relational/core/datasources/base.js.map +1 -1
  7. package/dist/cjs/relational/core/migrations/runner.js +3 -3
  8. package/dist/cjs/relational/core/migrations/runner.js.map +1 -1
  9. package/dist/cjs/relational/core/models/base.js +1 -1
  10. package/dist/cjs/relational/core/models/base.js.map +1 -1
  11. package/dist/cjs/relational/core/repositories/core/base.d.ts +17 -17
  12. package/dist/cjs/relational/core/repositories/core/base.d.ts.map +1 -1
  13. package/dist/cjs/relational/core/repositories/core/base.js +1 -0
  14. package/dist/cjs/relational/core/repositories/core/base.js.map +1 -1
  15. package/dist/cjs/relational/core/repositories/core/readable.d.ts +17 -17
  16. package/dist/cjs/relational/core/repositories/core/readable.d.ts.map +1 -1
  17. package/dist/cjs/relational/core/repositories/core/readable.js +8 -2
  18. package/dist/cjs/relational/core/repositories/core/readable.js.map +1 -1
  19. package/dist/cjs/relational/core/repositories/core/soft-deletable.d.ts +9 -9
  20. package/dist/cjs/relational/core/repositories/core/soft-deletable.d.ts.map +1 -1
  21. package/dist/cjs/relational/core/repositories/core/soft-deletable.js.map +1 -1
  22. package/dist/cjs/relational/core/repositories/dialect/filter.js +3 -3
  23. package/dist/cjs/relational/core/repositories/dialect/filter.js.map +1 -1
  24. package/dist/cjs/relational/core/repositories/dialect/relations/one.d.ts.map +1 -1
  25. package/dist/cjs/relational/core/repositories/dialect/relations/one.js +7 -7
  26. package/dist/cjs/relational/core/repositories/dialect/relations/one.js.map +1 -1
  27. package/dist/cjs/relational/core/repositories/sqls/recursive-tree.d.ts.map +1 -1
  28. package/dist/cjs/relational/core/repositories/sqls/recursive-tree.js +3 -3
  29. package/dist/cjs/relational/core/repositories/sqls/recursive-tree.js.map +1 -1
  30. package/dist/cjs/relational/postgres/drivers/pglite.js +2 -2
  31. package/dist/cjs/relational/postgres/drivers/pglite.js.map +1 -1
  32. package/dist/cjs/relational/postgres/repositories/dialect/query.js +1 -1
  33. package/dist/cjs/relational/postgres/repositories/dialect/query.js.map +1 -1
  34. package/dist/cjs/relational/sqlite/drivers/libsql.js +2 -2
  35. package/dist/cjs/relational/sqlite/drivers/libsql.js.map +1 -1
  36. package/dist/cjs/relational/sqlite/repositories/dialect/internal/json-path.js +3 -3
  37. package/dist/cjs/relational/sqlite/repositories/dialect/internal/json-path.js.map +1 -1
  38. package/dist/cjs/search/core/connector.js +2 -2
  39. package/dist/cjs/search/core/connector.js.map +1 -1
  40. package/dist/cjs/search/core/controllers/factory.js.map +1 -1
  41. package/dist/cjs/search/core/datasources/base.js +2 -2
  42. package/dist/cjs/search/core/datasources/base.js.map +1 -1
  43. package/dist/cjs/search/core/models/define-search-collection.js +3 -3
  44. package/dist/cjs/search/core/models/define-search-collection.js.map +1 -1
  45. package/dist/cjs/search/core/models/zod-derivation.js +1 -1
  46. package/dist/cjs/search/core/models/zod-derivation.js.map +1 -1
  47. package/dist/cjs/search/core/repositories/common/dialect-helpers.js +1 -1
  48. package/dist/cjs/search/core/repositories/common/dialect-helpers.js.map +1 -1
  49. package/dist/cjs/search/core/repositories/core/base.js +2 -2
  50. package/dist/cjs/search/core/repositories/core/base.js.map +1 -1
  51. package/dist/cjs/search/core/repositories/core/readable.d.ts +17 -17
  52. package/dist/cjs/search/core/repositories/core/readable.d.ts.map +1 -1
  53. package/dist/cjs/search/core/repositories/core/readable.js +4 -4
  54. package/dist/cjs/search/core/repositories/core/readable.js.map +1 -1
  55. package/dist/cjs/search/meilisearch/compiler.js +4 -4
  56. package/dist/cjs/search/meilisearch/compiler.js.map +1 -1
  57. package/dist/cjs/search/meilisearch/connector.js +22 -22
  58. package/dist/cjs/search/meilisearch/connector.js.map +1 -1
  59. package/dist/cjs/search/meilisearch/internal/connector-internal.js +1 -1
  60. package/dist/cjs/search/meilisearch/internal/connector-internal.js.map +1 -1
  61. package/dist/cjs/search/meilisearch/repositories/dialect/query-dialect.js +6 -6
  62. package/dist/cjs/search/meilisearch/repositories/dialect/query-dialect.js.map +1 -1
  63. package/dist/cjs/search/typesense/compiler.js +8 -8
  64. package/dist/cjs/search/typesense/compiler.js.map +1 -1
  65. package/dist/cjs/search/typesense/connector.js +23 -23
  66. package/dist/cjs/search/typesense/connector.js.map +1 -1
  67. package/dist/cjs/search/typesense/internal/mappers.js +1 -1
  68. package/dist/cjs/search/typesense/internal/mappers.js.map +1 -1
  69. package/dist/cjs/search/typesense/internal/pagination-windows.js +3 -3
  70. package/dist/cjs/search/typesense/internal/pagination-windows.js.map +1 -1
  71. package/dist/cjs/search/typesense/repositories/dialect/query-dialect.js +7 -7
  72. package/dist/cjs/search/typesense/repositories/dialect/query-dialect.js.map +1 -1
  73. package/dist/esm/http/repository.d.ts +23 -23
  74. package/dist/esm/http/repository.d.ts.map +1 -1
  75. package/dist/esm/http/repository.js.map +1 -1
  76. package/dist/esm/relational/core/datasources/base.d.ts.map +1 -1
  77. package/dist/esm/relational/core/datasources/base.js +1 -1
  78. package/dist/esm/relational/core/datasources/base.js.map +1 -1
  79. package/dist/esm/relational/core/migrations/runner.js +3 -3
  80. package/dist/esm/relational/core/migrations/runner.js.map +1 -1
  81. package/dist/esm/relational/core/models/base.js +1 -1
  82. package/dist/esm/relational/core/models/base.js.map +1 -1
  83. package/dist/esm/relational/core/repositories/core/base.d.ts +17 -17
  84. package/dist/esm/relational/core/repositories/core/base.d.ts.map +1 -1
  85. package/dist/esm/relational/core/repositories/core/base.js +1 -0
  86. package/dist/esm/relational/core/repositories/core/base.js.map +1 -1
  87. package/dist/esm/relational/core/repositories/core/readable.d.ts +17 -17
  88. package/dist/esm/relational/core/repositories/core/readable.d.ts.map +1 -1
  89. package/dist/esm/relational/core/repositories/core/readable.js +8 -2
  90. package/dist/esm/relational/core/repositories/core/readable.js.map +1 -1
  91. package/dist/esm/relational/core/repositories/core/soft-deletable.d.ts +9 -9
  92. package/dist/esm/relational/core/repositories/core/soft-deletable.d.ts.map +1 -1
  93. package/dist/esm/relational/core/repositories/core/soft-deletable.js.map +1 -1
  94. package/dist/esm/relational/core/repositories/dialect/filter.js +3 -3
  95. package/dist/esm/relational/core/repositories/dialect/filter.js.map +1 -1
  96. package/dist/esm/relational/core/repositories/dialect/relations/one.d.ts.map +1 -1
  97. package/dist/esm/relational/core/repositories/dialect/relations/one.js +7 -7
  98. package/dist/esm/relational/core/repositories/dialect/relations/one.js.map +1 -1
  99. package/dist/esm/relational/core/repositories/sqls/recursive-tree.d.ts.map +1 -1
  100. package/dist/esm/relational/core/repositories/sqls/recursive-tree.js +3 -3
  101. package/dist/esm/relational/core/repositories/sqls/recursive-tree.js.map +1 -1
  102. package/dist/esm/relational/postgres/drivers/pglite.js +2 -2
  103. package/dist/esm/relational/postgres/drivers/pglite.js.map +1 -1
  104. package/dist/esm/relational/postgres/repositories/dialect/query.js +1 -1
  105. package/dist/esm/relational/postgres/repositories/dialect/query.js.map +1 -1
  106. package/dist/esm/relational/sqlite/drivers/libsql.js +2 -2
  107. package/dist/esm/relational/sqlite/drivers/libsql.js.map +1 -1
  108. package/dist/esm/relational/sqlite/repositories/dialect/internal/json-path.js +3 -3
  109. package/dist/esm/relational/sqlite/repositories/dialect/internal/json-path.js.map +1 -1
  110. package/dist/esm/search/core/connector.js +2 -2
  111. package/dist/esm/search/core/connector.js.map +1 -1
  112. package/dist/esm/search/core/controllers/factory.js.map +1 -1
  113. package/dist/esm/search/core/datasources/base.js +2 -2
  114. package/dist/esm/search/core/datasources/base.js.map +1 -1
  115. package/dist/esm/search/core/models/define-search-collection.js +3 -3
  116. package/dist/esm/search/core/models/define-search-collection.js.map +1 -1
  117. package/dist/esm/search/core/models/zod-derivation.js +1 -1
  118. package/dist/esm/search/core/models/zod-derivation.js.map +1 -1
  119. package/dist/esm/search/core/repositories/common/dialect-helpers.js +1 -1
  120. package/dist/esm/search/core/repositories/common/dialect-helpers.js.map +1 -1
  121. package/dist/esm/search/core/repositories/core/base.js +2 -2
  122. package/dist/esm/search/core/repositories/core/base.js.map +1 -1
  123. package/dist/esm/search/core/repositories/core/readable.d.ts +17 -17
  124. package/dist/esm/search/core/repositories/core/readable.d.ts.map +1 -1
  125. package/dist/esm/search/core/repositories/core/readable.js +4 -4
  126. package/dist/esm/search/core/repositories/core/readable.js.map +1 -1
  127. package/dist/esm/search/meilisearch/compiler.js +4 -4
  128. package/dist/esm/search/meilisearch/compiler.js.map +1 -1
  129. package/dist/esm/search/meilisearch/connector.js +22 -22
  130. package/dist/esm/search/meilisearch/connector.js.map +1 -1
  131. package/dist/esm/search/meilisearch/internal/connector-internal.js +1 -1
  132. package/dist/esm/search/meilisearch/internal/connector-internal.js.map +1 -1
  133. package/dist/esm/search/meilisearch/repositories/dialect/query-dialect.js +6 -6
  134. package/dist/esm/search/meilisearch/repositories/dialect/query-dialect.js.map +1 -1
  135. package/dist/esm/search/typesense/compiler.js +8 -8
  136. package/dist/esm/search/typesense/compiler.js.map +1 -1
  137. package/dist/esm/search/typesense/connector.js +23 -23
  138. package/dist/esm/search/typesense/connector.js.map +1 -1
  139. package/dist/esm/search/typesense/internal/mappers.js +1 -1
  140. package/dist/esm/search/typesense/internal/mappers.js.map +1 -1
  141. package/dist/esm/search/typesense/internal/pagination-windows.js +3 -3
  142. package/dist/esm/search/typesense/internal/pagination-windows.js.map +1 -1
  143. package/dist/esm/search/typesense/repositories/dialect/query-dialect.js +7 -7
  144. package/dist/esm/search/typesense/repositories/dialect/query-dialect.js.map +1 -1
  145. package/package.json +7 -7
@@ -1 +1 @@
1
- {"version":3,"file":"pglite.js","sourceRoot":"","sources":["../../../../../src/relational/postgres/drivers/pglite.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';\nimport type { TRelationalConnector } from '@/relational/postgres/datasources/common';\nimport type { PGlite } from '@electric-sql/pglite';\nimport type { ILogger, IPoolControlOptions } from '@venizia/ignis-helpers/core';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, BasePoolHelper, getError } from '@venizia/ignis-helpers/core';\nimport { drizzle } from 'drizzle-orm/pglite';\nimport type { TRelationalConnection, TRelationalDriver } from './driver';\n\n/** Pool knobs the driver forwards, minus `size`: one slot IS the mutual exclusion PGlite lacks. */\nexport type TPGliteDriverOptions = Omit<IPoolControlOptions, 'size'> & { client: PGlite };\n\n/**\n * Postgres compiled to WASM, in-process. Reports PostgreSQL 18.x, so the dialect works unchanged.\n *\n * One session only, and a second `BEGIN` neither nests nor errors - it joins the open transaction,\n * so the outer COMMIT commits the inner writer's rows. Hence the 1-slot pool behind `acquire()`.\n *\n * Consequence: a `createConnector()` write - the path all repositories take - runs INSIDE any open\n * transaction and dies with its ROLLBACK. Under concurrency, write through `acquire()`.\n */\nexport class PGliteDriver<\n Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema,\n> implements TRelationalDriver<Schema, PGlite> {\n private readonly client: PGlite;\n\n /**\n * The pooled resource IS the single client, so `create()` always hands back the same instance.\n * The pool contributes the mutual exclusion PGlite lacks, not connection multiplicity.\n */\n private readonly slot: BasePoolHelper<PGlite>;\n\n private readonly logger: ILogger;\n\n /**\n * A leaked transaction never releases the one slot, so without a timeout every later `acquire()`\n * in the process hangs forever and silently. 30s outlasts any honest transaction on an in-process\n * database with no network in it, and turns a leak into a named error instead of a dead process.\n */\n static readonly DEFAULT_ACQUIRE_TIMEOUT_MS = 30_000;\n\n /**\n * PGlite's Emscripten runtime plants this status on the HOST process during ordinary operation -\n * measured on `@electric-sql/pglite` 0.5.5, `process.exitCode` is `undefined` before the first\n * query and 99 after it, and every later query re-arms it. A server that shuts down cleanly then\n * exits 99, which Docker, systemd and CI all read as a crash.\n *\n * Named rather than inlined so a future PGlite using a different status stops matching and makes\n * the problem visible again, instead of {@link end} silently forcing a zero it did not verify.\n */\n private static readonly WASM_HOST_EXIT_STATUS = 99;\n\n constructor(opts: TPGliteDriverOptions) {\n const { client, acquireTimeoutMs, maxWaitingClients, scope } = opts;\n\n // PGlite is not a connection pool: it has no connect()/totalCount, which is what a `pg.Pool`\n // leads with. Probing its own verbs names the mistake here instead of at the first query.\n const isPGlite =\n typeof (client as AnyType)?.query === 'function' &&\n typeof (client as AnyType)?.exec === 'function' &&\n typeof (client as AnyType)?.close === 'function';\n\n if (!isPGlite) {\n throw getError({\n message: `[${PGliteDriver.name}] Expected an \\`@electric-sql/pglite\\` PGlite | Got a client without exec()/close() - a \\`pg.Pool\\`? | Construct \\`new PGlite('./pgdata')\\`, or name NodePostgresDriver instead`,\n });\n }\n\n this.client = client;\n // `LoggerFactory` cannot be imported here: this is the browser driver, and that\n // import reaches `node:module`. `BaseHelper` resolves the same logger through\n // the swappable resolver without pulling in the node-only provider loader.\n this.logger = new BaseHelper({ scope: PGliteDriver.name }).getLogger();\n\n this.slot = new BasePoolHelper<PGlite>({\n size: 1,\n acquireTimeoutMs: acquireTimeoutMs ?? PGliteDriver.DEFAULT_ACQUIRE_TIMEOUT_MS,\n maxWaitingClients,\n scope: scope ?? PGliteDriver.name,\n create: async () => {\n await this.client.waitReady;\n return this.client;\n },\n destroy: resource => this.scrubSession({ resource }),\n });\n }\n\n createConnector(opts: { schema: Schema }): TRelationalConnector<Schema> {\n return drizzle({ client: this.client, schema: opts.schema }) as TRelationalConnector<Schema>;\n }\n\n async acquire(opts: { schema: Schema }): Promise<TRelationalConnection<Schema>> {\n let client: PGlite;\n\n // The bare pool error names only a timeout; on one session the cause is almost always an\n // unreleased transaction, so say so where the caller reads it.\n try {\n client = await this.slot.acquire();\n } catch (error) {\n throw getError({\n message: `[${PGliteDriver.name}][acquire] Could not borrow the single PGlite session | ${(error as Error)?.message ?? String(error)} | An unreleased transaction still holds it - commit/rollback it, or raise \\`acquireTimeoutMs\\``,\n });\n }\n\n let connector: TRelationalConnector<Schema>;\n try {\n connector = drizzle({ client, schema: opts.schema }) as TRelationalConnector<Schema>;\n } catch (error) {\n this.slot.release({ resource: client });\n throw error;\n }\n\n // Every borrower gets the SAME object, so a stale handle releasing twice would hand the\n // slot away underneath whoever holds it now. The latch makes the second release a no-op.\n let isReleased = false;\n\n return {\n connector,\n\n execute: async (executeOpts: { statement: string }) => {\n const result = await client.query(executeOpts.statement);\n return { count: result.affectedRows ?? 0 };\n },\n\n query: async <R>(queryOpts: { statement: string }) => {\n const result = await client.query<R>(queryOpts.statement);\n return result.rows ?? [];\n },\n\n release: (releaseOpts?: { destroy?: boolean }) => {\n if (isReleased) {\n return;\n }\n isReleased = true;\n\n if (releaseOpts?.destroy !== true) {\n this.slot.release({ resource: client });\n return;\n }\n\n // Discard cannot throw the session away - there is one and no replacement.\n // The slot is re-created from the same instance after the destroy hook\n // scrubs it, so the next waiter never inherits an unknown transaction.\n this.slot.discard({ resource: client }).catch(error => {\n this.logger.for('release').error('Failed to discard the PGlite slot | Error: %s', error);\n });\n },\n };\n }\n\n getClient(): PGlite {\n return this.client;\n }\n\n async end(): Promise<void> {\n await this.slot.destroy();\n await this.client.close();\n this.clearWasmHostExitStatus();\n }\n\n /**\n * Clears the exit status PGlite planted on the host - see {@link WASM_HOST_EXIT_STATUS} - and\n * only while it still holds exactly that value, so an exit code the application set itself\n * survives untouched.\n *\n * `globalThis.process` is bound to a local and never member-accessed as `globalThis.process.x`:\n * this driver has to bundle clean for a browser target, where the property read yields\n * `undefined` and the optional chain short-circuits, while the member-access spelling is what the\n * purity gate treats as fatal.\n */\n private clearWasmHostExitStatus(): void {\n const host = globalThis.process;\n\n if (host?.exitCode !== PGliteDriver.WASM_HOST_EXIT_STATUS) {\n return;\n }\n\n host.exitCode = 0;\n this.logger\n .for(this.end.name)\n .debug(\n 'Cleared the exit status PGlite planted on the host process | status: %s',\n PGliteDriver.WASM_HOST_EXIT_STATUS,\n );\n }\n\n /**\n * The pool's destroy hook. A failed COMMIT/ROLLBACK may leave the session inside a transaction,\n * and the next borrower would inherit it. `ROLLBACK` outside a transaction is a no-op, so this is\n * safe whichever state the session is actually in.\n */\n private async scrubSession(opts: { resource: PGlite }): Promise<void> {\n const { resource } = opts;\n\n if (resource.closed) {\n return;\n }\n\n try {\n await resource.query('ROLLBACK');\n } catch (error) {\n this.logger\n .for(this.scrubSession.name)\n .warn('Failed to scrub the PGlite session | Error: %s', error);\n }\n }\n}\n"]}
1
+ {"version":3,"file":"pglite.js","sourceRoot":"","sources":["../../../../../src/relational/postgres/drivers/pglite.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';\nimport type { TRelationalConnector } from '@/relational/postgres/datasources/common';\nimport type { PGlite } from '@electric-sql/pglite';\nimport type { ILogger, IPoolControlOptions } from '@venizia/ignis-helpers/core';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, BasePoolHelper, getError } from '@venizia/ignis-helpers/core';\nimport { drizzle } from 'drizzle-orm/pglite';\nimport type { TRelationalConnection, TRelationalDriver } from './driver';\n\n/** Pool knobs the driver forwards, minus `size`: one slot IS the mutual exclusion PGlite lacks. */\nexport type TPGliteDriverOptions = Omit<IPoolControlOptions, 'size'> & { client: PGlite };\n\n/**\n * Postgres compiled to WASM, in-process. Reports PostgreSQL 18.x, so the dialect works unchanged.\n *\n * One session only, and a second `BEGIN` neither nests nor errors - it joins the open transaction,\n * so the outer COMMIT commits the inner writer's rows. Hence the 1-slot pool behind `acquire()`.\n *\n * Consequence: a `createConnector()` write - the path all repositories take - runs INSIDE any open\n * transaction and dies with its ROLLBACK. Under concurrency, write through `acquire()`.\n */\nexport class PGliteDriver<\n Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema,\n> implements TRelationalDriver<Schema, PGlite> {\n private readonly client: PGlite;\n\n /**\n * The pooled resource IS the single client, so `create()` always hands back the same instance.\n * The pool contributes the mutual exclusion PGlite lacks, not connection multiplicity.\n */\n private readonly slot: BasePoolHelper<PGlite>;\n\n private readonly logger: ILogger;\n\n /**\n * A leaked transaction never releases the one slot, so without a timeout every later `acquire()`\n * in the process hangs forever and silently. 30s outlasts any honest transaction on an in-process\n * database with no network in it, and turns a leak into a named error instead of a dead process.\n */\n static readonly DEFAULT_ACQUIRE_TIMEOUT_MS = 30_000;\n\n /**\n * PGlite's Emscripten runtime plants this status on the HOST process during ordinary operation -\n * measured on `@electric-sql/pglite` 0.5.5, `process.exitCode` is `undefined` before the first\n * query and 99 after it, and every later query re-arms it. A server that shuts down cleanly then\n * exits 99, which Docker, systemd and CI all read as a crash.\n *\n * Named rather than inlined so a future PGlite using a different status stops matching and makes\n * the problem visible again, instead of {@link end} silently forcing a zero it did not verify.\n */\n private static readonly WASM_HOST_EXIT_STATUS = 99;\n\n constructor(opts: TPGliteDriverOptions) {\n const { client, acquireTimeoutMs, maxWaitingClients, scope } = opts;\n\n // PGlite is not a connection pool: it has no connect()/totalCount, which is what a `pg.Pool`\n // leads with. Probing its own verbs names the mistake here instead of at the first query.\n const isPGlite =\n typeof (client as AnyType)?.query === 'function' &&\n typeof (client as AnyType)?.exec === 'function' &&\n typeof (client as AnyType)?.close === 'function';\n\n if (!isPGlite) {\n throw getError({\n message: `[${PGliteDriver.name}] Expected an \\`@electric-sql/pglite\\` PGlite | Got a client without exec()/close() - a \\`pg.Pool\\`? | Construct \\`new PGlite('./pgdata')\\`, or name NodePostgresDriver instead`,\n });\n }\n\n this.client = client;\n // `LoggerFactory` cannot be imported here: this is the browser driver, and that\n // import reaches `node:module`. `BaseHelper` resolves the same logger through\n // the swappable resolver without pulling in the node-only provider loader.\n this.logger = new BaseHelper({ scope: PGliteDriver.name }).getLogger();\n\n this.slot = new BasePoolHelper<PGlite>({\n size: 1,\n acquireTimeoutMs: acquireTimeoutMs ?? PGliteDriver.DEFAULT_ACQUIRE_TIMEOUT_MS,\n maxWaitingClients,\n scope: scope ?? PGliteDriver.name,\n create: async () => {\n await this.client.waitReady;\n return this.client;\n },\n destroy: (resource) => this.scrubSession({ resource }),\n });\n }\n\n createConnector(opts: { schema: Schema }): TRelationalConnector<Schema> {\n return drizzle({ client: this.client, schema: opts.schema }) as TRelationalConnector<Schema>;\n }\n\n async acquire(opts: { schema: Schema }): Promise<TRelationalConnection<Schema>> {\n let client: PGlite;\n\n // The bare pool error names only a timeout; on one session the cause is almost always an\n // unreleased transaction, so say so where the caller reads it.\n try {\n client = await this.slot.acquire();\n } catch (error) {\n throw getError({\n message: `[${PGliteDriver.name}][acquire] Could not borrow the single PGlite session | ${(error as Error)?.message ?? String(error)} | An unreleased transaction still holds it - commit/rollback it, or raise \\`acquireTimeoutMs\\``,\n });\n }\n\n let connector: TRelationalConnector<Schema>;\n try {\n connector = drizzle({ client, schema: opts.schema }) as TRelationalConnector<Schema>;\n } catch (error) {\n this.slot.release({ resource: client });\n throw error;\n }\n\n // Every borrower gets the SAME object, so a stale handle releasing twice would hand the\n // slot away underneath whoever holds it now. The latch makes the second release a no-op.\n let isReleased = false;\n\n return {\n connector,\n\n execute: async (executeOpts: { statement: string }) => {\n const result = await client.query(executeOpts.statement);\n return { count: result.affectedRows ?? 0 };\n },\n\n query: async <R>(queryOpts: { statement: string }) => {\n const result = await client.query<R>(queryOpts.statement);\n return result.rows ?? [];\n },\n\n release: (releaseOpts?: { destroy?: boolean }) => {\n if (isReleased) {\n return;\n }\n isReleased = true;\n\n if (releaseOpts?.destroy !== true) {\n this.slot.release({ resource: client });\n return;\n }\n\n // Discard cannot throw the session away - there is one and no replacement.\n // The slot is re-created from the same instance after the destroy hook\n // scrubs it, so the next waiter never inherits an unknown transaction.\n this.slot.discard({ resource: client }).catch((error) => {\n this.logger.for('release').error('Failed to discard the PGlite slot | Error: %s', error);\n });\n },\n };\n }\n\n getClient(): PGlite {\n return this.client;\n }\n\n async end(): Promise<void> {\n await this.slot.destroy();\n await this.client.close();\n this.clearWasmHostExitStatus();\n }\n\n /**\n * Clears the exit status PGlite planted on the host - see {@link WASM_HOST_EXIT_STATUS} - and\n * only while it still holds exactly that value, so an exit code the application set itself\n * survives untouched.\n *\n * `globalThis.process` is bound to a local and never member-accessed as `globalThis.process.x`:\n * this driver has to bundle clean for a browser target, where the property read yields\n * `undefined` and the optional chain short-circuits, while the member-access spelling is what the\n * purity gate treats as fatal.\n */\n private clearWasmHostExitStatus(): void {\n const host = globalThis.process;\n\n if (host?.exitCode !== PGliteDriver.WASM_HOST_EXIT_STATUS) {\n return;\n }\n\n host.exitCode = 0;\n this.logger\n .for(this.end.name)\n .debug(\n 'Cleared the exit status PGlite planted on the host process | status: %s',\n PGliteDriver.WASM_HOST_EXIT_STATUS,\n );\n }\n\n /**\n * The pool's destroy hook. A failed COMMIT/ROLLBACK may leave the session inside a transaction,\n * and the next borrower would inherit it. `ROLLBACK` outside a transaction is a no-op, so this is\n * safe whichever state the session is actually in.\n */\n private async scrubSession(opts: { resource: PGlite }): Promise<void> {\n const { resource } = opts;\n\n if (resource.closed) {\n return;\n }\n\n try {\n await resource.query('ROLLBACK');\n } catch (error) {\n this.logger\n .for(this.scrubSession.name)\n .warn('Failed to scrub the PGlite session | Error: %s', error);\n }\n }\n}\n"]}
@@ -8,7 +8,7 @@ const drizzle_orm_1 = require("drizzle-orm");
8
8
  /** Builds `<column> <operator> ARRAY[$1, ...]` with every element BOUND, never interpolated - these operators are wire-reachable with a `z.any()` operand, so raw interpolation is SQL injection. Element type decides only the CAST (text[] vs numeric[]), never the binding. */
9
9
  const buildPgArrayComparison = (opts) => {
10
10
  const { column, value, operator } = opts;
11
- const items = drizzle_orm_1.sql.join(value.map(item => (0, drizzle_orm_1.sql) `${item}`), (0, drizzle_orm_1.sql) `, `);
11
+ const items = drizzle_orm_1.sql.join(value.map((item) => (0, drizzle_orm_1.sql) `${item}`), (0, drizzle_orm_1.sql) `, `);
12
12
  const isNumericOrBoolean = typeof value[0] === 'number' || typeof value[0] === 'boolean';
13
13
  if (isNumericOrBoolean) {
14
14
  return (0, drizzle_orm_1.sql) `${column} ${drizzle_orm_1.sql.raw(operator)} ARRAY[${items}]`;
@@ -1 +1 @@
1
- {"version":3,"file":"query.js","sourceRoot":"","sources":["../../../../../../src/relational/postgres/repositories/dialect/query.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IQueryHandlerOptions } from '@venizia/ignis-kernel';\nimport { buildSubqueryCondition } from '@/relational/core/repositories/dialect/internal';\nimport { QueryOperators } from '@venizia/ignis-kernel';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport {\n between,\n eq,\n gt,\n gte,\n ilike,\n inArray,\n isNotNull,\n isNull,\n like,\n lt,\n lte,\n ne,\n not,\n notInArray,\n notLike,\n sql,\n} from 'drizzle-orm';\n\n/** Builds `<column> <operator> ARRAY[$1, ...]` with every element BOUND, never interpolated - these operators are wire-reachable with a `z.any()` operand, so raw interpolation is SQL injection. Element type decides only the CAST (text[] vs numeric[]), never the binding. */\nconst buildPgArrayComparison = (opts: { column: AnyType; value: AnyType[]; operator: string }) => {\n const { column, value, operator } = opts;\n\n const items = sql.join(\n value.map(item => sql`${item}`),\n sql`, `,\n );\n\n const isNumericOrBoolean = typeof value[0] === 'number' || typeof value[0] === 'boolean';\n\n if (isNumericOrBoolean) {\n return sql`${column} ${sql.raw(operator)} ARRAY[${items}]`;\n }\n\n // varchar[]/text[]/char[] all compare cleanly once both sides are text[].\n return sql`${column}::text[] ${sql.raw(operator)} ARRAY[${items}]::text[]`;\n};\n\n/** Drizzle-backed handlers for the neutral QueryOperators vocabulary (SQL branch only); the operator NAMES live in repositories/common/operators.ts, shared with the Search dialects. */\nexport class PostgresQueryOperators extends QueryOperators {\n static readonly FNS = {\n [this.EQ]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNull(opts.column) : eq(opts.column, opts.value),\n // SQL three-valued logic is canonical: a NULL row never matches `neq`/`ne` because comparing to a real value yields UNKNOWN, not TRUE.\n [this.NE]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNotNull(opts.column) : ne(opts.column, opts.value),\n [this.NEQ]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNotNull(opts.column) : ne(opts.column, opts.value),\n\n // `exists`/`notExists` test presence: `exists: true` -> IS NOT NULL, `exists: false` -> IS NULL, `notExists` the inverse.\n [this.EXISTS]: (opts: IQueryHandlerOptions) =>\n opts.value === false ? isNull(opts.column) : isNotNull(opts.column),\n [this.NOT_EXISTS]: (opts: IQueryHandlerOptions) =>\n opts.value === false ? isNotNull(opts.column) : isNull(opts.column),\n\n [this.GT]: (opts: IQueryHandlerOptions) => gt(opts.column, opts.value),\n [this.GTE]: (opts: IQueryHandlerOptions) => gte(opts.column, opts.value),\n\n [this.LT]: (opts: IQueryHandlerOptions) => lt(opts.column, opts.value),\n [this.LTE]: (opts: IQueryHandlerOptions) => lte(opts.column, opts.value),\n\n [this.IS]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNull(opts.column) : eq(opts.column, opts.value),\n [this.IS_NOT]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNotNull(opts.column) : ne(opts.column, opts.value),\n\n [this.IN]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value)) {\n return eq(opts.column, opts.value);\n }\n return opts.value.length === 0 ? sql`false` : inArray(opts.column, opts.value);\n },\n [this.INQ]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value)) {\n return eq(opts.column, opts.value);\n }\n return opts.value.length === 0 ? sql`false` : inArray(opts.column, opts.value);\n },\n [this.IN_SQL]: (opts: IQueryHandlerOptions) =>\n buildSubqueryCondition({ ...opts, operator: this.IN_SQL, isNegated: false }),\n [this.NOT_IN_SQL]: (opts: IQueryHandlerOptions) =>\n buildSubqueryCondition({ ...opts, operator: this.NOT_IN_SQL, isNegated: true }),\n [this.NIN]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value)) {\n return ne(opts.column, opts.value);\n }\n return opts.value.length === 0 ? sql`true` : notInArray(opts.column, opts.value);\n },\n [this.BETWEEN]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value) || opts.value.length !== 2) {\n throw getError({\n message: `[PostgresQueryOperators][BETWEEN] Invalid value: expected array of 2 elements, got ${JSON.stringify(opts.value)}`,\n });\n }\n return between(opts.column, opts.value[0], opts.value[1]);\n },\n [this.NOT_BETWEEN]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value) || opts.value.length !== 2) {\n throw getError({\n message: `[PostgresQueryOperators][NOT_BETWEEN] Invalid value: expected array of 2 elements, got ${JSON.stringify(opts.value)}`,\n });\n }\n return not(between(opts.column, opts.value[0], opts.value[1]));\n },\n\n [this.CONTAINS]: (opts: IQueryHandlerOptions) => {\n const value = Array.isArray(opts.value) ? opts.value : [opts.value];\n if (value.length === 0) {\n return sql`true`;\n }\n return buildPgArrayComparison({ column: opts.column, value, operator: '@>' });\n },\n [this.CONTAINED_BY]: (opts: IQueryHandlerOptions) => {\n const value = Array.isArray(opts.value) ? opts.value : [opts.value];\n if (value.length === 0) {\n return sql`${opts.column} = '{}'`;\n }\n return buildPgArrayComparison({ column: opts.column, value, operator: '<@' });\n },\n [this.OVERLAPS]: (opts: IQueryHandlerOptions) => {\n const value = Array.isArray(opts.value) ? opts.value : [opts.value];\n if (value.length === 0) {\n return sql`false`;\n }\n return buildPgArrayComparison({ column: opts.column, value, operator: '&&' });\n },\n\n [this.LIKE]: (opts: IQueryHandlerOptions) => like(opts.column, opts.value),\n [this.NOT_LIKE]: (opts: IQueryHandlerOptions) => notLike(opts.column, opts.value),\n [this.ILIKE]: (opts: IQueryHandlerOptions) => ilike(opts.column, opts.value),\n [this.NOT_ILIKE]: (opts: IQueryHandlerOptions) => not(ilike(opts.column, opts.value)),\n\n [this.REGEXP]: (opts: IQueryHandlerOptions) => sql`${opts.column} ~ ${opts.value}`,\n [this.IREGEXP]: (opts: IQueryHandlerOptions) => sql`${opts.column} ~* ${opts.value}`,\n };\n}\n"]}
1
+ {"version":3,"file":"query.js","sourceRoot":"","sources":["../../../../../../src/relational/postgres/repositories/dialect/query.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IQueryHandlerOptions } from '@venizia/ignis-kernel';\nimport { buildSubqueryCondition } from '@/relational/core/repositories/dialect/internal';\nimport { QueryOperators } from '@venizia/ignis-kernel';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport {\n between,\n eq,\n gt,\n gte,\n ilike,\n inArray,\n isNotNull,\n isNull,\n like,\n lt,\n lte,\n ne,\n not,\n notInArray,\n notLike,\n sql,\n} from 'drizzle-orm';\n\n/** Builds `<column> <operator> ARRAY[$1, ...]` with every element BOUND, never interpolated - these operators are wire-reachable with a `z.any()` operand, so raw interpolation is SQL injection. Element type decides only the CAST (text[] vs numeric[]), never the binding. */\nconst buildPgArrayComparison = (opts: { column: AnyType; value: AnyType[]; operator: string }) => {\n const { column, value, operator } = opts;\n\n const items = sql.join(\n value.map((item) => sql`${item}`),\n sql`, `,\n );\n\n const isNumericOrBoolean = typeof value[0] === 'number' || typeof value[0] === 'boolean';\n\n if (isNumericOrBoolean) {\n return sql`${column} ${sql.raw(operator)} ARRAY[${items}]`;\n }\n\n // varchar[]/text[]/char[] all compare cleanly once both sides are text[].\n return sql`${column}::text[] ${sql.raw(operator)} ARRAY[${items}]::text[]`;\n};\n\n/** Drizzle-backed handlers for the neutral QueryOperators vocabulary (SQL branch only); the operator NAMES live in repositories/common/operators.ts, shared with the Search dialects. */\nexport class PostgresQueryOperators extends QueryOperators {\n static readonly FNS = {\n [this.EQ]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNull(opts.column) : eq(opts.column, opts.value),\n // SQL three-valued logic is canonical: a NULL row never matches `neq`/`ne` because comparing to a real value yields UNKNOWN, not TRUE.\n [this.NE]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNotNull(opts.column) : ne(opts.column, opts.value),\n [this.NEQ]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNotNull(opts.column) : ne(opts.column, opts.value),\n\n // `exists`/`notExists` test presence: `exists: true` -> IS NOT NULL, `exists: false` -> IS NULL, `notExists` the inverse.\n [this.EXISTS]: (opts: IQueryHandlerOptions) =>\n opts.value === false ? isNull(opts.column) : isNotNull(opts.column),\n [this.NOT_EXISTS]: (opts: IQueryHandlerOptions) =>\n opts.value === false ? isNotNull(opts.column) : isNull(opts.column),\n\n [this.GT]: (opts: IQueryHandlerOptions) => gt(opts.column, opts.value),\n [this.GTE]: (opts: IQueryHandlerOptions) => gte(opts.column, opts.value),\n\n [this.LT]: (opts: IQueryHandlerOptions) => lt(opts.column, opts.value),\n [this.LTE]: (opts: IQueryHandlerOptions) => lte(opts.column, opts.value),\n\n [this.IS]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNull(opts.column) : eq(opts.column, opts.value),\n [this.IS_NOT]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNotNull(opts.column) : ne(opts.column, opts.value),\n\n [this.IN]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value)) {\n return eq(opts.column, opts.value);\n }\n return opts.value.length === 0 ? sql`false` : inArray(opts.column, opts.value);\n },\n [this.INQ]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value)) {\n return eq(opts.column, opts.value);\n }\n return opts.value.length === 0 ? sql`false` : inArray(opts.column, opts.value);\n },\n [this.IN_SQL]: (opts: IQueryHandlerOptions) =>\n buildSubqueryCondition({ ...opts, operator: this.IN_SQL, isNegated: false }),\n [this.NOT_IN_SQL]: (opts: IQueryHandlerOptions) =>\n buildSubqueryCondition({ ...opts, operator: this.NOT_IN_SQL, isNegated: true }),\n [this.NIN]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value)) {\n return ne(opts.column, opts.value);\n }\n return opts.value.length === 0 ? sql`true` : notInArray(opts.column, opts.value);\n },\n [this.BETWEEN]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value) || opts.value.length !== 2) {\n throw getError({\n message: `[PostgresQueryOperators][BETWEEN] Invalid value: expected array of 2 elements, got ${JSON.stringify(opts.value)}`,\n });\n }\n return between(opts.column, opts.value[0], opts.value[1]);\n },\n [this.NOT_BETWEEN]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value) || opts.value.length !== 2) {\n throw getError({\n message: `[PostgresQueryOperators][NOT_BETWEEN] Invalid value: expected array of 2 elements, got ${JSON.stringify(opts.value)}`,\n });\n }\n return not(between(opts.column, opts.value[0], opts.value[1]));\n },\n\n [this.CONTAINS]: (opts: IQueryHandlerOptions) => {\n const value = Array.isArray(opts.value) ? opts.value : [opts.value];\n if (value.length === 0) {\n return sql`true`;\n }\n return buildPgArrayComparison({ column: opts.column, value, operator: '@>' });\n },\n [this.CONTAINED_BY]: (opts: IQueryHandlerOptions) => {\n const value = Array.isArray(opts.value) ? opts.value : [opts.value];\n if (value.length === 0) {\n return sql`${opts.column} = '{}'`;\n }\n return buildPgArrayComparison({ column: opts.column, value, operator: '<@' });\n },\n [this.OVERLAPS]: (opts: IQueryHandlerOptions) => {\n const value = Array.isArray(opts.value) ? opts.value : [opts.value];\n if (value.length === 0) {\n return sql`false`;\n }\n return buildPgArrayComparison({ column: opts.column, value, operator: '&&' });\n },\n\n [this.LIKE]: (opts: IQueryHandlerOptions) => like(opts.column, opts.value),\n [this.NOT_LIKE]: (opts: IQueryHandlerOptions) => notLike(opts.column, opts.value),\n [this.ILIKE]: (opts: IQueryHandlerOptions) => ilike(opts.column, opts.value),\n [this.NOT_ILIKE]: (opts: IQueryHandlerOptions) => not(ilike(opts.column, opts.value)),\n\n [this.REGEXP]: (opts: IQueryHandlerOptions) => sql`${opts.column} ~ ${opts.value}`,\n [this.IREGEXP]: (opts: IQueryHandlerOptions) => sql`${opts.column} ~* ${opts.value}`,\n };\n}\n"]}
@@ -55,7 +55,7 @@ class LibSqlDriver {
55
55
  maxWaitingClients,
56
56
  scope: scope ?? LibSqlDriver.name,
57
57
  create: () => this.client,
58
- destroy: resource => this.scrubSession({ resource }),
58
+ destroy: (resource) => this.scrubSession({ resource }),
59
59
  });
60
60
  }
61
61
  createConnector(opts) {
@@ -115,7 +115,7 @@ class LibSqlDriver {
115
115
  // Discard cannot throw the connection away - there is one client and no
116
116
  // replacement. The slot is re-created from the same instance after the destroy
117
117
  // hook scrubs it, so the next waiter never inherits an unknown transaction.
118
- this.slot.discard({ resource: client }).catch(error => {
118
+ this.slot.discard({ resource: client }).catch((error) => {
119
119
  this.logger.for('release').error('Failed to discard the libsql slot | Error: %s', error);
120
120
  });
121
121
  },
@@ -1 +1 @@
1
- {"version":3,"file":"libsql.js","sourceRoot":"","sources":["../../../../../src/relational/sqlite/drivers/libsql.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';\nimport { throwNotSupported } from '@venizia/ignis-kernel';\nimport type { Client } from '@libsql/client';\nimport type { ILogger, IPoolControlOptions } from '@venizia/ignis-helpers/core';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, BasePoolHelper, getError } from '@venizia/ignis-helpers/core';\nimport { drizzle } from 'drizzle-orm/libsql';\nimport type { TSqliteConnection, TSqliteConnector, TSqliteDriver } from './driver';\n\n/**\n * libsql's own name for a local database file, the\n * only protocol whose statements share a connection.\n */\nconst FILE_PROTOCOL = 'file';\n\n/**\n * SQLite rejects ROLLBACK outside a transaction rather\n * than treating it as a no-op the way Postgres does.\n */\nconst NO_ACTIVE_TRANSACTION = 'no transaction is active';\n\n/**\n * Pool knobs the driver forwards, minus `size`: one slot\n * IS the mutual exclusion a single connection lacks.\n */\nexport type TLibSqlDriverOptions = Omit<IPoolControlOptions, 'size'> & { client: Client };\n\n/**\n * Covers `:memory:`, a local file, remote Turso and embedded replicas. Chosen over `better-sqlite3`\n * and `bun:sqlite` for its async result kind - those block the event loop.\n *\n * `acquire()` takes a 1-slot pool, not a second connection: `drizzle()` binds to a `Client`, never\n * to libsql's `Transaction`, and `client.transaction()` swaps the connection out - against\n * `:memory:` that is a DIFFERENT empty database.\n *\n * Consequence: a query on the `createConnector()` connector while a transaction is open runs INSIDE\n * it. Route work that must stay outside one through `acquire()`.\n */\nexport class LibSqlDriver<\n Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema,\n> implements TSqliteDriver<Schema, Client> {\n private readonly client: Client;\n\n /**\n * The pooled resource IS the single client, so `create()` always hands back the same instance.\n * The pool contributes mutual exclusion, not connection multiplicity.\n */\n private readonly slot: BasePoolHelper<Client>;\n\n private readonly logger: ILogger;\n\n /**\n * A leaked transaction never releases the one slot, so without a timeout every later `acquire()`\n * in the process hangs forever and silently. 30s outlasts any honest SQLite write transaction -\n * one writer at a time is the engine's own limit - and turns a leak into a named error.\n */\n static readonly DEFAULT_ACQUIRE_TIMEOUT_MS = 30_000;\n\n constructor(opts: TLibSqlDriverOptions) {\n const { client, acquireTimeoutMs, maxWaitingClients, scope } = opts;\n\n // A `bun:sqlite` / better-sqlite3 Database leads with prepare()/exec() and has none\n // of these, so the wrong driver class fails here rather than at the first query.\n const isLibSqlClient =\n typeof (client as AnyType)?.execute === 'function' &&\n typeof (client as AnyType)?.batch === 'function' &&\n typeof (client as AnyType)?.transaction === 'function' &&\n typeof (client as AnyType)?.protocol === 'string';\n\n if (!isLibSqlClient) {\n throw getError({\n message: `[${LibSqlDriver.name}] Expected an \\`@libsql/client\\` Client | Got a client without execute()/batch()/transaction() - a \\`bun:sqlite\\` Database? | Construct \\`createClient({ url: 'file:./data.db' })\\``,\n });\n }\n\n this.client = client;\n // Not `LoggerFactory`: it reaches the helpers root barrel, which pulls `ioredis` and fails a\n // browser bundle on `tls`.\n this.logger = new BaseHelper({ scope: LibSqlDriver.name }).getLogger();\n\n this.slot = new BasePoolHelper<Client>({\n size: 1,\n acquireTimeoutMs: acquireTimeoutMs ?? LibSqlDriver.DEFAULT_ACQUIRE_TIMEOUT_MS,\n maxWaitingClients,\n scope: scope ?? LibSqlDriver.name,\n create: () => this.client,\n destroy: resource => this.scrubSession({ resource }),\n });\n }\n\n createConnector(opts: { schema: Schema }): TSqliteConnector<Schema> {\n return drizzle({ client: this.client, schema: opts.schema });\n }\n\n async acquire(opts: { schema: Schema }): Promise<TSqliteConnection<Schema>> {\n // A remote client opens a stream per statement and closes it, so BEGIN would neither hold nor\n // error - the transaction would silently not exist.\n if (this.client.protocol !== FILE_PROTOCOL) {\n throwNotSupported({\n scope: LibSqlDriver.name,\n feature: `Explicit transactions over a '${this.client.protocol}' libsql client - every statement runs on its own connection, so BEGIN cannot hold; use a \\`file:\\` or \\`:memory:\\` url, or an embedded replica`,\n logger: this.logger,\n });\n }\n\n let client: Client;\n\n // The bare pool error names only a timeout; on one connection the cause is almost always an\n // unreleased transaction, so say so where the caller reads it.\n try {\n client = await this.slot.acquire();\n } catch (error) {\n throw getError({\n message: `[${LibSqlDriver.name}][acquire] Could not borrow the single libsql connection | ${(error as Error)?.message ?? String(error)} | An unreleased transaction still holds it - commit/rollback it, or raise \\`acquireTimeoutMs\\``,\n });\n }\n\n let connector: TSqliteConnector<Schema>;\n try {\n connector = drizzle({ client, schema: opts.schema });\n } catch (error) {\n this.slot.release({ resource: client });\n throw error;\n }\n\n // Every borrower gets the SAME object, so a stale handle releasing twice would hand the\n // slot away underneath whoever holds it now. The latch makes the second release a no-op.\n let isReleased = false;\n\n return {\n connector,\n\n execute: async (executeOpts: { statement: string }) => {\n const result = await client.execute(executeOpts.statement);\n return { count: result.rowsAffected ?? 0 };\n },\n\n query: async <R>(queryOpts: { statement: string }) => {\n const result = await client.execute(queryOpts.statement);\n return (result.rows ?? []) as Array<R>;\n },\n\n release: (releaseOpts?: { destroy?: boolean }) => {\n if (isReleased) {\n return;\n }\n isReleased = true;\n\n if (releaseOpts?.destroy !== true) {\n this.slot.release({ resource: client });\n return;\n }\n\n // Discard cannot throw the connection away - there is one client and no\n // replacement. The slot is re-created from the same instance after the destroy\n // hook scrubs it, so the next waiter never inherits an unknown transaction.\n this.slot.discard({ resource: client }).catch(error => {\n this.logger.for('release').error('Failed to discard the libsql slot | Error: %s', error);\n });\n },\n };\n }\n\n getClient(): Client {\n return this.client;\n }\n\n async end(): Promise<void> {\n await this.slot.destroy();\n this.client.close();\n }\n\n /**\n * The pool's destroy hook. A failed COMMIT/ROLLBACK may leave the connection inside a transaction\n * and the next borrower would inherit it. The client offers no way to ask whether one is open, so\n * the ROLLBACK is issued blind and its rejection is the ordinary answer of a clean connection.\n */\n private async scrubSession(opts: { resource: Client }): Promise<void> {\n const { resource } = opts;\n\n if (resource.closed) {\n return;\n }\n\n try {\n await resource.execute('ROLLBACK');\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n\n if (message.includes(NO_ACTIVE_TRANSACTION)) {\n this.logger.for(this.scrubSession.name).debug('Nothing to scrub | %s', message);\n return;\n }\n\n this.logger\n .for(this.scrubSession.name)\n .warn('Failed to scrub the libsql session | Error: %s', error);\n }\n }\n}\n"]}
1
+ {"version":3,"file":"libsql.js","sourceRoot":"","sources":["../../../../../src/relational/sqlite/drivers/libsql.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';\nimport { throwNotSupported } from '@venizia/ignis-kernel';\nimport type { Client } from '@libsql/client';\nimport type { ILogger, IPoolControlOptions } from '@venizia/ignis-helpers/core';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, BasePoolHelper, getError } from '@venizia/ignis-helpers/core';\nimport { drizzle } from 'drizzle-orm/libsql';\nimport type { TSqliteConnection, TSqliteConnector, TSqliteDriver } from './driver';\n\n/**\n * libsql's own name for a local database file, the\n * only protocol whose statements share a connection.\n */\nconst FILE_PROTOCOL = 'file';\n\n/**\n * SQLite rejects ROLLBACK outside a transaction rather\n * than treating it as a no-op the way Postgres does.\n */\nconst NO_ACTIVE_TRANSACTION = 'no transaction is active';\n\n/**\n * Pool knobs the driver forwards, minus `size`: one slot\n * IS the mutual exclusion a single connection lacks.\n */\nexport type TLibSqlDriverOptions = Omit<IPoolControlOptions, 'size'> & { client: Client };\n\n/**\n * Covers `:memory:`, a local file, remote Turso and embedded replicas. Chosen over `better-sqlite3`\n * and `bun:sqlite` for its async result kind - those block the event loop.\n *\n * `acquire()` takes a 1-slot pool, not a second connection: `drizzle()` binds to a `Client`, never\n * to libsql's `Transaction`, and `client.transaction()` swaps the connection out - against\n * `:memory:` that is a DIFFERENT empty database.\n *\n * Consequence: a query on the `createConnector()` connector while a transaction is open runs INSIDE\n * it. Route work that must stay outside one through `acquire()`.\n */\nexport class LibSqlDriver<\n Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema,\n> implements TSqliteDriver<Schema, Client> {\n private readonly client: Client;\n\n /**\n * The pooled resource IS the single client, so `create()` always hands back the same instance.\n * The pool contributes mutual exclusion, not connection multiplicity.\n */\n private readonly slot: BasePoolHelper<Client>;\n\n private readonly logger: ILogger;\n\n /**\n * A leaked transaction never releases the one slot, so without a timeout every later `acquire()`\n * in the process hangs forever and silently. 30s outlasts any honest SQLite write transaction -\n * one writer at a time is the engine's own limit - and turns a leak into a named error.\n */\n static readonly DEFAULT_ACQUIRE_TIMEOUT_MS = 30_000;\n\n constructor(opts: TLibSqlDriverOptions) {\n const { client, acquireTimeoutMs, maxWaitingClients, scope } = opts;\n\n // A `bun:sqlite` / better-sqlite3 Database leads with prepare()/exec() and has none\n // of these, so the wrong driver class fails here rather than at the first query.\n const isLibSqlClient =\n typeof (client as AnyType)?.execute === 'function' &&\n typeof (client as AnyType)?.batch === 'function' &&\n typeof (client as AnyType)?.transaction === 'function' &&\n typeof (client as AnyType)?.protocol === 'string';\n\n if (!isLibSqlClient) {\n throw getError({\n message: `[${LibSqlDriver.name}] Expected an \\`@libsql/client\\` Client | Got a client without execute()/batch()/transaction() - a \\`bun:sqlite\\` Database? | Construct \\`createClient({ url: 'file:./data.db' })\\``,\n });\n }\n\n this.client = client;\n // Not `LoggerFactory`: it reaches the helpers root barrel, which pulls `ioredis` and fails a\n // browser bundle on `tls`.\n this.logger = new BaseHelper({ scope: LibSqlDriver.name }).getLogger();\n\n this.slot = new BasePoolHelper<Client>({\n size: 1,\n acquireTimeoutMs: acquireTimeoutMs ?? LibSqlDriver.DEFAULT_ACQUIRE_TIMEOUT_MS,\n maxWaitingClients,\n scope: scope ?? LibSqlDriver.name,\n create: () => this.client,\n destroy: (resource) => this.scrubSession({ resource }),\n });\n }\n\n createConnector(opts: { schema: Schema }): TSqliteConnector<Schema> {\n return drizzle({ client: this.client, schema: opts.schema });\n }\n\n async acquire(opts: { schema: Schema }): Promise<TSqliteConnection<Schema>> {\n // A remote client opens a stream per statement and closes it, so BEGIN would neither hold nor\n // error - the transaction would silently not exist.\n if (this.client.protocol !== FILE_PROTOCOL) {\n throwNotSupported({\n scope: LibSqlDriver.name,\n feature: `Explicit transactions over a '${this.client.protocol}' libsql client - every statement runs on its own connection, so BEGIN cannot hold; use a \\`file:\\` or \\`:memory:\\` url, or an embedded replica`,\n logger: this.logger,\n });\n }\n\n let client: Client;\n\n // The bare pool error names only a timeout; on one connection the cause is almost always an\n // unreleased transaction, so say so where the caller reads it.\n try {\n client = await this.slot.acquire();\n } catch (error) {\n throw getError({\n message: `[${LibSqlDriver.name}][acquire] Could not borrow the single libsql connection | ${(error as Error)?.message ?? String(error)} | An unreleased transaction still holds it - commit/rollback it, or raise \\`acquireTimeoutMs\\``,\n });\n }\n\n let connector: TSqliteConnector<Schema>;\n try {\n connector = drizzle({ client, schema: opts.schema });\n } catch (error) {\n this.slot.release({ resource: client });\n throw error;\n }\n\n // Every borrower gets the SAME object, so a stale handle releasing twice would hand the\n // slot away underneath whoever holds it now. The latch makes the second release a no-op.\n let isReleased = false;\n\n return {\n connector,\n\n execute: async (executeOpts: { statement: string }) => {\n const result = await client.execute(executeOpts.statement);\n return { count: result.rowsAffected ?? 0 };\n },\n\n query: async <R>(queryOpts: { statement: string }) => {\n const result = await client.execute(queryOpts.statement);\n return (result.rows ?? []) as Array<R>;\n },\n\n release: (releaseOpts?: { destroy?: boolean }) => {\n if (isReleased) {\n return;\n }\n isReleased = true;\n\n if (releaseOpts?.destroy !== true) {\n this.slot.release({ resource: client });\n return;\n }\n\n // Discard cannot throw the connection away - there is one client and no\n // replacement. The slot is re-created from the same instance after the destroy\n // hook scrubs it, so the next waiter never inherits an unknown transaction.\n this.slot.discard({ resource: client }).catch((error) => {\n this.logger.for('release').error('Failed to discard the libsql slot | Error: %s', error);\n });\n },\n };\n }\n\n getClient(): Client {\n return this.client;\n }\n\n async end(): Promise<void> {\n await this.slot.destroy();\n this.client.close();\n }\n\n /**\n * The pool's destroy hook. A failed COMMIT/ROLLBACK may leave the connection inside a transaction\n * and the next borrower would inherit it. The client offers no way to ask whether one is open, so\n * the ROLLBACK is issued blind and its rejection is the ordinary answer of a clean connection.\n */\n private async scrubSession(opts: { resource: Client }): Promise<void> {\n const { resource } = opts;\n\n if (resource.closed) {\n return;\n }\n\n try {\n await resource.execute('ROLLBACK');\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n\n if (message.includes(NO_ACTIVE_TRANSACTION)) {\n this.logger.for(this.scrubSession.name).debug('Nothing to scrub | %s', message);\n return;\n }\n\n this.logger\n .for(this.scrubSession.name)\n .warn('Failed to scrub the libsql session | Error: %s', error);\n }\n }\n}\n"]}
@@ -14,7 +14,7 @@ const isAmbiguousComponent = (opts) => /^\d+$/.test(opts.part);
14
14
  */
15
15
  const toSqliteJsonPaths = (opts) => {
16
16
  const { path } = opts;
17
- const ambiguousCount = path.filter(part => isAmbiguousComponent({ part })).length;
17
+ const ambiguousCount = path.filter((part) => isAmbiguousComponent({ part })).length;
18
18
  if (ambiguousCount > MAX_AMBIGUOUS_COMPONENTS) {
19
19
  throw (0, core_1.getError)({
20
20
  message: `[toSqliteJsonPaths] Ambiguous JSON path components over the limit | max: ${MAX_AMBIGUOUS_COMPONENTS} | got: ${ambiguousCount} | each all-digit component doubles the candidate paths`,
@@ -23,8 +23,8 @@ const toSqliteJsonPaths = (opts) => {
23
23
  let literals = ['$'];
24
24
  for (const part of path) {
25
25
  literals = isAmbiguousComponent({ part })
26
- ? literals.flatMap(literal => [`${literal}[${part}]`, `${literal}."${part}"`])
27
- : literals.map(literal => `${literal}."${part}"`);
26
+ ? literals.flatMap((literal) => [`${literal}[${part}]`, `${literal}."${part}"`])
27
+ : literals.map((literal) => `${literal}."${part}"`);
28
28
  }
29
29
  return literals;
30
30
  };
@@ -1 +1 @@
1
- {"version":3,"file":"json-path.js","sourceRoot":"","sources":["../../../../../../../src/relational/sqlite/repositories/dialect/internal/json-path.ts"],"names":[],"mappings":";;;AACA,sDAAuD;AAEvD,6CAA0C;AAE1C,kGAAkG;AAClG,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAEnC,MAAM,oBAAoB,GAAG,CAAC,IAAsB,EAAW,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE1F;;;;;GAKG;AACI,MAAM,iBAAiB,GAAG,CAAC,IAAwB,EAAY,EAAE;IACtE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAEtB,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAClF,IAAI,cAAc,GAAG,wBAAwB,EAAE,CAAC;QAC9C,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE,4EAA4E,wBAAwB,WAAW,cAAc,yDAAyD;SAChM,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,QAAQ,GAAG,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC;YACvC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,GAAG,EAAE,GAAG,OAAO,KAAK,IAAI,GAAG,CAAC,CAAC;YAC9E,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,KAAK,IAAI,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAnBW,QAAA,iBAAiB,qBAmB5B;AAEF,MAAM,eAAe,GAAG,IAAI,yBAAW,CAAC,eAAe,CAAC,CAAC;AACzD,MAAM,yBAAyB,GAAG,IAAI,yBAAW,CAAC,wBAAwB,CAAC,CAAC;AAE5E;;;;;;;;GAQG;AACI,MAAM,4BAA4B,GAAG,CAAC,IAG5C,EAAc,EAAE;IACf,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAE9B,MAAM,QAAQ,GAAG,IAAA,yBAAiB,EAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACtC,2FAA2F;IAC3F,MAAM,MAAM,GAAe,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC;IAE3F,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,yBAAW,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,yBAAW,CAAC,MAAM,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;IAE7E,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAnBW,QAAA,4BAA4B,gCAmBvC","sourcesContent":["import type { TTableColumns } from '@/relational/core/repositories/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { SQLChunk } from 'drizzle-orm';\nimport { StringChunk } from 'drizzle-orm';\n\n/** Every all-digit component doubles the candidate paths, and filter keys arrive from callers. */\nconst MAX_AMBIGUOUS_COMPONENTS = 4;\n\nconst isAmbiguousComponent = (opts: { part: string }): boolean => /^\\d+$/.test(opts.part);\n\n/**\n * Every path literal a component sequence can mean, array reading first. SQLite cannot\n * express both readings of an all-digit component at once - `$.\"c\"[0]` is an array element,\n * `$.\"c\".\"0\"` an object key, and neither falls back to the other - while Postgres's `#>>\n * '{c,0}'` addresses both. Handing SQLite every candidate is what makes the engines agree.\n */\nexport const toSqliteJsonPaths = (opts: { path: string[] }): string[] => {\n const { path } = opts;\n\n const ambiguousCount = path.filter(part => isAmbiguousComponent({ part })).length;\n if (ambiguousCount > MAX_AMBIGUOUS_COMPONENTS) {\n throw getError({\n message: `[toSqliteJsonPaths] Ambiguous JSON path components over the limit | max: ${MAX_AMBIGUOUS_COMPONENTS} | got: ${ambiguousCount} | each all-digit component doubles the candidate paths`,\n });\n }\n\n let literals = ['$'];\n\n for (const part of path) {\n literals = isAmbiguousComponent({ part })\n ? literals.flatMap(literal => [`${literal}[${part}]`, `${literal}.\"${part}\"`])\n : literals.map(literal => `${literal}.\"${part}\"`);\n }\n\n return literals;\n};\n\nconst EXTRACTION_OPEN = new StringChunk('json_extract(');\nconst COALESCED_EXTRACTION_OPEN = new StringChunk('coalesce(json_extract(');\n\n/**\n * The `json_extract` expression for one JSON-path key, as the chunks of one flat fragment (every\n * nested `SQL` level costs a render pass); a caller may append a chunk before `sql.fromList`. The\n * Drizzle column chunk is qualified or aliased like a plain key. The path literal is raw text, safe\n * only because every component has passed `validateJsonPathComponents`, which admits no quote.\n *\n * Coalescing loses nothing: a container is either an array or an object, so at most one candidate\n * resolves to non-NULL.\n */\nexport const toSqliteJsonExtractionChunks = (opts: {\n column: TTableColumns[string];\n path: string[];\n}): SQLChunk[] => {\n const { column, path } = opts;\n\n const literals = toSqliteJsonPaths({ path });\n const lastIndex = literals.length - 1;\n // json_extract(col, 'L') | coalesce(json_extract(col, 'L0'), ..., json_extract(col, 'Ln'))\n const chunks: SQLChunk[] = [lastIndex === 0 ? EXTRACTION_OPEN : COALESCED_EXTRACTION_OPEN];\n\n for (let index = 0; index < lastIndex; index++) {\n chunks.push(column, new StringChunk(`, '${literals[index]}'), json_extract(`));\n }\n\n const closing = lastIndex === 0 ? ')' : '))';\n chunks.push(column, new StringChunk(`, '${literals[lastIndex]}'${closing}`));\n\n return chunks;\n};\n"]}
1
+ {"version":3,"file":"json-path.js","sourceRoot":"","sources":["../../../../../../../src/relational/sqlite/repositories/dialect/internal/json-path.ts"],"names":[],"mappings":";;;AACA,sDAAuD;AAEvD,6CAA0C;AAE1C,kGAAkG;AAClG,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAEnC,MAAM,oBAAoB,GAAG,CAAC,IAAsB,EAAW,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE1F;;;;;GAKG;AACI,MAAM,iBAAiB,GAAG,CAAC,IAAwB,EAAY,EAAE;IACtE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAEtB,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IACpF,IAAI,cAAc,GAAG,wBAAwB,EAAE,CAAC;QAC9C,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE,4EAA4E,wBAAwB,WAAW,cAAc,yDAAyD;SAChM,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,QAAQ,GAAG,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC;YACvC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,GAAG,EAAE,GAAG,OAAO,KAAK,IAAI,GAAG,CAAC,CAAC;YAChF,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,KAAK,IAAI,GAAG,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAnBW,QAAA,iBAAiB,qBAmB5B;AAEF,MAAM,eAAe,GAAG,IAAI,yBAAW,CAAC,eAAe,CAAC,CAAC;AACzD,MAAM,yBAAyB,GAAG,IAAI,yBAAW,CAAC,wBAAwB,CAAC,CAAC;AAE5E;;;;;;;;GAQG;AACI,MAAM,4BAA4B,GAAG,CAAC,IAG5C,EAAc,EAAE;IACf,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAE9B,MAAM,QAAQ,GAAG,IAAA,yBAAiB,EAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACtC,2FAA2F;IAC3F,MAAM,MAAM,GAAe,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC;IAE3F,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,yBAAW,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,yBAAW,CAAC,MAAM,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;IAE7E,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAnBW,QAAA,4BAA4B,gCAmBvC","sourcesContent":["import type { TTableColumns } from '@/relational/core/repositories/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { SQLChunk } from 'drizzle-orm';\nimport { StringChunk } from 'drizzle-orm';\n\n/** Every all-digit component doubles the candidate paths, and filter keys arrive from callers. */\nconst MAX_AMBIGUOUS_COMPONENTS = 4;\n\nconst isAmbiguousComponent = (opts: { part: string }): boolean => /^\\d+$/.test(opts.part);\n\n/**\n * Every path literal a component sequence can mean, array reading first. SQLite cannot\n * express both readings of an all-digit component at once - `$.\"c\"[0]` is an array element,\n * `$.\"c\".\"0\"` an object key, and neither falls back to the other - while Postgres's `#>>\n * '{c,0}'` addresses both. Handing SQLite every candidate is what makes the engines agree.\n */\nexport const toSqliteJsonPaths = (opts: { path: string[] }): string[] => {\n const { path } = opts;\n\n const ambiguousCount = path.filter((part) => isAmbiguousComponent({ part })).length;\n if (ambiguousCount > MAX_AMBIGUOUS_COMPONENTS) {\n throw getError({\n message: `[toSqliteJsonPaths] Ambiguous JSON path components over the limit | max: ${MAX_AMBIGUOUS_COMPONENTS} | got: ${ambiguousCount} | each all-digit component doubles the candidate paths`,\n });\n }\n\n let literals = ['$'];\n\n for (const part of path) {\n literals = isAmbiguousComponent({ part })\n ? literals.flatMap((literal) => [`${literal}[${part}]`, `${literal}.\"${part}\"`])\n : literals.map((literal) => `${literal}.\"${part}\"`);\n }\n\n return literals;\n};\n\nconst EXTRACTION_OPEN = new StringChunk('json_extract(');\nconst COALESCED_EXTRACTION_OPEN = new StringChunk('coalesce(json_extract(');\n\n/**\n * The `json_extract` expression for one JSON-path key, as the chunks of one flat fragment (every\n * nested `SQL` level costs a render pass); a caller may append a chunk before `sql.fromList`. The\n * Drizzle column chunk is qualified or aliased like a plain key. The path literal is raw text, safe\n * only because every component has passed `validateJsonPathComponents`, which admits no quote.\n *\n * Coalescing loses nothing: a container is either an array or an object, so at most one candidate\n * resolves to non-NULL.\n */\nexport const toSqliteJsonExtractionChunks = (opts: {\n column: TTableColumns[string];\n path: string[];\n}): SQLChunk[] => {\n const { column, path } = opts;\n\n const literals = toSqliteJsonPaths({ path });\n const lastIndex = literals.length - 1;\n // json_extract(col, 'L') | coalesce(json_extract(col, 'L0'), ..., json_extract(col, 'Ln'))\n const chunks: SQLChunk[] = [lastIndex === 0 ? EXTRACTION_OPEN : COALESCED_EXTRACTION_OPEN];\n\n for (let index = 0; index < lastIndex; index++) {\n chunks.push(column, new StringChunk(`, '${literals[index]}'), json_extract(`));\n }\n\n const closing = lastIndex === 0 ? ')' : '))';\n chunks.push(column, new StringChunk(`, '${literals[lastIndex]}'${closing}`));\n\n return chunks;\n};\n"]}
@@ -40,7 +40,7 @@ class BaseSearchConnector extends core_1.BaseHelper {
40
40
  notFoundTolerance(opts) {
41
41
  const { method, subject } = opts;
42
42
  return {
43
- when: error => this.isNotFoundError({ error }),
43
+ when: (error) => this.isNotFoundError({ error }),
44
44
  handle: () => {
45
45
  this.logger.for(method).debug('%s not found', subject);
46
46
  internal_1.SearchConnectorInternal.throwNotFoundError({ method, subject });
@@ -51,7 +51,7 @@ class BaseSearchConnector extends core_1.BaseHelper {
51
51
  notFoundFallback(opts) {
52
52
  const { method, message, args, fallback } = opts;
53
53
  return {
54
- when: error => this.isNotFoundError({ error }),
54
+ when: (error) => this.isNotFoundError({ error }),
55
55
  handle: () => {
56
56
  this.logger.for(method).debug(message, ...(args ?? []));
57
57
  return fallback;
@@ -1 +1 @@
1
- {"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../../src/search/core/connector.ts"],"names":[],"mappings":";;;AAEA,sDAAuF;AACvF,yCAAqD;AA8IrD,MAAsB,mBAAoB,SAAQ,iBAAU;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,IAAA,eAAQ,EAAC,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,IAAA,yBAAkB,EAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,kCAAuB,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,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAC9C,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;gBACvD,kCAAuB,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,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAC9C,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;AAhGD,kDAgGC","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,sDAAuF;AACvF,yCAAqD;AA8IrD,MAAsB,mBAAoB,SAAQ,iBAAU;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,IAAA,eAAQ,EAAC,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,IAAA,yBAAkB,EAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,kCAAuB,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,kCAAuB,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;AAhGD,kDAgGC","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 +1 @@
1
- {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../src/search/core/controllers/factory.ts"],"names":[],"mappings":";;;AAEA,wDAAwF;AAKxF,sDAAmE;AACnE,8DAAmD;AAGnD,yCAAsD;AACtD,6CAAwD;AAmCxD,wHAAwH;AACxH,MAAa,uBAAwB,SAAQ,iBAAU;IACrD;QACE,KAAK,CAAC,EAAE,KAAK,EAAE,uBAAuB,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,wLAAwL;IACxL,MAAM,CAAC,sBAAsB,CAO3B,OAA0C;QAC1C,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAExE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,cAAc,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,UAAU,CAAC;QACxE,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;YAC7C,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,gEAAgE,IAAI,gBAAgB,QAAQ,EAAE;aACxG,CAAC,CAAC;QACL,CAAC;QAED,MAAM,WAAW,GAAG,IAAA,yBAAO,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACxD,MAAM,cAAc,GAAG,IAAI,WAAW,EAAE,CAAC;QAEzC,MAAM,YAAY,GAAG,cAAc,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,0BAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5E,MAAM,gBAAgB,GAAG,IAAA,qCAAwB,EAAC,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;QAE7F,MAAM,eAAe,GAAG,KAAM,SAAQ,mCAOrC;YACC,YAAY,UAAiD;gBAC3D,KAAK,CAAC;oBACJ,KAAK,EAAE,IAAI;oBACX,IAAI,EAAE,QAAQ;oBACd,QAAQ;oBACR,UAAU;oBACV,WAAW,EAAE,gBAAgB;iBAC9B,CAAC,CAAC;YACL,CAAC;YAED,0FAA0F;YACjF,OAAO;gBACd,MAAM,SAAS,GAAG,CAAC,QAAyC,EAAE,EAAE;oBAC9D,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,KAAK,KAAK,CAAC;gBAC/C,CAAC,CAAC;gBAEF,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACxB,IAAI,CAAC,WAAW,CAAC;wBACf,OAAO,EAAE,gBAAgB,CAAC,MAAM;wBAChC,OAAO,EAAE,KAAK,EAAC,OAAO,EAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;qBACnD,CAAC,CAAC;gBACL,CAAC;gBAED,IAAI,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC;oBAC7B,IAAI,CAAC,WAAW,CAAC;wBACf,OAAO,EAAE,gBAAgB,CAAC,YAAY;wBACtC,OAAO,EAAE,KAAK,EAAC,OAAO,EAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;qBACxD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF,CAAC;QAEF,MAAM,CAAC,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QACpF,IAAA,iDAAkC,EAAC;YACjC,MAAM,EAAE,eAAe;YACvB,WAAW,EAAE,wBAAwB;YACrC,cAAc,EAAE,IAAI;YACpB,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,IAAI;SACxC,CAAC,CAAC;QACH,OAAO,eAAe,CAAC;IACzB,CAAC;CACF;AA9ED,0DA8EC","sourcesContent":["import type { TEntityDataObject } from '@venizia/ignis-kernel';\nimport type { AbstractEntity } from '@venizia/ignis-kernel';\nimport { registerFactoryRepositoryInjection, SchemaTypes } from '@venizia/ignis-kernel';\nimport type { TAuthMode, TAuthStrategy } from '@venizia/ignis-kernel';\nimport type { IAuthorizationSpec } from '@venizia/ignis-kernel';\nimport type { TAnyObjectSchema } from '@venizia/ignis-kernel';\nimport type { TClass, TResolver, ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError } from '@venizia/ignis-helpers/core';\nimport { isClass } from '@venizia/ignis-inversion';\nimport type { Env, Schema } from 'hono';\nimport type { ReadableSearchRepository } from '../repositories/core/readable';\nimport { AbstractSearchController } from './abstract';\nimport { defineSearchRouteConfigs } from './definition';\n\n/** Per-route enable/disable switches for the generated search controller. */\nexport interface ISearchCustomizableRoutes {\n search?: { enabled?: boolean };\n multiSearch?: { enabled?: boolean };\n}\n\n/** Configuration options for creating a search controller via SearchControllerFactory.defineSearchController. */\nexport interface ISearchControllerOptions<\n TEntity extends AbstractEntity<TAnyObjectSchema> = AbstractEntity<TAnyObjectSchema>,\n> {\n /** Entity class or resolver returning it; its SELECT schema drives the `hits[].document` shape in the generated route's response. */\n entity: TClass<TEntity> | TResolver<TClass<TEntity>>;\n\n repository: {\n name: string; // Repository binding name in the IoC container\n };\n\n controller: {\n name: string;\n basePath: string;\n isStrict?: boolean;\n };\n\n /** Authentication config applied to both generated routes. */\n authenticate?: { strategies?: TAuthStrategy[]; mode?: TAuthMode };\n\n /** Authorization config applied to both generated routes. */\n authorize?: IAuthorizationSpec | IAuthorizationSpec[];\n\n /** Per-route enable/disable configuration. */\n routes?: ISearchCustomizableRoutes;\n}\n\n/** Factory for generating turnkey search controllers (single-collection + cross-collection) from entity definitions. */\nexport class SearchControllerFactory extends BaseHelper {\n constructor() {\n super({ scope: SearchControllerFactory.name });\n }\n\n /** Creates a search controller with two endpoints: `POST {basePath}/search` via `repository.search()`, and `POST {basePath}/multi-search` via `repository.dataSource.multiSearch()`. */\n static defineSearchController<\n TEntity extends AbstractEntity<TAnyObjectSchema> = AbstractEntity<TAnyObjectSchema>,\n RouteEnv extends Env = Env,\n RouteSchema extends Schema = {},\n BasePath extends string = '/',\n ConfigurableOptions extends object = {},\n TDataObject extends object = TEntityDataObject<TEntity>,\n >(defOpts: ISearchControllerOptions<TEntity>) {\n const { controller, entity, authenticate, authorize, routes } = defOpts;\n\n const { name, basePath = 'unknown_path', isStrict = true } = controller;\n if (!basePath || basePath === 'unknown_path') {\n throw getError({\n message: `[defineSearchController] Invalid controller basePath | name: ${name} | basePath: ${basePath}`,\n });\n }\n\n const entityClass = isClass(entity) ? entity : entity();\n const entityInstance = new entityClass();\n\n const selectSchema = entityInstance.getSchema({ type: SchemaTypes.SELECT });\n const routeDefinitions = defineSearchRouteConfigs({ selectSchema, authenticate, authorize });\n\n const controllerClass = class extends AbstractSearchController<\n TEntity,\n RouteEnv,\n RouteSchema,\n BasePath,\n ConfigurableOptions,\n TDataObject\n > {\n constructor(repository: ReadableSearchRepository<TDataObject>) {\n super({\n scope: name,\n path: basePath,\n isStrict,\n repository,\n definitions: routeDefinitions,\n });\n }\n\n /** Registers the search + multiSearch route handlers, honoring per-route enable flags. */\n override binding(): ValueOrPromise<void> {\n const isEnabled = (routeKey: keyof ISearchCustomizableRoutes) => {\n return routes?.[routeKey]?.enabled !== false;\n };\n\n if (isEnabled('search')) {\n this.defineRoute({\n configs: routeDefinitions.SEARCH,\n handler: async context => this.search({ context }),\n });\n }\n\n if (isEnabled('multiSearch')) {\n this.defineRoute({\n configs: routeDefinitions.MULTI_SEARCH,\n handler: async context => this.multiSearch({ context }),\n });\n }\n }\n };\n\n Object.defineProperty(controllerClass, 'name', { value: name, configurable: true });\n registerFactoryRepositoryInjection({\n target: controllerClass,\n factoryName: 'defineSearchController',\n controllerName: name,\n repositoryName: defOpts.repository.name,\n });\n return controllerClass;\n }\n}\n"]}
1
+ {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../src/search/core/controllers/factory.ts"],"names":[],"mappings":";;;AAEA,wDAAwF;AAKxF,sDAAmE;AACnE,8DAAmD;AAGnD,yCAAsD;AACtD,6CAAwD;AAmCxD,wHAAwH;AACxH,MAAa,uBAAwB,SAAQ,iBAAU;IACrD;QACE,KAAK,CAAC,EAAE,KAAK,EAAE,uBAAuB,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,wLAAwL;IACxL,MAAM,CAAC,sBAAsB,CAO3B,OAA0C;QAC1C,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAExE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,cAAc,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,UAAU,CAAC;QACxE,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;YAC7C,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,gEAAgE,IAAI,gBAAgB,QAAQ,EAAE;aACxG,CAAC,CAAC;QACL,CAAC;QAED,MAAM,WAAW,GAAG,IAAA,yBAAO,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACxD,MAAM,cAAc,GAAG,IAAI,WAAW,EAAE,CAAC;QAEzC,MAAM,YAAY,GAAG,cAAc,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,0BAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5E,MAAM,gBAAgB,GAAG,IAAA,qCAAwB,EAAC,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;QAE7F,MAAM,eAAe,GAAG,KAAM,SAAQ,mCAOrC;YACC,YAAY,UAAiD;gBAC3D,KAAK,CAAC;oBACJ,KAAK,EAAE,IAAI;oBACX,IAAI,EAAE,QAAQ;oBACd,QAAQ;oBACR,UAAU;oBACV,WAAW,EAAE,gBAAgB;iBAC9B,CAAC,CAAC;YACL,CAAC;YAED,0FAA0F;YACjF,OAAO;gBACd,MAAM,SAAS,GAAG,CAAC,QAAyC,EAAE,EAAE;oBAC9D,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,KAAK,KAAK,CAAC;gBAC/C,CAAC,CAAC;gBAEF,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACxB,IAAI,CAAC,WAAW,CAAC;wBACf,OAAO,EAAE,gBAAgB,CAAC,MAAM;wBAChC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;qBACrD,CAAC,CAAC;gBACL,CAAC;gBAED,IAAI,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC;oBAC7B,IAAI,CAAC,WAAW,CAAC;wBACf,OAAO,EAAE,gBAAgB,CAAC,YAAY;wBACtC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;qBAC1D,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF,CAAC;QAEF,MAAM,CAAC,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QACpF,IAAA,iDAAkC,EAAC;YACjC,MAAM,EAAE,eAAe;YACvB,WAAW,EAAE,wBAAwB;YACrC,cAAc,EAAE,IAAI;YACpB,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,IAAI;SACxC,CAAC,CAAC;QACH,OAAO,eAAe,CAAC;IACzB,CAAC;CACF;AA9ED,0DA8EC","sourcesContent":["import type { TEntityDataObject } from '@venizia/ignis-kernel';\nimport type { AbstractEntity } from '@venizia/ignis-kernel';\nimport { registerFactoryRepositoryInjection, SchemaTypes } from '@venizia/ignis-kernel';\nimport type { TAuthMode, TAuthStrategy } from '@venizia/ignis-kernel';\nimport type { IAuthorizationSpec } from '@venizia/ignis-kernel';\nimport type { TAnyObjectSchema } from '@venizia/ignis-kernel';\nimport type { TClass, TResolver, ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError } from '@venizia/ignis-helpers/core';\nimport { isClass } from '@venizia/ignis-inversion';\nimport type { Env, Schema } from 'hono';\nimport type { ReadableSearchRepository } from '../repositories/core/readable';\nimport { AbstractSearchController } from './abstract';\nimport { defineSearchRouteConfigs } from './definition';\n\n/** Per-route enable/disable switches for the generated search controller. */\nexport interface ISearchCustomizableRoutes {\n search?: { enabled?: boolean };\n multiSearch?: { enabled?: boolean };\n}\n\n/** Configuration options for creating a search controller via SearchControllerFactory.defineSearchController. */\nexport interface ISearchControllerOptions<\n TEntity extends AbstractEntity<TAnyObjectSchema> = AbstractEntity<TAnyObjectSchema>,\n> {\n /** Entity class or resolver returning it; its SELECT schema drives the `hits[].document` shape in the generated route's response. */\n entity: TClass<TEntity> | TResolver<TClass<TEntity>>;\n\n repository: {\n name: string; // Repository binding name in the IoC container\n };\n\n controller: {\n name: string;\n basePath: string;\n isStrict?: boolean;\n };\n\n /** Authentication config applied to both generated routes. */\n authenticate?: { strategies?: TAuthStrategy[]; mode?: TAuthMode };\n\n /** Authorization config applied to both generated routes. */\n authorize?: IAuthorizationSpec | IAuthorizationSpec[];\n\n /** Per-route enable/disable configuration. */\n routes?: ISearchCustomizableRoutes;\n}\n\n/** Factory for generating turnkey search controllers (single-collection + cross-collection) from entity definitions. */\nexport class SearchControllerFactory extends BaseHelper {\n constructor() {\n super({ scope: SearchControllerFactory.name });\n }\n\n /** Creates a search controller with two endpoints: `POST {basePath}/search` via `repository.search()`, and `POST {basePath}/multi-search` via `repository.dataSource.multiSearch()`. */\n static defineSearchController<\n TEntity extends AbstractEntity<TAnyObjectSchema> = AbstractEntity<TAnyObjectSchema>,\n RouteEnv extends Env = Env,\n RouteSchema extends Schema = {},\n BasePath extends string = '/',\n ConfigurableOptions extends object = {},\n TDataObject extends object = TEntityDataObject<TEntity>,\n >(defOpts: ISearchControllerOptions<TEntity>) {\n const { controller, entity, authenticate, authorize, routes } = defOpts;\n\n const { name, basePath = 'unknown_path', isStrict = true } = controller;\n if (!basePath || basePath === 'unknown_path') {\n throw getError({\n message: `[defineSearchController] Invalid controller basePath | name: ${name} | basePath: ${basePath}`,\n });\n }\n\n const entityClass = isClass(entity) ? entity : entity();\n const entityInstance = new entityClass();\n\n const selectSchema = entityInstance.getSchema({ type: SchemaTypes.SELECT });\n const routeDefinitions = defineSearchRouteConfigs({ selectSchema, authenticate, authorize });\n\n const controllerClass = class extends AbstractSearchController<\n TEntity,\n RouteEnv,\n RouteSchema,\n BasePath,\n ConfigurableOptions,\n TDataObject\n > {\n constructor(repository: ReadableSearchRepository<TDataObject>) {\n super({\n scope: name,\n path: basePath,\n isStrict,\n repository,\n definitions: routeDefinitions,\n });\n }\n\n /** Registers the search + multiSearch route handlers, honoring per-route enable flags. */\n override binding(): ValueOrPromise<void> {\n const isEnabled = (routeKey: keyof ISearchCustomizableRoutes) => {\n return routes?.[routeKey]?.enabled !== false;\n };\n\n if (isEnabled('search')) {\n this.defineRoute({\n configs: routeDefinitions.SEARCH,\n handler: async (context) => this.search({ context }),\n });\n }\n\n if (isEnabled('multiSearch')) {\n this.defineRoute({\n configs: routeDefinitions.MULTI_SEARCH,\n handler: async (context) => this.multiSearch({ context }),\n });\n }\n }\n };\n\n Object.defineProperty(controllerClass, 'name', { value: name, configurable: true });\n registerFactoryRepositoryInjection({\n target: controllerClass,\n factoryName: 'defineSearchController',\n controllerName: name,\n repositoryName: defOpts.repository.name,\n });\n return controllerClass;\n }\n}\n"]}
@@ -53,7 +53,7 @@ class BaseSearchDataSource extends abstract_1.AbstractSearchDataSource {
53
53
  const dialect = this.getQueryDialect();
54
54
  const hiddenByCollection = this.hiddenFieldsByCollection();
55
55
  // Same friendly -> wire mapping search() uses, unioning each entry's hidden fields into excludeFields per collection.
56
- const wireSearches = searches.map(entry => ({
56
+ const wireSearches = searches.map((entry) => ({
57
57
  collection: entry.collection,
58
58
  ...dialect.toWireParams({
59
59
  query: (0, common_1.toSearchQueryParams)(this.applyHiddenExclusion({ entry, hiddenByCollection })),
@@ -73,7 +73,7 @@ class BaseSearchDataSource extends abstract_1.AbstractSearchDataSource {
73
73
  discoverCollections() {
74
74
  return this.discoverDefinitions({
75
75
  kind: 'collection',
76
- read: modelClass => this.readCollectionDefinition(modelClass),
76
+ read: (modelClass) => this.readCollectionDefinition(modelClass),
77
77
  });
78
78
  }
79
79
  /** Reads a bound model class's collection definition - dual-schema `searchCollection` first, then shape-guarded `schema`; undefined when it carries neither. */
@@ -1 +1 @@
1
- {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/search/core/datasources/base.ts"],"names":[],"mappings":";;;AAGA,8DAAwE;AAGxE,6DAAkE;AAClE,sDAAuD;AAEvD,yCAAsD;AACtD,qCAAwD;AAQxD,kPAAkP;AAClP,MAAsB,oBAGpB,SAAQ,mCAAkC;IAO1C,YAAY,IAAqE;QAC/E,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAE5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC;QAExC,0FAA0F;QAC1F,gFAAgF;QAChF,MAAM,aAAa,GAAG,CACpB,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,iCAAiC,IAAI,OAAO,CACtE,CAAC,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa,KAAK,MAAM,IAAI,aAAa,KAAK,GAAG,CAAC,CAAC;QAC/F,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,6DAA6D,EAC7D,IAAI,CAAC,aAAa,CACnB,CAAC;IACJ,CAAC;IAKD,iKAAiK;IACjK,KAAK,CAAC,SAAS;QACb,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;iBACxB,IAAI,CAAC,0DAA0D,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/E,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QAElE,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;IACpC,CAAC;IAED,YAAY;QACV,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,uCAAuC,IAAI,CAAC,IAAI,2BAA2B;aAC9G,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,6EAA6E;IACpE,SAAS;QAChB,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,qBAAqB;QACnB,MAAM,QAAQ,GAAG,2BAAgB,CAAC,WAAW,EAAE,CAAC;QAChD,OAAO,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,WAAkC,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,2KAA2K;IAC3K,WAAW,CAAC,IAKX;QACC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACjE,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACvC,MAAM,kBAAkB,GAAG,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAE3D,sHAAsH;QACtH,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC1C,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,GAAG,OAAO,CAAC,YAAY,CAAC;gBACtB,KAAK,EAAE,IAAA,4BAAmB,EAAC,IAAI,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;aACrF,CAAC;SACH,CAAC,CAAC,CAAC;QACJ,MAAM,gBAAgB,GAAG,YAAY;YACnC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,IAAA,4BAAmB,EAAC,YAAY,CAAC,EAAE,CAAC;YACpE,CAAC,CAAC,SAAS,CAAC;QAEd,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC,WAAW,CAAC;YACrC,QAAQ,EAAE,YAAY;YACtB,KAAK,EAAE,OAAO;YACd,YAAY,EAAE,gBAAgB;YAC9B,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAED,kKAAkK;IACxJ,mBAAmB;QAC3B,OAAO,IAAI,CAAC,mBAAmB,CAA8B;YAC3D,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,wBAAwB,CAAC,UAAU,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAED,gKAAgK;IACxJ,wBAAwB,CAC9B,UAA2B;QAE3B,MAAM,KAAK,GAAG,UAAqC,CAAC;QAEpD,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC,gBAAgB,CAAC;QAChC,CAAC;QAED,OAAO,IAAA,qCAA4B,EAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/E,CAAC;IAED,2PAA2P;IACjP,wBAAwB;QAChC,IAAI,CAAC,2BAA2B,KAAK,IAAI,CAAC,gCAAgC,EAAE,CAAC;QAC7E,OAAO,IAAI,CAAC,2BAA2B,CAAC;IAC1C,CAAC;IAED,6HAA6H;IACnH,gCAAgC;QACxC,MAAM,QAAQ,GAAG,2BAAgB,CAAC,WAAW,EAAE,CAAC;QAChD,MAAM,MAAM,GAA6B,EAAE,CAAC;QAE5C,MAAM,iBAAiB,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACtD,KAAK,MAAM,UAAU,IAAI,iBAAiB,EAAE,CAAC;YAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAC;YAC7D,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,SAAS;YACX,CAAC;YAED,MAAM,gBAAgB,GAAG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ;gBAClF,EAAE,gBAAgB,CAAC;YACrB,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC;YAC7C,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,2MAA2M;IACnM,oBAAoB,CAAC,IAG5B;QACC,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;QAC3C,MAAM,YAAY,GAAG,kBAAkB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAE1D,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAC7F,OAAO,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,CAAC;IACrC,CAAC;IAED,kMAAkM;IACxL,KAAK,CAAC,oBAAoB;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAE/D,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CACT,sEAAsE,EACtE,IAAI,CAAC,IAAI,CACV,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAEpD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,gBAAgB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;YAE5C,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;gBACjC,SAAS;YACX,CAAC;YAED,MAAM,IAAI,CAAC,iBAAiB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,kDAAkD,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjG,CAAC;IAED,uKAAuK;IAC7J,KAAK,CAAC,iBAAiB,CAAC,IAEjC;QACC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC;QAExC,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;YACzB,kHAAkH;YAClH,MAAM,cAAc,GAAG,GAAG,UAAU,CAAC,IAAI,WAAW,CAAC;YAErD,MAAM,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;YACnE,MAAM,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC;gBAC9B,UAAU,EAAE,UAAU,CAAC,IAAI;gBAC3B,WAAW,EAAE,CAAC,cAAc,CAAC;aAC9B,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;YACvB,MAAM,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QAED,MAAM,CAAC,IAAI,CACT,gGAAgG,EAChG,IAAI,CAAC,IAAI,EACT,UAAU,CAAC,IAAI,CAChB,CAAC;IACJ,CAAC;CACF;AA7ND,oDA6NC","sourcesContent":["import type { IDataSource } from '@venizia/ignis-kernel';\nimport type { ISearchConnector } from '@/search/core/connector';\nimport type { ISearchCollectionDefinition, TSearchSchema } from '@/search/core/models';\nimport { toSearchQueryParams } from '@/search/core/repositories/common';\nimport type { ISearchDataSourceOptions } from '@/search/core/datasources/common';\nimport type { TMultiSearchEntry } from '@/search/core/repositories/common';\nimport { MetadataRegistry } from '@venizia/ignis-kernel/metadata';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { type TClass } from '@venizia/ignis-helpers/common';\nimport { AbstractSearchDataSource } from './abstract';\nimport { isSearchCollectionDefinition } from './guards';\n\n/** `searchCollection` is the dual-schema escape hatch: a postgres entity with a search index declares it beside its pgTable `schema`; a search-only entity puts the DSL straight in `schema`. */\ntype TDiscoverableModelClass = TClass<unknown> & {\n searchCollection?: ISearchCollectionDefinition;\n schema?: unknown;\n};\n\n/** Collection discovery/provisioning + connector lifecycle, mirroring BasePostgresDataSource. Paradigm seam: the connector is held via the `ISearchConnector`-bounded generic, never an engine type - engines supply only `createConnector()`. */\nexport abstract class BaseSearchDataSource<\n Settings extends object = {},\n TConnector extends ISearchConnector = ISearchConnector,\n> extends AbstractSearchDataSource<Settings> {\n protected autoProvision: boolean;\n protected hiddenFieldsByCollectionMap?: Record<string, string[]>;\n protected connector?: TConnector;\n\n private readonly injectedConnector?: TConnector;\n\n constructor(opts: ISearchDataSourceOptions<Settings> & { connector?: TConnector }) {\n super({ scope: opts.name });\n\n this.name = opts.name;\n this.settings = opts.config;\n this.injectedConnector = opts.connector;\n\n // `globalThis.process?.` not bare `process.`: `search/core` sits in the browser-pure root\n // barrel, and a free `process` identifier throws a ReferenceError outside Node.\n const autoProvision = (\n globalThis.process?.env?.APP_ENV_AUTO_PROVISION_COLLECTION ?? 'false'\n ).toLowerCase();\n this.autoProvision = opts.autoProvision ?? (autoProvision === 'true' || autoProvision === '1');\n this.logger.info(\n '[constructor] Auto Provision Collection - autoProvision: %s',\n this.autoProvision,\n );\n }\n\n /** The engine's connector instance - the ONLY engine-specific step of the lifecycle. */\n protected abstract createConnector(): TConnector;\n\n /** Builds the connector (unless injected, e.g. for tests), then provisions collections. Re-entrant-safe: a second call is a logged no-op, not a re-provision. */\n async configure(): Promise<void> {\n if (this.connector) {\n this.logger\n .for(this.configure.name)\n .info('Already configured | Name: %s | Skipping re-provisioning', this.name);\n return;\n }\n\n this.connector = this.injectedConnector ?? this.createConnector();\n\n await this.provisionCollections();\n }\n\n getConnector(): TConnector {\n if (!this.connector) {\n throw getError({\n message: `[${this.constructor.name}] Connector not initialized | Name: ${this.name} | Call configure() first`,\n });\n }\n\n return this.connector;\n }\n\n /** Auto-discovers collections from repositories if not manually provided. */\n override getSchema(): TSearchSchema {\n this.schema ??= this.discoverCollections();\n return this.schema;\n }\n\n hasDiscoverableModels(): boolean {\n const registry = MetadataRegistry.getInstance();\n return registry.hasModels({ dataSource: this.constructor as TClass<IDataSource> });\n }\n\n /** Cross-collection, so it lives on the datasource, not a repository; the envelope is engine-specific, so the return is `unknown` and `TypesenseDataSource` narrows it. */\n multiSearch(opts: {\n searches: TMultiSearchEntry[];\n union?: boolean;\n commonParams?: Omit<TMultiSearchEntry, 'collection'>;\n options?: unknown;\n }): Promise<unknown> {\n const { searches, union: isUnion, commonParams, options } = opts;\n const dialect = this.getQueryDialect();\n const hiddenByCollection = this.hiddenFieldsByCollection();\n\n // Same friendly -> wire mapping search() uses, unioning each entry's hidden fields into excludeFields per collection.\n const wireSearches = searches.map(entry => ({\n collection: entry.collection,\n ...dialect.toWireParams({\n query: toSearchQueryParams(this.applyHiddenExclusion({ entry, hiddenByCollection })),\n }),\n }));\n const wireCommonParams = commonParams\n ? dialect.toWireParams({ query: toSearchQueryParams(commonParams) })\n : undefined;\n\n return this.getConnector().multiSearch({\n searches: wireSearches,\n union: isUnion,\n commonParams: wireCommonParams,\n options,\n });\n }\n\n /** Reads `static searchCollection`, falling back to shape-guarded `static schema`; honors `@datasource({ autoDiscovery: false })` same as the postgres branch. */\n protected discoverCollections(): TSearchSchema {\n return this.discoverDefinitions<ISearchCollectionDefinition>({\n kind: 'collection',\n read: modelClass => this.readCollectionDefinition(modelClass),\n });\n }\n\n /** Reads a bound model class's collection definition - dual-schema `searchCollection` first, then shape-guarded `schema`; undefined when it carries neither. */\n private readCollectionDefinition(\n modelClass: TClass<unknown>,\n ): ISearchCollectionDefinition | undefined {\n const model = modelClass as TDiscoverableModelClass;\n\n if (model.searchCollection) {\n return model.searchCollection;\n }\n\n return isSearchCollectionDefinition(model.schema) ? model.schema : undefined;\n }\n\n /** Collection name -> `@model` hiddenProperties for cross-collection operations. Collections with none are omitted, so callers own exclusion for absent entries; memoized per instance and never invalidated because the metadata is frozen after boot. */\n protected hiddenFieldsByCollection(): Record<string, string[]> {\n this.hiddenFieldsByCollectionMap ??= this.discoverHiddenFieldsByCollection();\n return this.hiddenFieldsByCollectionMap;\n }\n\n /** The registry/model walk behind `hiddenFieldsByCollection` - mirrors the `getSchema()` / `discoverCollections()` split. */\n protected discoverHiddenFieldsByCollection(): Record<string, string[]> {\n const registry = MetadataRegistry.getInstance();\n const result: Record<string, string[]> = {};\n\n const boundModelClasses = this.getBoundModelClasses();\n for (const modelClass of boundModelClasses) {\n const definition = this.readCollectionDefinition(modelClass);\n if (!definition) {\n continue;\n }\n\n const hiddenProperties = registry.getModelMetadata({ target: modelClass })?.settings\n ?.hiddenProperties;\n if (hiddenProperties && hiddenProperties.length > 0) {\n result[definition.name] = hiddenProperties;\n }\n }\n\n return result;\n }\n\n /** Unions a collection's hidden fields into one multiSearch entry's excludeFields; an entry whose collection is not a discovered definition passes through untouched - the caller owns exclusion there. */\n private applyHiddenExclusion(opts: {\n entry: TMultiSearchEntry;\n hiddenByCollection: Record<string, string[]>;\n }): TMultiSearchEntry {\n const { entry, hiddenByCollection } = opts;\n const hiddenFields = hiddenByCollection[entry.collection];\n\n if (!hiddenFields || hiddenFields.length === 0) {\n return entry;\n }\n\n const excludeFields = Array.from(new Set([...(entry.excludeFields ?? []), ...hiddenFields]));\n return { ...entry, excludeFields };\n }\n\n /** Provisions discovered collections via ensureCollection (additive-only; destructive migration is caller policy). Skipped if autoProvision is false; failures propagate so boot fails loudly. */\n protected async provisionCollections(): Promise<void> {\n const logger = this.logger.for(this.provisionCollections.name);\n\n if (!this.autoProvision) {\n logger.info(\n 'autoProvision disabled | Skipping collection provisioning | Name: %s',\n this.name,\n );\n return;\n }\n\n const definitions = Object.values(this.getSchema());\n\n for (const definition of definitions) {\n await this.ensureCollection({ definition });\n\n if (!definition.synonyms?.length) {\n continue;\n }\n\n await this.provisionSynonyms({ definition });\n }\n\n logger.info('Provisioned collection(s) | Name: %s | Count: %s', this.name, definitions.length);\n }\n\n /** Engines expose synonyms as named linkable sets, a flat per-collection dictionary, or neither - both groups are optional on `ISearchConnector`, hence the branch. */\n protected async provisionSynonyms(opts: {\n definition: ISearchCollectionDefinition;\n }): Promise<void> {\n const { definition } = opts;\n const logger = this.logger.for(this.provisionSynonyms.name);\n const connector = this.getConnector();\n const items = definition.synonyms ?? [];\n\n if (connector.synonymSet) {\n // Stays distinct from Typesense's own auto-migration name (`<collection>_synonyms_index`) so the two never clash.\n const synonymSetName = `${definition.name}_synonyms`;\n\n await connector.synonymSet.upsert({ name: synonymSetName, items });\n await connector.synonymSet.link({\n collection: definition.name,\n synonymSets: [synonymSetName],\n });\n return;\n }\n\n if (connector.synonyms) {\n await connector.synonyms.set({ collection: definition.name, items });\n return;\n }\n\n logger.warn(\n 'Collection declares synonyms but the engine exposes no synonym API | Name: %s | Collection: %s',\n this.name,\n definition.name,\n );\n }\n}\n"]}
1
+ {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/search/core/datasources/base.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IDataSource } from '@venizia/ignis-kernel';\nimport type { ISearchConnector } from '@/search/core/connector';\nimport type { ISearchCollectionDefinition, TSearchSchema } from '@/search/core/models';\nimport { toSearchQueryParams } from '@/search/core/repositories/common';\nimport type { ISearchDataSourceOptions } from '@/search/core/datasources/common';\nimport type { TMultiSearchEntry } from '@/search/core/repositories/common';\nimport { MetadataRegistry } from '@venizia/ignis-kernel/metadata';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { type TClass } from '@venizia/ignis-helpers/common';\nimport { AbstractSearchDataSource } from './abstract';\nimport { isSearchCollectionDefinition } from './guards';\n\n/** `searchCollection` is the dual-schema escape hatch: a postgres entity with a search index declares it beside its pgTable `schema`; a search-only entity puts the DSL straight in `schema`. */\ntype TDiscoverableModelClass = TClass<unknown> & {\n searchCollection?: ISearchCollectionDefinition;\n schema?: unknown;\n};\n\n/** Collection discovery/provisioning + connector lifecycle, mirroring BasePostgresDataSource. Paradigm seam: the connector is held via the `ISearchConnector`-bounded generic, never an engine type - engines supply only `createConnector()`. */\nexport abstract class BaseSearchDataSource<\n Settings extends object = {},\n TConnector extends ISearchConnector = ISearchConnector,\n> extends AbstractSearchDataSource<Settings> {\n protected autoProvision: boolean;\n protected hiddenFieldsByCollectionMap?: Record<string, string[]>;\n protected connector?: TConnector;\n\n private readonly injectedConnector?: TConnector;\n\n constructor(opts: ISearchDataSourceOptions<Settings> & { connector?: TConnector }) {\n super({ scope: opts.name });\n\n this.name = opts.name;\n this.settings = opts.config;\n this.injectedConnector = opts.connector;\n\n // `globalThis.process?.` not bare `process.`: `search/core` sits in the browser-pure root\n // barrel, and a free `process` identifier throws a ReferenceError outside Node.\n const autoProvision = (\n globalThis.process?.env?.APP_ENV_AUTO_PROVISION_COLLECTION ?? 'false'\n ).toLowerCase();\n this.autoProvision = opts.autoProvision ?? (autoProvision === 'true' || autoProvision === '1');\n this.logger.info(\n '[constructor] Auto Provision Collection - autoProvision: %s',\n this.autoProvision,\n );\n }\n\n /** The engine's connector instance - the ONLY engine-specific step of the lifecycle. */\n protected abstract createConnector(): TConnector;\n\n /** Builds the connector (unless injected, e.g. for tests), then provisions collections. Re-entrant-safe: a second call is a logged no-op, not a re-provision. */\n async configure(): Promise<void> {\n if (this.connector) {\n this.logger\n .for(this.configure.name)\n .info('Already configured | Name: %s | Skipping re-provisioning', this.name);\n return;\n }\n\n this.connector = this.injectedConnector ?? this.createConnector();\n\n await this.provisionCollections();\n }\n\n getConnector(): TConnector {\n if (!this.connector) {\n throw getError({\n message: `[${this.constructor.name}] Connector not initialized | Name: ${this.name} | Call configure() first`,\n });\n }\n\n return this.connector;\n }\n\n /** Auto-discovers collections from repositories if not manually provided. */\n override getSchema(): TSearchSchema {\n this.schema ??= this.discoverCollections();\n return this.schema;\n }\n\n hasDiscoverableModels(): boolean {\n const registry = MetadataRegistry.getInstance();\n return registry.hasModels({ dataSource: this.constructor as TClass<IDataSource> });\n }\n\n /** Cross-collection, so it lives on the datasource, not a repository; the envelope is engine-specific, so the return is `unknown` and `TypesenseDataSource` narrows it. */\n multiSearch(opts: {\n searches: TMultiSearchEntry[];\n union?: boolean;\n commonParams?: Omit<TMultiSearchEntry, 'collection'>;\n options?: unknown;\n }): Promise<unknown> {\n const { searches, union: isUnion, commonParams, options } = opts;\n const dialect = this.getQueryDialect();\n const hiddenByCollection = this.hiddenFieldsByCollection();\n\n // Same friendly -> wire mapping search() uses, unioning each entry's hidden fields into excludeFields per collection.\n const wireSearches = searches.map((entry) => ({\n collection: entry.collection,\n ...dialect.toWireParams({\n query: toSearchQueryParams(this.applyHiddenExclusion({ entry, hiddenByCollection })),\n }),\n }));\n const wireCommonParams = commonParams\n ? dialect.toWireParams({ query: toSearchQueryParams(commonParams) })\n : undefined;\n\n return this.getConnector().multiSearch({\n searches: wireSearches,\n union: isUnion,\n commonParams: wireCommonParams,\n options,\n });\n }\n\n /** Reads `static searchCollection`, falling back to shape-guarded `static schema`; honors `@datasource({ autoDiscovery: false })` same as the postgres branch. */\n protected discoverCollections(): TSearchSchema {\n return this.discoverDefinitions<ISearchCollectionDefinition>({\n kind: 'collection',\n read: (modelClass) => this.readCollectionDefinition(modelClass),\n });\n }\n\n /** Reads a bound model class's collection definition - dual-schema `searchCollection` first, then shape-guarded `schema`; undefined when it carries neither. */\n private readCollectionDefinition(\n modelClass: TClass<unknown>,\n ): ISearchCollectionDefinition | undefined {\n const model = modelClass as TDiscoverableModelClass;\n\n if (model.searchCollection) {\n return model.searchCollection;\n }\n\n return isSearchCollectionDefinition(model.schema) ? model.schema : undefined;\n }\n\n /** Collection name -> `@model` hiddenProperties for cross-collection operations. Collections with none are omitted, so callers own exclusion for absent entries; memoized per instance and never invalidated because the metadata is frozen after boot. */\n protected hiddenFieldsByCollection(): Record<string, string[]> {\n this.hiddenFieldsByCollectionMap ??= this.discoverHiddenFieldsByCollection();\n return this.hiddenFieldsByCollectionMap;\n }\n\n /** The registry/model walk behind `hiddenFieldsByCollection` - mirrors the `getSchema()` / `discoverCollections()` split. */\n protected discoverHiddenFieldsByCollection(): Record<string, string[]> {\n const registry = MetadataRegistry.getInstance();\n const result: Record<string, string[]> = {};\n\n const boundModelClasses = this.getBoundModelClasses();\n for (const modelClass of boundModelClasses) {\n const definition = this.readCollectionDefinition(modelClass);\n if (!definition) {\n continue;\n }\n\n const hiddenProperties = registry.getModelMetadata({ target: modelClass })?.settings\n ?.hiddenProperties;\n if (hiddenProperties && hiddenProperties.length > 0) {\n result[definition.name] = hiddenProperties;\n }\n }\n\n return result;\n }\n\n /** Unions a collection's hidden fields into one multiSearch entry's excludeFields; an entry whose collection is not a discovered definition passes through untouched - the caller owns exclusion there. */\n private applyHiddenExclusion(opts: {\n entry: TMultiSearchEntry;\n hiddenByCollection: Record<string, string[]>;\n }): TMultiSearchEntry {\n const { entry, hiddenByCollection } = opts;\n const hiddenFields = hiddenByCollection[entry.collection];\n\n if (!hiddenFields || hiddenFields.length === 0) {\n return entry;\n }\n\n const excludeFields = Array.from(new Set([...(entry.excludeFields ?? []), ...hiddenFields]));\n return { ...entry, excludeFields };\n }\n\n /** Provisions discovered collections via ensureCollection (additive-only; destructive migration is caller policy). Skipped if autoProvision is false; failures propagate so boot fails loudly. */\n protected async provisionCollections(): Promise<void> {\n const logger = this.logger.for(this.provisionCollections.name);\n\n if (!this.autoProvision) {\n logger.info(\n 'autoProvision disabled | Skipping collection provisioning | Name: %s',\n this.name,\n );\n return;\n }\n\n const definitions = Object.values(this.getSchema());\n\n for (const definition of definitions) {\n await this.ensureCollection({ definition });\n\n if (!definition.synonyms?.length) {\n continue;\n }\n\n await this.provisionSynonyms({ definition });\n }\n\n logger.info('Provisioned collection(s) | Name: %s | Count: %s', this.name, definitions.length);\n }\n\n /** Engines expose synonyms as named linkable sets, a flat per-collection dictionary, or neither - both groups are optional on `ISearchConnector`, hence the branch. */\n protected async provisionSynonyms(opts: {\n definition: ISearchCollectionDefinition;\n }): Promise<void> {\n const { definition } = opts;\n const logger = this.logger.for(this.provisionSynonyms.name);\n const connector = this.getConnector();\n const items = definition.synonyms ?? [];\n\n if (connector.synonymSet) {\n // Stays distinct from Typesense's own auto-migration name (`<collection>_synonyms_index`) so the two never clash.\n const synonymSetName = `${definition.name}_synonyms`;\n\n await connector.synonymSet.upsert({ name: synonymSetName, items });\n await connector.synonymSet.link({\n collection: definition.name,\n synonymSets: [synonymSetName],\n });\n return;\n }\n\n if (connector.synonyms) {\n await connector.synonyms.set({ collection: definition.name, items });\n return;\n }\n\n logger.warn(\n 'Collection declares synonyms but the engine exposes no synonym API | Name: %s | Collection: %s',\n this.name,\n definition.name,\n );\n }\n}\n"]}
@@ -66,7 +66,7 @@ const defineSearchCollection = (opts) => {
66
66
  }
67
67
  seenNames.add(definitionField.name);
68
68
  }
69
- const idField = fields.find(item => item.name === 'id');
69
+ const idField = fields.find((item) => item.name === 'id');
70
70
  let resolvedFields = fields;
71
71
  if (!idField) {
72
72
  resolvedFields = [exports.field.id(), ...fields];
@@ -78,7 +78,7 @@ const defineSearchCollection = (opts) => {
78
78
  }
79
79
  // Engine-neutral rule only: defaultSort must reference an existing field; per-engine constraints (Typesense's numeric-scalar requirement) belong to that engine's compiler.
80
80
  if (defaultSort) {
81
- const sortField = resolvedFields.find(item => item.name === defaultSort);
81
+ const sortField = resolvedFields.find((item) => item.name === defaultSort);
82
82
  if (!sortField) {
83
83
  throw (0, core_1.getError)({
84
84
  message: `[defineSearchCollection] Invalid defaultSort | field not found | name: ${name} | defaultSort: ${defaultSort}`,
@@ -87,7 +87,7 @@ const defineSearchCollection = (opts) => {
87
87
  }
88
88
  if (defaultQueryBy) {
89
89
  for (const queryByFieldName of defaultQueryBy) {
90
- const queryByField = resolvedFields.find(item => item.name === queryByFieldName);
90
+ const queryByField = resolvedFields.find((item) => item.name === queryByFieldName);
91
91
  if (!queryByField) {
92
92
  throw (0, core_1.getError)({
93
93
  message: `[defineSearchCollection] Invalid defaultQueryBy | field not found | name: ${name} | field: ${queryByFieldName}`,
@@ -1 +1 @@
1
- {"version":3,"file":"define-search-collection.js","sourceRoot":"","sources":["../../../../../src/search/core/models/define-search-collection.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@venizia/ignis-helpers/core';\n\nimport type {\n ISearchCollectionDefinition,\n ISearchEmbedConfig,\n ISearchFieldDefinition,\n ISynonym,\n TFieldFlags,\n TSearchFieldType,\n TVectorDistance,\n} from './common';\nimport { SearchFieldTypes } from './common';\n\n/** `<const N, const O>` preserve the field's name/flag literals - a widened `ISearchFieldDefinition` return would break `TSearchDocument`, which needs literal types. */\nconst buildField = <\n const N extends string,\n Ty extends TSearchFieldType,\n const O extends TFieldFlags = {},\n>(opts: {\n name: N;\n type: Ty;\n flags?: O;\n}): { name: N; type: Ty } & O => {\n const { name, type, flags } = opts;\n\n return { name, type, ...flags } as { name: N; type: Ty } & O;\n};\n\n/** Curries `buildField` over a fixed field type - the shared shape behind `field.string/strings/number/numbers/boolean/booleans/geopoint`. */\nconst makeFieldBuilder =\n <Ty extends TSearchFieldType>(type: Ty) =>\n <const N extends string, const O extends TFieldFlags = {}>(\n name: N,\n opts?: O,\n ): { name: N; type: Ty } & O => {\n return buildField({ name, type, flags: opts });\n };\n\nexport const field = {\n id: (): { name: 'id'; type: 'string' } => {\n return { name: 'id', type: SearchFieldTypes.STRING };\n },\n string: makeFieldBuilder(SearchFieldTypes.STRING),\n strings: makeFieldBuilder(SearchFieldTypes.STRING_ARRAY),\n number: makeFieldBuilder(SearchFieldTypes.NUMBER),\n numbers: makeFieldBuilder(SearchFieldTypes.NUMBER_ARRAY),\n boolean: makeFieldBuilder(SearchFieldTypes.BOOLEAN),\n booleans: makeFieldBuilder(SearchFieldTypes.BOOLEAN_ARRAY),\n geopoint: makeFieldBuilder(SearchFieldTypes.GEOPOINT),\n /** `vector` carries its own `O` shape (dimensions/distance/embed) instead of routing through `buildField`; the `O extends { optional: true }` conditional makes `optional` appear, in type and at runtime, only when set - keeping `TSearchDocument`'s optional split working. */\n vector: <\n const N extends string,\n const O extends {\n dimensions?: number;\n distance?: TVectorDistance;\n embed?: ISearchEmbedConfig;\n optional?: boolean;\n },\n >(\n name: N,\n opts: O,\n ): { name: N; type: typeof SearchFieldTypes.VECTOR; vector: Omit<O, 'optional'> } & (O extends {\n optional: true;\n }\n ? { optional: true }\n : object) => {\n const { optional: isOptional, ...vector } = opts;\n const base = { name, type: SearchFieldTypes.VECTOR, vector };\n\n // The cast is unavoidable: the conditional-optional branch can't be proven from the runtime shape without widening `O`.\n return (isOptional ? { ...base, optional: isOptional } : base) as {\n name: N;\n type: typeof SearchFieldTypes.VECTOR;\n vector: Omit<O, 'optional'>;\n } & (O extends { optional: true } ? { optional: true } : object);\n },\n};\n\n/** @throws when two synonym sets in the same collection share an id. */\nconst assertUniqueSynonymIds = (opts: { name: string; synonyms: readonly ISynonym[] }): void => {\n const { name, synonyms } = opts;\n const seenSynonymIds = new Set<string>();\n\n for (const synonym of synonyms) {\n if (seenSynonymIds.has(synonym.id)) {\n throw getError({\n message: `[defineSearchCollection] Duplicate synonym id | name: ${name} | id: ${synonym.id}`,\n });\n }\n\n seenSynonymIds.add(synonym.id);\n }\n};\n\n/** `<const T>` preserves field literals so `TSearchDocument<typeof X>` can map over them - a plain `T extends ISearchCollectionDefinition` would widen `fields` and lose every literal. */\nexport const defineSearchCollection = <const T extends ISearchCollectionDefinition>(opts: T): T => {\n const { name, fields, defaultSort, defaultQueryBy, synonyms, engineOverrides } = opts;\n\n if (!name || name.trim().length === 0) {\n throw getError({\n message: `[defineSearchCollection] Invalid name | name must be non-empty | name: ${String(name)}`,\n });\n }\n\n if (!fields || fields.length === 0) {\n throw getError({\n message: `[defineSearchCollection] Invalid fields | at least one field is required | name: ${name}`,\n });\n }\n\n const seenNames = new Set<string>();\n for (const definitionField of fields) {\n if (seenNames.has(definitionField.name)) {\n throw getError({\n message: `[defineSearchCollection] Duplicate field name | name: ${name} | field: ${definitionField.name}`,\n });\n }\n\n seenNames.add(definitionField.name);\n }\n\n const idField = fields.find(item => item.name === 'id');\n let resolvedFields: readonly ISearchFieldDefinition[] = fields;\n\n if (!idField) {\n resolvedFields = [field.id(), ...fields];\n } else if (idField.type !== SearchFieldTypes.STRING) {\n throw getError({\n message: `[defineSearchCollection] Invalid id field | id field must be of type string | name: ${name} | type: ${idField.type}`,\n });\n }\n\n // Engine-neutral rule only: defaultSort must reference an existing field; per-engine constraints (Typesense's numeric-scalar requirement) belong to that engine's compiler.\n if (defaultSort) {\n const sortField = resolvedFields.find(item => item.name === defaultSort);\n\n if (!sortField) {\n throw getError({\n message: `[defineSearchCollection] Invalid defaultSort | field not found | name: ${name} | defaultSort: ${defaultSort}`,\n });\n }\n }\n\n if (defaultQueryBy) {\n for (const queryByFieldName of defaultQueryBy) {\n const queryByField = resolvedFields.find(item => item.name === queryByFieldName);\n\n if (!queryByField) {\n throw getError({\n message: `[defineSearchCollection] Invalid defaultQueryBy | field not found | name: ${name} | field: ${queryByFieldName}`,\n });\n }\n\n if (\n queryByField.type !== SearchFieldTypes.STRING &&\n queryByField.type !== SearchFieldTypes.STRING_ARRAY\n ) {\n throw getError({\n message: `[defineSearchCollection] Invalid defaultQueryBy | full-text search matches text fields only (string, string[]) | name: ${name} | field: ${queryByFieldName} | type: ${queryByField.type}`,\n });\n }\n }\n }\n\n if (synonyms) {\n assertUniqueSynonymIds({ name, synonyms });\n }\n\n // The runtime result is only structurally an ISearchCollectionDefinition; the cast back to the caller's literal T is deliberate - `id` is guaranteed at the type level via TSearchDocument.\n return {\n name,\n fields: resolvedFields,\n defaultSort,\n defaultQueryBy,\n synonyms,\n engineOverrides,\n } as T;\n};\n"]}
1
+ {"version":3,"file":"define-search-collection.js","sourceRoot":"","sources":["../../../../../src/search/core/models/define-search-collection.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@venizia/ignis-helpers/core';\n\nimport type {\n ISearchCollectionDefinition,\n ISearchEmbedConfig,\n ISearchFieldDefinition,\n ISynonym,\n TFieldFlags,\n TSearchFieldType,\n TVectorDistance,\n} from './common';\nimport { SearchFieldTypes } from './common';\n\n/** `<const N, const O>` preserve the field's name/flag literals - a widened `ISearchFieldDefinition` return would break `TSearchDocument`, which needs literal types. */\nconst buildField = <\n const N extends string,\n Ty extends TSearchFieldType,\n const O extends TFieldFlags = {},\n>(opts: {\n name: N;\n type: Ty;\n flags?: O;\n}): { name: N; type: Ty } & O => {\n const { name, type, flags } = opts;\n\n return { name, type, ...flags } as { name: N; type: Ty } & O;\n};\n\n/** Curries `buildField` over a fixed field type - the shared shape behind `field.string/strings/number/numbers/boolean/booleans/geopoint`. */\nconst makeFieldBuilder =\n <Ty extends TSearchFieldType>(type: Ty) =>\n <const N extends string, const O extends TFieldFlags = {}>(\n name: N,\n opts?: O,\n ): { name: N; type: Ty } & O => {\n return buildField({ name, type, flags: opts });\n };\n\nexport const field = {\n id: (): { name: 'id'; type: 'string' } => {\n return { name: 'id', type: SearchFieldTypes.STRING };\n },\n string: makeFieldBuilder(SearchFieldTypes.STRING),\n strings: makeFieldBuilder(SearchFieldTypes.STRING_ARRAY),\n number: makeFieldBuilder(SearchFieldTypes.NUMBER),\n numbers: makeFieldBuilder(SearchFieldTypes.NUMBER_ARRAY),\n boolean: makeFieldBuilder(SearchFieldTypes.BOOLEAN),\n booleans: makeFieldBuilder(SearchFieldTypes.BOOLEAN_ARRAY),\n geopoint: makeFieldBuilder(SearchFieldTypes.GEOPOINT),\n /** `vector` carries its own `O` shape (dimensions/distance/embed) instead of routing through `buildField`; the `O extends { optional: true }` conditional makes `optional` appear, in type and at runtime, only when set - keeping `TSearchDocument`'s optional split working. */\n vector: <\n const N extends string,\n const O extends {\n dimensions?: number;\n distance?: TVectorDistance;\n embed?: ISearchEmbedConfig;\n optional?: boolean;\n },\n >(\n name: N,\n opts: O,\n ): { name: N; type: typeof SearchFieldTypes.VECTOR; vector: Omit<O, 'optional'> } & (O extends {\n optional: true;\n }\n ? { optional: true }\n : object) => {\n const { optional: isOptional, ...vector } = opts;\n const base = { name, type: SearchFieldTypes.VECTOR, vector };\n\n // The cast is unavoidable: the conditional-optional branch can't be proven from the runtime shape without widening `O`.\n return (isOptional ? { ...base, optional: isOptional } : base) as {\n name: N;\n type: typeof SearchFieldTypes.VECTOR;\n vector: Omit<O, 'optional'>;\n } & (O extends { optional: true } ? { optional: true } : object);\n },\n};\n\n/** @throws when two synonym sets in the same collection share an id. */\nconst assertUniqueSynonymIds = (opts: { name: string; synonyms: readonly ISynonym[] }): void => {\n const { name, synonyms } = opts;\n const seenSynonymIds = new Set<string>();\n\n for (const synonym of synonyms) {\n if (seenSynonymIds.has(synonym.id)) {\n throw getError({\n message: `[defineSearchCollection] Duplicate synonym id | name: ${name} | id: ${synonym.id}`,\n });\n }\n\n seenSynonymIds.add(synonym.id);\n }\n};\n\n/** `<const T>` preserves field literals so `TSearchDocument<typeof X>` can map over them - a plain `T extends ISearchCollectionDefinition` would widen `fields` and lose every literal. */\nexport const defineSearchCollection = <const T extends ISearchCollectionDefinition>(opts: T): T => {\n const { name, fields, defaultSort, defaultQueryBy, synonyms, engineOverrides } = opts;\n\n if (!name || name.trim().length === 0) {\n throw getError({\n message: `[defineSearchCollection] Invalid name | name must be non-empty | name: ${String(name)}`,\n });\n }\n\n if (!fields || fields.length === 0) {\n throw getError({\n message: `[defineSearchCollection] Invalid fields | at least one field is required | name: ${name}`,\n });\n }\n\n const seenNames = new Set<string>();\n for (const definitionField of fields) {\n if (seenNames.has(definitionField.name)) {\n throw getError({\n message: `[defineSearchCollection] Duplicate field name | name: ${name} | field: ${definitionField.name}`,\n });\n }\n\n seenNames.add(definitionField.name);\n }\n\n const idField = fields.find((item) => item.name === 'id');\n let resolvedFields: readonly ISearchFieldDefinition[] = fields;\n\n if (!idField) {\n resolvedFields = [field.id(), ...fields];\n } else if (idField.type !== SearchFieldTypes.STRING) {\n throw getError({\n message: `[defineSearchCollection] Invalid id field | id field must be of type string | name: ${name} | type: ${idField.type}`,\n });\n }\n\n // Engine-neutral rule only: defaultSort must reference an existing field; per-engine constraints (Typesense's numeric-scalar requirement) belong to that engine's compiler.\n if (defaultSort) {\n const sortField = resolvedFields.find((item) => item.name === defaultSort);\n\n if (!sortField) {\n throw getError({\n message: `[defineSearchCollection] Invalid defaultSort | field not found | name: ${name} | defaultSort: ${defaultSort}`,\n });\n }\n }\n\n if (defaultQueryBy) {\n for (const queryByFieldName of defaultQueryBy) {\n const queryByField = resolvedFields.find((item) => item.name === queryByFieldName);\n\n if (!queryByField) {\n throw getError({\n message: `[defineSearchCollection] Invalid defaultQueryBy | field not found | name: ${name} | field: ${queryByFieldName}`,\n });\n }\n\n if (\n queryByField.type !== SearchFieldTypes.STRING &&\n queryByField.type !== SearchFieldTypes.STRING_ARRAY\n ) {\n throw getError({\n message: `[defineSearchCollection] Invalid defaultQueryBy | full-text search matches text fields only (string, string[]) | name: ${name} | field: ${queryByFieldName} | type: ${queryByField.type}`,\n });\n }\n }\n }\n\n if (synonyms) {\n assertUniqueSynonymIds({ name, synonyms });\n }\n\n // The runtime result is only structurally an ISearchCollectionDefinition; the cast back to the caller's literal T is deliberate - `id` is guaranteed at the type level via TSearchDocument.\n return {\n name,\n fields: resolvedFields,\n defaultSort,\n defaultQueryBy,\n synonyms,\n engineOverrides,\n } as T;\n};\n"]}
@@ -49,7 +49,7 @@ const buildFieldSchema = (field) => {
49
49
  };
50
50
  const buildShape = (fields) => {
51
51
  const entries = fields
52
- .map(field => [field.name, buildFieldSchema(field)])
52
+ .map((field) => [field.name, buildFieldSchema(field)])
53
53
  .filter((entry) => entry[1] !== undefined);
54
54
  return Object.fromEntries(entries);
55
55
  };