@rayadesu/dsh-llm-billing 0.3.7 → 0.3.9

package/lib/types/types.d.ts

@@ -1,6 +1,14 @@
 /**
  * Client-safe balance and spend vocabulary shared by the `billing` Remote,
  * its generated artifacts, and the web UI.
+ *
+ * Billing semantics (single source of truth, see billing.ts): every spend is
+ * priced per event by its own timestamp — Beijing-time (UTC+8, no DST) hour
+ * and weekday, with peak windows Monday–Friday 09:00–12:00 / 14:00–18:00 and
+ * weekends always off-peak; cache-hit input, cache-miss input (including
+ * cache writes), and output (including reasoning) are billed separately at
+ * per-1M-token rates. The published table prices the DeepSeek V4 rows and
+ * the MiMo-V2.5 series (flat rate, no peak/off-peak distinction).
  * @module @rayadesu/dsh-llm-billing/types
  */
 import type { SessionId } from '@deepseek-ai/dsh-session';
@@ -22,7 +30,7 @@ export interface DeepSeekBalance {
     /** Balance lines, one per currency; empty when the provider reports none. */
     lines: readonly DeepSeekBalanceLine[];
 }
-/** One model's billed spend within one session, priced by the peak/off-peak table. */
+/** One model's billed spend within one session. */
 export interface DeepSeekSessionSpendModel {
     /** Wire model id, e.g. `deepseek-v4-flash`. */
     model: string;
@@ -47,21 +55,21 @@ export interface DeepSeekSessionSpendModel {
     /** Billed cost of output tokens (reasoning included) in CNY. */
     outputCost: number;
 }
-/** The billed spend of one session, priced per event by its Beijing-time hour and weekday (peak hours apply Monday–Friday only; weekends are off-peak). */
+/** The billed spend of one session. */
 export interface DeepSeekSessionSpend {
     /** Total billed cost in CNY across every priced model. */
     total: number;
     /** One row per model that reported usage AND has a pricing row; empty when the session has no priced usage. */
     models: readonly DeepSeekSessionSpendModel[];
 }
-/** The billed spend of every session on one Beijing-time calendar day, priced per event by its Beijing-time hour and weekday (peak hours apply Monday–Friday only; weekends are off-peak). */
+/** The billed spend of every session on one Beijing-time calendar day. */
 export interface DeepSeekTodaySpend {
     /** Total billed cost in CNY across every priced model and every session. */
     total: number;
     /** One row per model that reported usage AND has a pricing row; empty when today has no priced usage. */
     models: readonly DeepSeekSessionSpendModel[];
 }
-/** One session's billed spend on one Beijing-time calendar day, priced per event by its Beijing-time hour and weekday (peak hours apply Monday–Friday only; weekends are off-peak). */
+/** One session's billed spend on one Beijing-time calendar day. */
 export interface DeepSeekTodaySessionSpend {
     /** The session's durable identity. */
     sessionId: SessionId;
@@ -78,9 +86,26 @@ export interface DeepSeekTodaySessionsSpend {
     /** Sessions with today's spend, sorted by `total` descending. */
     sessions: readonly DeepSeekTodaySessionSpend[];
 }
-/** The billed cost of one completed Turn, priced per event by its Beijing-time hour and weekday (peak hours apply Monday–Friday only; weekends are off-peak). */
+/** The billed cost of one completed Turn. */
 export interface DeepSeekTurnSpend {
     /** Total billed cost in CNY across every priced model in the Turn. */
     total: number;
 }
+/** One completed Turn's cost, located by the id of an assistant message inside it. */
+export interface DeepSeekTurnSpendRow {
+    /** The durable id of one assistant message inside the Turn. */
+    messageId: string;
+    /** The Turn's total billed cost in CNY (the same value for every message of the Turn). */
+    total: number;
+}
+/**
+ * Every completed Turn's billed cost in one session, in log order. One call
+ * replaces the per-message `getTurnSpend` fan-out (the transcript renders one
+ * row per message; fetching the whole map once is O(log), fetching per row is
+ * O(messages × log)).
+ */
+export interface DeepSeekSessionTurnSpends {
+    /** One row per assistant message inside a completed Turn; a Turn with N assistant messages contributes N rows. */
+    turns: readonly DeepSeekTurnSpendRow[];
+}
 //# sourceMappingURL=types.d.ts.map

package/lib/types/types.js

@@ -1,6 +1,14 @@
 /**
  * Client-safe balance and spend vocabulary shared by the `billing` Remote,
  * its generated artifacts, and the web UI.
+ *
+ * Billing semantics (single source of truth, see billing.ts): every spend is
+ * priced per event by its own timestamp — Beijing-time (UTC+8, no DST) hour
+ * and weekday, with peak windows Monday–Friday 09:00–12:00 / 14:00–18:00 and
+ * weekends always off-peak; cache-hit input, cache-miss input (including
+ * cache writes), and output (including reasoning) are billed separately at
+ * per-1M-token rates. The published table prices the DeepSeek V4 rows and
+ * the MiMo-V2.5 series (flat rate, no peak/off-peak distinction).
  * @module @rayadesu/dsh-llm-billing/types
  */
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rayadesu/dsh-llm-billing",
   "description": "Standalone DeepSeek account-balance and session-spend provider exposed through the billing Remote",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "publishConfig": {
     "access": "public"
   },
@@ -26,6 +26,10 @@
       "types": "./lib/types/types.d.ts",
       "default": "./lib/types/types.js"
     },
+    "./projection": {
+      "types": "./lib/types/projection.d.ts",
+      "default": "./lib/types/projection.js"
+    },
     "./typert": {
       "types": "./lib/typert.host.d.ts",
       "default": "./lib/typert.host.js"