shop-cli 0.1.1

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

@@ -0,0 +1,38 @@
+import { type ShopifyGidType } from '../gid';
+export declare const parseFirst: (value: unknown) => number;
+export declare const parseIntFlag: (flag: string, value: unknown) => number;
+export declare const requireId: (id: unknown, type: ShopifyGidType, flag?: string) => string;
+export declare const requireGidFlag: (value: unknown, flag: string, type: ShopifyGidType) => string;
+export declare const requireStringFlag: (value: unknown, flag: string) => string;
+export declare const requireLocationId: (value: unknown, flag?: string) => string;
+export declare const parseDateTime: (value: unknown, flag: string) => string;
+export declare const parseCsv: (value: unknown, label: string) => string[];
+export declare const parseIds: (value: unknown, type: ShopifyGidType) => string[];
+export declare const parseJsonArg: (value: unknown, label: string, { allowEmpty }?: {
+    allowEmpty?: boolean;
+}) => any;
+export declare const parseTextArg: (value: unknown, label: string, { allowEmpty }?: {
+    allowEmpty?: boolean;
+}) => string | undefined;
+export declare const parseStringList: (value: unknown, label: string, { allowEmpty }?: {
+    allowEmpty?: boolean;
+}) => string[];
+export declare const buildListNextPageArgs: (resource: string, args: {
+    first?: unknown;
+    query?: unknown;
+    sort?: unknown;
+    reverse?: unknown;
+}, extraFlags?: Array<{
+    flag: string;
+    value?: unknown;
+}>) => {
+    base: string;
+    first: number | undefined;
+    query: string | undefined;
+    sort: string | undefined;
+    reverse: boolean;
+    extraFlags: {
+        flag: string;
+        value?: string | number | boolean;
+    }[];
+};

package/dist/cli/verbs/_shared.js

