@eide/foir-proto-ts 0.89.0 → 0.91.0

package/src/operations/v1/operations_pb.d.ts

@@ -13,6 +13,98 @@ import type { BreakingChange, PublishStatus } from "../../publish/v1/publish_pb.
  */
 export declare const file_operations_v1_operations: GenFile;
 
+/**
+ * SecretBinding maps a {{secret.NAME}} placeholder in an operation's
+ * request template to a PROJECT-owned SecretsService secret. The
+ * dispatcher resolves the plaintext at call time; it is never stored on
+ * the operation row.
+ *
+ * @generated from message operations.v1.SecretBinding
+ */
+export declare type SecretBinding = Message<"operations.v1.SecretBinding"> & {
+  /**
+   * @generated from field: string name = 1;
+   */
+  name: string;
+
+  /**
+   * SecretsService secret ref. Must be PROJECT-owned and in the same
+   * (tenant, project) as the operation.
+   *
+   * @generated from field: string secret_ref = 2;
+   */
+  secretRef: string;
+};
+
+/**
+ * Describes the message operations.v1.SecretBinding.
+ * Use `create(SecretBindingSchema)` to create a new message.
+ */
+export declare const SecretBindingSchema: GenMessage<SecretBinding>;
+
+/**
+ * RequestTemplate shapes the outbound HTTP request for QUERY / FIELD
+ * operations. Template variables {{input.X}}, {{parent.X}},
+ * {{secret.NAME}}, {{context.X}} are interpolated at dispatch time.
+ *
+ * @generated from message operations.v1.RequestTemplate
+ */
+export declare type RequestTemplate = Message<"operations.v1.RequestTemplate"> & {
+  /**
+   * GET / POST / PUT / DELETE / PATCH. Defaults to POST.
+   *
+   * @generated from field: optional string method = 1;
+   */
+  method?: string | undefined;
+
+  /**
+   * Appended to operation.endpoint. Template variables allowed.
+   *
+   * @generated from field: optional string path_template = 2;
+   */
+  pathTemplate?: string | undefined;
+
+  /**
+   * Static + templated query params merged into the URL.
+   *
+   * @generated from field: map<string, string> query = 3;
+   */
+  query: { [key: string]: string };
+
+  /**
+   * Static + templated headers. X-Foir-Token (Ed25519) and X-Foir-Context
+   * are always set by the platform; these names are reserved.
+   *
+   * @generated from field: map<string, string> headers = 4;
+   */
+  headers: { [key: string]: string };
+
+  /**
+   * When set, replaces the default JSON-encoded input body.
+   *
+   * @generated from field: optional string body_template = 5;
+   */
+  bodyTemplate?: string | undefined;
+
+  /**
+   * FIELD-resolver batching opt-in. When true, ResolveOperationBatch sends
+   * ONE upstream request for the whole deduped input set: body_template
+   * receives the array as {{items}} (each element {input, parent}), the
+   * upstream returns an array, and response_transform maps it back by
+   * index. Default false = bounded-concurrency fan-out, no upstream
+   * contract change.
+   *
+   * @generated from field: optional bool batch_capable = 6;
+   */
+  batchCapable?: boolean | undefined;
+};
+
+/**
+ * Describes the message operations.v1.RequestTemplate.
+ * Use `create(RequestTemplateSchema)` to create a new message.
+ */
+export declare const RequestTemplateSchema: GenMessage<RequestTemplate>;
+
 /**
  * @generated from message operations.v1.Operation
  */
