@itwin/core-backend 4.5.0-dev.8 → 4.6.0-dev.0

package/lib/cjs/rpc/web/response.js.map

@@ -1 +1 @@
-{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../../src/rpc/web/response.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module RpcInterface\n */\n\nimport {\n  HttpServerRequest,\n  HttpServerResponse,\n  ReadableFormData,\n  RpcContentType,\n  RpcMultipart,\n  RpcProtocol,\n  RpcRequestFulfillment,\n  RpcRequestStatus,\n  RpcResponseCacheControl,\n  SerializedRpcRequest,\n  WEB_RPC_CONSTANTS,\n  WebAppRpcProtocol,\n  WebAppRpcRequest,\n} from \"@itwin/core-common\";\n\n/* eslint-disable deprecation/deprecation */\n\nfunction configureResponse(protocol: WebAppRpcProtocol, request: SerializedRpcRequest, fulfillment: RpcRequestFulfillment, res: HttpServerResponse) {\n  const success = protocol.getStatus(fulfillment.status) === RpcRequestStatus.Resolved;\n  // TODO: Use stale-while-revalidate in cache headers. This needs to be tested, and does not currently have support in the router/caching-service.\n  // This will allow browsers to use stale cached responses while also revalidating with the router, allowing us to start up a backend if necessary.\n\n  // RPC Caching Service uses the s-maxage header to determine the TTL for the redis cache.\n  const oneHourInSeconds = 3600;\n  if (success && request.caching === RpcResponseCacheControl.Immutable) {\n    // If response size is > 50 MB, do not cache it.\n    if (fulfillment.result.objects.length > (50 * 10 ** 7)) {\n      res.set(\"Cache-Control\", \"no-store\");\n    } else if (request.operation.operationName === \"generateTileContent\") {\n      res.set(\"Cache-Control\", \"no-store\");\n    } else if (request.operation.operationName === \"getConnectionProps\") {\n      // GetConnectionprops can't be cached on the browser longer than the lifespan of the backend. The lifespan of backend may shrink too. Keep it at 1 second to be safe.\n      res.set(\"Cache-Control\", `s-maxage=${oneHourInSeconds * 24}, max-age=1, immutable`);\n    } else if (request.operation.operationName === \"getTileCacheContainerUrl\") {\n      // getTileCacheContainerUrl returns a SAS with an expiry of 23:59:59. We can't exceed that time when setting the max-age.\n      res.set(\"Cache-Control\", `s-maxage=${oneHourInSeconds * 23}, max-age=${oneHourInSeconds * 23}, immutable`);\n    } else {\n      res.set(\"Cache-Control\", `s-maxage=${oneHourInSeconds * 24}, max-age=${oneHourInSeconds * 48}, immutable`);\n    }\n  }\n\n  if (fulfillment.retry) {\n    res.set(\"Retry-After\", fulfillment.retry);\n  }\n}\n\nfunction configureText(fulfillment: RpcRequestFulfillment, res: HttpServerResponse): string {\n  res.set(WEB_RPC_CONSTANTS.CONTENT, WEB_RPC_CONSTANTS.TEXT);\n  return (fulfillment.status === 204) ? \"\" : fulfillment.result.objects;\n}\n\nfunction configureBinary(fulfillment: RpcRequestFulfillment, res: HttpServerResponse): Buffer {\n  res.set(WEB_RPC_CONSTANTS.CONTENT, WEB_RPC_CONSTANTS.BINARY);\n  const data = fulfillment.result.data[0];\n  return Buffer.isBuffer(data) ? data : Buffer.from(data);\n}\n\nfunction configureMultipart(fulfillment: RpcRequestFulfillment, res: HttpServerResponse): ReadableFormData {\n  const response = RpcMultipart.createStream(fulfillment.result);\n  const headers = response.getHeaders();\n  for (const header in headers) {\n    if (headers.hasOwnProperty(header)) {\n      res.set(header, headers[header]);\n    }\n  }\n\n  return response;\n}\n\nfunction configureStream(fulfillment: RpcRequestFulfillment) {\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n  return fulfillment.result.stream!;\n}\n\n/** @internal */\nexport async function sendResponse(protocol: WebAppRpcProtocol, request: SerializedRpcRequest, fulfillment: RpcRequestFulfillment, req: HttpServerRequest, res: HttpServerResponse) {\n  const versionHeader = protocol.protocolVersionHeaderName;\n  if (versionHeader && RpcProtocol.protocolVersion) {\n    res.set(versionHeader, RpcProtocol.protocolVersion.toString());\n  }\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  const { Readable, Stream } = await import(/* webpackIgnore: true */ \"stream\");\n  const { createGzip } = await import(/* webpackIgnore: true */ \"zlib\");\n\n  const transportType = WebAppRpcRequest.computeTransportType(fulfillment.result, fulfillment.rawResult);\n  let responseBody;\n  if (transportType === RpcContentType.Binary) {\n    responseBody = configureBinary(fulfillment, res);\n  } else if (transportType === RpcContentType.Multipart) {\n    responseBody = configureMultipart(fulfillment, res);\n  } else if (transportType === RpcContentType.Stream) {\n    responseBody = configureStream(fulfillment);\n  } else {\n    responseBody = configureText(fulfillment, res);\n  }\n\n  configureResponse(protocol, request, fulfillment, res);\n  res.status(fulfillment.status);\n\n  if (fulfillment.allowCompression && req.header(\"Accept-Encoding\")?.includes(\"gzip\")) {\n    res.set(\"Content-Encoding\", \"gzip\");\n    const readableResponseBody = (responseBody instanceof Stream) ? responseBody : Readable.from(responseBody);\n    responseBody = readableResponseBody.pipe(createGzip());\n  }\n\n  // This check should in theory look for instances of Readable, but that would break backend implementation at\n  // core/backend/src/RpcBackend.ts\n  if (responseBody instanceof Stream) {\n    responseBody.pipe(res);\n  } else {\n    res.send(responseBody);\n  }\n}\n"]}
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../../src/rpc/web/response.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module RpcInterface\n */\n\nimport { Logger } from \"@itwin/core-bentley\";\nimport {\n  CommonLoggerCategory,\n  HttpServerRequest,\n  HttpServerResponse,\n  ReadableFormData,\n  RpcContentType,\n  RpcMultipart,\n  RpcProtocol,\n  RpcRequestFulfillment,\n  RpcRequestStatus,\n  RpcResponseCacheControl,\n  SerializedRpcRequest,\n  WEB_RPC_CONSTANTS,\n  WebAppRpcProtocol,\n  WebAppRpcRequest,\n} from \"@itwin/core-common\";\n\n/* eslint-disable deprecation/deprecation */\n\nfunction configureResponse(protocol: WebAppRpcProtocol, request: SerializedRpcRequest, fulfillment: RpcRequestFulfillment, res: HttpServerResponse) {\n  const success = protocol.getStatus(fulfillment.status) === RpcRequestStatus.Resolved;\n  // TODO: Use stale-while-revalidate in cache headers. This needs to be tested, and does not currently have support in the router/caching-service.\n  // This will allow browsers to use stale cached responses while also revalidating with the router, allowing us to start up a backend if necessary.\n\n  // RPC Caching Service uses the s-maxage header to determine the TTL for the redis cache.\n  const oneHourInSeconds = 3600;\n  if (success && request.caching === RpcResponseCacheControl.Immutable) {\n    // If response size is > 50 MB, do not cache it.\n    if (fulfillment.result.objects.length > (50 * 10 ** 7)) {\n      res.set(\"Cache-Control\", \"no-store\");\n    } else if (request.operation.operationName === \"generateTileContent\") {\n      res.set(\"Cache-Control\", \"no-store\");\n    } else if (request.operation.operationName === \"getConnectionProps\") {\n      // GetConnectionprops can't be cached on the browser longer than the lifespan of the backend. The lifespan of backend may shrink too. Keep it at 1 second to be safe.\n      res.set(\"Cache-Control\", `s-maxage=${oneHourInSeconds * 24}, max-age=1, immutable`);\n    } else if (request.operation.operationName === \"getTileCacheContainerUrl\") {\n      // getTileCacheContainerUrl returns a SAS with an expiry of 23:59:59. We can't exceed that time when setting the max-age.\n      res.set(\"Cache-Control\", `s-maxage=${oneHourInSeconds * 23}, max-age=${oneHourInSeconds * 23}, immutable`);\n    } else {\n      res.set(\"Cache-Control\", `s-maxage=${oneHourInSeconds * 24}, max-age=${oneHourInSeconds * 48}, immutable`);\n    }\n  }\n\n  if (fulfillment.retry) {\n    res.set(\"Retry-After\", fulfillment.retry);\n  }\n}\n\nfunction configureText(fulfillment: RpcRequestFulfillment, res: HttpServerResponse): string {\n  res.set(WEB_RPC_CONSTANTS.CONTENT, WEB_RPC_CONSTANTS.TEXT);\n  return (fulfillment.status === 204) ? \"\" : fulfillment.result.objects;\n}\n\nfunction configureBinary(fulfillment: RpcRequestFulfillment, res: HttpServerResponse): Buffer {\n  res.set(WEB_RPC_CONSTANTS.CONTENT, WEB_RPC_CONSTANTS.BINARY);\n  const data = fulfillment.result.data[0];\n  return Buffer.isBuffer(data) ? data : Buffer.from(data);\n}\n\nfunction configureMultipart(fulfillment: RpcRequestFulfillment, res: HttpServerResponse): ReadableFormData {\n  const response = RpcMultipart.createStream(fulfillment.result);\n  const headers = response.getHeaders();\n  for (const header in headers) {\n    if (headers.hasOwnProperty(header)) {\n      res.set(header, headers[header]);\n    }\n  }\n\n  return response;\n}\n\nfunction configureStream(fulfillment: RpcRequestFulfillment) {\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n  return fulfillment.result.stream!;\n}\n\n/** @internal */\nexport async function sendResponse(protocol: WebAppRpcProtocol, request: SerializedRpcRequest, fulfillment: RpcRequestFulfillment, req: HttpServerRequest, res: HttpServerResponse) {\n  logResponse(request, fulfillment.status, fulfillment.rawResult);\n\n  const versionHeader = protocol.protocolVersionHeaderName;\n  if (versionHeader && RpcProtocol.protocolVersion) {\n    res.set(versionHeader, RpcProtocol.protocolVersion.toString());\n  }\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  const { Readable, Stream } = await import(/* webpackIgnore: true */ \"stream\");\n  const { createGzip } = await import(/* webpackIgnore: true */ \"zlib\");\n\n  const transportType = WebAppRpcRequest.computeTransportType(fulfillment.result, fulfillment.rawResult);\n  let responseBody;\n  if (transportType === RpcContentType.Binary) {\n    responseBody = configureBinary(fulfillment, res);\n  } else if (transportType === RpcContentType.Multipart) {\n    responseBody = configureMultipart(fulfillment, res);\n  } else if (transportType === RpcContentType.Stream) {\n    responseBody = configureStream(fulfillment);\n  } else {\n    responseBody = configureText(fulfillment, res);\n  }\n\n  configureResponse(protocol, request, fulfillment, res);\n  res.status(fulfillment.status);\n\n  if (fulfillment.allowCompression && req.header(\"Accept-Encoding\")?.includes(\"gzip\")) {\n    res.set(\"Content-Encoding\", \"gzip\");\n    const readableResponseBody = (responseBody instanceof Stream) ? responseBody : Readable.from(responseBody);\n    responseBody = readableResponseBody.pipe(createGzip());\n  }\n\n  // This check should in theory look for instances of Readable, but that would break backend implementation at\n  // core/backend/src/RpcBackend.ts\n  if (responseBody instanceof Stream) {\n    responseBody.pipe(res);\n  } else {\n    res.send(responseBody);\n  }\n}\n\nfunction logResponse(request: SerializedRpcRequest, statusCode: number, resultObj: unknown) {\n  const metadata = {\n    ActivityId: request.id, // eslint-disable-line @typescript-eslint/naming-convention\n    method: request.method,\n    path: request.path,\n    operation: request.operation,\n    statusCode,\n    error: resultObj instanceof Error ? resultObj : undefined,\n  };\n\n  if (statusCode < 400)\n    Logger.logInfo(CommonLoggerCategory.RpcInterfaceBackend, \"RPC over HTTP success response\", metadata);\n  else\n    Logger.logError(CommonLoggerCategory.RpcInterfaceBackend, \"RPC over HTTP failure response\", metadata);\n}\n"]}

