@itwin/imodel-transformer 2.0.0-dev.5 → 2.0.0-dev.51

package/lib/cjs/schema-processing/DynamicSchemaUnionStrategy.d.ts

@@ -0,0 +1,29 @@
+/** @packageDocumentation
+ * @module iModels
+ */
+import { SchemaDifferenceResult } from "@itwin/ecschema-editing";
+import { Schema } from "@itwin/ecschema-metadata";
+import { SchemaProcessingContext, SchemaProcessingResult, SchemaProcessingStrategy } from "./SchemaProcessingStrategy";
+/**
+ * Processes ordinary schemas with newer-version selection and unions compatible
+ * differences for existing dynamic schemas. Dynamic schema root read and write
+ * versions must match; only the minor version may differ.
+ * @beta
+ */
+export declare class DynamicSchemaUnionStrategy implements SchemaProcessingStrategy {
+    /**
+     * Transform schema differences before conflict validation and merging.
+     * A subclass that changes the differencing result is responsible for ensuring
+     * that its changes are safe for the source and target schemas.
+     * @param sourceSchema The source schema being processed.
+     * @param targetSchema The existing target schema.
+     * @param differences The complete result from [[getSchemaDifferences]].
+     * @returns The differencing result to validate and merge.
+     * @beta
+     */
+    protected onSchemaDifferences(_sourceSchema: Schema, _targetSchema: Schema, differences: SchemaDifferenceResult): Promise<SchemaDifferenceResult>;
+    /** Select ordinary schemas and union compatible dynamic schema differences. */
+    processSchemas(context: SchemaProcessingContext): Promise<SchemaProcessingResult[]>;
+    private createPlan;
+}
+//# sourceMappingURL=DynamicSchemaUnionStrategy.d.ts.map

package/lib/cjs/schema-processing/DynamicSchemaUnionStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamicSchemaUnionStrategy.d.ts","sourceRoot":"","sources":["../../../src/schema-processing/DynamicSchemaUnionStrategy.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EAKL,sBAAsB,EAEvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,MAAM,EAGP,MAAM,0BAA0B,CAAC;AAKlC,OAAO,EAEL,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAsBpC;;;;;GAKG;AACH,qBAAa,0BAA2B,YAAW,wBAAwB;IACzE;;;;;;;;;OASG;IACH,UAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,sBAAsB,GAClC,OAAO,CAAC,sBAAsB,CAAC,CAEjC;IAED,+EAA+E;IAClE,cAAc,CACzB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,EAAE,CAAC,CA2EnC;YAEa,UAAU;CAwDzB"}

package/lib/cjs/schema-processing/DynamicSchemaUnionStrategy.js

