jazz-tools 0.17.4 → 0.17.5

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> jazz-tools@0.17.4 build /home/runner/_work/jazz/jazz/packages/jazz-tools
+> jazz-tools@0.17.5 build /home/runner/_work/jazz/jazz/packages/jazz-tools
 > tsup && pnpm types && pnpm build:svelte
 
 CLI Building entry: {"index":"src/index.ts","testing":"src/testing.ts"}
@@ -100,84 +100,84 @@
 ESM Build start
 CLI Cleaning output folder
 ESM Build start
-ESM dist/worker/index.js     2.31 KB
-ESM dist/worker/index.js.map 4.77 KB
-ESM ⚡️ Build success in 17ms
 ESM dist/react/ssr.js     688.00 B
 ESM dist/react/ssr.js.map 1.12 KB
-ESM ⚡️ Build success in 19ms
+ESM ⚡️ Build success in 18ms
+ESM dist/worker/index.js     2.31 KB
+ESM dist/worker/index.js.map 4.77 KB
+ESM ⚡️ Build success in 15ms
 ESM dist/tiptap/index.js     564.00 B
 ESM dist/tiptap/index.js.map 1.21 KB
-ESM ⚡️ Build success in 17ms
+ESM ⚡️ Build success in 15ms
 ESM dist/media/index.js              236.00 B
 ESM dist/media/index.browser.js      3.21 KB
 ESM dist/media/chunk-JBLT443O.js     6.33 KB
 ESM dist/media/index.native.js       3.53 KB
 ESM dist/media/index.js.map          71.00 B
-ESM dist/media/index.browser.js.map  6.02 KB
 ESM dist/media/chunk-JBLT443O.js.map 15.68 KB
 ESM dist/media/index.native.js.map   6.52 KB
-ESM ⚡️ Build success in 22ms
+ESM dist/media/index.browser.js.map  6.02 KB
+ESM ⚡️ Build success in 21ms
+ESM dist/react-native/index.js       2.53 KB
+ESM dist/react-native/testing.js     120.00 B
+ESM dist/react-native/crypto.js      161.00 B
+ESM dist/react-native/index.js.map   5.68 KB
+ESM dist/react-native/testing.js.map 176.00 B
+ESM dist/react-native/crypto.js.map  197.00 B
+ESM ⚡️ Build success in 19ms
 ESM dist/browser/index.js     13.43 KB
 ESM dist/browser/index.js.map 28.65 KB
-ESM ⚡️ Build success in 27ms
-ESM dist/expo/index.js       4.65 KB
-ESM dist/expo/crypto.js      153.00 B
-ESM dist/expo/testing.js     112.00 B
-ESM dist/expo/index.js.map   10.17 KB
-ESM dist/expo/crypto.js.map  189.00 B
-ESM dist/expo/testing.js.map 168.00 B
-ESM ⚡️ Build success in 27ms
+ESM ⚡️ Build success in 33ms
 ESM dist/react-core/index.js              8.41 KB
 ESM dist/react-core/testing.js            1.17 KB
 ESM dist/react-core/chunk-7DYMJ74I.js     279.00 B
 ESM dist/react-core/index.js.map          20.68 KB
 ESM dist/react-core/testing.js.map        1.82 KB
 ESM dist/react-core/chunk-7DYMJ74I.js.map 533.00 B
-ESM ⚡️ Build success in 27ms
-ESM dist/react-native/index.js       2.53 KB
-ESM dist/react-native/testing.js     120.00 B
-ESM dist/react-native/crypto.js      161.00 B
-ESM dist/react-native/index.js.map   5.68 KB
-ESM dist/react-native/testing.js.map 176.00 B
-ESM dist/react-native/crypto.js.map  197.00 B
 ESM ⚡️ Build success in 29ms
 ESM dist/react/testing.js     122.00 B
 ESM dist/react/index.js       24.55 KB
 ESM dist/react/testing.js.map 165.00 B
 ESM dist/react/index.js.map   52.42 KB
