@dxos/protocols 2.33.9-dev.2637427f → 2.33.9-dev.37a7739a

package/src/proto/dxos/config.proto

@@ -4,61 +4,61 @@
 
 syntax = "proto3";
 
+package dxos.config;
+
 import "google/protobuf/any.proto";
 import "google/protobuf/timestamp.proto";
 import "google/protobuf/descriptor.proto";
 
-package dxos.config;
-
 message Config {
-  int32 version = 1;
+  optional int32 version = 1;
 
   //
   // Package definition.
   //
 
-  Package package = 2;
+  optional Package package = 2;
 
   //
   // Runtime configuration.
   //
 
-  Runtime runtime = 3;
+  optional Runtime runtime = 3;
 }
 
 message Package {
-  string license = 1;
+  optional string license = 1;
   repeated Repo repos = 2;
   repeated Module modules = 3;
 }
 
 // TODO(wittjosiah): Shared with registry types. Factor out?
 message Repo {
-  string name = 1;
-  string url = 2;
-  string version = 3;
+  optional string name = 1;
+  optional string url = 2;
+  optional string version = 3;
 }
 
 message Module {
   message Build {
-    string command = 1;
-    string outdir = 2;
-    string version = 3;
-    string tag = 4;
+    optional string command = 1;
+    optional string outdir = 2;
+    optional string version = 3;
+    optional string tag = 4;
   }
 
-  string name = 1;
-  string type = 2;
-  string display_name = 3;
-  string description = 4;
+  optional string name = 1;
+  optional string type = 2;
+  optional string display_name = 3;
+  optional string description = 4;
   repeated string tags = 5;
 
-  Build build = 100;
+  optional Build build = 100;
   repeated Repo repos = 101;
 
   /// Data which will be included as apart of DXNS record.
   /// The data will be validated based on the type when being published.
-  google.protobuf.Any record = 200;
+  optional google.protobuf.Any record = 200;
 }
 
 message Runtime {
@@ -82,73 +82,76 @@ message Runtime {
         CHROME = 2;
         FIREFOX = 3;
         NODE = 4;
-        
+
         // Only for key storage:
 
         LEVELJS = 11;
         JSONDOWN = 12;
       }
 
-      bool persistent = 1;
-      StorageDriver storage_type = 2;
-      StorageDriver key_storage = 3;
-      string path = 4;
+      optional bool persistent = 1;
+      optional StorageDriver storage_type = 2;
+      optional StorageDriver key_storage = 3;
+      optional string path = 4;
     }
 
-    string debug = 1 [(env) = "DEBUG"];
-    Storage storage = 2;
-    bool enable_snapshots = 3;
+    optional string debug = 1 [(env) = "DEBUG"];
+    optional Storage storage = 2;
+    optional bool enable_snapshots = 3;
 
     /// Milliseconds
-    int32 snapshot_interval = 4;
+    optional int32 snapshot_interval = 4;
 
     /// Milliseconds
-    int32 invitation_expiration = 5;
+    optional int32 invitation_expiration = 5;
+
+    // TODO(wittjosiah): Remove.
+    optional Mode mode = 6;
 
-    Mode mode = 6;
+    optional string singleton_source = 7;
   }
 
   message App {
-    string org = 1;
-    string theme = 2;
-    string website = 3;
-    string public_url = 4 [(env) = "PUBLIC_URL"];
+    optional string org = 1;
+    optional string theme = 2;
+    optional string website = 3;
+    optional string public_url = 4 [(env) = "PUBLIC_URL"];
   }
 
   // CLI configuration
   message CLI {
     message AppServe {
       message Serve {
-        string config = 1;
-        string login_app = 2;
-        string key_phrase = 3;
+        optional string config = 1;
+        optional string login_app = 2;
+        optional string key_phrase = 3;
       }
 
-      Serve serve = 1;
+      optional Serve serve = 1;
     }
 
     message Package {
-      string package = 1;
-      string channel = 2;
-      string bin = 3;
-      string config = 4;
+      optional string package = 1;
+      optional string channel = 2;
+      optional string bin = 3;
+      optional string config = 4;
     }
 
-    string node_path = 1;
-    AppServe app = 2;
-    Package console = 3;
-    Package mdns = 4;
-    Package signal = 5;
-    string npm_client = 6;
-    string channel = 7;
+    optional string node_path = 1;
+    optional AppServe app = 2;
+    optional Package console = 3;
+    optional Package mdns = 4;
+    optional Package signal = 5;
+    optional string npm_client = 6;
+    optional string channel = 7;
   }
 
   message Props {
-    string title = 1;
+    optional string title = 1;
   }
 
   message System {
-    string debug = 1;
+    optional string debug = 1;
   }
 
   //
