@bufbuild/protobuf 2.10.2 → 2.12.0

package/dist/esm/wire/binary-encoding.d.ts

@@ -63,7 +63,7 @@ export declare class BinaryWriter {
     private readonly encodeUtf8;
     /**
      * We cannot allocate a buffer for the entire output
-     * because we don't know it's size.
+     * because we don't know its size.
      *
      * So we collect smaller chunks of known size and
      * concat them later.
@@ -120,7 +120,7 @@ export declare class BinaryWriter {
      */
     int32(value: number): this;
     /**
-     * Write a `bool` value, a variant.
+     * Write a `bool` value, a varint.
      */
     bool(value: boolean): this;
     /**
@@ -152,7 +152,7 @@ export declare class BinaryWriter {
      */
     sint32(value: number): this;
     /**
-     * Write a `fixed64` value, a signed, fixed-length 64-bit integer.
+     * Write a `sfixed64` value, a signed, fixed-length 64-bit integer.
      */
     sfixed64(value: string | number | bigint): this;
     /**
@@ -184,9 +184,10 @@ export declare class BinaryReader {
     readonly len: number;
     protected readonly buf: Uint8Array;
     private readonly view;
-    constructor(buf: Uint8Array, decodeUtf8?: (bytes: Uint8Array) => string);
+    constructor(buf: Uint8Array, decodeUtf8?: (bytes: Uint8Array, strict?: boolean) => string);
     /**
-     * Reads a tag - field number and wire type.
+     * Reads a tag - field number and wire type. Tags are uint32 varints; values
+     * that do not fit in uint32 are rejected.
      */
     tag(): [number, WireType];
     /**
@@ -258,7 +259,8 @@ export declare class BinaryReader {
      */
     bytes(): Uint8Array;
     /**
-     * Read a `string` field, length-delimited data converted to UTF-8 text.
+     * Read a `string` field, length-delimited data converted to UTF-8 text. If
+     * `strict` is true, throw on invalid UTF-8 instead of substituting U+FFFD.
      */
-    string(): string;
+    string(strict?: boolean): string;
 }

package/dist/esm/wire/binary-encoding.js

