@paygentic/sdk 0.7.19 → 0.7.20

package/src/funcs/ordersUpdateOrderLineItem.ts

@@ -0,0 +1,185 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { PaygenticCore } from "../core.js";
+import { encodeJSON, encodeSimple } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { PaygenticError } from "../models/errors/paygenticerror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Update a line item
+ */
+export function ordersUpdateOrderLineItem(
+  client: PaygenticCore,
+  request: operations.UpdateOrderLineItemRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.OrderLineItem,
+    | errors.BadRequest
+    | errors.ErrorT
+    | PaygenticError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: PaygenticCore,
+  request: operations.UpdateOrderLineItemRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.OrderLineItem,
+      | errors.BadRequest
+      | errors.ErrorT
+      | PaygenticError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.UpdateOrderLineItemRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload.UpdateOrderLineItemRequest, {
+    explode: true,
+  });
+
+  const pathParams = {
+    id: encodeSimple("id", payload.id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+    orderId: encodeSimple("orderId", payload.orderId, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/v0/orders/{orderId}/lineItems/{id}")(pathParams);
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.bearerAuth);
+  const securityInput = secConfig == null ? {} : { bearerAuth: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "updateOrderLineItem",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.bearerAuth,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "PATCH",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["400", "401", "403", "404", "4XX", "500", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    models.OrderLineItem,
+    | errors.BadRequest
+    | errors.ErrorT
+    | PaygenticError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, models.OrderLineItem$inboundSchema),
+    M.jsonErr(400, errors.BadRequest$inboundSchema),
+    M.jsonErr([401, 403, 404], errors.ErrorT$inboundSchema),
+    M.jsonErr(500, errors.ErrorT$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/lib/config.ts

@@ -65,7 +65,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.1.0",
-  sdkVersion: "0.7.19",
+  sdkVersion: "0.7.20",
   genVersion: "2.879.13",
-  userAgent: "speakeasy-sdk/typescript 0.7.19 2.879.13 0.1.0 @paygentic/sdk",
+  userAgent: "speakeasy-sdk/typescript 0.7.20 2.879.13 0.1.0 @paygentic/sdk",
 } as const;

package/src/models/approval.ts

@@ -0,0 +1,81 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { ClosedEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+
+export const ApprovalObject = {
+  Approval: "approval",
+} as const;
+export type ApprovalObject = ClosedEnum<typeof ApprovalObject>;
+
+export const ApprovalDecision = {
+  Pending: "pending",
+  Approved: "approved",
+  Rejected: "rejected",
+  Cancelled: "cancelled",
+} as const;
+export type ApprovalDecision = ClosedEnum<typeof ApprovalDecision>;
+
+export type Approval = {
+  id: string;
+  object: ApprovalObject;
+  merchantId: string;
+  resourceType: string;
+  resourceId: string;
+  kind: string;
+  decision: ApprovalDecision;
+  requester: string;
+  reviewer?: string | null | undefined;
+  note?: string | null | undefined;
+  dataSnapshotHash: string;
+  decidedAt?: Date | null | undefined;
+  createdAt: Date;
+};
+
+/** @internal */
+export const ApprovalObject$inboundSchema: z.ZodNativeEnum<
+  typeof ApprovalObject
+> = z.nativeEnum(ApprovalObject);
+
+/** @internal */
+export const ApprovalDecision$inboundSchema: z.ZodNativeEnum<
+  typeof ApprovalDecision
+> = z.nativeEnum(ApprovalDecision);
+
+/** @internal */
+export const Approval$inboundSchema: z.ZodType<
+  Approval,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  object: ApprovalObject$inboundSchema,
+  merchantId: z.string(),
+  resourceType: z.string(),
+  resourceId: z.string(),
+  kind: z.string(),
+  decision: ApprovalDecision$inboundSchema,
+  requester: z.string(),
+  reviewer: z.nullable(z.string()).optional(),
+  note: z.nullable(z.string()).optional(),
+  dataSnapshotHash: z.string(),
+  decidedAt: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ).optional(),
+  createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+});
+
+export function approvalFromJSON(
+  jsonString: string,
+): SafeParseResult<Approval, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Approval$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Approval' from JSON`,
+  );
+}