@@ -0,0 +1,181 @@
+"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 shared_exports = {};
+__export(shared_exports, {
+  buildListNextPageArgs: () => buildListNextPageArgs,
+  parseCsv: () => parseCsv,
+  parseDateTime: () => parseDateTime,
+  parseFirst: () => parseFirst,
+  parseIds: () => parseIds,
+  parseIntFlag: () => parseIntFlag,
+  parseJsonArg: () => parseJsonArg,
+  parseStringList: () => parseStringList,
+  parseTextArg: () => parseTextArg,
+  requireGidFlag: () => requireGidFlag,
+  requireId: () => requireId,
+  requireLocationId: () => requireLocationId,
+  requireStringFlag: () => requireStringFlag
+});
+module.exports = __toCommonJS(shared_exports);
+var import_node_fs = require("node:fs");
+var import_errors = require("../errors");
+var import_gid = require("../gid");
+const parseFirst = (value) => {
+  if (value === void 0) return 50;
+  const n = Number(value);
+  if (!Number.isFinite(n) || n <= 0) throw new import_errors.CliError("--first must be a positive integer", 2);
+  return Math.floor(n);
+};
+const parseIntFlag = (flag, value) => {
+  if (value === void 0 || value === null || value === "") {
+    throw new import_errors.CliError(`Missing ${flag}`, 2);
+  }
+  const n = Number(value);
+  if (!Number.isFinite(n) || !Number.isInteger(n)) {
+    throw new import_errors.CliError(`${flag} must be an integer`, 2);
+  }
+  return n;
+};
+const requireId = (id, type, flag = "--id") => {
+  const normalized = typeof id === "string" ? id : typeof id === "number" && Number.isFinite(id) ? String(id) : void 0;
+  if (!normalized) throw new import_errors.CliError(`Missing ${flag}`, 2);
+  return (0, import_gid.coerceGid)(normalized, type);
+};
+const requireGidFlag = (value, flag, type) => {
+  if (typeof value !== "string" || !value) throw new import_errors.CliError(`Missing ${flag}`, 2);
+  return (0, import_gid.coerceGid)(value, type);
+};
+const requireStringFlag = (value, flag) => {
+  if (typeof value !== "string" || !value) throw new import_errors.CliError(`Missing ${flag}`, 2);
+  return value;
+};
+const requireLocationId = (value, flag = "--location-id") => {
+  if (typeof value !== "string" || !value) throw new import_errors.CliError(`Missing ${flag}`, 2);
+  return (0, import_gid.coerceGid)(value, "Location");
+};
+const parseDateTime = (value, flag) => {
+  if (typeof value !== "string" || !value) throw new import_errors.CliError(`Missing ${flag}`, 2);
+  return value;
+};
+const parseCsv = (value, label) => {
+  if (typeof value !== "string" || !value.trim()) throw new import_errors.CliError(`Missing ${label}`, 2);
+  const parts = value.split(",").map((s) => s.trim()).filter(Boolean);
+  if (parts.length === 0) throw new import_errors.CliError(`${label} must include at least one item`, 2);
+  return parts;
+};
+const parseIds = (value, type) => {
+  const raw = Array.isArray(value) ? value : value === void 0 ? [] : [value];
+  const parts = [];
+  for (const v of raw) {
+    if (typeof v !== "string") throw new import_errors.CliError("--ids must be a string", 2);
+    parts.push(...v.split(",").map((s) => s.trim()).filter(Boolean));
+  }
+  if (parts.length === 0) throw new import_errors.CliError("Missing --ids", 2);
+  return parts.map((id) => (0, import_gid.coerceGid)(id, type));
+};
+const readUtf8 = (path) => (0, import_node_fs.readFileSync)(path, "utf8");
+const parseJson = (value, label) => {
+  try {
+    return JSON.parse(value);
+  } catch (err) {
+    throw new import_errors.CliError(`${label} must be valid JSON: ${err.message}`, 2);
+  }
+};
+const parseJsonArg = (value, label, { allowEmpty = false } = {}) => {
+  if (value === void 0 || value === null || value === "") {
+    if (allowEmpty) return void 0;
+    throw new import_errors.CliError(`Missing ${label}`, 2);
+  }
+  if (typeof value !== "string") throw new import_errors.CliError(`${label} must be a string`, 2);
+  const raw = value.trim();
+  if (!raw) {
+    if (allowEmpty) return void 0;
+    throw new import_errors.CliError(`Missing ${label}`, 2);
+  }
+  if (raw.startsWith("@file:")) return parseJson(readUtf8(raw.slice("@file:".length)), label);
+  if (raw.startsWith("@")) return parseJson(readUtf8(raw.slice(1)), label);
+  return parseJson(raw, label);
+};
+const parseTextArg = (value, label, { allowEmpty = false } = {}) => {
+  if (value === void 0 || value === null || value === "") {
+    if (allowEmpty) return void 0;
+    throw new import_errors.CliError(`Missing ${label}`, 2);
+  }
+  if (typeof value !== "string") throw new import_errors.CliError(`${label} must be a string`, 2);
+  const raw = value.trim();
+  if (!raw) {
+    if (allowEmpty) return void 0;
+    throw new import_errors.CliError(`Missing ${label}`, 2);
+  }
+  if (raw.startsWith("@file:")) return readUtf8(raw.slice("@file:".length));
+  if (raw.startsWith("@")) return readUtf8(raw.slice(1));
+  return raw;
+};
+const parseStringList = (value, label, { allowEmpty = false } = {}) => {
+  if (value === void 0 || value === null) {
+    if (allowEmpty) return [];
+    throw new import_errors.CliError(`Missing ${label}`, 2);
+  }
+  const raw = Array.isArray(value) ? value : [value];
+  const parts = [];
+  for (const v of raw) {
+    if (typeof v !== "string") throw new import_errors.CliError(`${label} must be a string`, 2);
+    parts.push(...v.split(",").map((s) => s.trim()).filter(Boolean));
+  }
+  if (parts.length === 0) {
+    if (allowEmpty) return [];
+    throw new import_errors.CliError(`Missing ${label}`, 2);
+  }
+  return parts;
+};
+const buildListNextPageArgs = (resource, args, extraFlags) => {
+  const normalizedExtraFlags = [];
+  for (const f of extraFlags ?? []) {
+    if (!f?.flag) continue;
+    const value = f.value;
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+      normalizedExtraFlags.push({ flag: f.flag, value });
+    }
+  }
+  return {
+    base: `shop ${resource} list`,
+    first: typeof args.first === "number" ? args.first : void 0,
+    query: typeof args.query === "string" ? args.query : void 0,
+    sort: typeof args.sort === "string" ? args.sort : void 0,
+    reverse: args.reverse === true,
+    extraFlags: normalizedExtraFlags
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildListNextPageArgs,
+  parseCsv,
+  parseDateTime,
+  parseFirst,
+  parseIds,
+  parseIntFlag,
+  parseJsonArg,
+  parseStringList,
+  parseTextArg,
+  requireGidFlag,
+  requireId,
+  requireLocationId,
+  requireStringFlag
+});
+//# sourceMappingURL=_shared.js.map

