@rljson/rljson 0.0.66 → 0.0.68

package/dist/example/bakery-example.d.ts

@@ -4,7 +4,7 @@ import { CakesTable } from '../content/cake.ts';
 import { ComponentsTable } from '../content/components.ts';
 import { LayersTable } from '../content/layer.ts';
 import { SliceIdsTable } from '../content/slice-ids.ts';
-import { History } from '../history/history.ts';
+import { InsertHistory } from '../insertHistory/insertHistory.ts';
 import { Rljson } from '../rljson.ts';
 import { Ref } from '../typedefs.ts';
 export interface Ingredient extends Json {
@@ -32,6 +32,6 @@ export interface Bakery extends Rljson {
     recipeIngredients: ComponentsTable<RecipIngredient>;
     ingredients: ComponentsTable<Ingredient>;
     nutritionalValues: ComponentsTable<NutritionalValues>;
-    ingredientsHistory: History<'Ingredients'>;
+    ingredientsInsertHistory: InsertHistory<'Ingredients'>;
 }
 export declare const bakeryExample: () => Bakery;

package/dist/index.d.ts

@@ -7,9 +7,9 @@ export * from './content/slice-ids.ts';
 export * from './content/table-cfg.ts';
 export * from './example.ts';
 export * from './example/bakery-example.ts';
-export * from './history/history.ts';
 export * from './insert/insert-validator.ts';
 export * from './insert/insert.ts';
+export * from './insertHistory/insertHistory.ts';
 export * from './rljson.ts';
 export * from './route/route.ts';
 export * from './tools/remove-duplicates.ts';

package/dist/insertHistory/insertHistory.d.ts

@@ -0,0 +1,24 @@
+import { TableCfg } from '../content/table-cfg.ts';
+import { RljsonTable } from '../rljson.ts';
+import { RouteRef } from '../route/route.ts';
+import { Ref } from '../typedefs.ts';
+export type InsertHistoryTimeId = string;
+export type InsertHistoryRow<Str extends string> = {
+    [key in Str as `${Uncapitalize<string & key>}Ref`]: string;
+} & {
+    timeId: InsertHistoryTimeId;
+    route: RouteRef;
+    origin?: Ref;
+    previous?: InsertHistoryTimeId[];
+};
+export type InsertHistory<Str extends string> = RljsonTable<InsertHistoryRow<Str>, 'insertHistory'>;
+/**
+ * Creates a TableCfg for a InsertHistory table for the given table configuration
+ * @param tableCfg - The table configuration to create the InsertHistory table for
+ * @returns The TableCfg for the InsertHistory table
+ */
+export declare const createInsertHistoryTableCfg: (tableCfg: TableCfg) => TableCfg;
+/**
+ * Provides an example insertHistory table for test purposes
+ */
+export declare const exampleInsertHistoryTable: () => InsertHistory<any>;

package/dist/rljson.d.ts

@@ -6,14 +6,14 @@ import { LayersTable } from './content/layer.ts';
 import { RevisionsTable } from './content/revision.ts';
 import { SliceIdsTable } from './content/slice-ids.ts';
 import { TableCfgRef, TablesCfgTable } from './content/table-cfg.ts';
-import { History } from './history/history.ts';
+import { InsertHistory } from './insertHistory/insertHistory.ts';
 import { ContentType, Ref, TableKey } from './typedefs.ts';
 export declare const reservedFieldNames: string[];
 export declare const reservedTableKeys: string[];
 /**
  * One of the supported Rljson table types
  */
-export type TableType = BuffetsTable | ComponentsTable<any> | LayersTable | SliceIdsTable | CakesTable | RevisionsTable | TablesCfgTable | History<any>;
+export type TableType = BuffetsTable | ComponentsTable<any> | LayersTable | SliceIdsTable | CakesTable | RevisionsTable | TablesCfgTable | InsertHistory<any>;
 /** The rljson data format */
 export interface Rljson extends Json {
     [tableId: TableKey]: TableType;

package/dist/rljson.js

@@ -1,11 +1,11 @@
 import { hip, hsh } from "@rljson/hash";
 import { exampleJsonObject, jsonValueTypes, jsonValueMatchesType, jsonValueType } from "@rljson/json";
 import { nanoid } from "nanoid";
-// @license
 class Route {
   constructor(_segments) {
     this._segments = _segments;
   }
+  _propertyKey;
   // .............................................................................
   /**
    * Creates a Route from a flat string representation.
@@ -17,7 +17,7 @@ class Route {
     const segments = [];
     for (const segmentFlat of segmentsFlat) {
       const [tableKey, refFlat] = segmentFlat.split("@");
-      const ref = !!refFlat ? refFlat.split(":").length == 2 ? { [tableKey + "HistoryRef"]: refFlat } : { [tableKey + "Ref"]: refFlat } : {};
+      const ref = !!refFlat ? refFlat.split(":").length == 2 ? { [tableKey + "InsertHistoryRef"]: refFlat } : { [tableKey + "Ref"]: refFlat } : {};
       const segment = {
         tableKey,
         ...ref
@@ -59,6 +59,78 @@ class Route {
     }
   }
   // .............................................................................
+  /**
+   * Returns a new Route that is one level higher than the current route.
+   * If steps is provided, it returns a new Route that is 'steps' levels higher.
+   * @param steps - The number of levels to go higher (optional)
+   * @returns A new Route that is one level higher or 'steps' levels higher
+   */
+  upper(steps) {
+    if (steps === void 0) {
+      return new Route(this._segments.slice(0, -1));
+    } else {
+      if (steps < 1) {
+        throw new Error("Steps must be greater than 0");
+      }
+      if (steps >= this._segments.length) {
+        throw new Error("Cannot go upper than the top level");
+      }
+      return new Route(this._segments.slice(0, -steps));
+    }
+  }
+  // .............................................................................
+  /**
+   * Returns a new Route with the property key set to the last segment's table key.
+   * If the property key is already set, it returns the current route.
+   * @returns A new Route with the property key set
+   */
+  toRouteWithProperty() {
+    if (this.hasPropertyKey) return this;
+    const route = this.upper();
+    route.propertyKey = this.segment().tableKey;
+    return route;
+  }
+  // .............................................................................
+  /**
+   * Returns a new Route without the property key.
+   * If the property key is not set, it returns the current route.
+   * @returns A new Route without the property key
+   */
+  toRouteWithoutProperty() {
+    if (!this.hasPropertyKey) return this;
+    const route = new Route(this._segments);
+    route.propertyKey = void 0;
+    return route;
+  }
+  // .............................................................................
+  /**
+   * Checks if the current route includes another route.
+   * A route includes another route if all segments of the other route
+   * are present in the current route in the same order.
+   * @param other - The other route to check
+   * @returns True if the current route includes the other route, false otherwise
+   */
+  includes(other) {
+    if (other._segments.length < this._segments.length) {
+      return false;
+    }
+    for (let i = 0; i < this._segments.length; i++) {
+      const thisSegment = this._segments[i];
+      const otherSegment = other._segments[i];
+      if (thisSegment.tableKey !== otherSegment.tableKey) {
+        return false;
+      }
+      if (Route.segmentHasRef(thisSegment) && Route.segmentHasRef(otherSegment)) {
+        const thisRef = Route.segmentRef(thisSegment);
+        const otherRef = Route.segmentRef(otherSegment);
+        if (thisRef !== otherRef) {
+          return false;
+        }
+      }
+    }
+    return true;
+  }
+  // .............................................................................
   /**
    * Checks if the current route is the root route.
    * @returns True if the current route is the root route, false otherwise
@@ -72,6 +144,18 @@ class Route {
    * @returns The flat string representation of the route (e.g. "/a/b/c")
    */
   get flat() {
+    let flat = this.flatWithoutPropertyKey;
+    if (this.hasPropertyKey) {
+      flat += `/${this.propertyKey}`;
+    }
+    return flat;
+  }
+  // .............................................................................
+  /**
+   * Returns the flat string representation of the route without the property key.
+   * @returns The flat string representation of the route without the property key
+   */
+  get flatWithoutPropertyKey() {
     let flat = "";
     for (const segment of this._segments) {
       const tableKey = segment.tableKey;
@@ -81,6 +165,22 @@ class Route {
     return flat;
   }
   // .............................................................................
+  /**
+   * Returns the flat string representation of the route without any references.
+   * @returns The flat string representation of the route without any references
+   */
+  get flatWithoutRefs() {
+    let flat = "";
+    for (const segment of this._segments) {
+      const tableKey = segment.tableKey;
+      flat += `/${tableKey}`;
+    }
+    if (this.hasPropertyKey) {
+      flat += `/${this.propertyKey}`;
+    }
+    return flat;
+  }
+  // .............................................................................
   /**
    * Returns the segments of the route as an array of strings.
    * @returns The segments of the route as an array of strings
@@ -121,6 +221,57 @@ class Route {
     return this._segments.length > 0 && this._segments.every((s) => s.tableKey.length > 0);
   }
   // .............................................................................
+  /**
+   * Checks if the route has a property key.
+   * @returns True if the route has a property key, false otherwise
+   */
+  get hasPropertyKey() {
+    return this._propertyKey !== void 0;
+  }
+  // .............................................................................
+  /**
+   * Returns the property key of the route if it exists.
+   * @returns The property key of the route or undefined if it doesn't exist
+   */
+  get propertyKey() {
+    return this._propertyKey;
+  }
+  // .............................................................................
+  /**
+   * Sets the property key of the route.
+   * @param key - The property key to set
+   */
+  set propertyKey(key) {
+    this._propertyKey = key;
+  }
+  // .............................................................................
+  /**
+   * Checks if two routes are equal.
+   * @param other - The other route to compare with
+   * @returns True if the routes are equal, false otherwise
+   */
+  equals(other) {
+    return this.flat === other.flat;
+  }
+  // .............................................................................
+  /**
+   * Checks if two routes are equal without considering the property key.
+   * @param other - The other route to compare with
+   * @returns True if the routes are equal without considering the property key, false otherwise
+   */
+  equalsWithoutPropertyKey(other) {
+    return this.flatWithoutPropertyKey === other.flatWithoutPropertyKey;
+  }
+  // .............................................................................
+  /**
+   * Checks if two routes are equal without considering the references.
+   * @param other - The other route to compare with
+   * @returns True if the routes are equal without considering the references, false otherwise
+   */
+  equalsWithoutRefs(other) {
+    return this.flatWithoutRefs === other.flatWithoutRefs;
+  }
+  // .............................................................................
   /**
    * Returns the reference of a segment if it exists.
    * @param segment - The segment to get the reference from
@@ -131,7 +282,6 @@ class Route {
       const refKey = Object.keys(segment).find(
         (k) => k.endsWith("Ref") && k !== "tableKey"
       );
-      /* v8 ignore next -- @preserve */
       if (refKey) {
         return segment[refKey];
       }
@@ -140,7 +290,7 @@ class Route {
   }
   // .............................................................................
   /**
-   * Checks if a segment has any reference (either default or history).
+   * Checks if a segment has any reference (either default or insertHistory).
    * @param segment - The segment to check
    * @returns True if the segment has any reference, false otherwise
    */
@@ -149,24 +299,23 @@ class Route {
   }
   // .............................................................................
   /**
-   * Checks if a segment has a default reference (i.e. not a history reference).
+   * Checks if a segment has a default reference (i.e. not a insertHistory reference).
    * @param segment - The segment to check
    * @returns True if the segment has a default reference, false otherwise
    */
   static segmentHasDefaultRef(segment) {
-    return this.segmentHasRef(segment) && !this.segmentHasHistoryRef(segment);
+    return this.segmentHasRef(segment) && !this.segmentHasInsertHistoryRef(segment);
   }
   // .............................................................................
   /**
-   * Checks if a segment has a history reference (i.e. an HistoryRef).
+   * Checks if a segment has a insertHistory reference (i.e. an InsertHistoryRef).
    * @param segment - The segment to check
-   * @returns True if the segment has a history reference, false otherwise
+   * @returns True if the segment has a insertHistory reference, false otherwise
    */
-  static segmentHasHistoryRef(segment) {
-    return this.segmentHasRef(segment) && Object.keys(segment).some((k) => k.endsWith("HistoryRef"));
+  static segmentHasInsertHistoryRef(segment) {
+    return this.segmentHasRef(segment) && Object.keys(segment).some((k) => k.endsWith("InsertHistoryRef"));
   }
 }
-// @license
 const bakeryExample = () => {
   const nutritionalValues = hip({
     _type: "components",
@@ -294,8 +443,8 @@ const bakeryExample = () => {
       }
     ]
   });
-  const ingredientsHistory = hip({
-    _type: "history",
+  const ingredientsInsertHistory = hip({
+    _type: "insertHistory",
     _data: [
       {
         timeId: "de72:1759123957292",
@@ -324,13 +473,11 @@ const bakeryExample = () => {
     recipeIngredients,
     ingredients,
     nutritionalValues,
-    ingredientsHistory
+    ingredientsInsertHistory
   };
   return result;
 };
-// @license
 const exampleBuffetsTable = () => bakeryExample().buffets;
-// @license
 const createCakeTableCfg = (cakeKey) => ({
   key: cakeKey,
   type: "cakes",
@@ -356,9 +503,7 @@ const createCakeTableCfg = (cakeKey) => ({
   isShared: true
 });
 const exampleCakesTable = () => bakeryExample().cakes;
-// @license
 const exampleComponentsTable = () => bakeryExample().nutritionalValues;
-// @license
 const createLayerTableCfg = (layerKey) => ({
   key: layerKey,
   type: "layers",
@@ -391,7 +536,6 @@ const createLayerTableCfg = (layerKey) => ({
   isShared: true
 });
 const exampleLayersTable = () => bakeryExample().recipeLayers;
-// @license
 const exampleRevision = () => ({
   table: "nutritionalValues",
   id: "flour",
@@ -399,9 +543,7 @@ const exampleRevision = () => ({
   successor: "IqeoWJjZQNlr-NVk2QT15B",
   timestamp: 1743558427
 });
-// @license
 const exampleSliceIdsTable = () => bakeryExample().slices;
-// @license
 class Example {
   static ok = {
     bakery: () => bakeryExample(),
@@ -1188,7 +1330,6 @@ class Example {
     }
   };
 }
-// @license
 const throwOnInvalidTableCfg = (tableCfg) => {
   if (tableCfg.columns.length < 2) {
     throw new Error(
@@ -1295,46 +1436,7 @@ const exampleTableCfg = (tableCfg = void 0) => {
     isShared: false
   };
 };
-// @license
-const createHistoryTableCfg = (tableCfg) => ({
-  key: `${tableCfg.key}History`,
-  type: "history",
-  columns: [
-    { key: "_hash", type: "string", titleLong: "Hash", titleShort: "Hash" },
-    {
-      key: "timeId",
-      type: "string",
-      titleLong: "Time ID",
-      titleShort: "Time ID"
-    },
-    {
-      key: `${tableCfg.key}Ref`,
-      type: "string",
-      titleLong: "Reference",
-      titleShort: "Ref"
-    },
-    { key: "route", type: "string", titleLong: "Route", titleShort: "Route" },
-    {
-      key: "origin",
-      type: "string",
-      titleLong: "Origin",
-      titleShort: "Origin"
-    },
-    {
-      key: "previous",
-      type: "jsonArray",
-      titleLong: "Previous",
-      titleShort: "Previous"
-    }
-  ],
-  isHead: false,
-  isRoot: false,
-  isShared: false
-});
-const exampleHistoryTable = () => bakeryExample().ingredientsHistory;
-// @license
 const objectDepth = (o) => Object(o) === o ? 1 + Math.max(-1, ...Object.values(o).map(objectDepth)) : 0;
-// @license
 class InsertValidator {
   constructor(_insert) {
     this._insert = _insert;
@@ -1388,9 +1490,9 @@ class InsertValidator {
     if (route.isValid) {
       const routeDepth = route.segments.length;
       const valueDepth = objectDepth(this._insert.value);
-      if (routeDepth !== valueDepth) {
+      if (routeDepth > valueDepth) {
         this.errors.dataRouteMismatch = {
-          error: "Insert route depth does not match value depth. Route depth must match the depth of the value object.",
+          error: "Insert route depth does not match value depth. Route depth must be lower than the depth of the value object.",
           route: this._insert.route,
           routeDepth,
           valueDepth
@@ -1440,13 +1542,47 @@ class InsertValidator {
 const validateInsert = (insert) => {
   return InsertValidator.create(insert).validate();
 };
-// @license
 const exampleInsert = () => ({
   route: "a/b/c",
   command: "add",
   value: { x: { y: { z: true } } }
 });
-// @license
+const createInsertHistoryTableCfg = (tableCfg) => ({
+  key: `${tableCfg.key}InsertHistory`,
+  type: "insertHistory",
+  columns: [
+    { key: "_hash", type: "string", titleLong: "Hash", titleShort: "Hash" },
+    {
+      key: "timeId",
+      type: "string",
+      titleLong: "Time ID",
+      titleShort: "Time ID"
+    },
+    {
+      key: `${tableCfg.key}Ref`,
+      type: "string",
+      titleLong: "Reference",
+      titleShort: "Ref"
+    },
+    { key: "route", type: "string", titleLong: "Route", titleShort: "Route" },
+    {
+      key: "origin",
+      type: "string",
+      titleLong: "Origin",
+      titleShort: "Origin"
+    },
+    {
+      key: "previous",
+      type: "jsonArray",
+      titleLong: "Previous",
+      titleShort: "Previous"
+    }
+  ],
+  isHead: false,
+  isRoot: false,
+  isShared: false
+});
+const exampleInsertHistoryTable = () => bakeryExample().ingredientsInsertHistory;
 const reservedFieldNames = ["_data"];
 const reservedTableKeys = [
   "_hash",
@@ -1486,7 +1622,6 @@ const iterateTables = async (rljson, callback) => {
     throw errors;
   }
 };
-// @license
 const removeDuplicates = (rljson) => {
   const result = {};
   for (const key in rljson) {
@@ -1500,17 +1635,25 @@ const removeDuplicates = (rljson) => {
   }
   return hip(result, { throwOnWrongHashes: false, updateExistingHashes: true });
 };
-// @license
 const timeId = () => {
-  return nanoid(4) + ":" + Date.now();
+  return Date.now() + ":" + nanoid(4);
 };
 const isTimeId = (id) => {
   const parts = id.split(":");
   if (parts.length !== 2) return false;
-  if (isNaN(Number(parts[1]))) return false;
-  return parts[0].length === 4;
+  if (isNaN(Number(parts[0]))) return false;
+  return parts[1].length === 4;
+};
+const getTimeIdTimestamp = (id) => {
+  if (!isTimeId(id)) return null;
+  const parts = id.split(":");
+  return Number(parts[0]);
+};
+const getTimeIdUniquePart = (id) => {
+  if (!isTimeId(id)) return null;
+  const parts = id.split(":");
+  return parts[1];
 };
-// @license
 const contentTypes = [
   "buffets",
   "cakes",
@@ -1519,7 +1662,7 @@ const contentTypes = [
   "components",
   "revisions",
   "tableCfgs",
-  "history"
+  "insertHistory"
 ];
 const exampleTypedefs = () => {
   return {
@@ -1529,7 +1672,6 @@ const exampleTypedefs = () => {
     contentType: "layers"
   };
 };
-// @license
 const rljsonIndexed = (rljson) => {
   const result = {};
   for (const key in rljson) {
@@ -1552,7 +1694,6 @@ const rljsonIndexed = (rljson) => {
   }
   return result;
 };
-// @license
 class BaseValidator {
   name = "base";
   async validate(rljson) {
@@ -1968,7 +2109,6 @@ class _BaseValidator {
       const tableCfgRef = table._tableCfg;
       if (!tableCfgRef) return;
       const tableCfg = this.rljsonIndexed.tableCfgs._data[tableCfgRef];
-      /* v8 ignore next -- @preserve */
       if (!tableCfg) return;
       const tableRows = table._data;
       for (const row of tableRows) {
@@ -1977,7 +2117,6 @@ class _BaseValidator {
           const columnCfg = tableCfg.columns.find(
             (col) => col.key === columnKey
           );
-          /* v8 ignore next -- @preserve */
           if (columnCfg === void 0) continue;
           if (columnCfg.ref && columnCfg.ref.tableKey) {
             const targetTableKey = columnCfg.ref.tableKey;
@@ -2331,7 +2470,6 @@ class _BaseValidator {
   }
 }
 const isValidFieldName = (fieldName) => BaseValidator.isValidFieldName(fieldName);
-// @license
 class Validate {
   addValidator(validator) {
     this._validators.push(validator);
@@ -2376,13 +2514,13 @@ export {
   bakeryExample,
   contentTypes,
   createCakeTableCfg,
-  createHistoryTableCfg,
+  createInsertHistoryTableCfg,
   createLayerTableCfg,
   exampleBuffetsTable,
   exampleCakesTable,
   exampleComponentsTable,
-  exampleHistoryTable,
   exampleInsert,
+  exampleInsertHistoryTable,
   exampleLayersTable,
   exampleRevision,
   exampleRljson,
@@ -2390,6 +2528,8 @@ export {
   exampleTableCfg,
   exampleTableCfgTable,
   exampleTypedefs,
+  getTimeIdTimestamp,
+  getTimeIdUniquePart,
   isTimeId,
   isValidFieldName,
   iterateTables,

package/dist/route/route.d.ts

@@ -11,6 +11,7 @@ export type RouteSegmentFlat<N extends string> = `${N}` | `${N}@${string}` | `${
  */
 export declare class Route {
     private readonly _segments;
+    private _propertyKey?;
     constructor(_segments: RouteSegment<any>[]);
     /**
      * Creates a Route from a flat string representation.
@@ -31,6 +32,33 @@ export declare class Route {
      * @returns A new Route that is one level deeper or 'steps' levels deeper
      */
     deeper(steps?: number): Route;
+    /**
+     * Returns a new Route that is one level higher than the current route.
+     * If steps is provided, it returns a new Route that is 'steps' levels higher.
+     * @param steps - The number of levels to go higher (optional)
+     * @returns A new Route that is one level higher or 'steps' levels higher
+     */
+    upper(steps?: number): Route;
+    /**
+     * Returns a new Route with the property key set to the last segment's table key.
+     * If the property key is already set, it returns the current route.
+     * @returns A new Route with the property key set
+     */
+    toRouteWithProperty(): Route;
+    /**
+     * Returns a new Route without the property key.
+     * If the property key is not set, it returns the current route.
+     * @returns A new Route without the property key
+     */
+    toRouteWithoutProperty(): Route;
+    /**
+     * Checks if the current route includes another route.
+     * A route includes another route if all segments of the other route
+     * are present in the current route in the same order.
+     * @param other - The other route to check
+     * @returns True if the current route includes the other route, false otherwise
+     */
+    includes(other: Route): boolean;
     /**
      * Checks if the current route is the root route.
      * @returns True if the current route is the root route, false otherwise
@@ -41,6 +69,16 @@ export declare class Route {
      * @returns The flat string representation of the route (e.g. "/a/b/c")
      */
     get flat(): string;
+    /**
+     * Returns the flat string representation of the route without the property key.
+     * @returns The flat string representation of the route without the property key
+     */
+    get flatWithoutPropertyKey(): string;
+    /**
+     * Returns the flat string representation of the route without any references.
+     * @returns The flat string representation of the route without any references
+     */
+    get flatWithoutRefs(): string;
     /**
      * Returns the segments of the route as an array of strings.
      * @returns The segments of the route as an array of strings
@@ -66,6 +104,39 @@ export declare class Route {
      * @returns True if the route is valid, false otherwise
      */
     get isValid(): boolean;
+    /**
+     * Checks if the route has a property key.
+     * @returns True if the route has a property key, false otherwise
+     */
+    get hasPropertyKey(): boolean;
+    /**
+     * Returns the property key of the route if it exists.
+     * @returns The property key of the route or undefined if it doesn't exist
+     */
+    get propertyKey(): string | undefined;
+    /**
+     * Sets the property key of the route.
+     * @param key - The property key to set
+     */
+    set propertyKey(key: string | undefined);
+    /**
+     * Checks if two routes are equal.
+     * @param other - The other route to compare with
+     * @returns True if the routes are equal, false otherwise
+     */
+    equals(other: Route): boolean;
+    /**
+     * Checks if two routes are equal without considering the property key.
+     * @param other - The other route to compare with
+     * @returns True if the routes are equal without considering the property key, false otherwise
+     */
+    equalsWithoutPropertyKey(other: Route): boolean;
+    /**
+     * Checks if two routes are equal without considering the references.
+     * @param other - The other route to compare with
+     * @returns True if the routes are equal without considering the references, false otherwise
+     */
+    equalsWithoutRefs(other: Route): boolean;
     /**
      * Returns the reference of a segment if it exists.
      * @param segment - The segment to get the reference from
@@ -73,21 +144,21 @@ export declare class Route {
      */
     static segmentRef(segment: RouteSegment<any>): string | undefined;
     /**
-     * Checks if a segment has any reference (either default or history).
+     * Checks if a segment has any reference (either default or insertHistory).
      * @param segment - The segment to check
      * @returns True if the segment has any reference, false otherwise
      */
     static segmentHasRef(segment: RouteSegment<any>): boolean;
     /**
-     * Checks if a segment has a default reference (i.e. not a history reference).
+     * Checks if a segment has a default reference (i.e. not a insertHistory reference).
      * @param segment - The segment to check
      * @returns True if the segment has a default reference, false otherwise
      */
     static segmentHasDefaultRef(segment: RouteSegment<any>): boolean;
     /**
-     * Checks if a segment has a history reference (i.e. an HistoryRef).
+     * Checks if a segment has a insertHistory reference (i.e. an InsertHistoryRef).
      * @param segment - The segment to check
-     * @returns True if the segment has a history reference, false otherwise
+     * @returns True if the segment has a insertHistory reference, false otherwise
      */
-    static segmentHasHistoryRef(segment: RouteSegment<any>): boolean;
+    static segmentHasInsertHistoryRef(segment: RouteSegment<any>): boolean;
 }

package/dist/tools/time-id.d.ts

@@ -15,3 +15,15 @@ export declare const timeId: () => string;
  * @returns True if the id is a valid TimeId, false otherwise
  */
 export declare const isTimeId: (id: string) => boolean;
+/**
+ * Extracts the timestamp from a TimeId.
+ * @param id - The TimeId string
+ * @returns The timestamp in milliseconds since epoch, or null if the id is not a valid TimeId
+ */
+export declare const getTimeIdTimestamp: (id: string) => number | null;
+/**
+ * Extracts the unique part from a TimeId.
+ * @param id - The TimeId string
+ * @returns The unique identifier part, or null if the id is not a valid TimeId
+ */
+export declare const getTimeIdUniquePart: (id: string) => string | null;

package/dist/typedefs.d.ts

@@ -26,7 +26,7 @@ export type ColumnKey = JsonKey;
  * - `ids` Tables containing slice ids
  * - `components` Tables containing slice components
  */
-export declare const contentTypes: readonly ["buffets", "cakes", "layers", "sliceIds", "components", "revisions", "tableCfgs", "history"];
+export declare const contentTypes: readonly ["buffets", "cakes", "layers", "sliceIds", "components", "revisions", "tableCfgs", "insertHistory"];
 export type ContentType = (typeof contentTypes)[number];
 /**
  * An example object using the typedefs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rljson/rljson",
-  "version": "0.0.66",
+  "version": "0.0.68",
   "description": "The RLJSON data format specification",
   "homepage": "https://github.com/rljson/rljson",
   "bugs": "https://github.com/rljson/rljson/issues",
@@ -20,29 +20,29 @@
   ],
   "type": "module",
   "devDependencies": {
-    "@types/node": "^24.9.1",
-    "@typescript-eslint/eslint-plugin": "^8.46.2",
-    "@typescript-eslint/parser": "^8.46.2",
-    "@vitest/coverage-v8": "^4.0.1",
+    "@types/node": "^24.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.46.3",
+    "@typescript-eslint/parser": "^8.46.3",
+    "@vitest/coverage-v8": "^4.0.7",
     "cross-env": "^10.1.0",
-    "eslint": "^9.38.0",
-    "eslint-plugin-jsdoc": "^61.1.5",
+    "eslint": "^9.39.1",
+    "eslint-plugin-jsdoc": "^61.1.12",
     "eslint-plugin-tsdoc": "^0.4.0",
-    "globals": "^16.4.0",
+    "globals": "^16.5.0",
     "jsdoc": "^4.0.5",
     "read-pkg": "^9.0.1",
     "typescript": "~5.9.3",
-    "typescript-eslint": "^8.46.2",
-    "vite": "^7.1.12",
-    "vite-node": "^3.2.4",
+    "typescript-eslint": "^8.46.3",
+    "vite": "^7.2.1",
+    "vite-node": "^5.0.0",
     "vite-plugin-dts": "^4.5.4",
     "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^4.0.1",
+    "vitest": "^4.0.7",
     "vitest-dom": "^0.1.1"
   },
   "dependencies": {
     "@rljson/hash": "^0.0.17",
-    "@rljson/json": "^0.0.22",
+    "@rljson/json": "^0.0.23",
     "nanoid": "^5.1.6"
   },
   "scripts": {

package/dist/history/history.d.ts

@@ -1,24 +0,0 @@
-import { TableCfg } from '../content/table-cfg.ts';
-import { RljsonTable } from '../rljson.ts';
-import { RouteRef } from '../route/route.ts';
-import { Ref } from '../typedefs.ts';
-export type HistoryTimeId = string;
-export type HistoryRow<Str extends string> = {
-    [key in Str as `${Uncapitalize<string & key>}Ref`]: string;
-} & {
-    timeId: HistoryTimeId;
-    route: RouteRef;
-    origin?: Ref;
-    previous?: HistoryTimeId[];
-};
-export type History<Str extends string> = RljsonTable<HistoryRow<Str>, 'history'>;
-/**
- * Creates a TableCfg for a History table for the given table configuration
- * @param tableCfg - The table configuration to create the History table for
- * @returns The TableCfg for the History table
- */
-export declare const createHistoryTableCfg: (tableCfg: TableCfg) => TableCfg;
-/**
- * Provides an example history table for test purposes
- */
-export declare const exampleHistoryTable: () => History<any>;