@@ -0,0 +1,212 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module iModels
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamicSchemaUnionStrategy = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
+const ecschema_editing_1 = require("@itwin/ecschema-editing");
+const ecschema_metadata_1 = require("@itwin/ecschema-metadata");
+const IModelTransformerError_1 = require("../IModelTransformerError");
+/**
+ * Processes ordinary schemas with newer-version selection and unions compatible
+ * differences for existing dynamic schemas. Dynamic schema root read and write
+ * versions must match; only the minor version may differ.
+ * @beta
+ */
+class DynamicSchemaUnionStrategy {
+    /**
+     * Transform schema differences before conflict validation and merging.
+     * A subclass that changes the differencing result is responsible for ensuring
+     * that its changes are safe for the source and target schemas.
+     * @param sourceSchema The source schema being processed.
+     * @param targetSchema The existing target schema.
+     * @param differences The complete result from [[getSchemaDifferences]].
+     * @returns The differencing result to validate and merge.
+     * @beta
+     */
+    async onSchemaDifferences(_sourceSchema, _targetSchema, differences) {
+        return differences;
+    }
+    /** Select ordinary schemas and union compatible dynamic schema differences. */
+    async processSchemas(context) {
+        const plans = [];
+        const conflicts = [];
+        for (const sourceSchema of context.sourceSchemas) {
+            try {
+                plans.push(await this.createPlan(sourceSchema, context.targetSchemas));
+            }
+            catch (error) {
+                if (core_bentley_1.ITwinError.isError(error, IModelTransformerError_1.IModelTransformerErrorScope, IModelTransformerError_1.IModelTransformerError.SchemaConflict)) {
+                    conflicts.push(error);
+                    continue;
+                }
+                throw error;
+            }
+        }
+        throwSchemaConflicts(conflicts);
+        const schemaEditingContext = new ecschema_metadata_1.SchemaContext();
+        const schemaCandidates = new Map();
+        for (const plan of plans) {
+            if (plan.kind === "dynamic-merge") {
+                collectSchemaCandidates(plan.target, schemaCandidates, true);
+                collectSchemaReferences(plan.source, schemaCandidates);
+            }
+            else if (plan.kind === "dynamic-noop") {
+                collectSchemaCandidates(plan.source, schemaCandidates, false);
+                collectSchemaReferences(plan.source, schemaCandidates);
+            }
+        }
+        for (const { schema } of schemaCandidates.values()) {
+            await schemaEditingContext.addSchema(schema);
+        }
+        const schemaMerger = new ecschema_editing_1.SchemaMerger(schemaEditingContext);
+        const results = [];
+        for (const plan of plans) {
+            switch (plan.kind) {
+                case "new":
+                    if (plan.source.isDynamic ||
+                        (await context.shouldExportSchema(plan.source.schemaKey))) {
+                        results.push({ kind: "source", schema: plan.source });
+                    }
+                    break;
+                case "ordinary":
+                    if (await context.shouldExportSchema(plan.source.schemaKey)) {
+                        results.push({ kind: "source", schema: plan.source });
+                    }
+                    break;
+                case "dynamic-noop":
+                    break;
+                case "dynamic-merge": {
+                    const mergedSchema = await schemaMerger.merge({
+                        ...plan.differences,
+                        conflicts: undefined,
+                    });
+                    const sourceVersion = plan.source.schemaKey.version;
+                    mergedSchema.setVersion(sourceVersion.read, sourceVersion.write, incrementMinorVersion(sourceVersion, plan.target.schemaKey.version));
+                    results.push({ kind: "generated", schema: mergedSchema });
+                    break;
+                }
+            }
+        }
+        appendRequiredNoOpSchemas(results, plans);
+        return results;
+    }
+    async createPlan(source, targetSchemas) {
+        const target = await targetSchemas.getSchema(source.name);
+        if (target === undefined)
+            return { kind: "new", source };
+        if (source.isDynamic !== target.isDynamic) {
+            throw createSchemaConflictError(source, "Schema DynamicSchema marker changed", new Error("The source and target DynamicSchema markers differ."));
+        }
+        if (!source.isDynamic)
+            return { kind: "ordinary", source, target };
+        const sourceVersion = source.schemaKey.version;
+        const targetVersion = target.schemaKey.version;
+        if (sourceVersion.read !== targetVersion.read ||
+            sourceVersion.write !== targetVersion.write) {
+            throw createSchemaConflictError(source, "Dynamic schema has incompatible root versions", new Error(`source ${sourceVersion.toString(false)}, target ${targetVersion.toString(false)}`));
+        }
+        const differences = await this.onSchemaDifferences(source, target, await (0, ecschema_editing_1.getSchemaDifferences)(target, source));
+        const unresolvedConflicts = (differences.conflicts ?? []).filter((conflict) => !isCompatibleReferenceVersionConflict(conflict));
+        if (unresolvedConflicts.length > 0) {
+            throw createSchemaConflictError(source, "Schema conflict", new ecschema_editing_1.SchemaConflictsError(`Schema '${source.name}' has unresolved conflicts`, unresolvedConflicts, source.schemaKey, target.schemaKey));
+        }
+        return differences.differences.length === 0
+            ? { kind: "dynamic-noop", source, target }
+            : { kind: "dynamic-merge", source, target, differences };
+    }
+}
+exports.DynamicSchemaUnionStrategy = DynamicSchemaUnionStrategy;
+function createSchemaConflictError(schema, operation, cause) {
+    return core_bentley_1.ITwinError.create({
+        message: `${operation} for '${schema.schemaKey.toString(false)}': ${cause.message}`,
+        iTwinErrorId: {
+            scope: IModelTransformerError_1.IModelTransformerErrorScope,
+            key: IModelTransformerError_1.IModelTransformerError.SchemaConflict,
+        },
+        cause,
+        schemaKey: schema.schemaKey.toString(false),
+    });
+}
+function throwSchemaConflicts(conflicts) {
+    if (conflicts.length === 1)
+        throw conflicts[0];
+    if (conflicts.length > 1)
+        throw new AggregateError(conflicts, "Schema processing failed");
+}
+function appendRequiredNoOpSchemas(results, plans) {
+    const noOpSchemas = new Map(plans
+        .filter((plan) => plan.kind === "dynamic-noop")
+        .map((plan) => [plan.source.name.toLowerCase(), plan.source]));
+    const requiredNoOpSchemas = new Set();
+    const schemasToVisit = results.map((result) => result.schema);
+    for (const schema of schemasToVisit) {
+        for (const reference of schema.references) {
+            const schemaName = reference.name.toLowerCase();
+            const noOpSchema = noOpSchemas.get(schemaName);
+            if (noOpSchema === undefined || requiredNoOpSchemas.has(schemaName))
+                continue;
+            requiredNoOpSchemas.add(schemaName);
+            schemasToVisit.push(noOpSchema);
+        }
+    }
+    for (const schemaName of requiredNoOpSchemas) {
+        const schema = noOpSchemas.get(schemaName);
+        if (schema !== undefined)
+            results.push({ kind: "source", schema });
+    }
+}
+function incrementMinorVersion(sourceVersion, targetVersion) {
+    const maximumVersion = sourceVersion.compare(targetVersion) >= 0 ? sourceVersion : targetVersion;
+    if (maximumVersion.minor >= 9_999_999) {
+        throw new Error(`Cannot increment schema version ${maximumVersion.toString(false)}`);
+    }
+    return maximumVersion.minor + 1;
+}
+function isCompatibleReferenceVersionConflict(conflict) {
+    if (conflict.code !== ecschema_editing_1.ConflictCode.ConflictingReferenceVersion)
+        return false;
+    if (typeof conflict.source !== "string" ||
+        typeof conflict.target !== "string")
+        return false;
+    const sourceVersion = ecschema_metadata_1.SchemaKey.parseString(conflict.source).version;
+    const targetVersion = ecschema_metadata_1.SchemaKey.parseString(conflict.target).version;
+    return (sourceVersion.read === targetVersion.read &&
+        sourceVersion.write === targetVersion.write);
+}
+function collectSchemaCandidates(schema, candidates, isTargetRoot, visited = new Set()) {
+    const traversalKey = schema.schemaKey.toString();
+    if (visited.has(traversalKey))
+        return;
+    visited.add(traversalKey);
+    const schemaName = schema.name.toLowerCase();
+    const existing = candidates.get(schemaName);
+    if (existing === undefined) {
+        candidates.set(schemaName, { schema, isTargetRoot });
+    }
+    else if (existing.schema.schemaKey.version.read !== schema.schemaKey.version.read ||
+        existing.schema.schemaKey.version.write !== schema.schemaKey.version.write) {
+        throw createSchemaConflictError(schema, "Schema reference has incompatible read/write versions", new Error(`${existing.schema.schemaKey.version.read}.${existing.schema.schemaKey.version.write} ` +
+            `and ${schema.schemaKey.version.read}.${schema.schemaKey.version.write} differ. ` +
+            "Only minor-version reference differences are supported."));
+    }
+    else if (isTargetRoot ||
+        (!existing.isTargetRoot &&
+            schema.schemaKey.version.compare(existing.schema.schemaKey.version) > 0)) {
+        candidates.set(schemaName, { schema, isTargetRoot });
+    }
+    for (const reference of schema.references) {
+        collectSchemaCandidates(reference, candidates, false, visited);
+    }
+}
+function collectSchemaReferences(schema, candidates) {
+    for (const reference of schema.references) {
+        collectSchemaCandidates(reference, candidates, false);
+    }
+}
+//# sourceMappingURL=DynamicSchemaUnionStrategy.js.map

