breeze-client 2.2.2 → 3.0.0

package/adapters/http.js

@@ -0,0 +1,202 @@
+import { config } from '../config/config.js';
+import { core } from '../core/core.js';
+import { appendQueryStringParameter, encodeParams } from './adapter-core.js';
+/*
+ * How Breeze makes HTTP requests.
+ *
+ * Breeze 3 needs no ajax adapter. Data service adapters send their requests through
+ * `config.fetch` - set with `configureBreeze({ fetch })` - which defaults to
+ * `globalThis.fetch`. This module is the one implementation of that path: turning Breeze's
+ * description of a request into a fetch call, and reading the response back.
+ *
+ * The ajax adapter contract (`AjaxAdapter`, the "ajax" registry slot) remains as a
+ * deprecated compatibility layer. `AjaxFetchAdapter` is built on the functions here, and so
+ * is the adapter data service adapters fall back to when none is registered.
+ *
+ * This module imports './config' and './core' directly, never the './breeze' barrel: the
+ * abstract data service adapter depends on it, and the barrel depends on that.
+ */
+/** The transport used when none is supplied. Wrapped so that `fetch` keeps its receiver,
+    which some environments require. */
+export const defaultFetch = (input, init) => globalThis.fetch(input, init);
+/** Turns Breeze's description of a request into the arguments for a fetch call. */
+export function toFetchArgs(request) {
+    const hasBody = request.type !== "GET" && request.type !== "HEAD";
+    // Content-Type describes a body, so a GET gets none - which also keeps it a CORS
+    // "simple request" with no preflight. Headers on the request are merged in last; the
+    // fetch adapter used to ignore them.
+    const headers = {};
+    if (hasBody) {
+        headers['Content-Type'] = request.contentType || 'application/json';
+    }
+    Object.assign(headers, request.headers);
+    const init = {
+        method: request.type,
+        mode: 'cors',
+        cache: 'no-cache',
+        credentials: 'include',
+        headers: headers,
+        redirect: 'follow',
+        // 'referrer' is deliberately unset. 'client' is the browser default, but Node's fetch
+        // (undici) rejects it as an invalid URL, so setting it explicitly breaks server-side
+        // and test usage for no gain.
+    };
+    if (hasBody) {
+        const data = request.data;
+        init.body = typeof data === "string" ? data : JSON.stringify(data);
+    }
+    let url = request.url;
+    if (!core.isEmpty(request.params)) {
+        url = appendQueryStringParameter(url, encodeParams(request.params));
+    }
+    return { url, init };
+}
+/**
+ * Sends one request and resolves with its outcome. Never rejects: a transport failure is
+ * reported with status 0, and a body that cannot be read with the real HTTP status.
+ */
+export async function sendFetch(fetchFn, url, init, request) {
+    let response;
+    try {
+        response = await fetchFn(url, init);
+    }
+    catch (err) {
+        return failure(request, 0, errorText(err), null, null, err);
+    }
+    let data;
+    try {
+        data = response.ok ? await response.json() : await response.text();
+    }
+    catch (err) {
+        return failure(request, response.status, 'Unable to read the response body: ' + errorText(err), null, response, err);
+    }
+    return response.ok
+        ? success(request, data, response.statusText, response)
+        : failure(request, response.status, response.statusText, data, response, null);
+}
+function success(request, data, statusText, response) {
+    return {
+        succeeded: true,
+        httpResponse: {
+            config: request,
+            data: data,
+            getHeaders: getHeadersFn(response),
+            status: response ? response.status : 200,
+            statusText: statusText,
+        },
+    };
+}
+function failure(request, status, statusText, body, response, errorThrown) {
+    return {
+        succeeded: false,
+        httpResponse: {
+            config: request,
+            data: body,
+            error: errorThrown || statusText,
+            getHeaders: getHeadersFn(response),
+            status: status,
+            statusText: statusText,
+        },
+    };
+}
+function errorText(err) {
+    return (err && err.message) || String(err);
+}
+// response is null when the transport itself failed, before any response existed.
+function getHeadersFn(response) {
+    if (!response || response.status === 0) { // timeout or abort; no headers
+        return function (headerName) {
+            return (headerName && headerName.length > 0) ? "" : {};
+        };
+    }
+    return function (headerName) {
+        if (headerName && headerName.length > 0) {
+            return response.headers.get(headerName);
+        }
+        const hob = {};
+        response.headers.forEach((val, key) => {
+            hob[key] = val;
+        });
+        return hob;
+    };
+}
+/**
+ * Ajax adapter using the fetch API.
+ *
+ * @deprecated Breeze 3 needs no ajax adapter: requests go through `config.fetch`, set with
+ * `configureBreeze({ fetch })`. This class is kept so that 2.x startup code - `register()`,
+ * `configureBreeze({ ajax: AjaxFetchAdapter })`, `config.initializeAdapterInstance('ajax',
+ * 'fetch')` - and code using `defaultSettings` or `requestInterceptor` keeps working. It is
+ * not scheduled for removal.
+ */
+export class AjaxFetchAdapter {
+    static adapterName = "fetch";
+    name;
+    defaultSettings;
+    requestInterceptor;
+    /** The function used to make the request. Defaults to `globalThis.fetch`. */
+    fetchFn;
+    constructor(fetchFn) {
+        this.name = AjaxFetchAdapter.adapterName;
+        this.defaultSettings = {};
+        this.requestInterceptor = undefined;
+        this.fetchFn = fetchFn || defaultFetch;
+    }
+    /**
+     * @param breezeConfig - defaults to the global breeze config
+     * @param fetchFn - the transport this adapter uses. Defaults to `globalThis.fetch`.
+     */
+    static register(breezeConfig, fetchFn) {
+        breezeConfig = breezeConfig || config;
+        if (fetchFn) {
+            // registerAdapter news up the ctor, so a custom transport needs a factory.
+            breezeConfig.registerAdapter("ajax", function () { return new AjaxFetchAdapter(fetchFn); });
+        }
+        else {
+            breezeConfig.registerAdapter("ajax", AjaxFetchAdapter);
+        }
+        return breezeConfig.initializeAdapterInstance("ajax", AjaxFetchAdapter.adapterName, true);
+    }
+    initialize() {
+    }
+    ajax(ajaxConfig) {
+        if (!this.fetchFn) {
+            throw new Error("fetch API not supported in this browser");
+        }
+        let { url, init } = toFetchArgs(ajaxConfig);
+        if (!core.isEmpty(this.defaultSettings)) {
+            let compositeConfig = core.extend({}, this.defaultSettings);
+            init = core.extend(compositeConfig, init);
+            // extend is shallow; extend headers separately
+            let headers = core.extend({}, this.defaultSettings.headers); // copy default headers 1st
+            init.headers = core.extend(headers, init.headers);
+        }
+        // An interceptor may change requestInfo.config (the fetch init), cancel the request by
+        // setting it to null, or answer it itself through success/error.
+        let requestInfo = {
+            adapter: this,
+            config: init,
+            dsaConfig: ajaxConfig,
+            success: (data, statusText, response) => ajaxConfig.success(success(ajaxConfig, data, statusText, response).httpResponse),
+            error: (status, statusText, body, response, errorThrown) => ajaxConfig.error(failure(ajaxConfig, status, statusText, body, response, errorThrown).httpResponse),
+        };
+        if (core.isFunction(this.requestInterceptor)) {
+            let ri = this.requestInterceptor;
+            ri(requestInfo);
+            if (ri.oneTime) {
+                this.requestInterceptor = undefined;
+            }
+        }
+        if (requestInfo.config) {
+            sendFetch(this.fetchFn, url, requestInfo.config, ajaxConfig).then(outcome => outcome.succeeded ? ajaxConfig.success(outcome.httpResponse) : ajaxConfig.error(outcome.httpResponse));
+        }
+    }
+}
+/**
+ * What a data service adapter uses when no ajax adapter is registered. It sends requests
+ * through `config.fetch`, read at call time, so a later `configureBreeze({ fetch })` takes
+ * effect without re-initializing anything.
+ * @hidden @internal
+ */
+export const builtinAjax = new AjaxFetchAdapter((input, init) => (config.fetch || defaultFetch)(input, init));
+//# sourceMappingURL=http.js.map

