@bufbuild/protoc-gen-es - npm Package Compare versions

Comparing version 0.1.0 to 0.1.1

dist/cjs/package.json

 {
     "name": "@bufbuild/protoc-gen-es",
-    "version": "0.1.0",
+    "version": "0.1.1",
     "description": "Protocol Buffers code generator for ECMAScript",
@@ -23,6 +23,6 @@ "license": "Apache-2.0",
     "dependencies": {
-        "@bufbuild/protoplugin": "0.1.0"
+        "@bufbuild/protoplugin": "0.1.1"
     },
     "peerDependencies": {
-        "@bufbuild/protobuf": "0.1.0"
+        "@bufbuild/protobuf": "0.1.1"
     },
@@ -29,0 +29,0 @@ "peerDependenciesMeta": {

package.json

 {
   "name": "@bufbuild/protoc-gen-es",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Protocol Buffers code generator for ECMAScript",
@@ -23,6 +23,6 @@ "license": "Apache-2.0",
   "dependencies": {
-    "@bufbuild/protoplugin": "0.1.0"
+    "@bufbuild/protoplugin": "0.1.1"
   },
   "peerDependencies": {
-    "@bufbuild/protobuf": "0.1.0"
+    "@bufbuild/protobuf": "0.1.1"
   },
@@ -29,0 +29,0 @@ "peerDependenciesMeta": {

README.md

 # @bufbuild/protoc-gen-es
 
-This package provides the code generator plugin `protoc-gen-es`. The code it 
-generates depends on [@bufbuild/protobuf](https://www.npmjs.com/package/@bufbuild/protobuf).
+The code generator for Protocol Buffers for ECMAScript. For example, the 
+following definition:
 
-## Protocol Buffers for ECMAScript
-
-A complete implementation of [Protocol Buffers](https://developers.google.com/protocol-buffers) 
-in TypeScript, suitable for web browsers and Node.js.  
-
-For example, the following definition:
-
 ```protobuf
@@ -34,3 +27,3 @@ message Person {
 
-Learn more at [github.com/bufbuild/protobuf-es](https://github.com/bufbuild/protobuf-es).
+Learn more about the project at [github.com/bufbuild/protobuf-es](https://github.com/bufbuild/protobuf-es).
 
@@ -40,31 +33,78 @@
 
-### With npm
+`protoc-gen-es` is a code generator plugin for Protocol Buffer compilers,
+like [buf](https://github.com/bufbuild/buf) and [protoc](https://github.com/protocolbuffers/protobuf/releases).
+It generates base types - messages and enumerations - from your Protocol Buffer 
+schema. The generated code requires the runtime library [@bufbuild/protobuf](https://www.npmjs.com/package/@bufbuild/protobuf).
 
+To install the plugin and the runtime library, run:
+
 ```shell
-npm install @bufbuild/protoc-gen-es
+npm install --save-dev @bufbuild/protoc-gen-es
+npm install @bufbuild/protobuf
 ```
 
-This will install the code generator plugin in `node_modules/.bin/protoc-gen-es`. 
-Note that npm does not add the executable to your `$PATH`. You can do so with:
+We use peer dependencies to ensure that code generator and runtime library are
+compatible with each other. Note that yarn and pnpm only emit a warning in this case.
 
-```shell
-PATH=$PATH:$(pwd)/node_modules/.bin
+
+## Generating code
+
+### With buf
+
+Add a new configuration file `buf.gen.yaml`:
+
+```yaml
+# buf.gen.yaml defines a local generation template.
+# For details, see https://docs.buf.build/configuration/v1/buf-gen-yaml
+version: v1
+plugins:
+  # This will invoke protoc-gen-es and write output to src/gen
+  - name: es
+    out: src/gen
+    opt: target=ts
 ```
 
-### With yarn
+Add the following script to your `package.json`:
 
-```shell
-yarn add @bufbuild/protoc-gen-es
+```json
+{
+  "name": "your-package",
+  "version": "1.0.0",
+  "scripts": {
+    "generate": "buf generate"
+  },
+  // ...
+}
 ```
 
-Note that yarn v2 does not use a `node_modules` directory anymore. To find the path 
-where yarn stores the executable, run `yarn bin protoc-gen-es` (it is "unplugged" 
-automatically).
+To generate code for all protobuf files within your project, simply run:
 
-You can always confirm successful installation with:
-```shell
-protoc-gen-es --version
+```bash
+npm run generate
 ```
 
+Note that `buf` can generate from various [inputs](https://docs.buf.build/reference/inputs),
+not just local protobuf files. 
 
+
+### With protoc
+
+```bash
+PATH=$PATH:$(pwd)/node_modules/.bin \
+  protoc -I . \
+  --es_out src/gen \
+  --es_opt target=ts \
+  a.proto b.proto c.proto
+```
+
+Note that we are adding `node_modules/.bin` to the `$PATH`, so that the protocol
+buffer compiler can find them. This happens automatically with npm scripts.
+
+Since yarn v2 and above does not use a `node_modules` directory, you need to 
+change the variable a bit:
+
+```bash
+PATH=$(dirname $(yarn bin protoc-gen-es)):$PATH
+```
+
 ## Plugin options
@@ -74,3 +114,3 @@
 
-This option controls whether the plugin generates JavaScript, TypeScript, 
+This option controls whether the plugin generates JavaScript, TypeScript,
 or TypeScript declaration files.
@@ -77,0 +117,0 @@

Fixed alerts

New author

Supply chain risk

A new npm collaborator published a version of the package for the first time. New collaborators are usually benign additions to a project, but do indicate a change to the security surface area of a package.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

153357

increased by0.68%

Number of lines in readme file

127

increased by45.98%

Number of medium supply chain risk alerts

0

decreased by-100%

Dependency changes

• + Added@bufbuild/protobuf@0.1.1(transitive)

• + Added@bufbuild/protoplugin@0.1.1(transitive)

• - Removed@bufbuild/protobuf@0.1.0(transitive)

• - Removed@bufbuild/protoplugin@0.1.0(transitive)

• Updated@bufbuild/protoplugin@0.1.1