@itwin/core-backend 3.0.0-dev.100

package/lib/cjs/ClassRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassRegistry.js","sourceRoot":"","sources":["../../src/ClassRegistry.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,sDAA2D;AAC3D,oDAAiE;AACjE,qCAAkC;AAElC,qCAA2C;AAC3C,6DAA0D;AAE1D;;GAEG;AACH,MAAa,aAAa;IAExB,gBAAgB;IACT,MAAM,CAAC,eAAe,CAAC,GAAQ,IAAI,OAAO,CAAC,GAAG,YAAY,yBAAW,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,KAAK,2BAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC/H,gBAAgB;IACT,MAAM,CAAC,yBAAyB,CAAC,SAAiB,IAAiB,OAAO,IAAI,yBAAW,CAAC,2BAAY,CAAC,QAAQ,EAAE,0BAA0B,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IACjK,gBAAgB;IACT,MAAM,CAAC,QAAQ,CAAC,WAA0B,EAAE,MAAqB;QACtE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC;QAC5B,MAAM,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5E,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YAC3B,MAAM,MAAM,GAAG,SAAS,GAAG,4FAA4F,WAAW,CAAC,IAAI,EAAE,CAAC;YAC1I,qBAAM,CAAC,QAAQ,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;SACzB;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACvC,CAAC;IAED,yEAAyE;IACjE,MAAM,CAAC,mBAAmB,CAAC,MAAc,EAAE,MAAgB;;QACjE,MAAM,WAAW,GAAG,SAAS,MAAK,MAAA,IAAI,uCAAkB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,gBAAgB,0CAAE,GAAG,CAAC,2BAA2B,CAAC,CAAA,CAAC;QACtI,MAAM,WAAW,GAAG,KAAM,SAAQ,eAAM;YAC/B,MAAM,KAAc,UAAU,KAAK,OAAO,MAAM,CAAC,CAAC,CAAC;YACnD,MAAM,KAAc,uBAAuB,KAAK,OAAO,WAAW,CAAC,CAAC,CAAC;SAC7E,CAAC;QAEF,gBAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,0CAA0C;QAC/E,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,sBAAsB,CAAC,cAA8B,EAAE,MAAgB;QACpF,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAE1B,IAAI,CAAC,KAAK,cAAc,CAAC,WAAW,CAAC,MAAM,EAAE,qCAAqC;YAChF,MAAM,IAAI,yBAAW,CAAC,2BAAY,CAAC,MAAM,EAAE,SAAS,IAAI,oBAAoB,CAAC,CAAC;QAEhF,0BAA0B;QAC1B,IAAI,MAAM,GAAG,gBAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,SAAS,KAAK,MAAM;YACtB,MAAM,GAAG,IAAI,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,iCAAiC;QAE1F,yFAAyF;QACzF,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACnF,IAAI,SAAS,KAAK,UAAU;YAC1B,MAAM,IAAI,yBAAW,CAAC,2BAAY,CAAC,QAAQ,EAAE,oCAAoC,IAAI,EAAE,CAAC,CAAC;QAE3F,MAAM,cAAc,GAAG,KAAM,SAAQ,UAAU;YAAU,MAAM,KAAc,SAAS,KAAK,OAAO,SAAS,CAAC,CAAC,CAAC;SAAE,CAAC;QACjH,yIAAyI;QACzI,MAAM,CAAC,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAE,2DAA2D;QAErI,qGAAqG;QACrG,IAAI,MAAM,CAAC,uBAAuB,EAAE;YAClC,MAAM,UAAU,GAAG,GAAG,EAAE,GAAG,MAAM,IAAI,yBAAW,CAAC,2BAAY,CAAC,YAAY,EAAE,WAAW,UAAU,wDAAwD,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9J,UAAU,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAAE,cAAsB,CAAC,SAAS,CAAC,GAAG,UAAU,CAAC,CAAC;SACxG;QAED,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,+BAA+B;QACtE,OAAO,cAAc,CAAC;IACxB,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,cAAc,CAAC,SAAc,EAAE,MAAqB;QAChE,KAAK,MAAM,UAAU,IAAI,SAAS,EAAE,EAAE,mCAAmC;YACvE,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;YACxC,IAAI,SAAS,CAAC,SAAS,YAAY,eAAM;gBACvC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;SACpC;IACH,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,aAAa,CAAC,aAAqB,EAAE,MAAgB;QAClE,MAAM,QAAQ,GAA+B,MAAM,CAAC,qBAAqB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC9F,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS;YAC1D,MAAM,IAAI,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC;QAEtD,iDAAiD;QACjD,IAAI,QAAQ,CAAC,WAAW,IAAI,CAAC,CAAC,KAAK,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC;YAC7D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAEjD,mDAAmD;QACnD,OAAO,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,mBAAmB,CAAC,aAAqB;QACrD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,QAAQ,CAAC,aAAqB,EAAE,MAAgB;QAC5D,MAAM,GAAG,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,eAAe,CAAC,aAAqB,IAAI,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;IACnH;;;;OAIG;IACI,MAAM,CAAC,qBAAqB,CAAC,MAAqB;QACvD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE;YAC9C,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM;gBAC5B,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;SAClC;IACH,CAAC;;AApIH,sCAqIC;AApIyB,uBAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;AAsIvE;;;GAGG;AACH,MAAa,gBAAgB;IAA7B;QACU,cAAS,GAAgC,IAAI,GAAG,EAA0B,CAAC;IAOrF,CAAC;IALC,wCAAwC;IACjC,IAAI,CAAC,aAAqB,IAAgC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;IAE1H,gCAAgC;IACzB,GAAG,CAAC,aAAqB,EAAE,QAAwB,IAAU,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;CACjI;AARD,4CAQC","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 Schema\r\n */\r\n\r\nimport { IModelStatus, Logger } from \"@itwin/core-bentley\";\r\nimport { EntityMetaData, IModelError } from \"@itwin/core-common\";\r\nimport { Entity } from \"./Entity\";\r\nimport { IModelDb } from \"./IModelDb\";\r\nimport { Schema, Schemas } from \"./Schema\";\r\nimport { IModelSchemaLoader } from \"./IModelSchemaLoader\";\r\n\r\n/** The mapping between a BIS class name (in the form \"schema:class\") and its JavaScript constructor function\r\n * @public\r\n */\r\nexport class ClassRegistry {\r\n  private static readonly _classMap = new Map<string, typeof Entity>();\r\n  /** @internal */\r\n  public static isNotFoundError(err: any) { return (err instanceof IModelError) && (err.errorNumber === IModelStatus.NotFound); }\r\n  /** @internal */\r\n  public static makeMetaDataNotFoundError(className: string): IModelError { return new IModelError(IModelStatus.NotFound, `metadata not found for ${className}`); }\r\n  /** @internal */\r\n  public static register(entityClass: typeof Entity, schema: typeof Schema) {\r\n    entityClass.schema = schema;\r\n    const key = (`${schema.schemaName}:${entityClass.className}`).toLowerCase();\r\n    if (this._classMap.has(key)) {\r\n      const errMsg = `Class ${key} is already registered. Make sure static className member is correct on JavaScript class ${entityClass.name}`;\r\n      Logger.logError(\"core-frontend.classRegistry\", errMsg);\r\n      throw new Error(errMsg);\r\n    }\r\n\r\n    this._classMap.set(key, entityClass);\r\n  }\r\n\r\n  /** Generate a proxy Schema for a domain that has not been registered. */\r\n  private static generateProxySchema(domain: string, iModel: IModelDb): typeof Schema {\r\n    const hasBehavior = undefined !== new IModelSchemaLoader(iModel).getSchema(domain).customAttributes?.get(\"BisCore.SchemaHasBehavior\");\r\n    const schemaClass = class extends Schema {\r\n      public static override get schemaName() { return domain; }\r\n      public static override get missingRequiredBehavior() { return hasBehavior; }\r\n    };\r\n\r\n    Schemas.registerSchema(schemaClass); // register the class before we return it.\r\n    return schemaClass;\r\n  }\r\n\r\n  /** Generate a JavaScript class from Entity metadata.\r\n   * @param entityMetaData The Entity metadata that defines the class\r\n   */\r\n  private static generateClassForEntity(entityMetaData: EntityMetaData, iModel: IModelDb): typeof Entity {\r\n    const name = entityMetaData.ecclass.split(\":\");\r\n    const domainName = name[0];\r\n    const className = name[1];\r\n\r\n    if (0 === entityMetaData.baseClasses.length) // metadata must contain a superclass\r\n      throw new IModelError(IModelStatus.BadArg, `class ${name} has no superclass`);\r\n\r\n    // make sure schema exists\r\n    let schema = Schemas.getRegisteredSchema(domainName);\r\n    if (undefined === schema)\r\n      schema = this.generateProxySchema(domainName, iModel); // no schema found, create it too\r\n\r\n    // this method relies on the caller having previously created/registered all superclasses\r\n    const superclass = this._classMap.get(entityMetaData.baseClasses[0].toLowerCase());\r\n    if (undefined === superclass)\r\n      throw new IModelError(IModelStatus.NotFound, `cannot find superclass for class ${name}`);\r\n\r\n    const generatedClass = class extends superclass { public static override get className() { return className; } };\r\n    // the above line creates an anonymous class. For help debugging, set the \"constructor.name\" property to be the same as the bisClassName.\r\n    Object.defineProperty(generatedClass, \"name\", { get: () => className });  // this is the (only) way to change that readonly property.\r\n\r\n    // if the schema is a proxy for a domain with behavior, throw exceptions for all protected operations\r\n    if (schema.missingRequiredBehavior) {\r\n      const throwError = () => { throw new IModelError(IModelStatus.WrongHandler, `Schema [${domainName}] not registered, but is marked with SchemaHasBehavior`); };\r\n      superclass.protectedOperations.forEach((operation) => (generatedClass as any)[operation] = throwError);\r\n    }\r\n\r\n    this.register(generatedClass, schema); // register it before returning\r\n    return generatedClass;\r\n  }\r\n\r\n  /** Register all of the classes found in the given module that derive from Entity. See the example in [[Schema]]\r\n   * @param moduleObj The module to search for subclasses of Entity\r\n   * @param schema The schema for all found classes\r\n   */\r\n  public static registerModule(moduleObj: any, schema: typeof Schema) {\r\n    for (const thisMember in moduleObj) { // eslint-disable-line guard-for-in\r\n      const thisClass = moduleObj[thisMember];\r\n      if (thisClass.prototype instanceof Entity)\r\n        this.register(thisClass, schema);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * This function fetches the specified Entity from the imodel, generates a JavaScript class for it, and registers the generated\r\n   * class. This function also ensures that all of the base classes of the Entity exist and are registered.\r\n   */\r\n  private static generateClass(classFullName: string, iModel: IModelDb): typeof Entity {\r\n    const metadata: EntityMetaData | undefined = iModel.classMetaDataRegistry.find(classFullName);\r\n    if (metadata === undefined || metadata.ecclass === undefined)\r\n      throw this.makeMetaDataNotFoundError(classFullName);\r\n\r\n    // Make sure we have all base classes registered.\r\n    if (metadata.baseClasses && (0 !== metadata.baseClasses.length))\r\n      this.getClass(metadata.baseClasses[0], iModel);\r\n\r\n    // Now we can generate the class from the classDef.\r\n    return this.generateClassForEntity(metadata, iModel);\r\n  }\r\n\r\n  /** Find a registered class by classFullName.\r\n   * @param classFullName class to find\r\n   * @param iModel The IModel that contains the class definitions\r\n   * @returns The Entity class or undefined\r\n   */\r\n  public static findRegisteredClass(classFullName: string): typeof Entity | undefined {\r\n    return this._classMap.get(classFullName.toLowerCase());\r\n  }\r\n\r\n  /** Get the Entity class for the specified Entity className.\r\n   * @param classFullName The full BIS class name of the Entity\r\n   * @param iModel The IModel that contains the class definitions\r\n   * @returns The Entity class\r\n   */\r\n  public static getClass(classFullName: string, iModel: IModelDb): typeof Entity {\r\n    const key = classFullName.toLowerCase();\r\n    const ctor = this._classMap.get(key);\r\n    return ctor ? ctor : this.generateClass(key, iModel);\r\n  }\r\n\r\n  /** Unregister a class, by name, if one is already registered.\r\n   * This function is not normally needed, but is useful for cases where a generated *proxy* class needs to be replaced by the *real* class.\r\n   * @param classFullName Name of the class to unregister\r\n   * @return true if the class was unregistered\r\n   * @internal\r\n   */\r\n  public static unregisterCLass(classFullName: string) { return this._classMap.delete(classFullName.toLowerCase()); }\r\n  /** Unregister all classes from a schema.\r\n   * This function is not normally needed, but is useful for cases where a generated *proxy* schema needs to be replaced by the *real* schema.\r\n   * @param schema Name of the schema to unregister\r\n   * @internal\r\n   */\r\n  public static unregisterClassesFrom(schema: typeof Schema) {\r\n    for (const entry of Array.from(this._classMap)) {\r\n      if (entry[1].schema === schema)\r\n        this.unregisterCLass(entry[0]);\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * A cache that records the mapping between class names and class metadata\r\n * @internal\r\n */\r\nexport class MetaDataRegistry {\r\n  private _registry: Map<string, EntityMetaData> = new Map<string, EntityMetaData>();\r\n\r\n  /** Get the specified Entity metadata */\r\n  public find(classFullName: string): EntityMetaData | undefined { return this._registry.get(classFullName.toLowerCase()); }\r\n\r\n  /** Add metadata to the cache */\r\n  public add(classFullName: string, metaData: EntityMetaData): void { this._registry.set(classFullName.toLowerCase(), metaData); }\r\n}\r\n"]}

