@flexprice/sdk 2.1.11 → 2.1.18

package/src/lib/sdks.ts

@@ -23,6 +23,7 @@ import {
   matchContentType,
 } from "./http.js";
 import { Logger } from "./logger.js";
+import { combineSignals } from "./primitives.js";
 import { retry, RetryConfig } from "./retries.js";
 import { SecurityState } from "./security.js";
 
@@ -127,27 +128,55 @@ export class ClientSDK {
     if (path) {
       baseURL.pathname = baseURL.pathname.replace(/\/+$/, "") + "/";
       reqURL = new URL(path, baseURL);
+      if (!reqURL.search && baseURL.search) {
+        reqURL.search = baseURL.search;
+      }
     } else {
       reqURL = baseURL;
     }
     reqURL.hash = "";
 
-    let finalQuery = query || "";
-
-    const secQuery: string[] = [];
-    for (const [k, v] of Object.entries(security?.queryParams || {})) {
-      const q = encodeForm(k, v, { charEncoding: "percent" });
-      if (typeof q !== "undefined") {
-        secQuery.push(q);
+    // Appends already-encoded query pairs to a query string, replacing any
+    // existing pairs with the same key so later sources take precedence.
+    const mergeQuery = (current: string, additions: string): string => {
+      if (!additions) {
+        return current;
       }
-    }
-    if (secQuery.length) {
-      finalQuery += `&${secQuery.join("&")}`;
-    }
+      const additionKeys = new Set(
+        additions
+          .split("&")
+          .filter((pair) => pair !== "")
+          .map((pair) => pair.split("=")[0] ?? ""),
+      );
+      const kept = current.split("&").filter((pair) => {
+        return pair !== "" && !additionKeys.has(pair.split("=")[0] ?? "");
+      });
+      return [...kept, additions].join("&");
+    };
+
+    const encodeQueryRecord = (record: Record<string, unknown>): string => {
+      return Object.entries(record)
+        .map(([k, v]) => {
+          if (v == null) {
+            return undefined;
+          }
+          const value = v;
+          return encodeForm(k, value, {
+            explode: Array.isArray(value),
+            charEncoding: "percent",
+          });
+        })
+        .filter((pair): pair is string => typeof pair !== "undefined")
+        .join("&");
+    };
+
+    const finalQuery = [
+      query || "",
+      encodeQueryRecord(security?.queryParams || {}),
+    ].reduce(mergeQuery, reqURL.search.slice(1));
 
     if (finalQuery) {
-      const q = finalQuery.startsWith("&") ? finalQuery.slice(1) : finalQuery;
-      reqURL.search = `?${q}`;
+      reqURL.search = `?${finalQuery}`;
     }
 
     const headers = new Headers(opHeaders);
@@ -193,9 +222,8 @@ export class ClientSDK {
       ...options?.fetchOptions,
       ...options,
     };
-    if (!fetchOptions?.signal && conf.timeoutMs && conf.timeoutMs > 0) {
-      const timeoutSignal = AbortSignal.timeout(conf.timeoutMs);
-      fetchOptions.signal = timeoutSignal;
+    if (!fetchOptions?.signal && conf.timeoutMs != null && conf.timeoutMs > 0) {
+      context.timeoutMs = conf.timeoutMs;
     }
 
     if (conf.body instanceof ReadableStream) {
@@ -242,10 +270,19 @@ export class ClientSDK {
     >
   > {
     const { context, isErrorStatusCode } = options;
+    const timeoutMs = context.timeoutMs;
 
     return retry(
       async () => {
-        const req = await this.#hooks.beforeRequest(context, request.clone());
+        const cloned = request.clone();
+        let attempt = cloned;
+        if (timeoutMs != null && timeoutMs > 0) {
+          const timeoutSignal = AbortSignal.timeout(timeoutMs);
+          const combined = combineSignals(cloned.signal, timeoutSignal)
+            ?? timeoutSignal;
+          attempt = new Request(cloned, { signal: combined });
+        }
+        const req = await this.#hooks.beforeRequest(context, attempt);
         await logRequest(this.#logger, req).catch((e) =>
           this.#logger?.log("Failed to log request:", e)
         );

package/src/sdk/coupon-associations.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { couponAssociationsGetCouponAssociation } from "../funcs/coupon-associations-get-coupon-association.js";
+import { couponAssociationsListCouponAssociations } from "../funcs/coupon-associations-list-coupon-associations.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import { unwrapAsync } from "../types/fp.js";
+import * as models from "./models/index.js";
+
+export class CouponAssociations extends ClientSDK {
+  /**
+   * List coupon associations
+   *
+   * @remarks
+   * List coupon associations with optional filters. Coupon associations are created and removed via the subscription modify API.
+   */
+  async listCouponAssociations(
+    request?: models.ListCouponAssociationsRequest | undefined,
+    options?: RequestOptions,
+  ): Promise<models.ListCouponAssociationsResponse> {
+    return unwrapAsync(couponAssociationsListCouponAssociations(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get coupon association
+   *
+   * @remarks
+   * Get a single coupon association by ID. Coupon associations are created and removed via the subscription modify API.
+   */
+  async getCouponAssociation(
+    id: string,
+    options?: RequestOptions,
+  ): Promise<models.CouponAssociationResponse> {
+    return unwrapAsync(couponAssociationsGetCouponAssociation(
+      this,
+      id,
+      options,
+    ));
+  }
+}

package/src/sdk/integrations.ts

@@ -2,12 +2,30 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import { integrationsDelinkIntegrationMapping } from "../funcs/integrations-delink-integration-mapping.js";
+import { integrationsGetEntityIntegrationMappings } from "../funcs/integrations-get-entity-integration-mappings.js";
+import { integrationsGetIntegrationConfig } from "../funcs/integrations-get-integration-config.js";
 import { integrationsLinkIntegrationMapping } from "../funcs/integrations-link-integration-mapping.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import { unwrapAsync } from "../types/fp.js";
 import * as models from "./models/index.js";
 
 export class Integrations extends ClientSDK {
+  /**
+   * Get integration configurations
+   *
+   * @remarks
+   * Returns the base capabilities and current sync configuration for all connected providers.
+   */
+  async getIntegrationConfig(
+    options?: RequestOptions,
+  ): Promise<models.IntegrationConfigResponse> {
+    return unwrapAsync(integrationsGetIntegrationConfig(
+      this,
+      options,
+    ));
+  }
+
   /**
    * Link integration mapping
    *
@@ -24,4 +42,40 @@ export class Integrations extends ClientSDK {
       options,
     ));
   }
+
+  /**
+   * Delink integration mapping
+   *
+   * @remarks
+   * Soft-delete (archive) the mapping between a FlexPrice entity and a provider entity.
+   */
+  async delinkIntegrationMapping(
+    request: models.DelinkIntegrationMappingRequest,
+    options?: RequestOptions,
+  ): Promise<models.SuccessResponse> {
+    return unwrapAsync(integrationsDelinkIntegrationMapping(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get entity integration mappings
+   *
+   * @remarks
+   * Get integration mappings for a specific entity by entity type and entity ID.
+   */
+  async getEntityIntegrationMappings(
+    entityType: string,
+    entityId: string,
+    options?: RequestOptions,
+  ): Promise<models.ListEntityIntegrationMappingsResponse> {
+    return unwrapAsync(integrationsGetEntityIntegrationMappings(
+      this,
+      entityType,
+      entityId,
+      options,
+    ));
+  }
 }

package/src/sdk/models/attributed-to-customer-result.ts

@@ -0,0 +1,55 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import {
+  DebugTrackerStatus,
+  DebugTrackerStatus$inboundSchema,
+} from "./debug-tracker-status.js";
+import {
+  ErrorResponse,
+  ErrorResponse$inboundSchema,
+} from "./error-response.js";
+import {
+  MeterUsageAttribution,
+  MeterUsageAttribution$inboundSchema,
+} from "./meter-usage-attribution.js";
+import { SDKValidationError } from "./sdk-validation-error.js";
+
+export type AttributedToCustomerResult = {
+  error?: ErrorResponse | undefined;
+  meterUsage?: MeterUsageAttribution | undefined;
+  status?: DebugTrackerStatus | undefined;
+};
+
+/** @internal */
+export const AttributedToCustomerResult$inboundSchema: z.ZodMiniType<
+  AttributedToCustomerResult,
+  unknown
+> = z.pipe(
+  z.object({
+    error: types.optional(ErrorResponse$inboundSchema),
+    meter_usage: types.optional(MeterUsageAttribution$inboundSchema),
+    status: types.optional(DebugTrackerStatus$inboundSchema),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "meter_usage": "meterUsage",
+    });
+  }),
+);
+
+export function attributedToCustomerResultFromJSON(
+  jsonString: string,
+): SafeParseResult<AttributedToCustomerResult, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AttributedToCustomerResult$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AttributedToCustomerResult' from JSON`,
+  );
+}

package/src/sdk/models/bucket-summary.ts

@@ -0,0 +1,80 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { Bucket, Bucket$inboundSchema } from "./bucket.js";
+import { SDKValidationError } from "./sdk-validation-error.js";
+
+export type BucketSummary = {
+  baseCharge?: string | undefined;
+  bucketId?: string | undefined;
+  commitmentType?: string | undefined;
+  commitmentValue?: string | undefined;
+  computedOverage?: string | undefined;
+  computedTrueUp?: string | undefined;
+  computedUtilized?: string | undefined;
+  end?: Bucket | undefined;
+  /**
+   * PriceID is the bucket's own price (the line item's price for the
+   *
+   * @remarks
+   * out-of-bucket row).
+   */
+  priceId?: string | undefined;
+  start?: Bucket | undefined;
+  /**
+   * SubscriptionLineItemID is the line item this bucket is configured on.
+   */
+  subscriptionLineItemId?: string | undefined;
+  totalUsage?: string | undefined;
+};
+
+/** @internal */
+export const BucketSummary$inboundSchema: z.ZodMiniType<
+  BucketSummary,
+  unknown
+> = z.pipe(
+  z.object({
+    base_charge: types.optional(types.string()),
+    bucket_id: types.optional(types.string()),
+    commitment_type: types.optional(types.string()),
+    commitment_value: types.optional(types.string()),
+    computed_overage: types.optional(types.string()),
+    computed_true_up: types.optional(types.string()),
+    computed_utilized: types.optional(types.string()),
+    end: types.optional(Bucket$inboundSchema),
+    price_id: types.optional(types.string()),
+    start: types.optional(Bucket$inboundSchema),
+    subscription_line_item_id: types.optional(types.string()),
+    total_usage: types.optional(types.string()),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "base_charge": "baseCharge",
+      "bucket_id": "bucketId",
+      "commitment_type": "commitmentType",
+      "commitment_value": "commitmentValue",
+      "computed_overage": "computedOverage",
+      "computed_true_up": "computedTrueUp",
+      "computed_utilized": "computedUtilized",
+      "price_id": "priceId",
+      "subscription_line_item_id": "subscriptionLineItemId",
+      "total_usage": "totalUsage",
+    });
+  }),
+);
+
+export function bucketSummaryFromJSON(
+  jsonString: string,
+): SafeParseResult<BucketSummary, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => BucketSummary$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'BucketSummary' from JSON`,
+  );
+}

package/src/sdk/models/bucket.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "./sdk-validation-error.js";
+
+export type Bucket = {
+  hour?: number | undefined;
+  minute?: number | undefined;
+};
+
+/** @internal */
+export const Bucket$inboundSchema: z.ZodMiniType<Bucket, unknown> = z.object({
+  hour: types.optional(types.number()),
+  minute: types.optional(types.number()),
+});
+/** @internal */
+export type Bucket$Outbound = {
+  hour?: number | undefined;
+  minute?: number | undefined;
+};
+
+/** @internal */
+export const Bucket$outboundSchema: z.ZodMiniType<Bucket$Outbound, Bucket> = z
+  .object({
+    hour: z.optional(z.int()),
+    minute: z.optional(z.int()),
+  });
+
+export function bucketToJSON(bucket: Bucket): string {
+  return JSON.stringify(Bucket$outboundSchema.parse(bucket));
+}
+export function bucketFromJSON(
+  jsonString: string,
+): SafeParseResult<Bucket, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Bucket$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Bucket' from JSON`,
+  );
+}

package/src/sdk/models/cancel-subscription-request.ts

@@ -18,6 +18,14 @@ import {
 } from "./proration-behavior.js";
 
 export type CancelSubscriptionRequest = {
+  /**
+   * CancelAt is the exact date/time when the subscription should be cancelled.
+   *
+   * @remarks
+   * Required for cancellation_type "scheduled_date"; optional for "immediate" (past dates only — backdated cancellation).
+   * For "scheduled_date", accepts both future dates (deferred cancellation) and past dates (backdated cancellation).
+   * For "immediate", accepts past/current dates only; use "scheduled_date" for future dates.
+   */
   cancelAt?: Date | undefined;
   cancelImmediatelyInovicePolicy?: CancelImmediatelyInvoicePolicy | undefined;
   cancellationType: CancellationType;

package/src/sdk/models/changed-subscription.ts

@@ -3,6 +3,7 @@
  */
 
 import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
 import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import * as types from "../../types/primitives.js";
@@ -21,19 +22,31 @@ export type ChangedSubscription = {
    * created | updated
    */
   action?: ChangedSubscriptionAction | undefined;
+  currentPeriodEnd?: Date | undefined;
   id?: string | undefined;
   status?: SubscriptionStatus | undefined;
+  trialEnd?: Date | undefined;
 };
 
 /** @internal */
 export const ChangedSubscription$inboundSchema: z.ZodMiniType<
   ChangedSubscription,
   unknown
-> = z.object({
-  action: types.optional(ChangedSubscriptionAction$inboundSchema),
-  id: types.optional(types.string()),
-  status: types.optional(SubscriptionStatus$inboundSchema),
-});
+> = z.pipe(
+  z.object({
+    action: types.optional(ChangedSubscriptionAction$inboundSchema),
+    current_period_end: types.optional(types.date()),
+    id: types.optional(types.string()),
+    status: types.optional(SubscriptionStatus$inboundSchema),
+    trial_end: types.optional(types.date()),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "current_period_end": "currentPeriodEnd",
+      "trial_end": "trialEnd",
+    });
+  }),
+);
 
 export function changedSubscriptionFromJSON(
   jsonString: string,

package/src/sdk/models/commitment-bucket-request.ts

@@ -0,0 +1,72 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { Bucket, Bucket$Outbound, Bucket$outboundSchema } from "./bucket.js";
+import {
+  CommitmentType,
+  CommitmentType$outboundSchema,
+} from "./commitment-type.js";
+import {
+  CreatePriceRequest,
+  CreatePriceRequest$Outbound,
+  CreatePriceRequest$outboundSchema,
+} from "./create-price-request.js";
+
+export type CommitmentBucketRequest = {
+  commitmentType?: CommitmentType | undefined;
+  commitmentValue?: string | undefined;
+  end?: Bucket | undefined;
+  id?: string | undefined;
+  overageFactor?: string | undefined;
+  price?: CreatePriceRequest | undefined;
+  start?: Bucket | undefined;
+  trueUpEnabled?: boolean | undefined;
+};
+
+/** @internal */
+export type CommitmentBucketRequest$Outbound = {
+  commitment_type?: string | undefined;
+  commitment_value?: string | undefined;
+  end?: Bucket$Outbound | undefined;
+  id?: string | undefined;
+  overage_factor?: string | undefined;
+  price?: CreatePriceRequest$Outbound | undefined;
+  start?: Bucket$Outbound | undefined;
+  true_up_enabled?: boolean | undefined;
+};
+
+/** @internal */
+export const CommitmentBucketRequest$outboundSchema: z.ZodMiniType<
+  CommitmentBucketRequest$Outbound,
+  CommitmentBucketRequest
+> = z.pipe(
+  z.object({
+    commitmentType: z.optional(CommitmentType$outboundSchema),
+    commitmentValue: z.optional(z.string()),
+    end: z.optional(Bucket$outboundSchema),
+    id: z.optional(z.string()),
+    overageFactor: z.optional(z.string()),
+    price: z.optional(CreatePriceRequest$outboundSchema),
+    start: z.optional(Bucket$outboundSchema),
+    trueUpEnabled: z.optional(z.boolean()),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      commitmentType: "commitment_type",
+      commitmentValue: "commitment_value",
+      overageFactor: "overage_factor",
+      trueUpEnabled: "true_up_enabled",
+    });
+  }),
+);
+
+export function commitmentBucketRequestToJSON(
+  commitmentBucketRequest: CommitmentBucketRequest,
+): string {
+  return JSON.stringify(
+    CommitmentBucketRequest$outboundSchema.parse(commitmentBucketRequest),
+  );
+}

package/src/sdk/models/coupon-response.ts

@@ -18,6 +18,7 @@ import { Status, Status$inboundSchema } from "./status.js";
 export type CouponResponse = {
   amountOff?: string | undefined;
   cadence?: CouponCadence | undefined;
+  couponCode?: string | undefined;
   createdAt?: Date | undefined;
   createdBy?: string | undefined;
   currency?: string | undefined;
@@ -47,6 +48,7 @@ export const CouponResponse$inboundSchema: z.ZodMiniType<
   z.object({
     amount_off: types.optional(types.string()),
     cadence: types.optional(CouponCadence$inboundSchema),
+    coupon_code: types.optional(types.string()),
     created_at: types.optional(types.date()),
     created_by: types.optional(types.string()),
     currency: types.optional(types.string()),
@@ -70,6 +72,7 @@ export const CouponResponse$inboundSchema: z.ZodMiniType<
   z.transform((v) => {
     return remap$(v, {
       "amount_off": "amountOff",
+      "coupon_code": "couponCode",
       "created_at": "createdAt",
       "created_by": "createdBy",
       "duration_in_periods": "durationInPeriods",

package/src/sdk/models/coupon.ts

@@ -18,6 +18,7 @@ import { Status, Status$inboundSchema } from "./status.js";
 export type Coupon = {
   amountOff?: string | undefined;
   cadence?: CouponCadence | undefined;
+  couponCode?: string | undefined;
   createdAt?: Date | undefined;
   createdBy?: string | undefined;
   currency?: string | undefined;
@@ -44,6 +45,7 @@ export const Coupon$inboundSchema: z.ZodMiniType<Coupon, unknown> = z.pipe(
   z.object({
     amount_off: types.optional(types.string()),
     cadence: types.optional(CouponCadence$inboundSchema),
+    coupon_code: types.optional(types.string()),
     created_at: types.optional(types.date()),
     created_by: types.optional(types.string()),
     currency: types.optional(types.string()),
@@ -67,6 +69,7 @@ export const Coupon$inboundSchema: z.ZodMiniType<Coupon, unknown> = z.pipe(
   z.transform((v) => {
     return remap$(v, {
       "amount_off": "amountOff",
+      "coupon_code": "couponCode",
       "created_at": "createdAt",
       "created_by": "createdBy",
       "duration_in_periods": "durationInPeriods",

package/src/sdk/models/create-coupon-request.ts

@@ -13,6 +13,7 @@ import { CouponType, CouponType$outboundSchema } from "./coupon-type.js";
 export type CreateCouponRequest = {
   amountOff?: string | undefined;
   cadence: CouponCadence;
+  couponCode?: string | undefined;
   currency?: string | undefined;
   durationInPeriods?: number | undefined;
   maxRedemptions?: number | undefined;
@@ -29,6 +30,7 @@ export type CreateCouponRequest = {
 export type CreateCouponRequest$Outbound = {
   amount_off?: string | undefined;
   cadence: string;
+  coupon_code?: string | undefined;
   currency?: string | undefined;
   duration_in_periods?: number | undefined;
   max_redemptions?: number | undefined;
@@ -49,6 +51,7 @@ export const CreateCouponRequest$outboundSchema: z.ZodMiniType<
   z.object({
     amountOff: z.optional(z.string()),
     cadence: CouponCadence$outboundSchema,
+    couponCode: z.optional(z.string()),
     currency: z.optional(z.string()),
     durationInPeriods: z.optional(z.int()),
     maxRedemptions: z.optional(z.int()),
@@ -63,6 +66,7 @@ export const CreateCouponRequest$outboundSchema: z.ZodMiniType<
   z.transform((v) => {
     return remap$(v, {
       amountOff: "amount_off",
+      couponCode: "coupon_code",
       durationInPeriods: "duration_in_periods",
       maxRedemptions: "max_redemptions",
       percentageOff: "percentage_off",