shop-cli 0.1.0

package/dist/cli/verbs/publications.d.ts

@@ -0,0 +1,6 @@
+import { type CommandContext } from '../router';
+export declare const runPublications: ({ ctx, verb, argv, }: {
+    ctx: CommandContext;
+    verb: string;
+    argv: string[];
+}) => Promise<void>;

package/dist/cli/verbs/publications.js

@@ -0,0 +1,256 @@
+"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 publications_exports = {};
+__export(publications_exports, {
+  runPublications: () => runPublications
+});
+module.exports = __toCommonJS(publications_exports);
+var import_errors = require("../errors");
+var import_gid = require("../gid");
+var import_input = require("../input");
+var import_output = require("../output");
+var import_router = require("../router");
+var import_select = require("../selection/select");
+var import_userErrors = require("../userErrors");
+var import_resolvePublicationId = require("../workflows/publications/resolvePublicationId");
+var import_shared = require("./_shared");
+const publicationSummarySelection = {
+  id: true,
+  name: true,
+  autoPublish: true,
+  catalog: { title: true }
+};
+const publicationFullSelection = {
+  ...publicationSummarySelection
+};
+const getPublicationSelection = (view) => {
+  if (view === "ids") return { id: true };
+  if (view === "full") return publicationFullSelection;
+  if (view === "raw") return {};
+  return publicationSummarySelection;
+};
+const runPublications = async ({
+  ctx,
+  verb,
+  argv
+}) => {
+  if (argv.includes("--help") || argv.includes("-h")) {
+    console.log(
+      [
+        "Usage:",
+        "  shop publications <verb> [flags]",
+        "",
+        "Verbs:",
+        "  resolve|create|get|list|count|published-products-count|update|delete",
+        "",
+        "Common output flags:",
+        "  --view summary|ids|full|raw",
+        "  --select <path>        (repeatable; dot paths; adds to base view selection)",
+        "  --selection <graphql>  (selection override; can be @file.gql)"
+      ].join("\n")
+    );
+    return;
+  }
+  if (verb === "count") {
+    const args = (0, import_router.parseStandardArgs)({ argv, extraOptions: { limit: { type: "string" } } });
+    const type = args.type;
+    const limitRaw = args.limit;
+    const limit = limitRaw === void 0 || limitRaw === null || limitRaw === "" ? void 0 : Number(limitRaw);
+    if (limit !== void 0 && (!Number.isFinite(limit) || limit <= 0)) {
+      throw new import_errors.CliError("--limit must be a positive number", 2);
+    }
+    const result = await (0, import_router.runQuery)(ctx, {
+      publicationsCount: {
+        __args: {
+          ...type ? { catalogType: type } : {},
+          ...limit !== void 0 ? { limit: Math.floor(limit) } : {}
+        },
+        count: true,
+        precision: true
+      }
+    });
+    if (result === void 0) return;
+    if (ctx.quiet) return console.log(result.publicationsCount?.count ?? "");
+    (0, import_output.printJson)(result.publicationsCount, ctx.format !== "raw");
+    return;
+  }
+  if (verb === "published-products-count") {
+    const args = (0, import_router.parseStandardArgs)({ argv, extraOptions: { limit: { type: "string" }, "publication-id": { type: "string" } } });
+    const raw = args["publication-id"];
+    if (!raw) throw new import_errors.CliError("Missing --publication-id", 2);
+    const publicationId = (0, import_gid.coerceGid)(raw, "Publication");
+    const limitRaw = args.limit;
+    const limit = limitRaw === void 0 || limitRaw === null || limitRaw === "" ? void 0 : Number(limitRaw);
+    if (limit !== void 0 && (!Number.isFinite(limit) || limit <= 0)) {
+      throw new import_errors.CliError("--limit must be a positive number", 2);
+    }
+    const result = await (0, import_router.runQuery)(ctx, {
+      publishedProductsCount: {
+        __args: {
+          publicationId,
+          ...limit !== void 0 ? { limit: Math.floor(limit) } : {}
+        },
+        count: true,
+        precision: true
+      }
+    });
+    if (result === void 0) return;
+    if (ctx.quiet) return console.log(result.publishedProductsCount?.count ?? "");
+    (0, import_output.printJson)(result.publishedProductsCount, ctx.format !== "raw");
+    return;
+  }
+  if (verb === "resolve") {
+    const args = (0, import_router.parseStandardArgs)({
+      argv,
+      extraOptions: {
+        publication: { type: "string" }
+      }
+    });
+    if (ctx.dryRun) {
+      await (0, import_resolvePublicationId.listPublications)(ctx);
+      return;
+    }
+    const identifier = args.publication;
+    if (!identifier) throw new import_errors.CliError("Missing --publication <name|gid|num>", 2);
+    const publications = await (0, import_resolvePublicationId.listPublications)(ctx);
+    const id = (0, import_resolvePublicationId.resolvePublicationIdFromList)({ publications, identifier });
+    if (ctx.quiet) return console.log(id);
+    const match = publications.find((p) => p.id === id) ?? {
+      id,
+      name: null,
+      catalogTitle: null,
+      autoPublish: null
+    };
+    (0, import_output.printJson)(match);
+    return;
+  }
+  if (verb === "get") {
+    const args = (0, import_router.parseStandardArgs)({ argv, extraOptions: {} });
+    const id = (0, import_shared.requireId)(args.id, "Publication");
+    const selection = (0, import_select.resolveSelection)({
+      resource: "publications",
+      view: ctx.view,
+      baseSelection: getPublicationSelection(ctx.view),
+      select: args.select,
+      selection: args.selection,
+      include: args.include,
+      ensureId: ctx.quiet
+    });
+    const result = await (0, import_router.runQuery)(ctx, { publication: { __args: { id }, ...selection } });
+    if (result === void 0) return;
+    (0, import_output.printNode)({ node: result.publication, format: ctx.format, quiet: ctx.quiet });
+    return;
+  }
+  if (verb === "list") {
+    const args = (0, import_router.parseStandardArgs)({ argv, extraOptions: {} });
+    const first = (0, import_shared.parseFirst)(args.first);
+    const after = args.after;
+    const reverse = args.reverse;
+    const nodeSelection = (0, import_select.resolveSelection)({
+      resource: "publications",
+      view: ctx.view,
+      baseSelection: getPublicationSelection(ctx.view),
+      select: args.select,
+      selection: args.selection,
+      include: args.include,
+      ensureId: ctx.quiet
+    });
+    const result = await (0, import_router.runQuery)(ctx, {
+      publications: {
+        __args: { first, after, reverse },
+        pageInfo: { hasNextPage: true, endCursor: true },
+        nodes: nodeSelection
+      }
+    });
+    if (result === void 0) return;
+    (0, import_output.printConnection)({
+      connection: result.publications,
+      format: ctx.format,
+      quiet: ctx.quiet,
+      nextPageArgs: (0, import_shared.buildListNextPageArgs)("publications", { first, reverse })
+    });
+    return;
+  }
+  if (verb === "create") {
+    const args = (0, import_router.parseStandardArgs)({ argv, extraOptions: {} });
+    const built = (0, import_input.buildInput)({
+      inputArg: args.input,
+      setArgs: args.set,
+      setJsonArgs: args["set-json"]
+    });
+    if (!built.used) throw new import_errors.CliError("Missing --input or --set/--set-json", 2);
+    const result = await (0, import_router.runMutation)(ctx, {
+      publicationCreate: {
+        __args: { input: built.input },
+        publication: publicationSummarySelection,
+        userErrors: { field: true, message: true }
+      }
+    });
+    if (result === void 0) return;
+    (0, import_userErrors.maybeFailOnUserErrors)({ payload: result.publicationCreate, failOnUserErrors: ctx.failOnUserErrors });
+    if (ctx.quiet) return console.log(result.publicationCreate?.publication?.id ?? "");
+    (0, import_output.printJson)(result.publicationCreate, ctx.format !== "raw");
+    return;
+  }
+  if (verb === "update") {
+    const args = (0, import_router.parseStandardArgs)({ argv, extraOptions: {} });
+    const id = (0, import_shared.requireId)(args.id, "Publication");
+    const built = (0, import_input.buildInput)({
+      inputArg: args.input,
+      setArgs: args.set,
+      setJsonArgs: args["set-json"]
+    });
+    if (!built.used) throw new import_errors.CliError("Missing --input or --set/--set-json", 2);
+    const result = await (0, import_router.runMutation)(ctx, {
+      publicationUpdate: {
+        __args: { id, input: built.input },
+        publication: publicationSummarySelection,
+        userErrors: { field: true, message: true }
+      }
+    });
+    if (result === void 0) return;
+    (0, import_userErrors.maybeFailOnUserErrors)({ payload: result.publicationUpdate, failOnUserErrors: ctx.failOnUserErrors });
+    if (ctx.quiet) return console.log(result.publicationUpdate?.publication?.id ?? "");
+    (0, import_output.printJson)(result.publicationUpdate, ctx.format !== "raw");
+    return;
+  }
+  if (verb === "delete") {
+    const args = (0, import_router.parseStandardArgs)({ argv, extraOptions: {} });
+    const id = (0, import_shared.requireId)(args.id, "Publication");
+    if (!args.yes) throw new import_errors.CliError("Refusing to delete without --yes", 2);
+    const result = await (0, import_router.runMutation)(ctx, {
+      publicationDelete: {
+        __args: { id },
+        deletedId: true,
+        userErrors: { field: true, message: true }
+      }
+    });
+    if (result === void 0) return;
+    (0, import_userErrors.maybeFailOnUserErrors)({ payload: result.publicationDelete, failOnUserErrors: ctx.failOnUserErrors });
+    if (ctx.quiet) return console.log(result.publicationDelete?.deletedId ?? "");
+    (0, import_output.printJson)(result.publicationDelete, ctx.format !== "raw");
+    return;
+  }
+  throw new import_errors.CliError(`Unknown verb for publications: ${verb}`, 2);
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runPublications
+});
+//# sourceMappingURL=publications.js.map

