@dxos/echo 0.9.0 → 0.9.1-staging.ee54ba693a

package/dist/lib/neutral/{chunk-WTQJHC75.mjs → chunk-L3E5IXAE.mjs}

@@ -1,13 +1,155 @@
 import {
+  ObjectDeletedId,
   ReferenceAnnotationId,
   Service,
   getSchemaURI,
   getTypeAnnotation,
   getTypeIdentifierAnnotation
-} from "./chunk-R5W6DXR4.mjs";
+} from "./chunk-3TN2VMI4.mjs";
 import {
   getStaticTypeSchema
-} from "./chunk-O6BH7EPN.mjs";
+} from "./chunk-2ZHECXUR.mjs";
+
+// src/internal/common/proxy/proxy-utils.ts
+import { invariant } from "@dxos/invariant";
+var __dxlog_file = "/__w/dxos/dxos/packages/core/echo/echo/src/internal/common/proxy/proxy-utils.ts";
+var symbolIsProxy = /* @__PURE__ */ Symbol.for("@dxos/schema/Proxy");
+var symbolReactivePrototype = /* @__PURE__ */ Symbol.for("@dxos/echo/ReactivePrototype");
+var isProxy = (value) => !!value?.[symbolIsProxy];
+var isReactiveRecord = (value) => {
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto != null && !!proto[symbolReactivePrototype];
+};
+var isValidProxyTarget = (value) => {
+  if (value == null || value[symbolIsProxy]) {
+    return false;
+  }
+  if (Array.isArray(value)) {
+    return true;
+  }
+  return typeof value === "object" && isReactiveRecord(value);
+};
+var getProxySlot = (proxy) => {
+  const value = proxy[symbolIsProxy];
+  invariant(value instanceof ProxyHandlerSlot, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 37, S: void 0, A: ["value instanceof ProxyHandlerSlot", ""] });
+  return value;
+};
+var getProxyTarget = (proxy) => {
+  return getProxySlot(proxy).target;
+};
+var getProxyHandler = (proxy) => {
+  return getProxySlot(proxy).handler;
+};
+var normalizeSpliceRange = (length, start, deleteCount) => {
+  const safeStart = start < 0 ? Math.max(length + start, 0) : Math.min(start, length);
+  const safeDeleteCount = Math.max(0, Math.min(deleteCount, length - safeStart));
+  return {
+    start: safeStart,
+    deleteCount: safeDeleteCount
+  };
+};
+var dangerouslySetProxyId = (obj, id) => {
+  getProxySlot(obj).target.id = id;
+};
+var createProxy = (target, handler) => {
+  const existingProxy = handler._proxyMap.get(target);
+  if (existingProxy) {
+    return existingProxy;
+  }
+  const proxy = new Proxy(target, new ProxyHandlerSlot(target, handler));
+  handler.init(target);
+  handler._proxyMap.set(target, proxy);
+  return proxy;
+};
+var ProxyHandlerSlot = class {
+  target;
+  _handler;
+  /**
+  * @param target Original object.
+  * @param _handler Handles intercepted operations.
+  */
+  constructor(target, _handler) {
+    this.target = target;
+    this._handler = _handler;
+  }
+  get handler() {
+    invariant(this._handler, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 100, S: this, A: ["this._handler", ""] });
+    return this._handler;
+  }
+  // TODO(burdon): Requires comment.
+  setHandler(handler) {
+    this._handler = handler;
+  }
+  /**
+  * Get value.
+  */
+  get(target, prop, receiver) {
+    if (prop === symbolIsProxy) {
+      return this;
+    }
+    if (!this._handler || !this._handler.get) {
+      return Reflect.get(target, prop, receiver);
+    }
+    return this._handler.get(target, prop, receiver);
+  }
+  static {
+    const TRAPS = [
+      "apply",
+      "construct",
+      "defineProperty",
+      "deleteProperty",
+      "get",
+      "getOwnPropertyDescriptor",
+      "getPrototypeOf",
+      "has",
+      "isExtensible",
+      "ownKeys",
+      "preventExtensions",
+      "set",
+      "setPrototypeOf"
+    ];
+    for (const trap of TRAPS) {
+      if (trap === "get") {
+        continue;
+      }
+      Object.defineProperty(this.prototype, trap, {
+        enumerable: false,
+        value: function(...args) {
+          if (!this._handler || !this._handler[trap]) {
+            return Reflect[trap](...args);
+          }
+          return this._handler[trap].apply(this._handler, args);
+        }
+      });
+    }
+  }
+};
+
+// src/internal/common/proxy/symbols.ts
+var EventId = /* @__PURE__ */ Symbol.for("@dxos/live-object/EventId");
+var ChangeId = /* @__PURE__ */ Symbol.for("@dxos/live-object/ChangeId");
+
+// src/internal/common/proxy/reactive.ts
+var subscribe = (obj, callback) => {
+  if (!isProxy(obj)) {
+    return () => {
+    };
+  }
+  const target = getProxyTarget(obj);
+  if (target && EventId in target) {
+    return target[EventId].on(callback);
+  }
+  return () => {
+  };
+};
+var change = (obj, callback) => {
+  const changeFn = obj[ChangeId];
+  if (changeFn) {
+    changeFn(callback);
+  } else {
+    callback(obj);
+  }
+};
 
 // src/internal/Ref/ref.ts
 import * as Effect from "effect/Effect";
@@ -21,7 +163,7 @@ import * as SchemaAST from "effect/SchemaAST";
 import { Event } from "@dxos/async";
 import { inspectCustom } from "@dxos/debug";
 import { EncodedReference } from "@dxos/echo-protocol";
-import { assertArgument, invariant } from "@dxos/invariant";
+import { assertArgument, invariant as invariant2 } from "@dxos/invariant";
 import { DXN, EID, EntityId } from "@dxos/keys";
 
 // src/internal/Ref/atoms.ts
@@ -50,12 +192,25 @@ var loadRefTarget = (ref, get, onTargetAvailable) => {
 // src/internal/Ref/atoms.ts
 var refSimpleFamily = Atom.family((ref) => {
   return Atom.make((get) => {
-    return loadRefTarget(ref, get, (target) => target);
+    let unsubscribeTarget;
+    const setupSubscription = (target) => {
+      unsubscribeTarget?.();
+      unsubscribeTarget = subscribe(target, () => {
+        const deleted2 = !!target[ObjectDeletedId];
+        get.setSelf(deleted2 ? void 0 : target);
+      });
+      const deleted = !!target[ObjectDeletedId];
+      return deleted ? void 0 : target;
+    };
+    get.addFinalizer(() => {
+      unsubscribeTarget?.();
+    });
+    return loadRefTarget(ref, get, setupSubscription);
   });
 });
 
 // src/internal/Ref/ref.ts
-var __dxlog_file = "/__w/dxos/dxos/packages/core/echo/echo/src/internal/Ref/ref.ts";
+var __dxlog_file2 = "/__w/dxos/dxos/packages/core/echo/echo/src/internal/Ref/ref.ts";
 var JSON_SCHEMA_ECHO_REF_ID = "/schemas/echo/ref";
 var getSchemaReference = (property) => {
   const { $id, reference: { schema: { $ref } = {} } = {} } = property;
@@ -86,7 +241,7 @@ var getReferenceAst = (ast) => {
     version: ast.annotations[ReferenceAnnotationId].version
   };
 };
-var RefTypeId = /* @__PURE__ */ Symbol("@dxos/echo/internal/Ref");
+var RefTypeId = /* @__PURE__ */ Symbol.for("@dxos/echo/internal/Ref");
 var Ref = (input) => {
   const schema = getStaticTypeSchema(input) ?? input;
   assertArgument(Schema.isSchema(schema), "schema", "Must call with an instance of effect-schema");
@@ -97,7 +252,7 @@ var Ref = (input) => {
   return createEchoReferenceSchema(getTypeIdentifierAnnotation(schema), annotation.typename, annotation.version);
 };
 Ref.isRef = (obj) => {
-  return obj && typeof obj === "object" && RefTypeId in obj;
+  return obj != null && typeof obj === "object" && RefTypeId in obj;
 };
 Ref.hasEntityId = (id) => (ref) => {
   const uri = EID.tryParse(ref.uri);
@@ -114,11 +269,12 @@ Ref.make = (obj) => {
     throw new TypeError("Expected: ECHO object.");
   }
   const id = obj.id;
-  invariant(EntityId.isValid(id), "Invalid object ID", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 86, S: void 0, A: ["EntityId.isValid(id)", "'Invalid object ID'"] });
+  invariant2(EntityId.isValid(id), "Invalid object ID", { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 87, S: void 0, A: ["EntityId.isValid(id)", "'Invalid object ID'"] });
   const uri = EID.make({
     entityId: id
   });
-  return new RefImpl(uri, obj);
+  const ref = new RefImpl(uri, obj);
+  return ref;
 };
 Ref.fromURI = (uri) => {
   assertArgument(typeof uri === "string", "uri", "Expected URI string");
@@ -180,15 +336,24 @@ var createEchoReferenceSchema = (echoUri, typename, version) => {
   });
   return refSchema;
 };
