@carrierllc/sdk 0.2.4 → 0.2.6

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.4` 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.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.

package/dist/data/cli.json

@@ -1698,6 +1698,45 @@
     "restPath": "/v1/onboarding/complete",
     "options": []
   },
+  {
+    "invocation": "carrier affiliate status",
+    "domain": "affiliate",
+    "summary": "Read-only: returns the affiliate profile, referral code, link, counts, money owed and paid, and Connect payouts status for the authenticated operator.",
+    "write": false,
+    "transport": "mcp",
+    "tool": "affiliate_status",
+    "restMethod": null,
+    "restPath": null,
+    "options": []
+  },
+  {
+    "invocation": "carrier affiliate commissions",
+    "domain": "affiliate",
+    "summary": "Read-only: returns the list of commission records for the authenticated operator.",
+    "write": false,
+    "transport": "mcp",
+    "tool": "affiliate_commissions",
+    "restMethod": null,
+    "restPath": null,
+    "options": [
+      {
+        "flags": "--limit <n>",
+        "description": "Maximum number of commission records to return (1-200, default: 50). Default 50.",
+        "required": false
+      }
+    ]
+  },
+  {
+    "invocation": "carrier affiliate join",
+    "domain": "affiliate",
+    "summary": "Join the Carrier affiliate program and generate a personal referral code and link.",
+    "write": false,
+    "transport": "mcp",
+    "tool": "affiliate_join",
+    "restMethod": null,
+    "restPath": null,
+    "options": []
+  },
   {
     "invocation": "carrier billing events",
     "domain": "billing",

package/dist/data/operations.json

@@ -1339,6 +1339,63 @@
     "queryParams": [],
     "headerParams": []
   },
+  {
+    "id": "affiliates_me_get",
+    "method": "GET",
+    "path": "/v1/affiliates/me",
+    "tag": "Affiliates",
+    "summary": "Get this org's affiliate link, referral count, earnings and payout status",
+    "security": "bearer",
+    "body": false,
+    "bodyRequired": false,
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": []
+  },
+  {
+    "id": "affiliates_me_create",
+    "method": "POST",
+    "path": "/v1/affiliates/me",
+    "tag": "Affiliates",
+    "summary": "Join the affiliate programme (idempotent: returns the existing code)",
+    "security": "bearer",
+    "body": false,
+    "bodyRequired": false,
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": []
+  },
+  {
+    "id": "affiliates_me_commissions_list",
+    "method": "GET",
+    "path": "/v1/affiliates/me/commissions",
+    "tag": "Affiliates",
+    "summary": "List commissions for this org, newest period first",
+    "security": "bearer",
+    "body": false,
+    "bodyRequired": false,
+    "pathParams": [],
+    "queryParams": [
+      {
+        "name": "limit",
+        "required": false
+      }
+    ],
+    "headerParams": []
+  },
+  {
+    "id": "affiliates_link",
+    "method": "POST",
+    "path": "/v1/affiliates/link",
+    "tag": "Affiliates",
+    "summary": "Attach a referral code to an organization created less than 30 minutes ago (browser sign-up only)",
+    "security": "bearer",
+    "body": true,
+    "bodyRequired": true,
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": []
+  },
   {
     "id": "operator_identity_status",
     "method": "GET",
@@ -2705,6 +2762,28 @@
     "queryParams": [],
     "headerParams": []
   },
+  {
+    "id": "update_storefront_plan",
+    "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.",
+    "security": "bearer",
+    "body": true,
+    "bodyRequired": true,
+    "pathParams": [
+      {
+        "name": "id",
+        "required": true
+      },
+      {
+        "name": "slug",
+        "required": true
+      }
+    ],
+    "queryParams": [],
+    "headerParams": []
+  },
   {
     "id": "health_check",
     "method": "GET",

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" | "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" | "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" | "rollback_storefront_order" | "get_hosted_storefront" | "list_storefronts" | "create_storefront" | "get_storefront" | "update_storefront" | "upsert_storefront_plan" | "update_storefront_plan" | "health_check";

package/dist/storefront-labels.d.ts

@@ -40,6 +40,8 @@ export declare function parseCountryInput(raw: string): {
     ok: false;
     message: string;
 };
+/** Upper bound for regions on one plan: every ISO 3166-1 region code (~249). */
+export declare const MAX_REGIONS_PER_PLAN = 250;
 /** Turns a small picture file into the data URL the shop stores. */
 export declare function logoFileDataUrl(bytes: Uint8Array): {
     ok: true;

package/dist/storefront-labels.js

@@ -63,7 +63,8 @@ export function parseCountryInput(raw) {
         if (!added)
             return { ok: false, message: "Countries are names, such as France, or codes such as FR." };
         for (const code of added) {
-            if (regions.length >= 40)
+            // A plan can span the whole world: cap at every ISO region code (~249).
+            if (regions.length >= MAX_REGIONS_PER_PLAN)
                 break;
             if (!regions.includes(code))
                 regions.push(code);
@@ -71,6 +72,8 @@ export function parseCountryInput(raw) {
     }
     return { ok: true, regions };
 }
+/** Upper bound for regions on one plan: every ISO 3166-1 region code (~249). */
+export const MAX_REGIONS_PER_PLAN = 250;
 function parseAmount(raw, unit, message, max, whole) {
     const text = raw.trim().replace(unit, "").trim();
     if (text === "" || !/^\d+(\.\d+)?$/.test(text))

package/dist/storefront-write.d.ts

@@ -29,6 +29,8 @@ export interface StorefrontPlanInput {
     regions?: string[];
     description?: string;
     active?: boolean;
+    /** Display order on the storefront (ascending). Defaults to 0; ties fall back to slug. */
+    sortOrder?: number;
 }
 export interface ExistingStorefrontBrand {
     theme?: Record<string, unknown>;
@@ -47,6 +49,7 @@ export interface StorefrontPlanBody {
     regions?: string[];
     description?: string;
     active?: boolean;
+    sort_order?: number;
 }
 export declare function storefrontBrandPatch(input: StorefrontBrandInput, existing?: ExistingStorefrontBrand): {
     theme?: Record<string, unknown>;

package/dist/storefront-write.js

@@ -41,6 +41,7 @@ export function completePlanInput(input, plans) {
         input.regions,
         input.description,
         input.active,
+        input.sortOrder,
     ].some((value) => value !== undefined);
     if (!touched)
         return input;
@@ -74,6 +75,8 @@ export function storefrontPlanBody(input) {
             body.price_cents = input.priceCents;
         if (input.active !== undefined)
             body.active = input.active;
+        if (input.sortOrder !== undefined)
+            body.sort_order = input.sortOrder;
         return body;
     }
     const touched = [
@@ -88,6 +91,7 @@ export function storefrontPlanBody(input) {
         input.regions,
         input.description,
         input.active,
+        input.sortOrder,
     ].some((value) => value !== undefined);
     if (!touched)
         return null;
@@ -120,6 +124,8 @@ export function storefrontPlanBody(input) {
         body.description = input.description;
     if (input.active !== undefined)
         body.active = input.active;
+    if (input.sortOrder !== undefined)
+        body.sort_order = input.sortOrder;
     return body;
 }
 export function isStorefrontPlanError(value) {

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

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