@@ -158,91 +161,91 @@ message Runtime {
     message Kube {
 
       message Endpoints {
-        string logs = 1;
-        string services = 2;
-        string cert = 3;
+        optional string logs = 1;
+        optional string services = 2;
+        optional string cert = 3;
       }
-    
-      Endpoints endpoints = 1;
-      string public_url = 2;
+
+      optional Endpoints endpoints = 1;
+      optional string public_url = 2;
     }
 
     message AppServer {
-      string prefix = 1;
-      string server = 2;
+      optional string prefix = 1;
+      optional string server = 2;
     }
 
     message Dxns {
       /// DXNS endpoint.
-      string server = 1;
+      optional string server = 1;
 
       /**
-      * Substrate account URI. This is a secret.
-      * KUBEs do not serve this with the config but we store it in profile.yml.
-      *
-      * TODO(dmaretskyi): Deprecate this and move it to keyring.
-      */
-      string account_uri = 2;
+       * Substrate account URI. This is a secret.
+       * KUBEs do not serve this with the config but we store it in profile.yml.
+       *
+       * TODO(dmaretskyi): Deprecate this and move it to keyring.
+       */
+      optional string account_uri = 2;
 
       /**
        * Public Polkadot Address.
-      */
-      string address = 3;
+       */
+      optional string address = 3;
 
       /**
        * Public address of a DXNS Account.
-      */
-      string account = 4;
+       */
+      optional string account = 4;
 
-      string faucet = 5;
+      optional string faucet = 5;
     }
 
     message Ipfs {
-      string server = 1;
-      string gateway = 2;
+      optional string server = 1;
+      optional string gateway = 2;
     }
 
     message Signal {
-      string server = 1;
-      string api = 2;
-      string status = 3;
+      optional string server = 1;
+      optional string api = 2;
+      optional string status = 3;
     }
 
     message Ice {
-      string urls = 1;
-      string username = 2;
-      string credential = 3;
+      optional string urls = 1;
+      optional string username = 2;
+      optional string credential = 3;
     }
 
     message Machine {
-      string do_access_token = 1;
-      string github_access_token = 2;
-      string github_username = 3;
-      string dns_domain = 4;
-      string npm_access_token = 5;
+      optional string do_access_token = 1;
+      optional string github_access_token = 2;
+      optional string github_username = 3;
+      optional string dns_domain = 4;
+      optional string npm_access_token = 5;
     }
 
     message BotFactory {
-      string topic = 1;
-      bool persistent = 2;
-      int32 retry_attempts = 3;
-      int32 retry_interval = 4;
+      optional string topic = 1;
+      optional bool persistent = 2;
+      optional int32 retry_attempts = 3;
+      optional int32 retry_interval = 4;
     }
 
-    Kube kube = 1;
-    AppServer app = 2;
-    Dxns dxns = 3;
-    Ipfs ipfs = 4;
-    Signal signal = 5;
+    optional Kube kube = 1;
+    optional AppServer app = 2;
+    optional Dxns dxns = 3;
+    optional Ipfs ipfs = 4;
+    optional Signal signal = 5;
     repeated Ice ice = 6;
-    Machine machine = 7;
-    BotFactory bot = 8;
+    optional Machine machine = 7;
+    optional BotFactory bot = 8;
   }
 
