@dxos/codec-protobuf 2.33.9-dev.e605934d → 2.33.9-dev.eb69ac10

package/dist/src/schema.js

@@ -0,0 +1,86 @@
+"use strict";
+//
+// Copyright 2021 DXOS.org
+//
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Schema = void 0;
+const lodash_merge_1 = __importDefault(require("lodash.merge"));
+const protobufjs_1 = __importStar(require("protobufjs"));
+const codec_1 = require("./codec");
+const mapping_1 = require("./mapping");
+const service_1 = require("./service");
+class Schema {
+    constructor(_typesRoot, substitutions) {
+        this._typesRoot = _typesRoot;
+        this._codecCache = {};
+        this._mapping = (0, mapping_1.createMappingDescriptors)(substitutions);
+    }
+    static fromJson(schema, substitutions = {}) {
+        const root = protobufjs_1.default.Root.fromJSON(schema);
+        return new Schema(root, substitutions);
+    }
+    getCodecForType(typeName) {
+        var _a;
+        var _b, _c;
+        if (typeof typeName !== 'string') {
+            throw new TypeError('Expected `typeName` argument to be a string');
+        }
+        const type = this._typesRoot.lookupType(typeName);
+        (_a = (_b = this._codecCache)[_c = type.fullName]) !== null && _a !== void 0 ? _a : (_b[_c] = new codec_1.ProtoCodec(type, this._mapping, this));
+        return this._codecCache[type.fullName];
+    }
+    tryGetCodecForType(typeName) {
+        var _a;
+        var _b, _c;
+        if (typeof typeName !== 'string') {
+            throw new TypeError('Expected `typeName` argument to be a string');
+        }
+        const type = this._typesRoot.lookupType(typeName);
+        (_a = (_b = this._codecCache)[_c = type.fullName]) !== null && _a !== void 0 ? _a : (_b[_c] = new codec_1.ProtoCodec(type, this._mapping, this));
+        return this._codecCache[type.fullName];
+    }
+    getService(name) {
+        if (typeof name !== 'string') {
+            throw new TypeError('Expected `name` argument to be a string');
+        }
+        const service = this._typesRoot.lookupService(name);
+        return new service_1.ServiceDescriptor(service, this);
+    }
+    /**
+     * Dynamically add new definitions to this schema.
+     */
+    addJson(schema) {
+        if (!schema.nested) {
+            throw new Error('Invalid schema: missing nested object');
+        }
+        this._typesRoot = protobufjs_1.Root.fromJSON((0, lodash_merge_1.default)(this._typesRoot.toJSON(), schema));
+    }
+}
+exports.Schema = Schema;
+//# sourceMappingURL=schema.js.map

package/dist/src/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEF,gEAAiC;AACjC,yDAA8C;AAE9C,mCAAqC;AAErC,uCAAqF;AACrF,uCAA8C;AAE9C,MAAa,MAAM;IAUjB,YACU,UAA2B,EACnC,aAA4B;QADpB,eAAU,GAAV,UAAU,CAAiB;QAHpB,gBAAW,GAA+B,EAAE,CAAA;QAM3D,IAAI,CAAC,QAAQ,GAAG,IAAA,kCAAwB,EAAC,aAAa,CAAC,CAAC;IAC1D,CAAC;IAdD,MAAM,CAAC,QAAQ,CAAqE,MAAW,EAAE,gBAA+B,EAAE;QAChI,MAAM,IAAI,GAAG,oBAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9C,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACzC,CAAC;IAaD,eAAe,CAA8B,QAAW;;;QACtD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE;YAChC,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;SACpE;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClD,YAAA,IAAI,CAAC,WAAW,OAAC,IAAI,CAAC,QAAQ,8CAAM,IAAI,kBAAU,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAC;QAC9E,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEzC,CAAC;IAED,kBAAkB,CAAE,QAAgB;;;QAClC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE;YAChC,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;SACpE;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClD,YAAA,IAAI,CAAC,WAAW,OAAC,IAAI,CAAC,QAAQ,8CAAM,IAAI,kBAAU,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAC;QAC9E,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,UAAU,CAA8B,IAAO;QAC7C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;YAC5B,MAAM,IAAI,SAAS,CAAC,yCAAyC,CAAC,CAAC;SAChE;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACpD,OAAO,IAAI,2BAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,OAAO,CAAE,MAAW;QAClB,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;YAClB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;SAC1D;QACD,IAAI,CAAC,UAAU,GAAG,iBAAI,CAAC,QAAQ,CAAC,IAAA,sBAAK,EAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3E,CAAC;CACF;AArDD,wBAqDC"}

