@venizia/ignis-connectors 0.4.8-15 → 0.4.8-17

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 (130) hide show
  1. package/README.md +22 -0
  2. package/dist/esm/common/driver-data-source.d.ts +3 -3
  3. package/dist/esm/common/driver-data-source.js +12 -8
  4. package/dist/esm/common/driver-data-source.js.map +1 -1
  5. package/dist/esm/common/internal/duck-typing.d.ts +15 -0
  6. package/dist/esm/common/internal/duck-typing.js +28 -0
  7. package/dist/esm/common/internal/duck-typing.js.map +1 -0
  8. package/dist/esm/common/internal/index.d.ts +1 -0
  9. package/dist/esm/common/internal/index.js +1 -0
  10. package/dist/esm/common/internal/index.js.map +1 -1
  11. package/dist/esm/http/repository.d.ts +3 -4
  12. package/dist/esm/http/repository.js.map +1 -1
  13. package/dist/esm/raw-sql/repository.d.ts +2 -3
  14. package/dist/esm/raw-sql/repository.js.map +1 -1
  15. package/dist/esm/relational/core/repositories/common/executor.d.ts +1 -1
  16. package/dist/esm/relational/core/repositories/common/executor.js.map +1 -1
  17. package/dist/esm/relational/core/repositories/common/scope-filter.d.ts +2 -2
  18. package/dist/esm/relational/core/repositories/common/scope-filter.js.map +1 -1
  19. package/dist/esm/relational/core/repositories/common/types.d.ts +6 -3
  20. package/dist/esm/relational/core/repositories/common/types.js.map +1 -1
  21. package/dist/esm/relational/core/repositories/core/base.d.ts +4 -3
  22. package/dist/esm/relational/core/repositories/core/base.js.map +1 -1
  23. package/dist/esm/relational/core/repositories/core/persistable.d.ts +4 -3
  24. package/dist/esm/relational/core/repositories/core/persistable.js +1 -1
  25. package/dist/esm/relational/core/repositories/core/persistable.js.map +1 -1
  26. package/dist/esm/relational/core/repositories/core/soft-deletable.js +18 -1
  27. package/dist/esm/relational/core/repositories/core/soft-deletable.js.map +1 -1
  28. package/dist/esm/relational/core/repositories/dialect/filter.d.ts +16 -12
  29. package/dist/esm/relational/core/repositories/dialect/filter.js +30 -17
  30. package/dist/esm/relational/core/repositories/dialect/filter.js.map +1 -1
  31. package/dist/esm/relational/core/repositories/dialect/internal/subquery.d.ts +2 -3
  32. package/dist/esm/relational/core/repositories/dialect/internal/subquery.js.map +1 -1
  33. package/dist/esm/relational/core/repositories/dialect/query-operators.js +5 -3
  34. package/dist/esm/relational/core/repositories/dialect/query-operators.js.map +1 -1
  35. package/dist/esm/relational/core/repositories/dialect/update.d.ts +3 -3
  36. package/dist/esm/relational/core/repositories/dialect/update.js +2 -2
  37. package/dist/esm/relational/core/repositories/dialect/update.js.map +1 -1
  38. package/dist/esm/relational/postgres/drivers/node-postgres.js +5 -2
  39. package/dist/esm/relational/postgres/drivers/node-postgres.js.map +1 -1
  40. package/dist/esm/relational/postgres/drivers/pglite.js +5 -3
  41. package/dist/esm/relational/postgres/drivers/pglite.js.map +1 -1
  42. package/dist/esm/relational/postgres/drivers/postgres-js.js +2 -3
  43. package/dist/esm/relational/postgres/drivers/postgres-js.js.map +1 -1
  44. package/dist/esm/relational/postgres/models/common/types/enrichers.d.ts +4 -1
  45. package/dist/esm/relational/postgres/models/common/types/enrichers.js.map +1 -1
  46. package/dist/esm/relational/postgres/models/enrichers/data-type.enricher.d.ts +3 -2
  47. package/dist/esm/relational/postgres/models/enrichers/data-type.enricher.js.map +1 -1
  48. package/dist/esm/relational/postgres/repositories/dialect/filter.d.ts +1 -1
  49. package/dist/esm/relational/postgres/repositories/dialect/filter.js +3 -2
  50. package/dist/esm/relational/postgres/repositories/dialect/filter.js.map +1 -1
  51. package/dist/esm/relational/postgres/repositories/dialect/query.d.ts +28 -27
  52. package/dist/esm/relational/postgres/repositories/dialect/query.js +4 -3
  53. package/dist/esm/relational/postgres/repositories/dialect/query.js.map +1 -1
  54. package/dist/esm/relational/postgres/repositories/dialect/update.d.ts +1 -1
  55. package/dist/esm/relational/postgres/repositories/dialect/update.js.map +1 -1
  56. package/dist/esm/relational/postgres/repositories/executor.d.ts +6 -0
  57. package/dist/esm/relational/postgres/repositories/executor.js +31 -11
  58. package/dist/esm/relational/postgres/repositories/executor.js.map +1 -1
  59. package/dist/esm/relational/sqlite/drivers/driver.d.ts +1 -2
  60. package/dist/esm/relational/sqlite/drivers/driver.js.map +1 -1
  61. package/dist/esm/relational/sqlite/drivers/libsql.js +10 -4
  62. package/dist/esm/relational/sqlite/drivers/libsql.js.map +1 -1
  63. package/dist/esm/relational/sqlite/models/common/types/enrichers.d.ts +4 -1
  64. package/dist/esm/relational/sqlite/models/common/types/enrichers.js.map +1 -1
  65. package/dist/esm/relational/sqlite/models/enrichers/data-type.enricher.d.ts +3 -2
  66. package/dist/esm/relational/sqlite/models/enrichers/data-type.enricher.js +1 -3
  67. package/dist/esm/relational/sqlite/models/enrichers/data-type.enricher.js.map +1 -1
  68. package/dist/esm/relational/sqlite/repositories/dialect/filter.d.ts +1 -1
  69. package/dist/esm/relational/sqlite/repositories/dialect/filter.js +3 -2
  70. package/dist/esm/relational/sqlite/repositories/dialect/filter.js.map +1 -1
  71. package/dist/esm/relational/sqlite/repositories/dialect/query.js +3 -3
  72. package/dist/esm/relational/sqlite/repositories/dialect/query.js.map +1 -1
  73. package/dist/esm/relational/sqlite/repositories/dialect/update.d.ts +2 -2
  74. package/dist/esm/relational/sqlite/repositories/dialect/update.js.map +1 -1
  75. package/dist/esm/relational/sqlite/repositories/executor.d.ts +6 -0
  76. package/dist/esm/relational/sqlite/repositories/executor.js +32 -15
  77. package/dist/esm/relational/sqlite/repositories/executor.js.map +1 -1
  78. package/dist/esm/search/core/controllers/abstract.d.ts +22 -9
  79. package/dist/esm/search/core/controllers/abstract.js +43 -9
  80. package/dist/esm/search/core/controllers/abstract.js.map +1 -1
  81. package/dist/esm/search/core/controllers/engine-params.d.ts +10 -1
  82. package/dist/esm/search/core/controllers/engine-params.js +18 -4
  83. package/dist/esm/search/core/controllers/engine-params.js.map +1 -1
  84. package/dist/esm/search/core/controllers/factory.d.ts +240 -37
  85. package/dist/esm/search/core/controllers/factory.js +72 -35
  86. package/dist/esm/search/core/controllers/factory.js.map +1 -1
  87. package/dist/esm/search/core/controllers/index.d.ts +4 -0
  88. package/dist/esm/search/core/controllers/index.js +4 -0
  89. package/dist/esm/search/core/controllers/index.js.map +1 -1
  90. package/dist/esm/search/core/controllers/options.d.ts +78 -0
  91. package/dist/esm/search/core/controllers/options.js +214 -0
  92. package/dist/esm/search/core/controllers/options.js.map +1 -0
  93. package/dist/esm/search/core/controllers/raw-access.d.ts +3 -3
  94. package/dist/esm/search/core/controllers/raw-access.js +7 -13
  95. package/dist/esm/search/core/controllers/raw-access.js.map +1 -1
  96. package/dist/esm/search/core/controllers/response.d.ts +46 -0
  97. package/dist/esm/search/core/controllers/response.js +65 -0
  98. package/dist/esm/search/core/controllers/response.js.map +1 -0
  99. package/dist/esm/search/core/controllers/scope.d.ts +8 -5
  100. package/dist/esm/search/core/controllers/scope.js +2 -2
  101. package/dist/esm/search/core/controllers/scope.js.map +1 -1
  102. package/dist/esm/search/core/controllers/settings.d.ts +140 -0
  103. package/dist/esm/search/core/controllers/settings.js +484 -0
  104. package/dist/esm/search/core/controllers/settings.js.map +1 -0
  105. package/dist/esm/search/core/controllers/toggles.d.ts +13 -0
  106. package/dist/esm/search/core/controllers/toggles.js +22 -0
  107. package/dist/esm/search/core/controllers/toggles.js.map +1 -0
  108. package/dist/esm/search/core/controllers/types.d.ts +88 -0
  109. package/dist/esm/search/core/controllers/types.js +2 -0
  110. package/dist/esm/search/core/controllers/types.js.map +1 -0
  111. package/dist/esm/search/core/datasources/abstract.d.ts +2 -0
  112. package/dist/esm/search/core/datasources/abstract.js.map +1 -1
  113. package/dist/esm/search/core/models/common/constants.d.ts +2 -0
  114. package/dist/esm/search/core/models/common/constants.js +4 -0
  115. package/dist/esm/search/core/models/common/constants.js.map +1 -1
  116. package/dist/esm/search/core/models/define-search-collection.js +1 -2
  117. package/dist/esm/search/core/models/define-search-collection.js.map +1 -1
  118. package/dist/esm/search/meilisearch/common/types.d.ts +9 -3
  119. package/dist/esm/search/meilisearch/common/types.js.map +1 -1
  120. package/dist/esm/search/meilisearch/connector.js.map +1 -1
  121. package/dist/esm/search/meilisearch/internal/connector-internal.d.ts +1 -1
  122. package/dist/esm/search/meilisearch/internal/connector-internal.js +0 -1
  123. package/dist/esm/search/meilisearch/internal/connector-internal.js.map +1 -1
  124. package/dist/esm/search/typesense/connector.js +1 -1
  125. package/dist/esm/search/typesense/connector.js.map +1 -1
  126. package/dist/esm/search/typesense/datasources/datasource.d.ts +2 -0
  127. package/dist/esm/search/typesense/datasources/datasource.js.map +1 -1
  128. package/dist/esm/search/typesense/internal/connector-internal.d.ts +1 -1
  129. package/dist/esm/search/typesense/internal/connector-internal.js.map +1 -1
  130. package/package.json +6 -6
package/README.md CHANGED
@@ -129,6 +129,28 @@ styles can live in one application.
129
129
  The root entry imports no driver and no engine client. A driver loads only when you import its
130
130
  entry and name its class in `@datasource({ driver })`.
131
131
 
132
+ ### Search controllers
133
+
134
+ `SearchControllerFactory.build` generates `POST /search` and `POST /multi-search`. It needs `authenticate`
135
+ (a config with no strategy and no `skip` throws when the controller is built), and each route you list is a
136
+ toggle:
137
+
138
+ ```typescript
139
+ import { Authentication } from '@venizia/ignis-kernel';
140
+ import { SearchControllerFactory } from '@venizia/ignis-connectors/typesense/controllers';
141
+
142
+ const BaseSearchController = SearchControllerFactory.build({
143
+ repository: ArticleRepository,
144
+ authenticate: { strategies: [Authentication.STRATEGY_JWT] }, // or { skip: true } to open the routes
145
+ routes: { search: { use: true } }, // a route that is absent or { use: false } is not served
146
+ query: { fixed: { queryBy: ['title'] }, allow: { tuning: ['typoTokensThreshold'] } },
147
+ });
148
+ ```
149
+
150
+ `modes: { raw: { use: true } }` serves `mode: 'raw'` and multi-search over HTTP. `query` sets what the server
151
+ decides for a query, and `response` reshapes the hits. See the
152
+ [Typesense guide](https://ignis.venizia.ai/guides/core-concepts/persistent/search-typesense) for each option.
153
+
132
154
  ## Where it sits
133
155
 
134
156
  Depends on `@venizia/ignis-kernel`, `@venizia/ignis-filter`, `@venizia/ignis-helpers` and
@@ -1,6 +1,6 @@
1
1
  import type { IDataSourceOpening, TAnyDataSourceSchema } from '@venizia/ignis-kernel';
2
2
  import { AbstractDataSource } from '@venizia/ignis-kernel/repository';
3
- import type { AnyObject, AnyType, TClass } from '@venizia/ignis-helpers/common';
3
+ import type { TClass } from '@venizia/ignis-helpers/common';
4
4
  import type { IConnectorDriver } from './driver.js';
5
5
  /**
6
6
  * A datasource that holds one client and a connector built over it through a driver: the lifecycle
@@ -13,7 +13,7 @@ import type { IConnectorDriver } from './driver.js';
13
13
  * `mapSecretToSettings` is a driver-config convention, not Postgres SQL, so it belongs on this
14
14
  * neutral base - do not move it down into a family.
15
15
  */
16
- export declare abstract class AbstractDriverDataSource<Settings extends object = {}, Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, ConfigurableOptions extends object = {}, Client = unknown, TConnector = unknown, TDriver extends IConnectorDriver<TConnector, AnyType> = IConnectorDriver<TConnector, Client>> extends AbstractDataSource<Settings, Schema, ConfigurableOptions> {
16
+ export declare abstract class AbstractDriverDataSource<Settings extends object = {}, Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, ConfigurableOptions extends object = {}, Client = unknown, TConnector = unknown, TDriver extends IConnectorDriver<TConnector, unknown> = IConnectorDriver<TConnector, Client>> extends AbstractDataSource<Settings, Schema, ConfigurableOptions> {
17
17
  connector?: TConnector;
18
18
  protected client?: Client;
19
19
  protected driver?: TDriver;
@@ -81,6 +81,6 @@ export declare abstract class AbstractDriverDataSource<Settings extends object =
81
81
  /** Vault's database engine returns `{ username, password }`; pg expects `{ user, password }`. */
82
82
  protected mapSecretToSettings(opts: {
83
83
  secret: Record<string, string>;
84
- }): AnyObject;
84
+ }): Record<string, unknown>;
85
85
  }
