@usagetap/sdk 0.1.0 → 0.2.1

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { U as UsageTapClient, B as BeginCallRequest, W as WrapOpenAIContext, a as WrapOpenAIOptions, w as wrapOpenAI, p as pipeToResponse } from './openai-CKyw08rB.cjs';
-export { A as AllowedEntitlements, r as BalanceSummary, m as BeginCallOptions, n as BeginCallResponseBody, E as EndCallOptions, o as EndCallRequest, q as EndCallResponseBody, u as EntitlementHints, X as IdempotencyMetadata, L as LimitType, v as MeterSnapshot, M as MeterSummary, x as MeteredUsage, T as ModelHints, N as NodeResponseLike, O as OpenAIAdapter, b as OpenAIAdapterInit, d as OpenAIInvokeParams, e as OpenAIInvokeResult, f as OpenAIStreamParams, g as OpenAIStreamResult, P as PlanSummary, R as RemainingRatios, y as RequestedEntitlements, z as RetryOptions, S as StreamMode, l as StreamOpenAIRouteOptions, h as StreamToResponseOptions, Q as SubscriptionSnapshot, C as UsageTapClientOptions, F as UsageTapErrorResponse, I as UsageTapLogEntry, G as UsageTapResultEnvelope, H as UsageTapResultStatus, D as UsageTapSuccessResponse, V as VendorHints, J as WithUsageContext, K as WithUsageOptions, i as WrapOpenAICallOptions, j as WrapOpenAIResponseCallOptions, k as WrappedOpenAI, c as createOpenAIAdapter, s as streamOpenAIRoute, t as toNextResponse } from './openai-CKyw08rB.cjs';
+import { U as UsageTapClient, B as BeginCallRequest, W as WrapOpenAIContext, a as WrapOpenAIOptions, w as wrapOpenAI, p as pipeToResponse } from './openai-CeptbEGH.cjs';
+export { D as AllowedEntitlements, v as BalanceSummary, m as BeginCallOptions, n as BeginCallResponseBody, C as CheckUsageOptions, o as CheckUsageRequest, q as CheckUsageResponseBody, E as EndCallOptions, r as EndCallRequest, u as EndCallResponseBody, x as EntitlementHints, _ as IdempotencyMetadata, X as LimitType, y as MeterSnapshot, M as MeterSummary, z as MeteredUsage, Z as ModelHints, N as NodeResponseLike, O as OpenAIAdapter, b as OpenAIAdapterInit, d as OpenAIInvokeParams, e as OpenAIInvokeResult, f as OpenAIStreamParams, g as OpenAIStreamResult, P as PlanSummary, R as RemainingRatios, A as RequestedEntitlements, F as RetryOptions, S as StreamMode, l as StreamOpenAIRouteOptions, h as StreamToResponseOptions, Y as SubscriptionSnapshot, G as UsageTapClientOptions, I as UsageTapErrorResponse, L as UsageTapLogEntry, J as UsageTapResultEnvelope, K as UsageTapResultStatus, H as UsageTapSuccessResponse, V as VendorHints, Q as WithUsageContext, T as WithUsageOptions, i as WrapOpenAICallOptions, j as WrapOpenAIResponseCallOptions, k as WrappedOpenAI, c as createOpenAIAdapter, s as streamOpenAIRoute, t as toNextResponse } from './openai-CeptbEGH.cjs';
 export { createOpenRouterAdapter } from './adapters/openrouter.cjs';
 import OpenAI from 'openai';
 import { Request, Response, NextFunction } from 'express';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { U as UsageTapClient, B as BeginCallRequest, W as WrapOpenAIContext, a as WrapOpenAIOptions, w as wrapOpenAI, p as pipeToResponse } from './openai-CKyw08rB.js';
