@carlonicora/nextjs-jsonapi 5.5.0 → 5.7.0

package/src/features/billing/stripe-coupon/data/stripe-coupon-offer.ts

@@ -0,0 +1,70 @@
+import { AbstractApiData, JsonApiHydratedDataInterface } from "../../../../core";
+import { StripeCouponOfferInterface } from "./stripe-coupon-offer.interface";
+import { StripeCouponDiscountType, StripeCouponDurationType } from "./stripe-coupon.interface";
+
+/** Read-only public resource: never created or updated from the frontend. */
+export class StripeCouponOffer extends AbstractApiData implements StripeCouponOfferInterface {
+  private _discountType?: StripeCouponDiscountType;
+  private _percentOff?: number;
+  private _amountOff?: number;
+  private _currency?: string;
+  private _duration?: StripeCouponDurationType;
+  private _durationInMonths?: number;
+  private _placesLeft: number = 0;
+  private _placesTotal: number = 0;
+
+  get discountType(): StripeCouponDiscountType {
+    if (!this._discountType) throw new Error("discountType is not defined");
+    return this._discountType;
+  }
+
+  get percentOff(): number | undefined {
+    return this._percentOff;
+  }
+
+  get amountOff(): number | undefined {
+    return this._amountOff;
+  }
+
+  get currency(): string | undefined {
+    return this._currency;
+  }
+
+  get duration(): StripeCouponDurationType {
+    if (!this._duration) throw new Error("duration is not defined");
+    return this._duration;
+  }
+
+  get durationInMonths(): number | undefined {
+    return this._durationInMonths;
+  }
+
+  get placesLeft(): number {
+    return this._placesLeft;
+  }
+
+  get placesTotal(): number {
+    return this._placesTotal;
+  }
+
+  rehydrate(data: JsonApiHydratedDataInterface): this {
+    super.rehydrate(data);
+
+    const attributes = data.jsonApi.attributes;
+
+    this._discountType = attributes.discountType;
+    this._percentOff = attributes.percentOff ?? undefined;
+    this._amountOff = attributes.amountOff ?? undefined;
+    this._currency = attributes.currency ?? undefined;
+    this._duration = attributes.duration;
+    this._durationInMonths = attributes.durationInMonths ?? undefined;
+    this._placesLeft = attributes.placesLeft ?? 0;
+    this._placesTotal = attributes.placesTotal ?? 0;
+
+    return this;
+  }
+
+  createJsonApi(_data?: any): any {
+    throw new Error("StripeCouponOffer is declared by the API and is read-only");
+  }
+}

package/src/features/billing/stripe-coupon/data/stripe-coupon.fields.ts

@@ -0,0 +1,7 @@
+export enum StripeCouponFields {
+  name = "name",
+  discount = "discount",
+  places = "places",
+  codes = "codes",
+  status = "status",
+}

package/src/features/billing/stripe-coupon/data/stripe-coupon.interface.ts

