autumn-js 1.3.73 → 1.4.0

package/dist/sdk/index.d.mts

@@ -109,10 +109,10 @@ type SDKOptions = {
 declare function serverURLFromOptions(options: SDKOptions): URL | null;
 declare const SDK_METADATA: {
     readonly language: "typescript";
-    readonly openapiDocVersion: "2.4.0";
+    readonly openapiDocVersion: "2.5.0";
     readonly sdkVersion: "0.10.18";
     readonly genVersion: "2.884.13";
-    readonly userAgent: "speakeasy-sdk/typescript 0.10.18 2.884.13 2.4.0 @useautumn/sdk";
+    readonly userAgent: "speakeasy-sdk/typescript 0.10.18 2.884.13 2.5.0 @useautumn/sdk";
 };
 
 /**
@@ -5522,10 +5522,6 @@ type RequestBody = {
      * How to handle usage that exceeds the available balance. "cap" (default) deducts only what fits, stopping at zero. "overflow" deducts the full value: the balance can go negative and usage limits do not clamp the deduction, though spend limits still apply.
      */
     overageBehavior?: BatchTrackOverageBehavior | undefined;
-    /**
-     * If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information.
-     */
-    async?: boolean | undefined;
 };
 /**
  * Batch accepted. All items passed synchronous validation. Enqueue is best-effort: partial failures (some items enqueued, some not) are logged server-side and are NOT surfaced in the response body; clients must not retry on success. See the endpoint description for full partial-failure semantics.
@@ -5555,7 +5551,6 @@ type RequestBody$Outbound = {
     idempotency_key?: string | undefined;
     timestamp?: number | undefined;
     overage_behavior?: string | undefined;
-    async?: boolean | undefined;
 };
 /** @internal */
 declare const RequestBody$outboundSchema: z$1.ZodMiniType<RequestBody$Outbound, RequestBody>;
@@ -77801,7 +77796,7 @@ type TrackParams = {
      */
     overageBehavior?: TrackOverageBehavior | undefined;
     /**
-     * If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information.
+     * Defaults to true: the event is queued and the response is a 202 with balance: null. Set to false to apply the usage before responding with a 200 and the updated balance.
      */
     async?: boolean | undefined;
 };
@@ -77858,7 +77853,7 @@ type TrackDeduction2 = {
     value: number;
 };
 /**
- * Accepted. Autumn is experiencing degraded service from a downstream provider, so the event was accepted for replay and will be tracked as soon as the service is restored.
+ * Accepted. The event was queued and will be applied shortly, so balance is null. Returned by default unless async is false, and when Autumn is experiencing degraded service.
  */
 type TrackResponseBody2 = {
     /**
@@ -78105,7 +78100,7 @@ type TrackTokensParams = {
      */
     overageBehavior?: TrackTokensOverageBehavior | undefined;
     /**
-     * If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information.
+     * Defaults to true: the event is queued and the response is a 202 with balance: null. Set to false to apply the usage before responding with a 200 and the updated balance.
      */
     async?: boolean | undefined;
 };