86
86
  //# sourceMappingURL=driver-data-source.d.ts.map
@@ -1,6 +1,7 @@
1
1
  import { AbstractDataSource } from '@venizia/ignis-kernel/repository';
2
2
  import { MetadataRegistry } from '@venizia/ignis-kernel/metadata';
3
3
  import { getError } from '@venizia/ignis-helpers/core';
4
+ import { DuckTypingUtility } from './internal/index.js';
4
5
  /**
5
6
  * A datasource that holds one client and a connector built over it through a driver: the lifecycle
6
7
  * every connector family that talks to an external engine shares - wiring the driver named by
@@ -32,7 +33,9 @@ export class AbstractDriverDataSource extends AbstractDataSource {
32
33
  });
33
34
  }
34
35
  const DriverClass = this.resolveDriverClass();
35
- return this.useDriver({ driver: new DriverClass({ client: this.client }) });
36
+ // `TClass` takes `never[]`, so any driver constructor fits; Reflect.construct passes the client through.
37
+ const driver = Reflect.construct(DriverClass, [{ client: this.client }]);
38
+ return this.useDriver({ driver });
36
39
  }
37
40
  /**
38
41
  * Rejects a driver-name string from untyped JS
@@ -213,7 +216,7 @@ export class AbstractDriverDataSource extends AbstractDataSource {
213
216
  let newConnector;
214
217
  try {
215
218
  const DriverClass = this.resolveDriverClass();
216
- newDriver = new DriverClass({ client: newClient });
219
+ newDriver = Reflect.construct(DriverClass, [{ client: newClient }]);
217
220
  newConnector = newDriver.createConnector({ schema: this.getSchema() });
218
221
  }
219
222
  catch (error) {
@@ -234,10 +237,10 @@ export class AbstractDriverDataSource extends AbstractDataSource {
234
237
  }
235
238
  /** Puts `settings` back to the snapshot: a key the failed rotation added (the rotated `password`) is removed, not left behind. */
