@dxos/client-protocol 0.8.4-main.ef1bc66f44 → 0.8.4-main.effb148878

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/client-protocol",
-  "version": "0.8.4-main.ef1bc66f44",
+  "version": "0.8.4-main.effb148878",
   "description": "Core DXOS Client API.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -8,7 +8,7 @@
     "type": "git",
     "url": "https://github.com/dxos/dxos"
   },
-  "license": "MIT",
+  "license": "FSL-1.1-Apache-2.0",
   "author": "DXOS.org",
   "sideEffects": false,
   "type": "module",
@@ -27,33 +27,26 @@
     }
   },
   "types": "dist/types/src/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "./types": [
-        "./dist/types/src/types/index.d.ts"
-      ]
-    }
-  },
   "files": [
     "dist",
     "src"
   ],
   "dependencies": {
-    "base-x": "~3.0.9",
-    "effect": "3.19.16",
-    "@dxos/async": "0.8.4-main.ef1bc66f44",
-    "@dxos/credentials": "0.8.4-main.ef1bc66f44",
-    "@dxos/echo-db": "0.8.4-main.ef1bc66f44",
-    "@dxos/context": "0.8.4-main.ef1bc66f44",
-    "@dxos/echo": "0.8.4-main.ef1bc66f44",
-    "@dxos/keys": "0.8.4-main.ef1bc66f44",
-    "@dxos/invariant": "0.8.4-main.ef1bc66f44",
-    "@dxos/node-std": "0.8.4-main.ef1bc66f44",
-    "@dxos/protocols": "0.8.4-main.ef1bc66f44",
-    "@dxos/rpc": "0.8.4-main.ef1bc66f44"
+    "base-x": "~3.0.11",
+    "effect": "3.20.0",
+    "@dxos/async": "0.8.4-main.effb148878",
+    "@dxos/context": "0.8.4-main.effb148878",
+    "@dxos/credentials": "0.8.4-main.effb148878",
+    "@dxos/echo": "0.8.4-main.effb148878",
+    "@dxos/echo-db": "0.8.4-main.effb148878",
+    "@dxos/keys": "0.8.4-main.effb148878",
+    "@dxos/invariant": "0.8.4-main.effb148878",
+    "@dxos/protocols": "0.8.4-main.effb148878",
+    "@dxos/rpc": "0.8.4-main.effb148878",
+    "@dxos/node-std": "0.8.4-main.effb148878"
   },
   "peerDependencies": {
-    "effect": "3.19.16"
+    "effect": "3.20.0"
   },
   "publishConfig": {
     "access": "public"

package/src/config.ts

@@ -60,9 +60,9 @@ export namespace DXEnv {
   }
 }
 
-// Base directories.
-// TODO(burdon): Consider Windows, Linux, OSX.
-// https://wiki.archlinux.org/title/XDG_Base_Directory
-// Each `/dx` directory should contain `/profile/<DX_PROFILE>` subdirectories.
-export const getProfilePath = (root: string, profile: string, file: string | undefined = undefined) =>
+// Profile layout: profile/<name> is the profile dir; profile/<name>.yml is the config file.
+export const getProfilePath = (root: string, profile: string, file?: string) =>
   `${root}/profile/${profile}` + (file ? `/${file}` : '');
+
+/** Path to the profile config file (profile/<name>.yml). */
+export const getProfileConfigPath = (root: string, profile: string) => `${getProfilePath(root, profile)}.yml`;

package/src/echo.ts

@@ -6,6 +6,7 @@ import type { MulticastObservable } from '@dxos/async';
 import type { Database } from '@dxos/echo';
 import type { PublicKey, SpaceId } from '@dxos/keys';
 import type { Invitation, SpaceArchive } from '@dxos/protocols/proto/dxos/client/services';
+import type { MembershipPolicy } from '@dxos/protocols/proto/dxos/halo/credentials';
 
 import type { AuthenticatingInvitation } from './invitations';
 import type { Space } from './space';
