@dxos/echo 0.8.4-main.406dc2a → 0.8.4-main.59c2e9b

package/src/internal/object/typename.ts

@@ -1,61 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { invariant } from '@dxos/invariant';
-import { DXN } from '@dxos/keys';
-
-import { getSchemaTypename } from '../ast';
-import { type BaseObject } from '../types';
-
-import { getSchema } from './accessors';
-import { TypeId } from './model';
-
-/**
- * Gets the typename of the object without the version.
- * Returns only the name portion, not the DXN.
- * @example "example.org/type/Contact"
- */
-export const getTypename = (obj: BaseObject): string | undefined => {
-  const schema = getSchema(obj);
-  if (schema != null) {
-    // Try to extract typename from DXN.
-    return getSchemaTypename(schema);
-  } else {
-    const type = getType(obj);
-    return type?.asTypeDXN()?.type;
-  }
-};
-
-/**
- * @internal
- */
-// TODO(dmaretskyi): Rename setTypeDXN.
-export const setTypename = (obj: any, typename: DXN) => {
-  invariant(typename instanceof DXN, 'Invalid type.');
-  Object.defineProperty(obj, TypeId, {
-    value: typename,
-    writable: false,
-    enumerable: false,
-    configurable: false,
-  });
-};
-
-/**
- * @returns Object type as {@link DXN}.
- * @returns undefined if the object doesn't have a type.
- * @example `dxn:example.com/type/Contact:1.0.0`
- */
-export const getType = (obj: BaseObject): DXN | undefined => {
-  if (!obj) {
-    return undefined;
-  }
-
-  const type = (obj as any)[TypeId];
-  if (!type) {
-    return undefined;
-  }
-
-  invariant(type instanceof DXN, 'Invalid object.');
-  return type;
-};

package/src/internal/object/version.ts

@@ -1,22 +0,0 @@
-//
-// NOTE: Those types must match the ones defined at @dxos/echo. We duplicated them murely due to technical constrains.
-//
-
-/**
- * Getter to get object version.
- */
-//
-// Copyright 2025 DXOS.org
-//
-
-export const VersionTypeId: unique symbol = Symbol('@dxos/echo/Version');
-
-/**
- * Represent object version.
- * May be backed by Automerge.
- * Objects with no history are not versioned.
- */
-export interface Version {
-  [VersionTypeId]: {};
-  automergeHeads?: string[];
-}

package/src/internal/projection/index.ts

@@ -1,5 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-export * from './compose';

package/src/internal/proxy/reactive-object.ts