package/dist/src/service.d.ts

@@ -2,8 +2,8 @@ import pb from 'protobufjs';
 import type { Schema } from './schema';
 import { Stream } from './stream';
 export interface Any {
-    'type_url'?: string;
-    value?: Uint8Array;
+    'type_url': string;
+    value: Uint8Array;
 }
 export interface ServiceBackend {
     call(method: string, request: Any): Promise<Any>;

package/dist/src/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,GAAG;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAClD,UAAU,CAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;CACxD;AAED,qBAAa,iBAAiB,CAAC,CAAC;IAE5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,QAAQ,EAAE,EAAE,CAAC,OAAO,EACpB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC;IAGvC,IAAI,YAAY,IAAK,EAAE,CAAC,OAAO,CAE9B;IAED,YAAY,CAAE,OAAO,EAAE,cAAc,GAAG,OAAO,GAAG,CAAC;IAInD,YAAY,CAAE,QAAQ,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC;CAG9C;AAED,qBAAa,OAAO;gBAEhB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,EAAE,CAAC,OAAO,EACnB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;CAyCtB;AAED,qBAAa,cAAc,CAAC,CAAC,GAAG,EAAE,CAAE,YAAW,cAAc;IAEzD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAFT,QAAQ,EAAE,EAAE,CAAC,OAAO,EACpB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EACpB,SAAS,EAAE,CAAC;IAGzB,IAAI,CAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAoB3D,UAAU,CAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IAqB1D,OAAO,CAAC,cAAc;CAavB"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,GAAG;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAClD,UAAU,CAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;CACxD;AAED,qBAAa,iBAAiB,CAAC,CAAC;IAE5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,QAAQ,EAAE,EAAE,CAAC,OAAO,EACpB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC;IAGvC,IAAI,YAAY,IAAK,EAAE,CAAC,OAAO,CAE9B;IAED,YAAY,CAAE,OAAO,EAAE,cAAc,GAAG,OAAO,GAAG,CAAC;IAInD,YAAY,CAAE,QAAQ,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC;CAG9C;AAED,qBAAa,OAAO;gBAEhB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,EAAE,CAAC,OAAO,EACnB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;CAqCtB;AAED,qBAAa,cAAc,CAAC,CAAC,GAAG,EAAE,CAAE,YAAW,cAAc;IAEzD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAFT,QAAQ,EAAE,EAAE,CAAC,OAAO,EACpB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EACpB,SAAS,EAAE,CAAC;IAGzB,IAAI,CAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAoB3D,UAAU,CAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IAkB1D,OAAO,CAAC,cAAc;CAavB"}

package/dist/src/service.js