package/lib/cjs/schema-processing/DynamicSchemaUnionStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamicSchemaUnionStrategy.js","sourceRoot":"","sources":["../../../src/schema-processing/DynamicSchemaUnionStrategy.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 iModels\n */\n\nimport { ITwinError } from \"@itwin/core-bentley\";\nimport {\n  AnySchemaDifferenceConflict,\n  ConflictCode,\n  getSchemaDifferences,\n  SchemaConflictsError,\n  SchemaDifferenceResult,\n  SchemaMerger,\n} from \"@itwin/ecschema-editing\";\nimport {\n  ECVersion,\n  Schema,\n  SchemaContext,\n  SchemaKey,\n} from \"@itwin/ecschema-metadata\";\nimport {\n  IModelTransformerError,\n  IModelTransformerErrorScope,\n} from \"../IModelTransformerError\";\nimport {\n  ReadonlySchemaAccessor,\n  SchemaProcessingContext,\n  SchemaProcessingResult,\n  SchemaProcessingStrategy,\n} from \"./SchemaProcessingStrategy\";\n\ntype SchemaPlan =\n  | { kind: \"new\"; source: Schema }\n  | { kind: \"ordinary\"; source: Schema; target: Schema }\n  | { kind: \"dynamic-noop\"; source: Schema; target: Schema }\n  | {\n      kind: \"dynamic-merge\";\n      source: Schema;\n      target: Schema;\n      differences: SchemaDifferenceResult;\n    };\n\ninterface SchemaCandidate {\n  schema: Schema;\n  isTargetRoot: boolean;\n}\n\ninterface SchemaConflictError extends ITwinError {\n  schemaKey: string;\n}\n\n/**\n * Processes ordinary schemas with newer-version selection and unions compatible\n * differences for existing dynamic schemas. Dynamic schema root read and write\n * versions must match; only the minor version may differ.\n * @beta\n */\nexport class DynamicSchemaUnionStrategy implements SchemaProcessingStrategy {\n  /**\n   * Transform schema differences before conflict validation and merging.\n   * A subclass that changes the differencing result is responsible for ensuring\n   * that its changes are safe for the source and target schemas.\n   * @param sourceSchema The source schema being processed.\n   * @param targetSchema The existing target schema.\n   * @param differences The complete result from [[getSchemaDifferences]].\n   * @returns The differencing result to validate and merge.\n   * @beta\n   */\n  protected async onSchemaDifferences(\n    _sourceSchema: Schema,\n    _targetSchema: Schema,\n    differences: SchemaDifferenceResult\n  ): Promise<SchemaDifferenceResult> {\n    return differences;\n  }\n\n  /** Select ordinary schemas and union compatible dynamic schema differences. */\n  public async processSchemas(\n    context: SchemaProcessingContext\n  ): Promise<SchemaProcessingResult[]> {\n    const plans: SchemaPlan[] = [];\n    const conflicts: Error[] = [];\n    for (const sourceSchema of context.sourceSchemas) {\n      try {\n        plans.push(await this.createPlan(sourceSchema, context.targetSchemas));\n      } catch (error: unknown) {\n        if (\n          ITwinError.isError(\n            error,\n            IModelTransformerErrorScope,\n            IModelTransformerError.SchemaConflict\n          )\n        ) {\n          conflicts.push(error);\n          continue;\n        }\n        throw error;\n      }\n    }\n    throwSchemaConflicts(conflicts);\n\n    const schemaEditingContext = new SchemaContext();\n    const schemaCandidates = new Map<string, SchemaCandidate>();\n    for (const plan of plans) {\n      if (plan.kind === \"dynamic-merge\") {\n        collectSchemaCandidates(plan.target, schemaCandidates, true);\n        collectSchemaReferences(plan.source, schemaCandidates);\n      } else if (plan.kind === \"dynamic-noop\") {\n        collectSchemaCandidates(plan.source, schemaCandidates, false);\n        collectSchemaReferences(plan.source, schemaCandidates);\n      }\n    }\n    for (const { schema } of schemaCandidates.values()) {\n      await schemaEditingContext.addSchema(schema);\n    }\n\n    const schemaMerger = new SchemaMerger(schemaEditingContext);\n    const results: SchemaProcessingResult[] = [];\n    for (const plan of plans) {\n      switch (plan.kind) {\n        case \"new\":\n          if (\n            plan.source.isDynamic ||\n            (await context.shouldExportSchema(plan.source.schemaKey))\n          ) {\n            results.push({ kind: \"source\", schema: plan.source });\n          }\n          break;\n        case \"ordinary\":\n          if (await context.shouldExportSchema(plan.source.schemaKey)) {\n            results.push({ kind: \"source\", schema: plan.source });\n          }\n          break;\n        case \"dynamic-noop\":\n          break;\n        case \"dynamic-merge\": {\n          const mergedSchema = await schemaMerger.merge({\n            ...plan.differences,\n            conflicts: undefined,\n          });\n          const sourceVersion = plan.source.schemaKey.version;\n          mergedSchema.setVersion(\n            sourceVersion.read,\n            sourceVersion.write,\n            incrementMinorVersion(sourceVersion, plan.target.schemaKey.version)\n          );\n          results.push({ kind: \"generated\", schema: mergedSchema });\n          break;\n        }\n      }\n    }\n\n    appendRequiredNoOpSchemas(results, plans);\n    return results;\n  }\n\n  private async createPlan(\n    source: Schema,\n    targetSchemas: ReadonlySchemaAccessor\n  ): Promise<SchemaPlan> {\n    const target = await targetSchemas.getSchema(source.name);\n    if (target === undefined) return { kind: \"new\", source };\n\n    if (source.isDynamic !== target.isDynamic) {\n      throw createSchemaConflictError(\n        source,\n        \"Schema DynamicSchema marker changed\",\n        new Error(\"The source and target DynamicSchema markers differ.\")\n      );\n    }\n    if (!source.isDynamic) return { kind: \"ordinary\", source, target };\n\n    const sourceVersion = source.schemaKey.version;\n    const targetVersion = target.schemaKey.version;\n    if (\n      sourceVersion.read !== targetVersion.read ||\n      sourceVersion.write !== targetVersion.write\n    ) {\n      throw createSchemaConflictError(\n        source,\n        \"Dynamic schema has incompatible root versions\",\n        new Error(\n          `source ${sourceVersion.toString(false)}, target ${targetVersion.toString(false)}`\n        )\n      );\n    }\n\n    const differences = await this.onSchemaDifferences(\n      source,\n      target,\n      await getSchemaDifferences(target, source)\n    );\n    const unresolvedConflicts = (differences.conflicts ?? []).filter(\n      (conflict) => !isCompatibleReferenceVersionConflict(conflict)\n    );\n    if (unresolvedConflicts.length > 0) {\n      throw createSchemaConflictError(\n        source,\n        \"Schema conflict\",\n        new SchemaConflictsError(\n          `Schema '${source.name}' has unresolved conflicts`,\n          unresolvedConflicts,\n          source.schemaKey,\n          target.schemaKey\n        )\n      );\n    }\n\n    return differences.differences.length === 0\n      ? { kind: \"dynamic-noop\", source, target }\n      : { kind: \"dynamic-merge\", source, target, differences };\n  }\n}\n\nfunction createSchemaConflictError(\n  schema: Schema,\n  operation: string,\n  cause: Error\n): Error {\n  return ITwinError.create<SchemaConflictError>({\n    message: `${operation} for '${schema.schemaKey.toString(false)}': ${cause.message}`,\n    iTwinErrorId: {\n      scope: IModelTransformerErrorScope,\n      key: IModelTransformerError.SchemaConflict,\n    },\n    cause,\n    schemaKey: schema.schemaKey.toString(false),\n  });\n}\n\nfunction throwSchemaConflicts(conflicts: Error[]): void {\n  if (conflicts.length === 1) throw conflicts[0];\n  if (conflicts.length > 1)\n    throw new AggregateError(conflicts, \"Schema processing failed\");\n}\n\nfunction appendRequiredNoOpSchemas(\n  results: SchemaProcessingResult[],\n  plans: SchemaPlan[]\n): void {\n  const noOpSchemas = new Map(\n    plans\n      .filter((plan) => plan.kind === \"dynamic-noop\")\n      .map((plan) => [plan.source.name.toLowerCase(), plan.source])\n  );\n  const requiredNoOpSchemas = new Set<string>();\n  const schemasToVisit = results.map((result) => result.schema);\n  for (const schema of schemasToVisit) {\n    for (const reference of schema.references) {\n      const schemaName = reference.name.toLowerCase();\n      const noOpSchema = noOpSchemas.get(schemaName);\n      if (noOpSchema === undefined || requiredNoOpSchemas.has(schemaName))\n        continue;\n\n      requiredNoOpSchemas.add(schemaName);\n      schemasToVisit.push(noOpSchema);\n    }\n  }\n  for (const schemaName of requiredNoOpSchemas) {\n    const schema = noOpSchemas.get(schemaName);\n    if (schema !== undefined) results.push({ kind: \"source\", schema });\n  }\n}\n\nfunction incrementMinorVersion(\n  sourceVersion: ECVersion,\n  targetVersion: ECVersion\n): number {\n  const maximumVersion =\n    sourceVersion.compare(targetVersion) >= 0 ? sourceVersion : targetVersion;\n  if (maximumVersion.minor >= 9_999_999) {\n    throw new Error(\n      `Cannot increment schema version ${maximumVersion.toString(false)}`\n    );\n  }\n  return maximumVersion.minor + 1;\n}\n\nfunction isCompatibleReferenceVersionConflict(\n  conflict: AnySchemaDifferenceConflict\n): boolean {\n  if (conflict.code !== ConflictCode.ConflictingReferenceVersion) return false;\n  if (\n    typeof conflict.source !== \"string\" ||\n    typeof conflict.target !== \"string\"\n  )\n    return false;\n\n  const sourceVersion = SchemaKey.parseString(conflict.source).version;\n  const targetVersion = SchemaKey.parseString(conflict.target).version;\n  return (\n    sourceVersion.read === targetVersion.read &&\n    sourceVersion.write === targetVersion.write\n  );\n}\n\nfunction collectSchemaCandidates(\n  schema: Schema,\n  candidates: Map<string, SchemaCandidate>,\n  isTargetRoot: boolean,\n  visited: Set<string> = new Set<string>()\n): void {\n  const traversalKey = schema.schemaKey.toString();\n  if (visited.has(traversalKey)) return;\n  visited.add(traversalKey);\n\n  const schemaName = schema.name.toLowerCase();\n  const existing = candidates.get(schemaName);\n  if (existing === undefined) {\n    candidates.set(schemaName, { schema, isTargetRoot });\n  } else if (\n    existing.schema.schemaKey.version.read !== schema.schemaKey.version.read ||\n    existing.schema.schemaKey.version.write !== schema.schemaKey.version.write\n  ) {\n    throw createSchemaConflictError(\n      schema,\n      \"Schema reference has incompatible read/write versions\",\n      new Error(\n        `${existing.schema.schemaKey.version.read}.${existing.schema.schemaKey.version.write} ` +\n          `and ${schema.schemaKey.version.read}.${schema.schemaKey.version.write} differ. ` +\n          \"Only minor-version reference differences are supported.\"\n      )\n    );\n  } else if (\n    isTargetRoot ||\n    (!existing.isTargetRoot &&\n      schema.schemaKey.version.compare(existing.schema.schemaKey.version) > 0)\n  ) {\n    candidates.set(schemaName, { schema, isTargetRoot });\n  }\n\n  for (const reference of schema.references) {\n    collectSchemaCandidates(reference, candidates, false, visited);\n  }\n}\n\nfunction collectSchemaReferences(\n  schema: Schema,\n  candidates: Map<string, SchemaCandidate>\n): void {\n  for (const reference of schema.references) {\n    collectSchemaCandidates(reference, candidates, false);\n  }\n}\n"]}