package/lib/cjs/CloudStorageBackend.d.ts

@@ -0,0 +1,46 @@
+/// <reference types="node" />
+import { Readable } from "stream";
+import { CloudStorageContainerDescriptor, CloudStorageContainerUrl, CloudStorageProvider, IModelRpcProps } from "@itwin/core-common";
+/** @beta */
+export interface CloudStorageServiceCredentials {
+    service: "azure" | "alicloud" | "external";
+    account: string;
+    accessKey: string;
+}
+/** @beta */
+export interface CloudStorageUploadOptions {
+    type?: string;
+    cacheControl?: string;
+    contentEncoding?: "gzip";
+}
+/** @beta */
+export declare abstract class CloudStorageService {
+    initialize(): void;
+    terminate(): void;
+    abstract id: CloudStorageProvider;
+    abstract obtainContainerUrl(id: CloudStorageContainerDescriptor, expiry: Date, clientIp?: string): CloudStorageContainerUrl;
+    abstract upload(container: string, name: string, data: Uint8Array, options?: CloudStorageUploadOptions, metadata?: object): Promise<string>;
+    download(_name: string): Promise<Readable | undefined>;
+    protected makeDescriptor(id: CloudStorageContainerDescriptor): {
+        name: string;
+        provider: CloudStorageProvider;
+    };
+}
+/** @beta */
+export declare class AzureBlobStorage extends CloudStorageService {
+    private _service;
+    private _credential;
+    constructor(credentials: CloudStorageServiceCredentials);
+    readonly id = CloudStorageProvider.Azure;
+    obtainContainerUrl(id: CloudStorageContainerDescriptor, expiry: Date, clientIp?: string): CloudStorageContainerUrl;
+    ensureContainer(name: string): Promise<void>;
+    upload(container: string, name: string, data: Uint8Array, options?: CloudStorageUploadOptions, metadata?: object): Promise<string>;
+}
+/** @internal */
+export declare class CloudStorageTileUploader {
+    private _activeUploads;
+    get activeUploads(): Iterable<Promise<void>>;
+    private uploadToCache;
+    cacheTile(tokenProps: IModelRpcProps, treeId: string, contentId: string, content: Uint8Array, guid: string | undefined, metadata?: object): Promise<void>;
+}
+//# sourceMappingURL=CloudStorageBackend.d.ts.map