@@ -167,6 +259,72 @@ export declare type Operation = Message<"operations.v1.Operation"> & {
    */
   capabilities: string[];
 
+  /**
+   * @generated from field: operations.v1.OperationKind kind = 26;
+   */
+  kind: OperationKind;
+
+  /**
+   * KIND_FIELD only — the model key whose generated GraphQL type gets this
+   * resolver attached as a field. Rejected for QUERY / MUTATION.
+   *
+   * @generated from field: optional string attached_to_model = 27;
+   */
+  attachedToModel?: string | undefined;
+
+  /**
+   * KIND_FIELD only — parent scalar fields projected into the request
+   * payload as parent:{...}. Read from the loaded record source regardless
+   * of the client's selection set. Reference / lazily-resolved fields are
+   * rejected at the write boundary.
+   *
+   * @generated from field: repeated string parent_fields = 28;
+   */
+  parentFields: string[];
+
+  /**
+   * Cache hint for QUERY / FIELD, honoured by the response cache. Ignored
+   * for MUTATION (mutations are never cached).
+   *
+   * @generated from field: optional google.protobuf.Struct cache_control = 29;
+   */
+  cacheControl?: JsonObject | undefined;
+
+  /**
+   * Secret references interpolated into the outbound request. Resolved at
+   * dispatch via SecretsService; never stored in plaintext on this row.
+   *
+   * @generated from field: repeated operations.v1.SecretBinding secret_bindings = 31;
+   */
+  secretBindings: SecretBinding[];
+
+  /**
+   * Outbound request shaping for QUERY / FIELD. Body defaults to the
+   * JSON-encoded input when unset.
+   *
+   * @generated from field: optional operations.v1.RequestTemplate request_template = 32;
+   */
+  requestTemplate?: RequestTemplate | undefined;
+
+  /**
+   * Optional jq program (gojq) applied to the upstream response before
+   * validation against output_schema. Empty = response used as-is. When
+   * set, replaces the legacy {success,result} unwrap heuristic. Guardrails:
+   * 4 KB program cap, 250 ms execution cap, 5 MB pre-transform size cap.
+   *
+   * @generated from field: optional string response_transform = 33;
+   */
+  responseTransform?: string | undefined;
+
+  /**
+   * Allows endpoint to resolve to a private/internal address (RFC1918,
+   * *.internal, link-local). Default false. TENANT-admin-only capability;
+   * cloud-metadata IPs are rejected even when true.
+   *
+   * @generated from field: optional bool allow_internal_endpoint = 34;
+   */
+  allowInternalEndpoint?: boolean | undefined;
+
   /**
    * Attribution.
    *
@@ -650,42 +808,27 @@ export declare const DeadLetterStatsSchema: GenMessage<DeadLetterStats>;
  */
 export declare type ListOperationsRequest = Message<"operations.v1.ListOperationsRequest"> & {
   /**
-   * @generated from field: optional string category = 1;
-   */
-  category?: string | undefined;
-
-  /**
-   * @generated from field: optional bool is_active = 2;
+   * @generated from field: optional google.protobuf.Struct where = 1;
    */
-  isActive?: boolean | undefined;
+  where?: JsonObject | undefined;
 
   /**
-   * @generated from field: optional string search = 3;
-   */
-  search?: string | undefined;
-
-  /**
-   * @generated from field: optional string config_id = 4;
-   */
-  configId?: string | undefined;
-
-  /**
-   * @generated from field: optional string after = 5;
+   * @generated from field: optional string after = 2;
    */
   after?: string | undefined;
 
   /**
-   * @generated from field: optional string before = 6;
+   * @generated from field: optional string before = 3;
    */
   before?: string | undefined;
 
   /**
-   * @generated from field: optional int32 first = 7;
+   * @generated from field: optional int32 first = 4;
    */
   first?: number | undefined;
 
   /**
-   * @generated from field: optional int32 last = 8;
+   * @generated from field: optional int32 last = 5;
    */
   last?: number | undefined;
 };
@@ -874,6 +1017,48 @@ export declare type CreateOperationRequest = Message<"operations.v1.CreateOperat
    * @generated from field: repeated string capabilities = 22;
    */
   capabilities: string[];
+
+  /**
+   * Resolver fields — see Operation for semantics.
+   *
+   * @generated from field: operations.v1.OperationKind kind = 23;
+   */
+  kind: OperationKind;
+
+  /**
+   * @generated from field: optional string attached_to_model = 24;
+   */
+  attachedToModel?: string | undefined;
+
+  /**
+   * @generated from field: repeated string parent_fields = 25;
+   */
+  parentFields: string[];
+
+  /**
+   * @generated from field: optional google.protobuf.Struct cache_control = 26;
+   */
+  cacheControl?: JsonObject | undefined;
+
+  /**
+   * @generated from field: repeated operations.v1.SecretBinding secret_bindings = 27;
+   */
+  secretBindings: SecretBinding[];
+
+  /**
+   * @generated from field: optional operations.v1.RequestTemplate request_template = 28;
+   */
+  requestTemplate?: RequestTemplate | undefined;
+
+  /**
+   * @generated from field: optional string response_transform = 29;
+   */
+  responseTransform?: string | undefined;
+
+  /**
+   * @generated from field: optional bool allow_internal_endpoint = 30;
+   */
+  allowInternalEndpoint?: boolean | undefined;
 };
 
 /**
@@ -994,6 +1179,48 @@ export declare type UpdateOperationRequest = Message<"operations.v1.UpdateOperat
    * @generated from field: repeated string capabilities = 19;
    */
   capabilities: string[];
