@bufbuild/protoplugin 2.10.2 → 2.12.0

package/dist/cjs/create-es-plugin.d.ts

@@ -30,20 +30,20 @@ interface PluginInit<Options extends object> {
      * If your plugin does not recognize an option, it must throw an Error in
      * parseOptions.
      */
-    parseOptions?: (rawOptions: {
+    parseOptions?: ((rawOptions: {
         key: string;
         value: string;
-    }[]) => Options;
+    }[]) => Options) | undefined;
     /**
      * The earliest edition supported by this plugin. Defaults to the minimum
      * edition supported by @bufbuild/protobuf.
      */
-    minimumEdition?: SupportedEdition;
+    minimumEdition?: SupportedEdition | undefined;
     /**
      * The latest edition supported by this plugin. Defaults to the maximum
      * edition supported by @bufbuild/protobuf.
      */
-    maximumEdition?: SupportedEdition;
+    maximumEdition?: SupportedEdition | undefined;
     /**
      * A function which will generate TypeScript files based on proto input.
      * This function will be invoked by the plugin framework when the plugin runs.
@@ -61,7 +61,7 @@ interface PluginInit<Options extends object> {
      * JavaScript files.  If not, the plugin framework will transpile the files
      * itself.
      */
-    generateJs?: (schema: Schema<Options>, target: "js") => void;
+    generateJs?: ((schema: Schema<Options>, target: "js") => void) | undefined;
     /**
      * A optional function which will generate TypeScript declaration files
      * based on proto input.  This function will be invoked by the plugin
@@ -72,7 +72,7 @@ interface PluginInit<Options extends object> {
      * declaration files.  If not, the plugin framework will transpile the files
      * itself.
      */
-    generateDts?: (schema: Schema<Options>, target: "dts") => void;
+    generateDts?: ((schema: Schema<Options>, target: "dts") => void) | undefined;
     /**
      * An optional function which will transpile a given set of files.
      *
@@ -86,7 +86,7 @@ interface PluginInit<Options extends object> {
      * transpiling to JS. If jsImportStyle is "legacy_commonjs", the function is
      * expected to use CommonJs require() and exports when transpiling to JS.
      */
-    transpile?: (files: FileInfo[], transpileJs: boolean, transpileDts: boolean, jsImportStyle: "module" | "legacy_commonjs") => FileInfo[];
+    transpile?: ((files: FileInfo[], transpileJs: boolean, transpileDts: boolean, jsImportStyle: "module" | "legacy_commonjs") => FileInfo[]) | undefined;
 }
 /**
  * Create a new code generator plugin for ECMAScript.

package/dist/cjs/create-es-plugin.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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.
@@ -36,7 +36,7 @@ function createEcmaScriptPlugin(init) {
             const minimumEdition = (_a = init.minimumEdition) !== null && _a !== void 0 ? _a : protobuf_2.minimumEdition;
             const maximumEdition = (_b = init.maximumEdition) !== null && _b !== void 0 ? _b : protobuf_2.maximumEdition;
             const parameter = (0, parameter_js_1.parseParameter)(req.parameter, init.parseOptions);
-            const schema = (0, schema_js_1.createSchema)(req, parameter, init.name, init.version, minimumEdition, maximumEdition);
+            const schema = (0, schema_js_1.createSchema)(req, parameter, init.name, parameter.parsed.elidePluginVersion ? undefined : init.version, minimumEdition, maximumEdition);
             const targetTs = schema.targets.includes("ts");
             const targetJs = schema.targets.includes("js");
             const targetDts = schema.targets.includes("dts");

package/dist/cjs/error.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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/cjs/file-preamble.d.ts

@@ -1,2 +1,2 @@
 import type { DescFile } from "@bufbuild/protobuf";
-export declare function makeFilePreamble(file: DescFile, pluginName: string, pluginVersion: string, parameter: string, tsNoCheck: boolean): string;
+export declare function makeFilePreamble(file: DescFile, pluginName: string, pluginVersion: string | undefined, parameter: string, tsNoCheck: boolean): string;

package/dist/cjs/file-preamble.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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.
@@ -36,7 +36,12 @@ function makeFilePreamble(file, pluginName, pluginVersion, parameter, tsNoCheck)
         }
     };
     writeLeadingComments((0, source_code_info_js_1.getSyntaxComments)(file));
-    builder.push(`// @generated by ${pluginName} ${pluginVersion}`);
+    if (pluginVersion === undefined) {
+        builder.push(`// @generated by ${pluginName}`);
+    }
+    else {
+        builder.push(`// @generated by ${pluginName} ${pluginVersion}`);
+    }
     if (parameter !== "") {
         builder.push(` with parameter "${parameter}"`);
     }
@@ -53,7 +58,10 @@ function makeFilePreamble(file, pluginName, pluginVersion, parameter, tsNoCheck)
             builder.push("syntax proto3)\n");
             break;
         default: {
-            const editionString = wkt_1.Edition[file.edition];
+            // Report the raw edition from the descriptor so files using
+            // EDITION_UNSTABLE (which we collapse to maximumEdition internally)
+            // still render as "edition unstable".
+            const editionString = wkt_1.Edition[file.proto.edition];
             if (typeof editionString == "string") {
                 const e = editionString.replace("EDITION_", "").toLowerCase();
                 builder.push(`edition ${e})\n`);

package/dist/cjs/generated-file.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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/cjs/import-path.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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/cjs/import-symbol.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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/cjs/index.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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/cjs/jsdoc.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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/cjs/names.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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/cjs/parameter.d.ts

@@ -37,6 +37,12 @@ export interface EcmaScriptPluginOptions {
      * The default is false.
      */
     tsNocheck: boolean;
