@windrun-huaiin/backend-core 28.0.0 → 28.0.1

package/dist/app/api/user/credit-overview/route.d.ts

@@ -0,0 +1,13 @@
+import type { CreditOverviewTranslations } from '@windrun-huaiin/third-ui/main/credit';
+import { NextResponse } from 'next/server';
+export type CreditOverviewTranslationsResolver = (locale: string) => CreditOverviewTranslations | Promise<CreditOverviewTranslations>;
+export interface CreateGETOptions {
+    defaultLocale?: string;
+    localePrefixAsNeeded?: boolean;
+    resolveTranslations: CreditOverviewTranslationsResolver;
+    pricingPath?: string;
+    checkoutApiEndpoint?: string;
+    customerPortalApiEndpoint?: string;
+}
+export declare function createGET(options: CreateGETOptions): (request: Request) => Promise<NextResponse<import("@core/lib/credit-overview").CreditOverviewPayload | null>>;
+//# sourceMappingURL=route.d.ts.map

package/dist/app/api/user/credit-overview/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../../src/app/api/user/credit-overview/route.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,MAAM,MAAM,kCAAkC,GAAG,CAC/C,MAAM,EAAE,MAAM,KACX,0BAA0B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,mBAAmB,EAAE,kCAAkC,CAAC;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,IACvB,SAAS,OAAO,6FAiB3C"}

package/dist/app/api/user/credit-overview/route.js

@@ -0,0 +1,32 @@
+'use strict';
+
+var tslib = require('tslib');
+var server = require('next/server');
+var creditOverview = require('../../../../lib/credit-overview.js');
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+// Fix BigInt serialization issue
+BigInt.prototype.toJSON = function () {
+    return this.toString();
+};
+function createGET(options) {
+    return function GET(request) {
+        return tslib.__awaiter(this, void 0, void 0, function* () {
+            const { searchParams } = new URL(request.url);
+            const locale = searchParams.get('locale') || options.defaultLocale || 'en';
+            const translations = yield options.resolveTranslations(locale);
+            const payload = yield creditOverview.buildCreditOverviewPayload({
+                locale,
+                defaultLocale: options.defaultLocale,
+                localePrefixAsNeeded: options.localePrefixAsNeeded,
+                translations,
+                pricingPath: options.pricingPath,
+                checkoutApiEndpoint: options.checkoutApiEndpoint,
+                customerPortalApiEndpoint: options.customerPortalApiEndpoint,
+            });
+            return server.NextResponse.json(payload);
+        });
+    };
+}
+
+exports.createGET = createGET;

package/dist/app/api/user/credit-overview/route.mjs

@@ -0,0 +1,30 @@
+import { __awaiter } from 'tslib';
+import { NextResponse } from 'next/server';
+import { buildCreditOverviewPayload } from '../../../../lib/credit-overview.mjs';
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+// Fix BigInt serialization issue
+BigInt.prototype.toJSON = function () {
+    return this.toString();
+};
+function createGET(options) {
+    return function GET(request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { searchParams } = new URL(request.url);
+            const locale = searchParams.get('locale') || options.defaultLocale || 'en';
+            const translations = yield options.resolveTranslations(locale);
+            const payload = yield buildCreditOverviewPayload({
+                locale,
+                defaultLocale: options.defaultLocale,
+                localePrefixAsNeeded: options.localePrefixAsNeeded,
+                translations,
+                pricingPath: options.pricingPath,
+                checkoutApiEndpoint: options.checkoutApiEndpoint,
+                customerPortalApiEndpoint: options.customerPortalApiEndpoint,
+            });
+            return NextResponse.json(payload);
+        });
+    };
+}
+
+export { createGET };

package/dist/app/api/user/pricing-context/route.d.ts

@@ -0,0 +1,3 @@
+import { NextResponse } from 'next/server';
+export declare function GET(): Promise<NextResponse<import("@windrun-huaiin/third-ui/main/server").InitUserContext>>;
+//# sourceMappingURL=route.d.ts.map

package/dist/app/api/user/pricing-context/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../../src/app/api/user/pricing-context/route.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,wBAAsB,GAAG,0FAGxB"}

package/dist/app/api/user/pricing-context/route.js