@@ -0,0 +1,113 @@
+"use strict";
+//
+// Copyright 2021 DXOS.org
+//
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceHandler = exports.Service = exports.ServiceDescriptor = void 0;
+const node_assert_1 = __importDefault(require("node:assert"));
+const stream_1 = require("./stream");
+class ServiceDescriptor {
+    constructor(_service, _schema) {
+        this._service = _service;
+        this._schema = _schema;
+    }
+    get serviceProto() {
+        return this._service;
+    }
+    createClient(backend) {
+        return new Service(backend, this._service, this._schema);
+    }
+    createServer(handlers) {
+        return new ServiceHandler(this._service, this._schema, handlers);
+    }
+}
+exports.ServiceDescriptor = ServiceDescriptor;
+class Service {
+    constructor(backend, service, schema) {
+        for (const method of service.methodsArray) {
+            method.resolve();
+            (0, node_assert_1.default)(method.resolvedRequestType);
+            (0, node_assert_1.default)(method.resolvedResponseType);
+            (0, node_assert_1.default)(!method.requestStream, 'Streaming RPC requests are not supported.');
+            // TODO(marik-d): What about primitive types.
+            const requestCodec = schema.tryGetCodecForType(method.resolvedRequestType.fullName);
+            const responseCodec = schema.tryGetCodecForType(method.resolvedResponseType.fullName);
+            const methodName = mapRpcMethodName(method.name);
+            if (!method.responseStream) {
+                this[methodName] = async (request) => {
+                    const encoded = requestCodec.encode(request);
+                    const response = await backend.call(method.name, {
+                        value: encoded,
+                        type_url: method.resolvedRequestType.fullName
+                    });
+                    return responseCodec.decode(response.value);
+                };
+            }
+            else {
+                this[methodName] = (request) => {
+                    const encoded = requestCodec.encode(request);
+                    const stream = backend.callStream(method.name, {
+                        value: encoded,
+                        type_url: method.resolvedRequestType.fullName
+                    });
+                    return stream_1.Stream.map(stream, data => responseCodec.decode(data.value));
+                };
+            }
+            // Set function name so that is properly named in stack traces.
+            Object.defineProperty(this[methodName], 'name', { value: methodName });
+        }
+    }
+}
+exports.Service = Service;
+class ServiceHandler {
+    constructor(_service, _schema, _handlers) {
+        this._service = _service;
+        this._schema = _schema;
+        this._handlers = _handlers;
+    }
+    async call(methodName, request) {
+        const { method, requestCodec, responseCodec } = this._getMethodInfo(methodName);
+        (0, node_assert_1.default)(!method.requestStream, 'Invalid RPC method call: request streaming mismatch.');
+        (0, node_assert_1.default)(!method.responseStream, `Invalid RPC method call: response streaming mismatch. ${methodName}`);
+        const mappedMethodName = mapRpcMethodName(methodName);
+        const handler = this._handlers[mappedMethodName];
+        (0, node_assert_1.default)(handler, `Handler is missing: ${mappedMethodName}`);
+        const requestDecoded = requestCodec.decode(request.value);
+        const response = await handler.bind(this._handlers)(requestDecoded);
+        const responseEncoded = responseCodec.encode(response);
+        return {
+            value: responseEncoded,
+            type_url: method.resolvedResponseType.fullName
+        };
+    }
+    callStream(methodName, request) {
+        const { method, requestCodec, responseCodec } = this._getMethodInfo(methodName);
+        (0, node_assert_1.default)(!method.requestStream, 'Invalid RPC method call: request streaming mismatch.');
+        (0, node_assert_1.default)(method.responseStream, `Invalid RPC method call: response streaming mismatch., ${methodName}`);
+        const mappedMethodName = mapRpcMethodName(methodName);
+        const handler = this._handlers[mappedMethodName];
+        (0, node_assert_1.default)(handler, `Handler is missing: ${mappedMethodName}`);
+        const requestDecoded = requestCodec.decode(request.value);
+        const responseStream = handler.bind(this._handlers)(requestDecoded);
+        return stream_1.Stream.map(responseStream, (data) => ({
+            value: responseCodec.encode(data),
+            type_url: method.resolvedResponseType.fullName
+        }));
+    }
+    _getMethodInfo(methodName) {
+        const method = this._service.methods[methodName];
+        (0, node_assert_1.default)(!!method, `Method not found: ${methodName}`);
+        method.resolve();
+        (0, node_assert_1.default)(method.resolvedRequestType);
+        (0, node_assert_1.default)(method.resolvedResponseType);
+        const requestCodec = this._schema.tryGetCodecForType(method.resolvedRequestType.fullName);
+        const responseCodec = this._schema.tryGetCodecForType(method.resolvedResponseType.fullName);
+        return { method, requestCodec, responseCodec };
+    }
+}
+exports.ServiceHandler = ServiceHandler;
+const mapRpcMethodName = (name) => name[0].toLocaleLowerCase() + name.substring(1);
+//# sourceMappingURL=service.js.map

