truss-shopify-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TRUSS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,89 @@
+# TRUSS Shopify Operations Hub
+
+MCP server for managing Shopify stores from Claude Code. List products, track orders, update inventory, fulfill shipments, generate AI descriptions, and analyze sales — all from your AI coding assistant.
+
+## Quick Start
+
+### 1. Create a Shopify Custom App
+
+1. Go to **Shopify Admin > Settings > Apps and sales channels > Develop apps**
+2. Click **Create an app**
+3. Under **Configuration > Admin API integration**, enable these scopes:
+   - `read_products`, `write_products`
+   - `read_orders`, `write_orders`
+   - `read_inventory`, `write_inventory`
+   - `read_locations`
+   - `read_fulfillments`, `write_fulfillments`
+4. Click **Install app** and copy the **Admin API access token**
+
+### 2. Configure Claude Code
+
+Add to your Claude Code MCP settings (`~/.claude/settings.json` or project-level):
+
+```json
+{
+  "mcpServers": {
+    "shopify": {
+      "command": "node",
+      "args": ["/path/to/shopify-mcp/dist/index.js"],
+      "env": {
+        "SHOPIFY_STORE": "your-store-subdomain",
+        "SHOPIFY_ACCESS_TOKEN": "shpat_..."
+      }
+    }
+  }
+}
+```
+
+### 3. Build
+
+```bash
+npm install
+npm run build
+```
+
+## Tools
+
+### Free Tier (10 operations/day)
+
+| Tool | Description |
+|------|-------------|
+| `shopify_status` | Check connection status and license tier |
+| `list_products` | List products with status/collection/vendor filters |
+| `get_product` | Full product details with variants, images, metafields |
+| `list_orders` | Recent orders with status and date filters |
+| `get_order` | Full order details with line items, customer, fulfillment |
+| `store_analytics` | Revenue, order count, top products, AOV |
+
+### Pro Tier ($25/mo)
+
+| Tool | Description |
+|------|-------------|
+| `create_product` | Create products with variants and images |
+| `update_inventory` | Bulk update inventory levels |
+| `fulfill_order` | Create fulfillments with tracking |
+| `generate_description` | AI-powered product descriptions |
+| `sales_report` | Detailed analytics with period comparisons |
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `SHOPIFY_STORE` | Yes | Store subdomain (e.g., `my-store` from `my-store.myshopify.com`) |
+| `SHOPIFY_ACCESS_TOKEN` | Yes | Admin API access token from your custom app |
+| `TRUSS_LICENSE_KEY` | No | Pro license key for write operations |
+| `ANTHROPIC_API_KEY` | No | For AI description generation (preferred) |
+| `OPENAI_API_KEY` | No | For AI description generation (fallback) |
+
+## Rate Limiting
+
+The Shopify Admin API uses a leaky bucket algorithm (40 requests/minute). This server handles rate limiting automatically:
+
+- Tracks bucket state from `X-Shopify-Shop-Api-Call-Limit` headers
+- Pre-flight checks to avoid hitting limits
+- Automatic retry on 429 responses with `Retry-After` header respect
+- Maximum 3 retries before failing
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+// Tool registrations — Free Tier
+import { registerListProducts } from './tools/list-products.js';
+import { registerGetProduct } from './tools/get-product.js';
+import { registerListOrders } from './tools/list-orders.js';
+import { registerGetOrder } from './tools/get-order.js';
+import { registerStoreAnalytics } from './tools/store-analytics.js';
+// Tool registrations — Pro Tier
+import { registerCreateProduct } from './tools/create-product.js';
+import { registerUpdateInventory } from './tools/update-inventory.js';
+import { registerFulfillOrder } from './tools/fulfill-order.js';
+import { registerGenerateDescription } from './tools/generate-description.js';
+import { registerSalesReport } from './tools/sales-report.js';
+// Lib
+import { getLicenseStatus } from './lib/license.js';
+import { validateShopifyConfig } from './lib/shopify-client.js';
+import { closeDb } from './lib/usage.js';
+const server = new McpServer({
+    name: '@truss-dev/shopify-mcp',
+    version: '1.0.0',
+});
+// ── Status Tool ─────────────────────────────────────────────────────
+server.tool('shopify_status', 'Check Shopify connection status, store config, and license tier.', {}, async () => {
+    const configCheck = validateShopifyConfig();
+    const license = await getLicenseStatus();
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    shopify: {
+                        configured: configCheck.valid,
+                        ...(configCheck.valid
+                            ? { store: process.env.SHOPIFY_STORE }
+                            : { error: configCheck.error }),
+                        setup_instructions: !configCheck.valid
+                            ? {
+                                step_1: 'Go to your Shopify admin > Settings > Apps and sales channels > Develop apps',
+                                step_2: 'Create a custom app with Admin API access',
+                                step_3: 'Grant scopes: read_products, write_products, read_orders, write_orders, read_inventory, write_inventory, read_locations, read_fulfillments, write_fulfillments',
+                                step_4: 'Install the app and copy the Admin API access token',
+                                step_5: 'Set env vars: SHOPIFY_STORE=your-store-subdomain SHOPIFY_ACCESS_TOKEN=shpat_...',
+                            }
+                            : undefined,
+                    },
+                    license: {
+                        tier: license.tier,
+                        valid: license.valid,
+                        expires_at: license.expiresAt,
+                    },
+                    ...(license.tier === 'free'
+                        ? {
+                            upgrade_info: {
+                                url: 'https://buy.stripe.com/truss-shopify-pro',
+                                price: '$25/mo',
+                                free_tier: '10 read-only operations/day',
+                                pro_features: [
+                                    'Unlimited operations',
+                                    'Create products',
+                                    'Update inventory',
+                                    'Fulfill orders',
+                                    'AI product descriptions',
+                                    'Detailed sales reports with comparisons',
+                                ],
+                            },
+                        }
+                        : {}),
+                }, null, 2),
+            },
+        ],
+    };
+});
+// ── Register Free Tier Tools ────────────────────────────────────────
+registerListProducts(server);
+registerGetProduct(server);
+registerListOrders(server);
+registerGetOrder(server);
+registerStoreAnalytics(server);
+// ── Register Pro Tier Tools ─────────────────────────────────────────
+registerCreateProduct(server);
+registerUpdateInventory(server);
+registerFulfillOrder(server);
+registerGenerateDescription(server);
+registerSalesReport(server);
+// ── Start Server ────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    // Clean shutdown
+    process.on('SIGINT', () => {
+        closeDb();
+        process.exit(0);
+    });
+    process.on('SIGTERM', () => {
+        closeDb();
+        process.exit(0);
+    });
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error('Fatal error starting MCP server:', err);
+    closeDb();
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/ai-content.d.ts