package/lib/cjs/schema-processing/SchemaProcessingCoordinator.d.ts

@@ -0,0 +1,25 @@
+import { IModelDb } from "@itwin/core-backend";
+import { Schema, SchemaKey } from "@itwin/ecschema-metadata";
+import { ExportSchemaResult, IModelExporter } from "../IModelExporter";
+import { SchemaProcessingStrategy } from "./SchemaProcessingStrategy";
+interface SchemaProcessingCoordinatorArgs {
+    exporter: IModelExporter;
+    targetDb: IModelDb;
+    getSchemaExportDirectory: () => string;
+    shouldExportSchema: (schemaKey: SchemaKey) => Promise<boolean>;
+    serializeSourceSchema: (schema: Schema) => Promise<void | ExportSchemaResult>;
+}
+/** @internal */
+export declare class SchemaProcessingCoordinator {
+    private readonly _args;
+    private readonly _longNamedSchemas;
+    constructor(_args: SchemaProcessingCoordinatorArgs);
+    process(strategy: SchemaProcessingStrategy): Promise<void>;
+    serializeSourceSchema(schema: Schema): Promise<ExportSchemaResult>;
+    private get _schemaExportDirectory();
+    private serializeSchema;
+    private getSchemaExportFileName;
+    private createLongNameResolvingSchemaContext;
+}
+export {};
+//# sourceMappingURL=SchemaProcessingCoordinator.d.ts.map