package/dist/src/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;;;;;;AAEF,8DAAiC;AAIjC,qCAAkC;AAYlC,MAAa,iBAAiB;IAC5B,YACmB,QAAoB,EACpB,OAAoB;QADpB,aAAQ,GAAR,QAAQ,CAAY;QACpB,YAAO,GAAP,OAAO,CAAa;IACpC,CAAC;IAEJ,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,YAAY,CAAE,OAAuB;QACnC,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAgB,CAAC;IAC1E,CAAC;IAED,YAAY,CAAE,QAAW;QACvB,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnE,CAAC;CACF;AAjBD,8CAiBC;AAED,MAAa,OAAO;IAClB,YACE,OAAuB,EACvB,OAAmB,EACnB,MAAmB;QAEnB,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE;YACzC,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,IAAA,qBAAM,EAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;YACnC,IAAA,qBAAM,EAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;YACpC,IAAA,qBAAM,EAAC,CAAC,MAAM,CAAC,aAAa,EAAE,2CAA2C,CAAC,CAAC;YAE3E,6CAA6C;YAC7C,MAAM,YAAY,GAAG,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YACpF,MAAM,aAAa,GAAG,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;YACtF,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAEjD,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE;gBACzB,IAAY,CAAC,UAAU,CAAC,GAAG,KAAK,EAAE,OAAgB,EAAE,EAAE;oBACrD,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;oBAC7C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;wBAC/C,KAAK,EAAE,OAAO;wBACd,QAAQ,EAAE,MAAM,CAAC,mBAAoB,CAAC,QAAQ;qBAC/C,CAAC,CAAC;oBACH,OAAO,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAM,CAAC,CAAC;gBAC/C,CAAC,CAAC;aACH;iBAAM;gBACJ,IAAY,CAAC,UAAU,CAAC,GAAG,CAAC,OAAgB,EAAE,EAAE;oBAC/C,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;oBAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE;wBAC7C,KAAK,EAAE,OAAO;wBACd,QAAQ,EAAE,MAAM,CAAC,mBAAoB,CAAC,QAAQ;qBAC/C,CAAC,CAAC;oBACH,OAAO,eAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,KAAM,CAAC,CAAC,CAAC;gBACvE,CAAC,CAAC;aACH;YAED,+DAA+D;YAC/D,MAAM,CAAC,cAAc,CAAE,IAAY,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;SACjF;IACH,CAAC;CACF;AAzCD,0BAyCC;AAED,MAAa,cAAc;IACzB,YACmB,QAAoB,EACpB,OAAoB,EACpB,SAAY;QAFZ,aAAQ,GAAR,QAAQ,CAAY;QACpB,YAAO,GAAP,OAAO,CAAa;QACpB,cAAS,GAAT,SAAS,CAAG;IAC5B,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAE,UAAkB,EAAE,OAAY;QAC1C,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAChF,IAAA,qBAAM,EAAC,CAAC,MAAM,CAAC,aAAa,EAAE,sDAAsD,CAAC,CAAC;QACtF,IAAA,qBAAM,EAAC,CAAC,MAAM,CAAC,cAAc,EAAE,yDAAyD,UAAU,EAAE,CAAC,CAAC;QAEtG,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAEtD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,gBAA2B,CAAC,CAAC;QAC5D,IAAA,qBAAM,EAAC,OAAO,EAAE,uBAAuB,gBAAgB,EAAE,CAAC,CAAC;QAE3D,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,KAAM,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,MAAO,OAAe,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,cAAc,CAAC,CAAC;QAC7E,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEvD,OAAO;YACL,KAAK,EAAE,eAAe;YACtB,QAAQ,EAAE,MAAM,CAAC,oBAAqB,CAAC,QAAQ;SAChD,CAAC;IACJ,CAAC;IAED,UAAU,CAAE,UAAkB,EAAE,OAAY;QAC1C,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAChF,IAAA,qBAAM,EAAC,CAAC,MAAM,CAAC,aAAa,EAAE,sDAAsD,CAAC,CAAC;QACtF,IAAA,qBAAM,EAAC,MAAM,CAAC,cAAc,EAAE,0DAA0D,UAAU,EAAE,CAAC,CAAC;QAEtG,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAEtD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,gBAA2B,CAAC,CAAC;QAC5D,IAAA,qBAAM,EAAC,OAAO,EAAE,uBAAuB,gBAAgB,EAAE,CAAC,CAAC;QAE3D,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,KAAM,CAAC,CAAC;QAC3D,MAAM,cAAc,GAAI,OAAe,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,cAAc,CAAoB,CAAC;QAChG,OAAO,eAAM,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,IAAI,EAAO,EAAE,CAAC,CAAC;YAChD,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC;YACjC,QAAQ,EAAE,MAAM,CAAC,oBAAqB,CAAC,QAAQ;SAChD,CAAC,CAAC,CAAC;IACN,CAAC;IAEO,cAAc,CAAE,UAAkB;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACjD,IAAA,qBAAM,EAAC,CAAC,CAAC,MAAM,EAAE,qBAAqB,UAAU,EAAE,CAAC,CAAC;QAEpD,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,IAAA,qBAAM,EAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACnC,IAAA,qBAAM,EAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAEpC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC1F,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAE5F,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;IACjD,CAAC;CACF;AA1DD,wCA0DC;AAED,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC"}

