@itwin/ecschema-metadata 5.0.0-dev.11 → 5.0.0-dev.110

package/lib/esm/DelayedPromise.d.ts

@@ -20,7 +20,7 @@
  * additional (non-lazily-loaded) "nested" properties can be added.
  *
  * [!alert text="*Remember:* Unlike regular Promises in JavaScript, DelayedPromises represent processes that **may not** already be happening." kind="warning"]
- * @beta
+ * @internal
  */
 export declare class DelayedPromise<T> implements Promise<T> {
     /**
@@ -54,7 +54,7 @@ export declare class DelayedPromise<T> implements Promise<T> {
     finally(onFinally?: (() => void) | undefined | null): Promise<T>;
 }
 /**
- * @beta
+ * @internal
  */
 export interface NoDelayedPromiseMethods {
     [propName: string]: any;
@@ -63,7 +63,7 @@ export interface NoDelayedPromiseMethods {
     catch?: never;
 }
 /**
- * @beta
+ * @internal
  */
 export interface DelayedPromiseWithPropsConstructor {
     /**
@@ -76,14 +76,15 @@ export interface DelayedPromiseWithPropsConstructor {
      *              as if they were readonly properties of the DelayedPromiseWithProps object being constructed.
      * @param startCallback The asynchronous callback to execute when as soon as this DelayedPromise should be "started".
      */
-    new <TProps extends NoDelayedPromiseMethods, TPayload>(props: TProps, startCallback: () => Promise<TPayload>): Readonly<TProps> & DelayedPromise<TPayload>;
+    new <TProps extends NoDelayedPromiseMethods, TPayload>(props: TProps, startCallback: () => Promise<TPayload>): TProps & DelayedPromise<TPayload>;
 }
 /**
- * @beta
+ * @internal
  */
 export declare const DelayedPromiseWithProps: DelayedPromiseWithPropsConstructor;
-/** Define the type of a DelayedPromiseWithProps instance
- * @beta
+/**
+ * Define the type of a DelayedPromiseWithProps instance
+ * @internal
  */
-export type DelayedPromiseWithProps<TProps, TPayload> = Readonly<TProps> & DelayedPromise<TPayload>;
+export type DelayedPromiseWithProps<TProps, TPayload> = TProps & DelayedPromise<TPayload>;
 //# sourceMappingURL=DelayedPromise.d.ts.map

package/lib/esm/DelayedPromise.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DelayedPromise.d.ts","sourceRoot":"","sources":["../../src/DelayedPromise.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,cAAc,CAAC,CAAC,CAAE,YAAW,OAAO,CAAC,CAAC,CAAC;IAElD;;;OAGG;gBACS,aAAa,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC;IAS3C,SAAgB,CAAC,MAAM,CAAC,WAAW,CAAC,YAAsB;IAE1D;;OAEG;IACI,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IAE/B;;;;;OAKG;IACU,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAIvP;;;;OAIG;IACU,KAAK,CAAC,OAAO,GAAG,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC;IAI5I;;;;OAIG;IACU,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;CAG9E;AAGD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAGD;;GAEG;AACH,MAAM,WAAW,kCAAkC;IAEjD;;;;;;;;;OASG;IACH,KAAK,MAAM,SAAS,uBAAuB,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;CAC5J;AAID;;GAEG;AAEH,eAAO,MAAM,uBAAuB,EAY9B,kCAAkC,CAAC;AAIzC;;GAEG;AACH,MAAM,MAAM,uBAAuB,CAAC,MAAM,EAAE,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"DelayedPromise.d.ts","sourceRoot":"","sources":["../../src/DelayedPromise.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,cAAc,CAAC,CAAC,CAAE,YAAW,OAAO,CAAC,CAAC,CAAC;IAElD;;;OAGG;gBACS,aAAa,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC;IAS3C,SAAgB,CAAC,MAAM,CAAC,WAAW,CAAC,YAAsB;IAE1D;;OAEG;IACI,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IAE/B;;;;;OAKG;IACU,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAIvP;;;;OAIG;IACU,KAAK,CAAC,OAAO,GAAG,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC;IAI5I;;;;OAIG;IACU,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;CAG9E;AAGD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAGD;;GAEG;AACH,MAAM,WAAW,kCAAkC;IAEjD;;;;;;;;;OASG;IACH,KAAK,MAAM,SAAS,uBAAuB,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;CAClJ;AAID;;GAEG;AAEH,eAAO,MAAM,uBAAuB,EAY9B,kCAAkC,CAAC;AAIzC;;;GAGG;AACH,MAAM,MAAM,uBAAuB,CAAC,MAAM,EAAE,QAAQ,IAAI,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC"}

package/lib/esm/DelayedPromise.js

@@ -5,7 +5,6 @@
 /** @packageDocumentation
  * @module Utils
  */
-var _a;
 /**
  * Similar to a normal Promise, a DelayedPromise represents the eventual completion (or failure)
  * and resulting value of an asynchronous operation ***that has not yet started***.
@@ -25,7 +24,7 @@ var _a;
  * additional (non-lazily-loaded) "nested" properties can be added.
  *
  * [!alert text="*Remember:* Unlike regular Promises in JavaScript, DelayedPromises represent processes that **may not** already be happening." kind="warning"]
- * @beta
+ * @internal
  */
 export class DelayedPromise {
     /**
@@ -33,14 +32,18 @@ export class DelayedPromise {
      * @param startCallback The asynchronous callback to execute when this DelayedPromise should be "started".
      */
     constructor(startCallback) {
-        // We need this in order to fulfill the Promise interface defined in lib.es2015.symbol.wellknown.d.ts
-        this[_a] = "Promise";
         let pending;
         this.start = async () => {
             pending = pending || startCallback();
             return pending;
         };
     }
+    // We need this in order to fulfill the Promise interface defined in lib.es2015.symbol.wellknown.d.ts
+    [Symbol.toStringTag] = "Promise";
+    /**
+     * Explicitly starts the asynchronous operation behind this DelayedPromise (if it hasn't started already).
+     */
+    start;
     /**
      * Attaches callbacks for the resolution and/or rejection of the Promise.
      * @param onfulfilled The callback to execute when the Promise is resolved.
@@ -67,11 +70,10 @@ export class DelayedPromise {
         return this.start().finally(onFinally);
     }
 }
-_a = Symbol.toStringTag;
 // Because the property getters that wrap `props` are dynamically added, TypeScript isn't aware of them.
 // So by defining this as a class _expression_, we can cast the constructed type to Readonly<TProps> & DelayedPromise<TPayload>
 /**
- * @beta
+ * @internal
  */
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export const DelayedPromiseWithProps = (class extends DelayedPromise {

package/lib/esm/DelayedPromise.js.map

@@ -1 +1 @@
-{"version":3,"file":"DelayedPromise.js","sourceRoot":"","sources":["../../src/DelayedPromise.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,cAAc;IAEzB;;;OAGG;IACH,YAAY,aAA+B;QAQ3C,qGAAqG;QACrF,QAAoB,GAAG,SAAkB,CAAC;QARxD,IAAI,OAA+B,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,EAAE;YACtB,OAAO,GAAG,OAAO,IAAI,aAAa,EAAE,CAAC;YACrC,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC;IACJ,CAAC;IAUD;;;;;OAKG;IACI,KAAK,CAAC,IAAI,CAAiC,WAAiF,EAAE,UAAmF;QACtN,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,KAAK,CAAkB,UAAiF;QACnH,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,OAAO,CAAC,SAA2C;QAC9D,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;CACF;KAlCkB,MAAM,CAAC,WAAW;AAkErC,wGAAwG;AACxG,+HAA+H;AAC/H;;GAEG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAyD,SAAQ,cAAwB;IAC/H,YAAY,KAAa,EAAE,EAA2B;QACpD,KAAK,CAAC,EAAE,CAAC,CAAC;QAEV,MAAM,OAAO,GAAG;YACd,GAAG,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,EAAE;gBACpC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAkB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAoB,CAAC,CAAC;YAClF,CAAC;SACF,CAAC;QAEF,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,CAAgD,CAAC;IAClF,CAAC;CACF,CAAuC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Utils\r\n */\r\n\r\n/**\r\n * Similar to a normal Promise, a DelayedPromise represents the eventual completion (or failure)\r\n * and resulting value of an asynchronous operation ***that has not yet started***.\r\n *\r\n * The asynchronous operation behind a DelayedPromise will start when any of the following occurs:\r\n *  - The DelayedPromise is `await`ed.\r\n *  - A callback is attached via `.then()` or `.catch(() => { })`.\r\n *  - The asynchronous operation is explicitly started via `.start()`\r\n *\r\n * Just as normal Promises will never return to their pending state once fulfilled or rejected,\r\n * a DelayedPromise will never re-execute its asynchronous operation more than **once**.\r\n *\r\n * Ultimately, a DelayedPromise is nothing more than some syntactic sugar that allows you to\r\n * represent an (asynchronously) lazily-loaded value as an instance property instead of a method.\r\n * You could also accomplish something similar by defining an async function as a property getter.\r\n * However, since a property defined as a DelayedPromise will not start simply by being accessed,\r\n * additional (non-lazily-loaded) \"nested\" properties can be added.\r\n *\r\n * [!alert text=\"*Remember:* Unlike regular Promises in JavaScript, DelayedPromises represent processes that **may not** already be happening.\" kind=\"warning\"]\r\n * @beta\r\n */\r\nexport class DelayedPromise<T> implements Promise<T> {\r\n\r\n  /**\r\n   * Constructs a DelayedPromise object.\r\n   * @param startCallback The asynchronous callback to execute when this DelayedPromise should be \"started\".\r\n   */\r\n  constructor(startCallback: () => Promise<T>) {\r\n    let pending: Promise<T> | undefined;\r\n    this.start = async () => {\r\n      pending = pending || startCallback();\r\n      return pending;\r\n    };\r\n  }\r\n\r\n  // We need this in order to fulfill the Promise interface defined in lib.es2015.symbol.wellknown.d.ts\r\n  public readonly [Symbol.toStringTag] = \"Promise\" as const;\r\n\r\n  /**\r\n   * Explicitly starts the asynchronous operation behind this DelayedPromise (if it hasn't started already).\r\n   */\r\n  public start: () => Promise<T>;\r\n\r\n  /**\r\n   * Attaches callbacks for the resolution and/or rejection of the Promise.\r\n   * @param onfulfilled The callback to execute when the Promise is resolved.\r\n   * @param onrejected The callback to execute when the Promise is rejected.\r\n   * @return A Promise for the completion of which ever callback is executed.\r\n   */\r\n  public async then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): Promise<TResult1 | TResult2> {\r\n    return this.start().then(onfulfilled, onrejected);\r\n  }\r\n\r\n  /**\r\n   * Attaches a callback for only the rejection of the Promise.\r\n   * @param onrejected The callback to execute when the Promise is rejected.\r\n   * @return A Promise for the completion of the callback.\r\n   */\r\n  public async catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<T | TResult> {\r\n    return this.start().catch(onrejected);\r\n  }\r\n\r\n  /**\r\n   * Attaches a callback for only the finally clause of the Promise.\r\n   * @param onrejected The callback to execute when the Promise is finalized.\r\n   * @return A Promise for the completion of the callback.\r\n   */\r\n  public async finally(onFinally?: (() => void) | undefined | null): Promise<T> {\r\n    return this.start().finally(onFinally);\r\n  }\r\n}\r\n\r\n// This keeps us from accidentally overriding one of DelayedPromise's methods in the DelayedPromiseWithProps constructor\r\n/**\r\n * @beta\r\n */\r\nexport interface NoDelayedPromiseMethods {\r\n  [propName: string]: any;\r\n  start?: never;\r\n  then?: never;\r\n  catch?: never;\r\n}\r\n\r\n// See definition of DelayedPromiseWithProps below\r\n/**\r\n * @beta\r\n */\r\nexport interface DelayedPromiseWithPropsConstructor {\r\n\r\n  /**\r\n   * Constructs a DelayedPromiseWithProps object, which is at once both:\r\n   *  - A DelayedPromise object representing the eventual completion (or failure)\r\n   *    of an asynchronous operation returning a value of type `TPayload`\r\n   *  - _and_ a readonly \"wrapper\" around an instance of type `TProps`\r\n   *\r\n   * @param props An object with properties and methods that will be accessible\r\n   *              as if they were readonly properties of the DelayedPromiseWithProps object being constructed.\r\n   * @param startCallback The asynchronous callback to execute when as soon as this DelayedPromise should be \"started\".\r\n   */\r\n  new <TProps extends NoDelayedPromiseMethods, TPayload>(props: TProps, startCallback: () => Promise<TPayload>): Readonly<TProps> & DelayedPromise<TPayload>; // eslint-disable-line @typescript-eslint/prefer-function-type\r\n}\r\n\r\n// Because the property getters that wrap `props` are dynamically added, TypeScript isn't aware of them.\r\n// So by defining this as a class _expression_, we can cast the constructed type to Readonly<TProps> & DelayedPromise<TPayload>\r\n/**\r\n * @beta\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport const DelayedPromiseWithProps = (class <TProps extends NoDelayedPromiseMethods, TPayload> extends DelayedPromise<TPayload> {\r\n  constructor(props: TProps, cb: () => Promise<TPayload>) {\r\n    super(cb);\r\n\r\n    const handler = {\r\n      get: (target: TProps, name: string) => {\r\n        return (name in this) ? this[name as keyof this] : target[name as keyof TProps];\r\n      },\r\n    };\r\n\r\n    return new Proxy(props, handler) as Readonly<TProps> & DelayedPromise<TPayload>;\r\n  }\r\n}) as DelayedPromiseWithPropsConstructor;\r\n\r\n/* eslint-disable @typescript-eslint/no-redeclare */\r\n\r\n/** Define the type of a DelayedPromiseWithProps instance\r\n * @beta\r\n */\r\nexport type DelayedPromiseWithProps<TProps, TPayload> = Readonly<TProps> & DelayedPromise<TPayload>;\r\n"]}
+{"version":3,"file":"DelayedPromise.js","sourceRoot":"","sources":["../../src/DelayedPromise.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,cAAc;IAEzB;;;OAGG;IACH,YAAY,aAA+B;QACzC,IAAI,OAA+B,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,EAAE;YACtB,OAAO,GAAG,OAAO,IAAI,aAAa,EAAE,CAAC;YACrC,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC;IACJ,CAAC;IAED,qGAAqG;IACrF,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,SAAkB,CAAC;IAE1D;;OAEG;IACI,KAAK,CAAmB;IAE/B;;;;;OAKG;IACI,KAAK,CAAC,IAAI,CAAiC,WAAiF,EAAE,UAAmF;QACtN,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,KAAK,CAAkB,UAAiF;QACnH,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,OAAO,CAAC,SAA2C;QAC9D,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;CACF;AAgCD,wGAAwG;AACxG,+HAA+H;AAC/H;;GAEG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAyD,SAAQ,cAAwB;IAC/H,YAAY,KAAa,EAAE,EAA2B;QACpD,KAAK,CAAC,EAAE,CAAC,CAAC;QAEV,MAAM,OAAO,GAAG;YACd,GAAG,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,EAAE;gBACpC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAkB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAoB,CAAC,CAAC;YAClF,CAAC;SACF,CAAC;QAEF,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,CAAsC,CAAC;IACxE,CAAC;CACF,CAAuC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Utils\r\n */\r\n\r\n/**\r\n * Similar to a normal Promise, a DelayedPromise represents the eventual completion (or failure)\r\n * and resulting value of an asynchronous operation ***that has not yet started***.\r\n *\r\n * The asynchronous operation behind a DelayedPromise will start when any of the following occurs:\r\n *  - The DelayedPromise is `await`ed.\r\n *  - A callback is attached via `.then()` or `.catch(() => { })`.\r\n *  - The asynchronous operation is explicitly started via `.start()`\r\n *\r\n * Just as normal Promises will never return to their pending state once fulfilled or rejected,\r\n * a DelayedPromise will never re-execute its asynchronous operation more than **once**.\r\n *\r\n * Ultimately, a DelayedPromise is nothing more than some syntactic sugar that allows you to\r\n * represent an (asynchronously) lazily-loaded value as an instance property instead of a method.\r\n * You could also accomplish something similar by defining an async function as a property getter.\r\n * However, since a property defined as a DelayedPromise will not start simply by being accessed,\r\n * additional (non-lazily-loaded) \"nested\" properties can be added.\r\n *\r\n * [!alert text=\"*Remember:* Unlike regular Promises in JavaScript, DelayedPromises represent processes that **may not** already be happening.\" kind=\"warning\"]\r\n * @internal\r\n */\r\nexport class DelayedPromise<T> implements Promise<T> {\r\n\r\n  /**\r\n   * Constructs a DelayedPromise object.\r\n   * @param startCallback The asynchronous callback to execute when this DelayedPromise should be \"started\".\r\n   */\r\n  constructor(startCallback: () => Promise<T>) {\r\n    let pending: Promise<T> | undefined;\r\n    this.start = async () => {\r\n      pending = pending || startCallback();\r\n      return pending;\r\n    };\r\n  }\r\n\r\n  // We need this in order to fulfill the Promise interface defined in lib.es2015.symbol.wellknown.d.ts\r\n  public readonly [Symbol.toStringTag] = \"Promise\" as const;\r\n\r\n  /**\r\n   * Explicitly starts the asynchronous operation behind this DelayedPromise (if it hasn't started already).\r\n   */\r\n  public start: () => Promise<T>;\r\n\r\n  /**\r\n   * Attaches callbacks for the resolution and/or rejection of the Promise.\r\n   * @param onfulfilled The callback to execute when the Promise is resolved.\r\n   * @param onrejected The callback to execute when the Promise is rejected.\r\n   * @return A Promise for the completion of which ever callback is executed.\r\n   */\r\n  public async then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): Promise<TResult1 | TResult2> {\r\n    return this.start().then(onfulfilled, onrejected);\r\n  }\r\n\r\n  /**\r\n   * Attaches a callback for only the rejection of the Promise.\r\n   * @param onrejected The callback to execute when the Promise is rejected.\r\n   * @return A Promise for the completion of the callback.\r\n   */\r\n  public async catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<T | TResult> {\r\n    return this.start().catch(onrejected);\r\n  }\r\n\r\n  /**\r\n   * Attaches a callback for only the finally clause of the Promise.\r\n   * @param onrejected The callback to execute when the Promise is finalized.\r\n   * @return A Promise for the completion of the callback.\r\n   */\r\n  public async finally(onFinally?: (() => void) | undefined | null): Promise<T> {\r\n    return this.start().finally(onFinally);\r\n  }\r\n}\r\n\r\n// This keeps us from accidentally overriding one of DelayedPromise's methods in the DelayedPromiseWithProps constructor\r\n/**\r\n * @internal\r\n */\r\nexport interface NoDelayedPromiseMethods {\r\n  [propName: string]: any;\r\n  start?: never;\r\n  then?: never;\r\n  catch?: never;\r\n}\r\n\r\n// See definition of DelayedPromiseWithProps below\r\n/**\r\n * @internal\r\n */\r\nexport interface DelayedPromiseWithPropsConstructor {\r\n\r\n  /**\r\n   * Constructs a DelayedPromiseWithProps object, which is at once both:\r\n   *  - A DelayedPromise object representing the eventual completion (or failure)\r\n   *    of an asynchronous operation returning a value of type `TPayload`\r\n   *  - _and_ a readonly \"wrapper\" around an instance of type `TProps`\r\n   *\r\n   * @param props An object with properties and methods that will be accessible\r\n   *              as if they were readonly properties of the DelayedPromiseWithProps object being constructed.\r\n   * @param startCallback The asynchronous callback to execute when as soon as this DelayedPromise should be \"started\".\r\n   */\r\n  new <TProps extends NoDelayedPromiseMethods, TPayload>(props: TProps, startCallback: () => Promise<TPayload>): TProps & DelayedPromise<TPayload>; // eslint-disable-line @typescript-eslint/prefer-function-type\r\n}\r\n\r\n// Because the property getters that wrap `props` are dynamically added, TypeScript isn't aware of them.\r\n// So by defining this as a class _expression_, we can cast the constructed type to Readonly<TProps> & DelayedPromise<TPayload>\r\n/**\r\n * @internal\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport const DelayedPromiseWithProps = (class <TProps extends NoDelayedPromiseMethods, TPayload> extends DelayedPromise<TPayload> {\r\n  constructor(props: TProps, cb: () => Promise<TPayload>) {\r\n    super(cb);\r\n\r\n    const handler = {\r\n      get: (target: TProps, name: string) => {\r\n        return (name in this) ? this[name as keyof this] : target[name as keyof TProps];\r\n      },\r\n    };\r\n\r\n    return new Proxy(props, handler) as TProps & DelayedPromise<TPayload>;\r\n  }\r\n}) as DelayedPromiseWithPropsConstructor;\r\n\r\n/* eslint-disable @typescript-eslint/no-redeclare */\r\n\r\n/**\r\n * Define the type of a DelayedPromiseWithProps instance\r\n * @internal\r\n */\r\nexport type DelayedPromiseWithProps<TProps, TPayload> = TProps & DelayedPromise<TPayload>;\r\n"]}

package/lib/esm/Deserialization/AbstractParser.js

@@ -4,5 +4,6 @@
 *--------------------------------------------------------------------------------------------*/
 /** @internal */
 export class AbstractParser {
+    _ecSpecVersion;
 }
 //# sourceMappingURL=AbstractParser.js.map

package/lib/esm/Deserialization/AbstractParser.js.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractParser.js","sourceRoot":"","sources":["../../../src/Deserialization/AbstractParser.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAoB/F,gBAAgB;AAChB,MAAM,OAAgB,cAAc;CAoCnC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nimport {\r\n  ConstantProps, CustomAttributeClassProps, EntityClassProps, EnumerationProps, InvertedUnitProps, KindOfQuantityProps, MixinProps,\r\n  NavigationPropertyProps, PhenomenonProps, PrimitiveArrayPropertyProps, PrimitivePropertyProps, PropertyCategoryProps, RelationshipClassProps,\r\n  SchemaItemFormatProps, SchemaItemUnitProps, SchemaProps, SchemaReferenceProps, StructArrayPropertyProps, StructClassProps, StructPropertyProps, UnitSystemProps,\r\n} from \"../Deserialization/JsonProps\";\r\nimport { CustomAttribute } from \"../Metadata/CustomAttribute\";\r\nimport { CustomAttributeClass } from \"../Metadata/CustomAttributeClass\";\r\nimport { ECSpecVersion } from \"./Helper\";\r\n\r\ntype SchemaItemTuple<T> = Readonly<[string /** Name */, string /** SchemaItemType */, Readonly<T>]>;\r\ntype PropertyTuple<T> = Readonly<[string /** Name */, string /** Property */, Readonly<T>]>;\r\n\r\n/** @internal */\r\nexport type CustomAttributeProvider = (caClass: CustomAttributeClass) => CustomAttribute;\r\n\r\n/** @internal */\r\nexport type CAProviderTuple = Readonly<[string /** Full Name */, CustomAttributeProvider]>;\r\n\r\n/** @internal */\r\nexport abstract class AbstractParser<TItem = any, TProperty = TItem> {\r\n  protected _ecSpecVersion?: ECSpecVersion;\r\n\r\n  public abstract parseSchema(): SchemaProps;\r\n  public abstract getReferences(): Iterable<SchemaReferenceProps>;\r\n\r\n  public abstract getItems(): Iterable<SchemaItemTuple<TItem>>;\r\n  public abstract findItem(itemName: string): SchemaItemTuple<TItem> | undefined;\r\n\r\n  public abstract parseEntityClass(data: Readonly<TItem>): EntityClassProps;\r\n  public abstract parseMixin(data: Readonly<TItem>): MixinProps;\r\n  public abstract parseStructClass(data: Readonly<TItem>): StructClassProps;\r\n  public abstract parseCustomAttributeClass(data: Readonly<TItem>): CustomAttributeClassProps;\r\n  public abstract parseRelationshipClass(data: Readonly<TItem>): RelationshipClassProps;\r\n  public abstract parseEnumeration(data: Readonly<TItem>): EnumerationProps;\r\n  public abstract parseKindOfQuantity(data: Readonly<TItem>): KindOfQuantityProps;\r\n  public abstract parsePropertyCategory(data: Readonly<TItem>): PropertyCategoryProps;\r\n  public abstract parseUnit(data: Readonly<TItem>): SchemaItemUnitProps;\r\n  public abstract parseInvertedUnit(data: Readonly<TItem>): InvertedUnitProps;\r\n  public abstract parseConstant(data: Readonly<TItem>): ConstantProps;\r\n  public abstract parsePhenomenon(data: Readonly<TItem>): PhenomenonProps;\r\n  public abstract parseFormat(data: Readonly<TItem>): SchemaItemFormatProps;\r\n  public abstract parseUnitSystem(data: Readonly<TItem>): UnitSystemProps;\r\n\r\n  public abstract getProperties(data: Readonly<TItem>, itemName: string): Iterable<PropertyTuple<TProperty>>;\r\n  public abstract parsePrimitiveProperty(data: Readonly<TProperty>): PrimitivePropertyProps;\r\n  public abstract parseStructProperty(data: Readonly<TProperty>): StructPropertyProps;\r\n  public abstract parsePrimitiveArrayProperty(data: Readonly<TProperty>): PrimitiveArrayPropertyProps;\r\n  public abstract parseStructArrayProperty(data: Readonly<TProperty>): StructArrayPropertyProps;\r\n  public abstract parseNavigationProperty(data: Readonly<TProperty>): NavigationPropertyProps;\r\n\r\n  public abstract getSchemaCustomAttributeProviders(): Iterable<CAProviderTuple>;\r\n  public abstract getClassCustomAttributeProviders(data: Readonly<TItem>): Iterable<CAProviderTuple>;\r\n  public abstract getPropertyCustomAttributeProviders(data: Readonly<TProperty>): Iterable<CAProviderTuple>;\r\n  public abstract getRelationshipConstraintCustomAttributeProviders(data: Readonly<TItem>): [Iterable<CAProviderTuple> /* source */, Iterable<CAProviderTuple> /* target */];\r\n  public abstract get getECSpecVersion(): ECSpecVersion | undefined;\r\n}\r\n\r\n/** @internal */\r\n// eslint-disable-next-line @typescript-eslint/prefer-function-type\r\nexport interface AbstractParserConstructor<TSchema, TItem = any, TProperty = TItem> { new(obj: Readonly<TSchema>): AbstractParser<TItem, TProperty> }\r\n"]}
+{"version":3,"file":"AbstractParser.js","sourceRoot":"","sources":["../../../src/Deserialization/AbstractParser.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAoB/F,gBAAgB;AAChB,MAAM,OAAgB,cAAc;IACxB,cAAc,CAAiB;CAmC1C","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nimport {\r\n  ConstantProps, CustomAttributeClassProps, EntityClassProps, EnumerationProps, InvertedUnitProps, KindOfQuantityProps, MixinProps,\r\n  NavigationPropertyProps, PhenomenonProps, PrimitiveArrayPropertyProps, PrimitivePropertyProps, PropertyCategoryProps, RelationshipClassProps,\r\n  SchemaItemFormatProps, SchemaItemUnitProps, SchemaProps, SchemaReferenceProps, StructArrayPropertyProps, StructClassProps, StructPropertyProps, UnitSystemProps,\r\n} from \"../Deserialization/JsonProps\";\r\nimport { CustomAttribute } from \"../Metadata/CustomAttribute\";\r\nimport { CustomAttributeClass } from \"../Metadata/CustomAttributeClass\";\r\nimport { ECSpecVersion } from \"./Helper\";\r\n\r\ntype SchemaItemTuple<T> = Readonly<[string /** Name */, string /** SchemaItemType */, Readonly<T>]>;\r\ntype PropertyTuple<T> = Readonly<[string /** Name */, string /** Property */, Readonly<T>]>;\r\n\r\n/** @internal */\r\nexport type CustomAttributeProvider = (caClass: CustomAttributeClass) => CustomAttribute;\r\n\r\n/** @internal */\r\nexport type CAProviderTuple = Readonly<[string /** Full Name */, CustomAttributeProvider]>;\r\n\r\n/** @internal */\r\nexport abstract class AbstractParser<TItem = any, TProperty = TItem> {\r\n  protected _ecSpecVersion?: ECSpecVersion;\r\n\r\n  public abstract parseSchema(): SchemaProps;\r\n  public abstract getReferences(): Iterable<SchemaReferenceProps>;\r\n\r\n  public abstract getItems(): Iterable<SchemaItemTuple<TItem>>;\r\n  public abstract findItem(itemName: string): SchemaItemTuple<TItem> | undefined;\r\n\r\n  public abstract parseEntityClass(data: Readonly<TItem>): EntityClassProps;\r\n  public abstract parseMixin(data: Readonly<TItem>): MixinProps;\r\n  public abstract parseStructClass(data: Readonly<TItem>): StructClassProps;\r\n  public abstract parseCustomAttributeClass(data: Readonly<TItem>): CustomAttributeClassProps;\r\n  public abstract parseRelationshipClass(data: Readonly<TItem>): RelationshipClassProps;\r\n  public abstract parseEnumeration(data: Readonly<TItem>): EnumerationProps;\r\n  public abstract parseKindOfQuantity(data: Readonly<TItem>): KindOfQuantityProps;\r\n  public abstract parsePropertyCategory(data: Readonly<TItem>): PropertyCategoryProps;\r\n  public abstract parseUnit(data: Readonly<TItem>): SchemaItemUnitProps;\r\n  public abstract parseInvertedUnit(data: Readonly<TItem>): InvertedUnitProps;\r\n  public abstract parseConstant(data: Readonly<TItem>): ConstantProps;\r\n  public abstract parsePhenomenon(data: Readonly<TItem>): PhenomenonProps;\r\n  public abstract parseFormat(data: Readonly<TItem>): SchemaItemFormatProps;\r\n  public abstract parseUnitSystem(data: Readonly<TItem>): UnitSystemProps;\r\n\r\n  public abstract getProperties(data: Readonly<TItem>, itemName: string): Iterable<PropertyTuple<TProperty>>;\r\n  public abstract parsePrimitiveProperty(data: Readonly<TProperty>): PrimitivePropertyProps;\r\n  public abstract parseStructProperty(data: Readonly<TProperty>): StructPropertyProps;\r\n  public abstract parsePrimitiveArrayProperty(data: Readonly<TProperty>): PrimitiveArrayPropertyProps;\r\n  public abstract parseStructArrayProperty(data: Readonly<TProperty>): StructArrayPropertyProps;\r\n  public abstract parseNavigationProperty(data: Readonly<TProperty>): NavigationPropertyProps;\r\n\r\n  public abstract getSchemaCustomAttributeProviders(): Iterable<CAProviderTuple>;\r\n  public abstract getClassCustomAttributeProviders(data: Readonly<TItem>): Iterable<CAProviderTuple>;\r\n  public abstract getPropertyCustomAttributeProviders(data: Readonly<TProperty>): Iterable<CAProviderTuple>;\r\n  public abstract getRelationshipConstraintCustomAttributeProviders(data: Readonly<TItem>): [Iterable<CAProviderTuple> /* source */, Iterable<CAProviderTuple> /* target */];\r\n  public abstract get getECSpecVersion(): ECSpecVersion | undefined;\r\n}\r\n\r\n/** @internal */\r\n// eslint-disable-next-line @typescript-eslint/prefer-function-type\r\nexport interface AbstractParserConstructor<TSchema, TItem = any, TProperty = TItem> { new(obj: Readonly<TSchema>): AbstractParser<TItem, TProperty> }\r\n"]}

package/lib/esm/Deserialization/Helper.d.ts

@@ -31,20 +31,20 @@ export declare class SchemaReadHelper<T = unknown> {
      * @param schema The Schema to populate
      * @param rawSchema The serialized data to use to populate the Schema.
      */
-    readSchemaInfo<U extends Schema>(schema: U, rawSchema: T): Promise<SchemaInfo>;
+    readSchemaInfo(schema: Schema, rawSchema: T): Promise<SchemaInfo>;
     /**
      * Populates the given Schema from a serialized representation.
      * @param schema The Schema to populate
      * @param rawSchema The serialized data to use to populate the Schema.
      */
-    readSchema<U extends Schema>(schema: U, rawSchema: T): Promise<U>;
+    readSchema(schema: Schema, rawSchema: T): Promise<Schema>;
     private loadSchema;
     /**
      * Populates the given Schema from a serialized representation.
      * @param schema The Schema to populate
      * @param rawSchema The serialized data to use to populate the Schema.
      */
-    readSchemaSync<U extends Schema>(schema: U, rawSchema: T): U;
+    readSchemaSync(schema: Schema, rawSchema: T): Schema;
     /**
      * Ensures that the schema references can be located and adds them to the schema.
      * @param ref The object to read the SchemaReference's props from.

package/lib/esm/Deserialization/Helper.d.ts.map

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

package/lib/esm/Deserialization/Helper.js

@@ -4,7 +4,7 @@
 *--------------------------------------------------------------------------------------------*/
 import { SchemaContext } from "../Context";
 import { parsePrimitiveType, parseSchemaItemType, SchemaItemType, SchemaMatchType } from "../ECObjects";
-import { ECObjectsError, ECObjectsStatus } from "../Exception";
+import { ECSchemaError, ECSchemaStatus } from "../Exception";
 import { Schema } from "../Metadata/Schema";
 import { SchemaItem } from "../Metadata/SchemaItem";
 import { ECVersion, SchemaItemKey, SchemaKey } from "../SchemaKey";
@@ -17,6 +17,14 @@ import { SchemaGraph } from "../utils/SchemaGraph";
  * @internal
  */
 export class SchemaReadHelper {
+    _context;
+    _visitorHelper;
+    _parserType;
+    _parser;
+    // Cache of the schema currently being loaded. This schema is in the _context but to
+    // avoid going back to the context every time, the cache is used.
+    _schema;
+    _schemaInfo;
     constructor(parserType, context, visitor) {
         this._context = (undefined !== context) ? context : new SchemaContext();
         this._visitorHelper = visitor ? new SchemaPartVisitorDelegate(visitor) : undefined;
@@ -33,7 +41,7 @@ export class SchemaReadHelper {
         // Ensure context matches schema context
         if (schema.context) {
             if (this._context !== schema.context)
-                throw new ECObjectsError(ECObjectsStatus.DifferentSchemaContexts, "The SchemaContext of the schema must be the same SchemaContext held by the SchemaReadHelper.");
+                throw new ECSchemaError(ECSchemaStatus.DifferentSchemaContexts, "The SchemaContext of the schema must be the same SchemaContext held by the SchemaReadHelper.");
         }
         else {
             schema.setContext(this._context);
@@ -42,10 +50,11 @@ export class SchemaReadHelper {
         // Loads all of the properties on the Schema object
         await schema.fromJSON(this._parser.parseSchema());
         this._schema = schema;
-        const schemaInfo = { schemaKey: schema.schemaKey, references: [] };
+        const schemaInfoReferences = [];
+        const schemaInfo = { schemaKey: schema.schemaKey, alias: schema.alias, references: schemaInfoReferences };
         for (const reference of this._parser.getReferences()) {
             const refKey = new SchemaKey(reference.name, ECVersion.fromString(reference.version));
-            schemaInfo.references.push({ schemaKey: refKey });
+            schemaInfoReferences.push({ schemaKey: refKey });
         }
         this._schemaInfo = schemaInfo;
         // Need to add this schema to the context to be able to locate schemaItems within the context.
@@ -65,7 +74,7 @@ export class SchemaReadHelper {
         }
         const cachedSchema = await this._context.getCachedSchema(this._schemaInfo.schemaKey, SchemaMatchType.Latest);
         if (undefined === cachedSchema)
-            throw new ECObjectsError(ECObjectsStatus.UnableToLoadSchema, `Could not load schema ${schema.schemaKey.toString()}`);
+            throw new ECSchemaError(ECSchemaStatus.UnableToLoadSchema, `Could not load schema ${schema.schemaKey.toString()}`);
         return cachedSchema;
     }
     /* Finish loading the rest of the schema */
@@ -136,7 +145,7 @@ export class SchemaReadHelper {
     async loadSchemaReference(schemaInfo, refKey) {
         const refSchema = await this._context.getSchema(refKey, SchemaMatchType.LatestWriteCompatible);
         if (undefined === refSchema)
-            throw new ECObjectsError(ECObjectsStatus.UnableToLocateSchema, `Could not locate the referenced schema, ${refKey.name}.${refKey.version.toString()}, of ${schemaInfo.schemaKey.name}`);
+            throw new ECSchemaError(ECSchemaStatus.UnableToLocateSchema, `Could not locate the referenced schema, ${refKey.name}.${refKey.version.toString()}, of ${schemaInfo.schemaKey.name}`);
         await this._schema.addReference(refSchema);
         const results = this.validateSchemaReferences(this._schema);
         let errorMessage = "";
@@ -144,7 +153,7 @@ export class SchemaReadHelper {
             errorMessage += `${result}\r\n`;
         }
         if (errorMessage) {
-            throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `${errorMessage}`);
+            throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `${errorMessage}`);
         }
     }
     /**
@@ -155,7 +164,7 @@ export class SchemaReadHelper {
         const schemaKey = new SchemaKey(ref.name, ECVersion.fromString(ref.version));
         const refSchema = this._context.getSchemaSync(schemaKey, SchemaMatchType.LatestWriteCompatible);
         if (!refSchema)
-            throw new ECObjectsError(ECObjectsStatus.UnableToLocateSchema, `Could not locate the referenced schema, ${ref.name}.${ref.version}, of ${this._schema.schemaKey.name}`);
+            throw new ECSchemaError(ECSchemaStatus.UnableToLocateSchema, `Could not locate the referenced schema, ${ref.name}.${ref.version}, of ${this._schema.schemaKey.name}`);
         this._schema.addReferenceSync(refSchema);
         SchemaGraph.generateGraphSync(this._schema).throwIfCycles();
         const results = this.validateSchemaReferences(this._schema);
@@ -164,7 +173,7 @@ export class SchemaReadHelper {
             errorMessage += `${result}\r\n`;
         }
         if (errorMessage) {
-            throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `${errorMessage}`);
+            throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `${errorMessage}`);
         }
     }
     /**
@@ -350,7 +359,7 @@ export class SchemaReadHelper {
         if (undefined !== schema && -1 !== fullOrQualifiedName.indexOf(":")) {
             const refName = schema.getReferenceNameByAlias(schemaName);
             if (undefined === refName)
-                throw new ECObjectsError(ECObjectsStatus.UnableToLocateSchema, `Could not resolve schema alias '${schemaName}' for schema item '${itemName}.`);
+                throw new ECSchemaError(ECSchemaStatus.UnableToLocateSchema, `Could not resolve schema alias '${schemaName}' for schema item '${itemName}.`);
             return [refName, itemName];
         }
         return [schemaName, itemName];
@@ -369,7 +378,7 @@ export class SchemaReadHelper {
         const [schemaName, itemName] = SchemaReadHelper.resolveSchemaAndItemName(name, this._schema);
         const isInThisSchema = (this._schema && this._schema.name.toLowerCase() === schemaName.toLowerCase());
         if (undefined === schemaName || 0 === schemaName.length)
-            throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The SchemaItem ${name} is invalid without a schema name`);
+            throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The SchemaItem ${name} is invalid without a schema name`);
         if (isInThisSchema) {
             schemaItem = await this._schema.getItem(itemName);
             if (schemaItem)
@@ -384,11 +393,11 @@ export class SchemaReadHelper {
                     loadCallBack(schemaItem);
                 return schemaItem;
             }
-            throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `Unable to locate SchemaItem ${name}.`);
+            throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `Unable to locate SchemaItem ${name}.`);
         }
         schemaItem = await this._context.getSchemaItem(new SchemaItemKey(itemName, new SchemaKey(schemaName)));
         if (undefined === schemaItem)
-            throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `Unable to locate SchemaItem ${name}.`);
+            throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `Unable to locate SchemaItem ${name}.`);
         return schemaItem;
     }
     /**
@@ -405,7 +414,7 @@ export class SchemaReadHelper {
         const [schemaName, itemName] = SchemaReadHelper.resolveSchemaAndItemName(name, this._schema);
         const isInThisSchema = (this._schema && this._schema.name.toLowerCase() === schemaName.toLowerCase());
         if (undefined === schemaName || schemaName.length === 0)
-            throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The SchemaItem ${name} is invalid without a schema name`);
+            throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The SchemaItem ${name} is invalid without a schema name`);
         if (isInThisSchema && undefined === this._schema.getItemSync(itemName)) {
             const foundItem = this._parser.findItem(itemName);
             if (foundItem) {
@@ -417,11 +426,11 @@ export class SchemaReadHelper {
                     loadCallBack(schemaItem);
                 return schemaItem;
             }
-            throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `Unable to locate SchemaItem ${name}.`);
+            throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `Unable to locate SchemaItem ${name}.`);
         }
         schemaItem = this._context.getSchemaItemSync(new SchemaItemKey(itemName, new SchemaKey(schemaName)));
         if (undefined === schemaItem)
-            throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `Unable to locate SchemaItem ${name}.`);
+            throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `Unable to locate SchemaItem ${name}.`);
         return schemaItem;
     }
     /**
@@ -725,16 +734,16 @@ export class SchemaReadHelper {
         const loadTypeName = async (typeName) => {
             if (undefined === parsePrimitiveType(typeName)) {
                 if (SchemaReadHelper.isECSpecVersionNewer(this._parser.getECSpecVersion))
-                    return ECObjectsStatus.NewerECSpecVersion;
+                    return ECSchemaStatus.NewerECSpecVersion;
                 await this.findSchemaItem(typeName);
             }
-            return ECObjectsStatus.Success;
+            return ECSchemaStatus.Success;
         };
         const lowerCasePropType = propType.toLowerCase();
         switch (lowerCasePropType) {
             case "primitiveproperty":
                 const primPropertyProps = this._parser.parsePrimitiveProperty(rawProperty);
-                if (await loadTypeName(primPropertyProps.typeName) === ECObjectsStatus.NewerECSpecVersion)
+                if (await loadTypeName(primPropertyProps.typeName) === ECSchemaStatus.NewerECSpecVersion)
                     primPropertyProps.typeName = "string";
                 const primProp = await classObj.createPrimitiveProperty(propName, primPropertyProps.typeName);
                 return this.loadProperty(primProp, primPropertyProps, rawProperty);
@@ -745,7 +754,7 @@ export class SchemaReadHelper {
                 return this.loadProperty(structProp, structPropertyProps, rawProperty);
             case "primitivearrayproperty":
                 const primArrPropertyProps = this._parser.parsePrimitiveArrayProperty(rawProperty);
-                if (await loadTypeName(primArrPropertyProps.typeName) === ECObjectsStatus.NewerECSpecVersion)
+                if (await loadTypeName(primArrPropertyProps.typeName) === ECSchemaStatus.NewerECSpecVersion)
                     primArrPropertyProps.typeName = "string";
                 const primArrProp = await classObj.createPrimitiveArrayProperty(propName, primArrPropertyProps.typeName);
                 return this.loadProperty(primArrProp, primArrPropertyProps, rawProperty);
@@ -756,7 +765,7 @@ export class SchemaReadHelper {
                 return this.loadProperty(structArrProp, structArrPropertyProps, rawProperty);
             case "navigationproperty":
                 if (classObj.schemaItemType !== SchemaItemType.EntityClass && classObj.schemaItemType !== SchemaItemType.RelationshipClass && classObj.schemaItemType !== SchemaItemType.Mixin)
-                    throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The Navigation Property ${classObj.name}.${propName} is invalid, because only EntityClasses, Mixins, and RelationshipClasses can have NavigationProperties.`);
+                    throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The Navigation Property ${classObj.name}.${propName} is invalid, because only EntityClasses, Mixins, and RelationshipClasses can have NavigationProperties.`);
                 const navPropertyProps = this._parser.parseNavigationProperty(rawProperty);
                 await this.findSchemaItem(navPropertyProps.relationshipName);
                 const navProp = await classObj.createNavigationProperty(propName, navPropertyProps.relationshipName, navPropertyProps.direction);
@@ -774,16 +783,16 @@ export class SchemaReadHelper {
         const loadTypeName = (typeName) => {
             if (undefined === parsePrimitiveType(typeName)) {
                 if (SchemaReadHelper.isECSpecVersionNewer(this._parser.getECSpecVersion))
-                    return ECObjectsStatus.NewerECSpecVersion;
+                    return ECSchemaStatus.NewerECSpecVersion;
                 this.findSchemaItemSync(typeName);
             }
-            return ECObjectsStatus.Success;
+            return ECSchemaStatus.Success;
         };
         const lowerCasePropType = propType.toLowerCase();
         switch (lowerCasePropType) {
             case "primitiveproperty":
                 const primPropertyProps = this._parser.parsePrimitiveProperty(rawProperty);
-                if (loadTypeName(primPropertyProps.typeName) === ECObjectsStatus.NewerECSpecVersion)
+                if (loadTypeName(primPropertyProps.typeName) === ECSchemaStatus.NewerECSpecVersion)
                     primPropertyProps.typeName = "string";
                 const primProp = classObj.createPrimitivePropertySync(propName, primPropertyProps.typeName);
                 return this.loadPropertySync(primProp, primPropertyProps, rawProperty);
@@ -794,7 +803,7 @@ export class SchemaReadHelper {
                 return this.loadPropertySync(structProp, structPropertyProps, rawProperty);
             case "primitivearrayproperty":
                 const primArrPropertyProps = this._parser.parsePrimitiveArrayProperty(rawProperty);
-                if (loadTypeName(primArrPropertyProps.typeName) === ECObjectsStatus.NewerECSpecVersion)
+                if (loadTypeName(primArrPropertyProps.typeName) === ECSchemaStatus.NewerECSpecVersion)
                     primArrPropertyProps.typeName = "string";
                 const primArrProp = classObj.createPrimitiveArrayPropertySync(propName, primArrPropertyProps.typeName);
                 return this.loadPropertySync(primArrProp, primArrPropertyProps, rawProperty);
@@ -805,7 +814,7 @@ export class SchemaReadHelper {
                 return this.loadPropertySync(structArrProp, structArrPropertyProps, rawProperty);
             case "navigationproperty":
                 if (classObj.schemaItemType !== SchemaItemType.EntityClass && classObj.schemaItemType !== SchemaItemType.RelationshipClass && classObj.schemaItemType !== SchemaItemType.Mixin)
-                    throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The Navigation Property ${classObj.name}.${propName} is invalid, because only EntityClasses, Mixins, and RelationshipClasses can have NavigationProperties.`);
+                    throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The Navigation Property ${classObj.name}.${propName} is invalid, because only EntityClasses, Mixins, and RelationshipClasses can have NavigationProperties.`);
                 const navPropertyProps = this._parser.parseNavigationProperty(rawProperty);
                 this.findSchemaItemSync(navPropertyProps.relationshipName);
                 const navProp = classObj.createNavigationPropertySync(propName, navPropertyProps.relationshipName, navPropertyProps.direction);
@@ -857,7 +866,7 @@ export class SchemaReadHelper {
             // If custom attribute exist within the context and is referenced, validate the reference is defined in the container's schema
             if (caClass && caClass.key.schemaName !== container.schema.name &&
                 !container.schema.getReferenceSync(caClass.key.schemaName)) {
-                throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `Unable to load custom attribute ${caClass.fullName} from container ${container.fullName}, ${caClass.key.schemaName} reference not defined`);
+                throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `Unable to load custom attribute ${caClass.fullName} from container ${container.fullName}, ${caClass.key.schemaName} reference not defined`);
             }
             // Second tuple entry ia a function that provides the CA instance.
             const provider = providerTuple[1];