@@ -0,0 +1,19 @@
+'use strict';
+
+var tslib = require('tslib');
+var moneyPriceHelper = require('../../../../lib/money-price-helper.js');
+var server = require('next/server');
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+// Fix BigInt serialization issue
+BigInt.prototype.toJSON = function () {
+    return this.toString();
+};
+function GET() {
+    return tslib.__awaiter(this, void 0, void 0, function* () {
+        const initUserContext = yield moneyPriceHelper.getMoneyPriceInitUserContext();
+        return server.NextResponse.json(initUserContext);
+    });
+}
+
+exports.GET = GET;

package/dist/app/api/user/pricing-context/route.mjs

@@ -0,0 +1,17 @@
+import { __awaiter } from 'tslib';
+import { getMoneyPriceInitUserContext } from '../../../../lib/money-price-helper.mjs';
+import { NextResponse } from 'next/server';
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+// Fix BigInt serialization issue
+BigInt.prototype.toJSON = function () {
+    return this.toString();
+};
+function GET() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const initUserContext = yield getMoneyPriceInitUserContext();
+        return NextResponse.json(initUserContext);
+    });
+}
+
+export { GET };

package/dist/credit/server.d.ts

@@ -1,2 +1,3 @@
 export * from '../lib/credit-init';
+export * from '../lib/credit-overview';
 //# sourceMappingURL=server.d.ts.map

package/dist/credit/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/credit/server.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/credit/server.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}

package/dist/credit/server.js

@@ -1,6 +1,7 @@
 'use strict';
 
 var creditInit = require('../lib/credit-init.js');
+var creditOverview = require('../lib/credit-overview.js');
 
 
 
@@ -9,3 +10,4 @@ exports.freeAmount = creditInit.freeAmount;
 exports.freeExpiredDays = creditInit.freeExpiredDays;
 exports.freeRegisterAmount = creditInit.freeRegisterAmount;
 exports.oneTimeExpiredDays = creditInit.oneTimeExpiredDays;
+exports.buildCreditOverviewPayload = creditOverview.buildCreditOverviewPayload;

package/dist/credit/server.mjs

@@ -1 +1,2 @@
 export { creditsConfig, freeAmount, freeExpiredDays, freeRegisterAmount, oneTimeExpiredDays } from '../lib/credit-init.mjs';
+export { buildCreditOverviewPayload } from '../lib/credit-overview.mjs';

package/dist/lib/credit-overview.d.ts

@@ -0,0 +1,17 @@
+import type { CreditOverviewData, CreditOverviewTranslations } from '@windrun-huaiin/third-ui/main/credit';
+export interface BuildCreditOverviewPayloadOptions {
+    locale: string;
+    defaultLocale?: string;
+    localePrefixAsNeeded?: boolean;
+    translations: CreditOverviewTranslations;
+    pricingPath?: string;
+    checkoutApiEndpoint?: string;
+    customerPortalApiEndpoint?: string;
+}
+export interface CreditOverviewPayload {
+    data: CreditOverviewData;
+    totalLabel: string;
+    translations: CreditOverviewTranslations;
+}
+export declare function buildCreditOverviewPayload(options: BuildCreditOverviewPayloadOptions): Promise<CreditOverviewPayload | null>;
+//# sourceMappingURL=credit-overview.d.ts.map

package/dist/lib/credit-overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit-overview.d.ts","sourceRoot":"","sources":["../../src/lib/credit-overview.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAE3G,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,YAAY,EAAE,0BAA0B,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,kBAAkB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,0BAA0B,CAAC;CAC1C;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,iCAAiC,GACzC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAuHvC"}

package/dist/lib/credit-overview.js

