@venizia/ignis-connectors 0.2.0-8 → 0.2.0

package/README.md

@@ -0,0 +1,146 @@
+# @venizia/ignis-connectors
+
+The datasources, drivers, entity bases and repositories IGNIS uses to reach a backing engine: SQL
+through Drizzle (Postgres, PGlite, SQLite), search engines (Typesense, Meilisearch), and another
+IGNIS server over HTTP.
+
+Server applications get these through `@venizia/ignis` and its sub-paths. Install this package
+directly when you use the connectors without the server, for example in a browser Worker.
+
+## Install
+
+For Postgres through `pg`:
+
+```bash
+bun add @venizia/ignis-connectors @venizia/ignis-kernel drizzle-orm drizzle-zod hono @hono/zod-openapi pg
+```
+
+Every peer is optional. Each entry point needs its own set - see the table in
+[Entry points](#entry-points).
+
+## Example
+
+Declare the tables with Drizzle first. `ModelFactory.defineEntity` turns each table into an entity,
+and a relation points at a table, not at another entity class:
+
+```typescript
+import { datasource, model, repository } from '@venizia/ignis-kernel';
+import {
+  BasePostgresDataSource,
+  DefaultCRUDRepository,
+  generateIdColumnDefs,
+  many,
+  ModelFactory,
+  one,
+  type TEntityObject,
+} from '@venizia/ignis-connectors/postgres';
+import { NodePostgresDriver } from '@venizia/ignis-connectors/postgres/node-postgres';
+import { pgTable, text } from 'drizzle-orm/pg-core';
+import { Pool } from 'pg';
+
+export const authorTable = pgTable('Author', {
+  ...generateIdColumnDefs({ id: { dataType: 'string' } }),
+  name: text('name').notNull(),
+});
+
+export const postTable = pgTable('Post', {
+  ...generateIdColumnDefs({ id: { dataType: 'string' } }),
+  authorId: text('author_id').notNull().references(() => authorTable.id),
+  title: text('title').notNull(),
+});
+
+@model({ type: 'entity' })
+export class Author extends ModelFactory.defineEntity({
+  table: authorTable,
+  relations: () => ({ posts: many(postTable, { relationName: 'author' }) }),
+}) {}
+
+@model({ type: 'entity' })
+export class Post extends ModelFactory.defineEntity({
+  table: postTable,
+  relations: () => ({ author: one(authorTable) }),
+}) {}
+
+@datasource({ driver: NodePostgresDriver })
+export class BlogDataSource extends BasePostgresDataSource<{ connectionString: string }> {
+  constructor() {
+    super({ name: BlogDataSource.name, config: { connectionString: 'postgres://localhost/blog' } });
+  }
+
+  override configure(): void {
+    this.client = new Pool(this.settings);
+  }
+
+  override getConnectionString(): string {
+    return this.settings.connectionString;
+  }
+}
+
+@repository({ model: Author, dataSource: BlogDataSource })
+export class AuthorRepository extends DefaultCRUDRepository<typeof authorTable> {}
+
+@repository({ model: Post, dataSource: BlogDataSource })
+export class PostRepository extends DefaultCRUDRepository<typeof postTable> {}
+
+const dataSource = new BlogDataSource();
+dataSource.configure();
+
+const authors = new AuthorRepository(dataSource);
+const found = await authors.find<TEntityObject<typeof Author>>({
+  filter: { where: { name: 'Ada' }, include: [{ relation: 'posts' }] },
+});
+console.log(found[0]?.posts?.map(post => post.title));
+```
+
+Notice what you did not write:
+
+- `one(authorTable)` has no `fields` or `references`. It reads them off the one foreign key from
+  `Post` to `Author`. With two keys to the same table, it throws and names them, so you write
+  `fields`/`references` for that relation.
+- `many(postTable, { relationName: 'author' })` pairs with the `one()` named `author` on `Post`.
+- The datasource has no schema. It collects the tables from every `@repository` bound to it.
+- `generateIdColumnDefs({ id: { dataType: 'string' } })` gives a text primary key filled with a UUID v7.
+
+A class that extends `BaseRelationalEntity` with a hand-written static `schema` still works. Both
+styles can live in one application.
+
+## Entry points
+
+| Import | What it gives | Extra peers |
+|---|---|---|
+| `@venizia/ignis-connectors` | The engine-neutral tiers: `BaseRelationalDataSource`, `BaseRelationalEntity`, `ModelFactory`, the relational repository chain, `RelationalMigrationRunner`, `RecursiveTreeSql`, and the search tier | `drizzle-orm`, `drizzle-zod`, `hono`, `@hono/zod-openapi` |
+| `/relational` | The engine-neutral SQL tier alone | `drizzle-orm`, `drizzle-zod`, `hono`, `@hono/zod-openapi` |
+| `/postgres` | `BasePostgresDataSource`, `DefaultCRUDRepository` and its chain, `ModelFactory`, `one`, `many`, the column helpers, `IsolationLevels`, `RecursiveTreeSql` | `drizzle-orm`, `drizzle-zod`, `hono`, `@hono/zod-openapi` |
+| `/postgres/node-postgres` | `NodePostgresDriver` | `drizzle-orm`, `pg` |
+| `/postgres/postgres-js` | `PostgresJsDriver` | `drizzle-orm`, `postgres` |
+| `/postgres/pglite` | `PGliteDriver` - Postgres in WASM, in memory or in the browser's OPFS | `drizzle-orm`, `@electric-sql/pglite` |
+| `/postgres/supabase` | `withAuthContext`, `PoolerModes`, `buildPostgresJsOptions`, and the Supabase role and table helpers | `drizzle-orm` |
+| `/sqlite` | `BaseSqliteDataSource`, `DefaultSqliteRepository` and its chain, `ModelFactory`, `RecursiveTreeSql` | `drizzle-orm`, `drizzle-zod`, `hono`, `@hono/zod-openapi` |
+| `/sqlite/libsql` | `LibSqlDriver` | `drizzle-orm`, `drizzle-zod`, `hono`, `@hono/zod-openapi`, `@libsql/client` |
+| `/search` | The engine-neutral search tier: `BaseSearchDataSource`, `BaseSearchEntity`, `DefaultSearchRepository` and its chain | none |
+| `/search/controllers` | `AbstractSearchController`, `SearchControllerFactory` | `hono`, `@hono/zod-openapi` |
+| `/typesense` | `TypesenseDataSource`, `TypesenseConnector`, `TypesenseQueryDialect`, plus everything in `/search` | `typesense` |
+| `/typesense/controllers` | The same search controllers as `/search/controllers` | `hono`, `@hono/zod-openapi` |
+| `/meilisearch` | `MeilisearchDataSource`, `MeilisearchConnector`, `MeilisearchQueryDialect` | `meilisearch` |
+| `/http` | `HttpDataSource` and `HttpRepository` - read another IGNIS server's REST routes with the same filter vocabulary | none |
+
+The root entry imports no driver and no engine client. A driver loads only when you import its
+entry and name its class in `@datasource({ driver })`.
+
+## Where it sits
+
+Depends on `@venizia/ignis-kernel`, `@venizia/ignis-filter`, `@venizia/ignis-helpers` and
+`@venizia/ignis-inversion`. Used by `@venizia/ignis`, which re-exports every sub-path under the same
+name (`@venizia/ignis/postgres`, ...) except `/http`. Its root re-exports `/postgres`.
+
+## Links
+
+- [Connectors](https://ignis.venizia.ai/references/base/connectors)
+- [Models](https://ignis.venizia.ai/guides/core-concepts/persistent/models) and [relations](https://ignis.venizia.ai/references/base/repositories/relations)
+- [Postgres drivers and Supabase](https://ignis.venizia.ai/guides/core-concepts/persistent/postgres-drivers), [PGlite](https://ignis.venizia.ai/guides/core-concepts/persistent/pglite), [SQLite](https://ignis.venizia.ai/guides/core-concepts/persistent/sqlite)
+- [Typesense](https://ignis.venizia.ai/guides/core-concepts/persistent/search-typesense), [Meilisearch](https://ignis.venizia.ai/guides/core-concepts/persistent/search-meilisearch)
+- [Changelog: define an entity from its table](https://ignis.venizia.ai/changelogs/2026-09-19-define-entity)
+- [Changelog: an HTTP connector](https://ignis.venizia.ai/changelogs/2026-09-17-an-http-connector)
+- [All changelogs](https://ignis.venizia.ai/changelogs/)
+
+MIT licensed - see [LICENSE.md](https://github.com/VENIZIA-AI/ignis/blob/main/LICENSE.md).

package/dist/cjs/common/index.d.ts

@@ -0,0 +1,2 @@
+export * from './scope-filter';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/cjs/common/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./scope-filter"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B"}

package/dist/cjs/common/scope-filter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Refuses to boot when `settings.scopeFilter` is declared where it cannot be honoured. Both cases
+ * are silent at runtime and fail in OPPOSITE directions: a search-backed model returns more rows,
+ * a context-less one returns none. The caller supplies `asyncContextEnabled` so no application
+ * config type reaches into this tier.
+ */
+export declare const assertScopeFilterSupported: (opts: {
+    asyncContextEnabled: boolean;
+}) => void;
+//# sourceMappingURL=scope-filter.d.ts.map

package/dist/cjs/common/scope-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-filter.d.ts","sourceRoot":"","sources":["../../../src/common/scope-filter.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GAAI,MAAM;IAAE,mBAAmB,EAAE,OAAO,CAAA;CAAE,KAAG,IA4CnF,CAAC"}

package/dist/cjs/common/scope-filter.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertScopeFilterSupported = void 0;
+const common_1 = require("@venizia/ignis-helpers/common");
+const core_1 = require("@venizia/ignis-helpers/core");
+const ignis_kernel_1 = require("@venizia/ignis-kernel");
+const models_1 = require("../search/core/models");
+/**
+ * Refuses to boot when `settings.scopeFilter` is declared where it cannot be honoured. Both cases
+ * are silent at runtime and fail in OPPOSITE directions: a search-backed model returns more rows,
+ * a context-less one returns none. The caller supplies `asyncContextEnabled` so no application
+ * config type reaches into this tier.
+ */
+const assertScopeFilterSupported = (opts) => {
+    const models = ignis_kernel_1.MetadataRegistry.getInstance().getAllModels();
+    const searchBacked = [];
+    const withoutAmbientContext = [];
+    for (const [name, entry] of models) {
+        if (!entry.metadata?.settings?.scopeFilter) {
+            continue;
+        }
+        const modelClass = (0, common_1.resolveValue)({ value: entry.target });
+        if (modelClass === models_1.BaseSearchEntity || modelClass.prototype instanceof models_1.BaseSearchEntity) {
+            searchBacked.push(name);
+            continue;
+        }
+        if (!opts.asyncContextEnabled) {
+            withoutAmbientContext.push(name);
+        }
+    }
+    if (searchBacked.length > 0) {
+        throw (0, core_1.getError)({
+            message: [
+                `[assertScopeFilterSupported] settings.scopeFilter on a search-backed model | models: ${searchBacked.join(', ')}`,
+                'Search repositories never read this setting, so no row scope is applied.',
+                'Unlike the relational path, a missing scope here returns MORE rows rather than none - nothing fails, the result is just wider.',
+                'Scope the search query in the application, and remove settings.scopeFilter from the model.',
+            ].join(' | '),
+        });
+    }
+    if (withoutAmbientContext.length > 0) {
+        throw (0, core_1.getError)({
+            message: [
+                `[assertScopeFilterSupported] settings.scopeFilter declared while asyncContext.enable is false | models: ${withoutAmbientContext.join(', ')}`,
+                'scopeFilter.resolve() takes no arguments, so the ambient request context is its only input.',
+                'With no context store every resolve() returns undefined, onMissing denies by default, and EVERY query on these models matches zero rows - with nothing naming the flag as the cause.',
+                'Set asyncContext.enable to true, or remove settings.scopeFilter.',
+            ].join(' | '),
+        });
+    }
+};
+exports.assertScopeFilterSupported = assertScopeFilterSupported;
+//# sourceMappingURL=scope-filter.js.map

package/dist/cjs/common/scope-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-filter.js","sourceRoot":"","sources":["../../../src/common/scope-filter.ts"],"names":[],"mappings":";;;AAAA,0DAA6D;AAC7D,sDAAuD;AACvD,wDAAyD;AACzD,iDAAwD;AAExD;;;;;GAKG;AACI,MAAM,0BAA0B,GAAG,CAAC,IAAsC,EAAQ,EAAE;IACzF,MAAM,MAAM,GAAG,+BAAgB,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,CAAC;IAE7D,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,MAAM,qBAAqB,GAAa,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;YAC3C,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,IAAA,qBAAY,EAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAEzD,IAAI,UAAU,KAAK,yBAAgB,IAAI,UAAU,CAAC,SAAS,YAAY,yBAAgB,EAAE,CAAC;YACxF,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,SAAS;QACX,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC9B,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE;gBACP,wFAAwF,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACjH,0EAA0E;gBAC1E,gIAAgI;gBAChI,4FAA4F;aAC7F,CAAC,IAAI,CAAC,KAAK,CAAC;SACd,CAAC,CAAC;IACL,CAAC;IAED,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE;gBACP,2GAA2G,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBAC7I,6FAA6F;gBAC7F,sLAAsL;gBACtL,kEAAkE;aACnE,CAAC,IAAI,CAAC,KAAK,CAAC;SACd,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC;AA5CW,QAAA,0BAA0B,8BA4CrC"}

package/dist/cjs/http/common/types.d.ts

@@ -0,0 +1,34 @@
+import type { TFilter } from '@venizia/ignis-filter';
+export interface IAuthToken {
+    value: string;
+    type?: string;
+    provider?: string;
+}
+/** `undefined` means no token. */
+export type TAuthTokenResolver = () => IAuthToken | undefined;
+/** Not `Record` alone: header names are case-insensitive, and an object merge appends two spellings. */
+export type THttpHeaders = Headers | Array<[string, string]> | Record<string, string>;
+export interface IHttpDataSourceSettings {
+    baseUrl: string;
+    /** Sent on every request. `x-request-count` is refused - the connector owns it. */
+    headers?: THttpHeaders;
+    /** Wins over `authTokenResolver`. */
+    authToken?: IAuthToken;
+    authTokenResolver?: TAuthTokenResolver;
+    /** Runs on a 401: `true` retries once (re-resolving the token), `false` lets the 401 stand. */
+    onUnauthorized?: () => Promise<boolean> | boolean;
+}
+/** A list with no `Content-Range` has no total - `hasRange` says so rather than using the page size. */
+export interface IHttpReadResult<R> {
+    data: R;
+    hasRange: boolean;
+    /** Raw header: tells a present-but-unreadable one from an absent one. */
+    contentRange?: string;
+    total?: number;
+    skip?: number;
+    dataLength: number;
+}
+export type THttpQuery<E extends object> = {
+    filter?: TFilter<E>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/http/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/http/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,kCAAkC;AAClC,MAAM,MAAM,kBAAkB,GAAG,MAAM,UAAU,GAAG,SAAS,CAAC;AAE9D,wGAAwG;AACxG,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACtF,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAEhB,mFAAmF;IACnF,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB,qCAAqC;IACrC,SAAS,CAAC,EAAE,UAAU,CAAC;IAEvB,iBAAiB,CAAC,EAAE,kBAAkB,CAAC;IAEvC,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACnD;AAED,wGAAwG;AACxG,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,IAAI;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC"}

package/dist/cjs/http/common/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/http/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/http/common/types.ts"],"names":[],"mappings":""}

package/dist/cjs/http/datasource.d.ts

@@ -0,0 +1,42 @@
+import { AbstractDataSource } from '@venizia/ignis-kernel/repository';
+import { NodeFetchNetworkRequest } from '@venizia/ignis-helpers/core';
+import type { IAuthToken, IHttpDataSourceSettings, IHttpReadResult } from './common/types';
+/** Reads an IGNIS REST server through the repository contract. Targets IGNIS, not any REST API. */
+export declare class HttpDataSource extends AbstractDataSource<IHttpDataSourceSettings> {
+    name: string;
+    settings: IHttpDataSourceSettings;
+    schema: never;
+    protected network: NodeFetchNetworkRequest;
+    /** Normalised once: every request copies these, never re-parses `settings.headers`. */
+    protected configuredHeaders: Array<[string, string]>;
+    /** Decided once: a relative baseUrl (`/api`) needs a location to resolve against on every request. */
+    protected isRelativeBaseUrl: boolean;
+    constructor(opts: IHttpDataSourceSettings & {
+        name?: string;
+    });
+    configure(): Promise<void>;
+    getCapabilities(): {
+        transactions: boolean;
+    };
+    protected resolveAuthToken(): IAuthToken | undefined;
+    protected buildHeaders(opts: {
+        token?: IAuthToken;
+    }): Headers;
+    buildUrl(opts: {
+        paths: Array<string>;
+        query?: Record<string, unknown>;
+    }): string;
+    /** The raw `Response` - for what is not rows, like an export. Auth and the 401 retry apply. */
+    request(opts: {
+        paths: Array<string>;
+        query?: Record<string, unknown>;
+        method?: string;
+    }): Promise<Response>;
+    /** Rows plus the total from `Content-Range`, reported absent when the header is. */
+    read<R>(opts: {
+        paths: Array<string>;
+        query?: Record<string, unknown>;
+        shape?: 'list' | 'one';
+    }): Promise<IHttpReadResult<R>>;
+}
+//# sourceMappingURL=datasource.d.ts.map

package/dist/cjs/http/datasource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasource.d.ts","sourceRoot":"","sources":["../../../src/http/datasource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,KAAK,EACV,UAAU,EACV,uBAAuB,EACvB,eAAe,EAEhB,MAAM,gBAAgB,CAAC;AAqGxB,mGAAmG;AACnG,qBAAa,cAAe,SAAQ,kBAAkB,CAAC,uBAAuB,CAAC;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,uBAAuB,CAAC;IAClC,MAAM,EAAS,KAAK,CAAC;IAE9B,SAAS,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC3C,uFAAuF;IACvF,SAAS,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,sGAAsG;IACtG,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAC;gBAEzB,IAAI,EAAE,uBAAuB,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAuBvD,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEvB,eAAe;;;IAIxB,SAAS,CAAC,gBAAgB,IAAI,UAAU,GAAG,SAAS;IAIpD,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO;IAqB7D,QAAQ,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,MAAM;IA2BjF,+FAA+F;IACzF,OAAO,CAAC,IAAI,EAAE;QAClB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAuBrB,oFAAoF;IAC9E,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE;QAClB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;KACxB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CAwBhC"}

package/dist/cjs/http/datasource.js

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpDataSource = void 0;
+const repository_1 = require("@venizia/ignis-kernel/repository");
+const common_1 = require("@venizia/ignis-helpers/common");
+const core_1 = require("@venizia/ignis-helpers/core");
+const core_2 = require("@venizia/ignis-helpers/core");
+const MAX_URL_IN_MESSAGE = 256;
+/** A leading RFC 3986 scheme makes a URL absolute. Read by pattern: `URL.canParse` needs Safari 17 or Chrome 120, and this runs in pages. */
+const URL_SCHEME_PATTERN = /^[a-z][a-z\d+.-]*:/i;
+/** A long `inq` makes a URL 200 KB: the message keeps its head and length. 414/431 name the URL. */
+const describeUrl = (opts) => {
+    const { url, status } = opts;
+    const shown = url.length > MAX_URL_IN_MESSAGE
+        ? `${url.slice(0, MAX_URL_IN_MESSAGE)}... (${url.length} chars)`
+        : url;
+    const isTooLong = status === common_1.HTTP.ResultCodes.RS_4.URITooLong ||
+        status === common_1.HTTP.ResultCodes.RS_4.RequestHeaderFieldsTooLarge;
+    return isTooLong
+        ? `${shown} | The URL is too long for a GET - split the filter (a long inq) into smaller requests.`
+        : shown;
+};
+/**
+ * A list is a bare array or the `{ count, data }` envelope; `one` is never unwrapped, since a record
+ * may carry `data` and `count` columns. The envelope `count` is the page size, never the total.
+ *
+ * Anything else asked for as a list throws: counting it as one row is how `existsWith` answers true
+ * for an empty result and a page reports a length it does not have.
+ */
+const unwrapBody = (opts) => {
+    const { body, shape, url } = opts;
+    if (shape === 'one' || Array.isArray(body)) {
+        return body;
+    }
+    if (body && typeof body === 'object' && 'data' in body && 'count' in body) {
+        return body.data;
+    }
+    throw (0, core_2.getError)({
+        statusCode: common_1.HTTP.ResultCodes.RS_5.InternalServerError,
+        message: `[read] A list was asked for and the response is neither an array nor a { count, data } envelope | ${url}`,
+    });
+};
+// `records 0-24/137` -> skip 0, total 137; an empty page `records */137` -> total 137; else undefined.
+const readContentRange = (opts) => {
+    const { header } = opts;
+    if (!header) {
+        return undefined;
+    }
+    const range = header.match(/(\d+)\s*-\s*(\d+)\s*\/\s*(\d+)/);
+    if (range) {
+        return { skip: Number(range[1]), total: Number(range[3]) };
+    }
+    const unsatisfied = header.match(/\*\s*\/\s*(\d+)/);
+    if (unsatisfied) {
+        return { total: Number(unsatisfied[1]) };
+    }
+    return undefined;
+};
+/**
+ * Caller headers as unique lowercase pairs, last spelling winning.
+ *
+ * Never `new Headers(input)`: that constructor APPENDS, so `{ 'X-Tenant': 'north', 'x-tenant':
+ * 'south' }` - which a merge of two config objects produces - reaches the wire as `"north, south"`,
+ * a value neither caller wrote. A `Headers` instance arrives already joined; that one is the
+ * caller's own, and is passed through as it stands.
+ */
+const toHeaderEntries = (opts) => {
+    const { headers } = opts;
+    if (!headers) {
+        return [];
+    }
+    const source = headers instanceof Headers
+        ? [...headers.entries()]
+        : Array.isArray(headers)
+            ? headers
+            : Object.entries(headers);
+    const merged = new Map();
+    for (const [name, value] of source) {
+        merged.set(name.toLowerCase(), value);
+    }
+    return [...merged.entries()];
+};
+/** Reads an IGNIS REST server through the repository contract. Targets IGNIS, not any REST API. */
+class HttpDataSource extends repository_1.AbstractDataSource {
+    constructor(opts) {
+        super({ scope: opts.name ?? HttpDataSource.name });
+        this.schema = {};
+        const { name = 'http', ...settings } = opts;
+        const configured = toHeaderEntries({ headers: settings.headers });
+        if (configured.some(([headerName]) => headerName === common_1.HTTP.Headers.REQUEST_COUNT_DATA)) {
+            throw (0, core_2.getError)({
+                statusCode: common_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                message: `[${name}] ${common_1.HTTP.Headers.REQUEST_COUNT_DATA} is owned by HttpDataSource and always sent as false: rows come back bare, the total in Content-Range.`,
+            });
+        }
+        this.configuredHeaders = configured;
+        this.name = name;
+        this.settings = settings;
+        this.isRelativeBaseUrl = !URL_SCHEME_PATTERN.test(settings.baseUrl);
+        this.network = new core_1.NodeFetchNetworkRequest({
+            name,
+            networkOptions: { baseUrl: settings.baseUrl },
+        });
+    }
+    async configure() { }
+    getCapabilities() {
+        return { transactions: false };
+    }
+    resolveAuthToken() {
+        return this.settings.authToken ?? this.settings.authTokenResolver?.();
+    }
+    buildHeaders(opts) {
+        const { token } = opts;
+        const headers = new Headers(this.configuredHeaders);
+        // Set last: under the envelope a record read answers `{ count, data }`.
+        headers.set(common_1.HTTP.Headers.REQUEST_COUNT_DATA, 'false');
+        if (!token) {
+            return headers;
+        }
+        headers.set(common_1.HTTP.Headers.AUTHORIZATION, `${token.type ?? 'Bearer'} ${token.value}`);
+        // Unconditionally it would send the string "undefined".
+        if (token.provider) {
+            headers.set('x-auth-provider', token.provider);
+        }
+        return headers;
+    }
+    buildUrl(opts) {
+        const { paths, query } = opts;
+        const requestUrl = this.network.getRequestUrl({ paths });
+        // A page or a Web Worker has a location to resolve '/api' against; a server has none.
+        const locationHref = this.isRelativeBaseUrl ? globalThis.location?.href : undefined;
+        if (this.isRelativeBaseUrl && !locationHref) {
+            throw (0, core_2.getError)({
+                statusCode: common_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                message: `[${this.name}] Relative baseUrl '${this.settings.baseUrl}' needs a page or worker location to resolve against, and there is none here | Pass an absolute baseUrl such as 'https://api.example.com'`,
+            });
+        }
+        const url = new URL(requestUrl, locationHref);
+        const parameters = Object.entries(query ?? {});
+        for (const [key, value] of parameters) {
+            if (value === undefined) {
+                continue;
+            }
+            url.searchParams.set(key, typeof value === 'string' ? value : JSON.stringify(value));
+        }
+        return url.toString();
+    }
+    /** The raw `Response` - for what is not rows, like an export. Auth and the 401 retry apply. */
+    async request(opts) {
+        const url = this.buildUrl(opts);
+        const send = () => this.network.getNetworkService().send({
+            url,
+            method: (opts.method ?? common_1.HTTP.Methods.GET),
+            headers: this.buildHeaders({ token: this.resolveAuthToken() }),
+        });
+        let response = await send();
+        if (response.status === common_1.HTTP.ResultCodes.RS_4.Unauthorized && this.settings.onUnauthorized) {
+            const shouldRetry = await this.settings.onUnauthorized();
+            if (shouldRetry) {
+                response = await send();
+            }
+        }
+        return response;
+    }
+    /** Rows plus the total from `Content-Range`, reported absent when the header is. */
+    async read(opts) {
+        const response = await this.request(opts);
+        if (!response.ok) {
+            throw (0, core_2.getError)({
+                statusCode: response.status,
+                message: `[${this.name}][read] ${response.status} | ${describeUrl({ url: this.buildUrl(opts), status: response.status })}`,
+            });
+        }
+        const body = await response.json();
+        const contentRange = response.headers.get(common_1.HTTP.Headers.CONTENT_RANGE) ?? undefined;
+        const range = readContentRange({ header: contentRange ?? null });
+        const data = unwrapBody({ body, shape: opts.shape ?? 'list', url: this.buildUrl(opts) });
+        return {
+            data,
+            hasRange: range !== undefined,
+            contentRange,
+            total: range?.total,
+            skip: range?.skip,
+            dataLength: Array.isArray(data) ? data.length : 1,
+        };
+    }
+}
+exports.HttpDataSource = HttpDataSource;
+//# sourceMappingURL=datasource.js.map

package/dist/cjs/http/datasource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasource.js","sourceRoot":"","sources":["../../../src/http/datasource.ts"],"names":[],"mappings":"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"}

package/dist/cjs/http/index.d.ts

@@ -0,0 +1,4 @@
+export * from './common/types';
+export * from './datasource';
+export * from './repository';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/http/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/cjs/http/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./common/types"), exports);
+__exportStar(require("./datasource"), exports);
+__exportStar(require("./repository"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/http/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,+CAA6B;AAC7B,+CAA6B"}

package/dist/cjs/http/repository.d.ts

@@ -0,0 +1,59 @@
+import { AbstractEntity } from '@venizia/ignis-kernel/repository';
+import type { IReadableRepository, TCount, TDataWithRange, TFilter, TSchemaType, TWhere } from '@venizia/ignis-kernel/repository';
+import type { AnyType } from '@venizia/ignis-helpers/common';
+import type { HttpDataSource } from './datasource';
+/** A remote resource has a name but no local schema. */
+export declare class HttpResourceEntity extends AbstractEntity {
+    getSchema<T = unknown>(_opts: {
+        type: TSchemaType;
+    }): T;
+}
+/** Read access to one remote resource, in the `@venizia/ignis-filter` vocabulary. */
+export declare class HttpRepository<E extends object = AnyType> implements IReadableRepository<E, {}> {
+    dataSource: HttpDataSource;
+    entity: AbstractEntity;
+    protected resource: string;
+    /** A count route, if the API has one. Absent, the total comes from `Content-Range`. */
+    protected countPath?: string;
+    constructor(opts: {
+        dataSource: HttpDataSource;
+        resource: string;
+        countPath?: string;
+    });
+    getEntity(): AbstractEntity;
+    /** No header and an unreadable one (`/*`) have different fixes, so different messages. */
+    protected getMissingTotalError(opts: {
+        method: string;
+        contentRange?: string;
+        noHeader: string;
+    }): import("@venizia/ignis-helpers/core").ApplicationError;
+    /** From `Content-Range`, or `countPath`. No total throws rather than reporting the page size. */
+    count(opts: {
+        where: TWhere<E>;
+        options?: {};
+    }): Promise<TCount>;
+    existsWith(opts: {
+        where: TWhere<E>;
+        options?: {};
+    }): Promise<boolean>;
+    find<R = E>(opts: {
+        filter: TFilter<E>;
+        options: {
+            shouldQueryRange: true;
+        };
+    }): Promise<TDataWithRange<R>>;
+    find<R = E>(opts: {
+        filter?: TFilter<E>;
+        options?: {};
+    }): Promise<Array<R>>;
+    findOne<R = E>(opts: {
+        filter?: TFilter<E>;
+        options?: {};
+    }): Promise<R | null>;
+    findById<R = E>(opts: {
+        id: string | number;
+        filter?: TFilter<E>;
+        options?: {};
+    }): Promise<R | null>;
+}
+//# sourceMappingURL=repository.d.ts.map