@itwin/core-frontend 3.2.0-dev.71 → 3.2.0-dev.72

package/lib/cjs/extension/providers/ExtensionLoadScript.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadScript = void 0;
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/**
+ * Executes an extension's bundled javascript module.
+ * First attempts an ES6 dynamic import,
+ * second attempts a dynamic import via a script element as a fallback.
+ * Used by remote and service Extensions.
+ * Throws an error if the module does not have a default or main function to execute.
+ * @internal
+ */
+async function loadScript(jsUrl) {
+    // Warning "Critical dependency: the request of a dependency is an expression"
+    // until that is resolved, leave code commented:
+    // const module = await import(/* webpackIgnore: true */jsUrl);
+    // return execute(module);
+    return new Promise((resolve, reject) => {
+        const head = document.getElementsByTagName("head")[0];
+        if (!head)
+            reject(new Error("No head element found"));
+        const scriptElement = document.createElement("script");
+        const tempGlobal = `__tempModuleLoadingVariable${Math.random().toString(32).substring(2)}`;
+        function cleanup() {
+            delete window[tempGlobal];
+            scriptElement.remove();
+        }
+        window[tempGlobal] = async function (module) {
+            await execute(module);
+            cleanup();
+            resolve(module);
+        };
+        scriptElement.type = "module";
+        scriptElement.textContent = `import * as m from "${jsUrl}";window.${tempGlobal}(m);`;
+        scriptElement.onerror = () => {
+            reject(new Error(`Failed to load extension with URL ${jsUrl}`));
+            cleanup();
+        };
+        head.insertBefore(scriptElement, head.lastChild);
+    });
+}
+exports.loadScript = loadScript;
+function execute(m) {
+    if (typeof m === "function")
+        return m();
+    if (m.main && typeof m.main === "function")
+        return m.main();
+    if (m.default && typeof m.default === "function")
+        return m.default();
+    throw new Error(`Failed to load extension. No default function was found to execute.`);
+}
+//# sourceMappingURL=ExtensionLoadScript.js.map

