@gr4vy/sdk 2.3.28 → 2.4.0

package/src/funcs/giftCardsIssuancesCreate.ts

@@ -0,0 +1,240 @@
+/*
+ * 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";
+
+/**
+ * Issue a gift card
+ *
+ * @remarks
+ * Issue a new virtual gift card through the primary gift card service.
+ */
+export function giftCardsIssuancesCreate(
+  client: Gr4vyCore,
+  giftCardIssuanceCreate: components.GiftCardIssuanceCreate,
+  idempotencyKey?: string | null | undefined,
+  merchantAccountId?: string | null | undefined,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    components.GiftCardIssuance,
+    | 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,
+    giftCardIssuanceCreate,
+    idempotencyKey,
+    merchantAccountId,
+    options,
+  ));
+}
+
+async function $do(
+  client: Gr4vyCore,
+  giftCardIssuanceCreate: components.GiftCardIssuanceCreate,
+  idempotencyKey?: string | null | undefined,
+  merchantAccountId?: string | null | undefined,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      components.GiftCardIssuance,
+      | 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.IssueGiftCardRequest = {
+    giftCardIssuanceCreate: giftCardIssuanceCreate,
+    idempotencyKey: idempotencyKey,
+    merchantAccountId: merchantAccountId,
+  };
+
+  const parsed = safeParse(
+    input,
+    (value) => operations.IssueGiftCardRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload.GiftCardIssuanceCreate, {
+    explode: true,
+  });
+
+  const path = pathToFunc("/gift-cards/issuances")();
+
+  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: "issue_gift_card",
+    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.GiftCardIssuance,
+    | 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(201, components.GiftCardIssuance$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.3.28",
-  genVersion: "2.918.4",
-  userAgent: "speakeasy-sdk/typescript 2.3.28 2.918.4 1.0.0 @gr4vy/sdk",
+  sdkVersion: "2.4.0",
+  genVersion: "2.924.0",
+  userAgent: "speakeasy-sdk/typescript 2.4.0 2.924.0 1.0.0 @gr4vy/sdk",
 } as const;

package/src/models/components/giftcardissuance.ts

@@ -0,0 +1,95 @@
+/*
+ * 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 {
+  GiftCardService,
+  GiftCardService$inboundSchema,
+} from "./giftcardservice.js";
+
+export type GiftCardIssuance = {
+  /**
+   * Always `gift-card-issuance`.
+   */
+  type: "gift-card-issuance";
+  /**
+   * The ID for the gift card issuance.
+   */
+  id: string;
+  /**
+   * The ID of the merchant account this gift card issuance belongs to.
+   */
+  merchantAccountId: string;
+  giftCardService: GiftCardService;
+  /**
+   * The identifier for this issuance as provided by the gift card service.
+   */
+  giftCardServicePaymentIssuanceId: string;
+  /**
+   * The URL for the issued gift card.
+   */
+  url: string;
+  /**
+   * The amount loaded onto the gift card, in the smallest denomination for the currency.
+   */
+  amount: number;
+  /**
+   * The ISO-4217 currency code for the `amount`.
+   */
+  currency: string;
+  /**
+   * The external identifier provided when issuing the gift card.
+   */
+  externalIdentifier?: string | null | undefined;
+  /**
+   * The date and time when this gift card was issued.
+   */
+  createdAt: Date;
+  /**
+   * The date and time when this gift card issuance was last updated.
+   */
+  updatedAt: Date;
+};
+
+/** @internal */
+export const GiftCardIssuance$inboundSchema: z.ZodType<
+  GiftCardIssuance,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  type: z.literal("gift-card-issuance").default("gift-card-issuance"),
+  id: z.string(),
+  merchant_account_id: z.string(),
+  gift_card_service: GiftCardService$inboundSchema,
+  gift_card_service_payment_issuance_id: z.string(),
+  url: z.string(),
+  amount: z.number().int(),
+  currency: z.string(),
+  external_identifier: 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)),
+}).transform((v) => {
+  return remap$(v, {
+    "merchant_account_id": "merchantAccountId",
+    "gift_card_service": "giftCardService",
+    "gift_card_service_payment_issuance_id": "giftCardServicePaymentIssuanceId",
+    "external_identifier": "externalIdentifier",
+    "created_at": "createdAt",
+    "updated_at": "updatedAt",
+  });
+});
+
+export function giftCardIssuanceFromJSON(
+  jsonString: string,
+): SafeParseResult<GiftCardIssuance, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GiftCardIssuance$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GiftCardIssuance' from JSON`,
+  );
+}