package/src/models/approvallist.ts

@@ -0,0 +1,57 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { ClosedEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import {
+  OffsetPagination,
+  OffsetPagination$inboundSchema,
+} from "./offsetpagination.js";
+import {
+  SchemasApproval,
+  SchemasApproval$inboundSchema,
+} from "./schemasapproval.js";
+
+export const ApprovalListObject = {
+  List: "list",
+} as const;
+export type ApprovalListObject = ClosedEnum<typeof ApprovalListObject>;
+
+export type ApprovalList = {
+  object: ApprovalListObject;
+  data: Array<SchemasApproval>;
+  /**
+   * Offset-based pagination response.
+   */
+  pagination: OffsetPagination;
+};
+
+/** @internal */
+export const ApprovalListObject$inboundSchema: z.ZodNativeEnum<
+  typeof ApprovalListObject
+> = z.nativeEnum(ApprovalListObject);
+
+/** @internal */
+export const ApprovalList$inboundSchema: z.ZodType<
+  ApprovalList,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  object: ApprovalListObject$inboundSchema,
+  data: z.array(SchemasApproval$inboundSchema),
+  pagination: OffsetPagination$inboundSchema,
+});
+
+export function approvalListFromJSON(
+  jsonString: string,
+): SafeParseResult<ApprovalList, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ApprovalList$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ApprovalList' from JSON`,
+  );
+}

package/src/models/billingschedule.ts

