@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
@@ -45,11 +45,11 @@ class RecursiveTreeSql {
45
45
  }
46
46
  }
47
47
  static walk(opts) {
48
- const { name, table, rootId, direction, maxDepth, idColumn = 'id', parentColumn = 'parent_id', columns = [], recursiveFilter, trackPath = false, startDepth = 0, } = opts;
48
+ const { name, table, rootId, direction, maxDepth, idColumn = 'id', parentColumn = 'parent_id', columns = [], anchorFilter, recursiveFilter, trackPath = false, startDepth = 0, } = opts;
49
49
  RecursiveTreeSql.assertValidIdentifier({ field: 'name', value: name });
50
50
  RecursiveTreeSql.assertValidIdentifier({ field: 'idColumn', value: idColumn });
51
51
  RecursiveTreeSql.assertValidIdentifier({ field: 'parentColumn', value: parentColumn });
52
- columns.forEach(column => RecursiveTreeSql.assertValidIdentifier({ field: 'columns', value: column }));
52
+ columns.forEach((column) => RecursiveTreeSql.assertValidIdentifier({ field: 'columns', value: column }));
53
53
  if (!RecursiveTreeDirections.isValid(direction)) {
54
54
  throw (0, core_1.getError)({
55
55
  message: `[RecursiveTreeSql.walk] Invalid 'direction' | Expected ${RecursiveTreeDirections.UP} or ${RecursiveTreeDirections.DOWN} | Got: ${direction}`,
@@ -68,18 +68,29 @@ class RecursiveTreeSql {
68
68
  const engine = RecursiveTreeSql.detectEngine(table);
69
69
  const tableName = (0, drizzle_orm_1.getTableName)(table);
70
70
  RecursiveTreeSql.assertValidIdentifier({ field: 'table', value: tableName });
71
- const tableIdentifier = drizzle_orm_1.sql.identifier(tableName);
71
+ // A Postgres table declared with `pgSchema('commerce').table(...)` lives outside the search path,
72
+ // so the unqualified name would read the wrong relation or none. SQLite has no schemas.
73
+ const schemaName = engine === RecursiveTreeEngines.POSTGRES
74
+ ? (0, pg_core_1.getTableConfig)(table).schema
75
+ : undefined;
76
+ if (schemaName !== undefined) {
77
+ RecursiveTreeSql.assertValidIdentifier({ field: 'schema', value: schemaName });
78
+ }
79
+ const tableIdentifier = schemaName === undefined
80
+ ? drizzle_orm_1.sql.identifier(tableName)
81
+ : (0, drizzle_orm_1.sql) `${drizzle_orm_1.sql.identifier(schemaName)}.${drizzle_orm_1.sql.identifier(tableName)}`;
72
82
  const cteIdentifier = drizzle_orm_1.sql.identifier(name);
73
83
  const idIdentifier = drizzle_orm_1.sql.identifier(idColumn);
74
84
  const parentIdentifier = drizzle_orm_1.sql.identifier(parentColumn);
75
- const extraIdentifiers = columns.map(column => drizzle_orm_1.sql.identifier(column));
85
+ const extraIdentifiers = columns.map((column) => drizzle_orm_1.sql.identifier(column));
76
86
  const baseColumnList = drizzle_orm_1.sql.join([idIdentifier, parentIdentifier, ...extraIdentifiers], (0, drizzle_orm_1.sql) `, `);
77
- const recursiveColumnList = drizzle_orm_1.sql.join([idIdentifier, parentIdentifier, ...extraIdentifiers].map(identifier => (0, drizzle_orm_1.sql) `t.${identifier}`), (0, drizzle_orm_1.sql) `, `);
87
+ const recursiveColumnList = drizzle_orm_1.sql.join([idIdentifier, parentIdentifier, ...extraIdentifiers].map((identifier) => (0, drizzle_orm_1.sql) `t.${identifier}`), (0, drizzle_orm_1.sql) `, `);
78
88
  const depthCast = RecursiveTreeSql.compileDepthCast({ engine, depth: startDepth });
79
89
  const { basePathColumns, recursivePathColumns } = trackPath
80
90
  ? RecursiveTreeSql.compileCycleGuardFragments({ engine, idIdentifier })
81
91
  : { basePathColumns: (0, drizzle_orm_1.sql) ``, recursivePathColumns: (0, drizzle_orm_1.sql) `` };
82
- const baseCase = (0, drizzle_orm_1.sql) `SELECT ${baseColumnList}, ${depthCast} AS depth${basePathColumns} FROM ${tableIdentifier} WHERE ${idIdentifier} = ${rootId}`;
92
+ const anchorExtraFilter = anchorFilter ? (0, drizzle_orm_1.sql) ` AND (${anchorFilter})` : (0, drizzle_orm_1.sql) ``;
93
+ const baseCase = (0, drizzle_orm_1.sql) `SELECT ${baseColumnList}, ${depthCast} AS depth${basePathColumns} FROM ${tableIdentifier} WHERE ${idIdentifier} = ${rootId}${anchorExtraFilter}`;
83
94
  // DOWN walks parent -> children (t.parentColumn = r.idColumn); UP walks child -> parent (t.idColumn = r.parentColumn).
84
95
  const joinCondition = direction === RecursiveTreeDirections.DOWN
85
96
  ? (0, drizzle_orm_1.sql) `t.${parentIdentifier} = r.${idIdentifier}`
@@ -1 +1 @@
1
- {"version":3,"file":"recursive-tree.js","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/sqls/recursive-tree.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TConstValue } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { Name, SQL } from 'drizzle-orm';\nimport { getTableName, is, sql, Table } from 'drizzle-orm';\nimport { PgTable } from 'drizzle-orm/pg-core';\nimport { SQLiteTable } from 'drizzle-orm/sqlite-core';\n\n/** Walk direction relative to `rootId`: DOWN follows `parentColumn -> idColumn` (descendants), UP follows the reverse (ancestors). */\nexport class RecursiveTreeDirections {\n static readonly UP = 'UP';\n static readonly DOWN = 'DOWN';\n static readonly SCHEME_SET = new Set([this.UP, this.DOWN]);\n\n static isValid(direction: string): boolean {\n return this.SCHEME_SET.has(direction);\n }\n}\n\nexport type TRecursiveTreeDirection = TConstValue<typeof RecursiveTreeDirections>;\n\n/** Internal only - not part of {@link IRecursiveTreeOptions}. Derived from `table`, never accepted as an option. */\nclass RecursiveTreeEngines {\n static readonly POSTGRES = 'POSTGRES';\n static readonly SQLITE = 'SQLITE';\n static readonly SCHEME_SET = new Set([this.POSTGRES, this.SQLITE]);\n}\n\ntype TRecursiveTreeEngine = TConstValue<typeof RecursiveTreeEngines>;\n\n/** A SQL identifier is safe to splice only after it matches this allowlist - see {@link RecursiveTreeSql.assertValidIdentifier}. */\nconst IDENTIFIER_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/**\n * ASCII Unit Separator (0x1F) - chosen because it does not occur in real ids, unlike `/` or `,`.\n * See {@link RecursiveTreeSql} for the exactness limitation this relies on.\n */\nconst SQLITE_PATH_DELIMITER = sql.raw('char(31)');\n\nexport interface IRecursiveTreeOptions {\n /** CTE name the caller references in the SELECT it writes around this fragment. */\n name: string;\n\n /** Runtime-checked with `is(table, Table)`; also the sole dialect selector (Postgres vs SQLite) - see {@link RecursiveTreeSql}. */\n table: unknown;\n rootId: string;\n direction: TRecursiveTreeDirection;\n\n /**\n * Counts EDGES, not rows: the root is at depth 0, so `N` returns up to `N+1` rows.\n * No default - `0` type-checks but silently produces an empty result, so `walk` throws at\n * runtime for `maxDepth <= 0`.\n */\n maxDepth: number;\n idColumn?: string;\n parentColumn?: string;\n\n /** Extra columns, beyond `idColumn`/`parentColumn`, carried into every row of the walk. */\n columns?: string[];\n\n /** ANDed into the recursive term's WHERE clause - build it with Drizzle's own `sql` tag. */\n recursiveFilter?: SQL;\n\n /**\n * Emits `path`/`is_cycle` and stops expanding once a row re-visits an id in its own path. Row\n * shape differs per engine and nothing in this signature shows it: Postgres returns a real array\n * and boolean; SQLite returns delimited text and `1`/`0` - so `row.path.length` throws on SQLite\n * and `row.is_cycle === true` is always false there.\n */\n trackPath?: boolean;\n startDepth?: number;\n}\n\n/**\n * Returns the CTE definition only - the caller writes its own `SELECT ... FROM <name>` around it.\n * Engine is read off `table`, never asked of the caller, so no option can disagree with the schema.\n * SQLite's `path` is `char(31)`-delimited text, not an array: exact unless an id contains that byte,\n * which this class does not reject. Identifiers cannot be parameterized, so `name`/`idColumn`/\n * `parentColumn`/`columns` are allowlist-checked before reaching a template.\n */\nexport class RecursiveTreeSql {\n private static assertValidIdentifier(opts: { field: string; value: string }): void {\n const { field, value } = opts;\n\n if (!IDENTIFIER_PATTERN.test(value)) {\n throw getError({\n message: `[RecursiveTreeSql.walk] Invalid '${field}' | Expected letters, digits and underscores only, not starting with a digit | Got: ${value}`,\n });\n }\n }\n\n static walk(opts: IRecursiveTreeOptions): SQL {\n const {\n name,\n table,\n rootId,\n direction,\n maxDepth,\n idColumn = 'id',\n parentColumn = 'parent_id',\n columns = [],\n recursiveFilter,\n trackPath = false,\n startDepth = 0,\n } = opts;\n\n RecursiveTreeSql.assertValidIdentifier({ field: 'name', value: name });\n RecursiveTreeSql.assertValidIdentifier({ field: 'idColumn', value: idColumn });\n RecursiveTreeSql.assertValidIdentifier({ field: 'parentColumn', value: parentColumn });\n columns.forEach(column =>\n RecursiveTreeSql.assertValidIdentifier({ field: 'columns', value: column }),\n );\n\n if (!RecursiveTreeDirections.isValid(direction)) {\n throw getError({\n message: `[RecursiveTreeSql.walk] Invalid 'direction' | Expected ${RecursiveTreeDirections.UP} or ${RecursiveTreeDirections.DOWN} | Got: ${direction}`,\n });\n }\n\n if (!Number.isInteger(maxDepth) || maxDepth <= 0) {\n throw getError({\n message: `[RecursiveTreeSql.walk] Invalid 'maxDepth' | Expected a positive integer | Got: ${maxDepth}`,\n });\n }\n\n if (!is(table, Table)) {\n throw getError({\n message: `[RecursiveTreeSql.walk] Invalid 'table' | Expected a Drizzle table | Got: ${typeof table}`,\n });\n }\n\n const engine = RecursiveTreeSql.detectEngine(table);\n\n const tableName = getTableName(table);\n RecursiveTreeSql.assertValidIdentifier({ field: 'table', value: tableName });\n\n const tableIdentifier = sql.identifier(tableName);\n const cteIdentifier = sql.identifier(name);\n const idIdentifier = sql.identifier(idColumn);\n const parentIdentifier = sql.identifier(parentColumn);\n const extraIdentifiers = columns.map(column => sql.identifier(column));\n\n const baseColumnList = sql.join([idIdentifier, parentIdentifier, ...extraIdentifiers], sql`, `);\n const recursiveColumnList = sql.join(\n [idIdentifier, parentIdentifier, ...extraIdentifiers].map(identifier => sql`t.${identifier}`),\n sql`, `,\n );\n\n const depthCast = RecursiveTreeSql.compileDepthCast({ engine, depth: startDepth });\n const { basePathColumns, recursivePathColumns } = trackPath\n ? RecursiveTreeSql.compileCycleGuardFragments({ engine, idIdentifier })\n : { basePathColumns: sql``, recursivePathColumns: sql`` };\n\n const baseCase = sql`SELECT ${baseColumnList}, ${depthCast} AS depth${basePathColumns} FROM ${tableIdentifier} WHERE ${idIdentifier} = ${rootId}`;\n\n // DOWN walks parent -> children (t.parentColumn = r.idColumn); UP walks child -> parent (t.idColumn = r.parentColumn).\n const joinCondition =\n direction === RecursiveTreeDirections.DOWN\n ? sql`t.${parentIdentifier} = r.${idIdentifier}`\n : sql`t.${idIdentifier} = r.${parentIdentifier}`;\n\n // `NOT r.is_cycle` stops expanding a row already flagged cyclic - the row itself stays in the\n // result set with is_cycle = true, only its own children are cut off.\n const cycleGuard = trackPath ? sql` AND NOT r.is_cycle` : sql``;\n const extraFilter = recursiveFilter ? sql` AND (${recursiveFilter})` : sql``;\n\n const recursiveCase = sql`SELECT ${recursiveColumnList}, r.depth + 1${recursivePathColumns} FROM ${tableIdentifier} t JOIN ${cteIdentifier} r ON ${joinCondition} WHERE r.depth + 1 <= ${maxDepth}${cycleGuard}${extraFilter}`;\n\n return sql`WITH RECURSIVE ${cteIdentifier} AS (${baseCase} UNION ALL ${recursiveCase})`;\n }\n\n /** See {@link RecursiveTreeSql} for why there is no separate `engine` option. */\n private static detectEngine(table: Table): TRecursiveTreeEngine {\n if (is(table, PgTable)) {\n return RecursiveTreeEngines.POSTGRES;\n }\n\n if (is(table, SQLiteTable)) {\n return RecursiveTreeEngines.SQLITE;\n }\n\n throw getError({\n message: `[RecursiveTreeSql.walk] Invalid 'table' | Expected a Postgres or SQLite Drizzle table | Got: ${getTableName(table)}`,\n });\n }\n\n /** Postgres needs an explicit cast so the base and recursive terms agree on the `depth` column's type; SQLite's looser typing does not, but casts anyway for parity and to fail loudly on a non-numeric `startDepth`. */\n private static compileDepthCast(opts: { engine: TRecursiveTreeEngine; depth: number }): SQL {\n const { engine, depth } = opts;\n\n switch (engine) {\n case RecursiveTreeEngines.POSTGRES: {\n return sql`${depth}::int`;\n }\n case RecursiveTreeEngines.SQLITE: {\n return sql`CAST(${depth} AS INTEGER)`;\n }\n default: {\n throw getError({\n message: `[RecursiveTreeSql.walk] Invalid 'engine' | Got: ${engine}`,\n });\n }\n }\n }\n\n /** See {@link RecursiveTreeSql} for why Postgres and SQLite need different `path`/`is_cycle` shapes. */\n private static compileCycleGuardFragments(opts: {\n engine: TRecursiveTreeEngine;\n idIdentifier: Name;\n }): { basePathColumns: SQL; recursivePathColumns: SQL } {\n const { engine, idIdentifier } = opts;\n\n switch (engine) {\n case RecursiveTreeEngines.POSTGRES: {\n return {\n basePathColumns: sql`, ARRAY[${idIdentifier}] AS path, false AS is_cycle`,\n recursivePathColumns: sql`, r.path || t.${idIdentifier} AS path, t.${idIdentifier} = ANY(r.path) AS is_cycle`,\n };\n }\n case RecursiveTreeEngines.SQLITE: {\n return {\n basePathColumns: sql`, ${SQLITE_PATH_DELIMITER} || ${idIdentifier} || ${SQLITE_PATH_DELIMITER} AS path, 0 AS is_cycle`,\n recursivePathColumns: sql`, r.path || t.${idIdentifier} || ${SQLITE_PATH_DELIMITER} AS path, instr(r.path, ${SQLITE_PATH_DELIMITER} || t.${idIdentifier} || ${SQLITE_PATH_DELIMITER}) > 0 AS is_cycle`,\n };\n }\n default: {\n throw getError({\n message: `[RecursiveTreeSql.walk] Invalid 'engine' | Got: ${engine}`,\n });\n }\n }\n }\n}\n"]}
1
+ {"version":3,"file":"recursive-tree.js","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/sqls/recursive-tree.ts"],"names":[],"mappings":";;;AACA,sDAAuD;AAEvD,6CAA2D;AAC3D,iDAA8D;AAC9D,yDAAsD;AAEtD,sIAAsI;AACtI,MAAa,uBAAuB;aAClB,OAAE,GAAG,IAAI,CAAC;aACV,SAAI,GAAG,MAAM,CAAC;aACd,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAE3D,MAAM,CAAC,OAAO,CAAC,SAAiB;QAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;;AAPH,0DAQC;AAID,oHAAoH;AACpH,MAAM,oBAAoB;aACR,aAAQ,GAAG,UAAU,CAAC;aACtB,WAAM,GAAG,QAAQ,CAAC;aAClB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;;AAKrE,oIAAoI;AACpI,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAEtD;;;GAGG;AACH,MAAM,qBAAqB,GAAG,iBAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AA8ClD;;;;;;GAMG;AACH,MAAa,gBAAgB;IACnB,MAAM,CAAC,qBAAqB,CAAC,IAAsC;QACzE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAE9B,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,oCAAoC,KAAK,uFAAuF,KAAK,EAAE;aACjJ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAA2B;QACrC,MAAM,EACJ,IAAI,EACJ,KAAK,EACL,MAAM,EACN,SAAS,EACT,QAAQ,EACR,QAAQ,GAAG,IAAI,EACf,YAAY,GAAG,WAAW,EAC1B,OAAO,GAAG,EAAE,EACZ,YAAY,EACZ,eAAe,EACf,SAAS,GAAG,KAAK,EACjB,UAAU,GAAG,CAAC,GACf,GAAG,IAAI,CAAC;QAET,gBAAgB,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,gBAAgB,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/E,gBAAgB,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;QACvF,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CACzB,gBAAgB,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAC5E,CAAC;QAEF,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAChD,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,0DAA0D,uBAAuB,CAAC,EAAE,OAAO,uBAAuB,CAAC,IAAI,WAAW,SAAS,EAAE;aACvJ,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YACjD,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,mFAAmF,QAAQ,EAAE;aACvG,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,IAAA,gBAAE,EAAC,KAAK,EAAE,mBAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,6EAA6E,OAAO,KAAK,EAAE;aACrG,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAEpD,MAAM,SAAS,GAAG,IAAA,0BAAY,EAAC,KAAK,CAAC,CAAC;QACtC,gBAAgB,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAE7E,kGAAkG;QAClG,wFAAwF;QACxF,MAAM,UAAU,GACd,MAAM,KAAK,oBAAoB,CAAC,QAAQ;YACtC,CAAC,CAAC,IAAA,wBAAc,EAAC,KAAgB,CAAC,CAAC,MAAM;YACzC,CAAC,CAAC,SAAS,CAAC;QAEhB,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,gBAAgB,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACjF,CAAC;QAED,MAAM,eAAe,GACnB,UAAU,KAAK,SAAS;YACtB,CAAC,CAAC,iBAAG,CAAC,UAAU,CAAC,SAAS,CAAC;YAC3B,CAAC,CAAC,IAAA,iBAAG,EAAA,GAAG,iBAAG,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,iBAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACtE,MAAM,aAAa,GAAG,iBAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,iBAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,gBAAgB,GAAG,iBAAG,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QACtD,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,iBAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAEzE,MAAM,cAAc,GAAG,iBAAG,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,CAAC,EAAE,IAAA,iBAAG,EAAA,IAAI,CAAC,CAAC;QAChG,MAAM,mBAAmB,GAAG,iBAAG,CAAC,IAAI,CAClC,CAAC,YAAY,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,CAAC,CAAC,GAAG,CACvD,CAAC,UAAU,EAAE,EAAE,CAAC,IAAA,iBAAG,EAAA,KAAK,UAAU,EAAE,CACrC,EACD,IAAA,iBAAG,EAAA,IAAI,CACR,CAAC;QAEF,MAAM,SAAS,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACnF,MAAM,EAAE,eAAe,EAAE,oBAAoB,EAAE,GAAG,SAAS;YACzD,CAAC,CAAC,gBAAgB,CAAC,0BAA0B,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;YACvE,CAAC,CAAC,EAAE,eAAe,EAAE,IAAA,iBAAG,EAAA,EAAE,EAAE,oBAAoB,EAAE,IAAA,iBAAG,EAAA,EAAE,EAAE,CAAC;QAE5D,MAAM,iBAAiB,GAAG,YAAY,CAAC,CAAC,CAAC,IAAA,iBAAG,EAAA,SAAS,YAAY,GAAG,CAAC,CAAC,CAAC,IAAA,iBAAG,EAAA,EAAE,CAAC;QAC7E,MAAM,QAAQ,GAAG,IAAA,iBAAG,EAAA,UAAU,cAAc,KAAK,SAAS,YAAY,eAAe,SAAS,eAAe,UAAU,YAAY,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;QAEtK,uHAAuH;QACvH,MAAM,aAAa,GACjB,SAAS,KAAK,uBAAuB,CAAC,IAAI;YACxC,CAAC,CAAC,IAAA,iBAAG,EAAA,KAAK,gBAAgB,QAAQ,YAAY,EAAE;YAChD,CAAC,CAAC,IAAA,iBAAG,EAAA,KAAK,YAAY,QAAQ,gBAAgB,EAAE,CAAC;QAErD,8FAA8F;QAC9F,sEAAsE;QACtE,MAAM,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,IAAA,iBAAG,EAAA,qBAAqB,CAAC,CAAC,CAAC,IAAA,iBAAG,EAAA,EAAE,CAAC;QAChE,MAAM,WAAW,GAAG,eAAe,CAAC,CAAC,CAAC,IAAA,iBAAG,EAAA,SAAS,eAAe,GAAG,CAAC,CAAC,CAAC,IAAA,iBAAG,EAAA,EAAE,CAAC;QAE7E,MAAM,aAAa,GAAG,IAAA,iBAAG,EAAA,UAAU,mBAAmB,gBAAgB,oBAAoB,SAAS,eAAe,WAAW,aAAa,SAAS,aAAa,yBAAyB,QAAQ,GAAG,UAAU,GAAG,WAAW,EAAE,CAAC;QAE/N,OAAO,IAAA,iBAAG,EAAA,kBAAkB,aAAa,QAAQ,QAAQ,cAAc,aAAa,GAAG,CAAC;IAC1F,CAAC;IAED,iFAAiF;IACzE,MAAM,CAAC,YAAY,CAAC,KAAY;QACtC,IAAI,IAAA,gBAAE,EAAC,KAAK,EAAE,iBAAO,CAAC,EAAE,CAAC;YACvB,OAAO,oBAAoB,CAAC,QAAQ,CAAC;QACvC,CAAC;QAED,IAAI,IAAA,gBAAE,EAAC,KAAK,EAAE,yBAAW,CAAC,EAAE,CAAC;YAC3B,OAAO,oBAAoB,CAAC,MAAM,CAAC;QACrC,CAAC;QAED,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE,gGAAgG,IAAA,0BAAY,EAAC,KAAK,CAAC,EAAE;SAC/H,CAAC,CAAC;IACL,CAAC;IAED,yNAAyN;IACjN,MAAM,CAAC,gBAAgB,CAAC,IAAqD;QACnF,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAE/B,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACnC,OAAO,IAAA,iBAAG,EAAA,GAAG,KAAK,OAAO,CAAC;YAC5B,CAAC;YACD,KAAK,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;gBACjC,OAAO,IAAA,iBAAG,EAAA,QAAQ,KAAK,cAAc,CAAC;YACxC,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,IAAA,eAAQ,EAAC;oBACb,OAAO,EAAE,mDAAmD,MAAM,EAAE;iBACrE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,wGAAwG;IAChG,MAAM,CAAC,0BAA0B,CAAC,IAGzC;QACC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;QAEtC,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACnC,OAAO;oBACL,eAAe,EAAE,IAAA,iBAAG,EAAA,WAAW,YAAY,8BAA8B;oBACzE,oBAAoB,EAAE,IAAA,iBAAG,EAAA,iBAAiB,YAAY,eAAe,YAAY,4BAA4B;iBAC9G,CAAC;YACJ,CAAC;YACD,KAAK,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;gBACjC,OAAO;oBACL,eAAe,EAAE,IAAA,iBAAG,EAAA,KAAK,qBAAqB,OAAO,YAAY,OAAO,qBAAqB,yBAAyB;oBACtH,oBAAoB,EAAE,IAAA,iBAAG,EAAA,iBAAiB,YAAY,OAAO,qBAAqB,2BAA2B,qBAAqB,SAAS,YAAY,OAAO,qBAAqB,mBAAmB;iBACvM,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,IAAA,eAAQ,EAAC;oBACb,OAAO,EAAE,mDAAmD,MAAM,EAAE;iBACrE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF;AA1KD,4CA0KC","sourcesContent":["import type { TConstValue } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { Name, SQL } from 'drizzle-orm';\nimport { getTableName, is, sql, Table } from 'drizzle-orm';\nimport { getTableConfig, PgTable } from 'drizzle-orm/pg-core';\nimport { SQLiteTable } from 'drizzle-orm/sqlite-core';\n\n/** Walk direction relative to `rootId`: DOWN follows `parentColumn -> idColumn` (descendants), UP follows the reverse (ancestors). */\nexport class RecursiveTreeDirections {\n static readonly UP = 'UP';\n static readonly DOWN = 'DOWN';\n static readonly SCHEME_SET = new Set([this.UP, this.DOWN]);\n\n static isValid(direction: string): boolean {\n return this.SCHEME_SET.has(direction);\n }\n}\n\nexport type TRecursiveTreeDirection = TConstValue<typeof RecursiveTreeDirections>;\n\n/** Internal only - not part of {@link IRecursiveTreeOptions}. Derived from `table`, never accepted as an option. */\nclass RecursiveTreeEngines {\n static readonly POSTGRES = 'POSTGRES';\n static readonly SQLITE = 'SQLITE';\n static readonly SCHEME_SET = new Set([this.POSTGRES, this.SQLITE]);\n}\n\ntype TRecursiveTreeEngine = TConstValue<typeof RecursiveTreeEngines>;\n\n/** A SQL identifier is safe to splice only after it matches this allowlist - see {@link RecursiveTreeSql.assertValidIdentifier}. */\nconst IDENTIFIER_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/**\n * ASCII Unit Separator (0x1F) - chosen because it does not occur in real ids, unlike `/` or `,`.\n * See {@link RecursiveTreeSql} for the exactness limitation this relies on.\n */\nconst SQLITE_PATH_DELIMITER = sql.raw('char(31)');\n\nexport interface IRecursiveTreeOptions {\n /** CTE name the caller references in the SELECT it writes around this fragment. */\n name: string;\n\n /** Runtime-checked with `is(table, Table)`; also the sole dialect selector (Postgres vs SQLite) - see {@link RecursiveTreeSql}. */\n table: unknown;\n rootId: string;\n direction: TRecursiveTreeDirection;\n\n /**\n * Counts EDGES, not rows: the root is at depth 0, so `N` returns up to `N+1` rows.\n * No default - `0` type-checks but silently produces an empty result, so `walk` throws at\n * runtime for `maxDepth <= 0`.\n */\n maxDepth: number;\n idColumn?: string;\n parentColumn?: string;\n\n /** Extra columns, beyond `idColumn`/`parentColumn`, carried into every row of the walk. */\n columns?: string[];\n\n /**\n * ANDed into the anchor term's WHERE clause, next to the `idColumn = rootId` match - build it with\n * Drizzle's own `sql` tag, columns unqualified. Together with {@link recursiveFilter} it keeps a\n * row out of the walk at both ends, e.g. `sql\\`deleted_at IS NULL\\`` on each term.\n *\n * `walk` takes a table, not a model, so it never applies a model's soft delete or `access` scope by\n * itself: both terms are filtered only by what the caller passes here and in `recursiveFilter`.\n */\n anchorFilter?: SQL;\n\n /** ANDed into the recursive term's WHERE clause - build it with Drizzle's own `sql` tag. */\n recursiveFilter?: SQL;\n\n /**\n * Emits `path`/`is_cycle` and stops expanding once a row re-visits an id in its own path. Row\n * shape differs per engine and nothing in this signature shows it: Postgres returns a real array\n * and boolean; SQLite returns delimited text and `1`/`0` - so `row.path.length` throws on SQLite\n * and `row.is_cycle === true` is always false there.\n */\n trackPath?: boolean;\n startDepth?: number;\n}\n\n/**\n * Returns the CTE definition only - the caller writes its own `SELECT ... FROM <name>` around it.\n * Engine is read off `table`, never asked of the caller, so no option can disagree with the schema.\n * SQLite's `path` is `char(31)`-delimited text, not an array: exact unless an id contains that byte,\n * which this class does not reject. Identifiers cannot be parameterized, so `name`/`idColumn`/\n * `parentColumn`/`columns` are allowlist-checked before reaching a template.\n */\nexport class RecursiveTreeSql {\n private static assertValidIdentifier(opts: { field: string; value: string }): void {\n const { field, value } = opts;\n\n if (!IDENTIFIER_PATTERN.test(value)) {\n throw getError({\n message: `[RecursiveTreeSql.walk] Invalid '${field}' | Expected letters, digits and underscores only, not starting with a digit | Got: ${value}`,\n });\n }\n }\n\n static walk(opts: IRecursiveTreeOptions): SQL {\n const {\n name,\n table,\n rootId,\n direction,\n maxDepth,\n idColumn = 'id',\n parentColumn = 'parent_id',\n columns = [],\n anchorFilter,\n recursiveFilter,\n trackPath = false,\n startDepth = 0,\n } = opts;\n\n RecursiveTreeSql.assertValidIdentifier({ field: 'name', value: name });\n RecursiveTreeSql.assertValidIdentifier({ field: 'idColumn', value: idColumn });\n RecursiveTreeSql.assertValidIdentifier({ field: 'parentColumn', value: parentColumn });\n columns.forEach((column) =>\n RecursiveTreeSql.assertValidIdentifier({ field: 'columns', value: column }),\n );\n\n if (!RecursiveTreeDirections.isValid(direction)) {\n throw getError({\n message: `[RecursiveTreeSql.walk] Invalid 'direction' | Expected ${RecursiveTreeDirections.UP} or ${RecursiveTreeDirections.DOWN} | Got: ${direction}`,\n });\n }\n\n if (!Number.isInteger(maxDepth) || maxDepth <= 0) {\n throw getError({\n message: `[RecursiveTreeSql.walk] Invalid 'maxDepth' | Expected a positive integer | Got: ${maxDepth}`,\n });\n }\n\n if (!is(table, Table)) {\n throw getError({\n message: `[RecursiveTreeSql.walk] Invalid 'table' | Expected a Drizzle table | Got: ${typeof table}`,\n });\n }\n\n const engine = RecursiveTreeSql.detectEngine(table);\n\n const tableName = getTableName(table);\n RecursiveTreeSql.assertValidIdentifier({ field: 'table', value: tableName });\n\n // A Postgres table declared with `pgSchema('commerce').table(...)` lives outside the search path,\n // so the unqualified name would read the wrong relation or none. SQLite has no schemas.\n const schemaName =\n engine === RecursiveTreeEngines.POSTGRES\n ? getTableConfig(table as PgTable).schema\n : undefined;\n\n if (schemaName !== undefined) {\n RecursiveTreeSql.assertValidIdentifier({ field: 'schema', value: schemaName });\n }\n\n const tableIdentifier =\n schemaName === undefined\n ? sql.identifier(tableName)\n : sql`${sql.identifier(schemaName)}.${sql.identifier(tableName)}`;\n const cteIdentifier = sql.identifier(name);\n const idIdentifier = sql.identifier(idColumn);\n const parentIdentifier = sql.identifier(parentColumn);\n const extraIdentifiers = columns.map((column) => sql.identifier(column));\n\n const baseColumnList = sql.join([idIdentifier, parentIdentifier, ...extraIdentifiers], sql`, `);\n const recursiveColumnList = sql.join(\n [idIdentifier, parentIdentifier, ...extraIdentifiers].map(\n (identifier) => sql`t.${identifier}`,\n ),\n sql`, `,\n );\n\n const depthCast = RecursiveTreeSql.compileDepthCast({ engine, depth: startDepth });\n const { basePathColumns, recursivePathColumns } = trackPath\n ? RecursiveTreeSql.compileCycleGuardFragments({ engine, idIdentifier })\n : { basePathColumns: sql``, recursivePathColumns: sql`` };\n\n const anchorExtraFilter = anchorFilter ? sql` AND (${anchorFilter})` : sql``;\n const baseCase = sql`SELECT ${baseColumnList}, ${depthCast} AS depth${basePathColumns} FROM ${tableIdentifier} WHERE ${idIdentifier} = ${rootId}${anchorExtraFilter}`;\n\n // DOWN walks parent -> children (t.parentColumn = r.idColumn); UP walks child -> parent (t.idColumn = r.parentColumn).\n const joinCondition =\n direction === RecursiveTreeDirections.DOWN\n ? sql`t.${parentIdentifier} = r.${idIdentifier}`\n : sql`t.${idIdentifier} = r.${parentIdentifier}`;\n\n // `NOT r.is_cycle` stops expanding a row already flagged cyclic - the row itself stays in the\n // result set with is_cycle = true, only its own children are cut off.\n const cycleGuard = trackPath ? sql` AND NOT r.is_cycle` : sql``;\n const extraFilter = recursiveFilter ? sql` AND (${recursiveFilter})` : sql``;\n\n const recursiveCase = sql`SELECT ${recursiveColumnList}, r.depth + 1${recursivePathColumns} FROM ${tableIdentifier} t JOIN ${cteIdentifier} r ON ${joinCondition} WHERE r.depth + 1 <= ${maxDepth}${cycleGuard}${extraFilter}`;\n\n return sql`WITH RECURSIVE ${cteIdentifier} AS (${baseCase} UNION ALL ${recursiveCase})`;\n }\n\n /** See {@link RecursiveTreeSql} for why there is no separate `engine` option. */\n private static detectEngine(table: Table): TRecursiveTreeEngine {\n if (is(table, PgTable)) {\n return RecursiveTreeEngines.POSTGRES;\n }\n\n if (is(table, SQLiteTable)) {\n return RecursiveTreeEngines.SQLITE;\n }\n\n throw getError({\n message: `[RecursiveTreeSql.walk] Invalid 'table' | Expected a Postgres or SQLite Drizzle table | Got: ${getTableName(table)}`,\n });\n }\n\n /** Postgres needs an explicit cast so the base and recursive terms agree on the `depth` column's type; SQLite's looser typing does not, but casts anyway for parity and to fail loudly on a non-numeric `startDepth`. */\n private static compileDepthCast(opts: { engine: TRecursiveTreeEngine; depth: number }): SQL {\n const { engine, depth } = opts;\n\n switch (engine) {\n case RecursiveTreeEngines.POSTGRES: {\n return sql`${depth}::int`;\n }\n case RecursiveTreeEngines.SQLITE: {\n return sql`CAST(${depth} AS INTEGER)`;\n }\n default: {\n throw getError({\n message: `[RecursiveTreeSql.walk] Invalid 'engine' | Got: ${engine}`,\n });\n }\n }\n }\n\n /** See {@link RecursiveTreeSql} for why Postgres and SQLite need different `path`/`is_cycle` shapes. */\n private static compileCycleGuardFragments(opts: {\n engine: TRecursiveTreeEngine;\n idIdentifier: Name;\n }): { basePathColumns: SQL; recursivePathColumns: SQL } {\n const { engine, idIdentifier } = opts;\n\n switch (engine) {\n case RecursiveTreeEngines.POSTGRES: {\n return {\n basePathColumns: sql`, ARRAY[${idIdentifier}] AS path, false AS is_cycle`,\n recursivePathColumns: sql`, r.path || t.${idIdentifier} AS path, t.${idIdentifier} = ANY(r.path) AS is_cycle`,\n };\n }\n case RecursiveTreeEngines.SQLITE: {\n return {\n basePathColumns: sql`, ${SQLITE_PATH_DELIMITER} || ${idIdentifier} || ${SQLITE_PATH_DELIMITER} AS path, 0 AS is_cycle`,\n recursivePathColumns: sql`, r.path || t.${idIdentifier} || ${SQLITE_PATH_DELIMITER} AS path, instr(r.path, ${SQLITE_PATH_DELIMITER} || t.${idIdentifier} || ${SQLITE_PATH_DELIMITER}) > 0 AS is_cycle`,\n };\n }\n default: {\n throw getError({\n message: `[RecursiveTreeSql.walk] Invalid 'engine' | Got: ${engine}`,\n });\n }\n }\n }\n}\n"]}
@@ -55,7 +55,7 @@ class PGliteDriver {
55
55
  await this.client.waitReady;
56
56
  return this.client;
57
57
  },
58
- destroy: resource => this.scrubSession({ resource }),
58
+ destroy: (resource) => this.scrubSession({ resource }),
59
59
  });
60
60
  }
