@carrierllc/sdk 0.2.17 → 0.2.20

package/dist/client.js

@@ -82,7 +82,7 @@ export class Carrier {
         }
         let parsed;
         try {
-            parsed = issuance ? JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(await response.arrayBuffer())) : await readJson(response);
+            parsed = issuance ? JSON.parse(new TextDecoder("utf-8", { fatal: true, ignoreBOM: false }).decode(await response.arrayBuffer())) : await readJson(response);
         }
         catch (error) {
             if (issuance)

package/dist/data/operations.json

@@ -2184,6 +2184,287 @@
     "queryParams": [],
     "headerParams": []
   },
+  {
+    "id": "create_connectivity_offering",
+    "method": "POST",
+    "path": "/v1/connectivity/offerings",
+    "tag": "Connectivity",
+    "summary": "Save an incomplete connectivity offer",
+    "security": "bearer",
+    "body": true,
+    "bodyRequired": true,
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [
+      {
+        "name": "Idempotency-Key",
+        "required": true
+      }
+    ]
+  },
+  {
+    "id": "list_connectivity_offerings",
+    "method": "GET",
+    "path": "/v1/connectivity/offerings",
+    "tag": "Connectivity",
+    "summary": "List this organization's drafts",
+    "security": "bearer",
+    "body": false,
+    "bodyRequired": false,
+    "pathParams": [],
+    "queryParams": [
+      {
+        "name": "limit",
+        "required": false
+      },
+      {
+        "name": "after",
+        "required": false
+      }
+    ],
+    "headerParams": []
+  },
+  {
+    "id": "list_connectivity_offering_templates",
+    "method": "GET",
+    "path": "/v1/connectivity/offerings/templates",
+    "tag": "Connectivity",
+    "summary": "Choose a versioned connectivity concept starter",
+    "security": "bearer",
+    "body": false,
+    "bodyRequired": false,
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": []
+  },
+  {
+    "id": "create_connectivity_offering_from_template",
+    "method": "POST",
+    "path": "/v1/connectivity/offerings/from-template",
+    "tag": "Connectivity",
+    "summary": "Start a private draft from a selected template version",
+    "security": "bearer",
+    "body": true,
+    "bodyRequired": true,
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [
+      {
+        "name": "Idempotency-Key",
+        "required": true
+      }
+    ]
+  },
+  {
+    "id": "get_connectivity_offering_revision",
+    "method": "GET",
+    "path": "/v1/connectivity/offerings/{id}/revisions/{revision}",
+    "tag": "Connectivity",
+    "summary": "Read an immutable concept revision",
+    "security": "bearer",
+    "body": false,
+    "bodyRequired": false,
+    "pathParams": [
+      {
+        "name": "id",
+        "required": true
+      },
+      {
+        "name": "revision",
+        "required": true
+      }
+    ],
+    "queryParams": [],
+    "headerParams": []
+  },
+  {
+    "id": "validate_connectivity_offering_revision",
+    "method": "GET",
+    "path": "/v1/connectivity/offerings/{id}/revisions/{revision}/validation",
+    "tag": "Connectivity",
+    "summary": "Check which referenced products exist for this organization",
+    "security": "bearer",
+    "body": false,
+    "bodyRequired": false,
+    "pathParams": [
+      {
+        "name": "id",
+        "required": true
+      },
+      {
+        "name": "revision",
+        "required": true
+      }
+    ],
+    "queryParams": [],
+    "headerParams": []
+  },
+  {
+    "id": "get_connectivity_offering_template_source",
+    "method": "GET",
+    "path": "/v1/connectivity/offerings/{id}/template",
+    "tag": "Connectivity",
+    "summary": "Read the original starter setup and measurement suggestions",
+    "security": "bearer",
+    "body": false,
+    "bodyRequired": false,
+    "pathParams": [
+      {
+        "name": "id",
+        "required": true
+      }
+    ],
+    "queryParams": [],
+    "headerParams": []
+  },
+  {
+    "id": "duplicate_connectivity_offering",
+    "method": "POST",
+    "path": "/v1/connectivity/offerings/{id}/duplicate",
+    "tag": "Connectivity",
+    "summary": "Copy a selected revision into a new concept",
+    "security": "bearer",
+    "body": true,
+    "bodyRequired": true,
+    "pathParams": [
+      {
+        "name": "id",
+        "required": true
+      }
+    ],
+    "queryParams": [],
+    "headerParams": [
+      {
+        "name": "Idempotency-Key",
+        "required": true
+      }
+    ]
+  },
+  {
+    "id": "get_connectivity_offering",
+    "method": "GET",
+    "path": "/v1/connectivity/offerings/{id}",
+    "tag": "Connectivity",
+    "summary": "Read an offering draft",
+    "security": "bearer",
+    "body": false,
+    "bodyRequired": false,
+    "pathParams": [
+      {
+        "name": "id",
+        "required": true
+      }
+    ],
+    "queryParams": [],
+    "headerParams": []
+  },
+  {
+    "id": "update_connectivity_offering",
+    "method": "PATCH",
+    "path": "/v1/connectivity/offerings/{id}",
+    "tag": "Connectivity",
+    "summary": "Edit a draft with revision protection",
+    "security": "bearer",
+    "body": true,
+    "bodyRequired": true,
+    "pathParams": [
+      {
+        "name": "id",
+        "required": true
+      }
+    ],
+    "queryParams": [],
+    "headerParams": []
+  },
+  {
+    "id": "create_benefit_campaign",
+    "method": "POST",
+    "path": "/v1/connectivity/benefit-campaigns",
+    "tag": "Connectivity",
+    "summary": "Create a sponsored benefit campaign",
+    "security": "bearer",
+    "body": true,
+    "bodyRequired": true,
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": []
+  },
+  {
+    "id": "set_benefit_campaign_status",
+    "method": "POST",
+    "path": "/v1/connectivity/benefit-campaigns/{id}/status",
+    "tag": "Connectivity",
+    "summary": "Pause or resume a campaign",
+    "security": "bearer",
+    "body": true,
+    "bodyRequired": true,
+    "pathParams": [
+      {
+        "name": "id",
+        "required": true
+      }
+    ],
+    "queryParams": [],
+    "headerParams": []
+  },
+  {
+    "id": "claim_benefit",
+    "method": "POST",
+    "path": "/v1/connectivity/benefit-campaigns/{id}/claims",
+    "tag": "Connectivity",
+    "summary": "Reserve one sponsored claim",
+    "security": "bearer",
+    "body": true,
+    "bodyRequired": true,
+    "pathParams": [
+      {
+        "name": "id",
+        "required": true
+      }
+    ],
+    "queryParams": [],
+    "headerParams": []
+  },
+  {
+    "id": "record_experiment_event",
+    "method": "POST",
+    "path": "/v1/connectivity/experiment-events",
+    "tag": "Connectivity",
+    "summary": "Store one experiment event",
+    "security": "bearer",
+    "body": true,
+    "bodyRequired": true,
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": []
+  },
+  {
+    "id": "experiment_report",
+    "method": "GET",
+    "path": "/v1/connectivity/experiment-events/{experimentId}/report",
+    "tag": "Connectivity",
+    "summary": "Counts for one experiment",
+    "security": "bearer",
+    "body": false,
+    "bodyRequired": false,
+    "pathParams": [
+      {
+        "name": "experimentId",
+        "required": true
+      }
+    ],
+    "queryParams": [
+      {
+        "name": "from",
+        "required": true
+      },
+      {
+        "name": "to",
+        "required": true
+      }
+    ],
+    "headerParams": []
+  },
   {
     "id": "list_connectivity_products",
     "method": "GET",
@@ -2967,6 +3248,65 @@
     "queryParams": [],
     "headerParams": []
   },
