shop-cli 0.1.1 → 0.1.2

package/dist/cli/approvalRequired.d.ts

@@ -0,0 +1,30 @@
+import type { OutputFormat } from './output';
+type ApprovalRequiredAction = Record<string, unknown> & {
+    type?: unknown;
+    status?: unknown;
+    id?: unknown;
+    executed?: unknown;
+    contentType?: unknown;
+    body?: unknown;
+};
+export type ApprovalRequiredInfo = {
+    code: 'APPROVAL_REQUIRED' | 'ACTION_REQUIRED';
+    action: ApprovalRequiredAction;
+};
+/**
+ * Generic GraphQL proxy contract for deferred execution.
+ *
+ * When a proxy requires human approval before executing an operation, it may return a
+ * standard GraphQL response with an `errors[]` entry that includes:
+ * - `error.extensions.code === "APPROVAL_REQUIRED"` (also accepts "ACTION_REQUIRED")
+ * - `error.extensions.action` describing the approval workflow
+ *
+ * In this case, the operation has NOT executed yet. shop-cli surfaces a purpose-built
+ * error payload and exits with code 3.
+ */
+export declare const findApprovalRequired: (errors: unknown[] | undefined | null) => ApprovalRequiredInfo | undefined;
+export declare const maybeThrowApprovalRequired: ({ format, errors, }: {
+    format: OutputFormat;
+    errors: unknown[] | undefined | null;
+}) => void;
+export {};

package/dist/cli/approvalRequired.js

@@ -0,0 +1,87 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var approvalRequired_exports = {};
+__export(approvalRequired_exports, {
+  findApprovalRequired: () => findApprovalRequired,
+  maybeThrowApprovalRequired: () => maybeThrowApprovalRequired
+});
+module.exports = __toCommonJS(approvalRequired_exports);
+var import_output = require("./output");
+var import_errors = require("./errors");
+const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const findApprovalRequired = (errors) => {
+  if (!Array.isArray(errors)) return void 0;
+  for (const err of errors) {
+    if (!isPlainObject(err)) continue;
+    const extensions = err.extensions;
+    if (!isPlainObject(extensions)) continue;
+    const code = extensions.code;
+    if (code !== "APPROVAL_REQUIRED" && code !== "ACTION_REQUIRED") continue;
+    const action = extensions.action;
+    if (!isPlainObject(action)) continue;
+    if (action.type !== "approval") continue;
+    if (action.status !== "pending") continue;
+    if (action.executed !== false) continue;
+    if (typeof action.id !== "string" || !action.id.trim()) continue;
+    if (typeof action.body !== "string" || !action.body.trim()) continue;
+    return { code, action };
+  }
+  return void 0;
+};
+const writeHumanApprovalMessage = ({ action }) => {
+  const id = String(action.id);
+  const body = typeof action.body === "string" ? action.body.trim() : "";
+  const lines = [
+    "Approval required: this operation was NOT executed yet.",
+    `Approval id: ${id}`,
+    "Execution will happen after approval is granted (out-of-band)."
+  ];
+  if (body) {
+    lines.push("", body);
+  }
+  process.stderr.write(lines.join("\n").trimEnd() + "\n");
+};
+const maybeThrowApprovalRequired = ({
+  format,
+  errors
+}) => {
+  const approval = findApprovalRequired(errors);
+  if (!approval) return;
+  if (format === "json" || format === "jsonl") {
+    (0, import_output.printJsonError)(
+      {
+        ok: false,
+        error: {
+          code: approval.code,
+          action: approval.action
+        }
+      },
+      format === "json"
+    );
+  } else {
+    writeHumanApprovalMessage(approval);
+  }
+  throw new import_errors.CliError("", 3, { silent: true });
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  findApprovalRequired,
+  maybeThrowApprovalRequired
+});
+//# sourceMappingURL=approvalRequired.js.map

package/dist/cli/errors.d.ts

@@ -1,4 +1,7 @@
 export declare class CliError extends Error {
     exitCode: number;
-    constructor(message: string, exitCode?: number);
+    silent: boolean;
+    constructor(message: string, exitCode?: number, { silent }?: {
+        silent?: boolean;
+    });
 }

package/dist/cli/errors.js

@@ -23,9 +23,11 @@ __export(errors_exports, {
 module.exports = __toCommonJS(errors_exports);
 class CliError extends Error {
   exitCode;
-  constructor(message, exitCode = 1) {
+  silent;
+  constructor(message, exitCode = 1, { silent = false } = {}) {
     super(message);
     this.exitCode = exitCode;
+    this.silent = silent;
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/cli/router.js

@@ -29,6 +29,7 @@ var import_admin_2026_04 = require("../generated/admin-2026-04");
 var import_admin_2026_042 = require("../generated/admin-2026-04");
 var import_errors = require("./errors");
 var import_output = require("./output");
+var import_approvalRequired = require("./approvalRequired");
 var import_introspection = require("./introspection");
 var import_format = require("./introspection/format");
 var import_resources = require("./introspection/resources");
@@ -442,6 +443,7 @@ const runQuery = async (ctx, request) => {
     return await ctx.client.query(request);
   } catch (err) {
     if (err instanceof import_admin_2026_042.GenqlError) {
+      (0, import_approvalRequired.maybeThrowApprovalRequired)({ format: ctx.format, errors: err.errors });
       if (ctx.warnMissingAccessToken && hasNotAuthorizedError(err)) {
         console.error("SHOPIFY_ACCESS_TOKEN not set");
       }
@@ -461,6 +463,7 @@ const runMutation = async (ctx, request) => {
     return await ctx.client.mutation(request);
   } catch (err) {
     if (err instanceof import_admin_2026_042.GenqlError) {
+      (0, import_approvalRequired.maybeThrowApprovalRequired)({ format: ctx.format, errors: err.errors });
       if (ctx.warnMissingAccessToken && hasNotAuthorizedError(err)) {
         console.error("SHOPIFY_ACCESS_TOKEN not set");
       }

package/dist/cli/verbs/graphql.js

@@ -26,6 +26,7 @@ var import_node_fs = require("node:fs");
 var import_errors = require("../errors");
 var import_output = require("../output");
 var import_router = require("../router");
+var import_approvalRequired = require("../approvalRequired");
 var import_adminClient = require("../../adminClient");
 var import_graphqlValidator = require("../../graphqlValidator");
 const printHelp = () => {
@@ -272,6 +273,7 @@ const runGraphQL = async ({
     throw new import_errors.CliError(`GraphQL request failed: ${err.message}`, 1);
   }
   if (response.errors && response.errors.length > 0) {
+    (0, import_approvalRequired.maybeThrowApprovalRequired)({ format: ctx.format, errors: response.errors });
     (0, import_output.printJsonError)({ errors: response.errors, data: response.data }, ctx.format !== "raw");
     throw new import_errors.CliError("GraphQL request returned errors", 1);
   }

package/dist/cli.js

@@ -224,12 +224,12 @@ Missing <verb> for "${resource}"`, 2);
 See help:
   ${command} ${resource} ${verb} --help`;
     }
-    throw new import_errors.CliError(message, err.exitCode);
+    throw new import_errors.CliError(message, err.exitCode, { silent: err.silent });
   }
 };
 main().catch((err) => {
   if (err instanceof import_errors.CliError) {
-    console.error(err.message);
+    if (!err.silent) console.error(err.message);
     process.exit(err.exitCode);
   }
   console.error(err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shop-cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "An agent-friendly command-line interface for managing Shopify stores",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",