package/lib/cjs/extension/providers/ExtensionLoadScript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionLoadScript.js","sourceRoot":"","sources":["../../../../src/extension/providers/ExtensionLoadScript.ts"],"names":[],"mappings":";;;AAAA;;;+FAG+F;AAC/F;;;;;;;GAOG;AACI,KAAK,UAAU,UAAU,CAAC,KAAa;IAC5C,8EAA8E;IAC9E,gDAAgD;IAChD,+DAA+D;IAC/D,0BAA0B;IAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI;YACP,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;QAE7C,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACvD,MAAM,UAAU,GAAW,8BAA8B,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAEnG,SAAS,OAAO;YACd,OAAQ,MAAc,CAAC,UAAU,CAAC,CAAC;YACnC,aAAa,CAAC,MAAM,EAAE,CAAC;QACzB,CAAC;QAEA,MAAc,CAAC,UAAU,CAAC,GAAG,KAAK,WAAW,MAAW;YACvD,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;YACtB,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC;QACF,aAAa,CAAC,IAAI,GAAG,QAAQ,CAAC;QAC9B,aAAa,CAAC,WAAW,GAAG,uBAAuB,KAAK,YAAY,UAAU,MAAM,CAAC;QAErF,aAAa,CAAC,OAAO,GAAG,GAAG,EAAE;YAC3B,MAAM,CAAC,IAAI,KAAK,CAAC,qCAAqC,KAAK,EAAE,CAAC,CAAC,CAAC;YAChE,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QAEF,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC;AAjCD,gCAiCC;AAED,SAAS,OAAO,CAAC,CAAM;IACrB,IAAI,OAAO,CAAC,KAAK,UAAU;QACzB,OAAO,CAAC,EAAE,CAAC;IACb,IAAI,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,UAAU;QACxC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAClB,IAAI,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,UAAU;QAC9C,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;IACrB,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;AACzF,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/**\r\n * Executes an extension's bundled javascript module.\r\n * First attempts an ES6 dynamic import,\r\n * second attempts a dynamic import via a script element as a fallback.\r\n * Used by remote and service Extensions.\r\n * Throws an error if the module does not have a default or main function to execute.\r\n * @internal\r\n */\r\nexport async function loadScript(jsUrl: string): Promise<any> {\r\n  // Warning \"Critical dependency: the request of a dependency is an expression\"\r\n  // until that is resolved, leave code commented:\r\n  // const module = await import(/* webpackIgnore: true */jsUrl);\r\n  // return execute(module);\r\n  return new Promise((resolve, reject) => {\r\n    const head = document.getElementsByTagName(\"head\")[0];\r\n    if (!head)\r\n      reject(new Error(\"No head element found\"));\r\n\r\n    const scriptElement = document.createElement(\"script\");\r\n    const tempGlobal: string = `__tempModuleLoadingVariable${Math.random().toString(32).substring(2)}`;\r\n\r\n    function cleanup() {\r\n      delete (window as any)[tempGlobal];\r\n      scriptElement.remove();\r\n    }\r\n\r\n    (window as any)[tempGlobal] = async function (module: any) {\r\n      await execute(module);\r\n      cleanup();\r\n      resolve(module);\r\n    };\r\n    scriptElement.type = \"module\";\r\n    scriptElement.textContent = `import * as m from \"${jsUrl}\";window.${tempGlobal}(m);`;\r\n\r\n    scriptElement.onerror = () => {\r\n      reject(new Error(`Failed to load extension with URL ${jsUrl}`));\r\n      cleanup();\r\n    };\r\n\r\n    head.insertBefore(scriptElement, head.lastChild);\r\n  });\r\n}\r\n\r\nfunction execute(m: any) {\r\n  if (typeof m === \"function\")\r\n    return m();\r\n  if (m.main && typeof m.main === \"function\")\r\n    return m.main();\r\n  if (m.default && typeof m.default === \"function\")\r\n    return m.default();\r\n  throw new Error(`Failed to load extension. No default function was found to execute.`);\r\n}\r\n"]}

package/lib/cjs/extension/providers/ExtensionServiceClient.d.ts

@@ -0,0 +1,52 @@
+import { AccessToken } from "@itwin/core-bentley";
+/** Structure of extensions from the ExtensionService
+ * @internal
+ */
+export interface ExtensionMetadata {
+    contextId: string;
+    extensionName: string;
+    version: string;
+    files: FileInfo[];
+    uploadedBy: string;
+    timestamp: Date;
+    status: ExtensionUploadStatus;
+    isPublic: boolean;
+}
+interface ExtensionUploadStatus {
+    updateTime: Date;
+    status: string;
+}
+interface FileInfo {
+    url: string;
+    expires: Date;
+    checksum: string;
+}
+/**
+ * Client for querying, publishing and deleting iModel.js Extensions.
+ *
+ * The `imodel-extension-service-api` OIDC scope is required for all operations and the `imodel-extension-service:modify` is
+ * required for modification operations (modify, publish, and deleting).
+ * @alpha
+ */
+export declare class ExtensionClient {
+    private readonly _baseUrl;
+    constructor();
+    private get _endpoint();
+    private parseExtensionMetadataArray;
+    /**
+     * Gets information on extensions. If extensionName is undefined, will return all extensions in the context.
+     * If it's defined, will return all versions of that extension.
+     * @param iTwinId Context Id
+     * @param extensionName Extension name (optional)
+     */
+    getExtensions(accessToken: AccessToken, iTwinId: string, extensionName?: string): Promise<ExtensionMetadata[]>;
+    /**
+     * Gets information about an extension's specific version
+     * @param iTwinId iTwin Id
+     * @param extensionName Extension name
+     * @param version Extension version
+     */
+    getExtensionMetadata(accessToken: AccessToken, iTwinId: string, extensionName: string, version: string): Promise<ExtensionMetadata | undefined>;
+}
+export {};
+//# sourceMappingURL=ExtensionServiceClient.d.ts.map

package/lib/cjs/extension/providers/ExtensionServiceClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionServiceClient.d.ts","sourceRoot":"","sources":["../../../../src/extension/providers/ExtensionServiceClient.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIlD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,qBAAqB;IAC7B,UAAU,EAAE,IAAI,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,QAAQ;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;;IAKlC,OAAO,KAAK,SAAS,GAWpB;IAED,OAAO,CAAC,2BAA2B;IAcnC;;;;;OAKG;IACU,aAAa,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAa3H;;;;;OAKG;IACU,oBAAoB,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;CAe7J"}

package/lib/cjs/extension/providers/ExtensionServiceClient.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExtensionClient = void 0;
+const Request_1 = require("../../request/Request");
+/**
+ * Client for querying, publishing and deleting iModel.js Extensions.
+ *
+ * The `imodel-extension-service-api` OIDC scope is required for all operations and the `imodel-extension-service:modify` is
+ * required for modification operations (modify, publish, and deleting).
+ * @alpha
+ */
+class ExtensionClient {
+    constructor() {
+        this._baseUrl = "https://api.bentley.com/iModelExtensionService/";
+    }
+    get _endpoint() {
+        const prefix = process.env.IMJS_URL_PREFIX;
+        const baseUrl = new URL(this._baseUrl);
+        if (prefix)
+            baseUrl.hostname = prefix + new URL(baseUrl).hostname;
+        if (!baseUrl.pathname.endsWith("/"))
+            baseUrl.pathname += "/";
+        baseUrl.pathname += "v1.0/";
+        return baseUrl.toString();
+    }
+    parseExtensionMetadataArray(json) {
+        if (!(json instanceof Array))
+            return [];
+        const ret = [];
+        json.forEach((extensionJson) => {
+            const extension = extensionMetadataFromJSON(extensionJson);
+            if (extension !== undefined)
+                ret.push(extension);
+        });
+        return ret;
+    }
+    /**
+     * Gets information on extensions. If extensionName is undefined, will return all extensions in the context.
+     * If it's defined, will return all versions of that extension.
+     * @param iTwinId Context Id
+     * @param extensionName Extension name (optional)
+     */
+    async getExtensions(accessToken, iTwinId, extensionName) {
+        const options = { method: "GET" };
+        options.headers = { authorization: accessToken };
+        const response = await (0, Request_1.request)(`${this._endpoint}${iTwinId}/IModelExtension/${extensionName !== null && extensionName !== void 0 ? extensionName : ""}`, options);
+        if (response.status !== 200)
+            throw new Error(`Server returned status: ${response.status}, message: ${response.body.message}`);
+        if (!(response.body instanceof Array) || response.body.length < 1)
+            return [];
+        return this.parseExtensionMetadataArray(response.body);
+    }
+    /**
+     * Gets information about an extension's specific version
+     * @param iTwinId iTwin Id
+     * @param extensionName Extension name
+     * @param version Extension version
+     */
+    async getExtensionMetadata(accessToken, iTwinId, extensionName, version) {
+        const options = { method: "GET" };
+        options.headers = { authorization: accessToken };
+        const response = await (0, Request_1.request)(`${this._endpoint}${iTwinId}/IModelExtension/${extensionName}/${version}`, options);
+        if (response.status !== 200)
+            throw new Error(`Server returned status: ${response.status}, message: ${response.body.message}`);
+        if (!(response.body instanceof Array) || response.body.length < 1)
+            return undefined;
+        if (response.body.length > 1)
+            throw new Error("Server returned too many extensions");
+        return extensionMetadataFromJSON(response.body[0]);
+    }
+}
+exports.ExtensionClient = ExtensionClient;
+/**
+ * Validates JSON and returns ExtensionMetadata
+ */
+function extensionMetadataFromJSON(jsonObject) {
+    if (jsonObject.contextId === undefined || typeof jsonObject.contextId !== "string" ||
+        jsonObject.extensionName === undefined || typeof jsonObject.extensionName !== "string" ||
+        jsonObject.version === undefined || typeof jsonObject.version !== "string" ||
+        jsonObject.files === undefined || !(jsonObject.files instanceof Array) ||
+        jsonObject.uploadedBy === undefined || typeof jsonObject.uploadedBy !== "string" ||
+        jsonObject.timestamp === undefined || typeof jsonObject.timestamp !== "string" ||
+        jsonObject.isPublic === undefined || typeof jsonObject.isPublic !== "boolean" ||
+        jsonObject.extensionStatus === undefined) {
+        return undefined;
+    }
+    const status = statusFromJSON(jsonObject.extensionStatus);
+    if (status === undefined)
+        return undefined;
+    const files = new Array(jsonObject.files.length);
+    for (let i = 0; i < jsonObject.files.length; i++) {
+        const parsed = fileInfoFromJSON(jsonObject.files[i]);
+        if (parsed === undefined)
+            return undefined;
+        files[i] = parsed;
+    }
+    return {
+        contextId: jsonObject.contextId,
+        extensionName: jsonObject.extensionName,
+        version: jsonObject.version,
+        files,
+        uploadedBy: jsonObject.uploadedBy,
+        timestamp: new Date(jsonObject.timestamp),
+        isPublic: jsonObject.isPublic,
+        status,
+    };
+}
+function statusFromJSON(jsonObject) {
+    var _a;
+    if (jsonObject.statusUpdateTime === undefined || typeof jsonObject.statusUpdateTime !== "string" ||
+        jsonObject.status === undefined || (jsonObject.status !== null && typeof jsonObject.status !== "string")) {
+        return undefined;
+    }
+    return {
+        updateTime: new Date(jsonObject.statusUpdateTime),
+        status: (_a = jsonObject.status) !== null && _a !== void 0 ? _a : "Valid",
+    };
+}
+function fileInfoFromJSON(jsonObject) {
+    if (jsonObject.url === undefined || typeof jsonObject.url !== "string" ||
+        jsonObject.expiresAt === undefined || typeof jsonObject.expiresAt !== "string" ||
+        jsonObject.checksum === undefined || (typeof jsonObject.checksum !== "string" && jsonObject.checksum !== null)) {
+        return undefined;
+    }
+    return {
+        url: jsonObject.url,
+        expires: new Date(jsonObject.expiresAt),
+        checksum: jsonObject.checksum,
+    };
+}
+//# sourceMappingURL=ExtensionServiceClient.js.map

package/lib/cjs/extension/providers/ExtensionServiceClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionServiceClient.js","sourceRoot":"","sources":["../../../../src/extension/providers/ExtensionServiceClient.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 { AccessToken } from \"@itwin/core-bentley\";\r\n\r\nimport { request, RequestOptions } from \"../../request/Request\";\r\n\r\n/** Structure of extensions from the ExtensionService\r\n * @internal\r\n */\r\nexport interface ExtensionMetadata {\r\n  contextId: string;\r\n  extensionName: string;\r\n  version: string;\r\n  files: FileInfo[];\r\n  uploadedBy: string;\r\n  timestamp: Date;\r\n  status: ExtensionUploadStatus;\r\n  isPublic: boolean;\r\n}\r\n\r\ninterface ExtensionUploadStatus {\r\n  updateTime: Date;\r\n  status: string;\r\n}\r\n\r\ninterface FileInfo {\r\n  url: string;\r\n  expires: Date;\r\n  checksum: string;\r\n}\r\n\r\n/**\r\n * Client for querying, publishing and deleting iModel.js Extensions.\r\n *\r\n * The `imodel-extension-service-api` OIDC scope is required for all operations and the `imodel-extension-service:modify` is\r\n * required for modification operations (modify, publish, and deleting).\r\n * @alpha\r\n */\r\nexport class ExtensionClient {\r\n  private readonly _baseUrl: string;\r\n  public constructor() {\r\n    this._baseUrl = \"https://api.bentley.com/iModelExtensionService/\";\r\n  }\r\n\r\n  private get _endpoint(): string {\r\n    const prefix = process.env.IMJS_URL_PREFIX;\r\n    const baseUrl = new URL(this._baseUrl);\r\n    if (prefix)\r\n      baseUrl.hostname = prefix + new URL(baseUrl).hostname;\r\n\r\n    if (!baseUrl.pathname.endsWith(\"/\"))\r\n      baseUrl.pathname += \"/\";\r\n\r\n    baseUrl.pathname += \"v1.0/\";\r\n    return baseUrl.toString();\r\n  }\r\n\r\n  private parseExtensionMetadataArray(json: any): ExtensionMetadata[] {\r\n    if (!(json instanceof Array))\r\n      return [];\r\n\r\n    const ret: ExtensionMetadata[] = [];\r\n    json.forEach((extensionJson) => {\r\n      const extension = extensionMetadataFromJSON(extensionJson);\r\n      if (extension !== undefined)\r\n        ret.push(extension);\r\n    });\r\n\r\n    return ret;\r\n  }\r\n\r\n  /**\r\n   * Gets information on extensions. If extensionName is undefined, will return all extensions in the context.\r\n   * If it's defined, will return all versions of that extension.\r\n   * @param iTwinId Context Id\r\n   * @param extensionName Extension name (optional)\r\n   */\r\n  public async getExtensions(accessToken: AccessToken, iTwinId: string, extensionName?: string): Promise<ExtensionMetadata[]> {\r\n    const options: RequestOptions = { method: \"GET\" };\r\n    options.headers = { authorization: accessToken };\r\n    const response = await request(`${this._endpoint}${iTwinId}/IModelExtension/${extensionName ?? \"\"}`, options);\r\n    if (response.status !== 200)\r\n      throw new Error(`Server returned status: ${response.status}, message: ${response.body.message}`);\r\n\r\n    if (!(response.body instanceof Array) || response.body.length < 1)\r\n      return [];\r\n\r\n    return this.parseExtensionMetadataArray(response.body);\r\n  }\r\n\r\n  /**\r\n   * Gets information about an extension's specific version\r\n   * @param iTwinId iTwin Id\r\n   * @param extensionName Extension name\r\n   * @param version Extension version\r\n   */\r\n  public async getExtensionMetadata(accessToken: AccessToken, iTwinId: string, extensionName: string, version: string): Promise<ExtensionMetadata | undefined> {\r\n\r\n    const options: RequestOptions = { method: \"GET\" };\r\n    options.headers = { authorization: accessToken };\r\n    const response = await request(`${this._endpoint}${iTwinId}/IModelExtension/${extensionName}/${version}`, options);\r\n    if (response.status !== 200)\r\n      throw new Error(`Server returned status: ${response.status}, message: ${response.body.message}`);\r\n\r\n    if (!(response.body instanceof Array) || response.body.length < 1)\r\n      return undefined;\r\n    if (response.body.length > 1)\r\n      throw new Error(\"Server returned too many extensions\");\r\n\r\n    return extensionMetadataFromJSON(response.body[0]);\r\n  }\r\n}\r\n\r\n/**\r\n * Validates JSON and returns ExtensionMetadata\r\n */\r\nfunction extensionMetadataFromJSON(jsonObject: any): ExtensionMetadata | undefined {\r\n  if (jsonObject.contextId === undefined || typeof jsonObject.contextId !== \"string\" ||\r\n    jsonObject.extensionName === undefined || typeof jsonObject.extensionName !== \"string\" ||\r\n    jsonObject.version === undefined || typeof jsonObject.version !== \"string\" ||\r\n    jsonObject.files === undefined || !(jsonObject.files instanceof Array) ||\r\n    jsonObject.uploadedBy === undefined || typeof jsonObject.uploadedBy !== \"string\" ||\r\n    jsonObject.timestamp === undefined || typeof jsonObject.timestamp !== \"string\" ||\r\n    jsonObject.isPublic === undefined || typeof jsonObject.isPublic !== \"boolean\" ||\r\n    jsonObject.extensionStatus === undefined) {\r\n\r\n    return undefined;\r\n  }\r\n\r\n  const status = statusFromJSON(jsonObject.extensionStatus);\r\n  if (status === undefined)\r\n    return undefined;\r\n\r\n  const files = new Array(jsonObject.files.length);\r\n  for (let i = 0; i < jsonObject.files.length; i++) {\r\n    const parsed = fileInfoFromJSON(jsonObject.files[i]);\r\n    if (parsed === undefined)\r\n      return undefined;\r\n    files[i] = parsed;\r\n  }\r\n\r\n  return {\r\n    contextId: jsonObject.contextId,\r\n    extensionName: jsonObject.extensionName,\r\n    version: jsonObject.version,\r\n    files,\r\n    uploadedBy: jsonObject.uploadedBy,\r\n    timestamp: new Date(jsonObject.timestamp),\r\n    isPublic: jsonObject.isPublic,\r\n    status,\r\n  };\r\n}\r\n\r\nfunction statusFromJSON(jsonObject: any) {\r\n  if (jsonObject.statusUpdateTime === undefined || typeof jsonObject.statusUpdateTime !== \"string\" ||\r\n    jsonObject.status === undefined || (jsonObject.status !== null && typeof jsonObject.status !== \"string\")) {\r\n\r\n    return undefined;\r\n  }\r\n\r\n  return {\r\n    updateTime: new Date(jsonObject.statusUpdateTime),\r\n    status: jsonObject.status ?? \"Valid\",\r\n  };\r\n}\r\n\r\nfunction fileInfoFromJSON(jsonObject: any) {\r\n  if (jsonObject.url === undefined || typeof jsonObject.url !== \"string\" ||\r\n    jsonObject.expiresAt === undefined || typeof jsonObject.expiresAt !== \"string\" ||\r\n    jsonObject.checksum === undefined || (typeof jsonObject.checksum !== \"string\" && jsonObject.checksum !== null)) {\r\n\r\n    return undefined;\r\n  }\r\n\r\n  return {\r\n    url: jsonObject.url,\r\n    expires: new Date(jsonObject.expiresAt),\r\n    checksum: jsonObject.checksum,\r\n  };\r\n}\r\n"]}