+
+  /**
+   * Resolver fields — see Operation for semantics. Absent = unchanged.
+   *
+   * @generated from field: optional operations.v1.OperationKind kind = 20;
+   */
+  kind?: OperationKind | undefined;
+
+  /**
+   * @generated from field: optional string attached_to_model = 21;
+   */
+  attachedToModel?: string | undefined;
+
+  /**
+   * @generated from field: repeated string parent_fields = 22;
+   */
+  parentFields: string[];
+
+  /**
+   * @generated from field: optional google.protobuf.Struct cache_control = 23;
+   */
+  cacheControl?: JsonObject | undefined;
+
+  /**
+   * @generated from field: repeated operations.v1.SecretBinding secret_bindings = 24;
+   */
+  secretBindings: SecretBinding[];
+
+  /**
+   * @generated from field: optional operations.v1.RequestTemplate request_template = 25;
+   */
+  requestTemplate?: RequestTemplate | undefined;
+
+  /**
+   * @generated from field: optional string response_transform = 26;
+   */
+  responseTransform?: string | undefined;
+
+  /**
+   * @generated from field: optional bool allow_internal_endpoint = 27;
+   */
+  allowInternalEndpoint?: boolean | undefined;
 };
 
 /**
@@ -1158,36 +1385,191 @@ export declare type ExecuteOperationResponse = Message<"operations.v1.ExecuteOpe
 export declare const ExecuteOperationResponseSchema: GenMessage<ExecuteOperationResponse>;
 
 /**
- * @generated from message operations.v1.ListOperationExecutionsRequest
+ * One item in a resolver batch.
+ *
+ * @generated from message operations.v1.BatchItem
  */