61
61
  createConnector(opts) {
@@ -106,7 +106,7 @@ class PGliteDriver {
106
106
  // Discard cannot throw the session away - there is one and no replacement.
107
107
  // The slot is re-created from the same instance after the destroy hook
108
108
  // scrubs it, so the next waiter never inherits an unknown transaction.
109
- this.slot.discard({ resource: client }).catch(error => {
109
+ this.slot.discard({ resource: client }).catch((error) => {
110
110
  this.logger.for('release').error('Failed to discard the PGlite slot | Error: %s', error);
111
111
  });
112
112
  },
@@ -1 +1 @@
1
- {"version":3,"file":"pglite.js","sourceRoot":"","sources":["../../../../../src/relational/postgres/drivers/pglite.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';\nimport type { TRelationalConnector } from '@/relational/postgres/datasources/common';\nimport type { PGlite } from '@electric-sql/pglite';\nimport type { ILogger, IPoolControlOptions } from '@venizia/ignis-helpers/core';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, BasePoolHelper, getError } from '@venizia/ignis-helpers/core';\nimport { drizzle } from 'drizzle-orm/pglite';\nimport type { TRelationalConnection, TRelationalDriver } from './driver';\n\n/** Pool knobs the driver forwards, minus `size`: one slot IS the mutual exclusion PGlite lacks. */\nexport type TPGliteDriverOptions = Omit<IPoolControlOptions, 'size'> & { client: PGlite };\n\n/**\n * Postgres compiled to WASM, in-process. Reports PostgreSQL 18.x, so the dialect works unchanged.\n *\n * One session only, and a second `BEGIN` neither nests nor errors - it joins the open transaction,\n * so the outer COMMIT commits the inner writer's rows. Hence the 1-slot pool behind `acquire()`.\n *\n * Consequence: a `createConnector()` write - the path all repositories take - runs INSIDE any open\n * transaction and dies with its ROLLBACK. Under concurrency, write through `acquire()`.\n */\nexport class PGliteDriver<\n Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema,\n> implements TRelationalDriver<Schema, PGlite> {\n private readonly client: PGlite;\n\n /**\n * The pooled resource IS the single client, so `create()` always hands back the same instance.\n * The pool contributes the mutual exclusion PGlite lacks, not connection multiplicity.\n */\n private readonly slot: BasePoolHelper<PGlite>;\n\n private readonly logger: ILogger;\n\n /**\n * A leaked transaction never releases the one slot, so without a timeout every later `acquire()`\n * in the process hangs forever and silently. 30s outlasts any honest transaction on an in-process\n * database with no network in it, and turns a leak into a named error instead of a dead process.\n */\n static readonly DEFAULT_ACQUIRE_TIMEOUT_MS = 30_000;\n\n /**\n * PGlite's Emscripten runtime plants this status on the HOST process during ordinary operation -\n * measured on `@electric-sql/pglite` 0.5.5, `process.exitCode` is `undefined` before the first\n * query and 99 after it, and every later query re-arms it. A server that shuts down cleanly then\n * exits 99, which Docker, systemd and CI all read as a crash.\n *\n * Named rather than inlined so a future PGlite using a different status stops matching and makes\n * the problem visible again, instead of {@link end} silently forcing a zero it did not verify.\n */\n private static readonly WASM_HOST_EXIT_STATUS = 99;\n\n constructor(opts: TPGliteDriverOptions) {\n const { client, acquireTimeoutMs, maxWaitingClients, scope } = opts;\n\n // PGlite is not a connection pool: it has no connect()/totalCount, which is what a `pg.Pool`\n // leads with. Probing its own verbs names the mistake here instead of at the first query.\n const isPGlite =\n typeof (client as AnyType)?.query === 'function' &&\n typeof (client as AnyType)?.exec === 'function' &&\n typeof (client as AnyType)?.close === 'function';\n\n if (!isPGlite) {\n throw getError({\n message: `[${PGliteDriver.name}] Expected an \\`@electric-sql/pglite\\` PGlite | Got a client without exec()/close() - a \\`pg.Pool\\`? | Construct \\`new PGlite('./pgdata')\\`, or name NodePostgresDriver instead`,\n });\n }\n\n this.client = client;\n // `LoggerFactory` cannot be imported here: this is the browser driver, and that\n // import reaches `node:module`. `BaseHelper` resolves the same logger through\n // the swappable resolver without pulling in the node-only provider loader.\n this.logger = new BaseHelper({ scope: PGliteDriver.name }).getLogger();\n\n this.slot = new BasePoolHelper<PGlite>({\n size: 1,\n acquireTimeoutMs: acquireTimeoutMs ?? PGliteDriver.DEFAULT_ACQUIRE_TIMEOUT_MS,\n maxWaitingClients,\n scope: scope ?? PGliteDriver.name,\n create: async () => {\n await this.client.waitReady;\n return this.client;\n },\n destroy: resource => this.scrubSession({ resource }),\n });\n }\n\n createConnector(opts: { schema: Schema }): TRelationalConnector<Schema> {\n return drizzle({ client: this.client, schema: opts.schema }) as TRelationalConnector<Schema>;\n }\n\n async acquire(opts: { schema: Schema }): Promise<TRelationalConnection<Schema>> {\n let client: PGlite;\n\n // The bare pool error names only a timeout; on one session the cause is almost always an\n // unreleased transaction, so say so where the caller reads it.\n try {\n client = await this.slot.acquire();\n } catch (error) {\n throw getError({\n message: `[${PGliteDriver.name}][acquire] Could not borrow the single PGlite session | ${(error as Error)?.message ?? String(error)} | An unreleased transaction still holds it - commit/rollback it, or raise \\`acquireTimeoutMs\\``,\n });\n }\n\n let connector: TRelationalConnector<Schema>;\n try {\n connector = drizzle({ client, schema: opts.schema }) as TRelationalConnector<Schema>;\n } catch (error) {\n this.slot.release({ resource: client });\n throw error;\n }\n\n // Every borrower gets the SAME object, so a stale handle releasing twice would hand the\n // slot away underneath whoever holds it now. The latch makes the second release a no-op.\n let isReleased = false;\n\n return {\n connector,\n\n execute: async (executeOpts: { statement: string }) => {\n const result = await client.query(executeOpts.statement);\n return { count: result.affectedRows ?? 0 };\n },\n\n query: async <R>(queryOpts: { statement: string }) => {\n const result = await client.query<R>(queryOpts.statement);\n return result.rows ?? [];\n },\n\n release: (releaseOpts?: { destroy?: boolean }) => {\n if (isReleased) {\n return;\n }\n isReleased = true;\n\n if (releaseOpts?.destroy !== true) {\n this.slot.release({ resource: client });\n return;\n }\n\n // Discard cannot throw the session away - there is one and no replacement.\n // The slot is re-created from the same instance after the destroy hook\n // scrubs it, so the next waiter never inherits an unknown transaction.\n this.slot.discard({ resource: client }).catch(error => {\n this.logger.for('release').error('Failed to discard the PGlite slot | Error: %s', error);\n });\n },\n };\n }\n\n getClient(): PGlite {\n return this.client;\n }\n\n async end(): Promise<void> {\n await this.slot.destroy();\n await this.client.close();\n this.clearWasmHostExitStatus();\n }\n\n /**\n * Clears the exit status PGlite planted on the host - see {@link WASM_HOST_EXIT_STATUS} - and\n * only while it still holds exactly that value, so an exit code the application set itself\n * survives untouched.\n *\n * `globalThis.process` is bound to a local and never member-accessed as `globalThis.process.x`:\n * this driver has to bundle clean for a browser target, where the property read yields\n * `undefined` and the optional chain short-circuits, while the member-access spelling is what the\n * purity gate treats as fatal.\n */\n private clearWasmHostExitStatus(): void {\n const host = globalThis.process;\n\n if (host?.exitCode !== PGliteDriver.WASM_HOST_EXIT_STATUS) {\n return;\n }\n\n host.exitCode = 0;\n this.logger\n .for(this.end.name)\n .debug(\n 'Cleared the exit status PGlite planted on the host process | status: %s',\n PGliteDriver.WASM_HOST_EXIT_STATUS,\n );\n }\n\n /**\n * The pool's destroy hook. A failed COMMIT/ROLLBACK may leave the session inside a transaction,\n * and the next borrower would inherit it. `ROLLBACK` outside a transaction is a no-op, so this is\n * safe whichever state the session is actually in.\n */\n private async scrubSession(opts: { resource: PGlite }): Promise<void> {\n const { resource } = opts;\n\n if (resource.closed) {\n return;\n }\n\n try {\n await resource.query('ROLLBACK');\n } catch (error) {\n this.logger\n .for(this.scrubSession.name)\n .warn('Failed to scrub the PGlite session | Error: %s', error);\n }\n }\n}\n"]}
1
+ {"version":3,"file":"pglite.js","sourceRoot":"","sources":["../../../../../src/relational/postgres/drivers/pglite.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';\nimport type { TRelationalConnector } from '@/relational/postgres/datasources/common';\nimport type { PGlite } from '@electric-sql/pglite';\nimport type { ILogger, IPoolControlOptions } from '@venizia/ignis-helpers/core';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, BasePoolHelper, getError } from '@venizia/ignis-helpers/core';\nimport { drizzle } from 'drizzle-orm/pglite';\nimport type { TRelationalConnection, TRelationalDriver } from './driver';\n\n/** Pool knobs the driver forwards, minus `size`: one slot IS the mutual exclusion PGlite lacks. */\nexport type TPGliteDriverOptions = Omit<IPoolControlOptions, 'size'> & { client: PGlite };\n\n/**\n * Postgres compiled to WASM, in-process. Reports PostgreSQL 18.x, so the dialect works unchanged.\n *\n * One session only, and a second `BEGIN` neither nests nor errors - it joins the open transaction,\n * so the outer COMMIT commits the inner writer's rows. Hence the 1-slot pool behind `acquire()`.\n *\n * Consequence: a `createConnector()` write - the path all repositories take - runs INSIDE any open\n * transaction and dies with its ROLLBACK. Under concurrency, write through `acquire()`.\n */\nexport class PGliteDriver<\n Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema,\n> implements TRelationalDriver<Schema, PGlite> {\n private readonly client: PGlite;\n\n /**\n * The pooled resource IS the single client, so `create()` always hands back the same instance.\n * The pool contributes the mutual exclusion PGlite lacks, not connection multiplicity.\n */\n private readonly slot: BasePoolHelper<PGlite>;\n\n private readonly logger: ILogger;\n\n /**\n * A leaked transaction never releases the one slot, so without a timeout every later `acquire()`\n * in the process hangs forever and silently. 30s outlasts any honest transaction on an in-process\n * database with no network in it, and turns a leak into a named error instead of a dead process.\n */\n static readonly DEFAULT_ACQUIRE_TIMEOUT_MS = 30_000;\n\n /**\n * PGlite's Emscripten runtime plants this status on the HOST process during ordinary operation -\n * measured on `@electric-sql/pglite` 0.5.5, `process.exitCode` is `undefined` before the first\n * query and 99 after it, and every later query re-arms it. A server that shuts down cleanly then\n * exits 99, which Docker, systemd and CI all read as a crash.\n *\n * Named rather than inlined so a future PGlite using a different status stops matching and makes\n * the problem visible again, instead of {@link end} silently forcing a zero it did not verify.\n */\n private static readonly WASM_HOST_EXIT_STATUS = 99;\n\n constructor(opts: TPGliteDriverOptions) {\n const { client, acquireTimeoutMs, maxWaitingClients, scope } = opts;\n\n // PGlite is not a connection pool: it has no connect()/totalCount, which is what a `pg.Pool`\n // leads with. Probing its own verbs names the mistake here instead of at the first query.\n const isPGlite =\n typeof (client as AnyType)?.query === 'function' &&\n typeof (client as AnyType)?.exec === 'function' &&\n typeof (client as AnyType)?.close === 'function';\n\n if (!isPGlite) {\n throw getError({\n message: `[${PGliteDriver.name}] Expected an \\`@electric-sql/pglite\\` PGlite | Got a client without exec()/close() - a \\`pg.Pool\\`? | Construct \\`new PGlite('./pgdata')\\`, or name NodePostgresDriver instead`,\n });\n }\n\n this.client = client;\n // `LoggerFactory` cannot be imported here: this is the browser driver, and that\n // import reaches `node:module`. `BaseHelper` resolves the same logger through\n // the swappable resolver without pulling in the node-only provider loader.\n this.logger = new BaseHelper({ scope: PGliteDriver.name }).getLogger();\n\n this.slot = new BasePoolHelper<PGlite>({\n size: 1,\n acquireTimeoutMs: acquireTimeoutMs ?? PGliteDriver.DEFAULT_ACQUIRE_TIMEOUT_MS,\n maxWaitingClients,\n scope: scope ?? PGliteDriver.name,\n create: async () => {\n await this.client.waitReady;\n return this.client;\n },\n destroy: (resource) => this.scrubSession({ resource }),\n });\n }\n\n createConnector(opts: { schema: Schema }): TRelationalConnector<Schema> {\n return drizzle({ client: this.client, schema: opts.schema }) as TRelationalConnector<Schema>;\n }\n\n async acquire(opts: { schema: Schema }): Promise<TRelationalConnection<Schema>> {\n let client: PGlite;\n\n // The bare pool error names only a timeout; on one session the cause is almost always an\n // unreleased transaction, so say so where the caller reads it.\n try {\n client = await this.slot.acquire();\n } catch (error) {\n throw getError({\n message: `[${PGliteDriver.name}][acquire] Could not borrow the single PGlite session | ${(error as Error)?.message ?? String(error)} | An unreleased transaction still holds it - commit/rollback it, or raise \\`acquireTimeoutMs\\``,\n });\n }\n\n let connector: TRelationalConnector<Schema>;\n try {\n connector = drizzle({ client, schema: opts.schema }) as TRelationalConnector<Schema>;\n } catch (error) {\n this.slot.release({ resource: client });\n throw error;\n }\n\n // Every borrower gets the SAME object, so a stale handle releasing twice would hand the\n // slot away underneath whoever holds it now. The latch makes the second release a no-op.\n let isReleased = false;\n\n return {\n connector,\n\n execute: async (executeOpts: { statement: string }) => {\n const result = await client.query(executeOpts.statement);\n return { count: result.affectedRows ?? 0 };\n },\n\n query: async <R>(queryOpts: { statement: string }) => {\n const result = await client.query<R>(queryOpts.statement);\n return result.rows ?? [];\n },\n\n release: (releaseOpts?: { destroy?: boolean }) => {\n if (isReleased) {\n return;\n }\n isReleased = true;\n\n if (releaseOpts?.destroy !== true) {\n this.slot.release({ resource: client });\n return;\n }\n\n // Discard cannot throw the session away - there is one and no replacement.\n // The slot is re-created from the same instance after the destroy hook\n // scrubs it, so the next waiter never inherits an unknown transaction.\n this.slot.discard({ resource: client }).catch((error) => {\n this.logger.for('release').error('Failed to discard the PGlite slot | Error: %s', error);\n });\n },\n };\n }\n\n getClient(): PGlite {\n return this.client;\n }\n\n async end(): Promise<void> {\n await this.slot.destroy();\n await this.client.close();\n this.clearWasmHostExitStatus();\n }\n\n /**\n * Clears the exit status PGlite planted on the host - see {@link WASM_HOST_EXIT_STATUS} - and\n * only while it still holds exactly that value, so an exit code the application set itself\n * survives untouched.\n *\n * `globalThis.process` is bound to a local and never member-accessed as `globalThis.process.x`:\n * this driver has to bundle clean for a browser target, where the property read yields\n * `undefined` and the optional chain short-circuits, while the member-access spelling is what the\n * purity gate treats as fatal.\n */\n private clearWasmHostExitStatus(): void {\n const host = globalThis.process;\n\n if (host?.exitCode !== PGliteDriver.WASM_HOST_EXIT_STATUS) {\n return;\n }\n\n host.exitCode = 0;\n this.logger\n .for(this.end.name)\n .debug(\n 'Cleared the exit status PGlite planted on the host process | status: %s',\n PGliteDriver.WASM_HOST_EXIT_STATUS,\n );\n }\n\n /**\n * The pool's destroy hook. A failed COMMIT/ROLLBACK may leave the session inside a transaction,\n * and the next borrower would inherit it. `ROLLBACK` outside a transaction is a no-op, so this is\n * safe whichever state the session is actually in.\n */\n private async scrubSession(opts: { resource: PGlite }): Promise<void> {\n const { resource } = opts;\n\n if (resource.closed) {\n return;\n }\n\n try {\n await resource.query('ROLLBACK');\n } catch (error) {\n this.logger\n .for(this.scrubSession.name)\n .warn('Failed to scrub the PGlite session | Error: %s', error);\n }\n }\n}\n"]}
@@ -8,7 +8,7 @@ const drizzle_orm_1 = require("drizzle-orm");
8
8
  /** Builds `<column> <operator> ARRAY[$1, ...]` with every element BOUND, never interpolated - these operators are wire-reachable with a `z.any()` operand, so raw interpolation is SQL injection. Element type decides only the CAST (text[] vs numeric[]), never the binding. */
9
9
  const buildPgArrayComparison = (opts) => {
10
10
  const { column, value, operator } = opts;
11
- const items = drizzle_orm_1.sql.join(value.map(item => (0, drizzle_orm_1.sql) `${item}`), (0, drizzle_orm_1.sql) `, `);
11
+ const items = drizzle_orm_1.sql.join(value.map((item) => (0, drizzle_orm_1.sql) `${item}`), (0, drizzle_orm_1.sql) `, `);
12
12
  const isNumericOrBoolean = typeof value[0] === 'number' || typeof value[0] === 'boolean';
13
13
  if (isNumericOrBoolean) {
14
14
  return (0, drizzle_orm_1.sql) `${column} ${drizzle_orm_1.sql.raw(operator)} ARRAY[${items}]`;
@@ -1 +1 @@
1
- {"version":3,"file":"query.js","sourceRoot":"","sources":["../../../../../../src/relational/postgres/repositories/dialect/query.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IQueryHandlerOptions } from '@venizia/ignis-kernel';\nimport { buildSubqueryCondition } from '@/relational/core/repositories/dialect/internal';\nimport { QueryOperators } from '@venizia/ignis-kernel';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport {\n between,\n eq,\n gt,\n gte,\n ilike,\n inArray,\n isNotNull,\n isNull,\n like,\n lt,\n lte,\n ne,\n not,\n notInArray,\n notLike,\n sql,\n} from 'drizzle-orm';\n\n/** Builds `<column> <operator> ARRAY[$1, ...]` with every element BOUND, never interpolated - these operators are wire-reachable with a `z.any()` operand, so raw interpolation is SQL injection. Element type decides only the CAST (text[] vs numeric[]), never the binding. */\nconst buildPgArrayComparison = (opts: { column: AnyType; value: AnyType[]; operator: string }) => {\n const { column, value, operator } = opts;\n\n const items = sql.join(\n value.map(item => sql`${item}`),\n sql`, `,\n );\n\n const isNumericOrBoolean = typeof value[0] === 'number' || typeof value[0] === 'boolean';\n\n if (isNumericOrBoolean) {\n return sql`${column} ${sql.raw(operator)} ARRAY[${items}]`;\n }\n\n // varchar[]/text[]/char[] all compare cleanly once both sides are text[].\n return sql`${column}::text[] ${sql.raw(operator)} ARRAY[${items}]::text[]`;\n};\n\n/** Drizzle-backed handlers for the neutral QueryOperators vocabulary (SQL branch only); the operator NAMES live in repositories/common/operators.ts, shared with the Search dialects. */\nexport class PostgresQueryOperators extends QueryOperators {\n static readonly FNS = {\n [this.EQ]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNull(opts.column) : eq(opts.column, opts.value),\n // SQL three-valued logic is canonical: a NULL row never matches `neq`/`ne` because comparing to a real value yields UNKNOWN, not TRUE.\n [this.NE]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNotNull(opts.column) : ne(opts.column, opts.value),\n [this.NEQ]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNotNull(opts.column) : ne(opts.column, opts.value),\n\n // `exists`/`notExists` test presence: `exists: true` -> IS NOT NULL, `exists: false` -> IS NULL, `notExists` the inverse.\n [this.EXISTS]: (opts: IQueryHandlerOptions) =>\n opts.value === false ? isNull(opts.column) : isNotNull(opts.column),\n [this.NOT_EXISTS]: (opts: IQueryHandlerOptions) =>\n opts.value === false ? isNotNull(opts.column) : isNull(opts.column),\n\n [this.GT]: (opts: IQueryHandlerOptions) => gt(opts.column, opts.value),\n [this.GTE]: (opts: IQueryHandlerOptions) => gte(opts.column, opts.value),\n\n [this.LT]: (opts: IQueryHandlerOptions) => lt(opts.column, opts.value),\n [this.LTE]: (opts: IQueryHandlerOptions) => lte(opts.column, opts.value),\n\n [this.IS]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNull(opts.column) : eq(opts.column, opts.value),\n [this.IS_NOT]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNotNull(opts.column) : ne(opts.column, opts.value),\n\n [this.IN]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value)) {\n return eq(opts.column, opts.value);\n }\n return opts.value.length === 0 ? sql`false` : inArray(opts.column, opts.value);\n },\n [this.INQ]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value)) {\n return eq(opts.column, opts.value);\n }\n return opts.value.length === 0 ? sql`false` : inArray(opts.column, opts.value);\n },\n [this.IN_SQL]: (opts: IQueryHandlerOptions) =>\n buildSubqueryCondition({ ...opts, operator: this.IN_SQL, isNegated: false }),\n [this.NOT_IN_SQL]: (opts: IQueryHandlerOptions) =>\n buildSubqueryCondition({ ...opts, operator: this.NOT_IN_SQL, isNegated: true }),\n [this.NIN]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value)) {\n return ne(opts.column, opts.value);\n }\n return opts.value.length === 0 ? sql`true` : notInArray(opts.column, opts.value);\n },\n [this.BETWEEN]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value) || opts.value.length !== 2) {\n throw getError({\n message: `[PostgresQueryOperators][BETWEEN] Invalid value: expected array of 2 elements, got ${JSON.stringify(opts.value)}`,\n });\n }\n return between(opts.column, opts.value[0], opts.value[1]);\n },\n [this.NOT_BETWEEN]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value) || opts.value.length !== 2) {\n throw getError({\n message: `[PostgresQueryOperators][NOT_BETWEEN] Invalid value: expected array of 2 elements, got ${JSON.stringify(opts.value)}`,\n });\n }\n return not(between(opts.column, opts.value[0], opts.value[1]));\n },\n\n [this.CONTAINS]: (opts: IQueryHandlerOptions) => {\n const value = Array.isArray(opts.value) ? opts.value : [opts.value];\n if (value.length === 0) {\n return sql`true`;\n }\n return buildPgArrayComparison({ column: opts.column, value, operator: '@>' });\n },\n [this.CONTAINED_BY]: (opts: IQueryHandlerOptions) => {\n const value = Array.isArray(opts.value) ? opts.value : [opts.value];\n if (value.length === 0) {\n return sql`${opts.column} = '{}'`;\n }\n return buildPgArrayComparison({ column: opts.column, value, operator: '<@' });\n },\n [this.OVERLAPS]: (opts: IQueryHandlerOptions) => {\n const value = Array.isArray(opts.value) ? opts.value : [opts.value];\n if (value.length === 0) {\n return sql`false`;\n }\n return buildPgArrayComparison({ column: opts.column, value, operator: '&&' });\n },\n\n [this.LIKE]: (opts: IQueryHandlerOptions) => like(opts.column, opts.value),\n [this.NOT_LIKE]: (opts: IQueryHandlerOptions) => notLike(opts.column, opts.value),\n [this.ILIKE]: (opts: IQueryHandlerOptions) => ilike(opts.column, opts.value),\n [this.NOT_ILIKE]: (opts: IQueryHandlerOptions) => not(ilike(opts.column, opts.value)),\n\n [this.REGEXP]: (opts: IQueryHandlerOptions) => sql`${opts.column} ~ ${opts.value}`,\n [this.IREGEXP]: (opts: IQueryHandlerOptions) => sql`${opts.column} ~* ${opts.value}`,\n };\n}\n"]}
1
+ {"version":3,"file":"query.js","sourceRoot":"","sources":["../../../../../../src/relational/postgres/repositories/dialect/query.ts"],"names":[],"mappings":";;;AACA,8EAAyF;AACzF,wDAAuD;AAEvD,sDAAuD;AACvD,6CAiBqB;AAErB,kRAAkR;AAClR,MAAM,sBAAsB,GAAG,CAAC,IAA6D,EAAE,EAAE;IAC/F,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAEzC,MAAM,KAAK,GAAG,iBAAG,CAAC,IAAI,CACpB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,iBAAG,EAAA,GAAG,IAAI,EAAE,CAAC,EACjC,IAAA,iBAAG,EAAA,IAAI,CACR,CAAC;IAEF,MAAM,kBAAkB,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;IAEzF,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO,IAAA,iBAAG,EAAA,GAAG,MAAM,IAAI,iBAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,KAAK,GAAG,CAAC;IAC7D,CAAC;IAED,0EAA0E;IAC1E,OAAO,IAAA,iBAAG,EAAA,GAAG,MAAM,YAAY,iBAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,KAAK,WAAW,CAAC;AAC7E,CAAC,CAAC;AAEF,yLAAyL;AACzL,MAAa,sBAAuB,SAAQ,6BAAc;aACxC,QAAG,GAAG;QACpB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CACxC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAA,oBAAM,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAA,gBAAE,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;QACzE,uIAAuI;QACvI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CACxC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAA,uBAAS,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAA,gBAAE,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;QAC5E,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CACzC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAA,uBAAS,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAA,gBAAE,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;QAE5E,0HAA0H;QAC1H,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CAC5C,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,IAAA,oBAAM,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAA,uBAAS,EAAC,IAAI,CAAC,MAAM,CAAC;QACrE,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CAChD,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,IAAA,uBAAS,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAA,oBAAM,EAAC,IAAI,CAAC,MAAM,CAAC;QAErE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CAAC,IAAA,gBAAE,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;QACtE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CAAC,IAAA,iBAAG,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;QAExE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CAAC,IAAA,gBAAE,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;QACtE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CAAC,IAAA,iBAAG,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;QAExE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CACxC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAA,oBAAM,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAA,gBAAE,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;QACzE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CAC5C,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAA,uBAAS,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAA,gBAAE,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;QAE5E,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE;YACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,OAAO,IAAA,gBAAE,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;YACD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAA,iBAAG,EAAA,OAAO,CAAC,CAAC,CAAC,IAAA,qBAAO,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjF,CAAC;QACD,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE;YACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,OAAO,IAAA,gBAAE,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;YACD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAA,iBAAG,EAAA,OAAO,CAAC,CAAC,CAAC,IAAA,qBAAO,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjF,CAAC;QACD,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CAC5C,IAAA,iCAAsB,EAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAC9E,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CAChD,IAAA,iCAAsB,EAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACjF,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE;YACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,OAAO,IAAA,gBAAE,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;YACD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAA,iBAAG,EAAA,MAAM,CAAC,CAAC,CAAC,IAAA,wBAAU,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACnF,CAAC;QACD,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE;YAC7C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1D,MAAM,IAAA,eAAQ,EAAC;oBACb,OAAO,EAAE,sFAAsF,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;iBAC5H,CAAC,CAAC;YACL,CAAC;YACD,OAAO,IAAA,qBAAO,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,CAAC;QACD,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE;YACjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1D,MAAM,IAAA,eAAQ,EAAC;oBACb,OAAO,EAAE,0FAA0F,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;iBAChI,CAAC,CAAC;YACL,CAAC;YACD,OAAO,IAAA,iBAAG,EAAC,IAAA,qBAAO,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,CAAC;QAED,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE;YAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO,IAAA,iBAAG,EAAA,MAAM,CAAC;YACnB,CAAC;YACD,OAAO,sBAAsB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAChF,CAAC;QACD,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE;YAClD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO,IAAA,iBAAG,EAAA,GAAG,IAAI,CAAC,MAAM,SAAS,CAAC;YACpC,CAAC;YACD,OAAO,sBAAsB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAChF,CAAC;QACD,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE;YAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO,IAAA,iBAAG,EAAA,OAAO,CAAC;YACpB,CAAC;YACD,OAAO,sBAAsB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CAAC,IAAA,kBAAI,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;QAC1E,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CAAC,IAAA,qBAAO,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;QACjF,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CAAC,IAAA,mBAAK,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;QAC5E,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CAAC,IAAA,iBAAG,EAAC,IAAA,mBAAK,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAErF,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CAAC,IAAA,iBAAG,EAAA,GAAG,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,KAAK,EAAE;QAClF,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAA0B,EAAE,EAAE,CAAC,IAAA,iBAAG,EAAA,GAAG,IAAI,CAAC,MAAM,OAAO,IAAI,CAAC,KAAK,EAAE;KACrF,CAAC;;AA/FJ,wDAgGC","sourcesContent":["import type { IQueryHandlerOptions } from '@venizia/ignis-kernel';\nimport { buildSubqueryCondition } from '@/relational/core/repositories/dialect/internal';\nimport { QueryOperators } from '@venizia/ignis-kernel';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport {\n between,\n eq,\n gt,\n gte,\n ilike,\n inArray,\n isNotNull,\n isNull,\n like,\n lt,\n lte,\n ne,\n not,\n notInArray,\n notLike,\n sql,\n} from 'drizzle-orm';\n\n/** Builds `<column> <operator> ARRAY[$1, ...]` with every element BOUND, never interpolated - these operators are wire-reachable with a `z.any()` operand, so raw interpolation is SQL injection. Element type decides only the CAST (text[] vs numeric[]), never the binding. */\nconst buildPgArrayComparison = (opts: { column: AnyType; value: AnyType[]; operator: string }) => {\n const { column, value, operator } = opts;\n\n const items = sql.join(\n value.map((item) => sql`${item}`),\n sql`, `,\n );\n\n const isNumericOrBoolean = typeof value[0] === 'number' || typeof value[0] === 'boolean';\n\n if (isNumericOrBoolean) {\n return sql`${column} ${sql.raw(operator)} ARRAY[${items}]`;\n }\n\n // varchar[]/text[]/char[] all compare cleanly once both sides are text[].\n return sql`${column}::text[] ${sql.raw(operator)} ARRAY[${items}]::text[]`;\n};\n\n/** Drizzle-backed handlers for the neutral QueryOperators vocabulary (SQL branch only); the operator NAMES live in repositories/common/operators.ts, shared with the Search dialects. */\nexport class PostgresQueryOperators extends QueryOperators {\n static readonly FNS = {\n [this.EQ]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNull(opts.column) : eq(opts.column, opts.value),\n // SQL three-valued logic is canonical: a NULL row never matches `neq`/`ne` because comparing to a real value yields UNKNOWN, not TRUE.\n [this.NE]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNotNull(opts.column) : ne(opts.column, opts.value),\n [this.NEQ]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNotNull(opts.column) : ne(opts.column, opts.value),\n\n // `exists`/`notExists` test presence: `exists: true` -> IS NOT NULL, `exists: false` -> IS NULL, `notExists` the inverse.\n [this.EXISTS]: (opts: IQueryHandlerOptions) =>\n opts.value === false ? isNull(opts.column) : isNotNull(opts.column),\n [this.NOT_EXISTS]: (opts: IQueryHandlerOptions) =>\n opts.value === false ? isNotNull(opts.column) : isNull(opts.column),\n\n [this.GT]: (opts: IQueryHandlerOptions) => gt(opts.column, opts.value),\n [this.GTE]: (opts: IQueryHandlerOptions) => gte(opts.column, opts.value),\n\n [this.LT]: (opts: IQueryHandlerOptions) => lt(opts.column, opts.value),\n [this.LTE]: (opts: IQueryHandlerOptions) => lte(opts.column, opts.value),\n\n [this.IS]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNull(opts.column) : eq(opts.column, opts.value),\n [this.IS_NOT]: (opts: IQueryHandlerOptions) =>\n opts.value === null ? isNotNull(opts.column) : ne(opts.column, opts.value),\n\n [this.IN]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value)) {\n return eq(opts.column, opts.value);\n }\n return opts.value.length === 0 ? sql`false` : inArray(opts.column, opts.value);\n },\n [this.INQ]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value)) {\n return eq(opts.column, opts.value);\n }\n return opts.value.length === 0 ? sql`false` : inArray(opts.column, opts.value);\n },\n [this.IN_SQL]: (opts: IQueryHandlerOptions) =>\n buildSubqueryCondition({ ...opts, operator: this.IN_SQL, isNegated: false }),\n [this.NOT_IN_SQL]: (opts: IQueryHandlerOptions) =>\n buildSubqueryCondition({ ...opts, operator: this.NOT_IN_SQL, isNegated: true }),\n [this.NIN]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value)) {\n return ne(opts.column, opts.value);\n }\n return opts.value.length === 0 ? sql`true` : notInArray(opts.column, opts.value);\n },\n [this.BETWEEN]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value) || opts.value.length !== 2) {\n throw getError({\n message: `[PostgresQueryOperators][BETWEEN] Invalid value: expected array of 2 elements, got ${JSON.stringify(opts.value)}`,\n });\n }\n return between(opts.column, opts.value[0], opts.value[1]);\n },\n [this.NOT_BETWEEN]: (opts: IQueryHandlerOptions) => {\n if (!Array.isArray(opts.value) || opts.value.length !== 2) {\n throw getError({\n message: `[PostgresQueryOperators][NOT_BETWEEN] Invalid value: expected array of 2 elements, got ${JSON.stringify(opts.value)}`,\n });\n }\n return not(between(opts.column, opts.value[0], opts.value[1]));\n },\n\n [this.CONTAINS]: (opts: IQueryHandlerOptions) => {\n const value = Array.isArray(opts.value) ? opts.value : [opts.value];\n if (value.length === 0) {\n return sql`true`;\n }\n return buildPgArrayComparison({ column: opts.column, value, operator: '@>' });\n },\n [this.CONTAINED_BY]: (opts: IQueryHandlerOptions) => {\n const value = Array.isArray(opts.value) ? opts.value : [opts.value];\n if (value.length === 0) {\n return sql`${opts.column} = '{}'`;\n }\n return buildPgArrayComparison({ column: opts.column, value, operator: '<@' });\n },\n [this.OVERLAPS]: (opts: IQueryHandlerOptions) => {\n const value = Array.isArray(opts.value) ? opts.value : [opts.value];\n if (value.length === 0) {\n return sql`false`;\n }\n return buildPgArrayComparison({ column: opts.column, value, operator: '&&' });\n },\n\n [this.LIKE]: (opts: IQueryHandlerOptions) => like(opts.column, opts.value),\n [this.NOT_LIKE]: (opts: IQueryHandlerOptions) => notLike(opts.column, opts.value),\n [this.ILIKE]: (opts: IQueryHandlerOptions) => ilike(opts.column, opts.value),\n [this.NOT_ILIKE]: (opts: IQueryHandlerOptions) => not(ilike(opts.column, opts.value)),\n\n [this.REGEXP]: (opts: IQueryHandlerOptions) => sql`${opts.column} ~ ${opts.value}`,\n [this.IREGEXP]: (opts: IQueryHandlerOptions) => sql`${opts.column} ~* ${opts.value}`,\n };\n}\n"]}
@@ -55,7 +55,7 @@ class LibSqlDriver {
55
55
  maxWaitingClients,
56
56
  scope: scope ?? LibSqlDriver.name,
57
57
  create: () => this.client,
58
- destroy: resource => this.scrubSession({ resource }),
58
+ destroy: (resource) => this.scrubSession({ resource }),
59
59
  });
60
60
  }
61
61
  createConnector(opts) {
@@ -115,7 +115,7 @@ class LibSqlDriver {
115
115
  // Discard cannot throw the connection away - there is one client and no
116
116
  // replacement. The slot is re-created from the same instance after the destroy
117
117
  // hook scrubs it, so the next waiter never inherits an unknown transaction.
118
- this.slot.discard({ resource: client }).catch(error => {
118
+ this.slot.discard({ resource: client }).catch((error) => {
119
119
  this.logger.for('release').error('Failed to discard the libsql slot | Error: %s', error);
120
120
  });
121
121
  },
@@ -1 +1 @@
1
- {"version":3,"file":"libsql.js","sourceRoot":"","sources":["../../../../../src/relational/sqlite/drivers/libsql.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';\nimport { throwNotSupported } from '@venizia/ignis-kernel';\nimport type { Client } from '@libsql/client';\nimport type { ILogger, IPoolControlOptions } from '@venizia/ignis-helpers/core';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, BasePoolHelper, getError } from '@venizia/ignis-helpers/core';\nimport { drizzle } from 'drizzle-orm/libsql';\nimport type { TSqliteConnection, TSqliteConnector, TSqliteDriver } from './driver';\n\n/**\n * libsql's own name for a local database file, the\n * only protocol whose statements share a connection.\n */\nconst FILE_PROTOCOL = 'file';\n\n/**\n * SQLite rejects ROLLBACK outside a transaction rather\n * than treating it as a no-op the way Postgres does.\n */\nconst NO_ACTIVE_TRANSACTION = 'no transaction is active';\n\n/**\n * Pool knobs the driver forwards, minus `size`: one slot\n * IS the mutual exclusion a single connection lacks.\n */\nexport type TLibSqlDriverOptions = Omit<IPoolControlOptions, 'size'> & { client: Client };\n\n/**\n * Covers `:memory:`, a local file, remote Turso and embedded replicas. Chosen over `better-sqlite3`\n * and `bun:sqlite` for its async result kind - those block the event loop.\n *\n * `acquire()` takes a 1-slot pool, not a second connection: `drizzle()` binds to a `Client`, never\n * to libsql's `Transaction`, and `client.transaction()` swaps the connection out - against\n * `:memory:` that is a DIFFERENT empty database.\n *\n * Consequence: a query on the `createConnector()` connector while a transaction is open runs INSIDE\n * it. Route work that must stay outside one through `acquire()`.\n */\nexport class LibSqlDriver<\n Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema,\n> implements TSqliteDriver<Schema, Client> {\n private readonly client: Client;\n\n /**\n * The pooled resource IS the single client, so `create()` always hands back the same instance.\n * The pool contributes mutual exclusion, not connection multiplicity.\n */\n private readonly slot: BasePoolHelper<Client>;\n\n private readonly logger: ILogger;\n\n /**\n * A leaked transaction never releases the one slot, so without a timeout every later `acquire()`\n * in the process hangs forever and silently. 30s outlasts any honest SQLite write transaction -\n * one writer at a time is the engine's own limit - and turns a leak into a named error.\n */\n static readonly DEFAULT_ACQUIRE_TIMEOUT_MS = 30_000;\n\n constructor(opts: TLibSqlDriverOptions) {\n const { client, acquireTimeoutMs, maxWaitingClients, scope } = opts;\n\n // A `bun:sqlite` / better-sqlite3 Database leads with prepare()/exec() and has none\n // of these, so the wrong driver class fails here rather than at the first query.\n const isLibSqlClient =\n typeof (client as AnyType)?.execute === 'function' &&\n typeof (client as AnyType)?.batch === 'function' &&\n typeof (client as AnyType)?.transaction === 'function' &&\n typeof (client as AnyType)?.protocol === 'string';\n\n if (!isLibSqlClient) {\n throw getError({\n message: `[${LibSqlDriver.name}] Expected an \\`@libsql/client\\` Client | Got a client without execute()/batch()/transaction() - a \\`bun:sqlite\\` Database? | Construct \\`createClient({ url: 'file:./data.db' })\\``,\n });\n }\n\n this.client = client;\n // Not `LoggerFactory`: it reaches the helpers root barrel, which pulls `ioredis` and fails a\n // browser bundle on `tls`.\n this.logger = new BaseHelper({ scope: LibSqlDriver.name }).getLogger();\n\n this.slot = new BasePoolHelper<Client>({\n size: 1,\n acquireTimeoutMs: acquireTimeoutMs ?? LibSqlDriver.DEFAULT_ACQUIRE_TIMEOUT_MS,\n maxWaitingClients,\n scope: scope ?? LibSqlDriver.name,\n create: () => this.client,\n destroy: resource => this.scrubSession({ resource }),\n });\n }\n\n createConnector(opts: { schema: Schema }): TSqliteConnector<Schema> {\n return drizzle({ client: this.client, schema: opts.schema });\n }\n\n async acquire(opts: { schema: Schema }): Promise<TSqliteConnection<Schema>> {\n // A remote client opens a stream per statement and closes it, so BEGIN would neither hold nor\n // error - the transaction would silently not exist.\n if (this.client.protocol !== FILE_PROTOCOL) {\n throwNotSupported({\n scope: LibSqlDriver.name,\n feature: `Explicit transactions over a '${this.client.protocol}' libsql client - every statement runs on its own connection, so BEGIN cannot hold; use a \\`file:\\` or \\`:memory:\\` url, or an embedded replica`,\n logger: this.logger,\n });\n }\n\n let client: Client;\n\n // The bare pool error names only a timeout; on one connection the cause is almost always an\n // unreleased transaction, so say so where the caller reads it.\n try {\n client = await this.slot.acquire();\n } catch (error) {\n throw getError({\n message: `[${LibSqlDriver.name}][acquire] Could not borrow the single libsql connection | ${(error as Error)?.message ?? String(error)} | An unreleased transaction still holds it - commit/rollback it, or raise \\`acquireTimeoutMs\\``,\n });\n }\n\n let connector: TSqliteConnector<Schema>;\n try {\n connector = drizzle({ client, schema: opts.schema });\n } catch (error) {\n this.slot.release({ resource: client });\n throw error;\n }\n\n // Every borrower gets the SAME object, so a stale handle releasing twice would hand the\n // slot away underneath whoever holds it now. The latch makes the second release a no-op.\n let isReleased = false;\n\n return {\n connector,\n\n execute: async (executeOpts: { statement: string }) => {\n const result = await client.execute(executeOpts.statement);\n return { count: result.rowsAffected ?? 0 };\n },\n\n query: async <R>(queryOpts: { statement: string }) => {\n const result = await client.execute(queryOpts.statement);\n return (result.rows ?? []) as Array<R>;\n },\n\n release: (releaseOpts?: { destroy?: boolean }) => {\n if (isReleased) {\n return;\n }\n isReleased = true;\n\n if (releaseOpts?.destroy !== true) {\n this.slot.release({ resource: client });\n return;\n }\n\n // Discard cannot throw the connection away - there is one client and no\n // replacement. The slot is re-created from the same instance after the destroy\n // hook scrubs it, so the next waiter never inherits an unknown transaction.\n this.slot.discard({ resource: client }).catch(error => {\n this.logger.for('release').error('Failed to discard the libsql slot | Error: %s', error);\n });\n },\n };\n }\n\n getClient(): Client {\n return this.client;\n }\n\n async end(): Promise<void> {\n await this.slot.destroy();\n this.client.close();\n }\n\n /**\n * The pool's destroy hook. A failed COMMIT/ROLLBACK may leave the connection inside a transaction\n * and the next borrower would inherit it. The client offers no way to ask whether one is open, so\n * the ROLLBACK is issued blind and its rejection is the ordinary answer of a clean connection.\n */\n private async scrubSession(opts: { resource: Client }): Promise<void> {\n const { resource } = opts;\n\n if (resource.closed) {\n return;\n }\n\n try {\n await resource.execute('ROLLBACK');\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n\n if (message.includes(NO_ACTIVE_TRANSACTION)) {\n this.logger.for(this.scrubSession.name).debug('Nothing to scrub | %s', message);\n return;\n }\n\n this.logger\n .for(this.scrubSession.name)\n .warn('Failed to scrub the libsql session | Error: %s', error);\n }\n }\n}\n"]}
1
+ {"version":3,"file":"libsql.js","sourceRoot":"","sources":["../../../../../src/relational/sqlite/drivers/libsql.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';\nimport { throwNotSupported } from '@venizia/ignis-kernel';\nimport type { Client } from '@libsql/client';\nimport type { ILogger, IPoolControlOptions } from '@venizia/ignis-helpers/core';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, BasePoolHelper, getError } from '@venizia/ignis-helpers/core';\nimport { drizzle } from 'drizzle-orm/libsql';\nimport type { TSqliteConnection, TSqliteConnector, TSqliteDriver } from './driver';\n\n/**\n * libsql's own name for a local database file, the\n * only protocol whose statements share a connection.\n */\nconst FILE_PROTOCOL = 'file';\n\n/**\n * SQLite rejects ROLLBACK outside a transaction rather\n * than treating it as a no-op the way Postgres does.\n */\nconst NO_ACTIVE_TRANSACTION = 'no transaction is active';\n\n/**\n * Pool knobs the driver forwards, minus `size`: one slot\n * IS the mutual exclusion a single connection lacks.\n */\nexport type TLibSqlDriverOptions = Omit<IPoolControlOptions, 'size'> & { client: Client };\n\n/**\n * Covers `:memory:`, a local file, remote Turso and embedded replicas. Chosen over `better-sqlite3`\n * and `bun:sqlite` for its async result kind - those block the event loop.\n *\n * `acquire()` takes a 1-slot pool, not a second connection: `drizzle()` binds to a `Client`, never\n * to libsql's `Transaction`, and `client.transaction()` swaps the connection out - against\n * `:memory:` that is a DIFFERENT empty database.\n *\n * Consequence: a query on the `createConnector()` connector while a transaction is open runs INSIDE\n * it. Route work that must stay outside one through `acquire()`.\n */\nexport class LibSqlDriver<\n Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema,\n> implements TSqliteDriver<Schema, Client> {\n private readonly client: Client;\n\n /**\n * The pooled resource IS the single client, so `create()` always hands back the same instance.\n * The pool contributes mutual exclusion, not connection multiplicity.\n */\n private readonly slot: BasePoolHelper<Client>;\n\n private readonly logger: ILogger;\n\n /**\n * A leaked transaction never releases the one slot, so without a timeout every later `acquire()`\n * in the process hangs forever and silently. 30s outlasts any honest SQLite write transaction -\n * one writer at a time is the engine's own limit - and turns a leak into a named error.\n */\n static readonly DEFAULT_ACQUIRE_TIMEOUT_MS = 30_000;\n\n constructor(opts: TLibSqlDriverOptions) {\n const { client, acquireTimeoutMs, maxWaitingClients, scope } = opts;\n\n // A `bun:sqlite` / better-sqlite3 Database leads with prepare()/exec() and has none\n // of these, so the wrong driver class fails here rather than at the first query.\n const isLibSqlClient =\n typeof (client as AnyType)?.execute === 'function' &&\n typeof (client as AnyType)?.batch === 'function' &&\n typeof (client as AnyType)?.transaction === 'function' &&\n typeof (client as AnyType)?.protocol === 'string';\n\n if (!isLibSqlClient) {\n throw getError({\n message: `[${LibSqlDriver.name}] Expected an \\`@libsql/client\\` Client | Got a client without execute()/batch()/transaction() - a \\`bun:sqlite\\` Database? | Construct \\`createClient({ url: 'file:./data.db' })\\``,\n });\n }\n\n this.client = client;\n // Not `LoggerFactory`: it reaches the helpers root barrel, which pulls `ioredis` and fails a\n // browser bundle on `tls`.\n this.logger = new BaseHelper({ scope: LibSqlDriver.name }).getLogger();\n\n this.slot = new BasePoolHelper<Client>({\n size: 1,\n acquireTimeoutMs: acquireTimeoutMs ?? LibSqlDriver.DEFAULT_ACQUIRE_TIMEOUT_MS,\n maxWaitingClients,\n scope: scope ?? LibSqlDriver.name,\n create: () => this.client,\n destroy: (resource) => this.scrubSession({ resource }),\n });\n }\n\n createConnector(opts: { schema: Schema }): TSqliteConnector<Schema> {\n return drizzle({ client: this.client, schema: opts.schema });\n }\n\n async acquire(opts: { schema: Schema }): Promise<TSqliteConnection<Schema>> {\n // A remote client opens a stream per statement and closes it, so BEGIN would neither hold nor\n // error - the transaction would silently not exist.\n if (this.client.protocol !== FILE_PROTOCOL) {\n throwNotSupported({\n scope: LibSqlDriver.name,\n feature: `Explicit transactions over a '${this.client.protocol}' libsql client - every statement runs on its own connection, so BEGIN cannot hold; use a \\`file:\\` or \\`:memory:\\` url, or an embedded replica`,\n logger: this.logger,\n });\n }\n\n let client: Client;\n\n // The bare pool error names only a timeout; on one connection the cause is almost always an\n // unreleased transaction, so say so where the caller reads it.\n try {\n client = await this.slot.acquire();\n } catch (error) {\n throw getError({\n message: `[${LibSqlDriver.name}][acquire] Could not borrow the single libsql connection | ${(error as Error)?.message ?? String(error)} | An unreleased transaction still holds it - commit/rollback it, or raise \\`acquireTimeoutMs\\``,\n });\n }\n\n let connector: TSqliteConnector<Schema>;\n try {\n connector = drizzle({ client, schema: opts.schema });\n } catch (error) {\n this.slot.release({ resource: client });\n throw error;\n }\n\n // Every borrower gets the SAME object, so a stale handle releasing twice would hand the\n // slot away underneath whoever holds it now. The latch makes the second release a no-op.\n let isReleased = false;\n\n return {\n connector,\n\n execute: async (executeOpts: { statement: string }) => {\n const result = await client.execute(executeOpts.statement);\n return { count: result.rowsAffected ?? 0 };\n },\n\n query: async <R>(queryOpts: { statement: string }) => {\n const result = await client.execute(queryOpts.statement);\n return (result.rows ?? []) as Array<R>;\n },\n\n release: (releaseOpts?: { destroy?: boolean }) => {\n if (isReleased) {\n return;\n }\n isReleased = true;\n\n if (releaseOpts?.destroy !== true) {\n this.slot.release({ resource: client });\n return;\n }\n\n // Discard cannot throw the connection away - there is one client and no\n // replacement. The slot is re-created from the same instance after the destroy\n // hook scrubs it, so the next waiter never inherits an unknown transaction.\n this.slot.discard({ resource: client }).catch((error) => {\n this.logger.for('release').error('Failed to discard the libsql slot | Error: %s', error);\n });\n },\n };\n }\n\n getClient(): Client {\n return this.client;\n }\n\n async end(): Promise<void> {\n await this.slot.destroy();\n this.client.close();\n }\n\n /**\n * The pool's destroy hook. A failed COMMIT/ROLLBACK may leave the connection inside a transaction\n * and the next borrower would inherit it. The client offers no way to ask whether one is open, so\n * the ROLLBACK is issued blind and its rejection is the ordinary answer of a clean connection.\n */\n private async scrubSession(opts: { resource: Client }): Promise<void> {\n const { resource } = opts;\n\n if (resource.closed) {\n return;\n }\n\n try {\n await resource.execute('ROLLBACK');\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n\n if (message.includes(NO_ACTIVE_TRANSACTION)) {\n this.logger.for(this.scrubSession.name).debug('Nothing to scrub | %s', message);\n return;\n }\n\n this.logger\n .for(this.scrubSession.name)\n .warn('Failed to scrub the libsql session | Error: %s', error);\n }\n }\n}\n"]}
@@ -14,7 +14,7 @@ const isAmbiguousComponent = (opts) => /^\d+$/.test(opts.part);
14
14
  */
15
15
  const toSqliteJsonPaths = (opts) => {
16
16
  const { path } = opts;
17
- const ambiguousCount = path.filter(part => isAmbiguousComponent({ part })).length;
17
+ const ambiguousCount = path.filter((part) => isAmbiguousComponent({ part })).length;
18
18
  if (ambiguousCount > MAX_AMBIGUOUS_COMPONENTS) {
19
19
  throw (0, core_1.getError)({
20
20
  message: `[toSqliteJsonPaths] Ambiguous JSON path components over the limit | max: ${MAX_AMBIGUOUS_COMPONENTS} | got: ${ambiguousCount} | each all-digit component doubles the candidate paths`,
@@ -23,8 +23,8 @@ const toSqliteJsonPaths = (opts) => {
23
23
  let literals = ['$'];
24
24
  for (const part of path) {
25
25
  literals = isAmbiguousComponent({ part })
26
- ? literals.flatMap(literal => [`${literal}[${part}]`, `${literal}."${part}"`])
27
- : literals.map(literal => `${literal}."${part}"`);
26
+ ? literals.flatMap((literal) => [`${literal}[${part}]`, `${literal}."${part}"`])
27
+ : literals.map((literal) => `${literal}."${part}"`);
28
28
  }
29
29
  return literals;
30
30
  };
@@ -1 +1 @@
1
- {"version":3,"file":"json-path.js","sourceRoot":"","sources":["../../../../../../../src/relational/sqlite/repositories/dialect/internal/json-path.ts"],"names":[],"mappings":";;;AACA,sDAAuD;AAEvD,6CAA0C;AAE1C,kGAAkG;AAClG,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAEnC,MAAM,oBAAoB,GAAG,CAAC,IAAsB,EAAW,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE1F;;;;;GAKG;AACI,MAAM,iBAAiB,GAAG,CAAC,IAAwB,EAAY,EAAE;IACtE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAEtB,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAClF,IAAI,cAAc,GAAG,wBAAwB,EAAE,CAAC;QAC9C,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE,4EAA4E,wBAAwB,WAAW,cAAc,yDAAyD;SAChM,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,QAAQ,GAAG,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC;YACvC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,GAAG,EAAE,GAAG,OAAO,KAAK,IAAI,GAAG,CAAC,CAAC;YAC9E,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,KAAK,IAAI,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAnBW,QAAA,iBAAiB,qBAmB5B;AAEF,MAAM,eAAe,GAAG,IAAI,yBAAW,CAAC,eAAe,CAAC,CAAC;AACzD,MAAM,yBAAyB,GAAG,IAAI,yBAAW,CAAC,wBAAwB,CAAC,CAAC;AAE5E;;;;;;;;GAQG;AACI,MAAM,4BAA4B,GAAG,CAAC,IAG5C,EAAc,EAAE;IACf,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAE9B,MAAM,QAAQ,GAAG,IAAA,yBAAiB,EAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACtC,2FAA2F;IAC3F,MAAM,MAAM,GAAe,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC;IAE3F,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,yBAAW,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,yBAAW,CAAC,MAAM,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;IAE7E,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAnBW,QAAA,4BAA4B,gCAmBvC","sourcesContent":["import type { TTableColumns } from '@/relational/core/repositories/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { SQLChunk } from 'drizzle-orm';\nimport { StringChunk } from 'drizzle-orm';\n\n/** Every all-digit component doubles the candidate paths, and filter keys arrive from callers. */\nconst MAX_AMBIGUOUS_COMPONENTS = 4;\n\nconst isAmbiguousComponent = (opts: { part: string }): boolean => /^\\d+$/.test(opts.part);\n\n/**\n * Every path literal a component sequence can mean, array reading first. SQLite cannot\n * express both readings of an all-digit component at once - `$.\"c\"[0]` is an array element,\n * `$.\"c\".\"0\"` an object key, and neither falls back to the other - while Postgres's `#>>\n * '{c,0}'` addresses both. Handing SQLite every candidate is what makes the engines agree.\n */\nexport const toSqliteJsonPaths = (opts: { path: string[] }): string[] => {\n const { path } = opts;\n\n const ambiguousCount = path.filter(part => isAmbiguousComponent({ part })).length;\n if (ambiguousCount > MAX_AMBIGUOUS_COMPONENTS) {\n throw getError({\n message: `[toSqliteJsonPaths] Ambiguous JSON path components over the limit | max: ${MAX_AMBIGUOUS_COMPONENTS} | got: ${ambiguousCount} | each all-digit component doubles the candidate paths`,\n });\n }\n\n let literals = ['$'];\n\n for (const part of path) {\n literals = isAmbiguousComponent({ part })\n ? literals.flatMap(literal => [`${literal}[${part}]`, `${literal}.\"${part}\"`])\n : literals.map(literal => `${literal}.\"${part}\"`);\n }\n\n return literals;\n};\n\nconst EXTRACTION_OPEN = new StringChunk('json_extract(');\nconst COALESCED_EXTRACTION_OPEN = new StringChunk('coalesce(json_extract(');\n\n/**\n * The `json_extract` expression for one JSON-path key, as the chunks of one flat fragment (every\n * nested `SQL` level costs a render pass); a caller may append a chunk before `sql.fromList`. The\n * Drizzle column chunk is qualified or aliased like a plain key. The path literal is raw text, safe\n * only because every component has passed `validateJsonPathComponents`, which admits no quote.\n *\n * Coalescing loses nothing: a container is either an array or an object, so at most one candidate\n * resolves to non-NULL.\n */\nexport const toSqliteJsonExtractionChunks = (opts: {\n column: TTableColumns[string];\n path: string[];\n}): SQLChunk[] => {\n const { column, path } = opts;\n\n const literals = toSqliteJsonPaths({ path });\n const lastIndex = literals.length - 1;\n // json_extract(col, 'L') | coalesce(json_extract(col, 'L0'), ..., json_extract(col, 'Ln'))\n const chunks: SQLChunk[] = [lastIndex === 0 ? EXTRACTION_OPEN : COALESCED_EXTRACTION_OPEN];\n\n for (let index = 0; index < lastIndex; index++) {\n chunks.push(column, new StringChunk(`, '${literals[index]}'), json_extract(`));\n }\n\n const closing = lastIndex === 0 ? ')' : '))';\n chunks.push(column, new StringChunk(`, '${literals[lastIndex]}'${closing}`));\n\n return chunks;\n};\n"]}
1
+ {"version":3,"file":"json-path.js","sourceRoot":"","sources":["../../../../../../../src/relational/sqlite/repositories/dialect/internal/json-path.ts"],"names":[],"mappings":";;;AACA,sDAAuD;AAEvD,6CAA0C;AAE1C,kGAAkG;AAClG,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAEnC,MAAM,oBAAoB,GAAG,CAAC,IAAsB,EAAW,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE1F;;;;;GAKG;AACI,MAAM,iBAAiB,GAAG,CAAC,IAAwB,EAAY,EAAE;IACtE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAEtB,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IACpF,IAAI,cAAc,GAAG,wBAAwB,EAAE,CAAC;QAC9C,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE,4EAA4E,wBAAwB,WAAW,cAAc,yDAAyD;SAChM,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,QAAQ,GAAG,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC;YACvC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,GAAG,EAAE,GAAG,OAAO,KAAK,IAAI,GAAG,CAAC,CAAC;YAChF,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,KAAK,IAAI,GAAG,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAnBW,QAAA,iBAAiB,qBAmB5B;AAEF,MAAM,eAAe,GAAG,IAAI,yBAAW,CAAC,eAAe,CAAC,CAAC;AACzD,MAAM,yBAAyB,GAAG,IAAI,yBAAW,CAAC,wBAAwB,CAAC,CAAC;AAE5E;;;;;;;;GAQG;AACI,MAAM,4BAA4B,GAAG,CAAC,IAG5C,EAAc,EAAE;IACf,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAE9B,MAAM,QAAQ,GAAG,IAAA,yBAAiB,EAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACtC,2FAA2F;IAC3F,MAAM,MAAM,GAAe,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC;IAE3F,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,yBAAW,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,yBAAW,CAAC,MAAM,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;IAE7E,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAnBW,QAAA,4BAA4B,gCAmBvC","sourcesContent":["import type { TTableColumns } from '@/relational/core/repositories/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { SQLChunk } from 'drizzle-orm';\nimport { StringChunk } from 'drizzle-orm';\n\n/** Every all-digit component doubles the candidate paths, and filter keys arrive from callers. */\nconst MAX_AMBIGUOUS_COMPONENTS = 4;\n\nconst isAmbiguousComponent = (opts: { part: string }): boolean => /^\\d+$/.test(opts.part);\n\n/**\n * Every path literal a component sequence can mean, array reading first. SQLite cannot\n * express both readings of an all-digit component at once - `$.\"c\"[0]` is an array element,\n * `$.\"c\".\"0\"` an object key, and neither falls back to the other - while Postgres's `#>>\n * '{c,0}'` addresses both. Handing SQLite every candidate is what makes the engines agree.\n */\nexport const toSqliteJsonPaths = (opts: { path: string[] }): string[] => {\n const { path } = opts;\n\n const ambiguousCount = path.filter((part) => isAmbiguousComponent({ part })).length;\n if (ambiguousCount > MAX_AMBIGUOUS_COMPONENTS) {\n throw getError({\n message: `[toSqliteJsonPaths] Ambiguous JSON path components over the limit | max: ${MAX_AMBIGUOUS_COMPONENTS} | got: ${ambiguousCount} | each all-digit component doubles the candidate paths`,\n });\n }\n\n let literals = ['$'];\n\n for (const part of path) {\n literals = isAmbiguousComponent({ part })\n ? literals.flatMap((literal) => [`${literal}[${part}]`, `${literal}.\"${part}\"`])\n : literals.map((literal) => `${literal}.\"${part}\"`);\n }\n\n return literals;\n};\n\nconst EXTRACTION_OPEN = new StringChunk('json_extract(');\nconst COALESCED_EXTRACTION_OPEN = new StringChunk('coalesce(json_extract(');\n\n/**\n * The `json_extract` expression for one JSON-path key, as the chunks of one flat fragment (every\n * nested `SQL` level costs a render pass); a caller may append a chunk before `sql.fromList`. The\n * Drizzle column chunk is qualified or aliased like a plain key. The path literal is raw text, safe\n * only because every component has passed `validateJsonPathComponents`, which admits no quote.\n *\n * Coalescing loses nothing: a container is either an array or an object, so at most one candidate\n * resolves to non-NULL.\n */\nexport const toSqliteJsonExtractionChunks = (opts: {\n column: TTableColumns[string];\n path: string[];\n}): SQLChunk[] => {\n const { column, path } = opts;\n\n const literals = toSqliteJsonPaths({ path });\n const lastIndex = literals.length - 1;\n // json_extract(col, 'L') | coalesce(json_extract(col, 'L0'), ..., json_extract(col, 'Ln'))\n const chunks: SQLChunk[] = [lastIndex === 0 ? EXTRACTION_OPEN : COALESCED_EXTRACTION_OPEN];\n\n for (let index = 0; index < lastIndex; index++) {\n chunks.push(column, new StringChunk(`, '${literals[index]}'), json_extract(`));\n }\n\n const closing = lastIndex === 0 ? ')' : '))';\n chunks.push(column, new StringChunk(`, '${literals[lastIndex]}'${closing}`));\n\n return chunks;\n};\n"]}
@@ -40,7 +40,7 @@ class BaseSearchConnector extends core_1.BaseHelper {
40
40
  notFoundTolerance(opts) {
41
41
  const { method, subject } = opts;
42
42
  return {
43
- when: error => this.isNotFoundError({ error }),
43
+ when: (error) => this.isNotFoundError({ error }),
44
44
  handle: () => {
45
45
  this.logger.for(method).debug('%s not found', subject);
46
46
  internal_1.SearchConnectorInternal.throwNotFoundError({ method, subject });
@@ -51,7 +51,7 @@ class BaseSearchConnector extends core_1.BaseHelper {
51
51
  notFoundFallback(opts) {
52
52
  const { method, message, args, fallback } = opts;
53
53
  return {
54
- when: error => this.isNotFoundError({ error }),
54
+ when: (error) => this.isNotFoundError({ error }),
55
55
  handle: () => {
56
56
  this.logger.for(method).debug(message, ...(args ?? []));
57
57
  return fallback;
@@ -1 +1 @@
1
- {"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../../src/search/core/connector.ts"],"names":[],"mappings":";;;AAEA,sDAAuF;AACvF,yCAAqD;AA8IrD,MAAsB,mBAAoB,SAAQ,iBAAU;IAC1D,YAAY,IAA2C;QACrD,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,EAAE,CAAC;IACnB,CAAC;IAES,cAAc,CAAC,IAA6D;QACpF,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACrC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,IAAA,eAAQ,EAAC,EAAE,OAAO,EAAE,IAAI,MAAM,oCAAoC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,gHAAgH;IACtG,KAAK,CAAC,aAAa,CAAI,IAIhC;QACC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,GAAG,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxC,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,0JAA0J;YAC1J,IAAI,IAAA,yBAAkB,EAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,kCAAuB,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAKD,2IAA2I;IACjI,iBAAiB,CAAC,IAAyC;QAInE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEjC,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAC9C,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;gBACvD,kCAAuB,CAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAClE,CAAC;SACF,CAAC;IACJ,CAAC;IAED,sKAAsK;IAC5J,gBAAgB,CAAI,IAK7B;QACC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEjD,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAC9C,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;gBACxD,OAAO,QAAQ,CAAC;YAClB,CAAC;SACF,CAAC;IACJ,CAAC;CAkBF;AAhGD,kDAgGC","sourcesContent":["import type { ISynonym } from '@/search/core/models';\nimport type { ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError, isApplicationError } from '@venizia/ignis-helpers/core';\nimport { SearchConnectorInternal } from './internal';\n\nexport interface IImportResult<TResponse = unknown> {\n count: { success: number; fail: number };\n responses: TResponse[];\n}\n\nexport interface IAliasInfo {\n name: string;\n collection: string;\n}\n\nexport interface ISearchConnectorCallbacks {\n onInitialized?: (opts: { name: string }) => void;\n onError?: (opts: { name: string; error: unknown }) => void;\n}\n\n/** Search-response envelope, read without a boundary cast. `score` scales are unrelated across engines - never compare or threshold one against another; `isFoundExact` is false when `found` is approximate. */\nexport interface ISearchResult<\n DocumentType extends object = object,\n HighlightType = unknown,\n FacetCountType = unknown,\n GroupedHitType = unknown,\n> {\n found: number;\n isFoundExact: boolean;\n outOf?: number;\n searchTimeMs?: number;\n hits?: Array<{\n document: DocumentType;\n highlight?: HighlightType;\n highlights?: HighlightType[];\n score?: number;\n }>;\n facetCounts?: FacetCountType[];\n groupedHits?: GroupedHitType[];\n}\n\n// Schema/field types are engine-specific, not caller-owned - hence interface-level generics filled by the engine's connector, defaulting to `unknown` so `ISearchConnector` stays engine-agnostic.\nexport interface ISearchCollectionScoped<\n CreateSchema = unknown,\n Schema = unknown,\n FieldSchema = unknown,\n> {\n create(opts: { schema: CreateSchema }): Promise<Schema | void>;\n ensure(opts: { schema: CreateSchema }): Promise<Schema>;\n get(opts: { name: string }): Promise<Schema>;\n list(): Promise<Schema[]>;\n exists(opts: { name: string }): Promise<boolean>;\n patchSchema(opts: { name: string; fields: FieldSchema[] }): Promise<void>;\n delete(opts: { name: string }): Promise<boolean>;\n}\n\n/** A named pointer to one physical collection. Engines without aliases omit this group entirely. */\nexport interface ISearchAliasScoped {\n upsert(opts: { name: string; collection: string }): Promise<void>;\n get(opts: { name: string }): Promise<IAliasInfo | null>;\n}\n\n/** Atomic exchange of two collections' documents and settings - the alias-less path to a zero-downtime reindex. */\nexport interface ISearchSwapScoped {\n indexes(opts: { pairs: Array<[string, string]> }): Promise<void>;\n}\n\n// Synonym SETS (Typesense v30+): a named item set linked to one or more collections; `ISynonym` is the item shape.\nexport interface ISearchSynonymSetScoped {\n upsert(opts: { name: string; items: ISynonym[] }): Promise<void>;\n get(opts: { name: string }): Promise<ISynonym[] | null>;\n list(): Promise<string[]>;\n delete(opts: { name: string }): Promise<boolean>;\n link(opts: { collection: string; synonymSets: string[] }): Promise<void>;\n}\n\n/** A flat per-collection synonym dictionary - no named, linkable set resource. */\nexport interface ISearchSynonymScoped {\n set(opts: { collection: string; items: ISynonym[] }): Promise<void>;\n get(opts: { collection: string }): Promise<ISynonym[]>;\n reset(opts: { collection: string }): Promise<void>;\n}\n\nexport interface ISearchDocumentScoped {\n get<T extends object>(opts: { collection: string; id: string }): Promise<T>;\n\n /** Exact count of documents matching `filterBy`. Engines whose search endpoint caps or estimates its total must answer from a document-listing endpoint instead. */\n count(opts: { collection: string; filterBy?: string }): Promise<number>;\n\n create<T extends object>(opts: { collection: string; document: T }): Promise<T>;\n\n upsert<T extends object>(opts: { collection: string; document: T }): Promise<T>;\n update<T extends object>(opts: {\n collection: string;\n id: string;\n document: Partial<T>;\n }): Promise<T>;\n updateBy<T extends object>(opts: {\n collection: string;\n document: Partial<T>;\n filterBy: string;\n }): Promise<{ updatedCount: number }>;\n\n delete(opts: { collection: string; id: string }): Promise<boolean>;\n deleteBy(opts: { collection: string; filterBy: string }): Promise<number>;\n deleteAll(opts: { collection: string }): Promise<boolean>;\n\n import<T extends object>(opts: {\n collection: string;\n documents: T[];\n batchSize?: number;\n }): Promise<IImportResult<unknown>>;\n export(opts: {\n collection: string;\n filterBy?: string;\n includeFields?: string[];\n }): Promise<string>;\n}\n\n/** The verb contract every search engine implements - an interface so tests can fake it clientless. `collection`/`document` are the true intersection; `alias`/`synonymSet`/`synonyms`/`swap` are optional since no engine has all four, so agnostic callers must write `connector.alias?.…`. */\nexport interface ISearchConnector {\n getHealth(): Promise<{ ok: boolean }>;\n ping(): Promise<boolean>;\n\n collection: ISearchCollectionScoped;\n document: ISearchDocumentScoped;\n\n alias?: ISearchAliasScoped;\n synonymSet?: ISearchSynonymSetScoped;\n synonyms?: ISearchSynonymScoped;\n swap?: ISearchSwapScoped;\n\n search<TDocument extends object = object>(opts: {\n collection: string;\n params: unknown;\n }): Promise<ISearchResult<TDocument>>;\n\n multiSearch(opts: {\n searches: unknown[];\n union?: boolean;\n commonParams?: unknown;\n options?: unknown;\n }): Promise<unknown>;\n}\n\nexport abstract class BaseSearchConnector extends BaseHelper implements ISearchConnector {\n constructor(opts: { scope: string; identifier: string }) {\n super(opts);\n }\n\n async ping(): Promise<boolean> {\n const health = await this.getHealth();\n return health.ok;\n }\n\n protected assertNonEmpty(opts: { value?: string | null; name: string; method: string }): void {\n const { value, name, method } = opts;\n if (!value || value.trim().length === 0) {\n throw getError({ message: `[${method}] Missing or empty value | name: ${name}` });\n }\n }\n\n // Runs the engine verb; tolerated errors route to the caller's branch, everything else becomes a sanitized 503.\n protected async runEngineCall<T>(opts: {\n method: string;\n run: () => ValueOrPromise<T>;\n tolerate?: { when: (error: unknown) => boolean; handle: (error: unknown) => ValueOrPromise<T> };\n }) {\n const { method, run, tolerate } = opts;\n\n try {\n const rs = await run();\n return rs;\n } catch (error) {\n if (tolerate?.when(error)) {\n const rs = await tolerate.handle(error);\n return rs;\n }\n\n // A framework ApplicationError is already sanitized and carries its own statusCode/messageCode; only raw engine failures may be wrapped as a generic 503.\n if (isApplicationError(error)) {\n throw error;\n }\n\n SearchConnectorInternal.wrapDependencyError({ method, error, logger: this.logger });\n }\n }\n\n /** Which errors mean \"not found\" is engine-specific classification; the sanitized throw and the benign fallback are not. */\n protected abstract isNotFoundError(opts: { error: unknown }): boolean;\n\n /** Tolerated-404 branch shared by getCollection/patchCollectionSchema/getDocument/updateDocument: throws the sanitized not-found error. */\n protected notFoundTolerance(opts: { method: string; subject: string }): {\n when: (error: unknown) => boolean;\n handle: (error: unknown) => never;\n } {\n const { method, subject } = opts;\n\n return {\n when: error => this.isNotFoundError({ error }),\n handle: () => {\n this.logger.for(method).debug('%s not found', subject);\n SearchConnectorInternal.throwNotFoundError({ method, subject });\n },\n };\n }\n\n /** Tolerated-404 branch shared by deleteCollection/getAlias/getSynonymSet/deleteSynonymSet/deleteDocument: logs and returns a benign sentinel instead of throwing. */\n protected notFoundFallback<T>(opts: {\n method: string;\n message: string;\n args?: unknown[];\n fallback: T;\n }): { when: (error: unknown) => boolean; handle: (error: unknown) => T } {\n const { method, message, args, fallback } = opts;\n\n return {\n when: error => this.isNotFoundError({ error }),\n handle: () => {\n this.logger.for(method).debug(message, ...(args ?? []));\n return fallback;\n },\n };\n }\n\n abstract getHealth(): Promise<{ ok: boolean }>;\n\n // Resource-scoped verb groups, each supplied by the concrete connector as a facade object; only the intersection is abstract - an engine declares its own alias/synonymSet/synonyms/swap.\n abstract collection: ISearchCollectionScoped;\n abstract document: ISearchDocumentScoped;\n\n abstract search<TDocument extends object = object>(opts: {\n collection: string;\n params: unknown;\n }): Promise<ISearchResult<TDocument>>;\n\n abstract multiSearch(opts: {\n searches: unknown[];\n union?: boolean;\n commonParams?: unknown;\n }): Promise<unknown>;\n}\n"]}
1
+ {"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../../src/search/core/connector.ts"],"names":[],"mappings":";;;AAEA,sDAAuF;AACvF,yCAAqD;AA8IrD,MAAsB,mBAAoB,SAAQ,iBAAU;IAC1D,YAAY,IAA2C;QACrD,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,EAAE,CAAC;IACnB,CAAC;IAES,cAAc,CAAC,IAA6D;QACpF,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACrC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,IAAA,eAAQ,EAAC,EAAE,OAAO,EAAE,IAAI,MAAM,oCAAoC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,gHAAgH;IACtG,KAAK,CAAC,aAAa,CAAI,IAIhC;QACC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,GAAG,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxC,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,0JAA0J;YAC1J,IAAI,IAAA,yBAAkB,EAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,kCAAuB,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAKD,2IAA2I;IACjI,iBAAiB,CAAC,IAAyC;QAInE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEjC,OAAO;YACL,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAChD,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;gBACvD,kCAAuB,CAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAClE,CAAC;SACF,CAAC;IACJ,CAAC;IAED,sKAAsK;IAC5J,gBAAgB,CAAI,IAK7B;QACC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEjD,OAAO;YACL,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAChD,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;gBACxD,OAAO,QAAQ,CAAC;YAClB,CAAC;SACF,CAAC;IACJ,CAAC;CAkBF;AAhGD,kDAgGC","sourcesContent":["import type { ISynonym } from '@/search/core/models';\nimport type { ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError, isApplicationError } from '@venizia/ignis-helpers/core';\nimport { SearchConnectorInternal } from './internal';\n\nexport interface IImportResult<TResponse = unknown> {\n count: { success: number; fail: number };\n responses: TResponse[];\n}\n\nexport interface IAliasInfo {\n name: string;\n collection: string;\n}\n\nexport interface ISearchConnectorCallbacks {\n onInitialized?: (opts: { name: string }) => void;\n onError?: (opts: { name: string; error: unknown }) => void;\n}\n\n/** Search-response envelope, read without a boundary cast. `score` scales are unrelated across engines - never compare or threshold one against another; `isFoundExact` is false when `found` is approximate. */\nexport interface ISearchResult<\n DocumentType extends object = object,\n HighlightType = unknown,\n FacetCountType = unknown,\n GroupedHitType = unknown,\n> {\n found: number;\n isFoundExact: boolean;\n outOf?: number;\n searchTimeMs?: number;\n hits?: Array<{\n document: DocumentType;\n highlight?: HighlightType;\n highlights?: HighlightType[];\n score?: number;\n }>;\n facetCounts?: FacetCountType[];\n groupedHits?: GroupedHitType[];\n}\n\n// Schema/field types are engine-specific, not caller-owned - hence interface-level generics filled by the engine's connector, defaulting to `unknown` so `ISearchConnector` stays engine-agnostic.\nexport interface ISearchCollectionScoped<\n CreateSchema = unknown,\n Schema = unknown,\n FieldSchema = unknown,\n> {\n create(opts: { schema: CreateSchema }): Promise<Schema | void>;\n ensure(opts: { schema: CreateSchema }): Promise<Schema>;\n get(opts: { name: string }): Promise<Schema>;\n list(): Promise<Schema[]>;\n exists(opts: { name: string }): Promise<boolean>;\n patchSchema(opts: { name: string; fields: FieldSchema[] }): Promise<void>;\n delete(opts: { name: string }): Promise<boolean>;\n}\n\n/** A named pointer to one physical collection. Engines without aliases omit this group entirely. */\nexport interface ISearchAliasScoped {\n upsert(opts: { name: string; collection: string }): Promise<void>;\n get(opts: { name: string }): Promise<IAliasInfo | null>;\n}\n\n/** Atomic exchange of two collections' documents and settings - the alias-less path to a zero-downtime reindex. */\nexport interface ISearchSwapScoped {\n indexes(opts: { pairs: Array<[string, string]> }): Promise<void>;\n}\n\n// Synonym SETS (Typesense v30+): a named item set linked to one or more collections; `ISynonym` is the item shape.\nexport interface ISearchSynonymSetScoped {\n upsert(opts: { name: string; items: ISynonym[] }): Promise<void>;\n get(opts: { name: string }): Promise<ISynonym[] | null>;\n list(): Promise<string[]>;\n delete(opts: { name: string }): Promise<boolean>;\n link(opts: { collection: string; synonymSets: string[] }): Promise<void>;\n}\n\n/** A flat per-collection synonym dictionary - no named, linkable set resource. */\nexport interface ISearchSynonymScoped {\n set(opts: { collection: string; items: ISynonym[] }): Promise<void>;\n get(opts: { collection: string }): Promise<ISynonym[]>;\n reset(opts: { collection: string }): Promise<void>;\n}\n\nexport interface ISearchDocumentScoped {\n get<T extends object>(opts: { collection: string; id: string }): Promise<T>;\n\n /** Exact count of documents matching `filterBy`. Engines whose search endpoint caps or estimates its total must answer from a document-listing endpoint instead. */\n count(opts: { collection: string; filterBy?: string }): Promise<number>;\n\n create<T extends object>(opts: { collection: string; document: T }): Promise<T>;\n\n upsert<T extends object>(opts: { collection: string; document: T }): Promise<T>;\n update<T extends object>(opts: {\n collection: string;\n id: string;\n document: Partial<T>;\n }): Promise<T>;\n updateBy<T extends object>(opts: {\n collection: string;\n document: Partial<T>;\n filterBy: string;\n }): Promise<{ updatedCount: number }>;\n\n delete(opts: { collection: string; id: string }): Promise<boolean>;\n deleteBy(opts: { collection: string; filterBy: string }): Promise<number>;\n deleteAll(opts: { collection: string }): Promise<boolean>;\n\n import<T extends object>(opts: {\n collection: string;\n documents: T[];\n batchSize?: number;\n }): Promise<IImportResult<unknown>>;\n export(opts: {\n collection: string;\n filterBy?: string;\n includeFields?: string[];\n }): Promise<string>;\n}\n\n/** The verb contract every search engine implements - an interface so tests can fake it clientless. `collection`/`document` are the true intersection; `alias`/`synonymSet`/`synonyms`/`swap` are optional since no engine has all four, so agnostic callers must write `connector.alias?.…`. */\nexport interface ISearchConnector {\n getHealth(): Promise<{ ok: boolean }>;\n ping(): Promise<boolean>;\n\n collection: ISearchCollectionScoped;\n document: ISearchDocumentScoped;\n\n alias?: ISearchAliasScoped;\n synonymSet?: ISearchSynonymSetScoped;\n synonyms?: ISearchSynonymScoped;\n swap?: ISearchSwapScoped;\n\n search<TDocument extends object = object>(opts: {\n collection: string;\n params: unknown;\n }): Promise<ISearchResult<TDocument>>;\n\n multiSearch(opts: {\n searches: unknown[];\n union?: boolean;\n commonParams?: unknown;\n options?: unknown;\n }): Promise<unknown>;\n}\n\nexport abstract class BaseSearchConnector extends BaseHelper implements ISearchConnector {\n constructor(opts: { scope: string; identifier: string }) {\n super(opts);\n }\n\n async ping(): Promise<boolean> {\n const health = await this.getHealth();\n return health.ok;\n }\n\n protected assertNonEmpty(opts: { value?: string | null; name: string; method: string }): void {\n const { value, name, method } = opts;\n if (!value || value.trim().length === 0) {\n throw getError({ message: `[${method}] Missing or empty value | name: ${name}` });\n }\n }\n\n // Runs the engine verb; tolerated errors route to the caller's branch, everything else becomes a sanitized 503.\n protected async runEngineCall<T>(opts: {\n method: string;\n run: () => ValueOrPromise<T>;\n tolerate?: { when: (error: unknown) => boolean; handle: (error: unknown) => ValueOrPromise<T> };\n }) {\n const { method, run, tolerate } = opts;\n\n try {\n const rs = await run();\n return rs;\n } catch (error) {\n if (tolerate?.when(error)) {\n const rs = await tolerate.handle(error);\n return rs;\n }\n\n // A framework ApplicationError is already sanitized and carries its own statusCode/messageCode; only raw engine failures may be wrapped as a generic 503.\n if (isApplicationError(error)) {\n throw error;\n }\n\n SearchConnectorInternal.wrapDependencyError({ method, error, logger: this.logger });\n }\n }\n\n /** Which errors mean \"not found\" is engine-specific classification; the sanitized throw and the benign fallback are not. */\n protected abstract isNotFoundError(opts: { error: unknown }): boolean;\n\n /** Tolerated-404 branch shared by getCollection/patchCollectionSchema/getDocument/updateDocument: throws the sanitized not-found error. */\n protected notFoundTolerance(opts: { method: string; subject: string }): {\n when: (error: unknown) => boolean;\n handle: (error: unknown) => never;\n } {\n const { method, subject } = opts;\n\n return {\n when: (error) => this.isNotFoundError({ error }),\n handle: () => {\n this.logger.for(method).debug('%s not found', subject);\n SearchConnectorInternal.throwNotFoundError({ method, subject });\n },\n };\n }\n\n /** Tolerated-404 branch shared by deleteCollection/getAlias/getSynonymSet/deleteSynonymSet/deleteDocument: logs and returns a benign sentinel instead of throwing. */\n protected notFoundFallback<T>(opts: {\n method: string;\n message: string;\n args?: unknown[];\n fallback: T;\n }): { when: (error: unknown) => boolean; handle: (error: unknown) => T } {\n const { method, message, args, fallback } = opts;\n\n return {\n when: (error) => this.isNotFoundError({ error }),\n handle: () => {\n this.logger.for(method).debug(message, ...(args ?? []));\n return fallback;\n },\n };\n }\n\n abstract getHealth(): Promise<{ ok: boolean }>;\n\n // Resource-scoped verb groups, each supplied by the concrete connector as a facade object; only the intersection is abstract - an engine declares its own alias/synonymSet/synonyms/swap.\n abstract collection: ISearchCollectionScoped;\n abstract document: ISearchDocumentScoped;\n\n abstract search<TDocument extends object = object>(opts: {\n collection: string;\n params: unknown;\n }): Promise<ISearchResult<TDocument>>;\n\n abstract multiSearch(opts: {\n searches: unknown[];\n union?: boolean;\n commonParams?: unknown;\n }): Promise<unknown>;\n}\n"]}
@@ -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';
8
+ import type { TSearchScopeResolver } from './scope';
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"}
@@ -2,8 +2,10 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.AbstractSearchController = void 0;
4
4
  const ignis_kernel_1 = require("@venizia/ignis-kernel");
5
+ const core_1 = require("@venizia/ignis-helpers/core");
5
6
  const common_1 = require("@venizia/ignis-helpers/common");
6
7
  const common_2 = require("../repositories/common");
8
+ const scope_1 = require("./scope");
7
9
  /** 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. */
8
10
  const resolveSearchStart = (opts) => {
9
11
  const { input, hitCount } = opts;
@@ -29,12 +31,16 @@ class AbstractSearchController extends ignis_kernel_1.BaseRestController {
29
31
  constructor(opts) {
30
32
  super({ scope: opts.scope, path: opts.path, isStrict: opts.isStrict });
31
33
  this.repository = opts.repository;
34
+ this.searchScope = opts.searchScope;
32
35
  this.definitions = opts.definitions;
33
36
  }
34
37
  /** 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". */
35
38
  async search(opts) {
36
39
  const { context } = opts;
37
- const input = context.req.valid('json');
40
+ const body = context.req.valid('json');
41
+ const input = this.searchScope
42
+ ? await (0, scope_1.applySearchScope)({ resolve: this.searchScope, context, input: body })
43
+ : body;
38
44
  const rs = await this.measure({
39
45
  scope: 'search',
40
46
  args: input,
@@ -55,6 +61,14 @@ class AbstractSearchController extends ignis_kernel_1.BaseRestController {
55
61
  /** POST /multi-search - cross-collection search, forwarded verbatim to the engine. */
56
62
  async multiSearch(opts) {
57
63
  const { context } = opts;
64
+ // A multi-search entry carries the engine's own `filterBy` string, which a `where` scope cannot
65
+ // be ANDed into: a scoped controller does not serve it.
66
+ if (this.searchScope) {
67
+ throw (0, core_1.getError)({
68
+ statusCode: common_1.HTTP.ResultCodes.RS_4.BadRequest,
69
+ message: '[multiSearch] multi-search is not available on a scoped search controller',
70
+ });
71
+ }
58
72
  const input = context.req.valid('json');
59
73
  const rs = await this.measure({
60
74
  scope: 'multiSearch',