@@ -1,4 +1,4 @@
-// Copyright 2021-2025 Buf Technologies, Inc.
+// Copyright 2021-2026 Buf Technologies, Inc.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -178,7 +178,7 @@ export class BinaryWriter {
         return this;
     }
     /**
-     * Write a `bool` value, a variant.
+     * Write a `bool` value, a varint.
      */
     bool(value) {
         this.buf.push(value ? 1 : 0);
@@ -245,7 +245,7 @@ export class BinaryWriter {
         return this;
     }
     /**
-     * Write a `fixed64` value, a signed, fixed-length 64-bit integer.
+     * Write a `sfixed64` value, a signed, fixed-length 64-bit integer.
      */
     sfixed64(value) {
         let chunk = new Uint8Array(8), view = new DataView(chunk.buffer), tc = protoInt64.enc(value);
@@ -303,12 +303,21 @@ export class BinaryReader {
         this.view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
     }
     /**
-     * Reads a tag - field number and wire type.
+     * Reads a tag - field number and wire type. Tags are uint32 varints; values
+     * that do not fit in uint32 are rejected.
      */
     tag() {
-        let tag = this.uint32(), fieldNo = tag >>> 3, wireType = tag & 7;
-        if (fieldNo <= 0 || wireType < 0 || wireType > 5)
+        const start = this.pos;
+        const tag = this.uint32();
+        const bytesRead = this.pos - start;
+        if (bytesRead > 5 || (bytesRead == 5 && this.buf[this.pos - 1] > 0x0f)) {
+            throw new Error("illegal tag: varint overflows uint32");
+        }
+        const fieldNo = tag >>> 3;
+        const wireType = tag & 7;
+        if (fieldNo <= 0 || wireType > 5) {
             throw new Error("illegal tag: field no " + fieldNo + " wire type " + wireType);
+        }
         return [fieldNo, wireType];
     }
     /**
@@ -454,10 +463,11 @@ export class BinaryReader {
         return this.buf.subarray(start, start + len);
     }
     /**
-     * Read a `string` field, length-delimited data converted to UTF-8 text.
+     * Read a `string` field, length-delimited data converted to UTF-8 text. If
+     * `strict` is true, throw on invalid UTF-8 instead of substituting U+FFFD.
      */
-    string() {
-        return this.decodeUtf8(this.bytes());
+    string(strict) {
+        return this.decodeUtf8(this.bytes(), strict);
     }
 }
 /**

package/dist/esm/wire/index.js

@@ -1,4 +1,4 @@
-// Copyright 2021-2025 Buf Technologies, Inc.
+// Copyright 2021-2026 Buf Technologies, Inc.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/dist/esm/wire/size-delimited.js

@@ -1,4 +1,4 @@
-// Copyright 2021-2025 Buf Technologies, Inc.
+// Copyright 2021-2026 Buf Technologies, Inc.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/dist/esm/wire/text-encoding.d.ts

@@ -8,9 +8,11 @@ interface TextEncoding {
      */
     encodeUtf8: (text: string) => Uint8Array<ArrayBuffer>;
     /**
-     * Decode UTF-8 text from binary.
+     * Decode UTF-8 text from binary. If `strict` is true, throw on invalid byte
+     * sequences instead of silently substituting U+FFFD. Implementations that
+     * do not support strict decoding may ignore the flag.
      */
-    decodeUtf8: (bytes: Uint8Array) => string;
+    decodeUtf8: (bytes: Uint8Array, strict?: boolean) => string;
 }
 /**
  * Protobuf-ES requires the Text Encoding API to convert UTF-8 from and to

package/dist/esm/wire/text-encoding.js

@@ -1,4 +1,4 @@
-// Copyright 2021-2025 Buf Technologies, Inc.
+// Copyright 2021-2026 Buf Technologies, Inc.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -28,11 +28,18 @@ export function getTextEncoding() {
     if (globalThis[symbol] == undefined) {
         const te = new globalThis.TextEncoder();
         const td = new globalThis.TextDecoder();
+        let tdStrict;
         globalThis[symbol] = {
             encodeUtf8(text) {
                 return te.encode(text);
             },
-            decodeUtf8(bytes) {
+            decodeUtf8(bytes, strict) {
+                if (strict) {
+                    if (tdStrict === undefined) {
+                        tdStrict = new globalThis.TextDecoder("utf-8", { fatal: true });
+                    }
+                    return tdStrict.decode(bytes);
+                }
                 return td.decode(bytes);
             },
             checkUtf8(text) {

package/dist/esm/wire/text-format.js

@@ -1,4 +1,4 @@
-// Copyright 2021-2025 Buf Technologies, Inc.
+// Copyright 2021-2026 Buf Technologies, Inc.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/dist/esm/wkt/any.js

@@ -1,4 +1,4 @@
-// Copyright 2021-2025 Buf Technologies, Inc.
+// Copyright 2021-2026 Buf Technologies, Inc.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/dist/esm/wkt/duration.js

@@ -1,4 +1,4 @@
-// Copyright 2021-2025 Buf Technologies, Inc.
+// Copyright 2021-2026 Buf Technologies, Inc.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/dist/esm/wkt/gen/google/protobuf/any_pb.js

@@ -1,4 +1,4 @@
-// Copyright 2021-2025 Buf Technologies, Inc.
+// Copyright 2021-2026 Buf Technologies, Inc.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/dist/esm/wkt/gen/google/protobuf/api_pb.d.ts

@@ -75,7 +75,7 @@ export type Api = Message<"google.protobuf.Api"> & {
      *
      * @generated from field: google.protobuf.SourceContext source_context = 5;
      */
-    sourceContext?: SourceContext;
+    sourceContext?: SourceContext | undefined;
     /**
      * Included interfaces. See [Mixin][].
      *

package/dist/esm/wkt/gen/google/protobuf/api_pb.js

@@ -1,4 +1,4 @@
-// Copyright 2021-2025 Buf Technologies, Inc.
+// Copyright 2021-2026 Buf Technologies, Inc.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/dist/esm/wkt/gen/google/protobuf/compiler/plugin_pb.d.ts

@@ -121,7 +121,7 @@ export type CodeGeneratorRequest = Message<"google.protobuf.compiler.CodeGenerat
      *
      * @generated from field: optional google.protobuf.compiler.Version compiler_version = 3;
      */
-    compilerVersion?: Version;
+    compilerVersion?: Version | undefined;
 };
 /**
  * An encoded CodeGeneratorRequest is written to the plugin's stdin.
@@ -371,7 +371,7 @@ export type CodeGeneratorResponse_File = Message<"google.protobuf.compiler.CodeG
      *
      * @generated from field: optional google.protobuf.GeneratedCodeInfo generated_code_info = 16;
      */
