@omni-commerce/cli 0.1.0

package/dist/index.js

@@ -0,0 +1,2630 @@
+#!/usr/bin/env node
+
+// src/run.ts
+import { stdin as input } from "process";
+import { OmniClient, OmniError } from "@omni-commerce/sdk";
+
+// src/argv.ts
+var GLOBAL_TRUE_FLAGS = /* @__PURE__ */ new Set([
+  "help",
+  "h",
+  "schema",
+  "dry-run",
+  "version",
+  "v"
+]);
+function parseArgv(argv) {
+  const trail = [];
+  const flags = {};
+  let help = false;
+  let schema = false;
+  let dryRun = false;
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (token === "--") {
+      trail.push(...argv.slice(index + 1));
+      break;
+    }
+    if (token === "-h" || token === "--help") {
+      help = true;
+      continue;
+    }
+    if (token === "--schema") {
+      schema = true;
+      continue;
+    }
+    if (token === "--dry-run") {
+      dryRun = true;
+      continue;
+    }
+    if (token === "-v" || token === "--version") {
+      flags.version = true;
+      continue;
+    }
+    if (token.startsWith("--")) {
+      const stripped = token.slice(2);
+      const eq = stripped.indexOf("=");
+      if (eq >= 0) {
+        flags[stripped.slice(0, eq)] = stripped.slice(eq + 1);
+        continue;
+      }
+      const next = argv[index + 1];
+      if (!next || next.startsWith("-") && next !== "-" || GLOBAL_TRUE_FLAGS.has(stripped)) {
+        flags[stripped] = true;
+        continue;
+      }
+      flags[stripped] = next;
+      index += 1;
+      continue;
+    }
+    if (token.startsWith("-") && token.length === 2) {
+      continue;
+    }
+    trail.push(token);
+  }
+  return { trail, flags, help, schema, dryRun };
+}
+function flagString(flags, name) {
+  const value = flags[name];
+  return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+
+// src/config.ts
+import { chmod, mkdir, readFile, rm, writeFile } from "fs/promises";
+import { homedir } from "os";
+import path from "path";
+function configPath() {
+  return path.join(homedir(), ".omni", "config.json");
+}
+async function readConfig() {
+  try {
+    const raw = await readFile(configPath(), "utf8");
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed === "object" ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+async function writeConfig(config) {
+  const directory = path.dirname(configPath());
+  await mkdir(directory, { recursive: true });
+  await writeFile(configPath(), `${JSON.stringify(config, null, 2)}
+`, "utf8");
+  await chmod(configPath(), 384);
+}
+async function clearConfig() {
+  await rm(configPath(), { force: true });
+}
+async function resolveCredentials(input2) {
+  const file = await readConfig();
+  const apiKey = input2.apiKey || process.env.OMNI_API_KEY || file.apiKey || void 0;
+  const source = input2.apiKey ? "flag" : process.env.OMNI_API_KEY ? "env" : file.apiKey ? "config" : "none";
+  const baseUrl = input2.baseUrl || process.env.OMNI_BASE_URL || file.baseUrl || "https://omnicommerce.sg";
+  return { apiKey, baseUrl, source };
+}
+function maskSecret(value) {
+  if (value.length <= 8) return "********";
+  return `${value.slice(0, 7)}\u2026${value.slice(-4)}`;
+}
+
+// src/execute.ts
+function interpolatePath(template, values) {
+  return template.replace(/\{([^}]+)\}/g, (_, name) => {
+    const value = values[name];
+    if (!value) {
+      throw new Error(`Missing required path parameter: ${name}`);
+    }
+    return encodeURIComponent(value);
+  });
+}
+function stringValue(value, flag) {
+  if (typeof value !== "string" || value.trim() === "") {
+    throw new Error(`Missing required flag --${flag}`);
+  }
+  return value;
+}
+async function executeCommand(client, command, request) {
+  if (command.resourcePath[0] === "jobs" && command.methodName === "wait") {
+    const jobId = stringValue(request.jobId, "job-id");
+    const organizationId = typeof request.organizationId === "string" ? request.organizationId : void 0;
+    return client.jobs.wait({ jobId, organizationId });
+  }
+  const pathValues = {};
+  const query = {};
+  const consumed = /* @__PURE__ */ new Set();
+  for (const flag of command.flags) {
+    const value = request[flag.name];
+    if (value === void 0) continue;
+    consumed.add(flag.name);
+    if (flag.source === "path") {
+      pathValues[flag.name] = stringValue(value, flag.flag);
+    } else {
+      query[flag.name] = value;
+    }
+  }
+  const body = {};
+  for (const [key, value] of Object.entries(request)) {
+    if (!consumed.has(key)) body[key] = value;
+  }
+  return client.request({
+    method: command.httpMethod,
+    path: interpolatePath(command.path, pathValues),
+    query: Object.keys(query).length > 0 ? query : void 0,
+    body: command.acceptsJsonBody && Object.keys(body).length > 0 ? body : void 0
+  });
+}
+
+// src/format.ts
+function resolveFormat(flag, stdoutIsTty) {
+  if (flag === "table" || flag === "json") return flag;
+  return stdoutIsTty ? "table" : "json";
+}
+function cell(value) {
+  if (value === null || value === void 0) return "";
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  return JSON.stringify(value);
+}
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function formatOutput(value, format) {
+  if (format === "json") return `${JSON.stringify(value, null, 2)}
+`;
+  if (Array.isArray(value) && value.every(isRecord)) {
+    if (value.length === 0) return "";
+    const keys = [...new Set(value.flatMap((row) => Object.keys(row)))].slice(
+      0,
+      8
+    );
+    const header = keys.join("	");
+    const body = value.map((row) => keys.map((key) => cell(row[key])).join("	")).join("\n");
+    return `${header}
+${body}
+`;
+  }
+  if (isRecord(value)) {
+    return `${Object.entries(value).map(([key, entry]) => `${key}	${cell(entry)}`).join("\n")}
+`;
+  }
+  return `${cell(value)}
+`;
+}
+
+// src/generated/commands.ts
+var COMMANDS = [
+  {
+    trail: ["api", "root"],
+    resourcePath: ["api"],
+    methodName: "root",
+    httpMethod: "GET",
+    path: "/api",
+    summary: "API Root",
+    flags: [],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["api", "v1"],
+    resourcePath: ["api"],
+    methodName: "v1",
+    httpMethod: "GET",
+    path: "/api/v1",
+    summary: "API v1 Root",
+    flags: [],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["aop", "get-config"],
+    resourcePath: ["aop"],
+    methodName: "getConfig",
+    httpMethod: "GET",
+    path: "/api/v1/aop/{aopId}/config",
+    summary: "Get AOP configuration",
+    flags: [
+      {
+        name: "aopId",
+        flag: "aop-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["aop", "update-config"],
+    resourcePath: ["aop"],
+    methodName: "updateConfig",
+    httpMethod: "PUT",
+    path: "/api/v1/aop/{aopId}/config",
+    summary: "Overwrite AOP configuration",
+    flags: [
+      {
+        name: "aopId",
+        flag: "aop-id",
+        required: true,
+        source: "path"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["aop", "execute"],
+    resourcePath: ["aop"],
+    methodName: "execute",
+    httpMethod: "POST",
+    path: "/api/v1/aop/{aopId}/execute",
+    summary: "Execute an AOP",
+    flags: [
+      {
+        name: "aopId",
+        flag: "aop-id",
+        required: true,
+        source: "path"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: false
+  },
+  {
+    trail: ["aop", "create"],
+    resourcePath: ["aop"],
+    methodName: "create",
+    httpMethod: "POST",
+    path: "/api/v1/aop/create",
+    summary: "Create AOP",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["aop", "retry"],
+    resourcePath: ["aop"],
+    methodName: "retry",
+    httpMethod: "POST",
+    path: "/api/v1/aop/retry",
+    summary: "Retry a failed AOP execution",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["catalog", "list-items"],
+    resourcePath: ["catalog"],
+    methodName: "listItems",
+    httpMethod: "GET",
+    path: "/api/v1/catalog/items",
+    summary: "Export Catalog Items",
+    flags: [
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "updatedSince",
+        flag: "updated-since",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "cursor",
+        flag: "cursor",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "limit",
+        flag: "limit",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "format",
+        flag: "format",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["checkout-sessions", "create"],
+    resourcePath: ["checkoutSessions"],
+    methodName: "create",
+    httpMethod: "POST",
+    path: "/api/v1/checkout-sessions",
+    summary: "Create Agentic Checkout Session",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["checkout-sessions", "get"],
+    resourcePath: ["checkoutSessions"],
+    methodName: "get",
+    httpMethod: "GET",
+    path: "/api/v1/checkout-sessions/{sessionId}",
+    summary: "Get Agentic Checkout Session",
+    flags: [
+      {
+        name: "sessionId",
+        flag: "session-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["checkout-sessions", "update"],
+    resourcePath: ["checkoutSessions"],
+    methodName: "update",
+    httpMethod: "PATCH",
+    path: "/api/v1/checkout-sessions/{sessionId}",
+    summary: "Update Agentic Checkout Session",
+    flags: [
+      {
+        name: "sessionId",
+        flag: "session-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["checkout-sessions", "replace"],
+    resourcePath: ["checkoutSessions"],
+    methodName: "replace",
+    httpMethod: "PUT",
+    path: "/api/v1/checkout-sessions/{sessionId}",
+    summary: "Replace Agentic Checkout Session Fields",
+    flags: [
+      {
+        name: "sessionId",
+        flag: "session-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["checkout-sessions", "cancel"],
+    resourcePath: ["checkoutSessions"],
+    methodName: "cancel",
+    httpMethod: "POST",
+    path: "/api/v1/checkout-sessions/{sessionId}/cancel",
+    summary: "Cancel Agentic Checkout Session",
+    flags: [
+      {
+        name: "sessionId",
+        flag: "session-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: false
+  },
+  {
+    trail: ["checkout-sessions", "complete"],
+    resourcePath: ["checkoutSessions"],
+    methodName: "complete",
+    httpMethod: "POST",
+    path: "/api/v1/checkout-sessions/{sessionId}/complete",
+    summary: "Complete Agentic Checkout Session",
+    flags: [
+      {
+        name: "sessionId",
+        flag: "session-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["compare", "get"],
+    resourcePath: ["compare"],
+    methodName: "get",
+    httpMethod: "GET",
+    path: "/api/v1/compare",
+    summary: "Compare Public Products",
+    flags: [
+      {
+        name: "products",
+        flag: "products",
+        required: true,
+        source: "query"
+      },
+      {
+        name: "language",
+        flag: "language",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["directory", "list"],
+    resourcePath: ["directory"],
+    methodName: "list",
+    httpMethod: "GET",
+    path: "/api/v1/directory",
+    summary: "List Public Merchants",
+    flags: [],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["evaluate", "run"],
+    resourcePath: ["evaluate"],
+    methodName: "run",
+    httpMethod: "POST",
+    path: "/api/v1/evaluate",
+    summary: "Evaluate SKU Readiness",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: false
+  },
+  {
+    trail: ["feed", "get-llms-txt"],
+    resourcePath: ["feed"],
+    methodName: "getLlmsTxt",
+    httpMethod: "GET",
+    path: "/api/v1/feed/{domain}/llms.txt",
+    summary: "Get Merchant LLM Feed",
+    flags: [
+      {
+        name: "domain",
+        flag: "domain",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "limit",
+        flag: "limit",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["images", "ghost-mannequin"],
+    resourcePath: ["images"],
+    methodName: "ghostMannequin",
+    httpMethod: "POST",
+    path: "/api/v1/images/ghost-mannequin",
+    summary: "Generate Ghost Mannequin Image",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["jobs", "get"],
+    resourcePath: ["jobs"],
+    methodName: "get",
+    httpMethod: "GET",
+    path: "/api/v1/jobs/{jobId}",
+    summary: "Get Developer Job Status",
+    flags: [
+      {
+        name: "jobId",
+        flag: "job-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["jobs", "cancel"],
+    resourcePath: ["jobs"],
+    methodName: "cancel",
+    httpMethod: "POST",
+    path: "/api/v1/jobs/{jobId}/cancel",
+    summary: "Cancel Developer Job",
+    flags: [
+      {
+        name: "jobId",
+        flag: "job-id",
+        required: true,
+        source: "path"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: false
+  },
+  {
+    trail: ["looks", "list"],
+    resourcePath: ["looks"],
+    methodName: "list",
+    httpMethod: "GET",
+    path: "/api/v1/looks",
+    summary: "List Looks",
+    flags: [
+      {
+        name: "q",
+        flag: "q",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "status",
+        flag: "status",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "limit",
+        flag: "limit",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "offset",
+        flag: "offset",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["looks", "create"],
+    resourcePath: ["looks"],
+    methodName: "create",
+    httpMethod: "POST",
+    path: "/api/v1/looks",
+    summary: "Create Look",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["looks", "get"],
+    resourcePath: ["looks"],
+    methodName: "get",
+    httpMethod: "GET",
+    path: "/api/v1/looks/{lookId}",
+    summary: "Get Look",
+    flags: [
+      {
+        name: "lookId",
+        flag: "look-id",
+        required: true,
+        source: "path"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["product-categories", "recommend"],
+    resourcePath: ["productCategories"],
+    methodName: "recommend",
+    httpMethod: "POST",
+    path: "/api/v1/manage-product-category/recommend",
+    summary: "Recommend Marketplace Product Categories",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["marketplaces", "list-connected"],
+    resourcePath: ["marketplaces"],
+    methodName: "listConnected",
+    httpMethod: "GET",
+    path: "/api/v1/marketplaces/connected",
+    summary: "List Connected Marketplaces",
+    flags: [
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "marketplace",
+        flag: "marketplace",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "country",
+        flag: "country",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["merchants", "get-manifest"],
+    resourcePath: ["merchants"],
+    methodName: "getManifest",
+    httpMethod: "GET",
+    path: "/api/v1/merchants/{merchantId}/manifest",
+    summary: "Get Public Merchant Manifest",
+    flags: [
+      {
+        name: "merchantId",
+        flag: "merchant-id",
+        required: true,
+        source: "path"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["merchants", "list-products"],
+    resourcePath: ["merchants"],
+    methodName: "listProducts",
+    httpMethod: "GET",
+    path: "/api/v1/merchants/{merchantId}/products",
+    summary: "List Public Merchant Products",
+    flags: [
+      {
+        name: "merchantId",
+        flag: "merchant-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "platform",
+        flag: "platform",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "country",
+        flag: "country",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "language",
+        flag: "language",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "limit",
+        flag: "limit",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "offset",
+        flag: "offset",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["merchants", "search"],
+    resourcePath: ["merchants"],
+    methodName: "search",
+    httpMethod: "GET",
+    path: "/api/v1/merchants/{merchantId}/search",
+    summary: "Search Within Public Merchant Catalog",
+    flags: [
+      {
+        name: "merchantId",
+        flag: "merchant-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "q",
+        flag: "q",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "category",
+        flag: "category",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "brand",
+        flag: "brand",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "min_price",
+        flag: "min-price",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "max_price",
+        flag: "max-price",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "in_stock",
+        flag: "in-stock",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "sort",
+        flag: "sort",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "platform",
+        flag: "platform",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "country",
+        flag: "country",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "language",
+        flag: "language",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "include_intent",
+        flag: "include-intent",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "limit",
+        flag: "limit",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "offset",
+        flag: "offset",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["monitor", "run"],
+    resourcePath: ["monitor"],
+    methodName: "run",
+    httpMethod: "POST",
+    path: "/api/v1/monitor",
+    summary: "Run AI Shelf Share Monitor",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: false
+  },
+  {
+    trail: ["oauth", "revoke"],
+    resourcePath: ["oauth"],
+    methodName: "revoke",
+    httpMethod: "POST",
+    path: "/api/v1/oauth/revoke",
+    summary: "Revoke Access Token",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["oauth", "token"],
+    resourcePath: ["oauth"],
+    methodName: "token",
+    httpMethod: "POST",
+    path: "/api/v1/oauth/token",
+    summary: "Get Access Token",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["orders", "list"],
+    resourcePath: ["orders"],
+    methodName: "list",
+    httpMethod: "GET",
+    path: "/api/v1/orders",
+    summary: "List Orders",
+    flags: [
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "q",
+        flag: "q",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "status",
+        flag: "status",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "marketplace",
+        flag: "marketplace",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "country",
+        flag: "country",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "store",
+        flag: "store",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "bundleType",
+        flag: "bundle-type",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "sortBy",
+        flag: "sort-by",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "dateFrom",
+        flag: "date-from",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "dateTo",
+        flag: "date-to",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "limit",
+        flag: "limit",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "offset",
+        flag: "offset",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["orders", "create"],
+    resourcePath: ["orders"],
+    methodName: "create",
+    httpMethod: "POST",
+    path: "/api/v1/orders",
+    summary: "Create Order",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["orders", "get"],
+    resourcePath: ["orders"],
+    methodName: "get",
+    httpMethod: "GET",
+    path: "/api/v1/orders/{orderId}",
+    summary: "Get Order",
+    flags: [
+      {
+        name: "orderId",
+        flag: "order-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["orders", "update"],
+    resourcePath: ["orders"],
+    methodName: "update",
+    httpMethod: "PATCH",
+    path: "/api/v1/orders/{orderId}",
+    summary: "Update Order",
+    flags: [
+      {
+        name: "orderId",
+        flag: "order-id",
+        required: true,
+        source: "path"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["organizations", "create"],
+    resourcePath: ["organizations"],
+    methodName: "create",
+    httpMethod: "POST",
+    path: "/api/v1/organizations",
+    summary: "Create Organization",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["price-books", "list"],
+    resourcePath: ["priceBooks"],
+    methodName: "list",
+    httpMethod: "GET",
+    path: "/api/v1/price-books",
+    summary: "List Price Book Rules",
+    flags: [
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "platform",
+        flag: "platform",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "enabledOnly",
+        flag: "enabled-only",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["price-books", "create"],
+    resourcePath: ["priceBooks"],
+    methodName: "create",
+    httpMethod: "POST",
+    path: "/api/v1/price-books",
+    summary: "Create Price Book Rule",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["price-books", "delete"],
+    resourcePath: ["priceBooks"],
+    methodName: "delete",
+    httpMethod: "DELETE",
+    path: "/api/v1/price-books/{ruleId}",
+    summary: "Delete Price Book Rule",
+    flags: [
+      {
+        name: "ruleId",
+        flag: "rule-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["price-books", "get"],
+    resourcePath: ["priceBooks"],
+    methodName: "get",
+    httpMethod: "GET",
+    path: "/api/v1/price-books/{ruleId}",
+    summary: "Get Price Book Rule",
+    flags: [
+      {
+        name: "ruleId",
+        flag: "rule-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["price-books", "update"],
+    resourcePath: ["priceBooks"],
+    methodName: "update",
+    httpMethod: "PATCH",
+    path: "/api/v1/price-books/{ruleId}",
+    summary: "Update Price Book Rule",
+    flags: [
+      {
+        name: "ruleId",
+        flag: "rule-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["price-books", "preview"],
+    resourcePath: ["priceBooks"],
+    methodName: "preview",
+    httpMethod: "POST",
+    path: "/api/v1/price-books/preview",
+    summary: "Preview Channel List Price",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["products", "list"],
+    resourcePath: ["products"],
+    methodName: "list",
+    httpMethod: "GET",
+    path: "/api/v1/products",
+    summary: "List Products",
+    flags: [
+      {
+        name: "status",
+        flag: "status",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "marketplace",
+        flag: "marketplace",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "country",
+        flag: "country",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "q",
+        flag: "q",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "sku",
+        flag: "sku",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "minPrice",
+        flag: "min-price",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "maxPrice",
+        flag: "max-price",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "sortBy",
+        flag: "sort-by",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "limit",
+        flag: "limit",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "offset",
+        flag: "offset",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["products", "create"],
+    resourcePath: ["products"],
+    methodName: "create",
+    httpMethod: "POST",
+    path: "/api/v1/products",
+    summary: "Create Product",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["products", "delete"],
+    resourcePath: ["products"],
+    methodName: "delete",
+    httpMethod: "DELETE",
+    path: "/api/v1/products/{productId}",
+    summary: "Delete Product",
+    flags: [
+      {
+        name: "productId",
+        flag: "product-id",
+        required: true,
+        source: "path"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["products", "get"],
+    resourcePath: ["products"],
+    methodName: "get",
+    httpMethod: "GET",
+    path: "/api/v1/products/{productId}",
+    summary: "Get Product",
+    flags: [
+      {
+        name: "productId",
+        flag: "product-id",
+        required: true,
+        source: "path"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["products", "update"],
+    resourcePath: ["products"],
+    methodName: "update",
+    httpMethod: "PATCH",
+    path: "/api/v1/products/{productId}",
+    summary: "Update Product",
+    flags: [
+      {
+        name: "productId",
+        flag: "product-id",
+        required: true,
+        source: "path"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["products", "update-cost"],
+    resourcePath: ["products"],
+    methodName: "updateCost",
+    httpMethod: "PATCH",
+    path: "/api/v1/products/{productId}/cost",
+    summary: "Update Product Cost",
+    flags: [
+      {
+        name: "productId",
+        flag: "product-id",
+        required: true,
+        source: "path"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["products", "delist"],
+    resourcePath: ["products"],
+    methodName: "delist",
+    httpMethod: "POST",
+    path: "/api/v1/products/{productId}/delist",
+    summary: "Delist Product",
+    flags: [
+      {
+        name: "productId",
+        flag: "product-id",
+        required: true,
+        source: "path"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: false
+  },
+  {
+    trail: ["products", "update-inventory"],
+    resourcePath: ["products"],
+    methodName: "updateInventory",
+    httpMethod: "PATCH",
+    path: "/api/v1/products/{productId}/inventory",
+    summary: "Update Product Inventory",
+    flags: [
+      {
+        name: "productId",
+        flag: "product-id",
+        required: true,
+        source: "path"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["products", "update-price"],
+    resourcePath: ["products"],
+    methodName: "updatePrice",
+    httpMethod: "PATCH",
+    path: "/api/v1/products/{productId}/price",
+    summary: "Update Product Price",
+    flags: [
+      {
+        name: "productId",
+        flag: "product-id",
+        required: true,
+        source: "path"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["products", "publish"],
+    resourcePath: ["products"],
+    methodName: "publish",
+    httpMethod: "POST",
+    path: "/api/v1/products/{productId}/publish",
+    summary: "Publish Product",
+    flags: [
+      {
+        name: "productId",
+        flag: "product-id",
+        required: true,
+        source: "path"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: false
+  },
+  {
+    trail: ["products", "bulk-import"],
+    resourcePath: ["products"],
+    methodName: "bulkImport",
+    httpMethod: "POST",
+    path: "/api/v1/products/bulk-import",
+    summary: "Bulk Import Products from JSON or CSV",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["products", "update-costs"],
+    resourcePath: ["products"],
+    methodName: "updateCosts",
+    httpMethod: "POST",
+    path: "/api/v1/products/cost",
+    summary: "Batch Update Product Cost",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["products", "enrich"],
+    resourcePath: ["products"],
+    methodName: "enrich",
+    httpMethod: "POST",
+    path: "/api/v1/products/enrich",
+    summary: "Queue Product Enrichment",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["promotions", "list"],
+    resourcePath: ["promotions"],
+    methodName: "list",
+    httpMethod: "GET",
+    path: "/api/v1/promotions",
+    summary: "List Promotions",
+    flags: [
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "q",
+        flag: "q",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "status",
+        flag: "status",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "marketplace",
+        flag: "marketplace",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "store",
+        flag: "store",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "sortBy",
+        flag: "sort-by",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "sortDir",
+        flag: "sort-dir",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "limit",
+        flag: "limit",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "offset",
+        flag: "offset",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["promotions", "create"],
+    resourcePath: ["promotions"],
+    methodName: "create",
+    httpMethod: "POST",
+    path: "/api/v1/promotions",
+    summary: "Create Promotion",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["promotions", "delete"],
+    resourcePath: ["promotions"],
+    methodName: "delete",
+    httpMethod: "DELETE",
+    path: "/api/v1/promotions/{promotionId}",
+    summary: "Delete Promotion",
+    flags: [
+      {
+        name: "promotionId",
+        flag: "promotion-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["promotions", "get"],
+    resourcePath: ["promotions"],
+    methodName: "get",
+    httpMethod: "GET",
+    path: "/api/v1/promotions/{promotionId}",
+    summary: "Get Promotion",
+    flags: [
+      {
+        name: "promotionId",
+        flag: "promotion-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["promotions", "update"],
+    resourcePath: ["promotions"],
+    methodName: "update",
+    httpMethod: "PATCH",
+    path: "/api/v1/promotions/{promotionId}",
+    summary: "Update Promotion",
+    flags: [
+      {
+        name: "promotionId",
+        flag: "promotion-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["promotions", "remove-products"],
+    resourcePath: ["promotions"],
+    methodName: "removeProducts",
+    httpMethod: "DELETE",
+    path: "/api/v1/promotions/{promotionId}/products",
+    summary: "Unassign Products from Promotion",
+    flags: [
+      {
+        name: "promotionId",
+        flag: "promotion-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["promotions", "list-products"],
+    resourcePath: ["promotions"],
+    methodName: "listProducts",
+    httpMethod: "GET",
+    path: "/api/v1/promotions/{promotionId}/products",
+    summary: "List Promotion Assignments",
+    flags: [
+      {
+        name: "promotionId",
+        flag: "promotion-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["promotions", "add-products"],
+    resourcePath: ["promotions"],
+    methodName: "addProducts",
+    httpMethod: "POST",
+    path: "/api/v1/promotions/{promotionId}/products",
+    summary: "Assign Products to Promotion",
+    flags: [
+      {
+        name: "promotionId",
+        flag: "promotion-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["promotions", "sync"],
+    resourcePath: ["promotions"],
+    methodName: "sync",
+    httpMethod: "POST",
+    path: "/api/v1/promotions/{promotionId}/sync",
+    summary: "Sync Promotion to Marketplaces",
+    flags: [
+      {
+        name: "promotionId",
+        flag: "promotion-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["returns", "list"],
+    resourcePath: ["returns"],
+    methodName: "list",
+    httpMethod: "GET",
+    path: "/api/v1/returns",
+    summary: "List Returns",
+    flags: [
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "marketplace",
+        flag: "marketplace",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "accountId",
+        flag: "account-id",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "externalOrderId",
+        flag: "external-order-id",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "updatedSince",
+        flag: "updated-since",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "cursor",
+        flag: "cursor",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "limit",
+        flag: "limit",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["returns", "get"],
+    resourcePath: ["returns"],
+    methodName: "get",
+    httpMethod: "GET",
+    path: "/api/v1/returns/{returnId}",
+    summary: "Get Return",
+    flags: [
+      {
+        name: "returnId",
+        flag: "return-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["search", "list"],
+    resourcePath: ["search"],
+    methodName: "list",
+    httpMethod: "GET",
+    path: "/api/v1/search",
+    summary: "Search Public Merchant Products",
+    flags: [
+      {
+        name: "q",
+        flag: "q",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "category",
+        flag: "category",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "brand",
+        flag: "brand",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "min_price",
+        flag: "min-price",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "max_price",
+        flag: "max-price",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "in_stock",
+        flag: "in-stock",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "merchant_ids",
+        flag: "merchant-ids",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "sort",
+        flag: "sort",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "platform",
+        flag: "platform",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "country",
+        flag: "country",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "language",
+        flag: "language",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "include_intent",
+        flag: "include-intent",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "limit",
+        flag: "limit",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "offset",
+        flag: "offset",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["search", "query"],
+    resourcePath: ["search"],
+    methodName: "query",
+    httpMethod: "POST",
+    path: "/api/v1/search",
+    summary: "Search Public Merchant Products",
+    flags: [
+      {
+        name: "q",
+        flag: "q",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "category",
+        flag: "category",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "brand",
+        flag: "brand",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "min_price",
+        flag: "min-price",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "max_price",
+        flag: "max-price",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "in_stock",
+        flag: "in-stock",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "merchant_ids",
+        flag: "merchant-ids",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "sort",
+        flag: "sort",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "platform",
+        flag: "platform",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "country",
+        flag: "country",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "language",
+        flag: "language",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "include_intent",
+        flag: "include-intent",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "limit",
+        flag: "limit",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "offset",
+        flag: "offset",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: false
+  },
+  {
+    trail: ["settlements", "list"],
+    resourcePath: ["settlements"],
+    methodName: "list",
+    httpMethod: "GET",
+    path: "/api/v1/settlements",
+    summary: "List Settlements",
+    flags: [
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "marketplace",
+        flag: "marketplace",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "accountId",
+        flag: "account-id",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "orderId",
+        flag: "order-id",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "externalOrderId",
+        flag: "external-order-id",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "updatedSince",
+        flag: "updated-since",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "cursor",
+        flag: "cursor",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "limit",
+        flag: "limit",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["settlements", "create"],
+    resourcePath: ["settlements"],
+    methodName: "create",
+    httpMethod: "POST",
+    path: "/api/v1/settlements",
+    summary: "Apply Settlements",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["settlements", "get"],
+    resourcePath: ["settlements"],
+    methodName: "get",
+    httpMethod: "GET",
+    path: "/api/v1/settlements/{settlementId}",
+    summary: "Get Settlement",
+    flags: [
+      {
+        name: "settlementId",
+        flag: "settlement-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["sync", "run"],
+    resourcePath: ["sync"],
+    methodName: "run",
+    httpMethod: "POST",
+    path: "/api/v1/sync",
+    summary: "Sync Product Commercial Fields",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: false
+  },
+  {
+    trail: ["threads", "get-status"],
+    resourcePath: ["threads"],
+    methodName: "getStatus",
+    httpMethod: "GET",
+    path: "/api/v1/threads/{thread_id}/status",
+    summary: "Get Thread Status",
+    flags: [
+      {
+        name: "thread_id",
+        flag: "thread-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "include_messages",
+        flag: "include-messages",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["webhook-events", "list"],
+    resourcePath: ["webhookEvents"],
+    methodName: "list",
+    httpMethod: "GET",
+    path: "/api/v1/webhook-events",
+    summary: "List Webhook Events",
+    flags: [
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "eventType",
+        flag: "event-type",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "occurredSince",
+        flag: "occurred-since",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "cursor",
+        flag: "cursor",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "limit",
+        flag: "limit",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["webhooks", "list"],
+    resourcePath: ["webhooks"],
+    methodName: "list",
+    httpMethod: "GET",
+    path: "/api/v1/webhooks",
+    summary: "List Developer Webhooks",
+    flags: [],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["webhooks", "create"],
+    resourcePath: ["webhooks"],
+    methodName: "create",
+    httpMethod: "POST",
+    path: "/api/v1/webhooks",
+    summary: "Create Developer Webhook",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["zalora", "get-import"],
+    resourcePath: ["zalora"],
+    methodName: "getImport",
+    httpMethod: "GET",
+    path: "/api/v1/zalora/import",
+    summary: "Get Selected Zalora Import Status",
+    flags: [
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "jobId",
+        flag: "job-id",
+        required: true,
+        source: "query"
+      },
+      {
+        name: "storeId",
+        flag: "store-id",
+        required: true,
+        source: "query"
+      },
+      {
+        name: "productSetIds",
+        flag: "product-set-ids",
+        required: true,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["zalora", "import-products"],
+    resourcePath: ["zalora"],
+    methodName: "importProducts",
+    httpMethod: "POST",
+    path: "/api/v1/zalora/import",
+    summary: "Import Selected Zalora Products",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["ucp", "checkout-sessions", "create"],
+    resourcePath: ["ucp", "checkoutSessions"],
+    methodName: "create",
+    httpMethod: "POST",
+    path: "/ucp/v1/checkout-sessions",
+    summary: "Create UCP Checkout Session",
+    flags: [],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["ucp", "checkout-sessions", "get"],
+    resourcePath: ["ucp", "checkoutSessions"],
+    methodName: "get",
+    httpMethod: "GET",
+    path: "/ucp/v1/checkout-sessions/{sessionId}",
+    summary: "Get UCP Checkout Session",
+    flags: [
+      {
+        name: "sessionId",
+        flag: "session-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["ucp", "checkout-sessions", "update"],
+    resourcePath: ["ucp", "checkoutSessions"],
+    methodName: "update",
+    httpMethod: "PATCH",
+    path: "/ucp/v1/checkout-sessions/{sessionId}",
+    summary: "Update UCP Checkout Session",
+    flags: [
+      {
+        name: "sessionId",
+        flag: "session-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["ucp", "checkout-sessions", "replace"],
+    resourcePath: ["ucp", "checkoutSessions"],
+    methodName: "replace",
+    httpMethod: "PUT",
+    path: "/ucp/v1/checkout-sessions/{sessionId}",
+    summary: "Replace UCP Checkout Session Fields",
+    flags: [
+      {
+        name: "sessionId",
+        flag: "session-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["ucp", "checkout-sessions", "cancel"],
+    resourcePath: ["ucp", "checkoutSessions"],
+    methodName: "cancel",
+    httpMethod: "POST",
+    path: "/ucp/v1/checkout-sessions/{sessionId}/cancel",
+    summary: "Cancel UCP Checkout Session",
+    flags: [
+      {
+        name: "sessionId",
+        flag: "session-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: false
+  },
+  {
+    trail: ["ucp", "checkout-sessions", "complete"],
+    resourcePath: ["ucp", "checkoutSessions"],
+    methodName: "complete",
+    httpMethod: "POST",
+    path: "/ucp/v1/checkout-sessions/{sessionId}/complete",
+    summary: "Complete UCP Checkout Session",
+    flags: [
+      {
+        name: "sessionId",
+        flag: "session-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: true,
+    bodyRequired: true
+  },
+  {
+    trail: ["ucp", "orders", "get"],
+    resourcePath: ["ucp", "orders"],
+    methodName: "get",
+    httpMethod: "GET",
+    path: "/ucp/v1/orders/{orderId}",
+    summary: "Get UCP Order",
+    flags: [
+      {
+        name: "orderId",
+        flag: "order-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["jobs", "wait"],
+    resourcePath: ["jobs"],
+    methodName: "wait",
+    httpMethod: "GET",
+    path: "/api/v1/jobs/{jobId}",
+    summary: "Poll a developer job until the nested status is terminal",
+    flags: [
+      {
+        name: "jobId",
+        flag: "job-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    bodyRequired: false
+  }
+];
+
+// src/help.ts
+function printRootHelp(commands) {
+  const groups = [
+    ...new Set(commands.map((command) => command.trail[0]))
+  ].sort();
+  return `OmniCommerce CLI
+
+Usage:
+  omni <resource> <command> [flags]
+  omni auth login --api-key omni_sk_...
+  omni auth status
+  omni auth logout
+
+Resources:
+${groups.map((group) => `  ${group}`).join("\n")}
+
+Global flags:
+  --api-key <key>     API key (or OMNI_API_KEY / omni auth login)
+  --base-url <url>    API origin (default https://omnicommerce.sg)
+  --json <object|->   JSON body, or - to read stdin
+  --format json|table Output format (table on TTY, json when piped)
+  --dry-run           Print the request without sending it
+  --schema            Print flags for this command
+  --timeout <seconds> Request timeout
+  --help              Show help
+
+Examples:
+  omni products list --q lamp
+  omni products get --product-id prod_123
+  omni products create --json '{"product":{"sku":"SKU-1","title":"Lamp"}}'
+  omni jobs wait --job-id prod_123
+`;
+}
+function printCommandHelp(command) {
+  const flags = command.flags.map((flag) => {
+    const req = flag.required ? "required" : "optional";
+    return `  --${flag.flag} <${flag.name}>  ${req} ${flag.source}`;
+  }).join("\n");
+  const jsonLine = command.acceptsJsonBody ? `  --json <object|->  ${command.bodyRequired ? "required" : "optional"} body
+` : "";
+  return `omni ${command.trail.join(" ")}
+
+${command.summary}
+
+${command.httpMethod} ${command.path}
+
+Flags:
+${flags || "  (none)"}${jsonLine ? `
+${jsonLine}` : ""}
+`;
+}
+function matchCommands(commands, trail) {
+  const prefix = commands.filter(
+    (command) => trail.every((token, index) => command.trail[index] === token)
+  );
+  const exact = prefix.find((command) => command.trail.length === trail.length);
+  return { exact, prefix };
+}
+
+// src/version.ts
+var CLI_VERSION = "0.1.0";
+
+// src/run.ts
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of input) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
+async function parseJsonBody(raw) {
+  if (!raw) return void 0;
+  const text = raw === "-" ? await readStdin() : raw;
+  const parsed = JSON.parse(text);
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error("--json must be a JSON object");
+  }
+  return parsed;
+}
+function buildRequest(command, flags, body) {
+  const request = { ...body };
+  for (const flag of command.flags) {
+    const value = flagString(flags, flag.flag);
+    if (value === void 0) {
+      if (flag.required) {
+        throw new Error(`Missing required flag --${flag.flag}`);
+      }
+      continue;
+    }
+    request[flag.name] = value;
+  }
+  return request;
+}
+async function handleAuth(trail, flags) {
+  const action = trail[1] ?? "status";
+  if (action === "login") {
+    const apiKey = flagString(flags, "api-key");
+    if (!apiKey) {
+      throw new Error("omni auth login requires --api-key");
+    }
+    const existing = await readConfig();
+    await writeConfig({
+      ...existing,
+      apiKey,
+      baseUrl: flagString(flags, "base-url") ?? existing.baseUrl
+    });
+    process.stdout.write(
+      `Saved credentials to config (${maskSecret(apiKey)})
+`
+    );
+    return 0;
+  }
+  if (action === "logout") {
+    await clearConfig();
+    process.stdout.write("Removed saved credentials\n");
+    return 0;
+  }
+  const resolved = await resolveCredentials({
+    apiKey: flagString(flags, "api-key"),
+    baseUrl: flagString(flags, "base-url")
+  });
+  process.stdout.write(
+    `source	${resolved.source}
+baseUrl	${resolved.baseUrl}
+apiKey	${resolved.apiKey ? maskSecret(resolved.apiKey) : "(missing)"}
+`
+  );
+  return resolved.apiKey ? 0 : 1;
+}
+async function runCli(argv, options) {
+  const parsed = parseArgv(argv);
+  if (parsed.flags.version === true) {
+    process.stdout.write(`${CLI_VERSION}
+`);
+    return 0;
+  }
+  if (parsed.trail[0] === "auth") {
+    return handleAuth(parsed.trail, parsed.flags);
+  }
+  if (parsed.trail.length === 0) {
+    process.stdout.write(printRootHelp(COMMANDS));
+    return parsed.help ? 0 : 1;
+  }
+  const matched = matchCommands(COMMANDS, parsed.trail);
+  if (parsed.help && !matched.exact) {
+    if (matched.prefix.length === 0) {
+      process.stderr.write(`Unknown command: ${parsed.trail.join(" ")}
+`);
+      process.stdout.write(printRootHelp(COMMANDS));
+      return 1;
+    }
+    const unique = [
+      ...new Set(matched.prefix.map((command2) => command2.trail.join(" ")))
+    ];
+    process.stdout.write(
+      `omni ${parsed.trail.join(" ")}
+
+Commands:
+${unique.map((line) => `  omni ${line}`).join("\n")}
+`
+    );
+    return 0;
+  }
+  const command = matched.exact;
+  if (!command) {
+    process.stderr.write(`Unknown command: ${parsed.trail.join(" ")}
+`);
+    process.stdout.write(printRootHelp(COMMANDS));
+    return 1;
+  }
+  if (parsed.help) {
+    process.stdout.write(printCommandHelp(command));
+    return 0;
+  }
+  if (parsed.schema) {
+    process.stdout.write(`${JSON.stringify(command, null, 2)}
+`);
+    return 0;
+  }
+  const body = await parseJsonBody(flagString(parsed.flags, "json"));
+  if (command.bodyRequired && !body) {
+    throw new Error(`omni ${command.trail.join(" ")} requires --json`);
+  }
+  const request = buildRequest(command, parsed.flags, body);
+  if (parsed.dryRun) {
+    process.stdout.write(
+      `${JSON.stringify(
+        {
+          method: command.httpMethod,
+          path: command.path,
+          request
+        },
+        null,
+        2
+      )}
+`
+    );
+    return 0;
+  }
+  const credentials = await resolveCredentials({
+    apiKey: flagString(parsed.flags, "api-key"),
+    baseUrl: flagString(parsed.flags, "base-url")
+  });
+  if (!credentials.apiKey) {
+    process.stderr.write(
+      "Missing API key. Pass --api-key, set OMNI_API_KEY, or run omni auth login.\n"
+    );
+    return 1;
+  }
+  const timeoutRaw = flagString(parsed.flags, "timeout");
+  const timeoutInSeconds = timeoutRaw ? Number(timeoutRaw) : void 0;
+  const client = new OmniClient({
+    apiKey: credentials.apiKey,
+    baseUrl: credentials.baseUrl,
+    timeoutInSeconds: timeoutInSeconds && Number.isFinite(timeoutInSeconds) ? timeoutInSeconds : void 0,
+    fetch: options?.fetch
+  });
+  try {
+    const result = await executeCommand(client, command, request);
+    const format = resolveFormat(
+      flagString(parsed.flags, "format"),
+      options?.stdoutIsTty ?? Boolean(process.stdout.isTTY)
+    );
+    process.stdout.write(formatOutput(result, format));
+    return 0;
+  } catch (error) {
+    if (error instanceof OmniError) {
+      process.stderr.write(
+        `${error.name}: ${error.message}${error.statusCode ? ` (${error.statusCode})` : ""}
+`
+      );
+      if (error.body) {
+        process.stderr.write(`${JSON.stringify(error.body, null, 2)}
+`);
+      }
+      return 1;
+    }
+    throw error;
+  }
+}
+
+// src/index.ts
+var main = async () => {
+  try {
+    const code = await runCli(process.argv.slice(2), {
+      stdoutIsTty: Boolean(process.stdout.isTTY)
+    });
+    process.exitCode = code;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`${message}
+`);
+    process.exitCode = 1;
+  }
+};
+void main();
+//# sourceMappingURL=index.js.map