@bufbuild/protobuf 1.9.0 → 2.0.0-alpha.2

package/dist/cjs/clone.d.ts

@@ -0,0 +1,6 @@
+import type { MessageShape } from "./types.js";
+import type { DescMessage } from "./desc-types.js";
+/**
+ * Create a deep copy of a message, including extensions and unknown fields.
+ */
+export declare function clone<Desc extends DescMessage>(messageDesc: Desc, message: MessageShape<Desc>): MessageShape<Desc>;

package/dist/cjs/clone.js

@@ -0,0 +1,77 @@
+"use strict";
+// Copyright 2021-2024 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.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clone = void 0;
+const reflect_js_1 = require("./reflect/reflect.js");
+const guard_js_1 = require("./reflect/guard.js");
+const scalar_js_1 = require("./reflect/scalar.js");
+/**
+ * Create a deep copy of a message, including extensions and unknown fields.
+ */
+function clone(messageDesc, message) {
+    return cloneReflect((0, reflect_js_1.reflect)(messageDesc, message))
+        .message;
+}
+exports.clone = clone;
+function cloneReflect(i) {
+    const o = (0, reflect_js_1.reflect)(i.desc);
+    for (const f of i.fields) {
+        if (!i.isSet(f)) {
+            continue;
+        }
+        switch (f.fieldKind) {
+            default: {
+                const err = o.set(f, cloneSingular(f, i.get(f)));
+                if (err) {
+                    throw err;
+                }
+                break;
+            }
+            case "list":
+                for (const item of i.get(f)) {
+                    // TODO fix type error
+                    // @ts-expect-error TODO
+                    const err = o.addListItem(f, cloneSingular(f, item));
+                    if (err) {
+                        throw err;
+                    }
+                }
+                break;
+            case "map":
+                for (const entry of i.get(f).entries()) {
+                    const err = o.setMapEntry(f, entry[0], cloneSingular(f, entry[1]));
+                    if (err) {
+                        throw err;
+                    }
+                }
+                break;
+        }
+    }
+    const unknown = i.getUnknown();
+    if (unknown && unknown.length > 0) {
+        o.setUnknown([...unknown]);
+    }
+    return o;
+}
+function cloneSingular(field, value) {
+    if (field.message !== undefined && (0, guard_js_1.isReflectMessage)(value)) {
+        return cloneReflect(value);
+    }
+    if (field.scalar == scalar_js_1.ScalarType.BYTES && value instanceof Uint8Array) {
+        // @ts-expect-error T cannot extend Uint8Array in practice
+        return value.slice();
+    }
+    return value;
+}

package/dist/cjs/codegenv1/boot.d.ts

@@ -0,0 +1,63 @@
+import type { DescriptorProto_ExtensionRange, FieldDescriptorProto_Label, FieldDescriptorProto_Type, FieldOptions_OptionRetention, FieldOptions_OptionTargetType, FieldOptions_EditionDefault, EnumValueDescriptorProto, FileDescriptorProto } from "../wkt/gen/google/protobuf/descriptor_pb.js";
+import type { DescFile } from "../desc-types.js";
+/**
+ * Hydrate a file descriptor for google/protobuf/descriptor.proto from a plain
+ * object.
+ *
+ * See createFileDescriptorProtoBoot() for details.
+ *
+ * @private
+ */
+export declare function boot(boot: FileDescriptorProtoBoot): DescFile;
+/**
+ * An object literal for initializing the message google.protobuf.FileDescriptorProto
+ * for google/protobuf/descriptor.proto.
+ *
+ * See createFileDescriptorProtoBoot() for details.
+ *
+ * @private
+ */
+export type FileDescriptorProtoBoot = {
+    name: "google/protobuf/descriptor.proto";
+    package: "google.protobuf";
+    messageType: DescriptorProtoBoot[];
+    enumType: EnumDescriptorProtoBoot[];
+};
+export type DescriptorProtoBoot = {
+    name: string;
+    field?: FieldDescriptorProtoBoot[];
+    nestedType?: DescriptorProtoBoot[];
+    enumType?: EnumDescriptorProtoBoot[];
+    extensionRange?: Pick<DescriptorProto_ExtensionRange, "start" | "end">[];
+};
+export type FieldDescriptorProtoBoot = {
+    name: string;
+    number: number;
+    label?: FieldDescriptorProto_Label;
+    type: FieldDescriptorProto_Type;
+    typeName?: string;
+    extendee?: string;
+    defaultValue?: string;
+    options?: FieldOptionsBoot;
+};
+export type FieldOptionsBoot = {
+    packed?: boolean;
+    deprecated?: boolean;
+    retention?: FieldOptions_OptionRetention;
+    targets?: FieldOptions_OptionTargetType[];
+    editionDefaults?: FieldOptions_EditionDefaultBoot[];
+};
+export type FieldOptions_EditionDefaultBoot = Pick<FieldOptions_EditionDefault, "edition" | "value">;
+export type EnumDescriptorProtoBoot = {
+    name: string;
+    value: EnumValueDescriptorProtoBoot[];
+};
+export type EnumValueDescriptorProtoBoot = Pick<EnumValueDescriptorProto, "name" | "number">;
+/**
+ * Creates the message google.protobuf.FileDescriptorProto from an object literal.
+ *
+ * See createFileDescriptorProtoBoot() for details.
+ *
+ * @private
+ */
+export declare function bootFileDescriptorProto(init: FileDescriptorProtoBoot): FileDescriptorProto;

