@usagetap/sdk 1.2.0 → 1.3.1

package/dist/index.cjs

@@ -770,7 +770,8 @@ var IDEMPOTENCY_HEADER = "idempotency-key";
 var SDK_HEADER = "x-usage-sdk";
 var USER_AGENT = "UsageTapClient";
 var CANONICAL_MEDIA_TYPE = "application/vnd.usagetap.v1+json";
-var SDK_VERSION = "1.2.0" ;
+var DEFAULT_BASE_URL = "https://api.usagetap.com";
+var SDK_VERSION = "1.3.1" ;
 var HAS_WINDOW = typeof globalThis !== "undefined" && typeof globalThis.window !== "undefined";
 var UsageTapClient = class {
   apiKey;
@@ -797,23 +798,13 @@ var UsageTapClient = class {
   usageTapCompressionMessagesEndpoint;
   usageTapCompressionModel;
   usageTapCompressionAggressiveness;
-  constructor(options) {
-    if (!options) {
+  constructor(options = {}) {
+    const apiKey = options.apiKey?.trim() || readEnvironmentVariable("USAGETAP_API_KEY");
+    const baseUrl = options.baseUrl?.trim() || readEnvironmentVariable("USAGETAP_BASE_URL") || DEFAULT_BASE_URL;
+    if (!apiKey) {
       throw new UsageTapError(
         "USAGETAP_BAD_REQUEST",
-        "UsageTapClient options are required"
-      );
-    }
-    if (!options.apiKey) {
-      throw new UsageTapError(
-        "USAGETAP_BAD_REQUEST",
-        "UsageTapClient requires an apiKey"
-      );
-    }
-    if (!options.baseUrl) {
-      throw new UsageTapError(
-        "USAGETAP_BAD_REQUEST",
-        "UsageTapClient requires a baseUrl"
+        "UsageTapClient requires an apiKey or the USAGETAP_API_KEY environment variable"
       );
     }
     if (HAS_WINDOW && !options.allowBrowser) {
@@ -829,9 +820,9 @@ var UsageTapClient = class {
         "A global fetch implementation was not found. Pass fetchImpl in UsageTapClientOptions."
       );
     }
-    const normalizedBaseUrl = normalizeBaseUrl(options.baseUrl);
+    const normalizedBaseUrl = normalizeBaseUrl(baseUrl);
     this.baseUrl = new URL(normalizedBaseUrl);
-    this.apiKey = options.apiKey;
+    this.apiKey = apiKey;
     this.fetchImpl = wrapFetchImplementation(fetchCandidate, !options.fetchImpl);
     this.defaultFeature = options.defaultFeature;
     this.defaultTags = options.defaultTags?.length ? dedupeStrings(options.defaultTags) : void 0;
@@ -849,7 +840,7 @@ var UsageTapClient = class {
     this.aggressiveness = options.aggressiveness;
     this.tokenCompanyAggressiveness = options.tokenCompanyAggressiveness;
     this.tokenCompanyAppId = options.tokenCompanyAppId;
-    this.usageTapCompressionApiKey = options.usageTapCompressionApiKey ?? options.apiKey;
+    this.usageTapCompressionApiKey = options.usageTapCompressionApiKey ?? apiKey;
     this.usageTapCompressionEndpoint = options.usageTapCompressionEndpoint;
     this.usageTapCompressionMessagesEndpoint = options.usageTapCompressionMessagesEndpoint;
     this.usageTapCompressionModel = options.usageTapCompressionModel;
@@ -941,6 +932,30 @@ var UsageTapClient = class {
       failOpen: options.failOpen
     });
   }
+  /**
+   * Compress text with UsageTap's hosted compression service.
+   *
+   * This is the short, standalone path. It does not create a metered call and
+   * fails open to the original text unless failOpen is explicitly disabled.
+   */
+  async compress(text, options = {}) {
+    if (typeof text !== "string") {
+      throw new UsageTapError(
+        "USAGETAP_BAD_REQUEST",
+        "compress requires text"
+      );
+    }
+    const result = await this.compressPromptInput(text, {
+      ...options,
+      provider: "usagetap"
+    });
+    const output = typeof result.compressedInput === "string" ? result.compressedInput : text;
+    return {
+      ...result,
+      compressedInput: output,
+      output
+    };
+  }
   async compressPromptMessages(input, options = {}) {
     return compressPromptMessages({
       input,
@@ -1194,6 +1209,14 @@ var UsageTapClient = class {
     }
     return handlerResult;
   }
+  /**
+   * Meter one operation. Pass only a customer ID for the common path, or the
+   * existing begin-call request object when feature, tags, or entitlements are needed.
+   */
+  async meter(request, handler, options = {}) {
+    const beginRequest = typeof request === "string" ? { customerId: request } : request;
+    return this.withUsage(beginRequest, handler, options);
+  }
   toPromptCompressionTelemetry(result) {
     return {
       provider: result.provider,
@@ -1506,6 +1529,11 @@ function sanitizeDetails(payload) {
   if (payload.error) details.error = payload.error;
   return Object.keys(details).length ? details : void 0;
 }
+function readEnvironmentVariable(name) {
+  const runtime = globalThis;
+  const value = runtime.process?.env?.[name]?.trim();
+  return value || void 0;
+}
 function normalizeBaseUrl(baseUrl) {
   const trimmed = baseUrl.trim();
   if (!trimmed) return trimmed;
@@ -1795,6 +1823,7 @@ async function finalizeCall(callState, usageTap, error, usage) {
   }
 }
 
+exports.UsageTap = UsageTapClient;
 exports.UsageTapClient = UsageTapClient;
 exports.UsageTapError = UsageTapError;
 exports.compressPrompt = compressPrompt;