package/dist/src/stream.d.ts

@@ -1,8 +1,22 @@
 declare type Producer<T> = (callbacks: {
+    /**
+     * Advises that the producer is ready to stream the data.
+     * Called automatically with the first call to `next`.
+     */
+    ready: () => void;
+    /**
+     * Sends a message into the stream.
+     */
     next: (message: T) => void;
+    /**
+     * Closes the stream.
+     * Optional error can be provided.
+     */
     close: (error?: Error) => void;
 }) => (() => void) | void;
 export declare type StreamItem<T> = {
+    ready: true;
+} | {
     data: T;
 } | {
     closed: true;
@@ -20,17 +34,34 @@ export declare class Stream<T> {
      * Consumes the entire stream to the end until it closes and returns a promise with the resulting items.
      */
     static consume<T>(stream: Stream<T>): Promise<StreamItem<T>[]>;
+    /**
+     * Maps all data coming through the stream.
+     */
+    static map<T, U>(source: Stream<T>, map: (data: T) => U): Stream<U>;
     private _messageHandler?;
     private _closeHandler?;
+    private _readyHandler?;
     private _isClosed;
     private _closeError;
     private _dispose;
+    private _readyPromise;
+    private _resolveReadyPromise;
+    private _isReady;
     /**
      * Buffer messages before subscription. Set to null when buffer is no longer needed.
      */
     private _buffer;
     constructor(producer: Producer<T>);
+    private _markAsReady;
     subscribe(onMessage: (msg: T) => void, onClose?: (error?: Error) => void): void;
+    /**
+     * Resolves when stream is ready.
+     */
+    waitUntilReady(): Promise<void>;
+    /**
+     * Registers a callback to be called when stream is ready.
+     */
+    onReady(onReady: () => void): void;
     /**
      * Close the stream and dispose of any resources.
      */

package/dist/src/stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/stream.ts"],"names":[],"mappings":"AASA,aAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE;IAC7B,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAA;IAC1B,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAA;CAC/B,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAA;AAEzB,oBAAY,UAAU,CAAC,CAAC,IACpB;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,GACX;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAA;AAEnC;;;;;;GAMG;AACH,qBAAa,MAAM,CAAC,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAE,CAAC,EAAG,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAoBhE,OAAO,CAAC,eAAe,CAAC,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAC,CAA0B;IAEhD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAA2B;IAE3C;;OAEG;IACH,OAAO,CAAC,OAAO,CAAkB;gBAEpB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IA2ClC,SAAS,CAAE,SAAS,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI;IA0BzE;;OAEG;IACH,KAAK;CAcN"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/stream.ts"],"names":[],"mappings":"AASA,aAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE;IAC7B;;;OAGG;IACH,KAAK,EAAE,MAAM,IAAI,CAAA;IAEjB;;OAEG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAA;IAE1B;;;OAGG;IACH,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAA;CAC/B,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAA;AAEzB,oBAAY,UAAU,CAAC,CAAC,IACpB;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,GACX;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAA;AAEnC;;;;;;GAMG;AACH,qBAAa,MAAM,CAAC,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAE,CAAC,EAAG,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAuBhE;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAG,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IASpE,OAAO,CAAC,eAAe,CAAC,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAC,CAA0B;IAChD,OAAO,CAAC,aAAa,CAAC,CAAa;IAEnC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,oBAAoB,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAS;IAEzB;;OAEG;IACH,OAAO,CAAC,OAAO,CAAkB;gBAEpB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAqDlC,OAAO,CAAC,YAAY;IAQpB,SAAS,CAAE,SAAS,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI;IA0BzE;;OAEG;IACH,cAAc,IAAK,OAAO,CAAC,IAAI,CAAC;IAIhC;;OAEG;IACH,OAAO,CAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IASnC;;OAEG;IACH,KAAK;CAcN"}

package/dist/src/stream.js

@@ -0,0 +1,186 @@
+"use strict";
+//
+// Copyright 2021 DXOS.org
+//
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Stream = void 0;
+const debug_1 = __importDefault(require("debug"));
+const node_assert_1 = __importDefault(require("node:assert"));
+const log = (0, debug_1.default)('dxos:codec-protobuf:stream');
+/**
+ * Represents a typed stream of data.
+ *
+ * Can only have one subscriber.
+ *
+ * `close` must be called to clean-up the resources.
+ */
+class Stream {
+    constructor(producer) {
+        this._isClosed = false;
+        this._isReady = false;
+        /**
+         * Buffer messages before subscription. Set to null when buffer is no longer needed.
+         */
+        this._buffer = [];
+        this._readyPromise = new Promise(resolve => {
+            this._resolveReadyPromise = resolve;
+        });
+        const disposeCallback = producer({
+            ready: () => {
+                this._markAsReady();
+            },
+            next: msg => {
+                if (this._isClosed) {
+                    log('Stream is closed, dropping message.');
+                    return;
+                }
+                this._markAsReady();
+                if (this._messageHandler) {
+                    try {
+                        this._messageHandler(msg);
+                    }
+                    catch (error) {
+                        // Stop error propagation.
+                        throwUnhandledRejection(error);
+                    }
+                }
+                else {
+                    (0, node_assert_1.default)(this._buffer);
+                    this._buffer.push(msg);
+                }
+            },
+            close: err => {
+                var _a, _b;
+                if (this._isClosed) {
+                    return;
+                }
+                this._isClosed = true;
+                this._closeError = err;
+                (_a = this._dispose) === null || _a === void 0 ? void 0 : _a.call(this);
+                try {
+                    (_b = this._closeHandler) === null || _b === void 0 ? void 0 : _b.call(this, err);
+                }
+                catch (error) {
+                    // Stop error propagation.
+                    throwUnhandledRejection(error);
+                }
+            }
+        });
+        if (disposeCallback) {
+            this._dispose = disposeCallback;
+        }
+    }
+    /**
+     * Consumes the entire stream to the end until it closes and returns a promise with the resulting items.
+     */
+    static consume(stream) {
+        return new Promise(resolve => {
+            const items = [];
+            stream.onReady(() => {
+                items.push({ ready: true });
+            });
+            stream.subscribe(data => {
+                items.push({ data });
+            }, error => {
+                if (error) {
+                    items.push({ closed: true, error });
+                }
+                else {
+                    items.push({ closed: true });
+                }
+                resolve(items);
+            });
+        });
+    }
+    /**
+     * Maps all data coming through the stream.
+     */
+    static map(source, map) {
+        return new Stream(({ ready, next, close }) => {
+            source.onReady(ready);
+            source.subscribe(data => next(map(data)), close);
+            return () => source.close();
+        });
+    }
+    _markAsReady() {
+        var _a;
+        if (!this._isReady) {
+            this._isReady = true;
+            (_a = this._readyHandler) === null || _a === void 0 ? void 0 : _a.call(this);
+            this._resolveReadyPromise();
+        }
+    }
+    subscribe(onMessage, onClose) {
+        (0, node_assert_1.default)(!this._messageHandler, 'Stream is already subscribed to.');
+        (0, node_assert_1.default)(!this._closeHandler, 'Stream is already subscribed to.');
+        (0, node_assert_1.default)(this._buffer); // Must be not-null.
+        for (const message of this._buffer) {
+            try {
+                onMessage(message);
+            }
+            catch (error) {
+                // Stop error propagation.
+                throwUnhandledRejection(error);
+            }
+        }
+        this._buffer = null;
+        // Stream might have allready been closed.
+        if (this._isClosed) {
+            onClose === null || onClose === void 0 ? void 0 : onClose(this._closeError);
+            return;
+        }
+        this._messageHandler = onMessage;
+        this._closeHandler = onClose;
+    }
+    /**
+     * Resolves when stream is ready.
+     */
+    waitUntilReady() {
+        return this._readyPromise;
+    }
+    /**
+     * Registers a callback to be called when stream is ready.
+     */
+    onReady(onReady) {
+        (0, node_assert_1.default)(!this._readyHandler, 'Stream already has a handler for the ready event.');
+        this._readyHandler = onReady;
+        if (this._isReady) {
+            onReady();
+        }
+    }
+    /**
+     * Close the stream and dispose of any resources.
+     */
+    close() {
+        var _a, _b;
+        if (this._isClosed) {
+            return;
+        }
+        this._isClosed = true;
+        (_a = this._dispose) === null || _a === void 0 ? void 0 : _a.call(this);
+        (_b = this._closeHandler) === null || _b === void 0 ? void 0 : _b.call(this, undefined);
+        // Clear function pointers.
+        this._messageHandler = undefined;
+        this._closeHandler = undefined;
+        this._dispose = undefined;
+    }
+}
+exports.Stream = Stream;
+/**
+ * Asynchronously produces an unhandled rejection.
+ *
+ * Will terminate the node process with an error.
+ * In browser results in an error message in the console.
+ * In mocha tests it fails the currently running test.
+ *
+ * NOTE: Copied from @dxos/debug to avoid circular dependency.
+ */
+const throwUnhandledRejection = (error) => {
+    setTimeout(() => {
+        throw error;
+    });
+};
+//# sourceMappingURL=stream.js.map

package/dist/src/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/stream.ts"],"names":[],"mappings":"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"}

package/dist/src/stream.test.js

@@ -0,0 +1,66 @@
+"use strict";
+//
+// Copyright 2021 DXOS.org
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+const stream_1 = require("./stream");
+describe('Stream', () => {
+    test.only('can consume a stream that immediately closes', async () => {
+        const stream = new stream_1.Stream(({ next, close }) => {
+            next('foo');
+            next('bar');
+            next('baz');
+            close();
+        });
+        expect(await stream_1.Stream.consume(stream)).toEqual([
+            { ready: true },
+            { data: 'foo' },
+            { data: 'bar' },
+            { data: 'baz' },
+            { closed: true }
+        ]);
+    });
+    test('can consume a stream that produces items over time', async () => {
+        const stream = new stream_1.Stream(({ next, close }) => {
+            setImmediate(async () => {
+                await sleep(5);
+                next('foo');
+                await sleep(5);
+                next('bar');
+                await sleep(5);
+                next('baz');
+                await sleep(5);
+                close();
+            });
+        });
+        expect(await stream_1.Stream.consume(stream)).toEqual([
+            { ready: true },
+            { data: 'foo' },
+            { data: 'bar' },
+            { data: 'baz' },
+            { closed: true }
+        ]);
+    });
+    test('close error is buffered', async () => {
+        const stream = new stream_1.Stream(({ close }) => {
+            close(new Error('test'));
+        });
+        expect(await stream_1.Stream.consume(stream)).toEqual([
+            { closed: true, error: new Error('test') }
+        ]);
+    });
+    test('subscribe gets all updates', async () => {
+        let nextCb = () => { };
+        const stream = new stream_1.Stream(({ next }) => {
+            nextCb = next;
+        });
+        nextCb('first');
+        const received = [];
+        stream.subscribe(msg => received.push(msg), () => { });
+        nextCb('second');
+        expect(received).toEqual(['first', 'second']);
+    });
+});
+// To not introduce a dependency on @dxos/async.
+const sleep = (ms) => new Promise(resolve => setTimeout(resolve, ms));
+//# sourceMappingURL=stream.test.js.map

package/dist/src/stream.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.test.js","sourceRoot":"","sources":["../../src/stream.test.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;;AAEF,qCAAkC;AAElC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,IAAI,CAAC,IAAI,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;YAC5C,IAAI,CAAC,KAAK,CAAC,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,CAAC;YACZ,KAAK,EAAE,CAAC;QACV,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,eAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC3C,EAAE,KAAK,EAAE,IAAI,EAAE;YACf,EAAE,IAAI,EAAE,KAAK,EAAE;YACf,EAAE,IAAI,EAAE,KAAK,EAAE;YACf,EAAE,IAAI,EAAE,KAAK,EAAE;YACf,EAAE,MAAM,EAAE,IAAI,EAAE;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;YAC5C,YAAY,CAAC,KAAK,IAAI,EAAE;gBACtB,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC;gBACf,IAAI,CAAC,KAAK,CAAC,CAAC;gBACZ,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC;gBACf,IAAI,CAAC,KAAK,CAAC,CAAC;gBACZ,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC;gBACf,IAAI,CAAC,KAAK,CAAC,CAAC;gBACZ,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC;gBACf,KAAK,EAAE,CAAC;YACV,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,eAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC3C,EAAE,KAAK,EAAE,IAAI,EAAE;YACf,EAAE,IAAI,EAAE,KAAK,EAAE;YACf,EAAE,IAAI,EAAE,KAAK,EAAE;YACf,EAAE,IAAI,EAAE,KAAK,EAAE;YACf,EAAE,MAAM,EAAE,IAAI,EAAE;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;YACtC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,eAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC3C,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE;SAC3C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QAC5C,IAAI,MAAM,GAA4B,GAAG,EAAE,GAAE,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,eAAM,CAAS,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;YAC7C,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,CAAC;QAChB,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjB,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,gDAAgD;AAChD,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC"}

package/dist/src/substitutions/any.js

@@ -0,0 +1,30 @@
+"use strict";
+//
+// Copyright 2021 DXOS.org
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.anySubstitutions = void 0;
+exports.anySubstitutions = {
+    'google.protobuf.Any': {
+        encode: (value, schema) => {
+            if (typeof value['@type'] !== 'string') {
+                throw new Error('Cannot encode google.protobuf.Any without @type string field');
+            }
+            const codec = schema.tryGetCodecForType(value['@type']);
+            const data = codec.encode(value);
+            return {
+                type_url: value['@type'],
+                value: data
+            };
+        },
+        decode: (value, schema) => {
+            const codec = schema.tryGetCodecForType(value.type_url);
+            const data = codec.decode(value.value);
+            return {
+                ...data,
+                '@type': value.type_url
+            };
+        }
+    }
+};
+//# sourceMappingURL=any.js.map

package/dist/src/substitutions/any.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"any.js","sourceRoot":"","sources":["../../../src/substitutions/any.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;;;AAOW,QAAA,gBAAgB,GAAG;IAC9B,qBAAqB,EAAE;QACrB,MAAM,EAAE,CAAC,KAAsB,EAAE,MAAmB,EAAO,EAAE;YAC3D,IAAI,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,QAAQ,EAAE;gBACtC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;aACjF;YAED,MAAM,KAAK,GAAG,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjC,OAAO;gBACL,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC;gBACxB,KAAK,EAAE,IAAI;aACZ,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,CAAC,KAAU,EAAE,MAAmB,EAAoB,EAAE;YAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACvC,OAAO;gBACL,GAAG,IAAI;gBACP,OAAO,EAAE,KAAK,CAAC,QAAQ;aACxB,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}

package/dist/src/substitutions/index.js

@@ -0,0 +1,22 @@
+"use strict";
+//
+// Copyright 2022 DXOS.org
+//
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./any"), exports);
+__exportStar(require("./timestamp"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/substitutions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/substitutions/index.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;;;;;;;;;;;;;;;;AAEF,wCAAsB;AACtB,8CAA4B"}

package/dist/src/substitutions/timestamp.js

@@ -0,0 +1,19 @@
+"use strict";
+//
+// Copyright 2022 DXOS.org
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.timestampSubstitutions = void 0;
+exports.timestampSubstitutions = {
+    'google.protobuf.Timestamp': {
+        encode: (value) => {
+            const unixMilliseconds = value.getTime();
+            return {
+                seconds: Math.floor(unixMilliseconds / 1000).toString(),
+                nanos: (unixMilliseconds % 1000) * 1e6
+            };
+        },
+        decode: (value) => { var _a, _b; return new Date(parseInt((_a = value.seconds) !== null && _a !== void 0 ? _a : '0') * 1000 + ((_b = value.nanos) !== null && _b !== void 0 ? _b : 0) / 1e6); }
+    }
+};
+//# sourceMappingURL=timestamp.js.map

package/dist/src/substitutions/timestamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp.js","sourceRoot":"","sources":["../../../src/substitutions/timestamp.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;;;AAEW,QAAA,sBAAsB,GAAG;IACpC,2BAA2B,EAAE;QAC3B,MAAM,EAAE,CAAC,KAAW,EAAO,EAAE;YAC3B,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,QAAQ,EAAE;gBACvD,KAAK,EAAE,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,GAAG;aACvC,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,CAAC,KAAU,EAAQ,EAAE,eAAC,OAAA,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAA,KAAK,CAAC,OAAO,mCAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAA,KAAK,CAAC,KAAK,mCAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAA,EAAA;KACzG;CACF,CAAC"}