@carrierllc/sdk 0.2.14 → 0.2.16

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

@@ -14,6 +14,16 @@ export interface StorefrontBrandInput {
     tagline?: string;
     supportEmail?: string;
     legalName?: string;
+    address?: string;
+    locale?: "en" | "nl";
+    intro?: string;
+    ctaLabel?: string;
+    howHeading?: string;
+    plansHeading?: string;
+    buyLabel?: string;
+    emptyPlansText?: string;
+    searchHeading?: string;
+    searchPlaceholder?: string;
 }
 export interface StorefrontPlanInput {
     productId?: string;
@@ -32,6 +42,16 @@ export interface StorefrontPlanInput {
     active?: boolean;
     /** Display order on the storefront (ascending). Defaults to 0; ties fall back to slug. */
     sortOrder?: number;
+    /** Optional display section/group on the storefront. */
+    group?: string | null;
+    /** Optional ISO-8601 start timestamp from which the plan is visible. */
+    availableFrom?: string | null;
+    /** Optional ISO-8601 end timestamp until which the plan is visible. */
+    availableUntil?: string | null;
+    /** 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 +72,11 @@ export interface StorefrontPlanBody {
     description?: string;
     active?: boolean;
     sort_order?: number;
+    group?: string | null;
+    available_from?: string | null;
+    available_until?: string | null;
+    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"],
@@ -16,6 +18,16 @@ const COPY_FIELDS = [
     ["tagline", "tagline"],
     ["supportEmail", "supportEmail"],
     ["legalName", "legalName"],
+    ["address", "address"],
+    ["locale", "locale"],
+    ["intro", "intro"],
+    ["ctaLabel", "ctaLabel"],
+    ["howHeading", "howHeading"],
+    ["plansHeading", "plansHeading"],
+    ["buyLabel", "buyLabel"],
+    ["emptyPlansText", "emptyPlansText"],
+    ["searchHeading", "searchHeading"],
+    ["searchPlaceholder", "searchPlaceholder"],
 ];
 export function storefrontBrandPatch(input, existing) {
     const theme = overlay(existing?.theme, input, THEME_FIELDS);
@@ -43,6 +55,11 @@ export function completePlanInput(input, plans) {
         input.description,
         input.active,
         input.sortOrder,
+        input.group,
+        input.availableFrom,
+        input.availableUntil,
+        input.stripePriceId,
+        input.stripePriceMode,
     ].some((value) => value !== undefined);
     if (!touched)
         return input;
@@ -72,6 +89,12 @@ 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 windowFields = planWindowFields(input);
+    if (windowFields && "error" in windowFields)
+        return windowFields;
     const productId = input.productId?.trim() ?? "";
     if (productId !== "") {
         const body = { product_id: productId };
@@ -83,7 +106,7 @@ export function storefrontPlanBody(input) {
             body.active = input.active;
         if (input.sortOrder !== undefined)
             body.sort_order = input.sortOrder;
-        return body;
+        return { ...body, ...(windowFields ?? {}), ...(stripe ?? {}) };
     }
     const touched = [
         input.slug,
@@ -99,6 +122,11 @@ export function storefrontPlanBody(input) {
         input.description,
         input.active,
         input.sortOrder,
+        input.group,
+        input.availableFrom,
+        input.availableUntil,
+        input.stripePriceId,
+        input.stripePriceMode,
     ].some((value) => value !== undefined);
     if (!touched)
         return null;
@@ -135,7 +163,67 @@ export function storefrontPlanBody(input) {
         body.active = input.active;
     if (input.sortOrder !== undefined)
         body.sort_order = input.sortOrder;
-    return body;
+    return { ...body, ...(windowFields ?? {}), ...(stripe ?? {}) };
+}
+function planWindowFields(input) {
+    const out = {};
+    let touched = false;
+    if (input.group !== undefined) {
+        out.group = input.group === null || input.group.trim() === "" ? null : input.group.trim().slice(0, 80);
+        touched = true;
+    }
+    if (input.availableFrom !== undefined) {
+        if (input.availableFrom === null || input.availableFrom.trim() === "") {
+            out.available_from = null;
+        }
+        else {
+            const ms = Date.parse(input.availableFrom.trim());
+            if (!Number.isFinite(ms))
+                return { error: "available_from must be an ISO-8601 date or timestamp." };
+            out.available_from = new Date(ms).toISOString();
+        }
+        touched = true;
+    }
+    if (input.availableUntil !== undefined) {
+        if (input.availableUntil === null || input.availableUntil.trim() === "") {
+            out.available_until = null;
+        }
+        else {
+            const trimmed = input.availableUntil.trim();
+            const expanded = /^\d{4}-\d{2}-\d{2}$/.test(trimmed) ? `${trimmed}T23:59:59.999Z` : trimmed;
+            const ms = Date.parse(expanded);
+            if (!Number.isFinite(ms))
+                return { error: "available_until must be an ISO-8601 date or timestamp." };
+            out.available_until = new Date(ms).toISOString();
+        }
+        touched = true;
+    }
+    if (out.available_from && out.available_until && Date.parse(out.available_from) > Date.parse(out.available_until)) {
+        return { error: "available_from must not be after available_until." };
+    }
+    return touched ? out : undefined;
+}
+/** 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.14";
-export declare const USER_AGENT = "@carrierllc/sdk/0.2.14";
+export declare const SDK_VERSION = "0.2.16";
+export declare const USER_AGENT = "@carrierllc/sdk/0.2.16";

package/dist/version.js

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

package/package.json

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