@itwin/imodel-transformer 2.0.0-dev.35 → 2.0.0-dev.37

package/lib/cjs/TransformerLoggerCategory.js.map

@@ -1 +1 @@
-{"version":3,"file":"TransformerLoggerCategory.js","sourceRoot":"","sources":["../../src/TransformerLoggerCategory.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;AAChG;;GAEG;;;AAEH;;;;GAIG;AACH,IAAY,yBAsBX;AAtBD,WAAY,yBAAyB;IACnC;;OAEG;IACH,iFAAoD,CAAA;IAEpD;;OAEG;IACH,iFAAoD,CAAA;IAEpD;;OAEG;IACH,uFAA0D,CAAA;IAE1D;;OAEG;IACH,yFAA4D,CAAA;IAE5D,+FAAkE,CAAA;AACpE,CAAC,EAtBW,yBAAyB,yCAAzB,yBAAyB,QAsBpC","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 Logging\n */\n\n/** Logger categories used by this package\n * @note All logger categories in this package start with the `imodel-transformer` prefix.\n * @see [Logger]($bentley)\n * @public\n */\nexport enum TransformerLoggerCategory {\n  /** The logger category used by the [IModelExporter]($transformer) class.\n   * @beta\n   */\n  IModelExporter = \"imodel-transformer.IModelExporter\",\n\n  /** The logger category used by the [IModelImporter]($transformer) class.\n   * @beta\n   */\n  IModelImporter = \"imodel-transformer.IModelImporter\",\n\n  /** The logger category used by the [IModelTransformer]($transformer) class.\n   * @beta\n   */\n  IModelTransformer = \"imodel-transformer.IModelTransformer\",\n\n  /** The logger category used by the [IModelCloneContext]($transformer) class.\n   * @beta\n   */\n  IModelCloneContext = \"imodel-transformer.IModelCloneContext\",\n\n  ECReferenceTypesCache = \"imodel-transformer.ECReferenceTypesCache\",\n}\n"]}
+{"version":3,"file":"TransformerLoggerCategory.js","sourceRoot":"","sources":["../../src/TransformerLoggerCategory.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;AAChG;;GAEG;;;AAEH;;;;GAIG;AACH,IAAY,yBAsBX;AAtBD,WAAY,yBAAyB;IACnC;;OAEG;IACH,iFAAoD,CAAA;IAEpD;;OAEG;IACH,iFAAoD,CAAA;IAEpD;;OAEG;IACH,uFAA0D,CAAA;IAE1D;;OAEG;IACH,yFAA4D,CAAA;IAE5D,+FAAkE,CAAA;AACpE,CAAC,EAtBW,yBAAyB,yCAAzB,yBAAyB,QAsBpC","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 Logging\n */\n\n/** Logger categories used by this package\n * @note All logger categories in this package start with the `imodel-transformer` prefix.\n * @see [Logger]($bentley)\n * @public\n */\nexport enum TransformerLoggerCategory {\n  /** The logger category used by the [IModelExporter]($transformer) class.\n   * @beta\n   */\n  IModelExporter = \"imodel-transformer.IModelExporter\",\n\n  /** The logger category used by the [IModelImporter]($transformer) class.\n   * @beta\n   */\n  IModelImporter = \"imodel-transformer.IModelImporter\",\n\n  /** The logger category used by the [IModelTransformer]($transformer) class.\n   * @beta\n   */\n  IModelTransformer = \"imodel-transformer.IModelTransformer\",\n\n  /** The logger category used while cloning entities and remapping their references.\n   * @beta\n   */\n  IModelCloneContext = \"imodel-transformer.IModelCloneContext\",\n\n  ECReferenceTypesCache = \"imodel-transformer.ECReferenceTypesCache\",\n}\n"]}

package/lib/cjs/imodel-transformer.d.ts

@@ -2,6 +2,7 @@ export * from "./TransformerLoggerCategory";
 export * from "./IModelExporter";
 export * from "./IModelImporter";
 export * from "./IModelTransformer";
