@carrierllc/mcp 0.2.16 → 0.2.17

package/templates/storefront/src/vendor/carrier/client.ts

@@ -0,0 +1,95 @@
+/**
+ * Carrier API client stub.
+ * Set NEXT_PUBLIC_CARRIER_API_URL to point at a live Carrier API.
+ * When absent, all methods return mock data so the storefront builds without credentials.
+ */
+import type { SkuTemplate } from "./types";
+
+const MOCK_TEMPLATES: SkuTemplate[] = [
+  {
+    id: "visit-calm",
+    name: "Visit — Calm",
+    description: "Perfect for short trips. Light browsing & maps.",
+    dataGb: 3,
+    validityDays: 7,
+    price_cents: 499,
+    currency: "EUR",
+    regions: ["Europe"],
+    features: ["3 GB data", "7 days validity", "40+ countries", "Throttled after limit"],
+  },
+  {
+    id: "visit-cruise",
+    name: "Visit — Cruise",
+    description: "Comfortable speed for a week away.",
+    dataGb: 10,
+    validityDays: 7,
+    price_cents: 799,
+    currency: "EUR",
+    regions: ["Europe"],
+    features: ["10 GB data", "7 days validity", "40+ countries", "1 Mbps after limit"],
+  },
+  {
+    id: "nomad-calm",
+    name: "Nomad — Calm",
+    description: "Long-term coverage for slow travellers.",
+    dataGb: 30,
+    validityDays: 30,
+    price_cents: 1999,
+    currency: "EUR",
+    regions: ["Global"],
+    features: ["30 GB data", "30 days validity", "120+ countries", "Throttled after limit"],
+  },
+  {
+    id: "nomad-cruise",
+    name: "Nomad — Cruise",
+    description: "30 days of comfortable global data.",
+    dataGb: 50,
+    validityDays: 30,
+    price_cents: 2499,
+    currency: "EUR",
+    regions: ["Global"],
+    features: ["50 GB data", "30 days validity", "120+ countries", "1 Mbps after limit"],
+  },
+  {
+    id: "schengen-cruise",
+    name: "Schengen Loop — Cruise",
+    description: "Schengen zone coverage for multi-country trips.",
+    dataGb: 20,
+    validityDays: 14,
+    price_cents: 1499,
+    currency: "EUR",
+    regions: ["Schengen"],
+    features: ["20 GB data", "14 days validity", "26 Schengen countries", "1 Mbps after limit"],
+  },
+];
+
+const API_BASE = process.env.NEXT_PUBLIC_CARRIER_API_URL ?? "";
+
+export async function fetchTemplates(): Promise<SkuTemplate[]> {
+  if (!API_BASE) return MOCK_TEMPLATES;
+  try {
+    const res = await fetch(`${API_BASE}/api/templates`, { next: { revalidate: 3600 } });
+    if (!res.ok) return MOCK_TEMPLATES;
+    return (await res.json()) as SkuTemplate[];
+  } catch {
+    return MOCK_TEMPLATES;
+  }
+}
+
+export async function createCheckoutSession(
+  templateId: string,
+  userId: string,
+): Promise<{ url: string } | null> {
+  if (!API_BASE) return null;
+  try {
+    const res = await fetch(`${API_BASE}/api/checkout`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", Authorization: `Bearer ${userId}` },
+      body: JSON.stringify({ templateId }),
+    });
+    if (!res.ok) return null;
+    return (await res.json()) as { url: string };
+  } catch {
+    return null;
+  }
+}

package/templates/storefront/src/vendor/carrier/index.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export * from "./client";

package/templates/storefront/src/vendor/carrier/types.ts

@@ -0,0 +1,21 @@
+export type ICCID = string & { __brand: "ICCID" };
+export type TemplateId = string;
+
+export interface SkuTemplate {
+  id: TemplateId;
+  name: string;
+  description: string;
+  dataGb: number;
+  validityDays: number;
+  price_cents: number;
+  currency: string;
+  regions: string[];
+  features: string[];
+}
+
+export interface ProvisionEsimResult {
+  iccid: ICCID;
+  qrCode: string;
+  activationUrl: string;
+  expiresAt: string;
+}

package/templates/storefront/src/vendor/config/index.ts

