npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

pbjs2typescript

v4.0.0

Published

Typescript definition generator for Protocol Buffer definitions

Downloads

2

Readme

Pbjs2TypeScript (Proto2TypeScript)

This tool generate TypeScript definitions for your Protocol Buffers models, when you use the excellent ProtoBuf.js library.

UPDATES -- Difference from aliok/Proto2TypeScript

This fork version:

  • Added support for *.proto and protobufjs (only) 6.x json format
  • Rewrote code in ES6 syntax
  • Separated data interface from Message class
export interface IAwesomeMessage {
  awesome_field: number;
}

export class AwesomeMessage extends protobuf.Message<AwesomeMessage> implements IAwesomeMessage {
  public awesome_field: number;
  ...
}
  • Removed -c, -u, -p options
  • Added --noCtor, --noCreate, --noCoding, --noInherit, --bytes options
    • --noCtor: Don't generate constructor
    • --noCreate, Don't generate create() method
    • --noCoding: Don't generate encode()/decode() methods
    • --noInherit: Don't inherit Message<T> class
    • --bytes: Set type name of "bytes" field. (default: Uint8Array)

UPDATES (aliok/Proto2TypeScript) -- Difference from the original

Original tool doesn't seem supported anymore.

My updates:

  • Made the package globally installable
  • Converted the tool code from Typescript to Javascript as the build process for NPM package with Typescript was not there at all
  • Fixed some bugs
  • Published on NPM

Also, the build process was a mess. I fixed those. But I don't even send a PR, because I changed a lot of stuff.


Installation

npm install pbjs2typescript -g

Usage

# Convert the model to TypeScript definitions
pbjs2typescript --file model.proto > model.d.ts

or,

# Parse and convert the proto file to json using pbjs (from ProtoBuf.js)
pbjs model.proto > model.json

# Convert the model to TypeScript definitions
pbjs2typescript --file model.json > model.d.ts

Options

Options:
  -f, --file              proto file or JSON file                             [required]
  --noCtor                Don't generate `constructor`                        [default: false]
  --noCreate              Don't generate `create()` method                    [default: false]
  --noCoding              Don't generate `encode()`/`decode()` methods        [default: false]
  --noInherit             Don't inherit `Message<T>` class                    [default: false]
  --bytes                 Set type name of "bytes" field.                     [default: Uint8Array]

Gulp

See https://github.com/aliok/websocket-protobufs-ts-experiments for Gulp integration.

Why ?

Because intelligent code completion is cool :-)

Requirements

It is a Node.js project. The sourcecode is written in TypeScript, but the JavaScript output is present in the repository.

If you want to run the tests, you need bash, mocha and typescript.

npm install mocha -g
npm install typescript -g

In order to run tests:

./runTests.sh

Changes

4.0

  • Added support for *.proto file (-f, --file options)
  • fixed property type name of interface
    • in interface, if type of property is "message", now correctly specifies the message interface name, not message class name
    • e.g.:
export interface IAwesomeMessage {
  awesome_field: ISubDoc; // type is interface ISubDoc
}

export class AwesomeMessage extends protobuf.Message<AwesomeMessage> implements IAwesomeMessage {
  public awesome_field: SubDoc; // type if class SubDoc
  ...
}

export interface ISubDoc {
  ...
}

export class SubDoc extends protobuf.Message<SubDoc> implements ISubDoc {
  ...
}
  • Removed -m, --moduleName options
  • Added --bytes option
    • --bytes: Set type name of "bytes" field. (default: Uint8Array)

3.0

  • Added support for protobufjs (only) 6.x json format
  • Rewrote code in ES6 syntax
  • Separated data interface from Message class
export interface IAwesomeMessage {
  awesome_field: number;
}

export class AwesomeMessage extends protobuf.Message<AwesomeMessage> implements IAwesomeMessage {
  public awesome_field: number;
  ...
}
  • Removed -c, -u, -p options
  • Added -m, --moduleName, --noCtor, --noCreate, --noCoding, --noInherit options
    • -m, --moduleName: Set top level module name
    • --noCtor: Don't generate constructor
    • --noCreate, Don't generate create() method
    • --noCoding: Don't generate encode()/decode() methods
    • --noInherit: Don't inherit Message<T> class

Acknowledgements

This code is developed in context of the BRIDGE project.

Licence

The source code of this tool is licenced under the MIT License.