@@ -16,12 +17,6 @@ import type { SpaceProperties } from './types';
  */
 // TODO(wittjosiah): Rename Database (not product name).
 export interface Echo extends MulticastObservable<Space[]>, Database.Queryable {
-  /**
-   * Observable which indicates when the default space is available.
-   */
-  // TODO(wittjosiah): Remove. Ensure default space is always available.
-  get isReady(): MulticastObservable<boolean>;
-
   /**
    * Returns the list of spaces.
    */
@@ -38,25 +33,18 @@ export interface Echo extends MulticastObservable<Space[]>, Database.Queryable {
    */
   get(spaceKey: PublicKey): Space | undefined;
 
-  /**
-   * Returns the default space.
-   */
-  get default(): Space;
-
-  /**
-   * Resolves when the default space is available.
-   */
-  waitUntilReady(): Promise<void>;
-
   /**
    * Creates a new space.
    */
-  create(props?: Pick<SpaceProperties, 'name' | 'hue' | 'icon' | 'invocationTraceQueue'>): Promise<Space>;
+  create(
+    props?: Pick<SpaceProperties, 'name' | 'hue' | 'icon' | 'invocationTraceFeed'>,
+    options?: { tags?: string[]; membershipPolicy?: MembershipPolicy },
+  ): Promise<Space>;
 
   /**
    * Creates a space from the given archive.
    */
-  import(archive: SpaceArchive): Promise<Space>;
+  import(archive: SpaceArchive, options?: { tags?: string[] }): Promise<Space>;
 
   /**
    * Joins an existing space using the given invitation.

package/src/service.ts

@@ -21,7 +21,6 @@ import type { QueryService } from '@dxos/protocols/proto/dxos/echo/query';
 import type { DataService } from '@dxos/protocols/proto/dxos/echo/service';
 import type { AppService, ShellService, WorkerService } from '@dxos/protocols/proto/dxos/iframe';
 import type { BridgeService } from '@dxos/protocols/proto/dxos/mesh/bridge';
-import type { TracingService } from '@dxos/protocols/proto/dxos/tracing';
 import { type ServiceBundle, createServiceBundle } from '@dxos/rpc';
 
 export type { QueueService } from '@dxos/protocols/proto/dxos/client/services';
@@ -49,8 +48,6 @@ export type ClientServices = {
 
   // TODO(burdon): Deprecated.
   DevtoolsHost: DevtoolsHost;
-
-  TracingService: TracingService;
 };
 
 /**
@@ -104,7 +101,6 @@ export const clientServiceBundle = createServiceBundle<ClientServices>({
 
   // TODO(burdon): Deprecated.
   DevtoolsHost: schema.getService('dxos.devtools.host.DevtoolsHost'),
-  TracingService: schema.getService('dxos.tracing.TracingService'),
 });
 
 export type IframeServiceBundle = {

package/src/space.ts

@@ -14,7 +14,7 @@ import {
   type Contact,
   type CreateEpochRequest,
   type Invitation,
-  type SpaceArchive,
+  SpaceArchive,
   type Space as SpaceData,
   type SpaceMember,
   type SpaceState,
@@ -22,7 +22,7 @@ import {
 } from '@dxos/protocols/proto/dxos/client/services';
 import { type EdgeReplicationSetting } from '@dxos/protocols/proto/dxos/echo/metadata';
 import { type SpaceSnapshot } from '@dxos/protocols/proto/dxos/echo/snapshot';
-import { type Credential, type Epoch } from '@dxos/protocols/proto/dxos/halo/credentials';
+import { type Credential, type Epoch, type MembershipPolicy } from '@dxos/protocols/proto/dxos/halo/credentials';
 
 import { type CancellableInvitation } from './invitations';
 import { type SpaceProperties } from './types';
@@ -32,6 +32,14 @@ export type CreateEpochOptions = {
   automergeRootUrl?: string;
 };
 
+export type ExportSpaceOptions = {
+  /**
+   * Archive format.
+   * @default SpaceArchive.Format.BINARY
+   */
+  format?: SpaceArchive.Format;
+};
+
 export interface SpaceInternal {
   get db(): EchoDatabase;
   get data(): SpaceData;
@@ -46,7 +54,7 @@ export interface SpaceInternal {
   // TOOD(burdon): Start to factor out credentials.
   removeMember(memberKey: PublicKey): Promise<void>;
 
-  export(): Promise<SpaceArchive>;
+  export(options?: ExportSpaceOptions): Promise<SpaceArchive>;
 
   /**
    * Migrate space data to the latest version.
@@ -93,6 +101,18 @@ export interface Space extends Messenger {
   // TODO(burdon): Replace with state?
   get isOpen(): boolean;
 
+  /**
+   * Immutable tags assigned at space creation time.
+   * Available on closed spaces.
+   */
+  get tags(): string[];
+
+  /**
+   * Immutable membership policy assigned at space creation time.
+   * Available on closed spaces.
+   */
+  get membershipPolicy(): MembershipPolicy;
+
   /**
    * Current state of the space.
    * The database is ready to be used in `SpaceState.SPACE_READY` state.
@@ -103,7 +123,7 @@ export interface Space extends Messenger {
   /**
    * Properties object.
    */
-  get properties(): Obj.Obj<SpaceProperties>;
+  get properties(): Obj.OfShape<SpaceProperties>;
 
   /**
    * Current state of space pipeline.

package/src/types/SpaceProperties.ts

@@ -4,8 +4,13 @@
 
 import * as Schema from 'effect/Schema';
 
-import { Annotation, Type } from '@dxos/echo';
-import { Queue } from '@dxos/echo-db';
+import { DXN, Annotation, Feed, Ref, Type } from '@dxos/echo';
+
+/**
+ * Where do triggers get executed.
+ */
+export const ComputeEnvironment = Schema.Literal('disabled', 'local', 'edge');
+export type ComputeEnvironment = Schema.Schema.Type<typeof ComputeEnvironment>;
 
 export const SpacePropertiesSchema = Schema.Struct(
   {
@@ -17,7 +22,19 @@ export const SpacePropertiesSchema = Schema.Struct(
     // TODO(burdon): Change to mode (no booleans?)
     // TODO(wittjosiah): Make optional with default value.
     edgeReplication: Schema.optional(Schema.Boolean),
-    invocationTraceQueue: Schema.optional(Type.Ref(Queue)),
+
+    /**
+     * @deprecated
+     */
+    invocationTraceFeed: Schema.optional(Ref.Ref(Feed.Feed)),
+
+    /**
+     * Preference for trigger execution.
+     * *disabled* - triggers do not run locally or on EDGE.
+     * *local* - triggers are executed locally on the client, edge is not running triggers.
+     * *edge* - triggers are executed on the edge, triggers are not run locally.
+     */
+    computeEnvironment: Schema.optional(ComputeEnvironment),
 
     //
     // User properties.
@@ -38,12 +55,8 @@ export type SpacePropertiesSchema = Schema.Schema.Type<typeof SpacePropertiesSch
 // TODO(burdon): Pipe Schem.optional, or partial to entire struct to make everything optional?
 // TODO(burdon): Is separate schema def required for forms? Can it be extracted from SpaceProperties?
 export const SpaceProperties = SpacePropertiesSchema.pipe(
-  Type.object({
-    // TODO(burdon): Rename SpaceProperties.
-    typename: 'dxos.org/type/Properties',
-    version: '0.1.0',
-  }),
   Annotation.SystemTypeAnnotation.set(true),
+  Type.makeObject(DXN.make('org.dxos.type.spaceProperties', '0.1.0')),
 );
 
-export interface SpaceProperties extends Schema.Schema.Type<typeof SpaceProperties> {}
+export type SpaceProperties = Type.InstanceType<typeof SpaceProperties>;

package/dist/lib/browser/chunk-N7EC364H.mjs

@@ -1,36 +0,0 @@
-// src/types/SpaceProperties.ts
-import * as Schema from "effect/Schema";
-import { Annotation, Type } from "@dxos/echo";
-import { Queue } from "@dxos/echo-db";
-var SpacePropertiesSchema = Schema.Struct({
-  //
-  // System properties.
-  //
-  archived: Schema.optional(Schema.Boolean.annotations({
-    title: "Archive Space"
-  })),
-  // TODO(burdon): Change to mode (no booleans?)
-  // TODO(wittjosiah): Make optional with default value.
-  edgeReplication: Schema.optional(Schema.Boolean),
-  invocationTraceQueue: Schema.optional(Type.Ref(Queue)),
-  //
-  // User properties.
-  //
-  name: Schema.optional(Schema.String),
-  icon: Schema.optional(Schema.String),
-  hue: Schema.optional(Schema.String)
-}, {
-  key: Schema.String,
-  value: Schema.Any
-});
-var SpaceProperties = SpacePropertiesSchema.pipe(Type.object({
-  // TODO(burdon): Rename SpaceProperties.
-  typename: "dxos.org/type/Properties",
-  version: "0.1.0"
-}), Annotation.SystemTypeAnnotation.set(true));
-
-export {
-  SpacePropertiesSchema,
-  SpaceProperties
-};
-//# sourceMappingURL=chunk-N7EC364H.mjs.map

package/dist/lib/browser/chunk-N7EC364H.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/types/SpaceProperties.ts"],
-  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Annotation, Type } from '@dxos/echo';\nimport { Queue } from '@dxos/echo-db';\n\nexport const SpacePropertiesSchema = Schema.Struct(\n  {\n    //\n    // System properties.\n    //\n\n    archived: Schema.optional(Schema.Boolean.annotations({ title: 'Archive Space' })),\n    // TODO(burdon): Change to mode (no booleans?)\n    // TODO(wittjosiah): Make optional with default value.\n    edgeReplication: Schema.optional(Schema.Boolean),\n    invocationTraceQueue: Schema.optional(Type.Ref(Queue)),\n\n    //\n    // User properties.\n    //\n\n    name: Schema.optional(Schema.String),\n    icon: Schema.optional(Schema.String),\n    hue: Schema.optional(Schema.String),\n  },\n  {\n    key: Schema.String,\n    value: Schema.Any,\n  },\n);\n\nexport type SpacePropertiesSchema = Schema.Schema.Type<typeof SpacePropertiesSchema>;\n\n// TODO(burdon): Pipe Schem.optional, or partial to entire struct to make everything optional?\n// TODO(burdon): Is separate schema def required for forms? Can it be extracted from SpaceProperties?\nexport const SpaceProperties = SpacePropertiesSchema.pipe(\n  Type.object({\n    // TODO(burdon): Rename SpaceProperties.\n    typename: 'dxos.org/type/Properties',\n    version: '0.1.0',\n  }),\n  Annotation.SystemTypeAnnotation.set(true),\n);\n\nexport interface SpaceProperties extends Schema.Schema.Type<typeof SpaceProperties> {}\n"],
-  "mappings": ";AAIA,YAAYA,YAAY;AAExB,SAASC,YAAYC,YAAY;AACjC,SAASC,aAAa;AAEf,IAAMC,wBAA+BC,cAC1C;;;;EAKEC,UAAiBC,gBAAgBC,eAAQC,YAAY;IAAEC,OAAO;EAAgB,CAAA,CAAA;;;EAG9EC,iBAAwBJ,gBAAgBC,cAAO;EAC/CI,sBAA6BL,gBAASM,KAAKC,IAAIC,KAAAA,CAAAA;;;;EAM/CC,MAAaT,gBAAgBU,aAAM;EACnCC,MAAaX,gBAAgBU,aAAM;EACnCE,KAAYZ,gBAAgBU,aAAM;AACpC,GACA;EACEG,KAAYH;EACZI,OAAcC;AAChB,CAAA;AAOK,IAAMC,kBAAkBnB,sBAAsBoB,KACnDX,KAAKY,OAAO;;EAEVC,UAAU;EACVC,SAAS;AACX,CAAA,GACAC,WAAWC,qBAAqBC,IAAI,IAAA,CAAA;",
-  "names": ["Schema", "Annotation", "Type", "Queue", "SpacePropertiesSchema", "Struct", "archived", "optional", "Boolean", "annotations", "title", "edgeReplication", "invocationTraceQueue", "Type", "Ref", "Queue", "name", "String", "icon", "hue", "key", "value", "Any", "SpaceProperties", "pipe", "object", "typename", "version", "Annotation", "SystemTypeAnnotation", "set"]
-}

package/dist/lib/node-esm/chunk-EM6VN4X6.mjs

@@ -1,38 +0,0 @@
-import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
-
-// src/types/SpaceProperties.ts
-import * as Schema from "effect/Schema";
-import { Annotation, Type } from "@dxos/echo";
-import { Queue } from "@dxos/echo-db";
-var SpacePropertiesSchema = Schema.Struct({
-  //
-  // System properties.
-  //
-  archived: Schema.optional(Schema.Boolean.annotations({
-    title: "Archive Space"
-  })),
-  // TODO(burdon): Change to mode (no booleans?)
-  // TODO(wittjosiah): Make optional with default value.
-  edgeReplication: Schema.optional(Schema.Boolean),
-  invocationTraceQueue: Schema.optional(Type.Ref(Queue)),
-  //
-  // User properties.
-  //
-  name: Schema.optional(Schema.String),
-  icon: Schema.optional(Schema.String),
-  hue: Schema.optional(Schema.String)
-}, {
-  key: Schema.String,
-  value: Schema.Any
-});
-var SpaceProperties = SpacePropertiesSchema.pipe(Type.object({
-  // TODO(burdon): Rename SpaceProperties.
-  typename: "dxos.org/type/Properties",
-  version: "0.1.0"
-}), Annotation.SystemTypeAnnotation.set(true));
-
-export {
-  SpacePropertiesSchema,
-  SpaceProperties
-};
-//# sourceMappingURL=chunk-EM6VN4X6.mjs.map

package/dist/lib/node-esm/chunk-EM6VN4X6.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/types/SpaceProperties.ts"],
-  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Annotation, Type } from '@dxos/echo';\nimport { Queue } from '@dxos/echo-db';\n\nexport const SpacePropertiesSchema = Schema.Struct(\n  {\n    //\n    // System properties.\n    //\n\n    archived: Schema.optional(Schema.Boolean.annotations({ title: 'Archive Space' })),\n    // TODO(burdon): Change to mode (no booleans?)\n    // TODO(wittjosiah): Make optional with default value.\n    edgeReplication: Schema.optional(Schema.Boolean),\n    invocationTraceQueue: Schema.optional(Type.Ref(Queue)),\n\n    //\n    // User properties.\n    //\n\n    name: Schema.optional(Schema.String),\n    icon: Schema.optional(Schema.String),\n    hue: Schema.optional(Schema.String),\n  },\n  {\n    key: Schema.String,\n    value: Schema.Any,\n  },\n);\n\nexport type SpacePropertiesSchema = Schema.Schema.Type<typeof SpacePropertiesSchema>;\n\n// TODO(burdon): Pipe Schem.optional, or partial to entire struct to make everything optional?\n// TODO(burdon): Is separate schema def required for forms? Can it be extracted from SpaceProperties?\nexport const SpaceProperties = SpacePropertiesSchema.pipe(\n  Type.object({\n    // TODO(burdon): Rename SpaceProperties.\n    typename: 'dxos.org/type/Properties',\n    version: '0.1.0',\n  }),\n  Annotation.SystemTypeAnnotation.set(true),\n);\n\nexport interface SpaceProperties extends Schema.Schema.Type<typeof SpaceProperties> {}\n"],
-  "mappings": ";;;AAIA,YAAYA,YAAY;AAExB,SAASC,YAAYC,YAAY;AACjC,SAASC,aAAa;AAEf,IAAMC,wBAA+BC,cAC1C;;;;EAKEC,UAAiBC,gBAAgBC,eAAQC,YAAY;IAAEC,OAAO;EAAgB,CAAA,CAAA;;;EAG9EC,iBAAwBJ,gBAAgBC,cAAO;EAC/CI,sBAA6BL,gBAASM,KAAKC,IAAIC,KAAAA,CAAAA;;;;EAM/CC,MAAaT,gBAAgBU,aAAM;EACnCC,MAAaX,gBAAgBU,aAAM;EACnCE,KAAYZ,gBAAgBU,aAAM;AACpC,GACA;EACEG,KAAYH;EACZI,OAAcC;AAChB,CAAA;AAOK,IAAMC,kBAAkBnB,sBAAsBoB,KACnDX,KAAKY,OAAO;;EAEVC,UAAU;EACVC,SAAS;AACX,CAAA,GACAC,WAAWC,qBAAqBC,IAAI,IAAA,CAAA;",
-  "names": ["Schema", "Annotation", "Type", "Queue", "SpacePropertiesSchema", "Struct", "archived", "optional", "Boolean", "annotations", "title", "edgeReplication", "invocationTraceQueue", "Type", "Ref", "Queue", "name", "String", "icon", "hue", "key", "value", "Any", "SpaceProperties", "pipe", "object", "typename", "version", "Annotation", "SystemTypeAnnotation", "set"]
-}