@@ -0,0 +1,117 @@
+'use strict';
+
+var tslib = require('tslib');
+var authUtils = require('../auth/auth-utils.js');
+var moneyPriceConfig = require('./money-price-config.js');
+require('../prisma/prisma.js');
+require('../core-prisma/client.js');
+var subscription_service = require('../services/database/subscription.service.js');
+var credit_service = require('../services/database/credit.service.js');
+var userContextService = require('../services/context/user-context-service.js');
+var utils = require('@windrun-huaiin/lib/utils');
+var server = require('@windrun-huaiin/third-ui/main/money-price/server');
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+// Fix BigInt serialization issue
+BigInt.prototype.toJSON = function () {
+    return this.toString();
+};
+function buildCreditOverviewPayload(options) {
+    return tslib.__awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        const authUser = yield authUtils.getOptionalServerAuthUser();
+        if (!authUser) {
+            return null;
+        }
+        const { locale, defaultLocale = 'en', localePrefixAsNeeded = true, translations, pricingPath = '/pricing', checkoutApiEndpoint = '/api/stripe/checkout', customerPortalApiEndpoint = '/api/stripe/customer-portal', } = options;
+        const { user } = authUser;
+        const enableSubscriptionUpgrade = process.env.ENABLE_STRIPE_SUBSCRIPTION_UPGRADE !== 'false';
+        const [credit, subscription, moneyPriceData] = yield Promise.all([
+            credit_service.creditService.getCredit(user.userId),
+            subscription_service.subscriptionService.getActiveSubscription(user.userId),
+            server.buildMoneyPriceData({
+                locale,
+                currency: moneyPriceConfig.moneyPriceConfig.display.currency,
+                enabledBillingTypes: ['monthly', 'yearly', 'onetime'],
+            }),
+        ]);
+        if (!credit) {
+            return null;
+        }
+        const initUserContext = userContextService.buildInitUserContextFromEntities({
+            user,
+            credit,
+            subscription,
+        });
+        const totalBalance = ((_a = credit.balanceFree) !== null && _a !== void 0 ? _a : 0) +
+            ((_b = credit.balancePaid) !== null && _b !== void 0 ? _b : 0) +
+            ((_c = credit.balanceOneTimePaid) !== null && _c !== void 0 ? _c : 0);
+        const buckets = [
+            ...(credit.balancePaid > 0
+                ? [{
+                        kind: 'subscription',
+                        balance: credit.balancePaid,
+                        limit: credit.totalPaidLimit,
+                        expiresAt: utils.viewLocalTime(credit.paidEnd),
+                    }]
+                : []),
+            ...(credit.balanceOneTimePaid > 0
+                ? [{
+                        kind: 'onetime',
+                        balance: credit.balanceOneTimePaid,
+                        limit: credit.totalOneTimePaidLimit,
+                        expiresAt: utils.viewLocalTime(credit.oneTimePaidEnd),
+                    }]
+                : []),
+            ...(credit.balanceFree > 0
+                ? [{
+                        kind: 'free',
+                        balance: credit.balanceFree,
+                        limit: credit.totalFreeLimit,
+                        expiresAt: utils.viewLocalTime(credit.freeEnd),
+                    }]
+                : []),
+        ];
+        const pricingPageBaseUrl = utils.getAsNeededLocalizedUrl(locale, pricingPath, localePrefixAsNeeded, defaultLocale);
+        const data = {
+            totalBalance,
+            buckets,
+            pricingContext: {
+                moneyPriceData,
+                moneyPriceConfig: moneyPriceConfig.moneyPriceConfig,
+                checkoutApiEndpoint,
+                customerPortalApiEndpoint,
+                enableSubscriptionUpgrade,
+                initUserContext,
+            },
+            ctaBehaviors: {
+                subscribe: {
+                    desktop: { kind: 'modal', mode: 'subscription' },
+                    mobile: { kind: 'redirect', url: `${pricingPageBaseUrl}?initialBillingType=subscription` },
+                },
+                manage: {
+                    desktop: { kind: 'auth' },
+                    mobile: { kind: 'auth' },
+                },
+                onetime: {
+                    desktop: { kind: 'modal', mode: 'onetime' },
+                    mobile: { kind: 'redirect', url: `${pricingPageBaseUrl}?initialBillingType=onetime` },
+                },
+            },
+        };
+        if (subscription) {
+            data.subscription = {
+                planName: (_d = subscription.priceName) !== null && _d !== void 0 ? _d : '',
+                periodStart: utils.viewLocalTime(subscription.subPeriodStart),
+                periodEnd: utils.viewLocalTime(subscription.subPeriodEnd),
+            };
+        }
+        return {
+            data,
+            totalLabel: translations.totalLabel,
+            translations,
+        };
+    });
+}
+
+exports.buildCreditOverviewPayload = buildCreditOverviewPayload;

package/dist/lib/credit-overview.mjs

