@carrierllc/sdk 0.2.6 → 0.2.8

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.5` 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.6` 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/client.d.ts

@@ -7,7 +7,7 @@
  */
 import type { OperationId } from "./operation-ids.js";
 import { type CallParams } from "./operations.js";
-import type { ConnectivityIntent, ConnectivityPlan, HostedStorefront, IdempotentRequest, IntentCreateParams, ProductCreateParams, StorefrontCreateParams, StorefrontPlanParams, StorefrontUpdateParams } from "./types.js";
+import type { ConnectivityIntent, ConnectivityPlan, HostedStorefront, IdempotentRequest, IntentCreateParams, ProductCreateParams, StorefrontCreateParams, StorefrontPlanParams, StorefrontPlanUpdateParams, StorefrontUpdateParams } from "./types.js";
 export interface CarrierOptions {
     /** Defaults to https://api.carrier.llc. No trailing slash required. */
     baseUrl?: string;
@@ -33,6 +33,7 @@ export declare class Carrier {
         upsertPlan: (id: string, body: StorefrontPlanParams) => Promise<{
             slug: string;
         }>;
+        updatePlan: (id: string, slug: string, body: StorefrontPlanUpdateParams) => Promise<NonNullable<HostedStorefront["plans"]>[number]>;
     };
     constructor(apiKey: string, options?: CarrierOptions);
     /** Call any operation id from the public OpenAPI document. */

package/dist/client.js

@@ -34,6 +34,7 @@ export class Carrier {
             create: (body, request) => this.post("/v1/storefronts", body, request.idempotencyKey),
             update: (id, body) => this.request("PATCH", `/v1/storefronts/${encodeURIComponent(id)}`, { body }),
             upsertPlan: (id, body) => this.request("POST", `/v1/storefronts/${encodeURIComponent(id)}/plans`, { body }),
+            updatePlan: (id, slug, body) => this.request("PATCH", `/v1/storefronts/${encodeURIComponent(id)}/plans/${encodeURIComponent(slug)}`, { body }),
         };
     }
     /** Call any operation id from the public OpenAPI document. */

package/dist/data/operations.json

@@ -2618,6 +2618,75 @@
     ],
     "headerParams": []
   },
+  {
+    "id": "get_storefront_order_usage",
+    "method": "GET",
+    "path": "/api/orders/{orderId}/usage",
+    "tag": "Storefront",
+    "summary": "Data used by the order's own eSIM",
+    "security": "storefront",
+    "body": false,
+    "bodyRequired": false,
+    "pathParams": [
+      {
+        "name": "orderId",
+        "required": true
+      }
+    ],
+    "queryParams": [
+      {
+        "name": "storefront",
+        "required": false
+      }
+    ],
+    "headerParams": []
+  },
+  {
+    "id": "get_storefront_order_top_up_options",
+    "method": "GET",
+    "path": "/api/orders/{orderId}/top-up-options",
+    "tag": "Storefront",
+    "summary": "Plans the buyer can add to this order's eSIM",
+    "security": "storefront",
+    "body": false,
+    "bodyRequired": false,
+    "pathParams": [
+      {
+        "name": "orderId",
+        "required": true
+      }
+    ],
+    "queryParams": [
+      {
+        "name": "storefront",
+        "required": false
+      }
+    ],
+    "headerParams": []
+  },
+  {
+    "id": "cancel_storefront_order",
+    "method": "POST",
+    "path": "/api/orders/{orderId}/cancel",
+    "tag": "Storefront",
+    "summary": "Record the buyer's cancel",
+    "security": "storefront",
+    "body": false,
+    "bodyRequired": false,
+    "pathParams": [
+      {
+        "name": "orderId",
+        "required": true
+      }
+    ],
+    "queryParams": [
+      {
+        "name": "storefront",
+        "required": false
+      }
+    ],
+    "headerParams": []
+  },
   {
     "id": "get_storefront_order",
     "method": "GET",
@@ -2677,6 +2746,28 @@
     "queryParams": [],
     "headerParams": []
   },