236
239
  restoreSettings(opts) {
237
- const settings = this.settings;
240
+ const { settings } = this;
238
241
  for (const key of Object.keys(settings)) {
239
242
  if (!(key in opts.saved)) {
240
- delete settings[key];
243
+ Reflect.deleteProperty(settings, key);
241
244
  }
242
245
  }
243
246
  Object.assign(settings, opts.saved);
@@ -249,15 +252,16 @@ export class AbstractDriverDataSource extends AbstractDataSource {
249
252
  * client left undrained keeps a WASM instance or file handle alive forever.
250
253
  */
251
254
  async drainClient(opts) {
252
- const client = opts.client;
253
- const drain = typeof client?.end === 'function' ? client.end : client?.close;
254
- if (typeof drain !== 'function') {
255
+ const { client } = opts;
256
+ const drain = DuckTypingUtility.getMethod({ value: client, name: 'end' }) ??
257
+ DuckTypingUtility.getMethod({ value: client, name: 'close' });
258
+ if (!drain) {
255
259
  this.logger
256
260
  .for(this.drainClient.name)
257
261
  .warn('Client exposes neither end() nor close(); nothing to drain');
258
262
  return false;
259
263
  }
260
- await drain.call(client);
264
+ await drain();
261
265
  return true;
262
266
  }
263
267
  /** Vault's database engine returns `{ username, password }`; pg expects `{ user, password }`. */
@@ -1 +1 @@
1
- {"version":3,"file":"driver-data-source.js","sourceRoot":"","sources":["../../../src/common/driver-data-source.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IDataSourceOpening, TAnyDataSourceSchema } from '@venizia/ignis-kernel';\nimport { AbstractDataSource } from '@venizia/ignis-kernel/repository';\nimport { MetadataRegistry } from '@venizia/ignis-kernel/metadata';\nimport type { AnyObject, AnyType, TClass } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { IConnectorDriver } from './driver';\n\n/**\n * A datasource that holds one client and a connector built over it through a driver: the lifecycle\n * every connector family that talks to an external engine shares - wiring the driver named by\n * `@datasource({ driver })`, closing once, soft-evicting the client after a secret rotation, draining\n * a client by whichever verb its engine spells it with. No SQL members: the relational family adds\n * its dialect, executor and transactions in `AbstractRelationalDataSource`, a raw-SQL engine adds\n * nothing (`BaseRawSqlDataSource`). Transactions stay NotSupported, as in `AbstractDataSource`.\n *\n * `mapSecretToSettings` is a driver-config convention, not Postgres SQL, so it belongs on this\n * neutral base - do not move it down into a family.\n */\nexport abstract class AbstractDriverDataSource<\n Settings extends object = {},\n Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema,\n ConfigurableOptions extends object = {},\n Client = unknown,\n TConnector = unknown,\n TDriver extends IConnectorDriver<TConnector, AnyType> = IConnectorDriver<TConnector, Client>,\n> extends AbstractDataSource<Settings, Schema, ConfigurableOptions> {\n connector?: TConnector;\n\n protected client?: Client;\n protected driver?: TDriver;\n\n private closePromise?: Promise<void>;\n\n /**\n * Lazy and idempotent: builds the driver named by `@datasource({ driver })` over the client\n * `configure()` assigned, then the connector from it. Returns the connector.\n */\n protected wireDriverFromMetadata(): TConnector {\n if (this.connector) {\n return this.connector;\n }\n\n if (this.driver) {\n const connector = this.driver.createConnector({ schema: this.getSchema() });\n this.connector = connector;\n\n return connector;\n }\n\n if (!this.client) {\n throw getError({\n message: `[${this.constructor.name}][wireDriverFromMetadata] No driver and no client | Assign this.client in configure(), or wire a custom driver with useDriver()`,\n });\n }\n\n const DriverClass = this.resolveDriverClass();\n\n return this.useDriver({ driver: new DriverClass({ client: this.client }) });\n }\n\n /**\n * Rejects a driver-name string from untyped JS\n * callers: a string carries no module into the bundle.\n */\n protected resolveDriverClass(): TClass<TDriver> {\n const metadata = MetadataRegistry.getInstance().getDataSourceMetadata({\n target: this.constructor,\n });\n const driver = metadata?.driver;\n\n if (typeof driver !== 'function') {\n throw getError({\n message: `[${this.constructor.name}][resolveDriverClass] @datasource({ driver }) must name a driver CLASS | Got: ${String(driver)} | Use \\`@datasource({ driver: NodePostgresDriver })\\` with \\`import { NodePostgresDriver } from '@venizia/ignis-connectors/postgres/node-postgres'\\`, or wire a custom driver with useDriver()`,\n });\n }\n\n return driver as TClass<TDriver>;\n }\n\n protected resolveDriver(): TDriver {\n this.wireDriverFromMetadata();\n\n return this.driver as TDriver;\n }\n\n /**\n * Assigns `this.driver` AND builds `this.connector` in one step - a\n * driver without its connector is silently bypassed on pooled queries. Returns the connector.\n */\n protected useDriver(opts: { driver: TDriver; schema?: Schema }): TConnector {\n this.driver = opts.driver;\n const connector = opts.driver.createConnector({ schema: opts.schema ?? this.getSchema() });\n this.connector = connector;\n\n return connector;\n }\n\n /** A datasource that opens on first use has no client, driver or connector until the first call that needs it has awaited `ensureOpen()`. */\n private assertOpenForSyncUse(opts: { member: string }): void {\n if (!this.isOpenDeferred()) {\n return;\n }\n\n if (this.isClosed()) {\n throw getError({\n message: `[${this.constructor.name}][${opts.member}] The datasource is closed | It opens on first use only before close()`,\n });\n }\n\n if (this.isOpening()) {\n throw getError({\n message: `[${this.constructor.name}][${opts.member}] The datasource is still opening | Inside configure() use the opening argument (opening.${opts.member}()); outside it, await ensureOpen()`,\n });\n }\n\n if (!this.isOpen()) {\n throw getError({\n message: `[${this.constructor.name}][${opts.member}] The datasource opens on first use and is not open | Await ensureOpen() first; repository calls do it for you`,\n });\n }\n }\n\n /** The handles `configure()` is given: the connector and the client through the ungated internals, so its own database work (migrations, seeding) needs no gate. */\n protected override createOpening(): IDataSourceOpening<TConnector, Client> {\n return {\n ...super.createOpening(),\n getConnector: () => this.wireDriverFromMetadata(),\n getClient: () => this.readClient(),\n };\n }\n\n /** Wires the driver on first use, so a `configure()` that only builds `this.client` is enough. */\n getConnector(): TConnector {\n this.assertOpenForSyncUse({ member: this.getConnector.name });\n\n return this.wireDriverFromMetadata();\n }\n\n /**\n * Raw driver client (`pg.Pool` / `Sql`). Throws rather\n * than handing back an `undefined` typed as `Client`.\n */\n getClient(): Client {\n this.assertOpenForSyncUse({ member: this.getClient.name });\n\n return this.readClient();\n }\n\n private readClient(): Client {\n if (this.driver) {\n return this.driver.getClient() as Client;\n }\n\n if (!this.client) {\n throw getError({\n message: `[${this.constructor.name}][getClient] No driver and no client | Assign this.driver in configure()`,\n });\n }\n\n return this.client;\n }\n\n /**\n * Ends the connection `configure()` opened. Runs once: every later call returns the first call's\n * promise. Goes through the driver, wired now if nothing queried yet, because its `end()` is the\n * engine's whole teardown - PGlite also clears the exit status it plants on the host process.\n */\n override close(): Promise<void> {\n // A stop that arrives while the first use is still opening waits for that open, then closes what it built.\n this.closePromise ??= this.settleOpening().then(() => this.endConnection());\n\n return this.closePromise;\n }\n\n /** Ends a client that a failed open left half-built and forgets the driver and connector, so the next open starts from nothing. */\n protected override async discardPartialOpen(): Promise<void> {\n const { client, driver } = this;\n\n this.client = undefined;\n this.driver = undefined;\n this.connector = undefined;\n\n // A close() that is waiting for this open owns the slot: clearing it would let a second close end the connection twice.\n if (!this.isClosed()) {\n this.closePromise = undefined;\n }\n\n if (driver && typeof driver.end === 'function') {\n await driver.end();\n\n return;\n }\n\n if (client !== undefined) {\n await this.drainClient({ client });\n }\n }\n\n private async endConnection(): Promise<void> {\n if (!this.driver && this.client === undefined) {\n return;\n }\n\n let driver: TDriver;\n\n try {\n driver = this.resolveDriver();\n } catch (error) {\n this.logger\n .for(this.close.name)\n .warn('No driver to end the connection with | draining the client | error: %s', error);\n await this.drainClient({ client: this.client });\n\n return;\n }\n\n // A hand-made driver cast past `IConnectorDriver` can lack the `end()` its type promises.\n if (typeof driver.end !== 'function') {\n this.logger.for(this.close.name).warn('The driver has no end() | draining the client');\n await this.drainClient({ client: this.client });\n\n return;\n }\n\n await driver.end();\n }\n\n /**\n * Soft-evicts the pool after a secret rotation: rebuilds against the rotated credentials without\n * touching live fields, swaps atomically, then drains the old pool. On failure live state is\n * restored, any half-built pool drained, and the error rethrown.\n */\n async onSecretRotated(opts: { key: string; secret: Record<string, string> }): Promise<void> {\n const logger = this.logger.for(this.onSecretRotated.name);\n\n // Nothing is open yet, so there is no pool to swap: the rotated credentials wait in the settings for the first use.\n if (this.isOpenDeferred() && !this.isOpen()) {\n Object.assign(this.settings, this.mapSecretToSettings({ secret: opts.secret }));\n logger.info(\n 'Datasource not open yet; credentials kept for its first use | key: %s',\n opts.key,\n );\n\n return;\n }\n\n const oldClient = this.getClient() as AnyType;\n\n // Snapshot so a failed rebuild restores the datasource verbatim;\n // `settings` is copied because rotation mutates it in place.\n const savedClient = this.client;\n const savedSettings = { ...(this.settings as AnyObject) };\n\n // Rotation only takes effect through this.settings + configure(); a configure() that\n // hard-codes its connection string or reads the environment directly rebuilds with stale credentials.\n Object.assign(this.settings as AnyObject, this.mapSecretToSettings({ secret: opts.secret }));\n\n // configure() overwrites this.client, so the new pool is captured\n // into a local and the old client restored at once - live fields\n // are never nulled and the old pool keeps serving until the swap.\n let newClient: Client;\n\n try {\n await this.configure();\n newClient = this.client as Client;\n } catch (error) {\n const halfBuilt = this.client as AnyType;\n this.client = savedClient;\n this.restoreSettings({ saved: savedSettings });\n\n if (halfBuilt && halfBuilt !== savedClient) {\n await this.drainClient({ client: halfBuilt });\n }\n\n logger.error('Secret rotation failed in configure(); kept old pool | key: %s', opts.key);\n throw error;\n }\n\n this.client = savedClient;\n\n // Wired into locals: live state must stay on the old pool until the swap below.\n let newDriver: TDriver;\n let newConnector: TConnector;\n\n try {\n const DriverClass = this.resolveDriverClass();\n newDriver = new DriverClass({ client: newClient as AnyType });\n newConnector = newDriver.createConnector({ schema: this.getSchema() });\n } catch (error) {\n this.restoreSettings({ saved: savedSettings });\n await this.drainClient({ client: newClient });\n\n logger.error('Secret rotation failed while wiring driver; kept old pool | key: %s', opts.key);\n throw error;\n }\n\n // Commit the live fields in one synchronous step so there is no null window,\n // then soft-evict the old pool so its in-flight transactions can finish.\n this.client = newClient as AnyType;\n this.driver = newDriver;\n this.connector = newConnector as AnyType;\n\n const isDrained = await this.drainClient({ client: oldClient });\n\n if (isDrained) {\n logger.info('Old pool drained after secret rotation | key: %s', opts.key);\n }\n }\n\n /** Puts `settings` back to the snapshot: a key the failed rotation added (the rotated `password`) is removed, not left behind. */\n private restoreSettings(opts: { saved: AnyObject }): void {\n const settings = this.settings as AnyObject;\n\n for (const key of Object.keys(settings)) {\n if (!(key in opts.saved)) {\n delete settings[key];\n }\n }\n\n Object.assign(settings, opts.saved);\n }\n\n /**\n * Shuts a client down by whichever verb its engine spells it with -\n * `pg.Pool` and postgres.js have `end()`, PGlite and libsql only `close()`.\n * Probed rather than type-tested: this tier must not name an engine, and a\n * client left undrained keeps a WASM instance or file handle alive forever.\n */\n protected async drainClient(opts: { client: unknown }): Promise<boolean> {\n const client = opts.client as AnyType;\n\n const drain = typeof client?.end === 'function' ? client.end : client?.close;\n\n if (typeof drain !== 'function') {\n this.logger\n .for(this.drainClient.name)\n .warn('Client exposes neither end() nor close(); nothing to drain');\n\n return false;\n }\n\n await drain.call(client);\n\n return true;\n }\n\n /** Vault's database engine returns `{ username, password }`; pg expects `{ user, password }`. */\n protected mapSecretToSettings(opts: { secret: Record<string, string> }): AnyObject {\n const { username, password } = opts.secret;\n const mapped: AnyObject = {};\n\n if (username !== undefined) {\n mapped.user = username;\n }\n\n if (password !== undefined) {\n mapped.password = password;\n }\n\n return mapped;\n }\n}\n"]}
1
+ {"version":3,"file":"driver-data-source.js","sourceRoot":"","sources":["../../../src/common/driver-data-source.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IDataSourceOpening, TAnyDataSourceSchema } from '@venizia/ignis-kernel';\nimport { AbstractDataSource } from '@venizia/ignis-kernel/repository';\nimport { MetadataRegistry } from '@venizia/ignis-kernel/metadata';\nimport type { TClass } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { IConnectorDriver } from './driver';\nimport { DuckTypingUtility } from './internal';\n\n/**\n * A datasource that holds one client and a connector built over it through a driver: the lifecycle\n * every connector family that talks to an external engine shares - wiring the driver named by\n * `@datasource({ driver })`, closing once, soft-evicting the client after a secret rotation, draining\n * a client by whichever verb its engine spells it with. No SQL members: the relational family adds\n * its dialect, executor and transactions in `AbstractRelationalDataSource`, a raw-SQL engine adds\n * nothing (`BaseRawSqlDataSource`). Transactions stay NotSupported, as in `AbstractDataSource`.\n *\n * `mapSecretToSettings` is a driver-config convention, not Postgres SQL, so it belongs on this\n * neutral base - do not move it down into a family.\n */\nexport abstract class AbstractDriverDataSource<\n Settings extends object = {},\n Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema,\n ConfigurableOptions extends object = {},\n Client = unknown,\n TConnector = unknown,\n TDriver extends IConnectorDriver<TConnector, unknown> = IConnectorDriver<TConnector, Client>,\n> extends AbstractDataSource<Settings, Schema, ConfigurableOptions> {\n connector?: TConnector;\n\n protected client?: Client;\n protected driver?: TDriver;\n\n private closePromise?: Promise<void>;\n\n /**\n * Lazy and idempotent: builds the driver named by `@datasource({ driver })` over the client\n * `configure()` assigned, then the connector from it. Returns the connector.\n */\n protected wireDriverFromMetadata(): TConnector {\n if (this.connector) {\n return this.connector;\n }\n\n if (this.driver) {\n const connector = this.driver.createConnector({ schema: this.getSchema() });\n this.connector = connector;\n\n return connector;\n }\n\n if (!this.client) {\n throw getError({\n message: `[${this.constructor.name}][wireDriverFromMetadata] No driver and no client | Assign this.client in configure(), or wire a custom driver with useDriver()`,\n });\n }\n\n const DriverClass = this.resolveDriverClass();\n\n // `TClass` takes `never[]`, so any driver constructor fits; Reflect.construct passes the client through.\n const driver: TDriver = Reflect.construct(DriverClass, [{ client: this.client }]);\n\n return this.useDriver({ driver });\n }\n\n /**\n * Rejects a driver-name string from untyped JS\n * callers: a string carries no module into the bundle.\n */\n protected resolveDriverClass(): TClass<TDriver> {\n const metadata = MetadataRegistry.getInstance().getDataSourceMetadata({\n target: this.constructor,\n });\n const driver = metadata?.driver;\n\n if (typeof driver !== 'function') {\n throw getError({\n message: `[${this.constructor.name}][resolveDriverClass] @datasource({ driver }) must name a driver CLASS | Got: ${String(driver)} | Use \\`@datasource({ driver: NodePostgresDriver })\\` with \\`import { NodePostgresDriver } from '@venizia/ignis-connectors/postgres/node-postgres'\\`, or wire a custom driver with useDriver()`,\n });\n }\n\n return driver as TClass<TDriver>;\n }\n\n protected resolveDriver(): TDriver {\n this.wireDriverFromMetadata();\n\n return this.driver as TDriver;\n }\n\n /**\n * Assigns `this.driver` AND builds `this.connector` in one step - a\n * driver without its connector is silently bypassed on pooled queries. Returns the connector.\n */\n protected useDriver(opts: { driver: TDriver; schema?: Schema }): TConnector {\n this.driver = opts.driver;\n const connector = opts.driver.createConnector({ schema: opts.schema ?? this.getSchema() });\n this.connector = connector;\n\n return connector;\n }\n\n /** A datasource that opens on first use has no client, driver or connector until the first call that needs it has awaited `ensureOpen()`. */\n private assertOpenForSyncUse(opts: { member: string }): void {\n if (!this.isOpenDeferred()) {\n return;\n }\n\n if (this.isClosed()) {\n throw getError({\n message: `[${this.constructor.name}][${opts.member}] The datasource is closed | It opens on first use only before close()`,\n });\n }\n\n if (this.isOpening()) {\n throw getError({\n message: `[${this.constructor.name}][${opts.member}] The datasource is still opening | Inside configure() use the opening argument (opening.${opts.member}()); outside it, await ensureOpen()`,\n });\n }\n\n if (!this.isOpen()) {\n throw getError({\n message: `[${this.constructor.name}][${opts.member}] The datasource opens on first use and is not open | Await ensureOpen() first; repository calls do it for you`,\n });\n }\n }\n\n /** The handles `configure()` is given: the connector and the client through the ungated internals, so its own database work (migrations, seeding) needs no gate. */\n protected override createOpening(): IDataSourceOpening<TConnector, Client> {\n return {\n ...super.createOpening(),\n getConnector: () => this.wireDriverFromMetadata(),\n getClient: () => this.readClient(),\n };\n }\n\n /** Wires the driver on first use, so a `configure()` that only builds `this.client` is enough. */\n getConnector(): TConnector {\n this.assertOpenForSyncUse({ member: this.getConnector.name });\n\n return this.wireDriverFromMetadata();\n }\n\n /**\n * Raw driver client (`pg.Pool` / `Sql`). Throws rather\n * than handing back an `undefined` typed as `Client`.\n */\n getClient(): Client {\n this.assertOpenForSyncUse({ member: this.getClient.name });\n\n return this.readClient();\n }\n\n private readClient(): Client {\n if (this.driver) {\n return this.driver.getClient() as Client;\n }\n\n if (!this.client) {\n throw getError({\n message: `[${this.constructor.name}][getClient] No driver and no client | Assign this.driver in configure()`,\n });\n }\n\n return this.client;\n }\n\n /**\n * Ends the connection `configure()` opened. Runs once: every later call returns the first call's\n * promise. Goes through the driver, wired now if nothing queried yet, because its `end()` is the\n * engine's whole teardown - PGlite also clears the exit status it plants on the host process.\n */\n override close(): Promise<void> {\n // A stop that arrives while the first use is still opening waits for that open, then closes what it built.\n this.closePromise ??= this.settleOpening().then(() => this.endConnection());\n\n return this.closePromise;\n }\n\n /** Ends a client that a failed open left half-built and forgets the driver and connector, so the next open starts from nothing. */\n protected override async discardPartialOpen(): Promise<void> {\n const { client, driver } = this;\n\n this.client = undefined;\n this.driver = undefined;\n this.connector = undefined;\n\n // A close() that is waiting for this open owns the slot: clearing it would let a second close end the connection twice.\n if (!this.isClosed()) {\n this.closePromise = undefined;\n }\n\n if (driver && typeof driver.end === 'function') {\n await driver.end();\n\n return;\n }\n\n if (client !== undefined) {\n await this.drainClient({ client });\n }\n }\n\n private async endConnection(): Promise<void> {\n if (!this.driver && this.client === undefined) {\n return;\n }\n\n let driver: TDriver;\n\n try {\n driver = this.resolveDriver();\n } catch (error) {\n this.logger\n .for(this.close.name)\n .warn('No driver to end the connection with | draining the client | error: %s', error);\n await this.drainClient({ client: this.client });\n\n return;\n }\n\n // A hand-made driver cast past `IConnectorDriver` can lack the `end()` its type promises.\n if (typeof driver.end !== 'function') {\n this.logger.for(this.close.name).warn('The driver has no end() | draining the client');\n await this.drainClient({ client: this.client });\n\n return;\n }\n\n await driver.end();\n }\n\n /**\n * Soft-evicts the pool after a secret rotation: rebuilds against the rotated credentials without\n * touching live fields, swaps atomically, then drains the old pool. On failure live state is\n * restored, any half-built pool drained, and the error rethrown.\n */\n async onSecretRotated(opts: { key: string; secret: Record<string, string> }): Promise<void> {\n const logger = this.logger.for(this.onSecretRotated.name);\n\n // Nothing is open yet, so there is no pool to swap: the rotated credentials wait in the settings for the first use.\n if (this.isOpenDeferred() && !this.isOpen()) {\n Object.assign(this.settings, this.mapSecretToSettings({ secret: opts.secret }));\n logger.info(\n 'Datasource not open yet; credentials kept for its first use | key: %s',\n opts.key,\n );\n\n return;\n }\n\n const oldClient = this.getClient();\n\n // Snapshot so a failed rebuild restores the datasource verbatim;\n // `settings` is copied because rotation mutates it in place.\n const savedClient = this.client;\n const savedSettings = { ...this.settings };\n\n // Rotation only takes effect through this.settings + configure(); a configure() that\n // hard-codes its connection string or reads the environment directly rebuilds with stale credentials.\n Object.assign(this.settings, this.mapSecretToSettings({ secret: opts.secret }));\n\n // configure() overwrites this.client, so the new pool is captured\n // into a local and the old client restored at once - live fields\n // are never nulled and the old pool keeps serving until the swap.\n let newClient: Client;\n\n try {\n await this.configure();\n newClient = this.client as Client;\n } catch (error) {\n const halfBuilt = this.client;\n this.client = savedClient;\n this.restoreSettings({ saved: savedSettings });\n\n if (halfBuilt && halfBuilt !== savedClient) {\n await this.drainClient({ client: halfBuilt });\n }\n\n logger.error('Secret rotation failed in configure(); kept old pool | key: %s', opts.key);\n throw error;\n }\n\n this.client = savedClient;\n\n // Wired into locals: live state must stay on the old pool until the swap below.\n let newDriver: TDriver;\n let newConnector: TConnector;\n\n try {\n const DriverClass = this.resolveDriverClass();\n newDriver = Reflect.construct(DriverClass, [{ client: newClient }]);\n newConnector = newDriver.createConnector({ schema: this.getSchema() });\n } catch (error) {\n this.restoreSettings({ saved: savedSettings });\n await this.drainClient({ client: newClient });\n\n logger.error('Secret rotation failed while wiring driver; kept old pool | key: %s', opts.key);\n throw error;\n }\n\n // Commit the live fields in one synchronous step so there is no null window,\n // then soft-evict the old pool so its in-flight transactions can finish.\n this.client = newClient;\n this.driver = newDriver;\n this.connector = newConnector;\n\n const isDrained = await this.drainClient({ client: oldClient });\n\n if (isDrained) {\n logger.info('Old pool drained after secret rotation | key: %s', opts.key);\n }\n }\n\n /** Puts `settings` back to the snapshot: a key the failed rotation added (the rotated `password`) is removed, not left behind. */\n private restoreSettings(opts: { saved: Settings }): void {\n const { settings } = this;\n\n for (const key of Object.keys(settings)) {\n if (!(key in opts.saved)) {\n Reflect.deleteProperty(settings, key);\n }\n }\n\n Object.assign(settings, opts.saved);\n }\n\n /**\n * Shuts a client down by whichever verb its engine spells it with -\n * `pg.Pool` and postgres.js have `end()`, PGlite and libsql only `close()`.\n * Probed rather than type-tested: this tier must not name an engine, and a\n * client left undrained keeps a WASM instance or file handle alive forever.\n */\n protected async drainClient(opts: { client: unknown }): Promise<boolean> {\n const { client } = opts;\n\n const drain =\n DuckTypingUtility.getMethod({ value: client, name: 'end' }) ??\n DuckTypingUtility.getMethod({ value: client, name: 'close' });\n\n if (!drain) {\n this.logger\n .for(this.drainClient.name)\n .warn('Client exposes neither end() nor close(); nothing to drain');\n\n return false;\n }\n\n await drain();\n\n return true;\n }\n\n /** Vault's database engine returns `{ username, password }`; pg expects `{ user, password }`. */\n protected mapSecretToSettings(opts: { secret: Record<string, string> }): Record<string, unknown> {\n const { username, password } = opts.secret;\n const mapped: Record<string, unknown> = {};\n\n if (username !== undefined) {\n mapped.user = username;\n }\n\n if (password !== undefined) {\n mapped.password = password;\n }\n\n return mapped;\n }\n}\n"]}
@@ -0,0 +1,15 @@
1
+ /** The `typeof` result a duck-typed member must have. */
2
+ export type TDuckMemberType = 'function' | 'string' | 'number';
3
+ export declare class DuckTypingUtility {
4
+ /** The method `name` of `value`, bound to it, when it is a function; otherwise `undefined`. */
5
+ static getMethod(opts: {
6
+ value: unknown;
7
+ name: string;
8
+ }): ((...args: unknown[]) => unknown) | undefined;
9
+ /** True when `value` is an object (or function) whose every listed member has the stated `typeof`; `null`, `undefined` and primitives are false. */
10
+ static hasMembers(opts: {
11
+ value: unknown;
12
+ members: Readonly<Record<string, TDuckMemberType>>;
13
+ }): boolean;
14
+ }
15
+ //# sourceMappingURL=duck-typing.d.ts.map
@@ -0,0 +1,28 @@
1
+ export class DuckTypingUtility {
2
+ /** The method `name` of `value`, bound to it, when it is a function; otherwise `undefined`. */
3
+ static getMethod(opts) {
4
+ const { value, name } = opts;
5
+ if (value === null || (typeof value !== 'object' && typeof value !== 'function')) {
6
+ return undefined;
7
+ }
8
+ const member = Reflect.get(value, name);
9
+ if (typeof member !== 'function') {
10
+ return undefined;
11
+ }
12
+ return (...args) => Reflect.apply(member, value, args);
13
+ }
14
+ /** True when `value` is an object (or function) whose every listed member has the stated `typeof`; `null`, `undefined` and primitives are false. */
15
+ static hasMembers(opts) {
16
+ const { value, members } = opts;
17
+ if (value === null || (typeof value !== 'object' && typeof value !== 'function')) {
18
+ return false;
19
+ }
20
+ for (const [name, kind] of Object.entries(members)) {
21
+ if (typeof Reflect.get(value, name) !== kind) {
22
+ return false;
23
+ }
24
+ }
25
+ return true;
26
+ }
27
+ }
28
+ //# sourceMappingURL=duck-typing.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"duck-typing.js","sourceRoot":"","sources":["../../../../src/common/internal/duck-typing.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,iBAAiB;IAC5B,+FAA+F;IAC/F,MAAM,CAAC,SAAS,CAAC,IAGhB;QACC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAE7B,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,EAAE,CAAC;YACjF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,MAAM,GAAY,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAEjD,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,oJAAoJ;IACpJ,MAAM,CAAC,UAAU,CAAC,IAGjB;QACC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEhC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,EAAE,CAAC;YACjF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC7C,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF","sourcesContent":["/** The `typeof` result a duck-typed member must have. */\nexport type TDuckMemberType = 'function' | 'string' | 'number';\n\nexport class DuckTypingUtility {\n /** The method `name` of `value`, bound to it, when it is a function; otherwise `undefined`. */\n static getMethod(opts: {\n value: unknown;\n name: string;\n }): ((...args: unknown[]) => unknown) | undefined {\n const { value, name } = opts;\n\n if (value === null || (typeof value !== 'object' && typeof value !== 'function')) {\n return undefined;\n }\n\n const member: unknown = Reflect.get(value, name);\n\n if (typeof member !== 'function') {\n return undefined;\n }\n\n return (...args) => Reflect.apply(member, value, args);\n }\n\n /** True when `value` is an object (or function) whose every listed member has the stated `typeof`; `null`, `undefined` and primitives are false. */\n static hasMembers(opts: {\n value: unknown;\n members: Readonly<Record<string, TDuckMemberType>>;\n }): boolean {\n const { value, members } = opts;\n\n if (value === null || (typeof value !== 'object' && typeof value !== 'function')) {\n return false;\n }\n\n for (const [name, kind] of Object.entries(members)) {\n if (typeof Reflect.get(value, name) !== kind) {\n return false;\n }\n }\n\n return true;\n }\n}\n"]}
@@ -1,2 +1,3 @@
1
+ export * from './duck-typing.js';
1
2
  export * from './echo.js';
2
3
  //# sourceMappingURL=index.d.ts.map
@@ -1,2 +1,3 @@
1
+ export * from './duck-typing.js';
1
2
  export * from './echo.js';
2
3
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/common/internal/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC","sourcesContent":["export * from './echo';\n"]}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/common/internal/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC","sourcesContent":["export * from './duck-typing';\nexport * from './echo';\n"]}
@@ -1,4 +1,3 @@
1
- import type { AnyType } from '@venizia/ignis-helpers/common';
2
1
  import type { IDeletableRepository, IReadableRepository, IUpdatableRepository, TCount, TDataWithRange, TByIdFilter, TFields, TFilter, TRow, TSchemaType, TWhere } from '@venizia/ignis-kernel/repository';
3
2
  import { AbstractEntity } from '@venizia/ignis-kernel/repository';
4
3
  import type { TSearchInput } from '../search/core/repositories/common/constants.js';
@@ -20,7 +19,7 @@ export declare class HttpResourceEntity extends AbstractEntity {
20
19
  * vocabulary. `P` is what a write sends - a partial row by default, since the server fills ids and
21
20
  * defaults. There is no `createAll`: the IGNIS REST contract has no bulk-create route.
22
21
  */
23
- export declare class HttpRepository<E extends object = AnyType, P extends object = Partial<E>> implements IReadableRepository<E, THttpRepositoryOptions>, IUpdatableRepository<E, P, THttpRepositoryOptions>, IDeletableRepository<E, THttpRepositoryOptions> {
22
+ export declare class HttpRepository<E extends object = object, P extends object = Partial<E>> implements IReadableRepository<E, THttpRepositoryOptions>, IUpdatableRepository<E, P, THttpRepositoryOptions>, IDeletableRepository<E, THttpRepositoryOptions> {
24
23
  dataSource: HttpDataSource;
25
24
  entity: AbstractEntity;
26
25
  protected resource: string;
@@ -226,7 +225,7 @@ export declare class HttpRepository<E extends object = AnyType, P extends object
226
225
  shouldReturn?: boolean;
227
226
  };
228
227
  }): Promise<TCount & {
229
- data: AnyType;
228
+ data: unknown;
230
229
  }>;
231
230
  deleteById(opts: {
232
231
  id: string | number;
@@ -269,7 +268,7 @@ export declare class HttpRepository<E extends object = AnyType, P extends object
269
268
  shouldReturn?: boolean;
270
269
  };
271
270
  }): Promise<TCount & {
272
- data: AnyType;
271
+ data: unknown;
273
272
  }>;
274
273
  }