@@ -0,0 +1,2 @@
+// Carrier brand tokens (re-exported from brand.config for convenience)
+export { default as brand } from "@/brand.config";

package/templates/storefront/src/vendor/geo/index.ts

@@ -0,0 +1,32 @@
+export function getCountryName(iso: string, locale = "en"): string {
+  try {
+    const dn = new Intl.DisplayNames([locale], { type: "region" });
+    return dn.of(iso.toUpperCase()) ?? iso;
+  } catch {
+    return iso;
+  }
+}
+
+export function formatPrice(cents: number, currency = "EUR", locale = "en"): string {
+  try {
+    return new Intl.NumberFormat(locale, {
+      style: "currency",
+      currency,
+      minimumFractionDigits: 2,
+    }).format(cents / 100);
+  } catch {
+    return `${currency} ${(cents / 100).toFixed(2)}`;
+  }
+}
+
+export type DisplayCurrency = "EUR" | "USD" | "GBP";
+
+export const SUPPORTED_CURRENCIES: DisplayCurrency[] = ["EUR", "USD", "GBP"];
+
+export function getDisplayCurrency(countryIso: string): DisplayCurrency {
+  const map: Record<string, DisplayCurrency> = {
+    US: "USD",
+    GB: "GBP",
+  };
+  return map[countryIso.toUpperCase()] ?? "EUR";
+}

package/templates/storefront/src/vendor/ui/brand.ts

@@ -0,0 +1,68 @@
+import brand from "@/brand.config";
+
+/**
+ * BRAND constants — driven by brand.config.ts (white-label driven).
+ */
+export const BRAND = {
+  name: brand.name,
+  legalName: brand.legalName,
+  tagline: brand.tagline,
+  description: `Unlimited data in 200+ countries. Instant QR activation. Real support.`,
+  domain: brand.domain,
+  support: {
+    email: brand.supportEmail,
+    whatsapp: brand.supportWhatsapp,
+    sms: brand.supportWhatsapp,
+    statusUrl: brand.supportUrl,
+    hoursLocal: "16h/day · Mon-Sun · EU + Americas + Asia-Pac",
+    responseTimeMinutes: 5,
+  },
+  social: brand.social,
+} as const;
+
+export const GRADIENTS = {
+  hero: "bg-gradient-to-br from-[#FF7A45] via-[#FF6B35] to-[#D9461C]",
+  heroText: "bg-gradient-to-br from-[#FF6B35] to-[#D9461C] bg-clip-text text-transparent",
+  card: "bg-gradient-to-br from-[#0F1422] to-[#1F2638]",
+  glow: "bg-gradient-to-r from-[#FF6B35]/30 via-[#FF6B35]/40 to-[#FFB088]/30",
+} as const;
+
+export type SupportChannel = "whatsapp" | "sms" | "email";
+
+export interface SupportLinkContext {
+  message?: string;
+  orderId?: string;
+  iccid?: string;
+  skuName?: string;
+  subject?: string;
+}
+
+export function buildSupportLink(
+  channel: SupportChannel,
+  context: SupportLinkContext = {},
+): string {
+  const parts: string[] = [];
+  if (context.message?.trim()) parts.push(context.message.trim());
+  if (context.orderId) parts.push(`Order: ${context.orderId}`);
+  if (context.iccid) parts.push(`ICCID: ${context.iccid}`);
+  if (context.skuName) parts.push(`Plan: ${context.skuName}`);
+  const body = parts.join("\n");
+
+  if (channel === "whatsapp") {
+    const digits = BRAND.support.whatsapp.replace(/\D/g, "");
+    return body
+      ? `https://wa.me/${digits}?text=${encodeURIComponent(body)}`
+      : `https://wa.me/${digits}`;
+  }
+
+  if (channel === "sms") {
+    return body
+      ? `sms:${BRAND.support.sms}?&body=${encodeURIComponent(body)}`
+      : `sms:${BRAND.support.sms}`;
+  }
+
+  const subject = context.subject?.trim() || `${BRAND.name} support`;
+  const qs = new URLSearchParams({ subject });
+  if (body) qs.set("body", body);
+  return `mailto:${BRAND.support.email}?${qs.toString()}`;
+}

package/templates/storefront/src/vendor/ui/cn.ts