package/adapters/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/adapters/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,0BAA0B,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAI7E;;;;;;;;;;;;;;GAcG;AAEH;uCACuC;AACvC,MAAM,CAAC,MAAM,YAAY,GAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,KAAY,EAAE,IAAI,CAAC,CAAC;AAW/F,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,OAA0B;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,KAAK,KAAK,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC;IAElE,iFAAiF;IACjF,qFAAqF;IACrF,qCAAqC;IACrC,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,WAAW,IAAI,kBAAkB,CAAC;IACtE,CAAC;IACD,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAExC,MAAM,IAAI,GAAgB;QACxB,MAAM,EAAE,OAAO,CAAC,IAAI;QACpB,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,SAAS;QACtB,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,QAAQ;QAClB,sFAAsF;QACtF,qFAAqF;QACrF,8BAA8B;KAC/B,CAAC;IACF,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACtB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,GAAG,GAAG,0BAA0B,CAAC,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,MAAO,CAAC,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAoB,EAAE,GAAW,EAAE,IAAiB,EAChF,OAA0B;IAC5B,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,IAAS,CAAC;IACd,IAAI,CAAC;QACH,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACrE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,oCAAoC,GAAG,SAAS,CAAC,GAAG,CAAC,EAC5F,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,QAAQ,CAAC,EAAE;QAChB,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC;QACvD,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,OAAO,CAAC,OAA0B,EAAE,IAAS,EAAE,UAAkB,EAAE,QAAyB;IACnG,OAAO;QACL,SAAS,EAAE,IAAI;QACf,YAAY,EAAE;YACZ,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,IAAI;YACV,UAAU,EAAE,YAAY,CAAC,QAAQ,CAAC;YAClC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG;YACxC,UAAU,EAAE,UAAU;SACP;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,OAA0B,EAAE,MAAc,EAAE,UAAkB,EAAE,IAAS,EACtF,QAAyB,EAAE,WAAgB;IAC7C,OAAO;QACL,SAAS,EAAE,KAAK;QAChB,YAAY,EAAE;YACZ,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,WAAW,IAAI,UAAU;YAChC,UAAU,EAAE,YAAY,CAAC,QAAQ,CAAC;YAClC,MAAM,EAAE,MAAM;YACd,UAAU,EAAE,UAAU;SACP;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,GAAQ;IACzB,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,kFAAkF;AAClF,SAAS,YAAY,CAAC,QAAyB;IAC7C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC,+BAA+B;QACvE,OAAO,UAAU,UAAkB;YACjC,OAAO,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,UAAkB;QACjC,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,GAAG,GAAwB,EAAE,CAAC;QACpC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACpC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAgB;IAC3B,MAAM,CAAC,WAAW,GAAG,OAAO,CAAC;IAC7B,IAAI,CAAS;IACb,eAAe,CAA2C;IAC1D,kBAAkB,CAA0B;IAC5C,6EAA6E;IAC7E,OAAO,CAAc;IAErB,YAAY,OAAqB;QAC/B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC,WAAW,CAAC;QACzC,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,YAAY,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,YAA2B,EAAE,OAAqB;QAChE,YAAY,GAAG,YAAY,IAAI,MAAM,CAAC;QACtC,IAAI,OAAO,EAAE,CAAC;YACZ,2EAA2E;YAC3E,YAAY,CAAC,eAAe,CAAC,MAAM,EAAO,cAAc,OAAO,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnG,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,eAAe,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,YAAY,CAAC,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAqB,CAAC;IAChH,CAAC;IAED,UAAU;IACV,CAAC;IAED,IAAI,CAAC,UAAsB;QACzB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;QAE5C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;YACxC,IAAI,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;YAC5D,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,IAAI,CAAQ,CAAC;YACjD,+CAA+C;YAC/C,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B;YACxF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAQ,CAAC;QAC3D,CAAC;QAED,uFAAuF;QACvF,iEAAiE;QACjE,IAAI,WAAW,GAAG;YAChB,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAA0B;YAClC,SAAS,EAAE,UAAU;YACrB,OAAO,EAAE,CAAC,IAAS,EAAE,UAAkB,EAAE,QAAkB,EAAE,EAAE,CAC7D,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,YAAY,CAAC;YAClF,KAAK,EAAE,CAAC,MAAc,EAAE,UAAkB,EAAE,IAAmB,EAAE,QAAyB,EAAE,WAAgB,EAAE,EAAE,CAC9G,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,YAAY,CAAC;SACtG,CAAC;QAEF,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC7C,IAAI,EAAE,GAAG,IAAI,CAAC,kBAAyB,CAAC;YACxC,EAAE,CAAC,WAAW,CAAC,CAAC;YAChB,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;gBACf,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;YACtC,CAAC;QACH,CAAC;QAED,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;YACvB,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAC1E,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;QAC3G,CAAC;IACH,CAAC;;AAGH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAgB,IAAI,gBAAgB,CAC1D,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,YAAY,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC","sourcesContent":["import { BreezeConfig, config } from '../config/config.js';\nimport { core } from '../core/core.js';\nimport { appendQueryStringParameter, encodeParams } from './adapter-core.js';\nimport type { AjaxAdapter, AjaxConfig, AjaxRequestInterceptor, BreezeFetch } from '../config/interface-registry.js';\nimport type { HttpResponse } from '../manager/entity-manager.js';\n\n/*\n * How Breeze makes HTTP requests.\n *\n * Breeze 3 needs no ajax adapter. Data service adapters send their requests through\n * `config.fetch` - set with `configureBreeze({ fetch })` - which defaults to\n * `globalThis.fetch`. This module is the one implementation of that path: turning Breeze's\n * description of a request into a fetch call, and reading the response back.\n *\n * The ajax adapter contract (`AjaxAdapter`, the \"ajax\" registry slot) remains as a\n * deprecated compatibility layer. `AjaxFetchAdapter` is built on the functions here, and so\n * is the adapter data service adapters fall back to when none is registered.\n *\n * This module imports './config' and './core' directly, never the './breeze' barrel: the\n * abstract data service adapter depends on it, and the barrel depends on that.\n */\n\n/** The transport used when none is supplied. Wrapped so that `fetch` keeps its receiver,\n    which some environments require. */\nexport const defaultFetch: BreezeFetch = (input, init) => globalThis.fetch(input as any, init);\n\n/** Breeze's description of one request, without the callbacks. */\nexport type HttpRequestConfig = Omit<AjaxConfig, 'success' | 'error'>;\n\n/** The outcome of one request. Failures are values, not rejections. */\nexport interface HttpOutcome {\n  succeeded: boolean;\n  httpResponse: HttpResponse;\n}\n\n/** Turns Breeze's description of a request into the arguments for a fetch call. */\nexport function toFetchArgs(request: HttpRequestConfig): { url: string, init: RequestInit } {\n  const hasBody = request.type !== \"GET\" && request.type !== \"HEAD\";\n\n  // Content-Type describes a body, so a GET gets none - which also keeps it a CORS\n  // \"simple request\" with no preflight. Headers on the request are merged in last; the\n  // fetch adapter used to ignore them.\n  const headers: Record<string, string> = {};\n  if (hasBody) {\n    headers['Content-Type'] = request.contentType || 'application/json';\n  }\n  Object.assign(headers, request.headers);\n\n  const init: RequestInit = {\n    method: request.type,\n    mode: 'cors',\n    cache: 'no-cache',\n    credentials: 'include',\n    headers: headers,\n    redirect: 'follow',\n    // 'referrer' is deliberately unset. 'client' is the browser default, but Node's fetch\n    // (undici) rejects it as an invalid URL, so setting it explicitly breaks server-side\n    // and test usage for no gain.\n  };\n  if (hasBody) {\n    const data = request.data;\n    init.body = typeof data === \"string\" ? data : JSON.stringify(data);\n  }\n\n  let url = request.url;\n  if (!core.isEmpty(request.params)) {\n    url = appendQueryStringParameter(url, encodeParams(request.params!));\n  }\n  return { url, init };\n}\n\n/**\n * Sends one request and resolves with its outcome. Never rejects: a transport failure is\n * reported with status 0, and a body that cannot be read with the real HTTP status.\n */\nexport async function sendFetch(fetchFn: BreezeFetch, url: string, init: RequestInit,\n    request: HttpRequestConfig): Promise<HttpOutcome> {\n  let response: Response;\n  try {\n    response = await fetchFn(url, init);\n  } catch (err) {\n    return failure(request, 0, errorText(err), null, null, err);\n  }\n\n  let data: any;\n  try {\n    data = response.ok ? await response.json() : await response.text();\n  } catch (err) {\n    return failure(request, response.status, 'Unable to read the response body: ' + errorText(err),\n      null, response, err);\n  }\n\n  return response.ok\n    ? success(request, data, response.statusText, response)\n    : failure(request, response.status, response.statusText, data, response, null);\n}\n\nfunction success(request: HttpRequestConfig, data: any, statusText: string, response: Response | null): HttpOutcome {\n  return {\n    succeeded: true,\n    httpResponse: {\n      config: request,\n      data: data,\n      getHeaders: getHeadersFn(response),\n      status: response ? response.status : 200,\n      statusText: statusText,\n    } as HttpResponse,\n  };\n}\n\nfunction failure(request: HttpRequestConfig, status: number, statusText: string, body: any,\n    response: Response | null, errorThrown: any): HttpOutcome {\n  return {\n    succeeded: false,\n    httpResponse: {\n      config: request,\n      data: body,\n      error: errorThrown || statusText,\n      getHeaders: getHeadersFn(response),\n      status: status,\n      statusText: statusText,\n    } as HttpResponse,\n  };\n}\n\nfunction errorText(err: any): string {\n  return (err && err.message) || String(err);\n}\n\n// response is null when the transport itself failed, before any response existed.\nfunction getHeadersFn(response: Response | null): any {\n  if (!response || response.status === 0) { // timeout or abort; no headers\n    return function (headerName: string) {\n      return (headerName && headerName.length > 0) ? \"\" : {};\n    };\n  }\n  return function (headerName: string) {\n    if (headerName && headerName.length > 0) {\n      return response.headers.get(headerName);\n    }\n    const hob: Record<string, any> = {};\n    response.headers.forEach((val, key) => {\n      hob[key] = val;\n    });\n    return hob;\n  };\n}\n\n/**\n * Ajax adapter using the fetch API.\n *\n * @deprecated Breeze 3 needs no ajax adapter: requests go through `config.fetch`, set with\n * `configureBreeze({ fetch })`. This class is kept so that 2.x startup code - `register()`,\n * `configureBreeze({ ajax: AjaxFetchAdapter })`, `config.initializeAdapterInstance('ajax',\n * 'fetch')` - and code using `defaultSettings` or `requestInterceptor` keeps working. It is\n * not scheduled for removal.\n */\nexport class AjaxFetchAdapter implements AjaxAdapter {\n  static adapterName = \"fetch\";\n  name: string;\n  defaultSettings: { headers?: { [name: string]: string } };\n  requestInterceptor?: AjaxRequestInterceptor;\n  /** The function used to make the request. Defaults to `globalThis.fetch`. */\n  fetchFn: BreezeFetch;\n\n  constructor(fetchFn?: BreezeFetch) {\n    this.name = AjaxFetchAdapter.adapterName;\n    this.defaultSettings = {};\n    this.requestInterceptor = undefined;\n    this.fetchFn = fetchFn || defaultFetch;\n  }\n\n  /**\n   * @param breezeConfig - defaults to the global breeze config\n   * @param fetchFn - the transport this adapter uses. Defaults to `globalThis.fetch`.\n   */\n  static register(breezeConfig?: BreezeConfig, fetchFn?: BreezeFetch) {\n    breezeConfig = breezeConfig || config;\n    if (fetchFn) {\n      // registerAdapter news up the ctor, so a custom transport needs a factory.\n      breezeConfig.registerAdapter(\"ajax\", <any>function () { return new AjaxFetchAdapter(fetchFn); });\n    } else {\n      breezeConfig.registerAdapter(\"ajax\", AjaxFetchAdapter);\n    }\n    return breezeConfig.initializeAdapterInstance(\"ajax\", AjaxFetchAdapter.adapterName, true) as AjaxFetchAdapter;\n  }\n\n  initialize() {\n  }\n\n  ajax(ajaxConfig: AjaxConfig) {\n    if (!this.fetchFn) {\n      throw new Error(\"fetch API not supported in this browser\");\n    }\n\n    let { url, init } = toFetchArgs(ajaxConfig);\n\n    if (!core.isEmpty(this.defaultSettings)) {\n      let compositeConfig = core.extend({}, this.defaultSettings);\n      init = core.extend(compositeConfig, init) as any;\n      // extend is shallow; extend headers separately\n      let headers = core.extend({}, this.defaultSettings.headers); // copy default headers 1st\n      init.headers = core.extend(headers, init.headers) as any;\n    }\n\n    // An interceptor may change requestInfo.config (the fetch init), cancel the request by\n    // setting it to null, or answer it itself through success/error.\n    let requestInfo = {\n      adapter: this,\n      config: init as RequestInit | null,\n      dsaConfig: ajaxConfig,\n      success: (data: any, statusText: string, response: Response) =>\n        ajaxConfig.success(success(ajaxConfig, data, statusText, response).httpResponse),\n      error: (status: number, statusText: string, body: string | null, response: Response | null, errorThrown: any) =>\n        ajaxConfig.error(failure(ajaxConfig, status, statusText, body, response, errorThrown).httpResponse),\n    };\n\n    if (core.isFunction(this.requestInterceptor)) {\n      let ri = this.requestInterceptor as any;\n      ri(requestInfo);\n      if (ri.oneTime) {\n        this.requestInterceptor = undefined;\n      }\n    }\n\n    if (requestInfo.config) {\n      sendFetch(this.fetchFn, url, requestInfo.config, ajaxConfig).then(outcome =>\n        outcome.succeeded ? ajaxConfig.success(outcome.httpResponse) : ajaxConfig.error(outcome.httpResponse));\n    }\n  }\n}\n\n/**\n * What a data service adapter uses when no ajax adapter is registered. It sends requests\n * through `config.fetch`, read at call time, so a later `configureBreeze({ fetch })` takes\n * effect without re-initializing anything.\n * @hidden @internal\n */\nexport const builtinAjax: AjaxAdapter = new AjaxFetchAdapter(\n  (input, init) => (config.fetch || defaultFetch)(input, init));\n"]}

