@mutagent/sdk 0.4.3 → 0.5.0

package/src/lib/encodings.ts

@@ -1,564 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { bytesToBase64 } from "./base64.js";
-import { isPlainObject } from "./primitives.js";
-
-export class EncodingError extends Error {
-  constructor(message: string) {
-    super(message);
-    this.name = "EncodingError";
-  }
-}
-
-export type CharEncoding = "percent" | "percentExceptReserved" | "none";
-
-const reservedEscapes = /%(2[346bcf]|3[abdf]|40|5[bd])/gi;
-
-function encodeKeyChars(
-  v: string,
-  charEncoding: CharEncoding | undefined,
-): string {
-  return encodeChars(
-    v,
-    charEncoding === "percentExceptReserved" ? "percent" : charEncoding,
-  );
-}
-
-function encodeChars(
-  v: string,
-  charEncoding: CharEncoding | undefined,
-): string {
-  switch (charEncoding) {
-    case "percent":
-      return encodeURIComponent(v);
-    case "percentExceptReserved":
-      return encodeURIComponent(v).replace(
-        reservedEscapes,
-        (m) => decodeURIComponent(m),
-      );
-    default:
-      return v;
-  }
-}
-
-export function encodeMatrix(
-  key: string,
-  value: unknown,
-  options?: { explode?: boolean; charEncoding?: CharEncoding },
-): string | undefined {
-  let out = "";
-  const pairs: [string, unknown][] = options?.explode
-    ? explode(key, value)
-    : [[key, value]];
-
-  if (pairs.every(([_, v]) => v == null)) {
-    return;
-  }
-
-  const encodeString = (v: string) => {
-    return encodeChars(v, options?.charEncoding);
-  };
-  const encodeValue = (v: unknown) => encodeString(serializeValue(v));
-
-  pairs.forEach(([pk, pv]) => {
-    let tmp = "";
-    let encValue: string | null | undefined = null;
-
-    if (pv == null) {
-      return;
-    } else if (Array.isArray(pv)) {
-      encValue = mapDefined(pv, (v) => `${encodeValue(v)}`)?.join(",");
-    } else if (isPlainObject(pv)) {
-      const mapped = mapDefinedEntries(Object.entries(pv), ([k, v]) => {
-        return `,${encodeString(k)},${encodeValue(v)}`;
-      });
-      encValue = mapped?.join("").slice(1);
-    } else {
-      encValue = `${encodeValue(pv)}`;
-    }
-
-    if (encValue == null) {
-      return;
-    }
-
-    const keyPrefix = encodeKeyChars(pk, options?.charEncoding);
-    tmp = `${keyPrefix}=${encValue}`;
-    // trim trailing '=' if value was empty
-    if (tmp === `${keyPrefix}=`) {
-      tmp = tmp.slice(0, -1);
-    }
-
-    // If we end up with the nothing then skip forward
-    if (!tmp) {
-      return;
-    }
-
-    out += `;${tmp}`;
-  });
-
-  return out;
-}
-
-export function encodeLabel(
-  key: string,
-  value: unknown,
-  options?: { explode?: boolean; charEncoding?: CharEncoding },
-): string | undefined {
-  let out = "";
-  const pairs: [string, unknown][] = options?.explode
-    ? explode(key, value)
-    : [[key, value]];
-
-  if (pairs.every(([_, v]) => v == null)) {
-    return;
-  }
-
-  const encodeString = (v: string) => {
-    return encodeChars(v, options?.charEncoding);
-  };
-  const encodeValue = (v: unknown) => encodeString(serializeValue(v));
-
-  pairs.forEach(([pk, pv]) => {
-    let encValue: string | null | undefined = "";
-
-    if (pv == null) {
-      return;
-    } else if (Array.isArray(pv)) {
-      encValue = mapDefined(pv, (v) => `${encodeValue(v)}`)?.join(".");
-    } else if (isPlainObject(pv)) {
-      const mapped = mapDefinedEntries(Object.entries(pv), ([k, v]) => {
-        return `.${encodeString(k)}.${encodeValue(v)}`;
-      });
-      encValue = mapped?.join("").slice(1);
-    } else {
-      const k = options?.explode && isPlainObject(value)
-        ? `${encodeKeyChars(pk, options?.charEncoding)}=`
-        : "";
-      encValue = `${k}${encodeValue(pv)}`;
-    }
-
-    out += encValue == null ? "" : `.${encValue}`;
-  });
-
-  return out;
-}
-
-type FormEncoder = (
-  key: string,
-  value: unknown,
-  options?: { explode?: boolean; charEncoding?: CharEncoding },
-) => string | undefined;
-
-function formEncoder(sep: string): FormEncoder {
-  return (
-    key: string,
-    value: unknown,
-    options?: { explode?: boolean; charEncoding?: CharEncoding },
-  ) => {
-    let out = "";
-    const pairs: [string, unknown][] = options?.explode
-      ? explode(key, value)
-      : [[key, value]];
-
-    if (pairs.every(([_, v]) => v == null)) {
-      return;
-    }
-
-    const encodeString = (v: string) => {
-      return encodeChars(v, options?.charEncoding);
-    };
-
-    const encodeValue = (v: unknown) => encodeString(serializeValue(v));
-
-    const encodedSep = encodeString(sep);
-
-    pairs.forEach(([pk, pv]) => {
-      let tmp = "";
-      let encValue: string | null | undefined = null;
-
-      if (pv == null) {
-        return;
-      } else if (Array.isArray(pv)) {
-        encValue = mapDefined(pv, (v) => `${encodeValue(v)}`)?.join(encodedSep);
-      } else if (isPlainObject(pv)) {
-        encValue = mapDefinedEntries(Object.entries(pv), ([k, v]) => {
-          return `${encodeString(k)}${encodedSep}${encodeValue(v)}`;
-        })?.join(encodedSep);
-      } else {
-        encValue = `${encodeValue(pv)}`;
-      }
-
-      if (encValue == null) {
-        return;
-      }
-
-      tmp = `${encodeKeyChars(pk, options?.charEncoding)}=${encValue}`;
-
-      // If we end up with the nothing then skip forward
-      if (!tmp || tmp === "=") {
-        return;
-      }
-
-      out += `&${tmp}`;
-    });
-
-    return out.slice(1);
-  };
-}
-
-export const encodeForm = formEncoder(",");
-export const encodeSpaceDelimited = formEncoder(" ");
-export const encodePipeDelimited = formEncoder("|");
-
-export function encodeBodyForm(
-  key: string,
-  value: unknown,
-  options?: { explode?: boolean; charEncoding?: CharEncoding },
-): string {
-  let out = "";
-  const pairs: [string, unknown][] = options?.explode
-    ? explode(key, value)
-    : [[key, value]];
-
-  const encodeString = (v: string) => {
-    return encodeChars(v, options?.charEncoding);
-  };
-
-  const encodeValue = (v: unknown) => encodeString(serializeValue(v));
-
-  pairs.forEach(([pk, pv]) => {
-    let tmp = "";
-    let encValue = "";
-
-    if (pv == null) {
-      return;
-    } else if (Array.isArray(pv)) {
-      encValue = JSON.stringify(pv, jsonReplacer);
-    } else if (isPlainObject(pv)) {
-      encValue = JSON.stringify(pv, jsonReplacer);
-    } else {
-      encValue = `${encodeValue(pv)}`;
-    }
-
-    tmp = `${encodeKeyChars(pk, options?.charEncoding)}=${encValue}`;
-
-    // If we end up with the nothing then skip forward
-    if (!tmp || tmp === "=") {
-      return;
-    }
-
-    out += `&${tmp}`;
-  });
-
-  return out.slice(1);
-}
-
-export function encodeDeepObject(
-  key: string,
-  value: unknown,
-  options?: { charEncoding?: CharEncoding },
-): string | undefined {
-  if (value == null) {
-    return;
-  }
-
-  if (!isPlainObject(value)) {
-    throw new EncodingError(
-      `Value of parameter '${key}' which uses deepObject encoding must be an object or null`,
-    );
-  }
-
-  return encodeDeepObjectObject(key, value, options);
-}
-
-export function encodeDeepObjectObject(
-  key: string,
-  value: unknown,
-  options?: { charEncoding?: CharEncoding },
-): string | undefined {
-  if (value == null) {
-    return;
-  }
-
-  let out = "";
-
-  const encodeString = (v: string) => {
-    return encodeChars(v, options?.charEncoding);
-  };
-
-  if (!isPlainObject(value)) {
-    throw new EncodingError(`Expected parameter '${key}' to be an object.`);
-  }
-
-  Object.entries(value).forEach(([ck, cv]) => {
-    if (cv == null) {
-      return;
-    }
-
-    const pk = `${key}[${ck}]`;
-
-    if (isPlainObject(cv)) {
-      const objOut = encodeDeepObjectObject(pk, cv, options);
-
-      out += objOut == null ? "" : `&${objOut}`;
-
-      return;
-    }
-
-    const pairs: unknown[] = Array.isArray(cv) ? cv : [cv];
-    const encoded = mapDefined(pairs, (v) => {
-      return `${encodeKeyChars(pk, options?.charEncoding)}=${
-        encodeString(serializeValue(v))
-      }`;
-    })?.join("&");
-
-    out += encoded == null ? "" : `&${encoded}`;
-  });
-
-  return out.slice(1);
-}
-
-export function encodeJSON(
-  key: string,
-  value: unknown,
-  options?: { explode?: boolean; charEncoding?: CharEncoding },
-): string | undefined {
-  if (typeof value === "undefined") {
-    return;
-  }
-
-  const encodeString = (v: string) => {
-    return encodeChars(v, options?.charEncoding);
-  };
-
-  const encVal = encodeString(JSON.stringify(value, jsonReplacer));
-
-  return options?.explode
-    ? encVal
-    : `${encodeKeyChars(key, options?.charEncoding)}=${encVal}`;
-}
-
-export const encodeSimple = (
-  key: string,
-  value: unknown,
-  options?: { explode?: boolean; charEncoding?: CharEncoding },
-): string | undefined => {
-  let out = "";
-  const pairs: [string, unknown][] = options?.explode
-    ? explode(key, value)
-    : [[key, value]];
-
-  if (pairs.every(([_, v]) => v == null)) {
-    return;
-  }
-
-  const encodeString = (v: string) => {
-    return encodeChars(v, options?.charEncoding);
-  };
-  const encodeValue = (v: unknown) => encodeString(serializeValue(v));
-
-  pairs.forEach(([pk, pv]) => {
-    let tmp: string | null | undefined = "";
-
-    if (pv == null) {
-      return;
-    } else if (Array.isArray(pv)) {
-      tmp = mapDefined(pv, (v) => `${encodeValue(v)}`)?.join(",");
-    } else if (isPlainObject(pv)) {
-      const mapped = mapDefinedEntries(Object.entries(pv), ([k, v]) => {
-        return `,${encodeString(k)},${encodeValue(v)}`;
-      });
-      tmp = mapped?.join("").slice(1);
-    } else {
-      const k = options?.explode && isPlainObject(value) ? `${pk}=` : "";
-      tmp = `${k}${encodeValue(pv)}`;
-    }
-
-    out += tmp ? `,${tmp}` : "";
-  });
-
-  return out.slice(1);
-};
-
-function explode(key: string, value: unknown): [string, unknown][] {
-  if (Array.isArray(value)) {
-    return value.map((v) => [key, v]);
-  } else if (isPlainObject(value)) {
-    const o = value ?? {};
-    return Object.entries(o).map(([k, v]) => [k, v]);
-  } else {
-    return [[key, value]];
-  }
-}
-
-function serializeValue(value: unknown): string {
-  if (value == null) {
-    return "";
-  } else if (value instanceof Date) {
-    return value.toISOString();
-  } else if (value instanceof Uint8Array) {
-    return bytesToBase64(value);
-  } else if (typeof value === "object") {
-    return JSON.stringify(value, jsonReplacer);
-  }
-
-  return `${value}`;
-}
-
-function jsonReplacer(_: string, value: unknown): unknown {
-  if (value instanceof Uint8Array) {
-    return bytesToBase64(value);
-  } else {
-    return value;
-  }
-}
-
-function mapDefined<T, R>(inp: T[], mapper: (v: T) => R): R[] | null {
-  const res = inp.reduce<R[]>((acc, v) => {
-    if (v == null) {
-      return acc;
-    }
-
-    const m = mapper(v);
-    if (m == null) {
-      return acc;
-    }
-
-    acc.push(m);
-
-    return acc;
-  }, []);
-
-  return res.length ? res : null;
-}
-
-function mapDefinedEntries<K, V, R>(
-  inp: Iterable<[K, V]>,
-  mapper: (v: [K, V]) => R,
-): R[] | null {
-  const acc: R[] = [];
-  for (const [k, v] of inp) {
-    if (v == null) {
-      continue;
-    }
-
-    const m = mapper([k, v]);
-    if (m == null) {
-      continue;
-    }
-
-    acc.push(m);
-  }
-
-  return acc.length ? acc : null;
-}
-
-export function queryJoin(...args: (string | undefined)[]): string {
-  return args.filter(Boolean).join("&");
-}
-
-type QueryEncoderOptions = {
-  explode?: boolean;
-  charEncoding?: CharEncoding;
-  allowEmptyValue?: string[];
-};
-
-type QueryEncoder = (
-  key: string,
-  value: unknown,
-  options?: QueryEncoderOptions,
-) => string | undefined;
-
-type BulkQueryEncoder = (
-  values: Record<string, unknown>,
-  options?: QueryEncoderOptions,
-) => string;
-
-export function queryEncoder(f: QueryEncoder): BulkQueryEncoder {
-  const bulkEncode = function(
-    values: Record<string, unknown>,
-    options?: QueryEncoderOptions,
-  ): string {
-    const opts: QueryEncoderOptions = {
-      ...options,
-      explode: options?.explode ?? true,
-      charEncoding: options?.charEncoding ?? "percent",
-    };
-
-    const allowEmptySet = new Set(options?.allowEmptyValue ?? []);
-
-    const encoded = Object.entries(values).map(([key, value]) => {
-      if (allowEmptySet.has(key)) {
-        if (
-          value === undefined
-          || value === null
-          || value === ""
-          || (Array.isArray(value) && value.length === 0)
-        ) {
-          return `${encodeURIComponent(key)}=`;
-        }
-      }
-      return f(key, value, opts);
-    });
-    return queryJoin(...encoded);
-  };
-
-  return bulkEncode;
-}
-
-export const encodeJSONQuery = queryEncoder(encodeJSON);
-export const encodeFormQuery = queryEncoder(encodeForm);
-export const encodeSpaceDelimitedQuery = queryEncoder(encodeSpaceDelimited);
-export const encodePipeDelimitedQuery = queryEncoder(encodePipeDelimited);
-export const encodeDeepObjectQuery = queryEncoder(encodeDeepObject);
-
-function isBlobLike(val: unknown): val is Blob {
-  if (val instanceof Blob) {
-    return true;
-  }
-
-  if (typeof val !== "object" || val == null || !(Symbol.toStringTag in val)) {
-    return false;
-  }
-
-  const tag = val[Symbol.toStringTag];
-  if (tag !== "Blob" && tag !== "File") {
-    return false;
-  }
-
-  return "stream" in val && typeof val.stream === "function";
-}
-
-export function appendForm(
-  fd: FormData,
-  key: string,
-  value: unknown,
-  fileName?: string,
-): void {
-  if (value == null) {
-    return;
-  } else if (isBlobLike(value)) {
-    if (fileName) {
-      fd.append(key, value as Blob, fileName);
-    } else {
-      fd.append(key, value as Blob);
-    }
-  } else if (Array.isArray(value)) {
-    value.forEach((v) => {
-      appendForm(fd, key, v);
-    });
-  } else {
-    fd.append(key, String(value));
-  }
-}
-
-export async function normalizeBlob(
-  value: Pick<Blob, "arrayBuffer" | "type">,
-): Promise<Blob> {
-  if (value instanceof Blob) {
-    return value;
-  }
-  return new Blob([await value.arrayBuffer()], { type: value.type });
-}