@@ -0,0 +1,55 @@
+import { ApiDataInterface } from "../../../../core";
+import { StripeCouponCodeInput, StripeCouponCodeInterface } from "./stripe-coupon-code.interface";
+
+// ============================================================================
+// Stripe Coupon Interfaces
+// ============================================================================
+
+export type StripeCouponDiscountType = "percent_off" | "amount_off";
+export type StripeCouponDurationType = "once" | "repeating" | "forever";
+
+export interface StripeCouponInterface extends ApiDataInterface {
+  get stripeCouponId(): string;
+  get name(): string;
+  get discountType(): StripeCouponDiscountType;
+  get percentOff(): number | undefined;
+  get amountOff(): number | undefined; // minor units (cents)
+  get currency(): string | undefined;
+  get duration(): StripeCouponDurationType;
+  get durationInMonths(): number | undefined;
+  get stripeProductIds(): string[]; // empty = every product
+  get redeemBy(): Date | undefined;
+  get maxRedemptions(): number | undefined;
+  get timesRedeemed(): number;
+  get valid(): boolean;
+  get codes(): StripeCouponCodeInterface[];
+}
+
+// ============================================================================
+// Stripe Coupon Input DTOs
+// ============================================================================
+
+/** The discount of a new coupon: a percentage, or a fixed amount in one currency. */
+export type StripeCouponDiscountInput =
+  | { discountType: "percent_off"; percentOff: number }
+  | { discountType: "amount_off"; amountOff: number; currency: string }; // amountOff in minor units
+
+/** How long a new coupon's discount lasts: months only when it repeats. */
+export type StripeCouponDurationInput =
+  { duration: "once" } | { duration: "forever" } | { duration: "repeating"; durationInMonths: number };
+
+export type StripeCouponInput = {
+  id: string;
+  name: string;
+  stripeCouponId?: string;
+  productIds?: string[]; // our StripeProduct ids
+  redeemBy?: Date;
+  maxRedemptions?: number;
+  firstCode: Omit<StripeCouponCodeInput, "id" | "couponId">;
+} & StripeCouponDiscountInput &
+  StripeCouponDurationInput;
+
+export type StripeCouponRenameInput = {
+  id: string;
+  name: string;
+};

package/src/features/billing/stripe-coupon/data/stripe-coupon.service.ts

@@ -0,0 +1,93 @@
+import { AbstractService, EndpointCreator, HttpMethod, Modules, NextRef, PreviousRef } from "../../../../core";
+import { STRIPE_COUPON_REFRESH_SEGMENT } from "../stripe-coupon.module";
+import { StripeCoupon } from "./stripe-coupon";
+import { StripeCouponInput, StripeCouponInterface, StripeCouponRenameInput } from "./stripe-coupon.interface";
+
+/**
+ * Admin billing service for managing coupons
+ */
+export class StripeCouponService extends AbstractService {
+  /**
+   * List all coupons with their codes (admin)
+   */
+  static async listCoupons(params?: { next?: NextRef; prev?: PreviousRef }): Promise<StripeCouponInterface[]> {
+    const endpoint = new EndpointCreator({
+      endpoint: Modules.StripeCoupon,
+    });
+
+    return this.callApi({
+      type: Modules.StripeCoupon,
+      method: HttpMethod.GET,
+      endpoint: endpoint.generate(),
+      next: params?.next,
+      previous: params?.prev,
+    });
+  }
+
+  /**
+   * Get a specific coupon by ID (admin)
+   */
+  static async getCoupon(params: { id: string }): Promise<StripeCouponInterface> {
+    const endpoint = new EndpointCreator({
+      endpoint: Modules.StripeCoupon,
+      id: params.id,
+    });
+
+    return this.callApi<StripeCouponInterface>({
+      type: Modules.StripeCoupon,
+      method: HttpMethod.GET,
+      endpoint: endpoint.generate(),
+    });
+  }
+
+  /**
+   * Create a coupon and its first code (admin)
+   */
+  static async createCoupon(params: StripeCouponInput): Promise<StripeCouponInterface> {
+    const endpoint = new EndpointCreator({
+      endpoint: Modules.StripeCoupon,
+    });
+
+    return this.callApi<StripeCouponInterface>({
+      type: Modules.StripeCoupon,
+      method: HttpMethod.POST,
+      endpoint: endpoint.generate(),
+      input: params,
+    });
+  }
+
+  /**
+   * Rename a coupon (admin). The only coupon field Stripe allows to change.
+   */
+  static async renameCoupon(params: StripeCouponRenameInput): Promise<StripeCouponInterface> {
+    const endpoint = new EndpointCreator({
+      endpoint: Modules.StripeCoupon,
+      id: params.id,
+    });
+
+    return this.callApi<StripeCouponInterface>({
+      type: Modules.StripeCoupon,
+      method: HttpMethod.PATCH,
+      endpoint: endpoint.generate(),
+      input: new StripeCoupon().createRenameJsonApi(params),
+      overridesJsonApiCreation: true,
+    });
+  }
+
+  /**
+   * Re-read the coupon and its codes from Stripe and store the counts (admin)
+   */
+  static async refreshCounts(params: { id: string }): Promise<StripeCouponInterface> {
+    const endpoint = new EndpointCreator({
+      endpoint: Modules.StripeCoupon,
+      id: params.id,
+      childEndpoint: STRIPE_COUPON_REFRESH_SEGMENT,
+    });
+
+    return this.callApi<StripeCouponInterface>({
+      type: Modules.StripeCoupon,
+      method: HttpMethod.POST,
+      endpoint: endpoint.generate(),
+    });
+  }
+}

