@downcity/services 0.1.59 → 0.1.62

package/bin/billing/service.js

@@ -0,0 +1,457 @@
+/**
+ * Downcity 官方 Billing 服务实现。
+ *
+ * 设计边界：
+ * - usage 负责记录事实，billing 负责把事实换算成 charge
+ * - balance 负责真正的钱包扣减与流水
+ * - pricing rule 使用 microcredits，1 credit = 1 USD = 1_000_000 microcredits
+ */
+import { InstallableService, } from "@downcity/city";
+import { rawAll, rawFirst, rawRun } from "../balance/raw.js";
+import { microcreditsToCredits } from "../balance/amount.js";
+import { billingCharges, billingPricingRules, CHARGE_TABLE, PRICING_RULE_TABLE } from "./schema.js";
+import { registerBillingRoutes } from "./routes.js";
+const TOKENS_PER_MTOKEN = 1_000_000;
+const PRICING_RULE_COLUMNS = [
+    "rule_id",
+    "service_id",
+    "action_id",
+    "model_id",
+    "provider_id",
+    "request_microcredits",
+    "input_token_microcredits",
+    "input_mtoken_microcredits",
+    "output_token_microcredits",
+    "output_mtoken_microcredits",
+    "cached_token_microcredits",
+    "cached_mtoken_microcredits",
+    "image_microcredits",
+    "status",
+    "note",
+    "created_at",
+    "updated_at",
+].join(", ");
+const PRICING_RULE_MTOKEN_COLUMNS = [
+    "input_mtoken_microcredits",
+    "output_mtoken_microcredits",
+    "cached_mtoken_microcredits",
+];
+/**
+ * Billing 服务实例。
+ */
+export class BillingService extends InstallableService {
+    id = "billing";
+    name = "Billing";
+    version = "0.1.0";
+    schema = {
+        pricing_rules: billingPricingRules,
+        charges: billingCharges,
+    };
+    balance;
+    initialRules;
+    requireBeforeCall;
+    constructor(options) {
+        super();
+        this.balance = options.balance;
+        this.initialRules = options.pricing_rules ?? [];
+        this.requireBeforeCall = options.require_before_call !== false;
+        this.instruction = [
+            "根据 service 调用的标准 metering 计算扣费，并通过 balance 执行 microcredits 扣款。",
+            "pricing rule 使用 microcredits：1 credit = 1 USD = 1_000_000 microcredits。",
+            "Billing 不负责 provider 调用，也不替代 usage 事实层。",
+        ].join("\n");
+    }
+    async _onInit() {
+        await super._onInit();
+        await this.ensurePricingRuleColumns();
+        for (const rule of this.initialRules) {
+            await this.upsertPricingRule(rule);
+        }
+    }
+    install(ctx) {
+        registerBillingRoutes(this, ctx);
+        if (this.requireBeforeCall) {
+            ctx.hook.before(async (serviceCtx) => {
+                if (!shouldBill(serviceCtx))
+                    return;
+                const rule = await this.resolvePricingRule(serviceCtx);
+                if (!rule)
+                    return;
+                const amount_microcredits = calculateChargeAmount(serviceCtx, rule, { estimate: true });
+                if (amount_microcredits <= 0)
+                    return;
+                await this.balance.requireMicrocredits(serviceCtx.user.user_id, amount_microcredits);
+            });
+        }
+        ctx.hook.after(async (serviceCtx) => {
+            if (!shouldBill(serviceCtx))
+                return;
+            if (!isSuccessfulOutput(serviceCtx.output))
+                return;
+            await this.settle(serviceCtx);
+        });
+    }
+    /**
+     * 新增或更新 pricing rule。
+     */
+    async upsertPricingRule(input) {
+        const now = new Date().toISOString();
+        const rule = normalizePricingRule(input, now);
+        const existing = await this.readPricingRule(rule.rule_id);
+        if (existing) {
+            await rawRun(this.resolveRaw(), [
+                `UPDATE ${PRICING_RULE_TABLE}`,
+                "SET service_id = ?, action_id = ?, model_id = ?, provider_id = ?, request_microcredits = ?, input_token_microcredits = ?, input_mtoken_microcredits = ?, output_token_microcredits = ?, output_mtoken_microcredits = ?, cached_token_microcredits = ?, cached_mtoken_microcredits = ?, image_microcredits = ?, status = ?, note = ?, updated_at = ?",
+                "WHERE rule_id = ?",
+            ].join(" "), [
+                rule.service_id,
+                rule.action_id,
+                rule.model_id,
+                rule.provider_id,
+                rule.request_microcredits,
+                rule.input_token_microcredits,
+                rule.input_mtoken_microcredits,
+                rule.output_token_microcredits,
+                rule.output_mtoken_microcredits,
+                rule.cached_token_microcredits,
+                rule.cached_mtoken_microcredits,
+                rule.image_microcredits,
+                rule.status,
+                rule.note,
+                now,
+                rule.rule_id,
+            ]);
+            return await this.readPricingRuleRequired(rule.rule_id);
+        }
+        await rawRun(this.resolveRaw(), [
+            `INSERT INTO ${PRICING_RULE_TABLE} (${PRICING_RULE_COLUMNS})`,
+            "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)",
+        ].join(" "), [
+            rule.rule_id,
+            rule.service_id,
+            rule.action_id,
+            rule.model_id,
+            rule.provider_id,
+            rule.request_microcredits,
+            rule.input_token_microcredits,
+            rule.input_mtoken_microcredits,
+            rule.output_token_microcredits,
+            rule.output_mtoken_microcredits,
+            rule.cached_token_microcredits,
+            rule.cached_mtoken_microcredits,
+            rule.image_microcredits,
+            rule.status,
+            rule.note,
+            rule.created_at,
+            rule.updated_at,
+        ]);
+        return await this.readPricingRuleRequired(rule.rule_id);
+    }
+    /**
+     * 列出 pricing rules。
+     */
+    async listPricingRules(query = {}) {
+        const rows = await rawAll(this.resolveRaw(), [
+            `SELECT ${PRICING_RULE_COLUMNS} FROM ${PRICING_RULE_TABLE}`,
+            "ORDER BY updated_at DESC, rowid DESC",
+            "LIMIT ?",
+        ].join(" "), [normalizeLimit(query.limit)]);
+        return rows.map(parsePricingRuleRow);
+    }
+    /**
+     * 列出 charge。
+     */
+    async listCharges(query = {}) {
+        const params = [];
+        const clauses = [];
+        if (query.user_id) {
+            clauses.push("user_id = ?");
+            params.push(String(query.user_id));
+        }
+        if (query.town_id) {
+            clauses.push("town_id = ?");
+            params.push(String(query.town_id));
+        }
+        const where = clauses.length > 0 ? `WHERE ${clauses.join(" AND ")}` : "";
+        const rows = await rawAll(this.resolveRaw(), [
+            `SELECT charge_id, user_id, town_id, service_id, action_id, model_id, provider_id, rule_id, amount_microcredits, status, note, metadata_json, created_at FROM ${CHARGE_TABLE}`,
+            where,
+            "ORDER BY created_at DESC, rowid DESC",
+            "LIMIT ?",
+        ].join(" "), [...params, normalizeLimit(query.limit)]);
+        return rows.map(parseChargeRow);
+    }
+    /**
+     * 对当前 service 调用执行结算。
+     */
+    async settle(ctx) {
+        const rule = await this.resolvePricingRule(ctx);
+        if (!rule)
+            return undefined;
+        const amount_microcredits = calculateChargeAmount(ctx, rule, { estimate: false });
+        if (amount_microcredits <= 0)
+            return undefined;
+        const charge = await this.createCharge(ctx, rule, amount_microcredits);
+        await this.balance.subMicrocredits(ctx.user.user_id, amount_microcredits, {
+            note: charge.note,
+            ref: charge.charge_id,
+            meta: {
+                charge_id: charge.charge_id,
+                service_id: charge.service_id,
+                action_id: charge.action_id,
+                model_id: charge.model_id,
+                provider_id: charge.provider_id,
+                rule_id: charge.rule_id,
+                metering: ctx.metering ?? {},
+            },
+        });
+        return charge;
+    }
+    async createCharge(ctx, rule, amount_microcredits) {
+        const now = new Date().toISOString();
+        const charge = {
+            charge_id: `chg_${randomId()}`,
+            user_id: ctx.user?.user_id ?? "",
+            town_id: ctx.town?.town_id ?? "",
+            service_id: ctx.service?.id ?? "",
+            action_id: ctx.action?.id ?? "",
+            model_id: ctx.variant?.id ?? ctx.metering?.model_id ?? "",
+            provider_id: ctx.metering?.provider_id ?? "",
+            rule_id: rule.rule_id,
+            amount: microcreditsToCredits(amount_microcredits),
+            amount_microcredits,
+            status: "settled",
+            note: `${ctx.service?.id ?? "service"} ${ctx.action?.id ?? "action"}`,
+            metadata_json: JSON.stringify({
+                metering: ctx.metering ?? {},
+                pricing_rule: rule.rule_id,
+            }),
+            created_at: now,
+        };
+        await rawRun(this.resolveRaw(), [
+            `INSERT INTO ${CHARGE_TABLE} (charge_id, user_id, town_id, service_id, action_id, model_id, provider_id, rule_id, amount_microcredits, status, note, metadata_json, created_at)`,
+            "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)",
+        ].join(" "), [
+            charge.charge_id,
+            charge.user_id,
+            charge.town_id,
+            charge.service_id,
+            charge.action_id,
+            charge.model_id,
+            charge.provider_id,
+            charge.rule_id,
+            charge.amount_microcredits,
+            charge.status,
+            charge.note,
+            charge.metadata_json,
+            charge.created_at,
+        ]);
+        return charge;
+    }
+    async resolvePricingRule(ctx) {
+        const rules = (await this.listPricingRules({ limit: 200 }))
+            .filter((rule) => rule.status === "active")
+            .filter((rule) => matchesRule(rule.service_id, ctx.service?.id ?? ""))
+            .filter((rule) => matchesRule(rule.action_id, ctx.action?.id ?? ""))
+            .filter((rule) => matchesRule(rule.model_id, ctx.variant?.id ?? ctx.metering?.model_id ?? ""))
+            .filter((rule) => matchesRule(rule.provider_id, ctx.metering?.provider_id ?? ""));
+        return rules.sort((a, b) => scoreRule(b) - scoreRule(a))[0];
+    }
+    async readPricingRule(rule_id) {
+        const row = await rawFirst(this.resolveRaw(), [
+            `SELECT ${PRICING_RULE_COLUMNS} FROM ${PRICING_RULE_TABLE}`,
+            "WHERE rule_id = ?",
+        ].join(" "), [rule_id]);
+        return row ? parsePricingRuleRow(row) : undefined;
+    }
+    async readPricingRuleRequired(rule_id) {
+        const row = await this.readPricingRule(rule_id);
+        if (!row)
+            throw new Error(`pricing rule not found: ${rule_id}`);
+        return row;
+    }
+    async ensurePricingRuleColumns() {
+        for (const column of PRICING_RULE_MTOKEN_COLUMNS) {
+            try {
+                await rawRun(this.resolveRaw(), `ALTER TABLE ${PRICING_RULE_TABLE} ADD COLUMN ${column} INTEGER NOT NULL DEFAULT 0`, []);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                if (!/duplicate column|already exists/i.test(message))
+                    throw error;
+            }
+        }
+    }
+    resolveRaw() {
+        if (!this._raw) {
+            throw new Error("billing service raw database is not ready");
+        }
+        return this._raw;
+    }
+}
+/**
+ * 创建 Billing 服务实例。
+ */
+export function billingService(options) {
+    return new BillingService(options);
+}
+/**
+ * 是否应该对当前调用计费。
+ */
+function shouldBill(ctx) {
+    return Boolean(ctx.identity?.kind === "user" && ctx.user?.user_id && ctx.town?.town_id && ctx.service?.id !== "billing");
+}
+/**
+ * 判断输出是否成功。
+ */
+function isSuccessfulOutput(output) {
+    return !(output instanceof Response) || output.status < 400;
+}
+/**
+ * 计算扣费金额。
+ */
+function calculateChargeAmount(ctx, rule, options) {
+    const metering = ctx.metering ?? {};
+    const request_count = Number(metering.request_count ?? 1);
+    const input_tokens = options.estimate ? 0 : Number(metering.input_tokens ?? 0);
+    const output_tokens = options.estimate ? 0 : Number(metering.output_tokens ?? 0);
+    const cached_tokens = options.estimate ? 0 : Number(metering.cached_tokens ?? 0);
+    const image_count = options.estimate ? 0 : Number(metering.image_count ?? 0);
+    const total = request_count * rule.request_microcredits
+        + input_tokens * rule.input_token_microcredits
+        + (input_tokens * rule.input_mtoken_microcredits) / TOKENS_PER_MTOKEN
+        + output_tokens * rule.output_token_microcredits
+        + (output_tokens * rule.output_mtoken_microcredits) / TOKENS_PER_MTOKEN
+        + cached_tokens * rule.cached_token_microcredits
+        + (cached_tokens * rule.cached_mtoken_microcredits) / TOKENS_PER_MTOKEN
+        + image_count * rule.image_microcredits;
+    return Number.isFinite(total) && total > 0 ? Math.ceil(total) : 0;
+}
+/**
+ * 规则字段为空时表示 fallback。
+ */
+function matchesRule(rule_value, actual_value) {
+    return !rule_value || rule_value === actual_value;
+}
+/**
+ * 规则越具体优先级越高。
+ */
+function scoreRule(rule) {
+    return [
+        rule.service_id,
+        rule.action_id,
+        rule.model_id,
+        rule.provider_id,
+    ].filter(Boolean).length;
+}
+/**
+ * 标准化 pricing rule。
+ */
+function normalizePricingRule(input, now) {
+    const service_id = normalizeText(input.service_id ?? "ai");
+    const action_id = normalizeText(input.action_id ?? "");
+    const model_id = normalizeText(input.model_id ?? "");
+    const provider_id = normalizeText(input.provider_id ?? "");
+    return {
+        rule_id: normalizeText(input.rule_id) || `price_${randomId()}`,
+        service_id,
+        action_id,
+        model_id,
+        provider_id,
+        request_microcredits: normalizeNonNegativeInteger(input.request_microcredits ?? 0, "request_microcredits"),
+        input_token_microcredits: normalizeNonNegativeInteger(input.input_token_microcredits ?? 0, "input_token_microcredits"),
+        input_mtoken_microcredits: normalizeNonNegativeInteger(input.input_mtoken_microcredits ?? 0, "input_mtoken_microcredits"),
+        output_token_microcredits: normalizeNonNegativeInteger(input.output_token_microcredits ?? 0, "output_token_microcredits"),
+        output_mtoken_microcredits: normalizeNonNegativeInteger(input.output_mtoken_microcredits ?? 0, "output_mtoken_microcredits"),
+        cached_token_microcredits: normalizeNonNegativeInteger(input.cached_token_microcredits ?? 0, "cached_token_microcredits"),
+        cached_mtoken_microcredits: normalizeNonNegativeInteger(input.cached_mtoken_microcredits ?? 0, "cached_mtoken_microcredits"),
+        image_microcredits: normalizeNonNegativeInteger(input.image_microcredits ?? 0, "image_microcredits"),
+        status: input.status === "disabled" ? "disabled" : "active",
+        note: normalizeText(input.note),
+        created_at: now,
+        updated_at: now,
+    };
+}
+/**
+ * 解析 pricing rule 行。
+ */
+function parsePricingRuleRow(row) {
+    return {
+        rule_id: String(row.rule_id),
+        service_id: String(row.service_id ?? ""),
+        action_id: String(row.action_id ?? ""),
+        model_id: String(row.model_id ?? ""),
+        provider_id: String(row.provider_id ?? ""),
+        request_microcredits: Number(row.request_microcredits ?? 0),
+        input_token_microcredits: Number(row.input_token_microcredits ?? 0),
+        input_mtoken_microcredits: Number(row.input_mtoken_microcredits ?? 0),
+        output_token_microcredits: Number(row.output_token_microcredits ?? 0),
+        output_mtoken_microcredits: Number(row.output_mtoken_microcredits ?? 0),
+        cached_token_microcredits: Number(row.cached_token_microcredits ?? 0),
+        cached_mtoken_microcredits: Number(row.cached_mtoken_microcredits ?? 0),
+        image_microcredits: Number(row.image_microcredits ?? 0),
+        status: row.status === "disabled" ? "disabled" : "active",
+        note: String(row.note ?? ""),
+        created_at: String(row.created_at ?? ""),
+        updated_at: String(row.updated_at ?? ""),
+    };
+}
+/**
+ * 解析 charge 行。
+ */
+function parseChargeRow(row) {
+    const amount_microcredits = Number(row.amount_microcredits ?? 0);
+    return {
+        charge_id: String(row.charge_id),
+        user_id: String(row.user_id ?? ""),
+        town_id: String(row.town_id ?? ""),
+        service_id: String(row.service_id ?? ""),
+        action_id: String(row.action_id ?? ""),
+        model_id: String(row.model_id ?? ""),
+        provider_id: String(row.provider_id ?? ""),
+        rule_id: String(row.rule_id ?? ""),
+        amount: microcreditsToCredits(amount_microcredits),
+        amount_microcredits,
+        status: row.status === "skipped" ? "skipped" : "settled",
+        note: String(row.note ?? ""),
+        metadata_json: String(row.metadata_json ?? "{}"),
+        created_at: String(row.created_at ?? ""),
+    };
+}
+/**
+ * 标准化非负整数。
+ */
+function normalizeNonNegativeInteger(value, label) {
+    const normalized = Number(value ?? 0);
+    if (!Number.isSafeInteger(normalized) || normalized < 0) {
+        throw new TypeError(`${label} must be a non-negative integer`);
+    }
+    return normalized;
+}
+/**
+ * 标准化 limit。
+ */
+function normalizeLimit(value) {
+    const normalized = Number(value ?? 20);
+    if (!Number.isInteger(normalized) || normalized <= 0)
+        return 20;
+    return Math.min(normalized, 200);
+}
+/**
+ * 标准化文本。
+ */
+function normalizeText(value) {
+    return String(value ?? "").trim();
+}
+/**
+ * 生成随机 ID。
+ */
+function randomId() {
+    const bytes = new Uint8Array(12);
+    crypto.getRandomValues(bytes);
+    return btoa(String.fromCharCode(...bytes))
+        .replace(/\+/g, "-")
+        .replace(/\//g, "_")
+        .replace(/=+$/, "");
+}
+//# sourceMappingURL=service.js.map

package/bin/billing/service.js.map

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

package/bin/billing/types.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Billing 服务类型定义。
+ *
+ * 关键说明（中文）
+ * - pricing rule 使用 microcredits 描述单价
+ * - charge 是一次已经结算的账单事实
+ * - balance 桥接只暴露 billing 需要的最小扣费能力
+ */
+import type { Context } from "@downcity/city";
+/**
+ * Pricing rule 状态。
+ */
+export type BillingPricingRuleStatus = "active" | "disabled";
+/**
+ * Charge 状态。
+ */
+export type BillingChargeStatus = "settled" | "skipped";
+/**
+ * Billing 所需的 balance 最小桥接接口。
+ */
+export interface BillingBalanceBridge {
+    /**
+     * 检查余额是否足够，单位为 microcredits。
+     */
+    requireMicrocredits(user_id: string, amount_microcredits: number): Promise<unknown>;
+    /**
+     * 扣减余额，单位为 microcredits。
+     */
+    subMicrocredits(user_id: string, amount_microcredits: number, extra?: {
+        /** 说明文本。 */
+        note?: string;
+        /** 外部引用 ID。 */
+        ref?: string;
+        /** 结构化扩展字段。 */
+        meta?: Record<string, unknown>;
+    }): Promise<unknown>;
+}
+/**
+ * Billing 服务配置。
+ */
+export interface BillingServiceOptions {
+    /**
+     * 已挂载到 City 的 balance 服务实例。
+     */
+    balance: BillingBalanceBridge;
+    /**
+     * 默认 pricing rules。
+     */
+    pricing_rules?: BillingPricingRuleInput[];
+    /**
+     * 是否启用请求前余额检查。
+     */
+    require_before_call?: boolean;
+}
+/**
+ * Pricing rule 输入。
+ */
+export interface BillingPricingRuleInput extends Record<string, unknown> {
+    /**
+     * 规则 ID。
+     */
+    rule_id?: string;
+    /**
+     * 服务 ID，例如 ai。
+     */
+    service_id?: string;
+    /**
+     * action ID，例如 chat/completions。
+     */
+    action_id?: string;
+    /**
+     * 模型 ID，空表示 fallback。
+     */
+    model_id?: string;
+    /**
+     * provider ID，空表示 fallback。
+     */
+    provider_id?: string;
+    /**
+     * 每次请求固定扣费，单位为 microcredits。
+     */
+    request_microcredits?: number;
+    /**
+     * 每个 input token 扣费，单位为 microcredits。
+     */
+    input_token_microcredits?: number;
+    /**
+     * 每 1,000,000 个 input token 扣费，单位为 microcredits。
+     */
+    input_mtoken_microcredits?: number;
+    /**
+     * 每个 output token 扣费，单位为 microcredits。
+     */
+    output_token_microcredits?: number;
+    /**
+     * 每 1,000,000 个 output token 扣费，单位为 microcredits。
+     */
+    output_mtoken_microcredits?: number;
+    /**
+     * 每个 cached input token 扣费，单位为 microcredits。
+     */
+    cached_token_microcredits?: number;
+    /**
+     * 每 1,000,000 个 cached input token 扣费，单位为 microcredits。
+     */
+    cached_mtoken_microcredits?: number;
+    /**
+     * 每张图片扣费，单位为 microcredits。
+     */
+    image_microcredits?: number;
+    /**
+     * 规则状态。
+     */
+    status?: BillingPricingRuleStatus;
+    /**
+     * 说明文本。
+     */
+    note?: string;
+}
+/**
+ * Pricing rule 记录。
+ */
+export interface BillingPricingRule extends Required<BillingPricingRuleInput>, Record<string, unknown> {
+    /**
+     * 规则 ID。
+     */
+    rule_id: string;
+    /**
+     * 创建时间。
+     */
+    created_at: string;
+    /**
+     * 更新时间。
+     */
+    updated_at: string;
+}
+/**
+ * Charge 记录。
+ */
+export interface BillingCharge extends Record<string, unknown> {
+    /** 扣费记录 ID。 */
+    charge_id: string;
+    /** 用户 ID。 */
+    user_id: string;
+    /** Town ID。 */
+    town_id: string;
+    /** 服务 ID。 */
+    service_id: string;
+    /** action ID。 */
+    action_id: string;
+    /** 模型 ID。 */
+    model_id: string;
+    /** provider ID。 */
+    provider_id: string;
+    /** 命中的 pricing rule ID。 */
+    rule_id: string;
+    /** 扣费金额，单位为 credits。 */
+    amount: number;
+    /** 扣费金额，单位为 microcredits。 */
+    amount_microcredits: number;
+    /** 状态。 */
+    status: BillingChargeStatus;
+    /** 说明文本。 */
+    note: string;
+    /** 扩展字段 JSON。 */
+    metadata_json: string;
+    /** 创建时间。 */
+    created_at: string;
+}
+/**
+ * Charge 查询条件。
+ */
+export interface BillingChargeQuery extends Record<string, unknown> {
+    /** 可选用户 ID。 */
+    user_id?: string;
+    /** 可选 Town ID。 */
+    town_id?: string;
+    /** 返回条数上限。 */
+    limit?: string | number;
+}
+/**
+ * Pricing rule 查询条件。
+ */
+export interface BillingPricingRuleQuery extends Record<string, unknown> {
+    /** 返回条数上限。 */
+    limit?: string | number;
+}
+/**
+ * Billing hook 结算上下文。
+ */
+export interface BillingSettlementContext {
+    /**
+     * 当前 service action context。
+     */
+    ctx: Context;
+    /**
+     * 命中的 pricing rule。
+     */
+    rule: BillingPricingRule;
+    /**
+     * 结算金额，单位为 microcredits。
+     */
+    amount_microcredits: number;
+}
+//# sourceMappingURL=types.d.ts.map