@bufbuild/protobuf 1.4.2 → 1.5.1

package/dist/esm/descriptor-set.d.ts

@@ -1,6 +1,7 @@
-import type { DescriptorProto, EnumDescriptorProto, EnumValueDescriptorProto, FieldDescriptorProto, FileDescriptorProto, MethodDescriptorProto, OneofDescriptorProto, ServiceDescriptorProto } from "./google/protobuf/descriptor_pb.js";
-import type { ScalarType, LongType } from "./field.js";
+import type { DescriptorProto, Edition, EnumDescriptorProto, EnumValueDescriptorProto, FieldDescriptorProto, FileDescriptorProto, MethodDescriptorProto, OneofDescriptorProto, ServiceDescriptorProto } from "./google/protobuf/descriptor_pb.js";
+import type { LongType, ScalarType } from "./field.js";
 import type { MethodIdempotency, MethodKind } from "./service-type.js";
+import type { MergedFeatureSet } from "./private/feature-set.js";
 /**
  * DescriptorSet provides a convenient interface for working with a set
  * of google.protobuf.FileDescriptorProto.
@@ -50,7 +51,12 @@ export interface DescFile {
     /**
      * The syntax specified in the protobuf source.
      */
-    readonly syntax: "proto3" | "proto2";
+    readonly syntax: "proto3" | "proto2" | "editions";
+    /**
+     * The edition of the protobuf file. Will be EDITION_PROTO2 for syntax="proto2",
+     * EDITION_PROTO3 for syntax="proto3";
+     */
+    readonly edition: Exclude<Edition, Edition.EDITION_1_TEST_ONLY | Edition.EDITION_2_TEST_ONLY | Edition.EDITION_99997_TEST_ONLY | Edition.EDITION_99998_TEST_ONLY | Edition.EDITION_99999_TEST_ONLY>;
     /**
      * The name of the file, excluding the .proto suffix.
      * For a protobuf file `foo/bar.proto`, this is `foo/bar`.
@@ -91,6 +97,10 @@ export interface DescFile {
      * Get comments on the package element in the protobuf source.
      */
     getPackageComments(): DescComments;
+    /**
+     * Get the edition features for this protobuf element.
+     */
+    getFeatures(): MergedFeatureSet;
     toString(): string;
 }
 /**
@@ -135,6 +145,10 @@ export interface DescEnum {
      * Get comments on the element in the protobuf source.
      */
     getComments(): DescComments;
+    /**
+     * Get the edition features for this protobuf element.
+     */
+    getFeatures(): MergedFeatureSet;
     toString(): string;
 }
 /**
@@ -171,6 +185,10 @@ export interface DescEnumValue {
      * Get comments on the element in the protobuf source.
      */
     getComments(): DescComments;
+    /**
+     * Get the edition features for this protobuf element.
+     */
+    getFeatures(): MergedFeatureSet;
     toString(): string;
 }
 /**
@@ -234,6 +252,10 @@ export interface DescMessage {
      * Get comments on the element in the protobuf source.
      */
     getComments(): DescComments;
+    /**
+     * Get the edition features for this protobuf element.
+     */
+    getFeatures(): MergedFeatureSet;
     toString(): string;
 }
 /**
@@ -290,10 +312,14 @@ interface DescFieldCommon {
      */
     readonly packed: boolean;
     /**
-     * Is this field packed by default? Only valid for enum fields, and for
-     * scalar fields except BYTES and STRING.
+     * Is this field packed by default? Only valid for repeated enum fields, and
+     * for repeated scalar fields except BYTES and STRING.
+     *
      * In proto3 syntax, fields are packed by default. In proto2 syntax, fields
      * are unpacked by default.
+     *
+     * With editions, the default is whatever the edition specifies as a default.
+     * In edition 2023, fields are packed by default.
      */
     readonly packedByDefault: boolean;
     /**
@@ -318,6 +344,10 @@ interface DescFieldCommon {
      * protobuf source.
      */
     declarationString(): string;