package/src/features/billing/stripe-coupon/data/stripe-coupon.ts

@@ -0,0 +1,167 @@
+import { AbstractApiData, JsonApiHydratedDataInterface, Modules } from "../../../../core";
+import { StripeCouponCodeInput, StripeCouponCodeInterface } from "./stripe-coupon-code.interface";
+import {
+  StripeCouponDiscountType,
+  StripeCouponDurationType,
+  StripeCouponInput,
+  StripeCouponInterface,
+  StripeCouponRenameInput,
+} from "./stripe-coupon.interface";
+
+export class StripeCoupon extends AbstractApiData implements StripeCouponInterface {
+  private _stripeCouponId?: string;
+  private _name?: string;
+  private _discountType?: StripeCouponDiscountType;
+  private _percentOff?: number;
+  private _amountOff?: number;
+  private _currency?: string;
+  private _duration?: StripeCouponDurationType;
+  private _durationInMonths?: number;
+  private _stripeProductIds: string[] = [];
+  private _redeemBy?: Date;
+  private _maxRedemptions?: number;
+  private _timesRedeemed: number = 0;
+  private _valid: boolean = true;
+  private _codes: StripeCouponCodeInterface[] = [];
+
+  get stripeCouponId(): string {
+    if (!this._stripeCouponId) throw new Error("stripeCouponId is not defined");
+    return this._stripeCouponId;
+  }
+
+  get name(): string {
+    return this._name ?? "";
+  }
+
+  get discountType(): StripeCouponDiscountType {
+    if (!this._discountType) throw new Error("discountType is not defined");
+    return this._discountType;
+  }
+
+  get percentOff(): number | undefined {
+    return this._percentOff;
+  }
+
+  get amountOff(): number | undefined {
+    return this._amountOff;
+  }
+
+  get currency(): string | undefined {
+    return this._currency;
+  }
+
+  get duration(): StripeCouponDurationType {
+    if (!this._duration) throw new Error("duration is not defined");
+    return this._duration;
+  }
+
+  get durationInMonths(): number | undefined {
+    return this._durationInMonths;
+  }
+
+  get stripeProductIds(): string[] {
+    return this._stripeProductIds;
+  }
+
+  get redeemBy(): Date | undefined {
+    return this._redeemBy;
+  }
+
+  get maxRedemptions(): number | undefined {
+    return this._maxRedemptions;
+  }
+
+  get timesRedeemed(): number {
+    return this._timesRedeemed;
+  }
+
+  get valid(): boolean {
+    return this._valid;
+  }
+
+  get codes(): StripeCouponCodeInterface[] {
+    return this._codes;
+  }
+
+  rehydrate(data: JsonApiHydratedDataInterface): this {
+    super.rehydrate(data);
+
+    const attributes = data.jsonApi.attributes;
+
+    this._stripeCouponId = attributes.stripeCouponId;
+    this._name = attributes.name;
+    this._discountType = attributes.discountType;
+    this._percentOff = attributes.percentOff ?? undefined;
+    this._amountOff = attributes.amountOff ?? undefined;
+    this._currency = attributes.currency ?? undefined;
+    this._duration = attributes.duration;
+    this._durationInMonths = attributes.durationInMonths ?? undefined;
+    this._stripeProductIds = attributes.stripeProductIds ?? [];
+    this._redeemBy = attributes.redeemBy ? new Date(attributes.redeemBy) : undefined;
+    this._maxRedemptions = attributes.maxRedemptions ?? undefined;
+    this._timesRedeemed = attributes.timesRedeemed ?? 0;
+    this._valid = attributes.valid ?? true;
+
+    this._codes =
+      (this._readIncluded(data, "codes", Modules.StripeCouponCode) as StripeCouponCodeInterface[] | undefined) ?? [];
+
+    return this;
+  }
+
+  createJsonApi(data: StripeCouponInput): any {
+    const response: any = {
+      data: {
+        type: Modules.StripeCoupon.name,
+        id: data.id,
+        attributes: {
+          name: data.name,
+          discountType: data.discountType,
+          duration: data.duration,
+          firstCode: StripeCoupon.codeAttributes(data.firstCode),
+        },
+      },
+    };
+
+    const attributes = response.data.attributes;
+    if (data.stripeCouponId) attributes.stripeCouponId = data.stripeCouponId;
+    if (data.discountType === "percent_off") attributes.percentOff = data.percentOff;
+    else {
+      attributes.amountOff = data.amountOff;
+      attributes.currency = data.currency;
+    }
+    if (data.duration === "repeating") attributes.durationInMonths = data.durationInMonths;
+    if (data.productIds && data.productIds.length > 0) attributes.productIds = data.productIds;
+    if (data.redeemBy !== undefined) attributes.redeemBy = data.redeemBy.toISOString();
+    if (data.maxRedemptions !== undefined) attributes.maxRedemptions = data.maxRedemptions;
+
+    return response;
+  }
+
+  /**
+   * Rename is the only change Stripe allows on a coupon after creation.
+   * Dedicated method so the service never needs a generic override.
+   */
+  createRenameJsonApi(data: StripeCouponRenameInput): any {
+    return {
+      data: {
+        type: Modules.StripeCoupon.name,
+        id: data.id,
+        attributes: { name: data.name },
+      },
+    };
+  }
+
+  /** Attributes of a code, shared by the coupon's first code and StripeCouponCode.createJsonApi. */
+  static codeAttributes(code: Omit<StripeCouponCodeInput, "id" | "couponId">): Record<string, any> {
+    const attributes: Record<string, any> = {};
+    if (code.code) attributes.code = code.code;
+    if (code.firstTimeTransaction !== undefined) attributes.firstTimeTransaction = code.firstTimeTransaction;
+    if (code.minimumAmount !== undefined) attributes.minimumAmount = code.minimumAmount;
+    if (code.minimumAmountCurrency) attributes.minimumAmountCurrency = code.minimumAmountCurrency;
+    if (code.stripeCustomerId) attributes.stripeCustomerId = code.stripeCustomerId;
+    if (code.expiresAt !== undefined) attributes.expiresAt = code.expiresAt.toISOString();
+    if (code.maxRedemptions !== undefined) attributes.maxRedemptions = code.maxRedemptions;
+    if (code.automatic !== undefined) attributes.automatic = code.automatic;
+    return attributes;
+  }
+}