+    /**
+     * Elide the plugin's version at the top of each file.
+     *
+     * The default is false.
+     */
+    elidePluginVersion: boolean;
     /**
      * Prune empty files from the output.
      *

package/dist/cjs/parameter.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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.
@@ -18,6 +18,7 @@ const error_js_1 = require("./error.js");
 function parseParameter(parameter, parseExtraOptions) {
     let targets = ["js", "dts"];
     let tsNocheck = false;
+    let elidePluginVersion = false;
     let bootstrapWkt = false;
     let keepEmptyFiles = false;
     const rewriteImports = [];
@@ -62,6 +63,20 @@ function parseParameter(parameter, parseExtraOptions) {
                         throw new error_js_1.PluginOptionError(raw);
                 }
                 break;
+            case "elide_plugin_version":
+                switch (value) {
+                    case "true":
+                    case "1":
+                        elidePluginVersion = true;
+                        break;
+                    case "false":
+                    case "0":
+                        elidePluginVersion = false;
+                        break;
+                    default:
+                        throw new error_js_1.PluginOptionError(raw);
+                }
+                break;
             case "bootstrap_wkt":
                 switch (value) {
                     case "true":
@@ -152,6 +167,7 @@ function parseParameter(parameter, parseExtraOptions) {
     const ecmaScriptPluginOptions = {
         targets,
         tsNocheck,
+        elidePluginVersion,
         bootstrapWkt,
         rewriteImports,
         importExtension,

package/dist/cjs/plugin.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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/cjs/printable.d.ts

@@ -39,5 +39,5 @@ export type ValidTypeImport = {
 export type JSDocBlock = {
     readonly kind: "es_jsdoc";
     text: string;
-    indentation?: string;
+    indentation?: string | undefined;
 };

package/dist/cjs/printable.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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/cjs/run-node.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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.
@@ -61,7 +61,12 @@ function runNodeJs(plugin) {
 function readBytes(stream) {
     return new Promise((resolve, reject) => {
         const chunks = [];
-        stream.on("data", (chunk) => chunks.push(chunk));
+        stream.on("data", (chunk) => {
+            if (typeof chunk === "string") {
+                throw new Error("unexpected chunk type string");
+            }
+            chunks.push(chunk);
+        });
         stream.on("end", () => {
             resolve(Buffer.concat(chunks));
         });

package/dist/cjs/runtime-imports.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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/cjs/safe-identifier.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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/cjs/schema.d.ts

@@ -43,5 +43,5 @@ interface SchemaController<Options extends object> extends Schema<Options> {
     getFileInfo: () => FileInfo[];
     prepareGenerate(target: Target): void;
 }
-export declare function createSchema<T extends object>(request: CodeGeneratorRequest, parameter: ParsedParameter<T>, pluginName: string, pluginVersion: string, minimumEdition: Edition, maximumEdition: Edition): SchemaController<T>;
+export declare function createSchema<T extends object>(request: CodeGeneratorRequest, parameter: ParsedParameter<T>, pluginName: string, pluginVersion: string | undefined, minimumEdition: Edition, maximumEdition: Edition): SchemaController<T>;
 export {};

package/dist/cjs/schema.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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.
@@ -86,6 +86,11 @@ function getFilesToGenerate(request, minimumEdition, maximumEdition) {
                     edition = wkt_1.Edition.EDITION_UNKNOWN;
                     break;
             }
+            // EDITION_UNSTABLE is a sandbox for in-development features; accept
+            // it regardless of the plugin's min/max bounds.
+            if (edition === wkt_1.Edition.EDITION_UNSTABLE) {
+                continue;
+            }
             if (edition < minimumEdition) {
                 throw new Error(`${file.name}: unsupported edition ${editionToString(edition)} - the earliest supported edition is ${editionToString(minimumEdition)}`);
             }

package/dist/cjs/source-code-info.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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/cjs/transpile.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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.
@@ -42,9 +42,11 @@ const vfs_1 = require("@typescript/vfs");
  * npm does not support that yet.
  */
 function createTranspiler(options, files) {
-    const fsMap = (0, vfs_1.createDefaultMapFromNodeModules)({
-        target: options.target,
-    });
+    const fsMapOptions = {};
+    if (options.target) {
+        fsMapOptions.target = options.target;
+    }
+    const fsMap = (0, vfs_1.createDefaultMapFromNodeModules)(fsMapOptions);
     for (const file of files) {
         fsMap.set(file.name, file.content);
     }

package/dist/esm/create-es-plugin.d.ts

@@ -30,20 +30,20 @@ interface PluginInit<Options extends object> {
      * If your plugin does not recognize an option, it must throw an Error in
      * parseOptions.
      */
-    parseOptions?: (rawOptions: {
+    parseOptions?: ((rawOptions: {
         key: string;
         value: string;
-    }[]) => Options;
+    }[]) => Options) | undefined;
     /**
      * The earliest edition supported by this plugin. Defaults to the minimum
      * edition supported by @bufbuild/protobuf.
      */
-    minimumEdition?: SupportedEdition;
+    minimumEdition?: SupportedEdition | undefined;
     /**
      * The latest edition supported by this plugin. Defaults to the maximum
      * edition supported by @bufbuild/protobuf.
      */
-    maximumEdition?: SupportedEdition;
+    maximumEdition?: SupportedEdition | undefined;
     /**
      * A function which will generate TypeScript files based on proto input.
      * This function will be invoked by the plugin framework when the plugin runs.
@@ -61,7 +61,7 @@ interface PluginInit<Options extends object> {
      * JavaScript files.  If not, the plugin framework will transpile the files
      * itself.
      */
-    generateJs?: (schema: Schema<Options>, target: "js") => void;
+    generateJs?: ((schema: Schema<Options>, target: "js") => void) | undefined;
     /**
      * A optional function which will generate TypeScript declaration files
      * based on proto input.  This function will be invoked by the plugin
@@ -72,7 +72,7 @@ interface PluginInit<Options extends object> {
      * declaration files.  If not, the plugin framework will transpile the files
      * itself.
      */
-    generateDts?: (schema: Schema<Options>, target: "dts") => void;
+    generateDts?: ((schema: Schema<Options>, target: "dts") => void) | undefined;
     /**
      * An optional function which will transpile a given set of files.
      *
@@ -86,7 +86,7 @@ interface PluginInit<Options extends object> {
      * transpiling to JS. If jsImportStyle is "legacy_commonjs", the function is
      * expected to use CommonJs require() and exports when transpiling to JS.
      */
-    transpile?: (files: FileInfo[], transpileJs: boolean, transpileDts: boolean, jsImportStyle: "module" | "legacy_commonjs") => FileInfo[];
+    transpile?: ((files: FileInfo[], transpileJs: boolean, transpileDts: boolean, jsImportStyle: "module" | "legacy_commonjs") => FileInfo[]) | undefined;
 }
 /**
  * Create a new code generator plugin for ECMAScript.

package/dist/esm/create-es-plugin.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.
@@ -33,7 +33,7 @@ export function createEcmaScriptPlugin(init) {
             const minimumEdition = (_a = init.minimumEdition) !== null && _a !== void 0 ? _a : minimumEditionUpstream;
             const maximumEdition = (_b = init.maximumEdition) !== null && _b !== void 0 ? _b : maximumEditionUpstream;
             const parameter = parseParameter(req.parameter, init.parseOptions);
-            const schema = createSchema(req, parameter, init.name, init.version, minimumEdition, maximumEdition);
+            const schema = createSchema(req, parameter, init.name, parameter.parsed.elidePluginVersion ? undefined : init.version, minimumEdition, maximumEdition);
             const targetTs = schema.targets.includes("ts");
             const targetJs = schema.targets.includes("js");
             const targetDts = schema.targets.includes("dts");

package/dist/esm/error.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/file-preamble.d.ts

@@ -1,2 +1,2 @@
 import type { DescFile } from "@bufbuild/protobuf";
-export declare function makeFilePreamble(file: DescFile, pluginName: string, pluginVersion: string, parameter: string, tsNoCheck: boolean): string;
+export declare function makeFilePreamble(file: DescFile, pluginName: string, pluginVersion: string | undefined, parameter: string, tsNoCheck: boolean): string;

package/dist/esm/file-preamble.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.
@@ -33,7 +33,12 @@ export function makeFilePreamble(file, pluginName, pluginVersion, parameter, tsN
         }
     };
     writeLeadingComments(getSyntaxComments(file));
-    builder.push(`// @generated by ${pluginName} ${pluginVersion}`);
+    if (pluginVersion === undefined) {
+        builder.push(`// @generated by ${pluginName}`);
+    }
+    else {
+        builder.push(`// @generated by ${pluginName} ${pluginVersion}`);
+    }
     if (parameter !== "") {
         builder.push(` with parameter "${parameter}"`);
     }
@@ -50,7 +55,10 @@ export function makeFilePreamble(file, pluginName, pluginVersion, parameter, tsN
             builder.push("syntax proto3)\n");
             break;
         default: {
-            const editionString = Edition[file.edition];
+            // Report the raw edition from the descriptor so files using
+            // EDITION_UNSTABLE (which we collapse to maximumEdition internally)
+            // still render as "edition unstable".
+            const editionString = Edition[file.proto.edition];
             if (typeof editionString == "string") {
                 const e = editionString.replace("EDITION_", "").toLowerCase();
                 builder.push(`edition ${e})\n`);

package/dist/esm/generated-file.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/import-path.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/import-symbol.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/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/jsdoc.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/names.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/parameter.d.ts

@@ -37,6 +37,12 @@ export interface EcmaScriptPluginOptions {
      * The default is false.
      */
     tsNocheck: boolean;
+    /**
+     * Elide the plugin's version at the top of each file.
+     *
+     * The default is false.
+     */
+    elidePluginVersion: boolean;
     /**
      * Prune empty files from the output.
      *

package/dist/esm/parameter.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.
@@ -15,6 +15,7 @@ import { PluginOptionError } from "./error.js";
 export function parseParameter(parameter, parseExtraOptions) {
     let targets = ["js", "dts"];
     let tsNocheck = false;
+    let elidePluginVersion = false;
     let bootstrapWkt = false;
     let keepEmptyFiles = false;
     const rewriteImports = [];
@@ -59,6 +60,20 @@ export function parseParameter(parameter, parseExtraOptions) {
                         throw new PluginOptionError(raw);
                 }
                 break;
+            case "elide_plugin_version":
+                switch (value) {
+                    case "true":
+                    case "1":
+                        elidePluginVersion = true;
+                        break;
+                    case "false":
+                    case "0":
+                        elidePluginVersion = false;
+                        break;
+                    default:
+                        throw new PluginOptionError(raw);
+                }
+                break;
             case "bootstrap_wkt":
                 switch (value) {
                     case "true":
@@ -149,6 +164,7 @@ export function parseParameter(parameter, parseExtraOptions) {
     const ecmaScriptPluginOptions = {
         targets,
         tsNocheck,
+        elidePluginVersion,
         bootstrapWkt,
         rewriteImports,
         importExtension,

package/dist/esm/plugin.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/printable.d.ts

@@ -39,5 +39,5 @@ export type ValidTypeImport = {
 export type JSDocBlock = {
     readonly kind: "es_jsdoc";
     text: string;
-    indentation?: string;
+    indentation?: string | undefined;
 };

package/dist/esm/printable.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/run-node.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.
@@ -58,7 +58,12 @@ export function runNodeJs(plugin) {
 function readBytes(stream) {
     return new Promise((resolve, reject) => {
         const chunks = [];
-        stream.on("data", (chunk) => chunks.push(chunk));
+        stream.on("data", (chunk) => {
+            if (typeof chunk === "string") {
+                throw new Error("unexpected chunk type string");
+            }
+            chunks.push(chunk);
+        });
         stream.on("end", () => {
             resolve(Buffer.concat(chunks));
         });

package/dist/esm/runtime-imports.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/safe-identifier.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/schema.d.ts

@@ -43,5 +43,5 @@ interface SchemaController<Options extends object> extends Schema<Options> {
     getFileInfo: () => FileInfo[];
     prepareGenerate(target: Target): void;
 }
-export declare function createSchema<T extends object>(request: CodeGeneratorRequest, parameter: ParsedParameter<T>, pluginName: string, pluginVersion: string, minimumEdition: Edition, maximumEdition: Edition): SchemaController<T>;
+export declare function createSchema<T extends object>(request: CodeGeneratorRequest, parameter: ParsedParameter<T>, pluginName: string, pluginVersion: string | undefined, minimumEdition: Edition, maximumEdition: Edition): SchemaController<T>;
 export {};

package/dist/esm/schema.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.
@@ -83,6 +83,11 @@ function getFilesToGenerate(request, minimumEdition, maximumEdition) {
                     edition = Edition.EDITION_UNKNOWN;
                     break;
             }
+            // EDITION_UNSTABLE is a sandbox for in-development features; accept
+            // it regardless of the plugin's min/max bounds.
+            if (edition === Edition.EDITION_UNSTABLE) {
+                continue;
+            }
             if (edition < minimumEdition) {
                 throw new Error(`${file.name}: unsupported edition ${editionToString(edition)} - the earliest supported edition is ${editionToString(minimumEdition)}`);
             }

package/dist/esm/source-code-info.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/transpile.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.
@@ -36,9 +36,11 @@ import { createDefaultMapFromNodeModules, createSystem, createVirtualCompilerHos
  * npm does not support that yet.
  */
 function createTranspiler(options, files) {
-    const fsMap = createDefaultMapFromNodeModules({
-        target: options.target,
-    });
+    const fsMapOptions = {};
+    if (options.target) {
+        fsMapOptions.target = options.target;
+    }
+    const fsMap = createDefaultMapFromNodeModules(fsMapOptions);
     for (const file of files) {
         fsMap.set(file.name, file.content);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bufbuild/protoplugin",
-  "version": "2.10.2",
+  "version": "2.12.0",
   "license": "Apache-2.0",
   "description": "Helps to create your own Protocol Buffers code generators.",
   "keywords": [
@@ -35,7 +35,7 @@
     }
   },
   "dependencies": {
-    "@bufbuild/protobuf": "2.10.2",
+    "@bufbuild/protobuf": "2.12.0",
     "@typescript/vfs": "^1.6.2",
     "typescript": "5.4.5"
   },