@bufbuild/protobuf 2.2.5 → 2.4.0

package/dist/cjs/clone.js

@@ -30,24 +30,22 @@ function cloneReflect(i) {
             continue;
         }
         switch (f.fieldKind) {
-            default: {
-                o.set(f, cloneSingular(f, i.get(f)));
-                break;
-            }
             case "list":
-                // eslint-disable-next-line no-case-declarations
                 const list = o.get(f);
                 for (const item of i.get(f)) {
                     list.add(cloneSingular(f, item));
                 }
                 break;
             case "map":
-                // eslint-disable-next-line no-case-declarations
                 const map = o.get(f);
                 for (const entry of i.get(f).entries()) {
                     map.set(entry[0], cloneSingular(f, entry[1]));
                 }
                 break;
+            default: {
+                o.set(f, cloneSingular(f, i.get(f)));
+                break;
+            }
         }
     }
     const unknown = i.getUnknown();

package/dist/cjs/codegenv1/boot.js

@@ -29,7 +29,7 @@ function boot(boot) {
     const root = bootFileDescriptorProto(boot);
     root.messageType.forEach(restore_json_names_js_1.restoreJsonNames);
     const reg = (0, registry_js_1.createFileRegistry)(root, () => undefined);
-    // non-null assertion because we just created the registry from the file we look up
+    // biome-ignore lint/style/noNonNullAssertion: non-null assertion because we just created the registry from the file we look up
     return reg.getFile(root.name);
 }
 /**

package/dist/cjs/codegenv1/embed.js

@@ -235,7 +235,6 @@ function createEnumDescriptorBoot(proto) {
  * Assert that condition is truthy or throw error.
  */
 function assert(condition) {
-    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions -- we want the implicit conversion to boolean
     if (!condition) {
         throw new Error();
     }

package/dist/cjs/codegenv1/file.js

@@ -30,6 +30,6 @@ function fileDesc(b64, imports) {
     root.messageType.forEach(restore_json_names_js_1.restoreJsonNames);
     root.dependency = (_a = imports === null || imports === void 0 ? void 0 : imports.map((f) => f.proto.name)) !== null && _a !== void 0 ? _a : [];
     const reg = (0, registry_js_1.createFileRegistry)(root, (protoFileName) => imports === null || imports === void 0 ? void 0 : imports.find((f) => f.proto.name === protoFileName));
-    // non-null assertion because we just created the registry from the file we look up
+    // biome-ignore lint/style/noNonNullAssertion: non-null assertion because we just created the registry from the file we look up
     return reg.getFile(root.name);
 }

package/dist/cjs/codegenv1/symbols.js

@@ -25,10 +25,13 @@ exports.wktPublicImportPaths = {
     "google/protobuf/compiler/plugin.proto": exports.packageName + "/wkt",
     "google/protobuf/any.proto": exports.packageName + "/wkt",
     "google/protobuf/api.proto": exports.packageName + "/wkt",
+    "google/protobuf/cpp_features.proto": exports.packageName + "/wkt",
     "google/protobuf/descriptor.proto": exports.packageName + "/wkt",
     "google/protobuf/duration.proto": exports.packageName + "/wkt",
     "google/protobuf/empty.proto": exports.packageName + "/wkt",
     "google/protobuf/field_mask.proto": exports.packageName + "/wkt",
+    "google/protobuf/go_features.proto": exports.packageName + "/wkt",
+    "google/protobuf/java_features.proto": exports.packageName + "/wkt",
     "google/protobuf/source_context.proto": exports.packageName + "/wkt",
     "google/protobuf/struct.proto": exports.packageName + "/wkt",
     "google/protobuf/timestamp.proto": exports.packageName + "/wkt",
@@ -38,7 +41,7 @@ exports.wktPublicImportPaths = {
 /**
  * @private
  */
-// prettier-ignore
+// biome-ignore format: want this to read well
 exports.symbols = {
     isMessage: { typeOnly: false, bootstrapWktFrom: "../../is-message.js", from: exports.packageName },
     Message: { typeOnly: true, bootstrapWktFrom: "../../types.js", from: exports.packageName },

package/dist/cjs/create.js

@@ -64,7 +64,6 @@ function initMessage(messageDesc, message, init) {
         else {
             field = member;
         }
-        // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check -- no need to convert enum
         switch (field.fieldKind) {
             case "message":
                 value = toMessage(field, value);

package/dist/cjs/equals.js

@@ -165,7 +165,8 @@ function unknownEquals(a, b, registry) {
         return false;
     }
     for (let i = 0; i < unknownA.length; i++) {
-        const a = unknownA[i], b = unknownB[i];
+        const a = unknownA[i];
+        const b = unknownB[i];
         if (a.no != b.no) {
             return false;
         }

package/dist/cjs/extensions.js

@@ -151,7 +151,7 @@ function createExtensionContainer(extension, value) {
         () => {
             const value = container[localName];
             if (value === undefined) {
-                // Only message fields are undefined, rest will have a zero value.
+                // biome-ignore lint/style/noNonNullAssertion: Only message fields are undefined, rest will have a zero value.
                 const desc = extension.message;
                 if ((0, wrappers_js_1.isWrapperDesc)(desc)) {
                     return (0, scalar_js_1.scalarZeroValue)(desc.fields[0].scalar, desc.fields[0].longAsString);

package/dist/cjs/from-binary.js

@@ -59,7 +59,8 @@ function mergeFromBinary(schema, target, bytes, options) {
 function readMessage(message, reader, options, delimited, lengthOrDelimitedFieldNo) {
     var _a;
     const end = delimited ? reader.len : reader.pos + lengthOrDelimitedFieldNo;
-    let fieldNo, wireType;
+    let fieldNo;
+    let wireType;
     const unknownFields = (_a = message.getUnknown()) !== null && _a !== void 0 ? _a : [];
     while (reader.pos < end) {
         [fieldNo, wireType] = reader.tag();
@@ -78,7 +79,7 @@ function readMessage(message, reader, options, delimited, lengthOrDelimitedField
     }
     if (delimited) {
         if (wireType != binary_encoding_js_1.WireType.EndGroup || fieldNo !== lengthOrDelimitedFieldNo) {
-            throw new Error(`invalid end group tag`);
+            throw new Error("invalid end group tag");
         }
     }
     if (unknownFields.length > 0) {
@@ -110,7 +111,8 @@ function readField(message, reader, field, wireType, options) {
 // Read a map field, expecting key field = 1, value field = 2
 function readMapEntry(reader, map, options) {
     const field = map.field();
-    let key, val;
+    let key;
+    let val;
     const end = reader.pos + reader.uint32();
     while (reader.pos < end) {
         const [fieldNo] = reader.tag();

package/dist/cjs/from-json.js

@@ -19,7 +19,6 @@ exports.fromJson = fromJson;
 exports.mergeFromJson = mergeFromJson;
 exports.enumFromJson = enumFromJson;
 exports.isEnumJson = isEnumJson;
-/* eslint-disable no-case-declarations,@typescript-eslint/restrict-template-expressions */
 const descriptors_js_1 = require("./descriptors.js");
 const proto_int64_js_1 = require("./proto-int64.js");
 const create_js_1 = require("./create.js");
@@ -104,7 +103,7 @@ function mergeFromJson(schema, target, json, options) {
 function enumFromJson(descEnum, json) {
     const val = readEnum(descEnum, json, false, false);
     if (val === tokenIgnoredUnknownEnum) {
-        throw new Error(`cannot decode ${String(descEnum)} from JSON: ${(0, reflect_check_js_1.formatVal)(json)}`);
+        throw new Error(`cannot decode ${descEnum} from JSON: ${(0, reflect_check_js_1.formatVal)(json)}`);
     }
     return val;
 }
@@ -147,6 +146,7 @@ function readMessage(msg, json, opts) {
             let extension = undefined;
             if (jsonKey.startsWith("[") &&
                 jsonKey.endsWith("]") &&
+                // biome-ignore lint/suspicious/noAssignInExpressions: no
                 (extension = (_a = opts.registry) === null || _a === void 0 ? void 0 : _a.getExtension(jsonKey.substring(1, jsonKey.length - 1))) &&
                 extension.extendee.typeName === msg.desc.typeName) {
                 const [container, field, get] = (0, extensions_js_1.createExtensionContainer)(extension);
@@ -276,7 +276,6 @@ function readEnum(desc, json, ignoreUnknownFields, nullAsZeroValue) {
         }
         return nullAsZeroValue ? desc.values[0].number : tokenNull;
     }
-    // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check
     switch (typeof json) {
         case "number":
             if (Number.isInteger(json)) {
@@ -305,7 +304,6 @@ function scalarFromJson(field, json, nullAsZeroValue) {
     }
     // int64, sfixed64, sint64, fixed64, uint64: Reflect supports string and number.
     // string, bool: Supported by reflect.
-    // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check
     switch (field.scalar) {
         // float, double: JSON value will be a number or one of the special string values "NaN", "Infinity", and "-Infinity".
         // Either numbers or strings are accepted. Exponent notation is also accepted.
@@ -318,11 +316,11 @@ function scalarFromJson(field, json, nullAsZeroValue) {
             if (json === "-Infinity")
                 return Number.NEGATIVE_INFINITY;
             if (typeof json == "number") {
-                if (isNaN(json)) {
+                if (Number.isNaN(json)) {
                     // NaN must be encoded with string constants
                     throw new error_js_1.FieldError(field, "unexpected NaN number");
                 }
-                if (!isFinite(json)) {
+                if (!Number.isFinite(json)) {
                     // Infinity must be encoded with string constants
                     throw new error_js_1.FieldError(field, "unexpected infinite number");
                 }
@@ -338,7 +336,7 @@ function scalarFromJson(field, json, nullAsZeroValue) {
                     break;
                 }
                 const float = Number(json);
-                if (!isFinite(float)) {
+                if (!Number.isFinite(float)) {
                     // Infinity and NaN must be encoded with string constants
                     break;
                 }
@@ -379,7 +377,6 @@ function scalarFromJson(field, json, nullAsZeroValue) {
 function mapKeyFromJson(type, json) {
     switch (type) {
         case descriptors_js_1.ScalarType.BOOL:
-            // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check
             switch (json) {
                 case "true":
                     return true;
@@ -497,11 +494,12 @@ function anyFromJson(any, json, opts) {
     const msg = (0, reflect_js_1.reflect)(desc);
     if (typeName.startsWith("google.protobuf.") &&
         Object.prototype.hasOwnProperty.call(json, "value")) {
-        const value = json["value"];
+        const value = json.value;
         readMessage(msg, value, opts);
     }
     else {
         const copy = Object.assign({}, json);
+        // biome-ignore lint/performance/noDelete: <explanation>
         delete copy["@type"];
         readMessage(msg, copy, opts);
     }
@@ -516,7 +514,7 @@ function timestampFromJson(timestamp, json) {
         throw new Error(`cannot decode message ${timestamp.$typeName} from JSON: invalid RFC 3339 string`);
     }
     const ms = Date.parse(
-    //prettier-ignore
+    // biome-ignore format: want this to read well
     matches[1] + "-" + matches[2] + "-" + matches[3] + "T" + matches[4] + ":" + matches[5] + ":" + matches[6] + (matches[8] ? matches[8] : "Z"));
     if (Number.isNaN(ms)) {
         throw new Error(`cannot decode message ${timestamp.$typeName} from JSON: invalid RFC 3339 string`);

package/dist/cjs/proto-int64.js

@@ -31,7 +31,10 @@ function makeInt64Support() {
             typeof process.env != "object" ||
             process.env.BUF_BIGINT_DISABLE !== "1");
     if (ok) {
-        const MIN = BigInt("-9223372036854775808"), MAX = BigInt("9223372036854775807"), UMIN = BigInt("0"), UMAX = BigInt("18446744073709551615");
+        const MIN = BigInt("-9223372036854775808");
+        const MAX = BigInt("9223372036854775807");
+        const UMIN = BigInt("0");
+        const UMAX = BigInt("18446744073709551615");
         return {
             zero: BigInt(0),
             supported: true,

package/dist/cjs/reflect/guard.js

@@ -38,7 +38,8 @@ function isReflectList(arg, field) {
         "field" in arg &&
         typeof arg.field == "function") {
         if (field !== undefined) {
-            const a = field, b = arg.field();
+            const a = field;
+            const b = arg.field();
             return (a.listKind == b.listKind &&
                 a.scalar === b.scalar &&
                 ((_a = a.message) === null || _a === void 0 ? void 0 : _a.typeName) === ((_b = b.message) === null || _b === void 0 ? void 0 : _b.typeName) &&

package/dist/cjs/reflect/index.d.ts

@@ -4,4 +4,5 @@ export * from "./nested-types.js";
 export * from "./reflect.js";
 export * from "./reflect-types.js";
 export * from "./scalar.js";
+export * from "./path.js";
 export { isReflectList, isReflectMap, isReflectMessage } from "./guard.js";

package/dist/cjs/reflect/index.js

@@ -34,6 +34,7 @@ __exportStar(require("./nested-types.js"), exports);
 __exportStar(require("./reflect.js"), exports);
 __exportStar(require("./reflect-types.js"), exports);
 __exportStar(require("./scalar.js"), exports);
+__exportStar(require("./path.js"), exports);
 var guard_js_1 = require("./guard.js");
 Object.defineProperty(exports, "isReflectList", { enumerable: true, get: function () { return guard_js_1.isReflectList; } });
 Object.defineProperty(exports, "isReflectMap", { enumerable: true, get: function () { return guard_js_1.isReflectMap; } });

package/dist/cjs/reflect/names.d.ts

@@ -1,3 +1,11 @@
+import type { AnyDesc } from "../descriptors.js";
+/**
+ * Return a fully-qualified name for a Protobuf descriptor.
+ * For a file descriptor, return the original file path.
+ *
+ * See https://protobuf.com/docs/language-spec#fully-qualified-names
+ */
+export declare function qualifiedName(desc: AnyDesc): string;
 /**
  * Converts snake_case to protoCamelCase according to the convention
  * used by protoc to convert a field name to a JSON name.

package/dist/cjs/reflect/names.js

@@ -13,8 +13,36 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.qualifiedName = qualifiedName;
 exports.protoCamelCase = protoCamelCase;
 exports.safeObjectProperty = safeObjectProperty;
+/**
+ * Return a fully-qualified name for a Protobuf descriptor.
+ * For a file descriptor, return the original file path.
+ *
+ * See https://protobuf.com/docs/language-spec#fully-qualified-names
+ */
+function qualifiedName(desc) {
+    switch (desc.kind) {
+        case "field":
+        case "oneof":
+        case "rpc":
+            return desc.parent.typeName + "." + desc.name;
+        case "enum_value": {
+            const p = desc.parent.parent
+                ? desc.parent.parent.typeName
+                : desc.parent.file.proto.package;
+            return p + (p.length > 0 ? "." : "") + desc.name;
+        }
+        case "service":
+        case "message":
+        case "enum":
+        case "extension":
+            return desc.typeName;
+        case "file":
+            return desc.proto.name;
+    }
+}
 /**
  * Converts snake_case to protoCamelCase according to the convention
  * used by protoc to convert a field name to a JSON name.

package/dist/cjs/reflect/nested-types.d.ts

@@ -4,6 +4,29 @@ import type { AnyDesc, DescEnum, DescExtension, DescFile, DescMessage, DescServi
  * and enumerations, extensions and messages nested in messages.
  */
 export declare function nestedTypes(desc: DescFile | DescMessage): Iterable<DescMessage | DescEnum | DescExtension | DescService>;
+/**
+ * Iterate over types referenced by fields of the given message.
+ *
+ * For example:
+ *
+ * ```proto
+ * syntax="proto3";
+ *
+ * message Example {
+ *   Msg singular = 1;
+ *   repeated Level list = 2;
+ * }
+ *
+ * message Msg {}
+ *
+ * enum Level {
+ *   LEVEL_UNSPECIFIED = 0;
+ * }
+ * ```
+ *
+ * The message Example references the message Msg, and the enum Level.
+ */
+export declare function usedTypes(descMessage: DescMessage): Iterable<DescMessage | DescEnum>;
 /**
  * Returns the ancestors of a given Protobuf element, up to the file.
  */

package/dist/cjs/reflect/nested-types.js

@@ -14,6 +14,7 @@
 // limitations under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.nestedTypes = nestedTypes;
+exports.usedTypes = usedTypes;
 exports.parentTypes = parentTypes;
 /**
  * Iterate over all types - enumerations, extensions, services, messages -
@@ -40,6 +41,45 @@ function* nestedTypes(desc) {
             break;
     }
 }
+/**
+ * Iterate over types referenced by fields of the given message.
+ *
+ * For example:
+ *
+ * ```proto
+ * syntax="proto3";
+ *
+ * message Example {
+ *   Msg singular = 1;
+ *   repeated Level list = 2;
+ * }
+ *
+ * message Msg {}
+ *
+ * enum Level {
+ *   LEVEL_UNSPECIFIED = 0;
+ * }
+ * ```
+ *
+ * The message Example references the message Msg, and the enum Level.
+ */
+function usedTypes(descMessage) {
+    return usedTypesInternal(descMessage, new Set());
+}
+function* usedTypesInternal(descMessage, seen) {
+    var _a, _b;
+    for (const field of descMessage.fields) {
+        const ref = (_b = (_a = field.enum) !== null && _a !== void 0 ? _a : field.message) !== null && _b !== void 0 ? _b : undefined;
+        if (!ref || seen.has(ref.typeName)) {
+            continue;
+        }
+        seen.add(ref.typeName);
+        yield ref;
+        if (ref.kind == "message") {
+            yield* usedTypesInternal(ref, seen);
+        }
+    }
+}
 /**
  * Returns the ancestors of a given Protobuf element, up to the file.
  */

package/dist/cjs/reflect/path.d.ts

@@ -0,0 +1,107 @@
+import { type DescExtension, type DescField, type DescMessage, type DescOneof } from "../descriptors.js";
+import type { Registry } from "../registry.js";
+/**
+ * A path to a (nested) member of a Protobuf message, such as a field, oneof,
+ * extension, list element, or map entry.
+ *
+ * Note that we may add additional types to this union in the future to support
+ * more use cases.
+ */
+export type Path = (DescField | DescExtension | DescOneof | {
+    kind: "list_sub";
+    index: number;
+} | {
+    kind: "map_sub";
+    key: string | number | bigint | boolean;
+})[];
+/**
+ * Builds a Path.
+ */
+export type PathBuilder = {
+    /**
+     * The root message of the path.
+     */
+    readonly schema: DescMessage;
+    /**
+     * Add field access.
+     *
+     * Throws an InvalidPathError if the field cannot be added to the path.
+     */
+    field(field: DescField): PathBuilder;
+    /**
+     * Access a oneof.
+     *
+     * Throws an InvalidPathError if the oneof cannot be added to the path.
+     *
+     */
+    oneof(oneof: DescOneof): PathBuilder;
+    /**
+     * Access an extension.
+     *
+     * Throws an InvalidPathError if the extension cannot be added to the path.
+     */
+    extension(extension: DescExtension): PathBuilder;
+    /**
+     * Access a list field by index.
+     *
+     * Throws an InvalidPathError if the list access cannot be added to the path.
+     */
+    list(index: number): PathBuilder;
+    /**
+     * Access a map field by key.
+     *
+     * Throws an InvalidPathError if the map access cannot be added to the path.
+     */
+    map(key: string | number | bigint | boolean): PathBuilder;
+    /**
+     * Append a path.
+     *
+     * Throws an InvalidPathError if the path cannot be added.
+     */
+    add(path: Path | PathBuilder): PathBuilder;
+    /**
+     * Return the path.
+     */
+    toPath(): Path;
+    /**
+     * Create a copy of this builder.
+     */
+    clone(): PathBuilder;
+    /**
+     * Get the current container - a list, map, or message.
+     */
+    getLeft(): DescMessage | (DescField & {
+        fieldKind: "list";
+    }) | (DescField & {
+        fieldKind: "map";
+    }) | undefined;
+};
+/**
+ * Create a PathBuilder.
+ */
+export declare function buildPath(schema: DescMessage): PathBuilder;
+/**
+ * Parse a Path from a string.
+ *
+ * Throws an InvalidPathError if the path is invalid.
+ *
+ * Note that a Registry must be provided via the options argument to parse
+ * paths that refer to an extension.
+ */
+export declare function parsePath(schema: DescMessage, path: string, options?: {
+    registry?: Registry;
+}): Path;
+/**
+ * Stringify a path.
+ */
+export declare function pathToString(path: Path): string;
+/**
+ * InvalidPathError is thrown for invalid Paths, for example during parsing from
+ * a string, or when a new Path is built.
+ */
+export declare class InvalidPathError extends Error {
+    name: string;
+    readonly schema: DescMessage;
+    readonly path: Path | string;
+    constructor(schema: DescMessage, message: string, path: string | Path);
+}