package/lib/cjs/extension/providers/LocalExtensionProvider.d.ts

@@ -0,0 +1,26 @@
+import type { ExtensionManifest, ExtensionProvider, ResolveFunc } from "../Extension";
+/**
+ * Required props for a local extension provider
+ * @alpha
+ */
+export interface LocalExtensionProviderProps {
+    /** A promise that returns the manifest (package.json) of a local extension */
+    manifestPromise: Promise<any>;
+    /** A function that runs the main entry point of the local extension */
+    main: ResolveFunc;
+}
+/**
+ * Implements a "local" extension via LocalExtensionProps.
+ * An extension is not loaded until it is added to the ExtensionAdmin.
+ * The execute() and getManifest() methods are used by the ExtensionAdmin.
+ * @alpha
+ */
+export declare class LocalExtensionProvider implements ExtensionProvider {
+    private readonly _props;
+    constructor(_props: LocalExtensionProviderProps);
+    /** returns the manifest (package.json) of a local extension */
+    getManifest(): Promise<ExtensionManifest>;
+    /** executes the javascript main file / bundle (index.js) of a local extension */
+    execute(): Promise<any>;
+}
+//# sourceMappingURL=LocalExtensionProvider.d.ts.map

package/lib/cjs/extension/providers/LocalExtensionProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalExtensionProvider.d.ts","sourceRoot":"","sources":["../../../../src/extension/providers/LocalExtensionProvider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACZ,MAAM,cAAc,CAAC;AAEtB;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,8EAA8E;IAC9E,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,uEAAuE;IACvE,IAAI,EAAE,WAAW,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,iBAAiB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,2BAA2B;IAEhE,+DAA+D;IAClD,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAItD,iFAAiF;IACpE,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC;CAGrC"}