package/dist/cjs/codegenv1/boot.js

@@ -0,0 +1,102 @@
+"use strict";
+// Copyright 2021-2024 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.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bootFileDescriptorProto = exports.boot = void 0;
+const restore_json_names_js_1 = require("./restore-json-names.js");
+const registry_js_1 = require("../reflect/registry.js");
+const assert_js_1 = require("../reflect/assert.js");
+/**
+ * Hydrate a file descriptor for google/protobuf/descriptor.proto from a plain
+ * object.
+ *
+ * See createFileDescriptorProtoBoot() for details.
+ *
+ * @private
+ */
+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);
+    const file = reg.getFile(root.name);
+    (0, assert_js_1.assert)(file);
+    return file;
+}
+exports.boot = boot;
+/**
+ * Creates the message google.protobuf.FileDescriptorProto from an object literal.
+ *
+ * See createFileDescriptorProtoBoot() for details.
+ *
+ * @private
+ */
+function bootFileDescriptorProto(init) {
+    const proto = Object.create({
+        syntax: "",
+        edition: 0,
+    });
+    return Object.assign(proto, Object.assign(Object.assign({ $typeName: "google.protobuf.FileDescriptorProto", dependency: [], publicDependency: [], weakDependency: [], service: [], extension: [] }, init), { messageType: init.messageType.map(bootDescriptorProto), enumType: init.enumType.map(bootEnumDescriptorProto) }));
+}
+exports.bootFileDescriptorProto = bootFileDescriptorProto;
+function bootDescriptorProto(init) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    return {
+        $typeName: "google.protobuf.DescriptorProto",
+        name: init.name,
+        field: (_b = (_a = init.field) === null || _a === void 0 ? void 0 : _a.map(bootFieldDescriptorProto)) !== null && _b !== void 0 ? _b : [],
+        extension: [],
+        nestedType: (_d = (_c = init.nestedType) === null || _c === void 0 ? void 0 : _c.map(bootDescriptorProto)) !== null && _d !== void 0 ? _d : [],
+        enumType: (_f = (_e = init.enumType) === null || _e === void 0 ? void 0 : _e.map(bootEnumDescriptorProto)) !== null && _f !== void 0 ? _f : [],
+        extensionRange: (_h = (_g = init.extensionRange) === null || _g === void 0 ? void 0 : _g.map((e) => (Object.assign({ $typeName: "google.protobuf.DescriptorProto.ExtensionRange" }, e)))) !== null && _h !== void 0 ? _h : [],
+        oneofDecl: [],
+        reservedRange: [],
+        reservedName: [],
+    };
+}
+function bootFieldDescriptorProto(init) {
+    const proto = Object.create({
+        label: 1,
+        typeName: "",
+        extendee: "",
+        defaultValue: "",
+        oneofIndex: 0,
+        jsonName: "",
+        proto3Optional: false,
+    });
+    return Object.assign(proto, Object.assign(Object.assign({ $typeName: "google.protobuf.FieldDescriptorProto" }, init), { options: init.options ? bootFieldOptions(init.options) : undefined }));
+}
+function bootFieldOptions(init) {
+    var _a, _b, _c;
+    const proto = Object.create({
+        ctype: 0,
+        packed: false,
+        jstype: 0,
+        lazy: false,
+        unverifiedLazy: false,
+        deprecated: false,
+        weak: false,
+        debugRedact: false,
+        retention: 0,
+    });
+    return Object.assign(proto, Object.assign(Object.assign({ $typeName: "google.protobuf.FieldOptions" }, init), { targets: (_a = init.targets) !== null && _a !== void 0 ? _a : [], editionDefaults: (_c = (_b = init.editionDefaults) === null || _b === void 0 ? void 0 : _b.map((e) => (Object.assign({ $typeName: "google.protobuf.FieldOptions.EditionDefault" }, e)))) !== null && _c !== void 0 ? _c : [], uninterpretedOption: [] }));
+}
+function bootEnumDescriptorProto(init) {
+    return {
+        $typeName: "google.protobuf.EnumDescriptorProto",
+        name: init.name,
+        reservedName: [],
+        reservedRange: [],
+        value: init.value.map((e) => (Object.assign({ $typeName: "google.protobuf.EnumValueDescriptorProto" }, e))),
+    };
+}