package/angular/adapter-angular-httpclient.d.ts

@@ -0,0 +1,21 @@
+import type { HttpClient } from '@angular/common/http';
+import type { BreezeFetch } from '../config/interface-registry.js';
+/**
+ * A {@link BreezeFetch} that sends Breeze's requests through Angular's `HttpClient`, so that they
+ * pass through your interceptors and, in tests, `HttpTestingController`.
+ *
+ * ```ts
+ * // app.config.ts
+ * import { httpClientFetch } from 'breeze-client/adapter-angular-httpclient';
+ *
+ * provideAppInitializer(() => { configureBreeze({ fetch: httpClientFetch(inject(HttpClient)) }); }),
+ * ```
+ *
+ * `HttpClient` throws on a status outside 200-299 rather than returning the response. This hands
+ * Breeze that response anyway - its status, body and headers - because that is how Breeze turns a
+ * rejected save into `entityErrors` and a 409 into a concurrency conflict. A request that never
+ * completed (status 0) is left to fail, and Breeze reports it as a transport failure.
+ *
+ * @param http - the application's `HttpClient`
+ */
+export declare function httpClientFetch(http: HttpClient): BreezeFetch;

package/angular/adapter-angular-httpclient.js

@@ -0,0 +1,70 @@
+import { firstValueFrom } from 'rxjs';
+// Breeze's requests through Angular's HttpClient.
+//
+// breeze-client/adapter-angular-httpclient. Optional, and opt-in like breeze-client/rxjs: import
+// it from its own subpath. Nothing in `breeze-client` imports this module, and @angular/common is
+// an optional peer dependency, so an application that is not Angular never installs it.
+//
+//     import { httpClientFetch } from 'breeze-client/adapter-angular-httpclient';
+//     configureBreeze({ fetch: httpClientFetch(inject(HttpClient)) });
+//
+// It imports Angular's TYPES only. The one runtime question it asks of Angular - is this error an
+// HttpErrorResponse? - it answers by the error's name rather than with instanceof, so the published
+// JavaScript never loads @angular/common, and an application with two copies of Angular (a library
+// bundling its own, say) cannot fail the check.
+//
+// This replaces breeze-client/adapter-ajax-httpclient from Breeze 2.x.
+/**
+ * A {@link BreezeFetch} that sends Breeze's requests through Angular's `HttpClient`, so that they
+ * pass through your interceptors and, in tests, `HttpTestingController`.
+ *
+ * ```ts
+ * // app.config.ts
+ * import { httpClientFetch } from 'breeze-client/adapter-angular-httpclient';
+ *
+ * provideAppInitializer(() => { configureBreeze({ fetch: httpClientFetch(inject(HttpClient)) }); }),
+ * ```
+ *
+ * `HttpClient` throws on a status outside 200-299 rather than returning the response. This hands
+ * Breeze that response anyway - its status, body and headers - because that is how Breeze turns a
+ * rejected save into `entityErrors` and a 409 into a concurrency conflict. A request that never
+ * completed (status 0) is left to fail, and Breeze reports it as a transport failure.
+ *
+ * @param http - the application's `HttpClient`
+ */
+export function httpClientFetch(http) {
+    return async (input, init) => {
+        try {
+            const res = await firstValueFrom(http.request(init?.method ?? 'GET', String(input), {
+                body: init?.body ?? null,
+                headers: init?.headers,
+                observe: 'response',
+                responseType: 'text',
+            }));
+            return toResponse(res.body, res.status, res.statusText, res.headers);
+        }
+        catch (e) {
+            if (isHttpErrorResponse(e) && e.status !== 0) {
+                return toResponse(e.error, e.status, e.statusText, e.headers);
+            }
+            throw e;
+        }
+    };
+}
+/** By name, not instanceof: no runtime import of Angular, and no trouble with two copies of it. */
+function isHttpErrorResponse(e) {
+    return e != null && typeof e === 'object' && e.name === 'HttpErrorResponse';
+}
+function toResponse(body, status, statusText, headers) {
+    const h = new Headers();
+    for (const name of headers.keys()) {
+        const value = headers.get(name);
+        if (value != null)
+            h.set(name, value);
+    }
+    const text = typeof body === 'string' ? body : body == null ? null : JSON.stringify(body);
+    // A 204 or 304 may not carry a body, and new Response() throws if given one.
+    const bodyless = status === 204 || status === 304 || text === '';
+    return new Response(bodyless ? null : text, { status, statusText, headers: h });
+}
+//# sourceMappingURL=adapter-angular-httpclient.js.map

