@dxos/echo 0.8.4-main.ead640a → 0.8.4-main.effb148878

package/dist/types/src/internal/{ref → Ref}/ref.d.ts

@@ -1,9 +1,15 @@
+import * as Equal from 'effect/Equal';
+import * as Hash from 'effect/Hash';
+import * as Pipeable from 'effect/Pipeable';
 import * as Schema from 'effect/Schema';
 import * as SchemaAST from 'effect/SchemaAST';
-import { type EncodedReference } from '@dxos/echo-protocol';
-import { DXN, ObjectId } from '@dxos/keys';
-import { type JsonSchemaType } from '../json-schema';
-import type { BaseObject, WithId } from '../types';
+import type * as Types from 'effect/Types';
+import { type CustomInspectFunction, inspectCustom } from '@dxos/debug';
+import { EncodedReference } from '@dxos/echo-protocol';
+import { ObjectId, type URI } from '@dxos/keys';
+import type * as Type from '../../Type';
+import { type AnyEntity, type AnyProperties, type UnknownTypeSchema } from '../common/types';
+import { type JsonSchemaType } from '../JsonSchema';
 /**
  * The `$id` and `$ref` fields for an ECHO reference schema.
  */
@@ -11,7 +17,7 @@ export declare const JSON_SCHEMA_ECHO_REF_ID = "/schemas/echo/ref";
 export declare const getSchemaReference: (property: JsonSchemaType) => {
     typename: string;
 } | undefined;
-export declare const createSchemaReference: (typename: string) => JsonSchemaType;
+export declare const createSchemaReference: (typename: string) => Types.DeepMutable<JsonSchemaType>;
 /**
  * Runtime type-info for a reference extracted from effect AST.
  */
@@ -30,14 +36,17 @@ export declare const RefTypeId: unique symbol;
 /**
  * Reference Schema.
  */
