@carrierllc/sdk 0.2.13 → 0.2.15

package/dist/data/cli.json

@@ -1925,7 +1925,7 @@
     "options": [
       {
         "flags": "--pack <pack>",
-        "description": "Pack id (pack_500/pack_1000/pack_2500/pack_5000) or exact EUR-cents amount.",
+        "description": "Pack id (pack_25/pack_50/pack_100/pack_500/pack_1000/pack_2500/pack_5000) or exact EUR-cents amount.",
         "required": false
       }
     ]

package/dist/data/operations.json

@@ -2950,7 +2950,7 @@
     "method": "PATCH",
     "path": "/v1/storefronts/{id}/plans/{slug}",
     "tag": "Storefront",
-    "summary": "Change the price, sale state, or display order of an existing plan. Omitted fields stay as stored. A plan on another storefront is not found.",
+    "summary": "Change the price, sale state, display order, or stored Stripe Price of an existing plan. The Price id and its mode are set together; null clears both. The Price is stored, not yet charged. Omitted fields stay as stored. A plan on another storefront is not found.",
     "security": "bearer",
     "body": true,
     "bodyRequired": true,

package/dist/storefront-write.d.ts

@@ -32,6 +32,10 @@ export interface StorefrontPlanInput {
     active?: boolean;
     /** Display order on the storefront (ascending). Defaults to 0; ties fall back to slug. */
     sortOrder?: number;
+    /** Existing Stripe Price id (`price_…`), stored, not yet charged. Null clears the id and the mode. Set with stripePriceMode. */
+    stripePriceId?: string | null;
+    /** `test` or `live`. Null clears the id and the mode. Set with stripePriceId. */
+    stripePriceMode?: "test" | "live" | null;
 }
 export interface ExistingStorefrontBrand {
     theme?: Record<string, unknown>;
@@ -52,6 +56,8 @@ export interface StorefrontPlanBody {
     description?: string;
     active?: boolean;
     sort_order?: number;
+    stripe_price_id?: string | null;
+    stripe_price_mode?: "test" | "live" | null;
 }
 export declare function storefrontBrandPatch(input: StorefrontBrandInput, existing?: ExistingStorefrontBrand): {
     theme?: Record<string, unknown>;

package/dist/storefront-write.js

@@ -4,6 +4,8 @@
  * onto the store already saved before it is sent.
  */
 export { logoFileDataUrl, logoReference, majorToCents, parseCountryInput, parseDataGb, parseValidityDays, } from "./storefront-labels.js";
+const STRIPE_PRICE_ID_RE = /^price_[A-Za-z0-9_]+$/;
+const STRIPE_PRICE_ID_MAX_LENGTH = 255;
 const THEME_FIELDS = [
     ["accent", "accent"],
     ["accentDark", "accentDark"],
@@ -43,6 +45,8 @@ export function completePlanInput(input, plans) {
         input.description,
         input.active,
         input.sortOrder,
+        input.stripePriceId,
+        input.stripePriceMode,
     ].some((value) => value !== undefined);
     if (!touched)
         return input;
@@ -72,6 +76,9 @@ export function storefrontPlanBody(input) {
     if (input.accountId !== undefined && (!Number.isSafeInteger(input.accountId) || input.accountId <= 0)) {
         return { error: "OCS account id must be a positive integer." };
     }
+    const stripe = stripePriceFields(input.stripePriceId, input.stripePriceMode);
+    if (stripe && "error" in stripe)
+        return stripe;
     const productId = input.productId?.trim() ?? "";
     if (productId !== "") {
         const body = { product_id: productId };
@@ -83,7 +90,7 @@ export function storefrontPlanBody(input) {
             body.active = input.active;
         if (input.sortOrder !== undefined)
             body.sort_order = input.sortOrder;
-        return body;
+        return stripe ? { ...body, ...stripe } : body;
     }
     const touched = [
         input.slug,
@@ -99,6 +106,8 @@ export function storefrontPlanBody(input) {
         input.description,
         input.active,
         input.sortOrder,
+        input.stripePriceId,
+        input.stripePriceMode,
     ].some((value) => value !== undefined);
     if (!touched)
         return null;
@@ -135,7 +144,29 @@ export function storefrontPlanBody(input) {
         body.active = input.active;
     if (input.sortOrder !== undefined)
         body.sort_order = input.sortOrder;
-    return body;
+    return stripe ? { ...body, ...stripe } : body;
+}
+/** Null clears both fields. A Price id and its mode are sent together. */
+function stripePriceFields(id, mode) {
+    if (id === undefined && mode === undefined)
+        return undefined;
+    if (typeof id === "string") {
+        const trimmed = id.trim();
+        if (trimmed.length < 1 || trimmed.length > STRIPE_PRICE_ID_MAX_LENGTH || !STRIPE_PRICE_ID_RE.test(trimmed)) {
+            return { error: "stripe_price_id must look like price_… and be 1-255 characters." };
+        }
+        id = trimmed;
+    }
+    if (id === null || mode === null) {
+        if ((id !== undefined && id !== null) || (mode !== undefined && mode !== null)) {
+            return { error: "Sending null clears both stripe_price_id and stripe_price_mode." };
+        }
+        return { stripe_price_id: null, stripe_price_mode: null };
+    }
+    if (id === undefined || mode === undefined) {
+        return { error: "stripe_price_id and stripe_price_mode must be set together." };
+    }
+    return { stripe_price_id: id, stripe_price_mode: mode };
 }
 export function isStorefrontPlanError(value) {
     return value !== null && "error" in value;

package/dist/types.d.ts

@@ -71,9 +71,11 @@ export interface HostedStorefront {
         ocs_package_template_id: number;
         ocs_account_id: number | null;
         account_status: "owned" | "not_owned" | "unset" | "unknown";
+        stripe_price_id?: string | null;
+        stripe_price_mode?: "test" | "live" | null;
     }>;
 }
-export type StorefrontPlanUpdateParams = Pick<StorefrontPlanParams, "price_cents" | "active" | "ocs_account_id"> & {
+export type StorefrontPlanUpdateParams = Pick<StorefrontPlanParams, "price_cents" | "active" | "ocs_account_id" | "stripe_price_id" | "stripe_price_mode"> & {
     sort_order?: number;
 };
 export interface StorefrontPlanParams {
@@ -91,6 +93,10 @@ export interface StorefrontPlanParams {
     validity_days?: number;
     regions?: string[];
     active?: boolean;
+    /** Existing Stripe Price id (`price_…`), stored, not yet charged. Null clears the id and the mode. Set together with stripe_price_mode. */
+    stripe_price_id?: string | null;
+    /** `test` or `live`. Null clears the id and the mode. Set together with stripe_price_id. */
+    stripe_price_mode?: "test" | "live" | null;
 }
 export interface StorefrontCreateParams {
     slug: string;

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 /** Published version. Keep this equal to package.json. */
-export declare const SDK_VERSION = "0.2.13";
-export declare const USER_AGENT = "@carrierllc/sdk/0.2.13";
+export declare const SDK_VERSION = "0.2.15";
+export declare const USER_AGENT = "@carrierllc/sdk/0.2.15";

package/dist/version.js

@@ -1,3 +1,3 @@
 /** Published version. Keep this equal to package.json. */
-export const SDK_VERSION = "0.2.13";
+export const SDK_VERSION = "0.2.15";
 export const USER_AGENT = `@carrierllc/sdk/${SDK_VERSION}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carrierllc/sdk",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "description": "TypeScript client for the Carrier API, MCP server, and CLI.",
   "license": "MIT",
   "type": "module",