shopq 0.3.4 → 0.3.8

package/README.md

@@ -1,6 +1,6 @@
 # shopq
 
-[![CI](https://github.com/c-99-e/shopq/actions/workflows/ci.yml/badge.svg)](https://github.com/c-99-e/shopq/actions/workflows/ci.yml)
+[![CI](https://github.com/c99e/shopq/actions/workflows/ci.yml/badge.svg)](https://github.com/c99e/shopq/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/shopq)](https://www.npmjs.com/package/shopq)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![Bun](https://img.shields.io/badge/Bun-%3E%3D1.3-black?logo=bun)](https://bun.sh)
@@ -11,10 +11,20 @@ Built with AI agents as the primary user — structured JSON output, predictable
 
 ## Install
 
+### CLI
+
 ```bash
 bun install -g shopq
 ```
 
+### Pi coding agent
+
+Install as a [pi package](https://shittycodingagent.ai/packages) to give your agent Shopify skills:
+
+```bash
+pi install npm:shopq
+```
+
 ## Prerequisites
 
 - [Bun](https://bun.sh) v1.3+ (also works with Node.js v22+)
@@ -46,7 +56,7 @@ Bun loads `.env` automatically — no extra setup needed. shopq handles the OAut
 ### Development
 
 ```bash
-git clone https://github.com/c-99-e/shopq.git
+git clone https://github.com/c99e/shopq.git
 cd shopq
 bun install
 

package/dist/cli.js

@@ -0,0 +1,247 @@
+// @bun
+// src/cli.ts
+import { readFileSync } from "fs";
+
+// src/registry.ts
+var resources = new Map;
+function getResource(name) {
+  return resources.get(name);
+}
+function getAllResources() {
+  return resources;
+}
+
+// src/help.ts
+function topLevelHelp() {
+  const lines = [
+    "Usage: shopq <resource> <verb> [args] [flags]",
+    "",
+    "Global Flags:",
+    "  --json, -j       Output as JSON",
+    "  --help, -h       Show help",
+    "  --version, -v    Print version",
+    "  --store <url>    Store override",
+    "  --no-color       Disable colored output (also respects NO_COLOR env)",
+    ""
+  ];
+  const resources2 = getAllResources();
+  if (resources2.size > 0) {
+    lines.push("Resources:");
+    for (const [name, res] of resources2) {
+      lines.push(`  ${name.padEnd(16)} ${res.description}`);
+    }
+    lines.push("");
+  }
+  return lines.join(`
+`);
+}
+function resourceHelp(resourceName) {
+  const resource = getResource(resourceName);
+  if (!resource)
+    return;
+  const lines = [
+    `Usage: shopq ${resourceName} <verb> [args] [flags]`,
+    "",
+    `${resource.description}`,
+    "",
+    "Verbs:"
+  ];
+  for (const [verb, cmd] of resource.verbs) {
+    lines.push(`  ${verb.padEnd(16)} ${cmd.description}`);
+  }
+  lines.push("");
+  return lines.join(`
+`);
+}
+
+// src/parse.ts
+function parseArgs(argv) {
+  const flags = {
+    json: false,
+    help: false,
+    version: false,
+    noColor: "NO_COLOR" in process.env
+  };
+  const positional = [];
+  let i = 0;
+  while (i < argv.length) {
+    const arg = argv[i];
+    if (arg === "--version" || arg === "-v") {
+      flags.version = true;
+    } else if (arg === "--help" || arg === "-h") {
+      flags.help = true;
+    } else if (arg === "--json" || arg === "-j") {
+      flags.json = true;
+    } else if (arg === "--no-color") {
+      flags.noColor = true;
+    } else if (arg === "--store") {
+      i++;
+      flags.store = argv[i];
+    } else if (arg?.startsWith("--store=")) {
+      flags.store = arg.slice("--store=".length);
+    } else if (arg === "--vars") {
+      i++;
+      flags.vars = argv[i];
+    } else if (arg?.startsWith("--vars=")) {
+      flags.vars = arg.slice("--vars=".length);
+    } else if (arg === "--file") {
+      i++;
+      flags.file = argv[i];
+    } else if (arg?.startsWith("--file=")) {
+      flags.file = arg.slice("--file=".length);
+    } else if (arg === "--status") {
+      i++;
+      flags.status = argv[i];
+    } else if (arg?.startsWith("--status=")) {
+      flags.status = arg.slice("--status=".length);
+    } else if (arg === "--type") {
+      i++;
+      flags.type = argv[i];
+    } else if (arg?.startsWith("--type=")) {
+      flags.type = arg.slice("--type=".length);
+    } else if (arg === "--vendor") {
+      i++;
+      flags.vendor = argv[i];
+    } else if (arg?.startsWith("--vendor=")) {
+      flags.vendor = arg.slice("--vendor=".length);
+    } else if (arg === "--limit") {
+      i++;
+      flags.limit = argv[i];
+    } else if (arg?.startsWith("--limit=")) {
+      flags.limit = arg.slice("--limit=".length);
+    } else if (arg === "--cursor") {
+      i++;
+      flags.cursor = argv[i];
+    } else if (arg?.startsWith("--cursor=")) {
+      flags.cursor = arg.slice("--cursor=".length);
+    } else if (arg === "--title") {
+      i++;
+      flags.title = argv[i];
+    } else if (arg?.startsWith("--title=")) {
+      flags.title = arg.slice("--title=".length);
+    } else if (arg === "--handle") {
+      i++;
+      flags.handle = argv[i];
+    } else if (arg?.startsWith("--handle=")) {
+      flags.handle = arg.slice("--handle=".length);
+    } else if (arg === "--tags") {
+      i++;
+      flags.tags = argv[i];
+    } else if (arg?.startsWith("--tags=")) {
+      flags.tags = arg.slice("--tags=".length);
+    } else if (arg === "--description") {
+      i++;
+      flags.description = argv[i];
+    } else if (arg?.startsWith("--description=")) {
+      flags.description = arg.slice("--description=".length);
+    } else if (arg === "--variants") {
+      i++;
+      flags.variants = argv[i];
+    } else if (arg?.startsWith("--variants=")) {
+      flags.variants = arg.slice("--variants=".length);
+    } else if (arg === "--options") {
+      i++;
+      flags.options = argv[i];
+    } else if (arg?.startsWith("--options=")) {
+      flags.options = arg.slice("--options=".length);
+    } else if (arg === "--body") {
+      i++;
+      flags.body = argv[i];
+    } else if (arg?.startsWith("--body=")) {
+      flags.body = arg.slice("--body=".length);
+    } else if (arg === "--body-file") {
+      i++;
+      flags["body-file"] = argv[i];
+    } else if (arg?.startsWith("--body-file=")) {
+      flags["body-file"] = arg.slice("--body-file=".length);
+    } else if (arg === "--published") {
+      i++;
+      flags.published = argv[i];
+    } else if (arg?.startsWith("--published=")) {
+      flags.published = arg.slice("--published=".length);
+    } else if (arg === "--seo-title") {
+      i++;
+      flags["seo-title"] = argv[i];
+    } else if (arg?.startsWith("--seo-title=")) {
+      flags["seo-title"] = arg.slice("--seo-title=".length);
+    } else if (arg === "--seo-desc") {
+      i++;
+      flags["seo-desc"] = argv[i];
+    } else if (arg?.startsWith("--seo-desc=")) {
+      flags["seo-desc"] = arg.slice("--seo-desc=".length);
+    } else if (arg === "--yes" || arg === "-y") {
+      flags.yes = true;
+    } else if (arg) {
+      positional.push(arg);
+    }
+    i++;
+  }
+  return {
+    resource: positional[0],
+    verb: positional[1],
+    args: positional.slice(2),
+    flags
+  };
+}
+
+// src/cli.ts
+var pkgPath = new URL("../package.json", import.meta.url).pathname;
+var pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+async function run(argv) {
+  const parsed = parseArgs(argv);
+  if (parsed.flags.version) {
+    console.log(pkg.version);
+    return;
+  }
+  if (!parsed.resource || parsed.flags.help && !parsed.resource) {
+    console.log(topLevelHelp());
+    return;
+  }
+  const resource = getResource(parsed.resource);
+  if (parsed.flags.help && parsed.resource) {
+    const help = resourceHelp(parsed.resource);
+    if (help) {
+      console.log(help);
+      return;
+    }
+    process.stderr.write(`Error: unknown resource "${parsed.resource}"
+`);
+    process.exitCode = 2;
+    return;
+  }
+  if (!resource) {
+    process.stderr.write(`Error: unknown resource "${parsed.resource}"
+`);
+    process.exitCode = 2;
+    return;
+  }
+  if (!parsed.verb) {
+    const defaultCommand2 = resource.verbs.get("_default");
+    if (defaultCommand2) {
+      await defaultCommand2.handler(parsed);
+      return;
+    }
+    const help = resourceHelp(parsed.resource);
+    if (help)
+      console.log(help);
+    return;
+  }
+  const defaultCommand = resource.verbs.get("_default");
+  if (defaultCommand) {
+    parsed.args = [parsed.verb, ...parsed.args];
+    parsed.verb = undefined;
+    await defaultCommand.handler(parsed);
+    return;
+  }
+  const command = resource.verbs.get(parsed.verb);
+  if (!command) {
+    process.stderr.write(`Error: unknown verb "${parsed.verb}" for resource "${parsed.resource}"
+`);
+    process.exitCode = 2;
+    return;
+  }
+  await command.handler(parsed);
+}
+export {
+  run
+};

package/dist/shopq.js

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+import { createRequire } from "node:module";
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // src/graphql.ts
 var API_VERSION = "2026-01";
@@ -26,11 +28,34 @@ class HttpError extends Error {
 class ConfigError extends Error {
   missing;
   constructor(missing) {
-    super(`Missing required environment variables: ${missing.join(", ")}`);
+    super(`Missing required environment variables: ${missing.join(", ")}
+` + `Set them in ~/.config/shopq/.env, a local .env file, or as environment variables.`);
     this.missing = missing;
     this.name = "ConfigError";
   }
 }
+function loadConfigEnv() {
+  const xdgConfig = process.env.XDG_CONFIG_HOME || `${process.env.HOME || __require("os").homedir()}/.config`;
+  const configPath = `${xdgConfig}/shopq/.env`;
+  try {
+    const content = __require("fs").readFileSync(configPath, "utf-8");
+    for (const line of content.split(`
+`)) {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("#"))
+        continue;
+      const eqIdx = trimmed.indexOf("=");
+      if (eqIdx === -1)
+        continue;
+      const key = trimmed.slice(0, eqIdx).trim();
+      const value = trimmed.slice(eqIdx + 1).trim().replace(/^["']|["']$/g, "");
+      if (!process.env[key]) {
+        process.env[key] = value;
+      }
+    }
+  } catch {}
+}
+loadConfigEnv();
 function resolveConfig(storeFlag) {
   const missing = [];
   const store = storeFlag || process.env.SHOPIFY_STORE;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "shopq",
-	"version": "0.3.4",
+	"version": "0.3.8",
 	"description": "A zero-dependency Shopify Admin CLI built on Bun",
 	"type": "module",
 	"license": "MIT",
@@ -20,11 +20,11 @@
 	},
 	"repository": {
 		"type": "git",
-		"url": "git+https://github.com/c-99-e/shopq.git"
+		"url": "git+https://github.com/c99e/shopq.git"
 	},
-	"homepage": "https://github.com/c-99-e/shopq",
+	"homepage": "https://github.com/c99e/shopq",
 	"bugs": {
-		"url": "https://github.com/c-99-e/shopq/issues"
+		"url": "https://github.com/c99e/shopq/issues"
 	},
 	"keywords": [
 		"shopify",