@flopay/node 1.4.3 → 1.4.4

package/dist/index.cjs

@@ -1,269 +1 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  FloPay: () => FloPay,
-  STRIPE_API_VERSION: () => STRIPE_API_VERSION
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/flopay-node.ts
-var import_stripe = __toESM(require("stripe"), 1);
-var import_shared = require("@flopay/shared");
-var STRIPE_API_VERSION = "2026-04-22.dahlia";
-var FloPay = class {
-  constructor(secretKey, options) {
-    if (!secretKey) {
-      throw new import_shared.FloPayError(
-        "A secret key is required to initialize the FloPay server SDK.",
-        "authentication_error"
-      );
-    }
-    this.stripe = new import_stripe.default(options?.stripeSecretKey ?? secretKey, {
-      apiVersion: options?.apiVersion ?? STRIPE_API_VERSION,
-      appInfo: {
-        name: "flopay-node",
-        version: import_shared.SDK_VERSION
-      }
-    });
-    this.checkout = {
-      sessions: {
-        create: this.createSession.bind(this),
-        retrieve: this.retrieveSession.bind(this),
-        expire: this.expireSession.bind(this),
-        listLineItems: this.listLineItems.bind(this)
-      }
-    };
-    this.webhooks = {
-      constructEvent: this.constructWebhookEvent.bind(this)
-    };
-    this.customers = {
-      create: this.createCustomer.bind(this),
-      retrieve: this.retrieveCustomer.bind(this),
-      update: this.updateCustomer.bind(this)
-    };
-  }
-  /**
-   * Create a checkout session via the billing API.
-   *
-   * Mirrors `createCheckoutSession` from `clicktech-core-ui/modules`.
-   * Posts to `{billingApiUrl}/v1/checkouts/sessions` and returns
-   * the session UUID for redirect.
-   */
-  async createSession(params) {
-    const {
-      billingApiUrl,
-      checkoutBaseUrl,
-      items = [],
-      subscriptions = [],
-      products,
-      account,
-      successUrl,
-      cancelUrl,
-      checkoutMode = "confirm",
-      couponCodes = [],
-      tagsData,
-      redirectParams = {},
-      timeoutMs = 12e3,
-      clientId,
-      currency,
-      utmMetadata
-    } = params;
-    const wireProducts = products ?? (0, import_shared.foldIntoProducts)(items, subscriptions);
-    const sessionCurrency = (0, import_shared.resolveSessionCurrency)(currency, items, subscriptions, wireProducts);
-    if (!sessionCurrency) {
-      throw new import_shared.FloPayError(
-        "currency is required: pass `currency` on the session, or include a `currency` on the first item/subscription/product.",
-        "validation_error",
-        { code: "CurrencyRequired", param: "currency" }
-      );
-    }
-    const payload = {
-      clientId,
-      checkoutVersion: import_shared.SDK_VERSION,
-      successUrl,
-      cancelUrl,
-      currency: sessionCurrency,
-      checkoutMode,
-      products: wireProducts.map((product) => (0, import_shared.buildProductPayload)(product, sessionCurrency)),
-      accountData: {
-        userId: account.userId,
-        firstName: account.firstName ?? null,
-        lastName: account.lastName ?? null,
-        email: account.email,
-        country: account.country ?? null,
-        gender: account.gender ?? null,
-        city: account.city ?? null,
-        state: account.state ?? null,
-        zip: account.zip ?? null
-      },
-      couponCodes
-    };
-    if (tagsData) {
-      payload["tagsData"] = tagsData;
-    }
-    if (utmMetadata?.length) {
-      payload["utmMetadata"] = utmMetadata;
-    }
-    const url = `${billingApiUrl.replace(/\/+$/, "")}/v1/checkouts/sessions`;
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    let status;
-    let body;
-    try {
-      const response = await fetch(url, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(payload),
-        signal: controller.signal
-      });
-      status = response.status;
-      try {
-        body = await response.json();
-      } catch {
-      }
-    } finally {
-      clearTimeout(timer);
-    }
-    if (status === 201) {
-      const uuid = body?.data?.uuid;
-      const nonce = body?.data?.nonce;
-      if (!uuid) {
-        throw new Error("Checkout session created but no UUID was returned by the billing API");
-      }
-      if (!nonce) {
-        throw new import_shared.FloPayError(
-          "Checkout session created but no `nonce` was returned by the billing API. Upgrade the billing service to TeamFloPay/backend#640 or later.",
-          "api_error",
-          { code: "MissingCheckoutSessionToken" }
-        );
-      }
-      const redirectUrl = new URL(`${checkoutBaseUrl.replace(/\/+$/, "")}/secure`);
-      redirectUrl.searchParams.set("id", uuid);
-      for (const [key, value] of Object.entries(redirectParams)) {
-        redirectUrl.searchParams.set(key, value);
-      }
-      return { status: 201, redirectUrl: redirectUrl.toString(), nonce };
-    }
-    if (status === 204) {
-      return { status: 204 };
-    }
-    return { status };
-  }
-  normalizeStripeSession(session) {
-    const statusMap = {
-      open: "open",
-      complete: "complete",
-      expired: "expired"
-    };
-    return {
-      id: session.id,
-      clientSecret: session.client_secret ?? "",
-      mode: session.mode,
-      status: statusMap[session.status ?? "open"] ?? "open",
-      amount: session.amount_total ?? 0,
-      currency: session.currency ?? "usd",
-      metadata: session.metadata ?? {}
-    };
-  }
-  async retrieveSession(id) {
-    const session = await this.stripe.checkout.sessions.retrieve(id);
-    return this.normalizeStripeSession(session);
-  }
-  async expireSession(id) {
-    const session = await this.stripe.checkout.sessions.expire(id);
-    return this.normalizeStripeSession(session);
-  }
-  async listLineItems(id) {
-    const items = await this.stripe.checkout.sessions.listLineItems(id);
-    return items.data.map((item) => ({
-      price: item.price?.id,
-      quantity: item.quantity ?? 1
-    }));
-  }
-  constructWebhookEvent(payload, signature, secret) {
-    const event = this.stripe.webhooks.constructEvent(payload, signature, secret);
-    return {
-      id: event.id,
-      type: event.type,
-      data: event.data,
-      created: event.created
-    };
-  }
-  async createCustomer(params) {
-    const customer = await this.stripe.customers.create({
-      email: params.email,
-      name: params.name,
-      metadata: params.metadata
-    });
-    return {
-      id: customer.id,
-      email: customer.email ?? params.email,
-      firstName: params.name?.split(" ")[0],
-      lastName: params.name?.split(" ").slice(1).join(" ")
-    };
-  }
-  async retrieveCustomer(id) {
-    const customer = await this.stripe.customers.retrieve(id);
-    if (customer.deleted) {
-      throw new import_shared.FloPayError(
-        `Customer ${id} has been deleted`,
-        "api_error",
-        { code: "resource_missing" }
-      );
-    }
-    return {
-      id: customer.id,
-      email: customer.email ?? "",
-      firstName: customer.name?.split(" ")[0],
-      lastName: customer.name?.split(" ").slice(1).join(" ")
-    };
-  }
-  async updateCustomer(id, params) {
-    const customer = await this.stripe.customers.update(id, {
-      email: params.email,
-      name: params.name,
-      metadata: params.metadata
-    });
-    return {
-      id: customer.id,
-      email: customer.email ?? "",
-      firstName: customer.name?.split(" ")[0],
-      lastName: customer.name?.split(" ").slice(1).join(" ")
-    };
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  FloPay,
-  STRIPE_API_VERSION
-});
-//# sourceMappingURL=index.cjs.map
+"use strict";var A=Object.create;var u=Object.defineProperty;var z=Object.getOwnPropertyDescriptor;var D=Object.getOwnPropertyNames;var F=Object.getPrototypeOf,M=Object.prototype.hasOwnProperty;var q=(s,e)=>{for(var t in e)u(s,t,{get:e[t],enumerable:!0})},b=(s,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of D(e))!M.call(s,o)&&o!==t&&u(s,o,{get:()=>e[o],enumerable:!(r=z(e,o))||r.enumerable});return s};var W=(s,e,t)=>(t=s!=null?A(F(s)):{},b(e||!s||!s.__esModule?u(t,"default",{value:s,enumerable:!0}):t,s)),$=s=>b(u({},"__esModule",{value:!0}),s);var B={};q(B,{FloPay:()=>m,STRIPE_API_VERSION:()=>y});module.exports=$(B);var v=W(require("stripe"),1),i=require("@flopay/shared"),y="2026-04-22.dahlia",m=class{constructor(e,t){if(!e)throw new i.FloPayError("A secret key is required to initialize the FloPay server SDK.","authentication_error");this.stripe=new v.default(t?.stripeSecretKey??e,{apiVersion:t?.apiVersion??y,appInfo:{name:"flopay-node",version:i.SDK_VERSION}}),this.checkout={sessions:{create:this.createSession.bind(this),retrieve:this.retrieveSession.bind(this),expire:this.expireSession.bind(this),listLineItems:this.listLineItems.bind(this)}},this.webhooks={constructEvent:this.constructWebhookEvent.bind(this)},this.customers={create:this.createCustomer.bind(this),retrieve:this.retrieveCustomer.bind(this),update:this.updateCustomer.bind(this)}}async createSession(e){let{billingApiUrl:t,checkoutBaseUrl:r,items:o=[],subscriptions:C=[],products:w,account:n,successUrl:I,cancelUrl:N,checkoutMode:E="confirm",couponCodes:R=[],tagsData:S,redirectParams:U={},timeoutMs:x=12e3,clientId:_,currency:L,utmMetadata:g}=e,P=w??(0,i.foldIntoProducts)(o,C),l=(0,i.resolveSessionCurrency)(L,o,C,P);if(!l)throw new i.FloPayError("currency is required: pass `currency` on the session, or include a `currency` on the first item/subscription/product.","validation_error",{code:"CurrencyRequired",param:"currency"});let d={clientId:_,checkoutVersion:i.SDK_VERSION,successUrl:I,cancelUrl:N,currency:l,checkoutMode:E,products:P.map(a=>(0,i.buildProductPayload)(a,l)),accountData:{userId:n.userId,firstName:n.firstName??null,lastName:n.lastName??null,email:n.email,country:n.country??null,gender:n.gender??null,city:n.city??null,state:n.state??null,zip:n.zip??null},couponCodes:R};S&&(d.tagsData=S),g?.length&&(d.utmMetadata=g);let O=`${t.replace(/\/+$/,"")}/v1/checkouts/sessions`,f=new AbortController,T=setTimeout(()=>f.abort(),x),c,p;try{let a=await fetch(O,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(d),signal:f.signal});c=a.status;try{p=await a.json()}catch{}}finally{clearTimeout(T)}if(c===201){let a=p?.data?.uuid,k=p?.data?.nonce;if(!a)throw new Error("Checkout session created but no UUID was returned by the billing API");if(!k)throw new i.FloPayError("Checkout session created but no `nonce` was returned by the billing API. Upgrade the billing service to TeamFloPay/backend#640 or later.","api_error",{code:"MissingCheckoutSessionToken"});let h=new URL(`${r.replace(/\/+$/,"")}/secure`);h.searchParams.set("id",a);for(let[V,j]of Object.entries(U))h.searchParams.set(V,j);return{status:201,redirectUrl:h.toString(),nonce:k}}return c===204?{status:204}:{status:c}}normalizeStripeSession(e){let t={open:"open",complete:"complete",expired:"expired"};return{id:e.id,clientSecret:e.client_secret??"",mode:e.mode,status:t[e.status??"open"]??"open",amount:e.amount_total??0,currency:e.currency??"usd",metadata:e.metadata??{}}}async retrieveSession(e){let t=await this.stripe.checkout.sessions.retrieve(e);return this.normalizeStripeSession(t)}async expireSession(e){let t=await this.stripe.checkout.sessions.expire(e);return this.normalizeStripeSession(t)}async listLineItems(e){return(await this.stripe.checkout.sessions.listLineItems(e)).data.map(r=>({price:r.price?.id,quantity:r.quantity??1}))}constructWebhookEvent(e,t,r){let o=this.stripe.webhooks.constructEvent(e,t,r);return{id:o.id,type:o.type,data:o.data,created:o.created}}async createCustomer(e){let t=await this.stripe.customers.create({email:e.email,name:e.name,metadata:e.metadata});return{id:t.id,email:t.email??e.email,firstName:e.name?.split(" ")[0],lastName:e.name?.split(" ").slice(1).join(" ")}}async retrieveCustomer(e){let t=await this.stripe.customers.retrieve(e);if(t.deleted)throw new i.FloPayError(`Customer ${e} has been deleted`,"api_error",{code:"resource_missing"});return{id:t.id,email:t.email??"",firstName:t.name?.split(" ")[0],lastName:t.name?.split(" ").slice(1).join(" ")}}async updateCustomer(e,t){let r=await this.stripe.customers.update(e,{email:t.email,name:t.name,metadata:t.metadata});return{id:r.id,email:r.email??"",firstName:r.name?.split(" ")[0],lastName:r.name?.split(" ").slice(1).join(" ")}}};0&&(module.exports={FloPay,STRIPE_API_VERSION});