-export interface Ref$<T extends WithId> extends Schema.SchemaClass<Ref<T>, EncodedReference> {
+export interface RefSchema<T extends AnyEntity> extends Schema.SchemaClass<Ref<T>, EncodedReference> {
 }
+/**
+ * Type of the `Ref` function and extra methods attached to it.
+ */
 export interface RefFn {
-    <S extends Schema.Schema.Any>(schema: S): Ref$<Schema.Schema.Type<S>>;
+    <S extends Type.AnyEntity | UnknownTypeSchema<any, any> = Type.AnyEntity>(schema: S): RefSchema<S extends Type.AnyType ? Type.AnyEntity : S extends Type.AnyObj | Type.AnyRelation ? Type.InstanceType<S> : S extends UnknownTypeSchema<infer A, any> ? A : never>;
     /**
      * @returns True if the object is a reference.
      */
-    isRef: (obj: any) => obj is Ref<any>;
+    isRef: (obj: unknown) => obj is Ref<any>;
     /**
      * @returns True if the reference points to the given object id.
      */
@@ -45,7 +54,7 @@ export interface RefFn {
     /**
      * @returns True if the schema is a reference schema.
      */
-    isRefSchema: (schema: Schema.Schema<any, any>) => schema is Ref$<any>;
+    isRefSchema: (schema: Schema.Schema<any, any>) => schema is RefSchema<any>;
     /**
      * @returns True if the schema AST is a reference schema.
      */
@@ -53,11 +62,12 @@ export interface RefFn {
     /**
      * Constructs a reference that points to the given object.
      */
-    make: <T extends WithId>(object: T) => Ref<T>;
+    make: <T extends AnyEntity>(object: T) => Ref<T>;
     /**
-     * Constructs a reference that points to the object specified by the provided DXN.
+     * Constructs a reference that points to the object specified by the provided URI
+     * (either an `echo:` EchoURI for an object reference or a `dxn:` DXN for a type reference).
      */
-    fromDXN: (dxn: DXN) => Ref<any>;
+    fromURI: (uri: URI.URI) => Ref<any>;
 }
 /**
  * Schema builder for references.
@@ -67,17 +77,19 @@ export declare const Ref: RefFn;
  * Represents materialized reference to a target.
  * This is the data type for the fields marked as ref.
  */
-export interface Ref<T> {
+export interface Ref<T> extends Pipeable.Pipeable {
     /**
-     * Target object DXN.
+     * Target URI (either an `echo:` EchoURI for an object reference or a `dxn:` DXN for a type reference).
      */
-    get dxn(): DXN;
+    get uri(): URI.URI;
+    /**
+     * Returns true if the reference has a target available (inlined or resolver set).
+     */
+    get isAvailable(): boolean;
     /**
      * @returns The reference target.
      * May return `undefined` if the object is not loaded in the working set.
      * Accessing this property, even if it returns `undefined` will trigger the object to be loaded to the working set.
-     *
-     * @reactive Supports signal subscriptions.
      */
     get target(): T | undefined;
     /**
@@ -90,6 +102,15 @@ export interface Ref<T> {
      * @returns Promise that will resolves with the target object or undefined if the object is not loaded locally.
      */
     tryLoad(): Promise<T | undefined>;
+    /**
+     * Subscribe to the ref's resolution event.
+     * The callback fires when the target object becomes available in the working set
+     * (e.g. when its document is loaded after sibling-client mutation).
+     * Note: the resolver only schedules a notification when the target is requested
+     * via {@link target} while it is not yet loaded.
+     * @returns Function that unsubscribes the callback.
+     */
+    onResolved(callback: () => void): () => void;
     /**
      * Do not inline the target object in the reference.
      * Makes .target unavailable unless the reference is connected to a database context.
@@ -136,24 +157,36 @@ export interface RefResolver {
     /**
      * Resolve ref synchronously from the objects in the working set.
      *
-     * @param dxn
+     * @param uri
      * @param load If true the resolver should attempt to load the object from disk.
      * @param onLoad Callback to call when the object is loaded.
      */
-    resolveSync(dxn: DXN, load: boolean, onLoad?: () => void): BaseObject | undefined;
+    resolveSync(uri: URI.URI, load: boolean, onLoad?: () => void): AnyProperties | undefined;
     /**
      * Resolver ref asynchronously.
      */
-    resolve(dxn: DXN): Promise<BaseObject | undefined>;
-    resolveSchema(dxn: DXN): Promise<Schema.Schema.AnyNoContext | undefined>;
+    resolve(uri: URI.URI): Promise<AnyProperties | undefined>;
+    resolveSchema(uri: URI.URI): Promise<Schema.Schema.AnyNoContext | undefined>;
+    /**
+     * Resolve the source `Type.AnyEntity` entity for a type URI. Used by
+     * deserialization paths (`Obj.fromJSON`) to set the back-reference accessed
+     * via `Obj.getType` / `Entity.getType`. Optional — resolvers that only
+     * carry raw schemas may leave this unimplemented; the deserializer falls
+     * back to leaving the type entity unset.
+     */
+    resolveType?(uri: URI.URI): Promise<unknown | undefined>;
 }
 export declare class RefImpl<T> implements Ref<T> {
     #private;
-    constructor(dxn: DXN, target?: T);
+    constructor(uri: URI.URI, target?: T);
     /**
      * @inheritdoc
      */
-    get dxn(): DXN;
+    get uri(): URI.URI;
+    /**
+     * @inheritdoc
+     */
+    get isAvailable(): boolean;
     /**
      * @inheritdoc
      */
@@ -166,6 +199,10 @@ export declare class RefImpl<T> implements Ref<T> {
      * @inheritdoc
      */
     tryLoad(): Promise<T | undefined>;
+    /**
+     * @inheritdoc
+     */
+    onResolved(callback: () => void): () => void;
     /**
      * Do not inline the target object in the reference.
      * Makes .target unavailable unless the reference is connected to a database context.
@@ -181,9 +218,20 @@ export declare class RefImpl<T> implements Ref<T> {
      */
     toJSON(): EncodedReference;
     toString(): string;
+    [inspectCustom]: CustomInspectFunction;
     [RefTypeId]: {
         _T: any;
     };
+    /**
+     * Effect Hash trait. Required for MutableHashMap-based caches (e.g., Atom.family)
+     * to deduplicate Ref instances that point to the same object.
+     * ECHO proxies return new RefImpl instances on every property access,
+     * so without this, each access would create a separate cache entry.
+     */
+    [Hash.symbol](): number;
+    /** Effect Equal trait. See {@link Hash.symbol} for rationale. */
+    [Equal.symbol](that: Equal.Equal): boolean;
+    pipe(): unknown;
 }
 /**
  * Internal API for setting the reference resolver.
@@ -192,15 +240,15 @@ export declare const setRefResolver: (ref: Ref<any>, resolver: RefResolver) => v
 /**
  * Internal API for getting the saved target on a reference.
  */
-export declare const getRefSavedTarget: (ref: Ref<any>) => BaseObject | undefined;
+export declare const getRefSavedTarget: (ref: Ref<any>) => AnyProperties | undefined;
 export declare const refFromEncodedReference: (encodedReference: EncodedReference, resolver?: RefResolver) => Ref<any>;
 export declare class StaticRefResolver implements RefResolver {
-    objects: Map<string, BaseObject>;
-    schemas: Map<DXN.String, Schema.Schema.AnyNoContext>;
-    addObject(obj: BaseObject): this;
-    addSchema(schema: Schema.Schema.AnyNoContext): this;
-    resolveSync(dxn: DXN, _load: boolean, _onLoad?: () => void): BaseObject | undefined;
-    resolve(dxn: DXN): Promise<BaseObject | undefined>;
-    resolveSchema(dxn: DXN): Promise<Schema.Schema.AnyNoContext | undefined>;
+    objects: Map<string, AnyProperties>;
+    schemas: Map<URI.URI, Schema.Schema.AnyNoContext>;
+    addObject(obj: AnyProperties): this;
+    addSchema(input: Type.AnyEntity): this;
+    resolveSync(uri: URI.URI, _load: boolean, _onLoad?: () => void): AnyProperties | undefined;
+    resolve(uri: URI.URI): Promise<AnyProperties | undefined>;
+    resolveSchema(uri: URI.URI): Promise<Schema.Schema.AnyNoContext | undefined>;
 }
 //# sourceMappingURL=ref.d.ts.map

package/dist/types/src/internal/Ref/ref.d.ts.map

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

package/dist/types/src/internal/Ref/ref.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.test.d.ts","sourceRoot":"","sources":["../../../../../src/internal/Ref/ref.test.ts"],"names":[],"mappings":""}

package/dist/types/src/internal/Type/compose.d.ts

@@ -0,0 +1,7 @@
+import type * as Types from 'effect/Types';
+import { type JsonSchemaType } from '../JsonSchema';
+/**
+ * Creates a composite schema from the source and projection schemas.
+ */
+export declare const composeSchema: (source: Types.Mutable<JsonSchemaType>, target: Types.Mutable<JsonSchemaType>) => Types.Mutable<JsonSchemaType>;
+//# sourceMappingURL=compose.d.ts.map

package/dist/types/src/internal/Type/compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../../../../src/internal/Type/compose.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAI3C,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;GAEG;AAGH,eAAO,MAAM,aAAa,WAChB,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,UAC7B,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,KACpC,KAAK,CAAC,OAAO,CAAC,cAAc,CAsB9B,CAAC"}

package/dist/types/src/internal/Type/compose.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.test.d.ts","sourceRoot":"","sources":["../../../../../src/internal/Type/compose.test.ts"],"names":[],"mappings":""}

package/dist/types/src/internal/Type/index.d.ts

@@ -0,0 +1,3 @@
+export * from './manipulation';
+export * from './type-schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/internal/Type/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/internal/Type/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/types/src/internal/{schema → Type}/manipulation.d.ts

@@ -6,5 +6,4 @@ export declare const updateFieldNameInSchema: (schema: Schema.Schema.AnyNoContex
     before: PropertyKey;
     after: PropertyKey;
 }) => Schema.Schema.AnyNoContext;
-export declare const setTypenameInSchema: (schema: Schema.Schema.AnyNoContext, typename: string) => Schema.Schema.AnyNoContext;
 //# sourceMappingURL=manipulation.d.ts.map

package/dist/types/src/internal/Type/manipulation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manipulation.d.ts","sourceRoot":"","sources":["../../../../../src/internal/Type/manipulation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAMxC,eAAO,MAAM,iBAAiB,WACpB,MAAM,CAAC,MAAM,CAAC,YAAY,UAC1B,MAAM,CAAC,MAAM,CAAC,MAAM,KAC3B,MAAM,CAAC,MAAM,CAAC,YAKhB,CAAC;AAEF,eAAO,MAAM,oBAAoB,WACvB,MAAM,CAAC,MAAM,CAAC,YAAY,UAC1B,MAAM,CAAC,MAAM,CAAC,MAAM,KAC3B,MAAM,CAAC,MAAM,CAAC,YAgBhB,CAAC;AAEF,eAAO,MAAM,sBAAsB,WACzB,MAAM,CAAC,MAAM,CAAC,YAAY,cACtB,MAAM,EAAE,KACnB,MAAM,CAAC,MAAM,CAAC,YAEhB,CAAC;AAEF,eAAO,MAAM,uBAAuB,WAC1B,MAAM,CAAC,MAAM,CAAC,YAAY,qBACf;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,KAC7D,MAAM,CAAC,MAAM,CAAC,YAehB,CAAC"}

package/dist/types/src/internal/Type/type-schema.d.ts

@@ -0,0 +1,52 @@
+import * as Schema from 'effect/Schema';
+import { EntityKind, KindId, SchemaKindId, StaticTypeSchemaSlot } from '../common/types';
+import { EchoTypeKindSchema } from '../Entity';
+import { JsonSchemaType } from '../JsonSchema';
+/**
+ * Raw struct backing {@link TypeSchema}. Exposed only so `TypeSchema`
+ * (the TS type) can derive its data fields via `Schema.Schema.Type<typeof ...>`;
+ * runtime callers should use {@link TypeSchema} (the piped, branded entity).
+ *
+ * `typename` and `version` are NOT data fields — they live in `ObjectMeta.key` /
+ * `ObjectMeta.version` (the canonical registry-provenance pair, queryable via
+ * `Filter.key(...)`). The same `jsonSchema` payload also embeds them so a
+ * standalone JSON-Schema export remains self-describing, but the schema-registry
+ * reads/writes them through meta.
+ */
+declare const TypeSchemaStruct: Schema.Struct<{
+    name: Schema.optional<typeof Schema.String>;
+    jsonSchema: Schema.Schema<JsonSchemaType, JsonSchemaType, never>;
+}>;
+/**
+ * Persistent representation of a schema.
+ */
+export declare const TypeSchema: EchoTypeKindSchema<Schema.Struct<{
+    name: Schema.optional<typeof Schema.String>;
+    jsonSchema: Schema.Schema<JsonSchemaType, JsonSchemaType, never>;
+}>, Readonly<{
+    name: Schema.optional<typeof Schema.String>;
+    jsonSchema: Schema.Schema<JsonSchemaType, JsonSchemaType, never>;
+}>>;
+/**
+ * Persistent representation of a schema — the runtime shape that
+ * `db.add(Type.makeObjectFromJsonSchema(...))` / `db.schemaRegistry.register([...])` produces
+ * and `Filter.type(Type.Type).run()` returns.
+ *
+ * Structurally identical to a static `Type.Type` entity: the entity-handler's
+ * `get` trap exposes `[SchemaKindId]` (derived from `system.kind` and
+ * `data.jsonSchema.entityKind`) and rebuilds `[StaticTypeSchemaSlot]` lazily
+ * from `jsonSchema`, so a persisted instance satisfies the public `Type<A>`
+ * interface without casting.
+ */
+export type TypeSchema = Schema.Schema.Type<typeof TypeSchemaStruct> & {
+    /** Object identifier — injected by `EchoTypeKindSchema` and stamped at construction. */
+    readonly id: string;
+    /** Entity-kind discriminator (object/relation/type) carried on every entity instance. */
+    readonly [KindId]: EntityKind.Type;
+    /** Kind of schema described by this meta-instance — always `EntityKind.Type` for `Type.Type` itself. */
+    readonly [SchemaKindId]: EntityKind.Type;
+    /** Effect Schema rebuilt lazily from `jsonSchema`; satisfies `Type.getSchema(...)` without an extra cast. */
+    readonly [StaticTypeSchemaSlot]: Schema.Schema.AnyNoContext;
+};
+export {};
+//# sourceMappingURL=type-schema.d.ts.map

package/dist/types/src/internal/Type/type-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-schema.d.ts","sourceRoot":"","sources":["../../../../../src/internal/Type/type-schema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAqB,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,QAAA,MAAM,gBAAgB;;;EAGpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;GAOtB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC,GAAG;IACrE,wFAAwF;IACxF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,yFAAyF;IACzF,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC;IACnC,wGAAwG;IACxG,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC;IACzC,6GAA6G;IAC7G,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;CAC7D,CAAC"}

package/dist/types/src/internal/common/api/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared API helpers for Obj and Relation modules.
+ * These implementations use generic Entity types.
+ * Obj and Relation modules re-export with strongly-typed signatures.
+ *
+ * TODO(wittjosiah): Could this become the new "internal" where we slowly refactor
+ * existing internal modules into here? This would provide a cleaner boundary
+ * and prevent external packages from using internals directly.
+ */
+export * from './meta';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/internal/common/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/common/api/index.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,cAAc,QAAQ,CAAC"}

package/dist/types/src/internal/common/api/meta.d.ts

@@ -0,0 +1,42 @@
+import type { ForeignKey } from '@dxos/echo-protocol';
+import type { DeepReadonly } from '@dxos/util';
+import { type Mutable } from '../proxy';
+import { type AnyProperties, type ObjectMeta } from '../types';
+/**
+ * Deeply read-only version of ObjectMeta.
+ */
+export type ReadonlyMeta = DeepReadonly<ObjectMeta>;
+/**
+ * Mutable meta type received in meta mutation callbacks.
+ */
+export type Meta = Mutable<ObjectMeta>;
+/**
+ * Get the metadata for an entity with validation.
+ * Returns mutable meta when passed a mutable entity (inside change callback).
+ * Returns read-only meta when passed a regular entity or snapshot.
+ *
+ * TODO(burdon): When passed a Snapshot, should return a snapshot of meta, not the live meta proxy.
+ */
+export declare function getMetaChecked(entity: Mutable<AnyProperties>): Meta;
+export declare function getMetaChecked(entity: AnyProperties): ReadonlyMeta;
+/**
+ * @returns Foreign keys for the entity from the specified source.
+ * Accepts both reactive entities and snapshots.
+ */
+export declare const getKeys: (entity: AnyProperties, source: string) => ForeignKey[];
+/**
+ * Delete all keys from the entity for the specified source.
+ * Must be called within an Obj.update or Relation.update callback.
+ */
+export declare const deleteKeys: (entity: Mutable<AnyProperties>, source: string) => void;
+/**
+ * Add a tag to the entity.
+ * Must be called within an Obj.update or Relation.update callback.
+ */
+export declare const addTag: (entity: Mutable<AnyProperties>, tag: string) => void;
+/**
+ * Remove a tag from the entity.
+ * Must be called within an Obj.update or Relation.update callback.
+ */
+export declare const removeTag: (entity: Mutable<AnyProperties>, tag: string) => void;
+//# sourceMappingURL=meta.d.ts.map

package/dist/types/src/internal/common/api/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/common/api/meta.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAuB,MAAM,UAAU,CAAC;AAEpF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEvC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;AACrE,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,CAAC;AAQpE;;;GAGG;AACH,eAAO,MAAM,OAAO,WAAY,aAAa,UAAU,MAAM,KAAG,UAAU,EAKzE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,WAAY,OAAO,CAAC,aAAa,CAAC,UAAU,MAAM,SAQxE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,MAAM,WAAY,OAAO,CAAC,aAAa,CAAC,OAAO,MAAM,SAIjE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,SAAS,WAAY,OAAO,CAAC,aAAa,CAAC,OAAO,MAAM,SAWpE,CAAC"}

package/dist/types/src/internal/common/index.d.ts

@@ -0,0 +1,4 @@
+export * from './api';
+export * from './proxy';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/internal/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/internal/common/index.ts"],"names":[],"mappings":"AAIA,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/types/src/internal/common/proxy/change-context.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Enter a change context for the given key.
+ * While in a change context, mutations are allowed on the associated object.
+ * Nested Obj.update calls are not supported.
+ *
+ * @param key - The key to enter the change context for (target object or ObjectCore).
+ * @returns A cleanup function that exits the change context.
+ */
+export declare const enterChangeContext: (key: object) => (() => void);
+/**
+ * Check if the given key is currently in a change context.
+ *
+ * @param key - The key to check (target object or ObjectCore).
+ * @returns True if the key is in a change context, false otherwise.
+ */
+export declare const isInChangeContext: (key: object) => boolean;
+/**
+ * Queue a notification for the given key to be fired when the change context exits.
+ *
+ * @param key - The key to queue a notification for.
+ */
+export declare const queueNotification: (key: object) => void;
+/**
+ * Queue an owner notification. Owner notifications are for objects in the ownership
+ * chain that should be notified when a nested object changes.
+ * These objects have EventId and emit directly.
+ * Skip if the target is already the current change context (to avoid duplicate notifications).
+ *
+ * @param target - The owner target that has EventId.
+ */
+export declare const queueOwnerNotification: (target: object) => void;
+/**
+ * Check if there are any pending notifications for the given key.
+ *
+ * @param key - The key to check.
+ * @returns True if there are pending notifications, false otherwise.
+ */
+export declare const hasPendingNotifications: (key: object) => boolean;
+/**
+ * Clear any pending notifications for the given key.
+ *
+ * @param key - The key to clear notifications for.
+ */
+export declare const clearPendingNotifications: (key: object) => void;
+/**
+ * Execute a callback within a change context.
+ * This is the shared implementation used by both TypedReactiveHandler and EchoReactiveHandler.
+ *
+ * @param contextKey - The key for the change context (target for typed, ObjectCore for db).
+ * @param eventTarget - The object that has the EventId for notifications.
+ * @param proxy - The proxy object to pass to the callback.
+ * @param callback - The callback to execute with mutations allowed.
+ */
+export declare const executeChange: (contextKey: object, eventTarget: object, proxy: any, callback: (proxy: any) => void) => void;
+//# sourceMappingURL=change-context.d.ts.map

package/dist/types/src/internal/common/proxy/change-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-context.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/common/proxy/change-context.ts"],"names":[],"mappings":"AAkCA;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,QAAS,MAAM,KAAG,CAAC,MAAM,IAAI,CAK3D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,QAAS,MAAM,KAAG,OAE/C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAS,MAAM,KAAG,IAI/C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,WAAY,MAAM,KAAG,IAKvD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAAS,MAAM,KAAG,OAErD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,QAAS,MAAM,KAAG,IAIvD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,eACZ,MAAM,eACL,MAAM,SACZ,GAAG,YACA,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,KAC7B,IAiBF,CAAC"}

package/dist/types/src/internal/common/proxy/change.test.d.ts

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

package/dist/types/src/internal/common/proxy/change.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change.test.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/common/proxy/change.test.ts"],"names":[],"mappings":""}

package/dist/types/src/internal/common/proxy/define-hidden-property.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Define a non-enumerable property on an object.
+ */
+export declare const defineHiddenProperty: (object: any, key: string | symbol, value: any) => void;
+//# sourceMappingURL=define-hidden-property.d.ts.map

package/dist/types/src/internal/common/proxy/define-hidden-property.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-hidden-property.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/common/proxy/define-hidden-property.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,oBAAoB,WAAY,GAAG,OAAO,MAAM,GAAG,MAAM,SAAS,GAAG,SAMjF,CAAC"}

package/dist/types/src/internal/common/proxy/errors.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Error thrown when attempting to mutate an object outside of an Obj.update() context.
+ */
+export declare class MutationOutsideChangeContextError extends Error {
+    constructor(operation: string, suggestion: string);
+}
+/**
+ * Create an error for attempting to set a property outside of a change context.
+ */
+export declare const createPropertySetError: (prop: string | symbol) => MutationOutsideChangeContextError;
+/**
+ * Create an error for attempting to delete a property outside of a change context.
+ */
+export declare const createPropertyDeleteError: (prop: string | symbol) => MutationOutsideChangeContextError;
+/**
+ * Create an error for attempting to call an array method outside of a change context.
+ */
+export declare const createArrayMethodError: (method: string) => MutationOutsideChangeContextError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/src/internal/common/proxy/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/common/proxy/errors.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,qBAAa,iCAAkC,SAAQ,KAAK;IAC1D,YAAY,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAKhD;CACF;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,SAAU,MAAM,GAAG,MAAM,KAAG,iCAK9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,SAAU,MAAM,GAAG,MAAM,KAAG,iCAKjE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,WAAY,MAAM,KAAG,iCAEvD,CAAC"}

package/dist/types/src/internal/common/proxy/event-batch.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Run a callback in a batched context for EventId emissions.
+ * Multiple mutations within the batch will only emit one event per target.
+ */
+export declare const batchEvents: (callback: () => void) => void;
+/**
+ * Emit an event on a target, respecting batching.
+ */
+export declare const emitEvent: (target: object) => void;
+//# sourceMappingURL=event-batch.d.ts.map

package/dist/types/src/internal/common/proxy/event-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-batch.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/common/proxy/event-batch.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,eAAO,MAAM,WAAW,aAAc,MAAM,IAAI,KAAG,IAclD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,WAAY,MAAM,KAAG,IAM1C,CAAC"}

package/dist/types/src/internal/common/proxy/handler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.test.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/common/proxy/handler.test.ts"],"names":[],"mappings":""}

package/dist/types/src/internal/common/proxy/index.d.ts

@@ -0,0 +1,14 @@
+export * from './change-context';
+export * from './define-hidden-property';
+export * from './errors';
+export * from './event-batch';
+export * from './json-serializer';
+export * from './make-object';
+export * from './proxy-types';
+export * from './proxy-utils';
+export * from './reactive';
+export * from './reactive-array';
+export * from './schema-validator';
+export * from './symbols';
+export * from './typed-handler';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/internal/common/proxy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/common/proxy/index.ts"],"names":[],"mappings":"AAIA,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}

package/dist/types/src/internal/common/proxy/json-serializer.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Attaches a toJSON method to the object for typed serialization.
+ */
+export declare const attachTypedJsonSerializer: (obj: any) => void;
+export declare const typedJsonSerializer: (this: any) => any;
+//# sourceMappingURL=json-serializer.d.ts.map

package/dist/types/src/internal/common/proxy/json-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-serializer.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/common/proxy/json-serializer.ts"],"names":[],"mappings":"AAuBA;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAS,GAAG,SAajD,CAAC;AAIF,eAAO,MAAM,mBAAmB,SAAmB,GAAG,QA+BrD,CAAC"}

package/dist/types/src/internal/common/proxy/make-object.d.ts

@@ -0,0 +1,19 @@
+import type * as Schema from 'effect/Schema';
+import { type AnyProperties, KindId, type ObjectMeta, SchemaKindId, StaticTypeSchemaSlot } from '../types';
+import { TypeSource } from './typed-handler';
+/**
+ *
+ */
+export type MakeObjectProps<T extends AnyProperties> = Omit<T, 'id' | KindId | SchemaKindId | StaticTypeSchemaSlot>;
+/**
+ * Creates a reactive object from a plain Javascript object.
+ * Requires a TS-effect schema.
+ *
+ * Callers that have a `Type.Type` entity (not a raw schema) must unwrap it
+ * themselves — `Obj.make` / `Relation.make` do this via `Type.getSchema(...)`
+ * and pass the entity through as `typeSource` so the instance carries a
+ * back-reference for `Obj.getType` and resolves the live source schema
+ * uniformly via the entity's `[StaticTypeSchemaSlot]`.
+ */
+export declare const makeObject: <T extends AnyProperties>(schema: Schema.Schema<T, any, never>, obj: NoInfer<MakeObjectProps<T>>, meta?: ObjectMeta, typeSource?: TypeSource) => T;
+//# sourceMappingURL=make-object.d.ts.map

package/dist/types/src/internal/common/proxy/make-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-object.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/common/proxy/make-object.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAK7C,OAAO,EACL,KAAK,aAAa,EAClB,MAAM,EAEN,KAAK,UAAU,EAGf,YAAY,EACZ,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAIlB,OAAO,EAAE,UAAU,EAA0D,MAAM,iBAAiB,CAAC;AAErG;;GAEG;AAMH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,aAAa,IAAI,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,YAAY,GAAG,oBAAoB,CAAC,CAAC;AAEpH;;;;;;;;;GASG;AAKH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,aAAa,UACxC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,OAC/B,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SACzB,UAAU,eACJ,UAAU,KACtB,CAGF,CAAC"}

package/dist/types/src/internal/common/proxy/ownership.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Get the raw target from a value, unwrapping proxy if needed.
+ */
+export declare const getRawTarget: (value: any) => any;
+/**
+ * Get the ECHO object that owns this nested record.
+ *
+ * The owner is always the raw target object (not a proxy) of the root ECHO object.
+ * For example, if you have `echoObject.nested.deep`, both `nested` and `deep`
+ * will have their owner set to the raw target of `echoObject`.
+ *
+ * @param value - The nested record to check (can be a proxy or raw target).
+ * @returns The raw target of the owning root ECHO object, or undefined if not owned.
+ */
+export declare const getOwner: (value: object | null | undefined) => object | undefined;
+/**
+ * Set the ECHO object owner on a value and all its nested records.
+ * All nested JS objects point directly to the root ECHO object.
+ *
+ * @param value - The value to set ownership on (can be a proxy or raw target).
+ * @param owner - The raw target of the root ECHO object that will own this value.
+ * @param options.visited - Set of already-visited objects to avoid infinite loops.
+ * @param options.depth - Current recursion depth (unused, kept for debugging).
+ * @param options.allowedPreviousOwner - When reassigning a root ECHO object, its nested structures
+ *   are allowed to have this as their previous owner without triggering the invariant.
+ */
+export declare const setOwnerRecursive: (value: any, owner: object, options?: {
+    visited?: Set<object>;
+    depth?: number;
+    allowedPreviousOwner?: object;
+}) => void;
+/**
+ * Traverse an object graph, calling the visitor on each object.
+ * Handles proxy unwrapping and cycle detection.
+ *
+ * @param value - The value to traverse (can be a proxy or raw target).
+ * @param visitor - Called for each object. Return true to stop traversal (early exit).
+ * @returns true if the visitor returns true for any object.
+ */
+export declare const traverseObjectGraph: (value: any, visitor: (actualValue: any) => boolean, visited?: Set<object>) => boolean;
+/**
+ * Check if a value would create a cycle when assigned to a target ECHO object.
+ * Returns true if the value (or any nested object) IS the target root.
+ */
+export declare const wouldCreateCycle: (targetRoot: object, value: any) => boolean;
+/**
+ * Check if a value or any of its nested objects has an owner different from the target.
+ * Used to determine if deep copy is needed during init.
+ */
+export declare const hasForeignOwner: (value: any, target: object) => boolean;
+/**
+ * Notify all owners in the ownership chain.
+ * When a nested object changes, its parent should also be notified.
+ * This handles the case where a root ECHO object is nested inside another object.
+ */
+export declare const notifyOwnerChain: (target: object) => void;
+//# sourceMappingURL=ownership.d.ts.map