package/src/features/billing/stripe-coupon/hooks/useStripeCouponCodeTableStructure.tsx

@@ -0,0 +1,161 @@
+"use client";
+
+import { ColumnDef } from "@tanstack/react-table";
+import { useTranslations } from "next-intl";
+import { useMemo, useState } from "react";
+import { Badge } from "../../../../shadcnui";
+import { registerTableGenerator, TableContent, UseTableStructureHook } from "../../../../hooks";
+import { formatDate, useBillingFormatOptions } from "../../components/utils";
+import { useCouponContext } from "../../contexts/CouponContext";
+import { CouponCodeActions } from "../components/widgets/CouponCodeActions";
+import { StripeCouponCodeFields } from "../data/stripe-coupon-code.fields";
+import { StripeCouponCodeInterface } from "../data/stripe-coupon-code.interface";
+import { StripeCouponInterface } from "../data/stripe-coupon.interface";
+import { couponPlacesLeft } from "../utils/coupon-places";
+
+export type CouponCodeStatus = "active" | "inactive" | "expired" | "used_up";
+
+/**
+ * Expired and used-up codes are dead for good (Stripe never revives them), so
+ * they win over a plain inactive flag. Places follow the same rule as the
+ * backend: the smaller of the code's and the coupon's remaining limits.
+ */
+export function couponCodeStatus(
+  code: StripeCouponCodeInterface,
+  coupon: StripeCouponInterface | undefined,
+  now: Date,
+): CouponCodeStatus {
+  if (code.expiresAt && code.expiresAt.getTime() <= now.getTime()) return "expired";
+  const left = couponPlacesLeft(code, coupon ?? { maxRedemptions: undefined, timesRedeemed: 0 });
+  if (left === 0) return "used_up";
+  return code.active ? "active" : "inactive";
+}
+
+const STATUS_VARIANT: Record<CouponCodeStatus, "softGreen" | "softGray" | "softAmber" | "softRed"> = {
+  active: "softGreen",
+  inactive: "softGray",
+  expired: "softAmber",
+  used_up: "softRed",
+};
+
+export const useStripeCouponCodeTableStructure: UseTableStructureHook<
+  StripeCouponCodeInterface,
+  StripeCouponCodeFields
+> = (params) => {
+  const t = useTranslations();
+  const fmt = useBillingFormatOptions();
+  // The codes list is mounted on the coupon's own page, so the coupon whose
+  // limits share the places is the context's, not whatever the code includes.
+  const { coupon } = useCouponContext();
+  // Read once on mount: render stays pure, and "expired" is judged against the
+  // moment the list was opened.
+  const [now] = useState(() => new Date());
+
+  const tableData = useMemo(() => {
+    return params.data.map((code: StripeCouponCodeInterface) => {
+      const entry: TableContent<StripeCouponCodeInterface> = { jsonApiData: code };
+      params.fields.forEach((field) => {
+        entry[field] = (code as any)[field as keyof StripeCouponCodeInterface];
+      });
+      return entry;
+    });
+  }, [params.data, params.fields]);
+
+  const fieldColumnMap: Partial<Record<StripeCouponCodeFields, () => any>> = {
+    [StripeCouponCodeFields.code]: () => ({
+      id: "code",
+      accessorKey: "code",
+      header: t("billing.admin.coupons.fields.code"),
+      cell: ({ row }: { row: TableContent<StripeCouponCodeInterface> }) => {
+        const code: StripeCouponCodeInterface = row.original.jsonApiData;
+        return <span className="text-xs">{code.code}</span>;
+      },
+      enableSorting: false,
+      enableHiding: false,
+    }),
+    [StripeCouponCodeFields.places]: () => ({
+      id: "places",
+      accessorKey: "places",
+      header: t("billing.admin.coupons.fields.places"),
+      cell: ({ row }: { row: TableContent<StripeCouponCodeInterface> }) => {
+        const code: StripeCouponCodeInterface = row.original.jsonApiData;
+        // Typography role 15 (numeric): tabular-nums, end-aligned.
+        return (
+          <span className="block text-xs tabular-nums text-end">
+            {code.maxRedemptions !== undefined
+              ? t("billing.admin.coupons.places.limited", {
+                  used: String(code.timesRedeemed),
+                  limit: String(code.maxRedemptions),
+                })
+              : t("billing.admin.coupons.places.unlimited", { used: String(code.timesRedeemed) })}
+          </span>
+        );
+      },
+      enableSorting: false,
+      enableHiding: false,
+    }),
+    [StripeCouponCodeFields.expiresAt]: () => ({
+      id: "expiresAt",
+      accessorKey: "expiresAt",
+      header: t("billing.admin.coupons.fields.expiresAt"),
+      cell: ({ row }: { row: TableContent<StripeCouponCodeInterface> }) => {
+        const code: StripeCouponCodeInterface = row.original.jsonApiData;
+        return (
+          <span className="text-xs tabular-nums">
+            {code.expiresAt ? formatDate(code.expiresAt, fmt) : t("billing.admin.coupons.codes.never")}
+          </span>
+        );
+      },
+      enableSorting: false,
+      enableHiding: false,
+    }),
+    [StripeCouponCodeFields.automatic]: () => ({
+      id: "automatic",
+      accessorKey: "automatic",
+      header: t("billing.admin.coupons.fields.automatic"),
+      cell: ({ row }: { row: TableContent<StripeCouponCodeInterface> }) => {
+        const code: StripeCouponCodeInterface = row.original.jsonApiData;
+        return code.automatic ? (
+          <Badge variant="softBlue">{t("billing.admin.coupons.codes.automatic")}</Badge>
+        ) : (
+          <span className="text-muted-foreground text-xs">—</span>
+        );
+      },
+      enableSorting: false,
+      enableHiding: false,
+    }),
+    [StripeCouponCodeFields.status]: () => ({
+      id: "status",
+      accessorKey: "status",
+      header: t("billing.admin.coupons.fields.status"),
+      cell: ({ row }: { row: TableContent<StripeCouponCodeInterface> }) => {
+        const code: StripeCouponCodeInterface = row.original.jsonApiData;
+        const status = couponCodeStatus(code, code.coupon ?? coupon, now);
+        return <Badge variant={STATUS_VARIANT[status]}>{t(`billing.admin.coupons.codes.status.${status}`)}</Badge>;
+      },
+      enableSorting: false,
+      enableHiding: false,
+    }),
+    [StripeCouponCodeFields.actions]: () => ({
+      id: "actions",
+      accessorKey: "actions",
+      header: "",
+      cell: ({ row }: { row: TableContent<StripeCouponCodeInterface> }) => {
+        const code: StripeCouponCodeInterface = row.original.jsonApiData;
+        return <CouponCodeActions code={code} status={couponCodeStatus(code, code.coupon ?? coupon, now)} />;
+      },
+      enableSorting: false,
+      enableHiding: false,
+    }),
+  };
+
+  const columns = useMemo(() => {
+    return params.fields.map((field) => fieldColumnMap[field]?.()).filter((col) => col !== undefined) as ColumnDef<
+      TableContent<StripeCouponCodeInterface>
+    >[];
+  }, [params.fields, fieldColumnMap, t, coupon, now]);
+
+  return useMemo(() => ({ data: tableData, columns: columns }), [tableData, columns]);
+};
+
+registerTableGenerator("stripe-coupon-codes", useStripeCouponCodeTableStructure);

