@carrierllc/mcp 0.10.0 → 0.10.1

package/dist/{chunk-DUAENMJE.js → chunk-DP4ICKYF.js}

@@ -1792,7 +1792,7 @@ function storefrontScreen(input) {
 // package.json
 var package_default = {
   name: "@carrierllc/mcp",
-  version: "0.10.0",
+  version: "0.10.1",
   description: "Carrier MCP \u2014 natural-language control of MVNO/eSIM fleets via eSIMVault OCS. Stdio mode for direct integration with Claude Desktop, Cursor, Windsurf, and MCP-compatible clients. Ships the `carrier` CLI (plugin install + white-label eSIM storefront scaffold).",
   license: "MIT",
   author: "Carrier (Lifecycle Innovations Limited)",
@@ -1876,6 +1876,239 @@ var package_default = {
 // src/version.ts
 var CARRIER_VERSION = package_default.version;
 
+// ../../packages/ocs-client/dist/chunk-GTWOOFJA.js
+import { z } from "zod";
+var OCS_V1_METHODS = /* @__PURE__ */ new Set([
+  "getResellerInfo",
+  "listResellerAccount",
+  "listPrepaidPackageTemplate",
+  "listSubscriber",
+  "getSingleSubscriber",
+  "getSimProviderStatus",
+  "getSubscriberLocation",
+  "getSubscriberLocationByCellId",
+  "subscriberUsageOverPeriod",
+  "affectRecurringPackageToSubscriber",
+  "deleteSubscriberPackage",
+  "modifyAccountBalance",
+  "modifySubscriberBalance",
+  "modifySubscriberContactInfo",
+  "modifySubscriberMobilePlan",
+  "modifySubscriberSteeringList",
+  "modifySubscriberVoipPlan",
+  "modifySubscriberPrepaidPackageActivePeriod",
+  "modifySubscriberPrepaidPackageLimits",
+  "modifySubscriberPrepaidPackageStatus",
+  "modifyPPTCore",
+  "modifyPPTRecurring",
+  "createPrepaidPackageTemplate",
+  "createLocationZone",
+  "changeNetworkProfileOfLocationZone",
+  "hlrGetBitrate",
+  "hlrSetBitrate",
+  "listSponsor",
+  "listDestinationListPrefix",
+  "listDetailedLocationZone",
+  "listLocationZoneElement",
+  "listSubscriberVoipTariff",
+  "listVoipTariffRule",
+  "affectSubscriberFakePhoneNumber",
+  "affectSubscriberRealPhoneNumber",
+  "getCustomerTariff",
+  "resetSubsGzCounter",
+  "sendMtSms"
+]);
+var OcsResponseEnvelope = z.object({
+  status: z.object({
+    code: z.number(),
+    // Required to match the `OcsStatus` interface in client.ts ({ code, msg }).
+    msg: z.string()
+  }).passthrough()
+}).passthrough();
+var GetResellerInfoResponse = z.object({
+  id: z.number(),
+  name: z.string(),
+  parentId: z.number(),
+  parentName: z.string(),
+  balance: z.number(),
+  cdrFolder: z.string().optional(),
+  trafficInfo: z.object({}).passthrough().optional(),
+  chargingInfo: z.object({}).passthrough().optional(),
+  contactInfo: z.object({}).passthrough().optional()
+}).passthrough();
+var ListResellerAccountResponse = z.object({
+  reseller: z.array(
+    z.object({
+      id: z.number(),
+      name: z.string(),
+      account: z.array(z.object({}).passthrough())
+    }).passthrough()
+  )
+}).passthrough();
+var ListPrepaidPackageTemplateResponse = z.object({
+  template: z.array(
+    z.object({
+      prepaidpackagetemplateid: z.number(),
+      prepaidpackagetemplatename: z.string(),
+      resellerid: z.number(),
+      locationzoneid: z.number()
+    }).passthrough()
+  )
+}).passthrough();
+var SubscriberStatusName = z.string().regex(/^[A-Za-z]/, "subscriber status must be a non-empty alpha-leading name");
+var GetSingleSubscriberResponse = z.object({
+  status: z.array(
+    z.object({
+      status: SubscriberStatusName
+    }).passthrough()
+  ).min(1, "getSingleSubscriber.status must be a non-empty array")
+}).passthrough();
+var RESPONSE_SCHEMAS = {
+  getResellerInfo: GetResellerInfoResponse,
+  listResellerAccount: ListResellerAccountResponse,
+  listPrepaidPackageTemplate: ListPrepaidPackageTemplateResponse,
+  getSingleSubscriber: GetSingleSubscriberResponse
+};
+var IccidParam = z.object({ iccid: z.string().min(1) });
+var AccountIdParam = z.object({ accountId: z.coerce.number().int().positive() });
+var PackageIdParam = z.object({ packageId: z.coerce.number().int().positive() });
+var TemplateIdParam = z.object({ templateId: z.coerce.number().int().positive() });
+var ResellerIdParam = z.object({ resellerId: z.coerce.number().int().positive() });
+var DateRangeBody = z.object({
+  start: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "must be YYYY-MM-DD"),
+  end: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "must be YYYY-MM-DD")
+});
+var ErrorResponse = z.object({
+  error: z.string(),
+  code: z.number().optional(),
+  retryAfter: z.number().optional()
+});
+var OkResponse = z.object({
+  ok: z.boolean(),
+  data: z.unknown().optional()
+});
+var ModifySubscriberStatusBody = z.object({
+  newStatus: z.enum(["active", "suspended", "deactivated"])
+});
+var ModifySubscriberBalanceBody = z.object({
+  amount: z.number().optional(),
+  setBalance: z.number().optional()
+}).refine((v) => v.amount !== void 0 || v.setBalance !== void 0, {
+  message: "Provide either amount (delta) or setBalance (absolute)"
+});
+var ModifySubscriberContactInfoBody = z.object({
+  name: z.string().optional(),
+  mail: z.string().email().optional(),
+  phone: z.string().optional()
+});
+var SetTrafficRestrictionsBody = z.object({
+  blockData: z.boolean().optional(),
+  blockVoice: z.boolean().optional(),
+  blockSms: z.boolean().optional(),
+  blockRoaming: z.boolean().optional()
+});
+var ModifySteeringListBody = z.object({
+  steeringListId: z.number().int().positive()
+});
+var HlrSetBitrateBody = z.object({
+  limit: z.number().int().positive()
+});
+var AssignPackageBody = z.object({
+  packageTemplateId: z.number().int().positive(),
+  startDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional()
+});
+var AssignRecurringPackageBody = z.object({
+  packageTemplateId: z.number().int().positive()
+});
+var ModifyPackageLimitsBody = z.object({
+  dataLimitMb: z.number().positive().optional(),
+  voiceLimitMin: z.number().nonnegative().optional(),
+  smsLimit: z.number().nonnegative().optional()
+});
+var ModifyPackageExpiryBody = z.object({
+  expiryDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/)
+});
+var ModifyPackageStatusBody = z.object({
+  status: z.enum(["active", "paused"])
+});
+var StopResumeRecurringBody = z.object({
+  action: z.enum(["stop", "resume"])
+});
+var CreatePackageTemplateBody = z.object({
+  name: z.string().min(1),
+  dataLimitMb: z.number().positive(),
+  validityDays: z.number().int().positive(),
+  price: z.number().nonnegative().optional(),
+  recurring: z.boolean().optional()
+});
+var ModifyTemplateCoreBody = z.object({
+  name: z.string().optional(),
+  dataLimitMb: z.number().positive().optional(),
+  validityDays: z.number().int().positive().optional()
+});
+var ModifyTemplateRecurringBody = z.object({
+  billingCycleDays: z.number().int().positive().optional(),
+  autoRenew: z.boolean().optional()
+});
+var ModifyTemplateThrottlingBody = z.object({
+  throttleSpeedKbps: z.number().int().nonnegative()
+});
+var ModifyAccountBalanceBody = z.object({
+  amount: z.number(),
+  mode: z.enum(["add", "subtract", "set"]).default("add")
+});
+var MoveSubscribersBody = z.object({
+  fromAccountId: z.number().int().positive(),
+  iccidStart: z.string().min(1),
+  iccidEnd: z.string().min(1)
+});
+var CreateLocationZoneBody = z.object({
+  name: z.string().min(1),
+  countries: z.array(z.string().length(2)).min(1)
+});
+var SendSmsBody = z.object({
+  text: z.string().min(1).max(160),
+  senderId: z.string().optional()
+});
+var ChangeSimStatusBody = z.object({
+  newStatus: z.enum(["Enable", "Disable"])
+});
+var DiagnoseSubscriberBody = z.object({
+  iccid: z.string().min(1)
+});
+var FleetHealthQuery = z.object({
+  accountId: z.coerce.number().int().positive().optional()
+});
+var ChurnRiskQuery = z.object({
+  daysSinceUsage: z.coerce.number().int().positive().default(14),
+  limit: z.coerce.number().int().positive().max(500).default(50)
+});
+var DetectUsageAnomaliesBody = z.object({
+  start: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+  end: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+  thresholdMultiplier: z.number().positive().default(2.5)
+});
+var OptimizePackageBody = z.object({
+  iccid: z.string().min(1)
+});
+var AuditNetworkCoverageBody = z.object({
+  locationZoneId: z.number().int().positive().optional()
+});
+var MarketingIntelligenceQuery = z.object({
+  segment: z.enum(["low_usage", "high_usage", "expiring_soon", "churned"]).optional()
+});
+var HighCostSubscribersQuery = z.object({
+  limit: z.coerce.number().int().positive().max(200).default(20),
+  start: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+  end: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional()
+});
+var WebhookEventBody = z.record(z.string(), z.unknown());
+var HealthResponse = z.object({
+  ok: z.literal(true),
+  version: z.string(),
+  build_sha: z.string()
+});
+
 // ../../packages/ocs-client/dist/chunk-CGMK4FTD.js
 var DEFAULT_OCS_BUDGET = {
   attemptMs: 3e4,
@@ -1982,7 +2215,45 @@ async function runWithBudget(method, attempt, budget = ocsBudgetFor(method)) {
   throw lastTimeout ?? new OcsTimeoutError(method, budget.attemptMs, budget.totalMs, Math.max(attempts, 1));
 }
 
-// ../../packages/ocs-client/dist/chunk-OPUTHPZF.js
+// ../../packages/ocs-client/dist/chunk-3DUJKSSY.js
+var RATE_LIMIT = 10;
+var WINDOW_MS = 1e3;
+var windows = /* @__PURE__ */ new Map();
+function getWindowState(key) {
+  let s = windows.get(key);
+  if (!s) {
+    s = { log: [], gate: Promise.resolve() };
+    windows.set(key, s);
+  }
+  return s;
+}
+async function acquireToken(resellerId) {
+  const proc = globalThis["process"];
+  if (proc?.env?.["RATE_FLOOR_DISABLED"] === "true" || globalThis["RATE_FLOOR_DISABLED"] === "true") {
+    return;
+  }
+  const state = getWindowState(resellerId);
+  const ticket = state.gate.then(async () => {
+    while (true) {
+      const now = Date.now();
+      if (state.log.length < RATE_LIMIT) {
+        state.log.push(now);
+        return;
+      }
+      const oldest = state.log[0];
+      const age = now - oldest;
+      if (age >= WINDOW_MS) {
+        state.log.shift();
+        state.log.push(now);
+        return;
+      }
+      const waitMs = WINDOW_MS - age + 1;
+      await new Promise((r) => setTimeout(r, waitMs));
+    }
+  });
+  state.gate = ticket;
+  return ticket;
+}
 var ENDPOINT_LIMITS_PER_MIN = {
   // Global sentinel (keyed as "__global__")
   __global__: 600,
@@ -2142,8 +2413,25 @@ function getRateLimitWindowCounts(resellerKey, endpoint) {
   }
   return { calls_in_window, batch_calls_in_window };
 }
+var OCS_BARE_INT_RESELLER_METHODS = [
+  "listSponsor",
+  "listSteeringList",
+  "listDetailedDestinationList",
+  "listDetailedLocationZone",
+  "getCustomerTariff"
+];
+var OCS_BARE_INT_OTHER_METHODS = {
+  listLocationZoneElement: "locationZoneId",
+  listDestinationListPrefix: "destinationListId",
+  listVoipTariffRule: "voipPlanId",
+  getSimProviderStatus: "simId",
+  deleteSubscriberPackage: "packageId"
+};
 var OCS_PARAM_RENAMES = {
-  getResellerInfo: { resellerId: "id" }
+  getResellerInfo: { resellerId: "id" },
+  modifyPPTCore: { templateId: "prepaidpackagetemplateid" },
+  modifyPPTRecurring: { templateId: "prepaidpackagetemplateid" },
+  modifyPPTThrottling: { templateId: "prepaidpackagetemplateid" }
 };
 function applyParamRenames(method, params) {
   const renames = OCS_PARAM_RENAMES[method];
@@ -2160,8 +2448,257 @@ function applyParamRenames(method, params) {
   }
   return out ?? params;
 }
+function isBareIntResellerMethod(method) {
+  return OCS_BARE_INT_RESELLER_METHODS.includes(method);
+}
+function isBareIntMethod(method) {
+  return isBareIntResellerMethod(method) || Object.prototype.hasOwnProperty.call(OCS_BARE_INT_OTHER_METHODS, method);
+}
+function bareIntIdName(method) {
+  if (isBareIntResellerMethod(method)) return "resellerId";
+  return OCS_BARE_INT_OTHER_METHODS[method] ?? "id";
+}
+function assertBareIntParam(method, params) {
+  if (!isBareIntMethod(method)) return;
+  if (typeof params === "number") return;
+  const shape = params === null ? "null" : Array.isArray(params) ? "array" : typeof params === "object" ? "object" : typeof params;
+  throw new TypeError(
+    `OCS method "${method}" takes a BARE INTEGER ${bareIntIdName(method)}, but received ${shape}. Sending an object makes OCS reject the whole request with "Cannot deserialize value of type java.lang.Integer from Object value", which surfaces in the UI as an empty panel. Pass the id itself, e.g. call("${method}", 1170).`
+  );
+}
+var OcsApiError = class extends Error {
+  constructor(code, message, method, details = {}) {
+    super(`[${method}] OCS error ${code}: ${message}`);
+    this.code = code;
+    this.method = method;
+    this.name = "OcsApiError";
+    this.details = details;
+  }
+  code;
+  method;
+  details;
+};
+var OcsUnknownMethodError = class extends Error {
+  constructor(method) {
+    super(
+      `[${method}] is not a known OCS v1 method. It is not in the verified set of ${OCS_V1_METHODS.size} methods (createAccount/createSubscriber do not exist on the OCS). If this is a genuinely new method, add it to OCS_V1_METHODS or construct the client without { strictMethods: true }.`
+    );
+    this.method = method;
+    this.name = "OcsUnknownMethodError";
+  }
+  method;
+};
+var OcsContractError = class _OcsContractError extends Error {
+  constructor(method, issues, payload) {
+    super(
+      `[${method}] OCS response failed contract validation: ${_OcsContractError.summarize(issues)}`
+    );
+    this.method = method;
+    this.issues = issues;
+    this.payload = payload;
+    this.name = "OcsContractError";
+  }
+  method;
+  issues;
+  payload;
+  /** One-line, human-readable join of the issues — for logs and the error message. */
+  get summary() {
+    return _OcsContractError.summarize(this.issues);
+  }
+  static summarize(issues) {
+    return issues.map((i) => `${i.path}: ${i.message}`).join("; ");
+  }
+};
+function ocsErrorMessage(code, rawMsg, rawBody) {
+  switch (code) {
+    case 12:
+      return {
+        message: "OCS resource is read-only (code 12). The package/subscriber/account state does not allow this mutation. Often returned for end-of-life subscribers or finalized invoices.",
+        details: {}
+      };
+    case 17:
+      return {
+        message: "Subscriber is end-of-life (code 17). It can no longer be mutated. Use modify_subscriber_status to revive before further changes.",
+        details: {}
+      };
+    default:
+      if (code >= 10001 && code <= 10004) {
+        const details = {};
+        if (rawBody["invalidTadigs"] !== void 0) {
+          details.invalidTadigs = rawBody["invalidTadigs"];
+        }
+        if (rawBody["existingLZ"] !== void 0) {
+          details.existingLZ = rawBody["existingLZ"];
+        }
+        return { message: rawMsg || "Location zone validation failed", details };
+      }
+      return { message: rawMsg || "Unknown error", details: {} };
+  }
+}
+var BACKOFF_BASE_MS2 = 500;
+var BACKOFF_MAX_MS = 4e3;
+var BACKOFF_MAX_RETRIES = 3;
+var BACKOFF_JITTER = 0.25;
+async function retryWithBackoff(fn) {
+  let lastError;
+  for (let attempt = 0; attempt <= BACKOFF_MAX_RETRIES; attempt++) {
+    if (attempt > 0) {
+      const base = Math.min(BACKOFF_BASE_MS2 * Math.pow(2, attempt - 1), BACKOFF_MAX_MS);
+      const jitter = base * BACKOFF_JITTER * (2 * Math.random() - 1);
+      const delay = Math.max(0, Math.round(base + jitter));
+      await new Promise((r) => setTimeout(r, delay));
+    }
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err;
+      if (err instanceof OcsApiError && err.code !== 100) {
+        throw err;
+      }
+      if (err instanceof OcsContractError) {
+        throw err;
+      }
+      if (err instanceof OcsTimeoutError) {
+        throw err;
+      }
+    }
+  }
+  throw lastError;
+}
+function isAbortError(err) {
+  return err instanceof Error && (err.name === "AbortError" || err.name === "TimeoutError" || /aborted|timed? ?out/i.test(err.message));
+}
+var OcsClient = class {
+  /**
+   * @param baseUrl        OCS base URL without trailing slash (e.g. https://ocs.esimvault.cloud).
+   * @param _defaultToken  Default API token; identifies the reseller for rate-floor keying.
+   * @param _priority      Call priority: "interactive" (MCP tool calls, 80% capacity) or
+   *                       "batch" (cron/poll callers, 20% capacity). Default: "interactive".
+   * @param options        Contract-enforcement opt-outs (see `OcsClientOptions`).
+   */
+  constructor(baseUrl, _defaultToken, _priority = "interactive", options = {}) {
+    this._defaultToken = _defaultToken;
+    this._priority = _priority;
+    let end = baseUrl.length;
+    while (end > 0 && baseUrl.charCodeAt(end - 1) === 47) end--;
+    this.baseUrl = baseUrl.slice(0, end);
+    this._strictMethods = options.strictMethods ?? false;
+    this._validateResponses = options.validateResponses ?? true;
+    this._strictValidation = options.strictValidation ?? false;
+  }
+  _defaultToken;
+  _priority;
+  baseUrl;
+  _strictMethods;
+  _validateResponses;
+  _strictValidation;
+  // Per-instance (NOT static): a static set would dedup across requests in a
+  // reused Worker isolate and silently swallow recurring contract-drift warnings.
+  _warnedMethods = /* @__PURE__ */ new Set();
+  _warnedValidation = /* @__PURE__ */ new Set();
+  async call(method, params = {}, token) {
+    if (!OCS_V1_METHODS.has(method)) {
+      if (this._strictMethods) throw new OcsUnknownMethodError(method);
+      if (!this._warnedMethods.has(method)) {
+        this._warnedMethods.add(method);
+        console.warn(
+          `[ocs-client] method "${method}" is not in the verified OCS v1 set \u2014 it may not exist on this OCS instance (see OCS_V1_METHODS).`
+        );
+      }
+    }
+    const tok = token ?? this._defaultToken;
+    if (!tok) {
+      throw new OcsApiError(-1, "No OCS API token provided", method);
+    }
+    const url = `${this.baseUrl}/v1?token=${tok}`;
+    assertBareIntParam(method, params);
+    const wireParams = applyParamRenames(method, params);
+    const body = JSON.stringify({ [method]: wireParams });
+    return retryWithBackoff(async () => {
+      await acquireToken(tok);
+      await acquireEndpointSlot(tok, method, this._priority);
+      return runWithBudget(method, async (signal, attemptMs) => {
+        let res;
+        try {
+          res = await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body,
+            signal
+          });
+        } catch (err) {
+          if (isAbortError(err)) {
+            throw new OcsTimeoutError(method, attemptMs);
+          }
+          throw err;
+        }
+        if (res.status >= 500) {
+          throw new Error(`HTTP ${res.status} ${res.statusText}`);
+        }
+        if (!res.ok) {
+          throw new OcsApiError(
+            res.status,
+            `HTTP ${res.status} ${res.statusText}`,
+            method
+          );
+        }
+        let json;
+        try {
+          json = await res.json();
+        } catch (err) {
+          if (isAbortError(err)) {
+            throw new OcsTimeoutError(method, attemptMs);
+          }
+          throw err;
+        }
+        if (json.status?.code !== 0) {
+          const ocsCode = json.status?.code ?? -1;
+          const rawMsg = json.status?.msg ?? "Unknown error";
+          const rawBody = json;
+          const { message, details } = ocsErrorMessage(ocsCode, rawMsg, rawBody);
+          throw new OcsApiError(ocsCode, message, method, details);
+        }
+        let payload;
+        if (method === "getCustomerTariff" && json["listTariffRule"] !== void 0) {
+          payload = json["listTariffRule"];
+        } else if (method === "getSubscriberLocationByCellId") {
+          const byMethod = json[method];
+          if (byMethod !== void 0) {
+            payload = byMethod;
+          } else if (json["subscriberLocation"] !== void 0) {
+            payload = json["subscriberLocation"];
+          } else {
+            payload = json[method] ?? json;
+          }
+        } else {
+          payload = json[method] ?? json;
+        }
+        if (this._validateResponses) {
+          const schema = RESPONSE_SCHEMAS[method];
+          if (schema) {
+            const parsed = schema.safeParse(payload);
+            if (!parsed.success) {
+              const issues = parsed.error.issues.map((i) => ({
+                path: i.path.join(".") || "<root>",
+                message: i.message
+              }));
+              if (this._strictValidation) {
+                throw new OcsContractError(method, issues, payload);
+              }
+              if (!this._warnedValidation.has(method)) {
+                this._warnedValidation.add(method);
+                console.warn(`[ocs-client] ${new OcsContractError(method, issues, payload).message}`);
+              }
+            }
+          }
+        }
+        return payload;
+      });
+    });
+  }
+};
 