@@ -0,0 +1,134 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { ClosedEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+
+export const BillingScheduleObject = {
+  BillingSchedule: "billing_schedule",
+} as const;
+export type BillingScheduleObject = ClosedEnum<typeof BillingScheduleObject>;
+
+export const BillingScheduleStatus = {
+  Draft: "draft",
+  Active: "active",
+  Completed: "completed",
+  Cancelled: "cancelled",
+} as const;
+export type BillingScheduleStatus = ClosedEnum<typeof BillingScheduleStatus>;
+
+export const BillingScheduleAlignmentPolicy = {
+  Anchor: "anchor",
+  Calendar: "calendar",
+  Coterm: "coterm",
+} as const;
+export type BillingScheduleAlignmentPolicy = ClosedEnum<
+  typeof BillingScheduleAlignmentPolicy
+>;
+
+export const BillingScheduleProrationPolicy = {
+  None: "none",
+  Daily: "daily",
+} as const;
+export type BillingScheduleProrationPolicy = ClosedEnum<
+  typeof BillingScheduleProrationPolicy
+>;
+
+export const BillingSchedulePeriodPreset = {
+  Single: "single",
+  P1M: "P1M",
+  P3M: "P3M",
+  P6M: "P6M",
+  P1Y: "P1Y",
+  Custom: "custom",
+} as const;
+export type BillingSchedulePeriodPreset = ClosedEnum<
+  typeof BillingSchedulePeriodPreset
+>;
+
+/**
+ * Summary of a billing schedule owned by this order. The full schedule (with intervals + staged invoices) is served under /billingSchedules. Owner-polymorphic: a schedule belongs to exactly one Order or one Subscription (XOR); cadence lives on ScheduleIntervals, not the header.
+ */
+export type BillingSchedule = {
+  id: string;
+  object: BillingScheduleObject;
+  orderId?: string | null | undefined;
+  subscriptionId?: string | null | undefined;
+  merchantId: string;
+  status: BillingScheduleStatus;
+  startDate: Date;
+  endDate: Date;
+  billingAnchor: Date;
+  alignmentPolicy: BillingScheduleAlignmentPolicy;
+  prorationPolicy: BillingScheduleProrationPolicy;
+  paymentTermDays?: number | null | undefined;
+  periodPreset: BillingSchedulePeriodPreset;
+  metadata: { [k: string]: any };
+  createdAt: Date;
+  updatedAt: Date;
+};
+
+/** @internal */
+export const BillingScheduleObject$inboundSchema: z.ZodNativeEnum<
+  typeof BillingScheduleObject
+> = z.nativeEnum(BillingScheduleObject);
+
+/** @internal */
+export const BillingScheduleStatus$inboundSchema: z.ZodNativeEnum<
+  typeof BillingScheduleStatus
+> = z.nativeEnum(BillingScheduleStatus);
+
+/** @internal */
+export const BillingScheduleAlignmentPolicy$inboundSchema: z.ZodNativeEnum<
+  typeof BillingScheduleAlignmentPolicy
+> = z.nativeEnum(BillingScheduleAlignmentPolicy);
+
+/** @internal */
+export const BillingScheduleProrationPolicy$inboundSchema: z.ZodNativeEnum<
+  typeof BillingScheduleProrationPolicy
+> = z.nativeEnum(BillingScheduleProrationPolicy);
+
+/** @internal */
+export const BillingSchedulePeriodPreset$inboundSchema: z.ZodNativeEnum<
+  typeof BillingSchedulePeriodPreset
+> = z.nativeEnum(BillingSchedulePeriodPreset);
+
+/** @internal */
+export const BillingSchedule$inboundSchema: z.ZodType<
+  BillingSchedule,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  object: BillingScheduleObject$inboundSchema,
+  orderId: z.nullable(z.string()).optional(),
+  subscriptionId: z.nullable(z.string()).optional(),
+  merchantId: z.string(),
+  status: BillingScheduleStatus$inboundSchema,
+  startDate: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  endDate: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  billingAnchor: z.string().datetime({ offset: true }).transform(v =>
+    new Date(v)
+  ),
+  alignmentPolicy: BillingScheduleAlignmentPolicy$inboundSchema,
+  prorationPolicy: BillingScheduleProrationPolicy$inboundSchema,
+  paymentTermDays: z.nullable(z.number().int()).optional(),
+  periodPreset: BillingSchedulePeriodPreset$inboundSchema,
+  metadata: z.record(z.any()),
+  createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+});
+
+export function billingScheduleFromJSON(
+  jsonString: string,
+): SafeParseResult<BillingSchedule, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => BillingSchedule$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'BillingSchedule' from JSON`,
+  );
+}

package/src/models/createapprovalrequest.ts

@@ -0,0 +1,95 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../types/enums.js";
+
+export const CreateApprovalRequestResourceType = {
+  Order: "order",
+  Invoice: "invoice",
+} as const;
+export type CreateApprovalRequestResourceType = ClosedEnum<
+  typeof CreateApprovalRequestResourceType
+>;
+
+/**
+ * Defaults to data_review.
+ */
+export const CreateApprovalRequestKind = {
+  DataReview: "data_review",
+  FinancialReview: "financial_review",
+  Push: "push",
+} as const;
+/**
+ * Defaults to data_review.
+ */
+export type CreateApprovalRequestKind = ClosedEnum<
+  typeof CreateApprovalRequestKind
+>;
+
+export type CreateApprovalRequest = {
+  /**
+   * The merchant that owns the resource being approved.
+   */
+  merchantId: string;
+  resourceType: CreateApprovalRequestResourceType;
+  resourceId: string;
+  /**
+   * A precomputed hash of the resource state being approved. The resource-owning domain builds this snapshot; approvals stays decoupled from any specific resource shape.
+   */
+  dataSnapshotHash: string;
+  /**
+   * Defaults to data_review.
+   */
+  kind?: CreateApprovalRequestKind | undefined;
+  note?: string | null | undefined;
+  /**
+   * Optional. The real user id to record as the requester. Used when the request is made via a platform-level key on behalf of a human user (e.g. from the platform Next.js frontend). When supplied and the authenticated principal is 'platform', this value overrides the derived principal as the requester. Ignored when the caller is a non-platform API key.
+   */
+  actorId?: string | undefined;
+};
+
+/** @internal */
+export const CreateApprovalRequestResourceType$outboundSchema: z.ZodNativeEnum<
+  typeof CreateApprovalRequestResourceType
+> = z.nativeEnum(CreateApprovalRequestResourceType);
+
+/** @internal */
+export const CreateApprovalRequestKind$outboundSchema: z.ZodNativeEnum<
+  typeof CreateApprovalRequestKind
+> = z.nativeEnum(CreateApprovalRequestKind);
+
+/** @internal */
+export type CreateApprovalRequest$Outbound = {
+  merchantId: string;
+  resourceType: string;
+  resourceId: string;
+  dataSnapshotHash: string;
+  kind?: string | undefined;
+  note?: string | null | undefined;
+  actorId?: string | undefined;
+};
+
+/** @internal */
+export const CreateApprovalRequest$outboundSchema: z.ZodType<
+  CreateApprovalRequest$Outbound,
+  z.ZodTypeDef,
+  CreateApprovalRequest
+> = z.object({
+  merchantId: z.string(),
+  resourceType: CreateApprovalRequestResourceType$outboundSchema,
+  resourceId: z.string(),
+  dataSnapshotHash: z.string(),
+  kind: CreateApprovalRequestKind$outboundSchema.optional(),
+  note: z.nullable(z.string()).optional(),
+  actorId: z.string().optional(),
+});
+
+export function createApprovalRequestToJSON(
+  createApprovalRequest: CreateApprovalRequest,
+): string {
+  return JSON.stringify(
+    CreateApprovalRequest$outboundSchema.parse(createApprovalRequest),
+  );
+}

package/src/models/createbillingschedulerequest.ts

@@ -0,0 +1,111 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../types/enums.js";
+
+export const CreateBillingScheduleRequestAlignmentPolicy = {
+  Anchor: "anchor",
+  Calendar: "calendar",
+  Coterm: "coterm",
+} as const;
+export type CreateBillingScheduleRequestAlignmentPolicy = ClosedEnum<
+  typeof CreateBillingScheduleRequestAlignmentPolicy
+>;
+
+export const CreateBillingScheduleRequestProrationPolicy = {
+  None: "none",
+  Daily: "daily",
+} as const;
+export type CreateBillingScheduleRequestProrationPolicy = ClosedEnum<
+  typeof CreateBillingScheduleRequestProrationPolicy
+>;
+
+export const CreateBillingScheduleRequestPeriodPreset = {
+  Single: "single",
+  P1M: "P1M",
+  P3M: "P3M",
+  P6M: "P6M",
+  P1Y: "P1Y",
+  Custom: "custom",
+} as const;
+export type CreateBillingScheduleRequestPeriodPreset = ClosedEnum<
+  typeof CreateBillingScheduleRequestPeriodPreset
+>;
+
+export type CreateBillingScheduleRequest = {
+  orderId?: string | undefined;
+  subscriptionId?: string | undefined;
+  startDate: Date;
+  endDate: Date;
+  billingAnchor: Date;
+  alignmentPolicy?: CreateBillingScheduleRequestAlignmentPolicy | undefined;
+  prorationPolicy?: CreateBillingScheduleRequestProrationPolicy | undefined;
+  paymentTermDays?: number | null | undefined;
+  periodPreset?: CreateBillingScheduleRequestPeriodPreset | undefined;
+  customPeriodWindows?: Array<any> | undefined;
+  metadata?: { [k: string]: any } | undefined;
+};
+
+/** @internal */
+export const CreateBillingScheduleRequestAlignmentPolicy$outboundSchema:
+  z.ZodNativeEnum<typeof CreateBillingScheduleRequestAlignmentPolicy> = z
+    .nativeEnum(CreateBillingScheduleRequestAlignmentPolicy);
+
+/** @internal */
+export const CreateBillingScheduleRequestProrationPolicy$outboundSchema:
+  z.ZodNativeEnum<typeof CreateBillingScheduleRequestProrationPolicy> = z
+    .nativeEnum(CreateBillingScheduleRequestProrationPolicy);
+
+/** @internal */
+export const CreateBillingScheduleRequestPeriodPreset$outboundSchema:
+  z.ZodNativeEnum<typeof CreateBillingScheduleRequestPeriodPreset> = z
+    .nativeEnum(CreateBillingScheduleRequestPeriodPreset);
+
+/** @internal */
+export type CreateBillingScheduleRequest$Outbound = {
+  orderId?: string | undefined;
+  subscriptionId?: string | undefined;
+  startDate: string;
+  endDate: string;
+  billingAnchor: string;
+  alignmentPolicy?: string | undefined;
+  prorationPolicy?: string | undefined;
+  paymentTermDays?: number | null | undefined;
+  periodPreset?: string | undefined;
+  customPeriodWindows?: Array<any> | undefined;
+  metadata?: { [k: string]: any } | undefined;
+};
+
+/** @internal */
+export const CreateBillingScheduleRequest$outboundSchema: z.ZodType<
+  CreateBillingScheduleRequest$Outbound,
+  z.ZodTypeDef,
+  CreateBillingScheduleRequest
+> = z.object({
+  orderId: z.string().optional(),
+  subscriptionId: z.string().optional(),
+  startDate: z.date().transform(v => v.toISOString()),
+  endDate: z.date().transform(v => v.toISOString()),
+  billingAnchor: z.date().transform(v => v.toISOString()),
+  alignmentPolicy: CreateBillingScheduleRequestAlignmentPolicy$outboundSchema
+    .optional(),
+  prorationPolicy: CreateBillingScheduleRequestProrationPolicy$outboundSchema
+    .optional(),
+  paymentTermDays: z.nullable(z.number().int()).optional(),
+  periodPreset: CreateBillingScheduleRequestPeriodPreset$outboundSchema
+    .optional(),
+  customPeriodWindows: z.array(z.any()).optional(),
+  metadata: z.record(z.any()).optional(),
+});
+
+export function createBillingScheduleRequestToJSON(
+  createBillingScheduleRequest: CreateBillingScheduleRequest,
+): string {
+  return JSON.stringify(
+    CreateBillingScheduleRequest$outboundSchema.parse(
+      createBillingScheduleRequest,
+    ),
+  );
+}

package/src/models/creategrantrequest.ts

@@ -29,6 +29,10 @@ export type CreateGrantRequest = {
    * Minimum balance at the entitlement's reset boundary; balances below this are floored up. Defaults to 0 (no floor). Ignored when the target entitlement has no `usagePeriod` (one-time entitlement).
    */
   resetMinRollover?: number | undefined;
+  /**
+   * Burn-down priority. Grants with a lower priority are consumed before grants with a higher priority; ties break on earliest expiration, then creation order. Negative values are allowed and can be used to make a grant burn ahead of existing priority-0 grants (e.g. a correction grant absorbing erroneous usage before a recurring allowance). Defaults to 0.
+   */
+  priority?: number | undefined;
 };
 
 /** @internal */
@@ -39,6 +43,7 @@ export type CreateGrantRequest$Outbound = {
   idempotencyKey: string;
   resetMaxRollover?: number | undefined;
   resetMinRollover?: number | undefined;
+  priority?: number | undefined;
 };
 
 /** @internal */
@@ -53,6 +58,7 @@ export const CreateGrantRequest$outboundSchema: z.ZodType<
   idempotencyKey: z.string(),
   resetMaxRollover: z.number().optional(),
   resetMinRollover: z.number().optional(),
+  priority: z.number().int().optional(),
 });
 
 export function createGrantRequestToJSON(