@sovereignbase/convergent-replicated-struct 1.0.1 → 1.1.0

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/convergent-replicated-struct/convergent-replicated-struct/dist/index.cjs","../src/OOStruct/class.ts","../src/.errors/class.ts","../src/OOStruct/parseSnapshotEntryToStateEntry/index.ts","../src/OOStruct/parseStateEntryToSnapshotEntry/index.ts"],"names":["key"],"mappings":"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","file":"/home/runner/work/convergent-replicated-struct/convergent-replicated-struct/dist/index.cjs","sourcesContent":[null,"import { v7 as uuidv7 } from 'uuid'\nimport type {\n  OOStructChange,\n  OOStructDelta,\n  OOStructEventListenerFor,\n  OOStructEventMap,\n  OOStructSnapshot,\n  OOStructSnapshotEntry,\n  OOStructState,\n  OOStructStateEntry,\n  OOStructAck,\n} from '../.types/index.js'\nimport { OOStructError } from '../.errors/class.js'\nimport { parseSnapshotEntryToStateEntry } from './parseSnapshotEntryToStateEntry/index.js'\nimport { parseStateEntryToSnapshotEntry } from './parseStateEntryToSnapshotEntry/index.js'\nimport { isUuidV7, prototype, safeStructuredClone } from '@sovereignbase/utils'\n\n/**\n * Represents an observed-overwrite struct replica.\n *\n * The struct shape is fixed by the provided default values.\n */\nexport class OOStruct<T extends Record<string, unknown>> {\n  private readonly __eventTarget = new EventTarget()\n  private readonly __defaults: T\n  private readonly __state: OOStructState<T>\n  private __live: T\n\n  /**\n   * Creates a replica from default values and an optional snapshot.\n   *\n   * @param defaults - The default field values that define the struct shape.\n   * @param snapshot - An optional serialized snapshot used for hydration.\n   * @throws {OOStructError} Thrown when the default values are not supported by `structuredClone`.\n   */\n  constructor(\n    defaults: { [K in keyof T]: T[K] },\n    snapshot?: OOStructSnapshot<T>\n  ) {\n    const [cloned, copiedDefaults] = safeStructuredClone(defaults)\n    if (!cloned)\n      throw new OOStructError(\n        'DEFAULTS_NOT_CLONEABLE',\n        'Default values must be supported by structuredClone.'\n      )\n    this.__defaults = copiedDefaults\n    this.__state = {} as OOStructState<T>\n    this.__live = {} as T\n\n    const snapshotIsObject = snapshot && prototype(snapshot) === 'record'\n\n    for (const key of Object.keys(this.__defaults)) {\n      const defaultValue = this.__defaults[key as keyof T]\n      if (snapshotIsObject && Object.hasOwn(snapshot, key)) {\n        const valid = parseSnapshotEntryToStateEntry(\n          defaultValue,\n          snapshot[key as keyof T]\n        )\n        if (valid) {\n          this.__live[key as keyof T] = valid.__value\n          this.__state[key as keyof T] = valid\n          continue\n        }\n      }\n      this.__live[key as keyof T] = defaultValue\n      const root = uuidv7()\n      this.__state[key as keyof T] = {\n        __uuidv7: uuidv7(),\n        __after: root,\n        __value: defaultValue,\n        __overwrites: new Set([root]),\n      }\n    }\n  }\n\n  /**CRUD*/\n  /**\n   * Creates a new replica.\n   *\n   * @param defaults - The default field values that define the struct shape.\n   * @param snapshot - An optional serialized snapshot used for hydration.\n   * @returns A new OO-Struct replica.\n   */\n  static create<T extends Record<string, unknown>>(\n    defaults: { [K in keyof T]: T[K] },\n    snapshot?: OOStructSnapshot<T>\n  ): OOStruct<T> {\n    return new OOStruct(defaults, snapshot)\n  }\n\n  /**\n   * Reads the current value of a field.\n   *\n   * @param key - The field key to read.\n   * @returns A cloned copy of the field's current value.\n   */\n  read<K extends keyof T>(key: K): T[K] {\n    return structuredClone(this.__live[key])\n  }\n\n  /**\n   * Overwrites a field with a new value.\n   *\n   * @param key - The field key to overwrite.\n   * @param value - The next value for the field.\n   * @throws {OOStructError} Thrown when the value is not supported by `structuredClone`.\n   * @throws {OOStructError} Thrown when the value runtime type does not match the default value runtime type.\n   */\n  update<K extends keyof T>(key: K, value: T[K]): void {\n    const [cloned, copiedValue] = safeStructuredClone(value)\n    if (!cloned)\n      throw new OOStructError(\n        'VALUE_NOT_CLONEABLE',\n        'Updated values must be supported by structuredClone.'\n      )\n\n    if (prototype(copiedValue) !== prototype(this.__defaults[key]))\n      throw new OOStructError(\n        'VALUE_TYPE_MISMATCH',\n        'Updated value must match the default value runtime type.'\n      )\n    const delta: OOStructDelta<T> = {}\n    const change: OOStructChange<T> = {}\n    delta[key] = this.overwriteAndReturnSnapshotEntry(key, copiedValue)\n    change[key] = structuredClone(copiedValue)\n    this.__eventTarget.dispatchEvent(\n      new CustomEvent('delta', { detail: delta })\n    )\n    this.__eventTarget.dispatchEvent(\n      new CustomEvent('change', { detail: change })\n    )\n  }\n\n  /**\n   * Resets one field or the entire struct back to default values.\n   *\n   * @param key - The optional field key to reset. When omitted, every field is reset.\n   */\n  delete<K extends keyof T>(key?: K): void {\n    const delta: OOStructDelta<T> = {}\n    const change: OOStructChange<T> = {}\n\n    if (key !== undefined) {\n      if (!Object.hasOwn(this.__defaults, key)) return\n      const value = this.__defaults[key]\n      delta[key] = this.overwriteAndReturnSnapshotEntry(key, value)\n      change[key] = structuredClone(value)\n    } else {\n      for (const [key, value] of Object.entries(this.__defaults)) {\n        delta[key as K] = this.overwriteAndReturnSnapshotEntry(\n          key as K,\n          value as T[K]\n        )\n        change[key as K] = structuredClone(value as T[K])\n      }\n    }\n    this.__eventTarget.dispatchEvent(\n      new CustomEvent('delta', { detail: delta })\n    )\n    this.__eventTarget.dispatchEvent(\n      new CustomEvent('change', { detail: change })\n    )\n  }\n\n  /**MAGS*/\n  /**\n   * Merges an incoming delta into the current replica.\n   *\n   * @param replica - The incoming partial snapshot projection to merge.\n   */\n  merge<K extends keyof T>(replica: OOStructDelta<T>): void {\n    if (!replica || typeof replica !== 'object' || Array.isArray(replica))\n      return\n\n    const delta: OOStructDelta<T> = {}\n    const change: OOStructChange<T> = {}\n    let hasDelta = false\n    let hasChange = false\n\n    for (const [key, value] of Object.entries(replica)) {\n      if (!Object.hasOwn(this.__state, key)) continue\n\n      const candidate = parseSnapshotEntryToStateEntry(\n        this.__defaults[key as K],\n        value as OOStructSnapshotEntry<T[K]>\n      )\n      if (!candidate) continue\n\n      const target = this.__state[key as K]\n      const current = { ...target }\n      let frontier = ''\n      for (const overwrite of target.__overwrites) {\n        if (frontier < overwrite) frontier = overwrite\n      }\n\n      for (const overwrite of candidate.__overwrites) {\n        if (overwrite <= frontier || target.__overwrites.has(overwrite))\n          continue\n        target.__overwrites.add(overwrite)\n      }\n\n      if (target.__overwrites.has(candidate.__uuidv7)) continue\n\n      if (current.__uuidv7 === candidate.__uuidv7) {\n        if (current.__after < candidate.__after) {\n          target.__value = candidate.__value\n          target.__after = candidate.__after\n          target.__overwrites.add(candidate.__after)\n          this.__live[key as K] = candidate.__value\n          change[key as K] = structuredClone(candidate.__value)\n          hasChange = true\n        } else {\n          delta[key as K] = this.overwriteAndReturnSnapshotEntry(\n            key as K,\n            current.__value\n          )\n          hasDelta = true\n        }\n        continue\n      }\n\n      if (\n        current.__uuidv7 === candidate.__after ||\n        target.__overwrites.has(current.__uuidv7) ||\n        candidate.__uuidv7 > current.__uuidv7\n      ) {\n        target.__uuidv7 = candidate.__uuidv7\n        target.__value = candidate.__value\n        target.__after = candidate.__after\n        target.__overwrites.add(candidate.__after)\n        target.__overwrites.add(current.__uuidv7)\n        this.__live[key as K] = candidate.__value\n        change[key as K] = structuredClone(candidate.__value)\n        hasChange = true\n        continue\n      }\n\n      target.__overwrites.add(candidate.__uuidv7)\n      delta[key as K] = parseStateEntryToSnapshotEntry(target)\n      hasDelta = true\n    }\n    if (hasDelta)\n      this.__eventTarget.dispatchEvent(\n        new CustomEvent('delta', { detail: delta })\n      )\n    if (hasChange)\n      this.__eventTarget.dispatchEvent(\n        new CustomEvent('change', { detail: change })\n      )\n  }\n\n  /**\n   * Emits the current acknowledgement frontier for each field.\n   */\n  acknowledge<K extends Extract<keyof T, string>>(): void {\n    const ack: OOStructAck<T> = {}\n    for (const [key, value] of Object.entries(this.__state)) {\n      let max = ''\n      for (const overwrite of (value as OOStructStateEntry<T[K]>)\n        .__overwrites) {\n        if (max < overwrite) max = overwrite\n      }\n      ack[key as K] = max\n    }\n    this.__eventTarget.dispatchEvent(new CustomEvent('ack', { detail: ack }))\n  }\n\n  /**\n   * Removes overwritten identifiers that every provided frontier has acknowledged.\n   *\n   * @param frontiers - A collection of acknowledgement frontiers to compact against.\n   */\n  garbageCollect<K extends Extract<keyof T, string>>(\n    frontiers: Array<OOStructAck<T>>\n  ): void {\n    if (!Array.isArray(frontiers) || frontiers.length < 1) return\n    const smallestAcknowledgementsPerKey: OOStructAck<T> = {}\n\n    for (const frontier of frontiers) {\n      for (const [key, value] of Object.entries(frontier)) {\n        if (!Object.hasOwn(this.__state, key) || !isUuidV7(value)) continue\n\n        const current = smallestAcknowledgementsPerKey[key as K]\n        if (typeof current === 'string' && current <= value) continue\n        smallestAcknowledgementsPerKey[key as K] = value\n      }\n    }\n\n    for (const [key, value] of Object.entries(smallestAcknowledgementsPerKey)) {\n      const target = this.__state[key]\n      const smallest = value as string\n      for (const uuidv7 of target.__overwrites) {\n        if (uuidv7 === target.__after || uuidv7 > smallest) continue\n        target.__overwrites.delete(uuidv7)\n      }\n    }\n  }\n\n  /**\n   * Emits a serialized snapshot of the current replica state.\n   */\n  snapshot(): void {\n    const snapshot = {} as OOStructSnapshot<T>\n\n    for (const [key, value] of Object.entries(this.__state)) {\n      snapshot[key as keyof T] = parseStateEntryToSnapshotEntry(\n        value as OOStructStateEntry<T[keyof T]>\n      )\n    }\n\n    this.__eventTarget.dispatchEvent(\n      new CustomEvent('snapshot', { detail: snapshot })\n    )\n  }\n\n  /**ADDITIONAL*/\n\n  /**\n   * Returns the struct field keys.\n   *\n   * @returns The field keys in the current replica.\n   */\n  keys<K extends keyof T>(): Array<K> {\n    return Object.keys(this.__live) as Array<K>\n  }\n\n  /**\n   * Returns cloned copies of the current field values.\n   *\n   * @returns The current field values.\n   */\n  values<K extends keyof T>(): Array<T[K]> {\n    return Object.values(this.__live).map((value) =>\n      structuredClone(value)\n    ) as Array<T[K]>\n  }\n\n  /**\n   * Returns cloned key-value pairs for the current replica state.\n   *\n   * @returns The current field entries.\n   */\n  entries<K extends keyof T>(): Array<[K, T[K]]> {\n    return Object.entries(this.__live).map(([key, value]) => [\n      key as K,\n      structuredClone(value as T[K]),\n    ])\n  }\n\n  /**EVENTS*/\n\n  /**\n   * Registers an event listener.\n   *\n   * @param type - The event type to listen for.\n   * @param listener - The listener to register.\n   * @param options - Listener registration options.\n   */\n  addEventListener<K extends keyof OOStructEventMap<T>>(\n    type: K,\n    listener: OOStructEventListenerFor<T, K> | null,\n    options?: boolean | AddEventListenerOptions\n  ): void {\n    this.__eventTarget.addEventListener(\n      type,\n      listener as EventListenerOrEventListenerObject | null,\n      options\n    )\n  }\n\n  /**\n   * Removes an event listener.\n   *\n   * @param type - The event type to stop listening for.\n   * @param listener - The listener to remove.\n   * @param options - Listener removal options.\n   */\n  removeEventListener<K extends keyof OOStructEventMap<T>>(\n    type: K,\n    listener: OOStructEventListenerFor<T, K> | null,\n    options?: boolean | EventListenerOptions\n  ): void {\n    this.__eventTarget.removeEventListener(\n      type,\n      listener as EventListenerOrEventListenerObject | null,\n      options\n    )\n  }\n\n  /**HELPERS*/\n\n  /**\n   * Overwrites a field and returns the serialized delta entry for that overwrite.\n   *\n   * @param key - The field key to overwrite.\n   * @param value - The next value for the field.\n   * @returns The serialized snapshot entry for the new winning value.\n   */\n  private overwriteAndReturnSnapshotEntry<K extends keyof T>(\n    key: K,\n    value: T[K]\n  ): OOStructSnapshotEntry<T[K]> {\n    const target = this.__state[key]\n    const old = { ...target }\n    target.__uuidv7 = uuidv7()\n    target.__value = value\n    target.__after = old.__uuidv7\n    target.__overwrites.add(old.__uuidv7)\n    this.__live[key] = value\n    return parseStateEntryToSnapshotEntry(target)\n  }\n}\n","/**\n * Error codes thrown by {@link OOStruct}.\n */\nexport type OOStructErrorCode =\n  | 'DEFAULTS_NOT_CLONEABLE'\n  | 'VALUE_NOT_CLONEABLE'\n  | 'VALUE_TYPE_MISMATCH'\n\n/**\n * Represents a typed OO-Struct runtime error.\n */\nexport class OOStructError extends Error {\n  /**\n   * The semantic error code for the failure.\n   */\n  readonly code: OOStructErrorCode\n\n  /**\n   * Creates a typed OO-Struct error.\n   *\n   * @param code - The semantic error code.\n   * @param message - An optional human-readable detail message.\n   */\n  constructor(code: OOStructErrorCode, message?: string) {\n    const detail = message ?? code\n    super(`{@sovereignbase/observed-overwrite-struct} ${detail}`)\n    this.code = code\n    this.name = 'OOStructError'\n  }\n}\n","import type {\n  OOStructSnapshotEntry,\n  OOStructStateEntry,\n} from '../../.types/index.js'\nimport { isUuidV7, prototype, safeStructuredClone } from '@sovereignbase/utils'\n\n/**\n * Validates and converts a serialized field entry into internal replica state.\n *\n * Invalid entries are rejected by returning `false`.\n *\n * @param defaultValue - The default value for the field used for runtime type comparison.\n * @param snapshotEntry - The serialized entry to validate and parse.\n * @returns The parsed state entry, or `false` when the entry is invalid.\n */\nexport function parseSnapshotEntryToStateEntry<V>(\n  defaultValue: V,\n  snapshotEntry: OOStructSnapshotEntry<V>\n): OOStructStateEntry<V> | false {\n  if (\n    prototype(snapshotEntry) !== 'record' ||\n    !Object.hasOwn(snapshotEntry, '__value') ||\n    !isUuidV7(snapshotEntry.__uuidv7) ||\n    !isUuidV7(snapshotEntry.__after) ||\n    !Array.isArray(snapshotEntry.__overwrites)\n  )\n    return false\n\n  const [cloned, copiedValue] = safeStructuredClone(snapshotEntry.__value)\n  if (!cloned || prototype(copiedValue) !== prototype(defaultValue))\n    return false\n\n  const overwrites = new Set<string>([])\n  for (const overwrite of snapshotEntry.__overwrites) {\n    if (\n      !isUuidV7(overwrite) ||\n      overwrite ===\n        snapshotEntry.__uuidv7 /**if it was actually overwritten the current uuid would be different so this must be malicious*/\n    )\n      continue\n    overwrites.add(overwrite)\n  }\n\n  if (!overwrites.has(snapshotEntry.__after)) return false\n\n  return {\n    __uuidv7: snapshotEntry.__uuidv7,\n    __value: copiedValue,\n    __after: snapshotEntry.__after,\n    __overwrites: overwrites,\n  }\n}\n","import type {\n  OOStructStateEntry,\n  OOStructSnapshotEntry,\n} from '../../.types/index.js'\n\n/**\n * Serializes a field state entry into a snapshot entry.\n *\n * @param stateEntry - The internal state entry to serialize.\n * @returns The serialized snapshot entry.\n */\nexport function parseStateEntryToSnapshotEntry<K>(\n  stateEntry: OOStructStateEntry<K>\n): OOStructSnapshotEntry<K> {\n  return {\n    __uuidv7: stateEntry.__uuidv7,\n    __value: structuredClone(stateEntry.__value),\n    __after: stateEntry.__after,\n    __overwrites: Array.from(stateEntry.__overwrites),\n  }\n}\n"]}
+{"version":3,"sources":["/home/runner/work/convergent-replicated-struct/convergent-replicated-struct/dist/index.cjs","../src/.helpers/overwriteAndReturnSnapshotEntry/index.ts","../src/.helpers/parseSnapshotEntryToStateEntry/index.ts","../src/.helpers/parseStateEntryToSnapshotEntry/index.ts","../src/core/mags/merge/index.ts","../src/core/mags/acknowledge/index.ts","../src/core/mags/garbageCollect/index.ts","../src/core/mags/snapshot/index.ts","../src/core/crud/create/index.ts","../src/.errors/class.ts","../src/core/crud/read/index.ts","../src/core/crud/update/index.ts","../src/core/crud/delete/index.ts","../src/CRStruct/class.ts"],"names":["isUuidV7","uuidv7","key"],"mappings":"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","file":"/home/runner/work/convergent-replicated-struct/convergent-replicated-struct/dist/index.cjs","sourcesContent":[null,"import type {\n  CRStructState,\n  CRStructSnapshotEntry,\n} from '../../.types/index.js'\nimport { parseStateEntryToSnapshotEntry } from '../index.js'\nimport { v7 as uuidv7 } from 'uuid'\n/**\n * Overwrites a field and returns the serialized delta entry for that overwrite.\n *\n * @param key - The field key to overwrite.\n * @param value - The next value for the field.\n * @returns The serialized snapshot entry for the new winning value.\n */\nexport function overwriteAndReturnSnapshotEntry<\n  T extends Record<string, unknown>,\n>(\n  key: keyof T,\n  value: T[keyof T],\n  crStructReplica: CRStructState<T>\n): CRStructSnapshotEntry<T[keyof T]> {\n  const target = crStructReplica.entries[key]\n  const oldUuidv7 = target.uuidv7\n  target.uuidv7 = uuidv7()\n  target.value = value\n  target.predecessor = oldUuidv7\n  target.tombstones.add(oldUuidv7)\n  return parseStateEntryToSnapshotEntry(target)\n}\n","import type {\n  CRStructSnapshotEntry,\n  CRStructStateEntry,\n} from '../../.types/index.js'\nimport { isUuidV7, prototype, safeStructuredClone } from '@sovereignbase/utils'\n\n/**\n * Validates and converts a serialized field entry into internal replica state.\n *\n * Invalid entries are rejected by returning `false`.\n *\n * @param defaultValue - The default value for the field used for runtime type comparison.\n * @param snapshotEntry - The serialized entry to validate and parse.\n * @returns The parsed state entry, or `false` when the entry is invalid.\n */\nexport function parseSnapshotEntryToStateEntry<V>(\n  defaultValue: V,\n  snapshotEntry: CRStructSnapshotEntry<V>\n): CRStructStateEntry<V> | false {\n  if (\n    prototype(snapshotEntry) !== 'record' ||\n    !Object.hasOwn(snapshotEntry, 'value') ||\n    !isUuidV7(snapshotEntry.uuidv7) ||\n    !isUuidV7(snapshotEntry.predecessor) ||\n    !Array.isArray(snapshotEntry.tombstones)\n  )\n    return false\n\n  const [cloned, copiedValue] = safeStructuredClone(snapshotEntry.value)\n  if (!cloned || prototype(copiedValue) !== prototype(defaultValue))\n    return false\n\n  const tombstones = new Set<string>([])\n  for (const overwrite of snapshotEntry.tombstones) {\n    if (\n      !isUuidV7(overwrite) ||\n      overwrite ===\n        snapshotEntry.uuidv7 /**if it was actually overwritten the current uuid would be different so this must be malicious*/\n    )\n      continue\n    tombstones.add(overwrite)\n  }\n\n  if (!tombstones.has(snapshotEntry.predecessor)) return false\n\n  return {\n    uuidv7: snapshotEntry.uuidv7,\n    value: copiedValue,\n    predecessor: snapshotEntry.predecessor,\n    tombstones: tombstones,\n  }\n}\n","import type {\n  CRStructStateEntry,\n  CRStructSnapshotEntry,\n} from '../../.types/index.js'\n\n/**\n * Serializes a field state entry into a snapshot entry.\n *\n * @param stateEntry - The internal state entry to serialize.\n * @returns The serialized snapshot entry.\n */\nexport function parseStateEntryToSnapshotEntry<K>(\n  stateEntry: CRStructStateEntry<K>\n): CRStructSnapshotEntry<K> {\n  return {\n    uuidv7: stateEntry.uuidv7,\n    value: structuredClone(stateEntry.value),\n    predecessor: stateEntry.predecessor,\n    tombstones: Array.from(stateEntry.tombstones),\n  }\n}\n","import type {\n  CRStructState,\n  CRStructDelta,\n  CRStructChange,\n  CRStructStateEntry,\n} from '../../../.types/index.js'\nimport {\n  parseSnapshotEntryToStateEntry,\n  parseStateEntryToSnapshotEntry,\n  overwriteAndReturnSnapshotEntry,\n} from '../../../.helpers/index.js'\n\n/**\n * Merges an incoming delta into the current replica.\n *\n * Unknown fields and invalid snapshot entries are ignored. Accepted candidates\n * extend local tombstone knowledge, may advance the current winning value, and\n * may emit a return delta when the local state already dominates the incoming\n * entry.\n *\n * @param crStructDelta - The incoming partial snapshot projection to merge.\n * @param crStructReplica - The local replica state to merge into.\n *\n * @returns\n * The visible change projection and reply delta, or `false` when the input is\n * invalid or produces no outbound effect.\n *\n * Time complexity: O(d + l + i + c), worst case O(d + l + i + c)\n *\n * d = incoming delta field count\n * l = local tombstone count processed across touched fields\n * i = incoming tombstone count processed across accepted delta entries\n * c = cloned and serialized payload size across emitted changes and reply deltas\n *\n * Space complexity: O(d + l + c)\n */\nexport function __merge<T extends Record<string, unknown>>(\n  crStructDelta: CRStructDelta<T>,\n  crStructReplica: CRStructState<T>\n): { change: CRStructChange<T>; delta: CRStructDelta<T> } | false {\n  if (\n    !crStructDelta ||\n    typeof crStructDelta !== 'object' ||\n    Array.isArray(crStructDelta)\n  )\n    return false\n\n  const delta: CRStructDelta<T> = {}\n  const change: CRStructChange<T> = {}\n  let hasDelta = false\n  let hasChange = false\n\n  for (const [key, value] of Object.entries(crStructDelta)) {\n    if (!Object.hasOwn(crStructReplica.defaults, key)) continue\n\n    const candidate = parseSnapshotEntryToStateEntry(\n      crStructReplica.defaults[key],\n      value\n    ) as CRStructStateEntry<T[keyof T]>\n    if (!candidate) continue\n\n    const target = crStructReplica.entries[key] as CRStructStateEntry<\n      T[keyof T]\n    >\n    const current = { ...target }\n    let frontier = ''\n    for (const overwrite of target.tombstones) {\n      if (frontier < overwrite) frontier = overwrite\n    }\n\n    for (const overwrite of candidate.tombstones) {\n      if (overwrite <= frontier || target.tombstones.has(overwrite)) continue\n      target.tombstones.add(overwrite)\n    }\n\n    if (target.tombstones.has(candidate.uuidv7)) continue\n\n    if (current.uuidv7 === candidate.uuidv7) {\n      if (current.predecessor < candidate.predecessor) {\n        target.value = candidate.value\n        target.predecessor = candidate.predecessor\n        target.tombstones.add(candidate.predecessor)\n        change[key as keyof T] = structuredClone(candidate.value)\n        hasChange = true\n      } else {\n        delta[key as keyof T] = overwriteAndReturnSnapshotEntry(\n          key,\n          current.value,\n          crStructReplica\n        )\n        hasDelta = true\n      }\n      continue\n    }\n\n    if (\n      current.uuidv7 === candidate.predecessor ||\n      target.tombstones.has(current.uuidv7) ||\n      candidate.uuidv7 > current.uuidv7\n    ) {\n      target.uuidv7 = candidate.uuidv7\n      target.value = candidate.value\n      target.predecessor = candidate.predecessor\n      target.tombstones.add(candidate.predecessor)\n      target.tombstones.add(current.uuidv7)\n      change[key as keyof T] = structuredClone(candidate.value)\n      hasChange = true\n      continue\n    }\n\n    target.tombstones.add(candidate.uuidv7)\n    delta[key as keyof T] = parseStateEntryToSnapshotEntry(target)\n    hasDelta = true\n  }\n  if (!hasDelta && !hasChange) return false\n  return { change, delta }\n}\n","import type {\n  CRStructAck,\n  CRStructState,\n  CRStructStateEntry,\n} from '../../../.types/index.js'\n/**\n * Emits the current acknowledgement frontier for each field.\n *\n * Each field reports the largest tombstone identifier currently known for that\n * field.\n *\n * @param crStructReplica - The replica state to summarize.\n *\n * @returns\n * An acknowledgement frontier keyed by field name.\n *\n * Time complexity: O(k + t), worst case O(k + t)\n *\n * k = replica field count\n * t = total tombstone count across all fields\n *\n * Space complexity: O(k)\n */\nexport function __acknowledge<T extends Record<string, unknown>>(\n  crStructReplica: CRStructState<T>\n): CRStructAck<T> | false {\n  const ack: CRStructAck<T> = {}\n  for (const [key, value] of Object.entries(crStructReplica.entries)) {\n    let max = ''\n    for (const tombstone of (value as CRStructStateEntry<T[keyof T]>)\n      .tombstones) {\n      if (max < tombstone) max = tombstone\n    }\n    ack[key as keyof T] = max\n  }\n  return ack\n}\n","import { CRStructState, CRStructAck } from '../../../.types/index.js'\nimport { isUuidV7 } from '@sovereignbase/utils'\n\n/**\n * Removes overwritten identifiers that every provided frontier has acknowledged.\n *\n * The smallest valid acknowledgement per field is collected first, then local\n * tombstones at or below that frontier are removed while keeping the current\n * predecessor identifier intact.\n *\n * @param frontiers - A collection of acknowledgement frontiers to compact against.\n * @param crStructReplica - The replica state to compact.\n *\n * Time complexity: O(a + t), worst case O(a + t)\n *\n * a = acknowledgement entries scanned across all provided frontiers\n * t = tombstone count scanned across compacted fields\n *\n * Space complexity: O(k)\n *\n * k = fields that receive a valid acknowledgement frontier\n */\nexport function __garbageCollect<T extends Record<string, unknown>>(\n  frontiers: Array<CRStructAck<T>>,\n  crStructReplica: CRStructState<T>\n): void {\n  if (!Array.isArray(frontiers) || frontiers.length < 1) return\n  const smallestAcknowledgementsPerKey: CRStructAck<T> = {}\n\n  for (const frontier of frontiers) {\n    for (const [key, value] of Object.entries(frontier)) {\n      if (!Object.hasOwn(crStructReplica.entries, key) || !isUuidV7(value))\n        continue\n\n      const current = smallestAcknowledgementsPerKey[key]\n      if (typeof current === 'string' && current <= value) continue\n      smallestAcknowledgementsPerKey[key as keyof T] = value\n    }\n  }\n\n  for (const [key, value] of Object.entries(smallestAcknowledgementsPerKey)) {\n    const target = crStructReplica.entries[key]\n    const smallest = value as string\n    for (const uuidv7 of target.tombstones) {\n      if (uuidv7 === target.predecessor || uuidv7 > smallest) continue\n      target.tombstones.delete(uuidv7)\n    }\n  }\n}\n","import type {\n  CRStructState,\n  CRStructSnapshot,\n  CRStructStateEntry,\n} from '../../../.types/index.js'\nimport { parseStateEntryToSnapshotEntry } from '../../../.helpers/parseStateEntryToSnapshotEntry/index.js'\n\n/**\n * Serializes the current replica state into a snapshot projection.\n *\n * Each processed state entry is converted into its serializable snapshot form.\n *\n * @param crStructReplica - The replica state to serialize.\n *\n * @returns\n * A serializable snapshot projection of the replica state.\n *\n * Time complexity: O(k + t + c), worst case O(k + t + c)\n *\n * k = state entry count processed by the serializer\n * t = tombstone count serialized across processed entries\n * c = serialized payload size across processed values\n *\n * Space complexity: O(k + t + c)\n */\nexport function __snapshot<T extends Record<string, unknown>>(\n  crStructReplica: CRStructState<T>\n): CRStructSnapshot<T> {\n  const snapshot = {} as CRStructSnapshot<T>\n\n  for (const [key, value] of Object.entries(crStructReplica.entries)) {\n    snapshot[key as keyof T] = parseStateEntryToSnapshotEntry(\n      value as CRStructStateEntry<T[keyof T]>\n    )\n  }\n  return snapshot\n}\n","import type {\n  CRStructState,\n  CRStructStateEntry,\n  CRStructSnapshot,\n} from '../../../.types/index.js'\nimport { safeStructuredClone, prototype } from '@sovereignbase/utils'\nimport { CRStructError } from '../../../.errors/class.js'\nimport { parseSnapshotEntryToStateEntry } from '../../../.helpers/parseSnapshotEntryToStateEntry/index.js'\nimport { v7 as uuidv7 } from 'uuid'\n\n/**\n * Creates internal CR-Struct state from default values and an optional snapshot.\n *\n * Default values define the replica field set. Compatible snapshot entries are\n * parsed into live state entries, and invalid snapshot entries are ignored so\n * the corresponding field falls back to a freshly initialized default-backed\n * entry.\n *\n * @param defaults - Default field values that define the replica shape.\n * @param snapshot - Optional serialized state used to hydrate matching fields.\n *\n * @returns\n * A hydrated internal CR-Struct state object.\n *\n * @throws {CRStructError} Thrown when the default values are not supported by `structuredClone`.\n *\n * Time complexity: O(k + c + s + t), worst case O(k + c + s + t)\n *\n * k = default field count\n * c = total cloned payload size across defaults and accepted snapshot values\n * s = snapshot entries inspected for matching fields\n * t = tombstone count materialized for accepted snapshot entries\n *\n * Space complexity: O(k + c + t)\n */\nexport function __create<T extends Record<string, unknown>>(\n  defaults: T,\n  snapshot?: CRStructSnapshot<T>\n): CRStructState<T> {\n  const [cloned, copiedDefaults] = safeStructuredClone(defaults)\n  if (!cloned)\n    throw new CRStructError(\n      'DEFAULTS_NOT_CLONEABLE',\n      'Default values must be supported by structuredClone.'\n    )\n  const state: CRStructState<T> = {\n    entries: {} as { [K in keyof T]: CRStructStateEntry<T[K]> },\n    defaults: copiedDefaults,\n  }\n\n  const snapshotIsObject = snapshot && prototype(snapshot) === 'record'\n\n  for (const key of Object.keys(defaults)) {\n    const defaultValue = copiedDefaults[key as keyof T]\n    if (snapshotIsObject && Object.hasOwn(snapshot, key)) {\n      const valid = parseSnapshotEntryToStateEntry(\n        defaultValue,\n        snapshot[key as keyof T]\n      )\n      if (valid) {\n        state.entries[key as keyof T] = valid\n        continue\n      }\n    }\n    const root = uuidv7()\n    state.entries[key as keyof T] = {\n      uuidv7: uuidv7(),\n      predecessor: root,\n      value: defaultValue,\n      tombstones: new Set([root]),\n    }\n  }\n  return state\n}\n","/**\n * Error codes thrown by {@link OOStruct}.\n */\nexport type CRStructErrorCode =\n  | 'DEFAULTS_NOT_CLONEABLE'\n  | 'VALUE_NOT_CLONEABLE'\n  | 'VALUE_TYPE_MISMATCH'\n\n/**\n * Represents a typed CR-Struct runtime error.\n */\nexport class CRStructError extends Error {\n  /**\n   * The semantic error code for the failure.\n   */\n  readonly code: CRStructErrorCode\n\n  /**\n   * Creates a typed CR-Struct error.\n   *\n   * @param code - The semantic error code.\n   * @param message - An optional human-readable detail message.\n   */\n  constructor(code: CRStructErrorCode, message?: string) {\n    const detail = message ?? code\n    super(`{@sovereignbase/convergent-replicated-struct} ${detail}`)\n    this.code = code\n    this.name = 'CRStructError'\n  }\n}\n","import type { CRStructState } from '../../../.types/index.js'\n\n/**\n * Reads and clones the current value of a single field.\n *\n * @param key - The field key to read.\n * @param crStructReplica - The replica state that owns the field.\n *\n * @returns\n * A cloned copy of the field's current value.\n *\n * Time complexity: O(c), worst case O(c)\n *\n * c = cloned field payload size\n *\n * Space complexity: O(c)\n */\nexport function __read<T extends Record<string, unknown>>(\n  key: keyof T,\n  crStructReplica: CRStructState<T>\n): T[keyof T] {\n  return structuredClone(crStructReplica.entries[key].value)\n}\n","import type {\n  CRStructChange,\n  CRStructDelta,\n  CRStructState,\n} from '../../../.types/index.js'\nimport { safeStructuredClone, prototype } from '@sovereignbase/utils'\nimport { CRStructError } from '../../../.errors/class.js'\nimport { overwriteAndReturnSnapshotEntry } from '../../../.helpers/index.js'\n\n/**\n * Overwrites a field with a new value and emits the resulting projections.\n *\n * The incoming value is cloned first, validated against the default field\n * runtime type, and then written back as the current winning value for the\n * target field.\n *\n * @param key - The field key to overwrite.\n * @param value - The next value for the field.\n * @param crStructReplica - The replica state that owns the field.\n *\n * @returns\n * The visible change projection and serialized delta for the overwrite.\n *\n * @throws {CRStructError} Thrown when the value is not supported by `structuredClone`.\n * @throws {CRStructError} Thrown when the value runtime type does not match the default value runtime type.\n *\n * Time complexity: O(c + t), worst case O(c + t)\n *\n * c = cloned and serialized payload size for the updated value\n * t = tombstone count serialized for the target field\n *\n * Space complexity: O(c + t)\n */\nexport function __update<T extends Record<string, unknown>>(\n  key: keyof T,\n  value: T[keyof T],\n  crStructReplica: CRStructState<T>\n): { change: CRStructChange<T>; delta: CRStructDelta<T> } | false {\n  const [cloned, copiedValue] = safeStructuredClone(value)\n  if (!cloned)\n    throw new CRStructError(\n      'VALUE_NOT_CLONEABLE',\n      'Updated values must be supported by structuredClone.'\n    )\n\n  if (prototype(copiedValue) !== prototype(crStructReplica.defaults[key]))\n    throw new CRStructError(\n      'VALUE_TYPE_MISMATCH',\n      'Updated value must match the default value runtime type.'\n    )\n  const delta: CRStructDelta<T> = {}\n  const change: CRStructChange<T> = {}\n  delta[key] = overwriteAndReturnSnapshotEntry(\n    key,\n    copiedValue,\n    crStructReplica\n  )\n  change[key] = structuredClone(copiedValue)\n  return { change, delta }\n}\n","import { overwriteAndReturnSnapshotEntry } from '../../../.helpers/index.js'\nimport type {\n  CRStructState,\n  CRStructDelta,\n  CRStructChange,\n} from '../../../.types/index.js'\n\n/**\n * Resets one field or the entire struct back to default values.\n *\n * Each touched field is overwritten from the replica defaults and contributes a\n * visible change projection plus a serialized delta describing the reset.\n *\n * @param crStructReplica - The replica state to reset.\n * @param key - The optional field key to reset. When omitted, every field is reset.\n *\n * @returns\n * The visible change projection and serialized delta for the reset, or `false`\n * when a keyed reset targets a field outside the replica.\n *\n * Time complexity: O(k + c + t), worst case O(k + c + t)\n *\n * k = number of fields being reset\n * c = cloned and serialized payload size across reset field values\n * t = tombstone count serialized across reset fields\n *\n * Space complexity: O(k + c + t)\n */\nexport function __delete<T extends Record<string, unknown>>(\n  crStructReplica: CRStructState<T>,\n  key?: keyof T\n): { change: CRStructChange<T>; delta: CRStructDelta<T> } | false {\n  const delta: CRStructDelta<T> = {}\n  const change: CRStructChange<T> = {}\n\n  if (key !== undefined) {\n    if (!Object.hasOwn(crStructReplica.defaults, key)) return false\n    const value = crStructReplica.defaults[key]\n    delta[key] = overwriteAndReturnSnapshotEntry<T>(key, value, crStructReplica)\n    change[key] = structuredClone(value)\n  } else {\n    for (const [key, value] of Object.entries(crStructReplica.defaults)) {\n      delta[key as keyof T] = overwriteAndReturnSnapshotEntry<T>(\n        key,\n        value as T[keyof T],\n        crStructReplica\n      )\n      change[key as keyof T] = structuredClone(value as T[keyof T])\n    }\n  }\n  return { change, delta }\n}\n","import type {\n  CRStructDelta,\n  CRStructEventListenerFor,\n  CRStructEventMap,\n  CRStructSnapshot,\n  CRStructState,\n  CRStructAck,\n} from '../.types/index.js'\n\nimport {\n  __merge,\n  __acknowledge,\n  __garbageCollect,\n  __snapshot,\n} from '../core/mags/index.js'\nimport { __create, __read, __update, __delete } from '../core/crud/index.js'\n\n/**\n * Runtime implementation for a proxy-backed CR-Struct replica.\n */\nclass CRStructRaw<T extends Record<string, unknown>> {\n  declare private readonly state: CRStructState<T>\n  declare private readonly eventTarget: EventTarget\n\n  /**\n   * Creates a replica from default values and an optional snapshot.\n   *\n   * The struct shape is fixed by the provided default values. The returned\n   * proxy exposes those fields as direct properties on the instance.\n   *\n   * @param defaults - The default field values that define the struct shape.\n   * @param snapshot - An optional serialized snapshot used to hydrate the replica.\n   * @throws {CRStructError} Thrown when the default values are not supported by `structuredClone`.\n   */\n  constructor(defaults: T, snapshot?: CRStructSnapshot<T>) {\n    Object.defineProperties(this, {\n      state: {\n        value: __create<T>(defaults, snapshot),\n        enumerable: false,\n        configurable: false,\n        writable: false,\n      },\n      eventTarget: {\n        value: new EventTarget(),\n        enumerable: false,\n        configurable: false,\n        writable: false,\n      },\n    })\n    const keys = new Set(Object.keys(defaults))\n    return new Proxy(this, {\n      get(target, key, receiver) {\n        // Preserve normal property access for unknown keys.\n        if (typeof key !== 'string' || !keys.has(key))\n          return Reflect.get(target, key, receiver)\n        return __read(key, target.state)\n      },\n      has(target, key) {\n        // Preserve normal property checks for unknown keys.\n        if (typeof key !== 'string' || !keys.has(key))\n          return Reflect.has(target, key)\n        return true\n      },\n      set(target, key, value) {\n        if (typeof key !== 'string' || !keys.has(key)) return false\n        try {\n          const result = __update<T>(key, value, target.state)\n          /* c8 ignore next -- __update either throws or returns a result object. */\n          if (!result) return false\n          const { delta, change } = result\n          if (delta)\n            void target.eventTarget.dispatchEvent(\n              new CustomEvent('delta', { detail: delta })\n            )\n          if (change)\n            void target.eventTarget.dispatchEvent(\n              new CustomEvent('change', { detail: change })\n            )\n          return true\n        } catch {\n          return false\n        }\n      },\n      deleteProperty(target, key) {\n        if (typeof key !== 'string' || !keys.has(key)) return false\n        try {\n          const result = __delete<T>(target.state, key)\n          if (!result) return false\n          const { delta, change } = result\n          if (delta) {\n            void target.eventTarget.dispatchEvent(\n              new CustomEvent('delta', { detail: delta })\n            )\n          }\n          if (change) {\n            void target.eventTarget.dispatchEvent(\n              new CustomEvent('change', { detail: change })\n            )\n          }\n          return true\n        } catch {\n          return false\n        }\n      },\n      ownKeys(target) {\n        return [\n          ...Reflect.ownKeys(target),\n          ...Reflect.ownKeys(target.state.defaults),\n        ]\n      },\n      getOwnPropertyDescriptor(target, key) {\n        // Preserve normal property checks for unknown keys.\n        if (typeof key !== 'string' || !keys.has(key))\n          return Reflect.getOwnPropertyDescriptor(target, key)\n        return {\n          value: __read(key, target.state),\n          writable: true,\n          enumerable: true,\n          configurable: true,\n        }\n      },\n    })\n  }\n\n  /**\n   * Applies a remote or local delta to the replica state.\n   *\n   * @param crStructDelta - The partial serialized field state to merge.\n   */\n  merge(crStructDelta: CRStructDelta<T>): void {\n    const result = __merge<T>(crStructDelta, this.state)\n    if (!result) return\n    const { delta, change } = result\n    if (delta) {\n      void this.eventTarget.dispatchEvent(\n        new CustomEvent('delta', { detail: delta })\n      )\n    }\n    if (change) {\n      void this.eventTarget.dispatchEvent(\n        new CustomEvent('change', { detail: change })\n      )\n    }\n  }\n\n  /**\n   * Emits the current acknowledgement frontier for each field.\n   */\n  acknowledge(): void {\n    const ack = __acknowledge<T>(this.state)\n    if (ack) {\n      void this.eventTarget.dispatchEvent(\n        new CustomEvent('ack', { detail: ack })\n      )\n    }\n  }\n\n  /**\n   * Removes overwritten identifiers that every provided frontier has acknowledged.\n   *\n   * @param frontiers - A collection of acknowledgement frontiers to compact against.\n   */\n  garbageCollect(frontiers: Array<CRStructAck<T>>): void {\n    void __garbageCollect<T>(frontiers, this.state)\n  }\n\n  /**\n   * Emits a serialized snapshot of the current replica state.\n   */\n  snapshot(): void {\n    const snapshot = __snapshot<T>(this.state)\n    if (snapshot) {\n      void this.eventTarget.dispatchEvent(\n        new CustomEvent('snapshot', { detail: snapshot })\n      )\n    }\n  }\n\n  /**\n   * Returns the struct field keys.\n   *\n   * @returns The field keys in the current replica.\n   */\n  keys<K extends keyof T>(): Array<K> {\n    return Object.keys(this.state.entries) as Array<K>\n  }\n\n  /**\n   * Resets every field in the replica back to its default value.\n   */\n  clear(): void {\n    const result = __delete(this.state)\n    if (result) {\n      const { delta, change } = result\n      if (delta) {\n        void this.eventTarget.dispatchEvent(\n          new CustomEvent('delta', { detail: delta })\n        )\n      }\n      if (change) {\n        void this.eventTarget.dispatchEvent(\n          new CustomEvent('change', { detail: change })\n        )\n      }\n    }\n  }\n\n  /**\n   * Returns a cloned plain object view of the current replica fields.\n   *\n   * @returns The current field values keyed by field name.\n   */\n  clone(): T {\n    const out = {} as T\n    for (const [key, entry] of Object.entries(this.state.entries)) {\n      out[key as keyof T] = structuredClone(entry.value as T[keyof T])\n    }\n    return out\n  }\n\n  /**\n   * Returns cloned copies of the current field values.\n   *\n   * @returns The current field values.\n   */\n  values<K extends keyof T>(): Array<T[K]> {\n    return Object.values(this.state.entries).map((entry) =>\n      structuredClone(entry.value)\n    ) as Array<T[K]>\n  }\n\n  /**\n   * Returns cloned key-value pairs for the current replica state.\n   *\n   * @returns The current field entries.\n   */\n  entries<K extends keyof T>(): Array<[K, T[K]]> {\n    return Object.entries(this.state.entries).map(([key, entry]) => [\n      key as K,\n      structuredClone(entry.value as T[K]),\n    ])\n  }\n\n  /**\n   * Returns a serializable snapshot representation of this replica.\n   *\n   * Called automatically by `JSON.stringify`.\n   */\n  toJSON(): CRStructSnapshot<T> {\n    return __snapshot<T>(this.state)\n  }\n  /**\n   * Returns this replica as a JSON string.\n   */\n  toString(): string {\n    return JSON.stringify(this)\n  }\n  /**\n   * Returns the Node.js console inspection representation.\n   */\n  [Symbol.for('nodejs.util.inspect.custom')](): CRStructSnapshot<T> {\n    return this.toJSON()\n  }\n  /**\n   * Returns the Deno console inspection representation.\n   */\n  [Symbol.for('Deno.customInspect')](): CRStructSnapshot<T> {\n    return this.toJSON()\n  }\n  /**\n   * Iterates over the current live field entries.\n   */\n  *[Symbol.iterator](): IterableIterator<[keyof T, T[keyof T]]> {\n    for (const [key, entry] of Object.entries(this.state.entries)) {\n      yield [key, structuredClone(entry.value)]\n    }\n  }\n\n  /**\n   * Registers an event listener.\n   *\n   * @param type - The event type to listen for.\n   * @param listener - The listener to register.\n   * @param options - Listener registration options.\n   */\n  addEventListener<K extends keyof CRStructEventMap<T>>(\n    type: K,\n    listener: CRStructEventListenerFor<T, K> | null,\n    options?: boolean | AddEventListenerOptions\n  ): void {\n    this.eventTarget.addEventListener(\n      type,\n      listener as EventListenerOrEventListenerObject | null,\n      options\n    )\n  }\n\n  /**\n   * Removes an event listener.\n   *\n   * @param type - The event type to stop listening for.\n   * @param listener - The listener to remove.\n   * @param options - Listener removal options.\n   */\n  removeEventListener<K extends keyof CRStructEventMap<T>>(\n    type: K,\n    listener: CRStructEventListenerFor<T, K> | null,\n    options?: boolean | EventListenerOptions\n  ): void {\n    this.eventTarget.removeEventListener(\n      type,\n      listener as EventListenerOrEventListenerObject | null,\n      options\n    )\n  }\n}\n\nexport type CRStruct<T extends Record<string, unknown>> = CRStructRaw<T> & T\n\nexport const CRStruct = CRStructRaw as {\n  new <T extends Record<string, unknown>>(\n    defaults: T,\n    snapshot?: CRStructSnapshot<T>\n  ): CRStruct<T>\n}\n"]}

