@stithy/pod 0.1.0

package/LICENSE

@@ -0,0 +1,26 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Stithy
+Licensed Work:        @stithy/memory
+                      Copyright (c) 2026 Stithy
+Additional Use Grant: You may use the Licensed Work for non-production
+                      use, internal evaluation, and personal projects
+                      free of charge. Production use by organizations
+                      with annual revenue over $1M USD requires a
+                      commercial license purchased through the MCP
+                      Marketplace or directly from Stithy.
+
+Change Date:          2028-04-12
+Change License:       Apache License, Version 2.0
+
+For full BSL 1.1 terms see: https://mariadb.com/bsl11/
+
+---
+
+Notice
+
+The Business Source License (this document, or the "License") is not an
+Open Source license. However, the Licensed Work will eventually be made
+available under an Open Source License, as stated in this License.

package/README.md

@@ -0,0 +1,57 @@
+# @stithy/pod
+
+> Manage Printify, Printful, and Gelato from one prompt. Sync products, track orders, calculate margins — without leaving your AI client.
+
+Stithy POD is an MCP server that wraps the official APIs of the major print-on-demand platforms behind a single conversational interface. It's not a workflow-automation tool — it's an AI-native bulk operator: "list these 50 designs across Printify and Gelato with these prices and SEO titles" in one prompt.
+
+## Outcomes
+
+- **One prompt to rule them all.** Sync products, push prices, pull orders across every connected platform.
+- **See your real margins.** Cached price + cost across providers, sorted by margin %.
+- **Stop missing low stock.** A single tool call surfaces every SKU at risk on Printify.
+- **Credentials never leave your machine.** API keys are AES-256-GCM encrypted at rest with a per-machine master key.
+
+## Install
+
+```
+npx -y @stithy/pod install
+```
+
+Then run, in your AI client:
+
+```
+configure_provider provider=printify api_key=<your key> shop_id=<your shop id>
+```
+
+Repeat for printful / gelato as desired.
+
+## v0.1 Provider Coverage
+
+| Capability | Printify | Printful | Gelato |
+|---|---|---|---|
+| List products | ✅ | ✅ | ✅ |
+| List orders | ✅ | ✅ | ✅ |
+| Update pricing | ✅ | — | — |
+| Pause / unpause listing | ✅ | — | — |
+| Stock query | ✅ | — | — |
+
+Full Printful and Gelato write paths land in v0.2.
+
+## Tools (12)
+
+`configure_provider`, `list_providers`, `remove_provider`, `list_products`, `update_product_pricing`, `pause_listing`, `unpause_listing`, `list_orders`, `calculate_margins`, `low_stock_alert`, `revenue_summary`, `platform_health`.
+
+## Security & Platform Risk
+
+- API keys are encrypted at rest. The master key is generated per-machine and stored in `~/.stithy/.pod_master` (chmod 600). Override with `STITHY_POD_MASTER_KEY` in production.
+- Each buyer brings their own platform API keys. Stithy POD does not syndicate API access (Printify ToS compliant — no relay of one shop's credentials to another user).
+- We don't control Printify, Printful, or Gelato uptime, rate limits, or policy changes. The adapter pattern means a single provider going dark won't break the others.
+- Etsy is intentionally not supported. Etsy banned new sellers from third-party POD sync in 2026; existing sellers can already use Printify/Printful/Gelato sync directly.
+
+## License
+
+[BUSL-1.1](./LICENSE). Free for personal and commercial use under $1M annual revenue. Commercial license via mcp-marketplace.io.
+
+## Maintained
+
+Active maintenance, 7-day bug-fix turnaround, 30-day refund. Issues: https://github.com/resolceo-ai/stithy-mcp/issues

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+const cmd = process.argv[2];
+if (cmd === "install" || cmd === "uninstall" || cmd === "list") {
+    await import("./install.js");
+}
+else if (cmd === "license") {
+    const { verifyLicense } = await import("@mcp_marketplace/license");
+    const r = await verifyLicense({ slug: "stithy-pod" });
+    if (r.valid) {
+        console.log(`Licensed (server_id: ${r.server_id ?? "n/a"})`);
+        if (r.expires_at)
+            console.log(`Expires: ${r.expires_at}`);
+    }
+    else {
+        console.log(`Not licensed: ${r.reason ?? "unknown"}`);
+        console.log(`Set MCP_LICENSE_KEY in your environment.`);
+        console.log(`Get a key: https://mcp-marketplace.io/stithy-pod`);
+    }
+}
+else if (cmd === "--help" || cmd === "-h" || cmd === "help") {
+    console.log(`stithy-pod — print-on-demand multi-platform MCP server
+
+Usage:
+  npx @stithy/pod                        Run the MCP server (stdio transport)
+  npx @stithy/pod install                Install into all detected AI clients
+  npx @stithy/pod install --force        Overwrite existing config
+  npx @stithy/pod list                   Show install status for each client
+  npx @stithy/pod uninstall              Remove from all detected clients
+  npx @stithy/pod license                Check license status
+
+Environment:
+  MCP_LICENSE_KEY          Marketplace license key (required to run server)
+  STITHY_POD_DB            Path to SQLite db (default: ~/.stithy/pod.db)
+  STITHY_POD_DIR           Root for db + master key (default: ~/.stithy)
+  STITHY_POD_MASTER_KEY    Override master key (recommended in production)
+  STITHY_SKIP_LICENSE      Set to 1 to bypass license check (dev/test only)
+
+Docs: https://github.com/resolceo-ai/stithy-mcp
+`);
+}
+else {
+    await import("./server.js");
+}
+export {};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAE5B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;IAC/D,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;AAC/B,CAAC;KAAM,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;IAC7B,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IACnE,MAAM,CAAC,GAAG,MAAM,aAAa,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IACtD,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,SAAS,IAAI,KAAK,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,CAAC,UAAU;YAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;KAAM,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;CAkBb,CAAC,CAAC;AACH,CAAC;KAAM,CAAC;IACN,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;AAC9B,CAAC"}

package/dist/crypto.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Resolve the master key for credential encryption.
+ *
+ * Priority:
+ *   1. STITHY_POD_MASTER_KEY env var (recommended in production)
+ *   2. Per-machine key file at ~/.stithy/.pod_master (auto-generated, chmod 600)
+ *
+ * The file fallback keeps the server zero-config for solo users while still
+ * keeping API tokens off raw disk in clear text.
+ */
+export declare function resolveMasterKey(keyFilePath: string): Buffer;
+export declare function encryptString(plain: string, masterKey: Buffer): string;
+export declare function decryptString(token: string, masterKey: Buffer): string;
+/** Mask a credential for display in tool outputs. */
+export declare function mask(s: string): string;

package/dist/crypto.js

@@ -0,0 +1,63 @@
+import { createCipheriv, createDecipheriv, randomBytes, scryptSync } from "node:crypto";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, chmodSync } from "node:fs";
+import { dirname } from "node:path";
+const ALGO = "aes-256-gcm";
+const KEY_LEN = 32;
+const IV_LEN = 12;
+const SALT_LEN = 16;
+/**
+ * Resolve the master key for credential encryption.
+ *
+ * Priority:
+ *   1. STITHY_POD_MASTER_KEY env var (recommended in production)
+ *   2. Per-machine key file at ~/.stithy/.pod_master (auto-generated, chmod 600)
+ *
+ * The file fallback keeps the server zero-config for solo users while still
+ * keeping API tokens off raw disk in clear text.
+ */
+export function resolveMasterKey(keyFilePath) {
+    const env = process.env.STITHY_POD_MASTER_KEY;
+    if (env && env.length >= 32) {
+        return scryptSync(env, "stithy-pod", KEY_LEN);
+    }
+    if (!existsSync(keyFilePath)) {
+        mkdirSync(dirname(keyFilePath), { recursive: true });
+        const seed = randomBytes(48).toString("hex");
+        writeFileSync(keyFilePath, seed);
+        try {
+            chmodSync(keyFilePath, 0o600);
+        }
+        catch {
+            // Windows: chmod is a no-op
+        }
+    }
+    const seed = readFileSync(keyFilePath, "utf8").trim();
+    return scryptSync(seed, "stithy-pod", KEY_LEN);
+}
+export function encryptString(plain, masterKey) {
+    const salt = randomBytes(SALT_LEN);
+    const iv = randomBytes(IV_LEN);
+    const key = scryptSync(masterKey, salt, KEY_LEN);
+    const cipher = createCipheriv(ALGO, key, iv);
+    const enc = Buffer.concat([cipher.update(plain, "utf8"), cipher.final()]);
+    const tag = cipher.getAuthTag();
+    return Buffer.concat([salt, iv, tag, enc]).toString("base64");
+}
+export function decryptString(token, masterKey) {
+    const buf = Buffer.from(token, "base64");
+    const salt = buf.subarray(0, SALT_LEN);
+    const iv = buf.subarray(SALT_LEN, SALT_LEN + IV_LEN);
+    const tag = buf.subarray(SALT_LEN + IV_LEN, SALT_LEN + IV_LEN + 16);
+    const enc = buf.subarray(SALT_LEN + IV_LEN + 16);
+    const key = scryptSync(masterKey, salt, KEY_LEN);
+    const decipher = createDecipheriv(ALGO, key, iv);
+    decipher.setAuthTag(tag);
+    return Buffer.concat([decipher.update(enc), decipher.final()]).toString("utf8");
+}
+/** Mask a credential for display in tool outputs. */
+export function mask(s) {
+    if (s.length <= 8)
+        return "***";
+    return `${s.slice(0, 4)}…${s.slice(-4)}`;
+}
+//# sourceMappingURL=crypto.js.map

