breeze-client 2.2.2 → 3.0.0

package/adapters/adapter-model-library-backing-store.js

@@ -0,0 +1,321 @@
+import { config as globalConfig } from '../config/config.js';
+import { core } from '../core/core.js';
+import { EntityAspect } from '../entity/entity-aspect.js';
+import { DataProperty } from '../metadata/entity-metadata.js';
+import { makeComplexArray, makePrimitiveArray, makeRelationArray } from '../entity/array.js';
+/**
+ * Change tracking for plain JavaScript objects.
+ *
+ * Each mapped property becomes an accessor **on the prototype** - defined once per type, not per
+ * instance - and the values live in a `_backingStore` object on the instance. A get reads the
+ * store; a set hands the property, the new value and an accessor for the old one to the entity's
+ * `_$interceptor`, which is where change tracking actually happens.
+ *
+ * That split is why this file is cheap and the interceptor is not: of the time spent setting a
+ * tracked property, about 96% is change tracking (validation alone is around 63%) and about 2% is
+ * the plumbing here. Optimise the interceptor, or turn off `validateOnPropertyChange`; there is
+ * very little to win in this file.
+ */
+export class ModelLibraryBackingStoreAdapter {
+    name;
+    constructor() {
+        this.name = "backingStore";
+    }
+    static register(config) {
+        config = config || globalConfig;
+        config.registerAdapter("modelLibrary", ModelLibraryBackingStoreAdapter);
+        return config.initializeAdapterInstance("modelLibrary", "backingStore", true);
+    }
+    initialize() {
+    }
+    /**
+     * The value of a property as it is stored, without creating anything. A collection navigation
+     * is created on first read (see makeCollectionNavPropDescription), so code that only wants to
+     * look at existing related entities asks with this instead of `getProperty` - otherwise
+     * attaching or deleting an entity would materialise every collection it has.
+     */
+    peekProperty(entity, propertyName) {
+        const bs = entity._backingStore;
+        return bs ? bs[propertyName] : undefined;
+    }
+    getTrackablePropertyNames(entity) {
+        let names = [];
+        for (let p in entity) {
+            if (p === "entityAspect" || p === "entityType")
+                continue;
+            if (p === "_$typeName" || p === "_backingStore")
+                continue;
+            if (typeof entity[p] !== "function") {
+                names.push(p);
+            }
+        }
+        return names;
+    }
+    // This method is called during Metadata initialization
+    initializeEntityPrototype(proto) {
+        proto.getProperty = function (propertyName) {
+            return this[propertyName];
+        };
+        proto.setProperty = function (propertyName, value) {
+            this[propertyName] = value;
+            // allow setProperty chaining.
+            return this;
+        };
+        movePropDefsToProto(proto);
+    }
+    // This method is called when an EntityAspect is first created - this will occur as part of the entityType.createEntity call.
+    // which can be called either directly or via standard query materialization
+    // entity is either an entity or a complexObject
+    startTracking(entity, proto) {
+        // Write through the backing store rather than the accessors: the interceptor would treat
+        // these initial values as changes to an entity that does not exist yet.
+        let bs = movePropsToBackingStore(entity);
+        // assign default values to the entity
+        let stype = EntityAspect.isEntity(entity) ? entity.entityType : entity.complexType;
+        forEachProperty(stype, function (prop) {
+            let propName = prop.name;
+            // Deliberately the stored value rather than (entity as any)[propName]: reading a collection
+            // navigation through its accessor would create the very array this method leaves lazy.
+            let val = bs[propName];
+            if (prop instanceof DataProperty) {
+                if (prop.isComplexProperty) {
+                    if (prop.isScalar) {
+                        val = prop.dataType._createInstanceCore(entity, prop);
+                    }
+                    else {
+                        val = makeComplexArray([], entity, prop);
+                    }
+                }
+                else if (!prop.isScalar) {
+                    val = makePrimitiveArray([], entity, prop);
+                }
+                else if (val === undefined) {
+                    val = prop.defaultValue;
+                }
+            }
+            else if (prop.isNavigationProperty) {
+                if (val !== undefined && val !== null) {
+                    throw new Error("Cannot assign a navigation property in an entity ctor.: " + propName);
+                }
+                if (prop.isScalar) {
+                    // TODO: change this to nullstob later.
+                    val = null;
+                }
+                else {
+                    // Left uncreated: the accessor builds the relation array on first read. An array plus
+                    // its arrayChanged event is ~390 bytes, and most collections on most entities are never
+                    // touched. See makeCollectionNavPropDescription.
+                    return;
+                }
+            }
+            else {
+                throw new Error("unknown property: " + propName);
+            }
+            if (prop.isSettable || prop.isNavigationProperty) {
+                bs[propName] = val;
+            }
+        });
+    }
+}
+// NOTE: this module deliberately does NOT register itself on import.
+// Registration is explicit - pass the adapter to configureBreeze, or call
+// SomeAdapter.register(). Importing a module should not mutate global state.
+// private methods
+/**
+ * Visits a type's data and navigation properties. `getProperties()` returns them concatenated
+ * into a fresh array, and this runs twice for every instance created, so it walks the two arrays
+ * instead. (A ComplexType has no navigation properties.)
+ */
+function forEachProperty(stype, fn) {
+    const dataProps = stype.dataProperties;
+    for (let i = 0; i < dataProps.length; i++)
+        fn(dataProps[i]);
+    const navProps = stype.navigationProperties;
+    if (navProps) {
+        for (let i = 0; i < navProps.length; i++)
+            fn(navProps[i]);
+    }
+}
+// This method is called during Metadata initialization to correctly "wrap" properties.
+function movePropDefsToProto(proto) {
+    let stype = (proto.entityType || proto.complexType);
+    let extra = stype._extra;
+    let alreadyWrapped = extra.alreadyWrappedProps || {};
+    forEachProperty(stype, function (prop) {
+        let propName = prop.name;
+        // we only want to wrap props that haven't already been wrapped
+        if (alreadyWrapped[propName])
+            return;
+        // If property is already defined on the prototype then wrap it in another propertyDescriptor.
+        // otherwise create a propDescriptor for it.
+        let descr;
+        if (propName in proto) {
+            descr = wrapPropDescription(proto, prop);
+        }
+        else {
+            descr = makePropDescription(proto, prop);
+        }
+        // descr will be null for a wrapped descr that is not configurable
+        if (descr != null) {
+            Object.defineProperty(proto, propName, descr);
+        }
+        alreadyWrapped[propName] = true;
+    });
+    extra.alreadyWrappedProps = alreadyWrapped;
+}
+/**
+ * Called once per instance, as it starts being tracked. A custom constructor may have assigned
+ * properties in its own body, which lands them on the instance and shadows the prototype
+ * accessor; those values are moved into the backing store by writing them back through it.
+ */
+function movePropsToBackingStore(instance) {
+    let bs = getBackingStore(instance);
+    let proto = Object.getPrototypeOf(instance);
+    let stype = (proto.entityType || proto.complexType);
+    forEachProperty(stype, function (prop) {
+        let propName = prop.name;
+        if (prop.isUnmapped) {
+            // insure that any unmapped properties that were added after entityType
+            // was first created are wrapped with a property descriptor.
+            if (!core.getPropertyDescriptor(proto, propName)) {
+                let descr = makePropDescription(proto, prop);
+                Object.defineProperty(proto, propName, descr);
+            }
+        }
+        if (!Object.prototype.hasOwnProperty.call(instance, propName))
+            return;
+        // pulls off the value, removes the instance property and then rewrites it via the accessor
+        let value = instance[propName];
+        delete instance[propName];
+        instance[propName] = value;
+    });
+    return bs;
+}
+function makePropDescription(proto, property) {
+    if (property.isNavigationProperty && !property.isScalar) {
+        return makeCollectionNavPropDescription(property);
+    }
+    let propName = property.name;
+    let descr = {
+        get: function () {
+            let bs = this._backingStore || getBackingStore(this);
+            return bs[propName];
+        },
+        set: function (value) {
+            let bs = this._backingStore || getBackingStore(this);
+            // A fresh accessor per set, because `(property, newValue, rawAccessorFn)` is the
+            // interceptor contract - MetadataStore.trackUnmappedType lets an application supply its
+            // own. It is about 2% of a set, so the contract is worth more than the allocation.
+            this._$interceptor(property, value, getAccessorFn(bs, propName));
+        },
+        enumerable: true,
+        configurable: true
+    };
+    descr.set.rawSet = function (value) {
+        let bs = this._backingStore || getBackingStore(this);
+        bs[propName] = value;
+    };
+    return descr;
+}
+/**
+ * A collection navigation - `order.orderDetails` - is an empty relation array until something
+ * reads it. Creating one costs about 0.5 microseconds and 390 bytes, and an entity that is never
+ * navigated never pays it. Reads after the first are an ordinary backing-store lookup.
+ *
+ * Assigning to a collection navigation throws in the interceptor either way ("Nonscalar
+ * navigation properties are readonly"), so the setter keeps the standard path.
+ */
+function makeCollectionNavPropDescription(property) {
+    const propName = property.name;
+    const descr = {
+        get: function () {
+            const bs = this._backingStore || getBackingStore(this);
+            let arr = bs[propName];
+            if (arr === undefined) {
+                arr = makeRelationArray([], this, property);
+                bs[propName] = arr;
+            }
+            return arr;
+        },
+        set: function (value) {
+            const bs = this._backingStore || getBackingStore(this);
+            this._$interceptor(property, value, getAccessorFn(bs, propName));
+        },
+        enumerable: true,
+        configurable: true
+    };
+    descr.set.rawSet = function (value) {
+        const bs = this._backingStore || getBackingStore(this);
+        bs[propName] = value;
+    };
+    return descr;
+}
+function getAccessorFn(bsArg, propName) {
+    const bs = bsArg;
+    return function () {
+        if (arguments.length === 0) {
+            return bs[propName];
+        }
+        else {
+            bs[propName] = arguments[0];
+            return undefined;
+        }
+    };
+}
+/**
+ * For a property that already has an accessor on the prototype - a custom constructor using
+ * get/set - keep that accessor and route writes through the interceptor first.
+ */
+function wrapPropDescription(proto, property) {
+    if (!Object.prototype.hasOwnProperty.call(proto, property.name)) {
+        let nextProto = Object.getPrototypeOf(proto);
+        return wrapPropDescription(nextProto, property);
+    }
+    let propDescr = Object.getOwnPropertyDescriptor(proto, property.name);
+    if (!propDescr)
+        return undefined;
+    // if not configurable; we can't touch it - so leave.
+    if (!propDescr.configurable)
+        return undefined;
+    // if a data descriptor - don't change it - this is basically a static property - i.e. defined on every instance of the type with the same value.
+    if (propDescr.value)
+        return undefined;
+    // if a read only property descriptor - no need to change it.
+    if (!propDescr.set)
+        return undefined;
+    const originalGet = propDescr.get;
+    const originalSet = propDescr.set;
+    const rawSet = originalSet.rawSet || originalSet;
+    let localAccessorFn = function (entity) {
+        return function () {
+            if (arguments.length === 0) {
+                return originalGet.call(entity);
+            }
+            else {
+                rawSet.call(entity, arguments[0]);
+                return undefined;
+            }
+        };
+    };
+    let newDescr = {
+        get: function () {
+            return originalGet.call(this);
+        },
+        set: function (value) {
+            this._$interceptor(property, value, localAccessorFn(this));
+        },
+        enumerable: propDescr.enumerable,
+        configurable: true
+    };
+    newDescr.set.rawSet = originalSet;
+    return newDescr;
+}
+function getBackingStore(instance) {
+    let bs = instance._backingStore;
+    if (!bs) {
+        bs = {};
+        instance._backingStore = bs;
+    }
+    return bs;
+}
+//# sourceMappingURL=adapter-model-library-backing-store.js.map