@@ -0,0 +1,115 @@
+import { __awaiter } from 'tslib';
+import { getOptionalServerAuthUser } from '../auth/auth-utils.mjs';
+import { moneyPriceConfig } from './money-price-config.mjs';
+import '../prisma/prisma.mjs';
+import '../core-prisma/client.mjs';
+import { subscriptionService } from '../services/database/subscription.service.mjs';
+import { creditService } from '../services/database/credit.service.mjs';
+import { buildInitUserContextFromEntities } from '../services/context/user-context-service.mjs';
+import { viewLocalTime, getAsNeededLocalizedUrl } from '@windrun-huaiin/lib/utils';
+import { buildMoneyPriceData } from '@windrun-huaiin/third-ui/main/money-price/server';
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+// Fix BigInt serialization issue
+BigInt.prototype.toJSON = function () {
+    return this.toString();
+};
+function buildCreditOverviewPayload(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        const authUser = yield getOptionalServerAuthUser();
+        if (!authUser) {
+            return null;
+        }
+        const { locale, defaultLocale = 'en', localePrefixAsNeeded = true, translations, pricingPath = '/pricing', checkoutApiEndpoint = '/api/stripe/checkout', customerPortalApiEndpoint = '/api/stripe/customer-portal', } = options;
+        const { user } = authUser;
+        const enableSubscriptionUpgrade = process.env.ENABLE_STRIPE_SUBSCRIPTION_UPGRADE !== 'false';
+        const [credit, subscription, moneyPriceData] = yield Promise.all([
+            creditService.getCredit(user.userId),
+            subscriptionService.getActiveSubscription(user.userId),
+            buildMoneyPriceData({
+                locale,
+                currency: moneyPriceConfig.display.currency,
+                enabledBillingTypes: ['monthly', 'yearly', 'onetime'],
+            }),
+        ]);
+        if (!credit) {
+            return null;
+        }
+        const initUserContext = buildInitUserContextFromEntities({
+            user,
+            credit,
+            subscription,
+        });
+        const totalBalance = ((_a = credit.balanceFree) !== null && _a !== void 0 ? _a : 0) +
+            ((_b = credit.balancePaid) !== null && _b !== void 0 ? _b : 0) +
+            ((_c = credit.balanceOneTimePaid) !== null && _c !== void 0 ? _c : 0);
+        const buckets = [
+            ...(credit.balancePaid > 0
+                ? [{
+                        kind: 'subscription',
+                        balance: credit.balancePaid,
+                        limit: credit.totalPaidLimit,
+                        expiresAt: viewLocalTime(credit.paidEnd),
+                    }]
+                : []),
+            ...(credit.balanceOneTimePaid > 0
+                ? [{
+                        kind: 'onetime',
+                        balance: credit.balanceOneTimePaid,
+                        limit: credit.totalOneTimePaidLimit,
+                        expiresAt: viewLocalTime(credit.oneTimePaidEnd),
+                    }]
+                : []),
+            ...(credit.balanceFree > 0
+                ? [{
+                        kind: 'free',
+                        balance: credit.balanceFree,
+                        limit: credit.totalFreeLimit,
+                        expiresAt: viewLocalTime(credit.freeEnd),
+                    }]
+                : []),
+        ];
+        const pricingPageBaseUrl = getAsNeededLocalizedUrl(locale, pricingPath, localePrefixAsNeeded, defaultLocale);
+        const data = {
+            totalBalance,
+            buckets,
+            pricingContext: {
+                moneyPriceData,
+                moneyPriceConfig,
+                checkoutApiEndpoint,
+                customerPortalApiEndpoint,
+                enableSubscriptionUpgrade,
+                initUserContext,
+            },
+            ctaBehaviors: {
+                subscribe: {
+                    desktop: { kind: 'modal', mode: 'subscription' },
+                    mobile: { kind: 'redirect', url: `${pricingPageBaseUrl}?initialBillingType=subscription` },
+                },
+                manage: {
+                    desktop: { kind: 'auth' },
+                    mobile: { kind: 'auth' },
+                },
+                onetime: {
+                    desktop: { kind: 'modal', mode: 'onetime' },
+                    mobile: { kind: 'redirect', url: `${pricingPageBaseUrl}?initialBillingType=onetime` },
+                },
+            },
+        };
+        if (subscription) {
+            data.subscription = {
+                planName: (_d = subscription.priceName) !== null && _d !== void 0 ? _d : '',
+                periodStart: viewLocalTime(subscription.subPeriodStart),
+                periodEnd: viewLocalTime(subscription.subPeriodEnd),
+            };
+        }
+        return {
+            data,
+            totalLabel: translations.totalLabel,
+            translations,
+        };
+    });
+}
+
+export { buildCreditOverviewPayload };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/backend-core",
-  "version": "28.0.0",
+  "version": "28.0.1",
   "description": "Shared backend primitives: Prisma schema/client, database services, routing helpers",
   "type": "module",
   "main": "./dist/index.js",