package/lib/cjs/schema-processing/SchemaProcessingCoordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaProcessingCoordinator.d.ts","sourceRoot":"","sources":["../../../src/schema-processing/SchemaProcessingCoordinator.ts"],"names":[],"mappings":"AAOA,OAAO,EAAsB,QAAQ,EAAc,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAE,SAAS,EAAgB,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKvE,OAAO,EAGL,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAEpC,UAAU,+BAA+B;IACvC,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,wBAAwB,EAAE,MAAM,MAAM,CAAC;IACvC,kBAAkB,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,qBAAqB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,GAAG,kBAAkB,CAAC,CAAC;CAC/E;AAED,gBAAgB;AAChB,qBAAa,2BAA2B;IAGnB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFzC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA6B;IAE/D,YAAoC,KAAK,EAAE,+BAA+B,EAAI;IAEjE,OAAO,CAAC,QAAQ,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmEtE;IAEY,qBAAqB,CAChC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,kBAAkB,CAAC,CAU7B;IAED,OAAO,KAAK,sBAAsB,GAEjC;YAEa,eAAe;IAe7B,OAAO,CAAC,uBAAuB;IAkB/B,OAAO,CAAC,oCAAoC;CAU7C"}

package/lib/cjs/schema-processing/SchemaProcessingCoordinator.js