@@ -0,0 +1,7 @@
+/**
+ * AI-powered product description generation.
+ * Uses customer's Anthropic or OpenAI API key.
+ */
+import type { DescriptionInput, GeneratedDescription } from '../types.js';
+export declare function generateProductDescription(input: DescriptionInput): Promise<GeneratedDescription>;
+//# sourceMappingURL=ai-content.d.ts.map

package/dist/lib/ai-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-content.d.ts","sourceRoot":"","sources":["../../src/lib/ai-content.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAkH1E,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,oBAAoB,CAAC,CAoB/B"}

package/dist/lib/ai-content.js

@@ -0,0 +1,111 @@
+/**
+ * AI-powered product description generation.
+ * Uses customer's Anthropic or OpenAI API key.
+ */
+import { getConfig } from './config.js';
+const DEFAULT_TONE = 'professional';
+function buildPrompt(input) {
+    const tone = input.tone || DEFAULT_TONE;
+    const features = input.features.map((f) => `- ${f}`).join('\n');
+    const keywords = input.keywords?.length ? `\nTarget keywords: ${input.keywords.join(', ')}` : '';
+    return `Write a compelling product description for an e-commerce product.
+
+Product title: ${input.product_title}
+
+Key features:
+${features}
+${keywords}
+
+Tone: ${tone}
+
+Return a JSON object with these fields:
+- "title": An optimized product title (may differ slightly from input)
+- "description": HTML-formatted product description (2-4 paragraphs, use <p>, <ul>, <li> tags)
+- "meta_description": SEO meta description (under 160 characters)
+
+Return ONLY the JSON object, no other text.`;
+}
+async function generateWithAnthropic(prompt, apiKey) {
+    const response = await fetch('https://api.anthropic.com/v1/messages', {
+        method: 'POST',
+        headers: {
+            'x-api-key': apiKey,
+            'anthropic-version': '2023-06-01',
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            model: 'claude-sonnet-4-20250514',
+            max_tokens: 1024,
+            messages: [{ role: 'user', content: prompt }],
+        }),
+        signal: AbortSignal.timeout(30000),
+    });
+    if (!response.ok) {
+        const err = await response.text().catch(() => 'Unknown error');
+        throw new Error(`Anthropic API error ${response.status}: ${err}`);
+    }
+    const body = (await response.json());
+    const text = body.content.find((c) => c.type === 'text')?.text;
+    if (!text)
+        throw new Error('Empty response from Anthropic API');
+    return parseGeneratedDescription(text);
+}
+async function generateWithOpenAI(prompt, apiKey) {
+    const response = await fetch('https://api.openai.com/v1/chat/completions', {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            model: 'gpt-4o-mini',
+            messages: [{ role: 'user', content: prompt }],
+            max_tokens: 1024,
+            temperature: 0.7,
+        }),
+        signal: AbortSignal.timeout(30000),
+    });
+    if (!response.ok) {
+        const err = await response.text().catch(() => 'Unknown error');
+        throw new Error(`OpenAI API error ${response.status}: ${err}`);
+    }
+    const body = (await response.json());
+    const text = body.choices[0]?.message?.content;
+    if (!text)
+        throw new Error('Empty response from OpenAI API');
+    return parseGeneratedDescription(text);
+}
+function parseGeneratedDescription(text) {
+    // Try to extract JSON from the response
+    const jsonMatch = text.match(/\{[\s\S]*\}/);
+    if (!jsonMatch) {
+        throw new Error('AI response did not contain valid JSON');
+    }
+    const parsed = JSON.parse(jsonMatch[0]);
+    if (!parsed.description) {
+        throw new Error('AI response missing required "description" field');
+    }
+    return {
+        title: parsed.title || '',
+        description: parsed.description,
+        meta_description: parsed.meta_description || '',
+        tone: DEFAULT_TONE,
+    };
+}
+export async function generateProductDescription(input) {
+    const config = getConfig();
+    const prompt = buildPrompt(input);
+    // Prefer Anthropic, fall back to OpenAI
+    if (config.anthropicApiKey) {
+        const result = await generateWithAnthropic(prompt, config.anthropicApiKey);
+        result.tone = input.tone || DEFAULT_TONE;
+        return result;
+    }
+    if (config.openaiApiKey) {
+        const result = await generateWithOpenAI(prompt, config.openaiApiKey);
+        result.tone = input.tone || DEFAULT_TONE;
+        return result;
+    }
+    throw new Error('No AI API key configured. Set ANTHROPIC_API_KEY or OPENAI_API_KEY to use AI-powered description generation.');
+}
+//# sourceMappingURL=ai-content.js.map