+    /**
+     * Get the edition features for this protobuf element.
+     */
+    getFeatures(): MergedFeatureSet;
     toString(): string;
 }
 interface DescFieldScalar {
@@ -534,6 +564,10 @@ export interface DescOneof {
      * Get comments on the element in the protobuf source.
      */
     getComments(): DescComments;
+    /**
+     * Get the edition features for this protobuf element.
+     */
+    getFeatures(): MergedFeatureSet;
     toString(): string;
 }
 /**
@@ -569,6 +603,10 @@ export interface DescService {
      * Get comments on the element in the protobuf source.
      */
     getComments(): DescComments;
+    /**
+     * Get the edition features for this protobuf element.
+     */
+    getFeatures(): MergedFeatureSet;
     toString(): string;
 }
 /**
@@ -612,6 +650,10 @@ export interface DescMethod {
      * Get comments on the element in the protobuf source.
      */
     getComments(): DescComments;
+    /**
+     * Get the edition features for this protobuf element.
+     */
+    getFeatures(): MergedFeatureSet;
     toString(): string;
 }
 /**

package/dist/esm/field.d.ts

@@ -23,6 +23,7 @@ import type { MessageType } from "./message-type.js";
  *
  * - "oneof": If the field is member of a oneof group.
  * - "default": Only proto2: An explicit default value.
+ * - "delimited": Only proto2: Use the tag-delimited group encoding.
  */
 export type FieldInfo = fiRules<fiScalar> | fiRules<fiEnum> | fiRules<fiMessage> | fiRules<fiMap>;
 /**
@@ -46,6 +47,7 @@ export interface OneofInfo {
     readonly packed: false;
     readonly opt: false;
     readonly default: undefined;
+    readonly delimited?: undefined;
     readonly fields: readonly FieldInfo[];
     /**
      * Return field information by local name.
@@ -119,6 +121,13 @@ interface fiScalar extends fiShared {
      * Only proto2: An explicit default value.
      */
     readonly default: number | boolean | string | bigint | Uint8Array | undefined;