package/lib/cjs/extension/providers/LocalExtensionProvider.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalExtensionProvider = void 0;
+/**
+ * Implements a "local" extension via LocalExtensionProps.
+ * An extension is not loaded until it is added to the ExtensionAdmin.
+ * The execute() and getManifest() methods are used by the ExtensionAdmin.
+ * @alpha
+ */
+class LocalExtensionProvider {
+    constructor(_props) {
+        this._props = _props;
+    }
+    /** returns the manifest (package.json) of a local extension */
+    async getManifest() {
+        return this._props.manifestPromise;
+    }
+    /** executes the javascript main file / bundle (index.js) of a local extension */
+    async execute() {
+        return this._props.main();
+    }
+}
+exports.LocalExtensionProvider = LocalExtensionProvider;
+//# sourceMappingURL=LocalExtensionProvider.js.map

package/lib/cjs/extension/providers/LocalExtensionProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalExtensionProvider.js","sourceRoot":"","sources":["../../../../src/extension/providers/LocalExtensionProvider.ts"],"names":[],"mappings":";;;AAqBA;;;;;GAKG;AACH,MAAa,sBAAsB;IACjC,YAA6B,MAAmC;QAAnC,WAAM,GAAN,MAAM,CAA6B;IAAI,CAAC;IAErE,+DAA+D;IACxD,KAAK,CAAC,WAAW;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;IACrC,CAAC;IAED,iFAAiF;IAC1E,KAAK,CAAC,OAAO;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;CACF;AAZD,wDAYC","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 type {\r\n  ExtensionManifest,\r\n  ExtensionProvider,\r\n  ResolveFunc,\r\n} from \"../Extension\";\r\n\r\n/**\r\n * Required props for a local extension provider\r\n * @alpha\r\n */\r\nexport interface LocalExtensionProviderProps {\r\n  /** A promise that returns the manifest (package.json) of a local extension */\r\n  manifestPromise: Promise<any>;\r\n  /** A function that runs the main entry point of the local extension */\r\n  main: ResolveFunc;\r\n}\r\n\r\n/**\r\n * Implements a \"local\" extension via LocalExtensionProps.\r\n * An extension is not loaded until it is added to the ExtensionAdmin.\r\n * The execute() and getManifest() methods are used by the ExtensionAdmin.\r\n * @alpha\r\n */\r\nexport class LocalExtensionProvider implements ExtensionProvider {\r\n  constructor(private readonly _props: LocalExtensionProviderProps) { }\r\n\r\n  /** returns the manifest (package.json) of a local extension */\r\n  public async getManifest(): Promise<ExtensionManifest> {\r\n    return this._props.manifestPromise;\r\n  }\r\n\r\n  /** executes the javascript main file / bundle (index.js) of a local extension */\r\n  public async execute(): Promise<any> {\r\n    return this._props.main();\r\n  }\r\n}\r\n"]}