package/lib/cjs/CloudStorageBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudStorageBackend.d.ts","sourceRoot":"","sources":["../../src/CloudStorageBackend.ts"],"names":[],"mappings":";AAIA,OAAO,EAAe,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAI/C,OAAO,EACU,+BAA+B,EAAE,wBAAwB,EAAE,oBAAoB,EAAsC,cAAc,EAEnJ,MAAM,oBAAoB,CAAC;AAI5B,YAAY;AACZ,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,YAAY;AACZ,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,YAAY;AACZ,8BAAsB,mBAAmB;IAChC,UAAU,IAAI,IAAI;IAClB,SAAS,IAAI,IAAI;IACxB,SAAgB,EAAE,EAAE,oBAAoB,CAAC;aACzB,kBAAkB,CAAC,EAAE,EAAE,+BAA+B,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,wBAAwB;aAClH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,yBAAyB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACrI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAEnE,SAAS,CAAC,cAAc,CAAC,EAAE,EAAE,+BAA+B;;;;CAG7D;AAED,YAAY;AACZ,qBAAa,gBAAiB,SAAQ,mBAAmB;IACvD,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,WAAW,CAAmC;gBAEnC,WAAW,EAAE,8BAA8B;IAa9D,SAAgB,EAAE,8BAA8B;IAEzC,kBAAkB,CAAC,EAAE,EAAE,+BAA+B,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,wBAAwB;IAuB5G,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB5C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,yBAAyB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA4ChJ;AAED,gBAAgB;AAChB,qBAAa,wBAAwB;IACnC,OAAO,CAAC,cAAc,CAAyC;IAE/D,IAAW,aAAa,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAElD;YAEa,aAAa;IAoBd,SAAS,CAAC,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAevK"}