package/src/models/components/giftcardissuancecreate.ts

@@ -0,0 +1,60 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+
+/**
+ * The details used to issue a new virtual gift card.
+ */
+export type GiftCardIssuanceCreate = {
+  /**
+   * The provider theme code to issue the gift card against.
+   */
+  theme: string;
+  /**
+   * The amount to load onto the gift card, in the smallest denomination for the currency.
+   */
+  amount: number;
+  /**
+   * The ISO-4217 currency code for the `amount`.
+   */
+  currency: string;
+  /**
+   * An optional external identifier for this issuance.
+   */
+  externalIdentifier?: string | null | undefined;
+};
+
+/** @internal */
+export type GiftCardIssuanceCreate$Outbound = {
+  theme: string;
+  amount: number;
+  currency: string;
+  external_identifier?: string | null | undefined;
+};
+
+/** @internal */
+export const GiftCardIssuanceCreate$outboundSchema: z.ZodType<
+  GiftCardIssuanceCreate$Outbound,
+  z.ZodTypeDef,
+  GiftCardIssuanceCreate
+> = z.object({
+  theme: z.string(),
+  amount: z.number().int(),
+  currency: z.string(),
+  externalIdentifier: z.nullable(z.string()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    externalIdentifier: "external_identifier",
+  });
+});
+
+export function giftCardIssuanceCreateToJSON(
+  giftCardIssuanceCreate: GiftCardIssuanceCreate,
+): string {
+  return JSON.stringify(
+    GiftCardIssuanceCreate$outboundSchema.parse(giftCardIssuanceCreate),
+  );
+}

package/src/models/components/index.ts

@@ -124,6 +124,8 @@ export * from "./giftcardactivationcreate.js";
 export * from "./giftcardbalancerequest.js";
 export * from "./giftcardcreate.js";
 export * from "./giftcarderrorcode.js";
+export * from "./giftcardissuance.js";
+export * from "./giftcardissuancecreate.js";
 export * from "./giftcardredemption.js";
 export * from "./giftcardredemptionstatus.js";
 export * from "./giftcardrequest.js";

package/src/models/components/merchantaccount.ts

