@bufbuild/protobuf 0.0.1-alpha.1

package/dist/types/google/protobuf/duration_pb.d.ts

@@ -0,0 +1,117 @@
+import type {
+  BinaryReadOptions,
+  FieldList,
+  JsonReadOptions,
+  JsonValue,
+  JsonWriteOptions,
+  PartialMessage,
+  PlainMessage,
+} from "../../index.js";
+import { Message } from "../../index.js";
+/**
+ * A Duration represents a signed, fixed-length span of time represented
+ * as a count of seconds and fractions of seconds at nanosecond
+ * resolution. It is independent of any calendar and concepts like "day"
+ * or "month". It is related to Timestamp in that the difference between
+ * two Timestamp values is a Duration and it can be added or subtracted
+ * from a Timestamp. Range is approximately +-10,000 years.
+ *
+ * # Examples
+ *
+ * Example 1: Compute Duration from two Timestamps in pseudo code.
+ *
+ *     Timestamp start = ...;
+ *     Timestamp end = ...;
+ *     Duration duration = ...;
+ *
+ *     duration.seconds = end.seconds - start.seconds;
+ *     duration.nanos = end.nanos - start.nanos;
+ *
+ *     if (duration.seconds < 0 && duration.nanos > 0) {
+ *       duration.seconds += 1;
+ *       duration.nanos -= 1000000000;
+ *     } else if (duration.seconds > 0 && duration.nanos < 0) {
+ *       duration.seconds -= 1;
+ *       duration.nanos += 1000000000;
+ *     }
+ *
+ * Example 2: Compute Timestamp from Timestamp + Duration in pseudo code.
+ *
+ *     Timestamp start = ...;
+ *     Duration duration = ...;
+ *     Timestamp end = ...;
+ *
+ *     end.seconds = start.seconds + duration.seconds;
+ *     end.nanos = start.nanos + duration.nanos;
+ *
+ *     if (end.nanos < 0) {
+ *       end.seconds -= 1;
+ *       end.nanos += 1000000000;
+ *     } else if (end.nanos >= 1000000000) {
+ *       end.seconds += 1;
+ *       end.nanos -= 1000000000;
+ *     }
+ *
+ * Example 3: Compute Duration from datetime.timedelta in Python.
+ *
+ *     td = datetime.timedelta(days=3, minutes=10)
+ *     duration = Duration()
+ *     duration.FromTimedelta(td)
+ *
+ * # JSON Mapping
+ *
+ * In JSON format, the Duration type is encoded as a string rather than an
+ * object, where the string ends in the suffix "s" (indicating seconds) and
+ * is preceded by the number of seconds, with nanoseconds expressed as
+ * fractional seconds. For example, 3 seconds with 0 nanoseconds should be
+ * encoded in JSON format as "3s", while 3 seconds and 1 nanosecond should
+ * be expressed in JSON format as "3.000000001s", and 3 seconds and 1
+ * microsecond should be expressed in JSON format as "3.000001s".
+ *
+ *
+ *
+ * @generated from message google.protobuf.Duration
+ */
+export declare class Duration extends Message<Duration> {
+  /**
+   * Signed seconds of the span of time. Must be from -315,576,000,000
+   * to +315,576,000,000 inclusive. Note: these bounds are computed from:
+   * 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
+   *
+   * @generated from field: int64 seconds = 1;
+   */
+  seconds: bigint;
+  /**
+   * Signed fractions of a second at nanosecond resolution of the span
+   * of time. Durations less than one second are represented with a 0
+   * `seconds` field and a positive or negative `nanos` field. For durations
+   * of one second or more, a non-zero value for the `nanos` field must be
+   * of the same sign as the `seconds` field. Must be from -999,999,999
+   * to +999,999,999 inclusive.
+   *
+   * @generated from field: int32 nanos = 2;
+   */
+  nanos: number;
+  constructor(data?: PartialMessage<Duration>);
+  fromJson(json: JsonValue, options?: Partial<JsonReadOptions>): this;
+  toJson(options?: Partial<JsonWriteOptions>): JsonValue;
+  static readonly runtime: import("../../private/proto-runtime.js").ProtoRuntime;
+  static readonly typeName = "google.protobuf.Duration";
+  static readonly fields: FieldList;
+  static fromBinary(
+    bytes: Uint8Array,
+    options?: Partial<BinaryReadOptions>
+  ): Duration;
+  static fromJson(
+    jsonValue: JsonValue,
+    options?: Partial<JsonReadOptions>
+  ): Duration;
+  static fromJsonString(
+    jsonString: string,
+    options?: Partial<JsonReadOptions>
+  ): Duration;
+  static equals(
+    a: Duration | PlainMessage<Duration> | undefined,
+    b: Duration | PlainMessage<Duration> | undefined
+  ): boolean;
+}

