@gr4vy/sdk 1.0.0-beta.21 → 1.0.0-beta.22

package/src/funcs/transactionsSync.ts

@@ -11,6 +11,7 @@ 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,
@@ -19,7 +20,7 @@ import {
   UnexpectedClientError,
 } from "../models/errors/httpclienterrors.js";
 import * as errors from "../models/errors/index.js";
-import { SDKError } from "../models/errors/sdkerror.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";
@@ -51,13 +52,14 @@ export function transactionsSync(
     | errors.Error500
     | errors.Error502
     | errors.Error504
-    | SDKError
-    | SDKValidationError
-    | UnexpectedClientError
-    | InvalidRequestError
+    | Gr4vyError
+    | ResponseValidationError
+    | ConnectionError
     | RequestAbortedError
     | RequestTimeoutError
-    | ConnectionError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
   >
 > {
   return new APIPromise($do(
@@ -89,13 +91,14 @@ async function $do(
       | errors.Error500
       | errors.Error502
       | errors.Error504
-      | SDKError
-      | SDKValidationError
-      | UnexpectedClientError
-      | InvalidRequestError
+      | Gr4vyError
+      | ResponseValidationError
+      | ConnectionError
       | RequestAbortedError
       | RequestTimeoutError
-      | ConnectionError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
     >,
     APICall,
   ]
@@ -212,13 +215,14 @@ async function $do(
     | errors.Error500
     | errors.Error502
     | errors.Error504
-    | SDKError
-    | SDKValidationError
-    | UnexpectedClientError
-    | InvalidRequestError
+    | Gr4vyError
+    | ResponseValidationError
+    | ConnectionError
     | RequestAbortedError
     | RequestTimeoutError
-    | ConnectionError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
   >(
     M.json(200, components.Transaction$inboundSchema),
     M.jsonErr(400, errors.Error400$inboundSchema),
@@ -235,7 +239,7 @@ async function $do(
     M.jsonErr(504, errors.Error504$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),
-  )(response, { extraFields: responseFields });
+  )(response, req, { extraFields: responseFields });
   if (!result.ok) {
     return [result, { status: "complete", request: req, response }];
   }

package/src/funcs/transactionsVoid.ts

@@ -11,6 +11,7 @@ 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,
@@ -19,7 +20,7 @@ import {
   UnexpectedClientError,
 } from "../models/errors/httpclienterrors.js";
 import * as errors from "../models/errors/index.js";
-import { SDKError } from "../models/errors/sdkerror.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";
@@ -51,13 +52,14 @@ export function transactionsVoid(
     | errors.Error500
     | errors.Error502
     | errors.Error504
-    | SDKError
-    | SDKValidationError
-    | UnexpectedClientError
-    | InvalidRequestError
+    | Gr4vyError
+    | ResponseValidationError
+    | ConnectionError
     | RequestAbortedError
     | RequestTimeoutError
-    | ConnectionError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
   >
 > {
   return new APIPromise($do(
@@ -89,13 +91,14 @@ async function $do(
       | errors.Error500
       | errors.Error502
       | errors.Error504
-      | SDKError
-      | SDKValidationError
-      | UnexpectedClientError
-      | InvalidRequestError
+      | Gr4vyError
+      | ResponseValidationError
+      | ConnectionError
       | RequestAbortedError
       | RequestTimeoutError
-      | ConnectionError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
     >,
     APICall,
   ]
@@ -212,13 +215,14 @@ async function $do(
     | errors.Error500
     | errors.Error502
     | errors.Error504
-    | SDKError
-    | SDKValidationError
-    | UnexpectedClientError
-    | InvalidRequestError
+    | Gr4vyError
+    | ResponseValidationError
+    | ConnectionError
     | RequestAbortedError
     | RequestTimeoutError
-    | ConnectionError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
   >(
     M.json(200, components.Transaction$inboundSchema),
     M.jsonErr(400, errors.Error400$inboundSchema),
@@ -235,7 +239,7 @@ async function $do(
     M.jsonErr(504, errors.Error504$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),
-  )(response, { extraFields: responseFields });
+  )(response, req, { extraFields: responseFields });
   if (!result.ok) {
     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: "1.0.0-beta.21",
-  genVersion: "2.621.3",
-  userAgent: "speakeasy-sdk/typescript 1.0.0-beta.21 2.621.3 1.0.0 @gr4vy/sdk",
+  sdkVersion: "1.0.0-beta.22",
+  genVersion: "2.629.1",
+  userAgent: "speakeasy-sdk/typescript 1.0.0-beta.22 2.629.1 1.0.0 @gr4vy/sdk",
 } as const;

package/src/lib/files.ts

@@ -38,3 +38,45 @@ export async function readableStreamToArrayBuffer(
 
   return concatenatedChunks.buffer as ArrayBuffer;
 }
+
+/**
+ * Determines the MIME content type based on a file's extension.
+ * Returns null if the extension is not recognized.
+ */
+export function getContentTypeFromFileName(fileName: string): string | null {
+  if (!fileName) return null;
+
+  const ext = fileName.toLowerCase().split(".").pop();
+  if (!ext) return null;
+
+  const mimeTypes: Record<string, string> = {
+    json: "application/json",
+    xml: "application/xml",
+    html: "text/html",
+    htm: "text/html",
+    txt: "text/plain",
+    csv: "text/csv",
+    pdf: "application/pdf",
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    svg: "image/svg+xml",
+    js: "application/javascript",
+    css: "text/css",
+    zip: "application/zip",
+    tar: "application/x-tar",
+    gz: "application/gzip",
+    mp4: "video/mp4",
+    mp3: "audio/mpeg",
+    wav: "audio/wav",
+    webp: "image/webp",
+    ico: "image/x-icon",
+    woff: "font/woff",
+    woff2: "font/woff2",
+    ttf: "font/ttf",
+    otf: "font/otf",
+  };
+
+  return mimeTypes[ext] || null;
+}

package/src/lib/matchers.ts

@@ -2,12 +2,11 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
 import { SDKError } from "../models/errors/sdkerror.js";
-import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
-import { Result } from "../types/fp.js";
+import { ERR, OK, Result } from "../types/fp.js";
 import { matchResponse, matchStatusCode, StatusCodePredicate } from "./http.js";
 import { isPlainObject } from "./is-plain-object.js";
-import { safeParse } from "./schemas.js";
 
 export type Encoding =
   | "jsonl"
@@ -176,17 +175,19 @@ export type MatchedError<Matchers> = Matchers extends Matcher<any, infer E>[]
   : never;
 export type MatchFunc<T, E> = (
   response: Response,
+  request: Request,
   options?: { resultKey?: string; extraFields?: Record<string, unknown> },
 ) => Promise<[result: Result<T, E>, raw: unknown]>;
 
 export function match<T, E>(
   ...matchers: Array<Matcher<T, E>>
-): MatchFunc<T, E | SDKError | SDKValidationError> {
+): MatchFunc<T, E | SDKError | ResponseValidationError> {
   return async function matchFunc(
     response: Response,
+    request: Request,
     options?: { resultKey?: string; extraFields?: Record<string, unknown> },
   ): Promise<
-    [result: Result<T, E | SDKError | SDKValidationError>, raw: unknown]
+    [result: Result<T, E | SDKError | ResponseValidationError>, raw: unknown]
   > {
     let raw: unknown;
     let matcher: Matcher<T, E> | undefined;
@@ -205,21 +206,22 @@ export function match<T, E>(
     }
 
     if (!matcher) {
-      const responseBody = await response.text();
       return [{
         ok: false,
-        error: new SDKError(
-          "Unexpected API response status or content-type",
+        error: new SDKError("Unexpected Status or Content-Type", {
           response,
-          responseBody,
-        ),
-      }, responseBody];
+          request,
+          body: await response.text().catch(() => ""),
+        }),
+      }, raw];
     }
 
     const encoding = matcher.enc;
+    let body = "";
     switch (encoding) {
       case "json":
-        raw = await response.json();
+        body = await response.text();
+        raw = JSON.parse(body);
         break;
       case "jsonl":
         raw = response.body;
@@ -231,16 +233,19 @@ export function match<T, E>(
         raw = response.body;
         break;
       case "text":
-        raw = await response.text();
+        body = await response.text();
+        raw = body;
         break;
       case "sse":
         raw = response.body;
         break;
       case "nil":
-        raw = await discardResponseBody(response);
+        body = await response.text();
+        raw = undefined;
         break;
       case "fail":
-        raw = await response.text();
+        body = await response.text();
+        raw = body;
         break;
       default:
         encoding satisfies never;
@@ -250,11 +255,7 @@ export function match<T, E>(
     if (matcher.enc === "fail") {
       return [{
         ok: false,
-        error: new SDKError(
-          "API error occurred",
-          response,
-          typeof raw === "string" ? raw : "",
-        ),
+        error: new SDKError("API error occurred", { request, response, body }),
       }, raw];
     }
 
@@ -266,6 +267,9 @@ export function match<T, E>(
         ...options?.extraFields,
         ...(matcher.hdrs ? { Headers: unpackHeaders(response.headers) } : null),
         ...(isPlainObject(raw) ? raw : null),
+        request$: request,
+        response$: response,
+        body$: body,
       };
     } else if (resultKey) {
       data = {
@@ -284,18 +288,20 @@ export function match<T, E>(
     }
 
     if ("err" in matcher) {
-      const result = safeParse(
+      const result = safeParseResponse(
         data,
         (v: unknown) => matcher.schema.parse(v),
         "Response validation failed",
+        { request, response, body },
       );
       return [result.ok ? { ok: false, error: result.value } : result, raw];
     } else {
       return [
-        safeParse(
+        safeParseResponse(
           data,
           (v: unknown) => matcher.schema.parse(v),
           "Response validation failed",
+          { request, response, body },
         ),
         raw,
       ];
@@ -318,25 +324,22 @@ export function unpackHeaders(headers: Headers): Record<string, string[]> {
   return out;
 }
 
-/**
- * Discards the response body to free up resources.
- *
- * To learn why this is need, see the undici docs:
- * https://undici.nodejs.org/#/?id=garbage-collection
- */
-export async function discardResponseBody(res: Response) {
-  const reader = res.body?.getReader();
-  if (reader == null) {
-    return;
-  }
-
+function safeParseResponse<Inp, Out>(
+  rawValue: Inp,
+  fn: (value: Inp) => Out,
+  errorMessage: string,
+  httpMeta: { response: Response; request: Request; body: string },
+): Result<Out, ResponseValidationError> {
   try {
-    let done = false;
-    while (!done) {
-      const res = await reader.read();
-      done = res.done;
-    }
-  } finally {
-    reader.releaseLock();
+    return OK(fn(rawValue));
+  } catch (err) {
+    return ERR(
+      new ResponseValidationError(errorMessage, {
+        cause: err,
+        rawValue,
+        rawMessage: errorMessage,
+        ...httpMeta,
+      }),
+    );
   }
 }

package/src/lib/security.ts

@@ -7,8 +7,8 @@ import { env } from "./env.js";
 
 type OAuth2PasswordFlow = {
   username: string;
-  password?: string | undefined;
-  clientID: string;
+  password: string;
+  clientID?: string | undefined;
   clientSecret?: string | undefined;
   tokenURL: string;
 };

package/src/models/components/index.ts

@@ -193,6 +193,7 @@ export * from "./transactionrefundcreate.js";
 export * from "./transactionretriesreportspec.js";
 export * from "./transactionsreportspec.js";
 export * from "./transactionstatus.js";
+export * from "./transactionstatussummary.js";
 export * from "./transactionsummaries.js";
 export * from "./transactionsummary.js";
 export * from "./transactionthreedsecuresummary.js";

package/src/models/components/transactionstatussummary.ts

@@ -0,0 +1,85 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  TransactionStatus,
+  TransactionStatus$inboundSchema,
+  TransactionStatus$outboundSchema,
+} from "./transactionstatus.js";
+
+export type TransactionStatusSummary = {
+  /**
+   * Always `transaction`.
+   */
+  type?: "transaction" | undefined;
+  /**
+   * The ID for the transaction.
+   */
+  id: string;
+  status: TransactionStatus;
+};
+
+/** @internal */
+export const TransactionStatusSummary$inboundSchema: z.ZodType<
+  TransactionStatusSummary,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  type: z.literal("transaction").default("transaction"),
+  id: z.string(),
+  status: TransactionStatus$inboundSchema,
+});
+
+/** @internal */
+export type TransactionStatusSummary$Outbound = {
+  type: "transaction";
+  id: string;
+  status: string;
+};
+
+/** @internal */
+export const TransactionStatusSummary$outboundSchema: z.ZodType<
+  TransactionStatusSummary$Outbound,
+  z.ZodTypeDef,
+  TransactionStatusSummary
+> = z.object({
+  type: z.literal("transaction").default("transaction" as const),
+  id: z.string(),
+  status: TransactionStatus$outboundSchema,
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace TransactionStatusSummary$ {
+  /** @deprecated use `TransactionStatusSummary$inboundSchema` instead. */
+  export const inboundSchema = TransactionStatusSummary$inboundSchema;
+  /** @deprecated use `TransactionStatusSummary$outboundSchema` instead. */
+  export const outboundSchema = TransactionStatusSummary$outboundSchema;
+  /** @deprecated use `TransactionStatusSummary$Outbound` instead. */
+  export type Outbound = TransactionStatusSummary$Outbound;
+}
+
+export function transactionStatusSummaryToJSON(
+  transactionStatusSummary: TransactionStatusSummary,
+): string {
+  return JSON.stringify(
+    TransactionStatusSummary$outboundSchema.parse(transactionStatusSummary),
+  );
+}
+
+export function transactionStatusSummaryFromJSON(
+  jsonString: string,
+): SafeParseResult<TransactionStatusSummary, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => TransactionStatusSummary$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'TransactionStatusSummary' from JSON`,
+  );
+}

package/src/models/errors/error400.ts

@@ -4,6 +4,7 @@
 
 import * as z from "zod";
 import * as components from "../components/index.js";
+import { Gr4vyError } from "./gr4vyerror.js";
 
 export type Error400Data = {
   /**
@@ -28,7 +29,7 @@ export type Error400Data = {
   details?: Array<components.ErrorDetail> | undefined;
 };
 
-export class Error400 extends Error {
+export class Error400 extends Gr4vyError {
   /**
    * Always `error`.
    */
@@ -49,13 +50,15 @@ export class Error400 extends Error {
   /** The original data that was passed to this error instance. */
   data$: Error400Data;
 
-  constructor(err: Error400Data) {
+  constructor(
+    err: Error400Data,
+    httpMeta: { response: Response; request: Request; body: string },
+  ) {
     const message = "message" in err && typeof err.message === "string"
       ? err.message
       : `API error occurred: ${JSON.stringify(err)}`;
-    super(message);
+    super(message, httpMeta);
     this.data$ = err;
-
     if (err.type != null) this.type = err.type;
     if (err.code != null) this.code = err.code;
     if (err.status != null) this.status = err.status;
@@ -76,9 +79,16 @@ export const Error400$inboundSchema: z.ZodType<
   status: z.number().int().default(400),
   message: z.string().default("Generic error"),
   details: z.array(components.ErrorDetail$inboundSchema).optional(),
+  request$: z.instanceof(Request),
+  response$: z.instanceof(Response),
+  body$: z.string(),
 })
   .transform((v) => {
-    return new Error400(v);
+    return new Error400(v, {
+      request: v.request$,
+      response: v.response$,
+      body: v.body$,
+    });
   });
 
 /** @internal */

package/src/models/errors/error401.ts

@@ -4,6 +4,7 @@
 
 import * as z from "zod";
 import * as components from "../components/index.js";
+import { Gr4vyError } from "./gr4vyerror.js";
 
 export type Error401Data = {
   /**
@@ -28,7 +29,7 @@ export type Error401Data = {
   details?: Array<components.ErrorDetail> | undefined;
 };
 
-export class Error401 extends Error {
+export class Error401 extends Gr4vyError {
   /**
    * Always `error`.
    */
@@ -49,13 +50,15 @@ export class Error401 extends Error {
   /** The original data that was passed to this error instance. */
   data$: Error401Data;
 
-  constructor(err: Error401Data) {
+  constructor(
+    err: Error401Data,
+    httpMeta: { response: Response; request: Request; body: string },
+  ) {
     const message = "message" in err && typeof err.message === "string"
       ? err.message
       : `API error occurred: ${JSON.stringify(err)}`;
-    super(message);
+    super(message, httpMeta);
     this.data$ = err;
-
     if (err.type != null) this.type = err.type;
     if (err.code != null) this.code = err.code;
     if (err.status != null) this.status = err.status;
@@ -76,9 +79,16 @@ export const Error401$inboundSchema: z.ZodType<
   status: z.number().int().default(401),
   message: z.string().default("No valid API authentication found"),
   details: z.array(components.ErrorDetail$inboundSchema).optional(),
+  request$: z.instanceof(Request),
+  response$: z.instanceof(Response),
+  body$: z.string(),
 })
   .transform((v) => {
-    return new Error401(v);
+    return new Error401(v, {
+      request: v.request$,
+      response: v.response$,
+      body: v.body$,
+    });
   });
 
 /** @internal */

package/src/models/errors/error403.ts

@@ -4,6 +4,7 @@
 
 import * as z from "zod";
 import * as components from "../components/index.js";
+import { Gr4vyError } from "./gr4vyerror.js";
 
 export type Error403Data = {
   /**
@@ -28,7 +29,7 @@ export type Error403Data = {
   details?: Array<components.ErrorDetail> | undefined;
 };
 
-export class Error403 extends Error {
+export class Error403 extends Gr4vyError {
   /**
    * Always `error`.
    */
@@ -49,13 +50,15 @@ export class Error403 extends Error {
   /** The original data that was passed to this error instance. */
   data$: Error403Data;
 
-  constructor(err: Error403Data) {
+  constructor(
+    err: Error403Data,
+    httpMeta: { response: Response; request: Request; body: string },
+  ) {
     const message = "message" in err && typeof err.message === "string"
       ? err.message
       : `API error occurred: ${JSON.stringify(err)}`;
-    super(message);
+    super(message, httpMeta);
     this.data$ = err;
-
     if (err.type != null) this.type = err.type;
     if (err.code != null) this.code = err.code;
     if (err.status != null) this.status = err.status;
@@ -76,9 +79,16 @@ export const Error403$inboundSchema: z.ZodType<
   status: z.number().int().default(403),
   message: z.string().default("Generic error"),
   details: z.array(components.ErrorDetail$inboundSchema).optional(),
+  request$: z.instanceof(Request),
+  response$: z.instanceof(Response),
+  body$: z.string(),
 })
   .transform((v) => {
-    return new Error403(v);
+    return new Error403(v, {
+      request: v.request$,
+      response: v.response$,
+      body: v.body$,
+    });
   });
 
 /** @internal */