package/src/lib/env.ts

@@ -1,63 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import * as z from "zod/v4-mini";
-
-export interface Env {
-  MUTAGENT_API_KEY?: string | undefined;
-  MUTAGENT_BEARER_AUTH?: string | undefined;
-
-  MUTAGENT_DEBUG?: boolean | undefined;
-}
-
-export const envSchema: z.ZodMiniType<Env, unknown> = z.object({
-  MUTAGENT_API_KEY: z.optional(z.string()),
-  MUTAGENT_BEARER_AUTH: z.optional(z.string()),
-
-  MUTAGENT_DEBUG: z.optional(z.coerce.boolean()),
-});
-
-/**
- * Checks for the existence of the Deno global object to determine the environment.
- * @returns {boolean} True if the runtime is Deno, false otherwise.
- */
-function isDeno() {
-  if ("Deno" in globalThis) {
-    return true;
-  }
-
-  return false;
-}
-
-let envMemo: Env | undefined = undefined;
-/**
- * Reads and validates environment variables.
- */
-export function env(): Env {
-  if (envMemo) {
-    return envMemo;
-  }
-
-  const globals = globalThis as {
-    Deno?: { env?: { toObject?: () => Record<string, string | undefined> } };
-    process?: { env?: Record<string, string | undefined> };
-  };
-
-  let envObject: Record<string, unknown> = {};
-  if (isDeno()) {
-    envObject = globals.Deno?.env?.toObject?.() ?? {};
-  } else {
-    envObject = globals.process?.env ?? {};
-  }
-
-  envMemo = envSchema.parse(envObject);
-  return envMemo;
-}
-
-/**
- * Clears the cached env object. Useful for testing with a fresh environment.
- */
-export function resetEnv() {
-  envMemo = undefined;
-}