@@ -24,10 +24,14 @@ export type MerchantAccount = {
   displayName: string;
   /**
    * Client key provided by Pagos to authenticate to the Loon API. Loon is the Account Updater service we use and if the field is not set or if it's set to null, the Account Updater service doesn't get configured. If the field is set to `null`, the other `loon_*` fields must be set to null as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   loonClientKey?: string | null | undefined;
   /**
    * Secret key provided by Pagos to authenticate to the Loon API. Loon is the Account Updater service we use and if the field is not set or if it's set to null, the Account Updater service doesn't get configured. If the field is set to `null`, the other `loon_*` fields must be set to null as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   loonSecretKey?: string | null | undefined;
   /**
@@ -40,18 +44,26 @@ export type MerchantAccount = {
   loonMerchantAccountId?: string | null | undefined;
   /**
    * The public key used to encrypt the request to the Real-Time Account Updater service. The Account Updater service is used to update card details when cards are lost, stolen or expired. If the field is not set or if it's set to `null`, the Account Updater service doesn't get called. If the field is set, the other `account_updater_*` fields must be set as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   accountUpdaterRequestEncryptionKey?: string | null | undefined;
   /**
    * The ID of the key used to encrypt the request to the Real-Time Account Updater service. The Account Updater service is used to update card details when cards are lost, stolen or expired. If the field is not set or if it's set to `null`, the Account Updater service doesn't get called. If the field is set, the other `account_updater_*` fields must be set as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   accountUpdaterRequestEncryptionKeyId?: string | null | undefined;
   /**
    * The key used to decrypt the response from the Real-Time Account Updater service. The Account Updater service is used to update card details when cards are lost, stolen or expired. If the field is not set or if it's set to `null`, the Account Updater service doesn't get called. If the field is set, the other `account_updater_*` fields must be set as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   accountUpdaterResponseDecryptionKey?: string | null | undefined;
   /**
    * The ID of the key used to decrypt the request from the Real-Time Account Updater service. The Account Updater service is used to update card details when cards are lost, stolen or expired. If the field is not set or if it's set to `null`, the Account Updater service doesn't get called. If the field is set, the other `account_updater_*` fields must be set as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   accountUpdaterResponseDecryptionKeyId?: string | null | undefined;
   /**

package/src/models/components/merchantaccountcreate.ts

@@ -13,18 +13,26 @@ export type MerchantAccountCreate = {
   accountUpdaterEnabled?: boolean | undefined;
   /**
    * The public key used to encrypt the request to the Real-Time Account Updater service. The Account Updater service is used to update card details when cards are lost, stolen or expired. If the field is not set or if it's set to `null`, the Account Updater service doesn't get called. If the field is set, the other `account_updater_*` fields must be set as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   accountUpdaterRequestEncryptionKey?: string | null | undefined;
   /**
    * The ID of the key used to encrypt the request to the Real-Time Account Updater service. The Account Updater service is used to update card details when cards are lost, stolen or expired. If the field is not set or if it's set to `null`, the Account Updater service doesn't get called. If the field is set, the other `account_updater_*` fields must be set as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   accountUpdaterRequestEncryptionKeyId?: string | null | undefined;
   /**
    * The key used to decrypt the response from the Real-Time Account Updater service. The Account Updater service is used to update card details when cards are lost, stolen or expired. If the field is not set or if it's set to `null`, the Account Updater service doesn't get called. If the field is set, the other `account_updater_*` fields must be set as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   accountUpdaterResponseDecryptionKey?: string | null | undefined;
   /**
    * The ID of the key used to decrypt the request from the Real-Time Account Updater service. The Account Updater service is used to update card details when cards are lost, stolen or expired. If the field is not set or if it's set to `null`, the Account Updater service doesn't get called. If the field is set, the other `account_updater_*` fields must be set as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   accountUpdaterResponseDecryptionKeyId?: string | null | undefined;
   /**
@@ -37,10 +45,14 @@ export type MerchantAccountCreate = {
   overCapturePercentage?: number | null | undefined;
   /**
    * Client key provided by Pagos to authenticate to the Loon API. Loon is the Account Updater service we use and if the field is not set or if it's set to null, the Account Updater service doesn't get configured. If the field is set to `null`, the other `loon_*` fields must be set to null as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   loonClientKey?: string | null | undefined;
   /**
    * Secret key provided by Pagos to authenticate to the Loon API. Loon is the Account Updater service we use and if the field is not set or if it's set to null, the Account Updater service doesn't get configured. If the field is set to `null`, the other `loon_*` fields must be set to null as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   loonSecretKey?: string | null | undefined;
   /**

package/src/models/components/merchantaccountupdate.ts

@@ -13,18 +13,26 @@ export type MerchantAccountUpdate = {
   accountUpdaterEnabled?: boolean | undefined;
   /**
    * The public key used to encrypt the request to the Real-Time Account Updater service. The Account Updater service is used to update card details when cards are lost, stolen or expired. If the field is not set or if it's set to `null`, the Account Updater service doesn't get called. If the field is set, the other `account_updater_*` fields must be set as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   accountUpdaterRequestEncryptionKey?: string | null | undefined;
   /**
    * The ID of the key used to encrypt the request to the Real-Time Account Updater service. The Account Updater service is used to update card details when cards are lost, stolen or expired. If the field is not set or if it's set to `null`, the Account Updater service doesn't get called. If the field is set, the other `account_updater_*` fields must be set as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   accountUpdaterRequestEncryptionKeyId?: string | null | undefined;
   /**
    * The key used to decrypt the response from the Real-Time Account Updater service. The Account Updater service is used to update card details when cards are lost, stolen or expired. If the field is not set or if it's set to `null`, the Account Updater service doesn't get called. If the field is set, the other `account_updater_*` fields must be set as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   accountUpdaterResponseDecryptionKey?: string | null | undefined;
   /**
    * The ID of the key used to decrypt the request from the Real-Time Account Updater service. The Account Updater service is used to update card details when cards are lost, stolen or expired. If the field is not set or if it's set to `null`, the Account Updater service doesn't get called. If the field is set, the other `account_updater_*` fields must be set as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   accountUpdaterResponseDecryptionKeyId?: string | null | undefined;
   /**
@@ -37,10 +45,14 @@ export type MerchantAccountUpdate = {
   overCapturePercentage?: number | null | undefined;
   /**
    * Client key provided by Pagos to authenticate to the Loon API. Loon is the Account Updater service we use and if the field is not set or if it's set to null, the Account Updater service doesn't get configured. If the field is set to `null`, the other `loon_*` fields must be set to null as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   loonClientKey?: string | null | undefined;
   /**
    * Secret key provided by Pagos to authenticate to the Loon API. Loon is the Account Updater service we use and if the field is not set or if it's set to null, the Account Updater service doesn't get configured. If the field is set to `null`, the other `loon_*` fields must be set to null as well.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   loonSecretKey?: string | null | undefined;
   /**

package/src/models/components/transactionevent.ts

@@ -40,6 +40,8 @@ export const Name = {
   GiftCardRefundSucceeded: "gift-card-refund-succeeded",
   GiftCardRefundFailed: "gift-card-refund-failed",
   GiftCardReversalSucceeded: "gift-card-reversal-succeeded",
+  ReauthorizationAttempted: "reauthorization-attempted",
+  ReauthorizationCreated: "reauthorization-created",
   PaymentConnectorResponseTransactionAuthorizationSucceeded:
     "payment-connector-response-transaction-authorization-succeeded",
   PaymentConnectorResponseTransactionCaptureSucceeded:

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 "./issuegiftcard.js";
 export * from "./listallreportexecutions.js";
 export * from "./listapikeypairs.js";
 export * from "./listauditlogs.js";

package/src/models/operations/issuegiftcard.ts

@@ -0,0 +1,54 @@
+/*
+ * 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 IssueGiftCardGlobals = {
+  merchantAccountId?: string | undefined;
+};
+
+export type IssueGiftCardRequest = {
+  /**
+   * A unique key forwarded to the gift card service to make the issuance idempotent.
+   */
+  idempotencyKey?: string | null | undefined;
+  /**
+   * The ID of the merchant account to use for this request.
+   */
+  merchantAccountId?: string | null | undefined;
+  giftCardIssuanceCreate: components.GiftCardIssuanceCreate;
+};
+
+/** @internal */
+export type IssueGiftCardRequest$Outbound = {
+  "idempotency-key"?: string | null | undefined;
+  merchantAccountId?: string | null | undefined;
+  GiftCardIssuanceCreate: components.GiftCardIssuanceCreate$Outbound;
+};
+
+/** @internal */
+export const IssueGiftCardRequest$outboundSchema: z.ZodType<
+  IssueGiftCardRequest$Outbound,
+  z.ZodTypeDef,
+  IssueGiftCardRequest
+> = z.object({
+  idempotencyKey: z.nullable(z.string()).optional(),
+  merchantAccountId: z.nullable(z.string()).optional(),
+  giftCardIssuanceCreate: components.GiftCardIssuanceCreate$outboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    idempotencyKey: "idempotency-key",
+    giftCardIssuanceCreate: "GiftCardIssuanceCreate",
+  });
+});
+
+export function issueGiftCardRequestToJSON(
+  issueGiftCardRequest: IssueGiftCardRequest,
+): string {
+  return JSON.stringify(
+    IssueGiftCardRequest$outboundSchema.parse(issueGiftCardRequest),
+  );
+}