package/lib/cjs/CloudStorageBackend.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudStorageTileUploader = exports.AzureBlobStorage = exports.CloudStorageService = void 0;
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+const stream_1 = require("stream");
+const zlib = require("zlib");
+const Azure = require("@azure/storage-blob");
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_common_1 = require("@itwin/core-common");
+const BackendLoggerCategory_1 = require("./BackendLoggerCategory");
+const IModelHost_1 = require("./IModelHost");
+/** @beta */
+class CloudStorageService {
+    initialize() { }
+    terminate() { }
+    async download(_name) { return undefined; }
+    makeDescriptor(id) {
+        return { name: id.name, provider: this.id };
+    }
+}
+exports.CloudStorageService = CloudStorageService;
+/** @beta */
+class AzureBlobStorage extends CloudStorageService {
+    constructor(credentials) {
+        super();
+        this.id = core_common_1.CloudStorageProvider.Azure;
+        if (credentials.service !== "azure" || !credentials.account || !credentials.accessKey) {
+            throw new core_common_1.IModelError(core_common_1.BentleyStatus.ERROR, "Invalid credentials for Azure blob storage.");
+        }
+        this._credential = new Azure.StorageSharedKeyCredential(credentials.account, credentials.accessKey);
+        const options = {};
+        const pipeline = Azure.newPipeline(this._credential, options);
+        this._service = new Azure.BlobServiceClient(`https://${credentials.account}.blob.core.windows.net`, pipeline);
+    }
+    obtainContainerUrl(id, expiry, clientIp) {
+        const policy = {
+            containerName: id.name,
+            permissions: Azure.ContainerSASPermissions.parse("rl"),
+            expiresOn: expiry,
+        };
+        if (clientIp && clientIp !== "localhost" && clientIp !== "127.0.0.1" && clientIp !== "::1") {
+            policy.ipRange = { start: clientIp };
+        }
+        const token = Azure.generateBlobSASQueryParameters(policy, this._credential);
+        const url = {
+            descriptor: this.makeDescriptor(id),
+            valid: 0,
+            expires: expiry.getTime(),
+            url: `https://${this._credential.accountName}.blob.core.windows.net/${id.name}?${token.toString()}`,
+        };
+        return url;
+    }
+    async ensureContainer(name) {
+        try {
+            const container = this._service.getContainerClient(name);
+            await container.create();
+            return;
+        }
+        catch (maybeErr) {
+            try {
+                const err = maybeErr;
+                if (err.statusCode === 409 && err.code === "ContainerAlreadyExists") {
+                    return;
+                }
+            }
+            catch { }
+            if (typeof (maybeErr) !== "undefined" && maybeErr) {
+                throw maybeErr;
+            }
+            throw new core_common_1.IModelError(core_common_1.BentleyStatus.ERROR, `Unable to create container "${name}".`);
+        }
+    }
+    async upload(container, name, data, options, metadata) {
+        var _a, _b, _c;
+        try {
+            await this.ensureContainer(container);
+            const containerClient = this._service.getContainerClient(container);
+            const blocks = containerClient.getBlockBlobClient(name);
+            const blobHTTPHeaders = {
+                blobContentType: (_a = options === null || options === void 0 ? void 0 : options.type) !== null && _a !== void 0 ? _a : "application/octet-stream",
+                blobCacheControl: (_b = options === null || options === void 0 ? void 0 : options.cacheControl) !== null && _b !== void 0 ? _b : "private, max-age=31536000, immutable",
+            };
+            const blobOptions = metadata ?
+                {
+                    blobHTTPHeaders,
+                    metadata: { ...metadata },
+                } : {
+                blobHTTPHeaders,
+            };
+            const dataStream = new stream_1.PassThrough();
+            dataStream.end(data);
+            let source;
+            if (options && options.contentEncoding === "gzip") {
+                blobOptions.blobHTTPHeaders.blobContentEncoding = options.contentEncoding;
+                const compressor = zlib.createGzip();
+                source = dataStream.pipe(compressor);
+            }
+            else {
+                source = dataStream;
+            }
+            const blockSize = 100 * 1024 * 1024;
+            const concurrency = 1;
+            const result = await blocks.uploadStream(source, blockSize, concurrency, blobOptions);
+            return (_c = result.etag) !== null && _c !== void 0 ? _c : "";
+        }
+        catch (maybeErr) {
+            if (typeof (maybeErr) !== "undefined" && maybeErr) {
+                throw maybeErr;
+            }
+            throw new core_common_1.IModelError(core_common_1.BentleyStatus.ERROR, `Unable to upload "${name}".`);
+        }
+    }
+}
+exports.AzureBlobStorage = AzureBlobStorage;
+/** @internal */
+class CloudStorageTileUploader {
+    constructor() {
+        this._activeUploads = new Map();
+    }
+    get activeUploads() {
+        return this._activeUploads.values();
+    }
+    async uploadToCache(id, content, containerKey, resourceKey, metadata) {
+        await new Promise((resolve) => setTimeout(resolve));
+        try {
+            const options = {};
+            if (IModelHost_1.IModelHost.compressCachedTiles) {
+                options.contentEncoding = "gzip";
+            }
+            const perfInfo = { ...id.tokenProps, treeId: id.treeId, contentId: id.contentId, size: content.byteLength, compress: IModelHost_1.IModelHost.compressCachedTiles };
+            const perfLogger = new core_bentley_1.PerfLogger("Uploading tile to external tile cache", () => perfInfo);
+            await IModelHost_1.IModelHost.tileCacheService.upload(containerKey, resourceKey, content, options, metadata);
+            perfLogger.dispose();
+        }
+        catch (err) {
+            core_bentley_1.Logger.logError(BackendLoggerCategory_1.BackendLoggerCategory.IModelTileUpload, (err instanceof Error) ? err.toString() : JSON.stringify(err));
+        }
+        this._activeUploads.delete(containerKey + resourceKey);
+    }
+    async cacheTile(tokenProps, treeId, contentId, content, guid, metadata) {
+        const id = { tokenProps, treeId, contentId, guid };
+        const cache = core_common_1.CloudStorageTileCache.getCache();
+        const containerKey = cache.formContainerName(id);
+        const resourceKey = cache.formResourceName(id);
+        const key = containerKey + resourceKey;
+        if (this._activeUploads.has(key))
+            return;
+        const promise = this.uploadToCache(id, content, containerKey, resourceKey, metadata);
+        this._activeUploads.set(key, promise);
+        await promise;
+    }
+}
+exports.CloudStorageTileUploader = CloudStorageTileUploader;
+//# sourceMappingURL=CloudStorageBackend.js.map

