@gr4vy/sdk 2.4.2 → 2.4.4

package/src/funcs/transactionsIncrementAuthorization.ts

@@ -0,0 +1,260 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { Gr4vyCore } from "../core.js";
+import { encodeJSON, encodeSimple } 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 * as components from "../models/components/index.js";
+import { Gr4vyError } from "../models/errors/gr4vyerror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.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";
+
+/**
+ * Increment transaction authorization
+ *
+ * @remarks
+ * Increment the transaction authorization amount of a given transaction_id.
+ */
+export function transactionsIncrementAuthorization(
+  client: Gr4vyCore,
+  transactionAuthorizationIncrementCreate:
+    components.TransactionAuthorizationIncrementCreate,
+  transactionId: string,
+  merchantAccountId?: string | null | undefined,
+  idempotencyKey?: string | null | undefined,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    components.TransactionAuthorizationIncrement,
+    | errors.Error400
+    | errors.Error401
+    | errors.Error403
+    | errors.Error404
+    | errors.Error405
+    | errors.Error409
+    | errors.HTTPValidationError
+    | errors.Error425
+    | errors.Error429
+    | errors.Error500
+    | errors.Error502
+    | errors.Error504
+    | Gr4vyError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    transactionAuthorizationIncrementCreate,
+    transactionId,
+    merchantAccountId,
+    idempotencyKey,
+    options,
+  ));
+}
+
+async function $do(
+  client: Gr4vyCore,
+  transactionAuthorizationIncrementCreate:
+    components.TransactionAuthorizationIncrementCreate,
+  transactionId: string,
+  merchantAccountId?: string | null | undefined,
+  idempotencyKey?: string | null | undefined,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      components.TransactionAuthorizationIncrement,
+      | errors.Error400
+      | errors.Error401
+      | errors.Error403
+      | errors.Error404
+      | errors.Error405
+      | errors.Error409
+      | errors.HTTPValidationError
+      | errors.Error425
+      | errors.Error429
+      | errors.Error500
+      | errors.Error502
+      | errors.Error504
+      | Gr4vyError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const input: operations.IncrementTransactionAuthorizationRequest = {
+    transactionAuthorizationIncrementCreate:
+      transactionAuthorizationIncrementCreate,
+    transactionId: transactionId,
+    merchantAccountId: merchantAccountId,
+    idempotencyKey: idempotencyKey,
+  };
+
+  const parsed = safeParse(
+    input,
+    (value) =>
+      operations.IncrementTransactionAuthorizationRequest$outboundSchema.parse(
+        value,
+      ),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON(
+    "body",
+    payload.TransactionAuthorizationIncrementCreate,
+    { explode: true },
+  );
+
+  const pathParams = {
+    transaction_id: encodeSimple("transaction_id", payload.transaction_id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc(
+    "/transactions/{transaction_id}/authorization/increment",
+  )(pathParams);
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+    "idempotency-key": encodeSimple(
+      "idempotency-key",
+      payload["idempotency-key"],
+      { explode: false, charEncoding: "none" },
+    ),
+    "x-gr4vy-merchant-account-id": encodeSimple(
+      "x-gr4vy-merchant-account-id",
+      payload.merchantAccountId ?? client._options.merchantAccountId,
+      { explode: false, charEncoding: "none" },
+    ),
+  }));
+
+  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: "increment_transaction_authorization",
+    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: "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,
+    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<
+    components.TransactionAuthorizationIncrement,
+    | errors.Error400
+    | errors.Error401
+    | errors.Error403
+    | errors.Error404
+    | errors.Error405
+    | errors.Error409
+    | errors.HTTPValidationError
+    | errors.Error425
+    | errors.Error429
+    | errors.Error500
+    | errors.Error502
+    | errors.Error504
+    | Gr4vyError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, components.TransactionAuthorizationIncrement$inboundSchema),
+    M.jsonErr(400, errors.Error400$inboundSchema),
+    M.jsonErr(401, errors.Error401$inboundSchema),
+    M.jsonErr(403, errors.Error403$inboundSchema),
+    M.jsonErr(404, errors.Error404$inboundSchema),
+    M.jsonErr(405, errors.Error405$inboundSchema),
+    M.jsonErr(409, errors.Error409$inboundSchema),
+    M.jsonErr(422, errors.HTTPValidationError$inboundSchema),
+    M.jsonErr(425, errors.Error425$inboundSchema),
+    M.jsonErr(429, errors.Error429$inboundSchema),
+    M.jsonErr(500, errors.Error500$inboundSchema),
+    M.jsonErr(502, errors.Error502$inboundSchema),
+    M.jsonErr(504, errors.Error504$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

@@ -77,7 +77,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0.0",
-  sdkVersion: "2.4.2",
+  sdkVersion: "2.4.4",
   genVersion: "2.926.2",
-  userAgent: "speakeasy-sdk/typescript 2.4.2 2.926.2 1.0.0 @gr4vy/sdk",
+  userAgent: "speakeasy-sdk/typescript 2.4.4 2.926.2 1.0.0 @gr4vy/sdk",
 } as const;

