@venizia/ignis-connectors 0.2.0-4 → 0.2.0-41

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,40 @@
+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]>;
+    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;AAkGxB,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;gBAEzC,IAAI,EAAE,uBAAuB,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAsBvD,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;IAgBjF,+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,177 @@
+"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 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.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 url = new URL(this.network.getRequestUrl({ paths }));
+        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

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

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../src/http/repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAkB,MAAM,kCAAkC,CAAC;AAClF,OAAO,KAAK,EACV,mBAAmB,EACnB,MAAM,EACN,cAAc,EACd,OAAO,EACP,WAAW,EACX,MAAM,EACP,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,wDAAwD;AACxD,qBAAa,kBAAmB,SAAQ,cAAc;IACpD,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,GAAG,CAAC;CAGxD;AAED,qFAAqF;AACrF,qBAAa,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,OAAO,CAAE,YAAW,mBAAmB,CAAC,CAAC,EAAE,EAAE,CAAC;IAC3F,UAAU,EAAE,cAAc,CAAC;IAC3B,MAAM,EAAE,cAAc,CAAC;IAEvB,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC3B,uFAAuF;IACvF,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAOtF,SAAS,IAAI,cAAc;IAI3B,0FAA0F;IAC1F,SAAS,CAAC,oBAAoB,CAAC,IAAI,EAAE;QACnC,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;KAClB;IAYD,iGAAiG;IAC3F,KAAK,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAmChE,UAAU,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAStE,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QACtB,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QACnB,OAAO,EAAE;YAAE,gBAAgB,EAAE,IAAI,CAAA;SAAE,CAAC;KACrC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAoC3E,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK9E,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAC1B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QACpB,OAAO,CAAC,EAAE,EAAE,CAAC;KACd,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;CAStB"}

package/dist/cjs/http/repository.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpRepository = exports.HttpResourceEntity = void 0;
+const common_1 = require("@venizia/ignis-helpers/common");
+const repository_1 = require("@venizia/ignis-kernel/repository");
+const core_1 = require("@venizia/ignis-helpers/core");
+/** A remote resource has a name but no local schema. */
+class HttpResourceEntity extends repository_1.AbstractEntity {
+    getSchema(_opts) {
+        return {};
+    }
+}
+exports.HttpResourceEntity = HttpResourceEntity;
+/** Read access to one remote resource, in the `@venizia/ignis-filter` vocabulary. */
+class HttpRepository {
+    constructor(opts) {
+        this.dataSource = opts.dataSource;
+        this.resource = opts.resource;
+        this.countPath = opts.countPath;
+        this.entity = new HttpResourceEntity({ name: opts.resource });
+    }
+    getEntity() {
+        return this.entity;
+    }
+    /** No header and an unreadable one (`/*`) have different fixes, so different messages. */
+    getMissingTotalError(opts) {
+        const { method, contentRange, noHeader } = opts;
+        const message = contentRange
+            ? `Content-Range "${contentRange}" carries no readable total - an unknown "/*" or an unparseable value. Check the server's count query.`
+            : noHeader;
+        return (0, core_1.getError)({
+            statusCode: common_1.HTTP.ResultCodes.RS_5.InternalServerError,
+            message: `[${this.resource}][${method}] ${message}`,
+        });
+    }
+    /** From `Content-Range`, or `countPath`. No total throws rather than reporting the page size. */
+    async count(opts) {
+        if (this.countPath) {
+            const rs = await this.dataSource.read({
+                paths: [this.resource, this.countPath],
+                query: { where: opts.where },
+                shape: 'one',
+            });
+            const counted = rs.data?.count;
+            if (typeof counted !== 'number' || !Number.isFinite(counted)) {
+                throw (0, core_1.getError)({
+                    statusCode: common_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                    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)}`,
+                });
+            }
+            return { count: counted };
+        }
+        const rs = await this.dataSource.read({
+            paths: [this.resource],
+            query: { filter: { where: opts.where, limit: 1 } },
+        });
+        if (!rs.hasRange) {
+            throw this.getMissingTotalError({
+                method: 'count',
+                contentRange: rs.contentRange,
+                noHeader: `The response carried no Content-Range, so there is no total to report - answering with the page size would claim ${rs.dataLength}. Give this repository a countPath if the API publishes a count route.`,
+            });
+        }
+        return { count: rs.total ?? 0 };
+    }
+    async existsWith(opts) {
+        const rs = await this.dataSource.read({
+            paths: [this.resource],
+            query: { filter: { where: opts.where, limit: 1 } },
+        });
+        return rs.dataLength > 0;
+    }
+    async find(opts) {
+        const rs = await this.dataSource.read({
+            paths: [this.resource],
+            query: { filter: opts.filter ?? {} },
+        });
+        const data = rs.data ?? [];
+        if (!opts.options?.shouldQueryRange) {
+            return data;
+        }
+        if (!rs.hasRange) {
+            throw this.getMissingTotalError({
+                method: 'find',
+                contentRange: rs.contentRange,
+                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.`,
+            });
+        }
+        return {
+            data,
+            // An empty page names no start: take it from the filter, as the server did.
+            range: (0, repository_1.buildDataRange)({
+                skip: rs.skip ?? opts.filter?.skip,
+                offset: opts.filter?.offset,
+                dataLength: data.length,
+                total: rs.total ?? 0,
+            }),
+        };
+    }
+    async findOne(opts) {
+        const rs = await this.find({ filter: { ...(opts.filter ?? {}), limit: 1 } });
+        return rs[0] ?? null;
+    }
+    async findById(opts) {
+        const rs = await this.dataSource.read({
+            paths: [this.resource, `${opts.id}`],
+            query: { filter: opts.filter ?? {} },
+            shape: 'one',
+        });
+        return rs.data ?? null;
+    }
+}
+exports.HttpRepository = HttpRepository;
+//# sourceMappingURL=repository.js.map

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

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

package/dist/cjs/index.d.ts

@@ -1,3 +1,4 @@
+export * from './common';
 export * from './relational/core';
 export * from './search/core';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC"}

package/dist/cjs/index.js

@@ -14,6 +14,7 @@ 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"), exports);
 __exportStar(require("./relational/core"), exports);
 __exportStar(require("./search/core"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,gDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,oDAAkC;AAClC,gDAA8B"}