package/dist/cjs/codegenv1/embed.d.ts

@@ -0,0 +1,43 @@
+import type { DescEnum, DescExtension, DescMessage, DescService } from "../desc-types.js";
+import type { FileDescriptorProto } from "../wkt/gen/google/protobuf/descriptor_pb.js";
+import type { FileDescriptorProtoBoot } from "./boot.js";
+type EmbedUnknown = {
+    bootable: false;
+    proto(): FileDescriptorProto;
+    base64(): string;
+};
+type EmbedDescriptorProto = Omit<EmbedUnknown, "bootable"> & {
+    bootable: true;
+    boot(): FileDescriptorProtoBoot;
+};
+/**
+ * Create necessary information to embed a file descriptor in
+ * generated code.
+ *
+ * @private
+ */
+export declare function embedFileDesc(file: FileDescriptorProto): EmbedUnknown | EmbedDescriptorProto;
+/**
+ * Compute the path to a message, enumeration, extension, or service in a
+ * file descriptor.
+ *
+ * @private
+ */
+export declare function pathInFileDesc(desc: DescMessage | DescEnum | DescExtension | DescService): number[];
+/**
+ * The file descriptor for google/protobuf/descriptor.proto cannot be embedded
+ * in serialized form, since it is required to parse itself.
+ *
+ * This function takes an instance of the message, and returns a plain object
+ * that can be hydrated to the message again via bootFileDescriptorProto().
+ *
+ * This function only works with a message google.protobuf.FileDescriptorProto
+ * for google/protobuf/descriptor.proto, and only supports features that are
+ * relevant for the specific use case. For example, it discards file options,
+ * reserved ranges and reserved names, and field options that are unused in
+ * descriptor.proto.
+ *
+ * @private
+ */
+export declare function createFileDescriptorProtoBoot(proto: FileDescriptorProto): FileDescriptorProtoBoot;
+export {};

package/dist/cjs/codegenv1/embed.js