@@ -0,0 +1,196 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaProcessingCoordinator = void 0;
+const path = __importStar(require("node:path"));
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_backend_1 = require("@itwin/core-backend");
+const ecschema_metadata_1 = require("@itwin/ecschema-metadata");
+const IModelTransformerError_1 = require("../IModelTransformerError");
+/** @internal */
+class SchemaProcessingCoordinator {
+    _args;
+    _longNamedSchemas = new Map();
+    constructor(_args) {
+        this._args = _args;
+    }
+    async process(strategy) {
+        let processingFailure;
+        try {
+            core_backend_1.IModelJsFs.mkdirSync(this._schemaExportDirectory);
+            this._longNamedSchemas.clear();
+            const sourceSchemas = [];
+            for await (const schema of this._args.exporter.enumerateSchemas()) {
+                sourceSchemas.push(schema);
+            }
+            const targetSchemaLoader = new ecschema_metadata_1.SchemaLoader((name) => this._args.targetDb.getSchemaProps(name));
+            const targetSchemas = {
+                getSchema: async (schemaName) => targetSchemaLoader.tryGetSchema(schemaName),
+            };
+            const processedSchemas = await strategy.processSchemas({
+                sourceSchemas: orderSchemasByDependencies(sourceSchemas),
+                targetSchemas,
+                shouldExportSchema: this._args.shouldExportSchema,
+            });
+            for (const result of processedSchemas) {
+                await this.serializeSchema(result);
+            }
+            const exportedSchemaFiles = core_backend_1.IModelJsFs.readdirSync(this._schemaExportDirectory);
+            if (exportedSchemaFiles.length > 0) {
+                await this._args.targetDb.importSchemas(exportedSchemaFiles.map((fileName) => path.join(this._schemaExportDirectory, fileName)), {
+                    ecSchemaXmlContext: this._longNamedSchemas.size > 0
+                        ? this.createLongNameResolvingSchemaContext()
+                        : undefined,
+                });
+            }
+        }
+        catch (error) {
+            processingFailure = error;
+        }
+        let cleanupFailure;
+        try {
+            core_backend_1.IModelJsFs.removeSync(this._schemaExportDirectory);
+        }
+        catch (error) {
+            cleanupFailure = error;
+        }
+        finally {
+            this._longNamedSchemas.clear();
+        }
+        if (processingFailure !== undefined && cleanupFailure !== undefined) {
+            throw new AggregateError([processingFailure, cleanupFailure], "Schema processing and cleanup failed", { cause: processingFailure });
+        }
+        // Preserve failures from custom strategies and upstream libraries exactly.
+        // eslint-disable-next-line @typescript-eslint/only-throw-error
+        if (processingFailure !== undefined)
+            throw processingFailure;
+        // eslint-disable-next-line @typescript-eslint/only-throw-error
+        if (cleanupFailure !== undefined)
+            throw cleanupFailure;
+    }
+    async serializeSourceSchema(schema) {
+        const schemaFileName = this.getSchemaExportFileName(schema.name);
+        this._args.exporter.sourceDb.exportSchema({
+            schemaName: schema.name,
+            outputDirectory: this._schemaExportDirectory,
+            outputFileName: schemaFileName,
+        });
+        return {
+            schemaPath: path.join(this._schemaExportDirectory, schemaFileName),
+        };
+    }
+    get _schemaExportDirectory() {
+        return this._args.getSchemaExportDirectory();
+    }
+    async serializeSchema(result) {
+        if (result.kind === "source") {
+            await this._args.serializeSourceSchema(result.schema);
+            return;
+        }
+        const schemaLocaters = await import("@itwin/ecschema-locaters");
+        const schemaFileName = this.getSchemaExportFileName(result.schema.name);
+        const schemaXml = await schemaLocaters.SchemaXml.writeString(result.schema);
+        core_backend_1.IModelJsFs.writeFileSync(path.join(this._schemaExportDirectory, schemaFileName), schemaXml);
+    }
+    getSchemaExportFileName(schemaName) {
+        const extension = ".ecschema.xml";
+        let schemaFileName = schemaName + extension;
+        const systemMaxPathSegmentSize = 255;
+        const windowsMaxPathLimit = 260;
+        if (schemaFileName.length > systemMaxPathSegmentSize ||
+            path.join(this._schemaExportDirectory, schemaFileName).length >=
+                windowsMaxPathLimit) {
+            schemaFileName = `${schemaName.slice(0, 100)}${this._longNamedSchemas.size}${extension}`;
+            this._longNamedSchemas.set(schemaName, schemaFileName);
+        }
+        return schemaFileName;
+    }
+    createLongNameResolvingSchemaContext() {
+        const context = new core_backend_1.ECSchemaXmlContext();
+        context.setSchemaLocater((key) => {
+            const schemaFileName = this._longNamedSchemas.get(key.name);
+            return schemaFileName === undefined
+                ? undefined
+                : path.join(this._schemaExportDirectory, schemaFileName);
+        });
+        return context;
+    }
+}
+exports.SchemaProcessingCoordinator = SchemaProcessingCoordinator;
+function orderSchemasByDependencies(schemas) {
+    const schemasByName = new Map(schemas.map((schema) => [schema.name.toLowerCase(), schema]));
+    const state = new Map();
+    const orderedSchemas = [];
+    const stack = [];
+    const visit = (schema) => {
+        const schemaName = schema.name.toLowerCase();
+        const currentState = state.get(schemaName);
+        if (currentState === "visited")
+            return;
+        if (currentState === "visiting") {
+            const cycleStart = stack.indexOf(schemaName);
+            const schemaNames = stack.slice(cycleStart);
+            throw core_bentley_1.ITwinError.create({
+                message: `Schema dependency cycle detected: ${[
+                    ...schemaNames,
+                    schemaName,
+                ].join(" -> ")}`,
+                iTwinErrorId: {
+                    scope: IModelTransformerError_1.IModelTransformerErrorScope,
+                    key: IModelTransformerError_1.IModelTransformerError.SchemaDependencyCycle,
+                },
+                schemaNames,
+            });
+        }
+        state.set(schemaName, "visiting");
+        stack.push(schemaName);
+        for (const reference of schema.references) {
+            const referencedSchema = schemasByName.get(reference.name.toLowerCase());
+            if (referencedSchema !== undefined)
+                visit(referencedSchema);
+        }
+        stack.pop();
+        state.set(schemaName, "visited");
+        orderedSchemas.push(schema);
+    };
+    for (const schema of schemas)
+        visit(schema);
+    return orderedSchemas;
+}
+//# sourceMappingURL=SchemaProcessingCoordinator.js.map

