@spendgraph/sdk 0.7.0 → 0.8.0

package/dist/resources/files.d.ts

@@ -4,7 +4,7 @@ export declare const PUBLISH_TO: readonly ["md", "html", "txt", "pdf"];
 export type PublishFrom = (typeof PUBLISH_FROM)[number];
 export type PublishTo = (typeof PUBLISH_TO)[number];
 export interface PublishInput {
-    projectId: string;
+    projectId?: string;
     content: string;
     from: PublishFrom;
     to: PublishTo;

package/dist/resources/ingest.d.ts

@@ -19,6 +19,15 @@ export interface IngestResult {
     rejected: number;
     /** Ids nothing could price. Stored at $0 and counted, never rejected. */
     unpricedModels: string[];
+    /**
+     * What each event was priced at, by the `eventId` it was sent with.
+     *
+     * The server prices from the project's resolved offer as it writes the row,
+     * so this is the figure that was stored rather than a second calculation of
+     * it. A caller reporting usage rather than a rollout has no other way to put
+     * a cost on the call it just made.
+     */
+    costs: Record<string, number>;
 }
 /** The route takes up to this many events per request. */
 export declare const MAX_EVENTS = 100;
@@ -31,12 +40,22 @@ export declare const MAX_EVENTS = 100;
 export interface Sender {
     send(events: UsageEvent[]): Promise<void>;
 }
+/** What one event cost, for a caller that sent exactly one. */
+export type OneCost = number | undefined;
 /** Posts usage straight through, chunked to what the route accepts. */
 export declare class Ingest implements Sender {
     private readonly client;
     private readonly project?;
     constructor(client: Client, project?: string | undefined);
     send(events: UsageEvent[]): Promise<void>;
+    /**
+     * One event, and what it cost — for a caller that wants the figure back.
+     *
+     * `undefined` where the server could not price the model, which it counts at
+     * zero rather than rejecting. A caller can then say "unpriced" instead of
+     * showing a zero that looks measured.
+     */
+    priced(event: UsageEvent): Promise<OneCost>;
     /** The same write, with the server's answer — which ids went unpriced. */
     report(events: UsageEvent[]): Promise<IngestResult>;
 }

package/dist/resources/ingest.js

@@ -1 +1 @@
-const i=100;class p{client;project;constructor(c,e){this.client=c,this.project=e}async send(c){await this.report(c)}async report(c){const e={accepted:0,rejected:0,unpricedModels:[]};if(c.length===0)return e;const r=new Set,o=c.map(t=>({...t,eventId:t.eventId??crypto.randomUUID()}));for(let t=0;t<o.length;t+=100){const n=await this.client.post("/api/v1/ingest",{events:o.slice(t,t+100)},{project:this.project});e.accepted+=n?.accepted??0,e.rejected+=n?.rejected??0;for(const s of n?.unpricedModels??[])r.add(s)}return e.unpricedModels=[...r],e}}export{p as Ingest,i as MAX_EVENTS};
+const i=100;class p{client;project;constructor(e,t){this.client=e,this.project=t}async send(e){await this.report(e)}async priced(e){const t=e.eventId??crypto.randomUUID();return(await this.report([{...e,eventId:t}])).costs[t]}async report(e){const t={accepted:0,rejected:0,unpricedModels:[],costs:{}};if(e.length===0)return t;const r=new Set,o=e.map(c=>({...c,eventId:c.eventId??crypto.randomUUID()}));for(let c=0;c<o.length;c+=100){const s=await this.client.post("/api/v1/ingest",{events:o.slice(c,c+100)},{project:this.project});t.accepted+=s?.accepted??0,t.rejected+=s?.rejected??0;for(const n of s?.unpricedModels??[])r.add(n);Object.assign(t.costs,s?.costs??{})}return t.unpricedModels=[...r],t}}export{p as Ingest,i as MAX_EVENTS};

package/dist/resources/prompts.d.ts

@@ -21,7 +21,7 @@ export interface PromptBlock {
     body?: string;
 }
 export interface SavePromptInput {
-    projectId: string;
+    projectId?: string;
     name: string;
     blocks?: PromptBlock[];
     variables?: Record<string, string>;

package/dist/resources/tools.d.ts

@@ -22,7 +22,7 @@ export interface ToolRow {
     updatedAt: string;
 }
 export interface SaveToolInput {
-    projectId: string;
+    projectId?: string;
     name: string;
     description: string;
     args?: FieldSpec[];

package/dist/schema/types/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * Typed prompt fields — what a `{placeholder}` accepts, and how it renders.
  *
- * Deliberately a copy of `lib/fields.ts` rather than an import. This package is
+ * Deliberately a copy of `lib/prompts/fields.ts` rather than an import. This package is
  * published and depends on nothing; reaching into the app for a type would make
  * every installed copy break the next time the app moved a file. The two are
  * kept in step by the wire format, which is the only contract that matters.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spendgraph/sdk",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Track LLM input/output tokens and cost. Three functions, zero dependencies, fail-open.",
   "license": "Apache-2.0",
   "repository": {
@@ -46,6 +46,7 @@
     "README.md"
   ],
   "devDependencies": {
+    "@spendgraph/config": "0.8.0",
     "typescript": "^5"
   },
   "engines": {
@@ -56,6 +57,7 @@
   },
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.json --emitDeclarationOnly && tsc -p tsconfig.json --declaration false --removeComments && node ../../scripts/minify.mjs dist",
-    "test": "vitest run"
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.tests.json"
   }
 }