printify-effect/src/v1/catalog/getProvider.ts

Effect-ts wrapper for Printify REST API — still in early development, use at your own risk!

import { Schema } from "effect";
import { requestPrintify } from "../../common/requestPrintify";
import { GetProviderResponse } from "../schemas";

export { GetProviderResponse };
export type GetProviderResponseType = Schema.Schema.Type<
  typeof GetProviderResponse
>;

/**
 * Retrieve a specific print-provider and a list of associated blueprint offerings
 *
 * @param {string} printProviderId - The ID of the print provider to retrieve
 * @returns Effect that yields the provider details
 *
 * @example
 * const printProviderId = "123456";
 * const provider = printify.catalog.getProvider(printProviderId);
 * // Expected response: {
 *   "id": 1,
 *   "title": "SPOKE Custom Products",
 *   "location": { "address1": "89 Weirfield St", "address2": null, "city": "Brooklyn", "country": "US", "region": "NY", "zip": "11221-5120" },
 *   "blueprints": [
 *     { "id": 265, "title": "Slim Iphone 8", "brand": "Case Mate", "model": "Slim Iphone 8", "images": ["https://images.printify.com/59b261c9b8e7e361c9147b1b.png"] },
 *     { "id": 266, "title": "Tough Iphone 8", "brand": "Case Mate", "model": "Tough Iphone 8", "images": ["https://images.printify.com/59b26fbfb8e7e36254554a34.png"] }
 *     // ...
 *   ]
 * }
 */
const getProvider = (printProviderId: string) =>
  requestPrintify(
    GetProviderResponse,
    `/v1/catalog/print_providers/${printProviderId}.json`,
    {
      method: "GET",
    }
  );

export default getProvider;