@shippo/shippo-mcp 2.0.19 → 3.0.0

package/src/lib/retries.ts

@@ -1,218 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { isConnectionError, isTimeoutError } from "./http.js";
-
-export type BackoffStrategy = {
-  initialInterval: number;
-  maxInterval: number;
-  exponent: number;
-  maxElapsedTime: number;
-};
-
-const defaultBackoff: BackoffStrategy = {
-  initialInterval: 500,
-  maxInterval: 60000,
-  exponent: 1.5,
-  maxElapsedTime: 3600000,
-};
-
-export type RetryConfig =
-  | { strategy: "none" }
-  | {
-      strategy: "backoff";
-      backoff?: BackoffStrategy;
-      retryConnectionErrors?: boolean;
-    };
-
-/**
- * PermanentError is an error that is not recoverable. Throwing this error will
- * cause a retry loop to terminate.
- */
-export class PermanentError extends Error {
-  /** The underlying cause of the error. */
-  override readonly cause: unknown;
-
-  constructor(message: string, options?: { cause?: unknown }) {
-    let msg = message;
-    if (options?.cause) {
-      msg += `: ${options.cause}`;
-    }
-
-    super(msg, options);
-    this.name = "PermanentError";
-    // In older runtimes, the cause field would not have been assigned through
-    // the super() call.
-    if (typeof this.cause === "undefined") {
-      this.cause = options?.cause;
-    }
-
-    Object.setPrototypeOf(this, PermanentError.prototype);
-  }
-}
-
-/**
- * TemporaryError is an error is used to signal that an HTTP request can be
- * retried as part of a retry loop. If retry attempts are exhausted and this
- * error is thrown, the response will be returned to the caller.
- */
-export class TemporaryError extends Error {
-  response: Response;
-
-  constructor(message: string, response: Response) {
-    super(message);
-    this.response = response;
-    this.name = "TemporaryError";
-
-    Object.setPrototypeOf(this, TemporaryError.prototype);
-  }
-}
-
-export async function retry(
-  fetchFn: () => Promise<Response>,
-  options: {
-    config: RetryConfig;
-    statusCodes: string[];
-  },
-): Promise<Response> {
-  switch (options.config.strategy) {
-    case "backoff":
-      return retryBackoff(
-        wrapFetcher(fetchFn, {
-          statusCodes: options.statusCodes,
-          retryConnectionErrors: !!options.config.retryConnectionErrors,
-        }),
-        options.config.backoff ?? defaultBackoff,
-      );
-    default:
-      return await fetchFn();
-  }
-}
-
-function wrapFetcher(
-  fn: () => Promise<Response>,
-  options: {
-    statusCodes: string[];
-    retryConnectionErrors: boolean;
-  },
-): () => Promise<Response> {
-  return async () => {
-    try {
-      const res = await fn();
-      if (isRetryableResponse(res, options.statusCodes)) {
-        throw new TemporaryError(
-          "Response failed with retryable status code",
-          res,
-        );
-      }
-
-      return res;
-    } catch (err: unknown) {
-      if (err instanceof TemporaryError) {
-        throw err;
-      }
-
-      if (
-        options.retryConnectionErrors &&
-        (isTimeoutError(err) || isConnectionError(err))
-      ) {
-        throw err;
-      }
-
-      throw new PermanentError("Permanent error", { cause: err });
-    }
-  };
-}
-
-const codeRangeRE = new RegExp("^[0-9]xx$", "i");
-
-function isRetryableResponse(res: Response, statusCodes: string[]): boolean {
-  const actual = `${res.status}`;
-
-  return statusCodes.some((code) => {
-    if (!codeRangeRE.test(code)) {
-      return code === actual;
-    }
-
-    const expectFamily = code.charAt(0);
-    if (!expectFamily) {
-      throw new Error("Invalid status code range");
-    }
-
-    const actualFamily = actual.charAt(0);
-    if (!actualFamily) {
-      throw new Error(`Invalid response status code: ${actual}`);
-    }
-
-    return actualFamily === expectFamily;
-  });
-}
-
-async function retryBackoff(
-  fn: () => Promise<Response>,
-  strategy: BackoffStrategy,
-): Promise<Response> {
-  const { maxElapsedTime, initialInterval, exponent, maxInterval } = strategy;
-
-  const start = Date.now();
-  let x = 0;
-
-  while (true) {
-    try {
-      const res = await fn();
-      return res;
-    } catch (err: unknown) {
-      if (err instanceof PermanentError) {
-        throw err.cause;
-      }
-      const elapsed = Date.now() - start;
-      if (elapsed > maxElapsedTime) {
-        if (err instanceof TemporaryError) {
-          return err.response;
-        }
-
-        throw err;
-      }
-
-      let retryInterval = 0;
-      if (err instanceof TemporaryError) {
-        retryInterval = retryIntervalFromResponse(err.response);
-      }
-
-      if (retryInterval <= 0) {
-        retryInterval =
-          initialInterval * Math.pow(x, exponent) + Math.random() * 1000;
-      }
-
-      const d = Math.min(retryInterval, maxInterval);
-
-      await delay(d);
-      x++;
-    }
-  }
-}
-
-function retryIntervalFromResponse(res: Response): number {
-  const retryVal = res.headers.get("retry-after") || "";
-  if (!retryVal) {
-    return 0;
-  }
-
-  const parsedNumber = Number(retryVal);
-  if (Number.isInteger(parsedNumber)) {
-    return parsedNumber * 1000;
-  }
-
-  const parsedDate = Date.parse(retryVal);
-  if (Number.isInteger(parsedDate)) {
-    const deltaMS = parsedDate - Date.now();
-    return deltaMS > 0 ? Math.ceil(deltaMS) : 0;
-  }
-
-  return 0;
-}
-
-async function delay(delay: number): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, delay));
-}