package/dist/types/google/protobuf/empty_pb.d.ts

@@ -0,0 +1,44 @@
+import type {
+  BinaryReadOptions,
+  FieldList,
+  JsonReadOptions,
+  JsonValue,
+  PartialMessage,
+  PlainMessage,
+} from "../../index.js";
+import { Message } from "../../index.js";
+/**
+ * A generic empty message that you can re-use to avoid defining duplicated
+ * empty messages in your APIs. A typical example is to use it as the request
+ * or the response type of an API method. For instance:
+ *
+ *     service Foo {
+ *       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+ *     }
+ *
+ * The JSON representation for `Empty` is empty JSON object `{}`.
+ *
+ * @generated from message google.protobuf.Empty
+ */
+export declare class Empty extends Message<Empty> {
+  constructor(data?: PartialMessage<Empty>);
+  static readonly runtime: import("../../private/proto-runtime.js").ProtoRuntime;
+  static readonly typeName = "google.protobuf.Empty";
+  static readonly fields: FieldList;
+  static fromBinary(
+    bytes: Uint8Array,
+    options?: Partial<BinaryReadOptions>
+  ): Empty;
+  static fromJson(
+    jsonValue: JsonValue,
+    options?: Partial<JsonReadOptions>
+  ): Empty;
+  static fromJsonString(
+    jsonString: string,
+    options?: Partial<JsonReadOptions>
+  ): Empty;
+  static equals(
+    a: Empty | PlainMessage<Empty> | undefined,
+    b: Empty | PlainMessage<Empty> | undefined
+  ): boolean;
+}

package/dist/types/google/protobuf/field_mask_pb.d.ts

