@verdant-web/common 1.11.0

package/dist/cjs/oids.js

@@ -0,0 +1,375 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRoots = exports.getOidRange = exports.getOidRoot = exports.normalizeFirstLevel = exports.normalize = exports.createRef = exports.createOidSubId = exports.removeOidsFromAllSubObjects = exports.removeOidPropertiesFromAllSubObjects = exports.assignOidPropertiesToAllSubObjects = exports.maybeGetOidProperty = exports.assignOidProperty = exports.assignOidsToAllSubObjects = exports.assertAllLevelsHaveOids = exports.decomposeOid = exports.createSubOid = exports.createOid = exports.ensureOid = exports.isOidKey = exports.removeOid = exports.hasOid = exports.assignOid = exports.maybeGetOid = exports.getOid = exports.OID_KEY = exports.LEGACY_OID_KEY = void 0;
+const uuid_1 = require("uuid");
+const files_js_1 = require("./files.js");
+const operation_js_1 = require("./operation.js");
+const refs_js_1 = require("./refs.js");
+const utils_js_1 = require("./utils.js");
+exports.LEGACY_OID_KEY = '__@@oid_do_not_use';
+exports.OID_KEY = '@@id';
+const KEY_PATH_SEPARATOR = '.';
+const COLLECTION_SEPARATOR = '/';
+const RANDOM_SEPARATOR = ':';
+/**
+ * This is the global, in-memory storage for all OIDs. It is used to
+ * associate JS objects with OIDs without modifying the objects themselves.
+ */
+const oidMap = new WeakMap();
+function getOid(obj) {
+    const oid = maybeGetOid(obj);
+    (0, utils_js_1.assert)(!!oid, `Object ${JSON.stringify(obj)} does not have an OID assigned to it`);
+    return oid;
+}
+exports.getOid = getOid;
+function maybeGetOid(obj) {
+    var _a, _b;
+    if (!(0, utils_js_1.isObject)(obj)) {
+        return undefined;
+    }
+    return (_b = (_a = oidMap.get(obj)) !== null && _a !== void 0 ? _a : obj[exports.OID_KEY]) !== null && _b !== void 0 ? _b : obj[exports.LEGACY_OID_KEY];
+}
+exports.maybeGetOid = maybeGetOid;
+function assignOid(obj, oid) {
+    (0, utils_js_1.assert)((0, utils_js_1.isObject)(obj), `Only objects can be assigned OIDs, received ${JSON.stringify(obj)}`);
+    oidMap.set(obj, oid);
+    return obj;
+}
+exports.assignOid = assignOid;
+function hasOid(obj) {
+    return !!maybeGetOid(obj);
+}
+exports.hasOid = hasOid;
+function removeOid(obj) {
+    oidMap.delete(obj);
+    return obj;
+}
+exports.removeOid = removeOid;
+function isOidKey(key) {
+    return key === exports.OID_KEY || key === exports.LEGACY_OID_KEY;
+}
+exports.isOidKey = isOidKey;
+/**
+ * For sub-objects, assign a random sub-OID if no OID
+ * is already assigned.
+ */
+function ensureOid(obj, rootOid, key, createSubId) {
+    if (!hasOid(obj)) {
+        const oid = createSubOid(rootOid, key, createSubId);
+        assignOid(obj, oid);
+        return oid;
+    }
+    else {
+        return getOid(obj);
+    }
+}
+exports.ensureOid = ensureOid;
+const SANTIIZE_PLACEHOLDERS = {
+    '.': '˙',
+    '/': '&slash;',
+    ':': ':',
+};
+function sanitizeFragment(id) {
+    // replaces separator characters with placeholders
+    return id
+        .replace(/[/]/g, SANTIIZE_PLACEHOLDERS['/'])
+        .replace(/[:]/g, SANTIIZE_PLACEHOLDERS[':'])
+        .replace(/[.]/g, SANTIIZE_PLACEHOLDERS['.']);
+}
+function unsanitizeFragment(id) {
+    // replaces placeholders with separator characters
+    return id
+        .replace(/&slash;/g, '/')
+        .replace(/:/g, ':')
+        .replace(/˙/g, '.');
+}
+function createOid(collection, documentId, keyPath = [], subId) {
+    let oid = sanitizeFragment(collection) +
+        COLLECTION_SEPARATOR +
+        sanitizeFragment(documentId);
+    if (subId) {
+        const keyPathItems = keyPath.map((k) => typeof k === 'number' ? '#' : sanitizeFragment(k));
+        oid += KEY_PATH_SEPARATOR + keyPathItems.join(KEY_PATH_SEPARATOR);
+        oid += RANDOM_SEPARATOR + subId;
+    }
+    return oid;
+}
+exports.createOid = createOid;
+function createSubOid(root, key, createSubId = createOidSubId) {
+    const { collection, id, keyPath } = decomposeOid(root);
+    return createOid(collection, id, [...keyPath, key], createSubId());
+}
+exports.createSubOid = createSubOid;
+function decomposeOid(oid) {
+    const [core, random] = oid.split(RANDOM_SEPARATOR);
+    const [collection, paths] = core.split('/');
+    const [id, ...keyPath] = paths.split(KEY_PATH_SEPARATOR);
+    return {
+        collection: unsanitizeFragment(collection),
+        id: unsanitizeFragment(id),
+        subId: random,
+        keyPath: keyPath.map(unsanitizeFragment),
+    };
+}
+exports.decomposeOid = decomposeOid;
+function assertAllLevelsHaveOids(obj, root) {
+    (0, utils_js_1.assert)(getOid(obj), `Object ${JSON.stringify(obj)} must have an oid (child of ${JSON.stringify(root)})`);
+    if (Array.isArray(obj)) {
+        for (const item of obj) {
+            assertAllLevelsHaveOids(item, root || obj);
+        }
+    }
+    else if ((0, utils_js_1.isObject)(obj)) {
+        for (const key of Object.keys(obj)) {
+            assertAllLevelsHaveOids(obj[key], root || obj);
+        }
+    }
+}
+exports.assertAllLevelsHaveOids = assertAllLevelsHaveOids;
+function assignOidsToAllSubObjects(obj, createSubId) {
+    const rootOid = getOid(obj);
+    if (Array.isArray(obj)) {
+        let item;
+        for (let i = 0; i < obj.length; i++) {
+            item = obj[i];
+            if ((0, utils_js_1.isObject)(item) && !(0, refs_js_1.isRef)(item)) {
+                ensureOid(item, rootOid, i, createSubId);
+                assignOidsToAllSubObjects(item, createSubId);
+            }
+        }
+    }
+    else if ((0, utils_js_1.isObject)(obj) && !(0, refs_js_1.isRef)(obj)) {
+        for (const key of Object.keys(obj)) {
+            if ((0, utils_js_1.isObject)(obj[key]) && !(0, refs_js_1.isRef)(obj[key])) {
+                ensureOid(obj[key], rootOid, key, createSubId);
+                assignOidsToAllSubObjects(obj[key], createSubId);
+            }
+        }
+    }
+}
+exports.assignOidsToAllSubObjects = assignOidsToAllSubObjects;
+function assignOidProperty(obj, oid) {
+    (0, utils_js_1.assert)((0, utils_js_1.isObject)(obj), `Only objects can be assigned OIDs, received ${JSON.stringify(obj)}`);
+    obj[exports.OID_KEY] = oid;
+    return obj;
+}
+exports.assignOidProperty = assignOidProperty;
+function maybeGetOidProperty(obj) {
+    if (!(0, utils_js_1.isObject)(obj)) {
+        return undefined;
+    }
+    return obj[exports.OID_KEY] || obj[exports.LEGACY_OID_KEY];
+}
+exports.maybeGetOidProperty = maybeGetOidProperty;
+function hasOidProperty(obj) {
+    return !!maybeGetOidProperty(obj);
+}
+function removeOidProperty(obj) {
+    if (!(0, utils_js_1.isObject)(obj)) {
+        return obj;
+    }
+    delete obj[exports.LEGACY_OID_KEY];
+    delete obj[exports.OID_KEY];
+    return obj;
+}
+function transferOidFromSystemToProperty(obj) {
+    const oid = maybeGetOid(obj);
+    if (oid) {
+        assignOidProperty(obj, oid);
+    }
+}
+/**
+ * Assigns a special property to all objects in the given object
+ * which have an OID
+ */
+function assignOidPropertiesToAllSubObjects(obj) {
+    transferOidFromSystemToProperty(obj);
+    if (Array.isArray(obj)) {
+        for (let i = 0; i < obj.length; i++) {
+            assignOidPropertiesToAllSubObjects(obj[i]);
+        }
+    }
+    else if ((0, utils_js_1.isObject)(obj)) {
+        for (const key of Object.keys(obj)) {
+            assignOidPropertiesToAllSubObjects(obj[key]);
+        }
+    }
+}
+exports.assignOidPropertiesToAllSubObjects = assignOidPropertiesToAllSubObjects;
+function copyOidFromPropertyToSystem(obj) {
+    const oid = maybeGetOidProperty(obj);
+    if (oid) {
+        assignOid(obj, oid);
+    }
+}
+/**
+ *
+ * Removes the special property from all objects in the given object
+ * which have an OID, transferring the OID from the property to the OID
+ * system in-memory.
+ */
+function removeOidPropertiesFromAllSubObjects(obj) {
+    copyOidFromPropertyToSystem(obj);
+    removeOidProperty(obj);
+    if (Array.isArray(obj)) {
+        for (let i = 0; i < obj.length; i++) {
+            removeOidPropertiesFromAllSubObjects(obj[i]);
+        }
+    }
+    else if ((0, utils_js_1.isObject)(obj)) {
+        for (const key of Object.keys(obj)) {
+            removeOidPropertiesFromAllSubObjects(obj[key]);
+        }
+    }
+}
+exports.removeOidPropertiesFromAllSubObjects = removeOidPropertiesFromAllSubObjects;
+function removeOidsFromAllSubObjects(obj) {
+    removeOid(obj);
+    if (Array.isArray(obj)) {
+        for (let i = 0; i < obj.length; i++) {
+            removeOidsFromAllSubObjects(obj[i]);
+        }
+    }
+    else if ((0, utils_js_1.isObject)(obj)) {
+        for (const key of Object.keys(obj)) {
+            removeOidsFromAllSubObjects(obj[key]);
+        }
+    }
+}
+exports.removeOidsFromAllSubObjects = removeOidsFromAllSubObjects;
+function createOidSubId() {
+    return (0, uuid_1.v4)().slice(0, 8);
+}
+exports.createOidSubId = createOidSubId;
+function createRef(oid) {
+    return {
+        '@@type': 'ref',
+        id: oid,
+    };
+}
+exports.createRef = createRef;
+function normalize(obj, refs = new Map()) {
+    if (Array.isArray(obj)) {
+        const oid = getOid(obj);
+        const copy = assignOid([], oid);
+        for (let i = 0; i < obj.length; i++) {
+            const value = obj[i];
+            if ((0, utils_js_1.isObject)(value)) {
+                if ((0, operation_js_1.isObjectRef)(value)) {
+                    throw new Error('An attempt was made to normalize an already normalized object! This is an error in verdant itself.');
+                }
+                else if ((0, files_js_1.isFileRef)(value)) {
+                    copy[i] = value;
+                    continue;
+                }
+                else {
+                    const itemOid = getOid(value);
+                    copy[i] = createRef(itemOid);
+                    normalize(value, refs);
+                }
+            }
+            else {
+                copy[i] = value;
+            }
+        }
+        refs.set(oid, copy);
+    }
+    else if ((0, utils_js_1.isObject)(obj) && !(0, refs_js_1.isRef)(obj)) {
+        const oid = getOid(obj);
+        const copy = assignOid({}, oid);
+        for (const key of Object.keys(obj)) {
+            const value = obj[key];
+            if ((0, utils_js_1.isObject)(value)) {
+                if ((0, operation_js_1.isObjectRef)(value)) {
+                    throw new Error('An attempt was made to normalize an already normalized object! This is an error in verdant itself.');
+                }
+                else if ((0, files_js_1.isFileRef)(value)) {
+                    // stop here
+                    copy[key] = value;
+                }
+                else {
+                    const itemOid = getOid(value);
+                    copy[key] = createRef(itemOid);
+                    normalize(value, refs);
+                }
+            }
+            else {
+                copy[key] = value;
+            }
+        }
+        refs.set(oid, copy);
+    }
+    else if ((0, refs_js_1.isRef)(obj)) {
+    }
+    return refs;
+}
+exports.normalize = normalize;
+/**
+ * Only normalizes direct children. The created map
+ * of objects will still have nested objects.
+ */
+function normalizeFirstLevel(obj) {
+    const refs = new Map();
+    const oidKeyPairs = new Map();
+    if (Array.isArray(obj)) {
+        const oid = getOid(obj);
+        const copy = assignOid([], oid);
+        for (let i = 0; i < obj.length; i++) {
+            const value = obj[i];
+            if ((0, utils_js_1.isObject)(value)) {
+                const itemOid = getOid(value);
+                copy[i] = createRef(itemOid);
+                refs.set(itemOid, value);
+                oidKeyPairs.set(itemOid, i);
+            }
+            else {
+                copy[i] = value;
+            }
+        }
+        refs.set(oid, copy);
+    }
+    else if ((0, utils_js_1.isObject)(obj)) {
+        const oid = getOid(obj);
+        const copy = assignOid({}, oid);
+        for (const key of Object.keys(obj)) {
+            const value = obj[key];
+            if ((0, utils_js_1.isObject)(value)) {
+                const itemOid = getOid(value);
+                copy[key] = createRef(itemOid);
+                refs.set(itemOid, value);
+                oidKeyPairs.set(itemOid, key);
+            }
+            else {
+                copy[key] = value;
+            }
+        }
+        refs.set(oid, copy);
+    }
+    return { refs, oidKeyPairs };
+}
+exports.normalizeFirstLevel = normalizeFirstLevel;
+function getOidRoot(oid) {
+    const [collection, idAndPaths] = oid.split(RANDOM_SEPARATOR)[0].split('/');
+    const sepIdx = idAndPaths.indexOf(KEY_PATH_SEPARATOR);
+    const id = sepIdx !== -1 ? idAndPaths.substring(0, sepIdx) : idAndPaths;
+    return `${collection}/${id}`;
+}
+exports.getOidRoot = getOidRoot;
+/**
+ * Returns an inclusive range of OIDs that represent
+ * a root object and all of its sub-objects.
+ */
+function getOidRange(oid) {
+    const root = getOidRoot(oid);
+    return [root, `${root}${RANDOM_SEPARATOR}\uffff`];
+}
+exports.getOidRange = getOidRange;
+function getRoots(oids) {
+    const set = new Set();
+    for (const oid of oids) {
+        set.add(getOidRoot(oid));
+    }
+    return Array.from(set);
+}
+exports.getRoots = getRoots;
+//# sourceMappingURL=oids.js.map