275
274
  //# sourceMappingURL=repository.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../src/http/repository.ts"],"names":[],"mappings":"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","sourcesContent":["import { HttpReadShapes } from './common/constants';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type {\n IDeletableRepository,\n IReadableRepository,\n IUpdatableRepository,\n TCount,\n TDataWithRange,\n TByIdFilter,\n TFields,\n TFilter,\n TRow,\n TSchemaType,\n TWhere,\n} from '@venizia/ignis-kernel/repository';\nimport { AbstractEntity, DataRangeUtility } from '@venizia/ignis-kernel/repository';\nimport type { TSearchInput } from '../search/core/repositories/common/constants';\nimport type {\n IHttpCallOptions,\n IHttpSearchResult,\n IHttpWriteResult,\n THttpExtraQuery,\n TExtraRequest,\n TExtraResult,\n} from './common/types';\nimport type { HttpDataSource } from './datasource';\n\n/**\n * What a repository call takes. Only `headers` and `signal` cross HTTP; the shared repository\n * options (`transaction`, `log`, ...) are accepted for the common contract and have no effect.\n */\nexport type THttpRepositoryOptions = NonNullable<\n Parameters<IReadableRepository['existsWith']>[0]['options']\n> &\n IHttpCallOptions;\n\n/** A remote resource has a name but no local schema. */\nexport class HttpResourceEntity extends AbstractEntity {\n getSchema<T = unknown>(_opts: { type: TSchemaType }): T {\n return {} as T;\n }\n}\n\n/**\n * One remote resource, read and written through the IGNIS CRUD routes, in the `@venizia/ignis-filter`\n * vocabulary. `P` is what a write sends - a partial row by default, since the server fills ids and\n * defaults. There is no `createAll`: the IGNIS REST contract has no bulk-create route.\n */\nexport class HttpRepository<E extends object = AnyType, P extends object = Partial<E>>\n implements\n IReadableRepository<E, THttpRepositoryOptions>,\n IUpdatableRepository<E, P, THttpRepositoryOptions>,\n IDeletableRepository<E, THttpRepositoryOptions>\n{\n dataSource: HttpDataSource;\n entity: AbstractEntity;\n\n protected resource: string;\n /** A count route, if the API has one. Absent, the total comes from `Content-Range`. */\n protected countPath?: string;\n /** The segment after the resource that names the IGNIS find-one route. Absent, `findOne` asks the list route for one row. */\n protected findOnePath?: string;\n /** The page size `find` asks for when its filter names no limit. Absent, the server's own default applies. */\n protected defaultLimit?: number;\n /**\n * The segment after the resource that names the IGNIS search route.\n *\n * @default 'search'\n */\n protected searchPath: string;\n\n constructor(opts: {\n dataSource: HttpDataSource;\n resource: string;\n countPath?: string;\n findOnePath?: string;\n defaultLimit?: number;\n searchPath?: string;\n }) {\n const { defaultLimit } = opts;\n\n if (defaultLimit !== undefined && !(Number.isInteger(defaultLimit) && defaultLimit > 0)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${opts.resource}] defaultLimit must be a positive integer | Got ${defaultLimit}`,\n });\n }\n\n this.dataSource = opts.dataSource;\n this.resource = opts.resource;\n this.countPath = opts.countPath;\n this.findOnePath = opts.findOnePath;\n this.defaultLimit = defaultLimit;\n this.searchPath = opts.searchPath ?? 'search';\n this.entity = new HttpResourceEntity({ name: opts.resource });\n }\n\n getEntity(): AbstractEntity {\n return this.entity;\n }\n\n /**\n * The query string of a read: the caller's extra `query` with the call's own `params` (`filter`,\n * `where`) over it. `method` names the repository verb, so a subclass can reshape one route - a\n * keyword into the object its server reads - and leave the others.\n */\n protected buildQuery(opts: {\n method: string;\n query?: THttpExtraQuery;\n params: Record<string, unknown>;\n }): Record<string, unknown> {\n return { ...opts.query, ...opts.params };\n }\n\n /** The filter `find` sends: the caller's, with `defaultLimit` filled in when it names no limit. */\n protected resolveFindFilter(opts: { filter?: TFilter<E> }): TFilter<E> {\n const filter = opts.filter ?? {};\n\n return this.defaultLimit === undefined || filter.limit !== undefined\n ? filter\n : { ...filter, limit: this.defaultLimit };\n }\n\n /** `<resource>/<searchPath>`; override to move the route. */\n protected getSearchPaths(): Array<string> {\n return [this.resource, this.searchPath];\n }\n\n /** No header and an unreadable one (`/*`) have different fixes, so different messages. */\n protected getMissingTotalError(opts: {\n method: string;\n contentRange?: string;\n noHeader: string;\n }) {\n const { method, contentRange, noHeader } = opts;\n const message = contentRange\n ? `Content-Range \"${contentRange}\" carries no readable total - an unknown \"/*\" or an unparseable value. Check the server's count query.`\n : noHeader;\n\n return getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${this.resource}][${method}] ${message}`,\n });\n }\n\n /** From `Content-Range`, or `countPath`. No total throws rather than reporting the page size. */\n async count(opts: {\n where: TWhere<E>;\n query?: THttpExtraQuery;\n options?: THttpRepositoryOptions;\n }): Promise<TCount> {\n if (this.countPath) {\n const rs = await this.dataSource.read<{ count: number }>({\n paths: [this.resource, this.countPath],\n query: this.buildQuery({\n method: 'count',\n query: opts.query,\n params: { where: opts.where },\n }),\n shape: HttpReadShapes.ONE,\n isEveryDefaultOff: true,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n const counted = rs.data?.count;\n\n if (typeof counted !== 'number' || !Number.isFinite(counted)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${this.resource}][count] The count route answered no numeric count - answering 0 would read as an empty table. Body: ${JSON.stringify(rs.data)?.slice(0, 120)}`,\n });\n }\n\n return { count: counted };\n }\n\n const rs = await this.dataSource.read<Array<E>>({\n paths: [this.resource],\n query: this.buildQuery({\n method: 'count',\n query: opts.query,\n params: { filter: { where: opts.where, limit: 1 } },\n }),\n // Rows alone: a default extra would be computed and thrown away on every count or probe.\n isEveryDefaultOff: true,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n if (!rs.hasRange) {\n throw this.getMissingTotalError({\n method: 'count',\n contentRange: rs.contentRange,\n noHeader: `The response carried no Content-Range, so there is no total to report - answering with the page size would claim ${rs.dataLength}. Cross-origin, the server must list Content-Range in Access-Control-Expose-Headers; otherwise give this repository a countPath if the API publishes a count route.`,\n });\n }\n\n return { count: rs.total ?? 0 };\n }\n\n async existsWith(opts: {\n where: TWhere<E>;\n query?: THttpExtraQuery;\n options?: THttpRepositoryOptions;\n }): Promise<boolean> {\n const rs = await this.dataSource.read<Array<E>>({\n paths: [this.resource],\n query: this.buildQuery({\n method: 'existsWith',\n query: opts.query,\n params: { filter: { where: opts.where, limit: 1 } },\n }),\n // Rows alone: a default extra would be computed and thrown away on every count or probe.\n isEveryDefaultOff: true,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return rs.dataLength > 0;\n }\n\n /** With `extra`: what the route answered beside the rows, typed by what was asked for. */\n async find<\n R = unknown,\n const Extra extends TExtraRequest = TExtraRequest,\n const F extends TFields<E> = TFields<E>,\n >(opts: {\n filter: TFilter<E, F>;\n query?: THttpExtraQuery;\n options: THttpRepositoryOptions & { shouldQueryRange: true; extra: Extra };\n }): Promise<TDataWithRange<TRow<E, R, F>> & { extra: TExtraResult<Extra> }>;\n async find<R = unknown, const F extends TFields<E> = TFields<E>>(opts: {\n filter: TFilter<E, F>;\n query?: THttpExtraQuery;\n options: THttpRepositoryOptions & { shouldQueryRange: true };\n }): Promise<TDataWithRange<TRow<E, R, F>>>;\n async find<\n R = unknown,\n const Extra extends TExtraRequest = TExtraRequest,\n const F extends TFields<E> = TFields<E>,\n >(opts: {\n filter?: TFilter<E, F>;\n query?: THttpExtraQuery;\n options: THttpRepositoryOptions & { extra: Extra };\n }): Promise<{ data: Array<TRow<E, R, F>>; extra: TExtraResult<Extra> }>;\n async find<R = unknown, const F extends TFields<E> = TFields<E>>(opts: {\n filter?: TFilter<E, F>;\n query?: THttpExtraQuery;\n options?: THttpRepositoryOptions;\n }): Promise<Array<TRow<E, R, F>>>;\n /** `extra` or the range decided at run time: the caller narrows the union. */\n async find<R = unknown, const F extends TFields<E> = TFields<E>>(opts: {\n filter?: TFilter<E, F>;\n query?: THttpExtraQuery;\n options?: THttpRepositoryOptions & { shouldQueryRange?: boolean; extra?: TExtraRequest };\n }): Promise<\n | Array<TRow<E, R, F>>\n | TDataWithRange<TRow<E, R, F>>\n | { data: Array<TRow<E, R, F>>; extra: TExtraResult<TExtraRequest> }\n >;\n async find<R = E>(opts: {\n filter?: TFilter<E>;\n query?: THttpExtraQuery;\n options?: AnyType;\n }): Promise<Array<R> | TDataWithRange<R> | { data: Array<R>; extra?: Record<string, unknown> }> {\n const filter = this.resolveFindFilter({ filter: opts.filter });\n const rs = await this.dataSource.read<Array<R>>({\n paths: [this.resource],\n query: this.buildQuery({\n method: 'find',\n query: opts.query,\n params: { filter },\n }),\n extra: opts.options?.extra,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n const data = rs.data ?? [];\n\n if (!opts.options?.shouldQueryRange) {\n return opts.options?.extra ? { data, extra: rs.extra ?? {} } : data;\n }\n\n if (!rs.hasRange) {\n throw this.getMissingTotalError({\n method: 'find',\n contentRange: rs.contentRange,\n noHeader: `A range was asked for and the response carried no Content-Range. Deriving it from the page would report ${data.length} as the total. Cross-origin, the server must list Content-Range in Access-Control-Expose-Headers.`,\n });\n }\n\n return {\n data,\n // An empty page names no start: take it from the filter, as the server did.\n range: DataRangeUtility.buildDataRange({\n skip: rs.skip ?? filter.skip,\n offset: filter.offset,\n dataLength: data.length,\n total: rs.total ?? 0,\n }),\n // Asked for, `extra` is always there - empty when the route offered none.\n ...(opts.options?.extra ? { extra: rs.extra ?? {} } : {}),\n };\n }\n\n async findOne<R = unknown, const F extends TFields<E> = TFields<E>>(opts: {\n filter?: TFilter<E, F>;\n query?: THttpExtraQuery;\n options?: THttpRepositoryOptions;\n }): Promise<TRow<E, R, F> | null> {\n if (this.findOnePath) {\n const one = await this.dataSource.read<TRow<E, R, F> | null>({\n paths: [this.resource, this.findOnePath],\n query: this.buildQuery({\n method: 'findOne',\n query: opts.query,\n params: { filter: opts.filter ?? {} },\n }),\n shape: HttpReadShapes.ONE,\n isEveryDefaultOff: true,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return one.data ?? null;\n }\n\n const rs = await this.dataSource.read<Array<TRow<E, R, F>>>({\n paths: [this.resource],\n query: this.buildQuery({\n method: 'findOne',\n query: opts.query,\n params: { filter: { ...(opts.filter ?? {}), limit: 1 } },\n }),\n isEveryDefaultOff: true,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return rs.data?.[0] ?? null;\n }\n\n /** The server answers `null`, never 404, for a missing id. A `where` would be replaced by the id. */\n async findById<R = unknown, const F extends TFields<E> = TFields<E>>(opts: {\n id: string | number;\n filter?: TByIdFilter<E, F>;\n query?: THttpExtraQuery;\n options?: THttpRepositoryOptions;\n }): Promise<TRow<E, R, F> | null> {\n const rs = await this.dataSource.read<TRow<E, R, F>>({\n paths: this.getIdPaths({ id: opts.id }),\n query: this.buildQuery({\n method: 'findById',\n query: opts.query,\n params: { filter: opts.filter ?? {} },\n }),\n shape: HttpReadShapes.ONE,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return rs.data ?? null;\n }\n\n /**\n * POST `<resource>/search`, the IGNIS search route: `input` is its body (a keyword, semantic, hybrid\n * or raw search), the answer its `{ found, isFoundExact, hits }`. `found` is the total - there is no\n * count route for a search, and `isFoundExact` says when it is an estimate.\n */\n async search<R extends object = E>(opts: {\n input: TSearchInput;\n query?: THttpExtraQuery;\n options?: THttpRepositoryOptions;\n }): Promise<IHttpSearchResult<R>> {\n const rs = await this.dataSource.read<IHttpSearchResult<R> | null>({\n paths: this.getSearchPaths(),\n method: HTTP.Methods.POST,\n body: opts.input,\n query: this.buildQuery({ method: 'search', query: opts.query, params: {} }),\n shape: HttpReadShapes.ONE,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n const answer = rs.data;\n\n if (!answer || typeof answer.found !== 'number' || !Array.isArray(answer.hits)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.BadGateway,\n message: `[${this.resource}][search] The search route answered no { found, hits } envelope - answering an empty page would read as no match. Body: ${JSON.stringify(answer)?.slice(0, 120)}`,\n });\n }\n\n return answer;\n }\n\n /**\n * `<resource>/<id>`, the id encoded: an id carrying `/` or `?` would otherwise name another route.\n * An empty, `.` or `..` id is refused: a URL resolves it, encoded or not, to `/<resource>/` or the\n * parent - a router or proxy that ignores the trailing slash then serves the list or bulk route.\n */\n protected getIdPaths(opts: { id: string | number }): Array<string> {\n const id = String(opts.id);\n\n if (id === '' || id === '.' || id === '..') {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[${this.resource}] Invalid id '${id}' | An empty, '.' or '..' id names another route`,\n });\n }\n\n return [this.resource, encodeURIComponent(id)];\n }\n\n /** What a call adds to its request: headers and an abort signal. Every other option stays local. */\n protected toCallOptions(opts: { options?: THttpRepositoryOptions }): IHttpCallOptions {\n return { headers: opts.options?.headers, signal: opts.options?.signal };\n }\n\n /** The IGNIS bulk routes answer an empty `where` with a 400; refused here before a request is spent. */\n protected assertBulkWhere(opts: { method: string; where?: TWhere<E> }): TWhere<E> {\n const { method, where } = opts;\n\n if (!where || Object.keys(where).length === 0) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[${this.resource}][${method}] where is required for a bulk write | The IGNIS bulk routes refuse an empty where, and force cannot cross HTTP`,\n });\n }\n\n return where;\n }\n\n /** The server always answers the rows; `shouldReturn: false` drops them here, as a database repository would not fetch them. */\n protected toWriteResult<R>(opts: {\n result: IHttpWriteResult<R>;\n options?: THttpRepositoryOptions & { shouldReturn?: boolean };\n }): TCount & { data: R | null } {\n const { result, options } = opts;\n\n return { count: result.count, data: options?.shouldReturn === false ? null : result.data };\n }\n\n /** POST `/<resource>`. */\n async create<R = E>(opts: {\n data: P;\n options?: THttpRepositoryOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }> {\n const result = await this.dataSource.write<R>({\n paths: [this.resource],\n method: HTTP.Methods.POST,\n body: opts.data,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return { count: result.count, data: result.data };\n }\n\n async updateById(opts: {\n id: string | number;\n data: Partial<P>;\n options: THttpRepositoryOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n async updateById<R = E>(opts: {\n id: string | number;\n data: Partial<P>;\n options?: THttpRepositoryOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }>;\n /** PATCH `/<resource>/<id>`. */\n async updateById<R = E>(opts: {\n id: string | number;\n data: Partial<P>;\n options?: THttpRepositoryOptions & { shouldReturn?: boolean };\n }): Promise<TCount & { data: AnyType }> {\n const result = await this.dataSource.write<R>({\n paths: this.getIdPaths({ id: opts.id }),\n method: HTTP.Methods.PATCH,\n body: opts.data,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return this.toWriteResult({ result, options: opts.options });\n }\n\n async updateBy(opts: {\n data: Partial<P>;\n where: TWhere<E>;\n options: THttpRepositoryOptions & { shouldReturn: false; force?: boolean };\n }): Promise<TCount & { data: undefined | null }>;\n async updateBy<R = E>(opts: {\n data: Partial<P>;\n where: TWhere<E>;\n options?: THttpRepositoryOptions & { shouldReturn?: true; force?: boolean };\n }): Promise<TCount & { data: Array<R> | null }>;\n /** PATCH `/<resource>`, the `where` in the body beside the data - a long id list outgrows a URL. */\n async updateBy(opts: {\n data: Partial<P>;\n where: TWhere<E>;\n options?: THttpRepositoryOptions & { shouldReturn?: boolean; force?: boolean };\n }): Promise<TCount & { data: AnyType }> {\n return this.patchWhere({ ...opts, method: 'updateBy' });\n }\n\n protected async patchWhere(opts: {\n method: string;\n data: Partial<P>;\n where: TWhere<E>;\n options?: THttpRepositoryOptions & { shouldReturn?: boolean };\n }): Promise<TCount & { data: AnyType }> {\n const where = this.assertBulkWhere({ method: opts.method, where: opts.where });\n\n const result = await this.dataSource.write<Array<E>>({\n paths: [this.resource],\n method: HTTP.Methods.PATCH,\n body: { ...opts.data, where },\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return this.toWriteResult({ result, options: opts.options });\n }\n\n async deleteById(opts: {\n id: string | number;\n options: THttpRepositoryOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n async deleteById<R = E>(opts: {\n id: string | number;\n options?: THttpRepositoryOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }>;\n /** DELETE `/<resource>/<id>`. */\n async deleteById<R = E>(opts: {\n id: string | number;\n options?: THttpRepositoryOptions & { shouldReturn?: boolean };\n }): Promise<TCount & { data: AnyType }> {\n const result = await this.dataSource.write<R>({\n paths: this.getIdPaths({ id: opts.id }),\n method: HTTP.Methods.DELETE,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return this.toWriteResult({ result, options: opts.options });\n }\n\n async deleteBy(opts: {\n where: TWhere<E>;\n options: THttpRepositoryOptions & { shouldReturn: false; force?: boolean };\n }): Promise<TCount & { data: undefined | null }>;\n async deleteBy<R = E>(opts: {\n where: TWhere<E>;\n options?: THttpRepositoryOptions & { shouldReturn?: true; force?: boolean };\n }): Promise<TCount & { data: Array<R> | null }>;\n /** DELETE `/<resource>`, the `where` in the body. */\n async deleteBy(opts: {\n where: TWhere<E>;\n options?: THttpRepositoryOptions & { shouldReturn?: boolean; force?: boolean };\n }): Promise<TCount & { data: AnyType }> {\n return this.deleteWhere({ ...opts, method: 'deleteBy' });\n }\n\n protected async deleteWhere(opts: {\n method: string;\n where: TWhere<E>;\n options?: THttpRepositoryOptions & { shouldReturn?: boolean };\n }): Promise<TCount & { data: AnyType }> {\n const where = this.assertBulkWhere({ method: opts.method, where: opts.where });\n\n const result = await this.dataSource.write<Array<E>>({\n paths: [this.resource],\n method: HTTP.Methods.DELETE,\n body: { where },\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return this.toWriteResult({ result, options: opts.options });\n }\n}\n"]}
