@usagetap/sdk 1.4.0 → 1.7.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { U as UsageTapClient, B as BeginCallRequest } from './client-CExQ8e1T.cjs';
-export { av as AllowedEntitlements, ai as BalanceSummary, X as BeginCallOptions, d as BeginCallResponseBody, aN as CaptureSampleOptions, aM as CaptureSampleRequest, aO as CaptureSampleResponseBody, a8 as ChangePlanOptions, a9 as ChangePlanRequest, aa as ChangePlanResponseBody, ab as ChangePlanStrategy, a5 as CheckUsageOptions, a6 as CheckUsageRequest, a7 as CheckUsageResponseBody, aV as CircuitBreakerDecision, aU as CircuitBreakerOptions, a2 as CreateCustomerOptions, a3 as CreateCustomerRequest, a4 as CreateCustomerResponseBody, af as CustomMeterSlot, ag as EndCallOptions, E as EndCallRequest, ah as EndCallResponseBody, am 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, n as GatewayModel, o as GatewayModelList, aQ as GetSamplingSettingsOptions, aJ as IdempotencyMetadata, ac as IncrementCustomMeterOptions, ad as IncrementCustomMeterRequest, ae as IncrementCustomMeterResponseBody, aG as LimitType, M as MeterRequest, ap as MeterSnapshot, ao as MeterSummary, aq as MeteredUsage, aI as ModelHints, an as PlanSummary, K as PromptCompressionInput, O as PromptCompressionMessageRole, L as PromptCompressionMessagesAggressiveness, N as PromptCompressionMessagesInput, _ as PromptCompressionMessagesOptions, a as PromptCompressionMode, Z as PromptCompressionOptions, P as PromptCompressionProvider, Y as PromptCompressionRequest, $ as PromptCompressionResponseBody, Q as PromptCompressionResult, T as PromptCompressionRoleAggressiveness, a0 as PromptCompressionStandaloneOptions, b as PromptCompressionTelemetry, ar as RateLimitsSnapshot, ax as ReasoningEffort, ay as ReasoningEffortSource, aw as ReasoningLevel, a1 as RecordPromptCompressionRequest, as as RemainingRatios, au as RequestedEntitlements, R as ResourceRequestOptions, az as RetryOptions, at as RollingCallsRateLimitState, aL as SamplingDecisionInput, aT as SamplingDecisionOptions, aR as SamplingDecisionRequest, aS as SamplingDecisionResponseBody, S as SamplingOptions, aP as SamplingSettings, aj as SpendVelocitySnapshot, ak as SpendVelocityWindow, al as SpendVelocityWindowKey, aH as SubscriptionSnapshot, p as SummarizationBatch, q as SummarizationBatchCreateParams, r as SummarizationBatchJob, s as SummarizationContext, t as SummarizationCreateParams, u as SummarizationJob, v as SummarizationMeasurement, w as SummarizationMeasurementCreateParams, x as SummarizationProfile, y as SummarizationStatus, aK as UsageMetricEvent, aA as UsageTapClientOptions, e as UsageTapCompressOptions, f as UsageTapCompressResult, aB as UsageTapErrorResponse, aE as UsageTapLogEntry, aC as UsageTapResultEnvelope, aD as UsageTapResultStatus, c as UsageTapSuccessResponse, V as VendorHints, z as WaitOptions, aF as WithUsageContext, W as WithUsageOptions, A as compressPrompt, D as compressPromptHeuristic, C as compressPromptMessages, F as compressPromptToon, H as estimatePromptTokens, I as protect, J as protectPromptText } from './client-CExQ8e1T.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_CIRCUIT_OPEN" | "USAGETAP_SERVER_ERROR" | "USAGETAP_RETRY_EXHAUSTED" | "USAGETAP_END_CALL_ERROR";
 interface UsageTapErrorInit {
@@ -43,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
@@ -67,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,5 +1,5 @@
-import { U as UsageTapClient, B as BeginCallRequest } from './client-CExQ8e1T.js';
-export { av as AllowedEntitlements, ai as BalanceSummary, X as BeginCallOptions, d as BeginCallResponseBody, aN as CaptureSampleOptions, aM as CaptureSampleRequest, aO as CaptureSampleResponseBody, a8 as ChangePlanOptions, a9 as ChangePlanRequest, aa as ChangePlanResponseBody, ab as ChangePlanStrategy, a5 as CheckUsageOptions, a6 as CheckUsageRequest, a7 as CheckUsageResponseBody, aV as CircuitBreakerDecision, aU as CircuitBreakerOptions, a2 as CreateCustomerOptions, a3 as CreateCustomerRequest, a4 as CreateCustomerResponseBody, af as CustomMeterSlot, ag as EndCallOptions, E as EndCallRequest, ah as EndCallResponseBody, am 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, n as GatewayModel, o as GatewayModelList, aQ as GetSamplingSettingsOptions, aJ as IdempotencyMetadata, ac as IncrementCustomMeterOptions, ad as IncrementCustomMeterRequest, ae as IncrementCustomMeterResponseBody, aG as LimitType, M as MeterRequest, ap as MeterSnapshot, ao as MeterSummary, aq as MeteredUsage, aI as ModelHints, an as PlanSummary, K as PromptCompressionInput, O as PromptCompressionMessageRole, L as PromptCompressionMessagesAggressiveness, N as PromptCompressionMessagesInput, _ as PromptCompressionMessagesOptions, a as PromptCompressionMode, Z as PromptCompressionOptions, P as PromptCompressionProvider, Y as PromptCompressionRequest, $ as PromptCompressionResponseBody, Q as PromptCompressionResult, T as PromptCompressionRoleAggressiveness, a0 as PromptCompressionStandaloneOptions, b as PromptCompressionTelemetry, ar as RateLimitsSnapshot, ax as ReasoningEffort, ay as ReasoningEffortSource, aw as ReasoningLevel, a1 as RecordPromptCompressionRequest, as as RemainingRatios, au as RequestedEntitlements, R as ResourceRequestOptions, az as RetryOptions, at as RollingCallsRateLimitState, aL as SamplingDecisionInput, aT as SamplingDecisionOptions, aR as SamplingDecisionRequest, aS as SamplingDecisionResponseBody, S as SamplingOptions, aP as SamplingSettings, aj as SpendVelocitySnapshot, ak as SpendVelocityWindow, al as SpendVelocityWindowKey, aH as SubscriptionSnapshot, p as SummarizationBatch, q as SummarizationBatchCreateParams, r as SummarizationBatchJob, s as SummarizationContext, t as SummarizationCreateParams, u as SummarizationJob, v as SummarizationMeasurement, w as SummarizationMeasurementCreateParams, x as SummarizationProfile, y as SummarizationStatus, aK as UsageMetricEvent, aA as UsageTapClientOptions, e as UsageTapCompressOptions, f as UsageTapCompressResult, aB as UsageTapErrorResponse, aE as UsageTapLogEntry, aC as UsageTapResultEnvelope, aD as UsageTapResultStatus, c as UsageTapSuccessResponse, V as VendorHints, z as WaitOptions, aF as WithUsageContext, W as WithUsageOptions, A as compressPrompt, D as compressPromptHeuristic, C as compressPromptMessages, F as compressPromptToon, H as estimatePromptTokens, I as protect, J as protectPromptText } from './client-CExQ8e1T.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_CIRCUIT_OPEN" | "USAGETAP_SERVER_ERROR" | "USAGETAP_RETRY_EXHAUSTED" | "USAGETAP_END_CALL_ERROR";
 interface UsageTapErrorInit {
@@ -43,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
@@ -67,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 };