package/dist/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"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"}

package/dist/db.d.ts

@@ -0,0 +1,4 @@
+import Database from "better-sqlite3";
+export declare function openDb(path: string): Database.Database;
+export declare const PROVIDER_IDS: readonly ["printify", "printful", "gelato"];
+export type ProviderId = (typeof PROVIDER_IDS)[number];

package/dist/db.js

@@ -0,0 +1,54 @@
+import Database from "better-sqlite3";
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+export function openDb(path) {
+    mkdirSync(dirname(path), { recursive: true });
+    const db = new Database(path);
+    db.pragma("journal_mode = WAL");
+    db.pragma("synchronous = NORMAL");
+    db.pragma("foreign_keys = ON");
+    migrate(db);
+    return db;
+}
+function migrate(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS providers (
+      id              TEXT PRIMARY KEY,
+      enabled         INTEGER NOT NULL DEFAULT 1,
+      api_key_enc     TEXT NOT NULL,
+      shop_id         TEXT,
+      meta            TEXT NOT NULL DEFAULT '{}',
+      created_at      INTEGER NOT NULL,
+      updated_at      INTEGER NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS product_cache (
+      provider        TEXT NOT NULL,
+      external_id     TEXT NOT NULL,
+      title           TEXT NOT NULL,
+      price_cents     INTEGER,
+      cost_cents      INTEGER,
+      stock           INTEGER,
+      status          TEXT,
+      raw             TEXT NOT NULL,
+      synced_at       INTEGER NOT NULL,
+      PRIMARY KEY (provider, external_id)
+    );
+    CREATE INDEX IF NOT EXISTS idx_product_synced ON product_cache(synced_at DESC);
+
+    CREATE TABLE IF NOT EXISTS order_cache (
+      provider        TEXT NOT NULL,
+      external_id     TEXT NOT NULL,
+      status          TEXT,
+      total_cents     INTEGER,
+      currency        TEXT,
+      placed_at       INTEGER,
+      raw             TEXT NOT NULL,
+      synced_at       INTEGER NOT NULL,
+      PRIMARY KEY (provider, external_id)
+    );
+    CREATE INDEX IF NOT EXISTS idx_order_placed ON order_cache(placed_at DESC);
+  `);
+}
+export const PROVIDER_IDS = ["printify", "printful", "gelato"];
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAClC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,OAAO,CAAC,EAAqB;IACpC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCP,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAU,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/install.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync, renameSync } from "node:fs";
+import { homedir, platform } from "node:os";
+import { dirname, join } from "node:path";
+function targets() {
+    const home = homedir();
+    const p = platform();
+    const list = [];
+    if (p === "darwin") {
+        list.push({
+            name: "Claude Desktop",
+            configPath: join(home, "Library/Application Support/Claude/claude_desktop_config.json"),
+        });
+    }
+    else if (p === "win32") {
+        const appdata = process.env.APPDATA ?? join(home, "AppData/Roaming");
+        list.push({
+            name: "Claude Desktop",
+            configPath: join(appdata, "Claude/claude_desktop_config.json"),
+        });
+    }
+    else {
+        list.push({
+            name: "Claude Desktop",
+            configPath: join(home, ".config/Claude/claude_desktop_config.json"),
+        });
+    }
+    list.push({ name: "Cursor", configPath: join(home, ".cursor/mcp.json") });
+    list.push({
+        name: "Windsurf",
+        configPath: join(home, ".codeium/windsurf/mcp_config.json"),
+    });
+    list.push({ name: "Claude Code", configPath: join(home, ".claude.json") });
+    return list;
+}
+function serverEntry() {
+    return { command: "npx", args: ["-y", "@stithy/pod"] };
+}
+function readJson(path) {
+    if (!existsSync(path))
+        return { ok: true, data: {} };
+    try {
+        const raw = readFileSync(path, "utf8");
+        if (raw.trim().length === 0)
+            return { ok: true, data: {} };
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+            return { ok: false, reason: "Existing config is not a JSON object — refusing to overwrite" };
+        }
+        return { ok: true, data: parsed };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            reason: `Existing config is not valid JSON (${e instanceof Error ? e.message : String(e)}) — refusing to overwrite`,
+        };
+    }
+}
+function writeJsonAtomic(path, data) {
+    const tmp = `${path}.stithy.tmp`;
+    const json = JSON.stringify(data, null, 2);
+    writeFileSync(tmp, json);
+    JSON.parse(readFileSync(tmp, "utf8"));
+    renameSync(tmp, path);
+}
+function backup(path) {
+    if (!existsSync(path))
+        return;
+    const bak = `${path}.stithy.bak.${Date.now()}`;
+    copyFileSync(path, bak);
+    console.log(`  backup: ${bak}`);
+}
+function installFor(t, name, force) {
+    try {
+        const result = readJson(t.configPath);
+        if (!result.ok) {
+            console.error(`✗ ${t.name}: ${result.reason}`);
+            return "error";
+        }
+        const cfg = result.data;
+        const servers = cfg["mcpServers"] ?? {};
+        if (servers[name] && !force) {
+            console.log(`✓ ${t.name}: already configured (use --force to overwrite)`);
+            return "skipped";
+        }
+        servers[name] = serverEntry();
+        cfg["mcpServers"] = servers;
+        if (existsSync(t.configPath))
+            backup(t.configPath);
+        mkdirSync(dirname(t.configPath), { recursive: true });
+        writeJsonAtomic(t.configPath, cfg);
+        console.log(`✓ ${t.name}: installed at ${t.configPath}`);
+        return "installed";
+    }
+    catch (e) {
+        console.error(`✗ ${t.name}: ${e instanceof Error ? e.message : String(e)}`);
+        return "error";
+    }
+}
+function uninstallFor(t, name) {
+    try {
+        if (!existsSync(t.configPath))
+            return false;
+        const result = readJson(t.configPath);
+        if (!result.ok) {
+            console.error(`✗ ${t.name}: ${result.reason}`);
+            return false;
+        }
+        const cfg = result.data;
+        const servers = cfg["mcpServers"] ?? {};
+        if (!servers[name])
+            return false;
+        delete servers[name];
+        cfg["mcpServers"] = servers;
+        backup(t.configPath);
+        writeJsonAtomic(t.configPath, cfg);
+        console.log(`✓ ${t.name}: removed`);
+        return true;
+    }
+    catch (e) {
+        console.error(`✗ ${t.name}: ${e instanceof Error ? e.message : String(e)}`);
+        return false;
+    }
+}
+function main() {
+    const args = process.argv.slice(2);
+    const cmd = args[0] ?? "install";
+    const force = args.includes("--force");
+    const name = "stithy-pod";
+    if (cmd === "uninstall") {
+        console.log("Removing stithy-pod from detected clients...");
+        for (const t of targets())
+            uninstallFor(t, name);
+        console.log("\nDone. Restart your AI client to pick up the change.");
+        return;
+    }
+    if (cmd === "list") {
+        for (const t of targets()) {
+            const present = existsSync(t.configPath);
+            let has = false;
+            let bad = false;
+            if (present) {
+                const r = readJson(t.configPath);
+                if (!r.ok) {
+                    bad = true;
+                }
+                else {
+                    const servers = r.data["mcpServers"] ?? {};
+                    has = Boolean(servers[name]);
+                }
+            }
+            const marker = bad ? "?" : has ? "✓" : present ? "·" : "—";
+            console.log(`${marker} ${t.name.padEnd(16)} ${t.configPath}${bad ? "  (config unparseable)" : ""}`);
+        }
+        return;
+    }
+    console.log("Installing stithy-pod across detected AI clients...\n");
+    let installed = 0;
+    for (const t of targets()) {
+        const result = installFor(t, name, force);
+        if (result === "installed")
+            installed++;
+    }
+    console.log(`\nInstalled to ${installed} client${installed === 1 ? "" : "s"}.`);
+    console.log("Restart your AI client(s) to load stithy-pod.");
+}
+main();
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"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"}

package/dist/providers/gelato.d.ts

@@ -0,0 +1,28 @@
+import type { Provider, ProviderCapabilities, ProductSummary, OrderSummary } from "./types.js";
+/**
+ * Gelato adapter — minimal v0.1 surface. Gelato's API is split across multiple
+ * subdomains (product, order, ecommerce) and uses store-id paths. We expose
+ * read-only product/order listing + ping. Mutations are unsupported in v0.1.
+ */
+export declare class GelatoProvider implements Provider {
+    private readonly apiKey;
+    private readonly storeId;
+    readonly id = "gelato";
+    readonly displayName = "Gelato";
+    readonly capabilities: ProviderCapabilities;
+    constructor(apiKey: string, storeId: string);
+    private req;
+    ping(): Promise<{
+        ok: boolean;
+        reason?: string;
+    }>;
+    listProducts(opts?: {
+        limit?: number;
+    }): Promise<ProductSummary[]>;
+    updatePricing(): Promise<void>;
+    pauseListing(): Promise<void>;
+    unpauseListing(): Promise<void>;
+    listOrders(opts?: {
+        limit?: number;
+    }): Promise<OrderSummary[]>;
+}

package/dist/providers/gelato.js

@@ -0,0 +1,86 @@
+import { ProviderUnsupportedError } from "./types.js";
+const GELATO_PRODUCT_BASE = "https://product.gelatoapis.com/v3";
+const GELATO_ORDER_BASE = "https://order.gelatoapis.com/v4";
+/**
+ * Gelato adapter — minimal v0.1 surface. Gelato's API is split across multiple
+ * subdomains (product, order, ecommerce) and uses store-id paths. We expose
+ * read-only product/order listing + ping. Mutations are unsupported in v0.1.
+ */
+export class GelatoProvider {
+    apiKey;
+    storeId;
+    id = "gelato";
+    displayName = "Gelato";
+    capabilities = {
+        list_products: true,
+        update_pricing: false,
+        list_orders: true,
+        pause_listing: false,
+        stock_query: false,
+        create_product: false,
+    };
+    constructor(apiKey, storeId) {
+        this.apiKey = apiKey;
+        this.storeId = storeId;
+    }
+    async req(url, init = {}) {
+        const res = await fetch(url, {
+            ...init,
+            headers: {
+                "X-API-KEY": this.apiKey,
+                "Content-Type": "application/json",
+                ...(init.headers ?? {}),
+            },
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            throw new Error(`Gelato ${res.status} on ${url}: ${body.slice(0, 300)}`);
+        }
+        return (await res.json());
+    }
+    async ping() {
+        try {
+            await this.req(`${GELATO_PRODUCT_BASE}/stores/${this.storeId}/products?limit=1`);
+            return { ok: true };
+        }
+        catch (e) {
+            return { ok: false, reason: e instanceof Error ? e.message : String(e) };
+        }
+    }
+    async listProducts(opts) {
+        const limit = Math.min(opts?.limit ?? 50, 100);
+        const data = await this.req(`${GELATO_PRODUCT_BASE}/stores/${this.storeId}/products?limit=${limit}`);
+        return (data.products ?? []).map((p) => ({
+            external_id: p.id,
+            title: p.title ?? "(untitled)",
+            price_cents: null,
+            cost_cents: null,
+            stock: null,
+            status: p.status ?? "unknown",
+        }));
+    }
+    updatePricing() {
+        throw new ProviderUnsupportedError(this.id, "update_pricing");
+    }
+    pauseListing() {
+        throw new ProviderUnsupportedError(this.id, "pause_listing");
+    }
+    unpauseListing() {
+        throw new ProviderUnsupportedError(this.id, "pause_listing");
+    }
+    async listOrders(opts) {
+        const limit = Math.min(opts?.limit ?? 50, 100);
+        const data = await this.req(`${GELATO_ORDER_BASE}/orders:search`, {
+            method: "POST",
+            body: JSON.stringify({ storeIds: [this.storeId], limit }),
+        });
+        return (data.orders ?? []).map((o) => ({
+            external_id: o.id,
+            status: o.fulfillmentStatus ?? null,
+            total_cents: o.itemsRetailPriceSum !== undefined ? Math.round(o.itemsRetailPriceSum * 100) : null,
+            currency: o.currency ?? "USD",
+            placed_at: o.createdAt ? Date.parse(o.createdAt) || null : null,
+        }));
+    }
+}
+//# sourceMappingURL=gelato.js.map

package/dist/providers/gelato.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gelato.js","sourceRoot":"","sources":["../../src/providers/gelato.ts"],"names":[],"mappings":"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"}

package/dist/providers/printful.d.ts

@@ -0,0 +1,28 @@
+import type { Provider, ProviderCapabilities, ProductSummary, OrderSummary } from "./types.js";
+/**
+ * Printful adapter — read paths only in v0.1 (list_products, list_orders, ping).
+ * Pricing updates and pause/unpause require Printful's per-variant sync flow that
+ * needs more careful handling. Returns ProviderUnsupportedError for those ops so
+ * the caller can fall back gracefully.
+ */
+export declare class PrintfulProvider implements Provider {
+    private readonly apiKey;
+    readonly id = "printful";
+    readonly displayName = "Printful";
+    readonly capabilities: ProviderCapabilities;
+    constructor(apiKey: string);
+    private req;
+    ping(): Promise<{
+        ok: boolean;
+        reason?: string;
+    }>;
+    listProducts(opts?: {
+        limit?: number;
+    }): Promise<ProductSummary[]>;
+    updatePricing(): Promise<void>;
+    pauseListing(): Promise<void>;
+    unpauseListing(): Promise<void>;
+    listOrders(opts?: {
+        limit?: number;
+    }): Promise<OrderSummary[]>;
+}