@dxos/protocols 0.5.3-main.bc67fdb → 0.5.3-main.c8ad1bb

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;AA+DhE,OAAO,aAAa,MAAM,kBAAkB,CAAC;AA0iB7C,MAAM,CAAC,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,ug0GAAug0G,CAAC,CAAC,CAAC;AAChk0G,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;AA+DhE,OAAO,aAAa,MAAM,kBAAkB,CAAC;AA2iB7C,MAAM,CAAC,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,4o0GAA4o0G,CAAC,CAAC,CAAC;AACrs0G,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.5.3-main.bc67fdb",
+  "version": "0.5.3-main.c8ad1bb",
   "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.5.3-main.bc67fdb",
-    "@dxos/keys": "0.5.3-main.bc67fdb",
-    "@dxos/invariant": "0.5.3-main.bc67fdb",
-    "@dxos/timeframe": "0.5.3-main.bc67fdb"
+    "@dxos/invariant": "0.5.3-main.c8ad1bb",
+    "@dxos/codec-protobuf": "0.5.3-main.c8ad1bb",
+    "@dxos/keys": "0.5.3-main.c8ad1bb",
+    "@dxos/timeframe": "0.5.3-main.c8ad1bb"
   },
   "devDependencies": {
     "glob": "~7.1.6"

package/src/indexing.test.ts

@@ -0,0 +1,36 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+import { expect } from 'chai';
+
+import { describe, test } from '@dxos/test';
+
+import { ObjectPointerVersion, objectPointerCodec } from './indexing';
+
+describe('Indexing object pointer codec', () => {
+  test('getVersion', async () => {
+    expect(objectPointerCodec.getVersion('aaaa|bbbb')).to.eq(ObjectPointerVersion.V0);
+    expect(objectPointerCodec.getVersion('#01|ssss|aaaa|bbbb')).to.eq(ObjectPointerVersion.V1);
+  });
+
+  test('v0', async () => {
+    expect(objectPointerCodec.encode({ spaceKey: undefined, documentId: 'aaaa', objectId: 'bbbb' })).to.eq('aaaa|bbbb');
+    expect(objectPointerCodec.decode('aaaa|bbbb')).to.eql({
+      spaceKey: undefined,
+      documentId: 'aaaa',
+      objectId: 'bbbb',
+    });
+  });
+
+  test('v1', async () => {
+    expect(objectPointerCodec.encode({ spaceKey: 'ssss', documentId: 'aaaa', objectId: 'bbbb' })).to.eq(
+      '#01|ssss|aaaa|bbbb',
+    );
+    expect(objectPointerCodec.decode('#01|ssss|aaaa|bbbb')).to.eql({
+      spaceKey: 'ssss',
+      documentId: 'aaaa',
+      objectId: 'bbbb',
+    });
+  });
+});

package/src/indexing.ts

@@ -3,19 +3,58 @@
 //
 
 export type ObjectPointerDecoded = {
+  spaceKey: string | undefined;
   documentId: string;
   objectId: string;
 };
 
 /**
- * Encoded object pointer: `${documentId}|${objectId}`.
+ * Encoded object pointer: `#01|${spaceKey}|${documentId}|${objectId}`.
+ * Old format without spaceKey: `${documentId}|${objectId}`.
+ * The spaceKey is optional and was added in the later version.
+ * Space key is encoded in the front to allow prefix iteration.
  */
 export type ObjectPointerEncoded = string;
 
-export const idCodec = {
-  encode: ({ documentId, objectId }: ObjectPointerDecoded): ObjectPointerEncoded => `${documentId}|${objectId}`,
+const V1_PREFIX = '#01';
+
+export enum ObjectPointerVersion {
+  /**
+   * `${documentId}|${objectId}`
+   */
+  V0 = 0,
+  /**
+   * `#01|${spaceKey}|${documentId}|${objectId}`
+   */
+  V1 = 1,
+}
+
+export const objectPointerCodec = {
+  encode: ({ spaceKey, documentId, objectId }: ObjectPointerDecoded): ObjectPointerEncoded => {
+    if (spaceKey === undefined) {
+      return `${documentId}|${objectId}`;
+    } else {
+      return `${V1_PREFIX}|${spaceKey}|${documentId}|${objectId}`;
+    }
+  },
   decode: (id: ObjectPointerEncoded): ObjectPointerDecoded => {
-    const [documentId, objectId] = id.split('|');
-    return { documentId, objectId };
+    if (id.startsWith(V1_PREFIX)) {
+      const [_, spaceKey, documentId, objectId] = id.split('|');
+      return { spaceKey, documentId, objectId };
+    } else {
+      const [documentId, objectId] = id.split('|');
+      return { spaceKey: undefined, documentId, objectId };
+    }
+  },
+  getVersion: (id: ObjectPointerEncoded): ObjectPointerVersion => {
+    if (id.startsWith(V1_PREFIX)) {
+      return ObjectPointerVersion.V1;
+    } else {
+      return ObjectPointerVersion.V0;
+    }
+  },
+  convertV1ToV0: (id: ObjectPointerEncoded): ObjectPointerEncoded => {
+    const { documentId, objectId } = objectPointerCodec.decode(id);
+    return objectPointerCodec.encode({ documentId, objectId, spaceKey: undefined });
   },
 };

package/src/proto/dxos/agent/functions.proto

@@ -16,12 +16,11 @@ message FunctionsConfig {
 
 message Function {
   string id = 1;
-  string path = 2;
+  string route = 2;
 }
 
 message RegisterRequest {
   string endpoint = 1;
-  repeated Function functions = 2;
 }
 
 message RegisterResponse {
@@ -29,11 +28,17 @@ message RegisterResponse {
   string endpoint = 2;
 }
 
+message UpdateRegistrationRequest {
+  string registration_id = 1;
+  repeated Function functions = 2;
+}
+
 message UnregisterRequest {
   string registration_id = 1;
 }
 
 service FunctionRegistryService {
   rpc Register(RegisterRequest) returns (RegisterResponse) {}
+  rpc UpdateRegistration(UpdateRegistrationRequest) returns (google.protobuf.Empty) {}
   rpc Unregister(UnregisterRequest) returns (google.protobuf.Empty) {}
 }

package/src/proto/gen/dxos/agent/functions.ts

@@ -83,7 +83,7 @@ export interface FunctionsConfig {
  */
 export interface Function {
     id: string;
-    path: string;
+    route: string;
 }
 /**
  * Defined in:
@@ -91,7 +91,6 @@ export interface Function {
  */
 export interface RegisterRequest {
     endpoint: string;
-    functions?: Function[];
 }
 /**
  * Defined in:
@@ -101,6 +100,14 @@ export interface RegisterResponse {
     registrationId: string;
     endpoint: string;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../dxos/agent/functions.proto}
+ */
+export interface UpdateRegistrationRequest {
+    registrationId: string;
+    functions?: Function[];
+}
 /**
  * Defined in:
  *   {@link file://./../../../dxos/agent/functions.proto}
@@ -114,5 +121,6 @@ export interface UnregisterRequest {
  */
 export interface FunctionRegistryService {
     register: (request: RegisterRequest, options?: RequestOptions) => Promise<RegisterResponse>;
+    updateRegistration: (request: UpdateRegistrationRequest, options?: RequestOptions) => Promise<void>;
     unregister: (request: UnregisterRequest, options?: RequestOptions) => Promise<void>;
 }

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

@@ -61,181 +61,6 @@ import * as dxos_value from "../value";
 import * as example_testing_data from "../../example/testing/data";
 import * as example_testing_rpc from "../../example/testing/rpc";
 import * as google_protobuf from "../../google/protobuf";
-/**
- * Defined in:
- *   {@link file://./../../../dxos/client/logging.proto}
- */
-export interface Metrics {
-    timestamp: ReturnType<(typeof substitutions)["google.protobuf.Timestamp"]["decode"]>;
-    values?: Metrics.KeyPair[];
-}
-export namespace Metrics {
-    /**
-     * Defined in:
-     *   {@link file://./../../../dxos/client/logging.proto}
-     */
-    export interface KeyPair {
-        /**
-         * Options:
-         *   - proto3_optional = true
-         */
-        key?: string;
-        /**
-         * Options:
-         *   - proto3_optional = true
-         */
-        value?: dxos_value.Value;
-        /**
-         * Options:
-         *   - proto3_optional = true
-         */
-        stats?: dxos_value.Stats;
-    }
-}
-/**
- * Defined in:
- *   {@link file://./../../../dxos/client/logging.proto}
- */
-export interface ControlMetricsRequest {
-    /**
-     * Options:
-     *   - proto3_optional = true
-     */
-    reset?: boolean;
-    /**
-     * Options:
-     *   - proto3_optional = true
-     */
-    record?: boolean;
-}
-/**
- * Defined in:
- *   {@link file://./../../../dxos/client/logging.proto}
- */
-export interface ControlMetricsResponse {
-    /**
-     * Options:
-     *   - proto3_optional = true
-     */
-    recording?: boolean;
-}
-/**
- * Defined in:
- *   {@link file://./../../../dxos/client/logging.proto}
- */
-export interface QueryMetricsRequest {
-    /**
-     * Options:
-     *   - proto3_optional = true
-     */
-    interval?: number;
-}
-/**
- * Defined in:
- *   {@link file://./../../../dxos/client/logging.proto}
- */
-export interface QueryMetricsResponse {
-    timestamp: ReturnType<(typeof substitutions)["google.protobuf.Timestamp"]["decode"]>;
-    metrics: Metrics;
-}
-/**
- * Defined in:
- *   {@link file://./../../../dxos/client/logging.proto}
- */
-export enum LogLevel {
-    TRACE = 5,
-    DEBUG = 10,
-    INFO = 11,
-    WARN = 12,
-    ERROR = 13
-}
-/**
- * Defined in:
- *   {@link file://./../../../dxos/client/logging.proto}
- */
-export interface QueryLogsRequest {
-    filters?: QueryLogsRequest.Filter[];
-    /**
-     * Options:
-     *   - proto3_optional = true
-     */
-    options?: QueryLogsRequest.MatchingOptions;
-}
-export namespace QueryLogsRequest {
-    /**
-     * Defined in:
-     *   {@link file://./../../../dxos/client/logging.proto}
-     */
-    export enum MatchingOptions {
-        INCLUSIVE = 1,
-        EXPLICIT = 2
-    }
-    /**
-     * Defined in:
-     *   {@link file://./../../../dxos/client/logging.proto}
-     */
-    export interface Filter {
-        level: LogLevel;
-        /**
-         * Options:
-         *   - proto3_optional = true
-         */
-        pattern?: string;
-    }
-}
-/**
- * Defined in:
- *   {@link file://./../../../dxos/client/logging.proto}
- */
-export interface LogEntry {
-    level: LogLevel;
-    message: string;
-    /**
-     * Options:
-     *   - proto3_optional = true
-     */
-    context?: ReturnType<(typeof substitutions)["google.protobuf.Struct"]["decode"]>;
-    /**
-     * Options:
-     *   - proto3_optional = true
-     */
-    meta?: LogEntry.Meta;
-    /**
-     * Options:
-     *   - proto3_optional = true
-     */
-    error?: dxos_error.Error;
-    timestamp: ReturnType<(typeof substitutions)["google.protobuf.Timestamp"]["decode"]>;
-}
-export namespace LogEntry {
-    /**
-     * Defined in:
-     *   {@link file://./../../../dxos/client/logging.proto}
-     */
-    export interface Meta {
-        file: string;
-        line: number;
-        /**
-         * Options:
-         *   - proto3_optional = true
-         */
-        scope?: ReturnType<(typeof substitutions)["google.protobuf.Struct"]["decode"]>;
-        /**
-         * Options:
-         *   - proto3_optional = true
-         */
-        resourceId?: number;
-    }
-}
-/**
- * Defined in:
- *   {@link file://./../../../dxos/client/logging.proto}
- */
-export interface LoggingService {
-    controlMetrics: (request: ControlMetricsRequest, options?: RequestOptions) => Promise<ControlMetricsResponse>;
-    queryMetrics: (request: QueryMetricsRequest, options?: RequestOptions) => Stream<QueryMetricsResponse>;
-    queryLogs: (request: QueryLogsRequest, options?: RequestOptions) => Stream<LogEntry>;
-}
 /**
  * Defined in:
  *   {@link file://./../../../dxos/client/services.proto}
@@ -1142,3 +967,178 @@ export interface NetworkService {
     updateConfig: (request: UpdateConfigRequest, options?: RequestOptions) => Promise<void>;
     queryStatus: (request: void, options?: RequestOptions) => Stream<NetworkStatus>;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../dxos/client/logging.proto}
+ */
+export interface Metrics {
+    timestamp: ReturnType<(typeof substitutions)["google.protobuf.Timestamp"]["decode"]>;
+    values?: Metrics.KeyPair[];
+}
+export namespace Metrics {
+    /**
+     * Defined in:
+     *   {@link file://./../../../dxos/client/logging.proto}
+     */
+    export interface KeyPair {
+        /**
+         * Options:
+         *   - proto3_optional = true
+         */
+        key?: string;
+        /**
+         * Options:
+         *   - proto3_optional = true
+         */
+        value?: dxos_value.Value;
+        /**
+         * Options:
+         *   - proto3_optional = true
+         */
+        stats?: dxos_value.Stats;
+    }
+}
+/**
+ * Defined in:
+ *   {@link file://./../../../dxos/client/logging.proto}
+ */
+export interface ControlMetricsRequest {
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
+    reset?: boolean;
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
+    record?: boolean;
+}
+/**
+ * Defined in:
+ *   {@link file://./../../../dxos/client/logging.proto}
+ */
+export interface ControlMetricsResponse {
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
+    recording?: boolean;
+}
+/**
+ * Defined in:
+ *   {@link file://./../../../dxos/client/logging.proto}
+ */
+export interface QueryMetricsRequest {
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
+    interval?: number;
+}
+/**
+ * Defined in:
+ *   {@link file://./../../../dxos/client/logging.proto}
+ */
+export interface QueryMetricsResponse {
+    timestamp: ReturnType<(typeof substitutions)["google.protobuf.Timestamp"]["decode"]>;
+    metrics: Metrics;
+}
+/**
+ * Defined in:
+ *   {@link file://./../../../dxos/client/logging.proto}
+ */
+export enum LogLevel {
+    TRACE = 5,
+    DEBUG = 10,
+    INFO = 11,
+    WARN = 12,
+    ERROR = 13
+}
+/**
+ * Defined in:
+ *   {@link file://./../../../dxos/client/logging.proto}
+ */
+export interface QueryLogsRequest {
+    filters?: QueryLogsRequest.Filter[];
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
+    options?: QueryLogsRequest.MatchingOptions;
+}
+export namespace QueryLogsRequest {
+    /**
+     * Defined in:
+     *   {@link file://./../../../dxos/client/logging.proto}
+     */
+    export enum MatchingOptions {
+        INCLUSIVE = 1,
+        EXPLICIT = 2
+    }
+    /**
+     * Defined in:
+     *   {@link file://./../../../dxos/client/logging.proto}
+     */
+    export interface Filter {
+        level: LogLevel;
+        /**
+         * Options:
+         *   - proto3_optional = true
+         */
+        pattern?: string;
+    }
+}
+/**
+ * Defined in:
+ *   {@link file://./../../../dxos/client/logging.proto}
+ */
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
+    context?: ReturnType<(typeof substitutions)["google.protobuf.Struct"]["decode"]>;
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
+    meta?: LogEntry.Meta;
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
+    error?: dxos_error.Error;
+    timestamp: ReturnType<(typeof substitutions)["google.protobuf.Timestamp"]["decode"]>;
+}
+export namespace LogEntry {
+    /**
+     * Defined in:
+     *   {@link file://./../../../dxos/client/logging.proto}
+     */
+    export interface Meta {
+        file: string;
+        line: number;
+        /**
+         * Options:
+         *   - proto3_optional = true
+         */
+        scope?: ReturnType<(typeof substitutions)["google.protobuf.Struct"]["decode"]>;
+        /**
+         * Options:
+         *   - proto3_optional = true
+         */
+        resourceId?: number;
+    }
+}
+/**
+ * Defined in:
+ *   {@link file://./../../../dxos/client/logging.proto}
+ */
+export interface LoggingService {
+    controlMetrics: (request: ControlMetricsRequest, options?: RequestOptions) => Promise<ControlMetricsResponse>;
+    queryMetrics: (request: QueryMetricsRequest, options?: RequestOptions) => Stream<QueryMetricsResponse>;
+    queryLogs: (request: QueryLogsRequest, options?: RequestOptions) => Stream<LogEntry>;
+}

package/src/proto/gen/google/protobuf.ts

@@ -80,14 +80,14 @@ export enum NullValue {
 export interface ListValue {
     values?: Value[];
 }
-export interface Timestamp {
-    seconds: string;
-    nanos: number;
-}
 export interface Any {
     type_url: string;
     value: Uint8Array;
 }
+export interface Timestamp {
+    seconds: string;
+    nanos: number;
+}
 export interface FileDescriptorSet {
     file?: FileDescriptorProto[];
 }