package/dist/cli/verbs/abandoned-checkouts.d.ts

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

package/dist/cli/verbs/abandoned-checkouts.js

@@ -0,0 +1,259 @@
+"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 abandoned_checkouts_exports = {};
+__export(abandoned_checkouts_exports, {
+  runAbandonedCheckouts: () => runAbandonedCheckouts
+});
+module.exports = __toCommonJS(abandoned_checkouts_exports);
+var import_errors = require("../errors");
+var import_output = require("../output");
+var import_router = require("../router");
+var import_select = require("../selection/select");
+var import_userErrors = require("../userErrors");
+var import_gid = require("../gid");
+var import_shared = require("./_shared");
+const abandonedCheckoutSummarySelection = {
+  id: true,
+  name: true,
+  createdAt: true,
+  completedAt: true,
+  abandonedCheckoutUrl: true,
+  customer: { id: true, email: true, displayName: true },
+  totalPriceSet: { shopMoney: { amount: true, currencyCode: true } }
+};
+const abandonedCheckoutFullSelection = {
+  ...abandonedCheckoutSummarySelection,
+  updatedAt: true,
+  subtotalPriceSet: { shopMoney: { amount: true, currencyCode: true } },
+  totalDiscountSet: { shopMoney: { amount: true, currencyCode: true } },
+  lineItems: {
+    __args: { first: 25 },
+    nodes: {
+      id: true,
+      title: true,
+      quantity: true,
+      originalUnitPriceSet: { shopMoney: { amount: true, currencyCode: true } },
+      variant: { id: true, title: true },
+      product: { id: true, title: true }
+    },
+    pageInfo: { hasNextPage: true, endCursor: true }
+  }
+};
+const getAbandonedCheckoutSelection = (view) => {
+  if (view === "ids") return { id: true };
+  if (view === "full") return abandonedCheckoutFullSelection;
+  if (view === "raw") return {};
+  return abandonedCheckoutSummarySelection;
+};
+const abandonmentSummarySelection = {
+  id: true,
+  abandonmentType: true,
+  createdAt: true,
+  emailState: true,
+  emailSentAt: true,
+  daysSinceLastAbandonmentEmail: true,
+  customerHasNoOrderSinceAbandonment: true,
+  customerHasNoDraftOrderSinceAbandonment: true,
+  customer: { id: true, email: true, displayName: true },
+  abandonedCheckoutPayload: { id: true, name: true, abandonedCheckoutUrl: true }
+};
+const runAbandonedCheckouts = async ({
+  ctx,
+  verb,
+  argv
+}) => {
+  if (verb === "list") {
+    const args = (0, import_router.parseStandardArgs)({ argv, extraOptions: {} });
+    const first = (0, import_shared.parseFirst)(args.first);
+    const after = args.after;
+    const query = args.query;
+    const reverse = args.reverse;
+    const sortKey = args.sort;
+    const nodeSelection = (0, import_select.resolveSelection)({
+      resource: "abandoned-checkouts",
+      view: ctx.view,
+      baseSelection: getAbandonedCheckoutSelection(ctx.view),
+      select: args.select,
+      selection: args.selection,
+      include: args.include,
+      ensureId: ctx.quiet
+    });
+    const result = await (0, import_router.runQuery)(ctx, {
+      abandonedCheckouts: {
+        __args: { first, after, query, reverse, sortKey },
+        pageInfo: { hasNextPage: true, endCursor: true },
+        nodes: nodeSelection
+      }
+    });
+    if (result === void 0) return;
+    (0, import_output.printConnection)({
+      connection: result.abandonedCheckouts,
+      format: ctx.format,
+      quiet: ctx.quiet,
+      nextPageArgs: (0, import_shared.buildListNextPageArgs)("abandoned-checkouts", { first, query, sort: sortKey, reverse })
+    });
+    return;
+  }
+  if (verb === "count") {
+    const args = (0, import_router.parseStandardArgs)({ argv, extraOptions: { limit: { type: "string" } } });
+    const query = args.query;
+    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, {
+      abandonedCheckoutsCount: {
+        __args: {
+          ...query ? { query } : {},
+          ...limit !== void 0 ? { limit: Math.floor(limit) } : {}
+        },
+        count: true,
+        precision: true
+      }
+    });
+    if (result === void 0) return;
+    if (ctx.quiet) return console.log(result.abandonedCheckoutsCount?.count ?? "");
+    (0, import_output.printJson)(result.abandonedCheckoutsCount, ctx.format !== "raw");
+    return;
+  }
+  if (verb === "abandonment") {
+    const args = (0, import_router.parseStandardArgs)({ argv, extraOptions: {} });
+    const id = (0, import_shared.requireId)(args.id, "Abandonment");
+    const selection = (0, import_select.resolveSelection)({
+      resource: "abandoned-checkouts",
+      view: ctx.view,
+      baseSelection: abandonmentSummarySelection,
+      select: args.select,
+      selection: args.selection,
+      include: args.include,
+      ensureId: ctx.quiet
+    });
+    const result = await (0, import_router.runQuery)(ctx, { abandonment: { __args: { id }, ...selection } });
+    if (result === void 0) return;
+    (0, import_output.printNode)({ node: result.abandonment, format: ctx.format, quiet: ctx.quiet });
+    return;
+  }
+  if (verb === "abandonment-by-checkout") {
+    const args = (0, import_router.parseStandardArgs)({ argv, extraOptions: { "checkout-id": { type: "string" } } });
+    const checkoutIdRaw = args["checkout-id"];
+    if (!checkoutIdRaw) throw new import_errors.CliError("Missing --checkout-id", 2);
+    const abandonedCheckoutId = (0, import_gid.coerceGid)(checkoutIdRaw, "AbandonedCheckout");
+    const selection = (0, import_select.resolveSelection)({
+      resource: "abandoned-checkouts",
+      view: ctx.view,
+      baseSelection: abandonmentSummarySelection,
+      select: args.select,
+      selection: args.selection,
+      include: args.include,
+      ensureId: ctx.quiet
+    });
+    const result = await (0, import_router.runQuery)(ctx, {
+      abandonmentByAbandonedCheckoutId: { __args: { abandonedCheckoutId }, ...selection }
+    });
+    if (result === void 0) return;
+    (0, import_output.printNode)({
+      node: result.abandonmentByAbandonedCheckoutId,
+      format: ctx.format,
+      quiet: ctx.quiet
+    });
+    return;
+  }
+  if (verb === "update-email-state") {
+    const args = (0, import_router.parseStandardArgs)({
+      argv,
+      extraOptions: {
+        state: { type: "string" },
+        "email-sent-at": { type: "string" },
+        reason: { type: "string" }
+      }
+    });
+    const id = (0, import_shared.requireId)(args.id, "Abandonment");
+    const emailState = args.state;
+    if (!emailState) throw new import_errors.CliError("Missing --state", 2);
+    const emailSentAt = args["email-sent-at"];
+    const emailStateChangeReason = args.reason;
+    const result = await (0, import_router.runMutation)(ctx, {
+      abandonmentEmailStateUpdate: {
+        __args: {
+          id,
+          emailState,
+          ...emailSentAt ? { emailSentAt } : {},
+          ...emailStateChangeReason ? { emailStateChangeReason } : {}
+        },
+        abandonment: abandonmentSummarySelection,
+        userErrors: { field: true, message: true }
+      }
+    });
+    if (result === void 0) return;
+    (0, import_userErrors.maybeFailOnUserErrors)({ payload: result.abandonmentEmailStateUpdate, failOnUserErrors: ctx.failOnUserErrors });
+    if (ctx.quiet) return console.log(result.abandonmentEmailStateUpdate?.abandonment?.id ?? "");
+    (0, import_output.printJson)(result.abandonmentEmailStateUpdate, ctx.format !== "raw");
+    return;
+  }
+  if (verb === "update-activity-delivery-status") {
+    const args = (0, import_router.parseStandardArgs)({
+      argv,
+      extraOptions: {
+        "abandonment-id": { type: "string" },
+        "marketing-activity-id": { type: "string" },
+        status: { type: "string" },
+        "delivered-at": { type: "string" },
+        reason: { type: "string" }
+      }
+    });
+    const abandonmentIdRaw = args["abandonment-id"];
+    const marketingActivityIdRaw = args["marketing-activity-id"];
+    const deliveryStatus = args.status;
+    if (!abandonmentIdRaw) throw new import_errors.CliError("Missing --abandonment-id", 2);
+    if (!marketingActivityIdRaw) throw new import_errors.CliError("Missing --marketing-activity-id", 2);
+    if (!deliveryStatus) throw new import_errors.CliError("Missing --status", 2);
+    const abandonmentId = (0, import_gid.coerceGid)(abandonmentIdRaw, "Abandonment");
+    const marketingActivityId = (0, import_gid.coerceGid)(marketingActivityIdRaw, "MarketingActivity");
+    const deliveredAt = args["delivered-at"];
+    const deliveryStatusChangeReason = args.reason;
+    const result = await (0, import_router.runMutation)(ctx, {
+      abandonmentUpdateActivitiesDeliveryStatuses: {
+        __args: {
+          abandonmentId,
+          marketingActivityId,
+          deliveryStatus,
+          ...deliveredAt ? { deliveredAt } : {},
+          ...deliveryStatusChangeReason ? { deliveryStatusChangeReason } : {}
+        },
+        abandonment: abandonmentSummarySelection,
+        userErrors: { field: true, message: true }
+      }
+    });
+    if (result === void 0) return;
+    (0, import_userErrors.maybeFailOnUserErrors)({
+      payload: result.abandonmentUpdateActivitiesDeliveryStatuses,
+      failOnUserErrors: ctx.failOnUserErrors
+    });
+    if (ctx.quiet) return console.log(result.abandonmentUpdateActivitiesDeliveryStatuses?.abandonment?.id ?? "");
+    (0, import_output.printJson)(result.abandonmentUpdateActivitiesDeliveryStatuses, ctx.format !== "raw");
+    return;
+  }
+  throw new import_errors.CliError(`Unknown verb for abandoned-checkouts: ${verb}`, 2);
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runAbandonedCheckouts
+});
+//# sourceMappingURL=abandoned-checkouts.js.map

package/dist/cli/verbs/app-billing.d.ts

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