@@ -0,0 +1,238 @@
+"use strict";
+// Copyright 2021-2024 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.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFileDescriptorProtoBoot = exports.pathInFileDesc = exports.embedFileDesc = void 0;
+const names_js_1 = require("../reflect/names.js");
+const assert_js_1 = require("../reflect/assert.js");
+const fields_js_1 = require("../fields.js");
+const base64_encoding_js_1 = require("../wire/base64-encoding.js");
+const to_binary_js_1 = require("../to-binary.js");
+const clone_js_1 = require("../clone.js");
+const descriptor_pb_js_1 = require("../wkt/gen/google/protobuf/descriptor_pb.js");
+/**
+ * Create necessary information to embed a file descriptor in
+ * generated code.
+ *
+ * @private
+ */
+function embedFileDesc(file) {
+    const embed = {
+        bootable: false,
+        proto() {
+            const stripped = (0, clone_js_1.clone)(descriptor_pb_js_1.FileDescriptorProtoDesc, file);
+            (0, fields_js_1.clearField)(stripped, descriptor_pb_js_1.FileDescriptorProtoDesc.field.dependency);
+            (0, fields_js_1.clearField)(stripped, descriptor_pb_js_1.FileDescriptorProtoDesc.field.sourceCodeInfo);
+            stripped.messageType.map(stripJsonNames);
+            return stripped;
+        },
+        base64() {
+            const bytes = (0, to_binary_js_1.toBinary)(descriptor_pb_js_1.FileDescriptorProtoDesc, this.proto());
+            return (0, base64_encoding_js_1.base64Encode)(bytes, "std_raw");
+        },
+    };
+    return file.name == "google/protobuf/descriptor.proto"
+        ? Object.assign(Object.assign({}, embed), { bootable: true, boot() {
+                return createFileDescriptorProtoBoot(this.proto());
+            } }) : embed;
+}
+exports.embedFileDesc = embedFileDesc;
+function stripJsonNames(d) {
+    for (const f of d.field) {
+        if (f.jsonName === (0, names_js_1.protoCamelCase)(f.name)) {
+            (0, fields_js_1.clearField)(f, descriptor_pb_js_1.FieldDescriptorProtoDesc.field.jsonName);
+        }
+    }
+    for (const n of d.nestedType) {
+        stripJsonNames(n);
+    }
+}
+/**
+ * Compute the path to a message, enumeration, extension, or service in a
+ * file descriptor.
+ *
+ * @private
+ */
+function pathInFileDesc(desc) {
+    if (desc.kind == "service") {
+        return [desc.file.services.indexOf(desc)];
+    }
+    const parent = desc.parent;
+    if (parent == undefined) {
+        switch (desc.kind) {
+            case "enum":
+                return [desc.file.enums.indexOf(desc)];
+            case "message":
+                return [desc.file.messages.indexOf(desc)];
+            case "extension":
+                return [desc.file.extensions.indexOf(desc)];
+        }
+    }
+    function findPath(cur) {
+        const nested = [];
+        for (let parent = cur.parent; parent;) {
+            const idx = parent.nestedMessages.indexOf(cur);
+            nested.unshift(idx);
+            cur = parent;
+            parent = cur.parent;
+        }
+        nested.unshift(cur.file.messages.indexOf(cur));
+        return nested;
+    }
+    const path = findPath(parent);
+    switch (desc.kind) {
+        case "extension":
+            return [...path, parent.nestedExtensions.indexOf(desc)];
+        case "message":
+            return [...path, parent.nestedMessages.indexOf(desc)];
+        case "enum":
+            return [...path, parent.nestedEnums.indexOf(desc)];
+    }
+}
+exports.pathInFileDesc = pathInFileDesc;
+/**
+ * The file descriptor for google/protobuf/descriptor.proto cannot be embedded
+ * in serialized form, since it is required to parse itself.
+ *
+ * This function takes an instance of the message, and returns a plain object
+ * that can be hydrated to the message again via bootFileDescriptorProto().
+ *
+ * This function only works with a message google.protobuf.FileDescriptorProto
+ * for google/protobuf/descriptor.proto, and only supports features that are
+ * relevant for the specific use case. For example, it discards file options,
+ * reserved ranges and reserved names, and field options that are unused in
+ * descriptor.proto.
+ *
+ * @private
+ */
+function createFileDescriptorProtoBoot(proto) {
+    var _a;
+    (0, assert_js_1.assert)(proto.name == "google/protobuf/descriptor.proto");
+    (0, assert_js_1.assert)(proto.package == "google.protobuf");
+    (0, assert_js_1.assert)(!proto.dependency.length);
+    (0, assert_js_1.assert)(!proto.publicDependency.length);
+    (0, assert_js_1.assert)(!proto.weakDependency.length);
+    (0, assert_js_1.assert)(!proto.service.length);
+    (0, assert_js_1.assert)(!proto.extension.length);
+    (0, assert_js_1.assert)(proto.sourceCodeInfo === undefined);
+    (0, assert_js_1.assert)(proto.syntax == "" || proto.syntax == "proto2");
+    (0, assert_js_1.assert)(!((_a = proto.options) === null || _a === void 0 ? void 0 : _a.features)); // we're dropping file options
+    (0, assert_js_1.assert)(proto.edition === descriptor_pb_js_1.Edition.EDITION_UNKNOWN);
+    return {
+        name: proto.name,
+        package: proto.package,
+        messageType: proto.messageType.map(createDescriptorBoot),
+        enumType: proto.enumType.map(createEnumDescriptorBoot),
+    };
+}
+exports.createFileDescriptorProtoBoot = createFileDescriptorProtoBoot;
+function createDescriptorBoot(proto) {
+    (0, assert_js_1.assert)(proto.extension.length == 0);
+    (0, assert_js_1.assert)(!proto.oneofDecl.length);
+    (0, assert_js_1.assert)(!proto.options);
+    (0, assert_js_1.assert)(!proto.reservedName.length); // we're also dropping reserved_range
+    const b = {
+        name: proto.name,
+    };
+    if (proto.field.length) {
+        b.field = proto.field.map(createFieldDescriptorBoot);
+    }
+    if (proto.nestedType.length) {
+        b.nestedType = proto.nestedType.map(createDescriptorBoot);
+    }
+    if (proto.enumType.length) {
+        b.enumType = proto.enumType.map(createEnumDescriptorBoot);
+    }
+    if (proto.extensionRange.length) {
+        b.extensionRange = proto.extensionRange.map((r) => {
+            (0, assert_js_1.assert)(!r.options);
+            return { start: r.start, end: r.end };
+        });
+    }
+    return b;
+}
+function createFieldDescriptorBoot(proto) {
+    (0, assert_js_1.assert)((0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldDescriptorProtoDesc.field.name));
+    (0, assert_js_1.assert)((0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldDescriptorProtoDesc.field.number));
+    (0, assert_js_1.assert)((0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldDescriptorProtoDesc.field.type));
+    (0, assert_js_1.assert)(!(0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldDescriptorProtoDesc.field.oneofIndex));
+    (0, assert_js_1.assert)(!(0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldDescriptorProtoDesc.field.jsonName) ||
+        proto.jsonName === (0, names_js_1.protoCamelCase)(proto.name));
+    const b = {
+        name: proto.name,
+        number: proto.number,
+        type: proto.type,
+    };
+    if ((0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldDescriptorProtoDesc.field.label)) {
+        b.label = proto.label;
+    }
+    if ((0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldDescriptorProtoDesc.field.typeName)) {
+        b.typeName = proto.typeName;
+    }
+    if ((0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldDescriptorProtoDesc.field.extendee)) {
+        b.extendee = proto.extendee;
+    }
+    if ((0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldDescriptorProtoDesc.field.defaultValue)) {
+        b.defaultValue = proto.defaultValue;
+    }
+    if (proto.options) {
+        b.options = createFieldOptionsBoot(proto.options);
+    }
+    return b;
+}
+function createFieldOptionsBoot(proto) {
+    const b = {};
+    (0, assert_js_1.assert)(!(0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldOptionsDesc.field.ctype));
+    if ((0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldOptionsDesc.field.packed)) {
+        b.packed = proto.packed;
+    }
+    (0, assert_js_1.assert)(!(0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldOptionsDesc.field.jstype));
+    (0, assert_js_1.assert)(!(0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldOptionsDesc.field.lazy));
+    (0, assert_js_1.assert)(!(0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldOptionsDesc.field.unverifiedLazy));
+    if ((0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldOptionsDesc.field.deprecated)) {
+        b.deprecated = proto.deprecated;
+    }
+    (0, assert_js_1.assert)(!(0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldOptionsDesc.field.weak));
+    (0, assert_js_1.assert)(!(0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldOptionsDesc.field.debugRedact));
+    if ((0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldOptionsDesc.field.retention)) {
+        b.retention = proto.retention;
+    }
+    if (proto.targets.length) {
+        b.targets = proto.targets;
+    }
+    if (proto.editionDefaults.length) {
+        b.editionDefaults = proto.editionDefaults.map((d) => ({
+            value: d.value,
+            edition: d.edition,
+        }));
+    }
+    (0, assert_js_1.assert)(!(0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldOptionsDesc.field.features));
+    (0, assert_js_1.assert)(!(0, fields_js_1.isFieldSet)(proto, descriptor_pb_js_1.FieldOptionsDesc.field.uninterpretedOption));
+    return b;
+}
+function createEnumDescriptorBoot(proto) {
+    (0, assert_js_1.assert)(!proto.reservedName.length);
+    (0, assert_js_1.assert)(!proto.reservedRange.length);
+    (0, assert_js_1.assert)(!proto.options);
+    return {
+        name: proto.name,
+        value: proto.value.map((v) => {
+            (0, assert_js_1.assert)(!v.options);
+            return {
+                name: v.name,
+                number: v.number,
+            };
+        }),
+    };
+}