package/src/sdk/giftcards.ts

@@ -13,6 +13,7 @@ import { unwrapAsync } from "../types/fp.js";
 import { PageIterator, unwrapResultIterator } from "../types/operations.js";
 import { Activations } from "./activations.js";
 import { Balances } from "./balances.js";
+import { Issuances } from "./issuances.js";
 
 export class GiftCards extends ClientSDK {
   private _balances?: Balances;
@@ -25,6 +26,11 @@ export class GiftCards extends ClientSDK {
     return (this._activations ??= new Activations(this._options));
   }
 
+  private _issuances?: Issuances;
+  get issuances(): Issuances {
+    return (this._issuances ??= new Issuances(this._options));
+  }
+
   /**
    * Get gift card
    *

package/src/sdk/issuances.ts

@@ -0,0 +1,31 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { giftCardsIssuancesCreate } from "../funcs/giftCardsIssuancesCreate.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Issuances extends ClientSDK {
+  /**
+   * Issue a gift card
+   *
+   * @remarks
+   * Issue a new virtual gift card through the primary gift card service.
+   */
+  async create(
+    giftCardIssuanceCreate: components.GiftCardIssuanceCreate,
+    idempotencyKey?: string | null | undefined,
+    merchantAccountId?: string | null | undefined,
+    options?: RequestOptions,
+  ): Promise<components.GiftCardIssuance> {
+    return unwrapAsync(giftCardsIssuancesCreate(
+      this,
+      giftCardIssuanceCreate,
+      idempotencyKey,
+      merchantAccountId,
+      options,
+    ));
+  }
+}