-    generatedCodeInfo?: GeneratedCodeInfo;
+    generatedCodeInfo?: GeneratedCodeInfo | undefined;
 };
 /**
  * Represents a single generated file.

package/dist/esm/wkt/gen/google/protobuf/compiler/plugin_pb.js

@@ -1,4 +1,4 @@
-// Copyright 2021-2025 Buf Technologies, Inc.
+// Copyright 2021-2026 Buf Technologies, Inc.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/dist/esm/wkt/gen/google/protobuf/cpp_features_pb.js

@@ -1,4 +1,4 @@
-// Copyright 2021-2025 Buf Technologies, Inc.
+// Copyright 2021-2026 Buf Technologies, Inc.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/dist/esm/wkt/gen/google/protobuf/descriptor_pb.d.ts

@@ -100,7 +100,7 @@ export type FileDescriptorProto = Message<"google.protobuf.FileDescriptorProto">
     /**
      * @generated from field: optional google.protobuf.FileOptions options = 8;
      */
-    options?: FileOptions;
+    options?: FileOptions | undefined;
     /**
      * This field contains optional information about the original source code.
      * You may safely remove this entire field without harming runtime
@@ -109,7 +109,7 @@ export type FileDescriptorProto = Message<"google.protobuf.FileDescriptorProto">
      *
      * @generated from field: optional google.protobuf.SourceCodeInfo source_code_info = 9;
      */
-    sourceCodeInfo?: SourceCodeInfo;
+    sourceCodeInfo?: SourceCodeInfo | undefined;
     /**
      * The syntax of the proto file.
      * The supported values are "proto2", "proto3", and "editions".
@@ -273,7 +273,7 @@ export type DescriptorProto = Message<"google.protobuf.DescriptorProto"> & {
     /**
      * @generated from field: optional google.protobuf.MessageOptions options = 7;
      */
-    options?: MessageOptions;
+    options?: MessageOptions | undefined;
     /**
      * @generated from field: repeated google.protobuf.DescriptorProto.ReservedRange reserved_range = 9;
      */
@@ -374,7 +374,7 @@ export type DescriptorProto_ExtensionRange = Message<"google.protobuf.Descriptor
     /**
      * @generated from field: optional google.protobuf.ExtensionRangeOptions options = 3;
      */
-    options?: ExtensionRangeOptions;
+    options?: ExtensionRangeOptions | undefined;
 };
 /**
  * @generated from message google.protobuf.DescriptorProto.ExtensionRange
@@ -476,7 +476,7 @@ export type ExtensionRangeOptions = Message<"google.protobuf.ExtensionRangeOptio
      *
      * @generated from field: optional google.protobuf.FeatureSet features = 50;
      */