package/dist/cjs/codegenv1/enum.d.ts

@@ -0,0 +1,17 @@
+import type { DescEnum, DescFile } from "../desc-types.js";
+import type { GenDescEnum } from "./types.js";
+/**
+ * Hydrate an enum descriptor.
+ *
+ * @private
+ */
+export declare function enumDesc<Shape>(file: DescFile, path: number, ...paths: number[]): GenDescEnum<Shape>;
+/**
+ * Construct a TypeScript enum object at runtime from a descriptor.
+ */
+export declare function tsEnum(desc: DescEnum): enumObject;
+type enumObject = {
+    [key: number]: string;
+    [k: string]: number | string;
+};
+export {};

package/dist/cjs/codegenv1/enum.js

@@ -0,0 +1,41 @@
+"use strict";
+// Copyright 2021-2024 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.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tsEnum = exports.enumDesc = void 0;
+/**
+ * Hydrate an enum descriptor.
+ *
+ * @private
+ */
+function enumDesc(file, path, ...paths) {
+    if (paths.length == 0) {
+        return file.enums[path];
+    }
+    const e = paths.pop(); // we checked length above
+    return paths.reduce((acc, cur) => acc.nestedMessages[cur], file.messages[path]).nestedEnums[e];
+}
+exports.enumDesc = enumDesc;
+/**
+ * Construct a TypeScript enum object at runtime from a descriptor.
+ */
+function tsEnum(desc) {
+    const enumObject = {};
+    for (const value of desc.values) {
+        enumObject[value.localName] = value.number;
+        enumObject[value.number] = value.localName;
+    }
+    return enumObject;
+}
+exports.tsEnum = tsEnum;