package/angular/adapter-angular-httpclient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-angular-httpclient.js","sourceRoot":"","sources":["../../src/angular/adapter-angular-httpclient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAItC,kDAAkD;AAClD,EAAE;AACF,iGAAiG;AACjG,kGAAkG;AAClG,wFAAwF;AACxF,EAAE;AACF,kFAAkF;AAClF,uEAAuE;AACvE,EAAE;AACF,kGAAkG;AAClG,oGAAoG;AACpG,mGAAmG;AACnG,gDAAgD;AAChD,EAAE;AACF,uEAAuE;AAEvE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,eAAe,CAAC,IAAgB;IAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,IAAI,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE;gBAClF,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI;gBACxB,OAAO,EAAE,IAAI,EAAE,OAAiC;gBAChD,OAAO,EAAE,UAAU;gBACnB,YAAY,EAAE,MAAM;aACrB,CAAC,CAAC,CAAC;YACJ,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7C,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YAChE,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,SAAS,mBAAmB,CAAC,CAAU;IACrC,OAAO,CAAC,IAAI,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAK,CAAwB,CAAC,IAAI,KAAK,mBAAmB,CAAC;AACtG,CAAC;AAED,SAAS,UAAU,CAAC,IAAa,EAAE,MAAc,EAAE,UAAkB,EAAE,OAAoB;IACzF,MAAM,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC;IACxB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,KAAK,IAAI,IAAI;YAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1F,6EAA6E;IAC7E,MAAM,QAAQ,GAAG,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;IACjE,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;AAClF,CAAC","sourcesContent":["import { firstValueFrom } from 'rxjs';\nimport type { HttpClient, HttpErrorResponse, HttpHeaders } from '@angular/common/http';\nimport type { BreezeFetch } from '../config/interface-registry.js';\n\n// Breeze's requests through Angular's HttpClient.\n//\n// breeze-client/adapter-angular-httpclient. Optional, and opt-in like breeze-client/rxjs: import\n// it from its own subpath. Nothing in `breeze-client` imports this module, and @angular/common is\n// an optional peer dependency, so an application that is not Angular never installs it.\n//\n//     import { httpClientFetch } from 'breeze-client/adapter-angular-httpclient';\n//     configureBreeze({ fetch: httpClientFetch(inject(HttpClient)) });\n//\n// It imports Angular's TYPES only. The one runtime question it asks of Angular - is this error an\n// HttpErrorResponse? - it answers by the error's name rather than with instanceof, so the published\n// JavaScript never loads @angular/common, and an application with two copies of Angular (a library\n// bundling its own, say) cannot fail the check.\n//\n// This replaces breeze-client/adapter-ajax-httpclient from Breeze 2.x.\n\n/**\n * A {@link BreezeFetch} that sends Breeze's requests through Angular's `HttpClient`, so that they\n * pass through your interceptors and, in tests, `HttpTestingController`.\n *\n * ```ts\n * // app.config.ts\n * import { httpClientFetch } from 'breeze-client/adapter-angular-httpclient';\n *\n * provideAppInitializer(() => { configureBreeze({ fetch: httpClientFetch(inject(HttpClient)) }); }),\n * ```\n *\n * `HttpClient` throws on a status outside 200-299 rather than returning the response. This hands\n * Breeze that response anyway - its status, body and headers - because that is how Breeze turns a\n * rejected save into `entityErrors` and a 409 into a concurrency conflict. A request that never\n * completed (status 0) is left to fail, and Breeze reports it as a transport failure.\n *\n * @param http - the application's `HttpClient`\n */\nexport function httpClientFetch(http: HttpClient): BreezeFetch {\n  return async (input, init) => {\n    try {\n      const res = await firstValueFrom(http.request(init?.method ?? 'GET', String(input), {\n        body: init?.body ?? null,\n        headers: init?.headers as Record<string, string>,\n        observe: 'response',\n        responseType: 'text',\n      }));\n      return toResponse(res.body, res.status, res.statusText, res.headers);\n    } catch (e) {\n      if (isHttpErrorResponse(e) && e.status !== 0) {\n        return toResponse(e.error, e.status, e.statusText, e.headers);\n      }\n      throw e;\n    }\n  };\n}\n\n/** By name, not instanceof: no runtime import of Angular, and no trouble with two copies of it. */\nfunction isHttpErrorResponse(e: unknown): e is HttpErrorResponse {\n  return e != null && typeof e === 'object' && (e as { name?: unknown }).name === 'HttpErrorResponse';\n}\n\nfunction toResponse(body: unknown, status: number, statusText: string, headers: HttpHeaders): Response {\n  const h = new Headers();\n  for (const name of headers.keys()) {\n    const value = headers.get(name);\n    if (value != null) h.set(name, value);\n  }\n  const text = typeof body === 'string' ? body : body == null ? null : JSON.stringify(body);\n  // A 204 or 304 may not carry a body, and new Response() throws if given one.\n  const bodyless = status === 204 || status === 304 || text === '';\n  return new Response(bodyless ? null : text, { status, statusText, headers: h });\n}\n"]}

