perspectapi-ts-sdk 3.6.0 → 3.7.0

package/dist/index.d.mts

@@ -359,6 +359,46 @@ interface MediaItem {
     r2_key: string;
     site_name: string;
 }
+interface ProductSkuMediaItem {
+    id?: string;
+    media_id: string;
+    file_name?: string;
+    fileName?: string;
+    link?: string;
+    url?: string;
+    content_type?: string;
+    contentType?: string;
+    width?: number;
+    height?: number;
+    filesize?: number;
+    r2_key?: string;
+    site_name?: string;
+}
+interface ProductSkuOption {
+    name: string;
+    key: string;
+    value: string;
+    label: string;
+    value_id: number;
+}
+interface ProductSku {
+    sku_id: number;
+    sku?: string | null;
+    combination_key: string;
+    media_id?: string | null;
+    media?: ProductSkuMediaItem | null;
+    options?: ProductSkuOption[];
+    unit_amount?: number;
+    currency?: string;
+    quantity_available?: number | null;
+    price?: number;
+    sale_price?: number;
+    stock_quantity?: number;
+    value_ids: number[];
+    created_at?: string;
+    updated_at?: string;
+    [key: string]: any;
+}
 interface Product {
     id: number | string;
     name?: string;
@@ -372,6 +412,7 @@ interface Product {
     slug_prefix?: string;
     image?: string;
     media?: MediaItem[] | MediaItem[][];
+    skus?: ProductSku[];
     isActive?: boolean;
     organizationId?: number;
     createdAt?: string;
@@ -402,6 +443,20 @@ interface CreateProductRequest {
     stock_quantity?: number | null;
     isActive?: boolean;
 }
+interface CreateProductSkuRequest {
+    sku?: string | null;
+    media_id?: string | null;
+    unit_amount?: number;
+    currency?: string;
+    quantity_available?: number | null;
+    price?: number | null;
+    stock_quantity?: number | null;
+    sale_price?: number | null;
+    published?: boolean;
+    gateway_price_id_test?: string | null;
+    gateway_price_id_live?: string | null;
+    value_ids: number[];
+}
 interface ProductQueryParams extends PaginationParams {
     organizationId?: number;
     isActive?: boolean;
@@ -1459,34 +1514,11 @@ declare class ProductsClient extends BaseClient {
     /**
      * Get all SKUs for a product (with their option value combinations)
      */
-    getProductSkus(siteName: string, productId: number): Promise<ApiResponse<Array<{
-        sku_id: number;
-        sku: string;
-        price?: number;
-        sale_price?: number;
-        stock_quantity?: number;
-        combination_key: string;
-        value_ids: number[];
-        created_at: string;
-        updated_at: string;
-    }>>>;
+    getProductSkus(siteName: string, productId: number): Promise<ApiResponse<ProductSku[]>>;
     /**
      * Create or update a SKU for a product variant combination
      */
-    createProductSku(siteName: string, productId: number, data: {
-        sku: string;
-        price?: number | null;
-        sale_price?: number | null;
-        stock_quantity?: number | null;
-        value_ids: number[];
-    }): Promise<ApiResponse<{
-        sku_id: number;
-        sku: string;
-        price?: number;
-        sale_price?: number;
-        stock_quantity?: number;
-        combination_key: string;
-    }>>;
+    createProductSku(siteName: string, productId: number, data: CreateProductSkuRequest): Promise<ApiResponse<ProductSku>>;
 }
 
 /**
@@ -3087,4 +3119,4 @@ declare function createCheckoutSession(options: CheckoutSessionOptions): Promise
     error: string;
 }>;
 
-export { type AddCollectionItemRequest, type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, BaseClient, type BlogPost, type BundleCollection, type BundleCollectionItem, type BundleCollectionItemWithProduct, BundlesClient, type CacheConfig, CacheManager, CategoriesClient, type Category, type CategorySummary, type CheckoutAddress, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, type CheckoutSessionTax, type CheckoutTaxBreakdownItem, type CheckoutTaxCustomerExemptionRequest, type CheckoutTaxExemptionStatus, type CheckoutTaxRequest, type CheckoutTaxStrategy, ContactClient, type ContactStatusResponse, type ContactSubmission, type ContactSubmitResponse, type Content, type ContentCategoryResponse, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateBundleCollectionRequest, type CreateBundleGroupRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreateProductRequest, type CreateSiteRequest, type CreateWebhookRequest, type CreditBalance, type CreditBalanceWithTransactions, type CreditTransaction, DEFAULT_IMAGE_SIZES, type GrantCreditRequest, HttpClient, type HttpMethod, type ImageTransformOptions, InMemoryCacheAdapter, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, type NewsletterCampaignDetail, type NewsletterCampaignListResponse, type NewsletterCampaignSummary, NewsletterClient, type NewsletterConfirmResponse, type NewsletterList, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterUnsubscribeRequest, type NewsletterUnsubscribeResponse, NoopCacheAdapter, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, PerspectApiClient, type PerspectApiConfig, type Product, type ProductBundleGroup, type ProductQueryParams, ProductsClient, type RequestOptions, type RequestOtpRequest, type ResponsiveImageSizes, type SetProfileValueRequest, type Site, type SiteUser, type SiteUserOrder, type SiteUserProfile, type SiteUserSubscription, SiteUsersClient, SitesClient, type UpdateApiKeyRequest, type UpdateContentRequest, type UpdateSiteUserRequest, type User, type VerifyOtpRequest, type VerifyOtpResponse, type Webhook, WebhooksClient, buildImageUrl, createApiError, createCheckoutSession, createPerspectApiClient, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct };
+export { type AddCollectionItemRequest, type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, BaseClient, type BlogPost, type BundleCollection, type BundleCollectionItem, type BundleCollectionItemWithProduct, BundlesClient, type CacheConfig, CacheManager, CategoriesClient, type Category, type CategorySummary, type CheckoutAddress, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, type CheckoutSessionTax, type CheckoutTaxBreakdownItem, type CheckoutTaxCustomerExemptionRequest, type CheckoutTaxExemptionStatus, type CheckoutTaxRequest, type CheckoutTaxStrategy, ContactClient, type ContactStatusResponse, type ContactSubmission, type ContactSubmitResponse, type Content, type ContentCategoryResponse, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateBundleCollectionRequest, type CreateBundleGroupRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreateProductRequest, type CreateProductSkuRequest, type CreateSiteRequest, type CreateWebhookRequest, type CreditBalance, type CreditBalanceWithTransactions, type CreditTransaction, DEFAULT_IMAGE_SIZES, type GrantCreditRequest, HttpClient, type HttpMethod, type ImageTransformOptions, InMemoryCacheAdapter, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, type NewsletterCampaignDetail, type NewsletterCampaignListResponse, type NewsletterCampaignSummary, NewsletterClient, type NewsletterConfirmResponse, type NewsletterList, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterUnsubscribeRequest, type NewsletterUnsubscribeResponse, NoopCacheAdapter, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, PerspectApiClient, type PerspectApiConfig, type Product, type ProductBundleGroup, type ProductQueryParams, type ProductSku, type ProductSkuMediaItem, type ProductSkuOption, ProductsClient, type RequestOptions, type RequestOtpRequest, type ResponsiveImageSizes, type SetProfileValueRequest, type Site, type SiteUser, type SiteUserOrder, type SiteUserProfile, type SiteUserSubscription, SiteUsersClient, SitesClient, type UpdateApiKeyRequest, type UpdateContentRequest, type UpdateSiteUserRequest, type User, type VerifyOtpRequest, type VerifyOtpResponse, type Webhook, WebhooksClient, buildImageUrl, createApiError, createCheckoutSession, createPerspectApiClient, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct };

package/dist/index.d.ts

@@ -359,6 +359,46 @@ interface MediaItem {
     r2_key: string;
     site_name: string;
 }
+interface ProductSkuMediaItem {
+    id?: string;
+    media_id: string;
+    file_name?: string;
+    fileName?: string;
+    link?: string;
+    url?: string;
+    content_type?: string;
+    contentType?: string;
+    width?: number;
+    height?: number;
+    filesize?: number;
+    r2_key?: string;
+    site_name?: string;
+}
+interface ProductSkuOption {
+    name: string;
+    key: string;
+    value: string;
+    label: string;
+    value_id: number;
+}
+interface ProductSku {
+    sku_id: number;
+    sku?: string | null;
+    combination_key: string;
+    media_id?: string | null;
+    media?: ProductSkuMediaItem | null;
+    options?: ProductSkuOption[];
+    unit_amount?: number;
+    currency?: string;
+    quantity_available?: number | null;
+    price?: number;
+    sale_price?: number;
+    stock_quantity?: number;
+    value_ids: number[];
+    created_at?: string;
+    updated_at?: string;
+    [key: string]: any;
+}
 interface Product {
     id: number | string;
     name?: string;
@@ -372,6 +412,7 @@ interface Product {
     slug_prefix?: string;
     image?: string;
     media?: MediaItem[] | MediaItem[][];
+    skus?: ProductSku[];
     isActive?: boolean;
     organizationId?: number;
     createdAt?: string;
@@ -402,6 +443,20 @@ interface CreateProductRequest {
     stock_quantity?: number | null;
     isActive?: boolean;
 }
+interface CreateProductSkuRequest {
+    sku?: string | null;
+    media_id?: string | null;
+    unit_amount?: number;
+    currency?: string;
+    quantity_available?: number | null;
+    price?: number | null;
+    stock_quantity?: number | null;
+    sale_price?: number | null;
+    published?: boolean;
+    gateway_price_id_test?: string | null;
+    gateway_price_id_live?: string | null;
+    value_ids: number[];
+}
 interface ProductQueryParams extends PaginationParams {
     organizationId?: number;
     isActive?: boolean;
@@ -1459,34 +1514,11 @@ declare class ProductsClient extends BaseClient {
     /**
      * Get all SKUs for a product (with their option value combinations)
      */
-    getProductSkus(siteName: string, productId: number): Promise<ApiResponse<Array<{
-        sku_id: number;
-        sku: string;
-        price?: number;
-        sale_price?: number;
-        stock_quantity?: number;
-        combination_key: string;
-        value_ids: number[];
-        created_at: string;
-        updated_at: string;
-    }>>>;
+    getProductSkus(siteName: string, productId: number): Promise<ApiResponse<ProductSku[]>>;
     /**
      * Create or update a SKU for a product variant combination
      */
-    createProductSku(siteName: string, productId: number, data: {
-        sku: string;
-        price?: number | null;
-        sale_price?: number | null;
-        stock_quantity?: number | null;
-        value_ids: number[];
-    }): Promise<ApiResponse<{
-        sku_id: number;
-        sku: string;
-        price?: number;
-        sale_price?: number;
-        stock_quantity?: number;
-        combination_key: string;
-    }>>;
+    createProductSku(siteName: string, productId: number, data: CreateProductSkuRequest): Promise<ApiResponse<ProductSku>>;
 }
 
 /**
@@ -3087,4 +3119,4 @@ declare function createCheckoutSession(options: CheckoutSessionOptions): Promise
     error: string;
 }>;
 
-export { type AddCollectionItemRequest, type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, BaseClient, type BlogPost, type BundleCollection, type BundleCollectionItem, type BundleCollectionItemWithProduct, BundlesClient, type CacheConfig, CacheManager, CategoriesClient, type Category, type CategorySummary, type CheckoutAddress, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, type CheckoutSessionTax, type CheckoutTaxBreakdownItem, type CheckoutTaxCustomerExemptionRequest, type CheckoutTaxExemptionStatus, type CheckoutTaxRequest, type CheckoutTaxStrategy, ContactClient, type ContactStatusResponse, type ContactSubmission, type ContactSubmitResponse, type Content, type ContentCategoryResponse, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateBundleCollectionRequest, type CreateBundleGroupRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreateProductRequest, type CreateSiteRequest, type CreateWebhookRequest, type CreditBalance, type CreditBalanceWithTransactions, type CreditTransaction, DEFAULT_IMAGE_SIZES, type GrantCreditRequest, HttpClient, type HttpMethod, type ImageTransformOptions, InMemoryCacheAdapter, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, type NewsletterCampaignDetail, type NewsletterCampaignListResponse, type NewsletterCampaignSummary, NewsletterClient, type NewsletterConfirmResponse, type NewsletterList, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterUnsubscribeRequest, type NewsletterUnsubscribeResponse, NoopCacheAdapter, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, PerspectApiClient, type PerspectApiConfig, type Product, type ProductBundleGroup, type ProductQueryParams, ProductsClient, type RequestOptions, type RequestOtpRequest, type ResponsiveImageSizes, type SetProfileValueRequest, type Site, type SiteUser, type SiteUserOrder, type SiteUserProfile, type SiteUserSubscription, SiteUsersClient, SitesClient, type UpdateApiKeyRequest, type UpdateContentRequest, type UpdateSiteUserRequest, type User, type VerifyOtpRequest, type VerifyOtpResponse, type Webhook, WebhooksClient, buildImageUrl, createApiError, createCheckoutSession, createPerspectApiClient, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct };
+export { type AddCollectionItemRequest, type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, BaseClient, type BlogPost, type BundleCollection, type BundleCollectionItem, type BundleCollectionItemWithProduct, BundlesClient, type CacheConfig, CacheManager, CategoriesClient, type Category, type CategorySummary, type CheckoutAddress, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, type CheckoutSessionTax, type CheckoutTaxBreakdownItem, type CheckoutTaxCustomerExemptionRequest, type CheckoutTaxExemptionStatus, type CheckoutTaxRequest, type CheckoutTaxStrategy, ContactClient, type ContactStatusResponse, type ContactSubmission, type ContactSubmitResponse, type Content, type ContentCategoryResponse, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateBundleCollectionRequest, type CreateBundleGroupRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreateProductRequest, type CreateProductSkuRequest, type CreateSiteRequest, type CreateWebhookRequest, type CreditBalance, type CreditBalanceWithTransactions, type CreditTransaction, DEFAULT_IMAGE_SIZES, type GrantCreditRequest, HttpClient, type HttpMethod, type ImageTransformOptions, InMemoryCacheAdapter, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, type NewsletterCampaignDetail, type NewsletterCampaignListResponse, type NewsletterCampaignSummary, NewsletterClient, type NewsletterConfirmResponse, type NewsletterList, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterUnsubscribeRequest, type NewsletterUnsubscribeResponse, NoopCacheAdapter, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, PerspectApiClient, type PerspectApiConfig, type Product, type ProductBundleGroup, type ProductQueryParams, type ProductSku, type ProductSkuMediaItem, type ProductSkuOption, ProductsClient, type RequestOptions, type RequestOtpRequest, type ResponsiveImageSizes, type SetProfileValueRequest, type Site, type SiteUser, type SiteUserOrder, type SiteUserProfile, type SiteUserSubscription, SiteUsersClient, SitesClient, type UpdateApiKeyRequest, type UpdateContentRequest, type UpdateSiteUserRequest, type User, type VerifyOtpRequest, type VerifyOtpResponse, type Webhook, WebhooksClient, buildImageUrl, createApiError, createCheckoutSession, createPerspectApiClient, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct };

package/dist/index.js

@@ -1553,7 +1553,36 @@ var ProductsClient = class extends BaseClient {
       `/products/${productId}/skus`,
       { includeSitesSegment: false }
     );
-    return this.create(endpoint, data);
+    const unitAmountCandidate = typeof data.unit_amount === "number" ? data.unit_amount : typeof data.price === "number" ? Math.round(data.price * 100) : void 0;
+    if (typeof unitAmountCandidate !== "number" || !Number.isFinite(unitAmountCandidate)) {
+      throw new Error("createProductSku requires unit_amount or price");
+    }
+    const unitAmount = unitAmountCandidate;
+    const quantityAvailable = data.quantity_available !== void 0 ? data.quantity_available : data.stock_quantity ?? null;
+    const payload = {
+      sku: data.sku ?? null,
+      unit_amount: unitAmount,
+      currency: data.currency || "usd",
+      quantity_available: quantityAvailable,
+      published: data.published,
+      gateway_price_id_test: data.gateway_price_id_test,
+      gateway_price_id_live: data.gateway_price_id_live,
+      value_ids: data.value_ids
+    };
+    if (Object.prototype.hasOwnProperty.call(data, "media_id")) {
+      if (data.media_id === null) {
+        payload.media_id = null;
+      } else if (typeof data.media_id === "string") {
+        const trimmed = data.media_id.trim();
+        if (!trimmed) {
+          throw new Error("createProductSku media_id cannot be empty");
+        }
+        payload.media_id = trimmed;
+      } else if (data.media_id !== void 0) {
+        throw new Error("createProductSku media_id must be a string or null");
+      }
+    }
+    return this.create(endpoint, payload);
   }
 };
 

package/dist/index.mjs

@@ -1490,7 +1490,36 @@ var ProductsClient = class extends BaseClient {
       `/products/${productId}/skus`,
       { includeSitesSegment: false }
     );
-    return this.create(endpoint, data);
+    const unitAmountCandidate = typeof data.unit_amount === "number" ? data.unit_amount : typeof data.price === "number" ? Math.round(data.price * 100) : void 0;
+    if (typeof unitAmountCandidate !== "number" || !Number.isFinite(unitAmountCandidate)) {
+      throw new Error("createProductSku requires unit_amount or price");
+    }
+    const unitAmount = unitAmountCandidate;
+    const quantityAvailable = data.quantity_available !== void 0 ? data.quantity_available : data.stock_quantity ?? null;
+    const payload = {
+      sku: data.sku ?? null,
+      unit_amount: unitAmount,
+      currency: data.currency || "usd",
+      quantity_available: quantityAvailable,
+      published: data.published,
+      gateway_price_id_test: data.gateway_price_id_test,
+      gateway_price_id_live: data.gateway_price_id_live,
+      value_ids: data.value_ids
+    };
+    if (Object.prototype.hasOwnProperty.call(data, "media_id")) {
+      if (data.media_id === null) {
+        payload.media_id = null;
+      } else if (typeof data.media_id === "string") {
+        const trimmed = data.media_id.trim();
+        if (!trimmed) {
+          throw new Error("createProductSku media_id cannot be empty");
+        }
+        payload.media_id = trimmed;
+      } else if (data.media_id !== void 0) {
+        throw new Error("createProductSku media_id must be a string or null");
+      }
+    }
+    return this.create(endpoint, payload);
   }
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perspectapi-ts-sdk",
-  "version": "3.6.0",
+  "version": "3.7.0",
   "description": "TypeScript SDK for PerspectAPI - Cloudflare Workers compatible",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/client/products-client.ts

@@ -8,6 +8,8 @@ import type { CachePolicy } from '../cache/types';
 import type {
   Product,
   CreateProductRequest,
+  CreateProductSkuRequest,
+  ProductSku,
   PaginatedResponse,
   ApiResponse,
   ProductQueryParams,
@@ -457,17 +459,7 @@ export class ProductsClient extends BaseClient {
   async getProductSkus(
     siteName: string,
     productId: number
-  ): Promise<ApiResponse<Array<{
-    sku_id: number;
-    sku: string;
-    price?: number;
-    sale_price?: number;
-    stock_quantity?: number;
-    combination_key: string;
-    value_ids: number[];
-    created_at: string;
-    updated_at: string;
-  }>>> {
+  ): Promise<ApiResponse<ProductSku[]>> {
     const endpoint = this.siteScopedEndpoint(
       siteName,
       `/products/${productId}/skus`,
@@ -482,26 +474,66 @@ export class ProductsClient extends BaseClient {
   async createProductSku(
     siteName: string,
     productId: number,
-    data: {
-      sku: string;
-      price?: number | null;
-      sale_price?: number | null;
-      stock_quantity?: number | null;
-      value_ids: number[];
-    }
-  ): Promise<ApiResponse<{
-    sku_id: number;
-    sku: string;
-    price?: number;
-    sale_price?: number;
-    stock_quantity?: number;
-    combination_key: string;
-  }>> {
+    data: CreateProductSkuRequest
+  ): Promise<ApiResponse<ProductSku>> {
     const endpoint = this.siteScopedEndpoint(
       siteName,
       `/products/${productId}/skus`,
       { includeSitesSegment: false }
     );
-    return this.create(endpoint, data);
+
+    const unitAmountCandidate =
+      typeof data.unit_amount === 'number'
+        ? data.unit_amount
+        : typeof data.price === 'number'
+          ? Math.round(data.price * 100)
+          : undefined;
+
+    if (typeof unitAmountCandidate !== 'number' || !Number.isFinite(unitAmountCandidate)) {
+      throw new Error('createProductSku requires unit_amount or price');
+    }
+    const unitAmount = unitAmountCandidate;
+
+    const quantityAvailable =
+      data.quantity_available !== undefined
+        ? data.quantity_available
+        : (data.stock_quantity ?? null);
+
+    const payload: {
+      sku: string | null;
+      media_id?: string | null;
+      unit_amount: number;
+      currency: string;
+      quantity_available: number | null;
+      published?: boolean;
+      gateway_price_id_test?: string | null;
+      gateway_price_id_live?: string | null;
+      value_ids: number[];
+    } = {
+      sku: data.sku ?? null,
+      unit_amount: unitAmount,
+      currency: data.currency || 'usd',
+      quantity_available: quantityAvailable,
+      published: data.published,
+      gateway_price_id_test: data.gateway_price_id_test,
+      gateway_price_id_live: data.gateway_price_id_live,
+      value_ids: data.value_ids,
+    };
+
+    if (Object.prototype.hasOwnProperty.call(data, 'media_id')) {
+      if (data.media_id === null) {
+        payload.media_id = null;
+      } else if (typeof data.media_id === 'string') {
+        const trimmed = data.media_id.trim();
+        if (!trimmed) {
+          throw new Error('createProductSku media_id cannot be empty');
+        }
+        payload.media_id = trimmed;
+      } else if (data.media_id !== undefined) {
+        throw new Error('createProductSku media_id must be a string or null');
+      }
+    }
+
+    return this.create(endpoint, payload);
   }
 }

package/src/types/index.ts

@@ -320,6 +320,49 @@ export interface MediaItem {
   site_name: string;
 }
 
+export interface ProductSkuMediaItem {
+  id?: string;
+  media_id: string;
+  file_name?: string;
+  fileName?: string;
+  link?: string;
+  url?: string;
+  content_type?: string;
+  contentType?: string;
+  width?: number;
+  height?: number;
+  filesize?: number;
+  r2_key?: string;
+  site_name?: string;
+}
+
+export interface ProductSkuOption {
+  name: string;
+  key: string;
+  value: string;
+  label: string;
+  value_id: number;
+}
+
+export interface ProductSku {
+  sku_id: number;
+  sku?: string | null;
+  combination_key: string;
+  media_id?: string | null;
+  media?: ProductSkuMediaItem | null;
+  options?: ProductSkuOption[];
+  unit_amount?: number;
+  currency?: string;
+  quantity_available?: number | null;
+  price?: number;
+  sale_price?: number;
+  stock_quantity?: number;
+  value_ids: number[];
+  created_at?: string;
+  updated_at?: string;
+  [key: string]: any;
+}
+
 export interface Product {
   id: number | string;
   name?: string;
@@ -333,6 +376,7 @@ export interface Product {
   slug_prefix?: string;
   image?: string;
   media?: MediaItem[] | MediaItem[][];
+  skus?: ProductSku[];
   isActive?: boolean;
   organizationId?: number;
   createdAt?: string;
@@ -362,6 +406,21 @@ export interface CreateProductRequest {
   isActive?: boolean;
 }
 
+export interface CreateProductSkuRequest {
+  sku?: string | null;
+  media_id?: string | null;
+  unit_amount?: number;
+  currency?: string;
+  quantity_available?: number | null;
+  price?: number | null;
+  stock_quantity?: number | null;
+  sale_price?: number | null;
+  published?: boolean;
+  gateway_price_id_test?: string | null;
+  gateway_price_id_live?: string | null;
+  value_ids: number[];
+}
+
 export interface ProductQueryParams extends PaginationParams {
   organizationId?: number;
   isActive?: boolean;