package/lib/cjs/extension/providers/RemoteExtensionProvider.d.ts

@@ -0,0 +1,36 @@
+import type { ExtensionManifest, ExtensionProvider } from "../Extension";
+/**
+ * Required props for a remote extension provider
+ * @alpha
+ */
+export interface RemoteExtensionProviderProps {
+    /** URL where the extension entry point can be loaded from */
+    jsUrl: string;
+    /** URL where the manifest (package.json) can be loaded from */
+    manifestUrl: string;
+}
+/**
+ * Implements a "remote" extension.
+ * Remote extensions are hosted on an external server.
+ * The execute() and getManifest() methods are used by the ExtensionAdmin to load and execute the extension.
+ * @alpha
+ */
+export declare class RemoteExtensionProvider implements ExtensionProvider {
+    private readonly _props;
+    /** The name of the server where the extension is hosted. */
+    readonly hostname: string;
+    constructor(_props: RemoteExtensionProviderProps);
+    /**
+     * Attempts to execute an extension.
+     * Throws an error if the provided jsUrl is not accessible.
+     */
+    execute(): Promise<string>;
+    /**
+     * Attempts to fetch an extension's manifest (package.json) file.
+     * Throws an error if the provided manifestUrl is not accessible.
+     */
+    getManifest(): Promise<ExtensionManifest>;
+    /** Checks if url actually exists */
+    private _exists;
+}
+//# sourceMappingURL=RemoteExtensionProvider.d.ts.map

package/lib/cjs/extension/providers/RemoteExtensionProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteExtensionProvider.d.ts","sourceRoot":"","sources":["../../../../src/extension/providers/RemoteExtensionProvider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAGtB;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAInD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,4DAA4D;IAC5D,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAEJ,MAAM,EAAE,4BAA4B;IAIjE;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAQvC;;;OAGG;IACU,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAQtD,oCAAoC;YACtB,OAAO;CAWtB"}

package/lib/cjs/extension/providers/RemoteExtensionProvider.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemoteExtensionProvider = void 0;
+const ExtensionLoadScript_1 = require("./ExtensionLoadScript");
+/**
+ * Implements a "remote" extension.
+ * Remote extensions are hosted on an external server.
+ * The execute() and getManifest() methods are used by the ExtensionAdmin to load and execute the extension.
+ * @alpha
+ */
+class RemoteExtensionProvider {
+    constructor(_props) {
+        this._props = _props;
+        this.hostname = new URL(this._props.jsUrl).hostname.replace("www", "");
+    }
+    /**
+     * Attempts to execute an extension.
+     * Throws an error if the provided jsUrl is not accessible.
+     */
+    async execute() {
+        const doesUrlExist = await this._exists(this._props.jsUrl);
+        if (!doesUrlExist) {
+            throw new Error(`Extension at ${this._props.jsUrl} could not be found.`);
+        }
+        return (0, ExtensionLoadScript_1.loadScript)(this._props.jsUrl);
+    }
+    /**
+     * Attempts to fetch an extension's manifest (package.json) file.
+     * Throws an error if the provided manifestUrl is not accessible.
+     */
+    async getManifest() {
+        const doesUrlExist = await this._exists(this._props.manifestUrl);
+        if (!doesUrlExist) {
+            throw new Error(`Manifest at ${this._props.manifestUrl} could not be found.`);
+        }
+        return (await fetch(this._props.manifestUrl)).json();
+    }
+    /** Checks if url actually exists */
+    async _exists(url) {
+        let exists = false;
+        try {
+            const response = await fetch(url, { method: "HEAD" });
+            if (response.status === 200)
+                exists = true;
+        }
+        catch (error) {
+            exists = false;
+        }
+        return exists;
+    }
+}
+exports.RemoteExtensionProvider = RemoteExtensionProvider;
+//# sourceMappingURL=RemoteExtensionProvider.js.map