package/adapters/adapter-model-library-backing-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-model-library-backing-store.js","sourceRoot":"","sources":["../../src/adapters/adapter-model-library-backing-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { config as globalConfig, BreezeConfig } from '../config/config.js';\nimport { core } from '../core/core.js';\nimport type { ModelLibraryAdapter } from '../config/interface-registry.js';\nimport { EntityAspect } from '../entity/entity-aspect.js';\nimport type { Entity, StructuralObject } from '../entity/entity-aspect.js';\nimport { DataProperty, ComplexType, NavigationProperty } from '../metadata/entity-metadata.js';\nimport type { StructuralType, EntityProperty } from '../metadata/entity-metadata.js';\nimport { makeComplexArray, makePrimitiveArray, makeRelationArray } from '../entity/array.js';\n\n/**\n * Change tracking for plain JavaScript objects.\n *\n * Each mapped property becomes an accessor **on the prototype** - defined once per type, not per\n * instance - and the values live in a `_backingStore` object on the instance. A get reads the\n * store; a set hands the property, the new value and an accessor for the old one to the entity's\n * `_$interceptor`, which is where change tracking actually happens.\n *\n * That split is why this file is cheap and the interceptor is not: of the time spent setting a\n * tracked property, about 96% is change tracking (validation alone is around 63%) and about 2% is\n * the plumbing here. Optimise the interceptor, or turn off `validateOnPropertyChange`; there is\n * very little to win in this file.\n */\nexport class ModelLibraryBackingStoreAdapter implements ModelLibraryAdapter {\n  name: string;\n\n  constructor() {\n    this.name = \"backingStore\";\n  }\n\n  static register(config?: BreezeConfig) {\n    config = config || globalConfig;\n    config.registerAdapter(\"modelLibrary\", ModelLibraryBackingStoreAdapter);\n    return config.initializeAdapterInstance(\"modelLibrary\", \"backingStore\", true) as ModelLibraryBackingStoreAdapter;\n  }\n\n  initialize() {\n  }\n\n  /**\n   * The value of a property as it is stored, without creating anything. A collection navigation\n   * is created on first read (see makeCollectionNavPropDescription), so code that only wants to\n   * look at existing related entities asks with this instead of `getProperty` - otherwise\n   * attaching or deleting an entity would materialise every collection it has.\n   */\n  peekProperty(entity: StructuralObject, propertyName: string) {\n    const bs = (entity as any)._backingStore;\n    return bs ? bs[propertyName] : undefined;\n  }\n\n  getTrackablePropertyNames(entity: Entity) {\n    let names: string[] = [];\n    for (let p in entity) {\n      if (p === \"entityAspect\" || p === \"entityType\") continue;\n      if (p === \"_$typeName\" || p === \"_backingStore\") continue;\n      if (typeof (entity as Record<string, any>)[p] !== \"function\") {\n        names.push(p);\n      }\n    }\n    return names;\n  }\n\n  // This method is called during Metadata initialization\n  initializeEntityPrototype(proto: any) {\n\n    proto.getProperty = function (propertyName: string) {\n      return this[propertyName];\n    };\n\n    proto.setProperty = function (propertyName: string, value: any) {\n      this[propertyName] = value;\n      // allow setProperty chaining.\n      return this;\n    };\n\n    movePropDefsToProto(proto);\n  }\n\n  // This method is called when an EntityAspect is first created - this will occur as part of the entityType.createEntity call.\n  // which can be called either directly or via standard query materialization\n\n  // entity is either an entity or a complexObject\n  startTracking(entity: StructuralObject, proto: any) {\n    // Write through the backing store rather than the accessors: the interceptor would treat\n    // these initial values as changes to an entity that does not exist yet.\n    let bs = movePropsToBackingStore(entity);\n\n    // assign default values to the entity\n    let stype = EntityAspect.isEntity(entity) ? entity.entityType : entity.complexType;\n    forEachProperty(stype, function (prop) {\n\n      let propName = prop.name;\n      // Deliberately the stored value rather than (entity as any)[propName]: reading a collection\n      // navigation through its accessor would create the very array this method leaves lazy.\n      let val = bs[propName];\n\n      if (prop instanceof DataProperty) {\n        if (prop.isComplexProperty) {\n          if (prop.isScalar) {\n            val = (prop.dataType as ComplexType)._createInstanceCore(entity, prop);\n          } else {\n            val = makeComplexArray([], entity, prop);\n          }\n        } else if (!prop.isScalar) {\n          val = makePrimitiveArray([], entity, prop);\n        } else if (val === undefined) {\n          val = prop.defaultValue;\n        }\n\n      } else if (prop.isNavigationProperty) {\n        if (val !== undefined && val !== null) {\n          throw new Error(\"Cannot assign a navigation property in an entity ctor.: \" + propName);\n        }\n        if (prop.isScalar) {\n          // TODO: change this to nullstob later.\n          val = null;\n        } else {\n          // Left uncreated: the accessor builds the relation array on first read. An array plus\n          // its arrayChanged event is ~390 bytes, and most collections on most entities are never\n          // touched. See makeCollectionNavPropDescription.\n          return;\n        }\n      } else {\n        throw new Error(\"unknown property: \" + propName);\n      }\n      if ((prop as DataProperty).isSettable || prop.isNavigationProperty) {\n        bs[propName] = val;\n      }\n    });\n  }\n}\n\n// NOTE: this module deliberately does NOT register itself on import.\n// Registration is explicit - pass the adapter to configureBreeze, or call\n// SomeAdapter.register(). Importing a module should not mutate global state.\n\n\n// private methods\n\n/**\n * Visits a type's data and navigation properties. `getProperties()` returns them concatenated\n * into a fresh array, and this runs twice for every instance created, so it walks the two arrays\n * instead. (A ComplexType has no navigation properties.)\n */\nfunction forEachProperty(stype: StructuralType, fn: (prop: EntityProperty) => void) {\n  const dataProps = stype.dataProperties;\n  for (let i = 0; i < dataProps.length; i++) fn(dataProps[i]);\n  const navProps = (stype as any).navigationProperties as EntityProperty[] | undefined;\n  if (navProps) {\n    for (let i = 0; i < navProps.length; i++) fn(navProps[i]);\n  }\n}\n\n// This method is called during Metadata initialization to correctly \"wrap\" properties.\nfunction movePropDefsToProto(proto: any) {\n  let stype = (proto.entityType || proto.complexType) as StructuralType;\n  let extra = stype._extra;\n\n  let alreadyWrapped = extra.alreadyWrappedProps || {};\n\n  forEachProperty(stype, function (prop) {\n    let propName = prop.name;\n    // we only want to wrap props that haven't already been wrapped\n    if (alreadyWrapped[propName]) return;\n\n    // If property is already defined on the prototype then wrap it in another propertyDescriptor.\n    // otherwise create a propDescriptor for it.\n    let descr: any;\n    if (propName in proto) {\n      descr = wrapPropDescription(proto, prop);\n    } else {\n      descr = makePropDescription(proto, prop);\n    }\n    // descr will be null for a wrapped descr that is not configurable\n    if (descr != null) {\n      Object.defineProperty(proto, propName, descr);\n    }\n    alreadyWrapped[propName] = true;\n  });\n  extra.alreadyWrappedProps = alreadyWrapped;\n}\n\n/**\n * Called once per instance, as it starts being tracked. A custom constructor may have assigned\n * properties in its own body, which lands them on the instance and shadows the prototype\n * accessor; those values are moved into the backing store by writing them back through it.\n */\nfunction movePropsToBackingStore(instance: any) {\n\n  let bs = getBackingStore(instance);\n  let proto = Object.getPrototypeOf(instance);\n  let stype = (proto.entityType || proto.complexType) as StructuralType;\n  forEachProperty(stype, function (prop) {\n    let propName = prop.name;\n    if (prop.isUnmapped) {\n      // insure that any unmapped properties that were added after entityType\n      // was first created are wrapped with a property descriptor.\n      if (!core.getPropertyDescriptor(proto, propName)) {\n        let descr = makePropDescription(proto, prop);\n        Object.defineProperty(proto, propName, descr);\n      }\n    }\n    if (!Object.prototype.hasOwnProperty.call(instance, propName)) return;\n    // pulls off the value, removes the instance property and then rewrites it via the accessor\n    let value = instance[propName];\n    delete instance[propName];\n    instance[propName] = value;\n  });\n  return bs;\n}\n\nfunction makePropDescription(proto: any, property: EntityProperty) {\n  if (property.isNavigationProperty && !property.isScalar) {\n    return makeCollectionNavPropDescription(property as NavigationProperty);\n  }\n  let propName = property.name;\n  let descr = {\n    get: function () {\n      let bs = this._backingStore || getBackingStore(this);\n      return bs[propName];\n    },\n    set: function (value: any) {\n      let bs = this._backingStore || getBackingStore(this);\n      // A fresh accessor per set, because `(property, newValue, rawAccessorFn)` is the\n      // interceptor contract - MetadataStore.trackUnmappedType lets an application supply its\n      // own. It is about 2% of a set, so the contract is worth more than the allocation.\n      this._$interceptor(property, value, getAccessorFn(bs, propName));\n    },\n    enumerable: true,\n    configurable: true\n  };\n\n  (descr.set as any).rawSet = function (value: any) {\n    let bs = this._backingStore || getBackingStore(this);\n    bs[propName] = value;\n  };\n  return descr;\n\n}\n\n/**\n * A collection navigation - `order.orderDetails` - is an empty relation array until something\n * reads it. Creating one costs about 0.5 microseconds and 390 bytes, and an entity that is never\n * navigated never pays it. Reads after the first are an ordinary backing-store lookup.\n *\n * Assigning to a collection navigation throws in the interceptor either way (\"Nonscalar\n * navigation properties are readonly\"), so the setter keeps the standard path.\n */\nfunction makeCollectionNavPropDescription(property: NavigationProperty) {\n  const propName = property.name;\n  const descr = {\n    get: function () {\n      const bs = this._backingStore || getBackingStore(this);\n      let arr = bs[propName];\n      if (arr === undefined) {\n        arr = makeRelationArray([], this as Entity, property);\n        bs[propName] = arr;\n      }\n      return arr;\n    },\n    set: function (value: any) {\n      const bs = this._backingStore || getBackingStore(this);\n      this._$interceptor(property, value, getAccessorFn(bs, propName));\n    },\n    enumerable: true,\n    configurable: true\n  };\n\n  (descr.set as any).rawSet = function (value: any) {\n    const bs = this._backingStore || getBackingStore(this);\n    bs[propName] = value;\n  };\n  return descr;\n}\n\nfunction getAccessorFn(bsArg: {}, propName: string): any {\n  const bs = bsArg as Record<string, any>;\n  return function () {\n    if (arguments.length === 0) {\n      return bs[propName];\n    } else {\n      bs[propName] = arguments[0];\n      return undefined;\n    }\n  };\n}\n\n/**\n * For a property that already has an accessor on the prototype - a custom constructor using\n * get/set - keep that accessor and route writes through the interceptor first.\n */\nfunction wrapPropDescription(proto: any, property: EntityProperty): any {\n  if (!Object.prototype.hasOwnProperty.call(proto, property.name)) {\n    let nextProto = Object.getPrototypeOf(proto);\n    return wrapPropDescription(nextProto, property);\n  }\n\n  let propDescr = Object.getOwnPropertyDescriptor(proto, property.name);\n  if (!propDescr) return undefined;\n  // if not configurable; we can't touch it - so leave.\n  if (!propDescr.configurable) return undefined;\n  // if a data descriptor - don't change it - this is basically a static property - i.e. defined on every instance of the type with the same value.\n  if (propDescr.value) return undefined;\n  // if a read only property descriptor - no need to change it.\n  if (!propDescr.set) return undefined;\n\n  const originalGet = propDescr.get!;\n  const originalSet = propDescr.set;\n  const rawSet = (originalSet as any).rawSet || originalSet;\n\n  let localAccessorFn = function (entity: any) {\n    return function () {\n      if (arguments.length === 0) {\n        return originalGet.call(entity);\n      } else {\n        rawSet.call(entity, arguments[0]);\n        return undefined;\n      }\n    };\n  };\n\n  let newDescr = {\n    get: function () {\n      return originalGet.call(this);\n    },\n    set: function (value: any) {\n      this._$interceptor(property, value, localAccessorFn(this));\n    },\n    enumerable: propDescr.enumerable,\n    configurable: true\n  };\n  (newDescr.set as any).rawSet = originalSet;\n  return newDescr;\n}\n\n\nfunction getBackingStore(instance: any) {\n  let bs = instance._backingStore;\n  if (!bs) {\n    bs = {};\n    instance._backingStore = bs;\n  }\n  return bs;\n}\n"]}