-export { A as AllowedEntitlements, r as BalanceSummary, m as BeginCallOptions, n as BeginCallResponseBody, E as EndCallOptions, o as EndCallRequest, q as EndCallResponseBody, u as EntitlementHints, X as IdempotencyMetadata, L as LimitType, v as MeterSnapshot, M as MeterSummary, x as MeteredUsage, T as ModelHints, N as NodeResponseLike, O as OpenAIAdapter, b as OpenAIAdapterInit, d as OpenAIInvokeParams, e as OpenAIInvokeResult, f as OpenAIStreamParams, g as OpenAIStreamResult, P as PlanSummary, R as RemainingRatios, y as RequestedEntitlements, z as RetryOptions, S as StreamMode, l as StreamOpenAIRouteOptions, h as StreamToResponseOptions, Q as SubscriptionSnapshot, C as UsageTapClientOptions, F as UsageTapErrorResponse, I as UsageTapLogEntry, G as UsageTapResultEnvelope, H as UsageTapResultStatus, D as UsageTapSuccessResponse, V as VendorHints, J as WithUsageContext, K as WithUsageOptions, i as WrapOpenAICallOptions, j as WrapOpenAIResponseCallOptions, k as WrappedOpenAI, c as createOpenAIAdapter, s as streamOpenAIRoute, t as toNextResponse } from './openai-CKyw08rB.js';
+import { U as UsageTapClient, B as BeginCallRequest, W as WrapOpenAIContext, a as WrapOpenAIOptions, w as wrapOpenAI, p as pipeToResponse } from './openai-CeptbEGH.js';
+export { D as AllowedEntitlements, v as BalanceSummary, m as BeginCallOptions, n as BeginCallResponseBody, C as CheckUsageOptions, o as CheckUsageRequest, q as CheckUsageResponseBody, E as EndCallOptions, r as EndCallRequest, u as EndCallResponseBody, x as EntitlementHints, _ as IdempotencyMetadata, X as LimitType, y as MeterSnapshot, M as MeterSummary, z as MeteredUsage, Z as ModelHints, N as NodeResponseLike, O as OpenAIAdapter, b as OpenAIAdapterInit, d as OpenAIInvokeParams, e as OpenAIInvokeResult, f as OpenAIStreamParams, g as OpenAIStreamResult, P as PlanSummary, R as RemainingRatios, A as RequestedEntitlements, F as RetryOptions, S as StreamMode, l as StreamOpenAIRouteOptions, h as StreamToResponseOptions, Y as SubscriptionSnapshot, G as UsageTapClientOptions, I as UsageTapErrorResponse, L as UsageTapLogEntry, J as UsageTapResultEnvelope, K as UsageTapResultStatus, H as UsageTapSuccessResponse, V as VendorHints, Q as WithUsageContext, T as WithUsageOptions, i as WrapOpenAICallOptions, j as WrapOpenAIResponseCallOptions, k as WrappedOpenAI, c as createOpenAIAdapter, s as streamOpenAIRoute, t as toNextResponse } from './openai-CeptbEGH.js';
 export { createOpenRouterAdapter } from './adapters/openrouter.js';
 import OpenAI from 'openai';
 import { Request, Response, NextFunction } from 'express';

package/dist/index.js

@@ -116,6 +116,7 @@ async function runWithRetry(operation, options, shouldRetry, onSchedule, signal)
 // src/client.ts
 var CALL_BEGIN_PATH = "call_begin";
 var CALL_END_PATH = "call_end";
+var CHECK_USAGE_PATH = "customers/{customerId}/usage";
 var AUTH_HEADER = "authorization";
 var API_KEY_HEADER = "x-api-key";
 var CORRELATION_HEADER = "x-usage-correlation-id";
@@ -123,7 +124,7 @@ 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 = "0.1.0" ;
+var SDK_VERSION = "0.2.1" ;
 var HAS_WINDOW = typeof globalThis !== "undefined" && typeof globalThis.window !== "undefined";
 var UsageTapClient = class {
   apiKey;
@@ -217,6 +218,23 @@ var UsageTapClient = class {
     );
     return response;
   }
+  async checkUsage(request, options = {}) {
+    if (!request?.customerId) {
+      throw new UsageTapError(
+        "USAGETAP_BAD_REQUEST",
+        "checkUsage requires customerId"
+      );
+    }
+    const path = CHECK_USAGE_PATH.replace(
+      "{customerId}",
+      encodeURIComponent(request.customerId)
+    );
+    const response = await this.requestGet(
+      path,
+      options
+    );
+    return response;
+  }
   async withUsage(beginRequest, handler, options = {}) {
     const idempotencyKey = beginRequest.idempotency ?? (this.autoIdempotency ? this.idempotencyGenerator() : void 0);
     const beginPayload = idempotencyKey ? { ...beginRequest, idempotency: idempotencyKey } : { ...beginRequest };
@@ -336,6 +354,62 @@ var UsageTapClient = class {
       throw error;
     });
   }
+  async requestGet(path, options) {
+    const url = new URL(path, this.baseUrl).toString();
+    const headers = this.composeHeaders(void 0, options);
+    const resolvedRetry = resolveRetryOptions(
+      this.retryDefaults,
+      options.retries
+    );
+    const startTime = () => typeof performance !== "undefined" ? performance.now() : Date.now();
+    return runWithRetry(
+      async (attempt) => {
+        const startedAt = startTime();
+        this.log({
+          event: "request:start",
+          path,
+          attempt,
+          correlationId: options.correlationId
+        });
+        const response = await this.performFetch({
+          url,
+          method: "GET",
+          headers,
+          signal: options.signal
+        });
+        this.log({
+          event: "request:success",
+          path,
+          attempt,
+          correlationId: response.correlationId,
+          elapsedMs: startTime() - startedAt
+        });
+        return response;
+      },
+      resolvedRetry,
+      (error) => this.shouldRetry(error),
+      (attempt, delayMs, error) => {
+        this.log({
+          event: "retry:scheduled",
+          path,
+          attempt,
+          correlationId: options.correlationId,
+          error,
+          elapsedMs: delayMs
+        });
+      },
+      options.signal
+    ).catch((error) => {
+      this.log({
+        event: "retry:exhausted",
+        path,
+        attempt: resolvedRetry.maxAttempts,
+        correlationId: options.correlationId,
+        error
+      });
+      throw error;
+    });
+  }
   async performFetch(init) {
     let response;
     try {