package/dist/index.mjs

@@ -1,237 +1 @@
-// src/flopay-node.ts
-import Stripe from "stripe";
-import {
-  FloPayError,
-  SDK_VERSION,
-  buildProductPayload,
-  foldIntoProducts,
-  resolveSessionCurrency
-} from "@flopay/shared";
-var STRIPE_API_VERSION = "2026-04-22.dahlia";
-var FloPay = class {
-  constructor(secretKey, options) {
-    if (!secretKey) {
-      throw new FloPayError(
-        "A secret key is required to initialize the FloPay server SDK.",
-        "authentication_error"
-      );
-    }
-    this.stripe = new Stripe(options?.stripeSecretKey ?? secretKey, {
-      apiVersion: options?.apiVersion ?? STRIPE_API_VERSION,
-      appInfo: {
-        name: "flopay-node",
-        version: SDK_VERSION
-      }
-    });
-    this.checkout = {
-      sessions: {
-        create: this.createSession.bind(this),
-        retrieve: this.retrieveSession.bind(this),
-        expire: this.expireSession.bind(this),
-        listLineItems: this.listLineItems.bind(this)
-      }
-    };
-    this.webhooks = {
-      constructEvent: this.constructWebhookEvent.bind(this)
-    };
-    this.customers = {
-      create: this.createCustomer.bind(this),
-      retrieve: this.retrieveCustomer.bind(this),
-      update: this.updateCustomer.bind(this)
-    };
-  }
-  /**
-   * Create a checkout session via the billing API.
-   *
-   * Mirrors `createCheckoutSession` from `clicktech-core-ui/modules`.
-   * Posts to `{billingApiUrl}/v1/checkouts/sessions` and returns
-   * the session UUID for redirect.
-   */
-  async createSession(params) {
-    const {
-      billingApiUrl,
-      checkoutBaseUrl,
-      items = [],
-      subscriptions = [],
-      products,
-      account,
-      successUrl,
-      cancelUrl,
-      checkoutMode = "confirm",
-      couponCodes = [],
-      tagsData,
-      redirectParams = {},
-      timeoutMs = 12e3,
-      clientId,
-      currency,
-      utmMetadata
-    } = params;
-    const wireProducts = products ?? foldIntoProducts(items, subscriptions);
-    const sessionCurrency = resolveSessionCurrency(currency, items, subscriptions, wireProducts);
-    if (!sessionCurrency) {
-      throw new FloPayError(
-        "currency is required: pass `currency` on the session, or include a `currency` on the first item/subscription/product.",
-        "validation_error",
-        { code: "CurrencyRequired", param: "currency" }
-      );
-    }
-    const payload = {
-      clientId,
-      checkoutVersion: SDK_VERSION,
-      successUrl,
-      cancelUrl,
-      currency: sessionCurrency,
-      checkoutMode,
-      products: wireProducts.map((product) => buildProductPayload(product, sessionCurrency)),
-      accountData: {
-        userId: account.userId,
-        firstName: account.firstName ?? null,
-        lastName: account.lastName ?? null,
-        email: account.email,
-        country: account.country ?? null,
-        gender: account.gender ?? null,
-        city: account.city ?? null,
-        state: account.state ?? null,
-        zip: account.zip ?? null
-      },
-      couponCodes
-    };
-    if (tagsData) {
-      payload["tagsData"] = tagsData;
-    }
-    if (utmMetadata?.length) {
-      payload["utmMetadata"] = utmMetadata;
-    }
-    const url = `${billingApiUrl.replace(/\/+$/, "")}/v1/checkouts/sessions`;
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    let status;
-    let body;
-    try {
-      const response = await fetch(url, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(payload),
-        signal: controller.signal
-      });
-      status = response.status;
-      try {
-        body = await response.json();
-      } catch {
-      }
-    } finally {
-      clearTimeout(timer);
-    }
-    if (status === 201) {
-      const uuid = body?.data?.uuid;
-      const nonce = body?.data?.nonce;
-      if (!uuid) {
-        throw new Error("Checkout session created but no UUID was returned by the billing API");
-      }
-      if (!nonce) {
-        throw new FloPayError(
-          "Checkout session created but no `nonce` was returned by the billing API. Upgrade the billing service to TeamFloPay/backend#640 or later.",
-          "api_error",
-          { code: "MissingCheckoutSessionToken" }
-        );
-      }
-      const redirectUrl = new URL(`${checkoutBaseUrl.replace(/\/+$/, "")}/secure`);
-      redirectUrl.searchParams.set("id", uuid);
-      for (const [key, value] of Object.entries(redirectParams)) {
-        redirectUrl.searchParams.set(key, value);
-      }
-      return { status: 201, redirectUrl: redirectUrl.toString(), nonce };
-    }
-    if (status === 204) {
-      return { status: 204 };
-    }
-    return { status };
-  }
-  normalizeStripeSession(session) {
-    const statusMap = {
-      open: "open",
-      complete: "complete",
-      expired: "expired"
-    };
-    return {
-      id: session.id,
-      clientSecret: session.client_secret ?? "",
-      mode: session.mode,
-      status: statusMap[session.status ?? "open"] ?? "open",
-      amount: session.amount_total ?? 0,
-      currency: session.currency ?? "usd",
-      metadata: session.metadata ?? {}
-    };
-  }
-  async retrieveSession(id) {
-    const session = await this.stripe.checkout.sessions.retrieve(id);
-    return this.normalizeStripeSession(session);
-  }
-  async expireSession(id) {
-    const session = await this.stripe.checkout.sessions.expire(id);
-    return this.normalizeStripeSession(session);
-  }
-  async listLineItems(id) {
-    const items = await this.stripe.checkout.sessions.listLineItems(id);
-    return items.data.map((item) => ({
-      price: item.price?.id,
-      quantity: item.quantity ?? 1
-    }));
-  }
-  constructWebhookEvent(payload, signature, secret) {
-    const event = this.stripe.webhooks.constructEvent(payload, signature, secret);
-    return {
-      id: event.id,
-      type: event.type,
-      data: event.data,
-      created: event.created
-    };
-  }
-  async createCustomer(params) {
-    const customer = await this.stripe.customers.create({
-      email: params.email,
-      name: params.name,
-      metadata: params.metadata
-    });
-    return {
-      id: customer.id,
-      email: customer.email ?? params.email,
-      firstName: params.name?.split(" ")[0],
-      lastName: params.name?.split(" ").slice(1).join(" ")
-    };
-  }
-  async retrieveCustomer(id) {
-    const customer = await this.stripe.customers.retrieve(id);
-    if (customer.deleted) {
-      throw new FloPayError(
-        `Customer ${id} has been deleted`,
-        "api_error",
-        { code: "resource_missing" }
-      );
-    }
-    return {
-      id: customer.id,
-      email: customer.email ?? "",
-      firstName: customer.name?.split(" ")[0],
-      lastName: customer.name?.split(" ").slice(1).join(" ")
-    };
-  }
-  async updateCustomer(id, params) {
-    const customer = await this.stripe.customers.update(id, {
-      email: params.email,
-      name: params.name,
-      metadata: params.metadata
-    });
-    return {
-      id: customer.id,
-      email: customer.email ?? "",
-      firstName: customer.name?.split(" ")[0],
-      lastName: customer.name?.split(" ").slice(1).join(" ")
-    };
-  }
-};
-export {
-  FloPay,
-  STRIPE_API_VERSION
-};
-//# sourceMappingURL=index.mjs.map
+import T from"stripe";import{FloPayError as a,SDK_VERSION as P,buildProductPayload as V,foldIntoProducts as j,resolveSessionCurrency as A}from"@flopay/shared";var f="2026-04-22.dahlia",d=class{constructor(e,t){if(!e)throw new a("A secret key is required to initialize the FloPay server SDK.","authentication_error");this.stripe=new T(t?.stripeSecretKey??e,{apiVersion:t?.apiVersion??f,appInfo:{name:"flopay-node",version:P}}),this.checkout={sessions:{create:this.createSession.bind(this),retrieve:this.retrieveSession.bind(this),expire:this.expireSession.bind(this),listLineItems:this.listLineItems.bind(this)}},this.webhooks={constructEvent:this.constructWebhookEvent.bind(this)},this.customers={create:this.createCustomer.bind(this),retrieve:this.retrieveCustomer.bind(this),update:this.updateCustomer.bind(this)}}async createSession(e){let{billingApiUrl:t,checkoutBaseUrl:s,items:i=[],subscriptions:p=[],products:k,account:r,successUrl:b,cancelUrl:v,checkoutMode:w="confirm",couponCodes:I=[],tagsData:h,redirectParams:N={},timeoutMs:E=12e3,clientId:R,currency:U,utmMetadata:y}=e,C=k??j(i,p),c=A(U,i,p,C);if(!c)throw new a("currency is required: pass `currency` on the session, or include a `currency` on the first item/subscription/product.","validation_error",{code:"CurrencyRequired",param:"currency"});let u={clientId:R,checkoutVersion:P,successUrl:b,cancelUrl:v,currency:c,checkoutMode:w,products:C.map(o=>V(o,c)),accountData:{userId:r.userId,firstName:r.firstName??null,lastName:r.lastName??null,email:r.email,country:r.country??null,gender:r.gender??null,city:r.city??null,state:r.state??null,zip:r.zip??null},couponCodes:I};h&&(u.tagsData=h),y?.length&&(u.utmMetadata=y);let x=`${t.replace(/\/+$/,"")}/v1/checkouts/sessions`,S=new AbortController,_=setTimeout(()=>S.abort(),E),n,m;try{let o=await fetch(x,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(u),signal:S.signal});n=o.status;try{m=await o.json()}catch{}}finally{clearTimeout(_)}if(n===201){let o=m?.data?.uuid,g=m?.data?.nonce;if(!o)throw new Error("Checkout session created but no UUID was returned by the billing API");if(!g)throw new a("Checkout session created but no `nonce` was returned by the billing API. Upgrade the billing service to TeamFloPay/backend#640 or later.","api_error",{code:"MissingCheckoutSessionToken"});let l=new URL(`${s.replace(/\/+$/,"")}/secure`);l.searchParams.set("id",o);for(let[L,O]of Object.entries(N))l.searchParams.set(L,O);return{status:201,redirectUrl:l.toString(),nonce:g}}return n===204?{status:204}:{status:n}}normalizeStripeSession(e){let t={open:"open",complete:"complete",expired:"expired"};return{id:e.id,clientSecret:e.client_secret??"",mode:e.mode,status:t[e.status??"open"]??"open",amount:e.amount_total??0,currency:e.currency??"usd",metadata:e.metadata??{}}}async retrieveSession(e){let t=await this.stripe.checkout.sessions.retrieve(e);return this.normalizeStripeSession(t)}async expireSession(e){let t=await this.stripe.checkout.sessions.expire(e);return this.normalizeStripeSession(t)}async listLineItems(e){return(await this.stripe.checkout.sessions.listLineItems(e)).data.map(s=>({price:s.price?.id,quantity:s.quantity??1}))}constructWebhookEvent(e,t,s){let i=this.stripe.webhooks.constructEvent(e,t,s);return{id:i.id,type:i.type,data:i.data,created:i.created}}async createCustomer(e){let t=await this.stripe.customers.create({email:e.email,name:e.name,metadata:e.metadata});return{id:t.id,email:t.email??e.email,firstName:e.name?.split(" ")[0],lastName:e.name?.split(" ").slice(1).join(" ")}}async retrieveCustomer(e){let t=await this.stripe.customers.retrieve(e);if(t.deleted)throw new a(`Customer ${e} has been deleted`,"api_error",{code:"resource_missing"});return{id:t.id,email:t.email??"",firstName:t.name?.split(" ")[0],lastName:t.name?.split(" ").slice(1).join(" ")}}async updateCustomer(e,t){let s=await this.stripe.customers.update(e,{email:t.email,name:t.name,metadata:t.metadata});return{id:s.id,email:s.email??"",firstName:s.name?.split(" ")[0],lastName:s.name?.split(" ").slice(1).join(" ")}}};export{d as FloPay,f as STRIPE_API_VERSION};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flopay/node",
-  "version": "1.4.3",
+  "version": "1.4.4",
   "type": "module",
   "sideEffects": false,
   "publishConfig": {
@@ -27,7 +27,7 @@
   ],
   "dependencies": {
     "stripe": "^22.2.1",
-    "@flopay/shared": "1.4.3"
+    "@flopay/shared": "1.4.4"
   },
   "devDependencies": {
     "tsup": "^8.3.0",

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts","../src/flopay-node.ts"],"sourcesContent":["export { FloPay, STRIPE_API_VERSION } from './flopay-node.js';\nexport type { FloPayNodeOptions } from './flopay-node.js';\n","import Stripe from 'stripe';\nimport type {\n  CheckoutSession,\n  LineItem,\n  CreateSessionParams,\n  CheckoutSessionResult,\n  CreateCustomerParams,\n  UpdateCustomerParams,\n  WebhookEvent,\n  Customer,\n} from '@flopay/shared';\nimport {\n  FloPayError,\n  SDK_VERSION,\n  buildProductPayload,\n  foldIntoProducts,\n  resolveSessionCurrency,\n} from '@flopay/shared';\n\nexport const STRIPE_API_VERSION = '2026-04-22.dahlia';\n\ntype StripeConfig = NonNullable<ConstructorParameters<typeof Stripe>[1]>;\n\n/** Options for the FloPay Node SDK constructor. */\nexport interface FloPayNodeOptions {\n  apiVersion?: string;\n  /** Stripe secret key, required when using Stripe-specific operations. */\n  stripeSecretKey?: string;\n}\n\n/**\n * Server-side FloPay SDK.\n *\n * Supports two modes of operation:\n *\n * 1. **Billing API mode** — Creates checkout sessions via the FloPay/ClickTech\n *    billing API (`POST /v1/checkouts/sessions`). This mirrors the\n *    `createCheckoutSession` function from `clicktech-core-ui`.\n *\n * 2. **Stripe direct mode** — When a `stripeSecretKey` is provided, also\n *    exposes direct Stripe operations (customers, webhooks).\n *\n * @example\n * ```ts\n * import { FloPay } from '@flopay/node';\n *\n * const flopay = new FloPay('sk_test_...');\n *\n * // Create session via billing API\n * const result = await flopay.checkout.sessions.create({\n *   billingApiUrl: 'https://billing.example.com',\n *   checkoutBaseUrl: 'https://checkout.example.com',\n *   clientId: 'client_123',\n *   currency: 'USD',\n *   items: [{ code: 'prod_abc' }],\n *   account: { userId: 'user_1', email: 'user@example.com' },\n *   successUrl: '/success',\n *   cancelUrl: '/cancel',\n * });\n * ```\n */\nexport class FloPay {\n  private readonly stripe: Stripe;\n\n  readonly checkout: {\n    sessions: {\n      /** Create a checkout session via the billing API. */\n      create: (params: CreateSessionParams) => Promise<CheckoutSessionResult>;\n      /** Retrieve a checkout session from Stripe. */\n      retrieve: (id: string) => Promise<CheckoutSession>;\n      /** Expire a checkout session on Stripe. */\n      expire: (id: string) => Promise<CheckoutSession>;\n      /** List line items for a Stripe checkout session. */\n      listLineItems: (id: string) => Promise<LineItem[]>;\n    };\n  };\n\n  readonly webhooks: {\n    constructEvent: (\n      payload: string | Buffer,\n      signature: string,\n      secret: string,\n    ) => WebhookEvent;\n  };\n\n  readonly customers: {\n    create: (params: CreateCustomerParams) => Promise<Customer>;\n    retrieve: (id: string) => Promise<Customer>;\n    update: (id: string, params: UpdateCustomerParams) => Promise<Customer>;\n  };\n\n  constructor(secretKey: string, options?: FloPayNodeOptions) {\n    if (!secretKey) {\n      throw new FloPayError(\n        'A secret key is required to initialize the FloPay server SDK.',\n        'authentication_error',\n      );\n    }\n\n    this.stripe = new Stripe(options?.stripeSecretKey ?? secretKey, {\n      apiVersion: (options?.apiVersion ?? STRIPE_API_VERSION) as StripeConfig['apiVersion'],\n      appInfo: {\n        name: 'flopay-node',\n        version: SDK_VERSION,\n      },\n    });\n\n    this.checkout = {\n      sessions: {\n        create: this.createSession.bind(this),\n        retrieve: this.retrieveSession.bind(this),\n        expire: this.expireSession.bind(this),\n        listLineItems: this.listLineItems.bind(this),\n      },\n    };\n\n    this.webhooks = {\n      constructEvent: this.constructWebhookEvent.bind(this),\n    };\n\n    this.customers = {\n      create: this.createCustomer.bind(this),\n      retrieve: this.retrieveCustomer.bind(this),\n      update: this.updateCustomer.bind(this),\n    };\n  }\n\n  /**\n   * Create a checkout session via the billing API.\n   *\n   * Mirrors `createCheckoutSession` from `clicktech-core-ui/modules`.\n   * Posts to `{billingApiUrl}/v1/checkouts/sessions` and returns\n   * the session UUID for redirect.\n   */\n  private async createSession(\n    params: CreateSessionParams,\n  ): Promise<CheckoutSessionResult> {\n    const {\n      billingApiUrl,\n      checkoutBaseUrl,\n      items = [],\n      subscriptions = [],\n      products,\n      account,\n      successUrl,\n      cancelUrl,\n      checkoutMode = 'confirm',\n      couponCodes = [],\n      tagsData,\n      redirectParams = {},\n      timeoutMs = 12000,\n      clientId,\n      currency,\n      utmMetadata,\n    } = params;\n\n    const wireProducts = products ?? foldIntoProducts(items, subscriptions);\n    const sessionCurrency = resolveSessionCurrency(currency, items, subscriptions, wireProducts);\n    if (!sessionCurrency) {\n      throw new FloPayError(\n        'currency is required: pass `currency` on the session, or include a `currency` on the first item/subscription/product.',\n        'validation_error',\n        { code: 'CurrencyRequired', param: 'currency' },\n      );\n    }\n\n    const payload: Record<string, unknown> = {\n      clientId,\n      checkoutVersion: SDK_VERSION,\n      successUrl,\n      cancelUrl,\n      currency: sessionCurrency,\n      checkoutMode,\n      products: wireProducts.map((product) => buildProductPayload(product, sessionCurrency)),\n      accountData: {\n        userId: account.userId,\n        firstName: account.firstName ?? null,\n        lastName: account.lastName ?? null,\n        email: account.email,\n        country: account.country ?? null,\n        gender: account.gender ?? null,\n        city: account.city ?? null,\n        state: account.state ?? null,\n        zip: account.zip ?? null,\n      },\n      couponCodes,\n    };\n\n    if (tagsData) {\n      payload['tagsData'] = tagsData;\n    }\n\n    if (utmMetadata?.length) {\n      payload['utmMetadata'] = utmMetadata;\n    }\n\n    const url = `${billingApiUrl.replace(/\\/+$/, '')}/v1/checkouts/sessions`;\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), timeoutMs);\n\n    let status: number;\n    let body: { data?: { uuid?: string; nonce?: string } } | undefined;\n\n    try {\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify(payload),\n        signal: controller.signal,\n      });\n\n      status = response.status;\n\n      try {\n        body = await response.json() as { data?: { uuid?: string; nonce?: string } };\n      } catch {\n        // 204 or empty body\n      }\n    } finally {\n      clearTimeout(timer);\n    }\n\n    if (status === 201) {\n      const uuid = body?.data?.uuid;\n      const nonce = body?.data?.nonce;\n\n      if (!uuid) {\n        throw new Error('Checkout session created but no UUID was returned by the billing API');\n      }\n\n      if (!nonce) {\n        throw new FloPayError(\n          'Checkout session created but no `nonce` was returned by the billing API. Upgrade the billing service to TeamFloPay/backend#640 or later.',\n          'api_error',\n          { code: 'MissingCheckoutSessionToken' },\n        );\n      }\n\n      const redirectUrl = new URL(`${checkoutBaseUrl.replace(/\\/+$/, '')}/secure`);\n      redirectUrl.searchParams.set('id', uuid);\n\n      for (const [key, value] of Object.entries(redirectParams)) {\n        redirectUrl.searchParams.set(key, value);\n      }\n\n      return { status: 201, redirectUrl: redirectUrl.toString(), nonce };\n    }\n\n    if (status === 204) {\n      return { status: 204 };\n    }\n\n    return { status };\n  }\n\n  private normalizeStripeSession(\n    session: Stripe.Checkout.Session,\n  ): CheckoutSession {\n    const statusMap: Record<string, CheckoutSession['status']> = {\n      open: 'open',\n      complete: 'complete',\n      expired: 'expired',\n    };\n\n    return {\n      id: session.id,\n      clientSecret: session.client_secret ?? '',\n      mode: session.mode as CheckoutSession['mode'],\n      status: statusMap[session.status ?? 'open'] ?? 'open',\n      amount: session.amount_total ?? 0,\n      currency: session.currency ?? 'usd',\n      metadata: (session.metadata as Record<string, string>) ?? {},\n    };\n  }\n\n  private async retrieveSession(id: string): Promise<CheckoutSession> {\n    const session = await this.stripe.checkout.sessions.retrieve(id);\n    return this.normalizeStripeSession(session);\n  }\n\n  private async expireSession(id: string): Promise<CheckoutSession> {\n    const session = await this.stripe.checkout.sessions.expire(id);\n    return this.normalizeStripeSession(session);\n  }\n\n  private async listLineItems(id: string): Promise<LineItem[]> {\n    const items = await this.stripe.checkout.sessions.listLineItems(id);\n    return items.data.map((item) => ({\n      price: item.price?.id,\n      quantity: item.quantity ?? 1,\n    }));\n  }\n\n  private constructWebhookEvent(\n    payload: string | Buffer,\n    signature: string,\n    secret: string,\n  ): WebhookEvent {\n    const event = this.stripe.webhooks.constructEvent(payload, signature, secret);\n\n    return {\n      id: event.id,\n      type: event.type,\n      data: event.data as unknown as Record<string, unknown>,\n      created: event.created,\n    };\n  }\n\n  private async createCustomer(params: CreateCustomerParams): Promise<Customer> {\n    const customer = await this.stripe.customers.create({\n      email: params.email,\n      name: params.name,\n      metadata: params.metadata,\n    });\n\n    return {\n      id: customer.id,\n      email: customer.email ?? params.email,\n      firstName: params.name?.split(' ')[0],\n      lastName: params.name?.split(' ').slice(1).join(' '),\n    };\n  }\n\n  private async retrieveCustomer(id: string): Promise<Customer> {\n    const customer = await this.stripe.customers.retrieve(id);\n\n    if (customer.deleted) {\n      throw new FloPayError(\n        `Customer ${id} has been deleted`,\n        'api_error',\n        { code: 'resource_missing' },\n      );\n    }\n\n    return {\n      id: customer.id,\n      email: customer.email ?? '',\n      firstName: customer.name?.split(' ')[0],\n      lastName: customer.name?.split(' ').slice(1).join(' '),\n    };\n  }\n\n  private async updateCustomer(\n    id: string,\n    params: UpdateCustomerParams,\n  ): Promise<Customer> {\n    const customer = await this.stripe.customers.update(id, {\n      email: params.email,\n      name: params.name,\n      metadata: params.metadata,\n    });\n\n    return {\n      id: customer.id,\n      email: customer.email ?? '',\n      firstName: customer.name?.split(' ')[0],\n      lastName: customer.name?.split(' ').slice(1).join(' '),\n    };\n  }\n}\n"],"mappings":"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","names":["Stripe"]}

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/flopay-node.ts"],"sourcesContent":["import Stripe from 'stripe';\nimport type {\n  CheckoutSession,\n  LineItem,\n  CreateSessionParams,\n  CheckoutSessionResult,\n  CreateCustomerParams,\n  UpdateCustomerParams,\n  WebhookEvent,\n  Customer,\n} from '@flopay/shared';\nimport {\n  FloPayError,\n  SDK_VERSION,\n  buildProductPayload,\n  foldIntoProducts,\n  resolveSessionCurrency,\n} from '@flopay/shared';\n\nexport const STRIPE_API_VERSION = '2026-04-22.dahlia';\n\ntype StripeConfig = NonNullable<ConstructorParameters<typeof Stripe>[1]>;\n\n/** Options for the FloPay Node SDK constructor. */\nexport interface FloPayNodeOptions {\n  apiVersion?: string;\n  /** Stripe secret key, required when using Stripe-specific operations. */\n  stripeSecretKey?: string;\n}\n\n/**\n * Server-side FloPay SDK.\n *\n * Supports two modes of operation:\n *\n * 1. **Billing API mode** — Creates checkout sessions via the FloPay/ClickTech\n *    billing API (`POST /v1/checkouts/sessions`). This mirrors the\n *    `createCheckoutSession` function from `clicktech-core-ui`.\n *\n * 2. **Stripe direct mode** — When a `stripeSecretKey` is provided, also\n *    exposes direct Stripe operations (customers, webhooks).\n *\n * @example\n * ```ts\n * import { FloPay } from '@flopay/node';\n *\n * const flopay = new FloPay('sk_test_...');\n *\n * // Create session via billing API\n * const result = await flopay.checkout.sessions.create({\n *   billingApiUrl: 'https://billing.example.com',\n *   checkoutBaseUrl: 'https://checkout.example.com',\n *   clientId: 'client_123',\n *   currency: 'USD',\n *   items: [{ code: 'prod_abc' }],\n *   account: { userId: 'user_1', email: 'user@example.com' },\n *   successUrl: '/success',\n *   cancelUrl: '/cancel',\n * });\n * ```\n */\nexport class FloPay {\n  private readonly stripe: Stripe;\n\n  readonly checkout: {\n    sessions: {\n      /** Create a checkout session via the billing API. */\n      create: (params: CreateSessionParams) => Promise<CheckoutSessionResult>;\n      /** Retrieve a checkout session from Stripe. */\n      retrieve: (id: string) => Promise<CheckoutSession>;\n      /** Expire a checkout session on Stripe. */\n      expire: (id: string) => Promise<CheckoutSession>;\n      /** List line items for a Stripe checkout session. */\n      listLineItems: (id: string) => Promise<LineItem[]>;\n    };\n  };\n\n  readonly webhooks: {\n    constructEvent: (\n      payload: string | Buffer,\n      signature: string,\n      secret: string,\n    ) => WebhookEvent;\n  };\n\n  readonly customers: {\n    create: (params: CreateCustomerParams) => Promise<Customer>;\n    retrieve: (id: string) => Promise<Customer>;\n    update: (id: string, params: UpdateCustomerParams) => Promise<Customer>;\n  };\n\n  constructor(secretKey: string, options?: FloPayNodeOptions) {\n    if (!secretKey) {\n      throw new FloPayError(\n        'A secret key is required to initialize the FloPay server SDK.',\n        'authentication_error',\n      );\n    }\n\n    this.stripe = new Stripe(options?.stripeSecretKey ?? secretKey, {\n      apiVersion: (options?.apiVersion ?? STRIPE_API_VERSION) as StripeConfig['apiVersion'],\n      appInfo: {\n        name: 'flopay-node',\n        version: SDK_VERSION,\n      },\n    });\n\n    this.checkout = {\n      sessions: {\n        create: this.createSession.bind(this),\n        retrieve: this.retrieveSession.bind(this),\n        expire: this.expireSession.bind(this),\n        listLineItems: this.listLineItems.bind(this),\n      },\n    };\n\n    this.webhooks = {\n      constructEvent: this.constructWebhookEvent.bind(this),\n    };\n\n    this.customers = {\n      create: this.createCustomer.bind(this),\n      retrieve: this.retrieveCustomer.bind(this),\n      update: this.updateCustomer.bind(this),\n    };\n  }\n\n  /**\n   * Create a checkout session via the billing API.\n   *\n   * Mirrors `createCheckoutSession` from `clicktech-core-ui/modules`.\n   * Posts to `{billingApiUrl}/v1/checkouts/sessions` and returns\n   * the session UUID for redirect.\n   */\n  private async createSession(\n    params: CreateSessionParams,\n  ): Promise<CheckoutSessionResult> {\n    const {\n      billingApiUrl,\n      checkoutBaseUrl,\n      items = [],\n      subscriptions = [],\n      products,\n      account,\n      successUrl,\n      cancelUrl,\n      checkoutMode = 'confirm',\n      couponCodes = [],\n      tagsData,\n      redirectParams = {},\n      timeoutMs = 12000,\n      clientId,\n      currency,\n      utmMetadata,\n    } = params;\n\n    const wireProducts = products ?? foldIntoProducts(items, subscriptions);\n    const sessionCurrency = resolveSessionCurrency(currency, items, subscriptions, wireProducts);\n    if (!sessionCurrency) {\n      throw new FloPayError(\n        'currency is required: pass `currency` on the session, or include a `currency` on the first item/subscription/product.',\n        'validation_error',\n        { code: 'CurrencyRequired', param: 'currency' },\n      );\n    }\n\n    const payload: Record<string, unknown> = {\n      clientId,\n      checkoutVersion: SDK_VERSION,\n      successUrl,\n      cancelUrl,\n      currency: sessionCurrency,\n      checkoutMode,\n      products: wireProducts.map((product) => buildProductPayload(product, sessionCurrency)),\n      accountData: {\n        userId: account.userId,\n        firstName: account.firstName ?? null,\n        lastName: account.lastName ?? null,\n        email: account.email,\n        country: account.country ?? null,\n        gender: account.gender ?? null,\n        city: account.city ?? null,\n        state: account.state ?? null,\n        zip: account.zip ?? null,\n      },\n      couponCodes,\n    };\n\n    if (tagsData) {\n      payload['tagsData'] = tagsData;\n    }\n\n    if (utmMetadata?.length) {\n      payload['utmMetadata'] = utmMetadata;\n    }\n\n    const url = `${billingApiUrl.replace(/\\/+$/, '')}/v1/checkouts/sessions`;\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), timeoutMs);\n\n    let status: number;\n    let body: { data?: { uuid?: string; nonce?: string } } | undefined;\n\n    try {\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify(payload),\n        signal: controller.signal,\n      });\n\n      status = response.status;\n\n      try {\n        body = await response.json() as { data?: { uuid?: string; nonce?: string } };\n      } catch {\n        // 204 or empty body\n      }\n    } finally {\n      clearTimeout(timer);\n    }\n\n    if (status === 201) {\n      const uuid = body?.data?.uuid;\n      const nonce = body?.data?.nonce;\n\n      if (!uuid) {\n        throw new Error('Checkout session created but no UUID was returned by the billing API');\n      }\n\n      if (!nonce) {\n        throw new FloPayError(\n          'Checkout session created but no `nonce` was returned by the billing API. Upgrade the billing service to TeamFloPay/backend#640 or later.',\n          'api_error',\n          { code: 'MissingCheckoutSessionToken' },\n        );\n      }\n\n      const redirectUrl = new URL(`${checkoutBaseUrl.replace(/\\/+$/, '')}/secure`);\n      redirectUrl.searchParams.set('id', uuid);\n\n      for (const [key, value] of Object.entries(redirectParams)) {\n        redirectUrl.searchParams.set(key, value);\n      }\n\n      return { status: 201, redirectUrl: redirectUrl.toString(), nonce };\n    }\n\n    if (status === 204) {\n      return { status: 204 };\n    }\n\n    return { status };\n  }\n\n  private normalizeStripeSession(\n    session: Stripe.Checkout.Session,\n  ): CheckoutSession {\n    const statusMap: Record<string, CheckoutSession['status']> = {\n      open: 'open',\n      complete: 'complete',\n      expired: 'expired',\n    };\n\n    return {\n      id: session.id,\n      clientSecret: session.client_secret ?? '',\n      mode: session.mode as CheckoutSession['mode'],\n      status: statusMap[session.status ?? 'open'] ?? 'open',\n      amount: session.amount_total ?? 0,\n      currency: session.currency ?? 'usd',\n      metadata: (session.metadata as Record<string, string>) ?? {},\n    };\n  }\n\n  private async retrieveSession(id: string): Promise<CheckoutSession> {\n    const session = await this.stripe.checkout.sessions.retrieve(id);\n    return this.normalizeStripeSession(session);\n  }\n\n  private async expireSession(id: string): Promise<CheckoutSession> {\n    const session = await this.stripe.checkout.sessions.expire(id);\n    return this.normalizeStripeSession(session);\n  }\n\n  private async listLineItems(id: string): Promise<LineItem[]> {\n    const items = await this.stripe.checkout.sessions.listLineItems(id);\n    return items.data.map((item) => ({\n      price: item.price?.id,\n      quantity: item.quantity ?? 1,\n    }));\n  }\n\n  private constructWebhookEvent(\n    payload: string | Buffer,\n    signature: string,\n    secret: string,\n  ): WebhookEvent {\n    const event = this.stripe.webhooks.constructEvent(payload, signature, secret);\n\n    return {\n      id: event.id,\n      type: event.type,\n      data: event.data as unknown as Record<string, unknown>,\n      created: event.created,\n    };\n  }\n\n  private async createCustomer(params: CreateCustomerParams): Promise<Customer> {\n    const customer = await this.stripe.customers.create({\n      email: params.email,\n      name: params.name,\n      metadata: params.metadata,\n    });\n\n    return {\n      id: customer.id,\n      email: customer.email ?? params.email,\n      firstName: params.name?.split(' ')[0],\n      lastName: params.name?.split(' ').slice(1).join(' '),\n    };\n  }\n\n  private async retrieveCustomer(id: string): Promise<Customer> {\n    const customer = await this.stripe.customers.retrieve(id);\n\n    if (customer.deleted) {\n      throw new FloPayError(\n        `Customer ${id} has been deleted`,\n        'api_error',\n        { code: 'resource_missing' },\n      );\n    }\n\n    return {\n      id: customer.id,\n      email: customer.email ?? '',\n      firstName: customer.name?.split(' ')[0],\n      lastName: customer.name?.split(' ').slice(1).join(' '),\n    };\n  }\n\n  private async updateCustomer(\n    id: string,\n    params: UpdateCustomerParams,\n  ): Promise<Customer> {\n    const customer = await this.stripe.customers.update(id, {\n      email: params.email,\n      name: params.name,\n      metadata: params.metadata,\n    });\n\n    return {\n      id: customer.id,\n      email: customer.email ?? '',\n      firstName: customer.name?.split(' ')[0],\n      lastName: customer.name?.split(' ').slice(1).join(' '),\n    };\n  }\n}\n"],"mappings":"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","names":[]}