release(v2.1.2-beta): update the OpenAPI spec.json (#32)

> - source: blob:https://developers.printful.com/11c34042-9e1f-4afc-8f97-06c2a7b5968c
> - docs: https://developers.printful.com/docs/v2-beta/

Author: spencerlepine

CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.1.2-beta] - 2025-07-24
+
+- Updated to the latest OpenAPI spec (Jul 2025).
+  > - source: blob:https://developers.printful.com/11c34042-9e1f-4afc-8f97-06c2a7b5968c
+  > - docs: https://developers.printful.com/docs/v2-beta/
+
 ## [2.1.0-beta] - 2025-04-15
 
 - Updated to the latest OpenAPI spec (Apr 2025).

openapi.json

@@ -1,6 +1,6 @@
 {
   "name": "printful-sdk-js-v2",
-  "version": "2.1.1-beta",
+  "version": "2.1.2-beta",
   "description": "Printful SDK for Node.js / TypeScript. A wrapper for the Printful REST API (v2)",
   "author": "Spencer Lepine <spencer.sayhello@gmail.com>",
   "license": "MIT",

package.json

@@ -42,6 +42,7 @@ export type { CustomizationReadonly } from './models/CustomizationReadonly';
 export type { DateFrom } from './models/DateFrom';
 export type { DateTo } from './models/DateTo';
 export type { DefaultEventConfigurationRequest } from './models/DefaultEventConfigurationRequest';
+export type { DefaultMockupStylesFilter } from './models/DefaultMockupStylesFilter';
 export type { DesignPlacement } from './models/DesignPlacement';
 export type { DestinationCountry } from './models/DestinationCountry';
 export { dPuffOption } from './models/dPuffOption';
@@ -61,7 +62,7 @@ export type { HeaderSource } from './models/HeaderSource';
 export { InsideLabelTypeOption } from './models/InsideLabelTypeOption';
 export { InsidePocketOption } from './models/InsidePocketOption';
 export type { InternalId } from './models/InternalId';
-export type { Item } from './models/Item';
+export { Item } from './models/Item';
 export type { ItemExternalId } from './models/ItemExternalId';
 export type { ItemId } from './models/ItemId';
 export type { ItemReadonly } from './models/ItemReadonly';
@@ -123,6 +124,7 @@ export type { ProductCategoryIds } from './models/ProductCategoryIds';
 export type { ProductData } from './models/ProductData';
 export type { ProductId } from './models/ProductId';
 export type { ProductInfo } from './models/ProductInfo';
+export type { ProductionCurrency } from './models/ProductionCurrency';
 export type { ProductLinks } from './models/ProductLinks';
 export type { ProductOptions } from './models/ProductOptions';
 export type { ProductPrices } from './models/ProductPrices';

src/index.ts

@@ -0,0 +1,5 @@
+/* generated using openapi-typescript-codegen -- do not edit */
+/* istanbul ignore file */
+/* tslint:disable */
+/* eslint-disable */
+export type DefaultMockupStylesFilter = boolean;

src/models/DefaultMockupStylesFilter.ts

@@ -28,6 +28,10 @@ export type Item = {
      */
     name?: string;
     placements?: PlacementsList;
+    /**
+     * Orientation of the design. Applies only to the products that allow multiple orientations such as framed posters.
+     */
+    orientation?: Item.orientation | null;
     product_options?: ProductOptions;
     /**
      * HATEOAS links
@@ -36,4 +40,14 @@ export type Item = {
         self?: HateoasLink;
     };
 };
+export namespace Item {
+    /**
+     * Orientation of the design. Applies only to the products that allow multiple orientations such as framed posters.
+     */
+    export enum orientation {
+        HORIZONTAL = 'horizontal',
+        VERTICAL = 'vertical',
+        ANY = 'any',
+    }
+}
 

src/models/Item.ts

@@ -9,6 +9,12 @@ export type MockupTaskCreation = {
      * Generated file format. PNG will have a transparent background, JPG will have a smaller file size.
      */
     format?: MockupTaskCreation.format;
+    /**
+     * Width of the mockup image in pixels. If not specified, the default value will be used. The default value is 1000px.
+     * If the value is specified as 2000 that means that resulting mockups will be 2000x2000px.
+     *
+     */
+    mockup_width_px?: number;
     products: Array<(CatalogMockupProduct | TemplateMockupProduct)>;
 };
 export namespace MockupTaskCreation {

src/models/MockupTaskCreation.ts

@@ -0,0 +1,8 @@
+/* generated using openapi-typescript-codegen -- do not edit */
+/* istanbul ignore file */
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * The production currency (3-letter code) used to determine currency in which the prices will be calculated. The active user production currency will be used by default. The format is compliant with ISO 4217 standard.
+ */
+export type ProductionCurrency = string;

src/models/ProductionCurrency.ts

@@ -32,6 +32,10 @@ export type Variant = {
      * Secondary hexadecimal RGB color code. May not exactly reflect the real-world color
      */
     color_code2: string | null;
+    /**
+     * A list of placement configuration objects, each specifying the layout details for a particular placement.
+     */
+    placement_dimensions?: any;
     /**
      * URL of a preview image for this variant
      */

src/models/Variant.ts

@@ -303,6 +303,7 @@ export class CatalogV2Service {
      * @param id Product ID.
      * @param sellingRegionName Specifies the region production currency that the product prices will be calculated in
      * @param currency The currency (3-letter code) used to determine currency in which the prices will be displayed. The store currency will be used by default. The format is compliant with ISO 4217 standard.
+     * @param productionCurrency The production currency (3-letter code) used to determine currency in which the prices will be calculated. The active user production currency will be used by default. The format is compliant with ISO 4217 standard.
      * @param xPfLanguage Use this to specify which locale you would like to use in the responses, for some endpoints this can affect translations.
      *
      * @returns any OK
@@ -312,6 +313,7 @@ export class CatalogV2Service {
         id: number,
         sellingRegionName?: string,
         currency?: string,
+        productionCurrency?: string,
         xPfLanguage?: string,
     ): CancelablePromise<any> {
         return this.httpRequest.request({
@@ -326,6 +328,7 @@ export class CatalogV2Service {
             query: {
                 'selling_region_name': sellingRegionName,
                 'currency': currency,
+                'production_currency': productionCurrency,
             },
             errors: {
                 404: `Not found`,
@@ -338,6 +341,7 @@ export class CatalogV2Service {
      * @param id Variant ID
      * @param sellingRegionName Specifies the region production currency that the product prices will be calculated in
      * @param currency The currency (3-letter code) used to determine currency in which the prices will be displayed. The store currency will be used by default. The format is compliant with ISO 4217 standard.
+     * @param productionCurrency The production currency (3-letter code) used to determine currency in which the prices will be calculated. The active user production currency will be used by default. The format is compliant with ISO 4217 standard.
      * @param xPfLanguage Use this to specify which locale you would like to use in the responses, for some endpoints this can affect translations.
      *
      * @returns any OK
@@ -347,6 +351,7 @@ export class CatalogV2Service {
         id: number,
         sellingRegionName?: string,
         currency?: string,
+        productionCurrency?: string,
         xPfLanguage?: string,
     ): CancelablePromise<any> {
         return this.httpRequest.request({
@@ -361,6 +366,7 @@ export class CatalogV2Service {
             query: {
                 'selling_region_name': sellingRegionName,
                 'currency': currency,
+                'production_currency': productionCurrency,
             },
             errors: {
                 404: `Not found`,
@@ -486,6 +492,7 @@ export class CatalogV2Service {
      *
      * @param id Product ID.
      * @param placements One or more placement idenitifiers used to filter in mockup styles that match a given placement. The complete list of placements can be found [here](https://developers.printful.com/docs/#tag/Common/Placements).
+     * @param defaultMockupStyles
      * @param sellingRegionName Only returns the products that can be sold in the specified region. If is set to 'all' returns each region availability for specified product.
      * @param offset Result set offset
      * @param limit Number of items per page (max 100)
@@ -497,6 +504,7 @@ export class CatalogV2Service {
     public retrieveMockupStylesByProductId(
         id: number,
         placements?: Array<string>,
+        defaultMockupStyles: boolean = false,
         sellingRegionName: 'worldwide' | 'north_america' | 'canada' | 'europe' | 'spain' | 'latvia' | 'uk' | 'france' | 'germany' | 'australia' | 'japan' | 'new_zealand' | 'italy' | 'brazil' | 'southeast_asia' | 'republic_of_korea' | 'all' = 'worldwide',
         offset?: number,
         limit?: number,
@@ -513,6 +521,7 @@ export class CatalogV2Service {
             },
             query: {
                 'placements': placements,
+                'default_mockup_styles': defaultMockupStyles,
                 'selling_region_name': sellingRegionName,
                 'offset': offset,
                 'limit': limit,