@rayadesu/dsh-client-ui-billing 0.1.0-rc.10

package/lib/index.js

@@ -0,0 +1,11 @@
+//#region lib/types/index.js
+/**
+* Account-balance badge plugin, node half. Pure UI plugin: the empty apply
+* exists so the plugin appears in the host cordis.yml / Loader; the browser
+* half ships via exports["./client"], discovered through the package.json
+* dshClient declaration.
+*/
+/** Host plugin body — no host-side behavior for this source plugin. */
+function apply() {}
+//#endregion
+export { apply };

package/lib/invariant.js

@@ -0,0 +1,25 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@rayadesu/dsh-client-ui-billing`.
+* @module @rayadesu/dsh-client-ui-billing/invariant
+*/
+const PACKAGE_NAME = "@rayadesu/dsh-client-ui-billing";
+/** Cordis companion plugin name. */
+const name = "client-ui-billing-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: this package is a read-only projection of one Remote
+* snapshot onto one header slot entry. It emits no cordis events, owns no
+* cross-plugin mutable state, and its single slot registration proves disposal
+* through the HMR-safety spec.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/client/BalanceBadge.d.ts

@@ -0,0 +1,33 @@
+/** Session-header billing badge: balance plus the current conversation's billed spend. */
+import type { DeepSeekBalance, DeepSeekSessionSpend, DeepSeekTodaySpend } from '@rayadesu/dsh-llm-billing/types';
+import type { SessionId } from '@deepseek-ai/dsh-client-runtime/client';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import { NS } from './locales.ts';
+/** Registration-side Remote face used by the header badge. */
+export interface BalanceBadgeInjected {
+    /** Read the account balance; rejects with the Remote error message. */
+    getBalance: () => Promise<DeepSeekBalance>;
+    /** Read one session's billed spend; rejects with the Remote error message. */
+    getSessionSpend: (sessionId: SessionId) => Promise<DeepSeekSessionSpend>;
+    /** Read today's billed spend across every session; rejects with the Remote error message. */
+    getTodaySpend: () => Promise<DeepSeekTodaySpend>;
+}
+/** Full props assembled by the header utilities slot renderer. */
+export type BalanceBadgeProps = PropsRuntime<'conversation.session.header.utilities'> & InjectFace<BalanceBadgeInjected> & PropsLocale<typeof NS>;
+/**
+ * Render the billing badge in the session-header utilities row. The trigger
+ * shows the remaining balance and this conversation's billed spend and opens
+ * a label box with the amount, this session's spend with its cache-hit /
+ * cache-miss-input / output cost breakdown per model, today's spend across
+ * every session, a refresh action, and a spend disclaimer. Refreshing keeps
+ * the last values visible rather than blanking them.
+ *
+ * The spend follows the conversation: a new message in the current session
+ * recomputes only the (local, network-free) session spend and today's spend
+ * through `getSessionSpend` / `getTodaySpend`; the balance stays a
+ * manual-refresh snapshot and is never refetched on its own.
+ * @param props - Remote face, locale, and the standard session-header runtime share.
+ * @returns the badge, or null until the first balance fetch settles.
+ */
+export declare function BalanceBadge({ getBalance, getSessionSpend, getTodaySpend, sessionId, useSession, t }: BalanceBadgeProps): import("react").JSX.Element | null;
+//# sourceMappingURL=BalanceBadge.d.ts.map

package/lib/types/client/index.d.ts

@@ -0,0 +1,20 @@
+/** DeepSeek account-balance badge, browser half: one session-header utility entry. */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type BillingKey } from './locales.ts';
+export type { BalanceBadgeInjected, BalanceBadgeProps } from './BalanceBadge.tsx';
+export type { BillingKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** DeepSeek account-balance copy. */
+        'billing': BillingKey;
+    }
+}
+/** Services required for locale registration, the Remote face, and the header slot. */
+export declare const inject: string[];
+/**
+ * Client plugin body: mount the `billing` Remote, register the dictionaries,
+ * and contribute the header utility badge.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/locales.d.ts

@@ -0,0 +1,26 @@
+/** `billing` namespace dictionaries. */
+/** Dictionary namespace owned by this plugin. */
+export declare const NS = "billing";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    readonly 'trigger.balance': "剩余额度：{amount}";
+    readonly 'trigger.conversationSpend': "本轮对话花费：{amount}";
+    readonly 'label.amount': "API 剩余金额：{amount}";
+    readonly 'label.sessionSpend': "本会话花费：{amount}";
+    readonly 'label.todaySpend': "今日共花费：{amount}";
+    readonly 'label.cost.hit': "缓存命中 {amount}";
+    readonly 'label.cost.input': "未命中输入 {amount}";
+    readonly 'label.cost.output': "输出 {amount}";
+    readonly 'stat.none': "暂无消耗记录";
+    readonly 'state.unavailable': "额度不可用";
+    readonly 'action.refresh': "刷新";
+    readonly 'info.aria': "花费说明";
+    readonly 'info.hint': "仅能预估 DeepSeek 相关模型。本会话花费按每条消息的发生时刻（北京时间）所在峰谷时段单价计费：缓存命中输入、未命中输入（含缓存写入）、输出（含推理）分别计价。费用按 8 月 17 日实行的标准。";
+    readonly 'badge.aria': "DeepSeek 额度：{amount}";
+    readonly 'panel.aria': "DeepSeek 额度详情";
+};
+/** English dictionary, key-identical to the Chinese source of truth. */
+export declare const en: Record<BillingKey, string>;
+/** Key domain of the `billing` namespace (zh is the source of truth). */
+export type BillingKey = keyof typeof zh;
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Account-balance badge plugin, node half. Pure UI plugin: the empty apply
+ * exists so the plugin appears in the host cordis.yml / Loader; the browser
+ * half ships via exports["./client"], discovered through the package.json
+ * dshClient declaration.
+ */
+/** Host plugin body — no host-side behavior for this source plugin. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@rayadesu/dsh-client-ui-billing`.
+ * @module @rayadesu/dsh-client-ui-billing/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-billing-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@rayadesu/dsh-client-ui-billing",
+  "description": "Session-header DeepSeek account-balance and conversation-spend badge over the billing Remote",
+  "version": "0.1.0-rc.10",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rayadesune/DeepSeek-Harness-chat-billing.git",
+    "directory": "packages/ui-billing"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@rayadesu/dsh-llm-billing": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.8",
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "devDependencies": {
+    "@rayadesu/dsh-llm-billing": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.8",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}