@paygentic/sdk 0.6.11 → 0.6.13

package/src/funcs/paymentsGet.ts

@@ -0,0 +1,177 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { PaygenticCore } from "../core.js";
+import { 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";
+
+/**
+ * Get Payment
+ *
+ * @remarks
+ * Retrieve a single payment by ID.
+ */
+export function paymentsGet(
+  client: PaygenticCore,
+  request: operations.GetPaymentRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.Payment,
+    | errors.ErrorT
+    | PaygenticError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: PaygenticCore,
+  request: operations.GetPaymentRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.Payment,
+      | errors.ErrorT
+      | PaygenticError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.GetPaymentRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    id: encodeSimple("id", payload.id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc("/v0/payments/{id}")(pathParams);
+
+  const headers = new Headers(compactMap({
+    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: "getPayment",
+    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: "GET",
+    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: ["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.Payment,
+    | errors.ErrorT
+    | PaygenticError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, models.Payment$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/funcs/paymentsList.ts

@@ -0,0 +1,179 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { PaygenticCore } from "../core.js";
+import { encodeFormQuery } 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 operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * List Payments
+ *
+ * @remarks
+ * List payments for the authenticated merchant with optional filters.
+ */
+export function paymentsList(
+  client: PaygenticCore,
+  request?: operations.ListPaymentsRequest | undefined,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.ListPaymentsResponse,
+    | errors.ErrorT
+    | PaygenticError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: PaygenticCore,
+  request?: operations.ListPaymentsRequest | undefined,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.ListPaymentsResponse,
+      | errors.ErrorT
+      | PaygenticError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.ListPaymentsRequest$outboundSchema.optional().parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const path = pathToFunc("/v0/payments")();
+
+  const query = encodeFormQuery({
+    "customerId": payload?.customerId,
+    "limit": payload?.limit,
+    "merchantId": payload?.merchantId,
+    "offset": payload?.offset,
+    "status": payload?.status,
+  });
+
+  const headers = new Headers(compactMap({
+    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: "listPayments",
+    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: "GET",
+    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,
+    errorCodes: ["401", "403", "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<
+    operations.ListPaymentsResponse,
+    | errors.ErrorT
+    | PaygenticError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, operations.ListPaymentsResponse$inboundSchema),
+    M.jsonErr([401, 403], 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

@@ -61,7 +61,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.1.0",
-  sdkVersion: "0.6.4",
-  genVersion: "2.836.5",
-  userAgent: "speakeasy-sdk/typescript 0.6.4 2.836.5 0.1.0 @paygentic/sdk",
+  sdkVersion: "0.6.12",
+  genVersion: "2.849.10",
+  userAgent: "speakeasy-sdk/typescript 0.6.12 2.849.10 0.1.0 @paygentic/sdk",
 } as const;

package/src/lib/matchers.ts

@@ -251,8 +251,9 @@ export function match<T, E>(
         raw = body;
         break;
       default:
-        encoding satisfies never;
-        throw new Error(`Unsupported response type: ${encoding}`);
+        throw new Error(
+          `Unsupported response type: ${encoding satisfies never}`,
+        );
     }
 
     if (matcher.enc === "fail") {

package/src/lib/security.ts

@@ -198,8 +198,7 @@ export function resolveSecurity(
         applyBearer(state, spec);
         break;
       default:
-        spec satisfies never;
-        throw SecurityError.unrecognizedType(type);
+        throw SecurityError.unrecognizedType((spec satisfies never, type));
     }
   });
 

package/src/models/index.ts

@@ -28,6 +28,7 @@ export * from "./invoicelineitemsresponse.js";
 export * from "./issueentitlementrequest.js";
 export * from "./meteredentitlementdetail.js";
 export * from "./offsetpagination.js";
+export * from "./payment.js";
 export * from "./plan.js";
 export * from "./price.js";
 export * from "./pricefeature.js";
@@ -50,6 +51,7 @@ export * from "./subscriptionportal.js";
 export * from "./testclock.js";
 export * from "./updaterulerequest.js";
 export * from "./usageevent.js";
+export * from "./usageresponse.js";
 export * from "./user.js";
 export * from "./validationerror.js";
 export * from "./validtaxaddress.js";

package/src/models/operations/createpayment.ts

@@ -0,0 +1,156 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../../types/enums.js";
+
+/**
+ * ISO 4217 currency code.
+ */
+export const Currency = {
+  Usd: "USD",
+  Eur: "EUR",
+  Gbp: "GBP",
+  Aud: "AUD",
+} as const;
+/**
+ * ISO 4217 currency code.
+ */
+export type Currency = ClosedEnum<typeof Currency>;
+
+export type LineItem = {
+  /**
+   * Line item description.
+   */
+  description: string;
+  /**
+   * Line item amount in decimal format (e.g. '5.00').
+   */
+  amount: string;
+  /**
+   * Quantity of this line item. Defaults to 1.
+   */
+  quantity?: number | undefined;
+};
+
+export type CreatePaymentRequest = {
+  /**
+   * Payment amount in decimal format (e.g. '10.50'). Minimum 1.00, maximum 5,000.00. Contact support for higher limits.
+   */
+  amount: string;
+  /**
+   * ISO 4217 currency code.
+   */
+  currency: Currency;
+  /**
+   * Merchant organization ID. Required when using an API key that is not scoped to a single merchant.
+   */
+  merchantId?: string | undefined;
+  /**
+   * Optional customer ID. Must belong to this merchant.
+   */
+  customerId?: string | undefined;
+  /**
+   * Client-provided key for safe retries. If a payment with the same key already exists, the existing payment is returned.
+   */
+  idempotencyKey?: string | undefined;
+  /**
+   * Merchant-defined reference for this payment (e.g. order ID, invoice number).
+   */
+  reference?: string | undefined;
+  /**
+   * Arbitrary key-value string pairs to attach to the payment.
+   */
+  metadata?: { [k: string]: string } | undefined;
+  /**
+   * Optional breakdown of what the customer is being charged for.
+   */
+  lineItems?: Array<LineItem> | undefined;
+  /**
+   * URL to redirect the customer to after a successful payment.
+   */
+  successRedirectUrl?: string | undefined;
+  /**
+   * URL to redirect the customer to after a failed payment.
+   */
+  failureRedirectUrl?: string | undefined;
+  /**
+   * Whether to save the customer's payment method for future use. Defaults to false.
+   */
+  savePaymentMethod?: boolean | undefined;
+  /**
+   * ISO 8601 duration for the payment lifetime. Defaults to P30D (30 days). Maximum is P31D (31 days). Examples: PT1H, P1D, P7D, P30D.
+   */
+  expiresIn?: string | undefined;
+};
+
+/** @internal */
+export const Currency$outboundSchema: z.ZodNativeEnum<typeof Currency> = z
+  .nativeEnum(Currency);
+
+/** @internal */
+export type LineItem$Outbound = {
+  description: string;
+  amount: string;
+  quantity: number;
+};
+
+/** @internal */
+export const LineItem$outboundSchema: z.ZodType<
+  LineItem$Outbound,
+  z.ZodTypeDef,
+  LineItem
+> = z.object({
+  description: z.string(),
+  amount: z.string(),
+  quantity: z.number().int().default(1),
+});
+
+export function lineItemToJSON(lineItem: LineItem): string {
+  return JSON.stringify(LineItem$outboundSchema.parse(lineItem));
+}
+
+/** @internal */
+export type CreatePaymentRequest$Outbound = {
+  amount: string;
+  currency: string;
+  merchantId?: string | undefined;
+  customerId?: string | undefined;
+  idempotencyKey?: string | undefined;
+  reference?: string | undefined;
+  metadata?: { [k: string]: string } | undefined;
+  lineItems?: Array<LineItem$Outbound> | undefined;
+  successRedirectUrl?: string | undefined;
+  failureRedirectUrl?: string | undefined;
+  savePaymentMethod: boolean;
+  expiresIn?: string | undefined;
+};
+
+/** @internal */
+export const CreatePaymentRequest$outboundSchema: z.ZodType<
+  CreatePaymentRequest$Outbound,
+  z.ZodTypeDef,
+  CreatePaymentRequest
+> = z.object({
+  amount: z.string(),
+  currency: Currency$outboundSchema,
+  merchantId: z.string().optional(),
+  customerId: z.string().optional(),
+  idempotencyKey: z.string().optional(),
+  reference: z.string().optional(),
+  metadata: z.record(z.string()).optional(),
+  lineItems: z.array(z.lazy(() => LineItem$outboundSchema)).optional(),
+  successRedirectUrl: z.string().optional(),
+  failureRedirectUrl: z.string().optional(),
+  savePaymentMethod: z.boolean().default(false),
+  expiresIn: z.string().optional(),
+});
+
+export function createPaymentRequestToJSON(
+  createPaymentRequest: CreatePaymentRequest,
+): string {
+  return JSON.stringify(
+    CreatePaymentRequest$outboundSchema.parse(createPaymentRequest),
+  );
+}