package/lib/cjs/extension/providers/RemoteExtensionProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteExtensionProvider.js","sourceRoot":"","sources":["../../../../src/extension/providers/RemoteExtensionProvider.ts"],"names":[],"mappings":";;;AAQA,+DAAmD;AAanD;;;;;GAKG;AACH,MAAa,uBAAuB;IAIlC,YAA6B,MAAoC;QAApC,WAAM,GAAN,MAAM,CAA8B;QAC/D,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,OAAO;QAClB,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3D,IAAI,CAAC,YAAY,EAAE;YACjB,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,MAAM,CAAC,KAAK,sBAAsB,CAAC,CAAC;SAC1E;QACD,OAAO,IAAA,gCAAU,EAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,WAAW;QACtB,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACjE,IAAI,CAAC,YAAY,EAAE;YACjB,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,MAAM,CAAC,WAAW,sBAAsB,CAAC,CAAC;SAC/E;QACD,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,CAAC;IAED,oCAAoC;IAC5B,KAAK,CAAC,OAAO,CAAC,GAAW;QAC/B,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,IAAI;YACF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACtD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;gBACzB,MAAM,GAAG,IAAI,CAAC;SACjB;QAAC,OAAO,KAAK,EAAE;YACd,MAAM,GAAG,KAAK,CAAC;SAChB;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA5CD,0DA4CC","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 type {\r\n  ExtensionManifest,\r\n  ExtensionProvider,\r\n} from \"../Extension\";\r\nimport { loadScript } from \"./ExtensionLoadScript\";\r\n\r\n/**\r\n * Required props for a remote extension provider\r\n * @alpha\r\n */\r\nexport interface RemoteExtensionProviderProps {\r\n  /** URL where the extension entry point can be loaded from */\r\n  jsUrl: string;\r\n  /** URL where the manifest (package.json) can be loaded from */\r\n  manifestUrl: string;\r\n}\r\n\r\n/**\r\n * Implements a \"remote\" extension.\r\n * Remote extensions are hosted on an external server.\r\n * The execute() and getManifest() methods are used by the ExtensionAdmin to load and execute the extension.\r\n * @alpha\r\n */\r\nexport class RemoteExtensionProvider implements ExtensionProvider {\r\n  /** The name of the server where the extension is hosted. */\r\n  public readonly hostname: string;\r\n\r\n  constructor(private readonly _props: RemoteExtensionProviderProps) {\r\n    this.hostname = new URL(this._props.jsUrl).hostname.replace(\"www\", \"\");\r\n  }\r\n\r\n  /**\r\n   * Attempts to execute an extension.\r\n   * Throws an error if the provided jsUrl is not accessible.\r\n   */\r\n  public async execute(): Promise<string> {\r\n    const doesUrlExist = await this._exists(this._props.jsUrl);\r\n    if (!doesUrlExist) {\r\n      throw new Error(`Extension at ${this._props.jsUrl} could not be found.`);\r\n    }\r\n    return loadScript(this._props.jsUrl);\r\n  }\r\n\r\n  /**\r\n   * Attempts to fetch an extension's manifest (package.json) file.\r\n   * Throws an error if the provided manifestUrl is not accessible.\r\n   */\r\n  public async getManifest(): Promise<ExtensionManifest> {\r\n    const doesUrlExist = await this._exists(this._props.manifestUrl);\r\n    if (!doesUrlExist) {\r\n      throw new Error(`Manifest at ${this._props.manifestUrl} could not be found.`);\r\n    }\r\n    return (await fetch(this._props.manifestUrl)).json();\r\n  }\r\n\r\n  /** Checks if url actually exists */\r\n  private async _exists(url: string): Promise<boolean> {\r\n    let exists = false;\r\n    try {\r\n      const response = await fetch(url, { method: \"HEAD\" });\r\n      if (response.status === 200)\r\n        exists = true;\r\n    } catch (error) {\r\n      exists = false;\r\n    }\r\n    return exists;\r\n  }\r\n}\r\n"]}

package/lib/cjs/extension/providers/ServiceExtensionProvider.d.ts

@@ -0,0 +1,37 @@
+import type { ExtensionManifest, ExtensionProvider } from "../Extension";
+/**
+ * Required props for an extension uploaded to Bentley's Extension Service
+ * @alpha
+ */
+export interface ServiceExtensionProviderProps {
+    /** Name of the uploaded extension */
+    name: string;
+    /** Version number (Semantic Versioning) */
+    version: string;
+    /** iTwin Id */
+    iTwinId: string;
+}
+/**
+ * Implements an Extension from the Extension Service via the ServiceExtensionProviderProps.
+ * Service extensions are extensions hosted on Bentley's Extension Service.
+ * The execute() and getManifest() methods are used by the ExtensionAdmin to load and execute the extension.
+ * @alpha
+ */
+export declare class ServiceExtensionProvider implements ExtensionProvider {
+    private readonly _props;
+    constructor(_props: ServiceExtensionProviderProps);
+    /** Returns the extension's manifest (package.json) from the ExtensionService.
+     * Throws an error if the manifest cannot be found.
+     */
+    getManifest(): Promise<ExtensionManifest>;
+    /** Executes the javascript main file (the bundled index.js) of an extension from the Extension Service.
+     * Throws an error if the file cannot be found.
+     */
+    execute(): Promise<any>;
+    /** Checks if url actually exists */
+    private _exists;
+    /** Fetches the extension from the ExtensionService.
+     */
+    private _getExtensionFiles;
+}
+//# sourceMappingURL=ServiceExtensionProvider.d.ts.map