package/breeze.d.ts

@@ -0,0 +1,215 @@
+import { AbstractDataServiceAdapter } from './adapters/abstract-data-service-adapter.js';
+import { assertParam, assertConfig, Param } from './core/assert-param.js';
+import { BreezeConfig } from './config/config.js';
+import { BreezeEnum } from './core/enum.js';
+import { BreezeEvent } from './core/event.js';
+import type { ComplexArray } from './entity/complex-array.js';
+import { DataService, JsonResultsAdapter } from './metadata/data-service.js';
+import type { DataServiceConfig, JsonResultsAdapterConfig, NodeContext, NodeMeta } from './metadata/data-service.js';
+import { DataType } from './metadata/data-type.js';
+import { EntityAction } from './entity/entity-action.js';
+import { EntityAspect, ComplexAspect } from './entity/entity-aspect.js';
+import { EntityBase, ComplexObjectBase } from './entity/entity-base.js';
+import type { Entity, ComplexObject, StructuralObject, PropertyChangedEventArgs, QueriedAs, EntityAspectOf, ComplexAspectOf } from './entity/entity-aspect.js';
+import { EntityKey } from './entity/entity-key.js';
+import { EntityManager, ProblemTypes, isConcurrencyError } from './manager/entity-manager.js';
+import type { EntityManagerConfig, EntityError, EntityChangedEventArgs, SaveContext, SaveBundle, HttpResponse, KeyMapping, ServerError, SaveResult, QueryResult, ValidationErrorsChangedEventArgs, HasChangesChangedEventArgs } from './manager/entity-manager.js';
+import { EntityQuery, FilterQueryOp, BooleanQueryOp, OrderByClause, ExpandClause, SelectClause } from './query/entity-query.js';
+import { EntityState } from './entity/entity-state.js';
+import { InterfaceRegistry } from './config/interface-registry.js';
+import type { AjaxAdapter, AjaxConfig, BreezeFetch, DataServiceAdapter, ModelLibraryAdapter, ChangeRequestInterceptor, UriBuilderAdapter, InterfaceRegistryConfig, AjaxRequestInterceptor } from './config/interface-registry.js';
+import { KeyGenerator } from './entity/key-generator.js';
+import { LocalQueryComparisonOptions } from './metadata/local-query-comparison-options.js';
+import { MappingContext } from './query/mapping-context.js';
+import { MetadataStore, EntityType, ComplexType, DataProperty, NavigationProperty, AutoGeneratedKeyType, entityTypeForCtor } from './metadata/entity-metadata.js';
+import type { StructuralType, EntityProperty } from './metadata/entity-metadata.js';
+import { NamingConvention } from './metadata/naming-convention.js';
+import { Predicate, UnaryPredicate, BinaryPredicate, AnyAllPredicate, AndOrPredicate, LitExpr, FnExpr, PropExpr } from './query/predicate.js';
+import type { VisitContext, Visitor, ExpressionContext } from './query/predicate.js';
+import { QueryOptions, FetchStrategy, MergeStrategy } from './query/query-options.js';
+import { SaveOptions } from './manager/save-options.js';
+import { ValidationError, Validator } from './validation/validate.js';
+import { ValidationOptions } from './validation/validation-options.js';
+import { config } from './config/config.js';
+import type { BaseAdapter } from './config/config.js';
+import { configureBreeze } from './config/configure.js';
+import type { BreezeSetupOptions, AdapterRegistration, AjaxAdapterRegistration } from './config/configure.js';
+import { core } from './core/core.js';
+import type { Callback, ErrorCallback } from './core/core.js';
+import { makeRelationArray, makePrimitiveArray, makeComplexArray } from './entity/array.js';
+import type { RelationArray } from './entity/relation-array.js';
+import type { ArrayChangedArgs } from './entity/observable-array.js';
+export { BreezeConfig };
+export type { ComplexArray, RelationArray };
+export { AbstractDataServiceAdapter, AndOrPredicate, AnyAllPredicate, assertConfig, assertParam, AutoGeneratedKeyType, BinaryPredicate, BreezeEnum, BreezeEvent, ComplexAspect, ComplexObjectBase, ComplexType, config, configureBreeze, core, DataProperty, DataService, DataType, EntityAction, EntityAspect, EntityBase, EntityKey, EntityManager, EntityQuery, EntityState, EntityType, entityTypeForCtor, ExpandClause, FetchStrategy, FilterQueryOp, FnExpr, InterfaceRegistry, JsonResultsAdapter, KeyGenerator, LitExpr, LocalQueryComparisonOptions, makeComplexArray, makePrimitiveArray, makeRelationArray, MappingContext, MergeStrategy, MetadataStore, NamingConvention, NavigationProperty, OrderByClause, Predicate, PropExpr, QueryOptions, SaveOptions, SelectClause, UnaryPredicate, ValidationError, ValidationOptions, Validator, ProblemTypes, isConcurrencyError, };
+export type { AjaxAdapter, AjaxConfig, AjaxRequestInterceptor, ArrayChangedArgs, BaseAdapter, BreezeFetch, Callback, ChangeRequestInterceptor, ComplexObject, BreezeSetupOptions, AdapterRegistration, AjaxAdapterRegistration, DataServiceAdapter, DataServiceConfig, Entity, EntityChangedEventArgs, EntityError, EntityManagerConfig, EntityProperty, ErrorCallback, ExpressionContext, HasChangesChangedEventArgs, HttpResponse, InterfaceRegistryConfig, JsonResultsAdapterConfig, KeyMapping, ModelLibraryAdapter, NodeContext, NodeMeta, PropertyChangedEventArgs, QueriedAs, EntityAspectOf, ComplexAspectOf, QueryResult, SaveBundle, SaveContext, SaveResult, ServerError, StructuralObject, StructuralType, UriBuilderAdapter, ValidationErrorsChangedEventArgs, VisitContext, Visitor, };
+/** Every class, enum and helper of the Breeze 2.x API in one object - the `breeze` that 2.x code
+    imports or finds as a global. Kept so that code written against 2.x runs unchanged. New code
+    imports what it uses by name, which lets a bundler leave out the rest. */
+export declare const breeze: {
+    /** The base class of Breeze's data service adapters, for anyone writing one. The same as the
+        `AbstractDataServiceAdapter` export. */
+    AbstractDataServiceAdapter: typeof AbstractDataServiceAdapter;
+    /** Always `null`. Breeze 2.x exposed its argument-checking helpers here; Breeze 3 does not. */
+    assertConfig: any;
+    /** Always `null`. Breeze 2.x exposed its argument-checking helpers here; Breeze 3 does not. */
+    assertParam: any;
+    /** The same as the {@link AutoGeneratedKeyType} export. */
+    AutoGeneratedKeyType: typeof AutoGeneratedKeyType;
+    /** The operators that combine predicates in a query - `and`, `or` and `not` - as an enum. The
+        same as the `BooleanQueryOp` export. */
+    BooleanQueryOp: typeof BooleanQueryOp;
+    /** The same as the {@link ComplexAspect} export. */
+    ComplexAspect: typeof ComplexAspect;
+    /** The same as the {@link ComplexType} export. */
+    ComplexType: typeof ComplexType;
+    /** The same as the {@link config} export: the older adapter-registration API. New code calls
+        {@link configureBreeze} instead. */
+    config: BreezeConfig;
+    /** The same as the {@link core} export. */
+    core: {
+        hasOwnProperty: (obj: Object, key: string) => boolean;
+        getOwnPropertyValues: (source: Object) => any[];
+        getPropertyDescriptor: (obj: Object, propertyName: string) => PropertyDescriptor | undefined;
+        objectForEach: (obj: Object, kvFn: (key: string, val: any) => any) => void;
+        objectFirst: (obj: Object, kvPredicate: (key: string, val: any) => boolean) => {
+            key: string;
+            value: any;
+        } | null;
+        objectMap: (obj: Object, kvFn?: (key: string, val: any) => any) => any[];
+        extend: (target: Object, source?: Object, propNames?: string[]) => Object;
+        propEq: (propertyName: string, value: any) => (obj: Object) => boolean;
+        propsEq: (property1Name: string, property2Name: string, value: any) => (obj: Object) => boolean;
+        pluck: (propertyName: any) => (obj: Object) => any;
+        map: <T>(items: T | T[], fn: (v: T, ix?: number) => any, includeNull?: boolean) => any | any[];
+        resolveProperties: (sources: Object[], propertyNames: string[]) => any;
+        setAsDefault: (target: Object, ctor: {
+            new (...args: any[]): any;
+            defaultInstance?: any;
+        }) => any;
+        updateWithDefaults: (target: Object, defaults: Object) => any;
+        getMapArray: <K, V>(map: Map<K, V[]>, key: K) => V[];
+        toArray: (item: any) => any[];
+        arrayEquals: (a1: any[], a2: any[], equalsFn?: (x1: any, x2: any) => boolean) => boolean;
+        arraySlice: (ar: any[], start?: number, end?: number) => any[];
+        arrayFirst: <T>(array: T[], predicate: (i: any) => boolean) => T;
+        arrayIndexOf: <T>(array: T[], predicate: (i: any) => boolean) => number;
+        arrayRemoveItem: <T>(array: T[], predicateOrItem: T | ((i: T) => boolean), shouldRemoveMultiple?: boolean) => boolean;
+        arrayZip: (a1: any[], a2: any[], callback: (x1: any, x2: any) => any) => any[];
+        arrayAddItemUnique: <T>(array: T[], item: T) => void;
+        arrayFlatMap: typeof import("./core/core.js").arrayFlatMap;
+        using: (obj: Object, property: string, tempValue: any, fn: () => any) => any;
+        wrapExecution: (startFn: () => any, endFn: (state: any) => any, fn: () => any) => any;
+        memoize: (fn: any) => any;
+        getUuid: typeof import("./core/core.js").getUuid;
+        durationToSeconds: (duration: string) => number;
+        isSettable: (obj: Object, propertyName: string) => boolean;
+        isDate: (o: any) => boolean;
+        isDateString: (s: string) => boolean;
+        isGuid: (value: any) => boolean;
+        isDuration: (value: any) => boolean;
+        isFunction: (o: any) => boolean;
+        isEmpty: (obj: any) => boolean;
+        identity: (x: any) => any;
+        noop: () => void;
+        stringStartsWith: typeof import("./core/core.js").stringStartsWith;
+        stringEndsWith: typeof import("./core/core.js").stringEndsWith;
+        formatString: typeof import("./core/core.js").formatString;
+        toJson: (source: Object, template: Object, target?: Object) => Object;
+        toJSONSafe: (obj: any, replacer?: (prop: string, value: any) => any) => any;
+        toJSONSafeReplacer: (prop: string, val: any) => any;
+        strings: {
+            TO_TYPE: string;
+        };
+    };
+    /** The same as the {@link DataProperty} export. */
+    DataProperty: typeof DataProperty;
+    /** The same as the {@link DataService} export. */
+    DataService: typeof DataService;
+    /** The same as the {@link DataType} export. */
+    DataType: typeof DataType;
+    /** The same as the {@link EntityAction} export. */
+    EntityAction: typeof EntityAction;
+    /** The same as the {@link EntityAspect} export. */
+    EntityAspect: typeof EntityAspect;
+    /** The same as the {@link EntityKey} export. */
+    EntityKey: typeof EntityKey;
+    /** The same as the {@link EntityManager} export. */
+    EntityManager: typeof EntityManager;
+    /** The same as the {@link EntityQuery} export. */
+    EntityQuery: typeof EntityQuery;
+    /** The same as the {@link EntityState} export. */
+    EntityState: typeof EntityState;
+    /** The same as the {@link EntityType} export. */
+    EntityType: typeof EntityType;
+    /** The same as the {@link BreezeEvent} export, under its 2.x name. */
+    Event: typeof BreezeEvent;
+    /** The same as the {@link FetchStrategy} export. */
+    FetchStrategy: typeof FetchStrategy;
+    /** The same as the {@link FilterQueryOp} export. */
+    FilterQueryOp: typeof FilterQueryOp;
+    /** The same as the {@link InterfaceRegistry} export. */
+    InterfaceRegistry: typeof InterfaceRegistry;
+    /** The same as the {@link JsonResultsAdapter} export. */
+    JsonResultsAdapter: typeof JsonResultsAdapter;
+    /** The same as the {@link KeyGenerator} export. */
+    KeyGenerator: typeof KeyGenerator;
+    /** The same as the {@link LocalQueryComparisonOptions} export. */
+    LocalQueryComparisonOptions: typeof LocalQueryComparisonOptions;
+    /** Turns an array into the array behind a collection of complex objects. For model library
+        adapter authors; Breeze's own adapter calls it when it sets up an entity. */
+    makeComplexArray: typeof makeComplexArray;
+    /** Turns an array into the array behind a collection of primitive values. For model library
+        adapter authors; Breeze's own adapter calls it when it sets up an entity. */
+    makePrimitiveArray: typeof makePrimitiveArray;
+    /** Turns an array into the {@link RelationArray} behind a collection navigation property. For
+        model library adapter authors; Breeze's own adapter calls it when it sets up an entity. */
+    makeRelationArray: typeof makeRelationArray;
+    /** The same as the {@link MergeStrategy} export. */
+    MergeStrategy: typeof MergeStrategy;
+    /** The same as the {@link MetadataStore} export. */
+    MetadataStore: typeof MetadataStore;
+    /** The same as the {@link NamingConvention} export. */
+    NamingConvention: typeof NamingConvention;
+    /** The same as the {@link NavigationProperty} export. */
+    NavigationProperty: typeof NavigationProperty;
+    /** The class that holds a query's `orderBy`. Exposed for Breeze's own tests; applications do not
+        need it. */
+    OrderByClause: typeof OrderByClause;
+    /** Breeze's internal argument-checking helper. Applications do not need it. */
+    Param: typeof Param;
+    /** The same as the {@link Predicate} export. */
+    Predicate: typeof Predicate;
+    /** The same as the {@link QueryOptions} export. */
+    QueryOptions: typeof QueryOptions;
+    /** The same as the {@link SaveOptions} export. */
+    SaveOptions: typeof SaveOptions;
+    /** The same as the {@link ValidationError} export. */
+    ValidationError: typeof ValidationError;
+    /** The same as the {@link ValidationOptions} export. */
+    ValidationOptions: typeof ValidationOptions;
+    /** The same as the {@link Validator} export. */
+    Validator: typeof Validator;
+    /** The version of `breeze-client`. A test keeps it equal to the one in package.json. */
+    version: string;
+};
+export type { AdapterCtor, AdapterType } from './config/config.js';
+export type { AjaxRequest, ChangeRequestInterceptorCtor } from './config/interface-registry.js';
+export type { ComplexTypeConfig, DataPropertyConfig, EntityTypeConfig, EntityTypeSetConfig, MetadataFetchedEventArgs, MetadataStoreConfig, NavigationPropertyConfig, } from './metadata/entity-metadata.js';
+export type { EntityByKeyResult, EntityTypeArg, ExportEntitiesArg, IEntityByKeyResult, ImportConfig, ImportResult, InitialValues, ITempKeyMap, QueryErrorCallback, QuerySuccessCallback, SaveError, } from './manager/entity-manager.js';
+export type { LocalQueryComparisonOptionsConfig } from './metadata/local-query-comparison-options.js';
+export type { NamingConventionConfig } from './metadata/naming-convention.js';
+export type { CollectionElement, CollectionPath, FilterOpFor, FilterValueExpression, FilterValueFor, FunctionExpressionPath, FilterClause, FilterOpsObject, FilterOpNameFor, NavigationPath, OrderByPath, KeyValues, OriginalValues, PropertyPath, PropertyValue, QuantifierOp, SelectPath, WhereObject, } from './query/property-path.js';
+export type { TypedPredicateFactory } from './query/predicate.js';
+export type { QueryOptionsConfig } from './query/query-options.js';
+export type { SaveOptionsConfig } from './manager/save-options.js';
+export type { ValidationContext, ValidationFn, ValidationMessageContext } from './validation/validate.js';
+export type { ValidationOptionsConfig } from './validation/validation-options.js';
+/** Kept for code written against Breeze 2.x and `breeze-bridge2-angular`. Breeze 3 uses native
+    promises and has nothing to configure here. */
+export declare namespace promises {
+    /** An empty interface, kept so that code written for `breeze-bridge2-angular`, which named it,
+        still compiles. Breeze 3 uses native promises. */
+    interface IPromiseService {
+    }
+}