breeze-client 2.1.2 → 2.1.3-mjs

package/esm2020/src/key-generator.mjs

@@ -0,0 +1,108 @@
+import { EntityKey } from './entity-key';
+import { config } from './config';
+/*
+  @class KeyGenerator
+  */
+export class KeyGenerator {
+    constructor() {
+        // key is dataProperty.name + || + entityType.name, value is propEntry
+        // propEntry = { entityType, propertyName, keyMap }
+        // keyMap has key of the actual value ( as a string) and a value of null or the real id.
+        this._tempIdMap = {};
+    }
+    /*
+    Returns a unique 'temporary' id for the specified [[EntityType]].
+    Uniqueness is defined for this purpose as being unique within each instance of a KeyGenerator. This is sufficient
+    because each EntityManager will have its own instance of a KeyGenerator and any entities imported into
+    the EntityManager with temporary keys will have them regenerated and remapped on import.
+  
+    The return value of this method must be of the correct type as determined by the keyProperties of the
+    specified EntityType
+    @example
+        // Assume em1 is a preexisting EntityManager
+        let custType = em1.metadataStore.getEntityType("Customer");
+        let cust1 = custType.createEntity();
+        // next line both sets cust1's 'CustomerId' property but also returns the value
+        let cid1 = em1.generateTempKeyValue(cust1);
+        em1.saveChanges().then( function( data) {
+          let sameCust1 = data.results[0];
+          // cust1 === sameCust1;
+          // but cust1.getProperty("CustomerId") != cid1
+          // because the server will have generated a new id
+          // and the client will have been updated with this
+          // new id.
+        });
+    @method generateTempKeyValue
+    @param entityType {EntityType}
+    */
+    generateTempKeyValue(entityType, valueIfAvail) {
+        let keyProps = entityType.keyProperties;
+        if (keyProps.length > 1) {
+            throw new Error("Ids can not be autogenerated for entities with multipart keys");
+        }
+        let keyProp = keyProps[0];
+        let propEntry = this._getPropEntry(keyProp, true);
+        let nextId;
+        if (valueIfAvail != null) {
+            if (!propEntry.keyMap[valueIfAvail.toString()]) {
+                nextId = valueIfAvail;
+            }
+        }
+        if (nextId === undefined) {
+            let dataType = keyProp.dataType;
+            let getNextFn = dataType.getNext;
+            if (getNextFn) {
+                nextId = getNextFn(this);
+                // need to watch out for collision with previously imported ids that might also get generated.
+                while (propEntry.keyMap[nextId.toString()] != null) {
+                    nextId = getNextFn(this);
+                }
+            }
+            else {
+                throw new Error("Cannot use a property with a dataType of: " + dataType.toString() + " for id generation");
+            }
+        }
+        propEntry.keyMap[nextId.toString()] = true;
+        return nextId;
+    }
+    getTempKeys() {
+        let results = [];
+        //noinspection JSHint
+        for (let key in this._tempIdMap) {
+            let propEntry = this._tempIdMap[key];
+            let entityType = propEntry.entityType;
+            // let propName = propEntry.propertyName;
+            //noinspection JSHint
+            for (let keyValue in propEntry.keyMap) {
+                results.push(new EntityKey(entityType, [keyValue]));
+            }
+        }
+        return results;
+    }
+    // proto methods below are not part of the KeyGenerator interface.
+    isTempKey(entityKey) {
+        let keyProps = entityKey.entityType.keyProperties;
+        if (keyProps.length > 1)
+            return false;
+        let keyProp = keyProps[0];
+        let propEntry = this._getPropEntry(keyProp);
+        if (!propEntry) {
+            return false;
+        }
+        return (propEntry.keyMap[entityKey.values[0].toString()] !== undefined);
+    }
+    /** @hidden @internal */
+    _getPropEntry(keyProp, createIfMissing = false) {
+        let key = keyProp.name + ".." + keyProp.parentType.name;
+        let propEntry = this._tempIdMap[key];
+        if (!propEntry) {
+            if (createIfMissing) {
+                propEntry = { entityType: keyProp.parentType, propertyName: keyProp.name, keyMap: {} };
+                this._tempIdMap[key] = propEntry;
+            }
+        }
+        return propEntry;
+    }
+}
+config.registerType(KeyGenerator, "KeyGenerator");
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoia2V5LWdlbmVyYXRvci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9rZXktZ2VuZXJhdG9yLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFDekMsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLFVBQVUsQ0FBQztBQVlsQzs7SUFFSTtBQUNKLE1BQU0sT0FBTyxZQUFZO0lBS3ZCO1FBQ0Usc0VBQXNFO1FBQ3RFLG1EQUFtRDtRQUNuRCx3RkFBd0Y7UUFDeEYsSUFBSSxDQUFDLFVBQVUsR0FBRyxFQUFFLENBQUM7SUFDdkIsQ0FBQztJQUdEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7TUF3QkU7SUFDRixvQkFBb0IsQ0FBQyxVQUFzQixFQUFFLFlBQXNCO1FBQ2pFLElBQUksUUFBUSxHQUFHLFVBQVUsQ0FBQyxhQUFhLENBQUM7UUFDeEMsSUFBSSxRQUFRLENBQUMsTUFBTSxHQUFHLENBQUMsRUFBRTtZQUN2QixNQUFNLElBQUksS0FBSyxDQUFDLCtEQUErRCxDQUFDLENBQUM7U0FDbEY7UUFDRCxJQUFJLE9BQU8sR0FBRyxRQUFRLENBQUMsQ0FBQyxDQUFDLENBQUM7UUFDMUIsSUFBSSxTQUFTLEdBQUcsSUFBSSxDQUFDLGFBQWEsQ0FBQyxPQUFPLEVBQUUsSUFBSSxDQUFDLENBQUM7UUFDbEQsSUFBSSxNQUFXLENBQUM7UUFDaEIsSUFBSSxZQUFZLElBQUksSUFBSSxFQUFFO1lBQ3hCLElBQUksQ0FBQyxTQUFTLENBQUMsTUFBTSxDQUFDLFlBQVksQ0FBQyxRQUFRLEVBQUUsQ0FBQyxFQUFFO2dCQUM5QyxNQUFNLEdBQUcsWUFBWSxDQUFDO2FBQ3ZCO1NBQ0Y7UUFFRCxJQUFJLE1BQU0sS0FBSyxTQUFTLEVBQUU7WUFDeEIsSUFBSSxRQUFRLEdBQUcsT0FBTyxDQUFDLFFBQVEsQ0FBQztZQUNoQyxJQUFJLFNBQVMsR0FBSSxRQUFnQixDQUFDLE9BQU8sQ0FBQztZQUMxQyxJQUFJLFNBQVMsRUFBRTtnQkFDYixNQUFNLEdBQUcsU0FBUyxDQUFDLElBQUksQ0FBQyxDQUFDO2dCQUN6Qiw4RkFBOEY7Z0JBQzlGLE9BQU8sU0FBUyxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsUUFBUSxFQUFFLENBQUMsSUFBSSxJQUFJLEVBQUU7b0JBQ2xELE1BQU0sR0FBRyxTQUFTLENBQUMsSUFBSSxDQUFDLENBQUM7aUJBQzFCO2FBQ0Y7aUJBQU07Z0JBQ0wsTUFBTSxJQUFJLEtBQUssQ0FBQyw0Q0FBNEMsR0FBRyxRQUFRLENBQUMsUUFBUSxFQUFFLEdBQUcsb0JBQW9CLENBQUMsQ0FBQzthQUM1RztTQUNGO1FBRUQsU0FBUyxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsUUFBUSxFQUFFLENBQUMsR0FBRyxJQUFJLENBQUM7UUFDM0MsT0FBTyxNQUFNLENBQUM7SUFDaEIsQ0FBQztJQUVELFdBQVc7UUFDVCxJQUFJLE9BQU8sR0FBZ0IsRUFBRSxDQUFDO1FBQzlCLHFCQUFxQjtRQUNyQixLQUFLLElBQUksR0FBRyxJQUFJLElBQUksQ0FBQyxVQUFVLEVBQUU7WUFDL0IsSUFBSSxTQUFTLEdBQUcsSUFBSSxDQUFDLFVBQVUsQ0FBQyxHQUFHLENBQUMsQ0FBQztZQUNyQyxJQUFJLFVBQVUsR0FBRyxTQUFTLENBQUMsVUFBVSxDQUFDO1lBQ3RDLHlDQUF5QztZQUN6QyxxQkFBcUI7WUFDckIsS0FBSyxJQUFJLFFBQVEsSUFBSSxTQUFTLENBQUMsTUFBTSxFQUFFO2dCQUNyQyxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksU0FBUyxDQUFDLFVBQVUsRUFBRSxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsQ0FBQzthQUNyRDtTQUNGO1FBQ0QsT0FBTyxPQUFPLENBQUM7SUFDakIsQ0FBQztJQUdELGtFQUFrRTtJQUVsRSxTQUFTLENBQUMsU0FBb0I7UUFDNUIsSUFBSSxRQUFRLEdBQUcsU0FBUyxDQUFDLFVBQVUsQ0FBQyxhQUFhLENBQUM7UUFDbEQsSUFBSSxRQUFRLENBQUMsTUFBTSxHQUFHLENBQUM7WUFBRSxPQUFPLEtBQUssQ0FBQztRQUN0QyxJQUFJLE9BQU8sR0FBRyxRQUFRLENBQUMsQ0FBQyxDQUFDLENBQUM7UUFDMUIsSUFBSSxTQUFTLEdBQUcsSUFBSSxDQUFDLGFBQWEsQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUM1QyxJQUFJLENBQUMsU0FBUyxFQUFFO1lBQ2QsT0FBTyxLQUFLLENBQUM7U0FDZDtRQUNELE9BQU8sQ0FBQyxTQUFTLENBQUMsTUFBTSxDQUFDLFNBQVMsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLENBQUMsUUFBUSxFQUFFLENBQUMsS0FBSyxTQUFTLENBQUMsQ0FBQztJQUMxRSxDQUFDO0lBRUQsd0JBQXdCO0lBQ2hCLGFBQWEsQ0FBQyxPQUFxQixFQUFFLGVBQWUsR0FBRyxLQUFLO1FBQ2xFLElBQUksR0FBRyxHQUFHLE9BQU8sQ0FBQyxJQUFJLEdBQUcsSUFBSSxHQUFHLE9BQU8sQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDO1FBQ3hELElBQUksU0FBUyxHQUFHLElBQUksQ0FBQyxVQUFVLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDckMsSUFBSSxDQUFDLFNBQVMsRUFBRTtZQUNkLElBQUksZUFBZSxFQUFFO2dCQUNuQixTQUFTLEdBQUcsRUFBRSxVQUFVLEVBQUUsT0FBTyxDQUFDLFVBQXdCLEVBQUUsWUFBWSxFQUFFLE9BQU8sQ0FBQyxJQUFJLEVBQUUsTUFBTSxFQUFFLEVBQUUsRUFBRSxDQUFDO2dCQUNyRyxJQUFJLENBQUMsVUFBVSxDQUFDLEdBQUcsQ0FBQyxHQUFHLFNBQVMsQ0FBQzthQUNsQztTQUNGO1FBQ0QsT0FBTyxTQUFTLENBQUM7SUFDbkIsQ0FBQztDQUVGO0FBRUQsTUFBTSxDQUFDLFlBQVksQ0FBQyxZQUFZLEVBQUUsY0FBYyxDQUFDLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBFbnRpdHlUeXBlLCBEYXRhUHJvcGVydHkgfSBmcm9tICcuL2VudGl0eS1tZXRhZGF0YSc7XHJcbmltcG9ydCB7IEVudGl0eUtleSB9IGZyb20gJy4vZW50aXR5LWtleSc7XHJcbmltcG9ydCB7IGNvbmZpZyB9IGZyb20gJy4vY29uZmlnJztcclxuXHJcbmludGVyZmFjZSBJUHJvcEVudHJ5IHtcclxuICBlbnRpdHlUeXBlOiBFbnRpdHlUeXBlO1xyXG4gIHByb3BlcnR5TmFtZTogc3RyaW5nO1xyXG4gIGtleU1hcDogT2JqZWN0O1xyXG59XHJcblxyXG5pbnRlcmZhY2UgSVRlbXBJZE1hcCB7XHJcbiAgW2luZGV4OiBzdHJpbmddOiBJUHJvcEVudHJ5O1xyXG59XHJcblxyXG4vKlxyXG4gIEBjbGFzcyBLZXlHZW5lcmF0b3JcclxuICAqL1xyXG5leHBvcnQgY2xhc3MgS2V5R2VuZXJhdG9yIHtcclxuICAvKiogQGhpZGRlbiBAaW50ZXJuYWwgKi9cclxuICBwcml2YXRlIF90ZW1wSWRNYXA6IElUZW1wSWRNYXA7XHJcblxyXG5cclxuICBjb25zdHJ1Y3RvcigpIHtcclxuICAgIC8vIGtleSBpcyBkYXRhUHJvcGVydHkubmFtZSArIHx8ICsgZW50aXR5VHlwZS5uYW1lLCB2YWx1ZSBpcyBwcm9wRW50cnlcclxuICAgIC8vIHByb3BFbnRyeSA9IHsgZW50aXR5VHlwZSwgcHJvcGVydHlOYW1lLCBrZXlNYXAgfVxyXG4gICAgLy8ga2V5TWFwIGhhcyBrZXkgb2YgdGhlIGFjdHVhbCB2YWx1ZSAoIGFzIGEgc3RyaW5nKSBhbmQgYSB2YWx1ZSBvZiBudWxsIG9yIHRoZSByZWFsIGlkLlxyXG4gICAgdGhpcy5fdGVtcElkTWFwID0ge307XHJcbiAgfVxyXG5cclxuXHJcbiAgLypcclxuICBSZXR1cm5zIGEgdW5pcXVlICd0ZW1wb3JhcnknIGlkIGZvciB0aGUgc3BlY2lmaWVkIFtbRW50aXR5VHlwZV1dLlxyXG4gIFVuaXF1ZW5lc3MgaXMgZGVmaW5lZCBmb3IgdGhpcyBwdXJwb3NlIGFzIGJlaW5nIHVuaXF1ZSB3aXRoaW4gZWFjaCBpbnN0YW5jZSBvZiBhIEtleUdlbmVyYXRvci4gVGhpcyBpcyBzdWZmaWNpZW50XHJcbiAgYmVjYXVzZSBlYWNoIEVudGl0eU1hbmFnZXIgd2lsbCBoYXZlIGl0cyBvd24gaW5zdGFuY2Ugb2YgYSBLZXlHZW5lcmF0b3IgYW5kIGFueSBlbnRpdGllcyBpbXBvcnRlZCBpbnRvXHJcbiAgdGhlIEVudGl0eU1hbmFnZXIgd2l0aCB0ZW1wb3Jhcnkga2V5cyB3aWxsIGhhdmUgdGhlbSByZWdlbmVyYXRlZCBhbmQgcmVtYXBwZWQgb24gaW1wb3J0LlxyXG5cclxuICBUaGUgcmV0dXJuIHZhbHVlIG9mIHRoaXMgbWV0aG9kIG11c3QgYmUgb2YgdGhlIGNvcnJlY3QgdHlwZSBhcyBkZXRlcm1pbmVkIGJ5IHRoZSBrZXlQcm9wZXJ0aWVzIG9mIHRoZVxyXG4gIHNwZWNpZmllZCBFbnRpdHlUeXBlXHJcbiAgQGV4YW1wbGVcclxuICAgICAgLy8gQXNzdW1lIGVtMSBpcyBhIHByZWV4aXN0aW5nIEVudGl0eU1hbmFnZXJcclxuICAgICAgbGV0IGN1c3RUeXBlID0gZW0xLm1ldGFkYXRhU3RvcmUuZ2V0RW50aXR5VHlwZShcIkN1c3RvbWVyXCIpO1xyXG4gICAgICBsZXQgY3VzdDEgPSBjdXN0VHlwZS5jcmVhdGVFbnRpdHkoKTtcclxuICAgICAgLy8gbmV4dCBsaW5lIGJvdGggc2V0cyBjdXN0MSdzICdDdXN0b21lcklkJyBwcm9wZXJ0eSBidXQgYWxzbyByZXR1cm5zIHRoZSB2YWx1ZVxyXG4gICAgICBsZXQgY2lkMSA9IGVtMS5nZW5lcmF0ZVRlbXBLZXlWYWx1ZShjdXN0MSk7XHJcbiAgICAgIGVtMS5zYXZlQ2hhbmdlcygpLnRoZW4oIGZ1bmN0aW9uKCBkYXRhKSB7XHJcbiAgICAgICAgbGV0IHNhbWVDdXN0MSA9IGRhdGEucmVzdWx0c1swXTtcclxuICAgICAgICAvLyBjdXN0MSA9PT0gc2FtZUN1c3QxO1xyXG4gICAgICAgIC8vIGJ1dCBjdXN0MS5nZXRQcm9wZXJ0eShcIkN1c3RvbWVySWRcIikgIT0gY2lkMVxyXG4gICAgICAgIC8vIGJlY2F1c2UgdGhlIHNlcnZlciB3aWxsIGhhdmUgZ2VuZXJhdGVkIGEgbmV3IGlkXHJcbiAgICAgICAgLy8gYW5kIHRoZSBjbGllbnQgd2lsbCBoYXZlIGJlZW4gdXBkYXRlZCB3aXRoIHRoaXNcclxuICAgICAgICAvLyBuZXcgaWQuXHJcbiAgICAgIH0pO1xyXG4gIEBtZXRob2QgZ2VuZXJhdGVUZW1wS2V5VmFsdWVcclxuICBAcGFyYW0gZW50aXR5VHlwZSB7RW50aXR5VHlwZX1cclxuICAqL1xyXG4gIGdlbmVyYXRlVGVtcEtleVZhbHVlKGVudGl0eVR5cGU6IEVudGl0eVR5cGUsIHZhbHVlSWZBdmFpbD86IGJvb2xlYW4pIHtcclxuICAgIGxldCBrZXlQcm9wcyA9IGVudGl0eVR5cGUua2V5UHJvcGVydGllcztcclxuICAgIGlmIChrZXlQcm9wcy5sZW5ndGggPiAxKSB7XHJcbiAgICAgIHRocm93IG5ldyBFcnJvcihcIklkcyBjYW4gbm90IGJlIGF1dG9nZW5lcmF0ZWQgZm9yIGVudGl0aWVzIHdpdGggbXVsdGlwYXJ0IGtleXNcIik7XHJcbiAgICB9XHJcbiAgICBsZXQga2V5UHJvcCA9IGtleVByb3BzWzBdO1xyXG4gICAgbGV0IHByb3BFbnRyeSA9IHRoaXMuX2dldFByb3BFbnRyeShrZXlQcm9wLCB0cnVlKTtcclxuICAgIGxldCBuZXh0SWQ6IGFueTtcclxuICAgIGlmICh2YWx1ZUlmQXZhaWwgIT0gbnVsbCkge1xyXG4gICAgICBpZiAoIXByb3BFbnRyeS5rZXlNYXBbdmFsdWVJZkF2YWlsLnRvU3RyaW5nKCldKSB7XHJcbiAgICAgICAgbmV4dElkID0gdmFsdWVJZkF2YWlsO1xyXG4gICAgICB9XHJcbiAgICB9XHJcblxyXG4gICAgaWYgKG5leHRJZCA9PT0gdW5kZWZpbmVkKSB7XHJcbiAgICAgIGxldCBkYXRhVHlwZSA9IGtleVByb3AuZGF0YVR5cGU7XHJcbiAgICAgIGxldCBnZXROZXh0Rm4gPSAoZGF0YVR5cGUgYXMgYW55KS5nZXROZXh0O1xyXG4gICAgICBpZiAoZ2V0TmV4dEZuKSB7XHJcbiAgICAgICAgbmV4dElkID0gZ2V0TmV4dEZuKHRoaXMpO1xyXG4gICAgICAgIC8vIG5lZWQgdG8gd2F0Y2ggb3V0IGZvciBjb2xsaXNpb24gd2l0aCBwcmV2aW91c2x5IGltcG9ydGVkIGlkcyB0aGF0IG1pZ2h0IGFsc28gZ2V0IGdlbmVyYXRlZC5cclxuICAgICAgICB3aGlsZSAocHJvcEVudHJ5LmtleU1hcFtuZXh0SWQudG9TdHJpbmcoKV0gIT0gbnVsbCkge1xyXG4gICAgICAgICAgbmV4dElkID0gZ2V0TmV4dEZuKHRoaXMpO1xyXG4gICAgICAgIH1cclxuICAgICAgfSBlbHNlIHtcclxuICAgICAgICB0aHJvdyBuZXcgRXJyb3IoXCJDYW5ub3QgdXNlIGEgcHJvcGVydHkgd2l0aCBhIGRhdGFUeXBlIG9mOiBcIiArIGRhdGFUeXBlLnRvU3RyaW5nKCkgKyBcIiBmb3IgaWQgZ2VuZXJhdGlvblwiKTtcclxuICAgICAgfVxyXG4gICAgfVxyXG5cclxuICAgIHByb3BFbnRyeS5rZXlNYXBbbmV4dElkLnRvU3RyaW5nKCldID0gdHJ1ZTtcclxuICAgIHJldHVybiBuZXh0SWQ7XHJcbiAgfVxyXG5cclxuICBnZXRUZW1wS2V5cygpIHtcclxuICAgIGxldCByZXN1bHRzOiBFbnRpdHlLZXlbXSA9IFtdO1xyXG4gICAgLy9ub2luc3BlY3Rpb24gSlNIaW50XHJcbiAgICBmb3IgKGxldCBrZXkgaW4gdGhpcy5fdGVtcElkTWFwKSB7XHJcbiAgICAgIGxldCBwcm9wRW50cnkgPSB0aGlzLl90ZW1wSWRNYXBba2V5XTtcclxuICAgICAgbGV0IGVudGl0eVR5cGUgPSBwcm9wRW50cnkuZW50aXR5VHlwZTtcclxuICAgICAgLy8gbGV0IHByb3BOYW1lID0gcHJvcEVudHJ5LnByb3BlcnR5TmFtZTtcclxuICAgICAgLy9ub2luc3BlY3Rpb24gSlNIaW50XHJcbiAgICAgIGZvciAobGV0IGtleVZhbHVlIGluIHByb3BFbnRyeS5rZXlNYXApIHtcclxuICAgICAgICByZXN1bHRzLnB1c2gobmV3IEVudGl0eUtleShlbnRpdHlUeXBlLCBba2V5VmFsdWVdKSk7XHJcbiAgICAgIH1cclxuICAgIH1cclxuICAgIHJldHVybiByZXN1bHRzO1xyXG4gIH1cclxuXHJcblxyXG4gIC8vIHByb3RvIG1ldGhvZHMgYmVsb3cgYXJlIG5vdCBwYXJ0IG9mIHRoZSBLZXlHZW5lcmF0b3IgaW50ZXJmYWNlLlxyXG5cclxuICBpc1RlbXBLZXkoZW50aXR5S2V5OiBFbnRpdHlLZXkpIHtcclxuICAgIGxldCBrZXlQcm9wcyA9IGVudGl0eUtleS5lbnRpdHlUeXBlLmtleVByb3BlcnRpZXM7XHJcbiAgICBpZiAoa2V5UHJvcHMubGVuZ3RoID4gMSkgcmV0dXJuIGZhbHNlO1xyXG4gICAgbGV0IGtleVByb3AgPSBrZXlQcm9wc1swXTtcclxuICAgIGxldCBwcm9wRW50cnkgPSB0aGlzLl9nZXRQcm9wRW50cnkoa2V5UHJvcCk7XHJcbiAgICBpZiAoIXByb3BFbnRyeSkge1xyXG4gICAgICByZXR1cm4gZmFsc2U7XHJcbiAgICB9XHJcbiAgICByZXR1cm4gKHByb3BFbnRyeS5rZXlNYXBbZW50aXR5S2V5LnZhbHVlc1swXS50b1N0cmluZygpXSAhPT0gdW5kZWZpbmVkKTtcclxuICB9XHJcblxyXG4gIC8qKiBAaGlkZGVuIEBpbnRlcm5hbCAqL1xyXG4gIHByaXZhdGUgX2dldFByb3BFbnRyeShrZXlQcm9wOiBEYXRhUHJvcGVydHksIGNyZWF0ZUlmTWlzc2luZyA9IGZhbHNlKSB7XHJcbiAgICBsZXQga2V5ID0ga2V5UHJvcC5uYW1lICsgXCIuLlwiICsga2V5UHJvcC5wYXJlbnRUeXBlLm5hbWU7XHJcbiAgICBsZXQgcHJvcEVudHJ5ID0gdGhpcy5fdGVtcElkTWFwW2tleV07XHJcbiAgICBpZiAoIXByb3BFbnRyeSkge1xyXG4gICAgICBpZiAoY3JlYXRlSWZNaXNzaW5nKSB7XHJcbiAgICAgICAgcHJvcEVudHJ5ID0geyBlbnRpdHlUeXBlOiBrZXlQcm9wLnBhcmVudFR5cGUgYXMgRW50aXR5VHlwZSwgcHJvcGVydHlOYW1lOiBrZXlQcm9wLm5hbWUsIGtleU1hcDoge30gfTtcclxuICAgICAgICB0aGlzLl90ZW1wSWRNYXBba2V5XSA9IHByb3BFbnRyeTtcclxuICAgICAgfVxyXG4gICAgfVxyXG4gICAgcmV0dXJuIHByb3BFbnRyeTtcclxuICB9XHJcblxyXG59XHJcblxyXG5jb25maWcucmVnaXN0ZXJUeXBlKEtleUdlbmVyYXRvciwgXCJLZXlHZW5lcmF0b3JcIik7XHJcblxyXG4iXX0=