@@ -78162,7 +78157,7 @@ type TrackTokensDeduction2 = {
     value: number;
 };
 /**
- * Accepted. Autumn is experiencing degraded service from a downstream provider, so the token usage event was accepted for replay and will be tracked as soon as the service is restored.
+ * Accepted. The token usage event was queued and will be applied shortly, so balance is null. Returned by default unless async is false, and when Autumn is experiencing degraded service.
  */
 type TrackTokensResponseBody2 = {
     /**
@@ -95287,7 +95282,7 @@ declare class Autumn extends ClientSDK {
      */
     check(request: CheckParams, options?: RequestOptions): Promise<CheckResponse>;
     /**
-     * Records usage for a customer feature and returns updated balances.
+     * Records usage for a customer feature. Queued by default; pass async: false to apply it before responding with updated balances.
      *
      * Use this after an action happens to decrement usage, or send a negative value to credit balance back.
      *
@@ -95311,9 +95306,9 @@ declare class Autumn extends ClientSDK {
      * @param properties - Additional properties to attach to this usage event. (optional)
      * @param timestamp - Unix timestamp in milliseconds to use for the usage event. Defaults to the current time. (optional)
      * @param overageBehavior - How to handle usage that exceeds the available balance. "cap" (default) deducts only what fits, stopping at zero. "overflow" deducts the full value: the balance can go negative and usage limits do not clamp the deduction, though spend limits still apply. (optional)
-     * @param async - If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information. (optional)
+     * @param async - Defaults to true: the event is queued and the response is a 202 with balance: null. Set to false to apply the usage before responding with a 200 and the updated balance. (optional)
      *
-     * @returns The usage value recorded, with either a single updated balance or a map of updated balances. If Autumn is experiencing degraded service from a downstream provider, the API may return 202 after accepting the event for replay so it can be tracked as soon as the service is restored.
+     * @returns The usage value recorded. By default the event is queued and the API returns 202 with balance: null. With async: false it returns 200 with either a single updated balance or a map of updated balances, or 202 if Autumn is experiencing degraded service and accepted the event for replay.
      */
     track(request: TrackParams, options?: RequestOptions): Promise<TrackResponse>;
     /**
@@ -95348,9 +95343,9 @@ declare class Autumn extends ClientSDK {
      * @param properties - Additional properties to attach to this usage event. (optional)
      * @param timestamp - Unix timestamp in milliseconds to use for the usage event. Defaults to the current time. (optional)
      * @param overageBehavior - How to handle usage that exceeds the available balance. "cap" (default) deducts only what fits, stopping at zero. "overflow" deducts the full value: the balance can go negative and usage limits do not clamp the deduction, though spend limits still apply. (optional)
-     * @param async - If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information. (optional)
+     * @param async - Defaults to true: the event is queued and the response is a 202 with balance: null. Set to false to apply the usage before responding with a 200 and the updated balance. (optional)
      *
-     * @returns The dollar value recorded and the updated AI credit system balance. If Autumn is experiencing degraded service from a downstream provider, the API may return 202 after accepting the token usage event for replay so it can be tracked as soon as the service is restored.
+     * @returns The dollar value recorded. By default the event is queued and the API returns 202 with balance: null. With async: false it returns 200 with the updated AI credit system balance, or 202 if Autumn is experiencing degraded service and accepted the event for replay.
      */
     trackTokens(request: TrackTokensParams, options?: RequestOptions): Promise<TrackTokensResponse>;
     /**

package/dist/sdk/index.d.ts

@@ -109,10 +109,10 @@ type SDKOptions = {
 declare function serverURLFromOptions(options: SDKOptions): URL | null;
 declare const SDK_METADATA: {
     readonly language: "typescript";
-    readonly openapiDocVersion: "2.4.0";
+    readonly openapiDocVersion: "2.5.0";
     readonly sdkVersion: "0.10.18";
     readonly genVersion: "2.884.13";
-    readonly userAgent: "speakeasy-sdk/typescript 0.10.18 2.884.13 2.4.0 @useautumn/sdk";
+    readonly userAgent: "speakeasy-sdk/typescript 0.10.18 2.884.13 2.5.0 @useautumn/sdk";
 };
 
 /**
@@ -5522,10 +5522,6 @@ type RequestBody = {
      * How to handle usage that exceeds the available balance. "cap" (default) deducts only what fits, stopping at zero. "overflow" deducts the full value: the balance can go negative and usage limits do not clamp the deduction, though spend limits still apply.
      */
     overageBehavior?: BatchTrackOverageBehavior | undefined;
-    /**
-     * If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information.
-     */
-    async?: boolean | undefined;
 };
 /**
  * Batch accepted. All items passed synchronous validation. Enqueue is best-effort: partial failures (some items enqueued, some not) are logged server-side and are NOT surfaced in the response body; clients must not retry on success. See the endpoint description for full partial-failure semantics.
@@ -5555,7 +5551,6 @@ type RequestBody$Outbound = {
     idempotency_key?: string | undefined;
     timestamp?: number | undefined;
     overage_behavior?: string | undefined;
-    async?: boolean | undefined;
 };
 /** @internal */
 declare const RequestBody$outboundSchema: z$1.ZodMiniType<RequestBody$Outbound, RequestBody>;
@@ -77801,7 +77796,7 @@ type TrackParams = {
      */
     overageBehavior?: TrackOverageBehavior | undefined;
     /**
-     * If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information.
+     * Defaults to true: the event is queued and the response is a 202 with balance: null. Set to false to apply the usage before responding with a 200 and the updated balance.
      */
     async?: boolean | undefined;
 };
@@ -77858,7 +77853,7 @@ type TrackDeduction2 = {
     value: number;
 };
 /**
- * Accepted. Autumn is experiencing degraded service from a downstream provider, so the event was accepted for replay and will be tracked as soon as the service is restored.
+ * Accepted. The event was queued and will be applied shortly, so balance is null. Returned by default unless async is false, and when Autumn is experiencing degraded service.
  */
 type TrackResponseBody2 = {
     /**
@@ -78105,7 +78100,7 @@ type TrackTokensParams = {
      */
     overageBehavior?: TrackTokensOverageBehavior | undefined;
     /**
-     * If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information.
+     * Defaults to true: the event is queued and the response is a 202 with balance: null. Set to false to apply the usage before responding with a 200 and the updated balance.
      */
     async?: boolean | undefined;
 };
