@dxos/protocols 0.4.10-main.826d4ee → 0.4.10-main.85f8e19

package/dist/esm/src/proto/gen/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/proto/gen/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AA8DhE,OAAO,aAAa,MAAM,kBAAkB,CAAC;AA4hB7C,MAAM,CAAC,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,y+rGAAy+rG,CAAC,CAAC,CAAC;AAClisG,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAkB,UAAU,EAAE,aAAa,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/proto/gen/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AA8DhE,OAAO,aAAa,MAAM,kBAAkB,CAAC;AA6hB7C,MAAM,CAAC,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,u+tGAAu+tG,CAAC,CAAC,CAAC;AAChiuG,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAkB,UAAU,EAAE,aAAa,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/protocols",
-  "version": "0.4.10-main.826d4ee",
+  "version": "0.4.10-main.85f8e19",
   "description": "Protobuf definitions for DXOS protocols.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -33,10 +33,10 @@
     "src"
   ],
   "dependencies": {
-    "@dxos/codec-protobuf": "0.4.10-main.826d4ee",
-    "@dxos/invariant": "0.4.10-main.826d4ee",
-    "@dxos/keys": "0.4.10-main.826d4ee",
-    "@dxos/timeframe": "0.4.10-main.826d4ee"
+    "@dxos/codec-protobuf": "0.4.10-main.85f8e19",
+    "@dxos/invariant": "0.4.10-main.85f8e19",
+    "@dxos/timeframe": "0.4.10-main.85f8e19",
+    "@dxos/keys": "0.4.10-main.85f8e19"
   },
   "devDependencies": {
     "glob": "~7.1.6"

package/src/indexing.ts

@@ -2,14 +2,16 @@
 // Copyright 2024 DXOS.org
 //
 
-export type IdDecoded = {
+export type ObjectPointerDecoded = {
   documentId: string;
   objectId: string;
 };
 
+export type ObjectPointerEncoded = string;
+
 export const idCodec = {
-  encode: ({ documentId, objectId }: IdDecoded) => `${documentId}|${objectId}`,
-  decode: (id: string): IdDecoded => {
+  encode: ({ documentId, objectId }: ObjectPointerDecoded): ObjectPointerEncoded => `${documentId}|${objectId}`,
+  decode: (id: ObjectPointerEncoded): ObjectPointerDecoded => {
     const [documentId, objectId] = id.split('|');
     return { documentId, objectId };
   },

package/src/proto/dxos/client/services.proto

@@ -390,7 +390,8 @@ service SpacesService {
 
 service IndexService {
   rpc SetConfig(dxos.echo.indexing.IndexConfig) returns (google.protobuf.Empty);
-  rpc Find(dxos.agent.query.QueryRequest) returns (dxos.agent.query.QueryResponse);
+  rpc Find(dxos.agent.query.QueryRequest) returns (stream dxos.agent.query.QueryResponse);
+  
 }
 
 //
@@ -404,9 +405,12 @@ message Invitation {
   enum Type {
     /// Requires both to be online to complete key exchange.
     INTERACTIVE = 0;
-    /// Guest's identity key is known; invitation can be accepted by any valid peer.
-    OFFLINE = 1;
-    /// Multiple-use interactive invitation.
+    /// Invitation can be accepted by any valid peer.
+    DELEGATED = 1;
+    /**
+     * Multi-use interactive invitations.
+     * @deprecated use multiUse flag with type=interactive instead.
+     */
     MULTIUSE = 2;
   }
 
@@ -421,6 +425,9 @@ message Invitation {
 
     /// Guest should call `Authenticate` with the shared secret.
     SHARED_SECRET = 1;
+
+    /// Guest should prove they possess a private key corresponding to the known public key recorded in an invitation.
+    KNOWN_PUBLIC_KEY = 2;
   }
 
   enum State {
@@ -479,6 +486,17 @@ message Invitation {
   // TODO(nf): some feedback mechanism or GC for immortal invitations?
   // TODO(nf): should the creator have a way to make an invitation last as long as the client? this was the previous behavior.
   optional int32 lifetime = 14;
+
+  /// Whether an invitation can be used multiple times.
+  optional bool multi_use = 15;
+
+  /// Guest's keypair required for AuthMethod.KNOWN_PUBLIC_KEY.
+  optional AdmissionKeypair guest_keypair = 16;
+}
+
+message AdmissionKeypair {
+  dxos.keys.PublicKey public_key = 1;
+  optional dxos.keys.PrivateKey private_key = 2;
 }
 
 message AcceptInvitationRequest {
@@ -533,7 +551,6 @@ service InvitationsService {
   rpc Authenticate(AuthenticationRequest) returns (google.protobuf.Empty);
   rpc CancelInvitation(CancelInvitationRequest) returns (google.protobuf.Empty);
   rpc QueryInvitations(google.protobuf.Empty) returns (stream QueryInvitationsResponse);
-  rpc LoadPersistentInvitations(google.protobuf.Empty) returns (LoadPersistentInvitationsResponse);
 }
 
 //

package/src/proto/dxos/config.proto

@@ -103,6 +103,10 @@ message Runtime {
       optional StorageDriver key_store = 2;
       optional StorageDriver data_store = 3;
       optional string data_root = 4;
+      
+      /**
+       * @deprecated
+       */
       optional bool space_fragmentation = 5;
     }
     
@@ -127,12 +131,13 @@ message Runtime {
     /// Location of the remote client host.
     // TODO(burdon): Rename vault_endpoint (generalize http/ws; drop vault.html).
     optional string remote_source = 6;
-    
+
+    // Authenticate via `Sec-WebSocket-Protocol` header hack.
+    optional string remote_source_authentication_token = 8;
+
     /// Connect to and serve client services to a remote proxy.
     optional string devtools_proxy = 7;
 
-    /// Enable E.object api
-    optional bool use_reactive_object_api = 8;
   }
 
   message App {

package/src/proto/dxos/echo/model/document.proto

@@ -32,9 +32,6 @@ message Value {
     Array array                       = 21;
 
     Reference reference               = 30;
-
-    // YJS state snapshot.
-    YJS yjs                           = 40;
   }
 }
 

package/src/proto/dxos/echo/service.proto

@@ -47,7 +47,11 @@ message MutationReceipt {
 }
 
 message FlushRequest {
-  dxos.keys.PublicKey space_key = 1;
+  optional dxos.keys.PublicKey space_key = 1;
+  /**
+   * Automerge specific document ids to wait to flush.
+   */
+  repeated string document_ids = 2;
 }
 
 // Automerge specific.

package/src/proto/dxos/halo/invitations.proto

@@ -33,12 +33,19 @@ message IntroductionRequest {
 message IntroductionResponse {
   dxos.client.services.Invitation.AuthMethod auth_method = 1;
 
+  /// Present when auth_method is KNOWN_PUBLIC_KEY.
+  optional bytes challenge = 2;
+
   /// Only present for testing invitation types.
   optional dxos.keys.PublicKey space_key = 100;
 }
 
 message AuthenticationRequest {
-  string auth_code = 1;
+  /// Present when auth_method is SHARED_SECRET.
+  optional string auth_code = 1;
+
+  /// Present when auth_method is KNOWN_PUBLIC_KEY.
+  optional bytes signed_challenge = 2;
 }
 
 message AuthenticationResponse {
@@ -47,6 +54,7 @@ message AuthenticationResponse {
     INVALID_OTP = 1;
     INVALID_OPT_ATTEMPTS = 2;
     INTERNAL_ERROR = 3;
+    INVALID_SIGNATURE = 4;
   }
 
   optional Status status = 1;

package/src/proto/dxos/iframe.proto

@@ -55,11 +55,13 @@ service AppService {
 enum ShellLayout {
   DEFAULT = 0;
   INITIALIZE_IDENTITY = 1;
-  IDENTITY = 2;
-  SHARE_IDENTITY = 3;
-  EDIT_PROFILE = 4;
-  SPACE = 5;
-  JOIN_SPACE = 6;
+  INITIALIZE_IDENTITY_FROM_INVITATION = 2;
+  IDENTITY = 3;
+  SHARE_IDENTITY = 4;
+  EDIT_PROFILE = 5;
+  SPACE = 6;
+  JOIN_SPACE = 7;
+  STATUS = 8;
 }
 
 message LayoutRequest {

package/src/proto/gen/dxos/client/services.ts

@@ -840,7 +840,7 @@ export interface SpacesService {
  */
 export interface IndexService {
     setConfig: (request: dxos_echo_indexing.IndexConfig, options?: RequestOptions) => Promise<void>;
-    find: (request: dxos_agent_query.QueryRequest, options?: RequestOptions) => Promise<dxos_agent_query.QueryResponse>;
+    find: (request: dxos_agent_query.QueryRequest, options?: RequestOptions) => Stream<dxos_agent_query.QueryResponse>;
 }
 /**
  * Represents the invitation state passed between client and service.
@@ -925,6 +925,20 @@ export interface Invitation {
      *   - proto3_optional = true
      */
     lifetime?: number;
+    /**
+     * Whether an invitation can be used multiple times.
+     *
+     * Options:
+     *   - proto3_optional = true
+     */
+    multiUse?: boolean;
+    /**
+     * Guest's keypair required for AuthMethod.KNOWN_PUBLIC_KEY.
+     *
+     * Options:
+     *   - proto3_optional = true
+     */
+    guestKeypair?: AdmissionKeypair;
 }
 export namespace Invitation {
     /**
@@ -933,7 +947,7 @@ export namespace Invitation {
      */
     export enum Type {
         INTERACTIVE = 0,
-        OFFLINE = 1,
+        DELEGATED = 1,
         MULTIUSE = 2
     }
     /**
@@ -950,7 +964,8 @@ export namespace Invitation {
      */
     export enum AuthMethod {
         NONE = 0,
-        SHARED_SECRET = 1
+        SHARED_SECRET = 1,
+        KNOWN_PUBLIC_KEY = 2
     }
     /**
      * Defined in:
@@ -969,6 +984,18 @@ export namespace Invitation {
         EXPIRED = 9
     }
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../dxos/client/services.proto}
+ */
+export interface AdmissionKeypair {
+    publicKey: ReturnType<(typeof substitutions)["dxos.keys.PublicKey"]["decode"]>;
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
+    privateKey?: ReturnType<(typeof substitutions)["dxos.keys.PrivateKey"]["decode"]>;
+}
 /**
  * Defined in:
  *   {@link file://./../../../dxos/client/services.proto}
@@ -1055,7 +1082,6 @@ export interface InvitationsService {
     authenticate: (request: AuthenticationRequest, options?: RequestOptions) => Promise<void>;
     cancelInvitation: (request: CancelInvitationRequest, options?: RequestOptions) => Promise<void>;
     queryInvitations: (request: void, options?: RequestOptions) => Stream<QueryInvitationsResponse>;
-    loadPersistentInvitations: (request: void, options?: RequestOptions) => Promise<LoadPersistentInvitationsResponse>;
 }
 /**
  * Defined in:

package/src/proto/gen/dxos/config.ts

@@ -292,19 +292,17 @@ export namespace Runtime {
          */
         remoteSource?: string;
         /**
-         * Connect to and serve client services to a remote proxy.
-         *
          * Options:
          *   - proto3_optional = true
          */
-        devtoolsProxy?: string;
+        remoteSourceAuthenticationToken?: string;
         /**
-         * Enable E.object api
+         * Connect to and serve client services to a remote proxy.
          *
          * Options:
          *   - proto3_optional = true
          */
-        useReactiveObjectApi?: boolean;
+        devtoolsProxy?: string;
     }
     export namespace Client {
         /**
@@ -333,6 +331,8 @@ export namespace Runtime {
              */
             dataRoot?: string;
             /**
+             * @deprecated
+             *
              * Options:
              *   - proto3_optional = true
              */

package/src/proto/gen/dxos/echo/model/document.ts

@@ -78,7 +78,6 @@ export interface Value {
     object?: KeyValueObject;
     array?: Array;
     reference?: Reference;
-    yjs?: YJS;
 }
 /**
  * Ordered collection of values.

package/src/proto/gen/dxos/echo/service.ts

@@ -135,7 +135,15 @@ export interface MutationReceipt {
  *   {@link file://./../../../dxos/echo/service.proto}
  */
 export interface FlushRequest {
-    spaceKey: ReturnType<(typeof substitutions)["dxos.keys.PublicKey"]["decode"]>;
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
+    spaceKey?: ReturnType<(typeof substitutions)["dxos.keys.PublicKey"]["decode"]>;
+    /**
+     * Automerge specific document ids to wait to flush.
+     */
+    documentIds?: string[];
 }
 /**
  * Defined in:

package/src/proto/gen/dxos/halo/invitations.ts

@@ -104,6 +104,13 @@ export interface IntroductionRequest {
  */
 export interface IntroductionResponse {
     authMethod: dxos_client_services.Invitation.AuthMethod;
+    /**
+     * Present when auth_method is KNOWN_PUBLIC_KEY.
+     *
+     * Options:
+     *   - proto3_optional = true
+     */
+    challenge?: Uint8Array;
     /**
      * Only present for testing invitation types.
      *
@@ -117,7 +124,20 @@ export interface IntroductionResponse {
  *   {@link file://./../../../dxos/halo/invitations.proto}
  */
 export interface AuthenticationRequest {
-    authCode: string;
+    /**
+     * Present when auth_method is SHARED_SECRET.
+     *
+     * Options:
+     *   - proto3_optional = true
+     */
+    authCode?: string;
+    /**
+     * Present when auth_method is KNOWN_PUBLIC_KEY.
+     *
+     * Options:
+     *   - proto3_optional = true
+     */
+    signedChallenge?: Uint8Array;
 }
 /**
  * Defined in:
@@ -139,7 +159,8 @@ export namespace AuthenticationResponse {
         OK = 0,
         INVALID_OTP = 1,
         INVALID_OPT_ATTEMPTS = 2,
-        INTERNAL_ERROR = 3
+        INTERNAL_ERROR = 3,
+        INVALID_SIGNATURE = 4
     }
 }
 /**

package/src/proto/gen/dxos/iframe.ts

@@ -152,11 +152,13 @@ export interface AppService {
 export enum ShellLayout {
     DEFAULT = 0,
     INITIALIZE_IDENTITY = 1,
-    IDENTITY = 2,
-    SHARE_IDENTITY = 3,
-    EDIT_PROFILE = 4,
-    SPACE = 5,
-    JOIN_SPACE = 6
+    INITIALIZE_IDENTITY_FROM_INVITATION = 2,
+    IDENTITY = 3,
+    SHARE_IDENTITY = 4,
+    EDIT_PROFILE = 5,
+    SPACE = 6,
+    JOIN_SPACE = 7,
+    STATUS = 8
 }
 /**
  * Defined in: