protobufjs 4.1.1 → 5.0.1

package/externs/{ProtoBuf.js → protobuf.js}

@@ -1,922 +1,933 @@
-/*
- * Copyright 2012 The Closure Compiler Authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-/**
- * @fileoverview Externs for ProtoBuf.js.
- * @see https://github.com/dcodeIO/ProtoBuf.js
- * @externs
- */
-
-/**
- BEGIN_NODE_INCLUDE
- var ProtoBuf = require('protobufjs');
- END_NODE_INCLUDE
- */
-
-/**
- * {@type object.<string.*>}
- */
-var ProtoBuf = {};
-
-/**
- * @type {string}
- * @const
- */
-ProtoBuf.VERSION;
-
-/**
- * @type {!object.<string,number>}
- * @const
- */
-ProtoBuf.WIRE_TYPES = {};
-
-/**
- * @type {number}
- * @const
- */
-ProtoBuf.WIRE_TYPES.VARINT;
-
-/**
- * @type {number}
- * @const
- */
-ProtoBuf.WIRE_TYPES.BITS64;
-
-/**
- * @type {number}
- * @const
- */
-ProtoBuf.WIRE_TYPES.LDELIM;
-
-/**
- * @type {number}
- * @const
- */
-ProtoBuf.WIRE_TYPES.STARTGROUP;
-
-/**
- * @type {number}
- * @const
- */
-ProtoBuf.WIRE_TYPES.ENDGROUP;
-
-/**
- * @type {number}
- * @const
- */
-ProtoBuf.WIRE_TYPES.BITS32;
-
-/**
- * @type {!Array.<number>}
- * @const
- */
-ProtoBuf.PACKABLE_WIRE_TYPES;
-
-/**
- * @type {boolean}
- */
-ProtoBuf.convertFieldsToCamelCase;
-
-/**
- * @type {boolean}
- */
-ProtoBuf.populateAccessors;
-
-/**
- * @dict
- * @type {!object.<string,{name: string, wireType: number}>}
- * @const
- */
-ProtoBuf.TYPES;
-
-/**
- * @type {number}
- */
-ProtoBuf.ID_MIN;
-
-/**
- * @type {number}
- */
-ProtoBuf.ID_MAX;
-
-/**
- * @type {!function(new: ByteBuffer, ...[*])}
- */
-ProtoBuf.ByteBuffer;
-
-/**
- * @type {?function(new: Long, ...[*])}
- */
-ProtoBuf.Long;
-
-/**
- * @type {!object.<string,string|RegExp>}
- */
-ProtoBuf.Lang;
-
-/**
- * @type {!object.<string,function>}
- */
-ProtoBuf.DotProto;
-
-/**
- * @param {string} proto
- * @constructor
- */
-ProtoBuf.DotProto.Tokenizer = function(proto) {};
-
-/**
- * @type {string}
- */
-ProtoBuf.DotProto.Tokenizer.prototype.source;
-
-/**
- * @type {number}
- */
-ProtoBuf.DotProto.Tokenizer.prototype.index;
-
-/**
- * @type {number}
- */
-ProtoBuf.DotProto.Tokenizer.prototype.line;
-
-/**
- * @type {array.<string>}
- */
-ProtoBuf.DotProto.Tokenizer.prototype.stack;
-
-/**
- * @type {boolean}
- */
-ProtoBuf.DotProto.Tokenizer.prototype.readingString;
-
-/**
- * @return {?string}
- * @throws {Error}
- */
-ProtoBuf.DotProto.Tokenizer.prototype.next = function() {};
-
-/**
- * @return {?string}
- * @thorws {Error}
- */
-ProtoBuf.DotProto.Tokenizer.prototype.peek = function() {};
-
-/**
- * @return {string}
- * @nosideeffects
- */
-ProtoBuf.DotProto.Tokenizer.prototype.toString = function() {};
-
-/**
- * @param {string} proto
- * @constructor
- */
-ProtoBuf.DotProto.Parser = function(proto) {};
-
-/**
- * @type {!ProtoBuf.DotProto.Tokenizer}
- */
-ProtoBuf.DotProto.Parser.prototype.tn;
-
-/**
- * @return {{package: string|null, messages: Array.<object>, enums: Array.<object>, imports: Array.<string>, options: object<string,*>}}
- * @throws {Error}
- */
-ProtoBuf.DotProto.Parser.prototype.parse = function() {};
-
-/**
- * @return {string}
- * @nosideeffects
- */
-ProtoBuf.DotProto.Parser.prototype.toString = function() {};
-
-/**
- * @type {Object.<string,function>}
- */
-ProtoBuf.Reflect.Reflect = {};
-
-/**
- * @constructor
- * @param {ProtoBuf.Reflect.T} parent
- * @param {string} name Object name
- */
-ProtoBuf.Reflect.T = function(parent, name) {};
-
-/**
- * @type {?ProtoBuf.Reflect.T}
- */
-ProtoBuf.Reflect.T.prototype.parent;
-
-/**
- * @type {string}
- */
-ProtoBuf.Reflect.T.prototype.name;
-
-/**
- * @returns {string}
- * @nosideeffects
- */
-ProtoBuf.Reflect.T.prototype.fqn = function() {};
-
-/**
- * @param {boolean=} includeClass
- * @returns {string}
- * @nosideeffects
- */
-ProtoBuf.Reflect.T.prototype.toString = function(includeClass) {};
-
-/**
- * @throws {Error}
- */
-ProtoBuf.Reflect.T.prototype.build = function() {};
-
-/**
- * @param {?ProtoBuf.Reflect.Namespace} parent
- * @param {string} name
- * @constructor
- * @extends ProtoBuf.Reflect.T
- */
-ProtoBuf.Reflect.Namespace = function(parent, name) {};
-
-/**
- * @type {Array.<ProtoBuf.Reflect.T>}
- */
-ProtoBuf.Reflect.Namespace.prototype.children;
-
-/**
- * @param {ProtoBuf.Reflect.T=} type
- * @return {Array.<ProtoBuf.Reflect.T>}
- * @nosideeffects
- */
-ProtoBuf.Reflect.Namespace.prototype.getChildren = function(type) {};
-
-/**
- * @param {ProtoBuf.Reflect.T} child
- * @throws {Error}
- */
-ProtoBuf.Reflect.Namespace.prototype.addChild = function(child) {};
-
-/**
- * @param {string|number} nameOrId
- * @returns {boolean}
- * @nosideeffects
- */
-ProtoBuf.Reflect.Namespace.prototype.hasChild = function(nameOrId) {};
-
-/**
- * @param {string|number} nameOrId
- * @return {?ProtoBuf.Reflect.T}
- * @nosideeffects
- */
-ProtoBuf.Reflect.Namespace.prototype.getChild = function(nameOrId) {};
-
-/**
- * @param {string} qn
- * @param {boolean=} excludeFields
- * @return {?ProtoBuf.Reflect.Namespace}
- * @nosideeffects
- */
-ProtoBuf.Reflect.Namespace.prototype.resolve = function(qn, excludeFields) {};
-
-/**
- * @return {Object.<string,Function|Object>}
- */
-ProtoBuf.Reflect.Namespace.prototype.build = function() {};
-
-/**
- * @param {!ProtoBuf.Reflect.Namespace} parent
- * @param {string} name
- * @constructor
- * @extends ProtoBuf.Reflect.Namespace
- */
-ProtoBuf.Reflect.Message = function(parent, name) {};
-
-/**
- * @type {?Array.<number>}
- */
-ProtoBuf.Reflect.Message.prototype.extensions;
-
-/**
- * @type {?ProtoBuf.Builder.Message}
- */
-ProtoBuf.Reflect.Message.prototype.clazz;
-
-/**
- * @return {!ProtoBuf.Builder.Message}
- * @throws {Error}
- */
-ProtoBuf.Reflect.Message.prototype.build = function() {};
-
-/**
- * @param {!ProtoBuf.Builder.Message} message
- * @param {!ByteBuffer} buffer
- * @return {!ByteBuffer}
- * @throws {Error}
- */
-ProtoBuf.Reflect.Message.prototype.encode = function(message, buffer) {};
-
-/**
- * @param {!ProtoBuf.Builder.Message} message
- * @return {number}
- * @throws {Error}
- */
-ProtoBuf.Reflect.Message.prototype.calculate = function(message) {};
-
-/**
- * @param {!ProtoBuf.Builder.Message} message
- * @param {!ByteBuffer} buffer
- * @return {!ByteBuffer}
- * @throws {Error}
- */
-ProtoBuf.Reflect.Message.prototype.encodeDelimited = function(message, buffer) {};
-
-/**
- * @param {!ByteBuffer} buffer
- * @param {number=} length
- * @return {!ProtoBuf.Builder.Message}
- * @throws {Error}
- */
-ProtoBuf.Reflect.Message.prototype.decode = function(buffer, length) {};
-
-/**
- * @param {!ByteBuffer} buffer
- * @param {number=} length
- * @return {!ProtoBuf.Builder.Message}
- * @throws {Error}
- */
-ProtoBuf.Reflect.Message.prototype.decodeDelimited = function(buffer, length) {};
-
-/**
- * @param {!ProtoBuf.Reflect.Message} message
- * @param {string} rule
- * @param {string} type
- * @param {string} name
- * @param {number} id
- * @param {Object.<string.*>=} options
- * @constructor
- * @extends ProtoBuf.Reflect.T
- */
-ProtoBuf.Reflect.Message.Field = function(message, rule, type, name, id, options) {};
-
-/**
- * @type {boolean}
- */
-ProtoBuf.Reflect.Message.Field.prototype.required;
-
-/**
- * @type {boolean}
- */
-ProtoBuf.Reflect.Message.Field.prototype.repeated;
-
-/**
- * @type {string|{name: string, wireType: number}}
- */
-ProtoBuf.Reflect.Message.Field.prototype.type;
-
-/**
- * @type {number}
- */
-ProtoBuf.Reflect.Message.Field.prototype.id;
-
-/**
- * @type {!Object.<string,*>}
- */
-ProtoBuf.Reflect.Message.Field.prototype.options;
-
-/**
- * @type {?ProtoBuf.Reflect.T}
- */
-ProtoBuf.Reflect.Message.Field.prototype.resolvedType;
-
-/**
- * @type {string}
- */
-ProtoBuf.Reflect.Message.Field.prototype.originalName;
-
-/**
- * @param {*} value
- * @param {boolean=} skipRepeated
- * @return {*}
- * @throws {Error}
- * @nosideeffects
- */
-ProtoBuf.Reflect.Message.Field.prototype.verifyValue = function(value, skipRepeated) {};
-
-/**
- * @param {*} value
- * @param {!ByteBuffer} buffer
- * @return {!ByteBuffer}
- * @throws {Error}
- */
-ProtoBuf.Reflect.Message.Field.prototype.encode = function(value, buffer) {};
-
-/**
- * @param {*} value
- * @return {number}
- * @throws {Error}
- * @nosideeffects
- */
-ProtoBuf.Reflect.Message.Field.prototype.calculate = function(value) {};
-
-/**
- * @param {number} wireType
- * @param {!ByteBuffer} buffer
- * @return {*}
- * @throws {Error}
- */
-ProtoBuf.Reflect.Message.Field.prototype.decode = function(wireType, buffer) {};
-
-/**
- * @param {*} value
- * @param {!ByteBuffer} buffer
- * @return {!ByteBuffer}
- * @throws {Error}
- */
-ProtoBuf.Reflect.Message.Field.prototype.encodeValue = function(value, buffer) {};
-
-/**
- * @param {!ProtoBuf.Reflect.T} parent
- * @param {string} name
- * @constructor
- * @extends ProtoBuf.Reflect.Namespace
- */
-ProtoBuf.Reflect.Enum = function(parent, name) {};
-
-/**
- * @return {Object<string,*>}
- */
-ProtoBuf.Reflect.Enum.prototype.build = function() {};
-
-/**
- * @type {?Object.<string,number>}
- */
-ProtoBuf.Reflect.Enum.prototype.object;
-
-/**
- * @param {!ProtoBuf.Reflect.Enum} enm
- * @param {string} name
- * @param {number} id 
- * @constructor
- * @extends ProtoBuf.Reflect.T
- */
-ProtoBuf.Reflect.Enum.Value = function(enm, name, id) {};
-
-/**
- * @type {number}
- */
-ProtoBuf.Reflect.Enum.Value.prototype.id;
-
-/**
- * @param {!ProtoBuf.Reflect.Namespace} root
- * @param {string} name Service name
- * @param {Object.<string,*>=} options
- * @constructor
- * @extends ProtoBuf.Reflect.Namespace
- */
-ProtoBuf.Reflect.Service = function(root, name, options) {};
-
-/**
- * @type {ProtoBuf.Builder.Service}
- */
-ProtoBuf.Reflect.Service.prototype.clazz;
-
-/**
- * @return {!ProtoBuf.Builder.Service}
- * @throws {Error}
- */
-ProtoBuf.Reflect.Service.prototype.build = function() {};
-
-/**
- * @param {!ProtoBuf.Reflect.Service} svc
- * @param {string} name
- * @param {Object.<string,*>=} options
- * @constructor
- * @extends ProtoBuf.Reflect.T
- */
-ProtoBuf.Reflect.Service.Method = function(svc, name, options) {};
-
-/**
- * @return {Object.<string,*>}
- */
-ProtoBuf.Reflect.Service.Method.prototype.buildOpt = function() {};
-
-/**
- * @param {!ProtoBuf.Reflect.Service} svc
- * @param {string} name
- * @param {string} request
- * @param {string} response
- * @param {Object.<string,*>=} options
- * @constructor
- * @extends ProtoBuf.Reflect.Service.Method
- */
-ProtoBuf.Reflect.Service.RPCMethod = function(svc, name, request, response, options) {};
-
-/**
- * @type {string}
- */
-ProtoBuf.Reflect.Service.RPCMethod.prototype.requestName;
-
-/**
- * @type {string}
- */
-ProtoBuf.Reflect.Service.RPCMethod.prototype.responseName;
-
-/**
- * @type {ProtoBuf.Reflect.Message}
- */
-ProtoBuf.Reflect.Service.RPCMethod.prototype.resolvedRequestType;
-
-/**
- * @type {ProtoBuf.Reflect.Message}
- */
-ProtoBuf.Reflect.Service.RPCMethod.prototype.resolvedResponseType;
-
-/**
- * @constructor
- */
-ProtoBuf.Builder = function() {};
-
-/**
- * @type {!ProtoBuf.Reflect.Namespace}
- */
-ProtoBuf.Builder.prototype.ns;
-
-/**
- * @type {?ProtoBuf.Reflect.T}
- */
-ProtoBuf.Builder.prototype.ptr;
-
-/**
- * @type {boolean}
- */
-ProtoBuf.Builder.prototype.resolved;
-
-/**
- * @type {Object.<string,ProtoBuf.Builder.Message|Object>|null}
- */
-ProtoBuf.Builder.prototype.result;
-
-/**
- * @type {Array.<string>}
- */
-ProtoBuf.Builder.prototype.files;
-
-/**
- * @type {?string}
- */
-ProtoBuf.Builder.prototype.importRoot;
-
-/**
- */
-ProtoBuf.Builder.prototype.reset = function() {};
-
-/**
- * @param {string} pkg
- * @return {!ProtoBuf.Builder}
- * @throws {Error}
- */
-ProtoBuf.Builder.prototype.define = function(pkg) {};
-
-/**
- * @param {Object.<string,*>} def
- * @return {boolean}
- * @nosideeffects
- */
-ProtoBuf.Builder.isValidMessage = function(def) {};
-
-/**
- * @param {Object.<string,*>} def
- * @return {boolean}
- * @nosideeffects
- */
-ProtoBuf.Builder.isValidMessageField = function(def) {};
-
-/**
- * @param {Object.<string,*>} def
- * @return {boolean}
- */
-ProtoBuf.Builder.isValidEnum = function(def) {};
-
-/**
- * @param {Object.<string,*>} def
- * @return {boolean}
- */
-ProtoBuf.Builder.isValidService = function(def) {};
-
-/**
- * @param {Object.<string,*>} def
- * @return {boolean}
- */
-ProtoBuf.Builder.isValidExtend = function(def) {};
-
-/**
- * @param {Array.<Object.<string,*>>} messages
- * @return {ProtoBuf.Builder}
- * @throws {Error}
- */
-ProtoBuf.Builder.prototype.create = function(messages) {};
-
-/**
- * @name ProtoBuf.Builder.prototype.import
- * @function
- * @param {ProtoBuf.Builder} builder
- * @param {(string|{root: string, file: string})=} filename
- * @return {!ProtoBuf.Builder}
- * @throws {Error}
- */
-ProtoBuf.Builder.prototype["import"] = function(builder, filename) {};
-
-/**
- * @throws {Error}
- */
-ProtoBuf.Builder.prototype.resolveAll = function() {};
-
-/**
- * @param {string=} path
- * @return {ProtoBuf.Builder.Message|Object.<string,*>}
- * @throws {Error}
- */
-ProtoBuf.Builder.prototype.build = function(path) {};
-
-/**
- * @param {string=} path
- * @return {?ProtoBuf.Reflect.T}
- */
-ProtoBuf.Builder.prototype.lookup = function(path) {};
-
-/**
- * @return {string}
- * @nosideeffects
- */
-ProtoBuf.Builder.prototype.toString = function() {};
-
-/**
- * @param {Object.<string,*>} values
- * @constructor
- * @throws {Error}
- */
-ProtoBuf.Builder.Message = function(values) {};
-
-/**
- * @param {string} key
- * @param {*} value
- * @param {boolean=} noAssert
- * @throws {Error}
- */
-ProtoBuf.Builder.Message.prototype.add = function(key, value, noAssert) {};
-
-/**
- * @param {string} key
- * @param {*} value
- * @param {boolean=} noAssert
- * @throws {Error}
- */
-ProtoBuf.Builder.Message.prototype.$add = function(key, value, noAssert) {};
-
-/**
- * @param {string} key
- * @param {*} value
- * @param {boolean=} noAssert
- * @throws {Error}
- */
-ProtoBuf.Builder.Message.prototype.set = function(key, value, noAssert) {};
-
-/**
- * @param {string} key
- * @param {*} value
- * @param {boolean=} noAssert
- * @throws {Error}
- */
-ProtoBuf.Builder.Message.prototype.$set = function(key, value, noAssert) {};
-
-/**
- * @param {string} key
- * @return {*}
- * @throws {Error}
- * @nosideeffects
- */
-ProtoBuf.Builder.Message.prototype.get = function(key) {};
-
-/**
- * @param {string} key
- * @return {*}
- * @throws {Error}
- * @nosideeffects
- */
-ProtoBuf.Builder.Message.prototype.$get = function(key) {};
-
-/**
- * @param {ByteBuffer=} buffer
- * @return {!ByteBuffer}
- * @throws {Error}
- */
-ProtoBuf.Builder.Message.prototype.encode = function(buffer) {};
-
-/**
- * @return {number}
- * @throws {Error}
- * @nosideeffects
- */
-ProtoBuf.Builder.Message.prototype.calculate = function() {};
-
-/**
- * @return {!ArrayBuffer}
- * @throws {Error}
- */
-ProtoBuf.Builder.Message.prototype.encodeAB = function() {};
-
-/**
- * @return {!ArrayBuffer}
- * @throws {Error}
- * @nosideeffects
- */
-ProtoBuf.Builder.Message.prototype.toArrayBuffer = function() {};
-
-/**
- * @return {!Buffer}
- * @throws {Error}
- */
-ProtoBuf.Builder.Message.prototype.encodeNB = function() {};
-
-/**
- * @return {!Buffer}
- * @throws {Error}
- * @nosideeffects
- */
-ProtoBuf.Builder.Message.prototype.toBuffer = function() {};
-
-/**
- * @return {string}
- * @throws {Error}
- * @nosideeffects
- */
-ProtoBuf.Builder.Message.prototype.encode64 = function() {};
-
-/**
- * @return {string}
- * @throws {Error}
- * @nosideeffects
- */
-ProtoBuf.Builder.Message.prototype.toBase64 = function() {};
-
-/**
- * @return {string}
- * @throws {Error}
- * @nosideeffects
- */
-ProtoBuf.Builder.Message.prototype.encodeHex = function() {};
-
-/**
- * @return {string}
- * @throws {Error}
- * @nosideeffects
- */
-ProtoBuf.Builder.Message.prototype.toHex = function() {};
-
-/**
- * @param {boolean=} includeBuffers
- * @return {Object.<string,*>}
- * @nosideeffects
- */
-ProtoBuf.Builder.Message.prototype.toRaw = function(includeBuffers) {};
-
-/**
- * @param {!ByteBuffer|!ArrayBuffer|!Buffer|string} buffer
- * @param {string=} enc
- * @return {!ProtoBuf.Builder.Message}
- * @throws {Error}
- * @nosideeffects
- */
-ProtoBuf.Builder.Message.decode = function(buffer, enc) {};
-
-/**
- * @param {string} str
- * @return {!ProtoBuf.Builder.Message}
- * @throws {Error}
- * @nosideeffects
- */
-ProtoBuf.Builder.Message.decode64 = function(str) {};
-
-/**
- * @param {string} str
- * @return {!ProtoBuf.Builder.Message}
- * @throws {Error}
- * @nosideeffects
- */
-ProtoBuf.Builder.Message.decodeHex = function(str) {};
-
-/**
- * @return {string}
- * @nosideeffects
- */
-ProtoBuf.Builder.Message.prototype.toString = function() {};
-
-/**
- * @param {function(string, ProtoBuf.Builder.Message, function(Error, ProtoBuf.Builder.Message=))} rpcImpl
- * @constructor
- */
-ProtoBuf.Builder.Service = function(rpcImpl) {};
-
-/**
- * @type {function(string, ProtoBuf.Builder.Message, function(Error, ProtoBuf.Builder.Message=))}
- */
-ProtoBuf.Builder.prototype.rpcImpl;
-
-/**
- * @param {string} proto
- * @param {(ProtoBuf.Builder|string)=} builder
- * @param {(string|{root: string, file: string})=} filename
- * @return {!ProtoBuf.Builder}
- * @throws {Error}
- */
-ProtoBuf.loadProto = function(proto, builder, filename) {};
-
-/**
- * @param {string} proto
- * @param {(ProtoBuf.Builder|string|{root: string, file: string})=} builder
- * @param {(string|{root: string, file: string})=} filename
- * @return {!ProtoBuf.Builder}
- * @throws {Error}
- */
-ProtoBuf.protoFromString = function(proto, builder, filename) {};
-
-/**
- * @param {string|{root: string, file: string}} filename
- * @param {(function(ProtoBuf.Builder)|ProtoBuf.Builder)=} callback
- * @param {ProtoBuf.Builder=} builder
- * @return {ProtoBuf.Builder|undefined}
- * @throws {Error}
- */
-ProtoBuf.loadProtoFile = function(filename, callback, builder) {};
-
-/**
- * @param {string|{root: string, file: string}} filename
- * @param {(function(ProtoBuf.Builder)|ProtoBuf.Builder)=} callback
- * @param {ProtoBuf.Builder=} builder
- * @return {ProtoBuf.Builder|undefined}
- * @throws {Error}
- */
-ProtoBuf.protoFromFile = function(filename, callback, builder) {};
-
-/**
- * @param {!*|string} proto
- * @param {(ProtoBuf.Builder|string|{root: string, file: string})=} builder
- * @param {(string|{root: string, file: string})=} filename
- * @return {!ProtoBuf.Builder}
- * @throws {Error}
- */
-ProtoBuf.loadJson = function(json, builder, filename) {};
-
-/**
- * @param {string|{root: string, file: string}} filename
- * @param {(function(ProtoBuf.Builder)|ProtoBuf.Builder)=} callback
- * @param {ProtoBuf.Builder=} builder
- * @return {ProtoBuf.Builder|undefined}
- * @throws {Error}
- */
-ProtoBuf.loadJsonFile = function(filename, callback, builder) {};
-
-/**
- * @param {string=} pkg
- * @return {!ProtoBuf.Builder}
- */
-ProtoBuf.newBuilder = function(pkg) {};
-
-ProtoBuf.Util = {};
-
-/**
- * @type {boolean}
- */
-ProtoBuf.Util.IS_NODE;
-
-/**
- * @return {XMLHttpRequest}
- */
-ProtoBuf.Util.XHR = function() {};
-
-/**
- * @param {string} path
- * @param {function(?string)=} callback
- * @return {?string|undefined}
- */
-ProtoBuf.Util.fetch = function(path, callback) {};
-
-/**
- * @param {*} obj
- * @return {boolean}
- */
-ProtoBuf.Util.isArray = function(obj) {};
+/*
+ * Copyright 2012 The Closure Compiler Authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @fileoverview Externs for ProtoBuf.js.
+ * @see https://github.com/dcodeIO/ProtoBuf.js
+ * @externs
+ */
+
+/**
+ BEGIN_NODE_INCLUDE
+ var ProtoBuf = require('protobufjs');
+ END_NODE_INCLUDE
+ */
+
+/**
+ * @typedef {Array}
+ */
+var Buffer;
+
+/**
+ * @typedef {Object}
+ */
+var dcodeIO;
+
+/**
+ * {@type Object.<string.*>}
+ */
+var ProtoBuf = {};
+
+/**
+ * @type {string}
+ * @const
+ */
+ProtoBuf.VERSION;
+
+/**
+ * @type {!Object.<string,number>}
+ * @const
+ */
+ProtoBuf.WIRE_TYPES = {};
+
+/**
+ * @type {number}
+ * @const
+ */
+ProtoBuf.WIRE_TYPES.VARINT;
+
+/**
+ * @type {number}
+ * @const
+ */
+ProtoBuf.WIRE_TYPES.BITS64;
+
+/**
+ * @type {number}
+ * @const
+ */
+ProtoBuf.WIRE_TYPES.LDELIM;
+
+/**
+ * @type {number}
+ * @const
+ */
+ProtoBuf.WIRE_TYPES.STARTGROUP;
+
+/**
+ * @type {number}
+ * @const
+ */
+ProtoBuf.WIRE_TYPES.ENDGROUP;
+
+/**
+ * @type {number}
+ * @const
+ */
+ProtoBuf.WIRE_TYPES.BITS32;
+
+/**
+ * @type {!Array.<number>}
+ * @const
+ */
+ProtoBuf.PACKABLE_WIRE_TYPES;
+
+/**
+ * @type {boolean}
+ */
+ProtoBuf.convertFieldsToCamelCase;
+
+/**
+ * @type {boolean}
+ */
+ProtoBuf.populateAccessors;
+
+/**
+ * @dict
+ * @type {!Object<string,{name: string, wireType: number}>}
+ * @const
+ */
+ProtoBuf.TYPES;
+
+/**
+ * @type {number}
+ */
+ProtoBuf.ID_MIN;
+
+/**
+ * @type {number}
+ */
+ProtoBuf.ID_MAX;
+
+/**
+ * @type {!function(new: ByteBuffer, ...*)}
+ */
+ProtoBuf.ByteBuffer;
+
+/**
+ * @type {?function(new: Long, ...*)}
+ */
+ProtoBuf.Long;
+
+/**
+ * @type {!Object<string,string|RegExp>}
+ */
+ProtoBuf.Lang;
+
+/**
+ * @type {Object<string, function(*)>}
+ */
+ProtoBuf.DotProto;
+
+/**
+ * @param {string} proto
+ * @constructor
+ */
+ProtoBuf.DotProto.Tokenizer = function(proto) {};
+
+/**
+ * @type {string}
+ */
+ProtoBuf.DotProto.Tokenizer.prototype.source;
+
+/**
+ * @type {number}
+ */
+ProtoBuf.DotProto.Tokenizer.prototype.index;
+
+/**
+ * @type {number}
+ */
+ProtoBuf.DotProto.Tokenizer.prototype.line;
+
+/**
+ * @type {Array.<string>}
+ */
+ProtoBuf.DotProto.Tokenizer.prototype.stack;
+
+/**
+ * @type {boolean}
+ */
+ProtoBuf.DotProto.Tokenizer.prototype.readingString;
+
+/**
+ * @return {?string}
+ * @throws {Error}
+ */
+ProtoBuf.DotProto.Tokenizer.prototype.next = function() {};
+
+/**
+ * @return {?string}
+ * @throws {Error}
+ */
+ProtoBuf.DotProto.Tokenizer.prototype.peek = function() {};
+
+/**
+ * @return {string}
+ * @nosideeffects
+ */
+ProtoBuf.DotProto.Tokenizer.prototype.toString = function() {};
+
+/**
+ * @param {string} proto
+ * @constructor
+ */
+ProtoBuf.DotProto.Parser = function(proto) {};
+
+/**
+ * @type {!ProtoBuf.DotProto.Tokenizer}
+ */
+ProtoBuf.DotProto.Parser.prototype.tn;
+
+/**
+ * @return {{package: (string|null), messages: Array.<Object>, enums: Array.<Object>, imports: Array.<string>, options: Object<string,*>}}
+ * @throws {Error}
+ */
+ProtoBuf.DotProto.Parser.prototype.parse = function() {};
+
+/**
+ * @return {string}
+ * @nosideeffects
+ */
+ProtoBuf.DotProto.Parser.prototype.toString = function() {};
+
+/**
+ * @type {Object<string, function(*)>}
+ */
+ProtoBuf.Reflect.Reflect = {};
+
+/**
+ * @constructor
+ * @param {ProtoBuf.Reflect.T} parent
+ * @param {string} name Object name
+ */
+ProtoBuf.Reflect.T = function(parent, name) {};
+
+/**
+ * @type {?ProtoBuf.Reflect.T}
+ */
+ProtoBuf.Reflect.T.prototype.parent;
+
+/**
+ * @type {string}
+ */
+ProtoBuf.Reflect.T.prototype.name;
+
+/**
+ * @returns {string}
+ * @nosideeffects
+ */
+ProtoBuf.Reflect.T.prototype.fqn = function() {};
+
+/**
+ * @param {boolean=} includeClass
+ * @returns {string}
+ * @nosideeffects
+ */
+ProtoBuf.Reflect.T.prototype.toString = function(includeClass) {};
+
+/**
+ * @throws {Error}
+ */
+ProtoBuf.Reflect.T.prototype.build = function() {};
+
+/**
+ * @param {?ProtoBuf.Reflect.Namespace} parent
+ * @param {string} name
+ * @constructor
+ * @extends ProtoBuf.Reflect.T
+ */
+ProtoBuf.Reflect.Namespace = function(parent, name) {};
+
+/**
+ * @type {Array.<ProtoBuf.Reflect.T>}
+ */
+ProtoBuf.Reflect.Namespace.prototype.children;
+
+/**
+ * @param {ProtoBuf.Reflect.T=} type
+ * @return {Array.<ProtoBuf.Reflect.T>}
+ * @nosideeffects
+ */
+ProtoBuf.Reflect.Namespace.prototype.getChildren = function(type) {};
+
+/**
+ * @param {ProtoBuf.Reflect.T} child
+ * @throws {Error}
+ */
+ProtoBuf.Reflect.Namespace.prototype.addChild = function(child) {};
+
+/**
+ * @param {string|number} nameOrId
+ * @returns {boolean}
+ * @nosideeffects
+ */
+ProtoBuf.Reflect.Namespace.prototype.hasChild = function(nameOrId) {};
+
+/**
+ * @param {string|number} nameOrId
+ * @return {?ProtoBuf.Reflect.T}
+ * @nosideeffects
+ */
+ProtoBuf.Reflect.Namespace.prototype.getChild = function(nameOrId) {};
+
+/**
+ * @param {string} qn
+ * @param {boolean=} excludeFields
+ * @return {?ProtoBuf.Reflect.Namespace}
+ * @nosideeffects
+ */
+ProtoBuf.Reflect.Namespace.prototype.resolve = function(qn, excludeFields) {};
+
+/**
+ * @return {Object.<string,Function|Object>}
+ */
+ProtoBuf.Reflect.Namespace.prototype.build = function() {};
+
+/**
+ * @param {!ProtoBuf.Reflect.Namespace} parent
+ * @param {string} name
+ * @constructor
+ * @extends ProtoBuf.Reflect.Namespace
+ */
+ProtoBuf.Reflect.Message = function(parent, name) {};
+
+/**
+ * @type {?Array.<number>}
+ */
+ProtoBuf.Reflect.Message.prototype.extensions;
+
+/**
+ * @type {?ProtoBuf.Builder.Message}
+ */
+ProtoBuf.Reflect.Message.prototype.clazz;
+
+/**
+ * @return {!ProtoBuf.Builder.Message}
+ * @throws {Error}
+ */
+ProtoBuf.Reflect.Message.prototype.build = function() {};
+
+/**
+ * @param {!ProtoBuf.Builder.Message} message
+ * @param {!ByteBuffer} buffer
+ * @return {!ByteBuffer}
+ * @throws {Error}
+ */
+ProtoBuf.Reflect.Message.prototype.encode = function(message, buffer) {};
+
+/**
+ * @param {!ProtoBuf.Builder.Message} message
+ * @return {number}
+ * @throws {Error}
+ */
+ProtoBuf.Reflect.Message.prototype.calculate = function(message) {};
+
+/**
+ * @param {!ProtoBuf.Builder.Message} message
+ * @param {!ByteBuffer} buffer
+ * @param {bool} noVerify
+ * @return {!ByteBuffer}
+ * @throws {Error}
+ */
+ProtoBuf.Reflect.Message.prototype.encodeDelimited = function(message, buffer, noVerify) {};
+
+/**
+ * @param {!ByteBuffer} buffer
+ * @param {number=} length
+ * @return {!ProtoBuf.Builder.Message}
+ * @throws {Error}
+ */
+ProtoBuf.Reflect.Message.prototype.decode = function(buffer, length) {};
+
+/**
+ * @param {!ByteBuffer} buffer
+ * @param {number=} length
+ * @return {!ProtoBuf.Builder.Message}
+ * @throws {Error}
+ */
+ProtoBuf.Reflect.Message.prototype.decodeDelimited = function(buffer, length) {};
+
+/**
+ * @param {!ProtoBuf.Reflect.Message} message
+ * @param {string} rule
+ * @param {string} type
+ * @param {string} name
+ * @param {number} id
+ * @param {Object<string>=} options
+ * @constructor
+ * @extends ProtoBuf.Reflect.T
+ */
+ProtoBuf.Reflect.Message.Field = function(message, rule, type, name, id, options) {};
+
+/**
+ * @type {boolean}
+ */
+ProtoBuf.Reflect.Message.Field.prototype.required;
+
+/**
+ * @type {boolean}
+ */
+ProtoBuf.Reflect.Message.Field.prototype.repeated;
+
+/**
+ * @type {string|{name: string, wireType: number}}
+ */
+ProtoBuf.Reflect.Message.Field.prototype.type;
+
+/**
+ * @type {number}
+ */
+ProtoBuf.Reflect.Message.Field.prototype.id;
+
+/**
+ * @type {!Object.<string,*>}
+ */
+ProtoBuf.Reflect.Message.Field.prototype.options;
+
+/**
+ * @type {?ProtoBuf.Reflect.T}
+ */
+ProtoBuf.Reflect.Message.Field.prototype.resolvedType;
+
+/**
+ * @type {string}
+ */
+ProtoBuf.Reflect.Message.Field.prototype.originalName;
+
+/**
+ * @param {*} value
+ * @param {boolean=} skipRepeated
+ * @return {*}
+ * @throws {Error}
+ * @nosideeffects
+ */
+ProtoBuf.Reflect.Message.Field.prototype.verifyValue = function(value, skipRepeated) {};
+
+/**
+ * @param {*} value
+ * @param {!ByteBuffer} buffer
+ * @return {!ByteBuffer}
+ * @throws {Error}
+ */
+ProtoBuf.Reflect.Message.Field.prototype.encode = function(value, buffer) {};
+
+/**
+ * @param {*} value
+ * @return {number}
+ * @throws {Error}
+ * @nosideeffects
+ */
+ProtoBuf.Reflect.Message.Field.prototype.calculate = function(value) {};
+
+/**
+ * @param {number} wireType
+ * @param {!ByteBuffer} buffer
+ * @return {*}
+ * @throws {Error}
+ */
+ProtoBuf.Reflect.Message.Field.prototype.decode = function(wireType, buffer) {};
+
+/**
+ * @param {*} value
+ * @param {!ByteBuffer} buffer
+ * @return {!ByteBuffer}
+ * @throws {Error}
+ */
+ProtoBuf.Reflect.Message.Field.prototype.encodeValue = function(value, buffer) {};
+
+/**
+ * @param {!ProtoBuf.Reflect.T} parent
+ * @param {string} name
+ * @constructor
+ * @extends ProtoBuf.Reflect.Namespace
+ */
+ProtoBuf.Reflect.Enum = function(parent, name) {};
+
+/**
+ * @return {Object<string,*>}
+ */
+ProtoBuf.Reflect.Enum.prototype.build = function() {};
+
+/**
+ * @type {?Object.<string,number>}
+ */
+ProtoBuf.Reflect.Enum.prototype.object;
+
+/**
+ * @param {!ProtoBuf.Reflect.Enum} enm
+ * @param {string} name
+ * @param {number} id 
+ * @constructor
+ * @extends ProtoBuf.Reflect.T
+ */
+ProtoBuf.Reflect.Enum.Value = function(enm, name, id) {};
+
+/**
+ * @type {number}
+ */
+ProtoBuf.Reflect.Enum.Value.prototype.id;
+
+/**
+ * @param {!ProtoBuf.Reflect.Namespace} root
+ * @param {string} name Service name
+ * @param {Object.<string,*>=} options
+ * @constructor
+ * @extends ProtoBuf.Reflect.Namespace
+ */
+ProtoBuf.Reflect.Service = function(root, name, options) {};
+
+/**
+ * @type {ProtoBuf.Builder.Service}
+ */
+ProtoBuf.Reflect.Service.prototype.clazz;
+
+/**
+ * @return {!ProtoBuf.Builder.Service}
+ * @throws {Error}
+ */
+ProtoBuf.Reflect.Service.prototype.build = function() {};
+
+/**
+ * @param {!ProtoBuf.Reflect.Service} svc
+ * @param {string} name
+ * @param {Object.<string,*>=} options
+ * @constructor
+ * @extends ProtoBuf.Reflect.T
+ */
+ProtoBuf.Reflect.Service.Method = function(svc, name, options) {};
+
+/**
+ * @return {Object.<string,*>}
+ */
+ProtoBuf.Reflect.Service.Method.prototype.buildOpt = function() {};
+
+/**
+ * @param {!ProtoBuf.Reflect.Service} svc
+ * @param {string} name
+ * @param {string} request
+ * @param {string} response
+ * @param {Object.<string,*>=} options
+ * @constructor
+ * @extends ProtoBuf.Reflect.Service.Method
+ */
+ProtoBuf.Reflect.Service.RPCMethod = function(svc, name, request, response, options) {};
+
+/**
+ * @type {string}
+ */
+ProtoBuf.Reflect.Service.RPCMethod.prototype.requestName;
+
+/**
+ * @type {string}
+ */
+ProtoBuf.Reflect.Service.RPCMethod.prototype.responseName;
+
+/**
+ * @type {ProtoBuf.Reflect.Message}
+ */
+ProtoBuf.Reflect.Service.RPCMethod.prototype.resolvedRequestType;
+
+/**
+ * @type {ProtoBuf.Reflect.Message}
+ */
+ProtoBuf.Reflect.Service.RPCMethod.prototype.resolvedResponseType;
+
+/**
+ * @constructor
+ */
+ProtoBuf.Builder = function() {};
+
+/**
+ * @type {!ProtoBuf.Reflect.Namespace}
+ */
+ProtoBuf.Builder.prototype.ns;
+
+/**
+ * @type {?ProtoBuf.Reflect.T}
+ */
+ProtoBuf.Builder.prototype.ptr;
+
+/**
+ * @type {boolean}
+ */
+ProtoBuf.Builder.prototype.resolved;
+
+/**
+ * @type {Object.<string,ProtoBuf.Builder.Message|Object>|null}
+ */
+ProtoBuf.Builder.prototype.result;
+
+/**
+ * @type {Array.<string>}
+ */
+ProtoBuf.Builder.prototype.files;
+
+/**
+ * @type {?string}
+ */
+ProtoBuf.Builder.prototype.importRoot;
+
+/**
+ */
+ProtoBuf.Builder.prototype.reset = function() {};
+
+/**
+ * @param {string} pkg
+ * @return {!ProtoBuf.Builder}
+ * @throws {Error}
+ */
+ProtoBuf.Builder.prototype.define = function(pkg) {};
+
+/**
+ * @param {Object.<string,*>} def
+ * @return {boolean}
+ * @nosideeffects
+ */
+ProtoBuf.Builder.isValidMessage = function(def) {};
+
+/**
+ * @param {Object.<string,*>} def
+ * @return {boolean}
+ * @nosideeffects
+ */
+ProtoBuf.Builder.isValidMessageField = function(def) {};
+
+/**
+ * @param {Object.<string,*>} def
+ * @return {boolean}
+ */
+ProtoBuf.Builder.isValidEnum = function(def) {};
+
+/**
+ * @param {Object.<string,*>} def
+ * @return {boolean}
+ */
+ProtoBuf.Builder.isValidService = function(def) {};
+
+/**
+ * @param {Object.<string,*>} def
+ * @return {boolean}
+ */
+ProtoBuf.Builder.isValidExtend = function(def) {};
+
+/**
+ * @param {Array.<Object.<string,*>>} messages
+ * @return {ProtoBuf.Builder}
+ * @throws {Error}
+ */
+ProtoBuf.Builder.prototype.create = function(messages) {};
+
+/**
+ * @name ProtoBuf.Builder.prototype.import
+ * @function
+ * @param {ProtoBuf.Builder} builder
+ * @param {(string|{root: string, file: string})=} filename
+ * @return {!ProtoBuf.Builder}
+ * @throws {Error}
+ */
+ProtoBuf.Builder.prototype["import"] = function(builder, filename) {};
+
+/**
+ * @throws {Error}
+ */
+ProtoBuf.Builder.prototype.resolveAll = function() {};
+
+/**
+ * @param {string=} path
+ * @return {ProtoBuf.Builder.Message|Object.<string,*>}
+ * @throws {Error}
+ */
+ProtoBuf.Builder.prototype.build = function(path) {};
+
+/**
+ * @param {string=} path
+ * @return {?ProtoBuf.Reflect.T}
+ */
+ProtoBuf.Builder.prototype.lookup = function(path) {};
+
+/**
+ * @return {string}
+ * @nosideeffects
+ */
+ProtoBuf.Builder.prototype.toString = function() {};
+
+/**
+ * @param {Object.<string,*>} values
+ * @constructor
+ * @throws {Error}
+ */
+ProtoBuf.Builder.Message = function(values) {};
+
+/**
+ * @param {string} key
+ * @param {*} value
+ * @param {boolean=} noAssert
+ * @throws {Error}
+ */
+ProtoBuf.Builder.Message.prototype.add = function(key, value, noAssert) {};
+
+/**
+ * @param {string} key
+ * @param {*} value
+ * @param {boolean=} noAssert
+ * @throws {Error}
+ */
+ProtoBuf.Builder.Message.prototype.$add = function(key, value, noAssert) {};
+
+/**
+ * @param {string} key
+ * @param {*} value
+ * @param {boolean=} noAssert
+ * @throws {Error}
+ */
+ProtoBuf.Builder.Message.prototype.set = function(key, value, noAssert) {};
+
+/**
+ * @param {string} key
+ * @param {*} value
+ * @param {boolean=} noAssert
+ * @throws {Error}
+ */
+ProtoBuf.Builder.Message.prototype.$set = function(key, value, noAssert) {};
+
+/**
+ * @param {string} key
+ * @return {*}
+ * @throws {Error}
+ * @nosideeffects
+ */
+ProtoBuf.Builder.Message.prototype.get = function(key) {};
+
+/**
+ * @param {string} key
+ * @return {*}
+ * @throws {Error}
+ * @nosideeffects
+ */
+ProtoBuf.Builder.Message.prototype.$get = function(key) {};
+
+/**
+ * @param {ByteBuffer=} buffer
+ * @return {!ByteBuffer}
+ * @throws {Error}
+ */
+ProtoBuf.Builder.Message.prototype.encode = function(buffer) {};
+
+/**
+ * @return {number}
+ * @throws {Error}
+ * @nosideeffects
+ */
+ProtoBuf.Builder.Message.prototype.calculate = function() {};
+
+/**
+ * @return {!ArrayBuffer}
+ * @throws {Error}
+ */
+ProtoBuf.Builder.Message.prototype.encodeAB = function() {};
+
+/**
+ * @return {!ArrayBuffer}
+ * @throws {Error}
+ * @nosideeffects
+ */
+ProtoBuf.Builder.Message.prototype.toArrayBuffer = function() {};
+
+/**
+ * @return {!Buffer}
+ * @throws {Error}
+ */
+ProtoBuf.Builder.Message.prototype.encodeNB = function() {};
+
+/**
+ * @return {!Buffer}
+ * @throws {Error}
+ * @nosideeffects
+ */
+ProtoBuf.Builder.Message.prototype.toBuffer = function() {};
+
+/**
+ * @return {string}
+ * @throws {Error}
+ * @nosideeffects
+ */
+ProtoBuf.Builder.Message.prototype.encode64 = function() {};
+
+/**
+ * @return {string}
+ * @throws {Error}
+ * @nosideeffects
+ */
+ProtoBuf.Builder.Message.prototype.toBase64 = function() {};
+
+/**
+ * @return {string}
+ * @throws {Error}
+ * @nosideeffects
+ */
+ProtoBuf.Builder.Message.prototype.encodeHex = function() {};
+
+/**
+ * @return {string}
+ * @throws {Error}
+ * @nosideeffects
+ */
+ProtoBuf.Builder.Message.prototype.toHex = function() {};
+
+/**
+ * @param {boolean=} includeBuffers
+ * @return {Object.<string,*>}
+ * @nosideeffects
+ */
+ProtoBuf.Builder.Message.prototype.toRaw = function(includeBuffers) {};
+
+/**
+ * @param {!ByteBuffer|!ArrayBuffer|!Buffer|string} buffer
+ * @param {string=} enc
+ * @return {!ProtoBuf.Builder.Message}
+ * @throws {Error}
+ * @nosideeffects
+ */
+ProtoBuf.Builder.Message.decode = function(buffer, enc) {};
+
+/**
+ * @param {string} str
+ * @return {!ProtoBuf.Builder.Message}
+ * @throws {Error}
+ * @nosideeffects
+ */
+ProtoBuf.Builder.Message.decode64 = function(str) {};
+
+/**
+ * @param {string} str
+ * @return {!ProtoBuf.Builder.Message}
+ * @throws {Error}
+ * @nosideeffects
+ */
+ProtoBuf.Builder.Message.decodeHex = function(str) {};
+
+/**
+ * @return {string}
+ * @nosideeffects
+ */
+ProtoBuf.Builder.Message.prototype.toString = function() {};
+
+/**
+ * @param {function(string, ProtoBuf.Builder.Message, function(Error, ProtoBuf.Builder.Message=))} rpcImpl
+ * @constructor
+ */
+ProtoBuf.Builder.Service = function(rpcImpl) {};
+
+/**
+ * @type {function(string, ProtoBuf.Builder.Message, function(Error, ProtoBuf.Builder.Message=))}
+ */
+ProtoBuf.Builder.prototype.rpcImpl;
+
+/**
+ * @param {string} proto
+ * @param {(ProtoBuf.Builder|string)=} builder
+ * @param {(string|{root: string, file: string})=} filename
+ * @return {!ProtoBuf.Builder}
+ * @throws {Error}
+ */
+ProtoBuf.loadProto = function(proto, builder, filename) {};
+
+/**
+ * @param {string} proto
+ * @param {(ProtoBuf.Builder|string|{root: string, file: string})=} builder
+ * @param {(string|{root: string, file: string})=} filename
+ * @return {!ProtoBuf.Builder}
+ * @throws {Error}
+ */
+ProtoBuf.protoFromString = function(proto, builder, filename) {};
+
+/**
+ * @param {string|{root: string, file: string}} filename
+ * @param {(function(ProtoBuf.Builder)|ProtoBuf.Builder)=} callback
+ * @param {ProtoBuf.Builder=} builder
+ * @return {ProtoBuf.Builder|undefined}
+ * @throws {Error}
+ */
+ProtoBuf.loadProtoFile = function(filename, callback, builder) {};
+
+/**
+ * @param {string|{root: string, file: string}} filename
+ * @param {(function(ProtoBuf.Builder)|ProtoBuf.Builder)=} callback
+ * @param {ProtoBuf.Builder=} builder
+ * @return {ProtoBuf.Builder|undefined}
+ * @throws {Error}
+ */
+ProtoBuf.protoFromFile = function(filename, callback, builder) {};
+
+/**
+ * @param {!*|string} json
+ * @param {(ProtoBuf.Builder|string|{root: string, file: string})=} builder
+ * @param {(string|{root: string, file: string})=} filename
+ * @return {!ProtoBuf.Builder}
+ * @throws {Error}
+ */
+ProtoBuf.loadJson = function(json, builder, filename) {};
+
+/**
+ * @param {string|{root: string, file: string}} filename
+ * @param {(function(ProtoBuf.Builder)|ProtoBuf.Builder)=} callback
+ * @param {ProtoBuf.Builder=} builder
+ * @return {ProtoBuf.Builder|undefined}
+ * @throws {Error}
+ */
+ProtoBuf.loadJsonFile = function(filename, callback, builder) {};
+
+/**
+ * @param {string=} pkg
+ * @return {!ProtoBuf.Builder}
+ */
+ProtoBuf.newBuilder = function(pkg) {};
+
+ProtoBuf.Util = {};
+
+/**
+ * @type {boolean}
+ */
+ProtoBuf.Util.IS_NODE;
+
+/**
+ * @return {XMLHttpRequest}
+ */
+ProtoBuf.Util.XHR = function() {};
+
+/**
+ * @param {string} path
+ * @param {function(?string)=} callback
+ * @return {?string|undefined}
+ */
+ProtoBuf.Util.fetch = function(path, callback) {};
+
+/**
+ * @param {*} obj
+ * @return {boolean}
+ */
+ProtoBuf.Util.isArray = function(obj) {};