-    features?: FeatureSet;
+    features?: FeatureSet | undefined;
     /**
      * The verification state of the range.
      * TODO: flip the default to DECLARATION once all empty ranges
@@ -712,7 +712,7 @@ export type FieldDescriptorProto = Message<"google.protobuf.FieldDescriptorProto
     /**
      * @generated from field: optional google.protobuf.FieldOptions options = 8;
      */
-    options?: FieldOptions;
+    options?: FieldOptions | undefined;
     /**
      * If true, this is a proto3 "optional". When a proto3 field is optional, it
      * tracks presence regardless of field type.
@@ -997,7 +997,7 @@ export type OneofDescriptorProto = Message<"google.protobuf.OneofDescriptorProto
     /**
      * @generated from field: optional google.protobuf.OneofOptions options = 2;
      */
-    options?: OneofOptions;
+    options?: OneofOptions | undefined;
 };
 /**
  * Describes a oneof.
@@ -1038,7 +1038,7 @@ export type EnumDescriptorProto = Message<"google.protobuf.EnumDescriptorProto">
     /**
      * @generated from field: optional google.protobuf.EnumOptions options = 3;
      */
-    options?: EnumOptions;
+    options?: EnumOptions | undefined;
     /**
      * Range of reserved numeric values. Reserved numeric values may not be used
      * by enum values in the same enum declaration. Reserved ranges may not
@@ -1180,7 +1180,7 @@ export type EnumValueDescriptorProto = Message<"google.protobuf.EnumValueDescrip
     /**
      * @generated from field: optional google.protobuf.EnumValueOptions options = 3;
      */
-    options?: EnumValueOptions;
+    options?: EnumValueOptions | undefined;
 };
 /**
  * Describes a value within an enum.
@@ -1225,7 +1225,7 @@ export type ServiceDescriptorProto = Message<"google.protobuf.ServiceDescriptorP
     /**
      * @generated from field: optional google.protobuf.ServiceOptions options = 3;
      */
-    options?: ServiceOptions;
+    options?: ServiceOptions | undefined;
 };
 /**
  * Describes a service.
@@ -1277,7 +1277,7 @@ export type MethodDescriptorProto = Message<"google.protobuf.MethodDescriptorPro
     /**
      * @generated from field: optional google.protobuf.MethodOptions options = 4;
      */
-    options?: MethodOptions;
+    options?: MethodOptions | undefined;
     /**
      * Identifies if client streams multiple client messages
      *
@@ -1506,7 +1506,7 @@ export type FileOptions = Message<"google.protobuf.FileOptions"> & {
      *
      * @generated from field: optional google.protobuf.FeatureSet features = 50;
      */
-    features?: FeatureSet;
+    features?: FeatureSet | undefined;
     /**
      * The parser stores options it doesn't recognize here.
      * See the documentation for the "Options" section above.
@@ -1832,7 +1832,7 @@ export type MessageOptions = Message<"google.protobuf.MessageOptions"> & {
      *
      * @generated from field: optional google.protobuf.FeatureSet features = 12;
      */
-    features?: FeatureSet;
+    features?: FeatureSet | undefined;
     /**
      * The parser stores options it doesn't recognize here. See above.
      *
@@ -2072,11 +2072,11 @@ export type FieldOptions = Message<"google.protobuf.FieldOptions"> & {
      *
      * @generated from field: optional google.protobuf.FeatureSet features = 21;
      */
-    features?: FeatureSet;
+    features?: FeatureSet | undefined;
     /**
      * @generated from field: optional google.protobuf.FieldOptions.FeatureSupport feature_support = 22;
      */
-    featureSupport?: FieldOptions_FeatureSupport;
+    featureSupport?: FieldOptions_FeatureSupport | undefined;
     /**
      * The parser stores options it doesn't recognize here. See above.
      *
@@ -2299,6 +2299,13 @@ export type FieldOptions_FeatureSupport = Message<"google.protobuf.FieldOptions.
      * @generated from field: optional google.protobuf.Edition edition_removed = 4;
      */
     editionRemoved: Edition;