package/esm2020/src/local-query-comparison-options.mjs

@@ -0,0 +1,65 @@
+import { core } from './core';
+import { assertConfig } from './assert-param';
+import { config } from './config';
+/**
+A LocalQueryComparisonOptions instance is used to specify the "comparison rules" used when performing "local queries" in order
+to match the semantics of these same queries when executed against a remote service.  These options should be set based on the
+manner in which your remote service interprets certain comparison operations.
+
+The default LocalQueryComparisonOptions stipulates 'caseInsensitive" queries with ANSI SQL rules regarding comparisons of unequal
+length strings.
+**/
+export class LocalQueryComparisonOptions {
+    /**
+    LocalQueryComparisonOptions constructor
+    >      // create a 'caseSensitive - non SQL' instance.
+    >      var lqco = new LocalQueryComparisonOptions({
+    >              name: "caseSensitive-nonSQL"
+    >              isCaseSensitive: true;
+    >              usesSql92CompliantStringComparison: false;
+    >          });
+    >      // either apply it globally
+    >      lqco.setAsDefault();
+    >      // or to a specific MetadataStore
+    >      var ms = new MetadataStore({ localQueryComparisonOptions: lqco });
+    >      var em = new EntityManager( { metadataStore: ms });
+    @param config - A configuration object.
+    **/
+    constructor(lqcoConfig) {
+        assertConfig(lqcoConfig || {})
+            .whereParam("name").isOptional().isString()
+            .whereParam("isCaseSensitive").isOptional().isBoolean()
+            .whereParam("usesSql92CompliantStringComparison").isBoolean()
+            .applyAll(this);
+        if (!this.name) {
+            this.name = core.getUuid();
+        }
+        config._storeObject(this, "LocalQueryComparisonOptions", this.name);
+    }
+    /**
+    Sets the 'defaultInstance' by creating a copy of the current 'defaultInstance' and then applying all of the properties of the current instance.
+    The current instance is returned unchanged.
+    >     var lqco = new LocalQueryComparisonOptions({
+    >        isCaseSensitive: false;
+    >        usesSql92CompliantStringComparison: true;
+    >     });
+    >     lqco.setAsDefault();
+    **/
+    setAsDefault() {
+        return core.setAsDefault(this, LocalQueryComparisonOptions);
+    }
+}
+/**
+Case insensitive SQL compliant options - this is also the default unless otherwise changed.
+**/
+LocalQueryComparisonOptions.caseInsensitiveSQL = new LocalQueryComparisonOptions({
+    name: "caseInsensitiveSQL",
+    isCaseSensitive: false,
+    usesSql92CompliantStringComparison: true
+});
+/**
+The default value whenever LocalQueryComparisonOptions are not specified. By default this is 'caseInsensitiveSQL'.
+**/
+LocalQueryComparisonOptions.defaultInstance = new LocalQueryComparisonOptions(LocalQueryComparisonOptions.caseInsensitiveSQL);
+LocalQueryComparisonOptions.prototype._$typeName = "LocalQueryComparisonOptions";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9jYWwtcXVlcnktY29tcGFyaXNvbi1vcHRpb25zLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2xvY2FsLXF1ZXJ5LWNvbXBhcmlzb24tb3B0aW9ucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsSUFBSSxFQUFFLE1BQU0sUUFBUSxDQUFDO0FBQzlCLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUM5QyxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sVUFBVSxDQUFDO0FBZWxDOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLE9BQU8sMkJBQTJCO0lBWXRDOzs7Ozs7Ozs7Ozs7OztPQWNHO0lBQ0gsWUFBWSxVQUE2QztRQUN2RCxZQUFZLENBQUMsVUFBVSxJQUFJLEVBQUUsQ0FBQzthQUN6QixVQUFVLENBQUMsTUFBTSxDQUFDLENBQUMsVUFBVSxFQUFFLENBQUMsUUFBUSxFQUFFO2FBQzFDLFVBQVUsQ0FBQyxpQkFBaUIsQ0FBQyxDQUFDLFVBQVUsRUFBRSxDQUFDLFNBQVMsRUFBRTthQUN0RCxVQUFVLENBQUMsb0NBQW9DLENBQUMsQ0FBQyxTQUFTLEVBQUU7YUFDNUQsUUFBUSxDQUFDLElBQUksQ0FBQyxDQUFDO1FBQ3BCLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSSxFQUFFO1lBQ2QsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUMsT0FBTyxFQUFFLENBQUM7U0FDNUI7UUFDRCxNQUFNLENBQUMsWUFBWSxDQUFDLElBQUksRUFBRSw2QkFBNkIsRUFBRSxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDdEUsQ0FBQztJQWdCRDs7Ozs7Ozs7T0FRRztJQUNILFlBQVk7UUFDVixPQUFPLElBQUksQ0FBQyxZQUFZLENBQUMsSUFBSSxFQUFFLDJCQUEyQixDQUFDLENBQUM7SUFDOUQsQ0FBQzs7QUF6QkQ7O0dBRUc7QUFDSSw4Q0FBa0IsR0FBRyxJQUFJLDJCQUEyQixDQUFDO0lBQzFELElBQUksRUFBRSxvQkFBb0I7SUFDMUIsZUFBZSxFQUFFLEtBQUs7SUFDdEIsa0NBQWtDLEVBQUUsSUFBSTtDQUN6QyxDQUFDLENBQUM7QUFFSDs7R0FFRztBQUNJLDJDQUFlLEdBQUcsSUFBSSwyQkFBMkIsQ0FBQywyQkFBMkIsQ0FBQyxrQkFBa0IsQ0FBQyxDQUFDO0FBZ0IzRywyQkFBMkIsQ0FBQyxTQUFTLENBQUMsVUFBVSxHQUFHLDZCQUE2QixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgY29yZSB9IGZyb20gJy4vY29yZSc7XHJcbmltcG9ydCB7IGFzc2VydENvbmZpZyB9IGZyb20gJy4vYXNzZXJ0LXBhcmFtJztcclxuaW1wb3J0IHsgY29uZmlnIH0gZnJvbSAnLi9jb25maWcnO1xyXG5cclxuXHJcbi8qKiBDb25maWd1cmF0aW9uIGluZm8gdG8gYmUgcGFzc2VkIHRvIHRoZSBbW0xvY2FsUXVlcnlDb21wYXJpc29uT3B0aW9uc11dIGNvbnN0cnVjdG9yLiAqL1xyXG5leHBvcnQgaW50ZXJmYWNlIExvY2FsUXVlcnlDb21wYXJpc29uT3B0aW9uc0NvbmZpZyB7XHJcbiAgLyoqIFRoZSBuYW1lIG9mIHRoaXMgY29sbGVjdGlvbiBvZiBjb25maWd1cmF0aW9uIHNldHRpbmdzLiAqL1xyXG4gIG5hbWU/OiBzdHJpbmc7XHJcbiAgLyoqIFdoZXRoZXIgcHJlZGljYXRlcyB0aGF0IGludm9sdmUgc3RyaW5ncyB3aWxsIGJlIGludGVycHJldGVkIGluIGEgXCJjYXNlU2Vuc2l0aXZlXCIgbWFubmVyLiBEZWZhdWx0IGlzICdmYWxzZScuICovXHJcbiAgaXNDYXNlU2Vuc2l0aXZlPzogYm9vbGVhbjtcclxuICAvKiBXaGV0aGVyIG9yIG5vdCB0byBlbmZvcmNlIHRoZSBBTlNJIFNRTCBzdGFuZGFyZFxyXG4gIG9mIHBhZGRpbmcgc3RyaW5ncyBvZiB1bmVxdWFsIGxlbmd0aHMgYmVmb3JlIGNvbXBhcmlzb24gd2l0aCBzcGFjZXMuIE5vdGUgdGhhdCBwZXIgdGhlIHN0YW5kYXJkLCBwYWRkaW5nIG9ubHkgb2NjdXJzIHdpdGggZXF1YWxpdHkgYW5kXHJcbiAgaW5lcXVhbGl0eSBwcmVkaWNhdGVzLCBhbmQgbm90IHdpdGggb3BlcmF0aW9ucyBsaWtlICdzdGFydHNXaXRoJywgJ2VuZHNXaXRoJyBvciAnY29udGFpbnMnLiAgRGVmYXVsdCBpcyB0cnVlLiAqL1xyXG4gIHVzZXNTcWw5MkNvbXBsaWFudFN0cmluZ0NvbXBhcmlzb24/OiBib29sZWFuO1xyXG59XHJcblxyXG4vKipcclxuQSBMb2NhbFF1ZXJ5Q29tcGFyaXNvbk9wdGlvbnMgaW5zdGFuY2UgaXMgdXNlZCB0byBzcGVjaWZ5IHRoZSBcImNvbXBhcmlzb24gcnVsZXNcIiB1c2VkIHdoZW4gcGVyZm9ybWluZyBcImxvY2FsIHF1ZXJpZXNcIiBpbiBvcmRlclxyXG50byBtYXRjaCB0aGUgc2VtYW50aWNzIG9mIHRoZXNlIHNhbWUgcXVlcmllcyB3aGVuIGV4ZWN1dGVkIGFnYWluc3QgYSByZW1vdGUgc2VydmljZS4gIFRoZXNlIG9wdGlvbnMgc2hvdWxkIGJlIHNldCBiYXNlZCBvbiB0aGVcclxubWFubmVyIGluIHdoaWNoIHlvdXIgcmVtb3RlIHNlcnZpY2UgaW50ZXJwcmV0cyBjZXJ0YWluIGNvbXBhcmlzb24gb3BlcmF0aW9ucy5cclxuXHJcblRoZSBkZWZhdWx0IExvY2FsUXVlcnlDb21wYXJpc29uT3B0aW9ucyBzdGlwdWxhdGVzICdjYXNlSW5zZW5zaXRpdmVcIiBxdWVyaWVzIHdpdGggQU5TSSBTUUwgcnVsZXMgcmVnYXJkaW5nIGNvbXBhcmlzb25zIG9mIHVuZXF1YWxcclxubGVuZ3RoIHN0cmluZ3MuXHJcbioqL1xyXG5leHBvcnQgY2xhc3MgTG9jYWxRdWVyeUNvbXBhcmlzb25PcHRpb25zIHtcclxuICAvKiogQGhpZGRlbiBAaW50ZXJuYWwgKi9cclxuICBfJHR5cGVOYW1lOiBzdHJpbmc7IC8vIG9uIHByb3RvdHlwZVxyXG4gIC8qKiBUaGUgbmFtZSBmb3IgdGhpcyBpbnN0YW5jZS4gKi9cclxuICBuYW1lOiBzdHJpbmc7XHJcbiAgLyoqIFdoZXRoZXIgcHJlZGljYXRlcyB0aGF0IGludm9sdmUgc3RyaW5ncyB3aWxsIGJlIGludGVycHJldGVkIGluIGEgXCJjYXNlU2Vuc2l0aXZlXCIgbWFubmVyLiAoZGVmYXVsdCA9IGZhbHNlKS4gICovXHJcbiAgaXNDYXNlU2Vuc2l0aXZlOiBib29sZWFuO1xyXG4gIC8qIFdoZXRoZXIgb3Igbm90IHRvIGVuZm9yY2UgdGhlIEFOU0kgU1FMIHN0YW5kYXJkXHJcbiAgb2YgcGFkZGluZyBzdHJpbmdzIG9mIHVuZXF1YWwgbGVuZ3RocyBiZWZvcmUgY29tcGFyaXNvbiB3aXRoIHNwYWNlcy4gTm90ZSB0aGF0IHBlciB0aGUgc3RhbmRhcmQsIHBhZGRpbmcgb25seSBvY2N1cnMgd2l0aCBlcXVhbGl0eSBhbmRcclxuICBpbmVxdWFsaXR5IHByZWRpY2F0ZXMsIGFuZCBub3Qgd2l0aCBvcGVyYXRpb25zIGxpa2UgJ3N0YXJ0c1dpdGgnLCAnZW5kc1dpdGgnIG9yICdjb250YWlucycuICBEZWZhdWx0IGlzIHRydWUuICovXHJcbiAgdXNlc1NxbDkyQ29tcGxpYW50U3RyaW5nQ29tcGFyaXNvbjogYm9vbGVhbjtcclxuXHJcbiAgLyoqXHJcbiAgTG9jYWxRdWVyeUNvbXBhcmlzb25PcHRpb25zIGNvbnN0cnVjdG9yXHJcbiAgPiAgICAgIC8vIGNyZWF0ZSBhICdjYXNlU2Vuc2l0aXZlIC0gbm9uIFNRTCcgaW5zdGFuY2UuXHJcbiAgPiAgICAgIHZhciBscWNvID0gbmV3IExvY2FsUXVlcnlDb21wYXJpc29uT3B0aW9ucyh7XHJcbiAgPiAgICAgICAgICAgICAgbmFtZTogXCJjYXNlU2Vuc2l0aXZlLW5vblNRTFwiXHJcbiAgPiAgICAgICAgICAgICAgaXNDYXNlU2Vuc2l0aXZlOiB0cnVlO1xyXG4gID4gICAgICAgICAgICAgIHVzZXNTcWw5MkNvbXBsaWFudFN0cmluZ0NvbXBhcmlzb246IGZhbHNlO1xyXG4gID4gICAgICAgICAgfSk7XHJcbiAgPiAgICAgIC8vIGVpdGhlciBhcHBseSBpdCBnbG9iYWxseVxyXG4gID4gICAgICBscWNvLnNldEFzRGVmYXVsdCgpO1xyXG4gID4gICAgICAvLyBvciB0byBhIHNwZWNpZmljIE1ldGFkYXRhU3RvcmVcclxuICA+ICAgICAgdmFyIG1zID0gbmV3IE1ldGFkYXRhU3RvcmUoeyBsb2NhbFF1ZXJ5Q29tcGFyaXNvbk9wdGlvbnM6IGxxY28gfSk7XHJcbiAgPiAgICAgIHZhciBlbSA9IG5ldyBFbnRpdHlNYW5hZ2VyKCB7IG1ldGFkYXRhU3RvcmU6IG1zIH0pO1xyXG4gIEBwYXJhbSBjb25maWcgLSBBIGNvbmZpZ3VyYXRpb24gb2JqZWN0LlxyXG4gICoqL1xyXG4gIGNvbnN0cnVjdG9yKGxxY29Db25maWc6IExvY2FsUXVlcnlDb21wYXJpc29uT3B0aW9uc0NvbmZpZykge1xyXG4gICAgYXNzZXJ0Q29uZmlnKGxxY29Db25maWcgfHwge30pXHJcbiAgICAgICAgLndoZXJlUGFyYW0oXCJuYW1lXCIpLmlzT3B0aW9uYWwoKS5pc1N0cmluZygpXHJcbiAgICAgICAgLndoZXJlUGFyYW0oXCJpc0Nhc2VTZW5zaXRpdmVcIikuaXNPcHRpb25hbCgpLmlzQm9vbGVhbigpXHJcbiAgICAgICAgLndoZXJlUGFyYW0oXCJ1c2VzU3FsOTJDb21wbGlhbnRTdHJpbmdDb21wYXJpc29uXCIpLmlzQm9vbGVhbigpXHJcbiAgICAgICAgLmFwcGx5QWxsKHRoaXMpO1xyXG4gICAgaWYgKCF0aGlzLm5hbWUpIHtcclxuICAgICAgdGhpcy5uYW1lID0gY29yZS5nZXRVdWlkKCk7XHJcbiAgICB9XHJcbiAgICBjb25maWcuX3N0b3JlT2JqZWN0KHRoaXMsIFwiTG9jYWxRdWVyeUNvbXBhcmlzb25PcHRpb25zXCIsIHRoaXMubmFtZSk7XHJcbiAgfVxyXG5cclxuICAvKipcclxuICBDYXNlIGluc2Vuc2l0aXZlIFNRTCBjb21wbGlhbnQgb3B0aW9ucyAtIHRoaXMgaXMgYWxzbyB0aGUgZGVmYXVsdCB1bmxlc3Mgb3RoZXJ3aXNlIGNoYW5nZWQuXHJcbiAgKiovXHJcbiAgc3RhdGljIGNhc2VJbnNlbnNpdGl2ZVNRTCA9IG5ldyBMb2NhbFF1ZXJ5Q29tcGFyaXNvbk9wdGlvbnMoe1xyXG4gICAgbmFtZTogXCJjYXNlSW5zZW5zaXRpdmVTUUxcIixcclxuICAgIGlzQ2FzZVNlbnNpdGl2ZTogZmFsc2UsXHJcbiAgICB1c2VzU3FsOTJDb21wbGlhbnRTdHJpbmdDb21wYXJpc29uOiB0cnVlXHJcbiAgfSk7XHJcblxyXG4gIC8qKlxyXG4gIFRoZSBkZWZhdWx0IHZhbHVlIHdoZW5ldmVyIExvY2FsUXVlcnlDb21wYXJpc29uT3B0aW9ucyBhcmUgbm90IHNwZWNpZmllZC4gQnkgZGVmYXVsdCB0aGlzIGlzICdjYXNlSW5zZW5zaXRpdmVTUUwnLlxyXG4gICoqL1xyXG4gIHN0YXRpYyBkZWZhdWx0SW5zdGFuY2UgPSBuZXcgTG9jYWxRdWVyeUNvbXBhcmlzb25PcHRpb25zKExvY2FsUXVlcnlDb21wYXJpc29uT3B0aW9ucy5jYXNlSW5zZW5zaXRpdmVTUUwpO1xyXG5cclxuICAvKipcclxuICBTZXRzIHRoZSAnZGVmYXVsdEluc3RhbmNlJyBieSBjcmVhdGluZyBhIGNvcHkgb2YgdGhlIGN1cnJlbnQgJ2RlZmF1bHRJbnN0YW5jZScgYW5kIHRoZW4gYXBwbHlpbmcgYWxsIG9mIHRoZSBwcm9wZXJ0aWVzIG9mIHRoZSBjdXJyZW50IGluc3RhbmNlLlxyXG4gIFRoZSBjdXJyZW50IGluc3RhbmNlIGlzIHJldHVybmVkIHVuY2hhbmdlZC5cclxuICA+ICAgICB2YXIgbHFjbyA9IG5ldyBMb2NhbFF1ZXJ5Q29tcGFyaXNvbk9wdGlvbnMoe1xyXG4gID4gICAgICAgIGlzQ2FzZVNlbnNpdGl2ZTogZmFsc2U7XHJcbiAgPiAgICAgICAgdXNlc1NxbDkyQ29tcGxpYW50U3RyaW5nQ29tcGFyaXNvbjogdHJ1ZTtcclxuICA+ICAgICB9KTtcclxuICA+ICAgICBscWNvLnNldEFzRGVmYXVsdCgpO1xyXG4gICoqL1xyXG4gIHNldEFzRGVmYXVsdCgpIHtcclxuICAgIHJldHVybiBjb3JlLnNldEFzRGVmYXVsdCh0aGlzLCBMb2NhbFF1ZXJ5Q29tcGFyaXNvbk9wdGlvbnMpO1xyXG4gIH1cclxuXHJcbn1cclxuTG9jYWxRdWVyeUNvbXBhcmlzb25PcHRpb25zLnByb3RvdHlwZS5fJHR5cGVOYW1lID0gXCJMb2NhbFF1ZXJ5Q29tcGFyaXNvbk9wdGlvbnNcIjtcclxuIl19