package/dist/cli/verbs/publishables.d.ts

@@ -0,0 +1,6 @@
+import { type CommandContext } from '../router';
+export declare const runPublishables: ({ ctx, verb, argv, }: {
+    ctx: CommandContext;
+    verb: string;
+    argv: string[];
+}) => Promise<void>;

package/dist/cli/verbs/publishables.js

@@ -0,0 +1,73 @@
+"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 publishables_exports = {};
+__export(publishables_exports, {
+  runPublishables: () => runPublishables
+});
+module.exports = __toCommonJS(publishables_exports);
+var import_errors = require("../errors");
+var import_output = require("../output");
+var import_router = require("../router");
+var import_userErrors = require("../userErrors");
+const runPublishables = async ({
+  ctx,
+  verb,
+  argv
+}) => {
+  if (argv.includes("--help") || argv.includes("-h")) {
+    console.log(
+      [
+        "Usage:",
+        "  shop publishables <verb> [flags]",
+        "",
+        "Verbs:",
+        "  publish-to-current-channel|unpublish-to-current-channel",
+        "",
+        "Notes:",
+        "  --id must be a full gid://shopify/... ID (numeric IDs cannot be coerced for Publishable)."
+      ].join("\n")
+    );
+    return;
+  }
+  if (verb === "publish-to-current-channel" || verb === "unpublish-to-current-channel") {
+    const args = (0, import_router.parseStandardArgs)({ argv, extraOptions: {} });
+    const id = args.id;
+    if (typeof id !== "string" || !id) throw new import_errors.CliError("Missing --id", 2);
+    const mutation = verb === "publish-to-current-channel" ? "publishablePublishToCurrentChannel" : "publishableUnpublishToCurrentChannel";
+    const result = await (0, import_router.runMutation)(ctx, {
+      [mutation]: {
+        __args: { id },
+        publishable: { __typename: true, publishedOnCurrentChannel: true },
+        userErrors: { field: true, message: true }
+      }
+    });
+    if (result === void 0) return;
+    const payload = result[mutation];
+    (0, import_userErrors.maybeFailOnUserErrors)({ payload, failOnUserErrors: ctx.failOnUserErrors });
+    if (ctx.quiet) return console.log(id);
+    (0, import_output.printJson)(payload, ctx.format !== "raw");
+    return;
+  }
+  throw new import_errors.CliError(`Unknown verb for publishables: ${verb}`, 2);
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runPublishables
+});
+//# sourceMappingURL=publishables.js.map