package/lib/cjs/rpc-impl/RpcBriefcaseUtility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RpcBriefcaseUtility.d.ts","sourceRoot":"","sources":["../../../src/rpc-impl/RpcBriefcaseUtility.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAA0D,MAAM,qBAAqB,CAAC;AAC1G,OAAO,EACL,cAAc,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,cAAc,EAAiB,WAAW,EAAsB,QAAQ,EACpI,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAe,QAAQ,EAAc,MAAM,aAAa,CAAC;AAMhE,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,WAAW,CAAC;IACtB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,iBAAiB,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,cAAc,KAAK,MAAM,CAAC,EAAE,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AACD;;;GAGG;AACH,qBAAa,mBAAmB;mBAET,eAAe;IA2DpC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAgD;mBAC5D,aAAa;IAelC;;;;OAIG;WACiB,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc;WAQ/D,IAAI,CAAC,IAAI,EAAE,mBAAmB,GAAG;QAAC,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC3G;;OAEG;WAEiB,IAAI,CAAC,IAAI,EAAE,mBAAmB,GAAG;QAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;WAkEnG,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAC7K;;OAEG;WAEiB,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAQ1L"}
+{"version":3,"file":"RpcBriefcaseUtility.d.ts","sourceRoot":"","sources":["../../../src/rpc-impl/RpcBriefcaseUtility.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAA0D,MAAM,qBAAqB,CAAC;AAC1G,OAAO,EACL,cAAc,EAAE,qBAAqB,EAAe,kBAAkB,EAAE,cAAc,EAAiB,WAAW,EAAsB,QAAQ,EACjJ,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAe,QAAQ,EAAc,MAAM,aAAa,CAAC;AAMhE,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,WAAW,CAAC;IACtB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,iBAAiB,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,cAAc,KAAK,MAAM,CAAC,EAAE,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AACD;;;GAGG;AACH,qBAAa,mBAAmB;mBAET,eAAe;IA2DpC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAgD;mBAC5D,aAAa;IAelC;;;;OAIG;WACiB,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc;WAQ/D,IAAI,CAAC,IAAI,EAAE,mBAAmB,GAAG;QAAE,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC5G;;OAEG;WAEiB,IAAI,CAAC,IAAI,EAAE,mBAAmB,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;WAgEpG,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAC7K;;OAEG;WAEiB,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAQ1L"}

package/lib/cjs/rpc-impl/RpcBriefcaseUtility.js

@@ -99,7 +99,7 @@ class RpcBriefcaseUtility {
     static async findOpenIModel(accessToken, iModel) {
         const iModelDb = IModelDb_1.IModelDb.findByKey(iModel.key);
         // call refreshContainer, just in case this is a V2 checkpoint whose sasToken is about to expire, or its default transaction is about to be restarted.
-        await iModelDb.refreshContainer(accessToken);
+        await iModelDb.refreshContainerForRpc(accessToken);
         return iModelDb;
     }
     /**
@@ -108,41 +108,40 @@ class RpcBriefcaseUtility {
      */
     static async open(args) {
         const { activity, tokenProps, syncMode } = args;
-        core_bentley_1.Logger.logTrace(loggerCategory, "RpcBriefcaseUtility.open", () => ({ ...tokenProps }));
+        core_bentley_1.Logger.logTrace(loggerCategory, "RpcBriefcaseUtility.open", tokenProps);
         const timeout = args.timeout ?? 1000;
         if (syncMode === core_common_1.SyncMode.PullOnly || syncMode === core_common_1.SyncMode.PullAndPush) {
             const briefcaseDb = await core_bentley_1.BeDuration.race(timeout, this.openBriefcase(args));
             if (briefcaseDb === undefined) {
-                core_bentley_1.Logger.logTrace(loggerCategory, "Open briefcase - pending", () => ({ ...tokenProps }));
+                core_bentley_1.Logger.logTrace(loggerCategory, "Open briefcase - pending", tokenProps);
                 throw new core_common_1.RpcPendingResponse(); // eslint-disable-line deprecation/deprecation
             }
             // note: usage is logged in the function BriefcaseManager.downloadNewBriefcaseAndOpen
             return briefcaseDb;
         }
-        (0, core_bentley_1.assert)(undefined !== tokenProps.iModelId);
-        (0, core_bentley_1.assert)(undefined !== tokenProps.iTwinId);
-        (0, core_bentley_1.assert)(undefined !== tokenProps.changeset);
+        if (!tokenProps.iModelId || !tokenProps.iTwinId || !tokenProps.changeset)
+            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadArg, "invalid arguments");
         const checkpoint = {
             iModelId: tokenProps.iModelId,
             iTwinId: tokenProps.iTwinId,
             changeset: tokenProps.changeset,
             accessToken: activity.accessToken,
         };
-        // opening a checkpoint, readonly.
+        // opening a checkpoint.
         let db;
         // first check if it's already open
         db = IModelDb_1.SnapshotDb.tryFindByKey(CheckpointManager_1.CheckpointManager.getKey(checkpoint));
         if (db) {
-            core_bentley_1.Logger.logTrace(loggerCategory, "Checkpoint was already open", () => ({ ...tokenProps }));
+            core_bentley_1.Logger.logTrace(loggerCategory, "Checkpoint was already open", tokenProps);
             return db;
         }
         try {
             // now try V2 checkpoint
-            db = await IModelDb_1.SnapshotDb.openCheckpointV2(checkpoint);
-            core_bentley_1.Logger.logTrace(loggerCategory, "using V2 checkpoint briefcase", () => ({ ...tokenProps }));
+            db = await IModelDb_1.SnapshotDb.openCheckpointFromRpc(checkpoint);
+            core_bentley_1.Logger.logTrace(loggerCategory, "using V2 checkpoint", tokenProps);
         }
         catch (e) {
-            core_bentley_1.Logger.logTrace(loggerCategory, "unable to open V2 checkpoint - falling back to V1 checkpoint", () => ({ error: core_bentley_1.BentleyError.getErrorProps(e), ...tokenProps }));
+            core_bentley_1.Logger.logTrace(loggerCategory, "unable to open V2 checkpoint - falling back to V1 checkpoint", { error: core_bentley_1.BentleyError.getErrorProps(e), ...tokenProps });
             // this isn't a v2 checkpoint. Set up a race between the specified timeout period and the open. Throw an RpcPendingResponse exception if the timeout happens first.
             const request = {
                 checkpoint,
@@ -151,10 +150,10 @@ class RpcBriefcaseUtility {
             };
             db = await core_bentley_1.BeDuration.race(timeout, CheckpointManager_1.V1CheckpointManager.getCheckpointDb(request));
             if (db === undefined) {
-                core_bentley_1.Logger.logTrace(loggerCategory, "Open V1 checkpoint - pending", () => ({ ...tokenProps }));
+                core_bentley_1.Logger.logTrace(loggerCategory, "Open V1 checkpoint - pending", tokenProps);
                 throw new core_common_1.RpcPendingResponse(); // eslint-disable-line deprecation/deprecation
             }
-            core_bentley_1.Logger.logTrace(loggerCategory, "Opened V1 checkpoint", () => ({ ...tokenProps }));
+            core_bentley_1.Logger.logTrace(loggerCategory, "Opened V1 checkpoint", tokenProps);
         }
         return db;
     }

package/lib/cjs/rpc-impl/RpcBriefcaseUtility.js.map

@@ -1 +1 @@
-{"version":3,"file":"RpcBriefcaseUtility.js","sourceRoot":"","sources":["../../../src/rpc-impl/RpcBriefcaseUtility.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module RpcInterface\n */\n\nimport { AccessToken, assert, BeDuration, BentleyError, IModelStatus, Logger } from \"@itwin/core-bentley\";\nimport {\n  BriefcaseProps, IModelConnectionProps, IModelRpcOpenProps, IModelRpcProps, IModelVersion, RpcActivity, RpcPendingResponse, SyncMode,\n} from \"@itwin/core-common\";\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\nimport { BriefcaseManager, RequestNewBriefcaseArg } from \"../BriefcaseManager\";\nimport { CheckpointManager, CheckpointProps, V1CheckpointManager } from \"../CheckpointManager\";\nimport { BriefcaseDb, IModelDb, SnapshotDb } from \"../IModelDb\";\nimport { IModelHost } from \"../IModelHost\";\nimport { IModelJsFs } from \"../IModelJsFs\";\n\nconst loggerCategory: string = BackendLoggerCategory.IModelDb;\n\n/** @internal */\nexport interface DownloadAndOpenArgs {\n  activity: RpcActivity; // eslint-disable-line deprecation/deprecation\n  tokenProps: IModelRpcOpenProps;\n  syncMode: SyncMode;\n  fileNameResolvers?: ((arg: BriefcaseProps) => string)[];\n  timeout?: number;\n  forceDownload?: boolean;\n}\n/**\n * Utility to open the iModel for RPC interfaces\n * @internal\n */\nexport class RpcBriefcaseUtility {\n\n  private static async downloadAndOpen(args: DownloadAndOpenArgs): Promise<BriefcaseDb> {\n    const { activity, tokenProps } = args;\n    const accessToken = activity.accessToken;\n    assert(undefined !== tokenProps.iModelId);\n\n    const iModelId = tokenProps.iModelId;\n    let myBriefcaseIds: number[];\n    if (args.syncMode === SyncMode.PullOnly) {\n      myBriefcaseIds = [0]; // PullOnly means briefcaseId 0\n    } else {\n      // check with iModelHub and see if we already have acquired any briefcaseIds\n      myBriefcaseIds = await IModelHost.hubAccess.getMyBriefcaseIds({ accessToken, iModelId });\n    }\n\n    const resolvers = args.fileNameResolvers ?? [(arg) => BriefcaseManager.getFileName(arg)];\n\n    // see if we can open any of the briefcaseIds we already acquired from iModelHub\n    if (resolvers) {\n      for (const resolver of resolvers) {\n        for (const briefcaseId of myBriefcaseIds) {\n          const fileName = resolver({ briefcaseId, iModelId });\n          if (IModelJsFs.existsSync(fileName)) {\n            const briefcaseDb = BriefcaseDb.findByFilename(fileName);\n            if (briefcaseDb !== undefined)\n              return briefcaseDb as BriefcaseDb;\n            try {\n              if (args.forceDownload)\n                throw new Error(); // causes delete below\n              const db = await BriefcaseDb.open({ fileName });\n              if (db.changeset.id !== tokenProps.changeset?.id) {\n                assert(undefined !== tokenProps.changeset);\n                const toIndex = tokenProps.changeset?.index ??\n                  (await IModelHost.hubAccess.getChangesetFromVersion({ accessToken, iModelId, version: IModelVersion.asOfChangeSet(tokenProps.changeset.id) })).index;\n                await BriefcaseManager.pullAndApplyChangesets(db, { accessToken, toIndex });\n              }\n              return db;\n            } catch (error: any) {\n              if (!(error.errorNumber === IModelStatus.AlreadyOpen))\n                // somehow we have this briefcaseId and the file exists, but we can't open it. Delete it.\n                await BriefcaseManager.deleteBriefcaseFiles(fileName, accessToken);\n            }\n          }\n        }\n      }\n    }\n\n    // no local briefcase available. Download one and open it.\n    assert(undefined !== tokenProps.iTwinId);\n    const request: RequestNewBriefcaseArg = {\n      accessToken,\n      iTwinId: tokenProps.iTwinId,\n      iModelId,\n      briefcaseId: args.syncMode === SyncMode.PullOnly ? 0 : undefined, // if briefcaseId is undefined, we'll acquire a new one.\n    };\n\n    const props = await BriefcaseManager.downloadBriefcase(request);\n    return BriefcaseDb.open(props);\n  }\n\n  private static _briefcasePromises: Map<string, Promise<BriefcaseDb>> = new Map();\n  private static async openBriefcase(args: DownloadAndOpenArgs): Promise<BriefcaseDb> {\n    const key = `${args.tokenProps.iModelId}:${args.tokenProps.changeset?.id}:${args.tokenProps.changeset?.index}:${args.syncMode}`;\n    const cachedPromise = this._briefcasePromises.get(key);\n    if (cachedPromise)\n      return cachedPromise;\n\n    try {\n      const briefcasePromise = this.downloadAndOpen(args); // save the fact that we're working on downloading so if we timeout, we'll reuse this request.\n      this._briefcasePromises.set(key, briefcasePromise);\n      return await briefcasePromise;\n    } finally {\n      this._briefcasePromises.delete(key);  // the download and open is now done\n    }\n  }\n\n  /** find a previously opened iModel for RPC.\n   * @param accessToken necessary (only) for V2 checkpoints to refresh access token in daemon if it has expired. We use the accessToken of the current RPC request\n   * to refresh the daemon, even though it will be used for all authorized users.\n   * @param the IModelRpcProps to locate the opened iModel.\n   */\n  public static async findOpenIModel(accessToken: AccessToken, iModel: IModelRpcProps) {\n    const iModelDb = IModelDb.findByKey(iModel.key);\n\n    // call refreshContainer, just in case this is a V2 checkpoint whose sasToken is about to expire, or its default transaction is about to be restarted.\n    await iModelDb.refreshContainer(accessToken);\n    return iModelDb;\n  }\n\n  public static async open(args: DownloadAndOpenArgs & {syncMode: SyncMode.FixedVersion }): Promise<IModelDb>;\n  /**\n   * @deprecated in 4.4.0 - only `SyncMode.FixedVersion` should be used in RPC backends\n   */\n  // eslint-disable-next-line @typescript-eslint/unified-signatures -- these are separate to explicitly deprecate some SyncMode members.\n  public static async open(args: DownloadAndOpenArgs & {syncMode: Exclude<SyncMode, \"FixedVersion\"> }): Promise<IModelDb>;\n  /**\n   * Download and open a checkpoint or briefcase, ensuring the operation completes within a default timeout. If the time to open exceeds the timeout period,\n   * a RpcPendingResponse exception is thrown\n   */\n  public static async open(args: DownloadAndOpenArgs): Promise<IModelDb> {\n    const { activity, tokenProps, syncMode } = args;\n    Logger.logTrace(loggerCategory, \"RpcBriefcaseUtility.open\", () => ({ ...tokenProps }));\n\n    const timeout = args.timeout ?? 1000;\n    if (syncMode === SyncMode.PullOnly || syncMode === SyncMode.PullAndPush) {\n      const briefcaseDb = await BeDuration.race(timeout, this.openBriefcase(args));\n\n      if (briefcaseDb === undefined) {\n        Logger.logTrace(loggerCategory, \"Open briefcase - pending\", () => ({ ...tokenProps }));\n        throw new RpcPendingResponse(); // eslint-disable-line deprecation/deprecation\n      }\n      // note: usage is logged in the function BriefcaseManager.downloadNewBriefcaseAndOpen\n      return briefcaseDb;\n    }\n\n    assert(undefined !== tokenProps.iModelId);\n    assert(undefined !== tokenProps.iTwinId);\n    assert(undefined !== tokenProps.changeset);\n\n    const checkpoint: CheckpointProps = {\n      iModelId: tokenProps.iModelId,\n      iTwinId: tokenProps.iTwinId,\n      changeset: tokenProps.changeset,\n      accessToken: activity.accessToken,\n    };\n\n    // opening a checkpoint, readonly.\n    let db: SnapshotDb | void;\n    // first check if it's already open\n    db = SnapshotDb.tryFindByKey(CheckpointManager.getKey(checkpoint));\n    if (db) {\n      Logger.logTrace(loggerCategory, \"Checkpoint was already open\", () => ({ ...tokenProps }));\n      return db;\n    }\n\n    try {\n      // now try V2 checkpoint\n      db = await SnapshotDb.openCheckpointV2(checkpoint);\n      Logger.logTrace(loggerCategory, \"using V2 checkpoint briefcase\", () => ({ ...tokenProps }));\n    } catch (e) {\n      Logger.logTrace(loggerCategory, \"unable to open V2 checkpoint - falling back to V1 checkpoint\", () => ({ error: BentleyError.getErrorProps(e), ...tokenProps }));\n\n      // this isn't a v2 checkpoint. Set up a race between the specified timeout period and the open. Throw an RpcPendingResponse exception if the timeout happens first.\n      const request = {\n        checkpoint,\n        localFile: V1CheckpointManager.getFileName(checkpoint),\n        aliasFiles: [],\n      };\n      db = await BeDuration.race(timeout, V1CheckpointManager.getCheckpointDb(request));\n\n      if (db === undefined) {\n        Logger.logTrace(loggerCategory, \"Open V1 checkpoint - pending\", () => ({ ...tokenProps }));\n        throw new RpcPendingResponse(); // eslint-disable-line deprecation/deprecation\n      }\n      Logger.logTrace(loggerCategory, \"Opened V1 checkpoint\", () => ({ ...tokenProps }));\n    }\n\n    return db;\n  }\n\n  public static async openWithTimeout(activity: RpcActivity, tokenProps: IModelRpcOpenProps, syncMode: SyncMode.FixedVersion, timeout?: number): Promise<IModelConnectionProps>;\n  /**\n   * @deprecated in 4.4.0 - only `SyncMode.FixedVersion` should be used in RPC backends\n   */\n  // eslint-disable-next-line @typescript-eslint/unified-signatures -- these are separate to explicitly deprecate some SyncMode members.\n  public static async openWithTimeout(activity: RpcActivity, tokenProps: IModelRpcOpenProps, syncMode: Exclude<SyncMode, \"FixedVersion\">, timeout?: number): Promise<IModelConnectionProps>;\n  public static async openWithTimeout(activity: RpcActivity, tokenProps: IModelRpcOpenProps, syncMode: SyncMode, timeout: number = 1000): Promise<IModelConnectionProps> { // eslint-disable-line deprecation/deprecation\n    if (tokenProps.iModelId)\n      await IModelHost.tileStorage?.initialize(tokenProps.iModelId);\n    // eslint-disable-next-line deprecation/deprecation\n    return (await this.open({ activity, tokenProps, syncMode, timeout })).toJSON();\n  }\n\n}\n"]}
+{"version":3,"file":"RpcBriefcaseUtility.js","sourceRoot":"","sources":["../../../src/rpc-impl/RpcBriefcaseUtility.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module RpcInterface\n */\n\nimport { AccessToken, assert, BeDuration, BentleyError, IModelStatus, Logger } from \"@itwin/core-bentley\";\nimport {\n  BriefcaseProps, IModelConnectionProps, IModelError, IModelRpcOpenProps, IModelRpcProps, IModelVersion, RpcActivity, RpcPendingResponse, SyncMode,\n} from \"@itwin/core-common\";\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\nimport { BriefcaseManager, RequestNewBriefcaseArg } from \"../BriefcaseManager\";\nimport { CheckpointManager, V1CheckpointManager } from \"../CheckpointManager\";\nimport { BriefcaseDb, IModelDb, SnapshotDb } from \"../IModelDb\";\nimport { IModelHost } from \"../IModelHost\";\nimport { IModelJsFs } from \"../IModelJsFs\";\n\nconst loggerCategory: string = BackendLoggerCategory.IModelDb;\n\n/** @internal */\nexport interface DownloadAndOpenArgs {\n  activity: RpcActivity; // eslint-disable-line deprecation/deprecation\n  tokenProps: IModelRpcOpenProps;\n  syncMode: SyncMode;\n  fileNameResolvers?: ((arg: BriefcaseProps) => string)[];\n  timeout?: number;\n  forceDownload?: boolean;\n}\n/**\n * Utility to open the iModel for RPC interfaces\n * @internal\n */\nexport class RpcBriefcaseUtility {\n\n  private static async downloadAndOpen(args: DownloadAndOpenArgs): Promise<BriefcaseDb> {\n    const { activity, tokenProps } = args;\n    const accessToken = activity.accessToken;\n    assert(undefined !== tokenProps.iModelId);\n\n    const iModelId = tokenProps.iModelId;\n    let myBriefcaseIds: number[];\n    if (args.syncMode === SyncMode.PullOnly) {\n      myBriefcaseIds = [0]; // PullOnly means briefcaseId 0\n    } else {\n      // check with iModelHub and see if we already have acquired any briefcaseIds\n      myBriefcaseIds = await IModelHost.hubAccess.getMyBriefcaseIds({ accessToken, iModelId });\n    }\n\n    const resolvers = args.fileNameResolvers ?? [(arg) => BriefcaseManager.getFileName(arg)];\n\n    // see if we can open any of the briefcaseIds we already acquired from iModelHub\n    if (resolvers) {\n      for (const resolver of resolvers) {\n        for (const briefcaseId of myBriefcaseIds) {\n          const fileName = resolver({ briefcaseId, iModelId });\n          if (IModelJsFs.existsSync(fileName)) {\n            const briefcaseDb = BriefcaseDb.findByFilename(fileName);\n            if (briefcaseDb !== undefined)\n              return briefcaseDb as BriefcaseDb;\n            try {\n              if (args.forceDownload)\n                throw new Error(); // causes delete below\n              const db = await BriefcaseDb.open({ fileName });\n              if (db.changeset.id !== tokenProps.changeset?.id) {\n                assert(undefined !== tokenProps.changeset);\n                const toIndex = tokenProps.changeset?.index ??\n                  (await IModelHost.hubAccess.getChangesetFromVersion({ accessToken, iModelId, version: IModelVersion.asOfChangeSet(tokenProps.changeset.id) })).index;\n                await BriefcaseManager.pullAndApplyChangesets(db, { accessToken, toIndex });\n              }\n              return db;\n            } catch (error: any) {\n              if (!(error.errorNumber === IModelStatus.AlreadyOpen))\n                // somehow we have this briefcaseId and the file exists, but we can't open it. Delete it.\n                await BriefcaseManager.deleteBriefcaseFiles(fileName, accessToken);\n            }\n          }\n        }\n      }\n    }\n\n    // no local briefcase available. Download one and open it.\n    assert(undefined !== tokenProps.iTwinId);\n    const request: RequestNewBriefcaseArg = {\n      accessToken,\n      iTwinId: tokenProps.iTwinId,\n      iModelId,\n      briefcaseId: args.syncMode === SyncMode.PullOnly ? 0 : undefined, // if briefcaseId is undefined, we'll acquire a new one.\n    };\n\n    const props = await BriefcaseManager.downloadBriefcase(request);\n    return BriefcaseDb.open(props);\n  }\n\n  private static _briefcasePromises: Map<string, Promise<BriefcaseDb>> = new Map();\n  private static async openBriefcase(args: DownloadAndOpenArgs): Promise<BriefcaseDb> {\n    const key = `${args.tokenProps.iModelId}:${args.tokenProps.changeset?.id}:${args.tokenProps.changeset?.index}:${args.syncMode}`;\n    const cachedPromise = this._briefcasePromises.get(key);\n    if (cachedPromise)\n      return cachedPromise;\n\n    try {\n      const briefcasePromise = this.downloadAndOpen(args); // save the fact that we're working on downloading so if we timeout, we'll reuse this request.\n      this._briefcasePromises.set(key, briefcasePromise);\n      return await briefcasePromise;\n    } finally {\n      this._briefcasePromises.delete(key);  // the download and open is now done\n    }\n  }\n\n  /** find a previously opened iModel for RPC.\n   * @param accessToken necessary (only) for V2 checkpoints to refresh access token in daemon if it has expired. We use the accessToken of the current RPC request\n   * to refresh the daemon, even though it will be used for all authorized users.\n   * @param the IModelRpcProps to locate the opened iModel.\n   */\n  public static async findOpenIModel(accessToken: AccessToken, iModel: IModelRpcProps) {\n    const iModelDb = IModelDb.findByKey(iModel.key);\n\n    // call refreshContainer, just in case this is a V2 checkpoint whose sasToken is about to expire, or its default transaction is about to be restarted.\n    await iModelDb.refreshContainerForRpc(accessToken);\n    return iModelDb;\n  }\n\n  public static async open(args: DownloadAndOpenArgs & { syncMode: SyncMode.FixedVersion }): Promise<IModelDb>;\n  /**\n   * @deprecated in 4.4.0 - only `SyncMode.FixedVersion` should be used in RPC backends\n   */\n  // eslint-disable-next-line @typescript-eslint/unified-signatures -- these are separate to explicitly deprecate some SyncMode members.\n  public static async open(args: DownloadAndOpenArgs & { syncMode: Exclude<SyncMode, \"FixedVersion\"> }): Promise<IModelDb>;\n  /**\n   * Download and open a checkpoint or briefcase, ensuring the operation completes within a default timeout. If the time to open exceeds the timeout period,\n   * a RpcPendingResponse exception is thrown\n   */\n  public static async open(args: DownloadAndOpenArgs): Promise<IModelDb> {\n    const { activity, tokenProps, syncMode } = args;\n    Logger.logTrace(loggerCategory, \"RpcBriefcaseUtility.open\", tokenProps);\n\n    const timeout = args.timeout ?? 1000;\n    if (syncMode === SyncMode.PullOnly || syncMode === SyncMode.PullAndPush) {\n      const briefcaseDb = await BeDuration.race(timeout, this.openBriefcase(args));\n\n      if (briefcaseDb === undefined) {\n        Logger.logTrace(loggerCategory, \"Open briefcase - pending\", tokenProps);\n        throw new RpcPendingResponse(); // eslint-disable-line deprecation/deprecation\n      }\n      // note: usage is logged in the function BriefcaseManager.downloadNewBriefcaseAndOpen\n      return briefcaseDb;\n    }\n    if (!tokenProps.iModelId || !tokenProps.iTwinId || !tokenProps.changeset)\n      throw new IModelError(IModelStatus.BadArg, \"invalid arguments\");\n\n    const checkpoint = {\n      iModelId: tokenProps.iModelId,\n      iTwinId: tokenProps.iTwinId,\n      changeset: tokenProps.changeset,\n      accessToken: activity.accessToken,\n    };\n\n    // opening a checkpoint.\n    let db: SnapshotDb | void;\n    // first check if it's already open\n    db = SnapshotDb.tryFindByKey(CheckpointManager.getKey(checkpoint));\n    if (db) {\n      Logger.logTrace(loggerCategory, \"Checkpoint was already open\", tokenProps);\n      return db;\n    }\n\n    try {\n      // now try V2 checkpoint\n      db = await SnapshotDb.openCheckpointFromRpc(checkpoint);\n      Logger.logTrace(loggerCategory, \"using V2 checkpoint\", tokenProps);\n    } catch (e) {\n      Logger.logTrace(loggerCategory, \"unable to open V2 checkpoint - falling back to V1 checkpoint\", { error: BentleyError.getErrorProps(e), ...tokenProps });\n\n      // this isn't a v2 checkpoint. Set up a race between the specified timeout period and the open. Throw an RpcPendingResponse exception if the timeout happens first.\n      const request = {\n        checkpoint,\n        localFile: V1CheckpointManager.getFileName(checkpoint),\n        aliasFiles: [],\n      };\n      db = await BeDuration.race(timeout, V1CheckpointManager.getCheckpointDb(request));\n\n      if (db === undefined) {\n        Logger.logTrace(loggerCategory, \"Open V1 checkpoint - pending\", tokenProps);\n        throw new RpcPendingResponse(); // eslint-disable-line deprecation/deprecation\n      }\n      Logger.logTrace(loggerCategory, \"Opened V1 checkpoint\", tokenProps);\n    }\n\n    return db;\n  }\n\n  public static async openWithTimeout(activity: RpcActivity, tokenProps: IModelRpcOpenProps, syncMode: SyncMode.FixedVersion, timeout?: number): Promise<IModelConnectionProps>;\n  /**\n   * @deprecated in 4.4.0 - only `SyncMode.FixedVersion` should be used in RPC backends\n   */\n  // eslint-disable-next-line @typescript-eslint/unified-signatures -- these are separate to explicitly deprecate some SyncMode members.\n  public static async openWithTimeout(activity: RpcActivity, tokenProps: IModelRpcOpenProps, syncMode: Exclude<SyncMode, \"FixedVersion\">, timeout?: number): Promise<IModelConnectionProps>;\n  public static async openWithTimeout(activity: RpcActivity, tokenProps: IModelRpcOpenProps, syncMode: SyncMode, timeout: number = 1000): Promise<IModelConnectionProps> { // eslint-disable-line deprecation/deprecation\n    if (tokenProps.iModelId)\n      await IModelHost.tileStorage?.initialize(tokenProps.iModelId);\n    // eslint-disable-next-line deprecation/deprecation\n    return (await this.open({ activity, tokenProps, syncMode, timeout })).toJSON();\n  }\n\n}\n"]}

package/lib/cjs/workspace/Workspace.d.ts

@@ -6,11 +6,11 @@ import { LocalDirName, LocalFileName } from "@itwin/core-common";
 import { CloudSqlite } from "../CloudSqlite";
 import { SQLiteDb } from "../SQLiteDb";
 import { Settings, SettingsPriority } from "./Settings";
+import type { IModelJsNative } from "@bentley/imodeljs-native";
 /** The Settings used by Workspace api
  * @beta
  */
 export declare const WorkspaceSetting: {
-    Accounts: string;
     Containers: string;
     Databases: string;
 };
@@ -40,6 +40,28 @@ export declare namespace WorkspaceContainer {
      * @returns a Promise that resolves to the AccessToken for the container.
      */
     type TokenFunc = (props: Props) => Promise<AccessToken>;
+    function validateDbName(dbName: WorkspaceDb.DbName): void;
+    /**
+     * Validate that a WorkspaceContainer.Id is valid.
+     * The rules for ContainerIds (from Azure, see https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata):
+     *  - may only contain lower case letters, numbers or dashes
+     *  - may not start or end with with a dash nor have more than one dash in a row
+     *  - may not be shorter than 3 or longer than 63 characters
+     */
+    function validateContainerId(id: WorkspaceContainer.Id): void;
+    /** @internal */
+    function validateVersion(version?: WorkspaceDb.Version): string;
+    /**
+     * Parse the name stored in a WorkspaceContainer into the dbName and version number. A single WorkspaceContainer may hold
+     * many versions of the same WorkspaceDb. The name of the Db in the WorkspaceContainer is in the format "name:version". This
+     * function splits them into separate strings.
+     */
+    function parseDbFileName(dbFileName: WorkspaceDb.DbFullName): {
+        dbName: WorkspaceDb.DbName;
+        version: WorkspaceDb.Version;
+    };
+    /** Create a dbName for a WorkspaceDb from its base name and version. This will be in the format "name:version" */
+    function makeDbFileName(dbName: WorkspaceDb.DbName, version?: WorkspaceDb.Version): WorkspaceDb.DbName;
 }
 /** @beta */
 export declare namespace WorkspaceDb {
@@ -64,6 +86,12 @@ export declare namespace WorkspaceDb {
      * @see semver.ReleaseType
      */
     type VersionIncrement = "major" | "minor" | "patch";
+    /** file extension for local WorkspaceDbs
+     * @internal
+     */
+    const fileExt = "itwin-workspace";
+    /** construct a new instance of a WorkspaceDb */
+    function construct(props: WorkspaceDb.Props, container: WorkspaceContainer): WorkspaceDb;
 }
 /** Types used to identify Workspace resources
  *  @beta
@@ -99,11 +127,18 @@ export interface WorkspaceDb {
     readonly onClose: BeEvent<() => void>;
     /** Name by which a WorkspaceDb may be opened. This will be either a local file name or the name of a database in a cloud container */
     readonly dbFileName: string;
+    /** the SQLiteDb for this WorkspaceDb*/
+    readonly sqliteDb: SQLiteDb;
+    open(): void;
+    close(): void;
     /** Get a string resource from this WorkspaceDb, if present. */
     getString(rscName: WorkspaceResource.Name): string | undefined;
     /** Get a blob resource from this WorkspaceDb, if present. */
     getBlob(rscName: WorkspaceResource.Name): Uint8Array | undefined;
-    /** @internal */
+    /** Get a BlobIO reader for a blob WorkspaceResource.
+     * @note when finished, caller *must* call `close` on the BlobIO.
+     * @internal
+     */
     getBlobReader(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO;
     /**
      * Extract a local copy of a file resource from this WorkspaceDb, if present.
@@ -128,7 +163,12 @@ export interface WorkspaceDb {
      * @returns a `CloudSqlite.CloudPrefetch` object that can be used to await and/or cancel the prefetch.
      * @throws if this WorkspaceDb is not from a `CloudContainer`.
      */
-    prefetch(): CloudSqlite.CloudPrefetch;
+    prefetch(opts?: CloudSqlite.PrefetchProps): CloudSqlite.CloudPrefetch;
+    /** @internal */
+    queryFileResource(rscName: WorkspaceResource.Name): {
+        localFileName: LocalFileName;
+        info: IModelJsNative.EmbedFileQuery;
+    } | undefined;
 }
 /** The properties of the CloudCache used for Workspaces.
  * @beta
@@ -197,10 +237,18 @@ export interface Workspace {
     /** Close this Workspace. All WorkspaceContainers are dropped. */
     close(): void;
 }
+/** @beta */
+export declare namespace Workspace {
+    /** @internal */
+    function construct(settings: Settings, opts?: WorkspaceOpts): Workspace;
+}
 /**
- * A WorkspaceContainer holds WorkspaceDbs.
- * Access rights are administered per WorkspaceContainer. That is, if a user has rights to access a WorkspaceContainer, that right
- * applies to all WorkspaceDbs in the WorkspaceContainer.
+ * A WorkspaceContainer is a type of `CloudSqlite.CloudContainer` that holds WorkspaceDbs. Normally a WorkspaceContainer will hold (many versions of) a single WorkspaceDb.
+ * Each version of a WorkspaceDb is treated as immutable after it is created and is stored in the WorkspaceContainer indefinitely. That means that
+ * older versions of the WorkspaceDb may continue to be used, for example by archived projects. For programmers familiar with [NPM](https://www.npmjs.com/), this is conceptually
+ * similar and versioning follows the same rules as NPM using [Semantic Versioning](https://semver.org/).
+ * @note It is possible to store more than one WorkspaceDb in the same WorkspaceContainer, but access rights are administered per WorkspaceContainer.
+ * That is, if a user has rights to access a WorkspaceContainer, that right applies to all WorkspaceDbs in the WorkspaceContainer.
  * @beta
  */
 export interface WorkspaceContainer {
@@ -210,137 +258,43 @@ export interface WorkspaceContainer {
     readonly id: WorkspaceContainer.Id;
     /** Workspace holding this WorkspaceContainer. */
     readonly workspace: Workspace;
-    /** CloudContainer for this WorkspaceContainer (`undefined` if this is a local WorkspaceContainer.)
-     * @internal
-    */
+    /** CloudContainer for this WorkspaceContainer (`undefined` if this is a local WorkspaceContainer.) */
     readonly cloudContainer?: CloudSqlite.CloudContainer;
     /** @internal */
-    addWorkspaceDb(toAdd: ITwinWorkspaceDb): void;
-    /** @internal */
-    resolveDbFileName(props: WorkspaceDb.Props): string;
-    /** find or open a WorkspaceDb from this WorkspaceContainer. */
-    getWorkspaceDb(props: WorkspaceDb.Props): WorkspaceDb;
-    /** Close and remove a currently opened [[WorkspaceDb]] from this Workspace. */
-    dropWorkspaceDb(container: WorkspaceDb): void;
-    /** Close this WorkspaceContainer. All currently opened WorkspaceDbs are dropped. */
-    close(): void;
-}
-/** @internal */
-export declare class ITwinWorkspace implements Workspace {
-    private _containers;
-    readonly containerDir: LocalDirName;
-    readonly settings: Settings;
-    private _cloudCache?;
-    getCloudCache(): CloudSqlite.CloudCache;
-    constructor(settings: Settings, opts?: WorkspaceOpts);
-    addContainer(toAdd: ITwinWorkspaceContainer): void;
-    findContainer(containerId: WorkspaceContainer.Id): ITwinWorkspaceContainer | undefined;
-    getContainer(props: WorkspaceContainer.Props): WorkspaceContainer;
-    getWorkspaceDbFromProps(dbProps: WorkspaceDb.Props, containerProps: WorkspaceContainer.Props): WorkspaceDb;
-    getWorkspaceDb(dbAlias: string): Promise<WorkspaceDb>;
-    loadSettingsDictionary(settingRsc: WorkspaceResource.Name, db: WorkspaceDb, priority: SettingsPriority): void;
-    close(): void;
-    resolveContainer(containerName: string): WorkspaceContainer.Props;
-    resolveDatabase(databaseName: string): WorkspaceDb.Props & WorkspaceContainer.Alias;
-}
-/** @internal */
-export declare class ITwinWorkspaceContainer implements WorkspaceContainer {
-    readonly workspace: ITwinWorkspace;
-    readonly filesDir: LocalDirName;
-    readonly id: WorkspaceContainer.Id;
-    readonly cloudContainer?: CloudSqlite.CloudContainer | undefined;
-    private _wsDbs;
-    get dirName(): string;
-    static noLeadingOrTrailingSpaces(name: string, msg: string): void;
-    /** rules for ContainerIds (from Azure, see https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata)
-     *  - may only contain lower case letters, numbers or dashes
-     *  - may not start or end with with a dash nor have more than one dash in a row
-     *  - may not be shorter than 3 or longer than 63 characters
+    addWorkspaceDb(toAdd: WorkspaceDbImpl): void;
+    /**
+     * Find the appropriate version of a WorkspaceDb in this WorkspaceContainer based on the SemVer rule
+     * in the `WorkspaceDb.Props`.
+     * If no version satisfying the WorkspaceDb.Props rules exists, throws an exception.
      */
-    private static validateContainerId;
-    static validateDbName(dbName: WorkspaceDb.DbName): void;
-    constructor(workspace: ITwinWorkspace, props: WorkspaceContainer.Props);
-    static validateVersion(version?: WorkspaceDb.Version): string;
-    static parseDbFileName(dbFileName: WorkspaceDb.DbFullName): {
-        dbName: WorkspaceDb.DbName;
-        version: WorkspaceDb.Version;
-    };
-    static makeDbFileName(dbName: WorkspaceDb.DbName, version?: WorkspaceDb.Version): WorkspaceDb.DbName;
-    static resolveCloudFileName(cloudContainer: CloudSqlite.CloudContainer, props: WorkspaceDb.Props): WorkspaceDb.DbFullName;
+    resolveDbFileName(props: WorkspaceDb.Props): WorkspaceDb.DbFullName;
     /**
-     * Create a copy of an existing [[WorkspaceDb]] in a cloud container with a new version number.
-     * @param cloudContainer The attached cloud container holding the existing WorkspaceDb
+     * Create a copy of an existing [[WorkspaceDb]] in this WorkspaceContainer with a new version number. This function is used
+     * by administrator tools that modify Workspaces. This requires that the write lock on the container be held. The copy should be modified with
+     * new content before the write lock is released, and thereafter should never be modified again.
      * @param fromProps Properties that describe the source WorkspaceDb for the new version
      * @param versionType The type of version increment to apply to the existing version.
-     * @note This requires that the cloudContainer is attached and the write lock on the container be held. The copy should be modified with
-     * new content before the write lock is released, and thereafter should never be modified again.
+     * @note The copy actually shares all of the data with the original, but with copy-on-write if/when data in the new WorkspaceDb is modified.
      */
-    static makeNewVersion(cloudContainer: CloudSqlite.CloudContainer, fromProps: WorkspaceDb.Props, versionType: WorkspaceDb.VersionIncrement): Promise<{
-        oldName: string;
-        newName: string;
+    makeNewVersion(fromProps: WorkspaceDb.Props, versionType: WorkspaceDb.VersionIncrement): Promise<{
+        oldName: WorkspaceDb.DbName;
+        newName: WorkspaceDb.DbName;
     }>;
-    /**
-     * Convert a WorkspaceDb.Props specification into a DbFileName. For cloud-based containers, this resolves to the dbName, incorporating the appropriate
-     * version. For file-based containers, this returns a local filename of a WorkspaceDb file with the extension ".itwin-workspace"
-     */
-    resolveDbFileName(props: WorkspaceDb.Props): WorkspaceDb.DbFullName;
-    addWorkspaceDb(toAdd: ITwinWorkspaceDb): void;
+    /** find or open a WorkspaceDb from this WorkspaceContainer. */
     getWorkspaceDb(props: WorkspaceDb.Props): WorkspaceDb;
-    dropWorkspaceDb(toDrop: WorkspaceDb): void;
+    /** Close and remove a currently opened [[WorkspaceDb]] from this Workspace. */
+    closeWorkspaceDb(container: WorkspaceDb): void;
+    /** Close this WorkspaceContainer. All currently opened WorkspaceDbs are dropped. */
     close(): void;
-    /** Delete all local files extracted by [[WorkspaceDb.getFile]] for this container. */
-    purgeContainerFiles(): void;
 }
 /**
- * Implementation of WorkspaceDb
- * @internal
- */
-export declare class ITwinWorkspaceDb implements WorkspaceDb {
-    /** file extension for local WorkspaceDbs */
-    static readonly fileExt = "itwin-workspace";
-    /** the SQLiteDb for this WorkspaceDb*/
-    readonly sqliteDb: SQLiteDb;
-    /** the base WorkspaceDb name, without directory, extension, or version information. */
-    readonly dbName: WorkspaceDb.DbName;
-    /** The WorkspaceContainer holding this WorkspaceDb */
-    readonly container: WorkspaceContainer;
-    /** called before db is closed */
-    readonly onClose: BeEvent<() => void>;
-    /** either a local file name or the name of the file in a cloud container, including version identifier */
-    dbFileName: string;
-    /** true if this WorkspaceDb is currently open */
-    get isOpen(): boolean;
-    queryFileResource(rscName: WorkspaceResource.Name): {
-        localFileName: string;
-        info: import("@bentley/imodeljs-native").IModelJsNative.EmbedFileQuery;
-    } | undefined;
-    constructor(props: WorkspaceDb.Props, container: WorkspaceContainer);
-    open(): void;
-    close(): void;
-    getString(rscName: WorkspaceResource.Name): string | undefined;
-    /** Get a BlobIO reader for a blob WorkspaceResource.
-     * @note when finished, caller *must* call `close` on the BlobIO.
-     */
-    getBlobReader(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO;
-    getBlob(rscName: WorkspaceResource.Name): Uint8Array | undefined;
-    getFile(rscName: WorkspaceResource.Name, targetFileName?: LocalFileName): LocalFileName | undefined;
-    prefetch(opts?: CloudSqlite.PrefetchProps): CloudSqlite.CloudPrefetch;
-}
-/**
- * An editable [[WorkspaceDb]]. This is used by administrators for creating and modifying `WorkspaceDb`s.
- * For cloud-backed containers, the write token must be obtained before this class may be used. Only one user at at time
- * may be editing.
- * @internal
+ * An editable [[WorkspaceDb]]. This is used only by tools to allow administrators to create and modify `WorkspaceDb`s.
+ * For CloudSqlite Workspaces, the write token must be obtained before the methods in this interface may be used. Normally
+ * only admins will have write access to Workspaces. Only one admin at at time may be editing a Workspace.
+ * @beta
  */
-export declare class EditableWorkspaceDb extends ITwinWorkspaceDb {
-    private static validateResourceName;
-    private validateResourceSize;
-    open(): void;
-    private getFileModifiedTime;
-    private performWriteSql;
+export interface EditableWorkspaceDb extends WorkspaceDb {
     createDb(version?: string): Promise<void>;
-    /** Create a new, empty, EditableWorkspaceDb for importing Workspace resources. */
-    static createEmpty(fileName: LocalFileName): void;
     /** Add a new string resource to this WorkspaceDb.
      * @param rscName The name of the string resource.
      * @param val The string to save.
@@ -386,4 +340,34 @@ export declare class EditableWorkspaceDb extends ITwinWorkspaceDb {
     /** Remove a file resource. */
     removeFile(rscName: WorkspaceResource.Name): void;
 }
+/** @beta */
+export declare namespace EditableWorkspaceDb {
+    /** construct a new instance of an EditableWorkspaceDb */
+    function construct(props: WorkspaceDb.Props, container: WorkspaceContainer): EditableWorkspaceDb;
+    /** Create a new, empty, EditableWorkspaceDb file on the local filesystem for importing Workspace resources. */
+    function createEmpty(fileName: LocalFileName): void;
+}
+/** Implementation of WorkspaceDb */
+declare class WorkspaceDbImpl implements WorkspaceDb {
+    readonly sqliteDb: SQLiteDb;
+    readonly dbName: WorkspaceDb.DbName;
+    readonly container: WorkspaceContainer;
+    readonly onClose: BeEvent<() => void>;
+    dbFileName: string;
+    /** true if this WorkspaceDb is currently open */
+    get isOpen(): boolean;
+    queryFileResource(rscName: WorkspaceResource.Name): {
+        localFileName: LocalFileName;
+        info: IModelJsNative.EmbedFileQuery;
+    } | undefined;
+    constructor(props: WorkspaceDb.Props, container: WorkspaceContainer);
+    open(): void;
+    close(): void;
+    getString(rscName: WorkspaceResource.Name): string | undefined;
+    getBlobReader(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO;
+    getBlob(rscName: WorkspaceResource.Name): Uint8Array | undefined;
+    getFile(rscName: WorkspaceResource.Name, targetFileName?: LocalFileName): LocalFileName | undefined;
+    prefetch(opts?: CloudSqlite.PrefetchProps): CloudSqlite.CloudPrefetch;
+}
+export {};
 //# sourceMappingURL=Workspace.d.ts.map

package/lib/cjs/workspace/Workspace.d.ts.map

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