@flexprice/sdk 2.1.20 → 2.1.24

package/src/funcs/webhook-events-post-webhook-events-wallet-ongoing-balance-updated.ts

@@ -0,0 +1,144 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { FlexpriceCore } from "../core.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import { FlexPriceError } from "../sdk/models/flex-price-error.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../sdk/models/http-client-errors.js";
+import * as models from "../sdk/models/index.js";
+import { ResponseValidationError } from "../sdk/models/response-validation-error.js";
+import { SDKValidationError } from "../sdk/models/sdk-validation-error.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * wallet.ongoing_balance.updated
+ *
+ * @remarks
+ * Fired when a wallet's ongoing (real-time) balance changes. Doc-only for parsing.
+ */
+export function webhookEventsPostWebhookEventsWalletOngoingBalanceUpdated(
+  client: FlexpriceCore,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.WebhookDtoWalletWebhookPayload,
+    | FlexPriceError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    options,
+  ));
+}
+
+async function $do(
+  client: FlexpriceCore,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.WebhookDtoWalletWebhookPayload,
+      | FlexPriceError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const path = pathToFunc("/webhook-events/wallet.ongoing_balance.updated")();
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKeyAuth);
+  const securityInput = secConfig == null ? {} : { apiKeyAuth: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "post_/webhook-events/wallet.ongoing_balance.updated",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKeyAuth,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    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,
+    isErrorStatusCode: (statusCode: number) =>
+      matchStatusCode({ status: statusCode } as Response, ["4XX", "5XX"]),
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const [result] = await M.match<
+    models.WebhookDtoWalletWebhookPayload,
+    | FlexPriceError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, models.WebhookDtoWalletWebhookPayload$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req);
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/webhook-events-post-webhook-events-wallet-transaction-updated.ts

@@ -0,0 +1,147 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { FlexpriceCore } from "../core.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import { FlexPriceError } from "../sdk/models/flex-price-error.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../sdk/models/http-client-errors.js";
+import * as models from "../sdk/models/index.js";
+import { ResponseValidationError } from "../sdk/models/response-validation-error.js";
+import { SDKValidationError } from "../sdk/models/sdk-validation-error.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * wallet.transaction.updated
+ *
+ * @remarks
+ * Fired when an existing wallet transaction is updated (e.g. pending to completed). Doc-only for parsing.
+ */
+export function webhookEventsPostWebhookEventsWalletTransactionUpdated(
+  client: FlexpriceCore,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.WebhookDtoTransactionUpdatedWebhookPayload,
+    | FlexPriceError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    options,
+  ));
+}
+
+async function $do(
+  client: FlexpriceCore,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.WebhookDtoTransactionUpdatedWebhookPayload,
+      | FlexPriceError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const path = pathToFunc("/webhook-events/wallet.transaction.updated")();
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKeyAuth);
+  const securityInput = secConfig == null ? {} : { apiKeyAuth: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "post_/webhook-events/wallet.transaction.updated",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKeyAuth,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    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,
+    isErrorStatusCode: (statusCode: number) =>
+      matchStatusCode({ status: statusCode } as Response, ["4XX", "5XX"]),
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const [result] = await M.match<
+    models.WebhookDtoTransactionUpdatedWebhookPayload,
+    | FlexPriceError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(
+      200,
+      models.WebhookDtoTransactionUpdatedWebhookPayload$inboundSchema,
+    ),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req);
+  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: "1.0",
-  sdkVersion: "2.1.20",
-  genVersion: "2.911.0",
-  userAgent: "speakeasy-sdk/typescript 2.1.20 2.911.0 1.0 @flexprice/sdk",
+  sdkVersion: "2.1.24",
+  genVersion: "2.931.0",
+  userAgent: "speakeasy-sdk/typescript 2.1.24 2.931.0 1.0 @flexprice/sdk",
 } as const;

package/src/lib/http.ts