package/dist/lib/ai-content.js.map

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

package/dist/lib/analytics.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Analytics aggregation for Shopify store data.
+ * Computes metrics from orders and products fetched via the API.
+ */
+import type { ShopifyOrder, StoreMetrics, SalesReportData, AnalyticsPeriod, GroupBy, CompareTo } from '../types.js';
+export declare function computeStoreMetrics(orders: ShopifyOrder[], period: AnalyticsPeriod): StoreMetrics;
+export declare function computeSalesReport(orders: ShopifyOrder[], period: AnalyticsPeriod, groupBy?: GroupBy, compareTo?: CompareTo): SalesReportData;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/lib/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/lib/analytics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,eAAe,EACf,OAAO,EACP,SAAS,EACV,MAAM,aAAa,CAAC;AAyDrB,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,EAAE,eAAe,GACtB,YAAY,CA2Cd;AAaD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,OAAe,EACxB,SAAS,CAAC,EAAE,SAAS,GACpB,eAAe,CAiGjB"}

package/dist/lib/analytics.js

@@ -0,0 +1,190 @@
+/**
+ * Analytics aggregation for Shopify store data.
+ * Computes metrics from orders and products fetched via the API.
+ */
+function getPeriodDates(period) {
+    const now = new Date();
+    const end = new Date(now);
+    switch (period) {
+        case 'today': {
+            const start = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+            return { start, end, label: 'Today' };
+        }
+        case 'week': {
+            const start = new Date(now);
+            start.setDate(now.getDate() - 7);
+            return { start, end, label: 'Last 7 days' };
+        }
+        case 'month': {
+            const start = new Date(now);
+            start.setDate(now.getDate() - 30);
+            return { start, end, label: 'Last 30 days' };
+        }
+        case 'quarter': {
+            const start = new Date(now);
+            start.setDate(now.getDate() - 90);
+            return { start, end, label: 'Last 90 days' };
+        }
+    }
+}
+function getComparisonDates(period, compareTo) {
+    const current = getPeriodDates(period);
+    const durationMs = current.end.getTime() - current.start.getTime();
+    if (compareTo === 'previous_period') {
+        const end = new Date(current.start);
+        const start = new Date(end.getTime() - durationMs);
+        return { start, end, label: 'Previous period' };
+    }
+    // last_year
+    const start = new Date(current.start);
+    start.setFullYear(start.getFullYear() - 1);
+    const end = new Date(current.end);
+    end.setFullYear(end.getFullYear() - 1);
+    return { start, end, label: 'Same period last year' };
+}
+function filterOrdersByDateRange(orders, start, end) {
+    return orders.filter((o) => {
+        const d = new Date(o.created_at);
+        return d >= start && d <= end;
+    });
+}
+export function computeStoreMetrics(orders, period) {
+    const dates = getPeriodDates(period);
+    const filtered = filterOrdersByDateRange(orders, dates.start, dates.end);
+    const totalRevenue = filtered.reduce((sum, o) => sum + parseFloat(o.total_price), 0);
+    const averageOrderValue = filtered.length > 0 ? totalRevenue / filtered.length : 0;
+    // Top products by quantity sold
+    const productMap = new Map();
+    for (const order of filtered) {
+        for (const item of order.line_items) {
+            const key = item.title;
+            const existing = productMap.get(key) || { quantity: 0, revenue: 0 };
+            existing.quantity += item.quantity;
+            existing.revenue += parseFloat(item.price) * item.quantity;
+            productMap.set(key, existing);
+        }
+    }
+    const topProducts = Array.from(productMap.entries())
+        .map(([title, data]) => ({
+        title,
+        quantity_sold: data.quantity,
+        revenue: Math.round(data.revenue * 100) / 100,
+    }))
+        .sort((a, b) => b.revenue - a.revenue)
+        .slice(0, 10);
+    // Orders by status
+    const ordersByStatus = {};
+    for (const order of filtered) {
+        const status = order.financial_status || 'unknown';
+        ordersByStatus[status] = (ordersByStatus[status] || 0) + 1;
+    }
+    return {
+        period: dates.label,
+        total_orders: filtered.length,
+        total_revenue: Math.round(totalRevenue * 100) / 100,
+        average_order_value: Math.round(averageOrderValue * 100) / 100,
+        top_products: topProducts,
+        orders_by_status: ordersByStatus,
+    };
+}
+function getGroupKey(date, groupBy, productTitle) {
+    if (groupBy === 'product')
+        return productTitle || 'Unknown';
+    if (groupBy === 'day')
+        return date.toISOString().split('T')[0];
+    // week: use ISO week start (Monday)
+    const d = new Date(date);
+    const day = d.getDay();
+    const diff = d.getDate() - day + (day === 0 ? -6 : 1);
+    d.setDate(diff);
+    return `week_of_${d.toISOString().split('T')[0]}`;
+}
+export function computeSalesReport(orders, period, groupBy = 'day', compareTo) {
+    const dates = getPeriodDates(period);
+    const filtered = filterOrdersByDateRange(orders, dates.start, dates.end);
+    const totalRevenue = filtered.reduce((sum, o) => sum + parseFloat(o.total_price), 0);
+    const avgOrderValue = filtered.length > 0 ? totalRevenue / filtered.length : 0;
+    // Grouped data
+    const groupMap = new Map();
+    for (const order of filtered) {
+        const orderDate = new Date(order.created_at);
+        if (groupBy === 'product') {
+            // Group by product
+            for (const item of order.line_items) {
+                const key = getGroupKey(orderDate, groupBy, item.title);
+                const existing = groupMap.get(key) || { revenue: 0, orders: 0 };
+                existing.revenue += parseFloat(item.price) * item.quantity;
+                existing.orders += 1;
+                groupMap.set(key, existing);
+            }
+        }
+        else {
+            // Group by time period
+            const key = getGroupKey(orderDate, groupBy);
+            const existing = groupMap.get(key) || { revenue: 0, orders: 0 };
+            existing.revenue += parseFloat(order.total_price);
+            existing.orders += 1;
+            groupMap.set(key, existing);
+        }
+    }
+    const groupedData = Array.from(groupMap.entries())
+        .map(([group_key, data]) => ({
+        group_key,
+        revenue: Math.round(data.revenue * 100) / 100,
+        orders: data.orders,
+        average_order_value: data.orders > 0 ? Math.round((data.revenue / data.orders) * 100) / 100 : 0,
+    }))
+        .sort((a, b) => (groupBy === 'product' ? b.revenue - a.revenue : a.group_key.localeCompare(b.group_key)));
+    // Top products
+    const productMap = new Map();
+    for (const order of filtered) {
+        for (const item of order.line_items) {
+            const existing = productMap.get(item.title) || { quantity: 0, revenue: 0 };
+            existing.quantity += item.quantity;
+            existing.revenue += parseFloat(item.price) * item.quantity;
+            productMap.set(item.title, existing);
+        }
+    }
+    const topProducts = Array.from(productMap.entries())
+        .map(([title, data]) => ({
+        title,
+        quantity_sold: data.quantity,
+        revenue: Math.round(data.revenue * 100) / 100,
+    }))
+        .sort((a, b) => b.revenue - a.revenue)
+        .slice(0, 10);
+    // Comparison data
+    let comparison;
+    if (compareTo) {
+        const compDates = getComparisonDates(period, compareTo);
+        const compOrders = filterOrdersByDateRange(orders, compDates.start, compDates.end);
+        const compRevenue = compOrders.reduce((sum, o) => sum + parseFloat(o.total_price), 0);
+        comparison = {
+            period: compDates.label,
+            total_revenue: Math.round(compRevenue * 100) / 100,
+            total_orders: compOrders.length,
+            revenue_change_pct: compRevenue > 0
+                ? Math.round(((totalRevenue - compRevenue) / compRevenue) * 10000) / 100
+                : totalRevenue > 0
+                    ? 100
+                    : 0,
+            orders_change_pct: compOrders.length > 0
+                ? Math.round(((filtered.length - compOrders.length) / compOrders.length) * 10000) / 100
+                : filtered.length > 0
+                    ? 100
+                    : 0,
+        };
+    }
+    return {
+        period: dates.label,
+        compare_to: compareTo,
+        group_by: groupBy,
+        total_revenue: Math.round(totalRevenue * 100) / 100,
+        total_orders: filtered.length,
+        average_order_value: Math.round(avgOrderValue * 100) / 100,
+        grouped_data: groupedData,
+        comparison,
+        top_products: topProducts,
+    };
+}
+//# sourceMappingURL=analytics.js.map