@@ -1,108 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import type * as Schema from 'effect/Schema';
-
-import { ObjectId } from '@dxos/keys';
-import {
-  type Live,
-  UntypedReactiveHandler,
-  createProxy,
-  defineHiddenProperty,
-  isValidProxyTarget,
-} from '@dxos/live-object';
-
-import { getTypeAnnotation } from '../ast';
-import { EntityKindId, Expando, MetaId, type ObjectMeta, ObjectMetaSchema, attachTypedJsonSerializer } from '../object';
-import type { BaseObject, CreationProps } from '../types';
-
-import { TypedReactiveHandler, prepareTypedTarget } from './typed-handler';
-
-/**
- * Creates a reactive object from a plain Javascript object.
- * Optionally provides a TS-effect schema.
- *
- * @depreacted Use `Obj.make`.
- */
-// TODO(dmaretskyi): Deep mutability.
-// TODO(dmaretskyi): Invert generics (generic over schema) to have better error messages.
-// TODO(dmaretskyi): Could mutate original object making it unusable.
-// TODO(burdon): Use Schema.make() to handle defaults?
-export const live: {
-  <T extends BaseObject>(obj: T): Live<T>;
-  <T extends BaseObject>(
-    schema: Schema.Schema<T, any, never>,
-    obj: NoInfer<CreationProps<T>>,
-    meta?: ObjectMeta,
-  ): Live<T>;
-} = <T extends BaseObject>(
-  objOrSchema: Schema.Schema<T, any> | T,
-  obj?: CreationProps<T>,
-  meta?: ObjectMeta,
-): Live<T> => {
-  // TODO(dmaretskyi): Remove Expando special case.
-  if (obj && (objOrSchema as any) !== Expando) {
-    return createReactiveObject<T>({ ...obj } as T, meta, objOrSchema as Schema.Schema<T, any>);
-  } else if (obj && (objOrSchema as any) === Expando) {
-    return createReactiveObject<T>({ ...obj } as T, meta, undefined, { expando: true });
-  } else {
-    return createReactiveObject<T>(objOrSchema as T, meta);
-  }
-};
-
-const createReactiveObject = <T extends BaseObject>(
-  obj: T,
-  meta?: ObjectMeta,
-  schema?: Schema.Schema<T>,
-  options?: { expando?: boolean },
-): Live<T> => {
-  if (!isValidProxyTarget(obj)) {
-    throw new Error('Value cannot be made into a reactive object.');
-  }
-
-  if (schema) {
-    const annotation = getTypeAnnotation(schema);
-    const shouldGenerateId = options?.expando || !!annotation;
-    if (shouldGenerateId) {
-      setIdOnTarget(obj);
-    }
-    if (annotation) {
-      defineHiddenProperty(obj, EntityKindId, annotation.kind);
-    }
-    initMeta(obj, meta);
-    prepareTypedTarget(obj, schema);
-    attachTypedJsonSerializer(obj);
-    return createProxy<T>(obj, TypedReactiveHandler.instance);
-  } else {
-    if (options?.expando) {
-      setIdOnTarget(obj);
-    }
-    initMeta(obj, meta);
-    return createProxy<T>(obj, UntypedReactiveHandler.instance);
-  }
-};
-
-/**
- * Set ID on ECHO object targets during creation.
- * Used for objects with schema and the ones explicitly marked as Expando.
- */
-const setIdOnTarget = (target: any) => {
-  // invariant(!('id' in target), 'Object already has an `id` field, which is reserved.');
-  if ('id' in target && target.id !== undefined && target.id !== null) {
-    if (!ObjectId.isValid(target.id)) {
-      throw new Error('Invalid object id format.');
-    }
-  } else {
-    target.id = ObjectId.random();
-  }
-};
-
-/**
- * Set metadata on object.
- */
-// TODO(dmaretskyi): Move to echo-schema.
-const initMeta = <T>(obj: T, meta: ObjectMeta = { keys: [] }) => {
-  prepareTypedTarget(meta, ObjectMetaSchema);
-  defineHiddenProperty(obj, MetaId, createProxy(meta, TypedReactiveHandler.instance as any));
-};

package/src/internal/query/index.ts

@@ -1,5 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-export * from './query';

package/src/internal/query/query.ts

@@ -1,23 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import * as Schema from 'effect/Schema';
-
-// TODO(wittjosiah): Remove. Use ordering in queries instead.
-
-/** @deprecated */
-const SortDirection = Schema.Union(Schema.Literal('asc'), Schema.Literal('desc'));
-/** @deprecated */
-export type SortDirectionType = Schema.Schema.Type<typeof SortDirection>;
-
-/** @deprecated */
-const FieldSort = Schema.Struct({
-  fieldId: Schema.String,
-  direction: SortDirection,
-}).pipe(Schema.mutable);
-
-/** @deprecated */
-export interface FieldSortType extends Schema.Schema.Type<typeof FieldSort> {}
-/** @deprecated */
-export const FieldSortType: Schema.Schema<FieldSortType> = FieldSort;

package/src/internal/schema/runtime-schema-registry.ts

@@ -1,78 +0,0 @@
-//
-// Copyright 2022 DXOS.org
-//
-
-import type * as Schema from 'effect/Schema';
-
-import { raise } from '@dxos/debug';
-import { invariant } from '@dxos/invariant';
-import { type DXN } from '@dxos/keys';
-import { defaultMap } from '@dxos/util';
-
-import { getSchemaTypename, getSchemaVersion } from '../ast';
-
-import { StoredSchema } from './stored-schema';
-
-/**
- * Runtime registry of static schema objects (i.e., not Dynamic .
- */
-// TODO(burdon): Reconcile with EchoSchemaRegistry.
-export class RuntimeSchemaRegistry {
-  private readonly _registry = new Map<string, Schema.Schema.AnyNoContext[]>();
-
-  constructor() {
-    this._registry.set(StoredSchema.typename, [StoredSchema]);
-  }
-
-  get schemas(): Schema.Schema.AnyNoContext[] {
-    return Array.from(this._registry.values()).flat();
-  }
-
-  hasSchema<S extends Schema.Schema.AnyNoContext>(schema: S): boolean {
-    const typename = getSchemaTypename(schema);
-    const version = getSchemaVersion(schema);
-    invariant(typename, 'Invalid schema');
-
-    const schemas = this._registry.get(typename);
-    return schemas?.some((schema) => getSchemaVersion(schema) === version) ?? false;
-  }
-
-  getSchemaByDXN(dxn: DXN): Schema.Schema.AnyNoContext | undefined {
-    const components = dxn.asTypeDXN();
-    if (!components) {
-      return undefined;
-    }
-
-    const { type, version } = components;
-    const allSchemas = this._registry.get(type) ?? [];
-    if (version) {
-      return allSchemas.find((s) => getSchemaVersion(s) === version);
-    } else {
-      // If no version is specified, return the earliest version for backwards compatibility.
-      // TODO(dmaretskyi): Probably not correct to compare lexicographically, but it's good enough for now.
-      return allSchemas.sort((a, b) =>
-        (getSchemaVersion(a) ?? '0.0.0').localeCompare(getSchemaVersion(b) ?? '0.0.0'),
-      )[0];
-    }
-  }
-
-  /**
-   * @deprecated Use getSchemaByDXN.
-   */
-  getSchema(typename: string): Schema.Schema.AnyNoContext | undefined {
-    return this._registry.get(typename)?.[0];
-  }
-
-  addSchema(types: Schema.Schema.AnyNoContext[]): void {
-    types.forEach((schema) => {
-      const typename = getSchemaTypename(schema) ?? raise(new TypeError('Schema has no typename'));
-      const version = getSchemaVersion(schema) ?? raise(new TypeError('Schema has no version'));
-      const versions = defaultMap(this._registry, typename, () => []);
-      if (versions.some((schema) => getSchemaVersion(schema) === version)) {
-        throw new Error(`Schema version already registered: ${typename}:${version}`);
-      }
-
-      versions.push(schema);
-    });
-  }
-}