package/lib/cjs/extension/providers/ServiceExtensionProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceExtensionProvider.d.ts","sourceRoot":"","sources":["../../../../src/extension/providers/ServiceExtensionProvider.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,iBAAiB,EAAE,iBAAiB,EACrC,MAAM,cAAc,CAAC;AAEtB;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,YAAW,iBAAiB;IAEpD,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,6BAA6B;IAElE;;OAEG;IACU,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAYtD;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC;IAYpC,oCAAoC;YACtB,OAAO;IAYrB;OACG;YACW,kBAAkB;CAyBjC"}

package/lib/cjs/extension/providers/ServiceExtensionProvider.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceExtensionProvider = 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 semver_1 = require("semver");
+const IModelApp_1 = require("../../IModelApp");
+const ExtensionLoadScript_1 = require("./ExtensionLoadScript");
+const ExtensionServiceClient_1 = require("./ExtensionServiceClient");
+/**
+ * Implements an Extension from the Extension Service via the ServiceExtensionProviderProps.
+ * Service extensions are extensions hosted on Bentley's Extension Service.
+ * The execute() and getManifest() methods are used by the ExtensionAdmin to load and execute the extension.
+ * @alpha
+ */
+class ServiceExtensionProvider {
+    constructor(_props) {
+        this._props = _props;
+    }
+    /** Returns the extension's manifest (package.json) from the ExtensionService.
+     * Throws an error if the manifest cannot be found.
+     */
+    async getManifest() {
+        const loadedExtensionProps = await this._getExtensionFiles(this._props);
+        if (!loadedExtensionProps)
+            throw new Error(`Error loading manifest for Extension ${this._props.name}.`);
+        const doesUrlExist = await this._exists(loadedExtensionProps.manifest.url);
+        if (!doesUrlExist)
+            throw new Error(`Manifest at ${loadedExtensionProps.manifest.url} could not be found.`);
+        return (await fetch(loadedExtensionProps.manifest.url)).json();
+    }
+    /** Executes the javascript main file (the bundled index.js) of an extension from the Extension Service.
+     * Throws an error if the file cannot be found.
+     */
+    async execute() {
+        const loadedExtensionProps = await this._getExtensionFiles(this._props);
+        if (!loadedExtensionProps)
+            throw new Error(`Error executing Extension ${this._props.name}.`);
+        const doesUrlExist = await this._exists(loadedExtensionProps.main.url);
+        if (!doesUrlExist)
+            throw new Error(`Main javascript file at ${loadedExtensionProps.main.url} could not be found.`);
+        return (0, ExtensionLoadScript_1.loadScript)(loadedExtensionProps.main.url);
+    }
+    /** Checks if url actually exists */
+    async _exists(url) {
+        let exists = false;
+        try {
+            const response = await fetch(url, { method: "HEAD" });
+            if (response.status === 200)
+                exists = true;
+        }
+        catch (error) {
+            exists = false;
+        }
+        return exists;
+    }
+    /** Fetches the extension from the ExtensionService.
+     */
+    async _getExtensionFiles(props) {
+        var _a;
+        const extensionClient = new ExtensionServiceClient_1.ExtensionClient();
+        const accessToken = await ((_a = IModelApp_1.IModelApp.authorizationClient) === null || _a === void 0 ? void 0 : _a.getAccessToken());
+        if (!accessToken)
+            return undefined;
+        let extensionProps;
+        if (props.version !== undefined)
+            extensionProps = await extensionClient.getExtensionMetadata(accessToken, props.iTwinId, props.name, props.version);
+        else {
+            const propsArr = await extensionClient.getExtensions(accessToken, props.iTwinId, props.name);
+            extensionProps = propsArr.sort((ext1, ext2) => (0, semver_1.rcompare)(ext1.version, ext2.version, true))[0];
+        }
+        if (extensionProps === undefined || extensionProps.files.length < 1)
+            return undefined;
+        const manifest = extensionProps.files.find((f) => f.url.indexOf("package.json?") > -1);
+        const main = extensionProps.files.find((f) => f.url.indexOf("index.js?") > -1);
+        if (!manifest || !main)
+            return undefined;
+        return { manifest, main };
+    }
+}
+exports.ServiceExtensionProvider = ServiceExtensionProvider;
+//# sourceMappingURL=ServiceExtensionProvider.js.map