package/lib/cjs/schema-processing/SchemaProcessingCoordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaProcessingCoordinator.js","sourceRoot":"","sources":["../../../src/schema-processing/SchemaProcessingCoordinator.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\nimport * as path from \"node:path\";\nimport { ITwinError } from \"@itwin/core-bentley\";\nimport { ECSchemaXmlContext, IModelDb, IModelJsFs } from \"@itwin/core-backend\";\nimport { Schema, SchemaKey, SchemaLoader } from \"@itwin/ecschema-metadata\";\nimport { ExportSchemaResult, IModelExporter } from \"../IModelExporter\";\nimport {\n  IModelTransformerError,\n  IModelTransformerErrorScope,\n} from \"../IModelTransformerError\";\nimport {\n  ReadonlySchemaAccessor,\n  SchemaProcessingResult,\n  SchemaProcessingStrategy,\n} from \"./SchemaProcessingStrategy\";\n\ninterface SchemaProcessingCoordinatorArgs {\n  exporter: IModelExporter;\n  targetDb: IModelDb;\n  getSchemaExportDirectory: () => string;\n  shouldExportSchema: (schemaKey: SchemaKey) => Promise<boolean>;\n  serializeSourceSchema: (schema: Schema) => Promise<void | ExportSchemaResult>;\n}\n\n/** @internal */\nexport class SchemaProcessingCoordinator {\n  private readonly _longNamedSchemas = new Map<string, string>();\n\n  public constructor(private readonly _args: SchemaProcessingCoordinatorArgs) {}\n\n  public async process(strategy: SchemaProcessingStrategy): Promise<void> {\n    let processingFailure: unknown;\n    try {\n      IModelJsFs.mkdirSync(this._schemaExportDirectory);\n      this._longNamedSchemas.clear();\n\n      const sourceSchemas: Schema[] = [];\n      for await (const schema of this._args.exporter.enumerateSchemas()) {\n        sourceSchemas.push(schema);\n      }\n      const targetSchemaLoader = new SchemaLoader((name) =>\n        this._args.targetDb.getSchemaProps(name)\n      );\n      const targetSchemas: ReadonlySchemaAccessor = {\n        getSchema: async (schemaName) =>\n          targetSchemaLoader.tryGetSchema(schemaName),\n      };\n      const processedSchemas = await strategy.processSchemas({\n        sourceSchemas: orderSchemasByDependencies(sourceSchemas),\n        targetSchemas,\n        shouldExportSchema: this._args.shouldExportSchema,\n      });\n\n      for (const result of processedSchemas) {\n        await this.serializeSchema(result);\n      }\n      const exportedSchemaFiles = IModelJsFs.readdirSync(\n        this._schemaExportDirectory\n      );\n      if (exportedSchemaFiles.length > 0) {\n        await this._args.targetDb.importSchemas(\n          exportedSchemaFiles.map((fileName) =>\n            path.join(this._schemaExportDirectory, fileName)\n          ),\n          {\n            ecSchemaXmlContext:\n              this._longNamedSchemas.size > 0\n                ? this.createLongNameResolvingSchemaContext()\n                : undefined,\n          }\n        );\n      }\n    } catch (error: unknown) {\n      processingFailure = error;\n    }\n\n    let cleanupFailure: unknown;\n    try {\n      IModelJsFs.removeSync(this._schemaExportDirectory);\n    } catch (error: unknown) {\n      cleanupFailure = error;\n    } finally {\n      this._longNamedSchemas.clear();\n    }\n\n    if (processingFailure !== undefined && cleanupFailure !== undefined) {\n      throw new AggregateError(\n        [processingFailure, cleanupFailure],\n        \"Schema processing and cleanup failed\",\n        { cause: processingFailure }\n      );\n    }\n    // Preserve failures from custom strategies and upstream libraries exactly.\n    // eslint-disable-next-line @typescript-eslint/only-throw-error\n    if (processingFailure !== undefined) throw processingFailure;\n    // eslint-disable-next-line @typescript-eslint/only-throw-error\n    if (cleanupFailure !== undefined) throw cleanupFailure;\n  }\n\n  public async serializeSourceSchema(\n    schema: Schema\n  ): Promise<ExportSchemaResult> {\n    const schemaFileName = this.getSchemaExportFileName(schema.name);\n    this._args.exporter.sourceDb.exportSchema({\n      schemaName: schema.name,\n      outputDirectory: this._schemaExportDirectory,\n      outputFileName: schemaFileName,\n    });\n    return {\n      schemaPath: path.join(this._schemaExportDirectory, schemaFileName),\n    };\n  }\n\n  private get _schemaExportDirectory(): string {\n    return this._args.getSchemaExportDirectory();\n  }\n\n  private async serializeSchema(result: SchemaProcessingResult): Promise<void> {\n    if (result.kind === \"source\") {\n      await this._args.serializeSourceSchema(result.schema);\n      return;\n    }\n\n    const schemaLocaters = await import(\"@itwin/ecschema-locaters\");\n    const schemaFileName = this.getSchemaExportFileName(result.schema.name);\n    const schemaXml = await schemaLocaters.SchemaXml.writeString(result.schema);\n    IModelJsFs.writeFileSync(\n      path.join(this._schemaExportDirectory, schemaFileName),\n      schemaXml\n    );\n  }\n\n  private getSchemaExportFileName(schemaName: string): string {\n    const extension = \".ecschema.xml\";\n    let schemaFileName = schemaName + extension;\n    const systemMaxPathSegmentSize = 255;\n    const windowsMaxPathLimit = 260;\n    if (\n      schemaFileName.length > systemMaxPathSegmentSize ||\n      path.join(this._schemaExportDirectory, schemaFileName).length >=\n        windowsMaxPathLimit\n    ) {\n      schemaFileName = `${schemaName.slice(0, 100)}${\n        this._longNamedSchemas.size\n      }${extension}`;\n      this._longNamedSchemas.set(schemaName, schemaFileName);\n    }\n    return schemaFileName;\n  }\n\n  private createLongNameResolvingSchemaContext(): ECSchemaXmlContext {\n    const context = new ECSchemaXmlContext();\n    context.setSchemaLocater((key) => {\n      const schemaFileName = this._longNamedSchemas.get(key.name);\n      return schemaFileName === undefined\n        ? undefined\n        : path.join(this._schemaExportDirectory, schemaFileName);\n    });\n    return context;\n  }\n}\n\ninterface SchemaDependencyCycleError extends ITwinError {\n  schemaNames: readonly string[];\n}\n\nfunction orderSchemasByDependencies(schemas: Schema[]): Schema[] {\n  const schemasByName = new Map(\n    schemas.map((schema) => [schema.name.toLowerCase(), schema])\n  );\n  const state = new Map<string, \"visiting\" | \"visited\">();\n  const orderedSchemas: Schema[] = [];\n  const stack: string[] = [];\n\n  const visit = (schema: Schema): void => {\n    const schemaName = schema.name.toLowerCase();\n    const currentState = state.get(schemaName);\n    if (currentState === \"visited\") return;\n    if (currentState === \"visiting\") {\n      const cycleStart = stack.indexOf(schemaName);\n      const schemaNames = stack.slice(cycleStart);\n      throw ITwinError.create<SchemaDependencyCycleError>({\n        message: `Schema dependency cycle detected: ${[\n          ...schemaNames,\n          schemaName,\n        ].join(\" -> \")}`,\n        iTwinErrorId: {\n          scope: IModelTransformerErrorScope,\n          key: IModelTransformerError.SchemaDependencyCycle,\n        },\n        schemaNames,\n      });\n    }\n\n    state.set(schemaName, \"visiting\");\n    stack.push(schemaName);\n    for (const reference of schema.references) {\n      const referencedSchema = schemasByName.get(reference.name.toLowerCase());\n      if (referencedSchema !== undefined) visit(referencedSchema);\n    }\n    stack.pop();\n    state.set(schemaName, \"visited\");\n    orderedSchemas.push(schema);\n  };\n\n  for (const schema of schemas) visit(schema);\n  return orderedSchemas;\n}\n"]}