@@ -0,0 +1,243 @@
+import type {
+  BinaryReadOptions,
+  FieldList,
+  JsonReadOptions,
+  JsonValue,
+  JsonWriteOptions,
+  PartialMessage,
+  PlainMessage,
+} from "../../index.js";
+import { Message } from "../../index.js";
+/**
+ * `FieldMask` represents a set of symbolic field paths, for example:
+ *
+ *     paths: "f.a"
+ *     paths: "f.b.d"
+ *
+ * Here `f` represents a field in some root message, `a` and `b`
+ * fields in the message found in `f`, and `d` a field found in the
+ * message in `f.b`.
+ *
+ * Field masks are used to specify a subset of fields that should be
+ * returned by a get operation or modified by an update operation.
+ * Field masks also have a custom JSON encoding (see below).
+ *
+ * # Field Masks in Projections
+ *
+ * When used in the context of a projection, a response message or
+ * sub-message is filtered by the API to only contain those fields as
+ * specified in the mask. For example, if the mask in the previous
+ * example is applied to a response message as follows:
+ *
+ *     f {
+ *       a : 22
+ *       b {
+ *         d : 1
+ *         x : 2
+ *       }
+ *       y : 13
+ *     }
+ *     z: 8
+ *
+ * The result will not contain specific values for fields x,y and z
+ * (their value will be set to the default, and omitted in proto text
+ * output):
+ *
+ *
+ *     f {
+ *       a : 22
+ *       b {
+ *         d : 1
+ *       }
+ *     }
+ *
+ * A repeated field is not allowed except at the last position of a
+ * paths string.
+ *
+ * If a FieldMask object is not present in a get operation, the
+ * operation applies to all fields (as if a FieldMask of all fields
+ * had been specified).
+ *
+ * Note that a field mask does not necessarily apply to the
+ * top-level response message. In case of a REST get operation, the
+ * field mask applies directly to the response, but in case of a REST
+ * list operation, the mask instead applies to each individual message
+ * in the returned resource list. In case of a REST custom method,
+ * other definitions may be used. Where the mask applies will be
+ * clearly documented together with its declaration in the API.  In
+ * any case, the effect on the returned resource/resources is required
+ * behavior for APIs.
+ *
+ * # Field Masks in Update Operations
+ *
+ * A field mask in update operations specifies which fields of the
+ * targeted resource are going to be updated. The API is required
+ * to only change the values of the fields as specified in the mask
+ * and leave the others untouched. If a resource is passed in to
+ * describe the updated values, the API ignores the values of all
+ * fields not covered by the mask.
+ *
+ * If a repeated field is specified for an update operation, new values will
+ * be appended to the existing repeated field in the target resource. Note that
+ * a repeated field is only allowed in the last position of a `paths` string.
+ *
+ * If a sub-message is specified in the last position of the field mask for an
+ * update operation, then new value will be merged into the existing sub-message
+ * in the target resource.
+ *
+ * For example, given the target message:
+ *
+ *     f {
+ *       b {
+ *         d: 1
+ *         x: 2
+ *       }
+ *       c: [1]
+ *     }
+ *
+ * And an update message:
+ *
+ *     f {
+ *       b {
+ *         d: 10
+ *       }
+ *       c: [2]
+ *     }
+ *
+ * then if the field mask is:
+ *
+ *  paths: ["f.b", "f.c"]
+ *
+ * then the result will be:
+ *
+ *     f {
+ *       b {
+ *         d: 10
+ *         x: 2
+ *       }
+ *       c: [1, 2]
+ *     }
+ *
+ * An implementation may provide options to override this default behavior for
+ * repeated and message fields.
+ *
+ * In order to reset a field's value to the default, the field must
+ * be in the mask and set to the default value in the provided resource.
+ * Hence, in order to reset all fields of a resource, provide a default
+ * instance of the resource and set all fields in the mask, or do
+ * not provide a mask as described below.
+ *
+ * If a field mask is not present on update, the operation applies to
+ * all fields (as if a field mask of all fields has been specified).
+ * Note that in the presence of schema evolution, this may mean that
+ * fields the client does not know and has therefore not filled into
+ * the request will be reset to their default. If this is unwanted
+ * behavior, a specific service may require a client to always specify
+ * a field mask, producing an error if not.
+ *
+ * As with get operations, the location of the resource which
+ * describes the updated values in the request message depends on the
+ * operation kind. In any case, the effect of the field mask is
+ * required to be honored by the API.
+ *
+ * ## Considerations for HTTP REST
+ *
+ * The HTTP kind of an update operation which uses a field mask must
+ * be set to PATCH instead of PUT in order to satisfy HTTP semantics
+ * (PUT must only be used for full updates).
+ *
+ * # JSON Encoding of Field Masks
+ *
+ * In JSON, a field mask is encoded as a single string where paths are
+ * separated by a comma. Fields name in each path are converted
+ * to/from lower-camel naming conventions.
+ *
+ * As an example, consider the following message declarations:
+ *
+ *     message Profile {
+ *       User user = 1;
+ *       Photo photo = 2;
+ *     }
+ *     message User {
+ *       string display_name = 1;
+ *       string address = 2;
+ *     }
+ *
+ * In proto a field mask for `Profile` may look as such:
+ *
+ *     mask {
+ *       paths: "user.display_name"
+ *       paths: "photo"
+ *     }
+ *
+ * In JSON, the same mask is represented as below:
+ *
+ *     {
+ *       mask: "user.displayName,photo"
+ *     }
+ *
+ * # Field Masks and Oneof Fields
+ *
+ * Field masks treat fields in oneofs just as regular fields. Consider the
+ * following message:
+ *
+ *     message SampleMessage {
+ *       oneof test_oneof {
+ *         string name = 4;
+ *         SubMessage sub_message = 9;
+ *       }
+ *     }
+ *
+ * The field mask can be:
+ *
+ *     mask {
+ *       paths: "name"
+ *     }
+ *
+ * Or:
+ *
+ *     mask {
+ *       paths: "sub_message"
+ *     }
+ *
+ * Note that oneof type names ("test_oneof" in this case) cannot be used in
+ * paths.
+ *
+ * ## Field Mask Verification
+ *
+ * The implementation of any API method which has a FieldMask type field in the
+ * request should verify the included field paths, and return an
+ * `INVALID_ARGUMENT` error if any path is unmappable.
+ *
+ * @generated from message google.protobuf.FieldMask
+ */
+export declare class FieldMask extends Message<FieldMask> {
+  /**
+   * The set of field mask paths.
+   *
+   * @generated from field: repeated string paths = 1;
+   */
+  paths: string[];
+  constructor(data?: PartialMessage<FieldMask>);
+  toJson(options?: Partial<JsonWriteOptions>): JsonValue;
+  fromJson(json: JsonValue, options?: Partial<JsonReadOptions>): this;
+  static readonly runtime: import("../../private/proto-runtime.js").ProtoRuntime;
+  static readonly typeName = "google.protobuf.FieldMask";
+  static readonly fields: FieldList;
+  static fromBinary(
+    bytes: Uint8Array,
+    options?: Partial<BinaryReadOptions>
+  ): FieldMask;
+  static fromJson(
+    jsonValue: JsonValue,
+    options?: Partial<JsonReadOptions>
+  ): FieldMask;
+  static fromJsonString(
+    jsonString: string,
+    options?: Partial<JsonReadOptions>
+  ): FieldMask;
+  static equals(
+    a: FieldMask | PlainMessage<FieldMask> | undefined,
+    b: FieldMask | PlainMessage<FieldMask> | undefined
+  ): boolean;
+}