-ESM ⚡️ Build success in 37ms
+ESM ⚡️ Build success in 30ms
 ESM dist/react-native-core/index.js       17.90 KB
 ESM dist/react-native-core/testing.js     119.00 B
 ESM dist/react-native-core/crypto.js      2.10 KB
 ESM dist/react-native-core/index.js.map   36.65 KB
 ESM dist/react-native-core/testing.js.map 175.00 B
 ESM dist/react-native-core/crypto.js.map  4.25 KB
-ESM ⚡️ Build success in 35ms
+ESM ⚡️ Build success in 32ms
+ESM dist/expo/index.js       4.65 KB
+ESM dist/expo/crypto.js      153.00 B
+ESM dist/expo/testing.js     112.00 B
+ESM dist/expo/index.js.map   10.17 KB
+ESM dist/expo/crypto.js.map  189.00 B
+ESM dist/expo/testing.js.map 168.00 B
+ESM ⚡️ Build success in 37ms
 ESM dist/prosemirror/index.js     76.90 KB
 ESM dist/prosemirror/index.js.map 305.53 KB
 ESM ⚡️ Build success in 44ms
 ESM dist/inspector/index.js     60.40 KB
 ESM dist/inspector/index.js.map 107.91 KB
-ESM ⚡️ Build success in 54ms
+ESM ⚡️ Build success in 55ms
 ESM dist/index.js              25.96 KB
 ESM dist/testing.js            6.76 KB
-ESM dist/chunk-NPXI4XAS.js     150.66 KB
-ESM dist/testing.js.map        13.07 KB
+ESM dist/chunk-EEKKLGF2.js     153.53 KB
 ESM dist/index.js.map          52.62 KB
-ESM dist/chunk-NPXI4XAS.js.map 361.51 KB
-ESM ⚡️ Build success in 73ms
+ESM dist/testing.js.map        13.07 KB
+ESM dist/chunk-EEKKLGF2.js.map 368.10 KB
+ESM ⚡️ Build success in 71ms
 ESM dist/inspector/register-custom-element.js     218.00 B
 ESM dist/inspector/register-custom-element.js.map 314.00 B
 ESM dist/inspector/custom-element-I7L56H6B.js     1.53 MB
 ESM dist/inspector/custom-element-I7L56H6B.js.map 2.35 MB
-ESM ⚡️ Build success in 110ms
+ESM ⚡️ Build success in 107ms
 
-> jazz-tools@0.17.4 types /home/runner/_work/jazz/jazz/packages/jazz-tools
+> jazz-tools@0.17.5 types /home/runner/_work/jazz/jazz/packages/jazz-tools
 > tsc --outDir dist
 
 
-> jazz-tools@0.17.4 build:svelte /home/runner/_work/jazz/jazz/packages/jazz-tools
+> jazz-tools@0.17.5 build:svelte /home/runner/_work/jazz/jazz/packages/jazz-tools
 > rm -rf dist/svelte && svelte-package -i src/svelte -o dist/svelte --tsconfig tsconfig.svelte.json
 
 src/svelte -> dist/svelte

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # jazz-tools
 
+## 0.17.5
+
+### Patch Changes
+
+- 5963658: Implement/expose loadUnique and upsertUnique on co.list and co.record
+- Updated dependencies [71c1411]
+- Updated dependencies [2d11d44]
+  - cojson@0.17.5
+  - cojson-storage-indexeddb@0.17.5
+  - cojson-transport-ws@0.17.5
+
 ## 0.17.4
 
 ### Patch Changes

package/dist/{chunk-NPXI4XAS.js → chunk-EEKKLGF2.js}