package/dist/cjs/codegenv1/extension.d.ts

@@ -0,0 +1,9 @@
+import type { Message } from "../types.js";
+import type { DescFile } from "../desc-types.js";
+import type { GenDescExtension } from "./types.js";
+/**
+ * Hydrate an extension descriptor.
+ *
+ * @private
+ */
+export declare function extDesc<Extendee extends Message, Value>(file: DescFile, path: number, ...paths: number[]): GenDescExtension<Extendee, Value>;

package/dist/cjs/codegenv1/extension.js

@@ -0,0 +1,29 @@
+"use strict";
+// Copyright 2021-2024 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.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extDesc = void 0;
+/**
+ * Hydrate an extension descriptor.
+ *
+ * @private
+ */
+function extDesc(file, path, ...paths) {
+    if (paths.length == 0) {
+        return file.extensions[path];
+    }
+    const e = paths.pop(); // we checked length above
+    return paths.reduce((acc, cur) => acc.nestedMessages[cur], file.messages[path]).nestedExtensions[e];
+}
+exports.extDesc = extDesc;

package/dist/cjs/codegenv1/file.d.ts

@@ -0,0 +1,7 @@
+import type { DescFile } from "../desc-types.js";
+/**
+ * Hydrate a file descriptor.
+ *
+ * @private
+ */
+export declare function fileDesc(b64: string, imports?: DescFile[]): DescFile;