package/adapters/adapter-uri-builder-json.d.ts

@@ -0,0 +1,11 @@
+import { BreezeConfig } from '../config/config.js';
+import type { UriBuilderAdapter } from '../config/interface-registry.js';
+import { EntityQuery } from '../query/entity-query.js';
+import { MetadataStore } from '../metadata/entity-metadata.js';
+export declare class UriBuilderJsonAdapter implements UriBuilderAdapter {
+    name: string;
+    constructor();
+    static register(config?: BreezeConfig): UriBuilderJsonAdapter;
+    initialize(): void;
+    buildUri(entityQuery: EntityQuery, metadataStore: MetadataStore): string;
+}

package/adapters/adapter-uri-builder-json.js

@@ -0,0 +1,40 @@
+import { config as globalConfig } from '../config/config.js';
+import { EntityType } from '../metadata/entity-metadata.js';
+import { appendQueryStringParameter } from './adapter-core.js';
+export class UriBuilderJsonAdapter {
+    name;
+    constructor() {
+        this.name = "json";
+    }
+    static register(config) {
+        config = config || globalConfig;
+        config.registerAdapter("uriBuilder", UriBuilderJsonAdapter);
+        return config.initializeAdapterInstance("uriBuilder", "json", true);
+    }
+    initialize() { }
+    buildUri(entityQuery, metadataStore) {
+        // force entityType validation;
+        let entityType = entityQuery._getFromEntityType(metadataStore, false);
+        if (!entityType)
+            entityType = new EntityType(metadataStore);
+        let json = entityQuery.toJSONExt({ entityType: entityType, toNameOnServer: true });
+        json.from = undefined;
+        json.queryOptions = undefined;
+        // withParameters values are sent once, as ordinary query-string arguments (the data
+        // service adapter passes them as request params). That is where the server's model
+        // binding reads them; a copy inside the JSON was never read.
+        json.parameters = undefined;
+        let jsonString = JSON.stringify(json);
+        if (jsonString.length > 2) {
+            let urlBody = encodeURIComponent(jsonString);
+            return appendQueryStringParameter(entityQuery.resourceName, urlBody);
+        }
+        else {
+            return entityQuery.resourceName;
+        }
+    }
+}
+// NOTE: this module deliberately does NOT register itself on import.
+// Registration is explicit - pass the adapter to configureBreeze, or call
+// SomeAdapter.register(). Importing a module should not mutate global state.
+//# sourceMappingURL=adapter-uri-builder-json.js.map

