@stithy/pod 0.1.0

package/dist/providers/printful.js

@@ -0,0 +1,84 @@
+import { ProviderUnsupportedError } from "./types.js";
+const PRINTFUL_BASE = "https://api.printful.com";
+/**
+ * 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 class PrintfulProvider {
+    apiKey;
+    id = "printful";
+    displayName = "Printful";
+    capabilities = {
+        list_products: true,
+        update_pricing: false,
+        list_orders: true,
+        pause_listing: false,
+        stock_query: false,
+        create_product: false,
+    };
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    async req(path, init = {}) {
+        const res = await fetch(`${PRINTFUL_BASE}${path}`, {
+            ...init,
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+                ...(init.headers ?? {}),
+            },
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            throw new Error(`Printful ${res.status} on ${path}: ${body.slice(0, 300)}`);
+        }
+        return (await res.json());
+    }
+    async ping() {
+        try {
+            await this.req(`/stores`);
+            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(`/store/products?limit=${limit}`);
+        return data.result.map((p) => ({
+            external_id: String(p.id),
+            title: p.name,
+            price_cents: null,
+            cost_cents: null,
+            stock: null,
+            status: p.is_ignored ? "ignored" : "active",
+        }));
+    }
+    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(`/orders?limit=${limit}`);
+        return data.result.map((o) => {
+            const totalNum = o.retail_costs?.total ? Math.round(parseFloat(o.retail_costs.total) * 100) : null;
+            return {
+                external_id: String(o.id),
+                status: o.status,
+                total_cents: Number.isFinite(totalNum) ? totalNum : null,
+                currency: o.retail_costs?.currency ?? "USD",
+                placed_at: o.created ? o.created * 1000 : null,
+            };
+        });
+    }
+}
+//# sourceMappingURL=printful.js.map

package/dist/providers/printful.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"printful.js","sourceRoot":"","sources":["../../src/providers/printful.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,aAAa,GAAG,0BAA0B,CAAC;AAmBjD;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IAYE;IAXpB,EAAE,GAAG,UAAU,CAAC;IAChB,WAAW,GAAG,UAAU,CAAC;IACzB,YAAY,GAAyB;QAC5C,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,KAAK;QACrB,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,cAAc,EAAE,KAAK;KACtB,CAAC;IAEF,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAEvC,KAAK,CAAC,GAAG,CAAI,IAAY,EAAE,OAAoB,EAAE;QACvD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,aAAa,GAAG,IAAI,EAAE,EAAE;YACjD,GAAG,IAAI;YACP,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;gBACtC,cAAc,EAAE,kBAAkB;gBAClC,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;aACxB;SACF,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,YAAY,GAAG,CAAC,MAAM,OAAO,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC1B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAyB;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CACzB,yBAAyB,KAAK,EAAE,CACjC,CAAC;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,KAAK,EAAE,CAAC,CAAC,IAAI;YACb,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,IAAI;YAChB,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;SAC5C,CAAC,CAAC,CAAC;IACN,CAAC;IAED,aAAa;QACX,MAAM,IAAI,wBAAwB,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAChE,CAAC;IAED,YAAY;QACV,MAAM,IAAI,wBAAwB,CAAC,IAAI,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;IAC/D,CAAC;IAED,cAAc;QACZ,MAAM,IAAI,wBAAwB,CAAC,IAAI,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAyB;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAA8B,iBAAiB,KAAK,EAAE,CAAC,CAAC;QACnF,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,CAAC,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACnG,OAAO;gBACL,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAkB,CAAC,CAAC,CAAC,CAAE,QAAmB,CAAC,CAAC,CAAC,IAAI;gBAC9E,QAAQ,EAAE,CAAC,CAAC,YAAY,EAAE,QAAQ,IAAI,KAAK;gBAC3C,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI;aAC/C,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/providers/printify.d.ts

@@ -0,0 +1,23 @@
+import type { Provider, ProviderCapabilities, ProductSummary, OrderSummary } from "./types.js";
+export declare class PrintifyProvider implements Provider {
+    private readonly apiKey;
+    private readonly shopId;
+    readonly id = "printify";
+    readonly displayName = "Printify";
+    readonly capabilities: ProviderCapabilities;
+    constructor(apiKey: string, shopId: string);
+    private req;
+    ping(): Promise<{
+        ok: boolean;
+        reason?: string;
+    }>;
+    listProducts(opts?: {
+        limit?: number;
+    }): Promise<ProductSummary[]>;
+    updatePricing(externalId: string, priceCents: number): Promise<void>;
+    pauseListing(externalId: string): Promise<void>;
+    unpauseListing(externalId: string): Promise<void>;
+    listOrders(opts?: {
+        limit?: number;
+    }): Promise<OrderSummary[]>;
+}

package/dist/providers/printify.js

@@ -0,0 +1,100 @@
+const PRINTIFY_BASE = "https://api.printify.com/v1";
+export class PrintifyProvider {
+    apiKey;
+    shopId;
+    id = "printify";
+    displayName = "Printify";
+    capabilities = {
+        list_products: true,
+        update_pricing: true,
+        list_orders: true,
+        pause_listing: true,
+        stock_query: true,
+        create_product: false, // deferred — needs upload + variants flow
+    };
+    constructor(apiKey, shopId) {
+        this.apiKey = apiKey;
+        this.shopId = shopId;
+    }
+    async req(path, init = {}) {
+        const res = await fetch(`${PRINTIFY_BASE}${path}`, {
+            ...init,
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+                ...(init.headers ?? {}),
+            },
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            throw new Error(`Printify ${res.status} on ${path}: ${body.slice(0, 300)}`);
+        }
+        return (await res.json());
+    }
+    async ping() {
+        try {
+            await this.req(`/shops.json`);
+            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(`/shops/${this.shopId}/products.json?limit=${limit}`);
+        return data.data.map((p) => {
+            const enabled = p.variants.filter((v) => v.is_enabled);
+            const minPrice = enabled.length
+                ? Math.min(...enabled.map((v) => v.price))
+                : null;
+            const minCost = enabled.length && enabled[0].cost !== undefined
+                ? Math.min(...enabled.map((v) => v.cost ?? 0))
+                : null;
+            const totalStock = enabled.reduce((acc, v) => (v.quantity !== undefined ? acc + v.quantity : acc), 0);
+            return {
+                external_id: p.id,
+                title: p.title,
+                price_cents: minPrice,
+                cost_cents: minCost,
+                stock: totalStock || null,
+                status: p.visible ? "active" : "hidden",
+            };
+        });
+    }
+    async updatePricing(externalId, priceCents) {
+        const product = await this.req(`/shops/${this.shopId}/products/${externalId}.json`);
+        const variants = product.variants.map((v) => ({
+            id: v.id,
+            price: priceCents,
+            is_enabled: v.is_enabled,
+        }));
+        await this.req(`/shops/${this.shopId}/products/${externalId}.json`, {
+            method: "PUT",
+            body: JSON.stringify({ variants }),
+        });
+    }
+    async pauseListing(externalId) {
+        await this.req(`/shops/${this.shopId}/products/${externalId}/unpublish.json`, {
+            method: "POST",
+        });
+    }
+    async unpauseListing(externalId) {
+        await this.req(`/shops/${this.shopId}/products/${externalId}/publish.json`, {
+            method: "POST",
+            body: JSON.stringify({ title: true, description: true, images: true, variants: true, tags: true }),
+        });
+    }
+    async listOrders(opts) {
+        const limit = Math.min(opts?.limit ?? 50, 100);
+        const data = await this.req(`/shops/${this.shopId}/orders.json?limit=${limit}`);
+        return data.data.map((o) => ({
+            external_id: o.id,
+            status: o.status,
+            total_cents: o.total_price,
+            currency: o.currency ?? "USD",
+            placed_at: Date.parse(o.created_at) || null,
+        }));
+    }
+}
+//# sourceMappingURL=printify.js.map

package/dist/providers/printify.js.map

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

package/dist/providers/registry.d.ts

@@ -0,0 +1,26 @@
+import type Database from "better-sqlite3";
+import { type ProviderId } from "../db.js";
+import { type Provider } from "./types.js";
+export interface ProviderConfig {
+    id: ProviderId;
+    enabled: boolean;
+    shop_id: string | null;
+    configured_at: number;
+}
+export declare class ProviderRegistry {
+    private readonly db;
+    private readonly masterKey;
+    constructor(db: Database.Database, masterKey: Buffer);
+    configure(input: {
+        id: ProviderId;
+        api_key: string;
+        shop_id?: string;
+    }): ProviderConfig;
+    remove(id: ProviderId): boolean;
+    setEnabled(id: ProviderId, enabled: boolean): void;
+    list(): ProviderConfig[];
+    /** Returns an instantiated Provider for the given id, decrypting credentials. */
+    load(id: ProviderId): Provider;
+    /** Load all enabled providers; ignore configuration errors for absent ones. */
+    loadAll(): Provider[];
+}