+  {
+    "id": "publish_storefront",
+    "method": "POST",
+    "path": "/v1/storefronts/{id}/publish",
+    "tag": "Storefront",
+    "summary": "Publish a hosted storefront. The catalogue and published status commit in one write. Readiness is computed on the server.",
+    "security": "bearer",
+    "body": true,
+    "bodyRequired": true,
+    "pathParams": [
+      {
+        "name": "id",
+        "required": true
+      }
+    ],
+    "queryParams": [],
+    "headerParams": [
+      {
+        "name": "Idempotency-Key",
+        "required": true
+      }
+    ]
+  },
+  {
+    "id": "plan_storefront_publish",
+    "method": "POST",
+    "path": "/v1/storefronts/{id}/publish-plan",
+    "tag": "Storefront",
+    "summary": "Preview a publish. Reads the shop and returns readiness. Does not write the catalogue or call a probe.",
+    "security": "bearer",
+    "body": true,
+    "bodyRequired": true,
+    "pathParams": [
+      {
+        "name": "id",
+        "required": true
+      }
+    ],
+    "queryParams": [],
+    "headerParams": []
+  },
+  {
+    "id": "unpublish_storefront",
+    "method": "POST",
+    "path": "/v1/storefronts/{id}/unpublish",
+    "tag": "Storefront",
+    "summary": "Return a hosted storefront to draft. Orders, plans, the custom domain, and notification settings stay.",
+    "security": "bearer",
+    "body": true,
+    "bodyRequired": true,
+    "pathParams": [
+      {
+        "name": "id",
+        "required": true
+      }
+    ],
+    "queryParams": [],
+    "headerParams": []
+  },
   {
     "id": "health_check",
     "method": "GET",

package/dist/index.d.ts

@@ -7,5 +7,7 @@ export { DEFAULT_MCP_URL, Mcp, PROTOCOL_VERSION, type McpOptions } from "./mcp.j
 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 { normalizeStorefrontDomain } from "./storefront-domain.js";
+export { storefrontRequest, type StorefrontOperation, type StorefrontRequest, } from "./storefront-operations.js";
+export { isStorefrontPlanError, logoFileDataUrl, logoReference, majorToCents, parseCountryInput, parseDataGb, parseValidityDays, parseWholeNumber, completePlanInput, storefrontBrandPatch, storefrontNotificationPatch, storefrontPlanBody, hostedStorefrontUrl, storefrontSlugFrom, type ExistingStorefrontBrand, type StorefrontBrandInput, type StorefrontNotificationInput, type StorefrontPlanBody, type StorefrontPlanInput, type StoredPlanIdentity, } from "./storefront-write.js";
 export type { ConnectivityEsim, ConnectivityIntent, ConnectivityPlan, HostedStorefront, IdempotentRequest, IntentCreateParams, IntentStatus, PlanPrice, ProductCreateParams, StorefrontCreateParams, StorefrontPlanParams, StorefrontPlanUpdateParams, StorefrontUpdateParams, } from "./types.js";

package/dist/index.js

@@ -5,4 +5,6 @@ export { Carrier } from "./client.js";
 export { CarrierError } from "./error.js";
 export { DEFAULT_MCP_URL, Mcp, PROTOCOL_VERSION } from "./mcp.js";
 export { SDK_VERSION } from "./version.js";
-export { isStorefrontPlanError, logoFileDataUrl, logoReference, majorToCents, parseCountryInput, parseDataGb, parseValidityDays, parseWholeNumber, completePlanInput, storefrontBrandPatch, storefrontPlanBody, hostedStorefrontUrl, storefrontSlugFrom, } from "./storefront-write.js";
+export { normalizeStorefrontDomain } from "./storefront-domain.js";
+export { storefrontRequest, } from "./storefront-operations.js";
+export { isStorefrontPlanError, logoFileDataUrl, logoReference, majorToCents, parseCountryInput, parseDataGb, parseValidityDays, parseWholeNumber, completePlanInput, storefrontBrandPatch, storefrontNotificationPatch, storefrontPlanBody, hostedStorefrontUrl, storefrontSlugFrom, } from "./storefront-write.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_charges" | "operator_billing_get_balance" | "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_top_up_checkout" | "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";
+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_charges" | "operator_billing_get_balance" | "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" | "create_connectivity_offering" | "list_connectivity_offerings" | "list_connectivity_offering_templates" | "create_connectivity_offering_from_template" | "get_connectivity_offering_revision" | "validate_connectivity_offering_revision" | "get_connectivity_offering_template_source" | "duplicate_connectivity_offering" | "get_connectivity_offering" | "update_connectivity_offering" | "create_benefit_campaign" | "set_benefit_campaign_status" | "claim_benefit" | "record_experiment_event" | "experiment_report" | "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_top_up_checkout" | "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" | "publish_storefront" | "plan_storefront_publish" | "unpublish_storefront" | "health_check";

package/dist/storefront-domain.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Strict, shared storefront custom-domain validator (SDK = single source).
+ *
+ * Contract: the input must already be a literal ASCII hostname. Nothing is
+ * trimmed, decoded, stripped or otherwise repaired; anything else throws.
+ * Valid input is lowercased. Punycode (`xn--`) labels are accepted literally.
+ */
+export declare function normalizeStorefrontDomain(value: string): string;

package/dist/storefront-domain.js

@@ -0,0 +1,45 @@
+/**
+ * Strict, shared storefront custom-domain validator (SDK = single source).
+ *
+ * Contract: the input must already be a literal ASCII hostname. Nothing is
+ * trimmed, decoded, stripped or otherwise repaired; anything else throws.
+ * Valid input is lowercased. Punycode (`xn--`) labels are accepted literally.
+ */
+const LABEL = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
+const NUMERIC_TLD = /^(?:\d+|0x[0-9a-f]*)$/;
+const fail = (message) => {
+    throw new Error(message);
+};
+export function normalizeStorefrontDomain(value) {
+    if (typeof value !== "string")
+        return fail("Enter a hostname as text");
+    if (value === "")
+        return fail("Enter a hostname");
+    if (value !== value.trim() || /[\s\u0000-\u001f\u007f-\u009f]/.test(value)) {
+        return fail("Enter a literal hostname without spaces or control characters");
+    }
+    if (value.endsWith("."))
+        return fail("Enter a literal hostname without a trailing dot");
+    if (/[^\x21-\x7e]/.test(value)) {
+        return fail("Use a valid ASCII hostname; encode international names with IDNA first");
+    }
+    if (/[:/\\?#@*[\]%]/.test(value))
+        return fail("Enter a hostname, not a URL, port, IP literal or wildcard");
+    const host = value.toLowerCase();
+    if (host.length > 253)
+        return fail("Hostname is longer than 253 characters");
+    const labels = host.split(".");
+    if (labels.length < 2)
+        return fail("Enter a fully qualified hostname such as shop.example.com");
+    if (labels.some(label => !LABEL.test(label))) {
+        return fail("Use a valid ASCII hostname; encode international names with IDNA first");
+    }
+    if (NUMERIC_TLD.test(labels[labels.length - 1] ?? ""))
+        return fail("IP addresses cannot be attached as a customer domain");
+    if (host === "localhost" || host.endsWith(".localhost"))
+        return fail("This hostname cannot be attached as a customer domain");
+    if (host === "carrier.llc" || host.endsWith(".carrier.llc")) {
+        return fail("This hostname cannot be attached as a customer domain");
+    }
+    return host;
+}

package/dist/storefront-operations.d.ts

@@ -0,0 +1,32 @@
+export declare const STOREFRONT_OPERATIONS: {
+    readonly list_storefronts: readonly ["GET", "", "read"];
+    readonly get_storefront: readonly ["GET", "/{storefront_id}", "read"];
+    readonly create_storefront: readonly ["POST", "", "write"];
+    readonly update_storefront: readonly ["PATCH", "/{storefront_id}", "write"];
+    readonly upsert_storefront_plan: readonly ["POST", "/{storefront_id}/plans", "write"];
+    readonly update_storefront_plan: readonly ["PATCH", "/{storefront_id}/plans/{slug}", "write"];
+    readonly list_storefront_orders: readonly ["GET", "/orders", "read"];
+    readonly plan_storefront_publish: readonly ["POST", "/{storefront_id}/publish-plan", "read"];
+    readonly publish_storefront: readonly ["POST", "/{storefront_id}/publish", "write"];
+    readonly unpublish_storefront: readonly ["POST", "/{storefront_id}/unpublish", "write"];
+    readonly verify_storefront: readonly ["GET", "/{storefront_id}/readiness", "read"];
+    readonly list_storefront_domains: readonly ["GET", "/{storefront_id}/domains", "read"];
+    readonly plan_storefront_domain: readonly ["POST", "/{storefront_id}/domains/plan", "read"];
+    readonly attach_storefront_domain: readonly ["POST", "/{storefront_id}/domains", "write"];
+    readonly verify_storefront_domain: readonly ["POST", "/{storefront_id}/domains/{hostname}/verify", "write"];
+    readonly detach_storefront_domain: readonly ["DELETE", "/{storefront_id}/domains/{hostname}", "write"];
+    readonly plan_storefront_dns: readonly ["POST", "/{storefront_id}/domains/{hostname}/dns-plan", "read"];
+    readonly apply_storefront_dns: readonly ["POST", "/{storefront_id}/domains/{hostname}/dns", "write"];
+    readonly plan_storefront_generation: readonly ["POST", "/generation-plan", "read"];
+    readonly generate_storefront: readonly ["POST", "/generations", "write"];
+    readonly get_storefront_generation: readonly ["GET", "/generations/{job_id}", "read"];
+};
+export type StorefrontOperation = keyof typeof STOREFRONT_OPERATIONS;
+export type StorefrontRequest = {
+    method: "GET" | "POST" | "PATCH" | "DELETE";
+    path: string;
+    body?: Record<string, unknown>;
+    idempotencyKey?: string;
+    confirmToken?: string;
+};
+export declare function storefrontRequest(operation: StorefrontOperation, input: Record<string, unknown>): StorefrontRequest;

package/dist/storefront-operations.js

@@ -0,0 +1,102 @@
+// Portable Carrier storefront REST operation contracts.
+//
+// This table is routing only. It is not authorization and not validation:
+// the REST router stays authoritative. The builder never performs network
+// work and never follows a confirmation challenge on its own.
+export const STOREFRONT_OPERATIONS = {
+    list_storefronts: ["GET", "", "read"],
+    get_storefront: ["GET", "/{storefront_id}", "read"],
+    create_storefront: ["POST", "", "write"],
+    update_storefront: ["PATCH", "/{storefront_id}", "write"],
+    upsert_storefront_plan: ["POST", "/{storefront_id}/plans", "write"],
+    update_storefront_plan: ["PATCH", "/{storefront_id}/plans/{slug}", "write"],
+    list_storefront_orders: ["GET", "/orders", "read"],
+    plan_storefront_publish: ["POST", "/{storefront_id}/publish-plan", "read"],
+    publish_storefront: ["POST", "/{storefront_id}/publish", "write"],
+    unpublish_storefront: ["POST", "/{storefront_id}/unpublish", "write"],
+    verify_storefront: ["GET", "/{storefront_id}/readiness", "read"],
+    list_storefront_domains: ["GET", "/{storefront_id}/domains", "read"],
+    plan_storefront_domain: ["POST", "/{storefront_id}/domains/plan", "read"],
+    attach_storefront_domain: ["POST", "/{storefront_id}/domains", "write"],
+    verify_storefront_domain: ["POST", "/{storefront_id}/domains/{hostname}/verify", "write"],
+    detach_storefront_domain: ["DELETE", "/{storefront_id}/domains/{hostname}", "write"],
+    plan_storefront_dns: ["POST", "/{storefront_id}/domains/{hostname}/dns-plan", "read"],
+    apply_storefront_dns: ["POST", "/{storefront_id}/domains/{hostname}/dns", "write"],
+    plan_storefront_generation: ["POST", "/generation-plan", "read"],
+    generate_storefront: ["POST", "/generations", "write"],
+    get_storefront_generation: ["GET", "/generations/{job_id}", "read"],
+};
+const IDEMPOTENCY_REQUIRED = [
+    "create_storefront",
+    "publish_storefront",
+    "attach_storefront_domain",
+    "generate_storefront",
+];
+const MAX_METADATA_LENGTH = 200;
+const CONTROL_CHARACTERS = /[\u0000-\u001f\u007f]/;
+function metadataValue(name, value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string" || !value.trim() || value.length > MAX_METADATA_LENGTH) {
+        throw new Error(`${name} must be a non-empty string of at most ${MAX_METADATA_LENGTH} characters`);
+    }
+    if (CONTROL_CHARACTERS.test(value))
+        throw new Error(`${name} must not contain control characters`);
+    return value;
+}
+export function storefrontRequest(operation, input) {
+    if (!Object.hasOwn(STOREFRONT_OPERATIONS, operation)) {
+        throw new Error(`Unknown storefront operation: ${String(operation)}`);
+    }
+    if (input === null || typeof input !== "object" || Array.isArray(input)) {
+        throw new Error("input must be an object");
+    }
+    const [method, suffix] = STOREFRONT_OPERATIONS[operation];
+    const rest = { ...input };
+    if (IDEMPOTENCY_REQUIRED.includes(operation) &&
+        (typeof rest.idempotency_key !== "string" || !rest.idempotency_key.trim())) {
+        throw new Error("idempotency_key_required");
+    }
+    const path = `/v1/storefronts${suffix.replace(/\{(\w+)\}/g, (_match, key) => {
+        const value = rest[key];
+        if (typeof value !== "string" || value.length === 0)
+            throw new Error(`${key} is required`);
+        if (value === "." || value === "..")
+            throw new Error(`${key} must not be a dot segment`);
+        delete rest[key];
+        return encodeURIComponent(value);
+    })}`;
+    const idempotencyKey = metadataValue("idempotency_key", rest.idempotency_key);
+    const confirmToken = metadataValue("confirm_token", rest.confirm_token);
+    delete rest.idempotency_key;
+    delete rest.confirm_token;
+    if (method === "GET") {
+        if (confirmToken !== undefined || idempotencyKey !== undefined) {
+            throw new Error("Read requests do not accept mutation metadata");
+        }
+        const params = new URLSearchParams();
+        for (const key of Object.keys(rest).sort()) {
+            const value = rest[key];
+            if (value === undefined || value === null)
+                continue;
+            const valid = typeof value === "string" ||
+                typeof value === "boolean" ||
+                (typeof value === "number" && Number.isFinite(value));
+            if (!valid)
+                throw new Error(`${key} must be a scalar query value`);
+            params.set(key, String(value));
+        }
+        const query = params.toString();
+        return { method, path: query ? `${path}?${query}` : path };
+    }
+    if (method === "DELETE" && Object.values(rest).some(value => value !== undefined)) {
+        throw new Error("DELETE does not accept content fields");
+    }
+    return {
+        method,
+        path,
+        ...(method !== "DELETE" ? { body: rest } : {}),
+        ...(idempotencyKey !== undefined ? { idempotencyKey } : {}),
+        ...(confirmToken !== undefined ? { confirmToken } : {}),
+    };
+}

package/dist/storefront-write.d.ts

@@ -25,6 +25,11 @@ export interface StorefrontBrandInput {
     searchHeading?: string;
     searchPlaceholder?: string;
 }
+/** null clears a notification target; undefined leaves the saved value alone. */
+export interface StorefrontNotificationInput {
+    orderNotifyEmail?: string | null;
+    orderNotifyWebhookUrl?: string | null;
+}
 export interface StorefrontPlanInput {
     productId?: string;
     slug?: string;
@@ -82,6 +87,10 @@ export declare function storefrontBrandPatch(input: StorefrontBrandInput, existi
     theme?: Record<string, unknown>;
     copy?: Record<string, unknown>;
 };
+export declare function storefrontNotificationPatch(input: StorefrontNotificationInput): {
+    order_notify_email?: string | null;
+    order_notify_webhook_url?: string | null;
+};
 export interface StoredPlanIdentity {
     slug: string;
     name: string;

package/dist/storefront-write.js

@@ -37,6 +37,12 @@ export function storefrontBrandPatch(input, existing) {
         ...(copy ? { copy } : {}),
     };
 }
+export function storefrontNotificationPatch(input) {
+    return {
+        ...(input.orderNotifyEmail !== undefined ? { order_notify_email: input.orderNotifyEmail } : {}),
+        ...(input.orderNotifyWebhookUrl !== undefined ? { order_notify_webhook_url: input.orderNotifyWebhookUrl } : {}),
+    };
+}
 /** Fill slug, name, currency, and template id from a saved plan so a price change can omit them. */
 export function completePlanInput(input, plans) {
     if ((input.productId?.trim() ?? "") !== "")

package/dist/types.d.ts

@@ -64,6 +64,8 @@ export interface HostedStorefront {
     updated_at: number;
     theme?: Record<string, unknown>;
     copy?: Record<string, unknown>;
+    order_notify_email?: string | null;
+    order_notify_webhook_url?: string | null;
     plans?: Array<{
         slug: string;
         name: string;
@@ -104,6 +106,8 @@ export interface StorefrontCreateParams {
     status?: "draft" | "published";
     theme?: Record<string, unknown>;
     copy?: Record<string, unknown>;
+    order_notify_email?: string | null;
+    order_notify_webhook_url?: string | null;
 }
 export interface StorefrontUpdateParams {
     slug?: string;
@@ -111,4 +115,6 @@ export interface StorefrontUpdateParams {
     status?: "draft" | "published";
     theme?: Record<string, unknown>;
     copy?: Record<string, unknown>;
+    order_notify_email?: string | null;
+    order_notify_webhook_url?: string | null;
 }

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carrierllc/sdk",
-  "version": "0.2.17",
+  "version": "0.2.20",
   "description": "TypeScript client for the Carrier API, MCP server, and CLI.",
   "license": "MIT",
   "type": "module",
@@ -11,6 +11,14 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./storefront-domain": {
+      "types": "./dist/storefront-domain.d.ts",
+      "import": "./dist/storefront-domain.js"
+    },
+    "./storefront-operations": {
+      "types": "./dist/storefront-operations.d.ts",
+      "import": "./dist/storefront-operations.js"
+    },
     "./storefront-write": {
       "types": "./dist/storefront-write.d.ts",
       "import": "./dist/storefront-write.js"