package/adapters/adapter-uri-builder-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-uri-builder-json.js","sourceRoot":"","sources":["../../src/adapters/adapter-uri-builder-json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,YAAY,EAAgB,MAAM,qBAAqB,CAAC;AAG3E,OAAO,EAAiB,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,OAAO,qBAAqB;IAChC,IAAI,CAAS;IAEb;QACE,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,MAAqB;QACnC,MAAM,GAAG,MAAM,IAAI,YAAY,CAAC;QAChC,MAAM,CAAC,eAAe,CAAC,YAAY,EAAE,qBAAqB,CAAC,CAAC;QAC5D,OAAO,MAAM,CAAC,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAA0B,CAAC;IAC/F,CAAC;IAED,UAAU,KAAI,CAAC;IAEf,QAAQ,CAAC,WAAwB,EAAE,aAA4B;QAC7D,+BAA+B;QAC/B,IAAI,UAAU,GAAG,WAAW,CAAC,kBAAkB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QACtE,IAAI,CAAC,UAAU;YAAE,UAAU,GAAG,IAAI,UAAU,CAAC,aAAa,CAAC,CAAC;QAC5D,IAAI,IAAI,GAAG,WAAW,CAAC,SAAS,CAAE,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,IAAI,EAAC,CAAQ,CAAC;QAC1F,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAC9B,oFAAoF;QACpF,mFAAmF;QACnF,6DAA6D;QAC7D,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAE5B,IAAI,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,IAAI,OAAO,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;YAC7C,OAAO,0BAA0B,CAAC,WAAW,CAAC,YAAa,EAAE,OAAO,CAAC,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,OAAO,WAAW,CAAC,YAAa,CAAC;QACnC,CAAC;IAEH,CAAC;CAEF;AAED,qEAAqE;AACrE,0EAA0E;AAC1E,6EAA6E","sourcesContent":["import { config as globalConfig, BreezeConfig } from '../config/config.js';\r\nimport type { UriBuilderAdapter } from '../config/interface-registry.js';\r\nimport { EntityQuery } from '../query/entity-query.js';\r\nimport { MetadataStore, EntityType } from '../metadata/entity-metadata.js';\r\nimport { appendQueryStringParameter } from './adapter-core.js';\r\n\r\nexport class UriBuilderJsonAdapter implements UriBuilderAdapter {\r\n  name: string;\r\n\r\n  constructor() {\r\n    this.name = \"json\";\r\n  }\r\n\r\n  static register(config?: BreezeConfig) {\r\n    config = config || globalConfig;\r\n    config.registerAdapter(\"uriBuilder\", UriBuilderJsonAdapter);\r\n    return config.initializeAdapterInstance(\"uriBuilder\", \"json\", true) as UriBuilderJsonAdapter;\r\n  }\r\n\r\n  initialize() {}\r\n\r\n  buildUri(entityQuery: EntityQuery, metadataStore: MetadataStore) {\r\n    // force entityType validation;\r\n    let entityType = entityQuery._getFromEntityType(metadataStore, false);\r\n    if (!entityType) entityType = new EntityType(metadataStore);\r\n    let json = entityQuery.toJSONExt( { entityType: entityType, toNameOnServer: true}) as any;\r\n    json.from = undefined;\r\n    json.queryOptions = undefined;\r\n    // withParameters values are sent once, as ordinary query-string arguments (the data\r\n    // service adapter passes them as request params). That is where the server's model\r\n    // binding reads them; a copy inside the JSON was never read.\r\n    json.parameters = undefined;\r\n\r\n    let jsonString = JSON.stringify(json);\r\n    if (jsonString.length > 2) {\r\n      let urlBody = encodeURIComponent(jsonString);\r\n      return appendQueryStringParameter(entityQuery.resourceName!, urlBody);\r\n    } else {\r\n      return entityQuery.resourceName!;\r\n    }\r\n\r\n  }\r\n\r\n}\r\n\r\n// NOTE: this module deliberately does NOT register itself on import.\r\n// Registration is explicit - pass the adapter to configureBreeze, or call\r\n// SomeAdapter.register(). Importing a module should not mutate global state.\r\n\r\n\r\n\r\n\r\n"]}