+var makeSettledRequest = (state, result) => ({
+  state,
+  stateChanged: new Event(),
+  getResult: () => state === "ready" ? result : void 0,
+  wait: async () => state === "ready" ? result : void 0,
+  abort: () => {
+  }
+});
 var RefImpl = class _RefImpl {
+  [RefTypeId] = refVariance;
   #uri;
-  #resolver = void 0;
-  #resolved = new Event();
   /**
   * Target is set when the reference is created from a specific object.
   * In this case, the target might not be in the database.
   */
   #target = void 0;
+  #resolver = void 0;
+  #resolved = new Event();
   /**
   * Callback to issue a reactive notification when object is resolved.
   */
@@ -208,28 +373,31 @@ var RefImpl = class _RefImpl {
   /**
   * @inheritdoc
   */
-  get isAvailable() {
-    return this.#target !== void 0 || this.#resolver !== void 0;
-  }
-  /**
-  * @inheritdoc
-  */
   get target() {
     if (this.#target) {
       return this.#target;
     }
-    invariant(this.#resolver, "Resolver is not set", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 193, S: this, A: ["this.#resolver", "'Resolver is not set'"] });
+    invariant2(this.#resolver, "Resolver is not set", { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 201, S: this, A: ["this.#resolver", "'Resolver is not set'"] });
     return this.#resolver.resolveSync(this.#uri, true, this.#resolverCallback);
   }
   /**
   * @inheritdoc
   */
+  get isAvailable() {
+    return this.#target !== void 0 || this.#resolver !== void 0;
+  }
+  get atom() {
+    return refSimpleFamily(this);
+  }
+  /**
+  * @inheritdoc
+  */
   async load() {
     if (this.#target) {
       return this.#target;
     }
-    invariant(this.#resolver, "Resolver is not set", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 202, S: this, A: ["this.#resolver", "'Resolver is not set'"] });
-    const obj = await this.#resolver.resolve(this.#uri);
+    invariant2(this.#resolver, "Resolver is not set", { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 218, S: this, A: ["this.#resolver", "'Resolver is not set'"] });
+    const obj = await this.#resolver.resolveLegacy(this.#uri);
     if (obj == null) {
       throw new Error("Object not found");
     }
@@ -242,8 +410,8 @@ var RefImpl = class _RefImpl {
     if (this.#target) {
       return this.#target;
     }
-    invariant(this.#resolver, "Resolver is not set", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 215, S: this, A: ["this.#resolver", "'Resolver is not set'"] });
-    return await this.#resolver.resolve(this.#uri);
+    invariant2(this.#resolver, "Resolver is not set", { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 231, S: this, A: ["this.#resolver", "'Resolver is not set'"] });
+    return await this.#resolver.resolveLegacy(this.#uri);
   }
   /**
   * @inheritdoc
@@ -287,7 +455,6 @@ var RefImpl = class _RefImpl {
   [inspectCustom] = (depth, options, inspect) => {
     return this.toString();
   };
-  [RefTypeId] = refVariance;
   /**
   * Effect Hash trait. Required for MutableHashMap-based caches (e.g., Atom.family)
   * to deduplicate Ref instances that point to the same object.
@@ -301,12 +468,10 @@ var RefImpl = class _RefImpl {
   [Equal.symbol](that) {
     return that instanceof _RefImpl && this.#uri === that.uri;
   }
-  get atom() {
-    return refSimpleFamily(this);
+  pipe() {
+    return Pipeable.pipeArguments(this, arguments);
   }
   /**
-  * Internal method to set the resolver.
-  *
   * @internal
   */
   _setResolver(resolver) {
@@ -318,16 +483,13 @@ var RefImpl = class _RefImpl {
   _getSavedTarget() {
     return this.#target;
   }
-  pipe() {
-    return Pipeable.pipeArguments(this, arguments);
-  }
 };
 var setRefResolver = (ref, resolver) => {
-  invariant(ref instanceof RefImpl, "Ref is not an instance of RefImpl", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 292, S: void 0, A: ["ref instanceof RefImpl", "'Ref is not an instance of RefImpl'"] });
+  invariant2(ref instanceof RefImpl, "Ref is not an instance of RefImpl", { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 302, S: void 0, A: ["ref instanceof RefImpl", "'Ref is not an instance of RefImpl'"] });
   ref._setResolver(resolver);
 };
 var getRefSavedTarget = (ref) => {
-  invariant(ref instanceof RefImpl, "Ref is not an instance of RefImpl", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 298, S: void 0, A: ["ref instanceof RefImpl", "'Ref is not an instance of RefImpl'"] });
+  invariant2(ref instanceof RefImpl, "Ref is not an instance of RefImpl", { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 308, S: void 0, A: ["ref instanceof RefImpl", "'Ref is not an instance of RefImpl'"] });
   return ref._getSavedTarget();
 };
 var refVariance = {
@@ -350,21 +512,26 @@ var StaticRefResolver = class {
   }
   addSchema(input) {
     const schema = getStaticTypeSchema(input);
-    invariant(schema, "Type entity is missing its source schema", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 323, S: this, A: ["schema", "'Type entity is missing its source schema'"] });
+    invariant2(schema, "Type entity is missing its source schema", { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 333, S: this, A: ["schema", "'Type entity is missing its source schema'"] });
     const uri = getSchemaURI(schema);
-    invariant(uri, "Schema has no URI", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 325, S: this, A: ["uri", "'Schema has no URI'"] });
+    invariant2(uri, "Schema has no URI", { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 335, S: this, A: ["uri", "'Schema has no URI'"] });
     this.schemas.set(uri, schema);
     return this;
   }
+  resolve(uri, _options) {
+    const obj = this.#lookup(uri);
+    return makeSettledRequest(obj ? "ready" : "unavailable", obj);
+  }
   resolveSync(uri, _load, _onLoad) {
-    const echoUri = EID.tryParse(uri);
-    const id = echoUri ? EID.getEntityId(echoUri) : void 0;
-    if (id == null) {
-      return void 0;
-    }
-    return this.objects.get(id);
+    return this.#lookup(uri);
+  }
+  async resolveLegacy(uri) {
+    return this.#lookup(uri);
+  }
+  async resolveSchema(uri) {
+    return this.schemas.get(uri);
   }
-  async resolve(uri) {
+  #lookup(uri) {
     const echoUri = EID.tryParse(uri);
     const id = echoUri ? EID.getEntityId(echoUri) : void 0;
     if (id == null) {
@@ -372,12 +539,24 @@ var StaticRefResolver = class {
     }
     return this.objects.get(id);
   }
-  async resolveSchema(uri) {
-    return this.schemas.get(uri);
-  }
 };
 
 export {
+  symbolIsProxy,
+  symbolReactivePrototype,
+  isProxy,
+  isReactiveRecord,
+  isValidProxyTarget,
+  getProxySlot,
+  getProxyTarget,
+  getProxyHandler,
+  normalizeSpliceRange,
+  dangerouslySetProxyId,
+  createProxy,
+  EventId,
+  ChangeId,
+  subscribe,
+  change,
   loadRefTarget,
   JSON_SCHEMA_ECHO_REF_ID,
   getSchemaReference,
@@ -386,10 +565,11 @@ export {
   RefTypeId,
   Ref,
   createEchoReferenceSchema,
+  makeSettledRequest,
   RefImpl,
   setRefResolver,
   getRefSavedTarget,
   refFromEncodedReference,
   StaticRefResolver
 };
-//# sourceMappingURL=chunk-WTQJHC75.mjs.map
+//# sourceMappingURL=chunk-L3E5IXAE.mjs.map

package/dist/lib/neutral/chunk-L3E5IXAE.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/internal/common/proxy/proxy-utils.ts", "../../../src/internal/common/proxy/symbols.ts", "../../../src/internal/common/proxy/reactive.ts", "../../../src/internal/Ref/ref.ts", "../../../src/internal/Ref/atoms.ts", "../../../src/internal/Ref/utils.ts"],
+  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { invariant } from '@dxos/invariant';\n\nimport { type ReactiveHandler } from './proxy-types';\n\nexport const symbolIsProxy = Symbol.for('@dxos/schema/Proxy');\n\n/**\n * Marker placed on a reactive-object behaviour prototype (e.g. the typed handler's\n * `TypedObject` prototype). A record target whose prototype chain carries this marker\n * is a reactive data record — equivalent, for the purposes of the \"plain object\" gates\n * below, to one rooted directly at `Object.prototype`. This lets a handler move its\n * per-object metadata onto an intermediate prototype without those gates mistaking the\n * record for a foreign class instance.\n */\nexport const symbolReactivePrototype = Symbol.for('@dxos/echo/ReactivePrototype');\n\n/**\n * Internal api.\n */\nexport const isProxy = (value: unknown) => !!(value as any)?.[symbolIsProxy];\n\n/**\n * True if `value` is a plain data record — either rooted at `Object.prototype` or carrying\n * a reactive behaviour prototype (see {@link symbolReactivePrototype}).\n */\nexport const isReactiveRecord = (value: any): boolean => {\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || (proto != null && !!proto[symbolReactivePrototype]);\n};\n\nexport const isValidProxyTarget = (value: any): value is object => {\n  if (value == null || value[symbolIsProxy]) {\n    return false;\n  }\n  if (Array.isArray(value)) {\n    return true;\n  }\n\n  return typeof value === 'object' && isReactiveRecord(value);\n};\n\n/**\n * @deprecated\n */\nexport const getProxySlot = <T extends object>(proxy: any): ProxyHandlerSlot<T> => {\n  const value = (proxy as any)[symbolIsProxy];\n  invariant(value instanceof ProxyHandlerSlot);\n  return value;\n};\n\nexport const getProxyTarget = <T extends object>(proxy: any): T => {\n  return getProxySlot<T>(proxy).target;\n};\n\nexport const getProxyHandler = <T extends object>(proxy: any): ReactiveHandler<T> => {\n  return getProxySlot<T>(proxy).handler;\n};\n\n/**\n * Clamp a splice range to `Array.prototype.splice` semantics for a string of the given `length`:\n * a negative `start` counts from the end, a `start` past the end appends, and `deleteCount` is bounded\n * to the remaining characters. Shared by both reactive handlers so the string CRDT API behaves\n * identically across the in-memory and Automerge backends (Automerge's `splice` otherwise throws on\n * out-of-range indices).\n */\nexport const normalizeSpliceRange = (\n  length: number,\n  start: number,\n  deleteCount: number,\n): { start: number; deleteCount: number } => {\n  const safeStart = start < 0 ? Math.max(length + start, 0) : Math.min(start, length);\n  const safeDeleteCount = Math.max(0, Math.min(deleteCount, length - safeStart));\n  return { start: safeStart, deleteCount: safeDeleteCount };\n};\n\n/**\n * Unsafe method to override id for debugging/testing and migration purposes.\n * @deprecated\n */\nexport const dangerouslySetProxyId = <T>(obj: T, id: string) => {\n  (getProxySlot(obj).target as any).id = id;\n};\n\n/**\n * Create a reactive proxy object.\n * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy\n *\n * @param target Object or array. Passing in array will enable array methods.\n * @param handler ReactiveHandler instance.\n */\n// TODO(burdon): Document.\n// TODO(burdon): Tests for low-level functions.\nexport const createProxy = <T extends object>(target: T, handler: ReactiveHandler<T>): T => {\n  const existingProxy = handler._proxyMap.get(target);\n  if (existingProxy) {\n    return existingProxy;\n  }\n\n  // TODO(dmaretskyi): In the future this should be mutable to allow replacing the handler on-the-fly while maintaining the proxy identity.\n  const proxy = new Proxy(target, new ProxyHandlerSlot<T>(target, handler));\n  handler.init(target);\n\n  // TODO(dmaretskyi): Check if this will actually work; maybe a global WeakMap is better?\n  handler._proxyMap.set(target, proxy);\n  return proxy;\n};\n\n/**\n * Passed as the handler to the Proxy constructor.\n * Maintains a mutable slot for the actual handler.\n */\nclass ProxyHandlerSlot<T extends object> implements ProxyHandler<T> {\n  /**\n   * @param target Original object.\n   * @param _handler Handles intercepted operations.\n   */\n  constructor(\n    readonly target: T,\n    private _handler: ReactiveHandler<T>,\n  ) {}\n\n  get handler() {\n    invariant(this._handler);\n    return this._handler;\n  }\n\n  // TODO(burdon): Requires comment.\n  setHandler(handler: ReactiveHandler<T>): void {\n    this._handler = handler;\n  }\n\n  /**\n   * Get value.\n   */\n  get(target: T, prop: string | symbol, receiver: any): any {\n    if (prop === symbolIsProxy) {\n      return this;\n    }\n\n    if (!this._handler || !this._handler.get) {\n      return Reflect.get(target, prop, receiver);\n    }\n\n    return this._handler.get(target, prop, receiver);\n  }\n\n  static {\n    const TRAPS: (keyof ProxyHandler<any>)[] = [\n      'apply',\n      'construct',\n      'defineProperty',\n      'deleteProperty',\n      'get',\n      'getOwnPropertyDescriptor',\n      'getPrototypeOf',\n      'has',\n      'isExtensible',\n      'ownKeys',\n      'preventExtensions',\n      'set',\n      'setPrototypeOf',\n    ];\n\n    for (const trap of TRAPS) {\n      if (trap === 'get') {\n        continue;\n      }\n\n      Object.defineProperty(this.prototype, trap, {\n        enumerable: false,\n        value: function (this: ProxyHandlerSlot<any>, ...args: any[]) {\n          // log.info('trap', { trap, args });\n          if (!this._handler || !this._handler[trap]) {\n            return (Reflect[trap] as Function)(...args);\n          }\n\n          return (this._handler[trap] as Function).apply(this._handler, args);\n        },\n      });\n    }\n  }\n}\n", "//\n// Copyright 2024 DXOS.org\n//\n\n// TODO(dmaretskyi): Rename all symbols that are props to end with *Key.\nexport const EventId = Symbol.for('@dxos/live-object/EventId');\nexport const ChangeId = Symbol.for('@dxos/live-object/ChangeId');\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type RefTypeId } from '../../Ref/ref';\nimport { getProxyTarget, isProxy } from './proxy-utils';\nimport { ChangeId, EventId } from './symbols';\n\n/**\n * Subscribe to changes on a reactive object.\n * @param obj - The reactive object to subscribe to.\n * @param callback - Called when the object changes.\n * @returns Unsubscribe function.\n */\n// TODO(wittjosiah): Consider throwing if obj doesn't have EventId instead of returning no-op.\nexport const subscribe = (obj: unknown, callback: () => void): (() => void) => {\n  // Guard against non-reactive inputs (queue-stored typed objects, snapshots, plain shapes\n  // with branded symbols) before `getProxyTarget`'s `ProxyHandlerSlot` invariant kicks in.\n  // `Obj.isObject` (KindId-based) is satisfied by these inputs, so callers like\n  // `Atom.family((obj) => Atom.make((get) => Obj.subscribe(obj, ...)))` legitimately reach\n  // here with a non-proxy. Falling back to a no-op preserves the documented contract that\n  // values without subscription support get a no-op unsubscribe.\n  if (!isProxy(obj)) {\n    return () => {};\n  }\n  const target = getProxyTarget(obj as any);\n  if (target && EventId in target) {\n    return (target as any)[EventId].on(callback);\n  }\n  return () => {};\n};\n\n/**\n * Deeply removes readonly modifiers from all properties of T.\n * Inside Obj.update, all properties are fully mutable regardless of schema definition.\n * Ref types are preserved as-is since they are value-like objects that are replaced, not mutated.\n * Primitive types (including branded primitives) are preserved as-is.\n */\nexport type Mutable<T> = T extends string | number | boolean | bigint | symbol | null | undefined\n  ? T // Primitives (including branded primitives like JsonPath) stay as-is.\n  : T extends { [RefTypeId]: any }\n    ? T // Keep Ref types as-is (they're value-like, not mutated in place).\n    : T extends object\n      ? T extends readonly (infer U)[]\n        ? Mutable<U>[]\n        : { -readonly [K in keyof T]: Mutable<T[K]> }\n      : T;\n\n/**\n * Callback type for the change function.\n */\nexport type ChangeCallback<T> = (mutableObj: Mutable<T>) => void;\n\n/**\n * Perform mutations on a reactive object within a change context.\n *\n * If the object has a change handler (via ChangeId), it will be called with the callback.\n * This allows handlers to implement features like:\n * - Readonly enforcement (mutations only allowed within change context)\n * - Batched notifications (single notification for all mutations in the callback)\n * - Transaction semantics\n *\n * If the object doesn't have a change handler, the callback is called directly.\n *\n * @param obj - The reactive object to mutate.\n * @param callback - Callback that receives a mutable view of the object.\n */\nexport const change = <T>(obj: T, callback: ChangeCallback<T>): void => {\n  // Check proxy first (allows handler to intercept), then fall back to target.\n  // This order is important for EchoReactiveHandler which handles ChangeId in the proxy trap.\n  const changeFn = (obj as any)[ChangeId];\n  if (changeFn) {\n    changeFn(callback);\n  } else {\n    callback(obj as Mutable<T>);\n  }\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport type * as Atom from '@effect-atom/atom/Atom';\nimport * as Effect from 'effect/Effect';\nimport * as Equal from 'effect/Equal';\nimport * as Hash from 'effect/Hash';\nimport * as Option from 'effect/Option';\nimport * as ParseResult from 'effect/ParseResult';\nimport * as Pipeable from 'effect/Pipeable';\nimport * as Schema from 'effect/Schema';\nimport * as SchemaAST from 'effect/SchemaAST';\nimport type * as Types from 'effect/Types';\n\nimport { Event } from '@dxos/async';\nimport { type CustomInspectFunction, inspectCustom } from '@dxos/debug';\nimport { EncodedReference } from '@dxos/echo-protocol';\nimport { assertArgument, invariant } from '@dxos/invariant';\nimport { DXN, EID, EntityId, type URI } from '@dxos/keys';\n\nimport * as Database from '../../Database';\nimport type * as Type from '../../Type';\nimport {\n  ReferenceAnnotationId,\n  getSchemaURI,\n  getTypeAnnotation,\n  getTypeIdentifierAnnotation,\n} from '../Annotation/annotations';\nimport { type AnyEntity, type AnyProperties, type UnknownTypeSchema, getStaticTypeSchema } from '../common/types';\nimport { type JsonSchemaType } from '../JsonSchema';\nimport * as RefAtoms from './atoms';\n\n/**\n * The `$id` and `$ref` fields for an ECHO reference schema.\n */\nexport const JSON_SCHEMA_ECHO_REF_ID = '/schemas/echo/ref';\n\nexport const getSchemaReference = (property: JsonSchemaType): { typename: string } | undefined => {\n  const { $id, reference: { schema: { $ref } = {} } = {} } = property;\n  if ($id === JSON_SCHEMA_ECHO_REF_ID && $ref) {\n    const parsed = DXN.tryMake($ref);\n    const typename = parsed ? DXN.getName(parsed) : undefined;\n    return typename ? { typename } : undefined;\n  }\n};\n\nexport const createSchemaReference = (typename: string): Types.DeepMutable<JsonSchemaType> => {\n  return {\n    $id: JSON_SCHEMA_ECHO_REF_ID,\n    reference: {\n      schema: {\n        $ref: DXN.make(typename),\n      },\n    },\n  };\n};\n\n/**\n * Runtime type-info for a reference extracted from effect AST.\n */\nexport type RefereneAST = {\n  /**\n   * Typename of linked schema.\n   */\n  typename: string;\n\n  /**\n   * Version of linked schema.\n   */\n  version: string;\n};\n\nexport const getReferenceAst = (ast: SchemaAST.AST): RefereneAST | undefined => {\n  if (ast._tag !== 'Declaration' || !ast.annotations[ReferenceAnnotationId]) {\n    return undefined;\n  }\n  return {\n    typename: (ast.annotations[ReferenceAnnotationId] as any).typename,\n    version: (ast.annotations[ReferenceAnnotationId] as any).version,\n  };\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const RefTypeId: unique symbol = Symbol.for('@dxos/echo/internal/Ref') as any;\n\n/**\n * Reference Schema.\n */\nexport interface RefSchema<T extends AnyEntity> extends Schema.SchemaClass<Ref<T>, EncodedReference> {}\n\n/**\n * Type of the `Ref` function and extra methods attached to it.\n */\nexport interface RefFn {\n  // A reference target is a `Type.AnyEntity` entity (the canonical Option B\n  // input) or one of the well-known \"any object\" / \"any relation\" branded\n  // schemas (`Obj.Unknown` / `Relation.Unknown`). Arbitrary raw schemas are\n  // rejected.\n  //\n  // Referencing a type-kind entity (a meta-schema, e.g. `Type.Type`) yields a\n  // reference to a stored schema record; its loaded target is any registered\n  // entity (`Type.AnyEntity`), since a stored object/relation schema is itself a\n  // `Type.Type` record. Referencing an object/relation type yields a reference\n  // to an instance of that type.\n  <S extends Type.AnyEntity | UnknownTypeSchema<any, any> = Type.AnyEntity>(\n    schema: S,\n  ): RefSchema<\n    S extends Type.AnyType\n      ? Type.AnyEntity\n      : S extends Type.AnyObj | Type.AnyRelation\n        ? Type.InstanceType<S>\n        : S extends UnknownTypeSchema<infer A, any>\n          ? A\n          : never\n  >;\n\n  /**\n   * @returns True if the object is a reference.\n   */\n  isRef: (obj: unknown) => obj is Ref<any>;\n\n  /**\n   * @returns True if the reference points to the given object id.\n   */\n  hasEntityId: (id: EntityId) => (ref: Ref<any>) => boolean;\n\n  /**\n   * @returns True if the schema is a reference schema.\n   */\n  isRefSchema: (schema: Schema.Schema<any, any>) => schema is RefSchema<any>;\n\n  /**\n   * @returns True if the schema AST is a reference schema.\n   */\n  isRefSchemaAST: (ast: SchemaAST.AST) => boolean;\n\n  /**\n   * Constructs a reference that points to the given object.\n   */\n  // TODO(burdon): Narrow to Obj.Unknown?\n  make: <T extends AnyEntity>(object: T) => Ref<T>;\n\n  /**\n   * Constructs a reference that points to the object specified by the provided URI\n   * (either an `echo:` EID for an object reference or a `dxn:` DXN for a type reference).\n   */\n  fromURI: (uri: URI.URI) => Ref<any>;\n}\n\n/**\n * Schema builder for references.\n */\nexport const Ref: RefFn = (input: any): RefSchema<any> => {\n  // `Type.Type` entities carry their source schema on the hidden slot; the\n  // branded `Obj.Unknown` / `Relation.Unknown` schemas are used directly.\n  const schema = getStaticTypeSchema(input) ?? input;\n  assertArgument(Schema.isSchema(schema), 'schema', 'Must call with an instance of effect-schema');\n  const annotation = getTypeAnnotation(schema);\n  if (annotation == null) {\n    throw new Error('Reference target must be an ECHO schema.');\n  }\n\n  return createEchoReferenceSchema(getTypeIdentifierAnnotation(schema), annotation.typename, annotation.version);\n};\n\n/**\n * Represents materialized reference to a target.\n * This is the data type for the fields marked as ref.\n */\nexport interface Ref<T> extends Pipeable.Pipeable {\n  /**\n   * Target URI (either an `echo:` EID for an object reference or a `dxn:` DXN for a type reference).\n   */\n  get uri(): URI.URI;\n\n  /**\n   * Returns true if the reference has a target available (inlined or resolver set).\n   */\n  get isAvailable(): boolean;\n\n  /**\n   * @returns The reference target.\n   * May return `undefined` if the object is not loaded in the working set.\n   * Accessing this property, even if it returns `undefined` will trigger the object to be loaded to the working set.\n   */\n  get target(): T | undefined;\n\n  /**\n   * @returns Promise that will resolves with the target object.\n   * Will load the object from disk if it is not present in the working set.\n   * Short-circuits immediately when the target is already loaded.\n   * @throws If the object is not available locally.\n   *\n   * @idiom org.dxos.echo.refLoad\n   *   applies: Resolving a ref inside an async function or Effect handler — guarantees the object is available before proceeding\n   *   instead-of: `ref.target` — not guaranteed to be defined in async contexts; use `await ref.load()` (or `yield* Database.load(ref)` in Effect) to ensure the target is present\n   *   uses: {@link load}\n   *   related: org.dxos.echo-react.useObjectReactive\n   */\n  load(): Promise<T>;\n\n  /**\n   * @returns Promise that will resolves with the target object or undefined if the object is not loaded locally.\n   */\n\n  tryLoad(): Promise<T | undefined>;\n\n  /**\n   * Subscribe to the ref's resolution event.\n   * The callback fires when the target object becomes available in the working set\n   * (e.g. when its document is loaded after sibling-client mutation).\n   * Note: the resolver only schedules a notification when the target is requested\n   * via {@link target} while it is not yet loaded.\n   * @returns Function that unsubscribes the callback.\n   */\n  onResolved(callback: () => void): () => void;\n\n  /**\n   * Do not inline the target object in the reference.\n   * Makes .target unavailable unless the reference is connected to a database context.\n   *\n   * When serialized with toJSON, the difference is between:\n   * `{ \"/\": \"dxn:...\" }`\n   * and\n   * `{ \"/\": \"dxn:...\", \"target\": { ... } }`\n   *\n   * Clones the reference object.\n   */\n  noInline(): Ref<T>;\n\n  /**\n   * Read-only atom for the ref target.\n   * Resolves once when the target loads; does NOT subscribe to target object mutations.\n   * Use `Obj.atom(ref)` if you need reactive snapshots that update on every object mutation.\n   */\n  get atom(): Atom.Atom<T | undefined>;\n\n  /**\n   * Serializes the reference to a JSON object.\n   * The serialization format is compatible with the IPLD-style encoded references.\n   * When a reference has a saved target (i.e. the target or object holding the reference is not in the database),\n   * the target is included in the serialized object.\n   *\n   * Examples:\n   * `{ \"/\": \"dxn:...\" }`\n   * `{ \"/\": \"dxn:...\", \"target\": { ... } }`\n   */\n  encode(): EncodedReference;\n\n  [RefTypeId]: {\n    _T: T;\n  };\n}\n\nexport declare namespace Ref {\n  /**\n   * Target of the reference.\n   */\n  export type Target<R> = R extends Ref<infer U> ? U : never;\n}\n\nRef.isRef = (obj: any): obj is Ref<any> => {\n  return obj != null && typeof obj === 'object' && RefTypeId in obj;\n};\n\nRef.hasEntityId = (id: EntityId) => (ref: Ref<any>) => {\n  const uri = EID.tryParse(ref.uri);\n  return uri !== undefined && EID.isLocal(uri) && EID.getEntityId(uri) === id;\n};\n\nRef.isRefSchema = (schema: Schema.Schema<any, any>): schema is RefSchema<any> => {\n  return Ref.isRefSchemaAST(schema.ast);\n};\n\nRef.isRefSchemaAST = (ast: SchemaAST.AST): boolean => {\n  return SchemaAST.getAnnotation(ast, ReferenceAnnotationId).pipe(Option.isSome);\n};\n\nRef.make = <T extends AnyProperties>(obj: T): Ref<T> => {\n  if (typeof obj !== 'object' || obj === null) {\n    throw new TypeError('Expected: ECHO object.');\n  }\n\n  // TODO(dmaretskyi): Extract to `getObjectEchoUri` function.\n  const id = obj.id;\n  invariant(EntityId.isValid(id), 'Invalid object ID');\n  const uri = EID.make({ entityId: id });\n  const ref = new RefImpl(uri, obj);\n  return ref;\n};\n\nRef.fromURI = (uri: URI.URI): Ref<any> => {\n  assertArgument(typeof uri === 'string', 'uri', 'Expected URI string');\n  return new RefImpl(uri);\n};\n\n/**\n * `reference` field on the schema object.\n */\nexport type JsonSchemaReferenceInfo = {\n  schema: { $ref: string };\n  schemaVersion?: string;\n};\n\n/**\n * @internal\n */\n// TODO(burdon): Move to json schema and make private?\nexport const createEchoReferenceSchema = (\n  echoUri: string | undefined,\n  typename: string | undefined,\n  version: string | undefined,\n): Schema.SchemaClass<Ref<any>, EncodedReference> => {\n  if (!echoUri && !typename) {\n    throw new TypeError('Either echoUri or typename must be provided.');\n  }\n\n  const referenceInfo: JsonSchemaReferenceInfo = {\n    schema: {\n      // TODO(dmaretskyi): Include version?\n      $ref: echoUri ?? DXN.make(typename!),\n    },\n    schemaVersion: version,\n  };\n\n  // TODO(dmaretskyi): Add name and description.\n  const refSchema = Schema.declare<Ref<any>, EncodedReference, []>(\n    [],\n    {\n      encode: () => {\n        return (value) =>\n          Effect.gen(function* () {\n            if (Ref.isRef(value)) {\n              return EncodedReference.fromURI((value as Ref<any>).uri);\n            } else if (EncodedReference.isEncodedReference(value)) {\n              return value;\n            }\n            throw new Error('Invalid reference');\n          });\n      },\n      decode: () => {\n        return (value) =>\n          Effect.gen(function* () {\n            const dbService = yield* Effect.serviceOption(Database.Service);\n\n            // TODO(dmaretskyi): This branch seems to be taken by Schema.is\n            if (Ref.isRef(value)) {\n              if (Option.isSome(dbService)) {\n                return dbService.value.db.makeRef(value.uri);\n              } else {\n                return value;\n              }\n            }\n\n            if (!EncodedReference.isEncodedReference(value)) {\n              return yield* Effect.fail(new ParseResult.Unexpected(value, 'reference'));\n            }\n            if (Option.isSome(dbService)) {\n              return dbService.value.db.makeRef(EncodedReference.toURI(value));\n            } else {\n              return Ref.fromURI(EncodedReference.toURI(value));\n            }\n          });\n      },\n    },\n    {\n      jsonSchema: {\n        // TODO(dmaretskyi): We should remove `$id` and keep `$ref` with a fully qualified name.\n        $id: JSON_SCHEMA_ECHO_REF_ID,\n        $ref: JSON_SCHEMA_ECHO_REF_ID,\n        reference: referenceInfo,\n      },\n      [ReferenceAnnotationId]: {\n        typename: typename ?? '',\n        version,\n      },\n    },\n  );\n\n  return refSchema;\n};\n\nconst getSchemaExpectedName = (ast: SchemaAST.Annotated): string | undefined => {\n  return SchemaAST.getIdentifierAnnotation(ast).pipe(\n    Option.orElse(() => SchemaAST.getTitleAnnotation(ast)),\n    Option.orElse(() => SchemaAST.getDescriptionAnnotation(ast)),\n    Option.getOrElse(() => undefined),\n  );\n};\n\n/**\n * Load-source ceiling for a resolution request. Cheaper tiers are always probed first; the\n * ceiling caps how far a request is allowed to reach:\n * - `working-set`: synchronous, in-memory only. A miss settles `unavailable` immediately.\n * - `disk`: probe the working set, then local storage; never the network.\n * - `network`: probe the working set, disk, then fetch from peers.\n *\n * `unavailable` is always relative to the requested ceiling (disk-unavailable ≠ network-unavailable).\n */\nexport type RefSource = 'working-set' | 'disk' | 'network';\n\n/**\n * A stateful, closure-aware handle to an in-flight (or settled) reference resolution.\n *\n * `ready` means the entity is FULLY USABLE: its own body and its strong-dependency closure are all\n * materialized. The body-vs-closure split is internal; `requesting` transparently covers \"a\n * dependency is still loading\".\n */\nexport interface RefResolverRequest {\n  /**\n   * `pending` is a one-way entry state (never re-entered). `requesting` means the body and/or\n   * closure is still loading. `ready` means fully usable. `unavailable` means unreachable at the\n   * requested ceiling.\n   */\n  readonly state: 'pending' | 'requesting' | 'ready' | 'unavailable';\n\n  /**\n   * Fires (deferred to a microtask) whenever {@link state} changes.\n   */\n  readonly stateChanged: Event<void>;\n\n  /**\n   * Synchronous snapshot of the resolved entity; defined iff `state === 'ready'`.\n   */\n  getResult(): AnyProperties | undefined;\n\n  /**\n   * Settles when `state ∈ {ready, unavailable}`.\n   */\n  wait(): Promise<AnyProperties | undefined>;\n\n  /**\n   * Decrements the refcount on the shared load op(s); cancels the underlying IO at zero.\n   */\n  abort(): void;\n}\n\nexport interface RefResolver {\n  /**\n   * Resolve a reference, returning a stateful handle. `source` is a required ceiling; cheaper\n   * tiers are always probed first.\n   */\n  resolve(uri: URI.URI, options: { source: RefSource }): RefResolverRequest;\n\n  /**\n   * Resolve ref synchronously from the objects in the working set.\n   *\n   * @param uri\n   * @param load If true the resolver should attempt to load the object from disk.\n   * @param onLoad Callback to call when the object is loaded.\n   * @deprecated Use {@link resolve} with `{ source: 'working-set' }`. Removed in Task 11.\n   */\n  resolveSync(uri: URI.URI, load: boolean, onLoad?: () => void): AnyProperties | undefined;\n\n  /**\n   * Resolver ref asynchronously.\n   * @deprecated Use {@link resolve} with `{ source: 'network' }`. Removed in Task 11.\n   */\n  resolveLegacy(uri: URI.URI): Promise<AnyProperties | undefined>;\n\n  /**\n   * @deprecated Use {@link resolve} + `Type.getSchema`. Removed in Task 11.\n   */\n  resolveSchema(uri: URI.URI): Promise<Schema.Schema.AnyNoContext | undefined>;\n\n  /**\n   * Resolve the source `Type.AnyEntity` entity for a type URI. Used by\n   * deserialization paths (`Obj.fromJSON`) to set the back-reference accessed\n   * via `Obj.getType` / `Entity.getType`. Optional — resolvers that only\n   * carry raw schemas may leave this unimplemented; the deserializer falls\n   * back to leaving the type entity unset.\n   * @deprecated Use {@link resolve}. Removed in Task 11.\n   */\n  resolveType?(uri: URI.URI): Promise<unknown | undefined>;\n}\n\n/**\n * A settled {@link RefResolverRequest} with a fixed `state` and `result`, used by resolvers\n * whose backends are fully synchronous (e.g. {@link StaticRefResolver}).\n */\nexport const makeSettledRequest = (\n  state: RefResolverRequest['state'],\n  result: AnyProperties | undefined,\n): RefResolverRequest => ({\n  state,\n  stateChanged: new Event<void>(),\n  getResult: () => (state === 'ready' ? result : undefined),\n  wait: async () => (state === 'ready' ? result : undefined),\n  abort: () => {},\n});\n\nexport class RefImpl<T> implements Ref<T> {\n  [RefTypeId] = refVariance;\n\n  #uri: URI.URI;\n\n  /**\n   * Target is set when the reference is created from a specific object.\n   * In this case, the target might not be in the database.\n   */\n  #target: T | undefined = undefined;\n\n  #resolver?: RefResolver = undefined;\n  #resolved = new Event<void>();\n\n  /**\n   * Callback to issue a reactive notification when object is resolved.\n   */\n  #resolverCallback = () => {\n    this.#resolved.emit();\n  };\n\n  constructor(uri: URI.URI, target?: T) {\n    this.#uri = uri;\n    this.#target = target;\n  }\n\n  /**\n   * @inheritdoc\n   */\n  get uri(): URI.URI {\n    return this.#uri;\n  }\n\n  /**\n   * @inheritdoc\n   */\n  get target(): T | undefined {\n    if (this.#target) {\n      return this.#target;\n    }\n\n    invariant(this.#resolver, 'Resolver is not set');\n    return this.#resolver.resolveSync(this.#uri, true, this.#resolverCallback) as T | undefined;\n  }\n\n  /**\n   * @inheritdoc\n   */\n  get isAvailable(): boolean {\n    return this.#target !== undefined || this.#resolver !== undefined;\n  }\n\n  get atom(): Atom.Atom<T | undefined> {\n    return RefAtoms.refSimpleFamily(this);\n  }\n\n  /**\n   * @inheritdoc\n   */\n  async load(): Promise<T> {\n    if (this.#target) {\n      return this.#target;\n    }\n    invariant(this.#resolver, 'Resolver is not set');\n    const obj = await this.#resolver.resolveLegacy(this.#uri);\n    if (obj == null) {\n      throw new Error('Object not found');\n    }\n    return obj as T;\n  }\n\n  /**\n   * @inheritdoc\n   */\n  async tryLoad(): Promise<T | undefined> {\n    if (this.#target) {\n      return this.#target;\n    }\n    invariant(this.#resolver, 'Resolver is not set');\n    return (await this.#resolver.resolveLegacy(this.#uri)) as T | undefined;\n  }\n\n  /**\n   * @inheritdoc\n   */\n  onResolved(callback: () => void): () => void {\n    return this.#resolved.on(callback);\n  }\n\n  /**\n   * Do not inline the target object in the reference.\n   * Makes .target unavailable unless the reference is connected to a database context.\n   * Clones the reference object.\n   */\n  noInline(): RefImpl<T> {\n    const ref = new RefImpl<T>(this.#uri, undefined);\n    ref.#resolver = this.#resolver;\n    return ref;\n  }\n\n  encode(): EncodedReference {\n    return {\n      '/': this.#uri,\n      ...(this.#target ? { target: this.#target } : {}),\n    };\n  }\n\n  /**\n   * Serializes the reference to a JSON object.\n   * The serialization format is compatible with the IPLD-style encoded references.\n   * When a reference has a saved target (i.e. the target or object holding the reference is not in the database),\n   * the target is included in the serialized object.\n   */\n  toJSON(): EncodedReference {\n    return this.encode();\n  }\n\n  toString(): string {\n    if (this.#target) {\n      return `Ref(${this.#target.toString()})`;\n    }\n\n    return `Ref(${this.#uri.toString()})`;\n  }\n\n  [inspectCustom]: CustomInspectFunction = (depth, options, inspect) => {\n    return this.toString();\n  };\n\n  /**\n   * Effect Hash trait. Required for MutableHashMap-based caches (e.g., Atom.family)\n   * to deduplicate Ref instances that point to the same object.\n   * ECHO proxies return new RefImpl instances on every property access,\n   * so without this, each access would create a separate cache entry.\n   */\n  [Hash.symbol](): number {\n    return Hash.hash(this.#uri.toString());\n  }\n\n  /** Effect Equal trait. See {@link Hash.symbol} for rationale. */\n  [Equal.symbol](that: Equal.Equal): boolean {\n    return that instanceof RefImpl && this.#uri === that.uri;\n  }\n\n  pipe() {\n    // eslint-disable-next-line prefer-rest-params\n    return Pipeable.pipeArguments(this, arguments);\n  }\n\n  /**\n   * @internal\n   */\n  _setResolver(resolver: RefResolver): void {\n    this.#resolver = resolver;\n  }\n\n  /**\n   * @internal\n   */\n  _getSavedTarget(): T | undefined {\n    return this.#target;\n  }\n}\n\n/**\n * Internal API for setting the reference resolver.\n */\nexport const setRefResolver = (ref: Ref<any>, resolver: RefResolver) => {\n  invariant(ref instanceof RefImpl, 'Ref is not an instance of RefImpl');\n  ref._setResolver(resolver);\n};\n\n/**\n * Internal API for getting the saved target on a reference.\n */\nexport const getRefSavedTarget = (ref: Ref<any>): AnyProperties | undefined => {\n  invariant(ref instanceof RefImpl, 'Ref is not an instance of RefImpl');\n  return ref._getSavedTarget();\n};\n\n// Used to validate reference target type.\nconst refVariance: Ref<any>[typeof RefTypeId] = {\n  _T: null as any,\n};\n\nexport const refFromEncodedReference = (encodedReference: EncodedReference, resolver?: RefResolver): Ref<any> => {\n  const uri = EncodedReference.toURI(encodedReference);\n  const ref = new RefImpl(uri);\n\n  // TODO(dmaretskyi): Handle inline target in the encoded reference.\n\n  if (resolver) {\n    setRefResolver(ref, resolver);\n  }\n  return ref;\n};\n\nexport class StaticRefResolver implements RefResolver {\n  public objects = new Map<EntityId, AnyProperties>();\n  public schemas = new Map<URI.URI, Schema.Schema.AnyNoContext>();\n\n  addObject(obj: AnyProperties): this {\n    this.objects.set(obj.id, obj);\n    return this;\n  }\n\n  addSchema(input: Type.AnyEntity): this {\n    const schema = getStaticTypeSchema(input);\n    invariant(schema, 'Type entity is missing its source schema');\n    const uri = getSchemaURI(schema);\n    invariant(uri, 'Schema has no URI');\n    this.schemas.set(uri, schema);\n    return this;\n  }\n\n  resolve(uri: URI.URI, _options: { source: RefSource }): RefResolverRequest {\n    const obj = this.#lookup(uri);\n    return makeSettledRequest(obj ? 'ready' : 'unavailable', obj);\n  }\n\n  resolveSync(uri: URI.URI, _load: boolean, _onLoad?: () => void): AnyProperties | undefined {\n    return this.#lookup(uri);\n  }\n\n  async resolveLegacy(uri: URI.URI): Promise<AnyProperties | undefined> {\n    return this.#lookup(uri);\n  }\n\n  async resolveSchema(uri: URI.URI): Promise<Schema.Schema.AnyNoContext | undefined> {\n    return this.schemas.get(uri);\n  }\n\n  #lookup(uri: URI.URI): AnyProperties | undefined {\n    const echoUri = EID.tryParse(uri);\n    const id = echoUri ? EID.getEntityId(echoUri) : undefined;\n    if (id == null) {\n      return undefined;\n    }\n    return this.objects.get(id);\n  }\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Atom from '@effect-atom/atom/Atom';\n\nimport { subscribe } from '../common/proxy/reactive';\nimport { ObjectDeletedId } from '../common/types/model-symbols';\nimport type { Ref } from './ref';\nimport { loadRefTarget } from './utils';\n\n/**\n * Atom family for ECHO refs.\n * Uses ref reference as key — same ref returns same atom.\n * Subscribes to target object changes and resolves to undefined when the target is deleted.\n */\nexport const refSimpleFamily = Atom.family(<T>(ref: Ref<T>): Atom.Atom<T | undefined> => {\n  return Atom.make<T | undefined>((get) => {\n    let unsubscribeTarget: (() => void) | undefined;\n\n    const setupSubscription = (target: T): T | undefined => {\n      // Release any previous subscription before re-subscribing (loadRefTarget may call this more than once).\n      // T has no ECHO-proxy constraint at this generic level; `subscribe` and ObjectDeletedId\n      // both require the internal proxy shape that cannot be expressed statically here.\n      unsubscribeTarget?.();\n      unsubscribeTarget = subscribe(target as any, () => {\n        const deleted = !!(target as any)[ObjectDeletedId];\n        get.setSelf(deleted ? undefined : target);\n      });\n      const deleted = !!(target as any)[ObjectDeletedId];\n      return deleted ? undefined : target;\n    };\n\n    get.addFinalizer(() => {\n      unsubscribeTarget?.();\n    });\n\n    return loadRefTarget(ref, get, setupSubscription);\n  });\n});\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport type * as Atom from '@effect-atom/atom/Atom';\n\nimport type { Ref } from './ref';\n\n/**\n * Internal helper for loading ref targets in atoms.\n * Handles the common pattern of checking for loaded target and triggering async load.\n */\nexport const loadRefTarget = <T, R>(\n  ref: Ref<T>,\n  get: Atom.Context,\n  onTargetAvailable: (target: T) => R,\n): R | undefined => {\n  // Accessing `ref.target` registers a resolution callback when the target is\n  // not yet loaded, so resolution can be observed via `ref.onResolved` below.\n  const currentTarget = ref.target;\n  if (currentTarget) {\n    return onTargetAvailable(currentTarget);\n  }\n\n  // Subscribe to the ref's resolution event in case the target loads later.\n  const unsubscribe = ref.onResolved(() => {\n    const target = ref.target;\n    if (target) {\n      get.setSelf(onTargetAvailable(target));\n    }\n  });\n  get.addFinalizer(unsubscribe);\n\n  // Also try async load (e.g. for objects that need disk loading).\n  void ref\n    .load()\n    .then((loadedTarget) => {\n      get.setSelf(onTargetAvailable(loadedTarget));\n    })\n    .catch(() => {\n      // Loading failed; the resolution subscription above will pick up cross-client updates.\n    });\n\n  return undefined;\n};\n"],
+  "mappings": "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",
+  "names": ["invariant", "symbolIsProxy", "proto", "prototype", "isValidProxyTarget", "value", "Array", "isArray", "ProxyHandlerSlot", "getProxyHandler", "safeDeleteCount", "Math", "deleteCount", "length", "start", "safeStart", "existingProxy", "handler", "_proxyMap", "set", "_handler", "setHandler", "get", "target", "prop", "receiver", "Object", "trap", "apply", "EventId", "Symbol", "for", "ChangeId", "subscribe", "obj", "callback", "isProxy", "target", "getProxyTarget", "EventId", "on", "change", "changeFn", "ChangeId", "Effect", "Equal", "Hash", "Option", "ParseResult", "Pipeable", "Schema", "SchemaAST", "Event", "inspectCustom", "EncodedReference", "assertArgument", "invariant", "DXN", "EID", "EntityId", "Atom", "loadRefTarget", "ref", "get", "onTargetAvailable", "currentTarget", "target", "unsubscribe", "onResolved", "setSelf", "addFinalizer", "load", "then", "loadedTarget", "catch", "undefined", "refSimpleFamily", "family", "ref", "make", "get", "unsubscribeTarget", "setupSubscription", "target", "subscribe", "deleted", "ObjectDeletedId", "setSelf", "undefined", "addFinalizer", "loadRefTarget", "__dxlog_file", "reference", "$ref", "$id", "JSON_SCHEMA_ECHO_REF_ID", "parsed", "tryMake", "typename", "getName", "undefined", "schema", "version", "annotation", "getTypeAnnotation", "Error", "createEchoReferenceSchema", "isRef", "obj", "hasEntityId", "ref", "uri", "isRefSchema", "isRefSchemaAST", "ast", "make", "TypeError", "EID", "entityId", "id", "fromURI", "RefImpl", "referenceInfo", "schemaVersion", "Effect", "gen", "EncodedReference", "value", "Ref", "dbService", "Option", "isSome", "jsonSchema", "ReferenceAnnotationId", "getSchemaExpectedName", "stateChanged", "Event", "getResult", "wait", "state", "abort", "RefImpl", "target", "invariant", "__dxlog_file", "atom", "obj", "Error", "ref", "encode", "toString", "inspectCustom", "depth", "options", "inspect", "pipe", "_setResolver", "resolver", "_getSavedTarget", "uri", "schemas", "addObject", "objects", "set", "addSchema", "input", "schema", "getSchemaURI", "resolve", "makeSettledRequest", "resolveSync", "_onLoad", "resolveLegacy", "resolveSchema", "id", "undefined"]
+}

package/dist/lib/neutral/{chunk-EVK6XBXO.mjs → chunk-PRC4FEKJ.mjs}

@@ -14,7 +14,7 @@ __export(Order_exports, {
 var OrderClass = class _OrderClass {
   ast;
   static "variance" = {};
-  static is(value) {
+  static "is"(value) {
     return typeof value === "object" && value !== null && "~Order" in value;
   }
   constructor(ast) {
@@ -53,4 +53,4 @@ export {
   created,
   Order_exports
 };
-//# sourceMappingURL=chunk-EVK6XBXO.mjs.map
+//# sourceMappingURL=chunk-PRC4FEKJ.mjs.map

package/dist/lib/neutral/chunk-PRC4FEKJ.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/Order.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport { type QueryAST } from '@dxos/echo-protocol';\n\nexport interface Order<T> {\n  // TODO(dmaretskyi): See new effect-schema approach to variance.\n  '~Order': { value: T };\n\n  'ast': QueryAST.Order;\n}\n\nexport type Any = Order<any>;\n\nclass OrderClass implements Order<any> {\n  private static 'variance': Order<any>['~Order'] = {} as Order<any>['~Order'];\n\n  static 'is'(value: unknown): value is Order<any> {\n    return typeof value === 'object' && value !== null && '~Order' in value;\n  }\n\n  'constructor'(public readonly ast: QueryAST.Order) {}\n\n  '~Order' = OrderClass.variance;\n}\n\nexport const natural: Order<any> = new OrderClass({ kind: 'natural' });\nexport const property = <T>(property: keyof T & string, direction: QueryAST.OrderDirection): Order<T> =>\n  new OrderClass({\n    kind: 'property',\n    property,\n    direction,\n  });\n\n/**\n * Order by relevance rank (for FTS/vector search results).\n * Higher rank = better match. Default direction is 'desc' (best matches first).\n */\nexport const rank = <T>(direction: QueryAST.OrderDirection = 'desc'): Order<T> =>\n  new OrderClass({\n    kind: 'rank',\n    direction,\n  });\n\n/**\n * Order by the system `updatedAt` timestamp (last re-indexed). Default direction is 'desc'\n * (most-recently-updated first). Mirrors {@link Filter.updated}.\n */\nexport const updated = <T>(direction: QueryAST.OrderDirection = 'desc'): Order<T> =>\n  new OrderClass({\n    kind: 'timestamp',\n    field: 'updatedAt',\n    direction,\n  });\n\n/**\n * Order by the system `createdAt` timestamp (first indexed). Default direction is 'desc'\n * (most-recently-created first). Mirrors {@link Filter.created}.\n */\nexport const created = <T>(direction: QueryAST.OrderDirection = 'desc'): Order<T> =>\n  new OrderClass({\n    kind: 'timestamp',\n    field: 'createdAt',\n    direction,\n  });\n"],
+  "mappings": ";;;;;AAAA;;;;;;;;AAiBA,IAAMA,aAAN,MAAMA,YAAAA;;EACJ,OAAe,aAAmC,CAAC;EAEnD,OAAO,KAAKC,OAAqC;AAC/C,WAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,YAAYA;EACpE;EAEA,YAA8BC,KAAqB;SAArBA,MAAAA;EAAsB;EAEpD,WAAWF,YAAWG;AACxB;AAEO,IAAMC,UAAsB,IAAIJ,WAAW;EAAEK,MAAM;AAAU,CAAA;AAC7D,IAAMC,WAAW,CAAIA,WAA4BC,cACtD,IAAIP,WAAW;EACbK,MAAM;EACNC,UAAAA;EACAC;AACF,CAAA;AAMK,IAAMC,OAAO,CAAID,YAAqC,WAC3D,IAAIP,WAAW;EACbK,MAAM;EACNE;AACF,CAAA;AAMK,IAAME,UAAU,CAAIF,YAAqC,WAC9D,IAAIP,WAAW;EACbK,MAAM;EACNK,OAAO;EACPH;AACF,CAAA;AAMK,IAAMI,UAAU,CAAIJ,YAAqC,WAC9D,IAAIP,WAAW;EACbK,MAAM;EACNK,OAAO;EACPH;AACF,CAAA;",
+  "names": ["OrderClass", "value", "ast", "variance", "natural", "kind", "property", "direction", "rank", "updated", "field", "created"]
+}

package/dist/lib/neutral/{chunk-6YDI3J37.mjs → chunk-SCT6FFCR.mjs}

@@ -1,13 +1,14 @@
 import {
   isRef
-} from "./chunk-MZ7K3MLL.mjs";
+} from "./chunk-FSGX2R62.mjs";
 import {
+  filterMatchEntity,
   prettyFilter
-} from "./chunk-7FPIAJIV.mjs";
+} from "./chunk-ACFAOTKJ.mjs";
 import {
   getTypeURIFromSpecifier,
   getUri
-} from "./chunk-R5W6DXR4.mjs";
+} from "./chunk-3TN2VMI4.mjs";
 import {
   __export
 } from "./chunk-J5LGTIGS.mjs";
@@ -40,9 +41,11 @@ __export(Filter_exports, {
   props: () => props,
   tag: () => tag,
   text: () => text,
+  toPredicate: () => toPredicate,
   type: () => type,
   updated: () => updated
 });
+import * as Function from "effect/Function";
 import * as Match from "effect/Match";
 import * as Schema from "effect/Schema";
 import * as SchemaAST from "effect/SchemaAST";
@@ -312,6 +315,7 @@ var processPredicate = (predicate) => {
   );
 };
 var pretty = (filter) => prettyFilter(filter.ast);
+var toPredicate = Function.dual(2, (entity, filter) => filterMatchEntity(filter.ast, entity));
 
 export {
   is,
@@ -341,6 +345,7 @@ export {
   and,
   or,
   pretty,
+  toPredicate,
   Filter_exports
 };
-//# sourceMappingURL=chunk-6YDI3J37.mjs.map
+//# sourceMappingURL=chunk-SCT6FFCR.mjs.map