@eide/foir-cli 0.39.0 → 0.40.0

package/dist/cli.js

@@ -2785,8 +2785,14 @@ import {
   ListDeadLetterEntriesRequestSchema,
   RetryDeadLetterEntryRequestSchema,
   DismissDeadLetterEntryRequestSchema,
-  PublishOperationRequestSchema
+  PublishOperationRequestSchema,
+  OperationKind
 } from "@eide/foir-proto-ts/operations/v1/operations_pb";
+function toOperationKind(kind) {
+  if (kind === "query") return OperationKind.QUERY;
+  if (kind === "field") return OperationKind.FIELD;
+  return OperationKind.MUTATION;
+}
 function createOperationsMethods(client) {
   return {
     // ── CRUD ──────────────────────────────────────────────────
@@ -2828,7 +2834,15 @@ function createOperationsMethods(client) {
           configId: params.configId,
           supportsAsync: params.supportsAsync,
           callbackTtlSeconds: params.callbackTtlSeconds,
-          capabilities: params.capabilities ?? []
+          capabilities: params.capabilities ?? [],
+          kind: toOperationKind(params.kind),
+          attachedToModel: params.attachedToModel,
+          parentFields: params.parentFields ?? [],
+          cacheControl: params.cacheControl,
+          secretBindings: params.secretBindings ?? [],
+          requestTemplate: params.requestTemplate,
+          responseTransform: params.responseTransform,
+          allowInternalEndpoint: params.allowInternalEndpoint
         })
       );
       return resp.operation ?? null;
@@ -2850,7 +2864,15 @@ function createOperationsMethods(client) {
           isActive: params.isActive,
           supportsAsync: params.supportsAsync,
           callbackTtlSeconds: params.callbackTtlSeconds,
-          capabilities: params.capabilities
+          capabilities: params.capabilities,
+          kind: params.kind ? toOperationKind(params.kind) : void 0,
+          attachedToModel: params.attachedToModel,
+          parentFields: params.parentFields ?? [],
+          cacheControl: params.cacheControl,
+          secretBindings: params.secretBindings ?? [],
+          requestTemplate: params.requestTemplate,
+          responseTransform: params.responseTransform,
+          allowInternalEndpoint: params.allowInternalEndpoint
         })
       );
       return resp.operation ?? null;
@@ -5339,7 +5361,16 @@ async function reconcileOperations(client, configId, operations, operationBaseUr
         isActive: op.isActive,
         supportsAsync,
         callbackTtlSeconds: op.callbackTtlSeconds,
-        capabilities
+        capabilities,
+        // Resolver (kind=query/field) fields — partial update on the platform.
+        kind: op.kind,
+        attachedToModel: op.attachedToModel,
+        parentFields: op.parentFields,
+        cacheControl: op.cacheControl,
+        secretBindings: op.secretBindings,
+        requestTemplate: op.requestTemplate,
+        responseTransform: op.responseTransform,
+        allowInternalEndpoint: op.allowInternalEndpoint
       });
       summary.operations.updated++;
       summary.updatedOperationIds.push(ex.id);
@@ -5362,7 +5393,16 @@ async function reconcileOperations(client, configId, operations, operationBaseUr
         configId,
         supportsAsync,
         callbackTtlSeconds: op.callbackTtlSeconds,
-        capabilities
+        capabilities,
+        // Resolver (kind=query/field) fields.
+        kind: op.kind,
+        attachedToModel: op.attachedToModel,
+        parentFields: op.parentFields,
+        cacheControl: op.cacheControl,
+        secretBindings: op.secretBindings,
+        requestTemplate: op.requestTemplate,
+        responseTransform: op.responseTransform,
+        allowInternalEndpoint: op.allowInternalEndpoint
       });
       summary.operations.created++;
     }

package/dist/lib/config-helpers.d.ts

@@ -213,6 +213,67 @@ interface ApplyConfigOperationInput {
      * whose extension makes no back-channel calls.
      */
     capabilities?: string[];
+    /**
+     * How the operation surfaces in the public GraphQL schema and how it is
+     * dispatched. `mutation` (default) is the existing behaviour: an
+     * `executeXxx` root mutation dispatched via the worker queue. `query`
+     * registers a root Query field resolved synchronously in-process.
+     * `field` attaches a resolver field to `attachedToModel`, batched per
+     * request. QUERY/FIELD operations are the new "resolver" kind and use
+     * `requestTemplate` / `responseTransform` to call an upstream endpoint.
+     */
+    kind?: 'mutation' | 'query' | 'field';
+    /**
+     * Model key the resolver field attaches to. Required (and only meaningful)
+     * when `kind === 'field'`.
+     */
+    attachedToModel?: string;
+    /**
+     * Field path(s) under `attachedToModel` that this resolver populates.
+     * FIELD only.
+     */
+    parentFields?: string[];
+    /**
+     * Cache-control for QUERY / FIELD resolver results. `scope` selects the
+     * cache audience; `maxAge` is the freshness window in seconds.
+     */
+    cacheControl?: {
+        scope: 'PUBLIC' | 'PRIVATE' | 'NO_CACHE';
+        maxAge?: number;
+    };
+    /**
+     * Maps `{{secret.NAME}}` placeholders in the request template to
+     * PROJECT-owned secrets. The dispatcher resolves plaintext at call time;
+     * it is never stored on the operation row.
+     */
+    secretBindings?: Array<{
+        name: string;
+        secretRef: string;
+    }>;
+    /**
+     * Shapes the outbound HTTP request for QUERY / FIELD operations. Template
+     * variables `{{input.X}}`, `{{parent.X}}`, `{{secret.NAME}}`,
+     * `{{context.X}}` are interpolated at dispatch time. Set `batchCapable`
+     * to send one upstream request for the whole deduped input set.
+     */
+    requestTemplate?: {
+        method?: string;
+        pathTemplate?: string;
+        query?: Record<string, string>;
+        headers?: Record<string, string>;
+        bodyTemplate?: string;
+        batchCapable?: boolean;
+    };
+    /**
+     * jq-style transform applied to the upstream response before it is
+     * returned to the caller. QUERY / FIELD only.
+     */
+    responseTransform?: string;
+    /**
+     * Allow the resolver to call an internal (private-network) endpoint.
+     * Off by default; only meaningful for QUERY / FIELD operations.
+     */
+    allowInternalEndpoint?: boolean;
 }
 interface ApplyConfigSegmentInput {
     key: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eide/foir-cli",
-  "version": "0.39.0",
+  "version": "0.40.0",
   "description": "Universal platform CLI for Foir platform",
   "type": "module",
   "publishConfig": {
@@ -50,7 +50,7 @@
     "@bufbuild/protovalidate": "^1.1.1",
     "@connectrpc/connect": "^2.0.0",
     "@connectrpc/connect-node": "^2.0.0",
-    "@eide/foir-proto-ts": "^0.90.0",
+    "@eide/foir-proto-ts": "^0.91.0",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "dotenv": "^16.4.5",