@itwin/core-backend 5.13.0-dev.2 → 5.13.0-dev.21

package/lib/esm/test/standalone/SchemaSyncDb.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SchemaSyncDb.test.d.ts.map

package/lib/esm/test/standalone/SchemaSyncDb.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaSyncDb.test.d.ts","sourceRoot":"","sources":["../../../../src/test/standalone/SchemaSyncDb.test.ts"],"names":[],"mappings":""}

package/lib/esm/test/standalone/SchemaSyncDb.test.js

@@ -0,0 +1,201 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { Guid, Id64, OpenMode } from "@itwin/core-bentley";
+import { BriefcaseIdValue, Code, ElementReservationError } from "@itwin/core-common";
+import { expect } from "chai";
+import { IModelJsFs, SchemaSync } from "../../core-backend";
+import { _nativeDb } from "../../internal/Symbols";
+import { IModelTestUtils } from "../IModelTestUtils";
+/** Assert that `promise` rejects with an `ElementReservationError` carrying the given key. */
+async function expectReservationError(promise, key) {
+    try {
+        await promise;
+    }
+    catch (err) {
+        expect(ElementReservationError.isError(err, key), `expected ElementReservationError '${key}', got: ${JSON.stringify(err)}`).to.be.true;
+        return;
+    }
+    expect.fail(`expected promise to reject with ElementReservationError '${key}'`);
+}
+describe("SchemaSyncDb", () => {
+    let schemaDb;
+    let schemaDbFileName;
+    beforeEach(() => {
+        schemaDbFileName = IModelTestUtils.prepareOutputFile("SchemaSyncDb", "schema-sync.db");
+        SchemaSync.SchemaSyncDb.createNewDb(schemaDbFileName);
+        schemaDb = new SchemaSync.SchemaSyncDb();
+        schemaDb.openDb(schemaDbFileName, OpenMode.ReadWrite);
+    });
+    afterEach(() => {
+        if (schemaDb.isOpen)
+            schemaDb.closeDb();
+        IModelJsFs.removeSync(schemaDbFileName);
+    });
+    function simulateVersion4Db() {
+        schemaDb.setRequiredVersions({ readVersion: "^4.0.0", writeVersion: "^4.0.0" });
+        schemaDb.saveChanges();
+    }
+    function getTableInfo(tableName) {
+        return schemaDb.withSqliteStatement(`PRAGMA table_info(${tableName})`, (stmt) => {
+            const rows = [];
+            while (stmt.nextRow())
+                rows.push({ name: stmt.getValueString(1), type: stmt.getValueString(2), notnull: stmt.getValueInteger(3) });
+            return rows;
+        });
+    }
+    function readReservedRows() {
+        return schemaDb.withSqliteStatement("SELECT federationGuid, elementId, ecClassId, codeValue FROM reserved_elements ORDER BY elementId", (stmt) => {
+            const rows = [];
+            while (stmt.nextRow()) {
+                rows.push({
+                    federationGuid: stmt.getValueGuid(0),
+                    elementId: stmt.getValueId(1),
+                    ecClassId: stmt.getValueId(2),
+                    codeValue: stmt.getValueString(3),
+                });
+            }
+            return rows;
+        });
+    }
+    // eslint-disable-next-line @typescript-eslint/dot-notation
+    const readNextLocalId = () => schemaDb["getNextReservedElementLocalId"]();
+    describe("schema", () => {
+        it("creates the reserved_elements table with elementId NOT NULL UNIQUE", () => {
+            const cols = getTableInfo("reserved_elements");
+            const names = cols.map((c) => c.name).sort();
+            expect(names).to.deep.equal(["codeScope", "codeSpecId", "codeValue", "ecClassId", "elementId", "federationGuid"]);
+            const elementIdCol = cols.find((c) => c.name === "elementId");
+            expect(elementIdCol.notnull).to.equal(1);
+        });
+        it("refuses a database from the previous major version", () => {
+            simulateVersion4Db();
+            schemaDb.closeDb();
+            expect(() => schemaDb.openDb(schemaDbFileName, OpenMode.ReadWrite)).to.throw();
+        });
+    });
+    describe("reserveElements", () => {
+        function makeReservation(federationGuid, codeValue, ecClassId = "0x1") {
+            return {
+                federationGuid,
+                ecClassId,
+                code: Code.fromJSON({ spec: "0x1", scope: "0x2", value: codeValue }),
+            };
+        }
+        it("throws when nextReservedElementLocalId file property is corrupt", async () => {
+            for (const corruptValue of ["abc", "0", "-1", "1.5"]) {
+                schemaDb[_nativeDb].saveFileProperty({ namespace: "schemasync", name: "nextReservedElementLocalId" }, corruptValue);
+                schemaDb.saveChanges();
+                await expectReservationError(schemaDb.reserveElements([
+                    makeReservation(Guid.createValue(), "cat"),
+                ]), "corrupt-reservation-data");
+            }
+        });
+        it("rejects duplicate non-empty code values across different federation guids", async () => {
+            await expect(schemaDb.reserveElements([
+                makeReservation(Guid.createValue(), "Cat-X"),
+                makeReservation(Guid.createValue(), "Cat-X"),
+            ])).to.be.rejected;
+        });
+        it("treats code values case-insensitively when enforcing uniqueness", async () => {
+            await expect(schemaDb.reserveElements([
+                makeReservation(Guid.createValue(), "Cat-A"),
+                makeReservation(Guid.createValue(), "cat-a"),
+            ])).to.be.rejected;
+        });
+        it("persists local-id counter across reserve calls", async () => {
+            await schemaDb.reserveElements([
+                makeReservation(Guid.createValue(), "Cat-A"),
+            ]);
+            expect(readNextLocalId()).to.equal(2);
+            await schemaDb.reserveElements([
+                makeReservation(Guid.createValue(), "Cat-B"),
+            ]);
+            expect(readNextLocalId()).to.equal(3);
+        });
+        it("allocates the elementId using the SchemaSyncElementReserved briefcase id", async () => {
+            await schemaDb.reserveElements([makeReservation(Guid.createValue(), "Cat-A")]);
+            const elementId = readReservedRows()[0].elementId;
+            expect(elementId).to.equal(Id64.fromLocalAndBriefcaseIds(1, BriefcaseIdValue.SchemaSyncElementReserved));
+            expect(Id64.getBriefcaseId(elementId)).to.equal(BriefcaseIdValue.SchemaSyncElementReserved);
+            expect(Id64.getLocalId(elementId)).to.equal(1);
+        });
+        it("assigns sequential local Ids for a batch", async () => {
+            await schemaDb.reserveElements([
+                makeReservation(Guid.createValue(), "Cat-A"),
+                makeReservation(Guid.createValue(), "Cat-B"),
+                makeReservation(Guid.createValue(), "Cat-C"),
+            ]);
+            const rows = readReservedRows();
+            expect(rows).to.have.lengthOf(3);
+            expect(rows.map((r) => Id64.getLocalId(r.elementId))).to.deep.equal([1, 2, 3]);
+            expect(readNextLocalId()).to.equal(4);
+        });
+        it("is idempotent within a single call (duplicate element props)", async () => {
+            const federationGuid = Guid.createValue();
+            await schemaDb.reserveElements([
+                makeReservation(federationGuid, "Cat-A"),
+                makeReservation(federationGuid, "Cat-A"),
+            ]);
+            expect(readReservedRows()).to.have.lengthOf(1);
+            expect(readNextLocalId()).to.equal(2);
+        });
+        it("is idempotent across calls (returns existing id, allocates no new row)", async () => {
+            const federationGuid = Guid.createValue();
+            await schemaDb.reserveElements([makeReservation(federationGuid, "Cat-A")]);
+            const firstId = readReservedRows()[0].elementId;
+            await schemaDb.reserveElements([makeReservation(federationGuid, "Cat-A")]);
+            expect(readReservedRows()).to.have.lengthOf(1);
+            expect(readReservedRows()[0].elementId).to.equal(firstId);
+            expect(readNextLocalId()).to.equal(2);
+        });
+        it("allows multiple identities with empty codes to coexist", async () => {
+            await schemaDb.reserveElements([
+                makeReservation(Guid.createValue(), ""),
+                makeReservation(Guid.createValue(), ""),
+                makeReservation(Guid.createValue(), ""),
+            ]);
+            const rows = readReservedRows();
+            expect(rows).to.have.lengthOf(3);
+            expect(new Set(rows.map((r) => r.elementId)).size).to.equal(3);
+        });
+        it("throws when an existing reservation has a different class", async () => {
+            const federationGuid = Guid.createValue();
+            await schemaDb.reserveElements([makeReservation(federationGuid, "Cat-A", "0x1")]);
+            await expectReservationError(schemaDb.reserveElements([
+                makeReservation(federationGuid, "Cat-A", "0x2"),
+            ]), "reservation-conflict");
+        });
+        it("throws when federationGuid and code resolve to different existing rows", async () => {
+            const federationGuidA = Guid.createValue();
+            const federationGuidB = Guid.createValue();
+            await schemaDb.reserveElements([
+                makeReservation(federationGuidA, "Cat-A"),
+                makeReservation(federationGuidB, "Cat-B"),
+            ]);
+            // fedGuid lookup returns the A row, code lookup returns the B row.
+            await expectReservationError(schemaDb.reserveElements([
+                makeReservation(federationGuidA, "Cat-B"),
+            ]), "reservation-conflict");
+        });
+        it("throws when the local-id sequence is exhausted", async () => {
+            // eslint-disable-next-line @typescript-eslint/dot-notation
+            schemaDb["setNextReservedElementLocalId"](Math.pow(2, 40) - 2); // Seed counter near the 2^40 ceiling.
+            schemaDb.saveChanges();
+            await expectReservationError(schemaDb.reserveElements([
+                makeReservation(Guid.createValue(), "Cat-A"),
+                makeReservation(Guid.createValue(), "Cat-B"),
+                makeReservation(Guid.createValue(), "Cat-C"),
+            ]), "id-sequence-exhausted");
+            expect(readReservedRows()).to.be.empty;
+        });
+        it("throws when a federationGuid is missing", async () => {
+            await expectReservationError(schemaDb.reserveElements([
+                { ecClassId: "0x1", code: Code.fromJSON({ spec: "0x1", scope: "0x2", value: "Cat-A" }) },
+            ]), "invalid-reservation");
+            expect(readReservedRows()).to.be.empty;
+        });
+    });
+});
+//# sourceMappingURL=SchemaSyncDb.test.js.map