-  Client client = 1;
-  App app = 2;
-  CLI cli = 3;
-  Props props = 4;
-  Services services = 5;
-  System system = 6;
+  optional Client client = 1;
+  optional App app = 2;
+  optional CLI cli = 3;
+  optional Props props = 4;
+  optional Services services = 5;
+  optional System system = 6;
 }

package/src/proto/dxos/devtools.proto

@@ -83,21 +83,21 @@ message GetConfigResponse {
 // EnableDebugLogging
 
 message EnableDebugLoggingRequest {
-  string namespaces = 1;
+  optional string namespaces = 1;
 }
 
 message EnableDebugLoggingResponse {
-  string enabledNamespaces = 1;
+  optional string enabledNamespaces = 1;
 }
 
 // DisableDebugLogging
 
 message DisableDebugLoggingRequest {
-  string namespaces = 1;
+  optional string namespaces = 1;
 }
 
 message DisableDebugLoggingResponse {
-  string enabledNamespaces = 1;
+  optional string enabledNamespaces = 1;
 }
 
 // SubscribeToKeyringKeys
@@ -111,7 +111,7 @@ message SubscribeToKeyringKeysResponse {
 // SubscribeToCredential
 
 message SubscribeToCredentialMessagesRequest {
-  PubKey partyKey = 1;
+  optional PubKey partyKey = 1;
 }
 
 message SubscribeToCredentialMessagesResponse {
@@ -188,9 +188,9 @@ message SubscribeToFeedsResponse {
 // SubscribeToFeedMessages
 
 message SubscribeToFeedBlocksRequest {
-  PubKey partyKey = 1;
-  PubKey feedKey = 2;
-  int32 maxBlocks = 3;
+  optional PubKey partyKey = 1;
+  optional PubKey feedKey = 2;
+  optional int32 maxBlocks = 3;
 }
 
 message SubscribeToFeedBlocksResponse {
@@ -212,7 +212,7 @@ message GetPartySnapshotRequest {
 }
 
 message GetPartySnapshotResponse {
-  PartySnapshot snapshot = 1;
+  optional PartySnapshot snapshot = 1;
 }
 
 // SavePartySnapshot
@@ -222,7 +222,7 @@ message SavePartySnapshotRequest {
 }
 
 message SavePartySnapshotResponse {
-  PartySnapshot snapshot = 1;
+  optional PartySnapshot snapshot = 1;
 }
 
 // ClearSnapshots
@@ -234,7 +234,7 @@ message ClearSnapshotsRequest {}
 message SubscribeToNetworkTopicsResponse {
   message Topic {
     PubKey topic = 1;
-    string label = 2;
+    optional string label = 2;
   }
 
   repeated Topic topics = 1;
@@ -249,7 +249,7 @@ message SubscribeToSignalStatusResponse {
     // SignalApi.State enum.
     string state = 2;
 
-    string error = 3;
+    optional string error = 3;
 
     // Number of milliseconds before reconnection.
     // TODO(dmaretskyi): Represent as absolute timestamp.
@@ -279,16 +279,16 @@ message SubscribeToSwarmInfoResponse {
   message SwarmInfo {
     PubKey id = 1;
     PubKey topic = 2;
-    string label = 3;
+    optional string label = 3;
     bool isActive = 4;
     message ConnectionInfo {
       message Json {
-        string data = 1;
+        optional string data = 1;
       }
       string state = 1;
       PubKey sessionId = 2;
       PubKey remotePeerId = 3;
-      string transport = 4;
+      optional string transport = 4;
       repeated string protocolExtensions = 5;
       repeated Json events = 6;
     }

package/src/proto/dxos/echo/feed.proto

@@ -8,6 +8,7 @@ syntax = "proto3";
 package dxos.echo.feed;
 
 import "google/protobuf/any.proto";
+
 import "./snapshot.proto";
 import "./timeframe.proto";
 
@@ -39,16 +40,16 @@ message EchoEnvelope {
   string itemId = 1;
 
   // Create item.
-  ItemGenesis genesis = 10;
+  optional ItemGenesis genesis = 10;
 
   // Item system mutations.
-  ItemMutation itemMutation = 11;
+  optional ItemMutation itemMutation = 11;
 
   // Model-specific mutations.
-  bytes mutation = 12;
+  optional bytes mutation = 12;
 
   /// Set the model to the provided snapshot.
-  ModelSnapshot snapshot = 13;
+  optional ModelSnapshot snapshot = 13;
 }
 
 // TODO(burdon): Document (different from parent/child).?
@@ -63,10 +64,10 @@ message LinkData {
  */
 // TODO(burdon): EntityGenesis?
 message ItemGenesis {
-  string itemType = 1;
+  optional string itemType = 1;
   string modelType = 2;
-  string modelVersion = 3;
-  LinkData link = 4;
+  optional string modelVersion = 3;
+  optional LinkData link = 4;
 }
 
 /**
@@ -79,6 +80,6 @@ message ItemMutation {
     RESTORE = 2;
   }
 
-  string parentId = 1;  // TODO(burdon): Define Action type?
-  Action action = 2;
+  optional string parentId = 1;  // TODO(burdon): Define Action type?
+  optional Action action = 2;
 }

package/src/proto/dxos/echo/invitation.proto

@@ -22,8 +22,8 @@ message InvitationDescriptor {
   bytes invitation = 3;
 
   /// Only present if type == OFFLINE.
-  bytes identityKey = 4;
+  optional bytes identityKey = 4;
 
   /// Must be stripped out when passing to another peer.
-  bytes secret = 5;
+  optional bytes secret = 5;
 }

package/src/proto/dxos/echo/metadata.proto

@@ -7,12 +7,13 @@ syntax = "proto3";
 package dxos.echo.metadata;
 
 import "google/protobuf/timestamp.proto";
+
 import "../halo/keys.proto";
 
 message EchoMetadata {
   /**
    * Version number that is inceremnted every time there's a breaking change to the storage schema.
-   * 
+   *
    * This is used to detect if the storage schema has changed since the last time the client was run.
    * Loading data from a different version will might result in an error.
    */
@@ -29,17 +30,17 @@ message PartyMetadata {
   /// Party key.
   PubKey key = 1;
 
-  PubKey genesis_feed_key = 6;
+  optional PubKey genesis_feed_key = 6;
 
   /// Key of the wriatable control feed.
-  PubKey control_feed_key = 4;
+  optional PubKey control_feed_key = 4;
 
   /// Key of the wriatable data feed.
-  PubKey data_feed_key = 3;
+  optional PubKey data_feed_key = 3;
 
   // Latest timeframe reached while processing party messages.
-  TimeframeVector latest_timeframe = 5;
+  optional TimeframeVector latest_timeframe = 5;
 
   /// List of all feed associated with the party.
   repeated PubKey feed_keys = 2;
-}
+}

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

@@ -5,8 +5,8 @@
 syntax = "proto3";
 
 import "../halo/keys.proto";
-import "feed.proto";
-import "snapshot.proto";
+import "./feed.proto";
+import "./snapshot.proto";
 
 package dxos.echo.service;
 
@@ -59,6 +59,6 @@ service DataService {
   rpc SubscribeEntitySet(SubscribeEntitySetRequest) returns (stream SubscribeEntitySetResponse);
 
   rpc SubscribeEntityStream(SubscribeEntityStreamRequest) returns (stream SubscribeEntityStreamResponse);
-   
+
   rpc Write(WriteRequest) returns (MutationReceipt);
 }

package/src/proto/dxos/echo/snapshot.proto

@@ -6,8 +6,8 @@ syntax = "proto3";
 
 package dxos.echo.snapshot;
 
-import "./feed.proto";
 import "../halo/keys.proto";
+import "./feed.proto";
 
 //
 // Snapshots define full party state at a given point in time.
@@ -20,10 +20,11 @@ import "../halo/keys.proto";
 
 message PartySnapshot {
   bytes partyKey = 1;
-  TimeframeVector timeframe = 2;
+  optional TimeframeVector timeframe = 2;
 
   // Unix timestamp of the snapshot creation time. For information purposes only.
-  int32 timestamp = 3;
+  // TODO(dmaretskyi): Convert to google.protobuf.Timestamp.
+  optional int32 timestamp = 3;
 
   HaloStateSnapshot halo = 11;
   // TODO(dmaretskyi): Rename to EchoSnapshot.
@@ -48,7 +49,7 @@ message DatabaseSnapshot {
 message ItemSnapshot {
   optional string itemId = 1;
   optional string itemType = 2;
-  optional string modelType = 3;
+  string modelType = 3;
   optional string modelVersion = 4;
   optional string parentId = 5;
   optional ModelSnapshot model = 6;
@@ -57,7 +58,7 @@ message ItemSnapshot {
 message LinkSnapshot {
   optional string linkId = 1;
   optional string linkType = 2;
-  optional string modelType = 3;
+  string modelType = 3;
   optional string modelVersion = 4;
   required string source = 5;
   required string target = 6;

package/src/proto/dxos/halo/auth.proto

@@ -6,25 +6,25 @@ syntax = "proto3";
 
 package dxos.credentials.auth;
 
-import "keys.proto";
-import "signed.proto";
+import "./keys.proto";
+import "./signed.proto";
 
 /**
  * The payload for a SignedMessage sent during handshake for replication authentication.
  */
 message Auth {
   /// The publicKey of the target Party for these credentials.
-  PubKey partyKey = 1;     
-  
+  PubKey partyKey = 1;
+
   /// The publicKey of the authenticating Device.
-  PubKey deviceKey = 2;    
-  
+  PubKey deviceKey = 2;
+
   /// The publicKey of the authenticating Identity.
-  PubKey identityKey = 3;  
-  
+  PubKey identityKey = 3;
+
   /// The publicKey of the authenticating Identity.
-  PubKey feedKey = 4;      
+  optional PubKey feedKey = 4;
 
   /// FeedAdmit message to the should be written to a control feed in case the `feedKey` is not admitted to the party.
-  google.protobuf.Any feed_admit = 5;
+  optional google.protobuf.Any feed_admit = 5;
 }

package/src/proto/dxos/halo/greet.proto

@@ -6,11 +6,12 @@ syntax = "proto3";
 
 package dxos.credentials.greet;
 
-import "keys.proto";
-import "party.proto";
 import "google/protobuf/any.proto";
 import "google/protobuf/wrappers.proto";
 
+import "./keys.proto";
+import "./party.proto";
+
 //
 // Greeting protocol:
 //
@@ -57,7 +58,7 @@ message Command {
   Type command = 1;
 
   // Auth secret (PIN, hash, AuthMessage, etc.).
-  bytes secret = 2;
+  optional bytes secret = 2;
 
   // TODO(burdon): These seem to be signed messages? In which case we already know the type.
   // TODO(dboreham): static typing of contained messages is not yet supported, change from any when it is.

package/src/proto/dxos/halo/identity.proto

@@ -7,18 +7,19 @@ syntax = "proto3";
 package dxos.credentials.identity;
 
 import "google/protobuf/any.proto";
-import "greet.proto";
-import "keys.proto";
-import "signed.proto";
+
+import "./greet.proto";
+import "./keys.proto";
+import "./signed.proto";
 
 // Additional, descriptive information about an Identity. Must be signed by the Identity's key.
 message IdentityInfo {
-  PubKey publicKey = 1;          // The publicKey of the Identity (must be signed by this key).
-  string displayName = 2;       // The display name to use for this key.
+  PubKey publicKey = 1;           // The publicKey of the Identity (must be signed by this key).
+  string displayName = 2;         // The display name to use for this key.
 }
 
 // Additional, descriptive information about a Device. Must be signed by the Device's key.
 message DeviceInfo {
-  PubKey publicKey = 1;          // The publicKey of the Device (must be signed by this key).
-  string displayName = 2;       // The display name to use for this key.
+  PubKey publicKey = 1;           // The publicKey of the Device (must be signed by this key).
+  string displayName = 2;         // The display name to use for this key.
 }