integrateledger 0.1.1 → 0.1.2

package/src/funcs/publish-catalog.ts

@@ -115,7 +115,7 @@ async function $do(
 
   const requestRes = client._createRequest(context, {
     security: requestSecurity,
-    method: "PUT",
+    method: "POST",
     baseURL: options?.serverURL,
     path: path,
     headers: headers,

package/src/funcs/set-customer-overage-cap.ts

@@ -0,0 +1,176 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { LedgerCore } from "../core.js";
+import { encodeFormQuery, encodeJSON } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.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/http-client-errors.js";
+import * as errors from "../models/errors/index.js";
+import { LedgerError } from "../models/errors/ledger-error.js";
+import { ResponseValidationError } from "../models/errors/response-validation-error.js";
+import { SDKValidationError } from "../models/errors/sdk-validation-error.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";
+
+/**
+ * Set or clear a customer's overage cap
+ */
+export function setCustomerOverageCap(
+  client: LedgerCore,
+  request: operations.SetCustomerOverageCapRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.CustomerOverageCap,
+    | errors.CustomerError
+    | LedgerError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: LedgerCore,
+  request: operations.SetCustomerOverageCapRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.CustomerOverageCap,
+      | errors.CustomerError
+      | LedgerError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      z.parse(operations.SetCustomerOverageCapRequest$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 path = pathToFunc("/v1/customers/overage-cap")();
+
+  const query = encodeFormQuery({
+    "customerId": payload.customerId,
+  });
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKey);
+  const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "setCustomerOverageCap",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKey,
+    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,
+    query: query,
+    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,
+    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 responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    models.CustomerOverageCap,
+    | errors.CustomerError
+    | LedgerError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, models.CustomerOverageCap$inboundSchema),
+    M.jsonErr([400, 401, 404], errors.CustomerError$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/set-customer-overage-override.ts

@@ -0,0 +1,179 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { LedgerCore } from "../core.js";
+import { encodeFormQuery, encodeJSON } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.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/http-client-errors.js";
+import * as errors from "../models/errors/index.js";
+import { LedgerError } from "../models/errors/ledger-error.js";
+import { ResponseValidationError } from "../models/errors/response-validation-error.js";
+import { SDKValidationError } from "../models/errors/sdk-validation-error.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";
+
+/**
+ * Set or clear a customer's negotiated overage rate
+ */
+export function setCustomerOverageOverride(
+  client: LedgerCore,
+  request: operations.SetCustomerOverageOverrideRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.CustomerOverageOverrideResult,
+    | errors.CustomerError
+    | LedgerError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: LedgerCore,
+  request: operations.SetCustomerOverageOverrideRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.CustomerOverageOverrideResult,
+      | errors.CustomerError
+      | LedgerError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      z.parse(
+        operations.SetCustomerOverageOverrideRequest$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 path = pathToFunc("/v1/customers/overage-override")();
+
+  const query = encodeFormQuery({
+    "customerId": payload.customerId,
+  });
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKey);
+  const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "setCustomerOverageOverride",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKey,
+    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,
+    query: query,
+    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,
+    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 responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    models.CustomerOverageOverrideResult,
+    | errors.CustomerError
+    | LedgerError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, models.CustomerOverageOverrideResult$inboundSchema),
+    M.jsonErr([400, 401, 404, 409], errors.CustomerError$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/set-subscription-cancellation.ts

@@ -132,7 +132,7 @@ async function $do(
 
   const requestRes = client._createRequest(context, {
     security: requestSecurity,
-    method: "PUT",
+    method: "POST",
     baseURL: options?.serverURL,
     path: path,
     headers: headers,

package/src/funcs/update-add-on.ts

@@ -128,7 +128,7 @@ async function $do(
 
   const requestRes = client._createRequest(context, {
     security: requestSecurity,
-    method: "PUT",
+    method: "POST",
     baseURL: options?.serverURL,
     path: path,
     headers: headers,

package/src/funcs/update-feature.ts

@@ -128,7 +128,7 @@ async function $do(
 
   const requestRes = client._createRequest(context, {
     security: requestSecurity,
-    method: "PUT",
+    method: "POST",
     baseURL: options?.serverURL,
     path: path,
     headers: headers,

package/src/funcs/update-plan.ts

@@ -128,7 +128,7 @@ async function $do(
 
   const requestRes = client._createRequest(context, {
     security: requestSecurity,
-    method: "PUT",
+    method: "POST",
     baseURL: options?.serverURL,
     path: path,
     headers: headers,

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.1.1",
+  sdkVersion: "0.1.2",
   genVersion: "2.954.8",
-  userAgent: "speakeasy-sdk/typescript 0.1.1 2.954.8 0.1.0 integrateledger",
+  userAgent: "speakeasy-sdk/typescript 0.1.2 2.954.8 0.1.0 integrateledger",
 } as const;

package/src/models/catalog-input.ts

@@ -26,6 +26,18 @@ export type Plan = {
   name: string;
   monthlyCredits: number;
   monthlyPriceCents: number;
+  /**
+   * Price in cents per overageBillingUnits credits used after the plan's credits and packs run out. Null or omitted: no overage.
+   */
+  overageUnitAmountCents?: number | null | undefined;
+  /**
+   * Credits billed per overageUnitAmountCents. Defaults to 1.
+   */
+  overageBillingUnits?: number | undefined;
+  /**
+   * Default monthly overage spend cap in cents. A customer's own cap replaces it. Null or omitted: no cap.
+   */
+  overageCapCents?: number | null | undefined;
 };
 
 export type Feature = {
@@ -85,6 +97,9 @@ export type Plan$Outbound = {
   name: string;
   monthlyCredits: number;
   monthlyPriceCents: number;
+  overageUnitAmountCents?: number | null | undefined;
+  overageBillingUnits?: number | undefined;
+  overageCapCents?: number | null | undefined;
 };
 
 /** @internal */
@@ -94,6 +109,9 @@ export const Plan$outboundSchema: z.ZodMiniType<Plan$Outbound, Plan> = z.object(
     name: z.string(),
     monthlyCredits: z.int(),
     monthlyPriceCents: z.int(),
+    overageUnitAmountCents: z.optional(z.nullable(z.int())),
+    overageBillingUnits: z.optional(z.int()),
+    overageCapCents: z.optional(z.nullable(z.int())),
   },
 );
 

package/src/models/check-response.ts

@@ -9,6 +9,9 @@ import * as types from "../types/primitives.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 
 export type CheckResponse = {
+  /**
+   * Whether track would accept this feature now: from prepaid credits, or as overage within the cap on a paid plan with overage.
+   */
   allowed: boolean;
   availableCredits: number;
   creditCost: number;

package/src/models/create-plan-input.ts

@@ -9,6 +9,18 @@ export type CreatePlanInput = {
   name: string;
   monthlyCredits: number;
   monthlyPriceCents: number;
+  /**
+   * Price in cents per overageBillingUnits credits used after the plan's credits and packs run out. Null or omitted: no overage.
+   */
+  overageUnitAmountCents?: number | null | undefined;
+  /**
+   * Credits billed per overageUnitAmountCents. Defaults to 1.
+   */
+  overageBillingUnits?: number | undefined;
+  /**
+   * Default monthly overage spend cap in cents. A customer's own cap replaces it. Null or omitted: no cap.
+   */
+  overageCapCents?: number | null | undefined;
 };
 
 /** @internal */
@@ -17,6 +29,9 @@ export type CreatePlanInput$Outbound = {
   name: string;
   monthlyCredits: number;
   monthlyPriceCents: number;
+  overageUnitAmountCents?: number | null | undefined;
+  overageBillingUnits?: number | undefined;
+  overageCapCents?: number | null | undefined;
 };
 
 /** @internal */
@@ -28,6 +43,9 @@ export const CreatePlanInput$outboundSchema: z.ZodMiniType<
   name: z.string(),
   monthlyCredits: z.int(),
   monthlyPriceCents: z.int(),
+  overageUnitAmountCents: z.optional(z.nullable(z.int())),
+  overageBillingUnits: z.optional(z.int()),
+  overageCapCents: z.optional(z.nullable(z.int())),
 });
 
 export function createPlanInputToJSON(

package/src/models/customer-detail.ts

@@ -8,6 +8,10 @@ import * as openEnums from "../types/enums.js";
 import { OpenEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import * as types from "../types/primitives.js";
+import {
+  CustomerOverage,
+  CustomerOverage$inboundSchema,
+} from "./customer-overage.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 
 export const CustomerDetailStatus = {
@@ -29,6 +33,11 @@ export type CustomerDetail = {
   createdAt: Date;
   availableCredits: number;
   currentPlan: CurrentPlan | null;
+  /**
+   * The customer's own overage cap, set with setCustomerOverageCap. Null: the plan default applies.
+   */
+  overageCapCents: number | null;
+  overage: CustomerOverage | null;
 };
 
 /** @internal */
@@ -66,6 +75,8 @@ export const CustomerDetail$inboundSchema: z.ZodMiniType<
   createdAt: types.date(),
   availableCredits: types.number(),
   currentPlan: types.nullable(z.lazy(() => CurrentPlan$inboundSchema)),
+  overageCapCents: types.nullable(types.number()),
+  overage: types.nullable(CustomerOverage$inboundSchema),
 });
 
 export function customerDetailFromJSON(

package/src/models/customer-overage-cap.ts

@@ -0,0 +1,39 @@
+/*
+ * 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 {
+  CustomerOverage,
+  CustomerOverage$inboundSchema,
+} from "./customer-overage.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+export type CustomerOverageCap = {
+  customerId: string;
+  capCents: number | null;
+  overage: CustomerOverage | null;
+};
+
+/** @internal */
+export const CustomerOverageCap$inboundSchema: z.ZodMiniType<
+  CustomerOverageCap,
+  unknown
+> = z.object({
+  customerId: types.string(),
+  capCents: types.nullable(types.number()),
+  overage: types.nullable(CustomerOverage$inboundSchema),
+});
+
+export function customerOverageCapFromJSON(
+  jsonString: string,
+): SafeParseResult<CustomerOverageCap, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CustomerOverageCap$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CustomerOverageCap' from JSON`,
+  );
+}

package/src/models/customer-overage-override-result.ts

@@ -0,0 +1,48 @@
+/*
+ * 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 {
+  CustomerOverageOverride,
+  CustomerOverageOverride$inboundSchema,
+} from "./customer-overage-override.js";
+import {
+  CustomerOverage,
+  CustomerOverage$inboundSchema,
+} from "./customer-overage.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+export type CustomerOverageOverrideResult = {
+  customerId: string;
+  /**
+   * The scope that was set or cleared. Null: any plan.
+   */
+  planId: string | null;
+  override: CustomerOverageOverride | null;
+  overage: CustomerOverage | null;
+};
+
+/** @internal */
+export const CustomerOverageOverrideResult$inboundSchema: z.ZodMiniType<
+  CustomerOverageOverrideResult,
+  unknown
+> = z.object({
+  customerId: types.string(),
+  planId: types.nullable(types.string()),
+  override: types.nullable(CustomerOverageOverride$inboundSchema),
+  overage: types.nullable(CustomerOverage$inboundSchema),
+});
+
+export function customerOverageOverrideResultFromJSON(
+  jsonString: string,
+): SafeParseResult<CustomerOverageOverrideResult, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CustomerOverageOverrideResult$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CustomerOverageOverrideResult' from JSON`,
+  );
+}

package/src/models/customer-overage-override.ts

@@ -0,0 +1,48 @@
+/*
+ * 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 "./errors/sdk-validation-error.js";
+
+/**
+ * The override behind the rate when source is override. Null otherwise.
+ */
+export type CustomerOverageOverride = {
+  /**
+   * The plan it applies to. Null: any plan.
+   */
+  planId: string | null;
+  unitAmountCents: number;
+  billingUnits: number;
+  /**
+   * The override's cap. Null: the plan default applies.
+   */
+  capCents: number | null;
+  effectiveFrom: Date;
+};
+
+/** @internal */
+export const CustomerOverageOverride$inboundSchema: z.ZodMiniType<
+  CustomerOverageOverride,
+  unknown
+> = z.object({
+  planId: types.nullable(types.string()),
+  unitAmountCents: types.number(),
+  billingUnits: types.number(),
+  capCents: types.nullable(types.number()),
+  effectiveFrom: types.date(),
+});
+
+export function customerOverageOverrideFromJSON(
+  jsonString: string,
+): SafeParseResult<CustomerOverageOverride, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CustomerOverageOverride$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CustomerOverageOverride' from JSON`,
+  );
+}