package/src/internal/schema/snapshot.ts

@@ -1,25 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-/**
- * Returns a non-reactive snapshot of the given live object.
- * @deprecated Use `getSnapshot` from `@dxos/live-object` instead.
- */
-// TODO(wittjosiah): Types.
-export const getSnapshot = (object: any): any => {
-  if (typeof object !== 'object') {
-    return object;
-  }
-
-  if (Array.isArray(object)) {
-    return object.map(getSnapshot);
-  }
-
-  const result: any = {};
-  for (const key in object) {
-    result[key] = getSnapshot(object[key]);
-  }
-
-  return result;
-};

package/src/internal/schema/stored-schema.ts

@@ -1,26 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import * as Schema from 'effect/Schema';
-
-import { SchemaVersion, Typename } from '../ast';
-import { JsonSchemaType } from '../json-schema';
-import { EchoObject } from '../object';
-
-/**
- * Persistent representation of a schema.
- */
-export const StoredSchema = Schema.Struct({
-  name: Schema.optional(Schema.String),
-  typename: Typename,
-  version: SchemaVersion,
-  jsonSchema: JsonSchemaType,
-}).pipe(
-  EchoObject({
-    typename: 'dxos.org/type/Schema',
-    version: '0.1.0',
-  }),
-);
-
-export type StoredSchema = Schema.Schema.Type<typeof StoredSchema>;

package/src/internal/testing/index.ts

@@ -1,6 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-export * from './types';
-export * from './utils';

package/src/internal/testing/types.ts