+export * from "./IModelTransformContext";
 export * from "./IModelTransformerError";
 export * from "./BranchProvenanceInitializer";
 /** @docs-package-description

package/lib/cjs/imodel-transformer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imodel-transformer.d.ts","sourceRoot":"","sources":["../../src/imodel-transformer.ts"],"names":[],"mappings":"AAIA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAyG9C;;;;;;GAMG;AACH;;;;GAIG;AACH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG"}
+{"version":3,"file":"imodel-transformer.d.ts","sourceRoot":"","sources":["../../src/imodel-transformer.ts"],"names":[],"mappings":"AAIA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAyG9C;;;;;;GAMG;AACH;;;;GAIG;AACH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG"}

package/lib/cjs/imodel-transformer.js

@@ -22,6 +22,7 @@ __exportStar(require("./TransformerLoggerCategory"), exports);
 __exportStar(require("./IModelExporter"), exports);
 __exportStar(require("./IModelImporter"), exports);
 __exportStar(require("./IModelTransformer"), exports);
+__exportStar(require("./IModelTransformContext"), exports);
 __exportStar(require("./IModelTransformerError"), exports);
 __exportStar(require("./BranchProvenanceInitializer"), exports);
 const semver = require("semver");

package/lib/cjs/imodel-transformer.js.map

@@ -1 +1 @@
-{"version":3,"file":"imodel-transformer.js","sourceRoot":"","sources":["../../src/imodel-transformer.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 *--------------------------------------------------------------------------------------------*/\nexport * from \"./TransformerLoggerCategory\";\nexport * from \"./IModelExporter\";\nexport * from \"./IModelImporter\";\nexport * from \"./IModelTransformer\";\nexport * from \"./IModelTransformerError\";\nexport * from \"./BranchProvenanceInitializer\";\n\nimport * as semver from \"semver\";\nimport { ITwinError } from \"@itwin/core-bentley\";\nimport { version as iTwinCoreBackendVersion } from \"@itwin/core-backend/package.json\";\nimport {\n  IModelTransformerError,\n  IModelTransformerErrorScope,\n} from \"./IModelTransformerError\";\nimport { transformerPackageMetadata } from \"./TransformerPackageMetadata\";\n\nconst {\n  version: ourVersion,\n  name: ourName,\n  peerDependencies,\n} = transformerPackageMetadata;\n\nconst ourITwinCoreBackendDepRange = peerDependencies[\"@itwin/core-backend\"];\n\nconst noStrictDepCheckEnvVar = \"TRANSFORMER_NO_STRICT_DEP_CHECK\";\nconst suggestEnvVarName = \"SUGGEST_TRANSFORMER_VERSIONS\";\n\n// warn if using a prerelease or dev version\nif (semver.prerelease(iTwinCoreBackendVersion)) {\n  // eslint-disable-next-line no-console\n  console.warn(\n    `Warning: dev version detected (${iTwinCoreBackendVersion}). ` +\n      \"This version is most likely fine, but it may introduce new behavior that could cause \" +\n      \"unexpected issues or changes in the transformer's functionality. Please proceed with caution.\"\n  );\n}\n\nif (\n  process.env[noStrictDepCheckEnvVar] !== \"1\" &&\n  !semver.satisfies(iTwinCoreBackendVersion, ourITwinCoreBackendDepRange, {\n    includePrerelease: true,\n  })\n) {\n  const errHeader =\n    `${ourName}@${ourVersion} only supports @itwin/core-backend@${ourITwinCoreBackendDepRange}, ` +\n    `but @itwin/core-backend${iTwinCoreBackendVersion} was resolved when looking for the peer dependency.\\n` +\n    `If you know exactly what you are doing, you can disable this check by setting ${noStrictDepCheckEnvVar}=1 in the environment\\n`;\n\n  if (process.env[suggestEnvVarName]) {\n    // let's not import https except in this case\n    // eslint-disable-next-line @typescript-eslint/no-var-requires, @typescript-eslint/no-require-imports\n    const https = require(\"node:https\") as typeof import(\"node:https\");\n    https.get(`https://registry.npmjs.org/${ourName}`, async (resp) => {\n      const chunks: string[] = [];\n      const packumentSrc = await new Promise<string>((r) =>\n        resp\n          .setEncoding(\"utf8\")\n          .on(\"data\", (d) => chunks.push(d))\n          .on(\"end\", () => r(chunks.join(\"\")))\n      );\n      interface PackumentSubset {\n        versions: Record<\n          string,\n          {\n            peerDependencies?: {\n              \"@itwin/core-backend\": string; // eslint-disable-line @typescript-eslint/naming-convention\n            };\n          }\n        >;\n      }\n\n      const packumentJson = JSON.parse(packumentSrc) as PackumentSubset;\n      const isTaglessVersion = (version: string) => version.includes(\"-\");\n      const latestFirstApplicableVersions = Object.entries(\n        packumentJson.versions\n      )\n        .filter(([, v]) =>\n          semver.satisfies(\n            iTwinCoreBackendVersion,\n            v.peerDependencies?.[\"@itwin/core-backend\"] ?? \"\"\n          )\n        )\n        .map(([k]) => k)\n        .filter(isTaglessVersion)\n        .reverse();\n\n      ITwinError.throwError({\n        iTwinErrorId: {\n          scope: IModelTransformerErrorScope,\n          key: IModelTransformerError.DependencyVersionMismatch,\n        },\n        message: [\n          errHeader,\n          `You have ${suggestEnvVarName}=1 set in the environment, so we suggest one of the following versions.`,\n          \"Be aware that older versions may be missing bug fixes.\",\n          ...latestFirstApplicableVersions,\n        ].join(\"\\n\"),\n      });\n    });\n  } else {\n    ITwinError.throwError({\n      iTwinErrorId: {\n        scope: IModelTransformerErrorScope,\n        key: IModelTransformerError.DependencyVersionMismatch,\n      },\n      message: `${errHeader}You can rerun with the environment variable ${suggestEnvVarName}=1 to have this error suggest a version`,\n    });\n  }\n}\n\n/** @docs-package-description\n * The @itwin/imodel-transformer package contains classes that [backend code]($docs/learning/backend/index.md) can use to\n * traverse iModels, as well as *transform* an iModel into another existing or empty one, by exporting elements from one during\n * traversal and importing them into another.\n *\n * You can read further in [iModelTransformation and Data Exchange]($docs/learning/transformer/index.md) here.\n */\n/**\n * @docs-group-description iModels\n * Classes for working with [iModels]($docs/learning/iModels.md).\n * See [the learning article]($docs/learning/backend/index.md).\n */\n/**\n * @docs-group-description Utils\n * Miscellaneous utility classes.\n */\n/**\n * @docs-group-description Logging\n * Logger categories used by this package.\n */\n/**\n * @docs-group-description ElementAspectExportCoordinator\n * Internal coordination for scoped, owner-batched ElementAspect export.\n */\n/**\n * @docs-group-description ElementAspectExportProcessor\n * Internal source queries, filtering, and export callbacks for ElementAspects owned by accepted elements.\n */\n/**\n * @docs-group-description IModelTransformerError\n * Stable identifiers for errors originating from this package.\n */\n/**\n * @docs-group-description TransformerPackageMetadata\n * Internal metadata describing this package and its peer dependencies.\n */\n"]}
+{"version":3,"file":"imodel-transformer.js","sourceRoot":"","sources":["../../src/imodel-transformer.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 *--------------------------------------------------------------------------------------------*/\nexport * from \"./TransformerLoggerCategory\";\nexport * from \"./IModelExporter\";\nexport * from \"./IModelImporter\";\nexport * from \"./IModelTransformer\";\nexport * from \"./IModelTransformContext\";\nexport * from \"./IModelTransformerError\";\nexport * from \"./BranchProvenanceInitializer\";\n\nimport * as semver from \"semver\";\nimport { ITwinError } from \"@itwin/core-bentley\";\nimport { version as iTwinCoreBackendVersion } from \"@itwin/core-backend/package.json\";\nimport {\n  IModelTransformerError,\n  IModelTransformerErrorScope,\n} from \"./IModelTransformerError\";\nimport { transformerPackageMetadata } from \"./TransformerPackageMetadata\";\n\nconst {\n  version: ourVersion,\n  name: ourName,\n  peerDependencies,\n} = transformerPackageMetadata;\n\nconst ourITwinCoreBackendDepRange = peerDependencies[\"@itwin/core-backend\"];\n\nconst noStrictDepCheckEnvVar = \"TRANSFORMER_NO_STRICT_DEP_CHECK\";\nconst suggestEnvVarName = \"SUGGEST_TRANSFORMER_VERSIONS\";\n\n// warn if using a prerelease or dev version\nif (semver.prerelease(iTwinCoreBackendVersion)) {\n  // eslint-disable-next-line no-console\n  console.warn(\n    `Warning: dev version detected (${iTwinCoreBackendVersion}). ` +\n      \"This version is most likely fine, but it may introduce new behavior that could cause \" +\n      \"unexpected issues or changes in the transformer's functionality. Please proceed with caution.\"\n  );\n}\n\nif (\n  process.env[noStrictDepCheckEnvVar] !== \"1\" &&\n  !semver.satisfies(iTwinCoreBackendVersion, ourITwinCoreBackendDepRange, {\n    includePrerelease: true,\n  })\n) {\n  const errHeader =\n    `${ourName}@${ourVersion} only supports @itwin/core-backend@${ourITwinCoreBackendDepRange}, ` +\n    `but @itwin/core-backend${iTwinCoreBackendVersion} was resolved when looking for the peer dependency.\\n` +\n    `If you know exactly what you are doing, you can disable this check by setting ${noStrictDepCheckEnvVar}=1 in the environment\\n`;\n\n  if (process.env[suggestEnvVarName]) {\n    // let's not import https except in this case\n    // eslint-disable-next-line @typescript-eslint/no-var-requires, @typescript-eslint/no-require-imports\n    const https = require(\"node:https\") as typeof import(\"node:https\");\n    https.get(`https://registry.npmjs.org/${ourName}`, async (resp) => {\n      const chunks: string[] = [];\n      const packumentSrc = await new Promise<string>((r) =>\n        resp\n          .setEncoding(\"utf8\")\n          .on(\"data\", (d) => chunks.push(d))\n          .on(\"end\", () => r(chunks.join(\"\")))\n      );\n      interface PackumentSubset {\n        versions: Record<\n          string,\n          {\n            peerDependencies?: {\n              \"@itwin/core-backend\": string; // eslint-disable-line @typescript-eslint/naming-convention\n            };\n          }\n        >;\n      }\n\n      const packumentJson = JSON.parse(packumentSrc) as PackumentSubset;\n      const isTaglessVersion = (version: string) => version.includes(\"-\");\n      const latestFirstApplicableVersions = Object.entries(\n        packumentJson.versions\n      )\n        .filter(([, v]) =>\n          semver.satisfies(\n            iTwinCoreBackendVersion,\n            v.peerDependencies?.[\"@itwin/core-backend\"] ?? \"\"\n          )\n        )\n        .map(([k]) => k)\n        .filter(isTaglessVersion)\n        .reverse();\n\n      ITwinError.throwError({\n        iTwinErrorId: {\n          scope: IModelTransformerErrorScope,\n          key: IModelTransformerError.DependencyVersionMismatch,\n        },\n        message: [\n          errHeader,\n          `You have ${suggestEnvVarName}=1 set in the environment, so we suggest one of the following versions.`,\n          \"Be aware that older versions may be missing bug fixes.\",\n          ...latestFirstApplicableVersions,\n        ].join(\"\\n\"),\n      });\n    });\n  } else {\n    ITwinError.throwError({\n      iTwinErrorId: {\n        scope: IModelTransformerErrorScope,\n        key: IModelTransformerError.DependencyVersionMismatch,\n      },\n      message: `${errHeader}You can rerun with the environment variable ${suggestEnvVarName}=1 to have this error suggest a version`,\n    });\n  }\n}\n\n/** @docs-package-description\n * The @itwin/imodel-transformer package contains classes that [backend code]($docs/learning/backend/index.md) can use to\n * traverse iModels, as well as *transform* an iModel into another existing or empty one, by exporting elements from one during\n * traversal and importing them into another.\n *\n * You can read further in [iModelTransformation and Data Exchange]($docs/learning/transformer/index.md) here.\n */\n/**\n * @docs-group-description iModels\n * Classes for working with [iModels]($docs/learning/iModels.md).\n * See [the learning article]($docs/learning/backend/index.md).\n */\n/**\n * @docs-group-description Utils\n * Miscellaneous utility classes.\n */\n/**\n * @docs-group-description Logging\n * Logger categories used by this package.\n */\n/**\n * @docs-group-description ElementAspectExportCoordinator\n * Internal coordination for scoped, owner-batched ElementAspect export.\n */\n/**\n * @docs-group-description ElementAspectExportProcessor\n * Internal source queries, filtering, and export callbacks for ElementAspects owned by accepted elements.\n */\n/**\n * @docs-group-description IModelTransformerError\n * Stable identifiers for errors originating from this package.\n */\n/**\n * @docs-group-description TransformerPackageMetadata\n * Internal metadata describing this package and its peer dependencies.\n */\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/imodel-transformer",
-  "version": "2.0.0-dev.35",
+  "version": "2.0.0-dev.37",
   "description": "API for exporting an iModel's parts and also importing them into another iModel",
   "main": "lib/cjs/imodel-transformer.js",
   "typings": "lib/cjs/imodel-transformer",