@@ -45,8 +45,10 @@ export class HTTPClient {
   private requestHooks: BeforeRequestHook[] = [];
   private requestErrorHooks: RequestErrorHook[] = [];
   private responseHooks: ResponseHook[] = [];
+  private options: HTTPClientOptions;
 
-  constructor(private options: HTTPClientOptions = {}) {
+  constructor(options: HTTPClientOptions = {}) {
+    this.options = options;
     this.fetcher = options.fetcher || DEFAULT_FETCHER;
   }
 

package/src/lib/security.ts

@@ -12,17 +12,22 @@ type OAuth2PasswordFlow = {
   tokenURL: string;
 };
 
-export enum SecurityErrorCode {
-  Incomplete = "incomplete",
-  UnrecognisedSecurityType = "unrecognized_security_type",
-}
+export const SecurityErrorCode = {
+  Incomplete: "incomplete",
+  UnrecognisedSecurityType: "unrecognized_security_type",
+} as const;
+export type SecurityErrorCode =
+  (typeof SecurityErrorCode)[keyof typeof SecurityErrorCode];
 
 export class SecurityError extends Error {
+  public code: SecurityErrorCode;
+
   constructor(
-    public code: SecurityErrorCode,
+    code: SecurityErrorCode,
     message: string,
   ) {
     super(message);
+    this.code = code;
     this.name = "SecurityError";
   }
 

package/src/sdk/alert-settings.ts

@@ -0,0 +1,101 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { alertSettingsCreateAlertSettings } from "../funcs/alert-settings-create-alert-settings.js";
+import { alertSettingsDeleteAlertSettings } from "../funcs/alert-settings-delete-alert-settings.js";
+import { alertSettingsGetAlertSettings } from "../funcs/alert-settings-get-alert-settings.js";
+import { alertSettingsQueryAlertSettings } from "../funcs/alert-settings-query-alert-settings.js";
+import { alertSettingsUpdateAlertSettings } from "../funcs/alert-settings-update-alert-settings.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import { unwrapAsync } from "../types/fp.js";
+import * as models from "./models/index.js";
+
+export class AlertSettings extends ClientSDK {
+  /**
+   * Create alert settings
+   *
+   * @remarks
+   * Configure a subscription, line item, or group spend alert.
+   */
+  async createAlertSettings(
+    request: models.CreateAlertSettingsRequest,
+    options?: RequestOptions,
+  ): Promise<models.AlertSettingsResponse> {
+    return unwrapAsync(alertSettingsCreateAlertSettings(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Query alert settings
+   *
+   * @remarks
+   * List or search alert settings. Returns a paginated list.
+   */
+  async queryAlertSettings(
+    request: models.AlertSettingsFilter,
+    options?: RequestOptions,
+  ): Promise<models.ListAlertSettingsResponse> {
+    return unwrapAsync(alertSettingsQueryAlertSettings(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get alert settings
+   *
+   * @remarks
+   * Fetch a single alert setting by id.
+   */
+  async getAlertSettings(
+    id: string,
+    options?: RequestOptions,
+  ): Promise<models.AlertSettingsResponse> {
+    return unwrapAsync(alertSettingsGetAlertSettings(
+      this,
+      id,
+      options,
+    ));
+  }
+
+  /**
+   * Update alert settings
+   *
+   * @remarks
+   * Patch an alert setting's config; omitted fields keep their stored value.
+   */
+  async updateAlertSettings(
+    id: string,
+    body: models.UpdateAlertSettingsRequest,
+    options?: RequestOptions,
+  ): Promise<models.AlertSettingsResponse> {
+    return unwrapAsync(alertSettingsUpdateAlertSettings(
+      this,
+      id,
+      body,
+      options,
+    ));
+  }
+
+  /**
+   * Delete alert settings
+   *
+   * @remarks
+   * Soft delete an alert setting.
+   */
+  async deleteAlertSettings(
+    id: string,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(alertSettingsDeleteAlertSettings(
+      this,
+      id,
+      options,
+    ));
+  }
+}

package/src/sdk/checkout.ts

@@ -0,0 +1,54 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { checkoutCreateCheckoutSession } from "../funcs/checkout-create-checkout-session.js";
+import { checkoutDeleteCheckoutSession } from "../funcs/checkout-delete-checkout-session.js";
+import { checkoutGetCheckoutSession } from "../funcs/checkout-get-checkout-session.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import { unwrapAsync } from "../types/fp.js";
+import * as models from "./models/index.js";
+
+export class Checkout extends ClientSDK {
+  /**
+   * Create checkout session
+   */
+  async createCheckoutSession(
+    request: models.CreateCheckoutSessionRequest,
+    options?: RequestOptions,
+  ): Promise<models.CheckoutSessionResponse> {
+    return unwrapAsync(checkoutCreateCheckoutSession(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get checkout session
+   */
+  async getCheckoutSession(
+    id: string,
+    options?: RequestOptions,
+  ): Promise<models.CheckoutSessionResponse> {
+    return unwrapAsync(checkoutGetCheckoutSession(
+      this,
+      id,
+      options,
+    ));
+  }
+
+  /**
+   * Delete checkout session
+   */
+  async deleteCheckoutSession(
+    id: string,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(checkoutDeleteCheckoutSession(
+      this,
+      id,
+      options,
+    ));
+  }
+}

package/src/sdk/credit-grants.ts

@@ -4,6 +4,7 @@
 
 import { creditGrantsCreateCreditGrant } from "../funcs/credit-grants-create-credit-grant.js";
 import { creditGrantsDeleteCreditGrant } from "../funcs/credit-grants-delete-credit-grant.js";
+import { creditGrantsGetAddonCreditGrants } from "../funcs/credit-grants-get-addon-credit-grants.js";
 import { creditGrantsGetCreditGrant } from "../funcs/credit-grants-get-credit-grant.js";
 import { creditGrantsGetPlanCreditGrants } from "../funcs/credit-grants-get-plan-credit-grants.js";
 import { creditGrantsUpdateCreditGrant } from "../funcs/credit-grants-update-credit-grant.js";
@@ -12,6 +13,23 @@ import { unwrapAsync } from "../types/fp.js";
 import * as models from "./models/index.js";
 
 export class CreditGrants extends ClientSDK {
+  /**
+   * Get addon credit grants
+   *
+   * @remarks
+   * Use when listing credits attached to an addon (e.g. included prepaid or promo credits).
+   */
+  async getAddonCreditGrants(
+    id: string,
+    options?: RequestOptions,
+  ): Promise<models.ListCreditGrantsResponse> {
+    return unwrapAsync(creditGrantsGetAddonCreditGrants(
+      this,
+      id,
+      options,
+    ));
+  }
+
   /**
    * Create credit grant
    *

package/src/sdk/customers.ts

@@ -5,10 +5,12 @@
 import { customersCreateCustomer } from "../funcs/customers-create-customer.js";
 import { customersDeleteCustomer } from "../funcs/customers-delete-customer.js";
 import { customersGetCustomerByExternalId } from "../funcs/customers-get-customer-by-external-id.js";
+import { customersGetCustomerEntitlementsByExternalID } from "../funcs/customers-get-customer-entitlements-by-external-id.js";
 import { customersGetCustomerEntitlements } from "../funcs/customers-get-customer-entitlements.js";
 import { customersGetCustomerUpcomingGrants } from "../funcs/customers-get-customer-upcoming-grants.js";
 import { customersGetCustomerUsageSummary } from "../funcs/customers-get-customer-usage-summary.js";
 import { customersGetCustomer } from "../funcs/customers-get-customer.js";
+import { customersGetSubscriptionsForCustomer } from "../funcs/customers-get-subscriptions-for-customer.js";
 import { customersQueryCustomer } from "../funcs/customers-query-customer.js";
 import { customersUpdateCustomer } from "../funcs/customers-update-customer.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
@@ -71,6 +73,42 @@ export class Customers extends ClientSDK {
     ));
   }
 
+  /**
+   * Get customer entitlements by external ID
+   *
+   * @remarks
+   * Use when checking entitlements by your app's customer id (e.g. feature gating at the edge). Supports optional filters (feature_ids, subscription_ids).
+   */
+  async getCustomerEntitlementsByExternalID(
+    externalId: string,
+    options?: RequestOptions,
+  ): Promise<models.CustomerEntitlementsResponse> {
+    return unwrapAsync(customersGetCustomerEntitlementsByExternalID(
+      this,
+      externalId,
+      options,
+    ));
+  }
+
+  /**
+   * Get subscriptions for customer by external ID
+   *
+   * @remarks
+   * Returns all subscriptions for a customer looked up by external_id, with line-item meters and entitlements attached (no pagination).
+   */
+  async getSubscriptionsForCustomer(
+    externalId: string,
+    expand?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<models.ListSubscriptionsResponse> {
+    return unwrapAsync(customersGetSubscriptionsForCustomer(
+      this,
+      externalId,
+      expand,
+      options,
+    ));
+  }
+
   /**
    * Query customers
    *

package/src/sdk/events.ts

@@ -70,13 +70,32 @@ export class Events extends ClientSDK {
    * Get Hugging Face inference data
    *
    * @remarks
-   * Use when fetching Hugging Face inference usage or billing data (e.g. for HF-specific reporting or reconciliation).
+   * Use when fetching Hugging Face inference usage or billing data (e.g. for HF-specific reporting or reconciliation). Reads the meter-usage pipeline.
    */
   async getHuggingfaceInferenceData(
+    request: models.GetHuggingFaceBillingDataRequest,
     options?: RequestOptions,
   ): Promise<models.GetHuggingFaceBillingDataResponse> {
     return unwrapAsync(eventsGetHuggingfaceInferenceData(
       this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get event
+   *
+   * @remarks
+   * Use when debugging a specific event (e.g. why it failed or how it was aggregated). Reads the meter-usage pipeline; includes processing status and step-by-step debug tracker when unprocessed. Uses ?id= query param because event IDs can contain "/".
+   */
+  async getEvent(
+    id: string,
+    options?: RequestOptions,
+  ): Promise<models.GetEventByIDResponse> {
+    return unwrapAsync(eventsGetEvent(
+      this,
+      id,
       options,
     ));
   }
@@ -131,21 +150,4 @@ export class Events extends ClientSDK {
       options,
     ));
   }
-
-  /**
-   * Get event
-   *
-   * @remarks
-   * Use when debugging a specific event (e.g. why it failed or how it was aggregated). Includes processing status and debug info.
-   */
-  async getEvent(
-    id: string,
-    options?: RequestOptions,
-  ): Promise<models.GetEventByIDResponse> {
-    return unwrapAsync(eventsGetEvent(
-      this,
-      id,
-      options,
-    ));
-  }
 }

package/src/sdk/invoices.ts

@@ -99,6 +99,7 @@ export class Invoices extends ClientSDK {
     id: string,
     expandBySource?: boolean | undefined,
     groupBy?: Array<string> | undefined,
+    expand?: string | undefined,
     options?: RequestOptions,
   ): Promise<models.InvoiceResponse> {
     return unwrapAsync(invoicesGetInvoice(
@@ -106,6 +107,7 @@ export class Invoices extends ClientSDK {
       id,
       expandBySource,
       groupBy,
+      expand,
       options,
     ));
   }
@@ -114,7 +116,7 @@ export class Invoices extends ClientSDK {
    * Update invoice
    *
    * @remarks
-   * Use when updating invoice metadata or due date (e.g. PDF URL, net terms). For paid invoices only safe fields can be updated.
+   * Use when updating invoice metadata or due date (e.g. PDF URL, net terms), or when recalculating this draft invoice's discount from its current standing coupon associations via apply_discount:true (idempotent, does not attach a new coupon). Allowed for invoices in draft or finalized status.
    */
   async updateInvoice(
     id: string,

package/src/sdk/marketplace.ts

@@ -0,0 +1,27 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { marketplacePostMarketplaceAgreements } from "../funcs/marketplace-post-marketplace-agreements.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import { unwrapAsync } from "../types/fp.js";
+import * as models from "./models/index.js";
+
+export class Marketplace extends ClientSDK {
+  /**
+   * Register an AWS Marketplace agreement
+   *
+   * @remarks
+   * Registers an AWS Marketplace buyer agreement against an existing Flexprice subscription, upserting plan/subscription/customer integration mappings in one call.
+   */
+  async postMarketplaceAgreements(
+    request: models.RegisterMarketplaceAgreementRequest,
+    options?: RequestOptions,
+  ): Promise<models.RegisterMarketplaceAgreementResponse> {
+    return unwrapAsync(marketplacePostMarketplaceAgreements(
+      this,
+      request,
+      options,
+    ));
+  }
+}