Files
halobestie-clone/backend/src/services/payment-icon.service.js
Ramadhan Sjamsani 2c95fd040d Phase 5.x payment revamp + Xendit Stage-8 prep
- Backend wraps idn-finlogos npm at /assets/payment-icons/<slug>.svg with
  1y immutable cache. Mobile drops bundled SVGs (only placeholder remains)
  and fetches via flutter_cache_manager. payment_methods.icon is now a
  CSV of slugs; catalog emits icon_urls[]. CARDS tile renders Visa + MC +
  JCB side by side.
- Per-method min/max amount bounds (BIGINT, nullable). Picker greys out
  out-of-range tiles with subtitle; backend gates with INVALID_PAYMENT_AMOUNT
  (422). Defense in depth against stale-catalog clients.
- Xendit channel codes corrected from authoritative docs
  (BCA_VA -> BCA_VIRTUAL_ACCOUNT, CREDIT_CARD -> CARDS, ovo -> ovo-new,
  shopeepay -> shopee-pay, ...). 18 methods x 5 groups seeded with
  Xendit-published per-channel min/max.
- Re-runnable seed (ON CONFLICT DO NOTHING on payment_code + new unique
  index on group name). Operator CC edits never clobbered across re-runs.
  One-shot reset + inspect scripts under backend/.dev/.
- Customer redirect HTML pages at /payment/return/{success,failure},
  brand-styled with "Buka HaloBestie" CTA firing halobestie:// deeplink.
  URL scheme registered on Android (intent-filter w/ BROWSABLE on
  MainActivity) and iOS (CFBundleURLTypes). Waiting-payment poller still
  owns confirmation; deeplink just brings the activity to foreground.
- Control center payment-catalog page: min/max inputs + columns. Other
  CC pages restyled with new theme tokens (separate work, bundled here).

169/169 backend tests pass. See requirement/phase5-payment-revamp-2026-05-27.md
for the full revamp doc. Stage 8 (E2E) still pending: webhook URL routing
decision + two client_app follow-ups (legacy /chat/request removal,
extension Custom Tab).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-27 21:33:51 +08:00

42 lines
1.5 KiB
JavaScript

/**
* Payment-icon serving — Phase 5.x icon hosting.
*
* Backend wraps the `idn-finlogos` npm package and serves its SVGs at
* `/assets/payment-icons/<slug>.svg`. The catalog endpoint returns
* `icon_url: "/assets/payment-icons/<slug>.svg"`; the client app fetches +
* caches with `flutter_cache_manager`. No bundled icons in the app anymore.
*
* License: idn-finlogos ships under CC-BY-NC-4.0 for the assets (per-brand
* permission still required for production use). Code under MIT. See
* `backend/node_modules/idn-finlogos/LICENSE-ASSETS` + `NOTICE`.
*
* Slug set is loaded ONCE at module init from `dist/icons/*.svg` filenames so
* the request path stays a single Set.has() lookup. Bump the package version
* to add/replace icons; restart the backend to refresh the slug set.
*/
import { readdirSync } from 'fs'
import { dirname, join } from 'path'
import { createRequire } from 'module'
const require = createRequire(import.meta.url)
const PACKAGE_DIR = dirname(require.resolve('idn-finlogos/package.json'))
const ICONS_DIR = join(PACKAGE_DIR, 'dist', 'icons')
const SLUGS = new Set(
readdirSync(ICONS_DIR)
.filter((f) => f.endsWith('.svg'))
.map((f) => f.slice(0, -4)),
)
export const hasIconSlug = (slug) => typeof slug === 'string' && SLUGS.has(slug)
export const resolveIconPath = (slug) => {
if (!hasIconSlug(slug)) return null
return join(ICONS_DIR, `${slug}.svg`)
}
/** Sorted slug list for the CC dropdown. */
export const listIconSlugs = () => Array.from(SLUGS).sort()