@usagetap/sdk 1.3.2 → 1.7.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { U as UsageTapClient, B as BeginCallRequest } from './client-BD8O2J8Z.cjs';
-export { a7 as AllowedEntitlements, T as BalanceSummary, s as BeginCallOptions, c as BeginCallResponseBody, G as ChangePlanOptions, H as ChangePlanRequest, I as ChangePlanResponseBody, J as ChangePlanStrategy, A as CheckUsageOptions, D as CheckUsageRequest, F as CheckUsageResponseBody, C as CreateCustomerOptions, y as CreateCustomerRequest, z as CreateCustomerResponseBody, O as CustomMeterSlot, Q as EndCallOptions, E as EndCallRequest, S as EndCallResponseBody, _ as EntitlementHints, ai as IdempotencyMetadata, K as IncrementCustomMeterOptions, L as IncrementCustomMeterRequest, N as IncrementCustomMeterResponseBody, af as LimitType, M as MeterRequest, a1 as MeterSnapshot, a0 as MeterSummary, a2 as MeteredUsage, ah as ModelHints, $ as PlanSummary, l as PromptCompressionInput, o as PromptCompressionMessageRole, m as PromptCompressionMessagesAggressiveness, n as PromptCompressionMessagesInput, v as PromptCompressionMessagesOptions, u as PromptCompressionOptions, P as PromptCompressionProvider, t as PromptCompressionRequest, w as PromptCompressionResponseBody, q as PromptCompressionResult, r as PromptCompressionRoleAggressiveness, x as PromptCompressionStandaloneOptions, a as PromptCompressionTelemetry, a3 as RateLimitsSnapshot, R as RecordPromptCompressionRequest, a4 as RemainingRatios, a6 as RequestedEntitlements, a8 as RetryOptions, a5 as RollingCallsRateLimitState, X as SpendVelocitySnapshot, Y as SpendVelocityWindow, Z as SpendVelocityWindowKey, ag as SubscriptionSnapshot, aj as UsageMetricEvent, a9 as UsageTapClientOptions, d as UsageTapCompressOptions, e as UsageTapCompressResult, aa as UsageTapErrorResponse, ad as UsageTapLogEntry, ab as UsageTapResultEnvelope, ac as UsageTapResultStatus, b as UsageTapSuccessResponse, V as VendorHints, ae as WithUsageContext, W as WithUsageOptions, f as compressPrompt, h as compressPromptHeuristic, g as compressPromptMessages, i as compressPromptToon, j as estimatePromptTokens, p as protect, k as protectPromptText } from './client-BD8O2J8Z.cjs';
+import { U as UsageTapClient, B as BeginCallRequest } from './client-C0UiaqVB.cjs';
+export { aF as AllowedEntitlements, as as BalanceSummary, a5 as BeginCallOptions, d as BeginCallResponseBody, aX as CaptureSampleOptions, aW as CaptureSampleRequest, aY as CaptureSampleResponseBody, ai as ChangePlanOptions, aj as ChangePlanRequest, ak as ChangePlanResponseBody, al as ChangePlanStrategy, af as CheckUsageOptions, ag as CheckUsageRequest, ah as CheckUsageResponseBody, b3 as CircuitBreakerDecision, b2 as CircuitBreakerOptions, ac as CreateCustomerOptions, ad as CreateCustomerRequest, ae as CreateCustomerResponseBody, ap as CustomMeterSlot, aq as EndCallOptions, E as EndCallRequest, ar as EndCallResponseBody, aw as EntitlementHints, G as GatewayBatch, g as GatewayBatchCreateParams, h as GatewayBatchRequest, i as GatewayBatchResult, j as GatewayBatchStatus, k as GatewayChatCompletion, l as GatewayChatCompletionCreateParams, m as GatewayChatMessage, x as GatewayModel, y as GatewayModelList, n as GatewayPromptCacheBreakpoint, o as GatewayResponse, p as GatewayResponseCreateParams, q as GatewayResponseInputItem, r as GatewayResponseInputMessage, s as GatewayResponseInputText, t as GatewayResponsePromptCacheOptions, u as GatewayResponseTextConfig, v as GatewayResponseTextFormat, w as GatewayResponseVerbosity, a_ as GetSamplingSettingsOptions, aT as IdempotencyMetadata, am as IncrementCustomMeterOptions, an as IncrementCustomMeterRequest, ao as IncrementCustomMeterResponseBody, aQ as LimitType, M as MeterRequest, az as MeterSnapshot, ay as MeterSummary, aA as MeteredUsage, aS as ModelHints, ax as PlanSummary, $ as PromptCompressionInput, a2 as PromptCompressionMessageRole, a0 as PromptCompressionMessagesAggressiveness, a1 as PromptCompressionMessagesInput, a8 as PromptCompressionMessagesOptions, a as PromptCompressionMode, a7 as PromptCompressionOptions, P as PromptCompressionProvider, a6 as PromptCompressionRequest, a9 as PromptCompressionResponseBody, a3 as PromptCompressionResult, a4 as PromptCompressionRoleAggressiveness, aa as PromptCompressionStandaloneOptions, b as PromptCompressionTelemetry, aB as RateLimitsSnapshot, aH as ReasoningEffort, aI as ReasoningEffortSource, aG as ReasoningLevel, ab as RecordPromptCompressionRequest, aC as RemainingRatios, aE as RequestedEntitlements, R as ResourceRequestOptions, aJ as RetryOptions, aD as RollingCallsRateLimitState, aV as SamplingDecisionInput, b1 as SamplingDecisionOptions, a$ as SamplingDecisionRequest, b0 as SamplingDecisionResponseBody, S as SamplingOptions, aZ as SamplingSettings, at as SpendVelocitySnapshot, au as SpendVelocityWindow, av as SpendVelocityWindowKey, aR as SubscriptionSnapshot, z as SummarizationBatch, A as SummarizationBatchCreateParams, C as SummarizationBatchJob, D as SummarizationContext, F as SummarizationCreateParams, H as SummarizationJob, I as SummarizationMeasurement, J as SummarizationMeasurementCreateParams, K as SummarizationProfile, L as SummarizationStatus, aU as UsageMetricEvent, aK as UsageTapClientOptions, e as UsageTapCompressOptions, f as UsageTapCompressResult, aL as UsageTapErrorResponse, aO as UsageTapLogEntry, aM as UsageTapResultEnvelope, aN as UsageTapResultStatus, c as UsageTapSuccessResponse, V as VendorHints, N as WaitOptions, aP as WithUsageContext, W as WithUsageOptions, O as compressPrompt, T as compressPromptHeuristic, Q as compressPromptMessages, X as compressPromptToon, Y as estimatePromptTokens, Z as protect, _ as protectPromptText } from './client-C0UiaqVB.cjs';
 