@@ -1,211 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import * as Schema from 'effect/Schema';
-
-import { EchoObject, EchoRelation, Expando, TypedObject } from '../object';
-import { Ref, type Ref$ } from '../ref';
-
-// TODO(burdon): These are non-canonical test types, so we really shouldn't export and use in other classes (compare with @dxos/sdk/testing).
-export namespace Testing {
-  //
-  // Primitives
-  //
-
-  const Circle = Schema.Struct({ type: Schema.Literal('circle'), radius: Schema.Number });
-  const Square = Schema.Struct({ type: Schema.Literal('square'), side: Schema.Number });
-  const Shape = Schema.Union(Circle, Square);
-
-  //
-  // Simple types
-  //
-
-  const TestNestedSchema = Schema.mutable(Schema.Struct({ field: Schema.String }));
-  export type TestNestedSchema = Schema.Schema.Type<typeof TestNestedSchema>;
-  export const TestNestedType = TestNestedSchema.pipe(
-    EchoObject({ typename: 'example.com/type/TestNested', version: '0.1.0' }),
-  );
-
-  //
-  // Complex types
-  // TODO(burdon): Change to Type.Obj.
-  //
-
-  export class EmptySchemaType extends TypedObject({
-    typename: 'example.com/type/Empty',
-    version: '0.1.0',
-  })({}) {}
-
-  const fields = {
-    string: Schema.String,
-    number: Schema.Number,
-    nullableShapeArray: Schema.mutable(Schema.Array(Schema.Union(Shape, Schema.Null))),
-    boolean: Schema.Boolean,
-    null: Schema.Null,
-    undefined: Schema.Undefined,
-    stringArray: Schema.mutable(Schema.Array(Schema.String)),
-    twoDimNumberArray: Schema.mutable(Schema.Array(Schema.mutable(Schema.Array(Schema.Number)))),
-    object: TestNestedSchema,
-    objectArray: Schema.mutable(Schema.Array(TestNestedSchema)),
-    nested: Schema.optional(Ref(TestNestedType)),
-    other: Schema.Any,
-  };
-
-  export const TestSchema = Schema.mutable(Schema.partial(Schema.Struct(fields)));
-  export type TestSchema = Schema.Schema.Type<typeof TestSchema>;
-
-  export class TestSchemaType extends TypedObject({
-    typename: 'example.com/type/Test',
-    version: '0.1.0',
-  })(fields, { partial: true }) {} // TODO(burdon): Partial?
-
-  // TODO(burdon): Why do we use need this rather then TestSchemaType?
-  export const TestType = TestSchema.pipe(
-    EchoObject({
-      typename: 'example.com/type/Test',
-      version: '0.1.0',
-    }),
-  );
-
-  export class TestClass {
-    field = 'value';
-    toJSON() {
-      return { field: this.field };
-    }
-  }
-
-  // TODO(dmaretskyi): Another top-level Schema.mutable call as a workaround for the regression in the last minor.
-  export const TestSchemaWithClass = Schema.mutable(
-    Schema.extend(
-      TestSchema,
-      Schema.mutable(
-        Schema.Struct({
-          classInstance: Schema.optional(Schema.instanceOf(TestClass)),
-        }),
-      ),
-    ),
-  );
-
-  export type TestSchemaWithClass = Schema.Schema.Type<typeof TestSchemaWithClass>;
-
-  export class Contact extends TypedObject({
-    typename: 'example.com/type/Contact',
-    version: '0.1.0',
-  })(
-    {
-      name: Schema.String,
-      username: Schema.String,
-      email: Schema.String,
-      phoneNumbers: Schema.optional(Schema.Array(Schema.Struct({ label: Schema.String, number: Schema.String }))),
-      tasks: Schema.suspend((): Schema.mutable<Schema.Array$<Ref$<Task>>> => Schema.mutable(Schema.Array(Ref(Task)))),
-      address: Schema.Struct({
-        city: Schema.optional(Schema.String),
-        state: Schema.optional(Schema.String),
-        zip: Schema.optional(Schema.String),
-        coordinates: Schema.Struct({
-          lat: Schema.optional(Schema.Number),
-          lng: Schema.optional(Schema.Number),
-        }),
-      }),
-    },
-    { partial: true },
-  ) {}
-
-  export class Task extends TypedObject({
-    typename: 'example.com/type/Task',
-    version: '0.1.0',
-  })(
-    {
-      title: Schema.optional(Schema.String),
-      completed: Schema.optional(Schema.Boolean),
-      assignee: Schema.optional(Ref(Contact)),
-      previous: Schema.optional(Schema.suspend((): Ref$<Task> => Ref(Task))),
-      subTasks: Schema.optional(Schema.mutable(Schema.Array(Schema.suspend((): Ref$<Task> => Ref(Task))))),
-      description: Schema.optional(Schema.String),
-    },
-    { partial: true },
-  ) {}
-
-  // TOOD(burdon): Ref$ breaks if using new syntax (since ID is not declared).
-
-  // export const Task = Schema.Struct({
-  //   title: Schema.String,
-  //   completed: Schema.Boolean,
-  //   assignee: Schema.optional(Ref(Schema.suspend((): Ref$<Contact> => Ref(Contact)))),
-  //   previous: Schema.optional(Ref(Schema.suspend((): Ref$<Task> => Ref(Task)))),
-  //   subTasks: Schema.optional(Schema.Array(Ref(Schema.suspend((): Ref$<Task> => Ref(Task))))),
-  //   description: Schema.optional(Schema.String),
-  // }).pipe(
-  //   EchoObject({
-  //     typename: 'example.com/type/Task',
-  //     version: '0.1.0',
-  //   }),
-  // );
-
-  // export type Task = Schema.Schema.Type<typeof Task>;
-
-  // export const Contact = Schema.Struct({
-  //   name: Schema.String,
-  //   username: Schema.String,
-  //   email: Schema.String,
-  //   // TOOD(burdon): Should model via relations?
-  //   // tasks: Schema.mutable(Schema.Array(Ref(Task))),
-  //   address: Schema.Struct({
-  //     city: Schema.optional(Schema.String),
-  //     state: Schema.optional(Schema.String),
-  //     zip: Schema.optional(Schema.String),
-  //     coordinates: Schema.Struct({
-  //       lat: Schema.optional(Schema.Number),
-  //       lng: Schema.optional(Schema.Number),
-  //     }),
-  //   }),
-  // }).pipe(
-  //   EchoObject({
-  //     typename: 'example.com/type/Contact',
-  //     version: '0.1.0',
-  //   }),
-  // );
-
-  // export type Contact = Schema.Schema.Type<typeof Contact>;
-
-  export enum RecordType {
-    UNDEFINED = 0,
-    PERSONAL = 1,
-    WORK = 2,
-  }
-
-  export class Container extends TypedObject({
-    typename: 'example.com/type/Container',
-    version: '0.1.0',
-  })(
-    {
-      objects: Schema.mutable(Schema.Array(Ref(Expando))),
-      records: Schema.mutable(
-        Schema.Array(
-          Schema.partial(
-            Schema.Struct({
-              title: Schema.String,
-              description: Schema.String,
-              contacts: Schema.mutable(Schema.Array(Ref(Contact))),
-              type: Schema.Enums(RecordType),
-            }),
-          ),
-        ),
-      ),
-    },
-    { partial: true },
-  ) {}
-
-  export const HasManager = Schema.Struct({
-    since: Schema.optional(Schema.String),
-  }).pipe(
-    EchoRelation({
-      typename: 'example.com/type/HasManager',
-      version: '0.1.0',
-      source: Contact,
-      target: Contact,
-    }),
-  );
-  export interface HasManager extends Schema.Schema.Type<typeof HasManager> {}
-}