package/dist/types/google/protobuf/source_context_pb.d.ts

@@ -0,0 +1,44 @@
+import type {
+  BinaryReadOptions,
+  FieldList,
+  JsonReadOptions,
+  JsonValue,
+  PartialMessage,
+  PlainMessage,
+} from "../../index.js";
+import { Message } from "../../index.js";
+/**
+ * `SourceContext` represents information about the source of a
+ * protobuf element, like the file in which it is defined.
+ *
+ * @generated from message google.protobuf.SourceContext
+ */
+export declare class SourceContext extends Message<SourceContext> {
+  /**
+   * The path-qualified name of the .proto file that contained the associated
+   * protobuf element.  For example: `"google/protobuf/source_context.proto"`.
+   *
+   * @generated from field: string file_name = 1;
+   */
+  fileName: string;
+  constructor(data?: PartialMessage<SourceContext>);
+  static readonly runtime: import("../../private/proto-runtime.js").ProtoRuntime;
+  static readonly typeName = "google.protobuf.SourceContext";
+  static readonly fields: FieldList;
+  static fromBinary(
+    bytes: Uint8Array,
+    options?: Partial<BinaryReadOptions>
+  ): SourceContext;
+  static fromJson(
+    jsonValue: JsonValue,
+    options?: Partial<JsonReadOptions>
+  ): SourceContext;
+  static fromJsonString(
+    jsonString: string,
+    options?: Partial<JsonReadOptions>
+  ): SourceContext;
+  static equals(
+    a: SourceContext | PlainMessage<SourceContext> | undefined,
+    b: SourceContext | PlainMessage<SourceContext> | undefined
+  ): boolean;
+}

package/dist/types/google/protobuf/struct_pb.d.ts