package/adapters/http.d.ts

@@ -0,0 +1,52 @@
+import { BreezeConfig } from '../config/config.js';
+import type { AjaxAdapter, AjaxConfig, AjaxRequestInterceptor, BreezeFetch } from '../config/interface-registry.js';
+import type { HttpResponse } from '../manager/entity-manager.js';
+/** The transport used when none is supplied. Wrapped so that `fetch` keeps its receiver,
+    which some environments require. */
+export declare const defaultFetch: BreezeFetch;
+/** Breeze's description of one request, without the callbacks. */
+export type HttpRequestConfig = Omit<AjaxConfig, 'success' | 'error'>;
+/** The outcome of one request. Failures are values, not rejections. */
+export interface HttpOutcome {
+    succeeded: boolean;
+    httpResponse: HttpResponse;
+}
+/** Turns Breeze's description of a request into the arguments for a fetch call. */
+export declare function toFetchArgs(request: HttpRequestConfig): {
+    url: string;
+    init: RequestInit;
+};
+/**
+ * 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 declare function sendFetch(fetchFn: BreezeFetch, url: string, init: RequestInit, request: HttpRequestConfig): Promise<HttpOutcome>;
+/**
+ * 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 declare class AjaxFetchAdapter implements AjaxAdapter {
+    static adapterName: string;
+    name: string;
+    defaultSettings: {
+        headers?: {
+            [name: string]: string;
+        };
+    };
+    requestInterceptor?: AjaxRequestInterceptor;
+    /** The function used to make the request. Defaults to `globalThis.fetch`. */
+    fetchFn: BreezeFetch;
+    constructor(fetchFn?: BreezeFetch);
+    /**
+     * @param breezeConfig - defaults to the global breeze config
+     * @param fetchFn - the transport this adapter uses. Defaults to `globalThis.fetch`.
+     */
+    static register(breezeConfig?: BreezeConfig, fetchFn?: BreezeFetch): AjaxFetchAdapter;
+    initialize(): void;
+    ajax(ajaxConfig: AjaxConfig): void;
+}