dsh-usage-state 0.3.0

package/lib/typert.js

@@ -0,0 +1,120 @@
+import { z } from "zod";
+//#region src/host/typert.ts
+/**
+* The host half of the Typert RPC contract.
+*
+* Three requirements here are not obvious and are load-bearing:
+*  - the module must export a NAMED `TYPERT`, and `package.json` must expose it
+*    as `exports["./typert"]` — that is where the loader looks;
+*  - `package` must equal the npm package name exactly;
+*  - every parameter and result codec must be "strict" and carry a zod **v4**
+*    schema (the loader checks `'_zod' in schema`), which is why zod is a runtime
+*    dependency rather than a dev one.
+*
+* `model` is mandatory even when empty.
+*/
+const TYPERT_PACKAGE = "dsh-usage-state";
+const TYPERT_SERVICE = "usageState";
+const TYPERT_NAMESPACE = "usageState";
+function strictCodec(name, schema) {
+	return {
+		mode: "strict",
+		typeSymbol: `${TYPERT_PACKAGE}#${name}`,
+		schema,
+		create: () => schema
+	};
+}
+const usageModeSchema = z.enum(["api", "coding-plan"]);
+const balanceSchema = z.object({
+	amount: z.number(),
+	currency: z.string(),
+	granted: z.number().optional(),
+	toppedUp: z.number().optional()
+});
+const quotaWindowSchema = z.object({
+	id: z.string(),
+	usedPercent: z.number(),
+	resetsAt: z.number().optional()
+});
+const snapshotErrorSchema = z.object({
+	kind: z.enum([
+		"config",
+		"auth",
+		"http",
+		"network",
+		"parse",
+		"unknown"
+	]),
+	detail: z.string().optional()
+});
+const snapshotSchema = z.object({
+	sourceId: z.string(),
+	mode: usageModeSchema,
+	balances: z.array(balanceSchema),
+	windows: z.array(quotaWindowSchema),
+	fetchedAt: z.number(),
+	stale: z.boolean().optional(),
+	error: snapshotErrorSchema.optional()
+});
+const catalogEntrySchema = z.object({
+	id: z.string(),
+	displayName: z.string(),
+	modes: z.array(usageModeSchema),
+	requiresBaseUrl: z.boolean(),
+	defaultBaseUrl: z.record(z.string(), z.string()),
+	credentialRefs: z.record(z.string(), z.array(z.string()))
+});
+const credentialCandidateSchema = z.object({
+	ref: z.string(),
+	configured: z.boolean(),
+	source: z.string().optional(),
+	writable: z.boolean().optional()
+});
+const credentialDescriptionSchema = z.object({
+	candidates: z.array(credentialCandidateSchema),
+	configured: z.boolean(),
+	ref: z.string().optional(),
+	source: z.string().optional(),
+	writable: z.boolean().optional()
+});
+const usageStateViewSchema = z.object({
+	sources: z.array(catalogEntrySchema),
+	snapshots: z.record(z.string(), snapshotSchema),
+	checkedAt: z.number()
+});
+const credentialReportSchema = z.object({ credentials: z.record(z.string(), credentialDescriptionSchema) });
+const TYPERT = {
+	package: TYPERT_PACKAGE,
+	face: "host",
+	schemas: [],
+	model: {
+		services: [],
+		events: [],
+		objects: []
+	},
+	invocations: [{
+		id: `${TYPERT_PACKAGE}#${TYPERT_NAMESPACE}/getState`,
+		service: TYPERT_SERVICE,
+		namespace: TYPERT_NAMESPACE,
+		method: "getState",
+		invocation: { kind: "direct" },
+		parameters: [{
+			name: "force",
+			wire: "force",
+			source: "json",
+			acceptsUndefined: true,
+			codec: strictCodec("Force", z.boolean().optional())
+		}],
+		result: strictCodec("UsageStateView", usageStateViewSchema)
+	}, {
+		id: `${TYPERT_PACKAGE}#${TYPERT_NAMESPACE}/describeCredentials`,
+		service: TYPERT_SERVICE,
+		namespace: TYPERT_NAMESPACE,
+		method: "describeCredentials",
+		invocation: { kind: "direct" },
+		parameters: [],
+		result: strictCodec("CredentialReport", credentialReportSchema)
+	}]
+};
+//#endregion
+export { TYPERT, TYPERT_NAMESPACE, TYPERT_PACKAGE, TYPERT_SERVICE, credentialReportSchema, strictCodec, usageStateViewSchema };

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "dsh-usage-state",
+  "version": "0.3.0",
+  "type": "module",
+  "description": "DSH plugin: show account balance (API mode) or coding-plan quota (5h/7d/30d) for the model in use",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20",
+    "dsh": ">=0.1.5-rc.1 <0.2.0-0"
+  },
+  "scripts": {
+    "test": "node --import ./tests/support/client-render-hook.mjs --test",
+    "test:watch": "node --import ./tests/support/client-render-hook.mjs --test --watch",
+    "typecheck": "tsc --noEmit",
+    "build": "node -e \"require('node:fs').rmSync('lib',{recursive:true,force:true})\" && tsdown",
+    "watch": "tsdown --watch"
+  },
+  "exports": {
+    ".": {
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./typert": {
+      "default": "./lib/typert.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-store": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-typert-loader": "^0.1.5-rc.2",
+    "@types/node": "^24.0.0",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.2.0",
+    "tsdown": "^0.22.14",
+    "typescript": "^5.9.2",
+    "unrun": "^0.2.39"
+  },
+  "dependencies": {
+    "zod": "4.5.1"
+  },
+  "main": "lib/index.js",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ]
+    }
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "README.en.md",
+    "LICENSE",
+    "docs/adapters.md"
+  ],
+  "peerDependencies": {
+    "react": "^18.2.0"
+  },
+  "keywords": [
+    "deepseek",
+    "dsh",
+    "dsh-plugin",
+    "usage",
+    "balance",
+    "quota",
+    "coding-plan"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/takboo/dsh-usage-state.git"
+  },
+  "homepage": "https://github.com/takboo/dsh-usage-state#readme",
+  "bugs": {
+    "url": "https://github.com/takboo/dsh-usage-state/issues"
+  }
+}