1
+ {"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../src/http/repository.ts"],"names":[],"mappings":"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","sourcesContent":["import { HttpReadShapes } from './common/constants';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type {\n IDeletableRepository,\n IReadableRepository,\n IUpdatableRepository,\n TCount,\n TDataWithRange,\n TByIdFilter,\n TFields,\n TFilter,\n TRow,\n TSchemaType,\n TWhere,\n} from '@venizia/ignis-kernel/repository';\nimport { AbstractEntity, DataRangeUtility } from '@venizia/ignis-kernel/repository';\nimport type { TSearchInput } from '../search/core/repositories/common/constants';\nimport type {\n IHttpCallOptions,\n IHttpSearchResult,\n IHttpWriteResult,\n THttpExtraQuery,\n TExtraRequest,\n TExtraResult,\n} from './common/types';\nimport type { HttpDataSource } from './datasource';\n\n/**\n * What a repository call takes. Only `headers` and `signal` cross HTTP; the shared repository\n * options (`transaction`, `log`, ...) are accepted for the common contract and have no effect.\n */\nexport type THttpRepositoryOptions = NonNullable<\n Parameters<IReadableRepository['existsWith']>[0]['options']\n> &\n IHttpCallOptions;\n\n/** A remote resource has a name but no local schema. */\nexport class HttpResourceEntity extends AbstractEntity {\n getSchema<T = unknown>(_opts: { type: TSchemaType }): T {\n return {} as T;\n }\n}\n\n/**\n * One remote resource, read and written through the IGNIS CRUD routes, in the `@venizia/ignis-filter`\n * vocabulary. `P` is what a write sends - a partial row by default, since the server fills ids and\n * defaults. There is no `createAll`: the IGNIS REST contract has no bulk-create route.\n */\nexport class HttpRepository<E extends object = object, P extends object = Partial<E>>\n implements\n IReadableRepository<E, THttpRepositoryOptions>,\n IUpdatableRepository<E, P, THttpRepositoryOptions>,\n IDeletableRepository<E, THttpRepositoryOptions>\n{\n dataSource: HttpDataSource;\n entity: AbstractEntity;\n\n protected resource: string;\n /** A count route, if the API has one. Absent, the total comes from `Content-Range`. */\n protected countPath?: string;\n /** The segment after the resource that names the IGNIS find-one route. Absent, `findOne` asks the list route for one row. */\n protected findOnePath?: string;\n /** The page size `find` asks for when its filter names no limit. Absent, the server's own default applies. */\n protected defaultLimit?: number;\n /**\n * The segment after the resource that names the IGNIS search route.\n *\n * @default 'search'\n */\n protected searchPath: string;\n\n constructor(opts: {\n dataSource: HttpDataSource;\n resource: string;\n countPath?: string;\n findOnePath?: string;\n defaultLimit?: number;\n searchPath?: string;\n }) {\n const { defaultLimit } = opts;\n\n if (defaultLimit !== undefined && !(Number.isInteger(defaultLimit) && defaultLimit > 0)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${opts.resource}] defaultLimit must be a positive integer | Got ${defaultLimit}`,\n });\n }\n\n this.dataSource = opts.dataSource;\n this.resource = opts.resource;\n this.countPath = opts.countPath;\n this.findOnePath = opts.findOnePath;\n this.defaultLimit = defaultLimit;\n this.searchPath = opts.searchPath ?? 'search';\n this.entity = new HttpResourceEntity({ name: opts.resource });\n }\n\n getEntity(): AbstractEntity {\n return this.entity;\n }\n\n /**\n * The query string of a read: the caller's extra `query` with the call's own `params` (`filter`,\n * `where`) over it. `method` names the repository verb, so a subclass can reshape one route - a\n * keyword into the object its server reads - and leave the others.\n */\n protected buildQuery(opts: {\n method: string;\n query?: THttpExtraQuery;\n params: Record<string, unknown>;\n }): Record<string, unknown> {\n return { ...opts.query, ...opts.params };\n }\n\n /** The filter `find` sends: the caller's, with `defaultLimit` filled in when it names no limit. */\n protected resolveFindFilter(opts: { filter?: TFilter<E> }): TFilter<E> {\n const filter = opts.filter ?? {};\n\n return this.defaultLimit === undefined || filter.limit !== undefined\n ? filter\n : { ...filter, limit: this.defaultLimit };\n }\n\n /** `<resource>/<searchPath>`; override to move the route. */\n protected getSearchPaths(): Array<string> {\n return [this.resource, this.searchPath];\n }\n\n /** No header and an unreadable one (`/*`) have different fixes, so different messages. */\n protected getMissingTotalError(opts: {\n method: string;\n contentRange?: string;\n noHeader: string;\n }) {\n const { method, contentRange, noHeader } = opts;\n const message = contentRange\n ? `Content-Range \"${contentRange}\" carries no readable total - an unknown \"/*\" or an unparseable value. Check the server's count query.`\n : noHeader;\n\n return getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${this.resource}][${method}] ${message}`,\n });\n }\n\n /** From `Content-Range`, or `countPath`. No total throws rather than reporting the page size. */\n async count(opts: {\n where: TWhere<E>;\n query?: THttpExtraQuery;\n options?: THttpRepositoryOptions;\n }): Promise<TCount> {\n if (this.countPath) {\n const rs = await this.dataSource.read<{ count: number }>({\n paths: [this.resource, this.countPath],\n query: this.buildQuery({\n method: 'count',\n query: opts.query,\n params: { where: opts.where },\n }),\n shape: HttpReadShapes.ONE,\n isEveryDefaultOff: true,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n const counted = rs.data?.count;\n\n if (typeof counted !== 'number' || !Number.isFinite(counted)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${this.resource}][count] The count route answered no numeric count - answering 0 would read as an empty table. Body: ${JSON.stringify(rs.data)?.slice(0, 120)}`,\n });\n }\n\n return { count: counted };\n }\n\n const rs = await this.dataSource.read<Array<E>>({\n paths: [this.resource],\n query: this.buildQuery({\n method: 'count',\n query: opts.query,\n params: { filter: { where: opts.where, limit: 1 } },\n }),\n // Rows alone: a default extra would be computed and thrown away on every count or probe.\n isEveryDefaultOff: true,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n if (!rs.hasRange) {\n throw this.getMissingTotalError({\n method: 'count',\n contentRange: rs.contentRange,\n noHeader: `The response carried no Content-Range, so there is no total to report - answering with the page size would claim ${rs.dataLength}. Cross-origin, the server must list Content-Range in Access-Control-Expose-Headers; otherwise give this repository a countPath if the API publishes a count route.`,\n });\n }\n\n return { count: rs.total ?? 0 };\n }\n\n async existsWith(opts: {\n where: TWhere<E>;\n query?: THttpExtraQuery;\n options?: THttpRepositoryOptions;\n }): Promise<boolean> {\n const rs = await this.dataSource.read<Array<E>>({\n paths: [this.resource],\n query: this.buildQuery({\n method: 'existsWith',\n query: opts.query,\n params: { filter: { where: opts.where, limit: 1 } },\n }),\n // Rows alone: a default extra would be computed and thrown away on every count or probe.\n isEveryDefaultOff: true,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return rs.dataLength > 0;\n }\n\n /** With `extra`: what the route answered beside the rows, typed by what was asked for. */\n async find<\n R = unknown,\n const Extra extends TExtraRequest = TExtraRequest,\n const F extends TFields<E> = TFields<E>,\n >(opts: {\n filter: TFilter<E, F>;\n query?: THttpExtraQuery;\n options: THttpRepositoryOptions & { shouldQueryRange: true; extra: Extra };\n }): Promise<TDataWithRange<TRow<E, R, F>> & { extra: TExtraResult<Extra> }>;\n async find<R = unknown, const F extends TFields<E> = TFields<E>>(opts: {\n filter: TFilter<E, F>;\n query?: THttpExtraQuery;\n options: THttpRepositoryOptions & { shouldQueryRange: true };\n }): Promise<TDataWithRange<TRow<E, R, F>>>;\n async find<\n R = unknown,\n const Extra extends TExtraRequest = TExtraRequest,\n const F extends TFields<E> = TFields<E>,\n >(opts: {\n filter?: TFilter<E, F>;\n query?: THttpExtraQuery;\n options: THttpRepositoryOptions & { extra: Extra };\n }): Promise<{ data: Array<TRow<E, R, F>>; extra: TExtraResult<Extra> }>;\n async find<R = unknown, const F extends TFields<E> = TFields<E>>(opts: {\n filter?: TFilter<E, F>;\n query?: THttpExtraQuery;\n options?: THttpRepositoryOptions;\n }): Promise<Array<TRow<E, R, F>>>;\n /** `extra` or the range decided at run time: the caller narrows the union. */\n async find<R = unknown, const F extends TFields<E> = TFields<E>>(opts: {\n filter?: TFilter<E, F>;\n query?: THttpExtraQuery;\n options?: THttpRepositoryOptions & { shouldQueryRange?: boolean; extra?: TExtraRequest };\n }): Promise<\n | Array<TRow<E, R, F>>\n | TDataWithRange<TRow<E, R, F>>\n | { data: Array<TRow<E, R, F>>; extra: TExtraResult<TExtraRequest> }\n >;\n async find<R = E>(opts: {\n filter?: TFilter<E>;\n query?: THttpExtraQuery;\n options?: THttpRepositoryOptions & { shouldQueryRange?: boolean; extra?: TExtraRequest };\n }): Promise<Array<R> | TDataWithRange<R> | { data: Array<R>; extra?: Record<string, unknown> }> {\n const filter = this.resolveFindFilter({ filter: opts.filter });\n const rs = await this.dataSource.read<Array<R>>({\n paths: [this.resource],\n query: this.buildQuery({\n method: 'find',\n query: opts.query,\n params: { filter },\n }),\n extra: opts.options?.extra,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n const data = rs.data ?? [];\n\n if (!opts.options?.shouldQueryRange) {\n return opts.options?.extra ? { data, extra: rs.extra ?? {} } : data;\n }\n\n if (!rs.hasRange) {\n throw this.getMissingTotalError({\n method: 'find',\n contentRange: rs.contentRange,\n noHeader: `A range was asked for and the response carried no Content-Range. Deriving it from the page would report ${data.length} as the total. Cross-origin, the server must list Content-Range in Access-Control-Expose-Headers.`,\n });\n }\n\n return {\n data,\n // An empty page names no start: take it from the filter, as the server did.\n range: DataRangeUtility.buildDataRange({\n skip: rs.skip ?? filter.skip,\n offset: filter.offset,\n dataLength: data.length,\n total: rs.total ?? 0,\n }),\n // Asked for, `extra` is always there - empty when the route offered none.\n ...(opts.options?.extra ? { extra: rs.extra ?? {} } : {}),\n };\n }\n\n async findOne<R = unknown, const F extends TFields<E> = TFields<E>>(opts: {\n filter?: TFilter<E, F>;\n query?: THttpExtraQuery;\n options?: THttpRepositoryOptions;\n }): Promise<TRow<E, R, F> | null> {\n if (this.findOnePath) {\n const one = await this.dataSource.read<TRow<E, R, F> | null>({\n paths: [this.resource, this.findOnePath],\n query: this.buildQuery({\n method: 'findOne',\n query: opts.query,\n params: { filter: opts.filter ?? {} },\n }),\n shape: HttpReadShapes.ONE,\n isEveryDefaultOff: true,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return one.data ?? null;\n }\n\n const rs = await this.dataSource.read<Array<TRow<E, R, F>>>({\n paths: [this.resource],\n query: this.buildQuery({\n method: 'findOne',\n query: opts.query,\n params: { filter: { ...(opts.filter ?? {}), limit: 1 } },\n }),\n isEveryDefaultOff: true,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return rs.data?.[0] ?? null;\n }\n\n /** The server answers `null`, never 404, for a missing id. A `where` would be replaced by the id. */\n async findById<R = unknown, const F extends TFields<E> = TFields<E>>(opts: {\n id: string | number;\n filter?: TByIdFilter<E, F>;\n query?: THttpExtraQuery;\n options?: THttpRepositoryOptions;\n }): Promise<TRow<E, R, F> | null> {\n const rs = await this.dataSource.read<TRow<E, R, F>>({\n paths: this.getIdPaths({ id: opts.id }),\n query: this.buildQuery({\n method: 'findById',\n query: opts.query,\n params: { filter: opts.filter ?? {} },\n }),\n shape: HttpReadShapes.ONE,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return rs.data ?? null;\n }\n\n /**\n * POST `<resource>/search`, the IGNIS search route: `input` is its body (a keyword, semantic, hybrid\n * or raw search), the answer its `{ found, isFoundExact, hits }`. `found` is the total - there is no\n * count route for a search, and `isFoundExact` says when it is an estimate.\n */\n async search<R extends object = E>(opts: {\n input: TSearchInput;\n query?: THttpExtraQuery;\n options?: THttpRepositoryOptions;\n }): Promise<IHttpSearchResult<R>> {\n const rs = await this.dataSource.read<IHttpSearchResult<R> | null>({\n paths: this.getSearchPaths(),\n method: HTTP.Methods.POST,\n body: opts.input,\n query: this.buildQuery({ method: 'search', query: opts.query, params: {} }),\n shape: HttpReadShapes.ONE,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n const answer = rs.data;\n\n if (!answer || typeof answer.found !== 'number' || !Array.isArray(answer.hits)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.BadGateway,\n message: `[${this.resource}][search] The search route answered no { found, hits } envelope - answering an empty page would read as no match. Body: ${JSON.stringify(answer)?.slice(0, 120)}`,\n });\n }\n\n return answer;\n }\n\n /**\n * `<resource>/<id>`, the id encoded: an id carrying `/` or `?` would otherwise name another route.\n * An empty, `.` or `..` id is refused: a URL resolves it, encoded or not, to `/<resource>/` or the\n * parent - a router or proxy that ignores the trailing slash then serves the list or bulk route.\n */\n protected getIdPaths(opts: { id: string | number }): Array<string> {\n const id = String(opts.id);\n\n if (id === '' || id === '.' || id === '..') {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[${this.resource}] Invalid id '${id}' | An empty, '.' or '..' id names another route`,\n });\n }\n\n return [this.resource, encodeURIComponent(id)];\n }\n\n /** What a call adds to its request: headers and an abort signal. Every other option stays local. */\n protected toCallOptions(opts: { options?: THttpRepositoryOptions }): IHttpCallOptions {\n return { headers: opts.options?.headers, signal: opts.options?.signal };\n }\n\n /** The IGNIS bulk routes answer an empty `where` with a 400; refused here before a request is spent. */\n protected assertBulkWhere(opts: { method: string; where?: TWhere<E> }): TWhere<E> {\n const { method, where } = opts;\n\n if (!where || Object.keys(where).length === 0) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[${this.resource}][${method}] where is required for a bulk write | The IGNIS bulk routes refuse an empty where, and force cannot cross HTTP`,\n });\n }\n\n return where;\n }\n\n /** The server always answers the rows; `shouldReturn: false` drops them here, as a database repository would not fetch them. */\n protected toWriteResult<R>(opts: {\n result: IHttpWriteResult<R>;\n options?: THttpRepositoryOptions & { shouldReturn?: boolean };\n }): TCount & { data: R | null } {\n const { result, options } = opts;\n\n return { count: result.count, data: options?.shouldReturn === false ? null : result.data };\n }\n\n /** POST `/<resource>`. */\n async create<R = E>(opts: {\n data: P;\n options?: THttpRepositoryOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }> {\n const result = await this.dataSource.write<R>({\n paths: [this.resource],\n method: HTTP.Methods.POST,\n body: opts.data,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return { count: result.count, data: result.data };\n }\n\n async updateById(opts: {\n id: string | number;\n data: Partial<P>;\n options: THttpRepositoryOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n async updateById<R = E>(opts: {\n id: string | number;\n data: Partial<P>;\n options?: THttpRepositoryOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }>;\n /** PATCH `/<resource>/<id>`. */\n async updateById<R = E>(opts: {\n id: string | number;\n data: Partial<P>;\n options?: THttpRepositoryOptions & { shouldReturn?: boolean };\n }): Promise<TCount & { data: unknown }> {\n const result = await this.dataSource.write<R>({\n paths: this.getIdPaths({ id: opts.id }),\n method: HTTP.Methods.PATCH,\n body: opts.data,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return this.toWriteResult({ result, options: opts.options });\n }\n\n async updateBy(opts: {\n data: Partial<P>;\n where: TWhere<E>;\n options: THttpRepositoryOptions & { shouldReturn: false; force?: boolean };\n }): Promise<TCount & { data: undefined | null }>;\n async updateBy<R = E>(opts: {\n data: Partial<P>;\n where: TWhere<E>;\n options?: THttpRepositoryOptions & { shouldReturn?: true; force?: boolean };\n }): Promise<TCount & { data: Array<R> | null }>;\n /** PATCH `/<resource>`, the `where` in the body beside the data - a long id list outgrows a URL. */\n async updateBy(opts: {\n data: Partial<P>;\n where: TWhere<E>;\n options?: THttpRepositoryOptions & { shouldReturn?: boolean; force?: boolean };\n }): Promise<TCount & { data: unknown }> {\n return this.patchWhere({ ...opts, method: 'updateBy' });\n }\n\n protected async patchWhere(opts: {\n method: string;\n data: Partial<P>;\n where: TWhere<E>;\n options?: THttpRepositoryOptions & { shouldReturn?: boolean };\n }): Promise<TCount & { data: unknown }> {\n const where = this.assertBulkWhere({ method: opts.method, where: opts.where });\n\n const result = await this.dataSource.write<Array<E>>({\n paths: [this.resource],\n method: HTTP.Methods.PATCH,\n body: { ...opts.data, where },\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return this.toWriteResult({ result, options: opts.options });\n }\n\n async deleteById(opts: {\n id: string | number;\n options: THttpRepositoryOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n async deleteById<R = E>(opts: {\n id: string | number;\n options?: THttpRepositoryOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }>;\n /** DELETE `/<resource>/<id>`. */\n async deleteById<R = E>(opts: {\n id: string | number;\n options?: THttpRepositoryOptions & { shouldReturn?: boolean };\n }): Promise<TCount & { data: unknown }> {\n const result = await this.dataSource.write<R>({\n paths: this.getIdPaths({ id: opts.id }),\n method: HTTP.Methods.DELETE,\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return this.toWriteResult({ result, options: opts.options });\n }\n\n async deleteBy(opts: {\n where: TWhere<E>;\n options: THttpRepositoryOptions & { shouldReturn: false; force?: boolean };\n }): Promise<TCount & { data: undefined | null }>;\n async deleteBy<R = E>(opts: {\n where: TWhere<E>;\n options?: THttpRepositoryOptions & { shouldReturn?: true; force?: boolean };\n }): Promise<TCount & { data: Array<R> | null }>;\n /** DELETE `/<resource>`, the `where` in the body. */\n async deleteBy(opts: {\n where: TWhere<E>;\n options?: THttpRepositoryOptions & { shouldReturn?: boolean; force?: boolean };\n }): Promise<TCount & { data: unknown }> {\n return this.deleteWhere({ ...opts, method: 'deleteBy' });\n }\n\n protected async deleteWhere(opts: {\n method: string;\n where: TWhere<E>;\n options?: THttpRepositoryOptions & { shouldReturn?: boolean };\n }): Promise<TCount & { data: unknown }> {\n const where = this.assertBulkWhere({ method: opts.method, where: opts.where });\n\n const result = await this.dataSource.write<Array<E>>({\n paths: [this.resource],\n method: HTTP.Methods.DELETE,\n body: { where },\n ...this.toCallOptions({ options: opts.options }),\n });\n\n return this.toWriteResult({ result, options: opts.options });\n }\n}\n"]}
@@ -1,7 +1,6 @@
1
1
  import type { IRepository } from '@venizia/ignis-kernel';