package/dist/cli/verbs/refunds.d.ts

@@ -0,0 +1,6 @@
+import { type CommandContext } from '../router';
+export declare const runRefunds: ({ ctx, verb, argv, }: {
+    ctx: CommandContext;
+    verb: string;
+    argv: string[];
+}) => Promise<void>;

package/dist/cli/verbs/refunds.js

@@ -0,0 +1,226 @@
+"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 refunds_exports = {};
+__export(refunds_exports, {
+  runRefunds: () => runRefunds
+});
+module.exports = __toCommonJS(refunds_exports);
+var import_node_crypto = require("node:crypto");
+var import_errors = require("../errors");
+var import_gid = require("../gid");
+var import_input = require("../input");
+var import_output = require("../output");
+var import_router = require("../router");
+var import_select = require("../selection/select");
+var import_userErrors = require("../userErrors");
+var import_shared = require("./_shared");
+const refundSummarySelection = {
+  id: true,
+  createdAt: true,
+  note: true,
+  totalRefundedSet: { shopMoney: { amount: true, currencyCode: true } },
+  order: { id: true, name: true },
+  refundLineItems: {
+    __args: { first: 20 },
+    nodes: {
+      lineItem: { id: true, title: true },
+      quantity: true,
+      restockType: true,
+      subtotalSet: { shopMoney: { amount: true, currencyCode: true } }
+    }
+  }
+};
+const refundFullSelection = {
+  ...refundSummarySelection,
+  duties: {
+    originalDuty: { id: true },
+    amountSet: { shopMoney: { amount: true, currencyCode: true } }
+  },
+  transactions: {
+    __args: { first: 20 },
+    id: true,
+    kind: true,
+    status: true,
+    amountSet: { shopMoney: { amount: true, currencyCode: true } },
+    gateway: true
+  },
+  refundShippingLines: {
+    __args: { first: 20 },
+    nodes: {
+      shippingLine: { title: true },
+      subtotalAmountSet: { shopMoney: { amount: true, currencyCode: true } }
+    }
+  }
+};
+const getRefundSelection = (view) => {
+  if (view === "ids") return { id: true };
+  if (view === "full") return refundFullSelection;
+  if (view === "raw") return {};
+  return refundSummarySelection;
+};
+const suggestedRefundSummarySelection = {
+  amountSet: { shopMoney: { amount: true, currencyCode: true } },
+  maximumRefundableSet: { shopMoney: { amount: true, currencyCode: true } },
+  refundLineItems: {
+    lineItem: { id: true, title: true },
+    quantity: true,
+    restockType: true,
+    subtotalSet: { shopMoney: { amount: true, currencyCode: true } }
+  },
+  shipping: {
+    amountSet: { shopMoney: { amount: true, currencyCode: true } },
+    maximumRefundableSet: { shopMoney: { amount: true, currencyCode: true } },
+    taxSet: { shopMoney: { amount: true, currencyCode: true } }
+  }
+};
+const suggestedRefundFullSelection = {
+  ...suggestedRefundSummarySelection,
+  discountedSubtotalSet: { shopMoney: { amount: true, currencyCode: true } },
+  subtotalSet: { shopMoney: { amount: true, currencyCode: true } },
+  totalDutiesSet: { shopMoney: { amount: true, currencyCode: true } },
+  totalTaxesSet: { shopMoney: { amount: true, currencyCode: true } }
+};
+const getSuggestedRefundSelection = (view) => {
+  if (view === "full") return suggestedRefundFullSelection;
+  if (view === "raw") return {};
+  return suggestedRefundSummarySelection;
+};
+const applyRestock = (input, restock) => {
+  if (!restock) return input;
+  if (!input || typeof input !== "object") return input;
+  if (!Array.isArray(input.refundLineItems)) return input;
+  return {
+    ...input,
+    refundLineItems: input.refundLineItems.map((item) => ({
+      ...item,
+      restockType: item.restockType ?? "RETURN"
+    }))
+  };
+};
+const runRefunds = async ({
+  ctx,
+  verb,
+  argv
+}) => {
+  if (argv.includes("--help") || argv.includes("-h")) {
+    console.log(
+      [
+        "Usage:",
+        "  shop refunds <verb> [flags]",
+        "",
+        "Verbs:",
+        "  create|get|calculate",
+        "",
+        "Common output flags:",
+        "  --view summary|ids|full|raw",
+        "  --select <path>        (repeatable; dot paths; adds to base view selection)",
+        "  --selection <graphql>  (selection override; can be @file.gql)",
+        "",
+        "Notes:",
+        "  create requires --order-id and --input (refund details).",
+        "  --notify sends a refund notification email.",
+        "  --restock sets restockType=RETURN for refundLineItems without restockType."
+      ].join("\n")
+    );
+    return;
+  }
+  if (verb === "get") {
+    const args = (0, import_router.parseStandardArgs)({ argv, extraOptions: {} });
+    const id = (0, import_shared.requireId)(args.id, "Refund");
+    const selection = (0, import_select.resolveSelection)({
+      resource: "refunds",
+      view: ctx.view,
+      baseSelection: getRefundSelection(ctx.view),
+      select: args.select,
+      selection: args.selection,
+      include: args.include,
+      ensureId: ctx.quiet
+    });
+    const result = await (0, import_router.runQuery)(ctx, { refund: { __args: { id }, ...selection } });
+    if (result === void 0) return;
+    (0, import_output.printNode)({ node: result.refund, format: ctx.format, quiet: ctx.quiet });
+    return;
+  }
+  if (verb === "calculate") {
+    const args = (0, import_router.parseStandardArgs)({ argv, extraOptions: { "order-id": { type: "string" } } });
+    const orderIdRaw = args["order-id"];
+    if (!orderIdRaw) throw new import_errors.CliError("Missing --order-id", 2);
+    const orderId = (0, import_gid.coerceGid)(orderIdRaw, "Order");
+    const built = (0, import_input.buildInput)({
+      inputArg: args.input,
+      setArgs: args.set,
+      setJsonArgs: args["set-json"]
+    });
+    if (!built.used) throw new import_errors.CliError("Missing --input or --set/--set-json", 2);
+    const selection = (0, import_select.resolveSelection)({
+      resource: "refunds",
+      typeName: "SuggestedRefund",
+      view: ctx.view,
+      baseSelection: getSuggestedRefundSelection(ctx.view),
+      select: args.select,
+      selection: args.selection,
+      include: args.include,
+      ensureId: false
+    });
+    const result = await (0, import_router.runQuery)(ctx, {
+      order: { __args: { id: orderId }, suggestedRefund: { __args: built.input, ...selection } }
+    });
+    if (result === void 0) return;
+    (0, import_output.printJson)(result.order?.suggestedRefund, ctx.format !== "raw");
+    return;
+  }
+  if (verb === "create") {
+    const args = (0, import_router.parseStandardArgs)({
+      argv,
+      extraOptions: { "order-id": { type: "string" }, notify: { type: "boolean" }, restock: { type: "boolean" } }
+    });
+    const built = (0, import_input.buildInput)({
+      inputArg: args.input,
+      setArgs: args.set,
+      setJsonArgs: args["set-json"]
+    });
+    if (!built.used) throw new import_errors.CliError("Missing --input or --set/--set-json", 2);
+    const orderIdRaw = args["order-id"] ?? built.input?.orderId;
+    if (!orderIdRaw) throw new import_errors.CliError("Missing --order-id", 2);
+    let input = { ...built.input, orderId: (0, import_gid.coerceGid)(orderIdRaw, "Order") };
+    if (args.notify) {
+      input = { ...input, notify: true };
+    }
+    input = applyRestock(input, args.restock);
+    const result = await (0, import_router.runMutation)(ctx, {
+      refundCreate: {
+        __directives: { idempotent: { key: (0, import_node_crypto.randomUUID)() } },
+        __args: { input },
+        refund: refundSummarySelection,
+        userErrors: { field: true, message: true }
+      }
+    });
+    if (result === void 0) return;
+    (0, import_userErrors.maybeFailOnUserErrors)({ payload: result.refundCreate, failOnUserErrors: ctx.failOnUserErrors });
+    if (ctx.quiet) return console.log(result.refundCreate?.refund?.id ?? "");
+    (0, import_output.printJson)(result.refundCreate, ctx.format !== "raw");
+    return;
+  }
+  throw new import_errors.CliError(`Unknown verb for refunds: ${verb}`, 2);
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runRefunds
+});
+//# sourceMappingURL=refunds.js.map

package/dist/cli/verbs/resource-feedback.d.ts

@@ -0,0 +1,6 @@
+import { type CommandContext } from '../router';
+export declare const runResourceFeedback: ({ ctx, verb, argv, }: {
+    ctx: CommandContext;
+    verb: string;
+    argv: string[];
+}) => Promise<void>;