package/lib/cjs/extension/providers/ServiceExtensionProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceExtensionProvider.js","sourceRoot":"","sources":["../../../../src/extension/providers/ServiceExtensionProvider.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 { rcompare } from \"semver\";\r\n\r\nimport { IModelApp } from \"../../IModelApp\";\r\nimport { loadScript } from \"./ExtensionLoadScript\";\r\nimport { ExtensionClient, ExtensionMetadata } from \"./ExtensionServiceClient\";\r\n\r\nimport type {\r\n  ExtensionManifest, ExtensionProvider,\r\n} from \"../Extension\";\r\n\r\n/**\r\n * Required props for an extension uploaded to Bentley's Extension Service\r\n * @alpha\r\n */\r\nexport interface ServiceExtensionProviderProps {\r\n  /** Name of the uploaded extension */\r\n  name: string;\r\n  /** Version number (Semantic Versioning) */\r\n  version: string;\r\n  /** iTwin Id */\r\n  iTwinId: string;\r\n}\r\n\r\n/**\r\n * Implements an Extension from the Extension Service via the ServiceExtensionProviderProps.\r\n * Service extensions are extensions hosted on Bentley's Extension Service.\r\n * The execute() and getManifest() methods are used by the ExtensionAdmin to load and execute the extension.\r\n * @alpha\r\n */\r\nexport class ServiceExtensionProvider implements ExtensionProvider {\r\n\r\n  constructor(private readonly _props: ServiceExtensionProviderProps) { }\r\n\r\n  /** Returns the extension's manifest (package.json) from the ExtensionService.\r\n   * Throws an error if the manifest cannot be found.\r\n   */\r\n  public async getManifest(): Promise<ExtensionManifest> {\r\n    const loadedExtensionProps = await this._getExtensionFiles(this._props);\r\n    if (!loadedExtensionProps)\r\n      throw new Error(`Error loading manifest for Extension ${this._props.name}.`);\r\n\r\n    const doesUrlExist = await this._exists(loadedExtensionProps.manifest.url);\r\n    if (!doesUrlExist)\r\n      throw new Error(`Manifest at ${loadedExtensionProps.manifest.url} could not be found.`);\r\n\r\n    return (await fetch(loadedExtensionProps.manifest.url)).json();\r\n  }\r\n\r\n  /** Executes the javascript main file (the bundled index.js) of an extension from the Extension Service.\r\n   * Throws an error if the file cannot be found.\r\n   */\r\n  public async execute(): Promise<any> {\r\n    const loadedExtensionProps = await this._getExtensionFiles(this._props);\r\n    if (!loadedExtensionProps)\r\n      throw new Error(`Error executing Extension ${this._props.name}.`);\r\n\r\n    const doesUrlExist = await this._exists(loadedExtensionProps.main.url);\r\n    if (!doesUrlExist)\r\n      throw new Error(`Main javascript file at ${loadedExtensionProps.main.url} could not be found.`);\r\n\r\n    return loadScript(loadedExtensionProps.main.url);\r\n  }\r\n\r\n  /** Checks if url actually exists */\r\n  private async _exists(url: string): Promise<boolean> {\r\n    let exists = false;\r\n    try {\r\n      const response = await fetch(url, { method: \"HEAD\" });\r\n      if (response.status === 200)\r\n        exists = true;\r\n    } catch (error) {\r\n      exists = false;\r\n    }\r\n    return exists;\r\n  }\r\n\r\n  /** Fetches the extension from the ExtensionService.\r\n   */\r\n  private async _getExtensionFiles(props: ServiceExtensionProviderProps) {\r\n    const extensionClient = new ExtensionClient();\r\n\r\n    const accessToken = await IModelApp.authorizationClient?.getAccessToken();\r\n    if (!accessToken)\r\n      return undefined;\r\n\r\n    let extensionProps: ExtensionMetadata | undefined;\r\n    if (props.version !== undefined)\r\n      extensionProps = await extensionClient.getExtensionMetadata(accessToken, props.iTwinId, props.name, props.version);\r\n    else {\r\n      const propsArr = await extensionClient.getExtensions(accessToken, props.iTwinId, props.name);\r\n      extensionProps = propsArr.sort((ext1, ext2) => rcompare(ext1.version, ext2.version, true))[0];\r\n    }\r\n\r\n    if (extensionProps === undefined || extensionProps.files.length < 1)\r\n      return undefined;\r\n\r\n    const manifest = extensionProps.files.find((f) => f.url.indexOf(\"package.json?\") > -1);\r\n    const main = extensionProps.files.find((f) => f.url.indexOf(\"index.js?\") > -1);\r\n    if (!manifest || !main)\r\n      return undefined;\r\n\r\n    return { manifest, main };\r\n  }\r\n}\r\n"]}

package/lib/esm/FrontendLoggerCategory.d.ts

@@ -26,6 +26,10 @@ export declare enum FrontendLoggerCategory {
      */
     RealityData = "core-frontend.RealityData",
     /** The logger category used for creating and displaying graphics. */
-    Render = "core-frontend.Render"
+    Render = "core-frontend.Render",
+    /** The logger category used for loading and executing Extensions
+     * @alpha
+     */
+    Extensions = "core-frontend.Extensions"
 }
 //# sourceMappingURL=FrontendLoggerCategory.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"FrontendLoggerCategory.d.ts","sourceRoot":"","sources":["../../src/FrontendLoggerCategory.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;;;GAKG;AACH,oBAAY,sBAAsB;IAChC,OAAO,kBAAkB;IAEzB,4FAA4F;IAC5F,gBAAgB,mCAAmC;IAEnD,6CAA6C;IAC7C,SAAS,4BAA4B;IAErC,4DAA4D;IAC5D,OAAO,0BAA0B;IAEjC;;;OAGG;IACH,eAAe,kCAAkC;IACjD;;;OAGG;IACH,WAAW,8BAA8B;IAEzC,qEAAqE;IACrE,MAAM,yBAAyB;CAChC"}
+{"version":3,"file":"FrontendLoggerCategory.d.ts","sourceRoot":"","sources":["../../src/FrontendLoggerCategory.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;;;GAKG;AACH,oBAAY,sBAAsB;IAChC,OAAO,kBAAkB;IAEzB,4FAA4F;IAC5F,gBAAgB,mCAAmC;IAEnD,6CAA6C;IAC7C,SAAS,4BAA4B;IAErC,4DAA4D;IAC5D,OAAO,0BAA0B;IAEjC;;;OAGG;IACH,eAAe,kCAAkC;IACjD;;;OAGG;IACH,WAAW,8BAA8B;IAEzC,qEAAqE;IACrE,MAAM,yBAAyB;IAE/B;;OAEG;IACH,UAAU,6BAA6B;CACxC"}

package/lib/esm/FrontendLoggerCategory.js

@@ -32,5 +32,9 @@ export var FrontendLoggerCategory;
     FrontendLoggerCategory["RealityData"] = "core-frontend.RealityData";
     /** The logger category used for creating and displaying graphics. */
     FrontendLoggerCategory["Render"] = "core-frontend.Render";
+    /** The logger category used for loading and executing Extensions
+     * @alpha
+     */
+    FrontendLoggerCategory["Extensions"] = "core-frontend.Extensions";
 })(FrontendLoggerCategory || (FrontendLoggerCategory = {}));
 //# sourceMappingURL=FrontendLoggerCategory.js.map