package/dist/cjs/oids.js.map

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

package/dist/cjs/oids.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/oids.test.js

@@ -0,0 +1,282 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const files_js_1 = require("./files.js");
+const oids_js_1 = require("./oids.js");
+(0, vitest_1.describe)('normalizing an object', () => {
+    (0, vitest_1.it)('should return a map of sub-objects with relationships replaced by refs', () => {
+        let i = 0;
+        function createSubId() {
+            return (i++).toString();
+        }
+        const initial = {
+            foo: {
+                bar: 1,
+                baz: [2, 3],
+            },
+            qux: [
+                {
+                    corge: true,
+                },
+                {
+                    grault: {
+                        garply: 4,
+                    },
+                },
+            ],
+        };
+        (0, oids_js_1.assignOid)(initial, 'test/a');
+        (0, oids_js_1.assignOidsToAllSubObjects)(initial, createSubId);
+        const result = (0, oids_js_1.normalize)(initial);
+        (0, vitest_1.expect)(result.get('test/a')).toEqual((0, oids_js_1.assignOid)({
+            foo: {
+                '@@type': 'ref',
+                id: 'test/a.foo:0',
+            },
+            qux: {
+                '@@type': 'ref',
+                id: 'test/a.qux:2',
+            },
+        }, 'test/a'));
+        (0, vitest_1.expect)(result.get('test/a.foo:0')).toEqual((0, oids_js_1.assignOid)({
+            bar: 1,
+            baz: {
+                '@@type': 'ref',
+                id: 'test/a.foo.baz:1',
+            },
+        }, 'test/a.foo:0'));
+        (0, vitest_1.expect)(result.get('test/a.foo.baz:1')).toEqual((0, oids_js_1.assignOid)([2, 3], 'test/a.foo.baz:1'));
+        (0, vitest_1.expect)(result.get('test/a.qux:2')).toEqual((0, oids_js_1.assignOid)([
+            {
+                '@@type': 'ref',
+                id: 'test/a.qux.#:3',
+            },
+            {
+                '@@type': 'ref',
+                id: 'test/a.qux.#:4',
+            },
+        ], 'test/a.qux:2'));
+        (0, vitest_1.expect)(result.get('test/a.qux.#:3')).toEqual((0, oids_js_1.assignOid)({
+            corge: true,
+        }, 'test/a.qux.#:3'));
+        (0, vitest_1.expect)(result.get('test/a.qux.#:4')).toEqual((0, oids_js_1.assignOid)({
+            grault: {
+                '@@type': 'ref',
+                id: 'test/a.qux.#.grault:5',
+            },
+        }, 'test/a.qux.#:4'));
+        (0, vitest_1.expect)(result.get('test/a.qux.#.grault:5')).toEqual((0, oids_js_1.assignOid)({
+            garply: 4,
+        }, 'test/a.qux.#.grault:5'));
+    });
+    (0, vitest_1.it)('should handle file references and not replace them with refs or attempt to normalize them', () => {
+        let i = 0;
+        function createSubId() {
+            return (i++).toString();
+        }
+        const initial = {
+            foo: {
+                bar: 1,
+                file: (0, files_js_1.createFileRef)('abcd123'),
+            },
+            qux: [(0, files_js_1.createFileRef)('efgh456'), (0, files_js_1.createFileRef)('ijkl789')],
+        };
+        (0, oids_js_1.assignOid)(initial, 'test/a');
+        (0, oids_js_1.assignOidsToAllSubObjects)(initial, createSubId);
+        const result = (0, oids_js_1.normalize)(initial);
+        (0, vitest_1.expect)(result.size).toBe(3);
+        (0, vitest_1.expect)(result.get('test/a')).toEqual((0, oids_js_1.assignOid)({
+            foo: {
+                '@@type': 'ref',
+                id: 'test/a.foo:0',
+            },
+            qux: {
+                '@@type': 'ref',
+                id: 'test/a.qux:1',
+            },
+        }, 'test/a'));
+        (0, vitest_1.expect)(result.get('test/a.foo:0')).toEqual((0, oids_js_1.assignOid)({
+            bar: 1,
+            file: {
+                '@@type': 'file',
+                id: 'abcd123',
+            },
+        }, 'test/a.foo:0'));
+        (0, vitest_1.expect)(result.get('test/a.qux:1')).toEqual((0, oids_js_1.assignOid)([
+            {
+                '@@type': 'file',
+                id: 'efgh456',
+            },
+            {
+                '@@type': 'file',
+                id: 'ijkl789',
+            },
+        ], 'test/a.qux:2'));
+    });
+});
+(0, vitest_1.describe)('normalizing the first level of an object', () => {
+    (0, vitest_1.it)('collects all top-level sub-objects', () => {
+        let i = 0;
+        function createSubId() {
+            return (i++).toString();
+        }
+        const initial = {
+            foo: {
+                bar: 1,
+                baz: [2, 3],
+            },
+            qux: [
+                {
+                    corge: true,
+                },
+                {
+                    grault: {
+                        garply: 4,
+                    },
+                },
+            ],
+        };
+        (0, oids_js_1.assignOid)(initial, 'test/a');
+        (0, oids_js_1.assignOidsToAllSubObjects)(initial, createSubId);
+        const { refs: result } = (0, oids_js_1.normalizeFirstLevel)(initial);
+        (0, vitest_1.expect)(result.get('test/a')).toMatchInlineSnapshot(`
+			{
+			  "foo": {
+			    "@@type": "ref",
+			    "id": "test/a.foo:0",
+			  },
+			  "qux": {
+			    "@@type": "ref",
+			    "id": "test/a.qux:2",
+			  },
+			}
+		`);
+        (0, vitest_1.expect)(result.get('test/a:0')).toMatchInlineSnapshot('undefined');
+        (0, vitest_1.expect)(result.get('test/a:1')).toBeUndefined();
+        (0, vitest_1.expect)(result.get('test/a:2')).toMatchInlineSnapshot('undefined');
+        (0, vitest_1.expect)(result.get('test/a:3')).toBeUndefined();
+        (0, vitest_1.expect)(result.get('test/a:4')).toBeUndefined();
+        (0, vitest_1.expect)(result.get('test/a:5')).toBeUndefined();
+    });
+});
+(0, vitest_1.describe)('computing a range of oids for a whole object set', () => {
+    function isWithin(oid, start, end) {
+        return oid >= start && oid <= end;
+    }
+    (0, vitest_1.it)('should include the root object and any possible sub object oid', () => {
+        const [start, end] = (0, oids_js_1.getOidRange)('test/a');
+        (0, vitest_1.expect)(start).toEqual('test/a');
+        (0, vitest_1.expect)(end).toEqual('test/a:\uffff');
+        (0, vitest_1.expect)(start < end).toBe(true);
+        (0, vitest_1.expect)(isWithin('test/a', start, end)).toBe(true);
+        (0, vitest_1.expect)(isWithin('test/a:0', start, end)).toBe(true);
+        (0, vitest_1.expect)(isWithin('test/a:1', start, end)).toBe(true);
+        (0, vitest_1.expect)(isWithin('test/a:zzzzzzzzzzzzzzzzzzzzzzz', start, end)).toBe(true);
+        (0, vitest_1.expect)(isWithin('test/a:\uffff', start, end)).toBe(true);
+        (0, vitest_1.expect)(isWithin('test1/a', start, end)).toBe(false);
+        (0, vitest_1.expect)(isWithin('test/b', start, end)).toBe(false);
+        (0, vitest_1.expect)(isWithin('test/ ', start, end)).toBe(false);
+    });
+});
+(0, vitest_1.describe)('assigning OIDs as properties', () => {
+    (0, vitest_1.it)('should assign to all sub-objects', () => {
+        let i = 0;
+        function createSubId() {
+            return (i++).toString();
+        }
+        const initial = {
+            foo: {
+                bar: 1,
+                baz: [2, 3],
+            },
+            qux: [
+                {
+                    corge: true,
+                },
+                {
+                    grault: {
+                        garply: 4,
+                    },
+                },
+            ],
+        };
+        (0, oids_js_1.assignOid)(initial, 'test/a');
+        (0, oids_js_1.assignOidsToAllSubObjects)(initial, createSubId);
+        (0, oids_js_1.assignOidPropertiesToAllSubObjects)(initial);
+        (0, vitest_1.expect)(initial).toMatchInlineSnapshot(`
+			{
+			  "@@id": "test/a",
+			  "foo": {
+			    "@@id": "test/a.foo:0",
+			    "bar": 1,
+			    "baz": [
+			      2,
+			      3,
+			    ],
+			  },
+			  "qux": [
+			    {
+			      "@@id": "test/a.qux.#:3",
+			      "corge": true,
+			    },
+			    {
+			      "@@id": "test/a.qux.#:4",
+			      "grault": {
+			        "@@id": "test/a.qux.#.grault:5",
+			        "garply": 4,
+			      },
+			    },
+			  ],
+			}
+		`);
+        // extra check needed for array since it doesn't serialize in the snapshot
+        (0, vitest_1.expect)((0, oids_js_1.maybeGetOidProperty)(initial.qux)).toBe('test/a.qux:2');
+    });
+    (0, vitest_1.it)('should transfer assigned OID properties to the memory system', () => {
+        const initial = (0, oids_js_1.assignOidProperty)({
+            foo: (0, oids_js_1.assignOidProperty)({
+                bar: 1,
+            }, 'test/a.foo:1'),
+            qux: (0, oids_js_1.assignOidProperty)([
+                (0, oids_js_1.assignOidProperty)({
+                    corge: true,
+                }, 'test/a.qux.#:2'),
+                (0, oids_js_1.assignOidProperty)({
+                    grault: (0, oids_js_1.assignOidProperty)({
+                        garply: 4,
+                    }, 'test/a.qux.#.grault:3'),
+                }, 'test/a.qux.#:4'),
+            ], 'test/a.qux:2'),
+        }, 'test/a');
+        (0, oids_js_1.removeOidPropertiesFromAllSubObjects)(initial);
+        (0, vitest_1.expect)((0, oids_js_1.getOid)(initial)).toEqual('test/a');
+        (0, vitest_1.expect)((0, oids_js_1.getOid)(initial.foo)).toEqual('test/a.foo:1');
+        (0, vitest_1.expect)((0, oids_js_1.getOid)(initial.qux)).toEqual('test/a.qux:2');
+        (0, vitest_1.expect)((0, oids_js_1.getOid)(initial.qux[0])).toEqual('test/a.qux.#:2');
+        (0, vitest_1.expect)((0, oids_js_1.getOid)(initial.qux[1])).toEqual('test/a.qux.#:4');
+        (0, vitest_1.expect)((0, oids_js_1.getOid)(initial.qux[1].grault)).toEqual('test/a.qux.#.grault:3');
+    });
+});
+(0, vitest_1.it)('should handle special characters in document id or collection', () => {
+    (0, vitest_1.expect)((0, oids_js_1.decomposeOid)((0, oids_js_1.createOid)('test.teesssst/asdf::', 'foo/bar (.) : huh:', ['baz?.quoo:/', 'qux'], 'corge'))).toEqual({
+        collection: 'test.teesssst/asdf::',
+        id: 'foo/bar (.) : huh:',
+        keyPath: ['baz?.quoo:/', 'qux'],
+        subId: 'corge',
+    });
+});
+(0, vitest_1.describe)('assigning OIDs to sub-objects', () => {
+    (0, vitest_1.it)('should not assign oids to refs', () => {
+        const obj = {
+            foo: {
+                file: (0, files_js_1.createFileRef)('1a'),
+            },
+            bar: [(0, files_js_1.createFileRef)('2a')],
+        };
+        (0, oids_js_1.assignOid)(obj, 'test/a');
+        (0, oids_js_1.assignOidsToAllSubObjects)(obj);
+        (0, vitest_1.expect)((0, oids_js_1.hasOid)(obj.foo.file)).toBe(false);
+        (0, vitest_1.expect)((0, oids_js_1.hasOid)(obj.bar[0])).toBe(false);
+    });
+});
+//# sourceMappingURL=oids.test.js.map