package/lib/cjs/CloudStorageBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudStorageBackend.js","sourceRoot":"","sources":["../../src/CloudStorageBackend.ts"],"names":[],"mappings":"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","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\nimport { PassThrough, Readable } from \"stream\";\r\nimport * as zlib from \"zlib\";\r\nimport * as Azure from \"@azure/storage-blob\";\r\nimport { Logger, PerfLogger } from \"@itwin/core-bentley\";\r\nimport {\r\n  BentleyStatus, CloudStorageContainerDescriptor, CloudStorageContainerUrl, CloudStorageProvider, CloudStorageTileCache, IModelError, IModelRpcProps,\r\n  TileContentIdentifier,\r\n} from \"@itwin/core-common\";\r\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\r\nimport { IModelHost } from \"./IModelHost\";\r\n\r\n/** @beta */\r\nexport interface CloudStorageServiceCredentials {\r\n  service: \"azure\" | \"alicloud\" | \"external\";\r\n  account: string;\r\n  accessKey: string;\r\n}\r\n\r\n/** @beta */\r\nexport interface CloudStorageUploadOptions {\r\n  type?: string;\r\n  cacheControl?: string;\r\n  contentEncoding?: \"gzip\";\r\n}\r\n\r\n/** @beta */\r\nexport abstract class CloudStorageService {\r\n  public initialize(): void { }\r\n  public terminate(): void { }\r\n  public abstract id: CloudStorageProvider;\r\n  public abstract obtainContainerUrl(id: CloudStorageContainerDescriptor, expiry: Date, clientIp?: string): CloudStorageContainerUrl;\r\n  public abstract upload(container: string, name: string, data: Uint8Array, options?: CloudStorageUploadOptions, metadata?: object): Promise<string>;\r\n  public async download(_name: string): Promise<Readable | undefined> { return undefined; }\r\n\r\n  protected makeDescriptor(id: CloudStorageContainerDescriptor) {\r\n    return { name: id.name, provider: this.id };\r\n  }\r\n}\r\n\r\n/** @beta */\r\nexport class AzureBlobStorage extends CloudStorageService {\r\n  private _service: Azure.BlobServiceClient;\r\n  private _credential: Azure.StorageSharedKeyCredential;\r\n\r\n  public constructor(credentials: CloudStorageServiceCredentials) {\r\n    super();\r\n\r\n    if (credentials.service !== \"azure\" || !credentials.account || !credentials.accessKey) {\r\n      throw new IModelError(BentleyStatus.ERROR, \"Invalid credentials for Azure blob storage.\");\r\n    }\r\n\r\n    this._credential = new Azure.StorageSharedKeyCredential(credentials.account, credentials.accessKey);\r\n    const options: Azure.StoragePipelineOptions = {};\r\n    const pipeline = Azure.newPipeline(this._credential, options);\r\n    this._service = new Azure.BlobServiceClient(`https://${credentials.account}.blob.core.windows.net`, pipeline);\r\n  }\r\n\r\n  public readonly id = CloudStorageProvider.Azure;\r\n\r\n  public obtainContainerUrl(id: CloudStorageContainerDescriptor, expiry: Date, clientIp?: string): CloudStorageContainerUrl {\r\n    const policy: Azure.BlobSASSignatureValues = {\r\n      containerName: id.name,\r\n      permissions: Azure.ContainerSASPermissions.parse(\"rl\"),\r\n      expiresOn: expiry,\r\n    };\r\n\r\n    if (clientIp && clientIp !== \"localhost\" && clientIp !== \"127.0.0.1\" && clientIp !== \"::1\") {\r\n      policy.ipRange = { start: clientIp };\r\n    }\r\n\r\n    const token = Azure.generateBlobSASQueryParameters(policy, this._credential);\r\n\r\n    const url: CloudStorageContainerUrl = {\r\n      descriptor: this.makeDescriptor(id),\r\n      valid: 0,\r\n      expires: expiry.getTime(),\r\n      url: `https://${this._credential.accountName}.blob.core.windows.net/${id.name}?${token.toString()}`,\r\n    };\r\n\r\n    return url;\r\n  }\r\n\r\n  public async ensureContainer(name: string): Promise<void> {\r\n    try {\r\n      const container = this._service.getContainerClient(name);\r\n      await container.create();\r\n      return;\r\n    } catch (maybeErr) {\r\n      try {\r\n        const err = maybeErr as Azure.RestError;\r\n        if (err.statusCode === 409 && err.code === \"ContainerAlreadyExists\") {\r\n          return;\r\n        }\r\n      } catch { }\r\n\r\n      if (typeof (maybeErr) !== \"undefined\" && maybeErr) {\r\n        throw maybeErr;\r\n      }\r\n\r\n      throw new IModelError(BentleyStatus.ERROR, `Unable to create container \"${name}\".`);\r\n    }\r\n  }\r\n\r\n  public async upload(container: string, name: string, data: Uint8Array, options?: CloudStorageUploadOptions, metadata?: object): Promise<string> {\r\n    try {\r\n      await this.ensureContainer(container);\r\n\r\n      const containerClient = this._service.getContainerClient(container);\r\n      const blocks = containerClient.getBlockBlobClient(name);\r\n      const blobHTTPHeaders = {\r\n        blobContentType: options?.type ?? \"application/octet-stream\",\r\n        blobCacheControl: options?.cacheControl ?? \"private, max-age=31536000, immutable\",\r\n      };\r\n\r\n      const blobOptions: Azure.BlockBlobUploadStreamOptions = metadata ?\r\n        {\r\n          blobHTTPHeaders,\r\n          metadata: { ...metadata },\r\n        } : {\r\n          blobHTTPHeaders,\r\n        };\r\n\r\n      const dataStream = new PassThrough();\r\n      dataStream.end(data);\r\n\r\n      let source: Readable;\r\n\r\n      if (options && options.contentEncoding === \"gzip\") {\r\n        blobOptions.blobHTTPHeaders!.blobContentEncoding = options.contentEncoding;\r\n        const compressor = zlib.createGzip();\r\n        source = dataStream.pipe(compressor);\r\n      } else {\r\n        source = dataStream;\r\n      }\r\n\r\n      const blockSize = 100 * 1024 * 1024;\r\n      const concurrency = 1;\r\n      const result = await blocks.uploadStream(source, blockSize, concurrency, blobOptions);\r\n      return result.etag ?? \"\";\r\n    } catch (maybeErr) {\r\n      if (typeof (maybeErr) !== \"undefined\" && maybeErr) {\r\n        throw maybeErr;\r\n      }\r\n\r\n      throw new IModelError(BentleyStatus.ERROR, `Unable to upload \"${name}\".`);\r\n    }\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport class CloudStorageTileUploader {\r\n  private _activeUploads: Map<string, Promise<void>> = new Map();\r\n\r\n  public get activeUploads(): Iterable<Promise<void>> {\r\n    return this._activeUploads.values();\r\n  }\r\n\r\n  private async uploadToCache(id: TileContentIdentifier, content: Uint8Array, containerKey: string, resourceKey: string, metadata?: object,) {\r\n    await new Promise((resolve) => setTimeout(resolve));\r\n\r\n    try {\r\n      const options: CloudStorageUploadOptions = {};\r\n      if (IModelHost.compressCachedTiles) {\r\n        options.contentEncoding = \"gzip\";\r\n      }\r\n\r\n      const perfInfo = { ...id.tokenProps, treeId: id.treeId, contentId: id.contentId, size: content.byteLength, compress: IModelHost.compressCachedTiles };\r\n      const perfLogger = new PerfLogger(\"Uploading tile to external tile cache\", () => perfInfo);\r\n      await IModelHost.tileCacheService.upload(containerKey, resourceKey, content, options, metadata);\r\n      perfLogger.dispose();\r\n    } catch (err) {\r\n      Logger.logError(BackendLoggerCategory.IModelTileUpload, (err instanceof Error) ? err.toString() : JSON.stringify(err));\r\n    }\r\n\r\n    this._activeUploads.delete(containerKey + resourceKey);\r\n  }\r\n\r\n  public async cacheTile(tokenProps: IModelRpcProps, treeId: string, contentId: string, content: Uint8Array, guid: string | undefined, metadata?: object): Promise<void> {\r\n    const id: TileContentIdentifier = { tokenProps, treeId, contentId, guid };\r\n\r\n    const cache = CloudStorageTileCache.getCache();\r\n    const containerKey = cache.formContainerName(id);\r\n    const resourceKey = cache.formResourceName(id);\r\n    const key = containerKey + resourceKey;\r\n\r\n    if (this._activeUploads.has(key))\r\n      return;\r\n\r\n    const promise = this.uploadToCache(id, content, containerKey, resourceKey, metadata);\r\n    this._activeUploads.set(key, promise);\r\n    await promise;\r\n  }\r\n}\r\n"]}

package/lib/cjs/CodeSpecs.d.ts

@@ -0,0 +1,51 @@
+/** @packageDocumentation
+ * @module Codes
+ */
+import { Id64String } from "@itwin/core-bentley";
+import { CodeScopeSpec, CodeSpec } from "@itwin/core-common";
+import { IModelDb } from "./IModelDb";
+/** Manages [CodeSpecs]($docs/BIS/intro/element-fundamentals.md#codespec) within an [[IModelDb]]
+ * @public
+ */
+export declare class CodeSpecs {
+    private _imodel;
+    private _loadedCodeSpecs;
+    constructor(imodel: IModelDb);
+    /** Look up the Id of the CodeSpec with the specified name. */
+    queryId(name: string): Id64String;
+    /** Look up a CodeSpec by Id. The CodeSpec will be loaded from the database if necessary.
+     * @param codeSpecId The Id of the CodeSpec to load
+     * @returns The CodeSpec with the specified Id
+     * @throws [[IModelError]] if the Id is invalid or if no CodeSpec with that Id could be found.
+     */
+    getById(codeSpecId: Id64String): CodeSpec;
+    /** Returns true if the IModelDb has a CodeSpec of the specified Id. */
+    hasId(codeSpecId: Id64String): boolean;
+    /** Look up a CodeSpec by name. The CodeSpec will be loaded from the database if necessary.
+     * @param name The name of the CodeSpec to load
+     * @returns The CodeSpec with the specified name
+     * @throws [[IModelError]] if no CodeSpec with the specified name could be found.
+     */
+    getByName(name: string): CodeSpec;
+    /** Returns true if the IModelDb has a CodeSpec of the specified name. */
+    hasName(name: string): boolean;
+    /** Add a new CodeSpec to the iModel.
+     * @param codeSpec The CodeSpec to insert
+     * @returns The Id of the persistent CodeSpec.
+     * @note If successful, this method will assign a valid CodeSpecId to the supplied CodeSpec
+     * @throws IModelError if the insertion fails
+     */
+    insert(codeSpec: CodeSpec): Id64String;
+    /** Add a new CodeSpec to the IModelDb.
+     * @param name The name for the new CodeSpec.
+     * @param scopeType The scope type
+     * @returns The Id of the persistent CodeSpec.
+     * @throws IModelError if the insertion fails
+     */
+    insert(name: string, scopeType: CodeScopeSpec.Type): Id64String;
+    /** Load a CodeSpec from the iModel
+     * @param id  The persistent Id of the CodeSpec to load
+     */
+    load(id: Id64String): CodeSpec;
+}
+//# sourceMappingURL=CodeSpecs.d.ts.map

