@carrierllc/sdk 0.2.2 → 0.2.3

package/README.md

@@ -35,4 +35,4 @@ const agentTools = restTools(carrier)
 
 `new Mcp(token, { auth: "bearer" })` sends an OAuth access token or a Clerk organization API key. The default sends `?TOKEN=` to `https://mcp.carrier.llc/mcp`. `Cli` never invokes a shell. Catalog entries marked `internal` do not accept a customer API key.
 
-`npm install @carrierllc/sdk@0.2.2` installs this surface. `0.1.0` only creates connectivity intents and products. The published tarball is the compiled `dist` output, including the generated operation catalog.
+`npm install @carrierllc/sdk@0.2.3` installs this surface. `0.1.0` only creates connectivity intents and products. The published tarball is the compiled `dist` output, including the generated operation catalog.

package/dist/storefront-labels.d.ts

@@ -9,7 +9,21 @@ export type LabelResult = {
     ok: false;
     message: string;
 };
-export declare function parseDataGb(raw: string): LabelResult;
+/**
+ * `unlimited` is always explicit, never inferred later from a bare 0.
+ * A caller reading only `value` and forgetting to check `unlimited` gets a
+ * finite 0, which every downstream consumer treats as "no data" and rejects
+ * or hides, not as "unlimited" — the failure mode is loud, not silent.
+ */
+export type DataGbResult = {
+    ok: true;
+    value: number;
+    unlimited: boolean;
+} | {
+    ok: false;
+    message: string;
+};
+export declare function parseDataGb(raw: string): DataGbResult;
 export declare function parseValidityDays(raw: string): LabelResult;
 /** Stripe minor units. Yen is already the minor unit, so 1000 JPY stays 1000. */
 export declare function majorToCents(input: string, currency?: string): {

package/dist/storefront-labels.js

@@ -21,8 +21,11 @@ NAME_TO_CODE.set("uk", "GB");
 const CODE_ALIASES = { UK: "GB" };
 export function parseDataGb(raw) {
     if (raw.trim().toLowerCase() === "unlimited")
-        return { ok: true, value: 0 };
-    return parseAmount(raw, /gigabytes?|gbs?|gb/gi, "Enter data like 1, 1 GB, or Unlimited.", 10_000, false);
+        return { ok: true, value: 0, unlimited: true };
+    const parsed = parseAmount(raw, /gigabytes?|gbs?|gb/gi, "Enter data like 1, 1 GB, or Unlimited.", 10_000, false);
+    if (!parsed.ok)
+        return parsed;
+    return { ok: true, value: parsed.value, unlimited: false };
 }
 export function parseValidityDays(raw) {
     return parseAmount(raw, /days?/gi, "Enter validity like 7 or 7 days.", 3650, true);

package/dist/storefront-write.d.ts

@@ -23,6 +23,8 @@ export interface StorefrontPlanInput {
     currency?: string;
     templateId?: number;
     dataGb?: number;
+    /** The only way a plan becomes unlimited. A 0 or missing dataGb without this stays finite. */
+    unlimited?: boolean;
     validityDays?: number;
     regions?: string[];
     description?: string;
@@ -40,6 +42,7 @@ export interface StorefrontPlanBody {
     currency?: string;
     ocs_package_template_id?: number;
     data_gb?: number;
+    unlimited?: boolean;
     validity_days?: number;
     regions?: string[];
     description?: string;

package/dist/storefront-write.js

@@ -36,6 +36,7 @@ export function completePlanInput(input, plans) {
         input.currency,
         input.templateId,
         input.dataGb,
+        input.unlimited,
         input.validityDays,
         input.regions,
         input.description,
@@ -82,6 +83,7 @@ export function storefrontPlanBody(input) {
         input.currency,
         input.templateId,
         input.dataGb,
+        input.unlimited,
         input.validityDays,
         input.regions,
         input.description,
@@ -92,6 +94,13 @@ export function storefrontPlanBody(input) {
     if (!input.slug || !input.name || input.priceCents === undefined || !input.currency || input.templateId === undefined) {
         return { error: "A plan needs a slug, name, price in minor units, currency, and OCS template id." };
     }
+    // A missing or zero dataGb never means unlimited on its own: that reading is
+    // exactly the bug a forgotten field falls into. `unlimited: true` is the
+    // only way in. A caller that means "unlimited" and sends 0 without the flag
+    // gets a loud rejection, not a silently unlimited plan.
+    if (input.dataGb !== undefined && input.dataGb <= 0 && input.unlimited !== true) {
+        return { error: "data_gb of 0 is refused. Send unlimited: true to sell an unlimited plan." };
+    }
     const body = {
         slug: input.slug,
         name: input.name,
@@ -101,6 +110,8 @@ export function storefrontPlanBody(input) {
     };
     if (input.dataGb !== undefined)
         body.data_gb = input.dataGb;
+    if (input.unlimited !== undefined)
+        body.unlimited = input.unlimited;
     if (input.validityDays !== undefined)
         body.validity_days = input.validityDays;
     if (input.regions !== undefined)

package/dist/types.d.ts

@@ -9,6 +9,8 @@ export interface ConnectivityPlan {
     object: "connectivity.plan";
     name: string;
     data_mb: number;
+    /** True only when the plan is explicitly unlimited. A 0 or missing data_mb never implies this. */
+    unlimited: boolean;
     validity_days: number;
     countries: string[];
     livemode: boolean;
@@ -78,6 +80,8 @@ export interface StorefrontPlanParams {
     product_id?: string;
     description?: string;
     data_gb?: number;
+    /** The only way to sell an unlimited plan. A 0 or missing data_gb without this is refused. */
+    unlimited?: boolean;
     validity_days?: number;
     regions?: string[];
     active?: boolean;

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

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