package/src/models/components/apikeypair.ts

@@ -55,6 +55,10 @@ export type APIKeyPair = {
    * The date and time when this API key pair was last updated.
    */
   updatedAt: Date;
+  /**
+   * The date and time when this API key pair was last used to authenticate, or `null` if it has never been used.
+   */
+  lastUsedAt?: Date | null | undefined;
   /**
    * The user or API key pair that created this API key pair.
    */
@@ -84,6 +88,9 @@ export const APIKeyPair$inboundSchema: z.ZodType<
   private_key: z.nullable(z.string()).optional(),
   created_at: z.string().datetime({ offset: true }).transform(v => new Date(v)),
   updated_at: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  last_used_at: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ).optional(),
   creator: z.nullable(ApiRoutersApiKeyPairsSchemasCreator$inboundSchema)
     .optional(),
   merchant_accounts: z.array(MerchantAccountSummary$inboundSchema).optional(),
@@ -94,6 +101,7 @@ export const APIKeyPair$inboundSchema: z.ZodType<
     "private_key": "privateKey",
     "created_at": "createdAt",
     "updated_at": "updatedAt",
+    "last_used_at": "lastUsedAt",
     "merchant_accounts": "merchantAccounts",
   });
 });

package/src/models/components/incrementalauthorizationstatus.ts

@@ -0,0 +1,22 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../../types/enums.js";
+import { OpenEnum } from "../../types/enums.js";
+
+export const IncrementalAuthorizationStatus = {
+  Succeeded: "succeeded",
+  Failed: "failed",
+} as const;
+export type IncrementalAuthorizationStatus = OpenEnum<
+  typeof IncrementalAuthorizationStatus
+>;
+
+/** @internal */
+export const IncrementalAuthorizationStatus$inboundSchema: z.ZodType<
+  IncrementalAuthorizationStatus,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(IncrementalAuthorizationStatus);

package/src/models/components/index.ts

@@ -147,6 +147,7 @@ export * from "./googlepaypaymentoptioncontext.js";
 export * from "./googlepaysession.js";
 export * from "./googlepaysessionrequest.js";
 export * from "./guestbuyer.js";
+export * from "./incrementalauthorizationstatus.js";
 export * from "./instrumenttype.js";
 export * from "./integrationclient.js";
 export * from "./klarnaoptions.js";
@@ -314,6 +315,8 @@ export * from "./tokenpaymentmethodcreate.js";
 export * from "./transaction.js";
 export * from "./transactionaction.js";
 export * from "./transactionactions.js";
+export * from "./transactionauthorizationincrement.js";
+export * from "./transactionauthorizationincrementcreate.js";
 export * from "./transactionbuyer.js";
 export * from "./transactioncancel.js";
 export * from "./transactioncapture.js";

package/src/models/components/transaction.ts

