@downcity/services 0.1.6

package/bin/balance/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/balance/service.ts"],"names":[],"mappings":"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"}

package/bin/balance/service.js

@@ -0,0 +1,557 @@
+/**
+ * Downcity 官方 Balance 服务实现。
+ *
+ * 设计边界：
+ * - 余额是用户级全局钱包，不与 product 绑定
+ * - 服务只负责账户、流水、充值单、redeem_code 与原子加减款
+ * - 真正的计费策略应由业务方在 hook 中直接调用本服务
+ */
+import { InstallableService, httpError, } from "@downcity/infra";
+import { rawAll, rawFirst, rawRun } from "./raw.js";
+import { registerBalanceRoutes } from "./routes.js";
+import { ACCOUNT_TABLE, LEDGER_TABLE, REDEEM_CODE_TABLE, TOPUP_TABLE, balanceAccounts, balanceLedger, balanceRedeemCodes, balanceTopups, } from "./schema.js";
+import { generateRedeemCode, hashRedeemCode, maskRedeemCode, mergeMetaJSON, normalizeLimit, normalizeNonNegativeInteger, normalizePositiveInteger, normalizeRedeemCode, normalizeRedeemCodeStatus, normalizeText, normalizeUserId, parseAccountRow, parseLedgerRow, parseMetaJSON, parseRedeemCodeRow, parseTopupRow, randomId, readRequired, stringifyMeta, } from "./utils.js";
+/**
+ * Balance 服务实例。
+ *
+ * 业务方应保存返回实例，并在 hook 中直接调用它的 `require()` / `sub()` / `add()`。
+ */
+export class BalanceService extends InstallableService {
+    id = "balance";
+    name = "Balance";
+    version = "0.1.0";
+    schema = {
+        accounts: balanceAccounts,
+        ledger: balanceLedger,
+        topups: balanceTopups,
+        redeem_codes: balanceRedeemCodes,
+    };
+    initAmount;
+    unitName;
+    constructor(options = {}) {
+        super();
+        this.initAmount = normalizeNonNegativeInteger(options.init ?? 0, "init");
+        this.unitName = String(options.unit ?? "credits").trim() || "credits";
+        this.instruction = [
+            "提供用户级全局余额、余额流水、充值单与 redeem_code 能力。",
+            `当前余额单位为 ${this.unitName}，首次自动开户发放 ${this.initAmount} ${this.unitName}。`,
+            "推荐在业务 hook 中调用 require/add/sub，把具体计费策略放在业务侧，而不是写死在服务内部。",
+            "管理端可查询所有账户、流水、充值单与 redeem_code；用户侧可查询自己的余额、历史记录、充值单，并直接兑换 redeem_code。",
+        ].join("\n");
+    }
+    install(ctx) {
+        registerBalanceRoutes(this, ctx);
+    }
+    /**
+     * 读取用户余额。
+     *
+     * 若账户不存在，会自动开户并按配置发放初始余额。
+     */
+    async read(user_id) {
+        const normalizedUserId = normalizeUserId(user_id);
+        await this.ensureAccount(normalizedUserId);
+        return await this.readAccountRequired(normalizedUserId);
+    }
+    /**
+     * 检查用户余额是否足够。
+     *
+     * 余额不足时会抛出 `402 insufficient balance`。
+     */
+    async require(user_id, amount) {
+        const normalizedUserId = normalizeUserId(user_id);
+        const normalizedAmount = normalizePositiveInteger(amount, "amount");
+        const account = await this.read(normalizedUserId);
+        if (account.balance < normalizedAmount) {
+            throw httpError(402, `insufficient balance: need ${normalizedAmount}, current ${account.balance}`);
+        }
+        return account;
+    }
+    /**
+     * 给用户加余额，并写入 `add` 流水。
+     */
+    async add(user_id, amount, extra = {}) {
+        return await this.applyDelta(normalizeUserId(user_id), normalizePositiveInteger(amount, "amount"), "add", extra);
+    }
+    /**
+     * 给用户扣余额，并写入 `sub` 流水。
+     */
+    async sub(user_id, amount, extra = {}) {
+        return await this.applyDelta(normalizeUserId(user_id), -normalizePositiveInteger(amount, "amount"), "sub", extra);
+    }
+    /**
+     * 查询某个用户的流水。
+     */
+    async history(user_id, limit) {
+        return await this.listHistory({
+            user_id: normalizeUserId(user_id),
+            limit,
+        });
+    }
+    /**
+     * 读取一笔充值单。
+     *
+     * 关键说明（中文）
+     * - 这是给支付桥接层使用的公开只读能力
+     * - 充值单的状态流转仍然只能通过 finishTopup / cancelTopup 完成
+     */
+    async readTopup(topup_id) {
+        return await this.readTopupRequired(readRequired(topup_id, "topup_id"));
+    }
+    /**
+     * 创建充值单。
+     *
+     * 这一步不会直接入账，只会生成 `pending` 充值单。
+     */
+    async createTopup(user_id, amount, extra = {}) {
+        const normalizedUserId = normalizeUserId(user_id);
+        const normalizedAmount = normalizePositiveInteger(amount, "amount");
+        const now = new Date().toISOString();
+        const topup = {
+            topup_id: `topup_${randomId()}`,
+            user_id: normalizedUserId,
+            amount: normalizedAmount,
+            unit: this.unitName,
+            status: "pending",
+            note: normalizeText(extra.note),
+            ref: normalizeText(extra.ref),
+            metadata_json: stringifyMeta(extra.meta),
+            created_at: now,
+            updated_at: now,
+        };
+        await this.ensureAccount(normalizedUserId);
+        await rawRun(this.resolveRaw(), [
+            `INSERT INTO ${TOPUP_TABLE} (topup_id, user_id, amount, unit, status, note, ref, metadata_json, created_at, updated_at)`,
+            "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)",
+        ].join(" "), [
+            topup.topup_id,
+            topup.user_id,
+            topup.amount,
+            topup.unit,
+            topup.status,
+            topup.note,
+            topup.ref,
+            topup.metadata_json,
+            topup.created_at,
+            topup.updated_at,
+        ]);
+        return topup;
+    }
+    /**
+     * 将充值单标记为完成，并真正给用户加余额。
+     */
+    async finishTopup(topup_id, extra = {}) {
+        const current = await this.readTopupRequired(topup_id);
+        if (current.status !== "pending") {
+            throw httpError(409, `topup is already ${current.status}`);
+        }
+        const now = new Date().toISOString();
+        const changed = await rawRun(this.resolveRaw(), [
+            `UPDATE ${TOPUP_TABLE}`,
+            "SET status = ?, updated_at = ?, note = ?, ref = ?, metadata_json = ?",
+            "WHERE topup_id = ? AND status = ?",
+        ].join(" "), [
+            "paid",
+            now,
+            normalizeText(extra.note) || current.note,
+            normalizeText(extra.ref) || current.ref,
+            mergeMetaJSON(current.metadata_json, extra.meta),
+            topup_id,
+            "pending",
+        ]);
+        if (changed === 0) {
+            throw httpError(409, "topup is no longer pending");
+        }
+        await this.applyDelta(current.user_id, current.amount, "topup", {
+            note: normalizeText(extra.note) || current.note || "topup",
+            ref: normalizeText(extra.ref) || topup_id,
+            meta: {
+                ...(parseMetaJSON(current.metadata_json)),
+                ...(extra.meta ?? {}),
+                topup_id,
+            },
+        });
+        return await this.readTopupRequired(topup_id);
+    }
+    /**
+     * 取消待处理充值单。
+     */
+    async cancelTopup(topup_id, extra = {}) {
+        const current = await this.readTopupRequired(topup_id);
+        if (current.status !== "pending") {
+            throw httpError(409, `topup is already ${current.status}`);
+        }
+        const changed = await rawRun(this.resolveRaw(), [
+            `UPDATE ${TOPUP_TABLE}`,
+            "SET status = ?, updated_at = ?, note = ?, ref = ?, metadata_json = ?",
+            "WHERE topup_id = ? AND status = ?",
+        ].join(" "), [
+            "canceled",
+            new Date().toISOString(),
+            normalizeText(extra.note) || current.note,
+            normalizeText(extra.ref) || current.ref,
+            mergeMetaJSON(current.metadata_json, extra.meta),
+            topup_id,
+            "pending",
+        ]);
+        if (changed === 0) {
+            throw httpError(409, "topup is no longer pending");
+        }
+        return await this.readTopupRequired(topup_id);
+    }
+    /**
+     * 创建一个新的 redeem_code。
+     */
+    async createRedeemCode(input) {
+        const amount = normalizePositiveInteger(input.amount, "amount");
+        const now = new Date().toISOString();
+        const code = input.code ? normalizeRedeemCode(input.code) : generateRedeemCode();
+        const codeHash = await hashRedeemCode(code);
+        if (await this.readRedeemCodeByHash(codeHash)) {
+            throw httpError(409, "redeem_code already exists");
+        }
+        const redeemCode = {
+            redeem_code_id: `rc_${randomId()}`,
+            amount,
+            unit: this.unitName,
+            status: "active",
+            code_mask: maskRedeemCode(code),
+            note: normalizeText(input.note),
+            ref: normalizeText(input.ref),
+            metadata_json: stringifyMeta(input.meta),
+            redeemed_by_user_id: "",
+            redeemed_at: "",
+            created_at: now,
+            updated_at: now,
+        };
+        await rawRun(this.resolveRaw(), [
+            `INSERT INTO ${REDEEM_CODE_TABLE} (redeem_code_id, code_hash, code_mask, amount, unit, status, note, ref, metadata_json, redeemed_by_user_id, redeemed_at, created_at, updated_at)`,
+            "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)",
+        ].join(" "), [
+            redeemCode.redeem_code_id,
+            codeHash,
+            redeemCode.code_mask,
+            redeemCode.amount,
+            redeemCode.unit,
+            redeemCode.status,
+            redeemCode.note,
+            redeemCode.ref,
+            redeemCode.metadata_json,
+            redeemCode.redeemed_by_user_id,
+            redeemCode.redeemed_at,
+            redeemCode.created_at,
+            redeemCode.updated_at,
+        ]);
+        return {
+            ...redeemCode,
+            code,
+        };
+    }
+    /**
+     * 用户兑换 redeem_code，并立刻给余额入账。
+     */
+    async redeemCode(user_id, code, extra = {}) {
+        const normalizedUserId = normalizeUserId(user_id);
+        const normalizedCode = normalizeRedeemCode(code);
+        const codeHash = await hashRedeemCode(normalizedCode);
+        const current = await this.readRedeemCodeByHash(codeHash);
+        if (!current) {
+            throw httpError(404, "redeem_code not found");
+        }
+        if (current.status !== "active") {
+            throw httpError(409, `redeem_code is already ${current.status}`);
+        }
+        const now = new Date().toISOString();
+        const changed = await rawRun(this.resolveRaw(), [
+            `UPDATE ${REDEEM_CODE_TABLE}`,
+            "SET status = ?, redeemed_by_user_id = ?, redeemed_at = ?, updated_at = ?, note = ?, ref = ?, metadata_json = ?",
+            "WHERE redeem_code_id = ? AND status = ?",
+        ].join(" "), [
+            "redeemed",
+            normalizedUserId,
+            now,
+            now,
+            normalizeText(extra.note) || current.note,
+            normalizeText(extra.ref) || current.ref,
+            mergeMetaJSON(current.metadata_json, extra.meta),
+            current.redeem_code_id,
+            "active",
+        ]);
+        if (changed === 0) {
+            const latest = await this.readRedeemCodeRequired(current.redeem_code_id);
+            throw httpError(409, `redeem_code is already ${latest.status}`);
+        }
+        const account = await this.applyDelta(normalizedUserId, current.amount, "redeem", {
+            note: normalizeText(extra.note) || current.note || "redeem_code",
+            ref: normalizeText(extra.ref) || current.redeem_code_id,
+            meta: {
+                ...(parseMetaJSON(current.metadata_json)),
+                ...(extra.meta ?? {}),
+                redeem_code_id: current.redeem_code_id,
+                code_mask: current.code_mask,
+            },
+        });
+        return {
+            account,
+            redeem_code: await this.readRedeemCodeRequired(current.redeem_code_id),
+        };
+    }
+    /**
+     * 停用一个尚未兑换的 redeem_code。
+     */
+    async disableRedeemCode(redeem_code_id, extra = {}) {
+        const current = await this.readRedeemCodeRequired(redeem_code_id);
+        if (current.status !== "active") {
+            throw httpError(409, `redeem_code is already ${current.status}`);
+        }
+        const changed = await rawRun(this.resolveRaw(), [
+            `UPDATE ${REDEEM_CODE_TABLE}`,
+            "SET status = ?, updated_at = ?, note = ?, ref = ?, metadata_json = ?",
+            "WHERE redeem_code_id = ? AND status = ?",
+        ].join(" "), [
+            "disabled",
+            new Date().toISOString(),
+            normalizeText(extra.note) || current.note,
+            normalizeText(extra.ref) || current.ref,
+            mergeMetaJSON(current.metadata_json, extra.meta),
+            redeem_code_id,
+            "active",
+        ]);
+        if (changed === 0) {
+            throw httpError(409, "redeem_code is no longer active");
+        }
+        return await this.readRedeemCodeRequired(redeem_code_id);
+    }
+    /**
+     * 列出余额账户。
+     */
+    async listUsers(limit) {
+        const rows = await rawAll(this.resolveRaw(), [
+            `SELECT user_id, balance, unit, created_at, updated_at FROM ${ACCOUNT_TABLE}`,
+            "ORDER BY updated_at DESC",
+            "LIMIT ?",
+        ].join(" "), [normalizeLimit(limit)]);
+        return rows.map(parseAccountRow);
+    }
+    /**
+     * 列出流水。
+     */
+    async listHistory(query = {}) {
+        const params = [];
+        const where = query.user_id
+            ? (() => {
+                params.push(normalizeUserId(query.user_id));
+                return "WHERE user_id = ?";
+            })()
+            : "";
+        const rows = await rawAll(this.resolveRaw(), [
+            `SELECT entry_id, user_id, kind, amount, balance_after, unit, note, ref, metadata_json, created_at FROM ${LEDGER_TABLE}`,
+            where,
+            "ORDER BY created_at DESC, rowid DESC",
+            "LIMIT ?",
+        ].join(" "), [...params, normalizeLimit(query.limit)]);
+        return rows.map(parseLedgerRow);
+    }
+    /**
+     * 列出充值单。
+     */
+    async listTopups(query = {}) {
+        const params = [];
+        const where = query.user_id
+            ? (() => {
+                params.push(normalizeUserId(query.user_id));
+                return "WHERE user_id = ?";
+            })()
+            : "";
+        const rows = await rawAll(this.resolveRaw(), [
+            `SELECT topup_id, user_id, amount, unit, status, note, ref, metadata_json, created_at, updated_at FROM ${TOPUP_TABLE}`,
+            where,
+            "ORDER BY created_at DESC",
+            "LIMIT ?",
+        ].join(" "), [...params, normalizeLimit(query.limit)]);
+        return rows.map(parseTopupRow);
+    }
+    /**
+     * 列出 redeem_code。
+     */
+    async listRedeemCodes(query = {}) {
+        const params = [];
+        const clauses = [];
+        const status = normalizeRedeemCodeStatus(query.status);
+        if (query.user_id) {
+            clauses.push("redeemed_by_user_id = ?");
+            params.push(normalizeUserId(query.user_id));
+        }
+        if (status) {
+            clauses.push("status = ?");
+            params.push(status);
+        }
+        const where = clauses.length > 0 ? `WHERE ${clauses.join(" AND ")}` : "";
+        const rows = await rawAll(this.resolveRaw(), [
+            `SELECT redeem_code_id, amount, unit, status, code_mask, note, ref, metadata_json, redeemed_by_user_id, redeemed_at, created_at, updated_at FROM ${REDEEM_CODE_TABLE}`,
+            where,
+            "ORDER BY created_at DESC",
+            "LIMIT ?",
+        ].join(" "), [...params, normalizeLimit(query.limit)]);
+        return rows.map(parseRedeemCodeRow);
+    }
+    /**
+     * 关键说明（中文）
+     * - 正数表示加款，负数表示扣款
+     * - 扣款走 SQL 条件更新，避免把余额扣成负数
+     * - 扣费策略本身不写在服务里，而是由业务 hook 调用本方法
+     */
+    async applyDelta(user_id, delta, kind, extra) {
+        if (!Number.isInteger(delta) || delta === 0) {
+            throw new TypeError("delta must be a non-zero integer");
+        }
+        await this.ensureAccount(user_id);
+        const now = new Date().toISOString();
+        if (delta > 0) {
+            await rawRun(this.resolveRaw(), [
+                `UPDATE ${ACCOUNT_TABLE}`,
+                "SET balance = balance + ?, updated_at = ?",
+                "WHERE user_id = ?",
+            ].join(" "), [delta, now, user_id]);
+        }
+        else {
+            const spend = Math.abs(delta);
+            const changed = await rawRun(this.resolveRaw(), [
+                `UPDATE ${ACCOUNT_TABLE}`,
+                "SET balance = balance - ?, updated_at = ?",
+                "WHERE user_id = ? AND balance >= ?",
+            ].join(" "), [spend, now, user_id, spend]);
+            if (changed === 0) {
+                const current = await this.readAccountRequired(user_id);
+                throw httpError(402, `insufficient balance: need ${spend}, current ${current.balance}`);
+            }
+        }
+        const account = await this.readAccountRequired(user_id);
+        await this.insertLedger({
+            entry_id: `bal_${randomId()}`,
+            user_id,
+            kind,
+            amount: delta,
+            balance_after: account.balance,
+            unit: account.unit,
+            note: normalizeText(extra.note),
+            ref: normalizeText(extra.ref),
+            metadata_json: stringifyMeta(extra.meta),
+            created_at: now,
+        });
+        return account;
+    }
+    /**
+     * 首次见到某用户时自动开户。
+     */
+    async ensureAccount(user_id) {
+        const now = new Date().toISOString();
+        const inserted = await rawRun(this.resolveRaw(), [
+            `INSERT OR IGNORE INTO ${ACCOUNT_TABLE} (user_id, balance, unit, created_at, updated_at)`,
+            "VALUES (?, ?, ?, ?, ?)",
+        ].join(" "), [user_id, this.initAmount, this.unitName, now, now]);
+        if (inserted > 0 && this.initAmount > 0) {
+            await this.insertLedger({
+                entry_id: `bal_${randomId()}`,
+                user_id,
+                kind: "init",
+                amount: this.initAmount,
+                balance_after: this.initAmount,
+                unit: this.unitName,
+                note: "initial balance",
+                ref: "",
+                metadata_json: "{}",
+                created_at: now,
+            });
+        }
+    }
+    /**
+     * 读取账户；不存在时报错。
+     */
+    async readAccountRequired(user_id) {
+        const row = await rawFirst(this.resolveRaw(), [
+            `SELECT user_id, balance, unit, created_at, updated_at FROM ${ACCOUNT_TABLE}`,
+            "WHERE user_id = ?",
+        ].join(" "), [user_id]);
+        if (!row) {
+            throw httpError(404, `balance account not found for user ${user_id}`);
+        }
+        return parseAccountRow(row);
+    }
+    /**
+     * 读取充值单；不存在时报错。
+     */
+    async readTopupRequired(topup_id) {
+        const row = await rawFirst(this.resolveRaw(), [
+            `SELECT topup_id, user_id, amount, unit, status, note, ref, metadata_json, created_at, updated_at FROM ${TOPUP_TABLE}`,
+            "WHERE topup_id = ?",
+        ].join(" "), [readRequired(topup_id, "topup_id")]);
+        if (!row) {
+            throw httpError(404, `topup not found: ${topup_id}`);
+        }
+        return parseTopupRow(row);
+    }
+    /**
+     * 按 ID 读取 redeem_code；不存在时报错。
+     */
+    async readRedeemCodeRequired(redeem_code_id) {
+        const row = await rawFirst(this.resolveRaw(), [
+            `SELECT redeem_code_id, amount, unit, status, code_mask, note, ref, metadata_json, redeemed_by_user_id, redeemed_at, created_at, updated_at FROM ${REDEEM_CODE_TABLE}`,
+            "WHERE redeem_code_id = ?",
+        ].join(" "), [readRequired(redeem_code_id, "redeem_code_id")]);
+        if (!row) {
+            throw httpError(404, `redeem_code not found: ${redeem_code_id}`);
+        }
+        return parseRedeemCodeRow(row);
+    }
+    /**
+     * 按哈希读取 redeem_code；不存在时返回空。
+     */
+    async readRedeemCodeByHash(codeHash) {
+        const row = await rawFirst(this.resolveRaw(), [
+            `SELECT redeem_code_id, code_hash, amount, unit, status, code_mask, note, ref, metadata_json, redeemed_by_user_id, redeemed_at, created_at, updated_at FROM ${REDEEM_CODE_TABLE}`,
+            "WHERE code_hash = ?",
+        ].join(" "), [readRequired(codeHash, "code_hash")]);
+        return row
+            ? {
+                ...parseRedeemCodeRow(row),
+                code_hash: String(row.code_hash),
+            }
+            : undefined;
+    }
+    /**
+     * 写入流水。
+     */
+    async insertLedger(entry) {
+        await rawRun(this.resolveRaw(), [
+            `INSERT INTO ${LEDGER_TABLE} (entry_id, user_id, kind, amount, balance_after, unit, note, ref, metadata_json, created_at)`,
+            "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)",
+        ].join(" "), [
+            entry.entry_id,
+            entry.user_id,
+            entry.kind,
+            entry.amount,
+            entry.balance_after,
+            entry.unit,
+            entry.note,
+            entry.ref,
+            entry.metadata_json,
+            entry.created_at,
+        ]);
+    }
+    /**
+     * 拿到底层原始数据库对象。
+     */
+    resolveRaw() {
+        if (!this._raw) {
+            throw new Error("balance service raw database is not ready");
+        }
+        return this._raw;
+    }
+}
+/**
+ * 创建 Balance 服务实例。
+ */
+export function balanceService(options = {}) {
+    return new BalanceService(options);
+}
+//# sourceMappingURL=service.js.map

package/bin/balance/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/balance/service.ts"],"names":[],"mappings":"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"}