+  {
+    "id": "get_hosted_storefront_plan_readiness",
+    "method": "GET",
+    "path": "/api/hosted/{slug}/plans/{planId}/readiness",
+    "tag": "Storefront",
+    "summary": "Read-only readiness check using the fulfilment owner's account rules",
+    "security": "public",
+    "body": false,
+    "bodyRequired": false,
+    "pathParams": [
+      {
+        "name": "slug",
+        "required": true
+      },
+      {
+        "name": "planId",
+        "required": true
+      }
+    ],
+    "queryParams": [],
+    "headerParams": []
+  },
   {
     "id": "list_storefronts",
     "method": "GET",
@@ -2708,6 +2799,32 @@
       }
     ]
   },
+  {
+    "id": "list_storefront_orders",
+    "method": "GET",
+    "path": "/v1/storefronts/orders",
+    "tag": "Storefront",
+    "summary": "List orders across the caller's storefronts, newest first. Metadata only — no ICCID, QR, or activation codes.",
+    "security": "bearer",
+    "body": false,
+    "bodyRequired": false,
+    "pathParams": [],
+    "queryParams": [
+      {
+        "name": "storefront_id",
+        "required": false
+      },
+      {
+        "name": "status",
+        "required": false
+      },
+      {
+        "name": "limit",
+        "required": false
+      }
+    ],
+    "headerParams": []
+  },
   {
     "id": "get_storefront",
     "method": "GET",

package/dist/index.d.ts

@@ -8,4 +8,4 @@ export type { OperationId } from "./operation-ids.js";
 export type { CallParams } from "./operations.js";
 export { SDK_VERSION } from "./version.js";
 export { isStorefrontPlanError, logoFileDataUrl, logoReference, majorToCents, parseCountryInput, parseDataGb, parseValidityDays, parseWholeNumber, completePlanInput, storefrontBrandPatch, storefrontPlanBody, hostedStorefrontUrl, storefrontSlugFrom, type ExistingStorefrontBrand, type StorefrontBrandInput, type StorefrontPlanBody, type StorefrontPlanInput, type StoredPlanIdentity, } from "./storefront-write.js";
-export type { ConnectivityEsim, ConnectivityIntent, ConnectivityPlan, HostedStorefront, IdempotentRequest, IntentCreateParams, IntentStatus, PlanPrice, ProductCreateParams, StorefrontCreateParams, StorefrontPlanParams, StorefrontUpdateParams, } from "./types.js";
+export type { ConnectivityEsim, ConnectivityIntent, ConnectivityPlan, HostedStorefront, IdempotentRequest, IntentCreateParams, IntentStatus, PlanPrice, ProductCreateParams, StorefrontCreateParams, StorefrontPlanParams, StorefrontPlanUpdateParams, StorefrontUpdateParams, } from "./types.js";

package/dist/operation-ids.d.ts

@@ -2,4 +2,4 @@
  *
  * Generated by sdks/generate.py. Do not edit by hand.
  */
-export type OperationId = "list_reseller_accounts" | "get_reseller_info" | "esim_status_per_account" | "list_sponsors" | "list_steering_lists" | "get_subscriber" | "list_subscribers" | "create_subscriber" | "get_sim_provider_status" | "change_sim_status" | "get_subscriber_location" | "hlr_get_bitrate" | "hlr_set_bitrate" | "list_subscriber_packages" | "assign_package" | "clean_all_packages" | "list_package_templates" | "create_package_template" | "list_location_zones" | "create_location_zone" | "list_detailed_location_zones" | "list_destination_prefixes" | "subscriber_usage" | "subscriber_network_events" | "subscriber_active_period" | "get_tariff" | "list_network_profiles" | "modify_subscriber_balance" | "modify_subscriber_status" | "modify_subscriber_contact_info" | "set_subscriber_traffic_restrictions" | "modify_subscriber_steering_list" | "move_subscriber_range_to_account" | "assign_recurring_package" | "modify_package_limits" | "modify_package_expiry" | "modify_package_status" | "stop_resume_recurring_package" | "modify_account_balance" | "delete_subscriber_package" | "modify_template_core" | "modify_template_recurring" | "modify_template_throttling" | "send_sms" | "fleet_health" | "churn_risk" | "audit_network_coverage" | "diagnose_subscriber" | "detect_usage_anomalies" | "optimize_package" | "marketing_intelligence" | "high_cost_subscribers" | "high_cost_subscribers_method_guard" | "detect_country_entry" | "list_intelligence_schedules" | "create_intelligence_schedule" | "delete_intelligence_schedule" | "run_intelligence_schedule" | "get_intelligence_schedule_report" | "get_intelligence_share" | "operator_billing_connect_begin" | "operator_billing_connect_oauth_begin" | "operator_billing_connect_oauth_complete" | "operator_billing_connect_status" | "operator_billing_connect_dashboard_link" | "operator_billing_list_payouts" | "operator_billing_create_manual_payout" | "operator_billing_get_payout_schedule" | "operator_billing_update_payout_schedule" | "operator_billing_list_fees" | "operator_billing_list_refunds" | "operator_billing_create_refund" | "operator_billing_list_disputes" | "operator_billing_submit_dispute_evidence" | "operator_billing_list_fraud_reviews" | "operator_billing_approve_fraud_review" | "operator_billing_decline_fraud_review" | "operator_billing_list_value_lists" | "operator_billing_add_value_list_item" | "affiliates_me_get" | "affiliates_me_create" | "affiliates_me_commissions_list" | "affiliates_link" | "operator_identity_status" | "operator_identity_create_session" | "operator_identity_update_session" | "operator_list_promotions" | "operator_create_promotion" | "signup_start" | "signup_verify" | "create_api_key" | "get_onboarding_state" | "onboarding_save_org" | "onboarding_connect_ocs_token" | "onboarding_start_managed_account" | "onboarding_save_plan" | "onboarding_skip_plan" | "onboarding_test_esim" | "onboarding_complete" | "operator_billing_stripe_webhook" | "receive_bridge4ip_webhook" | "affect_subscriber_phone_number" | "modify_subscriber_mobile_plan" | "modify_subscriber_voip_plan" | "push_steering_to_subscriber" | "modify_subscriber_package_active_period" | "get_subscriber_location_by_cell_id" | "reset_subscriber_gz_counter" | "list_destination_lists" | "list_subscriber_voip_tariff" | "list_voip_tariff_rule" | "change_network_profile_of_location_zone" | "get_network_default" | "set_network_default" | "plan_network_default" | "carrier_webhook_config" | "ai_chat" | "ai_insights" | "ai_quota" | "list_invoice_periods" | "get_billing_config" | "update_billing_config" | "stripe_connect_begin" | "stripe_connect_status" | "list_invoices" | "create_invoice" | "get_invoice" | "update_invoice" | "void_invoice" | "get_invoice_document" | "list_connectivity_plans" | "list_connectivity_products" | "create_connectivity_product" | "get_connectivity_product" | "list_connectivity_intents" | "create_connectivity_intent" | "get_connectivity_intent" | "confirm_connectivity_intent" | "create_connectivity_webhook_endpoint" | "list_connectivity_webhook_endpoints" | "delete_connectivity_webhook_endpoint" | "list_connectivity_events" | "get_connectivity_event" | "create_connectivity_usage_record" | "list_connectivity_usage_records" | "retry_connectivity_event" | "issue_esim_from_inventory" | "rollback_esim_issuance" | "subscriber_country_history" | "get_subscriber_notes" | "add_subscriber_note" | "put_subscriber_notes" | "observe_connectivity_event" | "ingest_connectivity_usage" | "ingest_cdr_events" | "aggregate_cdr" | "list_storefront_templates" | "list_storefront_buyer_orders" | "get_storefront_order" | "rollback_storefront_order" | "get_hosted_storefront" | "list_storefronts" | "create_storefront" | "get_storefront" | "update_storefront" | "upsert_storefront_plan" | "update_storefront_plan" | "health_check";
+export type OperationId = "list_reseller_accounts" | "get_reseller_info" | "esim_status_per_account" | "list_sponsors" | "list_steering_lists" | "get_subscriber" | "list_subscribers" | "create_subscriber" | "get_sim_provider_status" | "change_sim_status" | "get_subscriber_location" | "hlr_get_bitrate" | "hlr_set_bitrate" | "list_subscriber_packages" | "assign_package" | "clean_all_packages" | "list_package_templates" | "create_package_template" | "list_location_zones" | "create_location_zone" | "list_detailed_location_zones" | "list_destination_prefixes" | "subscriber_usage" | "subscriber_network_events" | "subscriber_active_period" | "get_tariff" | "list_network_profiles" | "modify_subscriber_balance" | "modify_subscriber_status" | "modify_subscriber_contact_info" | "set_subscriber_traffic_restrictions" | "modify_subscriber_steering_list" | "move_subscriber_range_to_account" | "assign_recurring_package" | "modify_package_limits" | "modify_package_expiry" | "modify_package_status" | "stop_resume_recurring_package" | "modify_account_balance" | "delete_subscriber_package" | "modify_template_core" | "modify_template_recurring" | "modify_template_throttling" | "send_sms" | "fleet_health" | "churn_risk" | "audit_network_coverage" | "diagnose_subscriber" | "detect_usage_anomalies" | "optimize_package" | "marketing_intelligence" | "high_cost_subscribers" | "high_cost_subscribers_method_guard" | "detect_country_entry" | "list_intelligence_schedules" | "create_intelligence_schedule" | "delete_intelligence_schedule" | "run_intelligence_schedule" | "get_intelligence_schedule_report" | "get_intelligence_share" | "operator_billing_connect_begin" | "operator_billing_connect_oauth_begin" | "operator_billing_connect_oauth_complete" | "operator_billing_connect_status" | "operator_billing_connect_dashboard_link" | "operator_billing_list_payouts" | "operator_billing_create_manual_payout" | "operator_billing_get_payout_schedule" | "operator_billing_update_payout_schedule" | "operator_billing_list_fees" | "operator_billing_list_refunds" | "operator_billing_create_refund" | "operator_billing_list_disputes" | "operator_billing_submit_dispute_evidence" | "operator_billing_list_fraud_reviews" | "operator_billing_approve_fraud_review" | "operator_billing_decline_fraud_review" | "operator_billing_list_value_lists" | "operator_billing_add_value_list_item" | "affiliates_me_get" | "affiliates_me_create" | "affiliates_me_commissions_list" | "affiliates_link" | "operator_identity_status" | "operator_identity_create_session" | "operator_identity_update_session" | "operator_list_promotions" | "operator_create_promotion" | "signup_start" | "signup_verify" | "create_api_key" | "get_onboarding_state" | "onboarding_save_org" | "onboarding_connect_ocs_token" | "onboarding_start_managed_account" | "onboarding_save_plan" | "onboarding_skip_plan" | "onboarding_test_esim" | "onboarding_complete" | "operator_billing_stripe_webhook" | "receive_bridge4ip_webhook" | "affect_subscriber_phone_number" | "modify_subscriber_mobile_plan" | "modify_subscriber_voip_plan" | "push_steering_to_subscriber" | "modify_subscriber_package_active_period" | "get_subscriber_location_by_cell_id" | "reset_subscriber_gz_counter" | "list_destination_lists" | "list_subscriber_voip_tariff" | "list_voip_tariff_rule" | "change_network_profile_of_location_zone" | "get_network_default" | "set_network_default" | "plan_network_default" | "carrier_webhook_config" | "ai_chat" | "ai_insights" | "ai_quota" | "list_invoice_periods" | "get_billing_config" | "update_billing_config" | "stripe_connect_begin" | "stripe_connect_status" | "list_invoices" | "create_invoice" | "get_invoice" | "update_invoice" | "void_invoice" | "get_invoice_document" | "list_connectivity_plans" | "list_connectivity_products" | "create_connectivity_product" | "get_connectivity_product" | "list_connectivity_intents" | "create_connectivity_intent" | "get_connectivity_intent" | "confirm_connectivity_intent" | "create_connectivity_webhook_endpoint" | "list_connectivity_webhook_endpoints" | "delete_connectivity_webhook_endpoint" | "list_connectivity_events" | "get_connectivity_event" | "create_connectivity_usage_record" | "list_connectivity_usage_records" | "retry_connectivity_event" | "issue_esim_from_inventory" | "rollback_esim_issuance" | "subscriber_country_history" | "get_subscriber_notes" | "add_subscriber_note" | "put_subscriber_notes" | "observe_connectivity_event" | "ingest_connectivity_usage" | "ingest_cdr_events" | "aggregate_cdr" | "list_storefront_templates" | "list_storefront_buyer_orders" | "get_storefront_order_usage" | "get_storefront_order_top_up_options" | "cancel_storefront_order" | "get_storefront_order" | "rollback_storefront_order" | "get_hosted_storefront" | "get_hosted_storefront_plan_readiness" | "list_storefronts" | "create_storefront" | "list_storefront_orders" | "get_storefront" | "update_storefront" | "upsert_storefront_plan" | "update_storefront_plan" | "health_check";

package/dist/storefront-write.d.ts

@@ -22,6 +22,7 @@ export interface StorefrontPlanInput {
     priceCents?: number;
     currency?: string;
     templateId?: number;
+    accountId?: number;
     dataGb?: number;
     /** The only way a plan becomes unlimited. A 0 or missing dataGb without this stays finite. */
     unlimited?: boolean;
@@ -43,6 +44,7 @@ export interface StorefrontPlanBody {
     price_cents?: number;
     currency?: string;
     ocs_package_template_id?: number;
+    ocs_account_id?: number;
     data_gb?: number;
     unlimited?: boolean;
     validity_days?: number;

package/dist/storefront-write.js

@@ -35,6 +35,7 @@ export function completePlanInput(input, plans) {
         input.priceCents,
         input.currency,
         input.templateId,
+        input.accountId,
         input.dataGb,
         input.unlimited,
         input.validityDays,
@@ -68,9 +69,14 @@ function sharedCurrency(plans) {
     return [...codes][0];
 }
 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 productId = input.productId?.trim() ?? "";
     if (productId !== "") {
         const body = { product_id: productId };
+        if (input.accountId !== undefined)
+            body.ocs_account_id = input.accountId;
         if (input.priceCents !== undefined)
             body.price_cents = input.priceCents;
         if (input.active !== undefined)
@@ -85,6 +91,7 @@ export function storefrontPlanBody(input) {
         input.priceCents,
         input.currency,
         input.templateId,
+        input.accountId,
         input.dataGb,
         input.unlimited,
         input.validityDays,
@@ -112,6 +119,8 @@ export function storefrontPlanBody(input) {
         currency: input.currency,
         ocs_package_template_id: input.templateId,
     };
+    if (input.accountId !== undefined)
+        body.ocs_account_id = input.accountId;
     if (input.dataGb !== undefined)
         body.data_gb = input.dataGb;
     if (input.unlimited !== undefined)

package/dist/types.d.ts

@@ -69,14 +69,20 @@ export interface HostedStorefront {
         name: string;
         currency: string;
         ocs_package_template_id: number;
+        ocs_account_id: number | null;
+        account_status: "owned" | "not_owned" | "unset" | "unknown";
     }>;
 }
+export type StorefrontPlanUpdateParams = Pick<StorefrontPlanParams, "price_cents" | "active" | "ocs_account_id"> & {
+    sort_order?: number;
+};
 export interface StorefrontPlanParams {
     slug?: string;
     name?: string;
     price_cents?: number;
     currency?: string;
     ocs_package_template_id?: number;
+    ocs_account_id?: number;
     product_id?: string;
     description?: string;
     data_gb?: number;

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

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