package/lib/cjs/schema-processing/SchemaProcessingStrategy.d.ts

@@ -0,0 +1,59 @@
+/** @packageDocumentation
+ * @module iModels
+ */
+import { Schema, SchemaKey } from "@itwin/ecschema-metadata";
+/**
+ * The result of processing one schema.
+ * @beta
+ */
+export type SchemaProcessingResult = {
+    kind: "source";
+    schema: Schema;
+} | {
+    kind: "generated";
+    schema: Schema;
+};
+/** Read-only access to schemas already present in the target iModel.
+ * @beta
+ */
+export interface ReadonlySchemaAccessor {
+    /** Load a target schema by name, or return `undefined` when it is absent. */
+    getSchema(schemaName: string): Promise<Schema | undefined>;
+}
+/**
+ * Context supplied to a [[SchemaProcessingStrategy]].
+ * @beta
+ */
+export interface SchemaProcessingContext {
+    /** Source schemas in dependency order. */
+    readonly sourceSchemas: readonly Schema[];
+    /** Read-only access to schemas already present in the target. */
+    readonly targetSchemas: ReadonlySchemaAccessor;
+    /** The schema-selection hook used by the default transformer path. */
+    readonly shouldExportSchema: (schemaKey: SchemaKey) => Promise<boolean>;
+}
+/**
+ * Selects source schemas and produces definitions for import into a target iModel.
+ * @beta
+ */
+export interface SchemaProcessingStrategy {
+    /** Select source schemas and produce definitions for import into the target iModel. */
+    processSchemas(context: SchemaProcessingContext): Promise<SchemaProcessingResult[]>;
+}
+/**
+ * Options for [[IModelTransformer.processSchemas]].
+ * @beta
+ */
+export interface ProcessSchemasOptions {
+    /** Strategy used to select and process source schemas. */
+    strategy?: SchemaProcessingStrategy;
+}
+/**
+ * Selects source schemas that are absent from the target or have a newer version.
+ * @beta
+ */
+export declare class NewerVersionSchemaImportStrategy implements SchemaProcessingStrategy {
+    /** Select schemas that are absent from the target or have a newer version. */
+    processSchemas(context: SchemaProcessingContext): Promise<SchemaProcessingResult[]>;
+}
+//# sourceMappingURL=SchemaProcessingStrategy.d.ts.map

package/lib/cjs/schema-processing/SchemaProcessingStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaProcessingStrategy.d.ts","sourceRoot":"","sources":["../../../src/schema-processing/SchemaProcessingStrategy.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAC5D;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,iEAAiE;IACjE,QAAQ,CAAC,aAAa,EAAE,sBAAsB,CAAC;IAC/C,sEAAsE;IACtE,QAAQ,CAAC,kBAAkB,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACzE;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,uFAAuF;IACvF,cAAc,CACZ,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,wBAAwB,CAAC;CACrC;AAED;;;GAGG;AACH,qBAAa,gCACX,YAAW,wBAAwB;IAEnC,8EAA8E;IACjE,cAAc,CACzB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAQnC;CACF"}

package/lib/cjs/schema-processing/SchemaProcessingStrategy.js

@@ -0,0 +1,28 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module iModels
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NewerVersionSchemaImportStrategy = void 0;
+/**
+ * Selects source schemas that are absent from the target or have a newer version.
+ * @beta
+ */
+class NewerVersionSchemaImportStrategy {
+    /** Select schemas that are absent from the target or have a newer version. */
+    async processSchemas(context) {
+        const results = [];
+        for (const schema of context.sourceSchemas) {
+            if (await context.shouldExportSchema(schema.schemaKey)) {
+                results.push({ kind: "source", schema });
+            }
+        }
+        return results;
+    }
+}
+exports.NewerVersionSchemaImportStrategy = NewerVersionSchemaImportStrategy;
+//# sourceMappingURL=SchemaProcessingStrategy.js.map