package/lib/cjs/CodeSpecs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeSpecs.d.ts","sourceRoot":"","sources":["../../src/CodeSpecs.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAkB,UAAU,EAAgB,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAe,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,gBAAgB,CAAkB;gBAE9B,MAAM,EAAE,QAAQ;IAO5B,8DAA8D;IACvD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IASxC;;;;OAIG;IACI,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ;IAehD,uEAAuE;IAChE,KAAK,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO;IAQ7C;;;;OAIG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAWxC,yEAAyE;IAClE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQrC;;;;;OAKG;IACI,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,UAAU;IAC7C;;;;;OAKG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,IAAI,GAAG,UAAU;IAgBtE;;OAEG;IACI,IAAI,CAAC,EAAE,EAAE,UAAU,GAAG,QAAQ;CAatC"}

package/lib/cjs/CodeSpecs.js

@@ -0,0 +1,113 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Codes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodeSpecs = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_common_1 = require("@itwin/core-common");
+/** Manages [CodeSpecs]($docs/BIS/intro/element-fundamentals.md#codespec) within an [[IModelDb]]
+ * @public
+ */
+class CodeSpecs {
+    constructor(imodel) {
+        this._loadedCodeSpecs = [];
+        this._imodel = imodel;
+        if (imodel.isBriefcaseDb()) {
+            imodel.onChangesetApplied.addListener(() => this._loadedCodeSpecs.length = 0);
+        }
+    }
+    /** Look up the Id of the CodeSpec with the specified name. */
+    queryId(name) {
+        return this._imodel.withPreparedStatement("SELECT ECInstanceId FROM BisCore.CodeSpec WHERE Name=:name", (stmt) => {
+            stmt.bindString("name", name);
+            if (core_bentley_1.DbResult.BE_SQLITE_ROW !== stmt.step())
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, "CodeSpec not found", () => ({ name }));
+            return stmt.getValue(0).getId();
+        });
+    }
+    /** Look up a CodeSpec by Id. The CodeSpec will be loaded from the database if necessary.
+     * @param codeSpecId The Id of the CodeSpec to load
+     * @returns The CodeSpec with the specified Id
+     * @throws [[IModelError]] if the Id is invalid or if no CodeSpec with that Id could be found.
+     */
+    getById(codeSpecId) {
+        if (core_bentley_1.Id64.isInvalid(codeSpecId))
+            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.InvalidId, "Invalid codeSpecId");
+        // good chance it is already loaded - check there before running a query
+        const found = this._loadedCodeSpecs.find((codeSpec) => codeSpec.id === codeSpecId);
+        if (found !== undefined)
+            return found;
+        // must load this codespec
+        const loadedCodeSpec = this.load(codeSpecId);
+        this._loadedCodeSpecs.push(loadedCodeSpec);
+        return loadedCodeSpec;
+    }
+    /** Returns true if the IModelDb has a CodeSpec of the specified Id. */
+    hasId(codeSpecId) {
+        try {
+            return undefined !== this.getById(codeSpecId);
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /** Look up a CodeSpec by name. The CodeSpec will be loaded from the database if necessary.
+     * @param name The name of the CodeSpec to load
+     * @returns The CodeSpec with the specified name
+     * @throws [[IModelError]] if no CodeSpec with the specified name could be found.
+     */
+    getByName(name) {
+        // good chance it is already loaded - check there before running a query
+        const found = this._loadedCodeSpecs.find((codeSpec) => codeSpec.name === name);
+        if (found !== undefined)
+            return found;
+        const codeSpecId = this.queryId(name);
+        if (codeSpecId === undefined)
+            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, "CodeSpec not found", () => ({ name }));
+        return this.getById(codeSpecId);
+    }
+    /** Returns true if the IModelDb has a CodeSpec of the specified name. */
+    hasName(name) {
+        try {
+            return undefined !== this.getByName(name);
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    insert(codeSpecOrName, scopeType) {
+        if (codeSpecOrName instanceof core_common_1.CodeSpec) {
+            const codeSpec = codeSpecOrName;
+            const id = this._imodel.insertCodeSpec(codeSpec);
+            codeSpec.id = id;
+            return id;
+        }
+        if (typeof codeSpecOrName === "string") {
+            const name = codeSpecOrName;
+            if (scopeType)
+                return this._imodel.insertCodeSpec(core_common_1.CodeSpec.create(this._imodel, name, scopeType));
+        }
+        throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadArg, "Invalid argument");
+    }
+    /** Load a CodeSpec from the iModel
+     * @param id  The persistent Id of the CodeSpec to load
+     */
+    load(id) {
+        if (core_bentley_1.Id64.isInvalid(id))
+            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.InvalidId, "Invalid codeSpecId");
+        return this._imodel.withPreparedStatement("SELECT name,jsonProperties FROM BisCore.CodeSpec WHERE ECInstanceId=?", (stmt) => {
+            stmt.bindId(1, id);
+            if (core_bentley_1.DbResult.BE_SQLITE_ROW !== stmt.step())
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.InvalidId, "Invalid codeSpecId");
+            const row = stmt.getRow();
+            return core_common_1.CodeSpec.createFromJson(this._imodel, id, row.name, JSON.parse(row.jsonProperties));
+        });
+    }
+}
+exports.CodeSpecs = CodeSpecs;
+//# sourceMappingURL=CodeSpecs.js.map

