@flexprice/sdk 2.1.1 → 2.1.3

package/src/funcs/meter-usage-query-meter-usage.ts

@@ -0,0 +1,170 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { FlexpriceCore } from "../core.js";
+import { encodeJSON } 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 { 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";
+
+/**
+ * Query meter usage
+ *
+ * @remarks
+ * Query aggregated usage from meter_usage table for a single meter with optional time-window bucketing
+ */
+export function meterUsageQueryMeterUsage(
+  client: FlexpriceCore,
+  request: models.MeterUsageQueryRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.MeterUsageQueryResponse,
+    | models.ErrorsErrorResponse
+    | FlexPriceError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: FlexpriceCore,
+  request: models.MeterUsageQueryRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.MeterUsageQueryResponse,
+      | models.ErrorsErrorResponse
+      | FlexPriceError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => z.parse(models.MeterUsageQueryRequest$outboundSchema, value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload, { explode: true });
+
+  const path = pathToFunc("/meter-usage/query")();
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    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: "queryMeterUsage",
+    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,
+    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", "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.MeterUsageQueryResponse,
+    | models.ErrorsErrorResponse
+    | FlexPriceError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, models.MeterUsageQueryResponse$inboundSchema),
+    M.jsonErr(400, models.ErrorsErrorResponse$inboundSchema),
+    M.jsonErr(500, models.ErrorsErrorResponse$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/funcs/{plans-post-plans-id-clone.ts → plans-clone-plan.ts}

@@ -31,7 +31,7 @@ import { Result } from "../types/fp.js";
  * @remarks
  * Clone an existing plan, copying its active prices, published entitlements, and published credit grants
  */
-export function plansPostPlansIdClone(
+export function plansClonePlan(
   client: FlexpriceCore,
   id: string,
   body: models.ClonePlanRequest,
@@ -80,14 +80,14 @@ async function $do(
     APICall,
   ]
 > {
-  const input: models.PostPlansIdCloneRequest = {
+  const input: models.ClonePlanRequestRequest = {
     id: id,
     body: body,
   };
 
   const parsed = safeParse(
     input,
-    (value) => z.parse(models.PostPlansIdCloneRequest$outboundSchema, value),
+    (value) => z.parse(models.ClonePlanRequestRequest$outboundSchema, value),
     "Input validation failed",
   );
   if (!parsed.ok) {
@@ -116,7 +116,7 @@ async function $do(
   const context = {
     options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
-    operationID: "post_/plans/{id}/clone",
+    operationID: "clonePlan",
     oAuth2Scopes: null,
 
     resolvedSecurity: requestSecurity,

package/src/funcs/subscriptions-execute-subscription-modify.ts

@@ -26,19 +26,19 @@ import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Add customers to subscription inheritance
+ * Execute subscription modification
  *
  * @remarks
- * Attach additional child customers (by external ID) to an active standalone or parent subscription; creates inherited skeleton subscriptions for each. The subscription must be active.
+ * Execute a mid-cycle subscription modification (inheritance or quantity change).
  */
 export function subscriptionsExecuteSubscriptionModify(
   client: FlexpriceCore,
   id: string,
-  body: models.ExecuteSubscriptionInheritanceRequest,
+  body: models.ExecuteSubscriptionModifyRequest,
   options?: RequestOptions,
 ): APIPromise<
   Result<
-    models.SubscriptionResponse,
+    models.SubscriptionModifyResponse,
     | models.ErrorsErrorResponse
     | FlexPriceError
     | ResponseValidationError
@@ -61,12 +61,12 @@ export function subscriptionsExecuteSubscriptionModify(
 async function $do(
   client: FlexpriceCore,
   id: string,
-  body: models.ExecuteSubscriptionInheritanceRequest,
+  body: models.ExecuteSubscriptionModifyRequest,
   options?: RequestOptions,
 ): Promise<
   [
     Result<
-      models.SubscriptionResponse,
+      models.SubscriptionModifyResponse,
       | models.ErrorsErrorResponse
       | FlexPriceError
       | ResponseValidationError
@@ -80,7 +80,7 @@ async function $do(
     APICall,
   ]
 > {
-  const input: models.ExecuteSubscriptionModifyRequest = {
+  const input: models.ExecuteSubscriptionModifyRequestRequest = {
     id: id,
     body: body,
   };
@@ -88,7 +88,10 @@ async function $do(
   const parsed = safeParse(
     input,
     (value) =>
-      z.parse(models.ExecuteSubscriptionModifyRequest$outboundSchema, value),
+      z.parse(
+        models.ExecuteSubscriptionModifyRequestRequest$outboundSchema,
+        value,
+      ),
     "Input validation failed",
   );
   if (!parsed.ok) {
@@ -160,7 +163,7 @@ async function $do(
   };
 
   const [result] = await M.match<
-    models.SubscriptionResponse,
+    models.SubscriptionModifyResponse,
     | models.ErrorsErrorResponse
     | FlexPriceError
     | ResponseValidationError
@@ -171,7 +174,7 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.json(200, models.SubscriptionResponse$inboundSchema),
+    M.json(200, models.SubscriptionModifyResponse$inboundSchema),
     M.jsonErr([400, 404], models.ErrorsErrorResponse$inboundSchema),
     M.jsonErr(500, models.ErrorsErrorResponse$inboundSchema),
     M.fail("4XX"),

package/src/funcs/subscriptions-preview-subscription-modify.ts

@@ -0,0 +1,185 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { FlexpriceCore } 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 { 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";
+
+/**
+ * Preview subscription modification
+ *
+ * @remarks
+ * Preview the impact of a mid-cycle subscription modification without committing changes.
+ */
+export function subscriptionsPreviewSubscriptionModify(
+  client: FlexpriceCore,
+  id: string,
+  body: models.ExecuteSubscriptionModifyRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.SubscriptionModifyResponse,
+    | models.ErrorsErrorResponse
+    | FlexPriceError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    id,
+    body,
+    options,
+  ));
+}
+
+async function $do(
+  client: FlexpriceCore,
+  id: string,
+  body: models.ExecuteSubscriptionModifyRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.SubscriptionModifyResponse,
+      | models.ErrorsErrorResponse
+      | FlexPriceError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const input: models.PreviewSubscriptionModifyRequest = {
+    id: id,
+    body: body,
+  };
+
+  const parsed = safeParse(
+    input,
+    (value) =>
+      z.parse(models.PreviewSubscriptionModifyRequest$outboundSchema, value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body$ = encodeJSON("body", payload.body, { explode: true });
+
+  const pathParams = {
+    id: encodeSimple("id", payload.id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/subscriptions/{id}/modify/preview")(pathParams);
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    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: "previewSubscriptionModify",
+    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,
+    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", "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.SubscriptionModifyResponse,
+    | models.ErrorsErrorResponse
+    | FlexPriceError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, models.SubscriptionModifyResponse$inboundSchema),
+    M.jsonErr([400, 404], models.ErrorsErrorResponse$inboundSchema),
+    M.jsonErr(500, models.ErrorsErrorResponse$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: "1.0",
-  sdkVersion: "2.1.1",
-  genVersion: "2.879.6",
-  userAgent: "speakeasy-sdk/typescript 2.1.1 2.879.6 1.0 @flexprice/sdk",
+  sdkVersion: "2.1.3",
+  genVersion: "2.879.13",
+  userAgent: "speakeasy-sdk/typescript 2.1.3 2.879.13 1.0 @flexprice/sdk",
 } as const;

package/src/lib/encodings.ts

@@ -514,3 +514,12 @@ export function appendForm(
     fd.append(key, String(value));
   }
 }
+
+export async function normalizeBlob(
+  value: Pick<Blob, "arrayBuffer" | "type">,
+): Promise<Blob> {
+  if (value instanceof Blob) {
+    return value;
+  }
+  return new Blob([await value.arrayBuffer()], { type: value.type });
+}

package/src/sdk/environments.ts

@@ -0,0 +1,29 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { environmentsCloneEnvironment } from "../funcs/environments-clone-environment.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import { unwrapAsync } from "../types/fp.js";
+import * as models from "./models/index.js";
+
+export class Environments extends ClientSDK {
+  /**
+   * Clone an environment
+   *
+   * @remarks
+   * Clone all published features and plans from the source environment into a target environment. If target_environment_id is provided, entities are cloned into that existing environment. Otherwise a new environment is created from name and type first.
+   */
+  async cloneEnvironment(
+    id: string,
+    body: models.CloneEnvironmentRequest,
+    options?: RequestOptions,
+  ): Promise<models.ModelsTemporalWorkflowResult> {
+    return unwrapAsync(environmentsCloneEnvironment(
+      this,
+      id,
+      body,
+      options,
+    ));
+  }
+}

package/src/sdk/features.ts

@@ -2,6 +2,7 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import { featuresCloneFeature } from "../funcs/features-clone-feature.js";
 import { featuresCreateFeature } from "../funcs/features-create-feature.js";
 import { featuresDeleteFeature } from "../funcs/features-delete-feature.js";
 import { featuresQueryFeature } from "../funcs/features-query-feature.js";
@@ -80,4 +81,23 @@ export class Features extends ClientSDK {
       options,
     ));
   }
+
+  /**
+   * Clone a feature
+   *
+   * @remarks
+   * Clone an existing feature
+   */
+  async cloneFeature(
+    id: string,
+    body: models.CloneFeatureRequest,
+    options?: RequestOptions,
+  ): Promise<models.FeatureResponse> {
+    return unwrapAsync(featuresCloneFeature(
+      this,
+      id,
+      body,
+      options,
+    ));
+  }
 }

package/src/sdk/invoices.ts

@@ -9,6 +9,7 @@ import { invoicesGetCustomerInvoiceSummary } from "../funcs/invoices-get-custome
 import { invoicesGetInvoicePdf } from "../funcs/invoices-get-invoice-pdf.js";
 import { invoicesGetInvoicePreview } from "../funcs/invoices-get-invoice-preview.js";
 import { invoicesGetInvoice } from "../funcs/invoices-get-invoice.js";
+import { invoicesGetMeterUsagePreviewInvoice } from "../funcs/invoices-get-meter-usage-preview-invoice.js";
 import { invoicesQueryInvoice } from "../funcs/invoices-query-invoice.js";
 import { invoicesRecalculateInvoiceV2 } from "../funcs/invoices-recalculate-invoice-v2.js";
 import { invoicesRecalculateInvoice } from "../funcs/invoices-recalculate-invoice.js";
@@ -55,6 +56,23 @@ export class Invoices extends ClientSDK {
     ));
   }
 
+  /**
+   * Get invoice preview using meter_usage data
+   *
+   * @remarks
+   * Preview invoice using the meter_usage table for usage data instead of feature_usage.
+   */
+  async getMeterUsagePreviewInvoice(
+    request: models.GetPreviewInvoiceRequest,
+    options?: RequestOptions,
+  ): Promise<models.InvoiceResponse> {
+    return unwrapAsync(invoicesGetMeterUsagePreviewInvoice(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * Get invoice preview
    *

package/src/sdk/meter-usage.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { meterUsageGetMeterUsageAnalytics } from "../funcs/meter-usage-get-meter-usage-analytics.js";
+import { meterUsageQueryMeterUsage } from "../funcs/meter-usage-query-meter-usage.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import { unwrapAsync } from "../types/fp.js";
+import * as models from "./models/index.js";
+
+export class MeterUsage extends ClientSDK {
+  /**
+   * Get meter usage analytics
+   *
+   * @remarks
+   * Query aggregated usage from meter_usage table for multiple meters
+   */
+  async getMeterUsageAnalytics(
+    request: models.MeterUsageAnalyticsRequest,
+    options?: RequestOptions,
+  ): Promise<models.MeterUsageAnalyticsResponse> {
+    return unwrapAsync(meterUsageGetMeterUsageAnalytics(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Query meter usage
+   *
+   * @remarks
+   * Query aggregated usage from meter_usage table for a single meter with optional time-window bucketing
+   */
+  async queryMeterUsage(
+    request: models.MeterUsageQueryRequest,
+    options?: RequestOptions,
+  ): Promise<models.MeterUsageQueryResponse> {
+    return unwrapAsync(meterUsageQueryMeterUsage(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/models/billing-cadence.ts

@@ -3,22 +3,18 @@
  */
 
 import * as z from "zod/v4-mini";
-import * as openEnums from "../../types/enums.js";
-import { OpenEnum } from "../../types/enums.js";
+import { ClosedEnum } from "../../types/enums.js";
 
 export const BillingCadence = {
   Recurring: "RECURRING",
-  Onetime: "ONETIME",
 } as const;
-export type BillingCadence = OpenEnum<typeof BillingCadence>;
+export type BillingCadence = ClosedEnum<typeof BillingCadence>;
 
 /** @internal */
-export const BillingCadence$inboundSchema: z.ZodMiniType<
-  BillingCadence,
-  unknown
-> = openEnums.inboundSchema(BillingCadence);
+export const BillingCadence$inboundSchema: z.ZodMiniEnum<
+  typeof BillingCadence
+> = z.enum(BillingCadence);
 /** @internal */
-export const BillingCadence$outboundSchema: z.ZodMiniType<
-  string,
-  BillingCadence
-> = openEnums.outboundSchema(BillingCadence);
+export const BillingCadence$outboundSchema: z.ZodMiniEnum<
+  typeof BillingCadence
+> = BillingCadence$inboundSchema;

package/src/sdk/models/billing-period.ts

@@ -13,6 +13,7 @@ export const BillingPeriod = {
   Daily: "DAILY",
   Quarterly: "QUARTERLY",
   HalfYearly: "HALF_YEARLY",
+  Onetime: "ONETIME",
 } as const;
 export type BillingPeriod = OpenEnum<typeof BillingPeriod>;