package/src/features/billing/stripe-coupon/hooks/useStripeCouponTableStructure.tsx

@@ -0,0 +1,113 @@
+"use client";
+
+import { ColumnDef } from "@tanstack/react-table";
+import { useTranslations } from "next-intl";
+import { useMemo } from "react";
+import { Badge, Link } from "../../../../shadcnui";
+import { registerTableGenerator, TableContent, usePageUrlGenerator, UseTableStructureHook } from "../../../../hooks";
+import { useBillingFormatOptions } from "../../components/utils";
+import { StripeCouponFields } from "../data/stripe-coupon.fields";
+import { STRIPE_COUPON_DETAIL_PAGE_URL } from "../stripe-coupon.module";
+import { StripeCouponInterface } from "../data/stripe-coupon.interface";
+import { formatCouponDiscount } from "../utils/format-coupon-discount";
+
+export const useStripeCouponTableStructure: UseTableStructureHook<StripeCouponInterface, StripeCouponFields> = (
+  params,
+) => {
+  const t = useTranslations();
+  const fmt = useBillingFormatOptions();
+  const generateUrl = usePageUrlGenerator();
+
+  const tableData = useMemo(() => {
+    return params.data.map((coupon: StripeCouponInterface) => {
+      const entry: TableContent<StripeCouponInterface> = { jsonApiData: coupon };
+      params.fields.forEach((field) => {
+        entry[field] = (coupon as any)[field as keyof StripeCouponInterface];
+      });
+      return entry;
+    });
+  }, [params.data, params.fields]);
+
+  const fieldColumnMap: Partial<Record<StripeCouponFields, () => any>> = {
+    [StripeCouponFields.name]: () => ({
+      id: "name",
+      accessorKey: "name",
+      header: t("billing.admin.coupons.fields.name"),
+      cell: ({ row }: { row: TableContent<StripeCouponInterface> }) => {
+        const coupon: StripeCouponInterface = row.original.jsonApiData;
+        return <Link href={generateUrl({ page: STRIPE_COUPON_DETAIL_PAGE_URL, id: coupon.id })}>{coupon.name}</Link>;
+      },
+      enableSorting: false,
+      enableHiding: false,
+    }),
+    [StripeCouponFields.discount]: () => ({
+      id: "discount",
+      accessorKey: "discount",
+      header: t("billing.admin.coupons.fields.discount"),
+      cell: ({ row }: { row: TableContent<StripeCouponInterface> }) => {
+        const coupon: StripeCouponInterface = row.original.jsonApiData;
+        return <span className="text-xs">{formatCouponDiscount(coupon, t, fmt)}</span>;
+      },
+      enableSorting: false,
+      enableHiding: false,
+    }),
+    [StripeCouponFields.places]: () => ({
+      id: "places",
+      accessorKey: "places",
+      header: t("billing.admin.coupons.fields.places"),
+      cell: ({ row }: { row: TableContent<StripeCouponInterface> }) => {
+        const coupon: StripeCouponInterface = row.original.jsonApiData;
+        // Typography role 15 (numeric): tabular-nums, end-aligned. NEVER
+        // font-mono — no monospace font is loaded in these apps.
+        return (
+          <span className="block text-xs tabular-nums text-end">
+            {coupon.maxRedemptions !== undefined
+              ? t("billing.admin.coupons.places.limited", {
+                  used: String(coupon.timesRedeemed),
+                  limit: String(coupon.maxRedemptions),
+                })
+              : t("billing.admin.coupons.places.unlimited", { used: String(coupon.timesRedeemed) })}
+          </span>
+        );
+      },
+      enableSorting: false,
+      enableHiding: false,
+    }),
+    [StripeCouponFields.codes]: () => ({
+      id: "codes",
+      accessorKey: "codes",
+      header: t("billing.admin.coupons.fields.codes"),
+      cell: ({ row }: { row: TableContent<StripeCouponInterface> }) => {
+        const coupon: StripeCouponInterface = row.original.jsonApiData;
+        return <span className="block text-xs tabular-nums text-end">{coupon.codes.length}</span>;
+      },
+      enableSorting: false,
+      enableHiding: false,
+    }),
+    [StripeCouponFields.status]: () => ({
+      id: "status",
+      accessorKey: "status",
+      header: t("billing.admin.coupons.fields.status"),
+      cell: ({ row }: { row: TableContent<StripeCouponInterface> }) => {
+        const coupon: StripeCouponInterface = row.original.jsonApiData;
+        return coupon.valid ? (
+          <Badge variant="softGreen">{t("billing.admin.coupons.status.active")}</Badge>
+        ) : (
+          <Badge variant="softGray">{t("billing.admin.coupons.status.ended")}</Badge>
+        );
+      },
+      enableSorting: false,
+      enableHiding: false,
+    }),
+  };
+
+  const columns = useMemo(() => {
+    return params.fields.map((field) => fieldColumnMap[field]?.()).filter((col) => col !== undefined) as ColumnDef<
+      TableContent<StripeCouponInterface>
+    >[];
+  }, [params.fields, fieldColumnMap, t, generateUrl]);
+
+  return useMemo(() => ({ data: tableData, columns: columns }), [tableData, columns]);
+};
+
+registerTableGenerator("stripe-coupons", useStripeCouponTableStructure);

package/src/features/billing/stripe-coupon/index.ts

@@ -0,0 +1,5 @@
+export * from "./data";
+export * from "./utils";
+export * from "./stripe-coupon.module";
+export * from "./stripe-coupon-code.module";
+export * from "./stripe-coupon-offer.module";