the-token-company 0.1.1 → 0.2.0

package/README.md

@@ -1,7 +1,17 @@
+<div align="center">
+
 # The Token Company Node.js SDK
 
 Compress LLM prompts to reduce costs and latency. 100K tokens compressed in ~85ms.
 
+[![CI](https://github.com/TheTokenCompany/the-token-company-node/actions/workflows/ci.yml/badge.svg)](https://github.com/TheTokenCompany/the-token-company-node/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/the-token-company)](https://www.npmjs.com/package/the-token-company)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/TheTokenCompany/the-token-company-node/blob/main/LICENSE)
+
+[Docs](https://thetokencompany.com/docs) · [Website](https://thetokencompany.com) · [Dashboard](https://app.thetokencompany.com) · [Python SDK](https://github.com/TheTokenCompany/the-token-company-python)
+
+</div>
+
 ## Install
 
 ```bash
@@ -131,6 +141,24 @@ withCompression(client, {
 | `system`   | `role: "system"` messages       | `system` parameter             | System messages     |
 | `tool`     | `tool` + `function` messages    | `tool_result` content blocks   | Tool result parts   |
 
+## App ID
+
+Tag compression requests with an application identifier for usage tracking:
+
+```ts
+// Set on the client — applies to all requests
+const client = new TheTokenCompany({ apiKey: "ttc-...", appId: "my-chatbot" });
+
+// Or per-request (overrides the client-level value)
+const result = await client.compress(text, { model: "bear-2", appId: "my-chatbot" });
+```
+
+Also supported in wrappers:
+
+```ts
+const client = withCompression(new OpenAI(), { compressionApiKey: "ttc-...", appId: "my-chatbot" });
+```
+
 ## Gzip
 
 Gzip compression of request payloads is on by default. Disable with:

package/dist/ai-sdk.js

@@ -17,7 +17,7 @@ import { CompressionStats } from "./types.js";
  */
 export function compressionMiddleware(options) {
     const stats = new CompressionStats();
-    const analytics = new AnalyticsTTC(new TheTokenCompany({ apiKey: options.compressionApiKey }), stats);
+    const analytics = new AnalyticsTTC(new TheTokenCompany({ apiKey: options.compressionApiKey, appId: options.appId }), stats);
     const compressionModel = options.model ?? "bear-2";
     const roleAggr = resolveAggressiveness(options.aggressiveness ?? 0.2);
     const middleware = {

package/dist/anthropic.js

@@ -24,7 +24,7 @@ import { CompressionStats } from "./types.js";
  */
 export function withCompression(client, options) {
     const stats = new CompressionStats();
-    const analytics = new AnalyticsTTC(new TheTokenCompany({ apiKey: options.compressionApiKey }), stats);
+    const analytics = new AnalyticsTTC(new TheTokenCompany({ apiKey: options.compressionApiKey, appId: options.appId }), stats);
     const model = options.model ?? "bear-2";
     const roleAggr = resolveAggressiveness(options.aggressiveness ?? 0.2);
     const systemAggr = roleAggr["system"];

package/dist/client.d.ts

@@ -8,10 +8,12 @@ export declare class TheTokenCompany {
     private readonly apiKey;
     private readonly timeout;
     private readonly gzip;
+    private readonly appId?;
     constructor(options: TheTokenCompanyOptions);
     compress(text: string, options?: {
         model?: string;
         aggressiveness?: number;
+        appId?: string;
     }): Promise<CompressResult>;
     private parseError;
 }

package/dist/client.js

@@ -13,11 +13,13 @@ export class TheTokenCompany {
     apiKey;
     timeout;
     gzip;
+    appId;
     constructor(options) {
         this.apiKey = options.apiKey;
         this.baseUrl = (options.baseUrl ?? BASE_URL).replace(/\/$/, "");
         this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
         this.gzip = options.gzip ?? true;
+        this.appId = options.appId;
     }
     async compress(text, options = {}) {
         const { model = "bear-2", aggressiveness = 0.2 } = options;
@@ -27,10 +29,12 @@ export class TheTokenCompany {
         if (aggressiveness < 0 || aggressiveness > 1) {
             throw new InvalidRequestError("aggressiveness must be between 0.0 and 1.0");
         }
+        const resolvedAppId = options.appId ?? this.appId;
         const payload = {
             model,
             input: text,
             compression_settings: { aggressiveness },
+            ...(resolvedAppId !== undefined && { app_id: resolvedAppId }),
         };
         const jsonBody = JSON.stringify(payload);
         const headers = {

package/dist/openai.js

@@ -22,7 +22,7 @@ import { CompressionStats } from "./types.js";
  */
 export function withCompression(client, options) {
     const stats = new CompressionStats();
-    const analytics = new AnalyticsTTC(new TheTokenCompany({ apiKey: options.compressionApiKey }), stats);
+    const analytics = new AnalyticsTTC(new TheTokenCompany({ apiKey: options.compressionApiKey, appId: options.appId }), stats);
     const model = options.model ?? "bear-2";
     const roleAggr = resolveAggressiveness(options.aggressiveness ?? 0.2);
     const originalCreate = client.chat.completions.create.bind(client.chat.completions);

package/dist/types.d.ts

@@ -4,6 +4,7 @@ export interface CompressRequest {
     compression_settings: {
         aggressiveness: number;
     };
+    app_id?: string;
 }
 export interface CompressResponse {
     output: string;
@@ -22,12 +23,14 @@ export interface TheTokenCompanyOptions {
     baseUrl?: string;
     timeout?: number;
     gzip?: boolean;
+    appId?: string;
 }
 export type Aggressiveness = number | Record<string, number>;
 export interface WithCompressionOptions {
     compressionApiKey: string;
     model?: string;
     aggressiveness?: Aggressiveness;
+    appId?: string;
 }
 export interface TurnStats {
     inputTokens: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "the-token-company",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Node.js SDK for The Token Company — compress LLM prompts to reduce costs and latency",
   "type": "module",
   "main": "./dist/index.js",