Pressmatic NPM

Pressmatic Printify Client

Your friendly helper for building print-on-demand apps

Installation

To install the package, run:

npm install pressmatic

Usage

Configuration

First, you need to configure the client with your Printify API key and endpoint:

import { PrintifyClient, PrintifyConfig } from 'pressmatic';

const config: PrintifyConfig = {
    apiKey: 'your-api-key',
    endpoint: 'https://api.printify.com/v1'
};

const client = new PrintifyClient(config);

Product Methods

Get Products

Get a paginated list of products:

const products = await client.getProducts('shopId', { page: 1, limit: 10 });
console.log(products);

Get Product

Get details of a single product:

const product = await client.getProduct('shopId', 'productId');
console.log(product);

Order Methods

Create Order

Create a new order:

const orderData = {
    id: 'orderId',
    address_to: {
        first_name: 'John',
        last_name: 'Doe',
        email: 'john.doe@example.com',
        country: 'US',
        address1: '123 Main St',
        city: 'New York',
        zip: '10001'
    },
    line_items: [
        {
            product_id: 'productId',
            variant_id: 1,
            quantity: 2
        }
    ],
    shipping_method: 1,
    send_shipping_notification: true,
    status: 'pending',
    created_at: new Date().toISOString(),
    updated_at: new Date().toISOString()
};

const order = await client.createOrder('shopId', orderData);
console.log(order);

Get Order Details

Get details of an existing order:

const orderDetails = await client.getOrderDetails('shopId', 'orderId');
console.log(orderDetails);

Update Order

Update an existing order:

const updatedOrder = await client.updateOrder('shopId', 'orderId', { status: 'completed' });
console.log(updatedOrder);

Delete Order

Delete an order:

await client.deleteOrder('shopId', 'orderId');
console.log('Order deleted');

Shipping Methods

Get Shipping Options

Get shipping options for a product:

const shippingOptions = await client.getShippingOptions('shopId', 'productId');
console.log(shippingOptions);

Error Handling

The client uses a central request handler with error management. If an error occurs, it throws a PrintifyError:

try {
    const products = await client.getProducts('shopId');
} catch (error) {
    if (error instanceof PrintifyError) {
        console.error(`Error: ${error.message}, Status Code: ${error.statusCode}`);
    } else {
        console.error('Unknown error occurred');
    }
}