package/dist/lib/analytics.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,5 @@
+import type { ShopifyConfig } from '../types.js';
+export declare function getConfig(): ShopifyConfig;
+export declare function getDataDir(): string;
+export declare function getDbPath(): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAWjD,wBAAgB,SAAS,IAAI,aAAa,CAUzC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

package/dist/lib/config.js

@@ -0,0 +1,29 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { mkdirSync } from 'node:fs';
+const DATA_DIR = join(homedir(), '.truss', 'shopify');
+// Ensure data directory exists on import
+try {
+    mkdirSync(DATA_DIR, { recursive: true });
+}
+catch {
+    // ignore -- directory already exists
+}
+export function getConfig() {
+    return {
+        shopifyStore: process.env.SHOPIFY_STORE || '',
+        shopifyAccessToken: process.env.SHOPIFY_ACCESS_TOKEN || '',
+        licenseKey: process.env.TRUSS_LICENSE_KEY,
+        anthropicApiKey: process.env.ANTHROPIC_API_KEY,
+        openaiApiKey: process.env.OPENAI_API_KEY,
+        trussApiBaseUrl: process.env.TRUSS_API_BASE_URL || 'https://api.truss.dev',
+        dataDir: DATA_DIR,
+    };
+}
+export function getDataDir() {
+    return DATA_DIR;
+}
+export function getDbPath() {
+    return join(DATA_DIR, 'usage.db');
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEtD,yCAAyC;AACzC,IAAI,CAAC;IACH,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC;AAAC,MAAM,CAAC;IACP,qCAAqC;AACvC,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE;QAC7C,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE;QAC1D,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;QACzC,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC9C,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;QACxC,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,uBAAuB;QAC1E,OAAO,EAAE,QAAQ;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AACpC,CAAC"}

package/dist/lib/license.d.ts

@@ -0,0 +1,4 @@
+import type { LicenseStatus } from '../types.js';
+export declare function getLicenseStatus(): Promise<LicenseStatus>;
+export declare function requirePro(): Promise<void>;
+//# sourceMappingURL=license.d.ts.map

package/dist/lib/license.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.d.ts","sourceRoot":"","sources":["../../src/lib/license.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,aAAa,CAAC;AAuE9D,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC,CAiC/D;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAQhD"}