jazz-tools 0.18.38 → 0.19.0

package/dist/tools/subscribe/CoValueCoreSubscription.d.ts

@@ -1,5 +1,6 @@
 import { LocalNode, RawCoValue } from "cojson";
 import type { BranchDefinition } from "./types.js";
+import { CoValueLoadingState } from "./types.js";
 /**
  * Manages subscriptions to CoValue cores, handling both direct subscriptions
  * and branch-based subscriptions with automatic loading and error handling.
@@ -15,7 +16,7 @@ export declare class CoValueCoreSubscription {
     private localNode;
     private listener;
     private skipRetry?;
-    constructor(localNode: LocalNode, id: string, listener: (value: RawCoValue | "unavailable") => void, skipRetry?: boolean, branch?: BranchDefinition);
+    constructor(localNode: LocalNode, id: string, listener: (value: RawCoValue | typeof CoValueLoadingState.UNAVAILABLE) => void, skipRetry?: boolean, branch?: BranchDefinition);
     /**
      * Rehydrates the subscription by resetting the unsubscribed flag and initializing the subscription again
      */
@@ -55,7 +56,7 @@ export declare class CoValueCoreSubscription {
      * This is the final step where we actually start receiving updates.
      */
     private subscribe;
-    emit(value: RawCoValue | "unavailable"): void;
+    emit(value: RawCoValue | typeof CoValueLoadingState.UNAVAILABLE): void;
     /**
      * Unsubscribes from all active subscriptions and marks the instance as unsubscribed.
      * This prevents any further operations and ensures proper cleanup.

package/dist/tools/subscribe/CoValueCoreSubscription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoValueCoreSubscription.d.ts","sourceRoot":"","sources":["../../../src/tools/subscribe/CoValueCoreSubscription.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,SAAS,EAET,UAAU,EACX,MAAM,QAAQ,CAAC;AAChB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;GAKG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO,CAAC,aAAa,CAAC,CAAU;IAChC,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,QAAQ,CAA8C;IAC9D,OAAO,CAAC,SAAS,CAAC,CAAU;gBAG1B,SAAS,EAAE,SAAS,EACpB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,KAAK,IAAI,EACrD,SAAS,CAAC,EAAE,OAAO,EACnB,MAAM,CAAC,EAAE,gBAAgB;IAY3B;;OAEG;IACH,SAAS;IAWT;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAmB9B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAuB7B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAY/B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAsBnB;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IA6BpC;;;OAGG;IACH,OAAO,CAAC,SAAS;IASjB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI;IAS7C;;;OAGG;IACH,WAAW,IAAI,IAAI;CAKpB"}
+{"version":3,"file":"CoValueCoreSubscription.d.ts","sourceRoot":"","sources":["../../../src/tools/subscribe/CoValueCoreSubscription.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,SAAS,EAET,UAAU,EACX,MAAM,QAAQ,CAAC;AAChB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;GAKG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO,CAAC,aAAa,CAAC,CAAU;IAChC,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,QAAQ,CAEN;IACV,OAAO,CAAC,SAAS,CAAC,CAAU;gBAG1B,SAAS,EAAE,SAAS,EACpB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,CACR,KAAK,EAAE,UAAU,GAAG,OAAO,mBAAmB,CAAC,WAAW,KACvD,IAAI,EACT,SAAS,CAAC,EAAE,OAAO,EACnB,MAAM,CAAC,EAAE,gBAAgB;IAY3B;;OAEG;IACH,SAAS;IAWT;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAmB9B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAuB7B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAY/B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAsBnB;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IA6BpC;;;OAGG;IACH,OAAO,CAAC,SAAS;IASjB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,mBAAmB,CAAC,WAAW,GAAG,IAAI;IAStE;;;OAGG;IACH,WAAW,IAAI,IAAI;CAKpB"}

package/dist/tools/subscribe/JazzError.d.ts

@@ -1,14 +1,15 @@
 import type { CoValue, ID } from "../internal.js";
+import { CoValueLoadingState } from "./types.js";
 export declare class JazzError {
     id: ID<CoValue> | undefined;
-    type: "unavailable" | "unauthorized";
+    type: typeof CoValueLoadingState.UNAVAILABLE | typeof CoValueLoadingState.UNAUTHORIZED;
     issues: JazzErrorIssue[];
-    constructor(id: ID<CoValue> | undefined, type: "unavailable" | "unauthorized", issues: JazzErrorIssue[]);
+    constructor(id: ID<CoValue> | undefined, type: typeof CoValueLoadingState.UNAVAILABLE | typeof CoValueLoadingState.UNAUTHORIZED, issues: JazzErrorIssue[]);
     toString(): string;
     prependPath(item: string): JazzError;
 }
 export type JazzErrorIssue = {
-    code: "unavailable" | "unauthorized" | "validationError";
+    code: typeof CoValueLoadingState.UNAVAILABLE | typeof CoValueLoadingState.UNAUTHORIZED | "validationError";
     message: string;
     params: Record<string, any>;
     path: string[];

package/dist/tools/subscribe/JazzError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JazzError.d.ts","sourceRoot":"","sources":["../../../src/tools/subscribe/JazzError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAElD,qBAAa,SAAS;IAEX,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,SAAS;IAC3B,IAAI,EAAE,aAAa,GAAG,cAAc;IACpC,MAAM,EAAE,cAAc,EAAE;gBAFxB,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,SAAS,EAC3B,IAAI,EAAE,aAAa,GAAG,cAAc,EACpC,MAAM,EAAE,cAAc,EAAE;IAGjC,QAAQ;IAkBR,WAAW,CAAC,IAAI,EAAE,MAAM;CAczB;AACD,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,aAAa,GAAG,cAAc,GAAG,iBAAiB,CAAC;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC"}
+{"version":3,"file":"JazzError.d.ts","sourceRoot":"","sources":["../../../src/tools/subscribe/JazzError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,SAAS;IAEX,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,SAAS;IAC3B,IAAI,EACP,OAAO,mBAAmB,CAAC,WAAW,GACtC,OAAO,mBAAmB,CAAC,YAAY;IACpC,MAAM,EAAE,cAAc,EAAE;gBAJxB,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,SAAS,EAC3B,IAAI,EACP,OAAO,mBAAmB,CAAC,WAAW,GACtC,OAAO,mBAAmB,CAAC,YAAY,EACpC,MAAM,EAAE,cAAc,EAAE;IAGjC,QAAQ;IAkBR,WAAW,CAAC,IAAI,EAAE,MAAM;CAczB;AACD,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EACA,OAAO,mBAAmB,CAAC,WAAW,GACtC,OAAO,mBAAmB,CAAC,YAAY,GACvC,iBAAiB,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC"}

package/dist/tools/subscribe/SubscriptionScope.d.ts

@@ -2,7 +2,8 @@ import type { LocalNode, RawCoValue } from "cojson";
 import { CoList, CoMap, type CoValue, type ID, type RefEncoded, type RefsToResolve } from "../internal.js";
 import { CoValueCoreSubscription } from "./CoValueCoreSubscription.js";
 import { JazzError } from "./JazzError.js";
-import type { BranchDefinition, SubscriptionValue, Unloaded } from "./types.js";
+import type { BranchDefinition, SubscriptionValue, SubscriptionValueLoading } from "./types.js";
+import { CoValueLoadingState, NotLoadedCoValueState } from "./types.js";
 export declare class SubscriptionScope<D extends CoValue> {
     node: LocalNode;
     id: ID<D>;
@@ -20,7 +21,7 @@ export declare class SubscriptionScope<D extends CoValue> {
      * Autoloaded child ids that are unloaded
      */
     pendingAutoloadedChildren: Set<string>;
-    value: SubscriptionValue<D, any> | Unloaded;
+    value: SubscriptionValue<D, any> | SubscriptionValueLoading;
     childErrors: Map<string, JazzError>;
     validationErrors: Map<string, JazzError>;
     errorFromChildren: JazzError | undefined;
@@ -38,11 +39,11 @@ export declare class SubscriptionScope<D extends CoValue> {
     silenceUpdates: boolean;
     constructor(node: LocalNode, resolve: RefsToResolve<D>, id: ID<D>, schema: RefEncoded<D>, skipRetry?: boolean, bestEffortResolution?: boolean, unstable_branch?: BranchDefinition | undefined);
     updateValue(value: SubscriptionValue<D, any>): void;
-    handleUpdate(update: RawCoValue | "unavailable"): void;
+    handleUpdate(update: RawCoValue | typeof CoValueLoadingState.UNAVAILABLE): void;
     computeChildErrors(): JazzError | undefined;
-    handleChildUpdate: (id: string, value: SubscriptionValue<any, any> | Unloaded, key?: string) => void;
+    handleChildUpdate: (id: string, value: SubscriptionValue<any, any> | SubscriptionValueLoading, key?: string) => void;
     shouldSendUpdates(): boolean;
-    getCurrentValue(): D | null | undefined;
+    getCurrentValue(): D | NotLoadedCoValueState;
     triggerUpdate(): void;
     subscribers: Set<(value: SubscriptionValue<D, any>) => void>;
     subscribe(listener: (value: SubscriptionValue<D, any>) => void): () => void;

package/dist/tools/subscribe/SubscriptionScope.d.ts.map

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

package/dist/tools/subscribe/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/subscribe/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAgB,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,CAAC,qDA0B/D;AAED,yBAAyB;AAEzB;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,OAAO,EAChD,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,OAqBZ;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,OAAO,EAC/C,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,OAa5B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/subscribe/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAgB,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,CAAC,qDA0B/D;AAED,yBAAyB;AAEzB;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,OAAO,EAChD,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,OAwBZ;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,OAAO,EAC/C,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,OAgB5B"}

package/dist/tools/subscribe/types.d.ts

@@ -1,12 +1,32 @@
 import type { Account, CoValue, Group, RefsToResolve, Resolved } from "../internal.js";
 import type { JazzError } from "./JazzError.js";
+export declare const CoValueLoadingState: {
+    /**
+     * The coValue is loaded.
+     */
+    readonly LOADED: "loaded";
+    /**
+     * The coValue is being loaded.
+     */
+    readonly LOADING: "loading";
+    /**
+     * The coValue was loaded but the account is not authorized to access it.
+     */
+    readonly UNAUTHORIZED: "unauthorized";
+    /**
+     * Tried to load the coValue but failed.
+     */
+    readonly UNAVAILABLE: "unavailable";
+};
+export type CoValueLoadingState = (typeof CoValueLoadingState)[keyof typeof CoValueLoadingState];
+export type NotLoadedCoValueState = typeof CoValueLoadingState.LOADING | typeof CoValueLoadingState.UNAUTHORIZED | typeof CoValueLoadingState.UNAVAILABLE;
 export type SubscriptionValue<D extends CoValue, R extends RefsToResolve<D>> = {
-    type: "loaded";
+    type: typeof CoValueLoadingState.LOADED;
     value: Resolved<D, R>;
     id: string;
 } | JazzError;
-export type Unloaded = {
-    type: "unloaded";
+export type SubscriptionValueLoading = {
+    type: typeof CoValueLoadingState.LOADING;
     id: string;
 };
 export type BranchDefinition = {

package/dist/tools/subscribe/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/subscribe/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,OAAO,EACP,KAAK,EACL,aAAa,EACb,QAAQ,EACT,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,IACvE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACrD,SAAS,CAAC;AACd,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,IAAI,CAAA;CAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/subscribe/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,OAAO,EACP,KAAK,EACL,aAAa,EACb,QAAQ,EACT,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,eAAO,MAAM,mBAAmB;IAC9B;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;CAEK,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAC7B,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjE,MAAM,MAAM,qBAAqB,GAC7B,OAAO,mBAAmB,CAAC,OAAO,GAClC,OAAO,mBAAmB,CAAC,YAAY,GACvC,OAAO,mBAAmB,CAAC,WAAW,CAAC;AAE3C,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,IACvE;IACE,IAAI,EAAE,OAAO,mBAAmB,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ,GACD,SAAS,CAAC;AACd,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,OAAO,mBAAmB,CAAC,OAAO,CAAC;IACzC,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,IAAI,CAAA;CAAE,CAAC"}

package/dist/tools/subscribe/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/tools/subscribe/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,UAAU,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEtD,OAAO,EACL,OAAO,EACP,UAAU,EAGX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,CAUnE;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,EAC7C,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAClB,GAAG,EAAE,UAAU,EACf,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAC;;;;EAgBxC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/tools/subscribe/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,UAAU,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEtD,OAAO,EACL,OAAO,EACP,UAAU,EAGX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,CAUnE;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,EAC7C,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAClB,GAAG,EAAE,UAAU,EACf,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAC;;;;EAgBxC"}

package/dist/tools/testing.d.ts

@@ -1,6 +1,7 @@
 import { LocalNode } from "cojson";
 import { PureJSCrypto } from "cojson/dist/crypto/PureJSCrypto";
-import { Account, AccountClass, type AnonymousJazzAgent, CoValueFromRaw, CoreAccountSchema, InstanceOfSchema, JazzContextManager, JazzContextManagerAuthProps, JazzContextManagerBaseProps } from "./internal.js";
+import { Account, AccountClass, type AnonymousJazzAgent, CoValueFromRaw, CoreAccountSchema, InstanceOfSchema, JazzContextManager, JazzContextManagerAuthProps, JazzContextManagerBaseProps, CoValue } from "./internal.js";
+export { assertLoaded } from "./lib/utils.js";
 export declare class TestJSCrypto extends PureJSCrypto {
     static create(): Promise<PureJSCrypto>;
 }
@@ -49,7 +50,7 @@ export declare class TestJazzContextManager<Acc extends Account> extends JazzCon
             fromNode: (typeof Account)["fromNode"];
         } & CoValueFromRaw<Acc> extends infer T ? T extends import("./internal.js").CoValueClass<Acc> & {
             fromNode: (typeof Account)["fromNode"];
-        } & CoValueFromRaw<Acc> ? T extends import("./internal.js").CoValueClass<import("./internal.js").CoValue> ? InstanceType<T> : never : never : never;
+        } & CoValueFromRaw<Acc> ? T extends import("./internal.js").CoValueClass<CoValue> ? InstanceType<T> : never : never : never;
         node: LocalNode;
         done: () => void;
         logOut: () => Promise<void>;

package/dist/tools/testing.d.ts.map

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

package/dist/tools/tests/schema.resolved.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.resolved.test.d.ts.map

package/dist/tools/tests/schema.resolved.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.resolved.test.d.ts","sourceRoot":"","sources":["../../../src/tools/tests/schema.resolved.test.ts"],"names":[],"mappings":""}

package/dist/tools/tests/utils.d.ts

@@ -1,7 +1,7 @@
 import { AccountClass } from "../coValues/account";
 import { CoID, LocalNode, RawCoValue } from "cojson";
 import { Account } from "../index";
-import { CoValueFromRaw } from "../internal";
+import { CoValue, CoValueFromRaw, MaybeLoaded, LoadedAndRequired } from "../internal";
 export declare function setupAccount(): Promise<{
     me: import("../internal").ControlledAccount;
     meOnSecondPeer: Account | ({
@@ -18,4 +18,5 @@ export declare function setupTwoNodes(options?: {
 }>;
 export declare function waitFor(callback: () => boolean | void | Promise<boolean | void>): Promise<void>;
 export declare function loadCoValueOrFail<V extends RawCoValue>(node: LocalNode, id: CoID<V>): Promise<V>;
+export declare function assertLoaded<T extends MaybeLoaded<CoValue>>(coValue: T): asserts coValue is LoadedAndRequired<T>;
 //# sourceMappingURL=utils.d.ts.map

package/dist/tools/tests/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/tools/tests/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,qBAAqB,CAAC;AAExE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGrD,OAAO,EACL,OAAO,EAGR,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7C,wBAAsB,YAAY;;;;;GAgCjC;AAED,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE;IAC5C,mBAAmB,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;CACvE;;;;;GAgDA;AAED,wBAAgB,OAAO,CACrB,QAAQ,EAAE,MAAM,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,iBA2BzD;AAED,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,UAAU,EAC1D,IAAI,EAAE,SAAS,EACf,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,GACV,OAAO,CAAC,CAAC,CAAC,CAMZ"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/tools/tests/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAuB,MAAM,qBAAqB,CAAC;AAExE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGrD,OAAO,EACL,OAAO,EAGR,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,OAAO,EACP,cAAc,EAEd,WAAW,EACX,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAIrB,wBAAsB,YAAY;;;;;GAgCjC;AAED,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE;IAC5C,mBAAmB,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;CACvE;;;;;GAgDA;AAED,wBAAgB,OAAO,CACrB,QAAQ,EAAE,MAAM,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,iBA2BzD;AAED,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,UAAU,EAC1D,IAAI,EAAE,SAAS,EACf,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,GACV,OAAO,CAAC,CAAC,CAAC,CAMZ;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,CAAC,OAAO,CAAC,EACzD,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,OAAO,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAEzC"}

package/package.json

@@ -187,7 +187,7 @@
   },
   "type": "module",
   "license": "MIT",
-  "version": "0.18.38",
+  "version": "0.19.0",
   "dependencies": {
     "@manuscripts/prosemirror-recreate-steps": "^0.1.4",
     "@scure/base": "1.2.1",
@@ -204,9 +204,9 @@
     "prosemirror-transform": "^1.9.0",
     "use-sync-external-store": "^1.5.0",
     "zod": "4.1.11",
-    "cojson": "0.18.38",
-    "cojson-storage-indexeddb": "0.18.38",
-    "cojson-transport-ws": "0.18.38"
+    "cojson": "0.19.0",
+    "cojson-storage-indexeddb": "0.19.0",
+    "cojson-transport-ws": "0.19.0"
   },
   "devDependencies": {
     "@scure/bip39": "^1.3.0",

package/src/better-auth/database-adapter/index.ts

@@ -80,7 +80,7 @@ export const JazzBetterAuthDatabaseAdapter = (
 
       let worker: Account | undefined = undefined;
 
-      async function getWorker() {
+      async function getWorker(): Promise<Account> {
         if (worker) {
           return worker;
         }
@@ -96,7 +96,7 @@ export const JazzBetterAuthDatabaseAdapter = (
 
         worker = result.worker;
 
-        return worker;
+        return result.worker;
       }
 
       async function initRepository(

package/src/better-auth/database-adapter/repository/account.ts

@@ -45,7 +45,7 @@ export class AccountRepository extends JazzRepository {
     if (isWhereBySingleField(this.getAccountIdProperty(), where)) {
       const accountIdIndex = await this.getAccountIdIndex(where[0].value);
 
-      const ids = accountIdIndex ?? [];
+      const ids = accountIdIndex.$isLoaded ? accountIdIndex : [];
 
       if (ids.length === 0) {
         return [];
@@ -102,7 +102,7 @@ export class AccountRepository extends JazzRepository {
   private async updateAccountIdIndex(accountId: string, entityId: string) {
     const accountIdIndex = await this.getAccountIdIndex(accountId);
 
-    const ids = accountIdIndex ?? [];
+    const ids = accountIdIndex.$isLoaded ? accountIdIndex : [];
 
     await AccountIdIndex.upsertUnique({
       value: [...ids, entityId],
@@ -114,7 +114,7 @@ export class AccountRepository extends JazzRepository {
   private async deleteAccountIdIndex(accountId: string, entityId: string) {
     const accountIdIndex = await this.getAccountIdIndex(accountId);
 
-    const ids = accountIdIndex ?? [];
+    const ids = accountIdIndex.$isLoaded ? accountIdIndex : [];
 
     await AccountIdIndex.upsertUnique({
       value: ids.filter((id) => id !== entityId),

package/src/better-auth/database-adapter/repository/generic.ts

@@ -80,16 +80,19 @@ export class JazzRepository {
     }
 
     // If we have a unique id, we must check for soft deleted items first
-    const existingNode = (await schema.loadUnique(
+    const existingNode = await schema.loadUnique(
       uniqueId,
       list.$jazz.owner.$jazz.id,
       {
         loadAs: this.worker,
       },
-    )) as CoMap | null;
+    );
 
     // if the entity exists and is not soft deleted, we must throw an error
-    if (existingNode && existingNode.$jazz?.raw.get("_deleted") !== true) {
+    if (
+      existingNode.$isLoaded &&
+      existingNode.$jazz.raw.get("_deleted") !== true
+    ) {
       throw new Error("Entity already exists");
     }
 
@@ -103,7 +106,7 @@ export class JazzRepository {
       unique: uniqueId,
     });
 
-    if (!node) {
+    if (!node.$isLoaded) {
       throw new Error("Unable to create entity");
     }
 
@@ -131,7 +134,7 @@ export class JazzRepository {
 
     const node = await this.getSchema(model).load(id, { loadAs: this.worker });
 
-    if (!node) {
+    if (!node.$isLoaded) {
       return null;
     }
 
@@ -156,7 +159,7 @@ export class JazzRepository {
       },
     );
 
-    if (!node) {
+    if (!node.$isLoaded) {
       return null;
     }
 

package/src/better-auth/database-adapter/repository/user.ts

@@ -27,7 +27,7 @@ export class UserRepository extends JazzRepository {
 
     const emailIndex = await this.loadEmailIndex(userEmail);
 
-    if (emailIndex?.user) {
+    if (emailIndex.$isLoaded && emailIndex.user) {
       throw new Error("Email already exists");
     }
 
@@ -68,7 +68,11 @@ export class UserRepository extends JazzRepository {
   private async findByEmail(email: string): Promise<TableItem[]> {
     const emailIndex = await this.loadEmailIndex(email);
 
-    const user = emailIndex?.user;
+    if (!emailIndex.$isLoaded) {
+      return [];
+    }
+
+    const user = emailIndex.user;
 
     if (!user) {
       return [];

package/src/better-auth/database-adapter/schema.ts

@@ -55,7 +55,7 @@ export function createJazzSchema(schema: BetterAuthDbSchema): JazzSchema {
         },
       );
 
-      if (!dbRoot) {
+      if (!dbRoot.$isLoaded) {
         // Create a group for the first time
         // it will be the owner of the all tables and data
         const adminGroup = Group.create({ owner: account });

package/src/better-auth/database-adapter/tests/index.test.ts

@@ -16,6 +16,7 @@ import { startWorker } from "jazz-tools/worker";
 import { createWorkerAccount, startSyncServer } from "./sync-utils.js";
 import { JazzBetterAuthDatabaseAdapter } from "../index.js";
 import { TableItem } from "../schema.js";
+import { assertLoaded } from "jazz-tools/testing";
 
 describe("JazzBetterAuthDatabaseAdapter tests", async () => {
   describe("better-auth internal tests", async () => {
@@ -197,9 +198,7 @@ describe("JazzBetterAuthDatabaseAdapter tests", async () => {
         },
       });
 
-      assert(db);
-      assert(db.group);
-      assert(db.tables);
+      assertLoaded(db);
 
       // Create a new worker account
       const newWorkerAccount = await createWorkerAccount({
@@ -208,7 +207,7 @@ describe("JazzBetterAuthDatabaseAdapter tests", async () => {
       });
 
       const newWorkerRef = await Account.load(newWorkerAccount.accountID);
-      assert(newWorkerRef);
+      assertLoaded(newWorkerRef);
 
       // Add the new worker to the group
       db.group.addMember(newWorkerRef, "admin");

package/src/inspector/tests/viewer/history-view.test.tsx

@@ -1,6 +1,10 @@
 // @vitest-environment happy-dom
 import { afterEach, assert, beforeAll, describe, expect, it } from "vitest";
-import { createJazzTestAccount, setupJazzTestSync } from "jazz-tools/testing";
+import {
+  assertLoaded,
+  createJazzTestAccount,
+  setupJazzTestSync,
+} from "jazz-tools/testing";
 import { co, z } from "jazz-tools";
 import {
   cleanup,
@@ -113,7 +117,7 @@ describe("HistoryView", async () => {
       const valueOnAccount2 = await Schema.load(value.$jazz.id, {
         loadAs: account2,
       });
-      assert(valueOnAccount2);
+      assertLoaded(valueOnAccount2);
 
       // This is invalid, since account2 is a reader
       valueOnAccount2.$jazz.set("pet", "cat");

package/src/media/utils.test.ts

@@ -253,6 +253,11 @@ describe("loadImageBySize", async () => {
     return imageDef;
   };
 
+  it("return null if the image cannot be loaded", async () => {
+    const result = await loadImageBySize("invalid-id", 256, 256);
+    expect(result).toBeNull();
+  });
+
   it("returns original if progressive is false", async () => {
     const imageDef = await createImageDef([[1920, 1080]], false);
     const result = await loadImageBySize(imageDef, 256, 256);

package/src/media/utils.ts

@@ -1,5 +1,5 @@
 import type { CoID } from "cojson";
-import { Account, FileStream, ImageDefinition } from "jazz-tools";
+import { Account, FileStream, ImageDefinition, MaybeLoaded } from "jazz-tools";
 
 export function highestResAvailable(
   image: ImageDefinition,
@@ -15,7 +15,7 @@ export function highestResAvailable(
     });
 
   if (availableSizes.length === 0) {
-    return image.original
+    return image.original.$isLoaded
       ? {
           width: image.originalSize[0],
           height: image.originalSize[1],
@@ -40,19 +40,20 @@ export function highestResAvailable(
   // note: `toReversed` is not available in react-native.
   const bestLoaded = [...sortedSizes]
     .reverse()
-    .find((el) => el.isLoaded && image[el.size[2]]?.getChunks());
+    .find((el) => el.isLoaded && getImageChunks(image[el.size[2]]));
 
   // if I can't find a good match, let's use the highest resolution
   const bestTarget =
     sortedSizes.find((el) => el.match > 0.95) || sortedSizes.at(-1);
 
   // if the best target is already loaded, we are done
-  if (image[bestTarget!.size[2]]?.getChunks()) {
-    return image[bestTarget!.size[2]]
+  const bestTargetImage = image[bestTarget!.size[2]];
+  if (getImageChunks(bestTargetImage)) {
+    return bestTargetImage?.$isLoaded
       ? {
           width: bestTarget!.size[0],
           height: bestTarget!.size[1],
-          image: image[bestTarget!.size[2]]!,
+          image: bestTargetImage,
         }
       : null;
   }
@@ -60,12 +61,13 @@ export function highestResAvailable(
   // if the best already loaded is not the best target
   // let's trigger the load of the best target
   if (bestLoaded) {
-    image[bestTarget!.size[2]]?.getChunks();
-    return image[bestLoaded.size[2]]
+    getImageChunks(bestTargetImage);
+    const bestLoadedImage = image[bestLoaded.size[2]];
+    return bestLoadedImage?.$isLoaded
       ? {
           width: bestLoaded.size[0],
           height: bestLoaded.size[1],
-          image: image[bestLoaded.size[2]]!,
+          image: bestLoadedImage,
         }
       : null;
   }
@@ -73,13 +75,20 @@ export function highestResAvailable(
   // if nothing is loaded, then start fetching all the images till the best
   for (let size of sortedSizes) {
     if (size.match <= bestTarget!.match) {
-      image[size.size[2]]?.getChunks();
+      getImageChunks(image[size.size[2]]);
     }
   }
 
   return null;
 }
 
+function getImageChunks(file: MaybeLoaded<FileStream> | undefined) {
+  if (!file || !file.$isLoaded) {
+    return undefined;
+  }
+  return file.getChunks();
+}
+
 function sizesMatchWanted(
   w: number,
   h: number,
@@ -117,7 +126,7 @@ export async function loadImage(
       },
     });
 
-    if (image === null || image.original === null) {
+    if (!image.$isLoaded) {
       return null;
     }
 
@@ -128,14 +137,14 @@ export async function loadImage(
     };
   }
 
-  if (!imageOrId.original) {
+  if (!imageOrId.original.$isLoaded) {
     console.warn("Unable to find the original image");
     return null;
   }
 
   const loadedOriginal = await FileStream.load(imageOrId.original.$jazz.id);
 
-  if (!loadedOriginal) {
+  if (!loadedOriginal.$isLoaded) {
     console.warn("Unable to find the original image");
     return null;
   }
@@ -153,12 +162,12 @@ export async function loadImageBySize(
   wantedHeight: number,
 ): Promise<{ width: number; height: number; image: FileStream } | null> {
   // @ts-expect-error The resolved type for CoMap does not include catchall properties
-  const image: ImageDefinition | null =
+  const image: MaybeLoaded<ImageDefinition> =
     typeof imageOrId === "string"
       ? await ImageDefinition.load(imageOrId)
       : imageOrId;
 
-  if (image === null) {
+  if (image.$isLoaded === false) {
     return null;
   }
 
@@ -200,7 +209,7 @@ export async function loadImageBySize(
 
   const loadedFile = await FileStream.load(file.id);
 
-  if (!loadedFile) {
+  if (!loadedFile.$isLoaded) {
     return null;
   }
 

package/src/react/hooks.tsx

@@ -50,8 +50,8 @@ export {
   experimental_useInboxSender,
   useJazzContext,
   useAccount,
-  useCoStateWithSelector,
-  useAccountWithSelector,
+  useAgent,
+  useLogOut,
   useSyncConnectionStatus,
   useCoValueSubscription,
   useAccountSubscription,

package/src/react/index.ts

@@ -7,8 +7,8 @@ export {
   experimental_useInboxSender,
   useJazzContext,
   useAuthSecretStorage,
-  useCoStateWithSelector,
-  useAccountWithSelector,
+  useAgent,
+  useLogOut,
   useSyncConnectionStatus,
   useCoValueSubscription,
   useAccountSubscription,

package/src/react/media/image.tsx

@@ -1,4 +1,4 @@
-import { ImageDefinition } from "jazz-tools";
+import { CoValueLoadingState, ImageDefinition } from "jazz-tools";
 import {
   type JSX,
   forwardRef,
@@ -87,7 +87,15 @@ export const Image = forwardRef<HTMLImageElement, ImageProps>(function Image(
   { imageId, width, height, ...props },
   ref,
 ) {
-  const image = useCoState(ImageDefinition, imageId);
+  const image = useCoState(ImageDefinition, imageId, {
+    select: (image) => {
+      if (image.$isLoaded) {
+        return image;
+      } else if (image.$jazz.loadingState === CoValueLoadingState.LOADING) {
+        return undefined;
+      } else return null;
+    },
+  });
   const lastBestImage = useRef<[string, string] | null>(null);
 
   /**

package/src/react/tests/useAcceptInvite.test.ts

@@ -1,6 +1,7 @@
 // @vitest-environment happy-dom
 
 import { CoMap, Group, ID, co, coField, z } from "jazz-tools";
+import { assertLoaded } from "jazz-tools/testing";
 import { describe, expect, it } from "vitest";
 import { createInviteLink, useAcceptInvite } from "../index.js";
 import { createJazzTestAccount, linkAccounts } from "../testing.js";
@@ -50,6 +51,7 @@ describe("useAcceptInvite", () => {
       loadAs: account,
     });
 
-    expect(accepted?.value).toEqual("hello");
+    assertLoaded(accepted);
+    expect(accepted.value).toEqual("hello");
   });
 });