package/src/lib/schemas.ts

@@ -1,79 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import * as z from "zod";
-import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
-import { ERR, OK, Result } from "../types/fp.js";
-
-export function collectExtraKeys<
-  Shape extends z.ZodRawShape,
-  Catchall extends z.ZodType,
-  K extends string,
-  Optional extends boolean,
->(
-  obj: z.ZodObject<Shape, z.core.$catchall<Catchall>>,
-  extrasKey: K,
-  optional: Optional,
-) {
-  return obj.transform((val: any) => {
-    const extras: Record<string, z.output<Catchall>> = {};
-    const { shape } = obj;
-    for (const [key] of Object.entries(val)) {
-      if (key in shape) {
-        continue;
-      }
-
-      const v = val[key];
-      if (typeof v === "undefined") {
-        continue;
-      }
-
-      extras[key] = v;
-      delete val[key];
-    }
-
-    if (optional && Object.keys(extras).length === 0) {
-      return val;
-    }
-
-    return { ...val, [extrasKey]: extras };
-  });
-}
-
-/**
- * Utility function that executes some code which may throw a ZodError. It
- * intercepts this error and converts it to an SDKValidationError so as to not
- * leak Zod implementation details to user code.
- */
-export function parse<Inp, Out>(
-  rawValue: Inp,
-  fn: (value: Inp) => Out,
-  errorMessage: string,
-): Out {
-  try {
-    return fn(rawValue);
-  } catch (err) {
-    if (err instanceof z.ZodError) {
-      throw new SDKValidationError(errorMessage, err, rawValue);
-    }
-    throw err;
-  }
-}
-
-/**
- * Utility function that executes some code which may result in a ZodError. It
- * intercepts this error and converts it to an SDKValidationError so as to not
- * leak Zod implementation details to user code.
- */
-export function safeParse<Inp, Out>(
-  rawValue: Inp,
-  fn: (value: Inp) => Out,
-  errorMessage: string,
-): Result<Out, SDKValidationError> {
-  try {
-    return OK(fn(rawValue));
-  } catch (err) {
-    return ERR(new SDKValidationError(errorMessage, err, rawValue));
-  }
-}

package/src/lib/sdks.ts