@@ -78162,7 +78157,7 @@ type TrackTokensDeduction2 = {
     value: number;
 };
 /**
- * Accepted. Autumn is experiencing degraded service from a downstream provider, so the token usage event was accepted for replay and will be tracked as soon as the service is restored.
+ * Accepted. The token usage event was queued and will be applied shortly, so balance is null. Returned by default unless async is false, and when Autumn is experiencing degraded service.
  */
 type TrackTokensResponseBody2 = {
     /**
@@ -95287,7 +95282,7 @@ declare class Autumn extends ClientSDK {
      */
     check(request: CheckParams, options?: RequestOptions): Promise<CheckResponse>;
     /**
-     * Records usage for a customer feature and returns updated balances.
+     * Records usage for a customer feature. Queued by default; pass async: false to apply it before responding with updated balances.
      *
      * Use this after an action happens to decrement usage, or send a negative value to credit balance back.
      *
@@ -95311,9 +95306,9 @@ declare class Autumn extends ClientSDK {
      * @param properties - Additional properties to attach to this usage event. (optional)
      * @param timestamp - Unix timestamp in milliseconds to use for the usage event. Defaults to the current time. (optional)
      * @param overageBehavior - How to handle usage that exceeds the available balance. "cap" (default) deducts only what fits, stopping at zero. "overflow" deducts the full value: the balance can go negative and usage limits do not clamp the deduction, though spend limits still apply. (optional)
-     * @param async - If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information. (optional)
+     * @param async - Defaults to true: the event is queued and the response is a 202 with balance: null. Set to false to apply the usage before responding with a 200 and the updated balance. (optional)
      *
-     * @returns The usage value recorded, with either a single updated balance or a map of updated balances. If Autumn is experiencing degraded service from a downstream provider, the API may return 202 after accepting the event for replay so it can be tracked as soon as the service is restored.
+     * @returns The usage value recorded. By default the event is queued and the API returns 202 with balance: null. With async: false it returns 200 with either a single updated balance or a map of updated balances, or 202 if Autumn is experiencing degraded service and accepted the event for replay.
      */
     track(request: TrackParams, options?: RequestOptions): Promise<TrackResponse>;
     /**
@@ -95348,9 +95343,9 @@ declare class Autumn extends ClientSDK {
      * @param properties - Additional properties to attach to this usage event. (optional)
      * @param timestamp - Unix timestamp in milliseconds to use for the usage event. Defaults to the current time. (optional)
      * @param overageBehavior - How to handle usage that exceeds the available balance. "cap" (default) deducts only what fits, stopping at zero. "overflow" deducts the full value: the balance can go negative and usage limits do not clamp the deduction, though spend limits still apply. (optional)
-     * @param async - If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information. (optional)
+     * @param async - Defaults to true: the event is queued and the response is a 202 with balance: null. Set to false to apply the usage before responding with a 200 and the updated balance. (optional)
      *
-     * @returns The dollar value recorded and the updated AI credit system balance. If Autumn is experiencing degraded service from a downstream provider, the API may return 202 after accepting the token usage event for replay so it can be tracked as soon as the service is restored.
+     * @returns The dollar value recorded. By default the event is queued and the API returns 202 with balance: null. With async: false it returns 200 with the updated AI credit system balance, or 202 if Autumn is experiencing degraded service and accepted the event for replay.
      */
     trackTokens(request: TrackTokensParams, options?: RequestOptions): Promise<TrackTokensResponse>;
     /**

package/dist/sdk/index.js

@@ -82,10 +82,10 @@ function serverURLFromOptions(options) {
 }
 var SDK_METADATA = {
   language: "typescript",
-  openapiDocVersion: "2.4.0",
+  openapiDocVersion: "2.5.0",
   sdkVersion: "0.10.18",
   genVersion: "2.884.13",
-  userAgent: "speakeasy-sdk/typescript 0.10.18 2.884.13 2.4.0 @useautumn/sdk"
+  userAgent: "speakeasy-sdk/typescript 0.10.18 2.884.13 2.5.0 @useautumn/sdk"
 };
 
 // ../sdk/src/lib/files.ts
@@ -829,7 +829,7 @@ function dlv(obj, key, def, p, undef) {
 // ../sdk/src/lib/env.ts
 var envSchema = z35__namespace.object({
   AUTUMN_SECRET_KEY: z35__namespace.optional(z35__namespace.string()),
-  AUTUMN_X_API_VERSION: z35__namespace._default(z35__namespace.string(), "2.4.0"),
+  AUTUMN_X_API_VERSION: z35__namespace._default(z35__namespace.string(), "2.5.0"),
   AUTUMN_FAIL_OPEN: z35__namespace.pipe(
     z35__namespace._default(z35__namespace.enum(["true", "false"]), "true"),
     z35__namespace.transform((v) => v === "true")
@@ -5472,8 +5472,7 @@ var RequestBody$outboundSchema = z35__namespace.pipe(
     properties: z35__namespace.optional(z35__namespace.record(z35__namespace.string(), z35__namespace.any())),
     idempotencyKey: z35__namespace.optional(z35__namespace.string()),
     timestamp: z35__namespace.optional(z35__namespace.int()),
-    overageBehavior: z35__namespace.optional(BatchTrackOverageBehavior$outboundSchema),
-    async: z35__namespace.optional(z35__namespace.boolean())
+    overageBehavior: z35__namespace.optional(BatchTrackOverageBehavior$outboundSchema)
   }),
   z35__namespace.transform((v) => {
     return remap(v, {
@@ -91737,7 +91736,7 @@ var Autumn = class extends ClientSDK {
     ));
   }
   /**
-   * Records usage for a customer feature and returns updated balances.
+   * Records usage for a customer feature. Queued by default; pass async: false to apply it before responding with updated balances.
    *
    * Use this after an action happens to decrement usage, or send a negative value to credit balance back.
    *
@@ -91761,9 +91760,9 @@ var Autumn = class extends ClientSDK {
    * @param properties - Additional properties to attach to this usage event. (optional)
    * @param timestamp - Unix timestamp in milliseconds to use for the usage event. Defaults to the current time. (optional)
    * @param overageBehavior - How to handle usage that exceeds the available balance. "cap" (default) deducts only what fits, stopping at zero. "overflow" deducts the full value: the balance can go negative and usage limits do not clamp the deduction, though spend limits still apply. (optional)
-   * @param async - If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information. (optional)
+   * @param async - Defaults to true: the event is queued and the response is a 202 with balance: null. Set to false to apply the usage before responding with a 200 and the updated balance. (optional)
    *
-   * @returns The usage value recorded, with either a single updated balance or a map of updated balances. If Autumn is experiencing degraded service from a downstream provider, the API may return 202 after accepting the event for replay so it can be tracked as soon as the service is restored.
+   * @returns The usage value recorded. By default the event is queued and the API returns 202 with balance: null. With async: false it returns 200 with either a single updated balance or a map of updated balances, or 202 if Autumn is experiencing degraded service and accepted the event for replay.
    */
   async track(request, options) {
     return unwrapAsync(track(
@@ -91804,9 +91803,9 @@ var Autumn = class extends ClientSDK {
    * @param properties - Additional properties to attach to this usage event. (optional)
    * @param timestamp - Unix timestamp in milliseconds to use for the usage event. Defaults to the current time. (optional)
    * @param overageBehavior - How to handle usage that exceeds the available balance. "cap" (default) deducts only what fits, stopping at zero. "overflow" deducts the full value: the balance can go negative and usage limits do not clamp the deduction, though spend limits still apply. (optional)
-   * @param async - If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information. (optional)
+   * @param async - Defaults to true: the event is queued and the response is a 202 with balance: null. Set to false to apply the usage before responding with a 200 and the updated balance. (optional)
    *
-   * @returns The dollar value recorded and the updated AI credit system balance. If Autumn is experiencing degraded service from a downstream provider, the API may return 202 after accepting the token usage event for replay so it can be tracked as soon as the service is restored.
+   * @returns The dollar value recorded. By default the event is queued and the API returns 202 with balance: null. With async: false it returns 200 with the updated AI credit system balance, or 202 if Autumn is experiencing degraded service and accepted the event for replay.
    */
   async trackTokens(request, options) {
     return unwrapAsync(trackTokens(

package/dist/sdk/index.mjs

@@ -59,10 +59,10 @@ function serverURLFromOptions(options) {
 }
 var SDK_METADATA = {
   language: "typescript",
-  openapiDocVersion: "2.4.0",
+  openapiDocVersion: "2.5.0",
   sdkVersion: "0.10.18",
   genVersion: "2.884.13",
-  userAgent: "speakeasy-sdk/typescript 0.10.18 2.884.13 2.4.0 @useautumn/sdk"
+  userAgent: "speakeasy-sdk/typescript 0.10.18 2.884.13 2.5.0 @useautumn/sdk"
 };
 
 // ../sdk/src/lib/files.ts
@@ -806,7 +806,7 @@ function dlv(obj, key, def, p, undef) {
 // ../sdk/src/lib/env.ts
 var envSchema = z35.object({
   AUTUMN_SECRET_KEY: z35.optional(z35.string()),
-  AUTUMN_X_API_VERSION: z35._default(z35.string(), "2.4.0"),
+  AUTUMN_X_API_VERSION: z35._default(z35.string(), "2.5.0"),
   AUTUMN_FAIL_OPEN: z35.pipe(
     z35._default(z35.enum(["true", "false"]), "true"),
     z35.transform((v) => v === "true")
@@ -5449,8 +5449,7 @@ var RequestBody$outboundSchema = z35.pipe(
     properties: z35.optional(z35.record(z35.string(), z35.any())),
     idempotencyKey: z35.optional(z35.string()),
     timestamp: z35.optional(z35.int()),
-    overageBehavior: z35.optional(BatchTrackOverageBehavior$outboundSchema),
-    async: z35.optional(z35.boolean())
+    overageBehavior: z35.optional(BatchTrackOverageBehavior$outboundSchema)
   }),
   z35.transform((v) => {
     return remap(v, {
@@ -91714,7 +91713,7 @@ var Autumn = class extends ClientSDK {
     ));
   }
   /**
-   * Records usage for a customer feature and returns updated balances.
+   * Records usage for a customer feature. Queued by default; pass async: false to apply it before responding with updated balances.
    *
    * Use this after an action happens to decrement usage, or send a negative value to credit balance back.
    *
@@ -91738,9 +91737,9 @@ var Autumn = class extends ClientSDK {
    * @param properties - Additional properties to attach to this usage event. (optional)
    * @param timestamp - Unix timestamp in milliseconds to use for the usage event. Defaults to the current time. (optional)
    * @param overageBehavior - How to handle usage that exceeds the available balance. "cap" (default) deducts only what fits, stopping at zero. "overflow" deducts the full value: the balance can go negative and usage limits do not clamp the deduction, though spend limits still apply. (optional)
-   * @param async - If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information. (optional)
+   * @param async - Defaults to true: the event is queued and the response is a 202 with balance: null. Set to false to apply the usage before responding with a 200 and the updated balance. (optional)
    *
-   * @returns The usage value recorded, with either a single updated balance or a map of updated balances. If Autumn is experiencing degraded service from a downstream provider, the API may return 202 after accepting the event for replay so it can be tracked as soon as the service is restored.
+   * @returns The usage value recorded. By default the event is queued and the API returns 202 with balance: null. With async: false it returns 200 with either a single updated balance or a map of updated balances, or 202 if Autumn is experiencing degraded service and accepted the event for replay.
    */
   async track(request, options) {
     return unwrapAsync(track(
@@ -91781,9 +91780,9 @@ var Autumn = class extends ClientSDK {
    * @param properties - Additional properties to attach to this usage event. (optional)
    * @param timestamp - Unix timestamp in milliseconds to use for the usage event. Defaults to the current time. (optional)
    * @param overageBehavior - How to handle usage that exceeds the available balance. "cap" (default) deducts only what fits, stopping at zero. "overflow" deducts the full value: the balance can go negative and usage limits do not clamp the deduction, though spend limits still apply. (optional)
-   * @param async - If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information. (optional)
+   * @param async - Defaults to true: the event is queued and the response is a 202 with balance: null. Set to false to apply the usage before responding with a 200 and the updated balance. (optional)
    *
-   * @returns The dollar value recorded and the updated AI credit system balance. If Autumn is experiencing degraded service from a downstream provider, the API may return 202 after accepting the token usage event for replay so it can be tracked as soon as the service is restored.
+   * @returns The dollar value recorded. By default the event is queued and the API returns 202 with balance: null. With async: false it returns 200 with the updated AI credit system balance, or 202 if Autumn is experiencing degraded service and accepted the event for replay.
    */
   async trackTokens(request, options) {
     return unwrapAsync(trackTokens(

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "autumn-js",
   "description": "Autumn JS Library",
-  "version": "1.3.73",
+  "version": "1.4.0",
   "repository": "github:useautumn/autumn",
   "homepage": "https://docs.useautumn.com",
   "main": "./dist/sdk/index.js",
@@ -126,5 +126,5 @@
       "optional": true
     }
   },
-  "gitHead": "ec93f2978a086ff1cb74c764b4a77c0a679fc3fc"
+  "gitHead": "7980cc38c03162bdd630f83eaf617ecad926c565"
 }