breeze-client 2.2.2 → 3.0.0

package/config/config.js

@@ -0,0 +1,392 @@
+import { core } from '../core/core.js';
+import { assertParam, assertConfig } from '../core/assert-param.js';
+import { BreezeEvent } from '../core/event.js';
+export class InterfaceDef {
+    name;
+    defaultInstance;
+    /** @hidden @internal */
+    _implMap;
+    constructor(name) {
+        this.name = name;
+        this.defaultInstance = undefined;
+        this._implMap = new Map();
+    }
+    /** Define an implementation of the given adaptername */
+    registerCtor(adapterName, ctor) {
+        this._implMap.set(adapterName.toLowerCase(), { ctor: ctor, defaultInstance: undefined });
+    }
+    /** Return the definition for the given adapterName */
+    getImpl(adapterName) {
+        return this._implMap.get(adapterName.toLowerCase());
+    }
+    /** Return the first implementation for this InterfaceDef */
+    getFirstImpl() {
+        // Map preserves insertion order, so 'first' is well defined here.
+        const first = this._implMap.values().next();
+        return first.done ? null : first.value;
+    }
+    getDefaultInstance() {
+        return this.defaultInstance;
+    }
+}
+/** Registers adapters used by Breeze */
+export class InterfaceRegistry {
+    /** Creates a registry with no adapters in it. {@link config} holds the one Breeze uses;
+    applications do not create their own. */
+    constructor() { }
+    /** The registered {@link AjaxAdapter}s, and the default one if any. Deprecated: Breeze 3 sends requests through `config.fetch` and needs no ajax adapter. */
+    ajax = new InterfaceDef("ajax");
+    /** The registered {@link ModelLibraryAdapter}s, and the default one. */
+    modelLibrary = new InterfaceDef("modelLibrary");
+    /** The registered {@link DataServiceAdapter}s, and the default one. */
+    dataService = new InterfaceDef("dataService");
+    /** The registered {@link UriBuilderAdapter}s, and the default one. */
+    uriBuilder = new InterfaceDef("uriBuilder");
+}
+// The data service adapter resolves the ajax adapter when it initializes, so ajax has to
+// come first. Same order as configureBreeze.
+const initOrder = ['modelLibrary', 'uriBuilder', 'ajax', 'dataService'];
+const defaultAdapters = {};
+/**
+Sets the adapters Breeze falls back to when none has been registered for an interface.
+Called once, by default-adapters.ts; applies to every BreezeConfig.
+@hidden @internal
+*/
+export function setDefaultAdapters(defaults) {
+    Object.assign(defaultAdapters, defaults);
+}
+/**
+Breeze's global configuration: the adapter registry, the `fetch` transport, and registries Breeze
+uses to find functions and objects by name when it deserializes metadata. The single instance is
+{@link config}.
+
+To configure Breeze, use {@link configureBreeze}. The adapter methods here (`registerAdapter`,
+`initializeAdapterInstance`, `getAdapterInstance` and the rest) are the 2.x API. They still
+work, and adapters' own static `register()` methods use them, but an application does not
+normally need to call them.
+*/
+export class BreezeConfig {
+    /**
+    Functions registered by name with {@link BreezeConfig.registerFunction}. Breeze looks up
+    validator factories here, under `"Validator." + name`, when it imports metadata. Applications do
+    not normally need it; use {@link Validator.register} and {@link Validator.registerFactory}.
+    */
+    functionRegistry = {};
+    /**
+    Constructors registered by name with {@link BreezeConfig.registerType}. Nothing in Breeze 3
+    reads it; applications do not normally need it.
+    */
+    typeRegistry = {};
+    /**
+    Named instances Breeze can find again by name, keyed `"<TypeName>.<name>"`: every
+    {@link JsonResultsAdapter}, {@link NamingConvention} and {@link LocalQueryComparisonOptions}
+    registers itself here when created. Breeze uses it to resolve the names in exported metadata and
+    exported entities. Applications do not normally need it.
+    */
+    objectRegistry = {};
+    /**
+    Published each time an adapter is initialized, with the interface name, the adapter instance
+    and whether it became the default for its interface. Breeze uses it to let adapters that depend
+    on each other recompose (see {@link BaseAdapter.checkForRecomposition}); applications do not
+    normally need it.
+    */
+    interfaceInitialized;
+    /**
+     * Adapter instances already subscribed to `interfaceInitialized` for recomposition, so that
+     * re-initializing one does not subscribe it twice. Weak because the entry is only ever looked
+     * up for an instance in hand, and one outliving its adapter would be its own small leak.
+     * @hidden @internal
+     */
+    _recomposers = new WeakSet();
+    /**
+    The indentation Breeze passes to `JSON.stringify` when it serializes exported entities
+    (`EntityManager.exportEntities`) and exported metadata (`MetadataStore.exportMetadata`).
+    The default, `''`, produces compact JSON; set it to, say, `'  '` for readable output.
+    */
+    stringifyPad = '';
+    /**
+     * The function Breeze makes HTTP requests with, unless a (deprecated) ajax adapter is
+     * registered. Set it with `configureBreeze({ fetch })`. When unset, `globalThis.fetch`.
+     */
+    fetch;
+    /** @hidden @internal */
+    _interfaceRegistry; // set below, on the global config. Untyped: getInterfaceDef looks interfaces up by name.
+    /** Creates a configuration with nothing registered. Breeze creates the one instance there is,
+    {@link config}; applications do not create their own. */
+    constructor() {
+        this.interfaceInitialized = new BreezeEvent("interfaceInitialized", this);
+    }
+    /**
+    Method use to register implementations of standard breeze interfaces.  Calls to this method are usually
+    made as the last step within an adapter implementation.
+    @param interfaceName {String} - one of the following interface names: "ajax", "dataService", "modelLibrary", "uriBuilder"
+    @param adapterCtor {Function} - an ctor function that returns an instance of the specified interface.
+
+    @deprecated For configuring an application, use `configureBreeze({ ajax: MyAdapter, ... })`
+    instead: the adapter classes are passed directly, so a misspelled name is a compile error
+    rather than a runtime one. An adapter's own static `register()` still calls this - that is
+    how an adapter registers itself, and is not deprecated. Not scheduled for removal.
+    */
+    registerAdapter(interfaceName, adapterCtor) {
+        assertParam(interfaceName, "interfaceName").isNonEmptyString().check();
+        assertParam(adapterCtor, "adapterCtor").isFunction().check();
+        // this impl will be thrown away after the name is retrieved.
+        let impl = new adapterCtor();
+        let implName = impl.name;
+        if (!implName) {
+            throw new Error("Unable to locate a 'name' property on the constructor passed into the 'registerAdapter' call.");
+        }
+        let idef = this.getInterfaceDef(interfaceName);
+        idef.registerCtor(implName, adapterCtor);
+    }
+    /**
+    Returns the ctor function used to implement a specific interface with a specific adapter name.
+    @param interfaceName {String} One of the following interface names: "ajax", "dataService", "modelLibrary", "uriBuilder"
+    @param [adapterName] {String} The name of any previously registered adapter. If this parameter is omitted then
+    this method returns the "default" adapter for this interface. If there is no default adapter, then a null is returned.
+    @returns {Function|null} Returns either a ctor function or null.
+    */
+    getAdapter(interfaceName, adapterName) {
+        let idef = this.getInterfaceDef(interfaceName);
+        if (adapterName) {
+            let impl = idef.getImpl(adapterName);
+            return impl ? impl.ctor : null;
+        }
+        else {
+            return idef.defaultInstance ? idef.defaultInstance._$impl.ctor : null;
+        }
+    }
+    /**
+    Initializes a single adapter implementation. Initialization means either newing a instance of the
+    specified interface and then calling "initialize" on it or simply calling "initialize" on the instance
+    if it already exists.
+    @param interfaceName {String} The name of the interface to which the adapter to initialize belongs.
+    @param adapterName {String} - The name of a previously registered adapter to initialize.
+    @param [isDefault=true] {Boolean} - Whether to make this the default "adapter" for this interface.
+    @returns {an instance of the specified adapter}
+
+    @deprecated For configuring an application, use `configureBreeze({ ajax: MyAdapter, ... })`
+    instead: the adapter classes are passed directly, so a misspelled name is a compile error
+    rather than a runtime one. An adapter's own static `register()` still calls this - that is
+    how an adapter registers itself, and is not deprecated. Not scheduled for removal.
+    */
+    initializeAdapterInstance(interfaceName, adapterName, isDefault = true) {
+        isDefault = isDefault === undefined ? true : isDefault;
+        assertParam(interfaceName, "interfaceName").isNonEmptyString().check();
+        assertParam(adapterName, "adapterName").isNonEmptyString().check();
+        assertParam(isDefault, "isDefault").isBoolean().check();
+        let idef = this.getInterfaceDef(interfaceName);
+        let impl = idef.getImpl(adapterName) || this._registerDefaultAdapter(idef, interfaceName, adapterName);
+        if (!impl) {
+            throw new Error("Unregistered adapter.  Interface: " + interfaceName + " AdapterName: " + adapterName);
+        }
+        return this._initializeAdapterInstanceCore(idef, impl, isDefault);
+    }
+    /**
+    Returns the adapter instance corresponding to the specified interface and adapter names.
+    @param interfaceName {String} The name of the interface.
+    @param [adapterName] {String} - The name of a previously registered adapter.  If this parameter is
+    omitted then the default implementation of the specified interface is returned. If there is
+    no defaultInstance of this interface, then the first registered instance of this interface is returned.
+    @returns {an instance of the specified adapter}
+    */
+    getAdapterInstance(interfaceName, adapterName) {
+        let idef = this.getInterfaceDef(interfaceName);
+        let impl;
+        let isDefault = adapterName == null || adapterName === "";
+        if (isDefault) {
+            if (idef.defaultInstance)
+                return idef.defaultInstance;
+            impl = idef.getFirstImpl();
+        }
+        else {
+            impl = idef.getImpl(adapterName);
+        }
+        if (!impl)
+            impl = this._registerDefaultAdapter(idef, interfaceName, isDefault ? undefined : adapterName);
+        if (!impl)
+            return undefined;
+        if (impl.defaultInstance) {
+            return impl.defaultInstance;
+        }
+        else {
+            return this._initializeAdapterInstanceCore(idef, impl, isDefault);
+        }
+    }
+    /** this is needed for reflection purposes when deserializing an object that needs a fn or ctor.
+        Used to register validators. */
+    registerFunction(fn, fnName) {
+        assertParam(fn, "fn").isFunction().check();
+        assertParam(fnName, "fnName").isString().check();
+        if (fn.prototype) {
+            fn.prototype._$fnName = fnName;
+        }
+        this.functionRegistry[fnName] = fn;
+    }
+    /**
+    Registers a constructor under a type name: stamps the name on its prototype as `_$typeName` and
+    adds it to {@link BreezeConfig.typeRegistry}. Breeze registers `KeyGenerator` this way;
+    applications do not normally need it.
+    @param ctor - The constructor to register.
+    @param typeName - The name to register it under.
+    */
+    registerType(ctor, typeName) {
+        assertParam(ctor, "ctor").isFunction().check();
+        assertParam(typeName, "typeName").isString().check();
+        if (ctor.prototype) {
+            ctor.prototype._$typeName = typeName;
+        }
+        this.typeRegistry[typeName] = ctor;
+    }
+    /**
+    Returns the function registered under the given name with {@link BreezeConfig.registerFunction},
+    or `undefined` if there is none. Validators are registered as `"Validator." + name`, so
+    `config.getRegisteredFunction('Validator.maxLength')` returns the `maxLength` factory.
+    @param fnName - The name the function was registered under.
+    */
+    getRegisteredFunction(fnName) {
+        return this.functionRegistry[fnName];
+    }
+    /**
+    Returns the registry entry for one adapter interface, which holds its registered adapters and
+    its default instance. The name is matched without regard to case.
+    Used by the adapter registration methods; applications do not normally need it.
+    @param interfaceName - `'ajax'`, `'dataService'`, `'modelLibrary'` or `'uriBuilder'`.
+    @throws if there is no interface with that name.
+    */
+    getInterfaceDef(interfaceName) {
+        let lcName = interfaceName.toLowerCase();
+        // source may be null
+        let kv = core.objectFirst(this._interfaceRegistry || {}, function (k, v) {
+            return k.toLowerCase() === lcName;
+        });
+        if (!kv) {
+            throw new Error("Unknown interface name: " + interfaceName);
+        }
+        return kv.value;
+    }
+    /** @deprecated @internal no-op kept for backward compatibility */
+    setQ(q) {
+        console && console.warn("setQ does nothing; ES6 Promise support is required - use a shim if necessary.");
+    }
+    /** @hidden @internal */
+    _storeObject(obj, type, name) {
+        // uncomment this if we make this public.
+        //assertParam(obj, "obj").isObject().check();
+        //assertParam(name, "objName").isString().check();
+        let key = (typeof (type) === "string" ? type : type.prototype._$typeName) + "." + name;
+        this.objectRegistry[key] = obj;
+    }
+    /** @hidden @internal */
+    _fetchObject(type, name) {
+        if (!name)
+            return undefined;
+        let key = (typeof (type) === "string" ? type : type.prototype._$typeName) + "." + name;
+        let result = this.objectRegistry[key];
+        if (!result) {
+            throw new Error("Unable to locate a registered object by the name: " + key);
+        }
+        return result;
+    }
+    /**
+    Registers the default adapter for an interface that has none, so that Breeze works with no
+    configuration at all (see default-adapters.ts). It runs only when the interface is first
+    asked for and nothing has been registered for it, so importing Breeze still registers
+    nothing, and anything an application registers wins. A named lookup falls back only when
+    the name is the default adapter's own.
+    @hidden @internal
+    */
+    _registerDefaultAdapter(idef, interfaceName, adapterName) {
+        const fallback = defaultAdapters[interfaceName];
+        if (!fallback)
+            return undefined;
+        if (!adapterName && fallback.namedOnly)
+            return undefined;
+        const name = new fallback.ctor().name;
+        if (adapterName && adapterName.toLowerCase() !== name.toLowerCase())
+            return undefined;
+        this.registerAdapter(interfaceName, fallback.ctor);
+        return idef.getImpl(name);
+    }
+    /** @hidden @internal */
+    _initializeAdapterInstanceCore(interfaceDef, impl, isDefault) {
+        let instance;
+        let inst = impl.defaultInstance;
+        if (!inst) {
+            instance = new (impl.ctor)();
+            impl.defaultInstance = instance;
+            instance._$impl = impl;
+        }
+        else {
+            instance = inst;
+        }
+        instance.initialize();
+        if (isDefault) {
+            // next line needs to occur before any recomposition
+            interfaceDef.defaultInstance = instance;
+        }
+        // recomposition of other impls will occur here.
+        this.interfaceInitialized.publish({ interfaceName: interfaceDef.name, instance: instance, isDefault: isDefault });
+        // Once per instance, not once per call. An adapter instance is cached on its impl, so
+        // re-initializing the same one - which configureBreeze does, and a test suite does over
+        // and over - used to add a second subscription for the same object: the subscriber list
+        // grew without bound, each duplicate holding the adapter, and checkForRecomposition ran
+        // once per duplicate on every later initialization. See the retention tier.
+        if (instance.checkForRecomposition != null && !this._recomposers.has(instance)) {
+            this._recomposers.add(instance);
+            // now register for own dependencies.
+            this.interfaceInitialized.subscribe((interfaceInitializedArgs) => {
+                // The `!` is needed because narrowing does not reach inside the callback:
+                // `instance` is a mutable binding, so TypeScript has to assume the property
+                // could have been cleared before the subscription fires. Reading it off
+                // `instance` here rather than capturing it in a const is deliberate - that is
+                // what gives the adapter its `this`.
+                instance.checkForRecomposition(interfaceInitializedArgs);
+            });
+        }
+        return instance;
+    }
+}
+/**
+The global {@link BreezeConfig}, used by every `EntityManager`, `MetadataStore` and `DataService`.
+
+To configure Breeze, use {@link configureBreeze}, which sets this object's adapters and `fetch`.
+The 2.x calls on it, such as `config.registerAdapter(...)` and
+`config.initializeAdapterInstance(...)`, still work and are not scheduled for removal.
+*/
+export const config = new BreezeConfig();
+// The adapter interfaces. They are set here rather than in interface-registry.ts because every
+// adapter lookup needs them, and under "sideEffects": false a bundler drops a module that nothing
+// uses a value from - such as interface-registry.ts, which only the barrel imports. See
+// CHANGES-DEV.md.
+config.interfaceRegistry = new InterfaceRegistry();
+config._interfaceRegistry = config.interfaceRegistry;
+config.interfaceRegistry.modelLibrary.getDefaultInstance = function () {
+    // Falls back to the default model library (backingStore) when none is registered.
+    const instance = this.defaultInstance || config.getAdapterInstance("modelLibrary");
+    if (!instance) {
+        throw new Error("Unable to locate the default implementation of the '" + this.name +
+            "' interface. Register one with configureBreeze({ modelLibrary: ... }).");
+    }
+    return instance;
+};
+/** @deprecated Use `configureBreeze({ ... })` instead. Still works; not scheduled for removal. */
+config.initializeAdapterInstances = function (irConfig) {
+    // Validate only - rejects unknown keys. This used to apply irConfig onto the global
+    // config and then walk every property of *config*, passing things like functionRegistry
+    // to initializeAdapterInstance as adapter names, so it always threw. Nothing tested it.
+    assertConfig(irConfig)
+        .whereParam("dataService").isOptional()
+        .whereParam("modelLibrary").isOptional()
+        .whereParam("ajax").isOptional()
+        .whereParam("uriBuilder").isOptional()
+        .applyAll(irConfig, true);
+    initOrder.forEach(name => {
+        const adapterName = irConfig[name];
+        if (adapterName)
+            this.initializeAdapterInstance(name, adapterName, true);
+    });
+};
+// legacy
+core.config = config;
+//# sourceMappingURL=config.js.map