package/src/internal/testing/utils.ts

@@ -1,54 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { effect } from '@preact/signals-core';
-import type * as SchemaAST from 'effect/SchemaAST';
-
-import { registerSignalsRuntime } from '@dxos/echo-signals';
-import { deepMapValues } from '@dxos/util';
-
-registerSignalsRuntime();
-
-// TODO(burdon): Move to util.
-export const updateCounter = (touch: () => void) => {
-  let updateCount = -1;
-  const unsubscribe = effect(() => {
-    touch();
-    updateCount++;
-  });
-
-  return {
-    // https://github.com/tc39/proposal-explicit-resource-management
-    [Symbol.dispose]: unsubscribe,
-    get count() {
-      return updateCount;
-    },
-  };
-};
-
-/**
- * Converts AST to a format that can be compared with test matchers.
- */
-export const prepareAstForCompare = (obj: SchemaAST.AST): any =>
-  deepMapValues(obj, (value: any, recurse, key) => {
-    if (typeof value === 'function') {
-      return null;
-    }
-
-    if (value instanceof RegExp) {
-      return value;
-    }
-
-    // Convert symbols to strings.
-    if (typeof value === 'object') {
-      const clone = { ...value };
-      for (const sym of Object.getOwnPropertySymbols(clone as any)) {
-        clone[sym.toString()] = clone[sym];
-        delete clone[sym];
-      }
-      return recurse(clone);
-    }
-
-    return recurse(value);
-  });

package/src/internal/types/types.test.ts

@@ -1,48 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { describe, test } from 'vitest';
-
-import { type JsonPath } from '@dxos/effect';
-
-import { type BaseObject, getValue, setValue } from './types';
-
-describe('Types', () => {
-  test('checks sanity', async ({ expect }) => {
-    const obj: BaseObject = {};
-    expect(obj).to.exist;
-  });
-});
-
-describe('get/set deep', () => {
-  test('get/set operations', ({ expect }) => {
-    const obj = {
-      name: 'test',
-      items: ['a', 'b', 'c'],
-      nested: {
-        prop: 'value',
-        arr: [1, 2, 3],
-      },
-    };
-
-    // Basic property access.
-    expect(getValue(obj, 'name' as JsonPath)).toBe('test');
-
-    // Array index access.
-    expect(getValue(obj, 'items[1]' as JsonPath)).toBe('b');
-
-    // Nested property access.
-    expect(getValue(obj, 'nested.prop' as JsonPath)).toBe('value');
-
-    // Nested array access.
-    expect(getValue(obj, 'nested.arr[2]' as JsonPath)).toBe(3);
-
-    // Setting values.
-    const updated1 = setValue(obj, 'items[1]' as JsonPath, 'x');
-    expect(updated1.items[1]).toBe('x');
-
-    const updated2 = setValue(obj, 'nested.arr[0]' as JsonPath, 99);
-    expect(updated2.nested.arr[0]).toBe(99);
-  });
-});