package/lib/esm/test/standalone/SchemaSyncDb.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaSyncDb.test.js","sourceRoot":"","sources":["../../../../src/test/standalone/SchemaSyncDb.test.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nimport { Guid, Id64, OpenMode } from \"@itwin/core-bentley\";\r\nimport { BriefcaseIdValue, Code, ElementReservationError } from \"@itwin/core-common\";\r\nimport { expect } from \"chai\";\r\nimport { IModelJsFs, SchemaSync } from \"../../core-backend\";\r\nimport { _nativeDb } from \"../../internal/Symbols\";\r\nimport { IModelTestUtils } from \"../IModelTestUtils\";\r\n\r\n/** Assert that `promise` rejects with an `ElementReservationError` carrying the given key. */\r\nasync function expectReservationError(promise: Promise<unknown>, key: ElementReservationError.Key): Promise<void> {\r\n  try {\r\n    await promise;\r\n  } catch (err) {\r\n    expect(ElementReservationError.isError(err, key), `expected ElementReservationError '${key}', got: ${JSON.stringify(err)}`).to.be.true;\r\n    return;\r\n  }\r\n  expect.fail(`expected promise to reject with ElementReservationError '${key}'`);\r\n}\r\n\r\ndescribe(\"SchemaSyncDb\", () => {\r\n  let schemaDb: SchemaSync.SchemaSyncDb;\r\n  let schemaDbFileName: string;\r\n\r\n  beforeEach(() => {\r\n    schemaDbFileName = IModelTestUtils.prepareOutputFile(\"SchemaSyncDb\", \"schema-sync.db\");\r\n    SchemaSync.SchemaSyncDb.createNewDb(schemaDbFileName);\r\n    schemaDb = new SchemaSync.SchemaSyncDb();\r\n    schemaDb.openDb(schemaDbFileName, OpenMode.ReadWrite);\r\n  });\r\n\r\n  afterEach(() => {\r\n    if (schemaDb.isOpen)\r\n      schemaDb.closeDb();\r\n    IModelJsFs.removeSync(schemaDbFileName);\r\n  });\r\n\r\n  function simulateVersion4Db() {\r\n    schemaDb.setRequiredVersions({ readVersion: \"^4.0.0\", writeVersion: \"^4.0.0\" });\r\n    schemaDb.saveChanges();\r\n  }\r\n\r\n  function getTableInfo(tableName: string) {\r\n    return schemaDb.withSqliteStatement(`PRAGMA table_info(${tableName})`, (stmt) => {\r\n      const rows: Array<{ name: string, type: string, notnull: number }> = [];\r\n      while (stmt.nextRow())\r\n        rows.push({ name: stmt.getValueString(1), type: stmt.getValueString(2), notnull: stmt.getValueInteger(3) });\r\n      return rows;\r\n    });\r\n  }\r\n\r\n  function readReservedRows(): Array<{ federationGuid: string, elementId: string, ecClassId: string, codeValue: string }> {\r\n    return schemaDb.withSqliteStatement(\r\n      \"SELECT federationGuid, elementId, ecClassId, codeValue FROM reserved_elements ORDER BY elementId\",\r\n      (stmt) => {\r\n        const rows: Array<{ federationGuid: string, elementId: string, ecClassId: string, codeValue: string }> = [];\r\n        while (stmt.nextRow()) {\r\n          rows.push({\r\n            federationGuid: stmt.getValueGuid(0),\r\n            elementId: stmt.getValueId(1),\r\n            ecClassId: stmt.getValueId(2),\r\n            codeValue: stmt.getValueString(3),\r\n          });\r\n        }\r\n        return rows;\r\n      },\r\n    );\r\n  }\r\n\r\n  // eslint-disable-next-line @typescript-eslint/dot-notation\r\n  const readNextLocalId = () => schemaDb[\"getNextReservedElementLocalId\"]();\r\n\r\n  describe(\"schema\", () => {\r\n    it(\"creates the reserved_elements table with elementId NOT NULL UNIQUE\", () => {\r\n      const cols = getTableInfo(\"reserved_elements\");\r\n      const names = cols.map((c) => c.name).sort();\r\n      expect(names).to.deep.equal([\"codeScope\", \"codeSpecId\", \"codeValue\", \"ecClassId\", \"elementId\", \"federationGuid\"]);\r\n      const elementIdCol = cols.find((c) => c.name === \"elementId\")!;\r\n      expect(elementIdCol.notnull).to.equal(1);\r\n    });\r\n\r\n    it(\"refuses a database from the previous major version\", () => {\r\n      simulateVersion4Db();\r\n      schemaDb.closeDb();\r\n\r\n      expect(() => schemaDb.openDb(schemaDbFileName, OpenMode.ReadWrite)).to.throw();\r\n    });\r\n  });\r\n\r\n  describe(\"reserveElements\", () => {\r\n    function makeReservation(federationGuid: string, codeValue: string, ecClassId = \"0x1\"): SchemaSync.ProposedElementReservation {\r\n      return {\r\n        federationGuid,\r\n        ecClassId,\r\n        code: Code.fromJSON({ spec: \"0x1\", scope: \"0x2\", value: codeValue }),\r\n      };\r\n    }\r\n\r\n    it(\"throws when nextReservedElementLocalId file property is corrupt\", async () => {\r\n      for (const corruptValue of [\"abc\", \"0\", \"-1\", \"1.5\"]) {\r\n        schemaDb[_nativeDb].saveFileProperty({ namespace: \"schemasync\", name: \"nextReservedElementLocalId\" }, corruptValue);\r\n        schemaDb.saveChanges();\r\n\r\n        await expectReservationError(schemaDb.reserveElements([\r\n          makeReservation(Guid.createValue(), \"cat\"),\r\n        ]), \"corrupt-reservation-data\");\r\n      }\r\n    });\r\n\r\n    it(\"rejects duplicate non-empty code values across different federation guids\", async () => {\r\n      await expect(schemaDb.reserveElements([\r\n        makeReservation(Guid.createValue(), \"Cat-X\"),\r\n        makeReservation(Guid.createValue(), \"Cat-X\"),\r\n      ])).to.be.rejected;\r\n    });\r\n\r\n    it(\"treats code values case-insensitively when enforcing uniqueness\", async () => {\r\n      await expect(schemaDb.reserveElements([\r\n        makeReservation(Guid.createValue(), \"Cat-A\"),\r\n        makeReservation(Guid.createValue(), \"cat-a\"),\r\n      ])).to.be.rejected;\r\n    });\r\n\r\n    it(\"persists local-id counter across reserve calls\", async () => {\r\n      await schemaDb.reserveElements([\r\n        makeReservation(Guid.createValue(), \"Cat-A\"),\r\n      ]);\r\n      expect(readNextLocalId()).to.equal(2);\r\n\r\n      await schemaDb.reserveElements([\r\n        makeReservation(Guid.createValue(), \"Cat-B\"),\r\n      ]);\r\n      expect(readNextLocalId()).to.equal(3);\r\n    });\r\n\r\n    it(\"allocates the elementId using the SchemaSyncElementReserved briefcase id\", async () => {\r\n      await schemaDb.reserveElements([makeReservation(Guid.createValue(), \"Cat-A\")]);\r\n      const elementId = readReservedRows()[0].elementId;\r\n      expect(elementId).to.equal(Id64.fromLocalAndBriefcaseIds(1, BriefcaseIdValue.SchemaSyncElementReserved));\r\n      expect(Id64.getBriefcaseId(elementId)).to.equal(BriefcaseIdValue.SchemaSyncElementReserved);\r\n      expect(Id64.getLocalId(elementId)).to.equal(1);\r\n    });\r\n\r\n    it(\"assigns sequential local Ids for a batch\", async () => {\r\n      await schemaDb.reserveElements([\r\n        makeReservation(Guid.createValue(), \"Cat-A\"),\r\n        makeReservation(Guid.createValue(), \"Cat-B\"),\r\n        makeReservation(Guid.createValue(), \"Cat-C\"),\r\n      ]);\r\n      const rows = readReservedRows();\r\n      expect(rows).to.have.lengthOf(3);\r\n      expect(rows.map((r) => Id64.getLocalId(r.elementId))).to.deep.equal([1, 2, 3]);\r\n      expect(readNextLocalId()).to.equal(4);\r\n    });\r\n\r\n    it(\"is idempotent within a single call (duplicate element props)\", async () => {\r\n      const federationGuid = Guid.createValue();\r\n      await schemaDb.reserveElements([\r\n        makeReservation(federationGuid, \"Cat-A\"),\r\n        makeReservation(federationGuid, \"Cat-A\"),\r\n      ]);\r\n      expect(readReservedRows()).to.have.lengthOf(1);\r\n      expect(readNextLocalId()).to.equal(2);\r\n    });\r\n\r\n    it(\"is idempotent across calls (returns existing id, allocates no new row)\", async () => {\r\n      const federationGuid = Guid.createValue();\r\n      await schemaDb.reserveElements([makeReservation(federationGuid, \"Cat-A\")]);\r\n      const firstId = readReservedRows()[0].elementId;\r\n\r\n      await schemaDb.reserveElements([makeReservation(federationGuid, \"Cat-A\")]);\r\n      expect(readReservedRows()).to.have.lengthOf(1);\r\n      expect(readReservedRows()[0].elementId).to.equal(firstId);\r\n      expect(readNextLocalId()).to.equal(2);\r\n    });\r\n\r\n    it(\"allows multiple identities with empty codes to coexist\", async () => {\r\n      await schemaDb.reserveElements([\r\n        makeReservation(Guid.createValue(), \"\"),\r\n        makeReservation(Guid.createValue(), \"\"),\r\n        makeReservation(Guid.createValue(), \"\"),\r\n      ]);\r\n      const rows = readReservedRows();\r\n      expect(rows).to.have.lengthOf(3);\r\n      expect(new Set(rows.map((r) => r.elementId)).size).to.equal(3);\r\n    });\r\n\r\n    it(\"throws when an existing reservation has a different class\", async () => {\r\n      const federationGuid = Guid.createValue();\r\n      await schemaDb.reserveElements([makeReservation(federationGuid, \"Cat-A\", \"0x1\")]);\r\n      await expectReservationError(schemaDb.reserveElements([\r\n        makeReservation(federationGuid, \"Cat-A\", \"0x2\"),\r\n      ]), \"reservation-conflict\");\r\n    });\r\n\r\n    it(\"throws when federationGuid and code resolve to different existing rows\", async () => {\r\n      const federationGuidA = Guid.createValue();\r\n      const federationGuidB = Guid.createValue();\r\n      await schemaDb.reserveElements([\r\n        makeReservation(federationGuidA, \"Cat-A\"),\r\n        makeReservation(federationGuidB, \"Cat-B\"),\r\n      ]);\r\n      // fedGuid lookup returns the A row, code lookup returns the B row.\r\n      await expectReservationError(schemaDb.reserveElements([\r\n        makeReservation(federationGuidA, \"Cat-B\"),\r\n      ]), \"reservation-conflict\");\r\n    });\r\n\r\n    it(\"throws when the local-id sequence is exhausted\", async () => {\r\n      // eslint-disable-next-line @typescript-eslint/dot-notation\r\n      schemaDb[\"setNextReservedElementLocalId\"](Math.pow(2, 40) - 2); // Seed counter near the 2^40 ceiling.\r\n      schemaDb.saveChanges();\r\n      await expectReservationError(schemaDb.reserveElements([\r\n        makeReservation(Guid.createValue(), \"Cat-A\"),\r\n        makeReservation(Guid.createValue(), \"Cat-B\"),\r\n        makeReservation(Guid.createValue(), \"Cat-C\"),\r\n      ]), \"id-sequence-exhausted\");\r\n      expect(readReservedRows()).to.be.empty;\r\n    });\r\n\r\n    it(\"throws when a federationGuid is missing\", async () => {\r\n      await expectReservationError(schemaDb.reserveElements([\r\n        { ecClassId: \"0x1\", code: Code.fromJSON({ spec: \"0x1\", scope: \"0x2\", value: \"Cat-A\" }) } as any,\r\n      ]), \"invalid-reservation\");\r\n      expect(readReservedRows()).to.be.empty;\r\n    });\r\n  });\r\n});\r\n"]}

package/lib/esm/test/standalone/SchemaSyncElementReservation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SchemaSyncElementReservation.test.d.ts.map

package/lib/esm/test/standalone/SchemaSyncElementReservation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaSyncElementReservation.test.d.ts","sourceRoot":"","sources":["../../../../src/test/standalone/SchemaSyncElementReservation.test.ts"],"names":[],"mappings":""}