npm · #2314 most downloaded on npm

@bufbuild/protobuf

2.15.0bufbuild/protobuf-es ↗New releases in your daily digest, changelog included.

Protocol Buffers for ECMAScript. Fully compliant with the Protobuf conformance tests.

Last release 7 days ago
11 Sep 2026
Ships fairly regularly
a new release about every 4 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
79 releases · first in 2022

Release timeline

79 releases since 2022

20222023202420252026

20222026

One column per quarter.

Releases

0.4.05 Dec 2022
This release includes the following:
This release includes the following:

Enhancements

Add plugin option import_extension to replace the .js extension in import paths by @timostamm in #317

Improve JSON parse error message by @timostamm in #318

Make PlainMessage recursive by @smaye81 in #308

New Contributors

@McTano made their first contribution in #311
Open source →
0.3.023 Nov 2022
This release includes the following:
This release includes the following:

🚨 Breaking Changes 🚨

#296 - If you have been using PlainMessage or PartialMessage to create message types, you may need to change your code if you are using generics. For example:

-type WrapperFn<T extends Message> = ( msg: PartialMessage<T> ) => void; +type WrapperFn<T extends Message<T>> = ( msg: PartialMessage<T> ) => void;

Enhancements

Add a toJSON method to messages by @smaye81 in #306

Add an unpack function to google.protobuf.Any by @smaye81 in #303

Make generated imports look more normal by @dimitropoulos in #298 :warning: Note that as a result of this PR, import statements in your generated code will contain diffs when generated with v0.3.0 as the import statements will have spaces added. For example:
- import {FooMessage} from './foo_message_pb.js'; + import { FooMessage } from './foo_message_pb.js';

Add print function with tagged template literal by @yukukotani in #279

Enhance the Any.is function by @smaye81 in #294

Make wrappers more lenient by @timostamm in #291

Bugfixes

Fix map equality by @calebdoxsey in #305

Make tsNocheck work correctly by @yukukotani in #275

New Contributors

@calebdoxsey made their first contribution in #305 @yukukotani made their first contributions in #275 and #279

0.2.131 Oct 2022

This patch release fixes bug when parsing Any from JSON. Thanks to @fubhy for catching it.

This patch release fixes bug when parsing Any from JSON. Thanks to @fubhy for catching it.

Bugfixes

Fix error when parsing google.protobuf.Any field from JSON empty object by @timostamm in https://github.com/bufbuild/protobuf-es/pull/261

Enhancements

Expose helper WKT methods by @smaye81 in https://github.com/bufbuild/protobuf-es/pull/263

Open source →

0.2.025 Oct 2022

This release includes the following:

🚨 Breaking Changes 🚨

#233 - If you have been inspecting fields (DescField) from createDescriptorSet(), you will need to update your code to use the new fieldKind discriminator. The kind property no longer contains values such as map_field and message_field for their respective types of DescField. Instead, a new type has been added named fieldKind, which allows you to further identify the kind of field a DescField represents (map, enum, message, etc.)
#228 - If you have been using createEcmaScriptPlugin to create your own plugin, the signature has changed. Previously, the function accepted a single generator function for generating your output files. This has been split up into separate functions for TypeScript (generateTs), JavaScript (generateJs), and declaration files (generateDts). See the plugin docs for more information on usage.

Enhancements

Add plugin example for creating a Twirp client by @smaye81 #250
Export printable type by @fubhy #255
Extend documentation for PlainMessage and PartialMessage by @timostamm #248
Add convenience functions for retrieving custom options by @smaye81 #244
Clean up descriptor discrimination by @timostamm #233
Add a plugin option to keep empty files by @timostamm #229
Add the option to transpile target files by @smaye81 #228

Bugfixes

Fix TypeScript file generation bug by @smaye81 #253
Fix: arbitrary imports by @fubhy #254

New Contributors

@fubhy made their first contributions in #254 and #255.

Open source →

0.1.12 Sept 2022

Fix error message in proto2 binary format by @timostamm in #221.

Bug Fixes

Fix error message in proto2 binary format by @timostamm in #221.
Fix type prop issue in conditional exports by @smaye81 in #210. This adds support for TypeScript compiler option of moduleResolution: "NodeNext".

Documentation

Fix protoc option in protoc-gen-es/README.md by @timostamm in #223.
Add code generation examples to protoc-gen-es README.md by @timostamm in #207.

Open source →

0.1.024 Aug 2022

This release includes the following:

Enhancements

Add rewrite_imports plugin option by @timostamm in #204
Point to commonjs in main property by @smaye81 in #201
Update protobuf to version 21.5 by @smaye81 in #200

Bugfixes

Fix string-based fallback for 64-bit integral values by @timostamm in #202
Fix PlainMessage type to correctly omit functions by @smaye81 in #195
Fix createRegistryFromDescriptors() by @timostamm in #183

Open source →

0.0.1028 Jul 2022

Respect json_name in messages created from a descriptor set

This release fixes two bugs:

Respect json_name in messages created from a descriptor set (#171)
call process.exit only after write completes (#172)

Open source →

0.0.922 Jul 2022Breaking

This release switches the code generator from Golang to a TypeScript implementation. There are breaking changes in the generated code and in the refle…

This release switches the code generator from Golang to a TypeScript implementation. There are breaking changes in the generated code and in the reflection API.

New features

createDescriptorSet() provides a nice way to inspect a set of google.protobuf.FileDescriptorProto
@bufbuild/protoplugin provides an early version of an API to write your own code generator plugins in TypeScript

API changes

class TypeRegistry is deprecated. Please use createRegistry() instead.
class DescriptorRegistry has been replaced by createRegistryFromDescriptors(). The old version is still available as class LegacyDescriptorRegistry
class DescriptorSet has been replaced by createDescriptorSet(). The old version is still available as class LegacyDescriptorSet.
The signatures of makeEnum(), setEnumType() and makeEnumType() have changed slightly for improved enum value names.

Changes in the generated code

The code generator can no longer be installed via go.
The logic for stripping shared enum prefixes (see docs) has improved for some edge cases, and enum value names in those edge cases will differ.
There are other minor changes, but they are not breaking. See #159 for details.

Open source →

0.0.812 Jul 2022

This release fixes a compatibility issue with webpack v4 and below (https://github.com/bufbuild/protobuf-es/pull/138).

Open source →

0.0.724 Jun 2022

This release fixes a bug where transpilation of projects using @bufbuild/protobuf would error when using TypeScript target lower than ES2020, because

This release fixes a bug where transpilation of projects using @bufbuild/protobuf would error when using TypeScript target lower than ES2020, because we left a bigint literal in the source that did not need to be there.