package/lib/cjs/CodeSpecs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeSpecs.js","sourceRoot":"","sources":["../../src/CodeSpecs.ts"],"names":[],"mappings":"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","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 Codes\r\n */\r\n\r\nimport { DbResult, Id64, Id64String, IModelStatus } from \"@itwin/core-bentley\";\r\nimport { CodeScopeSpec, CodeSpec, IModelError } from \"@itwin/core-common\";\r\nimport { ECSqlStatement } from \"./ECSqlStatement\";\r\nimport { IModelDb } from \"./IModelDb\";\r\n\r\n/** Manages [CodeSpecs]($docs/BIS/intro/element-fundamentals.md#codespec) within an [[IModelDb]]\r\n * @public\r\n */\r\nexport class CodeSpecs {\r\n  private _imodel: IModelDb;\r\n  private _loadedCodeSpecs: CodeSpec[] = [];\r\n\r\n  constructor(imodel: IModelDb) {\r\n    this._imodel = imodel;\r\n    if (imodel.isBriefcaseDb()) {\r\n      imodel.onChangesetApplied.addListener(() => this._loadedCodeSpecs.length = 0);\r\n    }\r\n  }\r\n\r\n  /** Look up the Id of the CodeSpec with the specified name. */\r\n  public queryId(name: string): Id64String {\r\n    return this._imodel.withPreparedStatement(\"SELECT ECInstanceId FROM BisCore.CodeSpec WHERE Name=:name\", (stmt: ECSqlStatement) => {\r\n      stmt.bindString(\"name\", name);\r\n      if (DbResult.BE_SQLITE_ROW !== stmt.step())\r\n        throw new IModelError(IModelStatus.NotFound, \"CodeSpec not found\", () => ({ name }));\r\n      return stmt.getValue(0).getId();\r\n    });\r\n  }\r\n\r\n  /** Look up a CodeSpec by Id. The CodeSpec will be loaded from the database if necessary.\r\n   * @param codeSpecId The Id of the CodeSpec to load\r\n   * @returns The CodeSpec with the specified Id\r\n   * @throws [[IModelError]] if the Id is invalid or if no CodeSpec with that Id could be found.\r\n   */\r\n  public getById(codeSpecId: Id64String): CodeSpec {\r\n    if (Id64.isInvalid(codeSpecId))\r\n      throw new IModelError(IModelStatus.InvalidId, \"Invalid codeSpecId\");\r\n\r\n    // good chance it is already loaded - check there before running a query\r\n    const found: CodeSpec | undefined = this._loadedCodeSpecs.find((codeSpec) => codeSpec.id === codeSpecId);\r\n    if (found !== undefined)\r\n      return found;\r\n\r\n    // must load this codespec\r\n    const loadedCodeSpec = this.load(codeSpecId);\r\n    this._loadedCodeSpecs.push(loadedCodeSpec);\r\n    return loadedCodeSpec;\r\n  }\r\n\r\n  /** Returns true if the IModelDb has a CodeSpec of the specified Id. */\r\n  public hasId(codeSpecId: Id64String): boolean {\r\n    try {\r\n      return undefined !== this.getById(codeSpecId);\r\n    } catch (error) {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  /** Look up a CodeSpec by name. The CodeSpec will be loaded from the database if necessary.\r\n   * @param name The name of the CodeSpec to load\r\n   * @returns The CodeSpec with the specified name\r\n   * @throws [[IModelError]] if no CodeSpec with the specified name could be found.\r\n   */\r\n  public getByName(name: string): CodeSpec {\r\n    // good chance it is already loaded - check there before running a query\r\n    const found: CodeSpec | undefined = this._loadedCodeSpecs.find((codeSpec) => codeSpec.name === name);\r\n    if (found !== undefined)\r\n      return found;\r\n    const codeSpecId = this.queryId(name);\r\n    if (codeSpecId === undefined)\r\n      throw new IModelError(IModelStatus.NotFound, \"CodeSpec not found\", () => ({ name }));\r\n    return this.getById(codeSpecId);\r\n  }\r\n\r\n  /** Returns true if the IModelDb has a CodeSpec of the specified name. */\r\n  public hasName(name: string): boolean {\r\n    try {\r\n      return undefined !== this.getByName(name);\r\n    } catch (error) {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  /** Add a new CodeSpec to the iModel.\r\n   * @param codeSpec The CodeSpec to insert\r\n   * @returns The Id of the persistent CodeSpec.\r\n   * @note If successful, this method will assign a valid CodeSpecId to the supplied CodeSpec\r\n   * @throws IModelError if the insertion fails\r\n   */\r\n  public insert(codeSpec: CodeSpec): Id64String;\r\n  /** Add a new CodeSpec to the IModelDb.\r\n   * @param name The name for the new CodeSpec.\r\n   * @param scopeType The scope type\r\n   * @returns The Id of the persistent CodeSpec.\r\n   * @throws IModelError if the insertion fails\r\n   */\r\n  public insert(name: string, scopeType: CodeScopeSpec.Type): Id64String;\r\n  public insert(codeSpecOrName: CodeSpec | string, scopeType?: CodeScopeSpec.Type): Id64String {\r\n    if (codeSpecOrName instanceof CodeSpec) {\r\n      const codeSpec = codeSpecOrName;\r\n      const id: Id64String = this._imodel.insertCodeSpec(codeSpec);\r\n      codeSpec.id = id;\r\n      return id;\r\n    }\r\n    if (typeof codeSpecOrName === \"string\") {\r\n      const name = codeSpecOrName;\r\n      if (scopeType)\r\n        return this._imodel.insertCodeSpec(CodeSpec.create(this._imodel, name, scopeType));\r\n    }\r\n    throw new IModelError(IModelStatus.BadArg, \"Invalid argument\");\r\n  }\r\n\r\n  /** Load a CodeSpec from the iModel\r\n   * @param id  The persistent Id of the CodeSpec to load\r\n   */\r\n  public load(id: Id64String): CodeSpec {\r\n    if (Id64.isInvalid(id))\r\n      throw new IModelError(IModelStatus.InvalidId, \"Invalid codeSpecId\");\r\n\r\n    return this._imodel.withPreparedStatement(\"SELECT name,jsonProperties FROM BisCore.CodeSpec WHERE ECInstanceId=?\", (stmt: ECSqlStatement) => {\r\n      stmt.bindId(1, id);\r\n      if (DbResult.BE_SQLITE_ROW !== stmt.step())\r\n        throw new IModelError(IModelStatus.InvalidId, \"Invalid codeSpecId\");\r\n\r\n      const row: any = stmt.getRow();\r\n      return CodeSpec.createFromJson(this._imodel, id, row.name, JSON.parse(row.jsonProperties));\r\n    });\r\n  }\r\n}\r\n"]}

package/lib/cjs/ConcurrentQuery.d.ts

@@ -0,0 +1,12 @@
+import { IModelJsNative } from "@bentley/imodeljs-native";
+import { DbBlobRequest, DbBlobResponse, DbQueryRequest, DbQueryResponse } from "@itwin/core-common";
+/** @internal */
+export declare type OnResponse = (response: Response) => void;
+/** @internal */
+export declare class ConcurrentQuery {
+    /** @internal */
+    static executeQueryRequest(conn: IModelJsNative.ECDb | IModelJsNative.DgnDb, request: DbQueryRequest): Promise<DbQueryResponse>;
+    /** @internal */
+    static executeBlobRequest(conn: IModelJsNative.ECDb | IModelJsNative.DgnDb, request: DbBlobRequest): Promise<DbBlobResponse>;
+}
+//# sourceMappingURL=ConcurrentQuery.d.ts.map