@@ -1,405 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { SDKHooks } from "../hooks/hooks.js";
-import { HookContext } from "../hooks/types.js";
-import {
-  ConnectionError,
-  InvalidRequestError,
-  RequestAbortedError,
-  RequestTimeoutError,
-  UnexpectedClientError,
-} from "../models/errors/httpclienterrors.js";
-import { stringToBase64 } from "./base64.js";
-import { SDK_METADATA, SDKOptions, serverURLFromOptions } from "./config.js";
-import { encodeForm } from "./encodings.js";
-import {
-  HTTPClient,
-  isAbortError,
-  isConnectionError,
-  isTimeoutError,
-  matchContentType,
-  matchStatusCode,
-} from "./http.js";
-import { Logger } from "./logger.js";
-import { ERR, OK, Result } from "./result.js";
-import { retry, RetryConfig } from "./retries.js";
-import { SecurityState } from "./security.js";
-
-export type RequestOptions = {
-  /**
-   * Sets a timeout, in milliseconds, on HTTP requests made by an SDK method. If
-   * `fetchOptions.signal` is set then it will take precedence over this option.
-   */
-  timeoutMs?: number;
-  /**
-   * Set or override a retry policy on HTTP calls.
-   */
-  retries?: RetryConfig;
-  /**
-   * Specifies the status codes which should be retried using the given retry policy.
-   */
-  retryCodes?: string[];
-  /**
-   * Overrides the base server URL that will be used by an operation.
-   */
-  serverURL?: string | URL;
-  /**
-   * @deprecated `fetchOptions` has been flattened into `RequestOptions`.
-   *
-   * Sets various request options on the `fetch` call made by an SDK method.
-   *
-   * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options|Request}
-   */
-  fetchOptions?: Omit<RequestInit, "method" | "body">;
-} & Omit<RequestInit, "method" | "body">;
-
-type RequestConfig = {
-  method: string;
-  path: string;
-  baseURL?: string | URL | undefined;
-  query?: string;
-  body?: RequestInit["body"];
-  headers?: HeadersInit;
-  security?: SecurityState | null;
-  uaHeader?: string;
-  userAgent?: string | undefined;
-  timeoutMs?: number;
-};
-
-const gt: unknown = typeof globalThis === "undefined" ? null : globalThis;
-const webWorkerLike = typeof gt === "object"
-  && gt != null
-  && "importScripts" in gt
-  && typeof gt["importScripts"] === "function";
-const isBrowserLike = webWorkerLike
-  || (typeof navigator !== "undefined" && "serviceWorker" in navigator)
-  || (typeof window === "object" && typeof window.document !== "undefined");
-
-export class ClientSDK {
-  readonly #httpClient: HTTPClient;
-  readonly #hooks: SDKHooks;
-  readonly #logger?: Logger | undefined;
-  public readonly _baseURL: URL | null;
-  public readonly _options: SDKOptions & { hooks?: SDKHooks };
-
-  constructor(options: SDKOptions = {}) {
-    const opt = options as unknown;
-    if (
-      typeof opt === "object"
-      && opt != null
-      && "hooks" in opt
-      && opt.hooks instanceof SDKHooks
-    ) {
-      this.#hooks = opt.hooks;
-    } else {
-      this.#hooks = new SDKHooks();
-    }
-    const defaultHttpClient = new HTTPClient();
-    options.httpClient = options.httpClient || defaultHttpClient;
-    options = this.#hooks.sdkInit(options);
-
-    const url = serverURLFromOptions(options);
-    if (url) {
-      url.pathname = url.pathname.replace(/\/+$/, "") + "/";
-    }
-    this._baseURL = url;
-    this.#httpClient = options.httpClient || defaultHttpClient;
-
-    this._options = { ...options, hooks: this.#hooks };
-
-    this.#logger = this._options.debugLogger;
-  }
-
-  public _createRequest(
-    context: HookContext,
-    conf: RequestConfig,
-    options?: RequestOptions,
-  ): Result<Request, InvalidRequestError | UnexpectedClientError> {
-    const { method, path, query, headers: opHeaders, security } = conf;
-
-    const base = conf.baseURL ?? this._baseURL;
-    if (!base) {
-      return ERR(new InvalidRequestError("No base URL provided for operation"));
-    }
-    const reqURL = new URL(base);
-    const inputURL = new URL(path, reqURL);
-
-    if (path) {
-      reqURL.pathname += reqURL.pathname.endsWith("/") ? "" : "/";
-      reqURL.pathname += inputURL.pathname.replace(/^\/+/, "");
-    }
-
-    let finalQuery = query || "";
-
-    const secQuery: string[] = [];
-    for (const [k, v] of Object.entries(security?.queryParams || {})) {
-      const q = encodeForm(k, v, { charEncoding: "percent" });
-      if (typeof q !== "undefined") {
-        secQuery.push(q);
-      }
-    }
-    if (secQuery.length) {
-      finalQuery += `&${secQuery.join("&")}`;
-    }
-
-    if (finalQuery) {
-      const q = finalQuery.startsWith("&") ? finalQuery.slice(1) : finalQuery;
-      reqURL.search = `?${q}`;
-    }
-
-    const headers = new Headers(opHeaders);
-
-    const username = security?.basic.username;
-    const password = security?.basic.password;
-    if (username != null || password != null) {
-      const encoded = stringToBase64(
-        [username || "", password || ""].join(":"),
-      );
-      headers.set("Authorization", `Basic ${encoded}`);
-    }
-
-    const securityHeaders = new Headers(security?.headers || {});
-    for (const [k, v] of securityHeaders) {
-      headers.set(k, v);
-    }
-
-    let cookie = headers.get("cookie") || "";
-    for (const [k, v] of Object.entries(security?.cookies || {})) {
-      cookie += `; ${k}=${v}`;
-    }
-    cookie = cookie.startsWith("; ") ? cookie.slice(2) : cookie;
-    headers.set("cookie", cookie);
-
-    const userHeaders = new Headers(
-      options?.headers ?? options?.fetchOptions?.headers,
-    );
-    for (const [k, v] of userHeaders) {
-      headers.set(k, v);
-    }
-
-    // Only set user agent header in non-browser-like environments since CORS
-    // policy disallows setting it in browsers e.g. Chrome throws an error.
-    if (!isBrowserLike) {
-      headers.set(
-        conf.uaHeader ?? "user-agent",
-        conf.userAgent ?? SDK_METADATA.userAgent,
-      );
-    }
-
-    const fetchOptions: Omit<RequestInit, "method" | "body"> = {
-      ...options?.fetchOptions,
-      ...options,
-    };
-    if (!fetchOptions?.signal && conf.timeoutMs && conf.timeoutMs > 0) {
-      const timeoutSignal = AbortSignal.timeout(conf.timeoutMs);
-      fetchOptions.signal = timeoutSignal;
-    }
-
-    if (conf.body instanceof ReadableStream) {
-      Object.assign(fetchOptions, { duplex: "half" });
-    }
-
-    let input;
-    try {
-      input = this.#hooks.beforeCreateRequest(context, {
-        url: reqURL,
-        options: {
-          ...fetchOptions,
-          body: conf.body ?? null,
-          headers,
-          method,
-        },
-      });
-    } catch (err: unknown) {
-      return ERR(
-        new UnexpectedClientError("Create request hook failed to execute", {
-          cause: err,
-        }),
-      );
-    }
-
-    return OK(new Request(input.url, input.options));
-  }
-
-  public async _do(
-    request: Request,
-    options: {
-      context: HookContext;
-      errorCodes: number | string | (number | string)[];
-      retryConfig: RetryConfig;
-      retryCodes: string[];
-    },
-  ): Promise<
-    Result<
-      Response,
-      | RequestAbortedError
-      | RequestTimeoutError
-      | ConnectionError
-      | UnexpectedClientError
-    >
-  > {
-    const { context, errorCodes } = options;
-
-    return retry(
-      async () => {
-        const req = await this.#hooks.beforeRequest(
-          context,
-          request.clone() as Request,
-        );
-        await logRequest(this.#logger, req).catch((e) =>
-          this.#logger?.log("Failed to log request:", e)
-        );
-
-        let response = await this.#httpClient.request(req);
-
-        try {
-          if (matchStatusCode(response, errorCodes)) {
-            const result = await this.#hooks.afterError(
-              context,
-              response,
-              null,
-            );
-            if (result.error) {
-              throw result.error;
-            }
-            response = result.response || response;
-          } else {
-            response = await this.#hooks.afterSuccess(context, response);
-          }
-        } finally {
-          await logResponse(this.#logger, response, req)
-            .catch(e => this.#logger?.log("Failed to log response:", e));
-        }
-
-        return response;
-      },
-      { config: options.retryConfig, statusCodes: options.retryCodes },
-    ).then(
-      (r) => OK(r),
-      (err) => {
-        switch (true) {
-          case isAbortError(err):
-            return ERR(
-              new RequestAbortedError("Request aborted by client", {
-                cause: err,
-              }),
-            );
-          case isTimeoutError(err):
-            return ERR(
-              new RequestTimeoutError("Request timed out", { cause: err }),
-            );
-          case isConnectionError(err):
-            return ERR(
-              new ConnectionError("Unable to make request", { cause: err }),
-            );
-          default:
-            return ERR(
-              new UnexpectedClientError("Unexpected HTTP client error", {
-                cause: err,
-              }),
-            );
-        }
-      },
-    );
-  }
-}
-
-const jsonLikeContentTypeRE = /(application|text)\/.*?\+*json.*/;
-const jsonlLikeContentTypeRE =
-  /(application|text)\/(.*?\+*\bjsonl\b.*|.*?\+*\bx-ndjson\b.*)/;
-async function logRequest(logger: Logger | undefined, req: Request) {
-  if (!logger) {
-    return;
-  }
-
-  const contentType = req.headers.get("content-type");
-  const ct = contentType?.split(";")[0] || "";
-
-  logger.group(`> Request: ${req.method} ${req.url}`);
-
-  logger.group("Headers:");
-  for (const [k, v] of req.headers.entries()) {
-    logger.log(`${k}: ${v}`);
-  }
-  logger.groupEnd();
-
-  logger.group("Body:");
-  switch (true) {
-    case jsonLikeContentTypeRE.test(ct):
-      logger.log(await req.clone().json());
-      break;
-    case ct.startsWith("text/"):
-      logger.log(await req.clone().text());
-      break;
-    case ct === "multipart/form-data": {
-      const body = await req.clone().formData();
-      for (const [k, v] of body) {
-        const vlabel = v instanceof Blob ? "<Blob>" : v;
-        logger.log(`${k}: ${vlabel}`);
-      }
-      break;
-    }
-    default:
-      logger.log(`<${contentType}>`);
-      break;
-  }
-  logger.groupEnd();
-
-  logger.groupEnd();
-}
-
-async function logResponse(
-  logger: Logger | undefined,
-  res: Response,
-  req: Request,
-) {
-  if (!logger) {
-    return;
-  }
-
-  const contentType = res.headers.get("content-type");
-  const ct = contentType?.split(";")[0] || "";
-
-  logger.group(`< Response: ${req.method} ${req.url}`);
-  logger.log("Status Code:", res.status, res.statusText);
-
-  logger.group("Headers:");
-  for (const [k, v] of res.headers.entries()) {
-    logger.log(`${k}: ${v}`);
-  }
-  logger.groupEnd();
-
-  logger.group("Body:");
-  switch (true) {
-    case matchContentType(res, "application/json")
-      || jsonLikeContentTypeRE.test(ct) && !jsonlLikeContentTypeRE.test(ct):
-      logger.log(await res.clone().json());
-      break;
-    case matchContentType(res, "application/jsonl")
-      || jsonlLikeContentTypeRE.test(ct):
-      logger.log(await res.clone().text());
-      break;
-    case matchContentType(res, "text/event-stream"):
-      logger.log(`<${contentType}>`);
-      break;
-    case matchContentType(res, "text/*"):
-      logger.log(await res.clone().text());
-      break;
-    case matchContentType(res, "multipart/form-data"): {
-      const body = await res.clone().formData();
-      for (const [k, v] of body) {
-        const vlabel = v instanceof Blob ? "<Blob>" : v;
-        logger.log(`${k}: ${vlabel}`);
-      }
-      break;
-    }
-    default:
-      logger.log(`<${contentType}>`);
-      break;
-  }
-  logger.groupEnd();
-
-  logger.groupEnd();
-}