-export declare type ListOperationExecutionsRequest = Message<"operations.v1.ListOperationExecutionsRequest"> & {
+export declare type BatchItem = Message<"operations.v1.BatchItem"> & {
+  /**
+   * Dataloader's canonical key; echoed back in BatchResult.key.
+   *
+   * @generated from field: string key = 1;
+   */
+  key: string;
+
+  /**
+   * @generated from field: optional google.protobuf.Struct input = 2;
+   */
+  input?: JsonObject | undefined;
+
+  /**
+   * KIND_FIELD parent_fields payload (parent:{...}).
+   *
+   * @generated from field: optional google.protobuf.Struct parent = 3;
+   */
+  parent?: JsonObject | undefined;
+};
+
+/**
+ * Describes the message operations.v1.BatchItem.
+ * Use `create(BatchItemSchema)` to create a new message.
+ */
+export declare const BatchItemSchema: GenMessage<BatchItem>;
+
+/**
+ * @generated from message operations.v1.BatchResult
+ */
+export declare type BatchResult = Message<"operations.v1.BatchResult"> & {
+  /**
+   * @generated from field: string key = 1;
+   */
+  key: string;
+
+  /**
+   * Null when this item failed.
+   *
+   * @generated from field: optional google.protobuf.Struct result = 2;
+   */
+  result?: JsonObject | undefined;
+
+  /**
+   * Per-item error, surfaced as a field error at that GraphQL position
+   * only; the rest of the batch still returns.
+   *
+   * @generated from field: optional string error = 3;
+   */
+  error?: string | undefined;
+};
+
+/**
+ * Describes the message operations.v1.BatchResult.
+ * Use `create(BatchResultSchema)` to create a new message.
+ */
+export declare const BatchResultSchema: GenMessage<BatchResult>;
+
+/**
+ * @generated from message operations.v1.ResolveOperationBatchRequest
+ */
+export declare type ResolveOperationBatchRequest = Message<"operations.v1.ResolveOperationBatchRequest"> & {
   /**
    * @generated from field: string operation_key = 1;
    */
   operationKey: string;
 
   /**
-   * @generated from field: optional string status = 2;
+   * @generated from field: repeated operations.v1.BatchItem items = 2;
    */
-  status?: string | undefined;
+  items: BatchItem[];
+
+  /**
+   * @generated from field: optional string customer_id = 3;
+   */
+  customerId?: string | undefined;
+};
+
+/**
+ * Describes the message operations.v1.ResolveOperationBatchRequest.
+ * Use `create(ResolveOperationBatchRequestSchema)` to create a new message.
+ */
+export declare const ResolveOperationBatchRequestSchema: GenMessage<ResolveOperationBatchRequest>;
+
+/**
+ * @generated from message operations.v1.ResolveOperationBatchResponse
+ */
+export declare type ResolveOperationBatchResponse = Message<"operations.v1.ResolveOperationBatchResponse"> & {
+  /**
+   * @generated from field: repeated operations.v1.BatchResult results = 1;
+   */
+  results: BatchResult[];
+};
+
+/**
+ * Describes the message operations.v1.ResolveOperationBatchResponse.
+ * Use `create(ResolveOperationBatchResponseSchema)` to create a new message.
+ */
+export declare const ResolveOperationBatchResponseSchema: GenMessage<ResolveOperationBatchResponse>;
+
+/**
+ * Single-item convenience for KIND_QUERY (root, non-list). Shares the
+ * batch handler internally.
+ *
+ * @generated from message operations.v1.ResolveOperationRequest
+ */
+export declare type ResolveOperationRequest = Message<"operations.v1.ResolveOperationRequest"> & {
+  /**
+   * @generated from field: string operation_key = 1;
+   */
+  operationKey: string;
+
+  /**
+   * @generated from field: optional google.protobuf.Struct input = 2;
+   */
+  input?: JsonObject | undefined;
+
+  /**
+   * @generated from field: optional google.protobuf.Struct parent = 3;
+   */
+  parent?: JsonObject | undefined;
 
   /**
-   * @generated from field: optional string after = 3;
+   * @generated from field: optional string customer_id = 4;
+   */
+  customerId?: string | undefined;
+};
+
+/**
+ * Describes the message operations.v1.ResolveOperationRequest.
+ * Use `create(ResolveOperationRequestSchema)` to create a new message.
+ */
+export declare const ResolveOperationRequestSchema: GenMessage<ResolveOperationRequest>;
+
+/**
+ * @generated from message operations.v1.ResolveOperationResponse
+ */
+export declare type ResolveOperationResponse = Message<"operations.v1.ResolveOperationResponse"> & {
+  /**
+   * @generated from field: optional google.protobuf.Struct result = 1;
+   */
+  result?: JsonObject | undefined;
+
+  /**
+   * @generated from field: optional string error = 2;
+   */
+  error?: string | undefined;
+};
+
+/**
+ * Describes the message operations.v1.ResolveOperationResponse.
+ * Use `create(ResolveOperationResponseSchema)` to create a new message.
+ */
+export declare const ResolveOperationResponseSchema: GenMessage<ResolveOperationResponse>;
+
+/**
+ * @generated from message operations.v1.ListOperationExecutionsRequest
+ */
+export declare type ListOperationExecutionsRequest = Message<"operations.v1.ListOperationExecutionsRequest"> & {
+  /**
+   * @generated from field: optional google.protobuf.Struct where = 1;
+   */
+  where?: JsonObject | undefined;
+
+  /**
+   * @generated from field: optional string after = 2;
    */
   after?: string | undefined;
 
   /**
-   * @generated from field: optional string before = 4;
+   * @generated from field: optional string before = 3;
    */
   before?: string | undefined;
 
   /**
-   * @generated from field: optional int32 first = 5;
+   * @generated from field: optional int32 first = 4;
    */
   first?: number | undefined;
 
   /**
-   * @generated from field: optional int32 last = 6;
+   * @generated from field: optional int32 last = 5;
    */
   last?: number | undefined;
 };
@@ -1268,32 +1650,27 @@ export declare const GetOperationExecutionStatsResponseSchema: GenMessage<GetOpe
  */
 export declare type ListDeadLetterEntriesRequest = Message<"operations.v1.ListDeadLetterEntriesRequest"> & {
   /**
-   * @generated from field: optional string operation_key = 1;
+   * @generated from field: optional google.protobuf.Struct where = 1;
    */
-  operationKey?: string | undefined;
+  where?: JsonObject | undefined;
 
   /**
-   * @generated from field: optional string status = 2;
-   */
-  status?: string | undefined;
-
-  /**
-   * @generated from field: optional string after = 3;
+   * @generated from field: optional string after = 2;
    */
   after?: string | undefined;
 
   /**
-   * @generated from field: optional string before = 4;
+   * @generated from field: optional string before = 3;
    */
   before?: string | undefined;
 
   /**
-   * @generated from field: optional int32 first = 5;
+   * @generated from field: optional int32 first = 4;
    */
   first?: number | undefined;
 
   /**
-   * @generated from field: optional int32 last = 6;
+   * @generated from field: optional int32 last = 5;
    */
   last?: number | undefined;
 };
@@ -2567,6 +2944,47 @@ export declare type CancelScheduledOperationPublishResponse = Message<"operation
  */
 export declare const CancelScheduledOperationPublishResponseSchema: GenMessage<CancelScheduledOperationPublishResponse>;
 
+/**
+ * OperationKind discriminates how an operation surfaces in the public
+ * GraphQL schema and how it is dispatched.
+ *   MUTATION — existing behaviour: executeXxx root mutation, async-capable,
+ *              dispatched via the worker queue.
+ *   QUERY    — root Query field, cacheable, dispatched synchronously
+ *              in-process via ResolveOperation.
+ *   FIELD    — field on a model object type, cacheable, batched per request
+ *              via ResolveOperationBatch.
+ * Rows written before this enum existed carry UNSPECIFIED; the platform
+ * treats UNSPECIFIED as MUTATION for backwards-compatibility.
+ *
+ * @generated from enum operations.v1.OperationKind
+ */
+export enum OperationKind {
+  /**
+   * @generated from enum value: OPERATION_KIND_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * @generated from enum value: OPERATION_KIND_MUTATION = 1;
+   */
+  MUTATION = 1,
+
+  /**
+   * @generated from enum value: OPERATION_KIND_QUERY = 2;
+   */
+  QUERY = 2,
+
+  /**
+   * @generated from enum value: OPERATION_KIND_FIELD = 3;
+   */
+  FIELD = 3,
+}
+
+/**
+ * Describes the enum operations.v1.OperationKind.
+ */
+export declare const OperationKindSchema: GenEnum<OperationKind>;
+
 /**
  * Execution mode.
  *
@@ -2650,6 +3068,25 @@ export declare const OperationsService: GenService<{
     input: typeof ExecuteOperationRequestSchema;
     output: typeof ExecuteOperationResponseSchema;
   },
+  /**
+   * Synchronous in-process dispatch for KIND_QUERY / KIND_FIELD. No queue,
+   * no execution row, no DLQ/watchdog. See message comments.
+   *
+   * @generated from rpc operations.v1.OperationsService.ResolveOperation
+   */
+  resolveOperation: {
+    methodKind: "unary";
+    input: typeof ResolveOperationRequestSchema;
+    output: typeof ResolveOperationResponseSchema;
+  },
+  /**
+   * @generated from rpc operations.v1.OperationsService.ResolveOperationBatch
+   */
+  resolveOperationBatch: {
+    methodKind: "unary";
+    input: typeof ResolveOperationBatchRequestSchema;
+    output: typeof ResolveOperationBatchResponseSchema;
+  },
   /**
    * @generated from rpc operations.v1.OperationsService.ListOperationExecutions
    */