-// ../../packages/ocs-client/dist/chunk-JWSVJVAF.js
+// ../../packages/ocs-client/dist/chunk-BBZNZIAA.js
 var OCS_MAX_USAGE_WINDOW_DAYS = 7;
 function clampUsagePeriod(start, end, maxDays = OCS_MAX_USAGE_WINDOW_DAYS) {
   const endMs = Date.parse(`${end}T00:00:00Z`);
@@ -2224,6 +2761,125 @@ function imsiFromSubscriberRecord(record) {
   }
   return void 0;
 }
+var OCS_PREPAID_PACKAGE_LIMIT_FIELDS = [
+  "dataByte",
+  "mocSecond",
+  "mtcSecond",
+  "moSms",
+  "mtSms"
+];
+var LIMIT_ALIASES = {
+  dataByte: "dataByte",
+  dataBytes: "dataByte",
+  dataLimit: "dataByte",
+  databyte: "dataByte",
+  mocSecond: "mocSecond",
+  mocSeconds: "mocSecond",
+  voiceOutLimit: "mocSecond",
+  mtcSecond: "mtcSecond",
+  mtcSeconds: "mtcSecond",
+  voiceInLimit: "mtcSecond",
+  moSms: "moSms",
+  moSmsNumber: "moSms",
+  smsOutLimit: "moSms",
+  mtSms: "mtSms",
+  mtSmsNumber: "mtSms",
+  smsInLimit: "mtSms"
+};
+function prepaidPackageLimits(limits) {
+  const out = {};
+  const unknown = [];
+  for (const [key, value] of Object.entries(limits)) {
+    const target = LIMIT_ALIASES[key];
+    if (!target) {
+      unknown.push(key);
+      continue;
+    }
+    out[target] = value;
+  }
+  if (unknown.length > 0) {
+    throw new Error(
+      `Unknown package limit field(s): ${unknown.join(", ")}. OCS accepts only ${OCS_PREPAID_PACKAGE_LIMIT_FIELDS.join(", ")} inside newLimits (aliases: ${Object.keys(LIMIT_ALIASES).join(", ")}).`
+    );
+  }
+  if (Object.keys(out).length === 0) {
+    throw new Error(
+      `No package limits to change. Provide at least one of ${OCS_PREPAID_PACKAGE_LIMIT_FIELDS.join(", ")}.`
+    );
+  }
+  return out;
+}
+function ocsLocalDateTime(value, bareDate = "end") {
+  const trimmed = value.trim();
+  if (/^\d{4}-\d{2}-\d{2}$/.test(trimmed)) {
+    return bareDate === "start" ? `${trimmed}T00:00:00` : `${trimmed}T23:59:59`;
+  }
+  if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$/.test(trimmed)) return `${trimmed}:00`;
+  if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/.test(trimmed)) {
+    return trimmed.replace(/(?:Z|[+-]\d{2}:?\d{2})$/, "").slice(0, 19);
+  }
+  throw new Error(
+    `"${value}" is not a date OCS can read. Use YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss \u2014 this field is a java.time.LocalDateTime and a zone offset is rejected.`
+  );
+}
+function activePeriodFromPackages(listResponse, packageId) {
+  const root = listResponse ?? {};
+  const payload = root.listSubscriberPrepaidPackages ?? root.data ?? root;
+  const packages = Array.isArray(payload?.packages) ? payload.packages : [];
+  for (const entry of packages) {
+    if (!entry || typeof entry !== "object") continue;
+    const rec = entry;
+    const id = rec.subscriberprepaidpackageid ?? rec.subscriberPrepaidPackageId;
+    if (Number(id) !== packageId) continue;
+    const activation = rec.tsactivationutc ?? rec.tsActivationUtc;
+    const expiration = rec.tsexpirationutc ?? rec.tsExpirationUtc;
+    const window = {};
+    if (typeof activation === "string" && activation) window.activation = activation;
+    if (typeof expiration === "string" && expiration) window.expiration = expiration;
+    return window;
+  }
+  return void 0;
+}
+var OCS_ACTIVE_PERIOD_DEFAULT_COMMENT = "Active period changed via Carrier";
+function packageActivePeriodParams(packageId, change) {
+  if (change.startDate === void 0 && change.endDate === void 0) {
+    throw new Error("Provide startDate and/or endDate to change a package's active period.");
+  }
+  const activation = change.startDate !== void 0 ? ocsLocalDateTime(change.startDate, "start") : change.current?.activation;
+  const expiration = change.endDate !== void 0 ? ocsLocalDateTime(change.endDate, "end") : change.current?.expiration;
+  for (const [field, value, omitted] of [
+    ["newActivationDateUtc", activation, "startDate"],
+    ["newExpirationDateUtc", expiration, "endDate"]
+  ]) {
+    if (value !== void 0) continue;
+    throw new Error(
+      `OCS requires both bounds on an active-period change and rejects the whole request with "Missing '${field}'" when one is absent. Supply ${omitted}, or read the package's current window first (activePeriodFromPackages) and pass it as \`current\`.`
+    );
+  }
+  return {
+    packageId,
+    // Already LocalDateTime-shaped when it came from `current`; normalising
+    // again is a no-op and keeps a hand-passed value honest.
+    newActivationDateUtc: ocsLocalDateTime(activation, "start"),
+    newExpirationDateUtc: ocsLocalDateTime(expiration, "end"),
+    comment: change.comment?.trim() || OCS_ACTIVE_PERIOD_DEFAULT_COMMENT
+  };
+}
+function recurringIdForPackage(listResponse, packageId) {
+  const root = listResponse ?? {};
+  const payload = root.listSubscriberPrepaidPackages ?? root.data ?? root;
+  const packages = Array.isArray(payload?.packages) ? payload.packages : [];
+  for (const entry of packages) {
+    if (!entry || typeof entry !== "object") continue;
+    const rec = entry;
+    const id = rec.subscriberprepaidpackageid ?? rec.subscriberPrepaidPackageId;
+    if (Number(id) !== packageId) continue;
+    const recurring = rec.recurringPackage ?? rec.recurringId;
+    const value = Number(recurring);
+    return Number.isFinite(value) && value > 0 ? value : void 0;
+  }
+  return void 0;
+}
 function emptyEsimStatusCounts() {
   return { active: 0, suspended: 0, inventory: 0, other: 0, total: 0 };
 }
@@ -2823,11 +3479,10 @@ async function generateStorefrontLogo(input) {
 }
 
 export {
-  runWithBudget,
-  acquireEndpointSlot,
   getLimitForEndpoint,
   getRateLimitWindowCounts,
-  applyParamRenames,
+  OcsApiError,
+  OcsClient,
   OCS_MAX_USAGE_WINDOW_DAYS,
   clampUsagePeriod,
   lastNDaysPeriod,
@@ -2837,6 +3492,11 @@ export {
   networkEventsOverPeriodParams,
   usageOverPeriodParams,
   imsiFromSubscriberRecord,
+  prepaidPackageLimits,
+  ocsLocalDateTime,
+  activePeriodFromPackages,
+  packageActivePeriodParams,
+  recurringIdForPackage,
   extractEsimStatusCounts,
   esimStatusPerAccountParams,
   normalizePackageTemplate,
@@ -2890,4 +3550,4 @@ export {
   storefrontScreen,
   CARRIER_VERSION
 };
-//# sourceMappingURL=chunk-DUAENMJE.js.map
+//# sourceMappingURL=chunk-DP4ICKYF.js.map