@venizia/ignis-connectors 0.4.0 → 0.4.2

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 (193) hide show
  1. package/dist/cjs/common/scope-filter.d.ts +1 -1
  2. package/dist/cjs/common/scope-filter.d.ts.map +1 -1
  3. package/dist/cjs/common/scope-filter.js +33 -7
  4. package/dist/cjs/common/scope-filter.js.map +1 -1
  5. package/dist/cjs/http/repository.d.ts +23 -23
  6. package/dist/cjs/http/repository.d.ts.map +1 -1
  7. package/dist/cjs/http/repository.js.map +1 -1
  8. package/dist/cjs/relational/core/datasources/base.d.ts.map +1 -1
  9. package/dist/cjs/relational/core/datasources/base.js +1 -1
  10. package/dist/cjs/relational/core/datasources/base.js.map +1 -1
  11. package/dist/cjs/relational/core/migrations/runner.js +3 -3
  12. package/dist/cjs/relational/core/migrations/runner.js.map +1 -1
  13. package/dist/cjs/relational/core/models/base.js +1 -1
  14. package/dist/cjs/relational/core/models/base.js.map +1 -1
  15. package/dist/cjs/relational/core/repositories/common/scope-write-guard.d.ts +50 -0
  16. package/dist/cjs/relational/core/repositories/common/scope-write-guard.d.ts.map +1 -0
  17. package/dist/cjs/relational/core/repositories/common/scope-write-guard.js +248 -0
  18. package/dist/cjs/relational/core/repositories/common/scope-write-guard.js.map +1 -0
  19. package/dist/cjs/relational/core/repositories/core/base.d.ts +35 -20
  20. package/dist/cjs/relational/core/repositories/core/base.d.ts.map +1 -1
  21. package/dist/cjs/relational/core/repositories/core/base.js +29 -4
  22. package/dist/cjs/relational/core/repositories/core/base.js.map +1 -1
  23. package/dist/cjs/relational/core/repositories/core/persistable.d.ts.map +1 -1
  24. package/dist/cjs/relational/core/repositories/core/persistable.js +6 -1
  25. package/dist/cjs/relational/core/repositories/core/persistable.js.map +1 -1
  26. package/dist/cjs/relational/core/repositories/core/readable.d.ts +17 -17
  27. package/dist/cjs/relational/core/repositories/core/readable.d.ts.map +1 -1
  28. package/dist/cjs/relational/core/repositories/core/readable.js +8 -2
  29. package/dist/cjs/relational/core/repositories/core/readable.js.map +1 -1
  30. package/dist/cjs/relational/core/repositories/core/soft-deletable.d.ts +9 -9
  31. package/dist/cjs/relational/core/repositories/core/soft-deletable.d.ts.map +1 -1
  32. package/dist/cjs/relational/core/repositories/core/soft-deletable.js.map +1 -1
  33. package/dist/cjs/relational/core/repositories/dialect/filter.d.ts +2 -2
  34. package/dist/cjs/relational/core/repositories/dialect/filter.js +6 -6
  35. package/dist/cjs/relational/core/repositories/dialect/filter.js.map +1 -1
  36. package/dist/cjs/relational/core/repositories/dialect/relations/one.d.ts.map +1 -1
  37. package/dist/cjs/relational/core/repositories/dialect/relations/one.js +7 -7
  38. package/dist/cjs/relational/core/repositories/dialect/relations/one.js.map +1 -1
  39. package/dist/cjs/relational/core/repositories/sqls/recursive-tree.d.ts +9 -0
  40. package/dist/cjs/relational/core/repositories/sqls/recursive-tree.d.ts.map +1 -1
  41. package/dist/cjs/relational/core/repositories/sqls/recursive-tree.js +17 -6
  42. package/dist/cjs/relational/core/repositories/sqls/recursive-tree.js.map +1 -1
  43. package/dist/cjs/relational/postgres/drivers/pglite.js +2 -2
  44. package/dist/cjs/relational/postgres/drivers/pglite.js.map +1 -1
  45. package/dist/cjs/relational/postgres/repositories/dialect/query.js +1 -1
  46. package/dist/cjs/relational/postgres/repositories/dialect/query.js.map +1 -1
  47. package/dist/cjs/relational/sqlite/drivers/libsql.js +2 -2
  48. package/dist/cjs/relational/sqlite/drivers/libsql.js.map +1 -1
  49. package/dist/cjs/relational/sqlite/repositories/dialect/internal/json-path.js +3 -3
  50. package/dist/cjs/relational/sqlite/repositories/dialect/internal/json-path.js.map +1 -1
  51. package/dist/cjs/search/core/connector.js +2 -2
  52. package/dist/cjs/search/core/connector.js.map +1 -1
  53. package/dist/cjs/search/core/controllers/abstract.d.ts +4 -0
  54. package/dist/cjs/search/core/controllers/abstract.d.ts.map +1 -1
  55. package/dist/cjs/search/core/controllers/abstract.js +15 -1
  56. package/dist/cjs/search/core/controllers/abstract.js.map +1 -1
  57. package/dist/cjs/search/core/controllers/factory.d.ts +14 -0
  58. package/dist/cjs/search/core/controllers/factory.d.ts.map +1 -1
  59. package/dist/cjs/search/core/controllers/factory.js +7 -1
  60. package/dist/cjs/search/core/controllers/factory.js.map +1 -1
  61. package/dist/cjs/search/core/controllers/scope.d.ts +28 -0
  62. package/dist/cjs/search/core/controllers/scope.d.ts.map +1 -0
  63. package/dist/cjs/search/core/controllers/scope.js +68 -0
  64. package/dist/cjs/search/core/controllers/scope.js.map +1 -0
  65. package/dist/cjs/search/core/datasources/base.js +2 -2
  66. package/dist/cjs/search/core/datasources/base.js.map +1 -1
  67. package/dist/cjs/search/core/models/define-search-collection.js +3 -3
  68. package/dist/cjs/search/core/models/define-search-collection.js.map +1 -1
  69. package/dist/cjs/search/core/models/zod-derivation.js +1 -1
  70. package/dist/cjs/search/core/models/zod-derivation.js.map +1 -1
  71. package/dist/cjs/search/core/repositories/common/dialect-helpers.js +1 -1
  72. package/dist/cjs/search/core/repositories/common/dialect-helpers.js.map +1 -1
  73. package/dist/cjs/search/core/repositories/core/base.js +2 -2
  74. package/dist/cjs/search/core/repositories/core/base.js.map +1 -1
  75. package/dist/cjs/search/core/repositories/core/readable.d.ts +17 -17
  76. package/dist/cjs/search/core/repositories/core/readable.d.ts.map +1 -1
  77. package/dist/cjs/search/core/repositories/core/readable.js +4 -4
  78. package/dist/cjs/search/core/repositories/core/readable.js.map +1 -1
  79. package/dist/cjs/search/meilisearch/compiler.js +4 -4
  80. package/dist/cjs/search/meilisearch/compiler.js.map +1 -1
  81. package/dist/cjs/search/meilisearch/connector.js +22 -22
  82. package/dist/cjs/search/meilisearch/connector.js.map +1 -1
  83. package/dist/cjs/search/meilisearch/internal/connector-internal.js +1 -1
  84. package/dist/cjs/search/meilisearch/internal/connector-internal.js.map +1 -1
  85. package/dist/cjs/search/meilisearch/repositories/dialect/query-dialect.js +6 -6
  86. package/dist/cjs/search/meilisearch/repositories/dialect/query-dialect.js.map +1 -1
  87. package/dist/cjs/search/typesense/compiler.js +8 -8
  88. package/dist/cjs/search/typesense/compiler.js.map +1 -1
  89. package/dist/cjs/search/typesense/connector.js +23 -23
  90. package/dist/cjs/search/typesense/connector.js.map +1 -1
  91. package/dist/cjs/search/typesense/internal/mappers.js +1 -1
  92. package/dist/cjs/search/typesense/internal/mappers.js.map +1 -1
  93. package/dist/cjs/search/typesense/internal/pagination-windows.js +3 -3
  94. package/dist/cjs/search/typesense/internal/pagination-windows.js.map +1 -1
  95. package/dist/cjs/search/typesense/repositories/dialect/query-dialect.js +7 -7
  96. package/dist/cjs/search/typesense/repositories/dialect/query-dialect.js.map +1 -1
  97. package/dist/esm/common/scope-filter.d.ts +1 -1
  98. package/dist/esm/common/scope-filter.d.ts.map +1 -1
  99. package/dist/esm/common/scope-filter.js +34 -8
  100. package/dist/esm/common/scope-filter.js.map +1 -1
  101. package/dist/esm/http/repository.d.ts +23 -23
  102. package/dist/esm/http/repository.d.ts.map +1 -1
  103. package/dist/esm/http/repository.js.map +1 -1
  104. package/dist/esm/relational/core/datasources/base.d.ts.map +1 -1
  105. package/dist/esm/relational/core/datasources/base.js +1 -1
  106. package/dist/esm/relational/core/datasources/base.js.map +1 -1
  107. package/dist/esm/relational/core/migrations/runner.js +3 -3
  108. package/dist/esm/relational/core/migrations/runner.js.map +1 -1
  109. package/dist/esm/relational/core/models/base.js +1 -1
  110. package/dist/esm/relational/core/models/base.js.map +1 -1
  111. package/dist/esm/relational/core/repositories/common/scope-write-guard.d.ts +50 -0
  112. package/dist/esm/relational/core/repositories/common/scope-write-guard.d.ts.map +1 -0
  113. package/dist/esm/relational/core/repositories/common/scope-write-guard.js +244 -0
  114. package/dist/esm/relational/core/repositories/common/scope-write-guard.js.map +1 -0
  115. package/dist/esm/relational/core/repositories/core/base.d.ts +35 -20
  116. package/dist/esm/relational/core/repositories/core/base.d.ts.map +1 -1
  117. package/dist/esm/relational/core/repositories/core/base.js +29 -4
  118. package/dist/esm/relational/core/repositories/core/base.js.map +1 -1
  119. package/dist/esm/relational/core/repositories/core/persistable.d.ts.map +1 -1
  120. package/dist/esm/relational/core/repositories/core/persistable.js +6 -1
  121. package/dist/esm/relational/core/repositories/core/persistable.js.map +1 -1
  122. package/dist/esm/relational/core/repositories/core/readable.d.ts +17 -17
  123. package/dist/esm/relational/core/repositories/core/readable.d.ts.map +1 -1
  124. package/dist/esm/relational/core/repositories/core/readable.js +8 -2
  125. package/dist/esm/relational/core/repositories/core/readable.js.map +1 -1
  126. package/dist/esm/relational/core/repositories/core/soft-deletable.d.ts +9 -9
  127. package/dist/esm/relational/core/repositories/core/soft-deletable.d.ts.map +1 -1
  128. package/dist/esm/relational/core/repositories/core/soft-deletable.js.map +1 -1
  129. package/dist/esm/relational/core/repositories/dialect/filter.d.ts +2 -2
  130. package/dist/esm/relational/core/repositories/dialect/filter.js +6 -6
  131. package/dist/esm/relational/core/repositories/dialect/filter.js.map +1 -1
  132. package/dist/esm/relational/core/repositories/dialect/relations/one.d.ts.map +1 -1
  133. package/dist/esm/relational/core/repositories/dialect/relations/one.js +7 -7
  134. package/dist/esm/relational/core/repositories/dialect/relations/one.js.map +1 -1
  135. package/dist/esm/relational/core/repositories/sqls/recursive-tree.d.ts +9 -0
  136. package/dist/esm/relational/core/repositories/sqls/recursive-tree.d.ts.map +1 -1
  137. package/dist/esm/relational/core/repositories/sqls/recursive-tree.js +18 -7
  138. package/dist/esm/relational/core/repositories/sqls/recursive-tree.js.map +1 -1
  139. package/dist/esm/relational/postgres/drivers/pglite.js +2 -2
  140. package/dist/esm/relational/postgres/drivers/pglite.js.map +1 -1
  141. package/dist/esm/relational/postgres/repositories/dialect/query.js +1 -1
  142. package/dist/esm/relational/postgres/repositories/dialect/query.js.map +1 -1
  143. package/dist/esm/relational/sqlite/drivers/libsql.js +2 -2
  144. package/dist/esm/relational/sqlite/drivers/libsql.js.map +1 -1
  145. package/dist/esm/relational/sqlite/repositories/dialect/internal/json-path.js +3 -3
  146. package/dist/esm/relational/sqlite/repositories/dialect/internal/json-path.js.map +1 -1
  147. package/dist/esm/search/core/connector.js +2 -2
  148. package/dist/esm/search/core/connector.js.map +1 -1
  149. package/dist/esm/search/core/controllers/abstract.d.ts +4 -0
  150. package/dist/esm/search/core/controllers/abstract.d.ts.map +1 -1
  151. package/dist/esm/search/core/controllers/abstract.js +15 -1
  152. package/dist/esm/search/core/controllers/abstract.js.map +1 -1
  153. package/dist/esm/search/core/controllers/factory.d.ts +14 -0
  154. package/dist/esm/search/core/controllers/factory.d.ts.map +1 -1
  155. package/dist/esm/search/core/controllers/factory.js +7 -1
  156. package/dist/esm/search/core/controllers/factory.js.map +1 -1
  157. package/dist/esm/search/core/controllers/scope.d.ts +28 -0
  158. package/dist/esm/search/core/controllers/scope.d.ts.map +1 -0
  159. package/dist/esm/search/core/controllers/scope.js +64 -0
  160. package/dist/esm/search/core/controllers/scope.js.map +1 -0
  161. package/dist/esm/search/core/datasources/base.js +2 -2
  162. package/dist/esm/search/core/datasources/base.js.map +1 -1
  163. package/dist/esm/search/core/models/define-search-collection.js +3 -3
  164. package/dist/esm/search/core/models/define-search-collection.js.map +1 -1
  165. package/dist/esm/search/core/models/zod-derivation.js +1 -1
  166. package/dist/esm/search/core/models/zod-derivation.js.map +1 -1
  167. package/dist/esm/search/core/repositories/common/dialect-helpers.js +1 -1
  168. package/dist/esm/search/core/repositories/common/dialect-helpers.js.map +1 -1
  169. package/dist/esm/search/core/repositories/core/base.js +2 -2
  170. package/dist/esm/search/core/repositories/core/base.js.map +1 -1
  171. package/dist/esm/search/core/repositories/core/readable.d.ts +17 -17
  172. package/dist/esm/search/core/repositories/core/readable.d.ts.map +1 -1
  173. package/dist/esm/search/core/repositories/core/readable.js +4 -4
  174. package/dist/esm/search/core/repositories/core/readable.js.map +1 -1
  175. package/dist/esm/search/meilisearch/compiler.js +4 -4
  176. package/dist/esm/search/meilisearch/compiler.js.map +1 -1
  177. package/dist/esm/search/meilisearch/connector.js +22 -22
  178. package/dist/esm/search/meilisearch/connector.js.map +1 -1
  179. package/dist/esm/search/meilisearch/internal/connector-internal.js +1 -1
  180. package/dist/esm/search/meilisearch/internal/connector-internal.js.map +1 -1
  181. package/dist/esm/search/meilisearch/repositories/dialect/query-dialect.js +6 -6
  182. package/dist/esm/search/meilisearch/repositories/dialect/query-dialect.js.map +1 -1
  183. package/dist/esm/search/typesense/compiler.js +8 -8
  184. package/dist/esm/search/typesense/compiler.js.map +1 -1
  185. package/dist/esm/search/typesense/connector.js +23 -23
  186. package/dist/esm/search/typesense/connector.js.map +1 -1
  187. package/dist/esm/search/typesense/internal/mappers.js +1 -1
  188. package/dist/esm/search/typesense/internal/mappers.js.map +1 -1
  189. package/dist/esm/search/typesense/internal/pagination-windows.js +3 -3
  190. package/dist/esm/search/typesense/internal/pagination-windows.js.map +1 -1
  191. package/dist/esm/search/typesense/repositories/dialect/query-dialect.js +7 -7
  192. package/dist/esm/search/typesense/repositories/dialect/query-dialect.js.map +1 -1
  193. 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"]}