@@ -0,0 +1,7 @@
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+/** Class-name combiner with Tailwind-merge dedup. */
+export function cn(...inputs: ClassValue[]): string {
+  return twMerge(clsx(inputs));
+}

package/templates/storefront/src/vendor/ui/countryImagery.ts

@@ -0,0 +1,46 @@
+export type CountryImage = {
+  url: string;
+  thumbUrl: string;
+  blurhash: string;
+};
+
+function ix(id: string, blurhash: string): CountryImage {
+  const base = `https://images.unsplash.com/${id}`;
+  return {
+    url: `${base}?w=1080&q=70&auto=format&fit=crop`,
+    thumbUrl: `${base}?w=480&q=60&auto=format&fit=crop`,
+    blurhash,
+  };
+}
+
+const FALLBACK: CountryImage = ix(
+  "photo-1500835556837-99ac94a94552",
+  "LJG]bjxu0Lt600WB_3M{0LWBxujt",
+);
+
+const CATALOG: Readonly<Record<string, CountryImage>> = {
+  FR: ix("photo-1502602898657-3e91760cbb34", "LCC@b800WB00j[~qof?bj[00of-;j["),
+  DE: ix("photo-1467269204594-9661b134dd2b", "LEC@$$Rj00j[~qof?bWB00j[?bj["),
+  IT: ix("photo-1531572753322-ad063cecc140", "LFC@b800WB00j[~qof?bj[00of-;j["),
+  ES: ix("photo-1543783207-ec64e4d95325", "LBE3KAj]00WB~qj[?bWB00WB-;j["),
+  GB: ix("photo-1513635269975-59663e0ac1ad", "LCE.~WM{00WB~qof?bj[00j[-;j["),
+  JP: ix("photo-1492571350019-22de08371fd3", "LDD]bjxu00j[~qWB?bof00j[%MWB"),
+  US: ix("photo-1485871981521-5b1fd3805eee", "LCD]bjxu00j[~qWB?bof00j[%MWB"),
+  AU: ix("photo-1506973035872-a4ec16b8e8d9", "LEE.~xRj00WB~qof?bof00WB-;j["),
+  SG: ix("photo-1525625293386-3f8f99389edd", "LFC@b800WB00j[~qof?bj[00of-;j["),
+  AE: ix("photo-1512453979798-5ea266f8880c", "LEE.~xRj00WB~qof?bof00WB-;j["),
+  TH: ix("photo-1528181304800-259b08848526", "LFE.~xRj00j[~qof?bj[00j[-;j["),
+  IN: ix("photo-1524492412937-b28074a5d7da", "LEE.~xRj00WB~qof?bof00WB-;j["),
+  BR: ix("photo-1483729558449-99ef09a8c325", "LFE.~xRj00j[~qof?bj[00j[-;j["),
+  CA: ix("photo-1503614472-8c93d56e92ce", "LBE.~Wf600M{~qof?bWB00j[-;of"),
+  MX: ix("photo-1518105779142-d975f22f1b0a", "LFC@b800WB00j[~qof?bj[00of-;j["),
+  NL: ix("photo-1534351590666-13e3e96c5017", "LCE.~Wf6IUM{_3xu%2Rj4mM{xuM{"),
+  PT: ix("photo-1555881400-74d7acaacd8b", "LFE.~xRj00j[~qof?bj[00j[-;j["),
+  GR: ix("photo-1530841377377-3ff06c0ca713", "LFE.~xRj00j[~qof?bj[00j[-;j["),
+};
+
+export function imageForIso(iso: string): CountryImage {
+  return CATALOG[iso.toUpperCase()] ?? FALLBACK;
+}
+
+export const FALLBACK_COUNTRY_IMAGE = FALLBACK;

package/templates/storefront/src/vendor/ui/index.ts

@@ -0,0 +1,3 @@
+export * from "./cn";
+export * from "./brand";
+export * from "./countryImagery";

package/templates/storefront/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "Bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/storefront/wrangler.jsonc

@@ -0,0 +1,11 @@
+{
+  "$schema": "node_modules/wrangler/config-schema.json",
+  "main": ".open-next/worker.js",
+  "name": "storefront",
+  "compatibility_date": "2025-05-01",
+  "compatibility_flags": ["nodejs_compat"],
+  "assets": {
+    "directory": ".open-next/assets",
+    "binding": "ASSETS"
+  }
+}