package/config/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AjaxAdapter, BreezeFetch, DataServiceAdapter, InterfaceRegistryConfig, ModelLibraryAdapter, UriBuilderAdapter } from './interface-registry.js';\r\nimport { core } from '../core/core.js';\r\nimport { assertParam, assertConfig } from '../core/assert-param.js';\r\nimport { BreezeEvent } from '../core/event.js';\r\n\r\n/** @hidden */\r\nexport interface AdapterCtor<T extends BaseAdapter> { new (...args: any[]): T; }\r\n/** @hidden */\r\nexport interface IDef<T extends BaseAdapter> { ctor: AdapterCtor<T>; defaultInstance?: T; }\r\n\r\n/**\r\nThe names of the adapter interfaces, as passed to the 2.x-style methods on {@link BreezeConfig}\r\nsuch as `registerAdapter` and `initializeAdapterInstance`. With {@link configureBreeze} you pass\r\nthe adapter classes instead and never need these names.\r\n*/\r\nexport type AdapterType = 'dataService'|'modelLibrary'|'ajax'|'uriBuilder';\r\n\r\nexport class InterfaceDef<T extends BaseAdapter> {\r\n\r\n    name: string;\r\n    defaultInstance?: T;\r\n    /** @hidden @internal */\r\n    _implMap: Map<string, IDef<T>>;\r\n\r\n    constructor(name: string) {\r\n        this.name = name;\r\n        this.defaultInstance = undefined;\r\n        this._implMap = new Map();\r\n    }\r\n\r\n    /** Define an implementation of the given adaptername */\r\n    registerCtor(adapterName: string, ctor: AdapterCtor<T>): void {\r\n        this._implMap.set(adapterName.toLowerCase(), { ctor: ctor, defaultInstance: undefined });\r\n    }\r\n\r\n    /** Return the definition for the given adapterName */\r\n    getImpl(adapterName: string): IDef<T> {\r\n        return this._implMap.get(adapterName.toLowerCase()) as IDef<T>;\r\n    }\r\n\r\n    /** Return the first implementation for this InterfaceDef */\r\n    getFirstImpl(): IDef<T> {\r\n        // Map preserves insertion order, so 'first' is well defined here.\r\n        const first = this._implMap.values().next();\r\n        return first.done ? null as any : first.value;\r\n    }\r\n\r\n    getDefaultInstance() {\r\n        return this.defaultInstance as T;\r\n    }\r\n}\r\n\r\n/** Registers adapters used by Breeze */\r\nexport class InterfaceRegistry {\r\n    /** Creates a registry with no adapters in it. {@link config} holds the one Breeze uses;\r\n    applications do not create their own. */\r\n    constructor() { }\r\n    /** The registered {@link AjaxAdapter}s, and the default one if any. Deprecated: Breeze 3 sends requests through `config.fetch` and needs no ajax adapter. */\r\n    ajax = new InterfaceDef<AjaxAdapter>(\"ajax\");\r\n    /** The registered {@link ModelLibraryAdapter}s, and the default one. */\r\n    modelLibrary = new InterfaceDef<ModelLibraryAdapter>(\"modelLibrary\");\r\n    /** The registered {@link DataServiceAdapter}s, and the default one. */\r\n    dataService = new InterfaceDef<DataServiceAdapter>(\"dataService\");\r\n    /** The registered {@link UriBuilderAdapter}s, and the default one. */\r\n    uriBuilder = new InterfaceDef<UriBuilderAdapter>(\"uriBuilder\");\r\n}\r\n\r\n// The data service adapter resolves the ajax adapter when it initializes, so ajax has to\r\n// come first. Same order as configureBreeze.\r\nconst initOrder: AdapterType[] = ['modelLibrary', 'uriBuilder', 'ajax', 'dataService'];\r\n\r\n/**\r\nWhat every Breeze adapter implements: the model library, data service, URI builder and\r\n(deprecated) ajax adapters all extend this interface.\r\n*/\r\nexport interface BaseAdapter {\r\n    /** @hidden @internal */\r\n    _$impl?: any;\r\n    /**\r\n    The name the adapter is registered under, such as `'webApi'` or `'backingStore'`. Names are\r\n    matched without regard to case. `registerAdapter` reads it from a throwaway instance and throws\r\n    if it is empty.\r\n    */\r\n    name: string;\r\n    /**\r\n    Called by Breeze each time the adapter is initialized: when it is first created, and again\r\n    whenever it is initialized by name or registered again, for example by {@link configureBreeze}.\r\n    Resolve anything the adapter depends on here, not in the constructor.\r\n    */\r\n    initialize(): void;\r\n    /**\r\n    Optional. Called each time any adapter is initialized after this one first was, with\r\n    `{ interfaceName, instance, isDefault }`, so that this adapter can pick up a new dependency. The data service adapters use\r\n    it to re-resolve their ajax adapter when a new default ajax adapter is initialized.\r\n    */\r\n    checkForRecomposition?: (context: any) => void;\r\n}\r\n\r\n/**\r\nAn adapter Breeze falls back to for an interface when nothing has been registered for it.\r\n@hidden\r\n*/\r\nexport interface DefaultAdapter {\r\n    ctor: AdapterCtor<any>;\r\n    /** Use only when asked for by name, never as the unnamed default. */\r\n    namedOnly?: boolean;\r\n}\r\n\r\nconst defaultAdapters: Partial<Record<AdapterType, DefaultAdapter>> = {};\r\n\r\n/**\r\nSets the adapters Breeze falls back to when none has been registered for an interface.\r\nCalled once, by default-adapters.ts; applies to every BreezeConfig.\r\n@hidden @internal\r\n*/\r\nexport function setDefaultAdapters(defaults: Partial<Record<AdapterType, DefaultAdapter>>) {\r\n    Object.assign(defaultAdapters, defaults);\r\n}\r\n\r\n/**\r\nBreeze's global configuration: the adapter registry, the `fetch` transport, and registries Breeze\r\nuses to find functions and objects by name when it deserializes metadata. The single instance is\r\n{@link config}.\r\n\r\nTo configure Breeze, use {@link configureBreeze}. The adapter methods here (`registerAdapter`,\r\n`initializeAdapterInstance`, `getAdapterInstance` and the rest) are the 2.x API. They still\r\nwork, and adapters' own static `register()` methods use them, but an application does not\r\nnormally need to call them.\r\n*/\r\nexport class BreezeConfig {\r\n    /**\r\n    Functions registered by name with {@link BreezeConfig.registerFunction}. Breeze looks up\r\n    validator factories here, under `\"Validator.\" + name`, when it imports metadata. Applications do\r\n    not normally need it; use {@link Validator.register} and {@link Validator.registerFactory}.\r\n    */\r\n    functionRegistry: Record<string, Function> = {};\r\n    /**\r\n    Constructors registered by name with {@link BreezeConfig.registerType}. Nothing in Breeze 3\r\n    reads it; applications do not normally need it.\r\n    */\r\n    typeRegistry: Record<string, Function> = {};\r\n    /**\r\n    Named instances Breeze can find again by name, keyed `\"<TypeName>.<name>\"`: every\r\n    {@link JsonResultsAdapter}, {@link NamingConvention} and {@link LocalQueryComparisonOptions}\r\n    registers itself here when created. Breeze uses it to resolve the names in exported metadata and\r\n    exported entities. Applications do not normally need it.\r\n    */\r\n    objectRegistry: Record<string, any> = {};\r\n    /**\r\n    Published each time an adapter is initialized, with the interface name, the adapter instance\r\n    and whether it became the default for its interface. Breeze uses it to let adapters that depend\r\n    on each other recompose (see {@link BaseAdapter.checkForRecomposition}); applications do not\r\n    normally need it.\r\n    */\r\n    interfaceInitialized: BreezeEvent<{\r\n        /** The interface the adapter implements: `\"ajax\"`, `\"dataService\"`, `\"modelLibrary\"` or `\"uriBuilder\"`. */\r\n        interfaceName: string,\r\n        /** The adapter that was initialized. */\r\n        instance: BaseAdapter,\r\n        /** Whether it became the default adapter for its interface. */\r\n        isDefault: boolean\r\n    }>;\r\n\r\n    /**\r\n     * Adapter instances already subscribed to `interfaceInitialized` for recomposition, so that\r\n     * re-initializing one does not subscribe it twice. Weak because the entry is only ever looked\r\n     * up for an instance in hand, and one outliving its adapter would be its own small leak.\r\n     * @hidden @internal\r\n     */\r\n    private _recomposers = new WeakSet<BaseAdapter>();\r\n\r\n    /**\r\n    The indentation Breeze passes to `JSON.stringify` when it serializes exported entities\r\n    (`EntityManager.exportEntities`) and exported metadata (`MetadataStore.exportMetadata`).\r\n    The default, `''`, produces compact JSON; set it to, say, `'  '` for readable output.\r\n    */\r\n    stringifyPad = '';\r\n    /**\r\n     * The function Breeze makes HTTP requests with, unless a (deprecated) ajax adapter is\r\n     * registered. Set it with `configureBreeze({ fetch })`. When unset, `globalThis.fetch`.\r\n     */\r\n    fetch?: BreezeFetch;\r\n    /** @hidden @internal */\r\n    _interfaceRegistry: any;  // set below, on the global config. Untyped: getInterfaceDef looks interfaces up by name.\r\n    /** @hidden @internal The adapter interfaces, strongly typed. Set below, on the global config. */\r\n    declare interfaceRegistry: InterfaceRegistry;\r\n    /**\r\n    Initializes a collection of adapter implementations and makes each one the default for its corresponding interface.\r\n    @deprecated Use `configureBreeze({ ... })` instead. Still works; not scheduled for removal.\r\n    @param irConfig - The name of a previously registered adapter for each interface to initialize,\r\n    e.g. `{ ajax: 'fetch', dataService: 'webApi' }`. Interfaces not named are left as they are.\r\n    @hidden @internal\r\n    */\r\n    declare initializeAdapterInstances: (irConfig: InterfaceRegistryConfig) => void;\r\n\r\n    /** Creates a configuration with nothing registered. Breeze creates the one instance there is,\r\n    {@link config}; applications do not create their own. */\r\n    constructor() {\r\n        this.interfaceInitialized = new BreezeEvent(\"interfaceInitialized\", this);\r\n    }\r\n\r\n    /**\r\n    Method use to register implementations of standard breeze interfaces.  Calls to this method are usually\r\n    made as the last step within an adapter implementation.\r\n    @param interfaceName {String} - one of the following interface names: \"ajax\", \"dataService\", \"modelLibrary\", \"uriBuilder\"\r\n    @param adapterCtor {Function} - an ctor function that returns an instance of the specified interface.\r\n\r\n    @deprecated For configuring an application, use `configureBreeze({ ajax: MyAdapter, ... })`\r\n    instead: the adapter classes are passed directly, so a misspelled name is a compile error\r\n    rather than a runtime one. An adapter's own static `register()` still calls this - that is\r\n    how an adapter registers itself, and is not deprecated. Not scheduled for removal.\r\n    */\r\n    registerAdapter<T extends BaseAdapter>(interfaceName: AdapterType, adapterCtor: AdapterCtor<T>) {\r\n        assertParam(interfaceName, \"interfaceName\").isNonEmptyString().check();\r\n        assertParam(adapterCtor, \"adapterCtor\").isFunction().check();\r\n        // this impl will be thrown away after the name is retrieved.\r\n        let impl = new adapterCtor();\r\n        let implName = impl.name;\r\n        if (!implName) {\r\n            throw new Error(\"Unable to locate a 'name' property on the constructor passed into the 'registerAdapter' call.\");\r\n        }\r\n        let idef = this.getInterfaceDef(interfaceName);\r\n        idef.registerCtor(implName, adapterCtor);\r\n    }\r\n\r\n    /**\r\n    Returns the ctor function used to implement a specific interface with a specific adapter name.\r\n    @param interfaceName {String} One of the following interface names: \"ajax\", \"dataService\", \"modelLibrary\", \"uriBuilder\"\r\n    @param [adapterName] {String} The name of any previously registered adapter. If this parameter is omitted then\r\n    this method returns the \"default\" adapter for this interface. If there is no default adapter, then a null is returned.\r\n    @returns {Function|null} Returns either a ctor function or null.\r\n    */\r\n    getAdapter(interfaceName: AdapterType, adapterName: string) {\r\n        let idef = this.getInterfaceDef(interfaceName);\r\n        if (adapterName) {\r\n            let impl = idef.getImpl(adapterName);\r\n            return impl ? impl.ctor : null;\r\n        } else {\r\n            return idef.defaultInstance ? idef.defaultInstance._$impl.ctor : null;\r\n        }\r\n    }\r\n\r\n    /**\r\n    Initializes a single adapter implementation. Initialization means either newing a instance of the\r\n    specified interface and then calling \"initialize\" on it or simply calling \"initialize\" on the instance\r\n    if it already exists.\r\n    @param interfaceName {String} The name of the interface to which the adapter to initialize belongs.\r\n    @param adapterName {String} - The name of a previously registered adapter to initialize.\r\n    @param [isDefault=true] {Boolean} - Whether to make this the default \"adapter\" for this interface.\r\n    @returns {an instance of the specified adapter}\r\n\r\n    @deprecated For configuring an application, use `configureBreeze({ ajax: MyAdapter, ... })`\r\n    instead: the adapter classes are passed directly, so a misspelled name is a compile error\r\n    rather than a runtime one. An adapter's own static `register()` still calls this - that is\r\n    how an adapter registers itself, and is not deprecated. Not scheduled for removal.\r\n    */\r\n    initializeAdapterInstance(interfaceName: AdapterType, adapterName: string, isDefault: boolean = true) {\r\n        isDefault = isDefault === undefined ? true : isDefault;\r\n        assertParam(interfaceName, \"interfaceName\").isNonEmptyString().check();\r\n        assertParam(adapterName, \"adapterName\").isNonEmptyString().check();\r\n        assertParam(isDefault, \"isDefault\").isBoolean().check();\r\n\r\n        let idef = this.getInterfaceDef(interfaceName);\r\n        let impl = idef.getImpl(adapterName) || this._registerDefaultAdapter(idef, interfaceName, adapterName);\r\n        if (!impl) {\r\n            throw new Error(\"Unregistered adapter.  Interface: \" + interfaceName + \" AdapterName: \" + adapterName);\r\n        }\r\n\r\n        return this._initializeAdapterInstanceCore(idef, impl, isDefault);\r\n    }\r\n\r\n    /**\r\n    Returns the adapter instance corresponding to the specified interface and adapter names.\r\n    @param interfaceName {String} The name of the interface.\r\n    @param [adapterName] {String} - The name of a previously registered adapter.  If this parameter is\r\n    omitted then the default implementation of the specified interface is returned. If there is\r\n    no defaultInstance of this interface, then the first registered instance of this interface is returned.\r\n    @returns {an instance of the specified adapter}\r\n    */\r\n    getAdapterInstance<T extends BaseAdapter>(interfaceName: AdapterType, adapterName?: string) {\r\n        let idef = this.getInterfaceDef<T>(interfaceName);\r\n        let impl: IDef<T>;\r\n\r\n        let isDefault = adapterName == null || adapterName === \"\";\r\n        if (isDefault) {\r\n            if (idef.defaultInstance) return idef.defaultInstance;\r\n            impl = idef.getFirstImpl();\r\n        } else {\r\n            impl = idef.getImpl(adapterName!);\r\n        }\r\n        if (!impl) impl = this._registerDefaultAdapter(idef, interfaceName, isDefault ? undefined : adapterName)!;\r\n        if (!impl) return undefined;\r\n        if (impl.defaultInstance) {\r\n            return impl.defaultInstance;\r\n        } else {\r\n            return this._initializeAdapterInstanceCore(idef, impl, isDefault);\r\n        }\r\n    }\r\n\r\n    /** this is needed for reflection purposes when deserializing an object that needs a fn or ctor.\r\n        Used to register validators. */\r\n    registerFunction(fn: Function, fnName: string) {\r\n        assertParam(fn, \"fn\").isFunction().check();\r\n        assertParam(fnName, \"fnName\").isString().check();\r\n        if (fn.prototype) {\r\n            fn.prototype._$fnName = fnName;\r\n        }\r\n        this.functionRegistry[fnName] = fn;\r\n    }\r\n\r\n    /**\r\n    Registers a constructor under a type name: stamps the name on its prototype as `_$typeName` and\r\n    adds it to {@link BreezeConfig.typeRegistry}. Breeze registers `KeyGenerator` this way;\r\n    applications do not normally need it.\r\n    @param ctor - The constructor to register.\r\n    @param typeName - The name to register it under.\r\n    */\r\n    registerType(ctor: Function, typeName: string) {\r\n        assertParam(ctor, \"ctor\").isFunction().check();\r\n        assertParam(typeName, \"typeName\").isString().check();\r\n        if (ctor.prototype) {\r\n            ctor.prototype._$typeName = typeName;\r\n        }\r\n        this.typeRegistry[typeName] = ctor;\r\n    }\r\n\r\n    /**\r\n    Returns the function registered under the given name with {@link BreezeConfig.registerFunction},\r\n    or `undefined` if there is none. Validators are registered as `\"Validator.\" + name`, so\r\n    `config.getRegisteredFunction('Validator.maxLength')` returns the `maxLength` factory.\r\n    @param fnName - The name the function was registered under.\r\n    */\r\n    getRegisteredFunction(fnName: string) {\r\n        return this.functionRegistry[fnName];\r\n    }\r\n\r\n    /**\r\n    Returns the registry entry for one adapter interface, which holds its registered adapters and\r\n    its default instance. The name is matched without regard to case.\r\n    Used by the adapter registration methods; applications do not normally need it.\r\n    @param interfaceName - `'ajax'`, `'dataService'`, `'modelLibrary'` or `'uriBuilder'`.\r\n    @throws if there is no interface with that name.\r\n    */\r\n    getInterfaceDef<T extends BaseAdapter>(interfaceName: string) {\r\n        let lcName = interfaceName.toLowerCase();\r\n        // source may be null\r\n        let kv = core.objectFirst(this._interfaceRegistry || {}, function (k, v) {\r\n            return k.toLowerCase() === lcName;\r\n        });\r\n        if (!kv) {\r\n            throw new Error(\"Unknown interface name: \" + interfaceName);\r\n        }\r\n        return <InterfaceDef<T>>kv.value;\r\n    }\r\n\r\n    /** @deprecated @internal no-op kept for backward compatibility */\r\n    setQ(q: any) {\r\n        console && console.warn(\"setQ does nothing; ES6 Promise support is required - use a shim if necessary.\");\r\n    }\r\n\r\n    /** @hidden @internal */\r\n    _storeObject(obj: Object, type: string | Function, name: string) {\r\n        // uncomment this if we make this public.\r\n        //assertParam(obj, \"obj\").isObject().check();\r\n        //assertParam(name, \"objName\").isString().check();\r\n        let key = (typeof (type) === \"string\" ? type : type.prototype._$typeName) + \".\" + name;\r\n        this.objectRegistry[key] = obj;\r\n    }\r\n\r\n    /** @hidden @internal */\r\n    _fetchObject(type: string | Function, name: string) {\r\n        if (!name) return undefined;\r\n        let key = (typeof (type) === \"string\" ? type : type.prototype._$typeName) + \".\" + name;\r\n        let result = this.objectRegistry[key];\r\n        if (!result) {\r\n            throw new Error(\"Unable to locate a registered object by the name: \" + key);\r\n        }\r\n        return result;\r\n    }\r\n\r\n    /**\r\n    Registers the default adapter for an interface that has none, so that Breeze works with no\r\n    configuration at all (see default-adapters.ts). It runs only when the interface is first\r\n    asked for and nothing has been registered for it, so importing Breeze still registers\r\n    nothing, and anything an application registers wins. A named lookup falls back only when\r\n    the name is the default adapter's own.\r\n    @hidden @internal\r\n    */\r\n    _registerDefaultAdapter<T extends BaseAdapter>(idef: InterfaceDef<T>, interfaceName: AdapterType, adapterName?: string): IDef<T> | undefined {\r\n        const fallback = defaultAdapters[interfaceName];\r\n        if (!fallback) return undefined;\r\n        if (!adapterName && fallback.namedOnly) return undefined;\r\n        const name: string = new fallback.ctor().name;\r\n        if (adapterName && adapterName.toLowerCase() !== name.toLowerCase()) return undefined;\r\n        this.registerAdapter(interfaceName, fallback.ctor);\r\n        return idef.getImpl(name);\r\n    }\r\n\r\n    /** @hidden @internal */\r\n    _initializeAdapterInstanceCore<T extends BaseAdapter>(interfaceDef: InterfaceDef<T>, impl: IDef<T>, isDefault: boolean) {\r\n        let instance: T;\r\n        let inst = impl.defaultInstance;\r\n        if (!inst) {\r\n            instance = new (impl.ctor)();\r\n            impl.defaultInstance = instance;\r\n            instance._$impl = impl;\r\n        } else {\r\n            instance = inst;\r\n        }\r\n\r\n        instance.initialize();\r\n\r\n        if (isDefault) {\r\n            // next line needs to occur before any recomposition\r\n            interfaceDef.defaultInstance = instance;\r\n        }\r\n\r\n        // recomposition of other impls will occur here.\r\n        this.interfaceInitialized.publish({ interfaceName: interfaceDef.name, instance: instance, isDefault: isDefault });\r\n\r\n        // Once per instance, not once per call. An adapter instance is cached on its impl, so\r\n        // re-initializing the same one - which configureBreeze does, and a test suite does over\r\n        // and over - used to add a second subscription for the same object: the subscriber list\r\n        // grew without bound, each duplicate holding the adapter, and checkForRecomposition ran\r\n        // once per duplicate on every later initialization. See the retention tier.\r\n        if (instance.checkForRecomposition != null && !this._recomposers.has(instance)) {\r\n            this._recomposers.add(instance);\r\n            // now register for own dependencies.\r\n            this.interfaceInitialized.subscribe((interfaceInitializedArgs) => {\r\n                // The `!` is needed because narrowing does not reach inside the callback:\r\n                // `instance` is a mutable binding, so TypeScript has to assume the property\r\n                // could have been cleared before the subscription fires. Reading it off\r\n                // `instance` here rather than capturing it in a const is deliberate - that is\r\n                // what gives the adapter its `this`.\r\n                instance.checkForRecomposition!(interfaceInitializedArgs);\r\n            });\r\n        }\r\n\r\n        return instance;\r\n    }\r\n\r\n}\r\n\r\n/**\r\nThe global {@link BreezeConfig}, used by every `EntityManager`, `MetadataStore` and `DataService`.\r\n\r\nTo configure Breeze, use {@link configureBreeze}, which sets this object's adapters and `fetch`.\r\nThe 2.x calls on it, such as `config.registerAdapter(...)` and\r\n`config.initializeAdapterInstance(...)`, still work and are not scheduled for removal.\r\n*/\r\nexport const config = new BreezeConfig();\r\n\r\n// The adapter interfaces. They are set here rather than in interface-registry.ts because every\r\n// adapter lookup needs them, and under \"sideEffects\": false a bundler drops a module that nothing\r\n// uses a value from - such as interface-registry.ts, which only the barrel imports. See\r\n// CHANGES-DEV.md.\r\nconfig.interfaceRegistry = new InterfaceRegistry();\r\nconfig._interfaceRegistry = config.interfaceRegistry;\r\nconfig.interfaceRegistry.modelLibrary.getDefaultInstance = function() {\r\n    // Falls back to the default model library (backingStore) when none is registered.\r\n    const instance = this.defaultInstance || config.getAdapterInstance<ModelLibraryAdapter>(\"modelLibrary\");\r\n    if (!instance) {\r\n        throw new Error(\"Unable to locate the default implementation of the '\" + this.name +\r\n            \"' interface. Register one with configureBreeze({ modelLibrary: ... }).\");\r\n    }\r\n    return instance;\r\n};\r\n\r\n/** @deprecated Use `configureBreeze({ ... })` instead. Still works; not scheduled for removal. */\r\nconfig.initializeAdapterInstances = function (irConfig: InterfaceRegistryConfig) {\r\n    // Validate only - rejects unknown keys. This used to apply irConfig onto the global\r\n    // config and then walk every property of *config*, passing things like functionRegistry\r\n    // to initializeAdapterInstance as adapter names, so it always threw. Nothing tested it.\r\n    assertConfig(irConfig)\r\n        .whereParam(\"dataService\").isOptional()\r\n        .whereParam(\"modelLibrary\").isOptional()\r\n        .whereParam(\"ajax\").isOptional()\r\n        .whereParam(\"uriBuilder\").isOptional()\r\n        .applyAll(irConfig, true);\r\n    initOrder.forEach(name => {\r\n        const adapterName = irConfig[name];\r\n        if (adapterName) this.initializeAdapterInstance(name, adapterName, true);\r\n    });\r\n};\r\n\r\n// legacy\r\n(core as any).config = config;\r\n\r\n\r\n\r\n"]}

package/config/configure.d.ts

@@ -0,0 +1,66 @@
+import { BreezeConfig } from './config.js';
+import { BreezeFetch } from './interface-registry.js';
+import { NamingConvention } from '../metadata/naming-convention.js';
+/**
+ * Anything with a static `register` method - which is every Breeze adapter.
+ * @hidden
+ */
+export interface AdapterRegistration {
+    register(breezeConfig?: BreezeConfig, ...rest: any[]): any;
+}
+/** An ajax adapter, which may additionally accept a custom transport. */
+export interface AjaxAdapterRegistration {
+    /**
+     * Registers the adapter and initializes it as the default ajax adapter, as
+     * `AjaxFetchAdapter.register` does. {@link configureBreeze} calls it
+     * with its target config and, when you pass one, the `fetch` option as the adapter's transport.
+     */
+    register(breezeConfig?: BreezeConfig, fetchFn?: BreezeFetch): any;
+}
+/** Options accepted by {@link configureBreeze}. */
+export interface BreezeSetupOptions {
+    /** Model library adapter. Defaults to `ModelLibraryBackingStoreAdapter`. */
+    modelLibrary?: AdapterRegistration;
+    /** Uri builder adapter. Defaults to `UriBuilderJsonAdapter`. */
+    uriBuilder?: AdapterRegistration;
+    /**
+     * @deprecated Breeze no longer needs an ajax adapter: requests go through `fetch`.
+     * Passing one still works. It is registered as in 2.x and used instead of `config.fetch`,
+     * and is handed `fetch` as its transport if you supply both.
+     */
+    ajax?: AjaxAdapterRegistration;
+    /** Data service adapter. Defaults to `DataServiceWebApiAdapter`. */
+    dataService?: AdapterRegistration;
+    /**
+     * The function Breeze makes every HTTP request with. Use it to add auth headers, retry or
+     * logging, or to route requests through a framework HTTP client. Sets `config.fetch`;
+     * defaults to `globalThis.fetch`.
+     */
+    fetch?: BreezeFetch;
+    /** Sets the default NamingConvention. Defaults to `NamingConvention.camelCase`; use `NamingConvention.none` when the server already sends the names the client should use. */
+    namingConvention?: NamingConvention;
+    /** Configure a BreezeConfig other than the global one. Rarely needed. */
+    config?: BreezeConfig;
+}
+/**
+ * Configures Breeze in a single typed call.
+ *
+ * Every option is optional, and a Breeze .NET server needs none of them. With no call at
+ * all, Breeze uses its default adapters - the backing-store model library, the JSON uri
+ * builder and the Web API data service - sends requests through `globalThis.fetch`, and
+ * maps property names with `NamingConvention.camelCase`.
+ *
+ * ```ts
+ * import { configureBreeze, NamingConvention } from 'breeze-client';
+ *
+ * // a server that already sends the names the client should use, with an auth transport
+ * configureBreeze({ namingConvention: NamingConvention.none, fetch: myAuthFetch });
+ * ```
+ *
+ * Pass an adapter to replace a default, e.g. `configureBreeze({ dataService: MyAdapter })`.
+ *
+ * This replaces the stringly-typed pairs of `config.registerAdapter("dataService", Ctor)`
+ * and `config.initializeAdapterInstance("dataService", "webApi", true)`. Those still work and
+ * are unchanged, but are deprecated.
+ */
+export declare function configureBreeze(options: BreezeSetupOptions): void;

package/config/configure.js

@@ -0,0 +1,46 @@
+import { config } from './config.js';
+/**
+ * Configures Breeze in a single typed call.
+ *
+ * Every option is optional, and a Breeze .NET server needs none of them. With no call at
+ * all, Breeze uses its default adapters - the backing-store model library, the JSON uri
+ * builder and the Web API data service - sends requests through `globalThis.fetch`, and
+ * maps property names with `NamingConvention.camelCase`.
+ *
+ * ```ts
+ * import { configureBreeze, NamingConvention } from 'breeze-client';
+ *
+ * // a server that already sends the names the client should use, with an auth transport
+ * configureBreeze({ namingConvention: NamingConvention.none, fetch: myAuthFetch });
+ * ```
+ *
+ * Pass an adapter to replace a default, e.g. `configureBreeze({ dataService: MyAdapter })`.
+ *
+ * This replaces the stringly-typed pairs of `config.registerAdapter("dataService", Ctor)`
+ * and `config.initializeAdapterInstance("dataService", "webApi", true)`. Those still work and
+ * are unchanged, but are deprecated.
+ */
+export function configureBreeze(options) {
+    const cfg = options.config || config;
+    if (options.modelLibrary) {
+        options.modelLibrary.register(cfg);
+    }
+    if (options.uriBuilder) {
+        options.uriBuilder.register(cfg);
+    }
+    if (options.fetch) {
+        cfg.fetch = options.fetch;
+    }
+    if (options.ajax) {
+        // Deprecated path. A registered ajax adapter takes precedence over config.fetch, so it
+        // is handed the same transport.
+        options.ajax.register(cfg, options.fetch);
+    }
+    if (options.dataService) {
+        options.dataService.register(cfg);
+    }
+    if (options.namingConvention) {
+        options.namingConvention.setAsDefault();
+    }
+}
+//# sourceMappingURL=configure.js.map

package/config/configure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.js","sourceRoot":"","sources":["../../src/config/configure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,MAAM,aAAa,CAAC;AAmDnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,eAAe,CAAC,OAA2B;IACzD,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC;IAErC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,uFAAuF;QACvF,gCAAgC;QAChC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC7B,OAAO,CAAC,gBAAgB,CAAC,YAAY,EAAE,CAAC;IAC1C,CAAC;AACH,CAAC","sourcesContent":["import { BreezeConfig, config } from './config.js';\nimport { BreezeFetch } from './interface-registry.js';\nimport { NamingConvention } from '../metadata/naming-convention.js';\n\n/**\n * Anything with a static `register` method - which is every Breeze adapter.\n * @hidden\n */\nexport interface AdapterRegistration {\n  register(breezeConfig?: BreezeConfig, ...rest: any[]): any;\n}\n\n/** An ajax adapter, which may additionally accept a custom transport. */\nexport interface AjaxAdapterRegistration {\n  /**\n   * Registers the adapter and initializes it as the default ajax adapter, as\n   * `AjaxFetchAdapter.register` does. {@link configureBreeze} calls it\n   * with its target config and, when you pass one, the `fetch` option as the adapter's transport.\n   */\n  register(breezeConfig?: BreezeConfig, fetchFn?: BreezeFetch): any;\n}\n\n/** Options accepted by {@link configureBreeze}. */\nexport interface BreezeSetupOptions {\n  /** Model library adapter. Defaults to `ModelLibraryBackingStoreAdapter`. */\n  modelLibrary?: AdapterRegistration;\n  /** Uri builder adapter. Defaults to `UriBuilderJsonAdapter`. */\n  uriBuilder?: AdapterRegistration;\n  /**\n   * @deprecated Breeze no longer needs an ajax adapter: requests go through `fetch`.\n   * Passing one still works. It is registered as in 2.x and used instead of `config.fetch`,\n   * and is handed `fetch` as its transport if you supply both.\n   */\n  ajax?: AjaxAdapterRegistration;\n  /** Data service adapter. Defaults to `DataServiceWebApiAdapter`. */\n  dataService?: AdapterRegistration;\n\n  /**\n   * The function Breeze makes every HTTP request with. Use it to add auth headers, retry or\n   * logging, or to route requests through a framework HTTP client. Sets `config.fetch`;\n   * defaults to `globalThis.fetch`.\n   */\n  fetch?: BreezeFetch;\n\n  /** Sets the default NamingConvention. Defaults to `NamingConvention.camelCase`; use `NamingConvention.none` when the server already sends the names the client should use. */\n  namingConvention?: NamingConvention;\n\n  /** Configure a BreezeConfig other than the global one. Rarely needed. */\n  config?: BreezeConfig;\n}\n\n/**\n * Configures Breeze in a single typed call.\n *\n * Every option is optional, and a Breeze .NET server needs none of them. With no call at\n * all, Breeze uses its default adapters - the backing-store model library, the JSON uri\n * builder and the Web API data service - sends requests through `globalThis.fetch`, and\n * maps property names with `NamingConvention.camelCase`.\n *\n * ```ts\n * import { configureBreeze, NamingConvention } from 'breeze-client';\n *\n * // a server that already sends the names the client should use, with an auth transport\n * configureBreeze({ namingConvention: NamingConvention.none, fetch: myAuthFetch });\n * ```\n *\n * Pass an adapter to replace a default, e.g. `configureBreeze({ dataService: MyAdapter })`.\n *\n * This replaces the stringly-typed pairs of `config.registerAdapter(\"dataService\", Ctor)`\n * and `config.initializeAdapterInstance(\"dataService\", \"webApi\", true)`. Those still work and\n * are unchanged, but are deprecated.\n */\nexport function configureBreeze(options: BreezeSetupOptions): void {\n  const cfg = options.config || config;\n\n  if (options.modelLibrary) {\n    options.modelLibrary.register(cfg);\n  }\n  if (options.uriBuilder) {\n    options.uriBuilder.register(cfg);\n  }\n  if (options.fetch) {\n    cfg.fetch = options.fetch;\n  }\n  if (options.ajax) {\n    // Deprecated path. A registered ajax adapter takes precedence over config.fetch, so it\n    // is handed the same transport.\n    options.ajax.register(cfg, options.fetch);\n  }\n  if (options.dataService) {\n    options.dataService.register(cfg);\n  }\n  if (options.namingConvention) {\n    options.namingConvention.setAsDefault();\n  }\n}\n"]}

package/config/default-adapters.d.ts

@@ -0,0 +1 @@
+export {};

package/config/default-adapters.js

@@ -0,0 +1,40 @@
+import { config } from './config.js';
+import { AjaxFetchAdapter, defaultFetch } from '../adapters/http.js';
+import { UriBuilderJsonAdapter } from '../adapters/adapter-uri-builder-json.js';
+import { DataServiceWebApiAdapter } from '../adapters/adapter-data-service-webapi.js';
+/*
+ * The adapters Breeze uses when an application registers none. With no configuration at
+ * all, `new EntityManager(serviceName)` tracks changes with the backing-store model library,
+ * builds Breeze JSON query URLs, talks to a Breeze .NET server, and sends its requests through
+ * `config.fetch` (globalThis.fetch unless set).
+ *
+ * Nothing is registered here. These fill a fallback table; config.ts registers a default only
+ * when an interface is first asked for and nothing has been registered for it, so anything an
+ * application registers - before or after - wins.
+ *
+ * entity-manager.ts installs them, when it loads, by passing `serverDefaultAdapters` to
+ * setDefaultAdapters. Using a value from this module is what keeps it in a bundle: an import
+ * for effect alone would be dropped under "sideEffects": false (see CHANGES-DEV.md). The model
+ * library default is installed by entity-metadata.ts instead, because a MetadataStore needs one
+ * even in a bundle with no EntityManager.
+ *
+ * Only entity-manager.ts imports this module, and nothing this module depends on may import it -
+ * entity-metadata.ts, say, or the barrel. That is an import cycle that fails at load time whenever
+ * abstract-data-service-adapter.ts loads first: DataServiceWebApiAdapter extends
+ * AbstractDataServiceAdapter while its module loads.
+ */
+/** What a 2.x-style `initializeAdapterInstance('ajax', 'fetch')` gets: an ajax adapter that
+    reads config.fetch on every request, as the default path does. */
+class ConfiguredFetchAjaxAdapter extends AjaxFetchAdapter {
+    constructor() {
+        super((input, init) => (config.fetch || defaultFetch)(input, init));
+    }
+}
+/** The defaults for the server-facing interfaces. @hidden @internal */
+export const serverDefaultAdapters = {
+    uriBuilder: { ctor: UriBuilderJsonAdapter },
+    dataService: { ctor: DataServiceWebApiAdapter },
+    // Never the unnamed default: with no ajax adapter, requests already go through config.fetch.
+    ajax: { ctor: ConfiguredFetchAjaxAdapter, namedOnly: true },
+};
+//# sourceMappingURL=default-adapters.js.map

package/config/default-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-adapters.js","sourceRoot":"","sources":["../../src/config/default-adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;qEACqE;AACrE,MAAM,0BAA2B,SAAQ,gBAAgB;IACvD;QACE,KAAK,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,YAAY,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IACtE,CAAC;CACF;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAiD;IACjF,UAAU,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAC3C,WAAW,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE;IAC/C,6FAA6F;IAC7F,IAAI,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,SAAS,EAAE,IAAI,EAAE;CAC5D,CAAC","sourcesContent":["import { config } from './config.js';\r\nimport type { AdapterType, DefaultAdapter } from './config.js';\r\nimport { AjaxFetchAdapter, defaultFetch } from '../adapters/http.js';\r\nimport { UriBuilderJsonAdapter } from '../adapters/adapter-uri-builder-json.js';\r\nimport { DataServiceWebApiAdapter } from '../adapters/adapter-data-service-webapi.js';\r\n\r\n/*\r\n * The adapters Breeze uses when an application registers none. With no configuration at\r\n * all, `new EntityManager(serviceName)` tracks changes with the backing-store model library,\r\n * builds Breeze JSON query URLs, talks to a Breeze .NET server, and sends its requests through\r\n * `config.fetch` (globalThis.fetch unless set).\r\n *\r\n * Nothing is registered here. These fill a fallback table; config.ts registers a default only\r\n * when an interface is first asked for and nothing has been registered for it, so anything an\r\n * application registers - before or after - wins.\r\n *\r\n * entity-manager.ts installs them, when it loads, by passing `serverDefaultAdapters` to\r\n * setDefaultAdapters. Using a value from this module is what keeps it in a bundle: an import\r\n * for effect alone would be dropped under \"sideEffects\": false (see CHANGES-DEV.md). The model\r\n * library default is installed by entity-metadata.ts instead, because a MetadataStore needs one\r\n * even in a bundle with no EntityManager.\r\n *\r\n * Only entity-manager.ts imports this module, and nothing this module depends on may import it -\r\n * entity-metadata.ts, say, or the barrel. That is an import cycle that fails at load time whenever\r\n * abstract-data-service-adapter.ts loads first: DataServiceWebApiAdapter extends\r\n * AbstractDataServiceAdapter while its module loads.\r\n */\r\n\r\n/** What a 2.x-style `initializeAdapterInstance('ajax', 'fetch')` gets: an ajax adapter that\r\n    reads config.fetch on every request, as the default path does. */\r\nclass ConfiguredFetchAjaxAdapter extends AjaxFetchAdapter {\r\n  constructor() {\r\n    super((input, init) => (config.fetch || defaultFetch)(input, init));\r\n  }\r\n}\r\n\r\n/** The defaults for the server-facing interfaces. @hidden @internal */\r\nexport const serverDefaultAdapters: Partial<Record<AdapterType, DefaultAdapter>> = {\r\n  uriBuilder: { ctor: UriBuilderJsonAdapter },\r\n  dataService: { ctor: DataServiceWebApiAdapter },\r\n  // Never the unnamed default: with no ajax adapter, requests already go through config.fetch.\r\n  ajax: { ctor: ConfiguredFetchAjaxAdapter, namedOnly: true },\r\n};\r\n"]}