package/lib/cjs/ConcurrentQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConcurrentQuery.d.ts","sourceRoot":"","sources":["../../src/ConcurrentQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAK1D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEpG,gBAAgB;AAChB,oBAAY,UAAU,GAAG,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;AAEtD,gBAAgB;AAChB,qBAAa,eAAe;IAC1B,gBAAgB;WACI,mBAAmB,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAO5I,gBAAgB;WACI,kBAAkB,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;CAO1I"}

package/lib/cjs/ConcurrentQuery.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConcurrentQuery = void 0;
+/** @internal */
+class ConcurrentQuery {
+    /** @internal */
+    static async executeQueryRequest(conn, request) {
+        return new Promise((resolve) => {
+            conn.concurrentQueryExecute(request, (response) => {
+                resolve(response);
+            });
+        });
+    }
+    /** @internal */
+    static async executeBlobRequest(conn, request) {
+        return new Promise((resolve) => {
+            conn.concurrentQueryExecute(request, (response) => {
+                resolve(response);
+            });
+        });
+    }
+}
+exports.ConcurrentQuery = ConcurrentQuery;
+//# sourceMappingURL=ConcurrentQuery.js.map

package/lib/cjs/ConcurrentQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConcurrentQuery.js","sourceRoot":"","sources":["../../src/ConcurrentQuery.ts"],"names":[],"mappings":";;;AAUA,gBAAgB;AAChB,MAAa,eAAe;IAC1B,gBAAgB;IACT,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAgD,EAAE,OAAuB;QAC/G,OAAO,IAAI,OAAO,CAAkB,CAAC,OAAO,EAAE,EAAE;YAC9C,IAAI,CAAC,sBAAsB,CAAC,OAAc,EAAE,CAAC,QAAa,EAAE,EAAE;gBAC5D,OAAO,CAAC,QAA2B,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IACD,gBAAgB;IACT,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAgD,EAAE,OAAsB;QAC7G,OAAO,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,EAAE;YAC7C,IAAI,CAAC,sBAAsB,CAAC,OAAc,EAAE,CAAC,QAAa,EAAE,EAAE;gBAC5D,OAAO,CAAC,QAA0B,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAjBD,0CAiBC","sourcesContent":["import { IModelJsNative } from \"@bentley/imodeljs-native\";\r\n/*---------------------------------------------------------------------------------------------\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\nimport { DbBlobRequest, DbBlobResponse, DbQueryRequest, DbQueryResponse } from \"@itwin/core-common\";\r\n\r\n/** @internal */\r\nexport type OnResponse = (response: Response) => void;\r\n\r\n/** @internal */\r\nexport class ConcurrentQuery {\r\n  /** @internal */\r\n  public static async executeQueryRequest(conn: IModelJsNative.ECDb | IModelJsNative.DgnDb, request: DbQueryRequest): Promise<DbQueryResponse> {\r\n    return new Promise<DbQueryResponse>((resolve) => {\r\n      conn.concurrentQueryExecute(request as any, (response: any) => {\r\n        resolve(response as DbQueryResponse);\r\n      });\r\n    });\r\n  }\r\n  /** @internal */\r\n  public static async executeBlobRequest(conn: IModelJsNative.ECDb | IModelJsNative.DgnDb, request: DbBlobRequest): Promise<DbBlobResponse> {\r\n    return new Promise<DbBlobResponse>((resolve) => {\r\n      conn.concurrentQueryExecute(request as any, (response: any) => {\r\n        resolve(response as DbBlobResponse);\r\n      });\r\n    });\r\n  }\r\n}\r\n"]}

package/lib/cjs/DevTools.d.ts

@@ -0,0 +1,72 @@
+/// <reference types="node" />
+import * as os from "os";
+import { LogLevel } from "@itwin/core-bentley";
+/**
+ * Performance and Memory statistics of backend
+ * @internal
+ */
+export interface DevToolsStats {
+    os: DevToolsOsStats;
+    process: DevToolsProcessStats;
+}
+/**
+ * OS stats of backend
+ * @internal
+ */
+export interface DevToolsOsStats {
+    platform: NodeJS.Platform;
+    hostname: string;
+    totalmem: number;
+    freemem: number;
+    uptime: number;
+    cpus: os.CpuInfo[];
+    cpuUsage: number;
+}
+/**
+ * Process stats of backend
+ * @internal
+ */
+export interface DevToolsProcessStats {
+    uptime: number;
+    pid: number;
+    ppid: number;
+    memoryUsage: NodeJS.MemoryUsage;
+}
+/** Utility to format the JSON created by DevTools.stats() to include the appropriate units
+ * @internal
+ */
+export declare class DevToolsStatsFormatter {
+    private static readonly _megaByteProps;
+    private static readonly _percentProps;
+    private static readonly _mHzProps;
+    private static readonly _secondsProps;
+    /** Replacer that includes units - can be used with JSON.stringify()  */
+    private static _replacer;
+    /** Converts the input stats to another JSON object with the appropriate units setup for various fields */
+    static toFormattedJson(stats: any): any;
+}
+/**
+ * Internal diagnostic utility
+ * @internal
+ */
+export declare class DevTools {
+    /** Receives a ping and returns true */
+    static ping(): boolean;
+    private static hrtimeToMS;
+    private static bytesToMegaBytes;
+    private static evaluateCpuUsage;
+    private static evaluateCpus;
+    private static evaluateMemoryUsage;
+    private static evaluateProcessStats;
+    private static evaluateOsStats;
+    /** Returns JSON object with backend statistics */
+    static stats(): DevToolsStats;
+    /** Sets up a log level at the backend and returns the old log level */
+    static setLogLevel(inLoggerCategory: string, newLevel: LogLevel): LogLevel | undefined;
+    /** Obtains the backend application and iModel.js versions */
+    static versions(): {
+        application: string;
+        iModelJs: any;
+    };
+}
+//# sourceMappingURL=DevTools.d.ts.map

package/lib/cjs/DevTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevTools.d.ts","sourceRoot":"","sources":["../../src/DevTools.ts"],"names":[],"mappings":";AAKA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,OAAO,EAAU,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAYvD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,eAAe,CAAC;IACpB,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC;CACjC;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAuE;IAC7G,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAsD;IAC3F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAa;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAc;IAEnD,wEAAwE;IACxE,OAAO,CAAC,MAAM,CAAC,SAAS,CAUtB;IAEF,0GAA0G;WAC5F,eAAe,CAAC,KAAK,EAAE,GAAG;CAOzC;AAED;;;GAGG;AACH,qBAAa,QAAQ;IAEnB,uCAAuC;WACzB,IAAI,IAAI,OAAO;IAK7B,OAAO,CAAC,MAAM,CAAC,UAAU;IAIzB,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAK/B,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAqB/B,OAAO,CAAC,MAAM,CAAC,YAAY;IAoB3B,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAWlC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IASnC,OAAO,CAAC,MAAM,CAAC,eAAe;IAY9B,kDAAkD;WACpC,KAAK,IAAI,aAAa;IAapC,uEAAuE;WACzD,WAAW,CAAC,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS;IAQ7F,6DAA6D;WAC/C,QAAQ;;;;CAMvB"}