@@ -107,6 +107,16 @@
       "import": "./dist/app/api/user/anonymous/init/route.mjs",
       "require": "./dist/app/api/user/anonymous/init/route.js"
     },
+    "./app/api/user/credit-overview/route": {
+      "types": "./dist/app/api/user/credit-overview/route.d.ts",
+      "import": "./dist/app/api/user/credit-overview/route.mjs",
+      "require": "./dist/app/api/user/credit-overview/route.js"
+    },
+    "./app/api/user/pricing-context/route": {
+      "types": "./dist/app/api/user/pricing-context/route.d.ts",
+      "import": "./dist/app/api/user/pricing-context/route.mjs",
+      "require": "./dist/app/api/user/pricing-context/route.js"
+    },
     "./app/api/stripe/checkout/route": {
       "types": "./dist/app/api/stripe/checkout/route.d.ts",
       "import": "./dist/app/api/stripe/checkout/route.mjs",
@@ -144,8 +154,8 @@
     "tslib": "^2.8.1",
     "zod": "^4.3.6",
     "@windrun-huaiin/contracts": "^28.0.0",
-    "@windrun-huaiin/lib": "^28.0.0",
-    "@windrun-huaiin/third-ui": "^28.0.0"
+    "@windrun-huaiin/third-ui": "^28.0.0",
+    "@windrun-huaiin/lib": "^28.0.0"
   },
   "devDependencies": {
     "@rollup/plugin-alias": "^5.1.1",

package/src/app/api/user/credit-overview/route.ts

@@ -0,0 +1,43 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+// Fix BigInt serialization issue
+(BigInt.prototype as any).toJSON = function () {
+  return this.toString();
+};
+
+import type { CreditOverviewTranslations } from '@windrun-huaiin/third-ui/main/credit';
+import { NextResponse } from 'next/server';
+import { buildCreditOverviewPayload } from '@core/lib/credit-overview';
+
+export type CreditOverviewTranslationsResolver = (
+  locale: string,
+) => CreditOverviewTranslations | Promise<CreditOverviewTranslations>;
+
+export interface CreateGETOptions {
+  defaultLocale?: string;
+  localePrefixAsNeeded?: boolean;
+  resolveTranslations: CreditOverviewTranslationsResolver;
+  pricingPath?: string;
+  checkoutApiEndpoint?: string;
+  customerPortalApiEndpoint?: string;
+}
+
+export function createGET(options: CreateGETOptions) {
+  return async function GET(request: Request) {
+    const { searchParams } = new URL(request.url);
+    const locale = searchParams.get('locale') || options.defaultLocale || 'en';
+    const translations = await options.resolveTranslations(locale);
+
+    const payload = await buildCreditOverviewPayload({
+      locale,
+      defaultLocale: options.defaultLocale,
+      localePrefixAsNeeded: options.localePrefixAsNeeded,
+      translations,
+      pricingPath: options.pricingPath,
+      checkoutApiEndpoint: options.checkoutApiEndpoint,
+      customerPortalApiEndpoint: options.customerPortalApiEndpoint,
+    });
+
+    return NextResponse.json(payload);
+  };
+}

package/src/app/api/user/pricing-context/route.ts

@@ -0,0 +1,14 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+// Fix BigInt serialization issue
+(BigInt.prototype as any).toJSON = function () {
+  return this.toString();
+};
+
+import { getMoneyPriceInitUserContext } from '@core/lib/money-price-helper';
+import { NextResponse } from 'next/server';
+
+export async function GET() {
+  const initUserContext = await getMoneyPriceInitUserContext();
+  return NextResponse.json(initUserContext);
+}

package/src/credit/server.ts

@@ -1 +1,2 @@
 export * from '../lib/credit-init';
+export * from '../lib/credit-overview';

package/src/lib/credit-overview.ts

@@ -0,0 +1,153 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+// Fix BigInt serialization issue
+(BigInt.prototype as any).toJSON = function () {
+  return this.toString();
+};
+
+import { getOptionalServerAuthUser } from '@core/auth/auth-utils';
+import { moneyPriceConfig } from '@core/lib/money-price-config';
+import { creditService, subscriptionService } from '@core/services/database';
+import { buildInitUserContextFromEntities } from '@core/services/context';
+import { getAsNeededLocalizedUrl, viewLocalTime } from '@windrun-huaiin/lib/utils';
+import { buildMoneyPriceData } from '@windrun-huaiin/third-ui/main/money-price/server';
+import type { CreditOverviewData, CreditOverviewTranslations } from '@windrun-huaiin/third-ui/main/credit';
+
+export interface BuildCreditOverviewPayloadOptions {
+  locale: string;
+  defaultLocale?: string;
+  localePrefixAsNeeded?: boolean;
+  translations: CreditOverviewTranslations;
+  pricingPath?: string;
+  checkoutApiEndpoint?: string;
+  customerPortalApiEndpoint?: string;
+}
+
+export interface CreditOverviewPayload {
+  data: CreditOverviewData;
+  totalLabel: string;
+  translations: CreditOverviewTranslations;
+}
+
+export async function buildCreditOverviewPayload(
+  options: BuildCreditOverviewPayloadOptions,
+): Promise<CreditOverviewPayload | null> {
+  const authUser = await getOptionalServerAuthUser();
+
+  if (!authUser) {
+    return null;
+  }
+
+  const {
+    locale,
+    defaultLocale = 'en',
+    localePrefixAsNeeded = true,
+    translations,
+    pricingPath = '/pricing',
+    checkoutApiEndpoint = '/api/stripe/checkout',
+    customerPortalApiEndpoint = '/api/stripe/customer-portal',
+  } = options;
+
+  const { user } = authUser;
+  const enableSubscriptionUpgrade = process.env.ENABLE_STRIPE_SUBSCRIPTION_UPGRADE !== 'false';
+
+  const [credit, subscription, moneyPriceData] = await Promise.all([
+    creditService.getCredit(user.userId),
+    subscriptionService.getActiveSubscription(user.userId),
+    buildMoneyPriceData({
+      locale,
+      currency: moneyPriceConfig.display.currency,
+      enabledBillingTypes: ['monthly', 'yearly', 'onetime'],
+    }),
+  ]);
+
+  if (!credit) {
+    return null;
+  }
+
+  const initUserContext = buildInitUserContextFromEntities({
+    user,
+    credit,
+    subscription,
+  });
+
+  const totalBalance =
+    (credit.balanceFree ?? 0) +
+    (credit.balancePaid ?? 0) +
+    (credit.balanceOneTimePaid ?? 0);
+
+  const buckets = [
+    ...(credit.balancePaid > 0
+      ? [{
+          kind: 'subscription' as const,
+          balance: credit.balancePaid,
+          limit: credit.totalPaidLimit,
+          expiresAt: viewLocalTime(credit.paidEnd),
+        }]
+      : []),
+    ...(credit.balanceOneTimePaid > 0
+      ? [{
+          kind: 'onetime' as const,
+          balance: credit.balanceOneTimePaid,
+          limit: credit.totalOneTimePaidLimit,
+          expiresAt: viewLocalTime(credit.oneTimePaidEnd),
+        }]
+      : []),
+    ...(credit.balanceFree > 0
+      ? [{
+          kind: 'free' as const,
+          balance: credit.balanceFree,
+          limit: credit.totalFreeLimit,
+          expiresAt: viewLocalTime(credit.freeEnd),
+        }]
+      : []),
+  ];
+
+  const pricingPageBaseUrl = getAsNeededLocalizedUrl(
+    locale,
+    pricingPath,
+    localePrefixAsNeeded,
+    defaultLocale,
+  );
+
+  const data: CreditOverviewData = {
+    totalBalance,
+    buckets,
+    pricingContext: {
+      moneyPriceData,
+      moneyPriceConfig,
+      checkoutApiEndpoint,
+      customerPortalApiEndpoint,
+      enableSubscriptionUpgrade,
+      initUserContext,
+    },
+    ctaBehaviors: {
+      subscribe: {
+        desktop: { kind: 'modal', mode: 'subscription' },
+        mobile: { kind: 'redirect', url: `${pricingPageBaseUrl}?initialBillingType=subscription` },
+      },
+      manage: {
+        desktop: { kind: 'auth' },
+        mobile: { kind: 'auth' },
+      },
+      onetime: {
+        desktop: { kind: 'modal', mode: 'onetime' },
+        mobile: { kind: 'redirect', url: `${pricingPageBaseUrl}?initialBillingType=onetime` },
+      },
+    },
+  };
+
+  if (subscription) {
+    data.subscription = {
+      planName: subscription.priceName ?? '',
+      periodStart: viewLocalTime(subscription.subPeriodStart),
+      periodEnd: viewLocalTime(subscription.subPeriodEnd),
+    };
+  }
+
+  return {
+    data,
+    totalLabel: translations.totalLabel,
+    translations,
+  };
+}