package/dist/providers/registry.js

@@ -0,0 +1,94 @@
+import { decryptString, encryptString } from "../crypto.js";
+import { PROVIDER_IDS } from "../db.js";
+import { ProviderNotConfiguredError, } from "./types.js";
+import { PrintifyProvider } from "./printify.js";
+import { PrintfulProvider } from "./printful.js";
+import { GelatoProvider } from "./gelato.js";
+export class ProviderRegistry {
+    db;
+    masterKey;
+    constructor(db, masterKey) {
+        this.db = db;
+        this.masterKey = masterKey;
+    }
+    configure(input) {
+        if (!PROVIDER_IDS.includes(input.id)) {
+            throw new Error(`unknown provider '${input.id}'. Valid: ${PROVIDER_IDS.join(", ")}`);
+        }
+        if (!input.api_key || input.api_key.length < 10) {
+            throw new Error("api_key looks invalid (too short)");
+        }
+        const enc = encryptString(input.api_key, this.masterKey);
+        const now = Date.now();
+        this.db
+            .prepare(`INSERT INTO providers (id, enabled, api_key_enc, shop_id, meta, created_at, updated_at)
+         VALUES (?, 1, ?, ?, '{}', ?, ?)
+         ON CONFLICT(id) DO UPDATE SET api_key_enc = excluded.api_key_enc, shop_id = excluded.shop_id, updated_at = excluded.updated_at, enabled = 1`)
+            .run(input.id, enc, input.shop_id ?? null, now, now);
+        return {
+            id: input.id,
+            enabled: true,
+            shop_id: input.shop_id ?? null,
+            configured_at: now,
+        };
+    }
+    remove(id) {
+        const r = this.db.prepare(`DELETE FROM providers WHERE id = ?`).run(id);
+        return r.changes > 0;
+    }
+    setEnabled(id, enabled) {
+        this.db
+            .prepare(`UPDATE providers SET enabled = ?, updated_at = ? WHERE id = ?`)
+            .run(enabled ? 1 : 0, Date.now(), id);
+    }
+    list() {
+        const rows = this.db.prepare(`SELECT * FROM providers`).all();
+        return rows.map((r) => ({
+            id: r.id,
+            enabled: !!r.enabled,
+            shop_id: r.shop_id,
+            configured_at: r.created_at,
+        }));
+    }
+    /** Returns an instantiated Provider for the given id, decrypting credentials. */
+    load(id) {
+        const row = this.db
+            .prepare(`SELECT * FROM providers WHERE id = ? AND enabled = 1`)
+            .get(id);
+        if (!row)
+            throw new ProviderNotConfiguredError(id);
+        const apiKey = decryptString(row.api_key_enc, this.masterKey);
+        switch (id) {
+            case "printify": {
+                const shopId = row.shop_id;
+                if (!shopId)
+                    throw new Error("printify requires shop_id at configure time");
+                return new PrintifyProvider(apiKey, shopId);
+            }
+            case "printful":
+                return new PrintfulProvider(apiKey);
+            case "gelato": {
+                const storeId = row.shop_id;
+                if (!storeId)
+                    throw new Error("gelato requires shop_id (store id) at configure time");
+                return new GelatoProvider(apiKey, storeId);
+            }
+        }
+    }
+    /** Load all enabled providers; ignore configuration errors for absent ones. */
+    loadAll() {
+        const out = [];
+        for (const cfg of this.list()) {
+            if (!cfg.enabled)
+                continue;
+            try {
+                out.push(this.load(cfg.id));
+            }
+            catch {
+                // skip
+            }
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/providers/registry.js.map

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

package/dist/providers/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Provider adapter interface.
+ *
+ * Each POD platform (Printify, Printful, Gelato) implements this interface.
+ * The server depends only on this contract — providers are swappable, and one
+ * being yanked (Printify ToS, API terminations) doesn't break the others.
+ *
+ * Tools that fan out across providers iterate the registry and call these
+ * methods; per-provider failures are reported but don't abort the whole call.
+ */
+export interface ProductSummary {
+    external_id: string;
+    title: string;
+    price_cents: number | null;
+    cost_cents: number | null;
+    stock: number | null;
+    status: string | null;
+}
+export interface OrderSummary {
+    external_id: string;
+    status: string | null;
+    total_cents: number | null;
+    currency: string | null;
+    placed_at: number | null;
+}
+export interface ProviderCapabilities {
+    list_products: boolean;
+    update_pricing: boolean;
+    list_orders: boolean;
+    pause_listing: boolean;
+    stock_query: boolean;
+    create_product: boolean;
+}
+export interface Provider {
+    readonly id: string;
+    readonly displayName: string;
+    readonly capabilities: ProviderCapabilities;
+    /** Validates the provider is reachable and credentials are accepted. */
+    ping(): Promise<{
+        ok: boolean;
+        reason?: string;
+    }>;
+    listProducts(opts?: {
+        limit?: number;
+    }): Promise<ProductSummary[]>;
+    updatePricing(externalId: string, priceCents: number): Promise<void>;
+    pauseListing(externalId: string): Promise<void>;
+    unpauseListing(externalId: string): Promise<void>;
+    listOrders(opts?: {
+        limit?: number;
+    }): Promise<OrderSummary[]>;
+}
+export declare class ProviderNotConfiguredError extends Error {
+    constructor(providerId: string);
+}
+export declare class ProviderUnsupportedError extends Error {
+    constructor(providerId: string, op: string);
+}

package/dist/providers/types.js

@@ -0,0 +1,21 @@
+/**
+ * Provider adapter interface.
+ *
+ * Each POD platform (Printify, Printful, Gelato) implements this interface.
+ * The server depends only on this contract — providers are swappable, and one
+ * being yanked (Printify ToS, API terminations) doesn't break the others.
+ *
+ * Tools that fan out across providers iterate the registry and call these
+ * methods; per-provider failures are reported but don't abort the whole call.
+ */
+export class ProviderNotConfiguredError extends Error {
+    constructor(providerId) {
+        super(`Provider '${providerId}' is not configured. Run configure_provider first.`);
+    }
+}
+export class ProviderUnsupportedError extends Error {
+    constructor(providerId, op) {
+        super(`Provider '${providerId}' does not support '${op}' in this version.`);
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAyCH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD,YAAY,UAAkB;QAC5B,KAAK,CAAC,aAAa,UAAU,oDAAoD,CAAC,CAAC;IACrF,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,UAAkB,EAAE,EAAU;QACxC,KAAK,CAAC,aAAa,UAAU,uBAAuB,EAAE,oBAAoB,CAAC,CAAC;IAC9E,CAAC;CACF"}

package/dist/server.d.ts

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