+    /**
+     * The removal error text if this feature is used after the edition it was
+     * removed in.
+     *
+     * @generated from field: optional string removal_error = 5;
+     */
+    removalError: string;
 };
 /**
  * Information about the support window of a feature.
@@ -2336,6 +2343,13 @@ export type FieldOptions_FeatureSupportJson = {
      * @generated from field: optional google.protobuf.Edition edition_removed = 4;
      */
     editionRemoved?: EditionJson;
+    /**
+     * The removal error text if this feature is used after the edition it was
+     * removed in.
+     *
+     * @generated from field: optional string removal_error = 5;
+     */
+    removalError?: string;
 };
 /**
  * Describes the message google.protobuf.FieldOptions.FeatureSupport.
@@ -2511,7 +2525,7 @@ export type OneofOptions = Message<"google.protobuf.OneofOptions"> & {
      *
      * @generated from field: optional google.protobuf.FeatureSet features = 1;
      */
-    features?: FeatureSet;
+    features?: FeatureSet | undefined;
     /**
      * The parser stores options it doesn't recognize here. See above.
      *
@@ -2586,7 +2600,7 @@ export type EnumOptions = Message<"google.protobuf.EnumOptions"> & {
      *
      * @generated from field: optional google.protobuf.FeatureSet features = 7;
      */
-    features?: FeatureSet;
+    features?: FeatureSet | undefined;
     /**
      * The parser stores options it doesn't recognize here. See above.
      *
@@ -2670,7 +2684,7 @@ export type EnumValueOptions = Message<"google.protobuf.EnumValueOptions"> & {
      *
      * @generated from field: optional google.protobuf.FeatureSet features = 2;
      */
-    features?: FeatureSet;
+    features?: FeatureSet | undefined;
     /**
      * Indicate that fields annotated with this enum value should not be printed
      * out when using debug formats, e.g. when the field contains sensitive
@@ -2684,7 +2698,7 @@ export type EnumValueOptions = Message<"google.protobuf.EnumValueOptions"> & {
      *
      * @generated from field: optional google.protobuf.FieldOptions.FeatureSupport feature_support = 4;
      */
-    featureSupport?: FieldOptions_FeatureSupport;
+    featureSupport?: FieldOptions_FeatureSupport | undefined;
     /**
      * The parser stores options it doesn't recognize here. See above.
      *
@@ -2754,7 +2768,7 @@ export type ServiceOptions = Message<"google.protobuf.ServiceOptions"> & {
      *
      * @generated from field: optional google.protobuf.FeatureSet features = 34;
      */
-    features?: FeatureSet;
+    features?: FeatureSet | undefined;
     /**
      * Is this service deprecated?
      * Depending on the target platform, this can emit Deprecated annotations
@@ -2832,7 +2846,7 @@ export type MethodOptions = Message<"google.protobuf.MethodOptions"> & {
      *
      * @generated from field: optional google.protobuf.FeatureSet features = 35;
      */
-    features?: FeatureSet;
+    features?: FeatureSet | undefined;
     /**
      * The parser stores options it doesn't recognize here. See above.
      *
@@ -3468,13 +3482,13 @@ export type FeatureSetDefaults_FeatureSetEditionDefault = Message<"google.protob
      *
      * @generated from field: optional google.protobuf.FeatureSet overridable_features = 4;
      */
-    overridableFeatures?: FeatureSet;
+    overridableFeatures?: FeatureSet | undefined;
     /**
      * Defaults of features that can't be overridden in this edition.
      *
      * @generated from field: optional google.protobuf.FeatureSet fixed_features = 5;
      */
-    fixedFeatures?: FeatureSet;
+    fixedFeatures?: FeatureSet | undefined;
 };
 /**
  * A map from every known edition with a unique set of defaults to its