@@ -718,7 +718,7 @@ var CoMapProxyHandler = {
 RegisteredSchemas["CoMap"] = CoMap;
 
 // src/tools/coValues/coList.ts
-import { ControlledAccount as ControlledAccount2, RawAccount as RawAccount2 } from "cojson";
+import { ControlledAccount as ControlledAccount2, RawAccount as RawAccount2, cojsonInternals as cojsonInternals2 } from "cojson";
 import { calcPatch } from "fast-myers-diff";
 var _CoList = class _CoList extends Array {
   /**
@@ -847,10 +847,13 @@ var _CoList = class _CoList extends Array {
    * @category Creation
    **/
   static create(items, options) {
-    const { owner } = parseCoValueCreateOptions(options);
+    const { owner, uniqueness } = parseCoValueCreateOptions(options);
     const instance = new this({ init: items, owner });
     const raw = owner._raw.createList(
-      toRawItems(items, instance._schema[ItemsSym], owner)
+      toRawItems(items, instance._schema[ItemsSym], owner),
+      null,
+      "private",
+      uniqueness
     );
     Object.defineProperties(instance, {
       id: {
@@ -1027,6 +1030,80 @@ var _CoList = class _CoList extends Array {
   castAs(cl) {
     return cl.fromRaw(this._raw);
   }
+  /** @deprecated Use `CoList.upsertUnique` and `CoList.loadUnique` instead. */
+  static findUnique(unique, ownerID, as) {
+    return _CoList._findUnique(unique, ownerID, as);
+  }
+  /** @internal */
+  static _findUnique(unique, ownerID, as) {
+    as ||= activeAccountContext.get();
+    const header = {
+      type: "colist",
+      ruleset: {
+        type: "ownedByGroup",
+        group: ownerID
+      },
+      meta: null,
+      uniqueness: unique
+    };
+    const crypto = as._type === "Anonymous" ? as.node.crypto : as._raw.core.node.crypto;
+    return cojsonInternals2.idforHeader(header, crypto);
+  }
+  /**
+   * Given some data, updates an existing CoList or initialises a new one if none exists.
+   *
+   * Note: This method respects resolve options, and thus can return `null` if the references cannot be resolved.
+   *
+   * @example
+   * ```ts
+   * const activeItems = await ItemList.upsertUnique(
+   *   {
+   *     value: [item1, item2, item3],
+   *     unique: sourceData.identifier,
+   *     owner: workspace,
+   *   }
+   * );
+   * ```
+   *
+   * @param options The options for creating or loading the CoList. This includes the intended state of the CoList, its unique identifier, its owner, and the references to resolve.
+   * @returns Either an existing & modified CoList, or a new initialised CoList if none exists.
+   * @category Subscription & Loading
+   */
+  static async upsertUnique(options) {
+    let listId = _CoList._findUnique(options.unique, options.owner.id);
+    let list = await loadCoValueWithoutMe(this, listId, {
+      ...options,
+      loadAs: options.owner._loadedAs,
+      skipRetry: true
+    });
+    if (!list) {
+      list = this.create(options.value, {
+        owner: options.owner,
+        unique: options.unique
+      });
+    } else {
+      list.applyDiff(options.value);
+    }
+    return await loadCoValueWithoutMe(this, listId, {
+      ...options,
+      loadAs: options.owner._loadedAs,
+      skipRetry: true
+    });
+  }
+  /**
+   * Loads a CoList by its unique identifier and owner's ID.
+   * @param unique The unique identifier of the CoList to load.
+   * @param ownerID The ID of the owner of the CoList.
+   * @param options Additional options for loading the CoList.
+   * @returns The loaded CoList, or null if unavailable.
+   */
+  static loadUnique(unique, ownerID, options) {
+    return loadCoValueWithoutMe(
+      this,
+      _CoList._findUnique(unique, ownerID, options?.loadAs),
+      { ...options, skipRetry: true }
+    );
+  }
   /**
    * Wait for the `CoList` to be uploaded to the other peers.
    *
@@ -1136,7 +1213,7 @@ var CoListProxyHandler = {
 };
 
 // src/tools/coValues/coFeed.ts
-import { cojsonInternals as cojsonInternals2 } from "cojson";
+import { cojsonInternals as cojsonInternals3 } from "cojson";
 var _CoFeed = class _CoFeed extends CoValueBase {
   /**
    * Declare a `CoFeed` by subclassing `CoFeed.Of(...)` and passing the item schema using a `co` primitive or a `coField.ref`.
@@ -1469,12 +1546,12 @@ var CoStreamPerSessionProxyHandler = (innerTarget, accessFrom) => ({
       const sessionID = key;
       const rawEntry = innerTarget._raw.lastItemIn(sessionID);
       if (!rawEntry) return;
-      const by = cojsonInternals2.accountOrAgentIDfromSessionID(sessionID);
+      const by = cojsonInternals3.accountOrAgentIDfromSessionID(sessionID);
       const entry = entryFromRawEntry(
         accessFrom,
         rawEntry,
         innerTarget._loadedAs,
-        cojsonInternals2.isAccountID(by) ? by : void 0,
+        cojsonInternals3.isAccountID(by) ? by : void 0,
         innerTarget._schema[ItemsSym]
       );
       Object.defineProperty(entry, "all", {
@@ -1488,7 +1565,7 @@ var CoStreamPerSessionProxyHandler = (innerTarget, accessFrom) => ({
                 accessFrom,
                 rawEntry2.value,
                 innerTarget._loadedAs,
-                cojsonInternals2.isAccountID(by) ? by : void 0,
+                cojsonInternals3.isAccountID(by) ? by : void 0,
                 innerTarget._schema[ItemsSym]
               );
             }
@@ -1658,7 +1735,7 @@ var FileStream = class extends CoValueBase {
       totalSizeBytes: arrayBuffer.byteLength,
       fileName
     });
-    const chunkSize = cojsonInternals2.TRANSACTION_CONFIG.MAX_RECOMMENDED_TX_SIZE;
+    const chunkSize = cojsonInternals3.TRANSACTION_CONFIG.MAX_RECOMMENDED_TX_SIZE;
     let lastProgressUpdate = Date.now();
     for (let idx = 0; idx < data.length; idx += chunkSize) {
       stream.push(data.slice(idx, idx + chunkSize));
@@ -1742,7 +1819,7 @@ var FileStream = class extends CoValueBase {
 import {
   ControlledAccount as ControlledAccount3,
   LocalNode,
-  cojsonInternals as cojsonInternals3
+  cojsonInternals as cojsonInternals4
 } from "cojson";
 var _Account = class _Account extends CoValueBase {
   get _schema() {
@@ -1888,7 +1965,7 @@ var _Account = class _Account extends CoValueBase {
     return activeAccountContext.get();
   }
   static async createAs(as, options) {
-    const connectedPeers = cojsonInternals3.connectedPeers(
+    const connectedPeers = cojsonInternals4.connectedPeers(
       "creatingAccount",
       "createdAccount",
       { peer1role: "server", peer2role: "client" }
@@ -4130,6 +4207,16 @@ var CoListSchema = class {
   getCoValueClass() {
     return this.coValueClass;
   }
+  /** @deprecated Use `CoList.upsertUnique` and `CoList.loadUnique` instead. */
+  findUnique(unique, ownerID, as) {
+    return this.coValueClass.findUnique(unique, ownerID, as);
+  }
+  upsertUnique(options) {
+    return this.coValueClass.upsertUnique(options);
+  }
+  loadUnique(unique, ownerID, options) {
+    return this.coValueClass.loadUnique(unique, ownerID, options);
+  }
   optional() {
     return coOptionalDefiner(this);
   }
@@ -4558,7 +4645,7 @@ var ImageDefinitionBase = coMapDefiner({
 var ImageDefinition = ImageDefinitionBase;
 
 // src/tools/implementation/ContextManager.ts
-import { cojsonInternals as cojsonInternals4 } from "cojson";
+import { cojsonInternals as cojsonInternals5 } from "cojson";
 import { PureJSCrypto } from "cojson/dist/crypto/PureJSCrypto";
 
 // src/tools/auth/KvStoreContext.ts
@@ -4887,7 +4974,7 @@ var JazzContextManager = class {
     }
     const currentContext = this.context;
     if (prevContext && currentContext && "me" in prevContext && "me" in currentContext) {
-      const [prevAccountAsPeer, currentAccountAsPeer] = cojsonInternals4.connectedPeers(
+      const [prevAccountAsPeer, currentAccountAsPeer] = cojsonInternals5.connectedPeers(
         prevContext.me.id,
         currentContext.me.id,
         {
@@ -5283,4 +5370,4 @@ export {
   JazzContextManager
 };
 /* istanbul ignore file -- @preserve */
-//# sourceMappingURL=chunk-NPXI4XAS.js.map
+//# sourceMappingURL=chunk-EEKKLGF2.js.map