package/dist/index.d.cts

@@ -2,182 +2,153 @@
 /**
  * Represents the internal replicated state for a single field.
  */
-type OOStructStateEntry<V> = {
+type CRStructStateEntry<V> = {
     /**
      * The identifier of the current winning value.
      */
-    __uuidv7: string;
+    uuidv7: string;
     /**
      * The current winning value.
      */
-    __value: V;
+    value: V;
     /**
      * The predecessor identifier for the current winning value.
      */
-    __after: string;
+    predecessor: string;
     /**
      * Identifiers known to have been overwritten for the field.
      */
-    __overwrites: Set<string>;
+    tombstones: Set<string>;
 };
 /**
  * Represents the internal replicated state of an OO-Struct replica.
  */
-type OOStructState<T extends Record<string, unknown>> = {
-    [K in keyof T]: OOStructStateEntry<T[K]>;
+type CRStructState<T extends Record<string, unknown>> = {
+    entries: {
+        [K in keyof T]: CRStructStateEntry<T[K]>;
+    };
+    defaults: T;
 };
 /**Serlialized projection of replica state*/
 /**
  * Represents the serialized state for a single field.
  */
-type OOStructSnapshotEntry<V> = {
+type CRStructSnapshotEntry<V> = {
     /**
      * The identifier of the current winning value.
      */
-    __uuidv7: string;
+    uuidv7: string;
     /**
      * The serialized current winning value.
      */
-    __value: V;
+    value: V;
     /**
      * The predecessor identifier for the current winning value.
      */
-    __after: string;
+    predecessor: string;
     /**
      * Serialized overwritten identifiers for the field.
      */
-    __overwrites: Array<string>;
+    tombstones: Array<string>;
 };
 /**
  * Represents a serialized snapshot of the full replica state.
  */
-type OOStructSnapshot<T extends Record<string, unknown>> = {
-    [K in keyof T]: OOStructSnapshotEntry<T[K]>;
+type CRStructSnapshot<T extends Record<string, unknown>> = {
+    [K in keyof T]: CRStructSnapshotEntry<T[K]>;
 };
 /**Resolved projection of replica state*/
 /**
  * Represents visible field values that changed during a local operation or merge.
  */
-type OOStructChange<T extends Record<string, unknown>> = Partial<T>;
+type CRStructChange<T extends Record<string, unknown>> = Partial<T>;
 /**(T)*/
-/**A "report" on what the replica has seen*/
-/**
- * Represents the acknowledgement frontier for a set of field keys.
- */
-type OOStructAcknowledgementFrontier<K extends string> = Record<K, string>;
 /**Partial changes to gossip*/
 /**
  * Represents a partial serialized state projection exchanged between replicas.
  */
-type OOStructDelta<T extends Record<string, unknown>> = Partial<OOStructSnapshot<T>>;
+type CRStructDelta<T extends Record<string, unknown>> = Partial<CRStructSnapshot<T>>;
+/**A "report" on what the replica has seen*/
 /**
  * Represents the current acknowledgement frontier emitted by a replica.
  */
-type OOStructAck<T extends Record<string, unknown>> = Partial<OOStructAcknowledgementFrontier<Extract<keyof T, string>>>;
+type CRStructAck<T extends Record<string, unknown>> = Partial<Record<keyof T, string>>;
 /***/
 /**
  * Maps OO-Struct event names to their event payload shapes.
  */
-type OOStructEventMap<T extends Record<string, unknown>> = {
+type CRStructEventMap<T extends Record<string, unknown>> = {
     /** STATE / PROJECTION */
-    snapshot: OOStructSnapshot<T>;
-    change: OOStructChange<T>;
+    snapshot: CRStructSnapshot<T>;
+    change: CRStructChange<T>;
     /** GOSSIP / PROTOCOL */
-    delta: OOStructDelta<T>;
-    ack: OOStructAck<T>;
+    delta: CRStructDelta<T>;
+    ack: CRStructAck<T>;
 };
 /**
  * Represents a strongly typed OO-Struct event listener.
  */
-type OOStructEventListener<T extends Record<string, unknown>, K extends keyof OOStructEventMap<T>> = ((event: CustomEvent<OOStructEventMap<T>[K]>) => void) | {
-    handleEvent(event: CustomEvent<OOStructEventMap<T>[K]>): void;
+type CRStructEventListener<T extends Record<string, unknown>, K extends keyof CRStructEventMap<T>> = ((event: CustomEvent<CRStructEventMap<T>[K]>) => void) | {
+    handleEvent(event: CustomEvent<CRStructEventMap<T>[K]>): void;
 };
 /**
  * Resolves an event name to its corresponding listener type.
  */
-type OOStructEventListenerFor<T extends Record<string, unknown>, K extends string> = K extends keyof OOStructEventMap<T> ? OOStructEventListener<T, K> : EventListenerOrEventListenerObject;
+type CRStructEventListenerFor<T extends Record<string, unknown>, K extends string> = K extends keyof CRStructEventMap<T> ? CRStructEventListener<T, K> : EventListenerOrEventListenerObject;
 
 /**
- * Represents an observed-overwrite struct replica.
- *
- * The struct shape is fixed by the provided default values.
+ * Runtime implementation for a proxy-backed CR-Struct replica.
  */
-declare class OOStruct<T extends Record<string, unknown>> {
-    private readonly __eventTarget;
-    private readonly __defaults;
-    private readonly __state;
-    private __live;
+declare class CRStructRaw<T extends Record<string, unknown>> {
+    private readonly state;
+    private readonly eventTarget;
     /**
      * Creates a replica from default values and an optional snapshot.
      *
-     * @param defaults - The default field values that define the struct shape.
-     * @param snapshot - An optional serialized snapshot used for hydration.
-     * @throws {OOStructError} Thrown when the default values are not supported by `structuredClone`.
-     */
-    constructor(defaults: {
-        [K in keyof T]: T[K];
-    }, snapshot?: OOStructSnapshot<T>);
-    /**CRUD*/
-    /**
-     * Creates a new replica.
+     * The struct shape is fixed by the provided default values. The returned
+     * proxy exposes those fields as direct properties on the instance.
      *
      * @param defaults - The default field values that define the struct shape.
-     * @param snapshot - An optional serialized snapshot used for hydration.
-     * @returns A new OO-Struct replica.
-     */
-    static create<T extends Record<string, unknown>>(defaults: {
-        [K in keyof T]: T[K];
-    }, snapshot?: OOStructSnapshot<T>): OOStruct<T>;
-    /**
-     * Reads the current value of a field.
-     *
-     * @param key - The field key to read.
-     * @returns A cloned copy of the field's current value.
-     */
-    read<K extends keyof T>(key: K): T[K];
-    /**
-     * Overwrites a field with a new value.
-     *
-     * @param key - The field key to overwrite.
-     * @param value - The next value for the field.
-     * @throws {OOStructError} Thrown when the value is not supported by `structuredClone`.
-     * @throws {OOStructError} Thrown when the value runtime type does not match the default value runtime type.
+     * @param snapshot - An optional serialized snapshot used to hydrate the replica.
+     * @throws {CRStructError} Thrown when the default values are not supported by `structuredClone`.
      */
-    update<K extends keyof T>(key: K, value: T[K]): void;
+    constructor(defaults: T, snapshot?: CRStructSnapshot<T>);
     /**
-     * Resets one field or the entire struct back to default values.
+     * Applies a remote or local delta to the replica state.
      *
-     * @param key - The optional field key to reset. When omitted, every field is reset.
+     * @param crStructDelta - The partial serialized field state to merge.
      */
-    delete<K extends keyof T>(key?: K): void;
-    /**MAGS*/
-    /**
-     * Merges an incoming delta into the current replica.
-     *
-     * @param replica - The incoming partial snapshot projection to merge.
-     */
-    merge<K extends keyof T>(replica: OOStructDelta<T>): void;
+    merge(crStructDelta: CRStructDelta<T>): void;
     /**
      * Emits the current acknowledgement frontier for each field.
      */
-    acknowledge<K extends Extract<keyof T, string>>(): void;
+    acknowledge(): void;
     /**
      * Removes overwritten identifiers that every provided frontier has acknowledged.
      *
      * @param frontiers - A collection of acknowledgement frontiers to compact against.
      */
-    garbageCollect<K extends Extract<keyof T, string>>(frontiers: Array<OOStructAck<T>>): void;
+    garbageCollect(frontiers: Array<CRStructAck<T>>): void;
     /**
      * Emits a serialized snapshot of the current replica state.
      */
     snapshot(): void;
-    /**ADDITIONAL*/
     /**
      * Returns the struct field keys.
      *
      * @returns The field keys in the current replica.
      */
     keys<K extends keyof T>(): Array<K>;
+    /**
+     * Resets every field in the replica back to its default value.
+     */
+    clear(): void;
+    /**
+     * Returns a cloned plain object view of the current replica fields.
+     *
+     * @returns The current field values keyed by field name.
+     */
+    clone(): T;
     /**
      * Returns cloned copies of the current field values.
      *
@@ -190,7 +161,20 @@ declare class OOStruct<T extends Record<string, unknown>> {
      * @returns The current field entries.
      */
     entries<K extends keyof T>(): Array<[K, T[K]]>;
-    /**EVENTS*/
+    /**
+     * Returns a serializable snapshot representation of this replica.
+     *
+     * Called automatically by `JSON.stringify`.
+     */
+    toJSON(): CRStructSnapshot<T>;
+    /**
+     * Returns this replica as a JSON string.
+     */
+    toString(): string;
+    /**
+     * Iterates over the current live field entries.
+     */
+    [Symbol.iterator](): IterableIterator<[keyof T, T[keyof T]]>;
     /**
      * Registers an event listener.
      *
@@ -198,7 +182,7 @@ declare class OOStruct<T extends Record<string, unknown>> {
      * @param listener - The listener to register.
      * @param options - Listener registration options.
      */
-    addEventListener<K extends keyof OOStructEventMap<T>>(type: K, listener: OOStructEventListenerFor<T, K> | null, options?: boolean | AddEventListenerOptions): void;
+    addEventListener<K extends keyof CRStructEventMap<T>>(type: K, listener: CRStructEventListenerFor<T, K> | null, options?: boolean | AddEventListenerOptions): void;
     /**
      * Removes an event listener.
      *
@@ -206,21 +190,205 @@ declare class OOStruct<T extends Record<string, unknown>> {
      * @param listener - The listener to remove.
      * @param options - Listener removal options.
      */
-    removeEventListener<K extends keyof OOStructEventMap<T>>(type: K, listener: OOStructEventListenerFor<T, K> | null, options?: boolean | EventListenerOptions): void;
-    /**HELPERS*/
-    /**
-     * Overwrites a field and returns the serialized delta entry for that overwrite.
-     *
-     * @param key - The field key to overwrite.
-     * @param value - The next value for the field.
-     * @returns The serialized snapshot entry for the new winning value.
-     */
-    private overwriteAndReturnSnapshotEntry;
+    removeEventListener<K extends keyof CRStructEventMap<T>>(type: K, listener: CRStructEventListenerFor<T, K> | null, options?: boolean | EventListenerOptions): void;
 }
+type CRStruct<T extends Record<string, unknown>> = CRStructRaw<T> & T;
+declare const CRStruct: {
+    new <T extends Record<string, unknown>>(defaults: T, snapshot?: CRStructSnapshot<T>): CRStruct<T>;
+};
 
 /**
  * Error codes thrown by {@link OOStruct}.
  */
-type OOStructErrorCode = 'DEFAULTS_NOT_CLONEABLE' | 'VALUE_NOT_CLONEABLE' | 'VALUE_TYPE_MISMATCH';
+type CRStructErrorCode = 'DEFAULTS_NOT_CLONEABLE' | 'VALUE_NOT_CLONEABLE' | 'VALUE_TYPE_MISMATCH';
+
+/**
+ * Creates internal CR-Struct state from default values and an optional snapshot.
+ *
+ * Default values define the replica field set. Compatible snapshot entries are
+ * parsed into live state entries, and invalid snapshot entries are ignored so
+ * the corresponding field falls back to a freshly initialized default-backed
+ * entry.
+ *
+ * @param defaults - Default field values that define the replica shape.
+ * @param snapshot - Optional serialized state used to hydrate matching fields.
+ *
+ * @returns
+ * A hydrated internal CR-Struct state object.
+ *
+ * @throws {CRStructError} Thrown when the default values are not supported by `structuredClone`.
+ *
+ * Time complexity: O(k + c + s + t), worst case O(k + c + s + t)
+ *
+ * k = default field count
+ * c = total cloned payload size across defaults and accepted snapshot values
+ * s = snapshot entries inspected for matching fields
+ * t = tombstone count materialized for accepted snapshot entries
+ *
+ * Space complexity: O(k + c + t)
+ */
+declare function __create<T extends Record<string, unknown>>(defaults: T, snapshot?: CRStructSnapshot<T>): CRStructState<T>;
+
+/**
+ * Reads and clones the current value of a single field.
+ *
+ * @param key - The field key to read.
+ * @param crStructReplica - The replica state that owns the field.
+ *
+ * @returns
+ * A cloned copy of the field's current value.
+ *
+ * Time complexity: O(c), worst case O(c)
+ *
+ * c = cloned field payload size
+ *
+ * Space complexity: O(c)
+ */
+declare function __read<T extends Record<string, unknown>>(key: keyof T, crStructReplica: CRStructState<T>): T[keyof T];
+
+/**
+ * Overwrites a field with a new value and emits the resulting projections.
+ *
+ * The incoming value is cloned first, validated against the default field
+ * runtime type, and then written back as the current winning value for the
+ * target field.
+ *
+ * @param key - The field key to overwrite.
+ * @param value - The next value for the field.
+ * @param crStructReplica - The replica state that owns the field.
+ *
+ * @returns
+ * The visible change projection and serialized delta for the overwrite.
+ *
+ * @throws {CRStructError} Thrown when the value is not supported by `structuredClone`.
+ * @throws {CRStructError} Thrown when the value runtime type does not match the default value runtime type.
+ *
+ * Time complexity: O(c + t), worst case O(c + t)
+ *
+ * c = cloned and serialized payload size for the updated value
+ * t = tombstone count serialized for the target field
+ *
+ * Space complexity: O(c + t)
+ */
+declare function __update<T extends Record<string, unknown>>(key: keyof T, value: T[keyof T], crStructReplica: CRStructState<T>): {
+    change: CRStructChange<T>;
+    delta: CRStructDelta<T>;
+} | false;
+
+/**
+ * Resets one field or the entire struct back to default values.
+ *
+ * Each touched field is overwritten from the replica defaults and contributes a
+ * visible change projection plus a serialized delta describing the reset.
+ *
+ * @param crStructReplica - The replica state to reset.
+ * @param key - The optional field key to reset. When omitted, every field is reset.
+ *
+ * @returns
+ * The visible change projection and serialized delta for the reset, or `false`
+ * when a keyed reset targets a field outside the replica.
+ *
+ * Time complexity: O(k + c + t), worst case O(k + c + t)
+ *
+ * k = number of fields being reset
+ * c = cloned and serialized payload size across reset field values
+ * t = tombstone count serialized across reset fields
+ *
+ * Space complexity: O(k + c + t)
+ */
+declare function __delete<T extends Record<string, unknown>>(crStructReplica: CRStructState<T>, key?: keyof T): {
+    change: CRStructChange<T>;
+    delta: CRStructDelta<T>;
+} | false;
+
+/**
+ * Merges an incoming delta into the current replica.
+ *
+ * Unknown fields and invalid snapshot entries are ignored. Accepted candidates
+ * extend local tombstone knowledge, may advance the current winning value, and
+ * may emit a return delta when the local state already dominates the incoming
+ * entry.
+ *
+ * @param crStructDelta - The incoming partial snapshot projection to merge.
+ * @param crStructReplica - The local replica state to merge into.
+ *
+ * @returns
+ * The visible change projection and reply delta, or `false` when the input is
+ * invalid or produces no outbound effect.
+ *
+ * Time complexity: O(d + l + i + c), worst case O(d + l + i + c)
+ *
+ * d = incoming delta field count
+ * l = local tombstone count processed across touched fields
+ * i = incoming tombstone count processed across accepted delta entries
+ * c = cloned and serialized payload size across emitted changes and reply deltas
+ *
+ * Space complexity: O(d + l + c)
+ */
+declare function __merge<T extends Record<string, unknown>>(crStructDelta: CRStructDelta<T>, crStructReplica: CRStructState<T>): {
+    change: CRStructChange<T>;
+    delta: CRStructDelta<T>;
+} | false;
+
+/**
+ * Emits the current acknowledgement frontier for each field.
+ *
+ * Each field reports the largest tombstone identifier currently known for that
+ * field.
+ *
+ * @param crStructReplica - The replica state to summarize.
+ *
+ * @returns
+ * An acknowledgement frontier keyed by field name.
+ *
+ * Time complexity: O(k + t), worst case O(k + t)
+ *
+ * k = replica field count
+ * t = total tombstone count across all fields
+ *
+ * Space complexity: O(k)
+ */
+declare function __acknowledge<T extends Record<string, unknown>>(crStructReplica: CRStructState<T>): CRStructAck<T> | false;
+
+/**
+ * Removes overwritten identifiers that every provided frontier has acknowledged.
+ *
+ * The smallest valid acknowledgement per field is collected first, then local
+ * tombstones at or below that frontier are removed while keeping the current
+ * predecessor identifier intact.
+ *
+ * @param frontiers - A collection of acknowledgement frontiers to compact against.
+ * @param crStructReplica - The replica state to compact.
+ *
+ * Time complexity: O(a + t), worst case O(a + t)
+ *
+ * a = acknowledgement entries scanned across all provided frontiers
+ * t = tombstone count scanned across compacted fields
+ *
+ * Space complexity: O(k)
+ *
+ * k = fields that receive a valid acknowledgement frontier
+ */
+declare function __garbageCollect<T extends Record<string, unknown>>(frontiers: Array<CRStructAck<T>>, crStructReplica: CRStructState<T>): void;
+
+/**
+ * Serializes the current replica state into a snapshot projection.
+ *
+ * Each processed state entry is converted into its serializable snapshot form.
+ *
+ * @param crStructReplica - The replica state to serialize.
+ *
+ * @returns
+ * A serializable snapshot projection of the replica state.
+ *
+ * Time complexity: O(k + t + c), worst case O(k + t + c)
+ *
+ * k = state entry count processed by the serializer
+ * t = tombstone count serialized across processed entries
+ * c = serialized payload size across processed values
+ *
+ * Space complexity: O(k + t + c)
+ */
+declare function __snapshot<T extends Record<string, unknown>>(crStructReplica: CRStructState<T>): CRStructSnapshot<T>;
 
-export { OOStruct, type OOStructAck, type OOStructAcknowledgementFrontier, type OOStructChange, type OOStructDelta, type OOStructErrorCode, type OOStructEventListener, type OOStructEventListenerFor, type OOStructEventMap, type OOStructSnapshot, type OOStructSnapshotEntry, type OOStructState, type OOStructStateEntry };
+export { CRStruct, type CRStructAck, type CRStructChange, type CRStructDelta, type CRStructErrorCode, type CRStructEventListener, type CRStructEventListenerFor, type CRStructEventMap, type CRStructSnapshot, type CRStructSnapshotEntry, type CRStructState, type CRStructStateEntry, __acknowledge, __create, __delete, __garbageCollect, __merge, __read, __snapshot, __update };