npm - @sovereignbase/convergent-replicated-struct - Versions diffs - 0.0.0 → 1.0.1 - Mend

@sovereignbase/convergent-replicated-struct 0.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/LICENSE CHANGED Viewed

@@ -1,201 +1,201 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-   1. Definitions.
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-   END OF TERMS AND CONDITIONS
-   APPENDIX: How to apply the Apache License to your work.
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-   Copyright [yyyy] [name of copyright owner]
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-       http://www.apache.org/licenses/LICENSE-2.0
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+   1. Definitions.
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+   END OF TERMS AND CONDITIONS
+   APPENDIX: How to apply the Apache License to your work.
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+   Copyright [yyyy] [name of copyright owner]
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md CHANGED Viewed

@@ -1,271 +1,271 @@
-[![npm version](https://img.shields.io/npm/v/@sovereignbase/convergent-replicated-struct)](https://www.npmjs.com/package/@sovereignbase/convergent-replicated-struct)
-[![CI](https://github.com/sovereignbase/convergent-replicated-struct/actions/workflows/ci.yaml/badge.svg?branch=master)](https://github.com/sovereignbase/convergent-replicated-struct/actions/workflows/ci.yaml)
-[![codecov](https://codecov.io/gh/sovereignbase/convergent-replicated-struct/branch/master/graph/badge.svg)](https://codecov.io/gh/sovereignbase/convergent-replicated-struct)
-[![license](https://img.shields.io/npm/l/@sovereignbase/convergent-replicated-struct)](LICENSE)
-# convergent-replicated-struct
-State-based CRDT for fixed-key object structs with per-field overwrite tracking.
-## Compatibility
-- Runtimes: Node >= 20; modern browsers; Bun; Deno; Cloudflare Workers; Edge Runtime.
-- Module format: ESM + CommonJS.
-- Required globals / APIs: `EventTarget`, `CustomEvent`, `structuredClone`.
-- TypeScript: bundled types.
-## Goals
-- Fixed-key replica shape defined by a default struct.
-- One visible value per field at any time.
-- Malformed ingress is ignored during hydration and merge instead of crashing the replica.
-- `read()`, `values()`, `entries()`, snapshots, deltas, and change payloads are detached with `structuredClone`.
-- Explicit `acknowledge()` and `garbageCollect()` APIs for overwrite-history compaction.
-- Consistent behavior across Node, browsers, and worker/edge runtimes.
-## Installation
-```sh
-npm install @sovereignbase/convergent-replicated-struct
-# or
-pnpm add @sovereignbase/convergent-replicated-struct
-# or
-yarn add @sovereignbase/convergent-replicated-struct
-# or
-bun add @sovereignbase/convergent-replicated-struct
-# or
-deno add jsr:@sovereignbase/convergent-replicated-struct
-# or
-vlt install jsr:@sovereignbase/convergent-replicated-struct
-```
-## Usage
-### Copy-paste example
-```ts
-import { OOStruct } from '@sovereignbase/convergent-replicated-struct'
-type TodoStruct = {
-  title: string
-  count: number
-  meta: { done: boolean }
-  tags: string[]
-}
-const alice = OOStruct.create<TodoStruct>({
-  title: '',
-  count: 0,
-  meta: { done: false },
-  tags: [],
-})
-const bob = OOStruct.create<TodoStruct>({
-  title: '',
-  count: 0,
-  meta: { done: false },
-  tags: [],
-})
-alice.addEventListener('delta', (event) => bob.merge(event.detail))
-alice.update('title', 'hello world')
-alice.update('meta', { done: true })
-console.log(bob.read('title')) // "hello world"
-console.log(bob.read('meta')) // { done: true }
-```
-### Hydrating from a snapshot
-```ts
-import {
-  OOStruct,
-  type OOStructSnapshot,
-} from '@sovereignbase/convergent-replicated-struct'
-type DraftStruct = {
-  title: string
-  count: number
-}
-const source = new OOStruct<DraftStruct>({
-  title: '',
-  count: 0,
-})
-let snapshot!: OOStructSnapshot<DraftStruct>
-source.addEventListener(
-  'snapshot',
-  (event) => {
-    snapshot = event.detail
-  },
-  { once: true }
-)
-source.update('title', 'draft')
-source.snapshot()
-const restored = OOStruct.create<DraftStruct>(
-  {
-    title: '',
-    count: 0,
-  },
-  snapshot
-)
-console.log(restored.entries()) // [['title', 'draft'], ['count', 0]]
-```
-### Event channels
-```ts
-import { OOStruct } from '@sovereignbase/convergent-replicated-struct'
-const replica = new OOStruct({
-  name: '',
-  count: 0,
-})
-replica.addEventListener('delta', (event) => {
-  console.log('delta', event.detail)
-})
-replica.addEventListener('change', (event) => {
-  console.log('change', event.detail)
-})
-replica.addEventListener('ack', (event) => {
-  console.log('ack', event.detail)
-})
-replica.addEventListener('snapshot', (event) => {
-  console.log('snapshot', event.detail)
-})
-```
-### Acknowledgements and garbage collection
-```ts
-import {
-  OOStruct,
-  type OOStructAck,
-} from '@sovereignbase/convergent-replicated-struct'
-type CounterStruct = {
-  title: string
-  count: number
-}
-const left = new OOStruct<CounterStruct>({
-  title: '',
-  count: 0,
-})
-const right = new OOStruct<CounterStruct>({
-  title: '',
-  count: 0,
-})
-const frontiers: Array<OOStructAck<CounterStruct>> = []
-left.addEventListener(
-  'ack',
-  (event) => {
-    frontiers.push(event.detail)
-  },
-  { once: true }
-)
-right.addEventListener(
-  'ack',
-  (event) => {
-    frontiers.push(event.detail)
-  },
-  { once: true }
-)
-left.acknowledge()
-right.acknowledge()
-left.garbageCollect(frontiers)
-right.garbageCollect(frontiers)
-```
-## Runtime behavior
-### Validation and errors
-Local API misuse throws `OOStructError` with stable error codes:
-- `DEFAULTS_NOT_CLONEABLE`
-- `VALUE_NOT_CLONEABLE`
-- `VALUE_TYPE_MISMATCH`
-Hydration and merge are ingress-tolerant: malformed top-level payloads, unknown keys, malformed field entries, invalid UUIDs, invalid overwrite members, and mismatched runtime kinds are ignored instead of throwing.
-### Safety and copying semantics
-- Constructor defaults must be `structuredClone`-compatible.
-- `read()`, `values()`, and `entries()` return detached clones.
-- `delta`, `change`, and `snapshot` event payloads are detached from live state.
-- `update()` stores a cloned value, so later caller-side mutation does not mutate replica state through shared references.
-### Convergence and compaction
-- The convergence guarantee is the resolved live struct state.
-- Internal overwrite history may differ between replicas after acknowledgement-based garbage collection while the resolved live state still converges.
-- `garbageCollect()` compacts overwritten identifiers that are below the smallest acknowledgement frontier for a key while preserving the active predecessor link.
-## Tests
-- Suite: unit, integration, and end-to-end runtime tests.
-- Node test runner: `node --test` for unit and integration suites.
-- Coverage: `c8` with 100% statements / branches / functions / lines on built `dist/**/*.js`.
-- E2E runtimes: Node ESM, Node CJS, Bun ESM, Bun CJS, Deno ESM, Cloudflare Workers ESM, Edge Runtime ESM.
-- Browser E2E: Chromium, Firefox, WebKit, mobile Chrome, mobile Safari via Playwright.
-- Current status: `npm run test` passes on Node 22.14.0 (`win32 x64`).
-## Benchmarks
-How it was run:
-```sh
-node benchmark/bench.js
-```
-Environment: Node 22.14.0 (`win32 x64`)
-| Benchmark                     | Result                    |
-| ----------------------------- | ------------------------- |
-| constructor empty             | 44,359 ops/s (2254.3 ms)  |
-| constructor hydrate x64       | 19,610 ops/s (255.0 ms)   |
-| constructor hydrate x256      | 8,088 ops/s (247.3 ms)    |
-| constructor hydrate x1024     | 1,724 ops/s (290.0 ms)    |
-| create() empty                | 49,874 ops/s (2005.1 ms)  |
-| create() hydrate x256         | 6,886 ops/s (290.4 ms)    |
-| read primitive                | 846,289 ops/s (236.3 ms)  |
-| read object                   | 298,983 ops/s (668.9 ms)  |
-| read array                    | 278,710 ops/s (717.6 ms)  |
-| keys()                        | 32,349,896 ops/s (6.2 ms) |
-| values()                      | 103,489 ops/s (966.3 ms)  |
-| entries()                     | 110,300 ops/s (906.6 ms)  |
-| snapshot()                    | 65,513 ops/s (305.3 ms)   |
-| acknowledge()                 | 536,890 ops/s (93.1 ms)   |
-| update string                 | 29,547 ops/s (1692.2 ms)  |
-| update number                 | 30,591 ops/s (1634.5 ms)  |
-| update object                 | 22,114 ops/s (2261.0 ms)  |
-| update array                  | 24,763 ops/s (2019.1 ms)  |
-| delete(key)                   | 8,352 ops/s (5986.8 ms)   |
-| delete() reset all            | 6,836 ops/s (2925.5 ms)   |
-| merge direct successor        | 32,541 ops/s (1536.5 ms)  |
-| merge stale conflict          | 30,995 ops/s (645.3 ms)   |
-| merge hydrate snapshot x256   | 5,748 ops/s (869.9 ms)    |
-| merge noop duplicate          | 7,576 ops/s (6600.1 ms)   |
-| garbageCollect() x512 history | 3,111 ops/s (1607.0 ms)   |
-| add/remove listener roundtrip | 49,005 ops/s (4081.2 ms)  |
-| update with listeners         | 25,120 ops/s (1194.3 ms)  |
-| merge with listeners          | 31,649 ops/s (631.9 ms)   |
-Results vary by machine, runtime version, and payload shape.
-## License
-Apache-2.0
+[![npm version](https://img.shields.io/npm/v/@sovereignbase/convergent-replicated-struct)](https://www.npmjs.com/package/@sovereignbase/convergent-replicated-struct)
+[![CI](https://github.com/sovereignbase/convergent-replicated-struct/actions/workflows/ci.yaml/badge.svg?branch=master)](https://github.com/sovereignbase/convergent-replicated-struct/actions/workflows/ci.yaml)
+[![codecov](https://codecov.io/gh/sovereignbase/convergent-replicated-struct/branch/master/graph/badge.svg)](https://codecov.io/gh/sovereignbase/convergent-replicated-struct)
+[![license](https://img.shields.io/npm/l/@sovereignbase/convergent-replicated-struct)](LICENSE)
+# convergent-replicated-struct
+State-based CRDT for fixed-key object structs with per-field overwrite tracking.
+## Compatibility
+- Runtimes: Node >= 20; modern browsers; Bun; Deno; Cloudflare Workers; Edge Runtime.
+- Module format: ESM + CommonJS.
+- Required globals / APIs: `EventTarget`, `CustomEvent`, `structuredClone`.
+- TypeScript: bundled types.
+## Goals
+- Fixed-key replica shape defined by a default struct.
+- One visible value per field at any time.
+- Malformed ingress is ignored during hydration and merge instead of crashing the replica.
+- `read()`, `values()`, `entries()`, snapshots, deltas, and change payloads are detached with `structuredClone`.
+- Explicit `acknowledge()` and `garbageCollect()` APIs for overwrite-history compaction.
+- Consistent behavior across Node, browsers, and worker/edge runtimes.
+## Installation
+```sh
+npm install @sovereignbase/convergent-replicated-struct
+# or
+pnpm add @sovereignbase/convergent-replicated-struct
+# or
+yarn add @sovereignbase/convergent-replicated-struct
+# or
+bun add @sovereignbase/convergent-replicated-struct
+# or
+deno add jsr:@sovereignbase/convergent-replicated-struct
+# or
+vlt install jsr:@sovereignbase/convergent-replicated-struct
+```
+## Usage
+### Copy-paste example
+```ts
+import { OOStruct } from '@sovereignbase/convergent-replicated-struct'
+type TodoStruct = {
+  title: string
+  count: number
+  meta: { done: boolean }
+  tags: string[]
+}
+const alice = OOStruct.create<TodoStruct>({
+  title: '',
+  count: 0,
+  meta: { done: false },
+  tags: [],
+})
+const bob = OOStruct.create<TodoStruct>({
+  title: '',
+  count: 0,
+  meta: { done: false },
+  tags: [],
+})
+alice.addEventListener('delta', (event) => bob.merge(event.detail))
+alice.update('title', 'hello world')
+alice.update('meta', { done: true })
+console.log(bob.read('title')) // "hello world"
+console.log(bob.read('meta')) // { done: true }
+```
+### Hydrating from a snapshot
+```ts
+import {
+  OOStruct,
+  type OOStructSnapshot,
+} from '@sovereignbase/convergent-replicated-struct'
+type DraftStruct = {
+  title: string
+  count: number
+}
+const source = new OOStruct<DraftStruct>({
+  title: '',
+  count: 0,
+})
+let snapshot!: OOStructSnapshot<DraftStruct>
+source.addEventListener(
+  'snapshot',
+  (event) => {
+    snapshot = event.detail
+  },
+  { once: true }
+)
+source.update('title', 'draft')
+source.snapshot()
+const restored = OOStruct.create<DraftStruct>(
+  {
+    title: '',
+    count: 0,
+  },
+  snapshot
+)
+console.log(restored.entries()) // [['title', 'draft'], ['count', 0]]
+```
+### Event channels
+```ts
+import { OOStruct } from '@sovereignbase/convergent-replicated-struct'
+const replica = new OOStruct({
+  name: '',
+  count: 0,
+})
+replica.addEventListener('delta', (event) => {
+  console.log('delta', event.detail)
+})
+replica.addEventListener('change', (event) => {
+  console.log('change', event.detail)
+})
+replica.addEventListener('ack', (event) => {
+  console.log('ack', event.detail)
+})
+replica.addEventListener('snapshot', (event) => {
+  console.log('snapshot', event.detail)
+})
+```
+### Acknowledgements and garbage collection
+```ts
+import {
+  OOStruct,
+  type OOStructAck,
+} from '@sovereignbase/convergent-replicated-struct'
+type CounterStruct = {
+  title: string
+  count: number
+}
+const left = new OOStruct<CounterStruct>({
+  title: '',
+  count: 0,
+})
+const right = new OOStruct<CounterStruct>({
+  title: '',
+  count: 0,
+})
+const frontiers: Array<OOStructAck<CounterStruct>> = []
+left.addEventListener(
+  'ack',
+  (event) => {
+    frontiers.push(event.detail)
+  },
+  { once: true }
+)
+right.addEventListener(
+  'ack',
+  (event) => {
+    frontiers.push(event.detail)
+  },
+  { once: true }
+)
+left.acknowledge()
+right.acknowledge()
+left.garbageCollect(frontiers)
+right.garbageCollect(frontiers)
+```
+## Runtime behavior
+### Validation and errors
+Local API misuse throws `OOStructError` with stable error codes:
+- `DEFAULTS_NOT_CLONEABLE`
+- `VALUE_NOT_CLONEABLE`
+- `VALUE_TYPE_MISMATCH`
+Hydration and merge are ingress-tolerant: malformed top-level payloads, unknown keys, malformed field entries, invalid UUIDs, invalid overwrite members, and mismatched runtime kinds are ignored instead of throwing.
+### Safety and copying semantics
+- Constructor defaults must be `structuredClone`-compatible.
+- `read()`, `values()`, and `entries()` return detached clones.
+- `delta`, `change`, and `snapshot` event payloads are detached from live state.
+- `update()` stores a cloned value, so later caller-side mutation does not mutate replica state through shared references.
+### Convergence and compaction
+- The convergence guarantee is the resolved live struct state.
+- Internal overwrite history may differ between replicas after acknowledgement-based garbage collection while the resolved live state still converges.
+- `garbageCollect()` compacts overwritten identifiers that are below the smallest acknowledgement frontier for a key while preserving the active predecessor link.
+## Tests
+- Suite: unit, integration, and end-to-end runtime tests.
+- Node test runner: `node --test` for unit and integration suites.
+- Coverage: `c8` with 100% statements / branches / functions / lines on built `dist/**/*.js`.
+- E2E runtimes: Node ESM, Node CJS, Bun ESM, Bun CJS, Deno ESM, Cloudflare Workers ESM, Edge Runtime ESM.
+- Browser E2E: Chromium, Firefox, WebKit, mobile Chrome, mobile Safari via Playwright.
+- Current status: `npm run test` passes on Node 22.14.0 (`win32 x64`).
+## Benchmarks
+How it was run:
+```sh
+node benchmark/bench.js
+```
+Environment: Node 22.14.0 (`win32 x64`)
+| Benchmark                     | Result                    |
+| ----------------------------- | ------------------------- |
+| constructor empty             | 44,359 ops/s (2254.3 ms)  |
+| constructor hydrate x64       | 19,610 ops/s (255.0 ms)   |
+| constructor hydrate x256      | 8,088 ops/s (247.3 ms)    |
+| constructor hydrate x1024     | 1,724 ops/s (290.0 ms)    |
+| create() empty                | 49,874 ops/s (2005.1 ms)  |
+| create() hydrate x256         | 6,886 ops/s (290.4 ms)    |
+| read primitive                | 846,289 ops/s (236.3 ms)  |
+| read object                   | 298,983 ops/s (668.9 ms)  |
+| read array                    | 278,710 ops/s (717.6 ms)  |
+| keys()                        | 32,349,896 ops/s (6.2 ms) |
+| values()                      | 103,489 ops/s (966.3 ms)  |
+| entries()                     | 110,300 ops/s (906.6 ms)  |
+| snapshot()                    | 65,513 ops/s (305.3 ms)   |
+| acknowledge()                 | 536,890 ops/s (93.1 ms)   |
+| update string                 | 29,547 ops/s (1692.2 ms)  |
+| update number                 | 30,591 ops/s (1634.5 ms)  |
+| update object                 | 22,114 ops/s (2261.0 ms)  |
+| update array                  | 24,763 ops/s (2019.1 ms)  |
+| delete(key)                   | 8,352 ops/s (5986.8 ms)   |
+| delete() reset all            | 6,836 ops/s (2925.5 ms)   |
+| merge direct successor        | 32,541 ops/s (1536.5 ms)  |
+| merge stale conflict          | 30,995 ops/s (645.3 ms)   |
+| merge hydrate snapshot x256   | 5,748 ops/s (869.9 ms)    |
+| merge noop duplicate          | 7,576 ops/s (6600.1 ms)   |
+| garbageCollect() x512 history | 3,111 ops/s (1607.0 ms)   |
+| add/remove listener roundtrip | 49,005 ops/s (4081.2 ms)  |
+| update with listeners         | 25,120 ops/s (1194.3 ms)  |
+| merge with listeners          | 31,649 ops/s (631.9 ms)   |
+Results vary by machine, runtime version, and payload shape.
+## License
+Apache-2.0

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["c:\\Users\\jorts\\convergent-replicated-struct\\dist\\index.cjs"],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,4BAAmC;AACnC;AACA;AACA,IAAI,cAAc,EAAE,MAAM,QAAQ,MAAM;AACxC;AACA;AACA;AACA,EAAE;AACF;AACA;AACA;AACA;AACA;AACA;AACA,EAAE,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE;AAC7B,IAAI,MAAM,OAAO,mBAAE,OAAQ,UAAG,MAAI;AAClC,IAAI,KAAK,CAAC,CAAC,2CAA2C,EAAE,MAAM,CAAC,CAAA;AACA,IAAA;AACA,IAAA;AACA,EAAA;AACA;AACA;AACA;AACA;AACA;AACA,EAAA;AACA,IAAA;AACA,EAAA;AACA,EAAA;AACA,IAAA;AACA,EAAA;AACA,EAAA;AACA,IAAA;AACA,MAAA;AACA,IAAA;AACA,EAAA;AACA,EAAA;AACA,EAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,EAAA;AACA;AACA;AACA;AACA;AACA,EAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,EAAA;AACA;AACA;AACA;AACA;AACA;AACA,iBAAA;AACA,EAAA;AACA,EAAA;AACA,EAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAA;AACA,IAAA;AACA,IAAA;AACA,MAAA;AACA,QAAA;AACA,QAAA;AACA,MAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,MAAA;AACA,MAAA;AACA,QAAA;AACA,UAAA;AACA,UAAA;AACA,QAAA;AACA,QAAA;AACA,UAAA;AACA,UAAA;AACA,UAAA;AACA,QAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACA,MAAA;AACA,IAAA;AACA,EAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAA;AACA,IAAA;AACA,EAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAA;AACA,IAAA;AACA,EAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAA;AACA,IAAA;AACA,IAAA;AACA,MAAA;AACA,QAAA;AACA,QAAA;AACA,MAAA;AACA,IAAA;AACA,MAAA;AACA,QAAA;AACA,QAAA;AACA,MAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,MAAA;AACA,IAAA;AACA,IAAA;AACA,MAAA;AACA,IAAA;AACA,EAAA;AACA;AACA;AACA;AACA;AACA;AACA,EAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,IAAA;AACA,MAAA;AACA,QAAA;AACA,UAAA;AACA,UAAA;AACA,QAAA;AACA,QAAA;AACA,MAAA;AACA,IAAA;AACA,IAAA;AACA,MAAA;AACA,IAAA;AACA,IAAA;AACA,MAAA;AACA,IAAA;AACA,EAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAA;AACA,IAAA;AACA,MAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,MAAA;AACA,MAAA;AACA,QAAA;AACA,QAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,QAAA;AACA,MAAA;AACA,MAAA;AACA,QAAA;AACA,UAAA;AACA,QAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,QAAA;AACA,UAAA;AACA,UAAA;AACA,UAAA;AACA,UAAA;AACA,UAAA;AACA,UAAA;AACA,QAAA;AACA,UAAA;AACA,YAAA;AACA,YAAA;AACA,UAAA;AACA,UAAA;AACA,QAAA;AACA,QAAA;AACA,MAAA;AACA,MAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,IAAA;AACA,IAAA;AACA,MAAA;AACA,QAAA;AACA,MAAA;AACA,IAAA;AACA,MAAA;AACA,QAAA;AACA,MAAA;AACA,EAAA;AACA;AACA;AACA;AACA,EAAA;AACA,IAAA;AACA,IAAA;AACA,MAAA;AACA,MAAA;AACA,QAAA;AACA,MAAA;AACA,MAAA;AACA,IAAA;AACA,IAAA;AACA,EAAA;AACA;AACA;AACA;AACA;AACA;AACA,EAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,MAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACA,MAAA;AACA,IAAA;AACA,IAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,QAAA;AACA,QAAA;AACA,MAAA;AACA,IAAA;AACA,EAAA;AACA;AACA;AACA;AACA,EAAA;AACA,IAAA;AACA,IAAA;AACA,MAAA;AACA,QAAA;AACA,MAAA;AACA,IAAA;AACA,IAAA;AACA,MAAA;AACA,IAAA;AACA,EAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAA;AACA,IAAA;AACA,EAAA;AACA;AACA;AACA;AACA;AACA;AACA,EAAA;AACA,IAAA;AACA,MAAA;AACA,IAAA;AACA,EAAA;AACA;AACA;AACA;AACA;AACA;AACA,EAAA;AACA,IAAA;AACA,MAAA;AACA,MAAA;AACA,IAAA;AACA,EAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAA;AACA,IAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,IAAA;AACA,EAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAA;AACA,IAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,IAAA;AACA,EAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,EAAA;AACA;AACA;AACA;AACA","file":"C:\\Users\\jorts\\convergent-replicated-struct\\dist\\index.cjs","sourcesContent":[null]}
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"]}

package/package.json CHANGED Viewed

@@ -1,89 +1,89 @@
-{
-  "type": "module",
-  "license": "Apache-2.0",
-  "name": "@sovereignbase/convergent-replicated-struct",
-  "version": "0.0.0",
-  "description": "State-based CRDT for fixed-key object structs with per-field overwrite tracking.",
-  "keywords": [
-    "crdt",
-    "state-based-crdt",
-    "eventual-consistency",
-    "local-first",
-    "replication",
-    "convergent-replicated-struct",
-    "cr-struct",
-    "uuidv7",
-    "lww-register",
-    "delta",
-    "snapshot",
-    "typescript"
-  ],
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs",
-      "default": "./dist/index.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "files": [
-    "dist",
-    "LICENSE",
-    "README.md"
-  ],
-  "sideEffects": false,
-  "scripts": {
-    "format": "prettier . --write",
-    "build": "tsup",
-    "test": "npm run build && node test/run-coverage.mjs && node test/e2e/run.mjs",
-    "bench": "npm run build && node benchmark/bench.js",
-    "prepare": "husky",
-    "prepublishOnly": "npm run test && npm run bench"
-  },
-  "c8": {
-    "all": true,
-    "include": [
-      "dist/**/*.js"
-    ],
-    "exclude": [
-      "dist/**/*.d.ts",
-      "test/**",
-      "benchmark/**",
-      "playwright.config.ts"
-    ]
-  },
-  "devDependencies": {
-    "@commitlint/cli": "^20.5.0",
-    "@commitlint/config-conventional": "^20.5.0",
-    "@playwright/test": "^1.59.1",
-    "@types/node": "^25.5.0",
-    "c8": "^11.0.0",
-    "edge-runtime": "^4.0.1",
-    "fast-glob": "^3.3.3",
-    "husky": "^9.1.7",
-    "playwright": "^1.59.1",
-    "prettier": "^3.8.1",
-    "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
-    "wrangler": "^4.79.0"
-  },
-  "dependencies": {
-    "@sovereignbase/utils": "^1.1.0",
-    "uuid": "^13.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/sovereignbase/convergent-replicated-struct.git"
-  },
-  "bugs": {
-    "url": "https://github.com/sovereignbase/convergent-replicated-struct/issues"
-  },
-  "homepage": "https://sovereignbase.github.io/convergent-replicated-struct"
-}
+{
+  "type": "module",
+  "license": "Apache-2.0",
+  "name": "@sovereignbase/convergent-replicated-struct",
+  "version": "1.0.1",
+  "description": "State-based CRDT for fixed-key object structs with per-field overwrite tracking.",
+  "keywords": [
+    "crdt",
+    "state-based-crdt",
+    "eventual-consistency",
+    "local-first",
+    "replication",
+    "convergent-replicated-struct",
+    "cr-struct",
+    "uuidv7",
+    "lww-register",
+    "delta",
+    "snapshot",
+    "typescript"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "format": "prettier . --write",
+    "build": "tsup",
+    "test": "npm run build && node test/run-coverage.mjs && node test/e2e/run.mjs",
+    "bench": "npm run build && node benchmark/bench.js",
+    "prepare": "husky",
+    "prepublishOnly": "npm run test && npm run bench"
+  },
+  "c8": {
+    "all": true,
+    "include": [
+      "dist/**/*.js"
+    ],
+    "exclude": [
+      "dist/**/*.d.ts",
+      "test/**",
+      "benchmark/**",
+      "playwright.config.ts"
+    ]
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.5.0",
+    "@commitlint/config-conventional": "^20.5.0",
+    "@playwright/test": "^1.59.1",
+    "@types/node": "^25.5.0",
+    "c8": "^11.0.0",
+    "edge-runtime": "^4.0.1",
+    "fast-glob": "^3.3.3",
+    "husky": "^9.1.7",
+    "playwright": "^1.59.1",
+    "prettier": "^3.8.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "wrangler": "^4.79.0"
+  },
+  "dependencies": {
+    "@sovereignbase/utils": "^1.1.0",
+    "uuid": "^13.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sovereignbase/convergent-replicated-struct.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sovereignbase/convergent-replicated-struct/issues"
+  },
+  "homepage": "https://sovereignbase.github.io/convergent-replicated-struct"
+}