package/src/lib/files.ts

@@ -1,104 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-/**
- * Consumes a stream and returns a concatenated array buffer. Useful in
- * situations where we need to read the whole file because it forms part of a
- * larger payload containing other fields, and we can't modify the underlying
- * request structure.
- */
-export async function readableStreamToArrayBuffer(
-  readable: ReadableStream<Uint8Array>,
-): Promise<ArrayBuffer> {
-  const reader = readable.getReader();
-  const chunks: Uint8Array[] = [];
-
-  let totalLength = 0;
-  let done = false;
-
-  while (!done) {
-    const { value, done: doneReading } = await reader.read();
-
-    if (doneReading) {
-      done = true;
-    } else {
-      chunks.push(value);
-      totalLength += value.length;
-    }
-  }
-
-  const concatenatedChunks = new Uint8Array(totalLength);
-  let offset = 0;
-
-  for (const chunk of chunks) {
-    concatenatedChunks.set(chunk, offset);
-    offset += chunk.length;
-  }
-
-  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;
-}
-
-/**
- * Creates a Blob from file content with the given MIME type.
- *
- * Node.js Buffers are Uint8Array subclasses that may share a pooled
- * ArrayBuffer (byteOffset > 0, byteLength < buffer.byteLength). Passing
- * such a Buffer directly to `new Blob([buf])` can include the entire
- * underlying pool on some runtimes, producing a Blob with extra bytes
- * that corrupts multipart uploads.
- *
- * Copying into a standalone Uint8Array ensures the Blob receives only the
- * intended bytes regardless of runtime behaviour.
- */
-export function bytesToBlob(
-  content: Uint8Array<ArrayBufferLike> | ArrayBuffer | Blob | string,
-  contentType: string,
-): Blob {
-  if (content instanceof Uint8Array) {
-    return new Blob([new Uint8Array(content)], { type: contentType });
-  }
-  return new Blob([content as BlobPart], { type: contentType });
-}