@stigg/typescript 0.1.0-beta.61 → 0.1.0-beta.63

package/resources/v2/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/resources/v2/usage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/resources/v2/usage.ts"],"names":[],"mappings":"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"}

package/src/resources/v1/addons/addons.ts

@@ -1968,7 +1968,7 @@ export namespace AddonUpdateParams {
       featureId?: string;
 
       /**
-       * Maximum number of units (max 999999)
+       * Maximum number of units
        */
       maxUnitQuantity?: number;
 

package/src/resources/v1/credits/credits.ts

@@ -33,6 +33,8 @@ import {
   GrantVoidParams,
   Grants,
 } from './grants';
+import * as ReservationsAPI from './reservations';
+import { ReservationReleaseParams, ReservationReleaseResponse, Reservations } from './reservations';
 import { APIPromise } from '../../../core/api-promise';
 import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from '../../../core/pagination';
 import { buildHeaders } from '../../../internal/headers';
@@ -44,6 +46,7 @@ export class Credits extends APIResource {
     this._client,
   );
   consumption: ConsumptionAPI.Consumption = new ConsumptionAPI.Consumption(this._client);
+  reservations: ReservationsAPI.Reservations = new ReservationsAPI.Reservations(this._client);
 
   /**
    * Retrieves the automatic recharge configuration for a customer and currency.
@@ -347,10 +350,17 @@ export namespace CreditGetUsageResponse {
  */
 export interface CreditListLedgerResponse {
   /**
-   * The credit amount for this event
+   * The amount of the ledger event. Reservation events carry their net effect on the
+   * balance: a reserve is negative, and so is a release that consumed more than was
+   * held
    */
   amount: number;
 
+  /**
+   * On a released reservation, the credits consumed from each grant
+   */
+  breakdown: Array<CreditListLedgerResponse.Breakdown> | null;
+
   /**
    * The credit currency ID
    */
@@ -381,13 +391,32 @@ export interface CreditListLedgerResponse {
     | 'CREDITS_VOIDED'
     | 'CREDITS_UPDATED'
     | 'CREDITS_CONSUMPTION_TRANSFER_SOURCE'
-    | 'CREDITS_CONSUMPTION_TRANSFER_TARGET';
+    | 'CREDITS_CONSUMPTION_TRANSFER_TARGET'
+    | 'CREDITS_RESERVED'
+    | 'CREDITS_RESERVATION_RELEASED'
+    | 'CREDITS_RESERVATION_EXPIRED';
 
   /**
    * The feature ID associated with this event
    */
   featureId: string | null;
 
+  /**
+   * On a released reservation, the held amount returned to the balance before
+   * consumed credits are deducted
+   */
+  holdReturnedAmount: number | null;
+
+  /**
+   * The metadata sent with the credit reservation
+   */
+  metadata: { [key: string]: string } | null;
+
+  /**
+   * The credit reservation this event belongs to
+   */
+  reservationId: string | null;
+
   /**
    * The resource ID this event is scoped to
    */
@@ -399,6 +428,72 @@ export interface CreditListLedgerResponse {
   timestamp: string;
 }
 
+export namespace CreditListLedgerResponse {
+  export interface Breakdown {
+    /**
+     * The amount of the ledger event. Reservation events carry their net effect on the
+     * balance: a reserve is negative, and so is a release that consumed more than was
+     * held
+     */
+    amount: number;
+
+    /**
+     * The credit currency ID
+     */
+    creditCurrencyId: string;
+
+    /**
+     * The credit grant ID associated with this event
+     */
+    creditGrantId: string;
+
+    /**
+     * The customer ID this event belongs to
+     */
+    customerId: string;
+
+    /**
+     * The unique event identifier
+     */
+    eventId: string | null;
+
+    /**
+     * The type of credit event
+     */
+    eventType:
+      | 'CREDITS_GRANTED'
+      | 'CREDITS_EXPIRED'
+      | 'CREDITS_CONSUMED'
+      | 'CREDITS_VOIDED'
+      | 'CREDITS_UPDATED'
+      | 'CREDITS_CONSUMPTION_TRANSFER_SOURCE'
+      | 'CREDITS_CONSUMPTION_TRANSFER_TARGET'
+      | 'CREDITS_RESERVED'
+      | 'CREDITS_RESERVATION_RELEASED'
+      | 'CREDITS_RESERVATION_EXPIRED';
+
+    /**
+     * The feature ID associated with this event
+     */
+    featureId: string | null;
+
+    /**
+     * The credit reservation this event belongs to
+     */
+    reservationId: string | null;
+
+    /**
+     * The resource ID this event is scoped to
+     */
+    resourceId: string | null;
+
+    /**
+     * The timestamp when the event occurred
+     */
+    timestamp: string;
+  }
+}
+
 export interface CreditGetAutoRechargeParams {
   /**
    * Query param: Filter by currency ID (required)
@@ -511,6 +606,11 @@ export interface CreditListLedgerParams extends MyCursorIDPageParams {
    */
   eventType?: string;
 
+  /**
+   * Query param: Filter by credit reservation ID
+   */
+  reservationId?: string;
+
   /**
    * Query param: Filter by resource ID
    */
@@ -533,6 +633,7 @@ export interface CreditListLedgerParams extends MyCursorIDPageParams {
 Credits.Grants = Grants;
 Credits.CustomCurrencies = CustomCurrencies;
 Credits.Consumption = Consumption;
+Credits.Reservations = Reservations;
 
 export declare namespace Credits {
   export {
@@ -576,4 +677,10 @@ export declare namespace Credits {
     type ConsumptionConsumeParams as ConsumptionConsumeParams,
     type ConsumptionConsumeAsyncParams as ConsumptionConsumeAsyncParams,
   };
+
+  export {
+    Reservations as Reservations,
+    type ReservationReleaseResponse as ReservationReleaseResponse,
+    type ReservationReleaseParams as ReservationReleaseParams,
+  };
 }

package/src/resources/v1/credits/index.ts

@@ -39,3 +39,4 @@ export {
   type GrantVoidParams,
   type GrantListResponsesMyCursorIDPage,
 } from './grants';
+export { Reservations, type ReservationReleaseResponse, type ReservationReleaseParams } from './reservations';

package/src/resources/v1/credits/reservations.ts

@@ -0,0 +1,172 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Reservations extends APIResource {
+  /**
+   * Releases a credit reservation, consuming the given amount and returning the rest
+   * of the held credits to the balance. Retry a failed release with the same
+   * reservation ID; it is applied once.
+   */
+  release(
+    reservationID: string,
+    params: ReservationReleaseParams,
+    options?: RequestOptions,
+  ): APIPromise<ReservationReleaseResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
+    return this._client.post(path`/api/v1/credits/reservations/${reservationID}/release`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+/**
+ * Response object
+ */
+export interface ReservationReleaseResponse {
+  /**
+   * Result of releasing a credit reservation
+   */
+  data: ReservationReleaseResponse.Data;
+}
+
+export namespace ReservationReleaseResponse {
+  /**
+   * Result of releasing a credit reservation
+   */
+  export interface Data {
+    /**
+     * The optimistic credit balance after the release
+     */
+    credit: Data.Credit | null;
+
+    /**
+     * The released reservation
+     */
+    reservation: Data.Reservation;
+  }
+
+  export namespace Data {
+    /**
+     * The optimistic credit balance after the release
+     */
+    export interface Credit {
+      /**
+       * The credit currency identifier
+       */
+      currencyId: string;
+
+      /**
+       * The wallet's total consumed credits for this currency (optimistic — includes
+       * not-yet-reconciled usage), shared across every feature that draws on the
+       * currency. This is the running balance, not this call's deduction — see
+       * `consumed` for that.
+       */
+      currentUsage: number;
+
+      /**
+       * The grant-version timestamp of this balance, used by the SDK for last-write-wins
+       * reconciliation
+       */
+      timestamp: string;
+
+      /**
+       * The total credits granted
+       */
+      usageLimit: number;
+
+      /**
+       * End of the current credit grant period (when recurring credits reset), if
+       * applicable
+       */
+      usagePeriodEnd?: string | null;
+    }
+
+    /**
+     * The released reservation
+     */
+    export interface Reservation {
+      /**
+       * The client-provided reservation ID.
+       */
+      id: string;
+
+      /**
+       * The amount of credits held.
+       */
+      amount: number;
+
+      /**
+       * The amount consumed at release
+       */
+      consumedAmount: number | null;
+
+      /**
+       * When the reservation expires. Unreleased credits return to the balance at this
+       * time.
+       */
+      expiresAt: string;
+
+      /**
+       * The status of the reservation.
+       */
+      status: 'ACTIVE' | 'RELEASED' | 'EXPIRED';
+    }
+  }
+}
+
+export interface ReservationReleaseParams {
+  /**
+   * Body param: The amount of credits to consume at release. Up to the reserved
+   * amount is charged to the credits that backed the reservation; the rest returns
+   * to the balance, and any amount above the reservation is consumed normally.
+   */
+  consumedAmount: number;
+
+  /**
+   * Body param: The credit currency of the reservation
+   */
+  currencyId: string;
+
+  /**
+   * Body param: The customer the reservation was made for
+   */
+  customerId: string;
+
+  /**
+   * Body param: The resource the reservation was made for, if any
+   */
+  resourceId?: string;
+
+  /**
+   * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+   * token); falls back to the user's first membership. Ignored for API-key auth.
+   */
+  'X-ACCOUNT-ID'?: string;
+
+  /**
+   * Header param: Environment ID — required when authenticating with a user JWT
+   * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+   * intrinsic to the key).
+   */
+  'X-ENVIRONMENT-ID'?: string;
+}
+
+export declare namespace Reservations {
+  export {
+    type ReservationReleaseResponse as ReservationReleaseResponse,
+    type ReservationReleaseParams as ReservationReleaseParams,
+  };
+}

package/src/resources/v1/customers/customers.ts

@@ -1873,7 +1873,7 @@ export namespace CustomerCheckEntitlementResponse {
       /**
        * The status of the reservation.
        */
-      status: 'ACTIVE' | 'RELEASED';
+      status: 'ACTIVE' | 'RELEASED' | 'EXPIRED';
     }
   }
 }
@@ -2625,7 +2625,7 @@ export namespace CustomerRetrieveEntitlementsResponse {
         /**
          * The status of the reservation.
          */
-        status: 'ACTIVE' | 'RELEASED';
+        status: 'ACTIVE' | 'RELEASED' | 'EXPIRED';
       }
     }
   }
@@ -3294,6 +3294,36 @@ export interface CustomerCheckEntitlementParams {
    */
   requestedValues?: Array<string>;
 
+  /**
+   * Query param: When the reservation expires (ISO 8601, at most 24 hours ahead).
+   * Mutually exclusive with `reservationTtlSeconds`.
+   */
+  reservationExpiresAt?: string;
+
+  /**
+   * Query param: Client-provided reservation ID, required with `reserveAmount`.
+   * Retry with the same ID to get the same result; reuse with different parameters
+   * is a conflict.
+   */
+  reservationId?: string;
+
+  /**
+   * Query param: JSON-encoded object of string values to attach to the reservation.
+   */
+  reservationMetadata?: string;
+
+  /**
+   * Query param: How long the reservation holds the credits, in seconds (1–86400,
+   * default 3600). Mutually exclusive with `reservationExpiresAt`.
+   */
+  reservationTtlSeconds?: number;
+
+  /**
+   * Query param: Credits to reserve (credit entitlements only). The check is decided
+   * and the credits held atomically; `requestedUsage` is ignored.
+   */
+  reserveAmount?: number;
+
   /**
    * Query param: Resource ID to scope the entitlement check to a specific resource
    */

package/src/resources/v1/events/beta/customers.ts

@@ -137,18 +137,31 @@ export namespace CustomerRetrieveGovernanceResponse {
      * exist
      */
     next: string | null;
+
+    /**
+     * Cursor for fetching the previous page of results, or null if at the beginning
+     */
+    prev: string | null;
   }
 }
 
 export interface CustomerRetrieveGovernanceParams {
   /**
-   * Query param: Return items that come after this cursor
+   * Query param: Opaque cursor from a page’s `next`; returns the page after it.
+   * Mutually exclusive with `before`.
    */
   after?: string;
 
   /**
-   * Query param: Currency ids to include, repeated per value (e.g.
-   * `?currencyIds=credits`). Omit both featureIds and currencyIds for tree mode.
+   * Query param: Opaque cursor from a page’s `prev`; returns the page before it.
+   * Mutually exclusive with `after`.
+   */
+  before?: string;
+
+  /**
+   * Query param: Currency ids to include, comma-separated (e.g.
+   * `?currencyIds=credits`), up to 100. Omit both featureIds and currencyIds for
+   * tree mode.
    */
   currencyIds?: Array<string>;
 
@@ -159,14 +172,14 @@ export interface CustomerRetrieveGovernanceParams {
   entityIdSearch?: string;
 
   /**
-   * Query param: Filter to one or more entity types, repeated per value (e.g.
-   * `?entityTypeIds=team&entityTypeIds=user`).
+   * Query param: Filter to one or more entity types, comma-separated (e.g.
+   * `?entityTypeIds=team,user`), up to 100.
    */
   entityTypeIds?: Array<string>;
 
   /**
-   * Query param: Feature ids to include, repeated per value (e.g.
-   * `?featureIds=ai-tokens&featureIds=seats`). Omit both featureIds and currencyIds
+   * Query param: Feature ids to include, comma-separated (e.g.
+   * `?featureIds=ai-tokens,seats`), up to 100. Omit both featureIds and currencyIds
    * for tree mode — every node in the hierarchy with no usage configuration
    * attached.
    */

package/src/resources/v1/plans/plans.ts

@@ -2692,7 +2692,7 @@ export namespace PlanUpdateParams {
       featureId?: string;
 
       /**
-       * Maximum number of units (max 999999)
+       * Maximum number of units
        */
       maxUnitQuantity?: number;
 

package/src/resources/v1/subscriptions/subscriptions.ts

@@ -3029,7 +3029,7 @@ export namespace SubscriptionProvisionResponse {
         /**
          * The status of the reservation.
          */
-        status: 'ACTIVE' | 'RELEASED';
+        status: 'ACTIVE' | 'RELEASED' | 'EXPIRED';
       }
     }
 

package/src/resources/v1/usage.ts

@@ -391,10 +391,10 @@ export interface UsageEstimateParams {
   featureId: string;
 
   /**
-   * Body param: The value to report for usage. Must be a whole number — the REST API
-   * does not accept fractional (float) usage values; scale up (e.g. report cents
-   * instead of dollars, or milliseconds instead of seconds) if you need sub-unit
-   * precision.
+   * Body param: The value to report for usage. Fractional values are accepted and
+   * rounded half away from zero to 5 decimal places. A value with a fractional part
+   * must have an absolute value below 34,359,738,368 (2^35); whole numbers are
+   * accepted up to ±9,007,199,254,740,991.
    */
   value: number;
 
@@ -511,9 +511,10 @@ export namespace UsageReportParams {
     featureId: string;
 
     /**
-     * The value to report for usage. Must be a whole number — the REST API does not
-     * accept fractional (float) usage values; scale up (e.g. report cents instead of
-     * dollars, or milliseconds instead of seconds) if you need sub-unit precision.
+     * The value to report for usage. Fractional values are accepted and rounded half
+     * away from zero to 5 decimal places. A value with a fractional part must have an
+     * absolute value below 34,359,738,368 (2^35); whole numbers are accepted up to
+     * ±9,007,199,254,740,991.
      */
     value: number;
 

package/src/resources/v1-beta/customers/assignments.ts

@@ -312,7 +312,8 @@ export namespace AssignmentUpsertParams {
     /**
      * Parent entity ID in the hierarchy. Omit to leave the current parent untouched (a
      * new node defaults to a root); `null` detaches to a root; an ID sets or changes
-     * the parent. Reparenting an existing node is leaf-only.
+     * the parent. Reparenting or detaching an existing node is leaf-only; place a
+     * parent before its children, or in the same batch.
      */
     parentId?: string | null;
 

package/src/resources/v1-beta/customers/customers.ts

@@ -27,16 +27,25 @@ import {
 } from './entities';
 import * as EntitlementsAPI from './entitlements';
 import { EntitlementCheckParams, EntitlementCheckResponse, Entitlements } from './entitlements';
+import * as GovernanceAPI from './governance';
+import {
+  Governance,
+  GovernanceListParams,
+  GovernanceListResponse,
+  GovernanceListResponsesMyCursorIDPage,
+} from './governance';
 
 export class Customers extends APIResource {
   entitlements: EntitlementsAPI.Entitlements = new EntitlementsAPI.Entitlements(this._client);
   entities: EntitiesAPI.Entities = new EntitiesAPI.Entities(this._client);
   assignments: AssignmentsAPI.Assignments = new AssignmentsAPI.Assignments(this._client);
+  governance: GovernanceAPI.Governance = new GovernanceAPI.Governance(this._client);
 }
 
 Customers.Entitlements = Entitlements;
 Customers.Entities = Entities;
 Customers.Assignments = Assignments;
+Customers.Governance = Governance;
 
 export declare namespace Customers {
   export {
@@ -68,4 +77,11 @@ export declare namespace Customers {
     type AssignmentListParams as AssignmentListParams,
     type AssignmentUpsertParams as AssignmentUpsertParams,
   };
+
+  export {
+    Governance as Governance,
+    type GovernanceListResponse as GovernanceListResponse,
+    type GovernanceListResponsesMyCursorIDPage as GovernanceListResponsesMyCursorIDPage,
+    type GovernanceListParams as GovernanceListParams,
+  };
 }

package/src/resources/v1-beta/customers/entitlements.ts

@@ -349,7 +349,7 @@ export namespace EntitlementCheckResponse {
       /**
        * The status of the reservation.
        */
-      status: 'ACTIVE' | 'RELEASED';
+      status: 'ACTIVE' | 'RELEASED' | 'EXPIRED';
     }
   }
 }