@@ -202,6 +202,10 @@ export type Transaction = {
    * Indicates whether this transaction has been disputed.
    */
   disputed: boolean;
+  /**
+   * The identifier of the transaction from which this transaction was reauthorized.
+   */
+  reauthorizedFromTransactionId?: string | null | undefined;
   /**
    * Contains information about an airline travel, if applicable.
    */
@@ -392,6 +396,7 @@ export const Transaction$inboundSchema: z.ZodType<
   created_at: z.string().datetime({ offset: true }).transform(v => new Date(v)),
   updated_at: z.string().datetime({ offset: true }).transform(v => new Date(v)),
   disputed: z.boolean(),
+  reauthorized_from_transaction_id: z.nullable(z.string()).optional(),
   airline: z.nullable(Airline$inboundSchema).optional(),
   auth_response_code: z.nullable(z.string()).optional(),
   avs_response_code: z.nullable(AVSResponseCode$inboundSchema).optional(),
@@ -467,6 +472,7 @@ export const Transaction$inboundSchema: z.ZodType<
     "gift_card_service": "giftCardService",
     "created_at": "createdAt",
     "updated_at": "updatedAt",
+    "reauthorized_from_transaction_id": "reauthorizedFromTransactionId",
     "auth_response_code": "authResponseCode",
     "avs_response_code": "avsResponseCode",
     "cvv_response_code": "cvvResponseCode",

package/src/models/components/transactionauthorizationincrement.ts

@@ -0,0 +1,69 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  IncrementalAuthorizationStatus,
+  IncrementalAuthorizationStatus$inboundSchema,
+} from "./incrementalauthorizationstatus.js";
+import { Transaction, Transaction$inboundSchema } from "./transaction.js";
+
+export type TransactionAuthorizationIncrement = {
+  /**
+   * Always `transaction-authorization-increment`.
+   */
+  type: "transaction-authorization-increment";
+  status: IncrementalAuthorizationStatus;
+  /**
+   * The standardized error code set by Gr4vy.
+   */
+  code: string | null;
+  /**
+   * This is the response code received from the payment service. This can be set to any value and is not standardized across different payment services.
+   */
+  rawResponseCode: string | null;
+  /**
+   * This is the response description received from the payment service. This can be set to any value and is not standardized across different payment services.
+   */
+  rawResponseDescription: string | null;
+  /**
+   * A full transaction resource.
+   */
+  transaction: Transaction;
+};
+
+/** @internal */
+export const TransactionAuthorizationIncrement$inboundSchema: z.ZodType<
+  TransactionAuthorizationIncrement,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  type: z.literal("transaction-authorization-increment").default(
+    "transaction-authorization-increment",
+  ),
+  status: IncrementalAuthorizationStatus$inboundSchema,
+  code: z.nullable(z.string()),
+  raw_response_code: z.nullable(z.string()),
+  raw_response_description: z.nullable(z.string()),
+  transaction: Transaction$inboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    "raw_response_code": "rawResponseCode",
+    "raw_response_description": "rawResponseDescription",
+  });
+});
+
+export function transactionAuthorizationIncrementFromJSON(
+  jsonString: string,
+): SafeParseResult<TransactionAuthorizationIncrement, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => TransactionAuthorizationIncrement$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'TransactionAuthorizationIncrement' from JSON`,
+  );
+}

package/src/models/components/transactionauthorizationincrementcreate.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+
+export type TransactionAuthorizationIncrementCreate = {
+  /**
+   * The amount by which to increment the authorization, in the smallest currency unit of the transaction's currency. For example, `1299` cents to increment the authorization by `$12.99`.
+   */
+  amount: number;
+};
+
+/** @internal */
+export type TransactionAuthorizationIncrementCreate$Outbound = {
+  amount: number;
+};
+
+/** @internal */
+export const TransactionAuthorizationIncrementCreate$outboundSchema: z.ZodType<
+  TransactionAuthorizationIncrementCreate$Outbound,
+  z.ZodTypeDef,
+  TransactionAuthorizationIncrementCreate
+> = z.object({
+  amount: z.number().int(),
+});
+
+export function transactionAuthorizationIncrementCreateToJSON(
+  transactionAuthorizationIncrementCreate:
+    TransactionAuthorizationIncrementCreate,
+): string {
+  return JSON.stringify(
+    TransactionAuthorizationIncrementCreate$outboundSchema.parse(
+      transactionAuthorizationIncrementCreate,
+    ),
+  );
+}

package/src/models/components/transactionsummary.ts

@@ -171,6 +171,10 @@ export type TransactionSummary = {
    * Indicates whether this transaction has been disputed.
    */
   disputed: boolean;
+  /**
+   * The identifier of the transaction from which this transaction was reauthorized.
+   */
+  reauthorizedFromTransactionId?: string | null | undefined;
 };
 
 /** @internal */
@@ -212,6 +216,7 @@ export const TransactionSummary$inboundSchema: z.ZodType<
   created_at: z.string().datetime({ offset: true }).transform(v => new Date(v)),
   updated_at: z.string().datetime({ offset: true }).transform(v => new Date(v)),
   disputed: z.boolean(),
+  reauthorized_from_transaction_id: z.nullable(z.string()).optional(),
 }).transform((v) => {
   return remap$(v, {
     "reconciliation_id": "reconciliationId",
@@ -235,6 +240,7 @@ export const TransactionSummary$inboundSchema: z.ZodType<
     "gift_card_service": "giftCardService",
     "created_at": "createdAt",
     "updated_at": "updatedAt",
+    "reauthorized_from_transaction_id": "reauthorizedFromTransactionId",
   });
 });
 

package/src/models/operations/incrementtransactionauthorization.ts

@@ -0,0 +1,68 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import * as components from "../components/index.js";
+
+export type IncrementTransactionAuthorizationGlobals = {
+  merchantAccountId?: string | undefined;
+};
+
+export type IncrementTransactionAuthorizationRequest = {
+  /**
+   * The unique identifier of the transaction.
+   */
+  transactionId: string;
+  /**
+   * The ID of the merchant account to use for this request.
+   */
+  merchantAccountId?: string | null | undefined;
+  /**
+   * A unique key that identifies this request. Providing this header will make this an idempotent request. We recommend using V4 UUIDs, or another random string with enough entropy to avoid collisions.
+   */
+  idempotencyKey?: string | null | undefined;
+  transactionAuthorizationIncrementCreate:
+    components.TransactionAuthorizationIncrementCreate;
+};
+
+/** @internal */
+export type IncrementTransactionAuthorizationRequest$Outbound = {
+  transaction_id: string;
+  merchantAccountId?: string | null | undefined;
+  "idempotency-key"?: string | null | undefined;
+  TransactionAuthorizationIncrementCreate:
+    components.TransactionAuthorizationIncrementCreate$Outbound;
+};
+
+/** @internal */
+export const IncrementTransactionAuthorizationRequest$outboundSchema: z.ZodType<
+  IncrementTransactionAuthorizationRequest$Outbound,
+  z.ZodTypeDef,
+  IncrementTransactionAuthorizationRequest
+> = z.object({
+  transactionId: z.string(),
+  merchantAccountId: z.nullable(z.string()).optional(),
+  idempotencyKey: z.nullable(z.string()).optional(),
+  transactionAuthorizationIncrementCreate:
+    components.TransactionAuthorizationIncrementCreate$outboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    transactionId: "transaction_id",
+    idempotencyKey: "idempotency-key",
+    transactionAuthorizationIncrementCreate:
+      "TransactionAuthorizationIncrementCreate",
+  });
+});
+
+export function incrementTransactionAuthorizationRequestToJSON(
+  incrementTransactionAuthorizationRequest:
+    IncrementTransactionAuthorizationRequest,
+): string {
+  return JSON.stringify(
+    IncrementTransactionAuthorizationRequest$outboundSchema.parse(
+      incrementTransactionAuthorizationRequest,
+    ),
+  );
+}

package/src/models/operations/index.ts

@@ -67,6 +67,7 @@ export * from "./gettransactioncapture.js";
 export * from "./gettransactionrefund.js";
 export * from "./gettransactionrefundsettlement.js";
 export * from "./gettransactionsettlement.js";
+export * from "./incrementtransactionauthorization.js";
 export * from "./issuegiftcard.js";
 export * from "./listallreportexecutions.js";
 export * from "./listapikeypairs.js";

package/src/sdk/transactions.ts

@@ -6,6 +6,7 @@ import { transactionsCancel } from "../funcs/transactionsCancel.js";
 import { transactionsCapture } from "../funcs/transactionsCapture.js";
 import { transactionsCreate } from "../funcs/transactionsCreate.js";
 import { transactionsGet } from "../funcs/transactionsGet.js";
+import { transactionsIncrementAuthorization } from "../funcs/transactionsIncrementAuthorization.js";
 import { transactionsList } from "../funcs/transactionsList.js";
 import { transactionsSync } from "../funcs/transactionsSync.js";
 import { transactionsUpdate } from "../funcs/transactionsUpdate.js";
@@ -212,4 +213,28 @@ export class Transactions extends ClientSDK {
       options,
     ));
   }
+
+  /**
+   * Increment transaction authorization
+   *
+   * @remarks
+   * Increment the transaction authorization amount of a given transaction_id.
+   */
+  async incrementAuthorization(
+    transactionAuthorizationIncrementCreate:
+      components.TransactionAuthorizationIncrementCreate,
+    transactionId: string,
+    merchantAccountId?: string | null | undefined,
+    idempotencyKey?: string | null | undefined,
+    options?: RequestOptions,
+  ): Promise<components.TransactionAuthorizationIncrement> {
+    return unwrapAsync(transactionsIncrementAuthorization(
+      this,
+      transactionAuthorizationIncrementCreate,
+      transactionId,
+      merchantAccountId,
+      idempotencyKey,
+      options,
+    ));
+  }
 }