@@ -5,7 +5,7 @@ import { between, eq, gt, gte, ilike, inArray, isNotNull, isNull, like, lt, lte,
5
5
  /** 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. */
6
6
  const buildPgArrayComparison = (opts) => {
7
7
  const { column, value, operator } = opts;
8
- const items = sql.join(value.map(item => sql `${item}`), sql `, `);
8
+ const items = sql.join(value.map((item) => sql `${item}`), sql `, `);
9
9
  const isNumericOrBoolean = typeof value[0] === 'number' || typeof value[0] === 'boolean';
10
10
  if (isNumericOrBoolean) {
11
11
  return sql `${column} ${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"]}
@@ -52,7 +52,7 @@ export class LibSqlDriver {
52
52
  maxWaitingClients,
53
53
  scope: scope ?? LibSqlDriver.name,
54
54
  create: () => this.client,
55
- destroy: resource => this.scrubSession({ resource }),
55
+ destroy: (resource) => this.scrubSession({ resource }),
56
56
  });
57
57
  }
58
58
  createConnector(opts) {
@@ -112,7 +112,7 @@ export class LibSqlDriver {
112
112
  // Discard cannot throw the connection away - there is one client and no
113
113
  // replacement. The slot is re-created from the same instance after the destroy
114
114
  // hook scrubs it, so the next waiter never inherits an unknown transaction.
115
- this.slot.discard({ resource: client }).catch(error => {
115
+ this.slot.discard({ resource: client }).catch((error) => {
116
116
  this.logger.for('release').error('Failed to discard the libsql slot | Error: %s', error);
117
117
  });
118
118
  },
@@ -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"]}
@@ -11,7 +11,7 @@ const isAmbiguousComponent = (opts) => /^\d+$/.test(opts.part);
11
11
  */
12
12
  export const toSqliteJsonPaths = (opts) => {
13
13
  const { path } = opts;
14
- const ambiguousCount = path.filter(part => isAmbiguousComponent({ part })).length;
14
+ const ambiguousCount = path.filter((part) => isAmbiguousComponent({ part })).length;
15
15
  if (ambiguousCount > MAX_AMBIGUOUS_COMPONENTS) {
16
16
  throw getError({
17
17
  message: `[toSqliteJsonPaths] Ambiguous JSON path components over the limit | max: ${MAX_AMBIGUOUS_COMPONENTS} | got: ${ambiguousCount} | each all-digit component doubles the candidate paths`,
@@ -20,8 +20,8 @@ export const toSqliteJsonPaths = (opts) => {
20
20
  let literals = ['$'];
21
21
  for (const part of path) {
22
22
  literals = isAmbiguousComponent({ part })
23
- ? literals.flatMap(literal => [`${literal}[${part}]`, `${literal}."${part}"`])
24
- : literals.map(literal => `${literal}."${part}"`);
23
+ ? literals.flatMap((literal) => [`${literal}[${part}]`, `${literal}."${part}"`])
24
+ : literals.map((literal) => `${literal}."${part}"`);
25
25
  }
26
26
  return literals;
27
27
  };
@@ -1 +1 @@
1
- {"version":3,"file":"json-path.js","sourceRoot":"","sources":["../../../../../../../src/relational/sqlite/repositories/dialect/internal/json-path.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;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;AACH,MAAM,CAAC,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,QAAQ,CAAC;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;AAEF,MAAM,eAAe,GAAG,IAAI,WAAW,CAAC,eAAe,CAAC,CAAC;AACzD,MAAM,yBAAyB,GAAG,IAAI,WAAW,CAAC,wBAAwB,CAAC,CAAC;AAE5E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,IAG5C,EAAc,EAAE;IACf,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAE9B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,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,WAAW,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,WAAW,CAAC,MAAM,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;IAE7E,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC","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,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;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;AACH,MAAM,CAAC,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,QAAQ,CAAC;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;AAEF,MAAM,eAAe,GAAG,IAAI,WAAW,CAAC,eAAe,CAAC,CAAC;AACzD,MAAM,yBAAyB,GAAG,IAAI,WAAW,CAAC,wBAAwB,CAAC,CAAC;AAE5E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,IAG5C,EAAc,EAAE;IACf,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAE9B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,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,WAAW,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,WAAW,CAAC,MAAM,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;IAE7E,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC","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"]}
@@ -37,7 +37,7 @@ export class BaseSearchConnector extends BaseHelper {
37
37
  notFoundTolerance(opts) {
38
38
  const { method, subject } = opts;
39
39
  return {
40
- when: error => this.isNotFoundError({ error }),
40
+ when: (error) => this.isNotFoundError({ error }),
41
41
  handle: () => {
42
42
  this.logger.for(method).debug('%s not found', subject);
43
43
  SearchConnectorInternal.throwNotFoundError({ method, subject });
@@ -48,7 +48,7 @@ export class BaseSearchConnector extends BaseHelper {
48
48
  notFoundFallback(opts) {
49
49
  const { method, message, args, fallback } = opts;
50
50
  return {
51
- when: error => this.isNotFoundError({ error }),
51
+ when: (error) => this.isNotFoundError({ error }),
52
52
  handle: () => {
53
53
  this.logger.for(method).debug(message, ...(args ?? []));
54
54
  return fallback;
@@ -1 +1 @@
1
- {"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../../src/search/core/connector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AA8IrD,MAAM,OAAgB,mBAAoB,SAAQ,UAAU;IAC1D,YAAY,IAA2C;QACrD,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,EAAE,CAAC;IACnB,CAAC;IAES,cAAc,CAAC,IAA6D;QACpF,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACrC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,MAAM,oCAAoC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,gHAAgH;IACtG,KAAK,CAAC,aAAa,CAAI,IAIhC;QACC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,GAAG,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxC,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,0JAA0J;YAC1J,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,uBAAuB,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAKD,2IAA2I;IACjI,iBAAiB,CAAC,IAAyC;QAInE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEjC,OAAO;YACL,IAAI,EAAE,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,uBAAuB,CAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAClE,CAAC;SACF,CAAC;IACJ,CAAC;IAED,sKAAsK;IAC5J,gBAAgB,CAAI,IAK7B;QACC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEjD,OAAO;YACL,IAAI,EAAE,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","sourcesContent":["import type { ISynonym } from '@/search/core/models';\nimport type { ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError, isApplicationError } from '@venizia/ignis-helpers/core';\nimport { SearchConnectorInternal } from './internal';\n\nexport interface IImportResult<TResponse = unknown> {\n count: { success: number; fail: number };\n responses: TResponse[];\n}\n\nexport interface IAliasInfo {\n name: string;\n collection: string;\n}\n\nexport interface ISearchConnectorCallbacks {\n onInitialized?: (opts: { name: string }) => void;\n onError?: (opts: { name: string; error: unknown }) => void;\n}\n\n/** Search-response envelope, read without a boundary cast. `score` scales are unrelated across engines - never compare or threshold one against another; `isFoundExact` is false when `found` is approximate. */\nexport interface ISearchResult<\n DocumentType extends object = object,\n HighlightType = unknown,\n FacetCountType = unknown,\n GroupedHitType = unknown,\n> {\n found: number;\n isFoundExact: boolean;\n outOf?: number;\n searchTimeMs?: number;\n hits?: Array<{\n document: DocumentType;\n highlight?: HighlightType;\n highlights?: HighlightType[];\n score?: number;\n }>;\n facetCounts?: FacetCountType[];\n groupedHits?: GroupedHitType[];\n}\n\n// Schema/field types are engine-specific, not caller-owned - hence interface-level generics filled by the engine's connector, defaulting to `unknown` so `ISearchConnector` stays engine-agnostic.\nexport interface ISearchCollectionScoped<\n CreateSchema = unknown,\n Schema = unknown,\n FieldSchema = unknown,\n> {\n create(opts: { schema: CreateSchema }): Promise<Schema | void>;\n ensure(opts: { schema: CreateSchema }): Promise<Schema>;\n get(opts: { name: string }): Promise<Schema>;\n list(): Promise<Schema[]>;\n exists(opts: { name: string }): Promise<boolean>;\n patchSchema(opts: { name: string; fields: FieldSchema[] }): Promise<void>;\n delete(opts: { name: string }): Promise<boolean>;\n}\n\n/** A named pointer to one physical collection. Engines without aliases omit this group entirely. */\nexport interface ISearchAliasScoped {\n upsert(opts: { name: string; collection: string }): Promise<void>;\n get(opts: { name: string }): Promise<IAliasInfo | null>;\n}\n\n/** Atomic exchange of two collections' documents and settings - the alias-less path to a zero-downtime reindex. */\nexport interface ISearchSwapScoped {\n indexes(opts: { pairs: Array<[string, string]> }): Promise<void>;\n}\n\n// Synonym SETS (Typesense v30+): a named item set linked to one or more collections; `ISynonym` is the item shape.\nexport interface ISearchSynonymSetScoped {\n upsert(opts: { name: string; items: ISynonym[] }): Promise<void>;\n get(opts: { name: string }): Promise<ISynonym[] | null>;\n list(): Promise<string[]>;\n delete(opts: { name: string }): Promise<boolean>;\n link(opts: { collection: string; synonymSets: string[] }): Promise<void>;\n}\n\n/** A flat per-collection synonym dictionary - no named, linkable set resource. */\nexport interface ISearchSynonymScoped {\n set(opts: { collection: string; items: ISynonym[] }): Promise<void>;\n get(opts: { collection: string }): Promise<ISynonym[]>;\n reset(opts: { collection: string }): Promise<void>;\n}\n\nexport interface ISearchDocumentScoped {\n get<T extends object>(opts: { collection: string; id: string }): Promise<T>;\n\n /** Exact count of documents matching `filterBy`. Engines whose search endpoint caps or estimates its total must answer from a document-listing endpoint instead. */\n count(opts: { collection: string; filterBy?: string }): Promise<number>;\n\n create<T extends object>(opts: { collection: string; document: T }): Promise<T>;\n\n upsert<T extends object>(opts: { collection: string; document: T }): Promise<T>;\n update<T extends object>(opts: {\n collection: string;\n id: string;\n document: Partial<T>;\n }): Promise<T>;\n updateBy<T extends object>(opts: {\n collection: string;\n document: Partial<T>;\n filterBy: string;\n }): Promise<{ updatedCount: number }>;\n\n delete(opts: { collection: string; id: string }): Promise<boolean>;\n deleteBy(opts: { collection: string; filterBy: string }): Promise<number>;\n deleteAll(opts: { collection: string }): Promise<boolean>;\n\n import<T extends object>(opts: {\n collection: string;\n documents: T[];\n batchSize?: number;\n }): Promise<IImportResult<unknown>>;\n export(opts: {\n collection: string;\n filterBy?: string;\n includeFields?: string[];\n }): Promise<string>;\n}\n\n/** The verb contract every search engine implements - an interface so tests can fake it clientless. `collection`/`document` are the true intersection; `alias`/`synonymSet`/`synonyms`/`swap` are optional since no engine has all four, so agnostic callers must write `connector.alias?.…`. */\nexport interface ISearchConnector {\n getHealth(): Promise<{ ok: boolean }>;\n ping(): Promise<boolean>;\n\n collection: ISearchCollectionScoped;\n document: ISearchDocumentScoped;\n\n alias?: ISearchAliasScoped;\n synonymSet?: ISearchSynonymSetScoped;\n synonyms?: ISearchSynonymScoped;\n swap?: ISearchSwapScoped;\n\n search<TDocument extends object = object>(opts: {\n collection: string;\n params: unknown;\n }): Promise<ISearchResult<TDocument>>;\n\n multiSearch(opts: {\n searches: unknown[];\n union?: boolean;\n commonParams?: unknown;\n options?: unknown;\n }): Promise<unknown>;\n}\n\nexport abstract class BaseSearchConnector extends BaseHelper implements ISearchConnector {\n constructor(opts: { scope: string; identifier: string }) {\n super(opts);\n }\n\n async ping(): Promise<boolean> {\n const health = await this.getHealth();\n return health.ok;\n }\n\n protected assertNonEmpty(opts: { value?: string | null; name: string; method: string }): void {\n const { value, name, method } = opts;\n if (!value || value.trim().length === 0) {\n throw getError({ message: `[${method}] Missing or empty value | name: ${name}` });\n }\n }\n\n // Runs the engine verb; tolerated errors route to the caller's branch, everything else becomes a sanitized 503.\n protected async runEngineCall<T>(opts: {\n method: string;\n run: () => ValueOrPromise<T>;\n tolerate?: { when: (error: unknown) => boolean; handle: (error: unknown) => ValueOrPromise<T> };\n }) {\n const { method, run, tolerate } = opts;\n\n try {\n const rs = await run();\n return rs;\n } catch (error) {\n if (tolerate?.when(error)) {\n const rs = await tolerate.handle(error);\n return rs;\n }\n\n // A framework ApplicationError is already sanitized and carries its own statusCode/messageCode; only raw engine failures may be wrapped as a generic 503.\n if (isApplicationError(error)) {\n throw error;\n }\n\n SearchConnectorInternal.wrapDependencyError({ method, error, logger: this.logger });\n }\n }\n\n /** Which errors mean \"not found\" is engine-specific classification; the sanitized throw and the benign fallback are not. */\n protected abstract isNotFoundError(opts: { error: unknown }): boolean;\n\n /** Tolerated-404 branch shared by getCollection/patchCollectionSchema/getDocument/updateDocument: throws the sanitized not-found error. */\n protected notFoundTolerance(opts: { method: string; subject: string }): {\n when: (error: unknown) => boolean;\n handle: (error: unknown) => never;\n } {\n const { method, subject } = opts;\n\n return {\n when: error => this.isNotFoundError({ error }),\n handle: () => {\n this.logger.for(method).debug('%s not found', subject);\n SearchConnectorInternal.throwNotFoundError({ method, subject });\n },\n };\n }\n\n /** Tolerated-404 branch shared by deleteCollection/getAlias/getSynonymSet/deleteSynonymSet/deleteDocument: logs and returns a benign sentinel instead of throwing. */\n protected notFoundFallback<T>(opts: {\n method: string;\n message: string;\n args?: unknown[];\n fallback: T;\n }): { when: (error: unknown) => boolean; handle: (error: unknown) => T } {\n const { method, message, args, fallback } = opts;\n\n return {\n when: error => this.isNotFoundError({ error }),\n handle: () => {\n this.logger.for(method).debug(message, ...(args ?? []));\n return fallback;\n },\n };\n }\n\n abstract getHealth(): Promise<{ ok: boolean }>;\n\n // Resource-scoped verb groups, each supplied by the concrete connector as a facade object; only the intersection is abstract - an engine declares its own alias/synonymSet/synonyms/swap.\n abstract collection: ISearchCollectionScoped;\n abstract document: ISearchDocumentScoped;\n\n abstract search<TDocument extends object = object>(opts: {\n collection: string;\n params: unknown;\n }): Promise<ISearchResult<TDocument>>;\n\n abstract multiSearch(opts: {\n searches: unknown[];\n union?: boolean;\n commonParams?: unknown;\n }): Promise<unknown>;\n}\n"]}
1
+ {"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../../src/search/core/connector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AA8IrD,MAAM,OAAgB,mBAAoB,SAAQ,UAAU;IAC1D,YAAY,IAA2C;QACrD,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,EAAE,CAAC;IACnB,CAAC;IAES,cAAc,CAAC,IAA6D;QACpF,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACrC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,MAAM,oCAAoC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,gHAAgH;IACtG,KAAK,CAAC,aAAa,CAAI,IAIhC;QACC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,GAAG,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxC,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,0JAA0J;YAC1J,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,uBAAuB,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAKD,2IAA2I;IACjI,iBAAiB,CAAC,IAAyC;QAInE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEjC,OAAO;YACL,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAChD,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;gBACvD,uBAAuB,CAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAClE,CAAC;SACF,CAAC;IACJ,CAAC;IAED,sKAAsK;IAC5J,gBAAgB,CAAI,IAK7B;QACC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEjD,OAAO;YACL,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAChD,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;gBACxD,OAAO,QAAQ,CAAC;YAClB,CAAC;SACF,CAAC;IACJ,CAAC;CAkBF","sourcesContent":["import type { ISynonym } from '@/search/core/models';\nimport type { ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError, isApplicationError } from '@venizia/ignis-helpers/core';\nimport { SearchConnectorInternal } from './internal';\n\nexport interface IImportResult<TResponse = unknown> {\n count: { success: number; fail: number };\n responses: TResponse[];\n}\n\nexport interface IAliasInfo {\n name: string;\n collection: string;\n}\n\nexport interface ISearchConnectorCallbacks {\n onInitialized?: (opts: { name: string }) => void;\n onError?: (opts: { name: string; error: unknown }) => void;\n}\n\n/** Search-response envelope, read without a boundary cast. `score` scales are unrelated across engines - never compare or threshold one against another; `isFoundExact` is false when `found` is approximate. */\nexport interface ISearchResult<\n DocumentType extends object = object,\n HighlightType = unknown,\n FacetCountType = unknown,\n GroupedHitType = unknown,\n> {\n found: number;\n isFoundExact: boolean;\n outOf?: number;\n searchTimeMs?: number;\n hits?: Array<{\n document: DocumentType;\n highlight?: HighlightType;\n highlights?: HighlightType[];\n score?: number;\n }>;\n facetCounts?: FacetCountType[];\n groupedHits?: GroupedHitType[];\n}\n\n// Schema/field types are engine-specific, not caller-owned - hence interface-level generics filled by the engine's connector, defaulting to `unknown` so `ISearchConnector` stays engine-agnostic.\nexport interface ISearchCollectionScoped<\n CreateSchema = unknown,\n Schema = unknown,\n FieldSchema = unknown,\n> {\n create(opts: { schema: CreateSchema }): Promise<Schema | void>;\n ensure(opts: { schema: CreateSchema }): Promise<Schema>;\n get(opts: { name: string }): Promise<Schema>;\n list(): Promise<Schema[]>;\n exists(opts: { name: string }): Promise<boolean>;\n patchSchema(opts: { name: string; fields: FieldSchema[] }): Promise<void>;\n delete(opts: { name: string }): Promise<boolean>;\n}\n\n/** A named pointer to one physical collection. Engines without aliases omit this group entirely. */\nexport interface ISearchAliasScoped {\n upsert(opts: { name: string; collection: string }): Promise<void>;\n get(opts: { name: string }): Promise<IAliasInfo | null>;\n}\n\n/** Atomic exchange of two collections' documents and settings - the alias-less path to a zero-downtime reindex. */\nexport interface ISearchSwapScoped {\n indexes(opts: { pairs: Array<[string, string]> }): Promise<void>;\n}\n\n// Synonym SETS (Typesense v30+): a named item set linked to one or more collections; `ISynonym` is the item shape.\nexport interface ISearchSynonymSetScoped {\n upsert(opts: { name: string; items: ISynonym[] }): Promise<void>;\n get(opts: { name: string }): Promise<ISynonym[] | null>;\n list(): Promise<string[]>;\n delete(opts: { name: string }): Promise<boolean>;\n link(opts: { collection: string; synonymSets: string[] }): Promise<void>;\n}\n\n/** A flat per-collection synonym dictionary - no named, linkable set resource. */\nexport interface ISearchSynonymScoped {\n set(opts: { collection: string; items: ISynonym[] }): Promise<void>;\n get(opts: { collection: string }): Promise<ISynonym[]>;\n reset(opts: { collection: string }): Promise<void>;\n}\n\nexport interface ISearchDocumentScoped {\n get<T extends object>(opts: { collection: string; id: string }): Promise<T>;\n\n /** Exact count of documents matching `filterBy`. Engines whose search endpoint caps or estimates its total must answer from a document-listing endpoint instead. */\n count(opts: { collection: string; filterBy?: string }): Promise<number>;\n\n create<T extends object>(opts: { collection: string; document: T }): Promise<T>;\n\n upsert<T extends object>(opts: { collection: string; document: T }): Promise<T>;\n update<T extends object>(opts: {\n collection: string;\n id: string;\n document: Partial<T>;\n }): Promise<T>;\n updateBy<T extends object>(opts: {\n collection: string;\n document: Partial<T>;\n filterBy: string;\n }): Promise<{ updatedCount: number }>;\n\n delete(opts: { collection: string; id: string }): Promise<boolean>;\n deleteBy(opts: { collection: string; filterBy: string }): Promise<number>;\n deleteAll(opts: { collection: string }): Promise<boolean>;\n\n import<T extends object>(opts: {\n collection: string;\n documents: T[];\n batchSize?: number;\n }): Promise<IImportResult<unknown>>;\n export(opts: {\n collection: string;\n filterBy?: string;\n includeFields?: string[];\n }): Promise<string>;\n}\n\n/** The verb contract every search engine implements - an interface so tests can fake it clientless. `collection`/`document` are the true intersection; `alias`/`synonymSet`/`synonyms`/`swap` are optional since no engine has all four, so agnostic callers must write `connector.alias?.…`. */\nexport interface ISearchConnector {\n getHealth(): Promise<{ ok: boolean }>;\n ping(): Promise<boolean>;\n\n collection: ISearchCollectionScoped;\n document: ISearchDocumentScoped;\n\n alias?: ISearchAliasScoped;\n synonymSet?: ISearchSynonymSetScoped;\n synonyms?: ISearchSynonymScoped;\n swap?: ISearchSwapScoped;\n\n search<TDocument extends object = object>(opts: {\n collection: string;\n params: unknown;\n }): Promise<ISearchResult<TDocument>>;\n\n multiSearch(opts: {\n searches: unknown[];\n union?: boolean;\n commonParams?: unknown;\n options?: unknown;\n }): Promise<unknown>;\n}\n\nexport abstract class BaseSearchConnector extends BaseHelper implements ISearchConnector {\n constructor(opts: { scope: string; identifier: string }) {\n super(opts);\n }\n\n async ping(): Promise<boolean> {\n const health = await this.getHealth();\n return health.ok;\n }\n\n protected assertNonEmpty(opts: { value?: string | null; name: string; method: string }): void {\n const { value, name, method } = opts;\n if (!value || value.trim().length === 0) {\n throw getError({ message: `[${method}] Missing or empty value | name: ${name}` });\n }\n }\n\n // Runs the engine verb; tolerated errors route to the caller's branch, everything else becomes a sanitized 503.\n protected async runEngineCall<T>(opts: {\n method: string;\n run: () => ValueOrPromise<T>;\n tolerate?: { when: (error: unknown) => boolean; handle: (error: unknown) => ValueOrPromise<T> };\n }) {\n const { method, run, tolerate } = opts;\n\n try {\n const rs = await run();\n return rs;\n } catch (error) {\n if (tolerate?.when(error)) {\n const rs = await tolerate.handle(error);\n return rs;\n }\n\n // A framework ApplicationError is already sanitized and carries its own statusCode/messageCode; only raw engine failures may be wrapped as a generic 503.\n if (isApplicationError(error)) {\n throw error;\n }\n\n SearchConnectorInternal.wrapDependencyError({ method, error, logger: this.logger });\n }\n }\n\n /** Which errors mean \"not found\" is engine-specific classification; the sanitized throw and the benign fallback are not. */\n protected abstract isNotFoundError(opts: { error: unknown }): boolean;\n\n /** Tolerated-404 branch shared by getCollection/patchCollectionSchema/getDocument/updateDocument: throws the sanitized not-found error. */\n protected notFoundTolerance(opts: { method: string; subject: string }): {\n when: (error: unknown) => boolean;\n handle: (error: unknown) => never;\n } {\n const { method, subject } = opts;\n\n return {\n when: (error) => this.isNotFoundError({ error }),\n handle: () => {\n this.logger.for(method).debug('%s not found', subject);\n SearchConnectorInternal.throwNotFoundError({ method, subject });\n },\n };\n }\n\n /** Tolerated-404 branch shared by deleteCollection/getAlias/getSynonymSet/deleteSynonymSet/deleteDocument: logs and returns a benign sentinel instead of throwing. */\n protected notFoundFallback<T>(opts: {\n method: string;\n message: string;\n args?: unknown[];\n fallback: T;\n }): { when: (error: unknown) => boolean; handle: (error: unknown) => T } {\n const { method, message, args, fallback } = opts;\n\n return {\n when: (error) => this.isNotFoundError({ error }),\n handle: () => {\n this.logger.for(method).debug(message, ...(args ?? []));\n return fallback;\n },\n };\n }\n\n abstract getHealth(): Promise<{ ok: boolean }>;\n\n // Resource-scoped verb groups, each supplied by the concrete connector as a facade object; only the intersection is abstract - an engine declares its own alias/synonymSet/synonyms/swap.\n abstract collection: ISearchCollectionScoped;\n abstract document: ISearchDocumentScoped;\n\n abstract search<TDocument extends object = object>(opts: {\n collection: string;\n params: unknown;\n }): Promise<ISearchResult<TDocument>>;\n\n abstract multiSearch(opts: {\n searches: unknown[];\n union?: boolean;\n commonParams?: unknown;\n }): Promise<unknown>;\n}\n"]}
@@ -5,15 +5,19 @@ import type { TAnyObjectSchema } from '@venizia/ignis-kernel';
5
5
  import type { AnyType } from '@venizia/ignis-helpers/common';
6
6
  import type { Env, Schema } from 'hono';
7
7
  import type { ReadableSearchRepository } from '../repositories/core/readable.js';
8
+ import type { TSearchScopeResolver } from './scope.js';
8
9
  /** Base tier of a generated search controller: the repository handle plus the search / multi-search verbs; SearchControllerFactory returns a thin subclass that only builds route configs and wires them. */
9
10
  export declare abstract class AbstractSearchController<TEntity extends AbstractEntity<TAnyObjectSchema> = AbstractEntity<TAnyObjectSchema>, RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ConfigurableOptions extends object = {}, TDataObject extends object = TEntityDataObject<TEntity>> extends BaseRestController<RouteEnv, RouteSchema, BasePath, ConfigurableOptions> {
10
11
  repository: ReadableSearchRepository<TDataObject>;
12
+ searchScope?: TSearchScopeResolver<RouteEnv>;
11
13
  constructor(opts: {
12
14
  scope: string;
13
15
  path: string;
14
16
  isStrict?: boolean;
15
17
  repository: ReadableSearchRepository<TDataObject>;
16
18
  definitions: AnyType;
19
+ /** Per-request search scope; see {@link TSearchScopeResolver}. */
20
+ searchScope?: TSearchScopeResolver<RouteEnv>;
17
21
  });
18
22
  /** POST /search - single-collection keyword/semantic/hybrid/raw search. Carries the list headers of every IGNIS list endpoint; the body keeps `{ found, isFoundExact, hits }` because `isFoundExact` has no place in a `{ count, data }` envelope, and it is the only carrier of "found is an estimate". */
19
23
  search(opts: {
@@ -1 +1 @@
1
- {"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../../src/search/core/controllers/abstract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAkB,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGxC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AA2B9E,6MAA6M;AAC7M,8BAAsB,wBAAwB,CAC5C,OAAO,SAAS,cAAc,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC,gBAAgB,CAAC,EACnF,QAAQ,SAAS,GAAG,GAAG,GAAG,EAC1B,WAAW,SAAS,MAAM,GAAG,EAAE,EAC/B,QAAQ,SAAS,MAAM,GAAG,GAAG,EAC7B,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,WAAW,SAAS,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CACvD,SAAQ,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,CAAC;IAChF,UAAU,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAC;gBAEtC,IAAI,EAAE;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAC;QAClD,WAAW,EAAE,OAAO,CAAC;KACtB;IAMD,4SAA4S;IACtS,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;KAAE;IAwBvD,sFAAsF;IAChF,WAAW,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;KAAE;CAY7D"}
1
+ {"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../../src/search/core/controllers/abstract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAkB,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGxC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAE9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AA2BpD,6MAA6M;AAC7M,8BAAsB,wBAAwB,CAC5C,OAAO,SAAS,cAAc,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC,gBAAgB,CAAC,EACnF,QAAQ,SAAS,GAAG,GAAG,GAAG,EAC1B,WAAW,SAAS,MAAM,GAAG,EAAE,EAC/B,QAAQ,SAAS,MAAM,GAAG,GAAG,EAC7B,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,WAAW,SAAS,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CACvD,SAAQ,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,CAAC;IAChF,UAAU,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAC;IAClD,WAAW,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;gBAEjC,IAAI,EAAE;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAC;QAClD,WAAW,EAAE,OAAO,CAAC;QACrB,kEAAkE;QAClE,WAAW,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;KAC9C;IAOD,4SAA4S;IACtS,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;KAAE;IA2BvD,sFAAsF;IAChF,WAAW,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;KAAE;CAqB7D"}
@@ -1,6 +1,8 @@
1
1
  import { BaseRestController, buildDataRange } from '@venizia/ignis-kernel';
2
+ import { getError } from '@venizia/ignis-helpers/core';
2
3
  import { HTTP } from '@venizia/ignis-helpers/common';
3
4
  import { SearchModes } from '../repositories/common/index.js';
5
+ import { applySearchScope } from './scope.js';
4
6
  /** Where the page starts, for `Content-Range`. Friendly modes carry `filter.skip` or `filter.offset`; raw mode carries the engine's own `offset`, or a 1-based `page` with `per_page`/`perPage`. A raw request that names a page but no page size is measured against this page's hit count, so only its last page can be off. */
5
7
  const resolveSearchStart = (opts) => {
6
8
  const { input, hitCount } = opts;
@@ -26,12 +28,16 @@ export class AbstractSearchController extends BaseRestController {
26
28
  constructor(opts) {
27
29
  super({ scope: opts.scope, path: opts.path, isStrict: opts.isStrict });
28
30
  this.repository = opts.repository;
31
+ this.searchScope = opts.searchScope;
29
32
  this.definitions = opts.definitions;
30
33
  }
31
34
  /** POST /search - single-collection keyword/semantic/hybrid/raw search. Carries the list headers of every IGNIS list endpoint; the body keeps `{ found, isFoundExact, hits }` because `isFoundExact` has no place in a `{ count, data }` envelope, and it is the only carrier of "found is an estimate". */
32
35
  async search(opts) {
33
36
  const { context } = opts;
34
- const input = context.req.valid('json');
37
+ const body = context.req.valid('json');
38
+ const input = this.searchScope
39
+ ? await applySearchScope({ resolve: this.searchScope, context, input: body })
40
+ : body;
35
41
  const rs = await this.measure({
36
42
  scope: 'search',
37
43
  args: input,
@@ -52,6 +58,14 @@ export class AbstractSearchController extends BaseRestController {
52
58
  /** POST /multi-search - cross-collection search, forwarded verbatim to the engine. */
53
59
  async multiSearch(opts) {
54
60
  const { context } = opts;
61
+ // A multi-search entry carries the engine's own `filterBy` string, which a `where` scope cannot
62
+ // be ANDed into: a scoped controller does not serve it.
63
+ if (this.searchScope) {
64
+ throw getError({
65
+ statusCode: HTTP.ResultCodes.RS_4.BadRequest,
66
+ message: '[multiSearch] multi-search is not available on a scoped search controller',
67
+ });
68
+ }
55
69
  const input = context.req.valid('json');
56
70
  const rs = await this.measure({
57
71
  scope: 'multiSearch',
@@ -1 +1 @@
1
- {"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../src/search/core/controllers/abstract.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TEntityDataObject, TRouteContext } from '@venizia/ignis-kernel';\nimport { BaseRestController, buildDataRange } from '@venizia/ignis-kernel';\nimport type { AbstractEntity } from '@venizia/ignis-kernel';\nimport type { TAnyObjectSchema } from '@venizia/ignis-kernel';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport type { Env, Schema } from 'hono';\nimport type { TMultiSearchInput, TSearchInput } from '@/search/core/repositories/common';\nimport { SearchModes } from '@/search/core/repositories/common';\nimport type { ReadableSearchRepository } from '../repositories/core/readable';\n\n/** Where the page starts, for `Content-Range`. Friendly modes carry `filter.skip` or `filter.offset`; raw mode carries the engine's own `offset`, or a 1-based `page` with `per_page`/`perPage`. A raw request that names a page but no page size is measured against this page's hit count, so only its last page can be off. */\nconst resolveSearchStart = (opts: { input: TSearchInput; hitCount: number }): number => {\n const { input, hitCount } = opts;\n\n if (input.mode !== SearchModes.RAW) {\n // Same precedence as buildDataRange: the repository filter carries skip or offset.\n return input.filter?.skip ?? input.filter?.offset ?? 0;\n }\n\n // Engine wire names are read through string keys only; `params` is an untyped passthrough.\n const params = input.params;\n const offset = params['offset'];\n if (typeof offset === 'number') {\n return offset;\n }\n\n const page = params['page'];\n if (typeof page !== 'number' || page < 1) {\n return 0;\n }\n\n const pageSize = params['per_page'] ?? params['perPage'];\n return (page - 1) * (typeof pageSize === 'number' ? pageSize : hitCount);\n};\n\n/** Base tier of a generated search controller: the repository handle plus the search / multi-search verbs; SearchControllerFactory returns a thin subclass that only builds route configs and wires them. */\nexport abstract class AbstractSearchController<\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> extends BaseRestController<RouteEnv, RouteSchema, BasePath, ConfigurableOptions> {\n repository: ReadableSearchRepository<TDataObject>;\n\n constructor(opts: {\n scope: string;\n path: string;\n isStrict?: boolean;\n repository: ReadableSearchRepository<TDataObject>;\n definitions: AnyType;\n }) {\n super({ scope: opts.scope, path: opts.path, isStrict: opts.isStrict });\n this.repository = opts.repository;\n this.definitions = opts.definitions;\n }\n\n /** POST /search - single-collection keyword/semantic/hybrid/raw search. Carries the list headers of every IGNIS list endpoint; the body keeps `{ found, isFoundExact, hits }` because `isFoundExact` has no place in a `{ count, data }` envelope, and it is the only carrier of \"found is an estimate\". */\n async search(opts: { context: TRouteContext<RouteEnv> }) {\n const { context } = opts;\n const input = context.req.valid<TSearchInput>('json');\n\n const rs = await this.measure({\n scope: 'search',\n args: input,\n task: async () => {\n // `isFoundExact` travels to the caller so an engine whose `found` is an estimate never looks exhaustive across the HTTP boundary.\n const { found, isFoundExact, hits } = await this.repository.search(input);\n return { found, isFoundExact, hits: hits ?? [] };\n },\n });\n\n const start = resolveSearchStart({ input, hitCount: rs.hits.length });\n this.setListHeaders({\n context,\n range: buildDataRange({ offset: start, dataLength: rs.hits.length, total: rs.found }),\n count: rs.hits.length,\n });\n\n return context.json(rs, HTTP.ResultCodes.RS_2.Ok);\n }\n\n /** POST /multi-search - cross-collection search, forwarded verbatim to the engine. */\n async multiSearch(opts: { context: TRouteContext<RouteEnv> }) {\n const { context } = opts;\n const input = context.req.valid<TMultiSearchInput>('json');\n\n const rs = await this.measure({\n scope: 'multiSearch',\n args: input,\n task: () => this.repository.multiSearch(input),\n });\n\n return context.json(rs, HTTP.ResultCodes.RS_2.Ok);\n }\n}\n"]}
1
+ {"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../src/search/core/controllers/abstract.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TEntityDataObject, TRouteContext } from '@venizia/ignis-kernel';\nimport { BaseRestController, buildDataRange } from '@venizia/ignis-kernel';\nimport type { AbstractEntity } from '@venizia/ignis-kernel';\nimport type { TAnyObjectSchema } from '@venizia/ignis-kernel';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport type { Env, Schema } from 'hono';\nimport type { TMultiSearchInput, TSearchInput } from '@/search/core/repositories/common';\nimport { SearchModes } from '@/search/core/repositories/common';\nimport type { ReadableSearchRepository } from '../repositories/core/readable';\nimport { applySearchScope } from './scope';\nimport type { TSearchScopeResolver } from './scope';\n\n/** Where the page starts, for `Content-Range`. Friendly modes carry `filter.skip` or `filter.offset`; raw mode carries the engine's own `offset`, or a 1-based `page` with `per_page`/`perPage`. A raw request that names a page but no page size is measured against this page's hit count, so only its last page can be off. */\nconst resolveSearchStart = (opts: { input: TSearchInput; hitCount: number }): number => {\n const { input, hitCount } = opts;\n\n if (input.mode !== SearchModes.RAW) {\n // Same precedence as buildDataRange: the repository filter carries skip or offset.\n return input.filter?.skip ?? input.filter?.offset ?? 0;\n }\n\n // Engine wire names are read through string keys only; `params` is an untyped passthrough.\n const params = input.params;\n const offset = params['offset'];\n if (typeof offset === 'number') {\n return offset;\n }\n\n const page = params['page'];\n if (typeof page !== 'number' || page < 1) {\n return 0;\n }\n\n const pageSize = params['per_page'] ?? params['perPage'];\n return (page - 1) * (typeof pageSize === 'number' ? pageSize : hitCount);\n};\n\n/** Base tier of a generated search controller: the repository handle plus the search / multi-search verbs; SearchControllerFactory returns a thin subclass that only builds route configs and wires them. */\nexport abstract class AbstractSearchController<\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> extends BaseRestController<RouteEnv, RouteSchema, BasePath, ConfigurableOptions> {\n repository: ReadableSearchRepository<TDataObject>;\n searchScope?: TSearchScopeResolver<RouteEnv>;\n\n constructor(opts: {\n scope: string;\n path: string;\n isStrict?: boolean;\n repository: ReadableSearchRepository<TDataObject>;\n definitions: AnyType;\n /** Per-request search scope; see {@link TSearchScopeResolver}. */\n searchScope?: TSearchScopeResolver<RouteEnv>;\n }) {\n super({ scope: opts.scope, path: opts.path, isStrict: opts.isStrict });\n this.repository = opts.repository;\n this.searchScope = opts.searchScope;\n this.definitions = opts.definitions;\n }\n\n /** POST /search - single-collection keyword/semantic/hybrid/raw search. Carries the list headers of every IGNIS list endpoint; the body keeps `{ found, isFoundExact, hits }` because `isFoundExact` has no place in a `{ count, data }` envelope, and it is the only carrier of \"found is an estimate\". */\n async search(opts: { context: TRouteContext<RouteEnv> }) {\n const { context } = opts;\n const body = context.req.valid<TSearchInput>('json');\n const input = this.searchScope\n ? await applySearchScope({ resolve: this.searchScope, context, input: body })\n : body;\n\n const rs = await this.measure({\n scope: 'search',\n args: input,\n task: async () => {\n // `isFoundExact` travels to the caller so an engine whose `found` is an estimate never looks exhaustive across the HTTP boundary.\n const { found, isFoundExact, hits } = await this.repository.search(input);\n return { found, isFoundExact, hits: hits ?? [] };\n },\n });\n\n const start = resolveSearchStart({ input, hitCount: rs.hits.length });\n this.setListHeaders({\n context,\n range: buildDataRange({ offset: start, dataLength: rs.hits.length, total: rs.found }),\n count: rs.hits.length,\n });\n\n return context.json(rs, HTTP.ResultCodes.RS_2.Ok);\n }\n\n /** POST /multi-search - cross-collection search, forwarded verbatim to the engine. */\n async multiSearch(opts: { context: TRouteContext<RouteEnv> }) {\n const { context } = opts;\n\n // A multi-search entry carries the engine's own `filterBy` string, which a `where` scope cannot\n // be ANDed into: a scoped controller does not serve it.\n if (this.searchScope) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: '[multiSearch] multi-search is not available on a scoped search controller',\n });\n }\n const input = context.req.valid<TMultiSearchInput>('json');\n\n const rs = await this.measure({\n scope: 'multiSearch',\n args: input,\n task: () => this.repository.multiSearch(input),\n });\n\n return context.json(rs, HTTP.ResultCodes.RS_2.Ok);\n }\n}\n"]}
@@ -7,6 +7,7 @@ import type { TClass, TResolver, ValueOrPromise } from '@venizia/ignis-helpers/c
7
7
  import { BaseHelper } from '@venizia/ignis-helpers/core';
8
8
  import type { Env, Schema } from 'hono';
9
9
  import type { ReadableSearchRepository } from '../repositories/core/readable.js';
10
+ import type { TSearchScopeResolver } from './scope.js';
10
11
  /** Per-route enable/disable switches for the generated search controller. */
11
12
  export interface ISearchCustomizableRoutes {
12
13
  search?: {
@@ -37,6 +38,18 @@ export interface ISearchControllerOptions<TEntity extends AbstractEntity<TAnyObj
37
38
  authorize?: IAuthorizationSpec | IAuthorizationSpec[];
38
39
  /** Per-route enable/disable configuration. */
39
40
  routes?: ISearchCustomizableRoutes;
41
+ /**
42
+ * A function of the request context returning the filter this caller may search within. It is
43
+ * ANDed into `input.filter.where` on the server: the client's own `where` can narrow it, never
44
+ * widen or remove it. Fails closed - a scope that is null, undefined or throws refuses the
45
+ * request with 403. Return `ScopeFilters.UNRESTRICTED` to apply none for a trusted caller.
46
+ *
47
+ * `raw` mode and `engineParams` hand the engine its own wire parameters, and a multi-search entry
48
+ * carries a raw `filterBy`; none can take a scope, so a scoped controller refuses `raw` and
49
+ * `engineParams` (400) and must disable the multi-search route (`routes.multiSearch.enabled:
50
+ * false`), which `defineSearchController` requires.
51
+ */
52
+ scope?: TSearchScopeResolver;
40
53
  }
41
54
  /** Factory for generating turnkey search controllers (single-collection + cross-collection) from entity definitions. */
42
55
  export declare class SearchControllerFactory extends BaseHelper {
@@ -47,6 +60,7 @@ export declare class SearchControllerFactory extends BaseHelper {
47
60
  /** Registers the search + multiSearch route handlers, honoring per-route enable flags. */
48
61
  binding(): ValueOrPromise<void>;
49
62
  repository: ReadableSearchRepository<TDataObject, import("../index.js").AbstractSearchDataSource<{}>>;
63
+ searchScope?: TSearchScopeResolver<RouteEnv> | undefined;
50
64
  search(opts: {
51
65
  context: import("@venizia/ignis-kernel").TRouteContext<RouteEnv>;
52
66
  }): Promise<import("@venizia/ignis-kernel").TJsonResponse<unknown, 200>>;
@@ -1 +1 @@
1
- {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../src/search/core/controllers/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AAEnE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAI9E,6EAA6E;AAC7E,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/B,WAAW,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACrC;AAED,iHAAiH;AACjH,MAAM,WAAW,wBAAwB,CACvC,OAAO,SAAS,cAAc,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC,gBAAgB,CAAC;IAEnF,qIAAqI;IACrI,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAErD,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAEF,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;IAEF,8DAA8D;IAC9D,YAAY,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC;IAElE,6DAA6D;IAC7D,SAAS,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAAC;IAEtD,8CAA8C;IAC9C,MAAM,CAAC,EAAE,yBAAyB,CAAC;CACpC;AAED,wHAAwH;AACxH,qBAAa,uBAAwB,SAAQ,UAAU;;IAKrD,wLAAwL;IACxL,MAAM,CAAC,sBAAsB,CAC3B,OAAO,SAAS,cAAc,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC,gBAAgB,CAAC,EACnF,QAAQ,SAAS,GAAG,GAAG,GAAG,EAC1B,WAAW,SAAS,MAAM,GAAG,EAAE,EAC/B,QAAQ,SAAS,MAAM,GAAG,GAAG,EAC7B,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,WAAW,SAAS,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,EACvD,OAAO,EAAE,wBAAwB,CAAC,OAAO,CAAC;yBAwBhB,wBAAwB,CAAC,WAAW,CAAC;YAU7D,0FAA0F;uBACtE,cAAc,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAxEiE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsG/G"}
1
+ {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../src/search/core/controllers/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AAEnE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAE9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAGpD,6EAA6E;AAC7E,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/B,WAAW,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACrC;AAED,iHAAiH;AACjH,MAAM,WAAW,wBAAwB,CACvC,OAAO,SAAS,cAAc,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC,gBAAgB,CAAC;IAEnF,qIAAqI;IACrI,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAErD,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAEF,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;IAEF,8DAA8D;IAC9D,YAAY,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC;IAElE,6DAA6D;IAC7D,SAAS,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAAC;IAEtD,8CAA8C;IAC9C,MAAM,CAAC,EAAE,yBAAyB,CAAC;IAEnC;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAC9B;AAED,wHAAwH;AACxH,qBAAa,uBAAwB,SAAQ,UAAU;;IAKrD,wLAAwL;IACxL,MAAM,CAAC,sBAAsB,CAC3B,OAAO,SAAS,cAAc,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC,gBAAgB,CAAC,EACnF,QAAQ,SAAS,GAAG,GAAG,GAAG,EAC1B,WAAW,SAAS,MAAM,GAAG,EAAE,EAC/B,QAAQ,SAAS,MAAM,GAAG,GAAG,EAC7B,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,WAAW,SAAS,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,EACvD,OAAO,EAAE,wBAAwB,CAAC,OAAO,CAAC;yBA8BhB,wBAAwB,CAAC,WAAW,CAAC;YAW7D,0FAA0F;uBACtE,cAAc,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA5FY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0H1D"}
@@ -10,13 +10,18 @@ export class SearchControllerFactory extends BaseHelper {
10
10
  }
11
11
  /** Creates a search controller with two endpoints: `POST {basePath}/search` via `repository.search()`, and `POST {basePath}/multi-search` via `repository.dataSource.multiSearch()`. */
12
12
  static defineSearchController(defOpts) {
13
- const { controller, entity, authenticate, authorize, routes } = defOpts;
13
+ const { controller, entity, authenticate, authorize, routes, scope } = defOpts;
14
14
  const { name, basePath = 'unknown_path', isStrict = true } = controller;
15
15
  if (!basePath || basePath === 'unknown_path') {
16
16
  throw getError({
17
17
  message: `[defineSearchController] Invalid controller basePath | name: ${name} | basePath: ${basePath}`,
18
18
  });
19
19
  }
20
+ if (scope && routes?.multiSearch?.enabled !== false) {
21
+ throw getError({
22
+ message: `[defineSearchController] A scoped search controller cannot serve multi-search | name: ${name} | set routes.multiSearch.enabled to false`,
23
+ });
24
+ }
20
25
  const entityClass = isClass(entity) ? entity : entity();
21
26
  const entityInstance = new entityClass();
22
27
  const selectSchema = entityInstance.getSchema({ type: SchemaTypes.SELECT });
@@ -29,6 +34,7 @@ export class SearchControllerFactory extends BaseHelper {
29
34
  isStrict,
30
35
  repository,
31
36
  definitions: routeDefinitions,
37
+ searchScope: scope,
32
38
  });
33
39
  }
34
40
  /** Registers the search + multiSearch route handlers, honoring per-route enable flags. */
@@ -1 +1 @@
1
- {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../src/search/core/controllers/factory.ts"],"names":[],"mappings":"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","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":"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","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 type { TSearchScopeResolver } from './scope';\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 * A function of the request context returning the filter this caller may search within. It is\n * ANDed into `input.filter.where` on the server: the client's own `where` can narrow it, never\n * widen or remove it. Fails closed - a scope that is null, undefined or throws refuses the\n * request with 403. Return `ScopeFilters.UNRESTRICTED` to apply none for a trusted caller.\n *\n * `raw` mode and `engineParams` hand the engine its own wire parameters, and a multi-search entry\n * carries a raw `filterBy`; none can take a scope, so a scoped controller refuses `raw` and\n * `engineParams` (400) and must disable the multi-search route (`routes.multiSearch.enabled:\n * false`), which `defineSearchController` requires.\n */\n scope?: TSearchScopeResolver;\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, scope } = 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 if (scope && routes?.multiSearch?.enabled !== false) {\n throw getError({\n message: `[defineSearchController] A scoped search controller cannot serve multi-search | name: ${name} | set routes.multiSearch.enabled to false`,\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 searchScope: scope as TSearchScopeResolver<RouteEnv> | undefined,\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"]}