+    /**
+     * Serialize this message with the delimited format, also known as group
+     * encoding, as opposed to the standard length prefix.
+     *
+     * Only valid for message fields.
+     */
+    readonly delimited?: undefined;
 }
 interface fiMessage extends fiShared {
     readonly kind: "message";
@@ -138,6 +147,13 @@ interface fiMessage extends fiShared {
      * An explicit default value (only proto2). Never set for messages.
      */
     readonly default: undefined;
+    /**
+     * Serialize this message with the delimited format, also known as group
+     * encoding, as opposed to the standard length prefix.
+     *
+     * Only valid for message fields.
+     */
+    readonly delimited?: boolean;
 }
 interface fiEnum extends fiShared {
     readonly kind: "enum";
@@ -163,6 +179,13 @@ interface fiEnum extends fiShared {
      * Only proto2: An explicit default value.
      */
     readonly default: number | undefined;
+    /**
+     * Serialize this message with the delimited format, also known as group
+     * encoding, as opposed to the standard length prefix.
+     *
+     * Only valid for message fields.
+     */
+    readonly delimited?: undefined;
 }
 interface fiMap extends fiShared {
     readonly kind: "map";
@@ -199,6 +222,13 @@ interface fiMap extends fiShared {
      * An explicit default value (only proto2). Never set for maps.
      */
     readonly default: undefined;
+    /**
+     * Serialize this message with the delimited format, also known as group
+     * encoding, as opposed to the standard length prefix.
+     *
+     * Only valid for message fields.
+     */
+    readonly delimited?: undefined;
 }
 type fiRules<T> = Omit<T, "oneof" | "repeat" | "repeated" | "packed" | "opt"> & ({
     readonly repeated: false;
@@ -221,7 +251,7 @@ type fiRules<T> = Omit<T, "oneof" | "repeat" | "repeated" | "packed" | "opt"> &
     readonly opt: false;
     readonly oneof: OneofInfo;
 });
-type fiPartialRules<T extends fiScalar | fiMap | fiEnum | fiMessage> = Omit<T, "jsonName" | "localName" | "oneof" | "repeat" | "repeated" | "packed" | "opt" | "default" | "L"> & ({
+type fiPartialRules<T extends fiScalar | fiMap | fiEnum | fiMessage> = Omit<T, "jsonName" | "localName" | "oneof" | "repeat" | "repeated" | "packed" | "opt" | "default" | "L" | "delimited"> & ({
     readonly jsonName?: string;
     readonly repeated?: false;
     readonly packed?: false;
@@ -229,6 +259,7 @@ type fiPartialRules<T extends fiScalar | fiMap | fiEnum | fiMessage> = Omit<T, "
     readonly oneof?: undefined;
     default?: T["default"];
     L?: LongType;
+    delimited?: boolean;
 } | {
     readonly jsonName?: string;
     readonly repeated?: false;
@@ -237,6 +268,7 @@ type fiPartialRules<T extends fiScalar | fiMap | fiEnum | fiMessage> = Omit<T, "
     readonly oneof?: undefined;
     default?: T["default"];
     L?: LongType;
+    delimited?: boolean;
 } | {
     readonly jsonName?: string;
     readonly repeated?: boolean;
@@ -245,6 +277,7 @@ type fiPartialRules<T extends fiScalar | fiMap | fiEnum | fiMessage> = Omit<T, "
     readonly oneof?: undefined;
     default?: T["default"];
     L?: LongType;
+    delimited?: boolean;
 } | {
     readonly jsonName?: string;
     readonly repeated?: false;
@@ -253,6 +286,7 @@ type fiPartialRules<T extends fiScalar | fiMap | fiEnum | fiMessage> = Omit<T, "
     readonly oneof: string;
     default?: T["default"];
     L?: LongType;
+    delimited?: boolean;
 });
 /**
  * Scalar value types. This is a subset of field types declared by protobuf
@@ -273,7 +307,7 @@ export declare enum ScalarType {
     UINT32 = 13,
     SFIXED32 = 15,
     SFIXED64 = 16,
-    SINT32 = 17,
+    SINT32 = 17,// Uses ZigZag encoding.
     SINT64 = 18
 }
 /**

package/dist/esm/google/protobuf/any_pb.js

@@ -237,7 +237,7 @@ export class Any extends Message {
             throw new Error(`invalid type url: ${url}`);
         }
         const slash = url.lastIndexOf("/");
-        const name = slash > 0 ? url.substring(slash + 1) : url;
+        const name = slash >= 0 ? url.substring(slash + 1) : url;
         if (!name.length) {
             throw new Error(`invalid type url: ${url}`);
         }

package/dist/esm/google/protobuf/descriptor_pb.js

@@ -18,7 +18,7 @@
 // The messages in this file describe the definitions found in .proto files.
 // A valid .proto file can be translated directly to a FileDescriptorProto
 // without any other information (e.g. without reading its imports).
-// @generated by protoc-gen-es v1.4.2 with parameter "bootstrap_wkt=true,ts_nocheck=false,target=ts"
+// @generated by protoc-gen-es v1.5.1 with parameter "bootstrap_wkt=true,ts_nocheck=false,target=ts"
 // @generated from file google/protobuf/descriptor.proto (package google.protobuf, syntax proto2)
 /* eslint-disable */
 import { proto2 } from "../../proto2.js";

package/dist/esm/google/protobuf/struct_pb.js

@@ -11,7 +11,7 @@
 // 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.
-// @generated by protoc-gen-es v1.4.2 with parameter "bootstrap_wkt=true,ts_nocheck=false,target=ts"
+// @generated by protoc-gen-es v1.5.1 with parameter "bootstrap_wkt=true,ts_nocheck=false,target=ts"
 // @generated from file google/protobuf/struct.proto (package google.protobuf, syntax proto3)
 /* eslint-disable */
 import { proto3 } from "../../proto3.js";

package/dist/esm/google/protobuf/type_pb.js

@@ -11,7 +11,7 @@
 // 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.
-// @generated by protoc-gen-es v1.4.2 with parameter "bootstrap_wkt=true,ts_nocheck=false,target=ts"
+// @generated by protoc-gen-es v1.5.1 with parameter "bootstrap_wkt=true,ts_nocheck=false,target=ts"
 // @generated from file google/protobuf/type.proto (package google.protobuf, syntax proto3)
 /* eslint-disable */
 import { proto3 } from "../../proto3.js";

package/dist/esm/private/binary-format-common.d.ts

@@ -2,12 +2,13 @@ import type { IBinaryReader, IBinaryWriter } from "../binary-encoding.js";
 import type { BinaryFormat, BinaryWriteOptions } from "../binary-format.js";
 import type { FieldInfo } from "../field.js";
 import { ScalarType } from "../field.js";
-import type { MessageType } from "../message-type.js";
 export declare function makeBinaryFormatCommon(): Omit<BinaryFormat, "writeMessage">;
 export declare function readScalarLTString(reader: IBinaryReader, type: ScalarType): any;
 export declare function writeMapEntry(writer: IBinaryWriter, options: BinaryWriteOptions, field: FieldInfo & {
     kind: "map";
 }, key: any, value: any): void;
-export declare function writeMessageField(writer: IBinaryWriter, options: BinaryWriteOptions, type: MessageType, fieldNo: number, value: any): void;
+export declare function writeMessageField(writer: IBinaryWriter, options: BinaryWriteOptions, field: FieldInfo & {
+    kind: "message";
+}, value: any): void;
 export declare function writeScalar(writer: IBinaryWriter, type: ScalarType, fieldNo: number, value: any, emitIntrinsicDefault: boolean): void;
 export declare function writePacked(writer: IBinaryWriter, type: ScalarType, fieldNo: number, value: any[]): void;

package/dist/esm/private/binary-format-common.js

@@ -62,11 +62,19 @@ export function makeBinaryFormatCommon() {
             }
             m[unknownFieldsSymbol].push({ no, wireType, data });
         },
-        readMessage(message, reader, length, options) {
+        readMessage(message, reader, lengthOrEndTagFieldNo, options, delimitedMessageEncoding) {
             const type = message.getType();
-            const end = length === undefined ? reader.len : reader.pos + length;
+            // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
+            const end = delimitedMessageEncoding
+                ? reader.len
+                : reader.pos + lengthOrEndTagFieldNo;
+            let fieldNo, wireType;
             while (reader.pos < end) {
-                const [fieldNo, wireType] = reader.tag(), field = type.fields.find(fieldNo);
+                [fieldNo, wireType] = reader.tag();
+                if (wireType == WireType.EndGroup) {
+                    break;
+                }
+                const field = type.fields.find(fieldNo);
                 if (!field) {
                     const data = reader.skip(wireType);
                     if (options.readUnknownFields) {
@@ -114,14 +122,14 @@ export function makeBinaryFormatCommon() {
                         const messageType = field.T;
                         if (repeated) {
                             // safe to assume presence of array, oneof cannot contain repeated values
-                            target[localName].push(readMessageField(reader, new messageType(), options));
+                            target[localName].push(readMessageField(reader, new messageType(), options, field));
                         }
                         else {
                             if (target[localName] instanceof Message) {
-                                readMessageField(reader, target[localName], options);
+                                readMessageField(reader, target[localName], options, field);
                             }
                             else {
-                                target[localName] = readMessageField(reader, new messageType(), options);
+                                target[localName] = readMessageField(reader, new messageType(), options, field);
                                 if (messageType.fieldWrapper &&
                                     !field.oneof &&
                                     !field.repeated) {
@@ -137,14 +145,20 @@ export function makeBinaryFormatCommon() {
                         break;
                 }
             }
+            if (delimitedMessageEncoding && // eslint-disable-line @typescript-eslint/strict-boolean-expressions
+                (wireType != WireType.EndGroup || fieldNo !== lengthOrEndTagFieldNo)) {
+                throw new Error(`invalid end group tag`);
+            }
         },
     };
 }
 // Read a message, avoiding MessageType.fromBinary() to re-use the
 // BinaryReadOptions and the IBinaryReader.
-function readMessageField(reader, message, options) {
+function readMessageField(reader, message, options, field) {
     const format = message.getType().runtime.bin;
-    format.readMessage(message, reader, reader.uint32(), options);
+    const delimited = field === null || field === void 0 ? void 0 : field.delimited;
+    format.readMessage(message, reader, delimited ? field === null || field === void 0 ? void 0 : field.no : reader.uint32(), // eslint-disable-line @typescript-eslint/strict-boolean-expressions
+    options, delimited);
     return message;
 }
 // Read a map field, expecting key field = 1, value field = 2
@@ -166,7 +180,7 @@ function readMapEntry(field, reader, options) {
                         val = reader.int32();
                         break;
                     case "message":
-                        val = readMessageField(reader, new field.V.T(), options);
+                        val = readMessageField(reader, new field.V.T(), options, undefined);
                         break;
                 }
                 break;
@@ -269,17 +283,24 @@ export function writeMapEntry(writer, options, field, key, value) {
             writeScalar(writer, ScalarType.INT32, 2, value, true);
             break;
         case "message":
-            writeMessageField(writer, options, field.V.T, 2, value);
+            writer.tag(2, WireType.LengthDelimited).bytes(value.toBinary(options));
             break;
     }
     writer.join();
 }
-export function writeMessageField(writer, options, type, fieldNo, value) {
+export function writeMessageField(writer, options, field, value) {
     if (value !== undefined) {
-        const message = wrapField(type, value);
-        writer
-            .tag(fieldNo, WireType.LengthDelimited)
-            .bytes(message.toBinary(options));
+        const message = wrapField(field.T, value);
+        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
+        if (field === null || field === void 0 ? void 0 : field.delimited)
+            writer
+                .tag(field.no, WireType.StartGroup)
+                .raw(message.toBinary(options))
+                .tag(field.no, WireType.EndGroup);
+        else
+            writer
+                .tag(field.no, WireType.LengthDelimited)
+                .bytes(message.toBinary(options));
     }
 }
 export function writeScalar(writer, type, fieldNo, value, emitIntrinsicDefault) {

package/dist/esm/private/binary-format-proto2.js

@@ -62,11 +62,11 @@ export function makeBinaryFormatProto2() {
                         case "message":
                             if (repeated) {
                                 for (const item of value) {
-                                    writeMessageField(writer, options, field.T, field.no, item);
+                                    writeMessageField(writer, options, field, item);
                                 }
                             }
                             else {
-                                writeMessageField(writer, options, field.T, field.no, value);
+                                writeMessageField(writer, options, field, value);
                             }
                             break;
                         case "map":

package/dist/esm/private/binary-format-proto3.js

@@ -53,11 +53,11 @@ export function makeBinaryFormatProto3() {
                     case "message":
                         if (repeated) {
                             for (const item of value) {
-                                writeMessageField(writer, options, field.T, field.no, item);
+                                writeMessageField(writer, options, field, item);
                             }
                         }
                         else {
-                            writeMessageField(writer, options, field.T, field.no, value);
+                            writeMessageField(writer, options, field, value);
                         }
                         break;
                     case "map":

package/dist/esm/private/feature-set.d.ts

@@ -0,0 +1,21 @@
+import { Edition, FeatureSet, FeatureSetDefaults } from "../google/protobuf/descriptor_pb.js";
+/**
+ * Static edition feature defaults supported by @bufbuild/protobuf.
+ */
+export declare const featureSetDefaults: FeatureSetDefaults;
+/**
+ * A merged google.protobuf.FeaturesSet, with all fields guaranteed to be set.
+ */
+export type MergedFeatureSet = FeatureSet & Required<FeatureSet>;
+/**
+ * A function that resolves features for the given edition.
+ *
+ * If no feature set is provided, the default feature set for the edition is
+ * returned. If features are provided, they are merged into the edition default
+ * features.
+ */
+export type FeatureResolverFn = (edition: Edition, a?: FeatureSet, b?: FeatureSet) => MergedFeatureSet;
+/**
+ * Create an edition feature resolver with the given feature set defaults.
+ */
+export declare function createFeatureResolver(compiledFeatureSetDefaults: FeatureSetDefaults): FeatureResolverFn;

package/dist/esm/private/feature-set.js

@@ -0,0 +1,103 @@
+// Copyright 2021-2023 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.
+import { Edition, FeatureSet, FeatureSetDefaults, } from "../google/protobuf/descriptor_pb.js";
+import { protoBase64 } from "../proto-base64.js";
+/**
+ * Static edition feature defaults supported by @bufbuild/protobuf.
+ */
+export const featureSetDefaults = FeatureSetDefaults.fromBinary(protoBase64.dec(
+/*upstream-inject-feature-defaults-start*/ "ChESDAgBEAIYAiABKAEwAhjmBwoREgwIAhABGAEgAigBMAEY5wcKERIMCAEQARgBIAIoATABGOgHIOYHKOgH" /*upstream-inject-feature-defaults-end*/));
+/**
+ * Create an edition feature resolver with the given feature set defaults.
+ */
+export function createFeatureResolver(compiledFeatureSetDefaults) {
+    const min = compiledFeatureSetDefaults.minimumEdition;
+    const max = compiledFeatureSetDefaults.maximumEdition;
+    if (min === undefined ||
+        max === undefined ||
+        compiledFeatureSetDefaults.defaults.some((d) => d.edition === undefined)) {
+        throw new Error("Invalid FeatureSetDefaults");
+    }
+    const defaultsBinByEdition = new Map();
+    return (edition, ...rest) => {
+        var _a, _b;
+        let defaultsBin = defaultsBinByEdition.get(edition);
+        if (defaultsBin === undefined) {
+            if (edition < min) {
+                throw new Error(`Edition ${Edition[edition]} is earlier than the minimum supported edition ${Edition[min]}`);
+            }
+            if (max < edition) {
+                throw new Error(`Edition ${Edition[edition]} is later than the maximum supported edition ${Edition[max]}`);
+            }
+            let highestMatch = undefined;
+            for (const c of compiledFeatureSetDefaults.defaults) {
+                const e = (_a = c.edition) !== null && _a !== void 0 ? _a : 0;
+                if (e > edition) {
+                    continue;
+                }
+                if (highestMatch !== undefined && highestMatch.e > e) {
+                    continue;
+                }
+                highestMatch = {
+                    e,
+                    f: (_b = c.features) !== null && _b !== void 0 ? _b : new FeatureSet(),
+                };
+            }
+            if (highestMatch === undefined) {
+                throw new Error(`No valid default found for edition ${Edition[edition]}`);
+            }
+            defaultsBin = highestMatch.f.toBinary();
+            defaultsBinByEdition.set(edition, defaultsBin);
+        }
+        const f = FeatureSet.fromBinary(defaultsBin);
+        for (const c of rest) {
+            if (c !== undefined) {
+                f.fromBinary(c.toBinary());
+            }
+        }
+        if (!validateMergedFeatures(f)) {
+            throw new Error(`Invalid FeatureSet for edition ${Edition[edition]}`);
+        }
+        return f;
+    };
+}
+// When protoc generates google.protobuf.FeatureSetDefaults, it ensures that
+// fields are not repeated or required, do not use oneof, and have a default
+// value.
+//
+// When features for an element are resolved, features of the element and its
+// parents are merged into the default FeatureSet for the edition. Because unset
+// fields in the FeatureSet of an element do not unset the default FeatureSet
+// values, a resolved FeatureSet is guaranteed to have all fields set. This is
+// also the case for extensions to FeatureSet that a user might provide, and for
+// features from the future.
+//
+// We cannot exhaustively validate correctness of FeatureSetDefaults at runtime
+// without knowing the schema: If no value for a feature is provided, we do not
+// know that it exists at all.
+//
+// As a sanity check, we validate that all fields known to our version of
+// FeatureSet are set.
+function validateMergedFeatures(featureSet) {
+    for (const fi of FeatureSet.fields.list()) {
+        const v = featureSet[fi.localName];
+        if (v === undefined) {
+            return false;
+        }
+        if (fi.kind == "enum" && v === 0) {
+            return false;
+        }
+    }
+    return true;
+}

package/dist/esm/private/text-format.d.ts

@@ -0,0 +1,4 @@
+import type { DescEnum } from "../descriptor-set.js";
+import { ScalarType } from "../field.js";
+export declare function parseTextFormatEnumValue(descEnum: DescEnum, value: string): number;
+export declare function parseTextFormatScalarValue(type: ScalarType, value: string): number | boolean | string | bigint | Uint8Array;