@lanlinling/lab-billing 0.1.0

package/README.md

@@ -0,0 +1,15 @@
+# @lanlinling/lab-billing
+
+The TypeScript client for the shared Lab billing contract. It contains no provider price table and no secrets. Cost and sales-policy facts live in the shared Supabase platform schema.
+
+```ts
+const quote = await quotePlatformCharge(service, {
+  experimentId: "english_testing",
+  action: "tts",
+  provider: "volcengine",
+  model: "doubao-tts-2",
+  usage: { unit: "char", chars: text.length },
+});
+```
+
+The caller passes `quote.costCny` and `quote.sellCny` to the server-only `debit_wallet` RPC after choosing the product-appropriate charge point.

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+type BillableUsage = {
+    unit: "token";
+    inputTokens: number;
+    outputTokens: number;
+} | {
+    unit: "char";
+    chars: number;
+} | {
+    unit: "count";
+    count: number;
+};
+type RpcResult<T> = {
+    data: T | null;
+    error: {
+        message: string;
+    } | null;
+};
+interface BillingRpcClient {
+    rpc<T>(name: string, args: Record<string, unknown>): PromiseLike<RpcResult<T>>;
+}
+declare function usageForRpc(usage: BillableUsage): Record<string, number | string>;
+declare function quotePlatformCost(service: BillingRpcClient, params: {
+    provider: string;
+    model: string;
+    usage: BillableUsage;
+}): Promise<number>;
+declare function quotePlatformSell(service: BillingRpcClient, params: {
+    experimentId: string;
+    action: string;
+    costCny: number;
+}): Promise<number>;
+declare function quotePlatformCharge(service: BillingRpcClient, params: {
+    experimentId: string;
+    action: string;
+    provider: string;
+    model: string;
+    usage: BillableUsage;
+}): Promise<{
+    costCny: number;
+    sellCny: number;
+    usage: Record<string, string | number>;
+}>;
+
+export { type BillableUsage, type BillingRpcClient, type RpcResult, quotePlatformCharge, quotePlatformCost, quotePlatformSell, usageForRpc };

package/dist/index.js

@@ -0,0 +1,44 @@
+// src/index.ts
+function usageForRpc(usage) {
+  switch (usage.unit) {
+    case "token":
+      return { unit: usage.unit, input_tokens: usage.inputTokens, output_tokens: usage.outputTokens };
+    case "char":
+      return { unit: usage.unit, chars: usage.chars };
+    case "count":
+      return { unit: usage.unit, count: usage.count };
+  }
+}
+async function quotePlatformCost(service, params) {
+  const { data, error } = await service.rpc("quote_platform_cost_cny", {
+    p_provider: params.provider,
+    p_model: params.model,
+    p_usage: usageForRpc(params.usage)
+  });
+  if (error || data === null) throw new Error(`platform_cost_quote_failed:${(error == null ? void 0 : error.message) ?? "unknown"}`);
+  return Number(data);
+}
+async function quotePlatformSell(service, params) {
+  const { data, error } = await service.rpc("quote_platform_sell_cny", {
+    p_experiment: params.experimentId,
+    p_action: params.action,
+    p_cost_cny: params.costCny
+  });
+  if (error || data === null) throw new Error(`platform_sell_quote_failed:${(error == null ? void 0 : error.message) ?? "unknown"}`);
+  return Number(data);
+}
+async function quotePlatformCharge(service, params) {
+  const costCny = await quotePlatformCost(service, params);
+  const sellCny = await quotePlatformSell(service, {
+    experimentId: params.experimentId,
+    action: params.action,
+    costCny
+  });
+  return { costCny, sellCny, usage: usageForRpc(params.usage) };
+}
+export {
+  quotePlatformCharge,
+  quotePlatformCost,
+  quotePlatformSell,
+  usageForRpc
+};

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@lanlinling/lab-billing",
+  "version": "0.1.0",
+  "description": "Shared Lab billing quote contract for TypeScript products",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": ["dist", "README.md"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "test": "npm run build && node --test test/index.test.mjs",
+    "prepublishOnly": "npm run test"
+  },
+  "devDependencies": {
+    "tsup": "8.5.1",
+    "typescript": "5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}