2
2
  import { AbstractEntity } from '@venizia/ignis-kernel/repository';
3
3
  import type { TSchemaType } from '@venizia/ignis-kernel/repository';
4
- import type { AnyType } from '@venizia/ignis-helpers/common';
5
4
  import { BaseHelper } from '@venizia/ignis-helpers/core';
6
5
  import type { IRawSqlConnector, IRawSqlResult, TRawSqlQuery } from './common/index.js';
7
6
  import type { BaseRawSqlDataSource } from './datasource.js';
@@ -20,9 +19,9 @@ export declare class RawSqlEntity extends AbstractEntity {
20
19
  * `@repository({ type: RepositoryTypes.REMOTE, dataSource: ReportDataSource })`.
21
20
  */
22
21
  export declare abstract class BaseRawSqlRepository<TConnector extends IRawSqlConnector = IRawSqlConnector> extends BaseHelper implements IRepository {
23
- dataSource: BaseRawSqlDataSource<AnyType, AnyType, TConnector>;
22
+ dataSource: BaseRawSqlDataSource<object, unknown, TConnector>;
24
23
  entity: AbstractEntity;
25
- constructor(dataSource: BaseRawSqlDataSource<AnyType, AnyType, TConnector>);
24
+ constructor(dataSource: BaseRawSqlDataSource<object, unknown, TConnector>);
26
25
  getEntity(): AbstractEntity;
27
26
  /** The engine's connector, typed by the generic this repository was declared with. */
28
27
  get connector(): TConnector;
@@ -1 +1 @@
1
- {"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../src/raw-sql/repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAGlE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAIzD,kEAAkE;AAClE,MAAM,OAAO,YAAa,SAAQ,cAAc;IAC9C,SAAS,CAAc,KAA4B;QACjD,OAAO,EAAO,CAAC;IACjB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAgB,oBACpB,SAAQ,UAAU;IAMlB,YAAY,UAA8D;QACxE,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAElC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,sFAAsF;IACtF,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;IACxC,CAAC;IAED,kGAAkG;IACxF,OAAO,CAAC,KAAmB;QACnC,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;CACF","sourcesContent":["import type { IRepository } from '@venizia/ignis-kernel';\nimport { AbstractEntity } from '@venizia/ignis-kernel/repository';\nimport type { TSchemaType } from '@venizia/ignis-kernel/repository';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport { BaseHelper } from '@venizia/ignis-helpers/core';\nimport type { IRawSqlConnector, IRawSqlResult, TRawSqlQuery } from './common';\nimport type { BaseRawSqlDataSource } from './datasource';\n\n/** A raw-SQL repository has a name but no model and no schema. */\nexport class RawSqlEntity extends AbstractEntity {\n getSchema<T = unknown>(_opts: { type: TSchemaType }): T {\n return {} as T;\n }\n}\n\n/**\n * A repository over a raw-SQL engine: it holds the datasource and reads `this.connector`, typed by\n * the connector the datasource was built with, so `this.connector.execute(...)` needs no cast. It\n * has no CRUD verbs - the subclass writes its own statements.\n *\n * Bind it with a datasource and no model, the same shape a remote repository has:\n * `@repository({ type: RepositoryTypes.REMOTE, dataSource: ReportDataSource })`.\n */\nexport abstract class BaseRawSqlRepository<TConnector extends IRawSqlConnector = IRawSqlConnector>\n extends BaseHelper\n implements IRepository\n{\n dataSource: BaseRawSqlDataSource<AnyType, AnyType, TConnector>;\n entity: AbstractEntity;\n\n constructor(dataSource: BaseRawSqlDataSource<AnyType, AnyType, TConnector>) {\n super({ scope: new.target.name });\n\n this.dataSource = dataSource;\n this.entity = new RawSqlEntity({ name: new.target.name });\n }\n\n getEntity(): AbstractEntity {\n return this.entity;\n }\n\n /** The engine's connector, typed by the generic this repository was declared with. */\n get connector(): TConnector {\n return this.dataSource.getConnector();\n }\n\n /** `this.connector.execute(query)`, for a repository that runs a statement and reads the rows. */\n protected execute(query: TRawSqlQuery): Promise<IRawSqlResult> {\n return this.connector.execute(query);\n }\n}\n"]}
1
+ {"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../src/raw-sql/repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAElE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAIzD,kEAAkE;AAClE,MAAM,OAAO,YAAa,SAAQ,cAAc;IAC9C,SAAS,CAAc,KAA4B;QACjD,OAAO,EAAO,CAAC;IACjB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAgB,oBACpB,SAAQ,UAAU;IAMlB,YAAY,UAA6D;QACvE,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAElC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,sFAAsF;IACtF,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;IACxC,CAAC;IAED,kGAAkG;IACxF,OAAO,CAAC,KAAmB;QACnC,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;CACF","sourcesContent":["import type { IRepository } from '@venizia/ignis-kernel';\nimport { AbstractEntity } from '@venizia/ignis-kernel/repository';\nimport type { TSchemaType } from '@venizia/ignis-kernel/repository';\nimport { BaseHelper } from '@venizia/ignis-helpers/core';\nimport type { IRawSqlConnector, IRawSqlResult, TRawSqlQuery } from './common';\nimport type { BaseRawSqlDataSource } from './datasource';\n\n/** A raw-SQL repository has a name but no model and no schema. */\nexport class RawSqlEntity extends AbstractEntity {\n getSchema<T = unknown>(_opts: { type: TSchemaType }): T {\n return {} as T;\n }\n}\n\n/**\n * A repository over a raw-SQL engine: it holds the datasource and reads `this.connector`, typed by\n * the connector the datasource was built with, so `this.connector.execute(...)` needs no cast. It\n * has no CRUD verbs - the subclass writes its own statements.\n *\n * Bind it with a datasource and no model, the same shape a remote repository has:\n * `@repository({ type: RepositoryTypes.REMOTE, dataSource: ReportDataSource })`.\n */\nexport abstract class BaseRawSqlRepository<TConnector extends IRawSqlConnector = IRawSqlConnector>\n extends BaseHelper\n implements IRepository\n{\n dataSource: BaseRawSqlDataSource<object, unknown, TConnector>;\n entity: AbstractEntity;\n\n constructor(dataSource: BaseRawSqlDataSource<object, unknown, TConnector>) {\n super({ scope: new.target.name });\n\n this.dataSource = dataSource;\n this.entity = new RawSqlEntity({ name: new.target.name });\n }\n\n getEntity(): AbstractEntity {\n return this.entity;\n }\n\n /** The engine's connector, typed by the generic this repository was declared with. */\n get connector(): TConnector {\n return this.dataSource.getConnector();\n }\n\n /** `this.connector.execute(query)`, for a repository that runs a statement and reads the rows. */\n protected execute(query: TRawSqlQuery): Promise<IRawSqlResult> {\n return this.connector.execute(query);\n }\n}\n"]}
@@ -2,7 +2,7 @@ import type { TDrizzleQueryOptions, TLockOptions } from '@venizia/ignis-kernel';
2
2
  import type { TNullable } from '@venizia/ignis-helpers/common';
3
3
  import type { AnyColumn, SQL } from 'drizzle-orm';
4
4
  import type { TTableSchemaWithId } from '../../models/common/index.js';
5
- /** Column subset for a projection, in Drizzle's own shape. `undefined` selects every column. */
5
+ /** Column subset for a projection: a flat record of name to column or SQL expression (`SQL`, `SQL.Aliased`). A nested object or a whole table is refused by the executors. `undefined` selects every column. */
6
6
  export type TColumnSelection = Record<string, unknown> | undefined;
7
7
  /** Input of a `select` call on the query executor; `connector` is the one resolved for the current operation or transaction. */
8
8
  export interface ISelectOptions<TConnector> {
@@ -1 +1 @@
1
- {"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/common/executor.ts"],"names":[],"mappings":"","sourcesContent":["import type { TDrizzleQueryOptions, TLockOptions } from '@venizia/ignis-kernel';\nimport type { TNullable } from '@venizia/ignis-helpers/common';\nimport type { AnyColumn, SQL } from 'drizzle-orm';\nimport type { TTableSchemaWithId } from '@/relational/core/models/common';\n\n/** Column subset for a projection, in Drizzle's own shape. `undefined` selects every column. */\nexport type TColumnSelection = Record<string, unknown> | undefined;\n\n/** Input of a `select` call on the query executor; `connector` is the one resolved for the current operation or transaction. */\nexport interface ISelectOptions<TConnector> {\n connector: TConnector;\n table: TTableSchemaWithId;\n columns?: TColumnSelection;\n where?: SQL;\n orderBy?: SQL[];\n limit?: number;\n offset?: number;\n /** Postgres `FOR UPDATE` and friends. Engines without row locking throw NotSupported. */\n lock?: TLockOptions;\n}\n\n/** Input of a `count` call on the query executor; `where` omitted counts every row. */\nexport interface ICountOptions<TConnector> {\n connector: TConnector;\n table: TTableSchemaWithId;\n where?: SQL;\n}\n\n/** Input of a relational (`findMany`/`findFirst` style) query on the query executor, run through Drizzle's relational query interface. */\nexport interface IRelationalQueryOptions<TConnector> {\n connector: TConnector;\n /** Schema registration key - the entity's `TABLE_NAME`, used to reach Drizzle's relational query interface. */\n entityName: string;\n query: TDrizzleQueryOptions;\n /** The calling repository's class name, so a thrown error names the class that failed rather than the executor. Falls back to the executor's own name when absent. */\n scope?: string;\n}\n\n/** Input of an `insert` call on the query executor; `shouldReturn` selects whether inserted rows are read back. */\nexport interface IInsertOptions<TConnector> {\n connector: TConnector;\n table: TTableSchemaWithId;\n values: Record<string, unknown> | Array<Record<string, unknown>>;\n /** `undefined` returns every column; omit the key entirely to return nothing. */\n returning?: TColumnSelection;\n shouldReturn: boolean;\n /** Turns the insert into an upsert: `ON CONFLICT (target) [WHERE targetWhere] DO UPDATE SET set [WHERE setWhere]`. A conflicting row that fails `setWhere` is left as it is and returned by nothing. */\n onConflict?: IInsertConflictOptions;\n}\n\n/** The conflict branch of an upsert; the repository reads `target` and `targetWhere` from a declared unique key before it gets here. */\nexport interface IInsertConflictOptions {\n /** The key's columns, from the table schema. */\n target: AnyColumn[];\n /** The predicate of a partial unique index, so the engine infers that index as the arbiter. */\n targetWhere?: SQL;\n /** Property to value for the update branch; columns with `$onUpdate` are added by Drizzle, as for an update. */\n set: Record<string, SQL>;\n /** Which existing rows the update branch may touch, read against the existing row. */\n setWhere?: SQL;\n}\n\n/** Input of an `update` call on the query executor; `where` omitted updates every row. */\nexport interface IUpdateOptions<TConnector> {\n connector: TConnector;\n table: TTableSchemaWithId;\n data: Record<string, unknown>;\n where?: SQL;\n returning?: TColumnSelection;\n shouldReturn: boolean;\n}\n\n/** Input of a `remove` call on the query executor; `where` omitted removes every row. */\nexport interface IRemoveOptions<TConnector> {\n connector: TConnector;\n table: TTableSchemaWithId;\n where?: SQL;\n returning?: TColumnSelection;\n shouldReturn: boolean;\n}\n\n/** A write's outcome. `count` is authoritative in both modes: with `shouldReturn` true it is `rows.length`, with it false the engine reads its driver's affected-row field and `rows` is empty. A bare `Array<R>` cannot express the second mode, which is why writes do not return one. */\nexport interface IWriteResult<R> {\n count: number;\n rows: Array<R>;\n}\n\n/** Every Drizzle call the shared repository tier makes, behind one engine-supplied port obtained via `dataSource.getQueryExecutor()`. Stateless: the connector is passed per call because the repository resolves a transaction-bound connector per operation. */\nexport interface IRelationalQueryExecutor<TConnector> {\n /** Whether `select` takes a row lock. SQLite locks the whole database, so it does not, and a lock there throws. */\n readonly supportsRowLock: boolean;\n select<R>(opts: ISelectOptions<TConnector>): Promise<Array<R>>;\n count(opts: ICountOptions<TConnector>): Promise<number>;\n findMany<R>(opts: IRelationalQueryOptions<TConnector>): Promise<Array<R>>;\n findFirst<R>(opts: IRelationalQueryOptions<TConnector>): Promise<TNullable<R>>;\n insert<R>(opts: IInsertOptions<TConnector>): Promise<IWriteResult<R>>;\n update<R>(opts: IUpdateOptions<TConnector>): Promise<IWriteResult<R>>;\n remove<R>(opts: IRemoveOptions<TConnector>): Promise<IWriteResult<R>>;\n}\n"]}
1
+ {"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/common/executor.ts"],"names":[],"mappings":"","sourcesContent":["import type { TDrizzleQueryOptions, TLockOptions } from '@venizia/ignis-kernel';\nimport type { TNullable } from '@venizia/ignis-helpers/common';\nimport type { AnyColumn, SQL } from 'drizzle-orm';\nimport type { TTableSchemaWithId } from '@/relational/core/models/common';\n\n/** Column subset for a projection: a flat record of name to column or SQL expression (`SQL`, `SQL.Aliased`). A nested object or a whole table is refused by the executors. `undefined` selects every column. */\nexport type TColumnSelection = Record<string, unknown> | undefined;\n\n/** Input of a `select` call on the query executor; `connector` is the one resolved for the current operation or transaction. */\nexport interface ISelectOptions<TConnector> {\n connector: TConnector;\n table: TTableSchemaWithId;\n columns?: TColumnSelection;\n where?: SQL;\n orderBy?: SQL[];\n limit?: number;\n offset?: number;\n /** Postgres `FOR UPDATE` and friends. Engines without row locking throw NotSupported. */\n lock?: TLockOptions;\n}\n\n/** Input of a `count` call on the query executor; `where` omitted counts every row. */\nexport interface ICountOptions<TConnector> {\n connector: TConnector;\n table: TTableSchemaWithId;\n where?: SQL;\n}\n\n/** Input of a relational (`findMany`/`findFirst` style) query on the query executor, run through Drizzle's relational query interface. */\nexport interface IRelationalQueryOptions<TConnector> {\n connector: TConnector;\n /** Schema registration key - the entity's `TABLE_NAME`, used to reach Drizzle's relational query interface. */\n entityName: string;\n query: TDrizzleQueryOptions;\n /** The calling repository's class name, so a thrown error names the class that failed rather than the executor. Falls back to the executor's own name when absent. */\n scope?: string;\n}\n\n/** Input of an `insert` call on the query executor; `shouldReturn` selects whether inserted rows are read back. */\nexport interface IInsertOptions<TConnector> {\n connector: TConnector;\n table: TTableSchemaWithId;\n values: Record<string, unknown> | Array<Record<string, unknown>>;\n /** `undefined` returns every column; omit the key entirely to return nothing. */\n returning?: TColumnSelection;\n shouldReturn: boolean;\n /** Turns the insert into an upsert: `ON CONFLICT (target) [WHERE targetWhere] DO UPDATE SET set [WHERE setWhere]`. A conflicting row that fails `setWhere` is left as it is and returned by nothing. */\n onConflict?: IInsertConflictOptions;\n}\n\n/** The conflict branch of an upsert; the repository reads `target` and `targetWhere` from a declared unique key before it gets here. */\nexport interface IInsertConflictOptions {\n /** The key's columns, from the table schema. */\n target: AnyColumn[];\n /** The predicate of a partial unique index, so the engine infers that index as the arbiter. */\n targetWhere?: SQL;\n /** Property to value for the update branch; columns with `$onUpdate` are added by Drizzle, as for an update. */\n set: Record<string, SQL>;\n /** Which existing rows the update branch may touch, read against the existing row. */\n setWhere?: SQL;\n}\n\n/** Input of an `update` call on the query executor; `where` omitted updates every row. */\nexport interface IUpdateOptions<TConnector> {\n connector: TConnector;\n table: TTableSchemaWithId;\n data: Record<string, unknown>;\n where?: SQL;\n returning?: TColumnSelection;\n shouldReturn: boolean;\n}\n\n/** Input of a `remove` call on the query executor; `where` omitted removes every row. */\nexport interface IRemoveOptions<TConnector> {\n connector: TConnector;\n table: TTableSchemaWithId;\n where?: SQL;\n returning?: TColumnSelection;\n shouldReturn: boolean;\n}\n\n/** A write's outcome. `count` is authoritative in both modes: with `shouldReturn` true it is `rows.length`, with it false the engine reads its driver's affected-row field and `rows` is empty. A bare `Array<R>` cannot express the second mode, which is why writes do not return one. */\nexport interface IWriteResult<R> {\n count: number;\n rows: Array<R>;\n}\n\n/** Every Drizzle call the shared repository tier makes, behind one engine-supplied port obtained via `dataSource.getQueryExecutor()`. Stateless: the connector is passed per call because the repository resolves a transaction-bound connector per operation. */\nexport interface IRelationalQueryExecutor<TConnector> {\n /** Whether `select` takes a row lock. SQLite locks the whole database, so it does not, and a lock there throws. */\n readonly supportsRowLock: boolean;\n select<R>(opts: ISelectOptions<TConnector>): Promise<Array<R>>;\n count(opts: ICountOptions<TConnector>): Promise<number>;\n findMany<R>(opts: IRelationalQueryOptions<TConnector>): Promise<Array<R>>;\n findFirst<R>(opts: IRelationalQueryOptions<TConnector>): Promise<TNullable<R>>;\n insert<R>(opts: IInsertOptions<TConnector>): Promise<IWriteResult<R>>;\n update<R>(opts: IUpdateOptions<TConnector>): Promise<IWriteResult<R>>;\n remove<R>(opts: IRemoveOptions<TConnector>): Promise<IWriteResult<R>>;\n}\n"]}
@@ -8,7 +8,7 @@ import type { TNullable } from '@venizia/ignis-helpers/common';
8
8
  */
9
9
  export declare class ScopeFilterDenial {
10
10
  /** The empty `inq` compiles to `sql\`false\`` in every dialect, deterministically matching zero rows. */
11
- static where<DataObject = any>(): TWhere<DataObject>;
11
+ static where<DataObject>(): TWhere<DataObject>;
12
12
  }
13
13
  /**
14
14
  * What a model's `access.resolve` returned, read once, the same way by the read path and the write guard.
@@ -21,7 +21,7 @@ export declare class ScopeFilterDenial {
21
21
  export declare class ScopeResolution {
22
22
  /** A non-empty plain object whose every value is defined, and whose `and` / `or` branches are themselves usable (an `and` has at least one). */
23
23
  private static isUsableWhere;
24
- static normalize<DataObject = any>(opts: {
24
+ static normalize<DataObject>(opts: {
25
25
  value: unknown;
26
26
  }): TNullable<TWhere<DataObject>> | typeof ScopeFilters.UNRESTRICTED;
27
27
  }