-type UsageTapErrorCode = "USAGETAP_BROWSER_RUNTIME" | "USAGETAP_AUTH_ERROR" | "USAGETAP_BAD_REQUEST" | "USAGETAP_INVALID_RESPONSE" | "USAGETAP_NETWORK_ERROR" | "USAGETAP_RATE_LIMITED" | "USAGETAP_SERVER_ERROR" | "USAGETAP_RETRY_EXHAUSTED" | "USAGETAP_END_CALL_ERROR";
+type UsageTapErrorCode = "USAGETAP_BROWSER_RUNTIME" | "USAGETAP_AUTH_ERROR" | "USAGETAP_BAD_REQUEST" | "USAGETAP_INVALID_RESPONSE" | "USAGETAP_NETWORK_ERROR" | "USAGETAP_RATE_LIMITED" | "USAGETAP_CIRCUIT_OPEN" | "USAGETAP_SERVER_ERROR" | "USAGETAP_RETRY_EXHAUSTED" | "USAGETAP_END_CALL_ERROR";
 interface UsageTapErrorInit {
     status?: number;
     retryable?: boolean;
@@ -24,6 +24,8 @@ interface WrapFetchContext extends Omit<BeginCallRequest, "idempotency"> {
     customerId: string;
 }
 interface WrapFetchOptions {
+    /** Vendor label recorded at call_end. Defaults to `openai`. */
+    provider?: string;
     /**
      * Context for UsageTap begin calls.
      * Can be overridden per-request via special headers.
@@ -41,9 +43,18 @@ interface WrapFetchOptions {
     autoIdempotency?: boolean;
     /**
      * Detect OpenAI-compatible endpoints by URL pattern.
-     * Default: detects /v1/chat/completions and /v1/responses
+     * Default: detects /v1/chat/completions, /v1/responses, and /v1/embeddings
      */
     isOpenAIEndpoint?: (url: string) => boolean;
+    /** Receive request parsing or begin/end failures after client retries. */
+    onMeteringError?: (event: WrapFetchMeteringError) => void | Promise<void>;
+    /** Throw metering failures instead of allowing the vendor response through. */
+    strictMetering?: boolean;
+}
+interface WrapFetchMeteringError {
+    stage: "request" | "begin" | "end";
+    callId?: string;
+    error: unknown;
 }
 /**
  * Wraps a fetch implementation to automatically instrument OpenAI API calls
@@ -65,4 +76,4 @@ declare function wrapFetch(usageTap: UsageTapClient, options: WrapFetchOptions):
 
 declare function createIdempotencyKey(): string;
 
-export { BeginCallRequest, UsageTapClient as UsageTap, UsageTapClient, UsageTapError, type UsageTapErrorCode, type UsageTapErrorInit, type WrapFetchContext, type WrapFetchOptions, createIdempotencyKey, isUsageTapError, wrapFetch };
+export { BeginCallRequest, UsageTapClient as UsageTap, UsageTapClient, UsageTapError, type UsageTapErrorCode, type UsageTapErrorInit, type WrapFetchContext, type WrapFetchMeteringError, type WrapFetchOptions, createIdempotencyKey, isUsageTapError, wrapFetch };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { U as UsageTapClient, B as BeginCallRequest } from './client-BD8O2J8Z.js';
-export { a7 as AllowedEntitlements, T as BalanceSummary, s as BeginCallOptions, c as BeginCallResponseBody, G as ChangePlanOptions, H as ChangePlanRequest, I as ChangePlanResponseBody, J as ChangePlanStrategy, A as CheckUsageOptions, D as CheckUsageRequest, F as CheckUsageResponseBody, C as CreateCustomerOptions, y as CreateCustomerRequest, z as CreateCustomerResponseBody, O as CustomMeterSlot, Q as EndCallOptions, E as EndCallRequest, S as EndCallResponseBody, _ as EntitlementHints, ai as IdempotencyMetadata, K as IncrementCustomMeterOptions, L as IncrementCustomMeterRequest, N as IncrementCustomMeterResponseBody, af as LimitType, M as MeterRequest, a1 as MeterSnapshot, a0 as MeterSummary, a2 as MeteredUsage, ah as ModelHints, $ as PlanSummary, l as PromptCompressionInput, o as PromptCompressionMessageRole, m as PromptCompressionMessagesAggressiveness, n as PromptCompressionMessagesInput, v as PromptCompressionMessagesOptions, u as PromptCompressionOptions, P as PromptCompressionProvider, t as PromptCompressionRequest, w as PromptCompressionResponseBody, q as PromptCompressionResult, r as PromptCompressionRoleAggressiveness, x as PromptCompressionStandaloneOptions, a as PromptCompressionTelemetry, a3 as RateLimitsSnapshot, R as RecordPromptCompressionRequest, a4 as RemainingRatios, a6 as RequestedEntitlements, a8 as RetryOptions, a5 as RollingCallsRateLimitState, X as SpendVelocitySnapshot, Y as SpendVelocityWindow, Z as SpendVelocityWindowKey, ag as SubscriptionSnapshot, aj as UsageMetricEvent, a9 as UsageTapClientOptions, d as UsageTapCompressOptions, e as UsageTapCompressResult, aa as UsageTapErrorResponse, ad as UsageTapLogEntry, ab as UsageTapResultEnvelope, ac as UsageTapResultStatus, b as UsageTapSuccessResponse, V as VendorHints, ae as WithUsageContext, W as WithUsageOptions, f as compressPrompt, h as compressPromptHeuristic, g as compressPromptMessages, i as compressPromptToon, j as estimatePromptTokens, p as protect, k as protectPromptText } from './client-BD8O2J8Z.js';
+import { U as UsageTapClient, B as BeginCallRequest } from './client-C0UiaqVB.js';
+export { aF as AllowedEntitlements, as as BalanceSummary, a5 as BeginCallOptions, d as BeginCallResponseBody, aX as CaptureSampleOptions, aW as CaptureSampleRequest, aY as CaptureSampleResponseBody, ai as ChangePlanOptions, aj as ChangePlanRequest, ak as ChangePlanResponseBody, al as ChangePlanStrategy, af as CheckUsageOptions, ag as CheckUsageRequest, ah as CheckUsageResponseBody, b3 as CircuitBreakerDecision, b2 as CircuitBreakerOptions, ac as CreateCustomerOptions, ad as CreateCustomerRequest, ae as CreateCustomerResponseBody, ap as CustomMeterSlot, aq as EndCallOptions, E as EndCallRequest, ar as EndCallResponseBody, aw as EntitlementHints, G as GatewayBatch, g as GatewayBatchCreateParams, h as GatewayBatchRequest, i as GatewayBatchResult, j as GatewayBatchStatus, k as GatewayChatCompletion, l as GatewayChatCompletionCreateParams, m as GatewayChatMessage, x as GatewayModel, y as GatewayModelList, n as GatewayPromptCacheBreakpoint, o as GatewayResponse, p as GatewayResponseCreateParams, q as GatewayResponseInputItem, r as GatewayResponseInputMessage, s as GatewayResponseInputText, t as GatewayResponsePromptCacheOptions, u as GatewayResponseTextConfig, v as GatewayResponseTextFormat, w as GatewayResponseVerbosity, a_ as GetSamplingSettingsOptions, aT as IdempotencyMetadata, am as IncrementCustomMeterOptions, an as IncrementCustomMeterRequest, ao as IncrementCustomMeterResponseBody, aQ as LimitType, M as MeterRequest, az as MeterSnapshot, ay as MeterSummary, aA as MeteredUsage, aS as ModelHints, ax as PlanSummary, $ as PromptCompressionInput, a2 as PromptCompressionMessageRole, a0 as PromptCompressionMessagesAggressiveness, a1 as PromptCompressionMessagesInput, a8 as PromptCompressionMessagesOptions, a as PromptCompressionMode, a7 as PromptCompressionOptions, P as PromptCompressionProvider, a6 as PromptCompressionRequest, a9 as PromptCompressionResponseBody, a3 as PromptCompressionResult, a4 as PromptCompressionRoleAggressiveness, aa as PromptCompressionStandaloneOptions, b as PromptCompressionTelemetry, aB as RateLimitsSnapshot, aH as ReasoningEffort, aI as ReasoningEffortSource, aG as ReasoningLevel, ab as RecordPromptCompressionRequest, aC as RemainingRatios, aE as RequestedEntitlements, R as ResourceRequestOptions, aJ as RetryOptions, aD as RollingCallsRateLimitState, aV as SamplingDecisionInput, b1 as SamplingDecisionOptions, a$ as SamplingDecisionRequest, b0 as SamplingDecisionResponseBody, S as SamplingOptions, aZ as SamplingSettings, at as SpendVelocitySnapshot, au as SpendVelocityWindow, av as SpendVelocityWindowKey, aR as SubscriptionSnapshot, z as SummarizationBatch, A as SummarizationBatchCreateParams, C as SummarizationBatchJob, D as SummarizationContext, F as SummarizationCreateParams, H as SummarizationJob, I as SummarizationMeasurement, J as SummarizationMeasurementCreateParams, K as SummarizationProfile, L as SummarizationStatus, aU as UsageMetricEvent, aK as UsageTapClientOptions, e as UsageTapCompressOptions, f as UsageTapCompressResult, aL as UsageTapErrorResponse, aO as UsageTapLogEntry, aM as UsageTapResultEnvelope, aN as UsageTapResultStatus, c as UsageTapSuccessResponse, V as VendorHints, N as WaitOptions, aP as WithUsageContext, W as WithUsageOptions, O as compressPrompt, T as compressPromptHeuristic, Q as compressPromptMessages, X as compressPromptToon, Y as estimatePromptTokens, Z as protect, _ as protectPromptText } from './client-C0UiaqVB.js';
 
-type UsageTapErrorCode = "USAGETAP_BROWSER_RUNTIME" | "USAGETAP_AUTH_ERROR" | "USAGETAP_BAD_REQUEST" | "USAGETAP_INVALID_RESPONSE" | "USAGETAP_NETWORK_ERROR" | "USAGETAP_RATE_LIMITED" | "USAGETAP_SERVER_ERROR" | "USAGETAP_RETRY_EXHAUSTED" | "USAGETAP_END_CALL_ERROR";
+type UsageTapErrorCode = "USAGETAP_BROWSER_RUNTIME" | "USAGETAP_AUTH_ERROR" | "USAGETAP_BAD_REQUEST" | "USAGETAP_INVALID_RESPONSE" | "USAGETAP_NETWORK_ERROR" | "USAGETAP_RATE_LIMITED" | "USAGETAP_CIRCUIT_OPEN" | "USAGETAP_SERVER_ERROR" | "USAGETAP_RETRY_EXHAUSTED" | "USAGETAP_END_CALL_ERROR";
 interface UsageTapErrorInit {
     status?: number;
     retryable?: boolean;
@@ -24,6 +24,8 @@ interface WrapFetchContext extends Omit<BeginCallRequest, "idempotency"> {
     customerId: string;
 }
 interface WrapFetchOptions {
+    /** Vendor label recorded at call_end. Defaults to `openai`. */
+    provider?: string;
     /**
      * Context for UsageTap begin calls.
      * Can be overridden per-request via special headers.
@@ -41,9 +43,18 @@ interface WrapFetchOptions {
     autoIdempotency?: boolean;
     /**
      * Detect OpenAI-compatible endpoints by URL pattern.
-     * Default: detects /v1/chat/completions and /v1/responses
+     * Default: detects /v1/chat/completions, /v1/responses, and /v1/embeddings
      */
     isOpenAIEndpoint?: (url: string) => boolean;
+    /** Receive request parsing or begin/end failures after client retries. */
+    onMeteringError?: (event: WrapFetchMeteringError) => void | Promise<void>;
+    /** Throw metering failures instead of allowing the vendor response through. */
+    strictMetering?: boolean;
+}
+interface WrapFetchMeteringError {
+    stage: "request" | "begin" | "end";
+    callId?: string;
+    error: unknown;
 }
 /**
  * Wraps a fetch implementation to automatically instrument OpenAI API calls
@@ -65,4 +76,4 @@ declare function wrapFetch(usageTap: UsageTapClient, options: WrapFetchOptions):
 
 declare function createIdempotencyKey(): string;
 
-export { BeginCallRequest, UsageTapClient as UsageTap, UsageTapClient, UsageTapError, type UsageTapErrorCode, type UsageTapErrorInit, type WrapFetchContext, type WrapFetchOptions, createIdempotencyKey, isUsageTapError, wrapFetch };
+export { BeginCallRequest, UsageTapClient as UsageTap, UsageTapClient, UsageTapError, type UsageTapErrorCode, type UsageTapErrorInit, type WrapFetchContext, type WrapFetchMeteringError, type WrapFetchOptions, createIdempotencyKey, isUsageTapError, wrapFetch };