shopq 0.3.9 → 0.4.1

package/dist/shopq.js

@@ -232,6 +232,14 @@ function handleCommandError(err) {
   }
   throw new Error(String(err));
 }
+function rejectHandleFlag(parsed, usage) {
+  if (parsed.args.length === 0 && parsed.flags.handle) {
+    formatError(`--handle is not a flag for this command. Pass the identifier as a positional argument: ${usage}`);
+    process.exitCode = 2;
+    return true;
+  }
+  return false;
+}
 async function readFileText(path) {
   if (!existsSync(path)) {
     formatError(`File not found: ${path}`);
@@ -476,6 +484,8 @@ var PRODUCTS_QUERY = `query ProductList($first: Int!, $after: String, $sortKey:
         vendor
         variantsCount { count }
         totalInventory
+        category { id name }
+        featuredImage { url }
       }
     }
     pageInfo {
@@ -514,7 +524,9 @@ async function handleProductList(parsed) {
       productType: e.node.productType,
       vendor: e.node.vendor,
       variantsCount: e.node.variantsCount.count,
-      totalInventory: e.node.totalInventory
+      totalInventory: e.node.totalInventory,
+      category: e.node.category?.name ?? null,
+      hasImage: e.node.featuredImage !== null
     }));
     const pageInfo = result.products.pageInfo;
     if (parsed.flags.json) {
@@ -532,9 +544,15 @@ async function handleProductList(parsed) {
       { key: "productType", header: "Type" },
       { key: "vendor", header: "Vendor" },
       { key: "variantsCount", header: "Variants" },
-      { key: "totalInventory", header: "Inventory" }
+      { key: "totalInventory", header: "Inventory" },
+      { key: "category", header: "Category" },
+      { key: "hasImage", header: "Image" }
     ];
-    formatOutput(products, columns, {
+    const tableData = products.map((p) => ({
+      ...p,
+      hasImage: p.hasImage ? "Yes" : "No"
+    }));
+    formatOutput(tableData, columns, {
       json: false,
       noColor: parsed.flags.noColor,
       pageInfo
@@ -552,6 +570,17 @@ var PRODUCT_GET_QUERY = `query ProductGet($id: ID!) {
     vendor
     tags
     descriptionHtml
+    category { id name }
+    metafields(first: 25) {
+      edges {
+        node {
+          namespace
+          key
+          type
+          value
+        }
+      }
+    }
     variants(first: 100) {
       edges {
         node {
@@ -602,6 +631,8 @@ function truncate(str, max) {
   return `${str.slice(0, max - 3)}...`;
 }
 async function handleProductGet(parsed) {
+  if (rejectHandleFlag(parsed, "shopq product get <id-or-title>"))
+    return;
   const idOrTitle = parsed.args.join(" ");
   if (!idOrTitle) {
     formatError("Usage: shopq product get <id-or-title>");
@@ -671,6 +702,12 @@ function outputProduct(product, parsed) {
     url: e.node.url,
     alt: e.node.altText ?? ""
   }));
+  const metafields = product.metafields.edges.map((e) => ({
+    namespace: e.node.namespace,
+    key: e.node.key,
+    type: e.node.type,
+    value: e.node.value
+  }));
   if (parsed.flags.json) {
     const data = {
       id: product.id,
@@ -680,6 +717,8 @@ function outputProduct(product, parsed) {
       vendor: product.vendor,
       tags: product.tags,
       description: stripHtml(product.descriptionHtml),
+      category: product.category,
+      metafields,
       variants: product.variants.edges.map((e) => ({
         id: e.node.id,
         sku: e.node.sku,
@@ -701,8 +740,18 @@ function outputProduct(product, parsed) {
   lines.push(`${label("Type")}: ${product.productType}`);
   lines.push(`${label("Vendor")}: ${product.vendor}`);
   lines.push(`${label("Tags")}: ${product.tags.join(", ")}`);
+  lines.push(`${label("Category")}: ${product.category?.name ?? ""}`);
   lines.push(`${label("Description")}: ${truncate(plainDesc, 80)}`);
   lines.push("");
+  lines.push(`${label("Metafields")}:`);
+  if (metafields.length === 0) {
+    lines.push("  (none)");
+  } else {
+    for (const mf of metafields) {
+      lines.push(`  ${mf.namespace}.${mf.key}: ${mf.value}`);
+    }
+  }
+  lines.push("");
   lines.push(`${label("Variants")}:`);
   for (const v of variants) {
     lines.push(`  SKU: ${v.sku}  Price: ${v.price}  Options: ${v.options}  Qty: ${v.inventoryQuantity}`);
@@ -1103,6 +1152,8 @@ function flattenItems(items, depth, rows) {
   }
 }
 async function handleMenuGet(parsed) {
+  if (rejectHandleFlag(parsed, "shopq menu get <id-or-handle>"))
+    return;
   const idOrHandle = parsed.args.join(" ");
   if (!idOrHandle) {
     formatError("Usage: shopq menu get <id-or-handle>");
@@ -1549,6 +1600,8 @@ function resolvePageId(input) {
   return { type: "handle", handle: input };
 }
 async function handlePageGet(parsed) {
+  if (rejectHandleFlag(parsed, "shopq page get <id-or-handle>"))
+    return;
   const idOrHandle = parsed.args.join(" ");
   if (!idOrHandle) {
     formatError("Usage: shopq page get <id-or-handle>");
@@ -1844,6 +1897,8 @@ function truncate2(str, max) {
   return `${str.slice(0, max - 3)}...`;
 }
 async function handleCollectionGet(parsed) {
+  if (rejectHandleFlag(parsed, "shopq collection get <id-or-handle>"))
+    return;
   const idOrHandle = parsed.args.join(" ");
   if (!idOrHandle) {
     formatError("Usage: shopq collection get <id-or-handle>");

package/extensions/shopq-path.ts

@@ -0,0 +1,29 @@
+/**
+ * Adds .pi/npm/node_modules/.bin to the bash tool's PATH so that
+ * `shopq` (and any other pi-installed CLI) resolves without a global install.
+ */
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { createBashTool } from "@mariozechner/pi-coding-agent";
+
+export default function (pi: ExtensionAPI) {
+	const cwd = process.cwd();
+
+	const bashTool = createBashTool(cwd, {
+		spawnHook: ({ command, cwd: spawnCwd, env }) => ({
+			command,
+			cwd: spawnCwd,
+			env: {
+				...env,
+				PATH: `${cwd}/.pi/npm/node_modules/.bin:${env.PATH ?? ""}`,
+			},
+		}),
+	});
+
+	pi.registerTool({
+		...bashTool,
+		execute: async (id, params, signal, onUpdate) => {
+			return bashTool.execute(id, params, signal, onUpdate);
+		},
+	});
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "shopq",
-	"version": "0.3.9",
+	"version": "0.4.1",
 	"description": "A zero-dependency Shopify Admin CLI built on Bun",
 	"type": "module",
 	"license": "MIT",
@@ -9,6 +9,7 @@
 	},
 	"files": [
 		"dist",
+		"extensions",
 		"skills"
 	],
 	"scripts": {
@@ -35,6 +36,9 @@
 		"pi-package"
 	],
 	"pi": {
+		"extensions": [
+			"./extensions"
+		],
 		"skills": [
 			"./skills"
 		]
@@ -47,6 +51,12 @@
 		"@types/bun": "latest"
 	},
 	"peerDependencies": {
+		"@mariozechner/pi-coding-agent": "*",
 		"typescript": "^5.9.3"
+	},
+	"peerDependenciesMeta": {
+		"@mariozechner/pi-coding-agent": {
+			"optional": true
+		}
 	}
 }

package/skills/shopq/SKILL.md

@@ -9,11 +9,7 @@ A zero-dependency Shopify Admin CLI. Structured JSON output, predictable exit co
 
 ## Setup
 
-Install globally:
-
-```bash
-bun install -g shopq
-```
+If `shopq` is not found on PATH, it may not be installed globally. Let the user know they can install it with their package manager (e.g. `npm install -g shopq`, `bun install -g shopq`, etc.).
 
 Configure credentials (one of):