@@ -0,0 +1,205 @@
+import type {
+  BinaryReadOptions,
+  FieldList,
+  JsonReadOptions,
+  JsonValue,
+  JsonWriteOptions,
+  PartialMessage,
+  PlainMessage,
+} from "../../index.js";
+import { Message } from "../../index.js";
+/**
+ * `NullValue` is a singleton enumeration to represent the null value for the
+ * `Value` type union.
+ *
+ *  The JSON representation for `NullValue` is JSON `null`.
+ *
+ * @generated from enum google.protobuf.NullValue
+ */
+export declare enum NullValue {
+  /**
+   * Null value.
+   *
+   * @generated from enum value: NULL_VALUE = 0;
+   */
+  NULL_VALUE = 0,
+}
+/**
+ * `Struct` represents a structured data value, consisting of fields
+ * which map to dynamically typed values. In some languages, `Struct`
+ * might be supported by a native representation. For example, in
+ * scripting languages like JS a struct is represented as an
+ * object. The details of that representation are described together
+ * with the proto support for the language.
+ *
+ * The JSON representation for `Struct` is JSON object.
+ *
+ * @generated from message google.protobuf.Struct
+ */
+export declare class Struct extends Message<Struct> {
+  /**
+   * Unordered map of dynamically typed values.
+   *
+   * @generated from field: map<string, google.protobuf.Value> fields = 1;
+   */
+  fields: {
+    [key: string]: Value;
+  };
+  constructor(data?: PartialMessage<Struct>);
+  toJson(options?: Partial<JsonWriteOptions>): JsonValue;
+  fromJson(json: JsonValue, options?: Partial<JsonReadOptions>): this;
+  static readonly runtime: import("../../private/proto-runtime.js").ProtoRuntime;
+  static readonly typeName = "google.protobuf.Struct";
+  static readonly fields: FieldList;
+  static fromBinary(
+    bytes: Uint8Array,
+    options?: Partial<BinaryReadOptions>
+  ): Struct;
+  static fromJson(
+    jsonValue: JsonValue,
+    options?: Partial<JsonReadOptions>
+  ): Struct;
+  static fromJsonString(
+    jsonString: string,
+    options?: Partial<JsonReadOptions>
+  ): Struct;
+  static equals(
+    a: Struct | PlainMessage<Struct> | undefined,
+    b: Struct | PlainMessage<Struct> | undefined
+  ): boolean;
+}
+/**
+ * `Value` represents a dynamically typed value which can be either
+ * null, a number, a string, a boolean, a recursive struct value, or a
+ * list of values. A producer of value is expected to set one of these
+ * variants. Absence of any variant indicates an error.
+ *
+ * The JSON representation for `Value` is JSON value.
+ *
+ * @generated from message google.protobuf.Value
+ */
+export declare class Value extends Message<Value> {
+  /**
+   * The kind of value.
+   *
+   * @generated from oneof google.protobuf.Value.kind
+   */
+  kind:
+    | {
+        /**
+         * Represents a null value.
+         *
+         * @generated from field: google.protobuf.NullValue null_value = 1;
+         */
+        value: NullValue;
+        case: "nullValue";
+      }
+    | {
+        /**
+         * Represents a double value.
+         *
+         * @generated from field: double number_value = 2;
+         */
+        value: number;
+        case: "numberValue";
+      }
+    | {
+        /**
+         * Represents a string value.
+         *
+         * @generated from field: string string_value = 3;
+         */
+        value: string;
+        case: "stringValue";
+      }
+    | {
+        /**
+         * Represents a boolean value.
+         *
+         * @generated from field: bool bool_value = 4;
+         */
+        value: boolean;
+        case: "boolValue";
+      }
+    | {
+        /**
+         * Represents a structured value.
+         *
+         * @generated from field: google.protobuf.Struct struct_value = 5;
+         */
+        value: Struct;
+        case: "structValue";
+      }
+    | {
+        /**
+         * Represents a repeated `Value`.
+         *
+         * @generated from field: google.protobuf.ListValue list_value = 6;
+         */
+        value: ListValue;
+        case: "listValue";
+      }
+    | {
+        case: undefined;
+        value?: undefined;
+      };
+  constructor(data?: PartialMessage<Value>);
+  toJson(options?: Partial<JsonWriteOptions>): JsonValue;
+  fromJson(json: JsonValue, options?: Partial<JsonReadOptions>): this;
+  static readonly runtime: import("../../private/proto-runtime.js").ProtoRuntime;
+  static readonly typeName = "google.protobuf.Value";
+  static readonly fields: FieldList;
+  static fromBinary(
+    bytes: Uint8Array,
+    options?: Partial<BinaryReadOptions>
+  ): Value;
+  static fromJson(
+    jsonValue: JsonValue,
+    options?: Partial<JsonReadOptions>
+  ): Value;
+  static fromJsonString(
+    jsonString: string,
+    options?: Partial<JsonReadOptions>
+  ): Value;
+  static equals(
+    a: Value | PlainMessage<Value> | undefined,
+    b: Value | PlainMessage<Value> | undefined
+  ): boolean;
+}
+/**
+ * `ListValue` is a wrapper around a repeated field of values.
+ *
+ * The JSON representation for `ListValue` is JSON array.
+ *
+ * @generated from message google.protobuf.ListValue
+ */
+export declare class ListValue extends Message<ListValue> {
+  /**
+   * Repeated field of dynamically typed values.
+   *
+   * @generated from field: repeated google.protobuf.Value values = 1;
+   */
+  values: Value[];
+  constructor(data?: PartialMessage<ListValue>);
+  toJson(options?: Partial<JsonWriteOptions>): JsonValue;
+  fromJson(json: JsonValue, options?: Partial<JsonReadOptions>): this;
+  static readonly runtime: import("../../private/proto-runtime.js").ProtoRuntime;
+  static readonly typeName = "google.protobuf.ListValue";
+  static readonly fields: FieldList;
+  static fromBinary(
+    bytes: Uint8Array,
+    options?: Partial<BinaryReadOptions>
+  ): ListValue;
+  static fromJson(
+    jsonValue: JsonValue,
+    options?: Partial<JsonReadOptions>
+  ): ListValue;
+  static fromJsonString(
+    jsonString: string,
+    options?: Partial<JsonReadOptions>
+  ): ListValue;
+  static equals(
+    a: ListValue | PlainMessage<ListValue> | undefined,
+    b: ListValue | PlainMessage<ListValue> | undefined
+  ): boolean;
+}