@settlemint/sdk-utils 2.6.2 → 2.6.3-mainb49d2d05

package/dist/string.js.map

@@ -1 +1 @@
-{"version":3,"file":"string.js","names":[],"sources":["../src/string.ts"],"sourcesContent":["/**\n * Capitalizes the first letter of a string.\n *\n * @param val - The string to capitalize\n * @returns The input string with its first letter capitalized\n *\n * @example\n * import { capitalizeFirstLetter } from \"@settlemint/sdk-utils\";\n *\n * const capitalized = capitalizeFirstLetter(\"hello\");\n * // Returns: \"Hello\"\n */\nexport function capitalizeFirstLetter(val: string) {\n  return String(val).charAt(0).toUpperCase() + String(val).slice(1);\n}\n\n/**\n * Converts a camelCase string to a human-readable string.\n *\n * @param s - The camelCase string to convert\n * @returns The human-readable string\n *\n * @example\n * import { camelCaseToWords } from \"@settlemint/sdk-utils\";\n *\n * const words = camelCaseToWords(\"camelCaseString\");\n * // Returns: \"Camel Case String\"\n */\nexport function camelCaseToWords(s: string) {\n  const result = s.replace(/([a-z])([A-Z])/g, \"$1 $2\");\n  const withSpaces = result.replace(/([A-Z])([a-z])/g, \" $1$2\");\n  const capitalized = capitalizeFirstLetter(withSpaces);\n  return capitalized.replace(/\\s+/g, \" \").trim();\n}\n\n/**\n * Replaces underscores and hyphens with spaces.\n *\n * @param s - The string to replace underscores and hyphens with spaces\n * @returns The input string with underscores and hyphens replaced with spaces\n *\n * @example\n * import { replaceUnderscoresAndHyphensWithSpaces } from \"@settlemint/sdk-utils\";\n *\n * const result = replaceUnderscoresAndHyphensWithSpaces(\"Already_Spaced-Second\");\n * // Returns: \"Already Spaced Second\"\n */\nexport function replaceUnderscoresAndHyphensWithSpaces(s: string) {\n  return s.replace(/[-_]/g, \" \");\n}\n\n/**\n * Truncates a string to a maximum length and appends \"...\" if it is longer.\n *\n * @param value - The string to truncate\n * @param maxLength - The maximum length of the string\n * @returns The truncated string or the original string if it is shorter than the maximum length\n *\n * @example\n * import { truncate } from \"@settlemint/sdk-utils\";\n *\n * const truncated = truncate(\"Hello, world!\", 10);\n * // Returns: \"Hello, wor...\"\n */\nexport function truncate(value: string, maxLength: number) {\n  if (value.length <= maxLength) {\n    return value;\n  }\n  return `${value.slice(0, maxLength)}...`;\n}\n"],"mappings":";;;;;;;;;;;;;AAYA,SAAgB,sBAAsB,KAAa;AACjD,QAAO,OAAO,KAAK,OAAO,GAAG,gBAAgB,OAAO,KAAK,MAAM;;;;;;;;;;;;;;AAejE,SAAgB,iBAAiB,GAAW;CAC1C,MAAM,SAAS,EAAE,QAAQ,mBAAmB;CAC5C,MAAM,aAAa,OAAO,QAAQ,mBAAmB;CACrD,MAAM,cAAc,sBAAsB;AAC1C,QAAO,YAAY,QAAQ,QAAQ,KAAK;;;;;;;;;;;;;;AAe1C,SAAgB,uCAAuC,GAAW;AAChE,QAAO,EAAE,QAAQ,SAAS;;;;;;;;;;;;;;;AAgB5B,SAAgB,SAAS,OAAe,WAAmB;AACzD,KAAI,MAAM,UAAU,WAAW;AAC7B,SAAO;;AAET,QAAO,GAAG,MAAM,MAAM,GAAG,WAAW"}
+{"version":3,"file":"string.js","names":[],"sources":["../src/string.ts"],"sourcesContent":["/**\n * Capitalizes the first letter of a string.\n *\n * @param val - The string to capitalize\n * @returns The input string with its first letter capitalized\n *\n * @example\n * import { capitalizeFirstLetter } from \"@settlemint/sdk-utils\";\n *\n * const capitalized = capitalizeFirstLetter(\"hello\");\n * // Returns: \"Hello\"\n */\nexport function capitalizeFirstLetter(val: string) {\n  return String(val).charAt(0).toUpperCase() + String(val).slice(1);\n}\n\n/**\n * Converts a camelCase string to a human-readable string.\n *\n * @param s - The camelCase string to convert\n * @returns The human-readable string\n *\n * @example\n * import { camelCaseToWords } from \"@settlemint/sdk-utils\";\n *\n * const words = camelCaseToWords(\"camelCaseString\");\n * // Returns: \"Camel Case String\"\n */\nexport function camelCaseToWords(s: string) {\n  const result = s.replace(/([a-z])([A-Z])/g, \"$1 $2\");\n  const withSpaces = result.replace(/([A-Z])([a-z])/g, \" $1$2\");\n  const capitalized = capitalizeFirstLetter(withSpaces);\n  return capitalized.replace(/\\s+/g, \" \").trim();\n}\n\n/**\n * Replaces underscores and hyphens with spaces.\n *\n * @param s - The string to replace underscores and hyphens with spaces\n * @returns The input string with underscores and hyphens replaced with spaces\n *\n * @example\n * import { replaceUnderscoresAndHyphensWithSpaces } from \"@settlemint/sdk-utils\";\n *\n * const result = replaceUnderscoresAndHyphensWithSpaces(\"Already_Spaced-Second\");\n * // Returns: \"Already Spaced Second\"\n */\nexport function replaceUnderscoresAndHyphensWithSpaces(s: string) {\n  return s.replace(/[-_]/g, \" \");\n}\n\n/**\n * Truncates a string to a maximum length and appends \"...\" if it is longer.\n *\n * @param value - The string to truncate\n * @param maxLength - The maximum length of the string\n * @returns The truncated string or the original string if it is shorter than the maximum length\n *\n * @example\n * import { truncate } from \"@settlemint/sdk-utils\";\n *\n * const truncated = truncate(\"Hello, world!\", 10);\n * // Returns: \"Hello, wor...\"\n */\nexport function truncate(value: string, maxLength: number) {\n  if (value.length <= maxLength) {\n    return value;\n  }\n  return `${value.slice(0, maxLength)}...`;\n}\n"],"mappings":";;;;;;;;;;;;;AAYA,SAAgB,sBAAsB,KAAa;AACjD,QAAO,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,aAAa,GAAG,OAAO,IAAI,CAAC,MAAM,EAAE;;;;;;;;;;;;;;AAenE,SAAgB,iBAAiB,GAAW;CAC1C,MAAM,SAAS,EAAE,QAAQ,mBAAmB,QAAQ;CACpD,MAAM,aAAa,OAAO,QAAQ,mBAAmB,QAAQ;CAC7D,MAAM,cAAc,sBAAsB,WAAW;AACrD,QAAO,YAAY,QAAQ,QAAQ,IAAI,CAAC,MAAM;;;;;;;;;;;;;;AAehD,SAAgB,uCAAuC,GAAW;AAChE,QAAO,EAAE,QAAQ,SAAS,IAAI;;;;;;;;;;;;;;;AAgBhC,SAAgB,SAAS,OAAe,WAAmB;AACzD,KAAI,MAAM,UAAU,WAAW;AAC7B,SAAO;;AAET,QAAO,GAAG,MAAM,MAAM,GAAG,UAAU,CAAC"}

package/dist/terminal.cjs

@@ -21,11 +21,16 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-const yoctocolors = __toESM(require("yoctocolors"));
-const node_child_process = __toESM(require("node:child_process"));
-const is_in_ci = __toESM(require("is-in-ci"));
-const yocto_spinner = __toESM(require("yocto-spinner"));
-const console_table_printer = __toESM(require("console-table-printer"));
+let yoctocolors = require("yoctocolors");
+yoctocolors = __toESM(yoctocolors);
+let node_child_process = require("node:child_process");
+node_child_process = __toESM(node_child_process);
+let is_in_ci = require("is-in-ci");
+is_in_ci = __toESM(is_in_ci);
+let yocto_spinner = require("yocto-spinner");
+yocto_spinner = __toESM(yocto_spinner);
+let console_table_printer = require("console-table-printer");
+console_table_printer = __toESM(console_table_printer);
 
 //#region src/terminal/should-print.ts
 /**

package/dist/terminal.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"terminal.cjs","names":["code: number","output: string[]","items","originalError: Error","isInCi","spinner","table","Table"],"sources":["../src/terminal/should-print.ts","../src/terminal/ascii.ts","../src/logging/mask-tokens.ts","../src/terminal/cancel.ts","../src/terminal/execute-command.ts","../src/terminal/intro.ts","../src/terminal/note.ts","../src/terminal/list.ts","../src/terminal/outro.ts","../src/terminal/spinner.ts","../src/string.ts","../src/terminal/table.ts"],"sourcesContent":["/**\n * Returns true if the terminal should print, false otherwise.\n * @returns true if the terminal should print, false otherwise.\n */\nexport function shouldPrint() {\n  return process.env.SETTLEMINT_DISABLE_TERMINAL !== \"true\";\n}\n","import { magentaBright } from \"yoctocolors\";\nimport { shouldPrint } from \"./should-print.js\";\n\n/**\n * Prints the SettleMint ASCII art logo to the console in magenta color.\n * Used for CLI branding and visual identification.\n *\n * @example\n * import { ascii } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Prints the SettleMint logo\n * ascii();\n */\nexport const ascii = (): void => {\n  if (!shouldPrint()) {\n    return;\n  }\n  console.log(\n    magentaBright(`\n  _________       __    __  .__            _____  .__        __\n /   _____/ _____/  |__/  |_|  |   ____   /     \\\\ |__| _____/  |_\n \\\\_____  \\\\_/ __ \\\\   __\\\\   __\\\\  | _/ __ \\\\ /  \\\\ /  \\\\|  |/    \\\\   __\\\\\n /        \\\\  ___/|  |  |  | |  |_\\\\  ___//    Y    \\\\  |   |  \\\\  |\n/_________/\\\\_____>__|  |__| |____/\\\\_____>____|____/__|___|__/__|\n`),\n  );\n};\n","/**\n * Masks sensitive SettleMint tokens in output text by replacing them with asterisks.\n * Handles personal access tokens (PAT), application access tokens (AAT), and service account tokens (SAT).\n *\n * @param output - The text string that may contain sensitive tokens\n * @returns The text with any sensitive tokens masked with asterisks\n * @example\n * import { maskTokens } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Masks a token in text\n * const masked = maskTokens(\"Token: sm_pat_****\"); // \"Token: ***\"\n */\nexport const maskTokens = (output: string): string => {\n  return output.replace(/sm_(pat|aat|sat)_[0-9a-zA-Z]+/g, \"***\");\n};\n","import { maskTokens } from \"@/logging/mask-tokens.js\";\nimport { inverse, redBright } from \"yoctocolors\";\n\n/**\n * Error class used to indicate that the operation was cancelled.\n * This error is used to signal that the operation should be aborted.\n */\nexport class CancelError extends Error {}\n\n/**\n * Displays an error message in red inverse text and throws a CancelError.\n * Used to terminate execution with a visible error message.\n * Any sensitive tokens in the message are masked before display.\n *\n * @param msg - The error message to display\n * @returns never - Function does not return as it throws an error\n * @example\n * import { cancel } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Exits process with error message\n * cancel(\"An error occurred\");\n */\nexport const cancel = (msg: string): never => {\n  console.log(\"\");\n  console.log(inverse(redBright(maskTokens(msg))));\n  console.log(\"\");\n  throw new CancelError(msg);\n};\n","import { type SpawnOptionsWithoutStdio, spawn } from \"node:child_process\";\nimport { maskTokens } from \"../logging/mask-tokens.js\";\n\n/**\n * Options for executing a command, extending SpawnOptionsWithoutStdio\n */\nexport interface ExecuteCommandOptions extends SpawnOptionsWithoutStdio {\n  /** Whether to suppress output to stdout/stderr */\n  silent?: boolean;\n}\n\n/**\n * Error class for command execution errors\n * @extends Error\n */\nexport class CommandError extends Error {\n  /**\n   * Constructs a new CommandError\n   * @param message - The error message\n   * @param code - The exit code of the command\n   * @param output - The output of the command\n   */\n  constructor(\n    message: string,\n    public readonly code: number,\n    public readonly output: string[],\n  ) {\n    super(message);\n  }\n}\n\n/**\n * Executes a command with the given arguments in a child process.\n * Pipes stdin to the child process and captures stdout/stderr output.\n * Masks any sensitive tokens in the output before displaying or returning.\n *\n * @param command - The command to execute\n * @param args - Array of arguments to pass to the command\n * @param options - Options for customizing command execution\n * @returns Array of output strings from stdout and stderr\n * @throws {CommandError} If the process fails to start or exits with non-zero code\n * @example\n * import { executeCommand } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Execute git clone\n * await executeCommand(\"git\", [\"clone\", \"repo-url\"]);\n *\n * // Execute silently\n * await executeCommand(\"npm\", [\"install\"], { silent: true });\n */\nexport async function executeCommand(\n  command: string,\n  args: string[],\n  options?: ExecuteCommandOptions,\n): Promise<string[]> {\n  const { silent, ...spawnOptions } = options ?? {};\n  const child = spawn(command, args, { ...spawnOptions, env: { ...process.env, ...options?.env } });\n  process.stdin.pipe(child.stdin);\n  const output: string[] = [];\n  return new Promise((resolve, reject) => {\n    child.stdout.on(\"data\", (data: Buffer | string) => {\n      const maskedData = maskTokens(data.toString());\n      if (!silent) {\n        process.stdout.write(maskedData);\n      }\n      output.push(maskedData);\n    });\n    child.stderr.on(\"data\", (data: Buffer | string) => {\n      const maskedData = maskTokens(data.toString());\n      if (!silent) {\n        process.stderr.write(maskedData);\n      }\n      output.push(maskedData);\n    });\n    child.on(\"error\", (err) => {\n      process.stdin.unpipe(child.stdin);\n      reject(new CommandError(err.message, \"code\" in err && typeof err.code === \"number\" ? err.code : 1, output));\n    });\n    child.on(\"close\", (code) => {\n      process.stdin.unpipe(child.stdin);\n      if (code === 0 || code === null || code === 143) {\n        resolve(output);\n        return;\n      }\n      reject(new CommandError(`Command \"${command}\" exited with code ${code}`, code, output));\n    });\n  });\n}\n","import { maskTokens } from \"@/logging/mask-tokens.js\";\nimport { magentaBright } from \"yoctocolors\";\nimport { shouldPrint } from \"./should-print.js\";\n\n/**\n * Displays an introductory message in magenta text with padding.\n * Any sensitive tokens in the message are masked before display.\n *\n * @param msg - The message to display as introduction\n * @example\n * import { intro } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Display intro message\n * intro(\"Starting deployment...\");\n */\nexport const intro = (msg: string): void => {\n  if (!shouldPrint()) {\n    return;\n  }\n  console.log(\"\");\n  console.log(magentaBright(maskTokens(msg)));\n  console.log(\"\");\n};\n","import { maskTokens } from \"@/logging/mask-tokens.js\";\nimport { yellowBright } from \"yoctocolors\";\nimport { shouldPrint } from \"./should-print.js\";\n\n/**\n * Displays a note message with optional warning level formatting.\n * Regular notes are displayed in normal text, while warnings are shown in yellow.\n * Any sensitive tokens in the message are masked before display.\n *\n * @param message - The message to display as a note\n * @param level - The note level: \"info\" (default) or \"warn\" for warning styling\n * @example\n * import { note } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Display info note\n * note(\"Operation completed successfully\");\n *\n * // Display warning note\n * note(\"Low disk space remaining\", \"warn\");\n */\nexport const note = (message: string, level: \"info\" | \"warn\" = \"info\"): void => {\n  if (!shouldPrint()) {\n    return;\n  }\n  const maskedMessage = maskTokens(message);\n\n  console.log(\"\");\n  if (level === \"warn\") {\n    console.warn(yellowBright(maskedMessage));\n    return;\n  }\n\n  console.log(maskedMessage);\n};\n","import { note } from \"./note.js\";\n\n/**\n * Displays a list of items in a formatted manner, supporting nested items.\n *\n * @param title - The title of the list\n * @param items - The items to display, can be strings or arrays for nested items\n * @returns The formatted list\n * @example\n * import { list } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Simple list\n * list(\"Use cases\", [\"use case 1\", \"use case 2\", \"use case 3\"]);\n *\n * // Nested list\n * list(\"Providers\", [\n *   \"AWS\",\n *   [\"us-east-1\", \"eu-west-1\"],\n *   \"Azure\",\n *   [\"eastus\", \"westeurope\"]\n * ]);\n */\nexport function list(title: string, items: Array<string | string[]>) {\n  const formatItems = (items: Array<string | string[]>): string => {\n    return items\n      .map((item) => {\n        if (Array.isArray(item)) {\n          return item.map((subItem) => `    • ${subItem}`).join(\"\\n\");\n        }\n        return `  • ${item}`;\n      })\n      .join(\"\\n\");\n  };\n\n  return note(`${title}:\\n\\n${formatItems(items)}`);\n}\n","import { maskTokens } from \"@/logging/mask-tokens.js\";\nimport { shouldPrint } from \"@/terminal/should-print.js\";\nimport { greenBright, inverse } from \"yoctocolors\";\n\n/**\n * Displays a closing message in green inverted text with padding.\n * Any sensitive tokens in the message are masked before display.\n *\n * @param msg - The message to display as conclusion\n * @example\n * import { outro } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Display outro message\n * outro(\"Deployment completed successfully!\");\n */\nexport const outro = (msg: string): void => {\n  if (!shouldPrint()) {\n    return;\n  }\n  console.log(\"\");\n  console.log(inverse(greenBright(maskTokens(msg))));\n  console.log(\"\");\n};\n","import isInCi from \"is-in-ci\";\nimport yoctoSpinner, { type Spinner } from \"yocto-spinner\";\nimport { redBright } from \"yoctocolors\";\nimport { maskTokens } from \"../logging/mask-tokens.js\";\nimport { note } from \"./note.js\";\nimport { shouldPrint } from \"./should-print.js\";\n\n/**\n * Error class used to indicate that the spinner operation failed.\n * This error is used to signal that the operation should be aborted.\n */\nexport class SpinnerError extends Error {\n  constructor(\n    message: string,\n    public readonly originalError: Error,\n  ) {\n    super(message);\n    this.name = \"SpinnerError\";\n  }\n}\n\n/**\n * Options for configuring the spinner behavior\n */\nexport interface SpinnerOptions<R> {\n  /** Message to display when spinner starts */\n  startMessage: string;\n  /** Async task to execute while spinner is active */\n  task: (spinner?: Spinner) => Promise<R>;\n  /** Message to display when spinner completes successfully */\n  stopMessage: string;\n}\n\n/**\n * Displays a loading spinner while executing an async task.\n * Shows progress with start/stop messages and handles errors.\n * Spinner is disabled in CI environments.\n *\n * @param options - Configuration options for the spinner\n * @returns The result from the executed task\n * @throws Will exit process with code 1 if task fails\n * @example\n * import { spinner } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Show spinner during async task\n * const result = await spinner({\n *   startMessage: \"Deploying...\",\n *   task: async () => {\n *     // Async work here\n *     return \"success\";\n *   },\n *   stopMessage: \"Deployed successfully!\"\n * });\n */\nexport const spinner = async <R>(options: SpinnerOptions<R>): Promise<R> => {\n  const handleError = (error: Error) => {\n    const errorMessage = maskTokens(error.message);\n    note(redBright(`${errorMessage}\\n\\n${error.stack}`));\n    throw new SpinnerError(errorMessage, error);\n  };\n  if (isInCi || !shouldPrint()) {\n    try {\n      return await options.task();\n    } catch (err) {\n      return handleError(err as Error);\n    }\n  }\n  const spinner = yoctoSpinner({ stream: process.stdout }).start(options.startMessage);\n  try {\n    const result = await options.task(spinner);\n    spinner.success(options.stopMessage);\n    // Ensure spinner success message renders before proceeding to avoid\n    // terminal output overlap issues with subsequent messages\n    await new Promise((resolve) => process.nextTick(resolve));\n    return result;\n  } catch (err) {\n    spinner.error(redBright(`${options.startMessage} --> Error!`));\n    return handleError(err as Error);\n  }\n};\n","/**\n * Capitalizes the first letter of a string.\n *\n * @param val - The string to capitalize\n * @returns The input string with its first letter capitalized\n *\n * @example\n * import { capitalizeFirstLetter } from \"@settlemint/sdk-utils\";\n *\n * const capitalized = capitalizeFirstLetter(\"hello\");\n * // Returns: \"Hello\"\n */\nexport function capitalizeFirstLetter(val: string) {\n  return String(val).charAt(0).toUpperCase() + String(val).slice(1);\n}\n\n/**\n * Converts a camelCase string to a human-readable string.\n *\n * @param s - The camelCase string to convert\n * @returns The human-readable string\n *\n * @example\n * import { camelCaseToWords } from \"@settlemint/sdk-utils\";\n *\n * const words = camelCaseToWords(\"camelCaseString\");\n * // Returns: \"Camel Case String\"\n */\nexport function camelCaseToWords(s: string) {\n  const result = s.replace(/([a-z])([A-Z])/g, \"$1 $2\");\n  const withSpaces = result.replace(/([A-Z])([a-z])/g, \" $1$2\");\n  const capitalized = capitalizeFirstLetter(withSpaces);\n  return capitalized.replace(/\\s+/g, \" \").trim();\n}\n\n/**\n * Replaces underscores and hyphens with spaces.\n *\n * @param s - The string to replace underscores and hyphens with spaces\n * @returns The input string with underscores and hyphens replaced with spaces\n *\n * @example\n * import { replaceUnderscoresAndHyphensWithSpaces } from \"@settlemint/sdk-utils\";\n *\n * const result = replaceUnderscoresAndHyphensWithSpaces(\"Already_Spaced-Second\");\n * // Returns: \"Already Spaced Second\"\n */\nexport function replaceUnderscoresAndHyphensWithSpaces(s: string) {\n  return s.replace(/[-_]/g, \" \");\n}\n\n/**\n * Truncates a string to a maximum length and appends \"...\" if it is longer.\n *\n * @param value - The string to truncate\n * @param maxLength - The maximum length of the string\n * @returns The truncated string or the original string if it is shorter than the maximum length\n *\n * @example\n * import { truncate } from \"@settlemint/sdk-utils\";\n *\n * const truncated = truncate(\"Hello, world!\", 10);\n * // Returns: \"Hello, wor...\"\n */\nexport function truncate(value: string, maxLength: number) {\n  if (value.length <= maxLength) {\n    return value;\n  }\n  return `${value.slice(0, maxLength)}...`;\n}\n","import { Table } from \"console-table-printer\";\nimport { whiteBright } from \"yoctocolors\";\nimport { camelCaseToWords } from \"@/string.js\";\nimport { note } from \"./note.js\";\nimport { shouldPrint } from \"./should-print.js\";\n/**\n * Displays data in a formatted table in the terminal.\n *\n * @param title - Title to display above the table\n * @param data - Array of objects to display in table format\n * @example\n * import { table } from \"@settlemint/sdk-utils/terminal\";\n *\n * const data = [\n *   { name: \"Item 1\", value: 100 },\n *   { name: \"Item 2\", value: 200 }\n * ];\n *\n * table(\"My Table\", data);\n */\nexport function table(title: string, data: unknown[]): void {\n  if (!shouldPrint()) {\n    return;\n  }\n\n  note(title);\n\n  if (!data || data.length === 0) {\n    note(\"No data to display\");\n    return;\n  }\n\n  const columnKeys = Object.keys(data[0] as Record<string, unknown>);\n  const table = new Table({\n    columns: columnKeys.map((key) => ({\n      name: key,\n      title: whiteBright(camelCaseToWords(key)),\n      alignment: \"left\",\n    })),\n  });\n  // biome-ignore lint/suspicious/noExplicitAny: Data structure varies based on table content\n  table.addRows(data as Array<Record<string, any>>);\n  table.printTable();\n}\n"],"mappings":"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"}
+{"version":3,"file":"terminal.cjs","names":["code: number","output: string[]","items","originalError: Error","isInCi","spinner","table","Table"],"sources":["../src/terminal/should-print.ts","../src/terminal/ascii.ts","../src/logging/mask-tokens.ts","../src/terminal/cancel.ts","../src/terminal/execute-command.ts","../src/terminal/intro.ts","../src/terminal/note.ts","../src/terminal/list.ts","../src/terminal/outro.ts","../src/terminal/spinner.ts","../src/string.ts","../src/terminal/table.ts"],"sourcesContent":["/**\n * Returns true if the terminal should print, false otherwise.\n * @returns true if the terminal should print, false otherwise.\n */\nexport function shouldPrint() {\n  return process.env.SETTLEMINT_DISABLE_TERMINAL !== \"true\";\n}\n","import { magentaBright } from \"yoctocolors\";\nimport { shouldPrint } from \"./should-print.js\";\n\n/**\n * Prints the SettleMint ASCII art logo to the console in magenta color.\n * Used for CLI branding and visual identification.\n *\n * @example\n * import { ascii } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Prints the SettleMint logo\n * ascii();\n */\nexport const ascii = (): void => {\n  if (!shouldPrint()) {\n    return;\n  }\n  console.log(\n    magentaBright(`\n  _________       __    __  .__            _____  .__        __\n /   _____/ _____/  |__/  |_|  |   ____   /     \\\\ |__| _____/  |_\n \\\\_____  \\\\_/ __ \\\\   __\\\\   __\\\\  | _/ __ \\\\ /  \\\\ /  \\\\|  |/    \\\\   __\\\\\n /        \\\\  ___/|  |  |  | |  |_\\\\  ___//    Y    \\\\  |   |  \\\\  |\n/_________/\\\\_____>__|  |__| |____/\\\\_____>____|____/__|___|__/__|\n`),\n  );\n};\n","/**\n * Masks sensitive SettleMint tokens in output text by replacing them with asterisks.\n * Handles personal access tokens (PAT), application access tokens (AAT), and service account tokens (SAT).\n *\n * @param output - The text string that may contain sensitive tokens\n * @returns The text with any sensitive tokens masked with asterisks\n * @example\n * import { maskTokens } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Masks a token in text\n * const masked = maskTokens(\"Token: sm_pat_****\"); // \"Token: ***\"\n */\nexport const maskTokens = (output: string): string => {\n  return output.replace(/sm_(pat|aat|sat)_[0-9a-zA-Z]+/g, \"***\");\n};\n","import { maskTokens } from \"@/logging/mask-tokens.js\";\nimport { inverse, redBright } from \"yoctocolors\";\n\n/**\n * Error class used to indicate that the operation was cancelled.\n * This error is used to signal that the operation should be aborted.\n */\nexport class CancelError extends Error {}\n\n/**\n * Displays an error message in red inverse text and throws a CancelError.\n * Used to terminate execution with a visible error message.\n * Any sensitive tokens in the message are masked before display.\n *\n * @param msg - The error message to display\n * @returns never - Function does not return as it throws an error\n * @example\n * import { cancel } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Exits process with error message\n * cancel(\"An error occurred\");\n */\nexport const cancel = (msg: string): never => {\n  console.log(\"\");\n  console.log(inverse(redBright(maskTokens(msg))));\n  console.log(\"\");\n  throw new CancelError(msg);\n};\n","import { type SpawnOptionsWithoutStdio, spawn } from \"node:child_process\";\nimport { maskTokens } from \"../logging/mask-tokens.js\";\n\n/**\n * Options for executing a command, extending SpawnOptionsWithoutStdio\n */\nexport interface ExecuteCommandOptions extends SpawnOptionsWithoutStdio {\n  /** Whether to suppress output to stdout/stderr */\n  silent?: boolean;\n}\n\n/**\n * Error class for command execution errors\n * @extends Error\n */\nexport class CommandError extends Error {\n  /**\n   * Constructs a new CommandError\n   * @param message - The error message\n   * @param code - The exit code of the command\n   * @param output - The output of the command\n   */\n  constructor(\n    message: string,\n    public readonly code: number,\n    public readonly output: string[],\n  ) {\n    super(message);\n  }\n}\n\n/**\n * Executes a command with the given arguments in a child process.\n * Pipes stdin to the child process and captures stdout/stderr output.\n * Masks any sensitive tokens in the output before displaying or returning.\n *\n * @param command - The command to execute\n * @param args - Array of arguments to pass to the command\n * @param options - Options for customizing command execution\n * @returns Array of output strings from stdout and stderr\n * @throws {CommandError} If the process fails to start or exits with non-zero code\n * @example\n * import { executeCommand } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Execute git clone\n * await executeCommand(\"git\", [\"clone\", \"repo-url\"]);\n *\n * // Execute silently\n * await executeCommand(\"npm\", [\"install\"], { silent: true });\n */\nexport async function executeCommand(\n  command: string,\n  args: string[],\n  options?: ExecuteCommandOptions,\n): Promise<string[]> {\n  const { silent, ...spawnOptions } = options ?? {};\n  const child = spawn(command, args, { ...spawnOptions, env: { ...process.env, ...options?.env } });\n  process.stdin.pipe(child.stdin);\n  const output: string[] = [];\n  return new Promise((resolve, reject) => {\n    child.stdout.on(\"data\", (data: Buffer | string) => {\n      const maskedData = maskTokens(data.toString());\n      if (!silent) {\n        process.stdout.write(maskedData);\n      }\n      output.push(maskedData);\n    });\n    child.stderr.on(\"data\", (data: Buffer | string) => {\n      const maskedData = maskTokens(data.toString());\n      if (!silent) {\n        process.stderr.write(maskedData);\n      }\n      output.push(maskedData);\n    });\n    child.on(\"error\", (err) => {\n      process.stdin.unpipe(child.stdin);\n      reject(new CommandError(err.message, \"code\" in err && typeof err.code === \"number\" ? err.code : 1, output));\n    });\n    child.on(\"close\", (code) => {\n      process.stdin.unpipe(child.stdin);\n      if (code === 0 || code === null || code === 143) {\n        resolve(output);\n        return;\n      }\n      reject(new CommandError(`Command \"${command}\" exited with code ${code}`, code, output));\n    });\n  });\n}\n","import { maskTokens } from \"@/logging/mask-tokens.js\";\nimport { magentaBright } from \"yoctocolors\";\nimport { shouldPrint } from \"./should-print.js\";\n\n/**\n * Displays an introductory message in magenta text with padding.\n * Any sensitive tokens in the message are masked before display.\n *\n * @param msg - The message to display as introduction\n * @example\n * import { intro } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Display intro message\n * intro(\"Starting deployment...\");\n */\nexport const intro = (msg: string): void => {\n  if (!shouldPrint()) {\n    return;\n  }\n  console.log(\"\");\n  console.log(magentaBright(maskTokens(msg)));\n  console.log(\"\");\n};\n","import { maskTokens } from \"@/logging/mask-tokens.js\";\nimport { yellowBright } from \"yoctocolors\";\nimport { shouldPrint } from \"./should-print.js\";\n\n/**\n * Displays a note message with optional warning level formatting.\n * Regular notes are displayed in normal text, while warnings are shown in yellow.\n * Any sensitive tokens in the message are masked before display.\n *\n * @param message - The message to display as a note\n * @param level - The note level: \"info\" (default) or \"warn\" for warning styling\n * @example\n * import { note } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Display info note\n * note(\"Operation completed successfully\");\n *\n * // Display warning note\n * note(\"Low disk space remaining\", \"warn\");\n */\nexport const note = (message: string, level: \"info\" | \"warn\" = \"info\"): void => {\n  if (!shouldPrint()) {\n    return;\n  }\n  const maskedMessage = maskTokens(message);\n\n  console.log(\"\");\n  if (level === \"warn\") {\n    console.warn(yellowBright(maskedMessage));\n    return;\n  }\n\n  console.log(maskedMessage);\n};\n","import { note } from \"./note.js\";\n\n/**\n * Displays a list of items in a formatted manner, supporting nested items.\n *\n * @param title - The title of the list\n * @param items - The items to display, can be strings or arrays for nested items\n * @returns The formatted list\n * @example\n * import { list } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Simple list\n * list(\"Use cases\", [\"use case 1\", \"use case 2\", \"use case 3\"]);\n *\n * // Nested list\n * list(\"Providers\", [\n *   \"AWS\",\n *   [\"us-east-1\", \"eu-west-1\"],\n *   \"Azure\",\n *   [\"eastus\", \"westeurope\"]\n * ]);\n */\nexport function list(title: string, items: Array<string | string[]>) {\n  const formatItems = (items: Array<string | string[]>): string => {\n    return items\n      .map((item) => {\n        if (Array.isArray(item)) {\n          return item.map((subItem) => `    • ${subItem}`).join(\"\\n\");\n        }\n        return `  • ${item}`;\n      })\n      .join(\"\\n\");\n  };\n\n  return note(`${title}:\\n\\n${formatItems(items)}`);\n}\n","import { maskTokens } from \"@/logging/mask-tokens.js\";\nimport { shouldPrint } from \"@/terminal/should-print.js\";\nimport { greenBright, inverse } from \"yoctocolors\";\n\n/**\n * Displays a closing message in green inverted text with padding.\n * Any sensitive tokens in the message are masked before display.\n *\n * @param msg - The message to display as conclusion\n * @example\n * import { outro } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Display outro message\n * outro(\"Deployment completed successfully!\");\n */\nexport const outro = (msg: string): void => {\n  if (!shouldPrint()) {\n    return;\n  }\n  console.log(\"\");\n  console.log(inverse(greenBright(maskTokens(msg))));\n  console.log(\"\");\n};\n","import isInCi from \"is-in-ci\";\nimport yoctoSpinner, { type Spinner } from \"yocto-spinner\";\nimport { redBright } from \"yoctocolors\";\nimport { maskTokens } from \"../logging/mask-tokens.js\";\nimport { note } from \"./note.js\";\nimport { shouldPrint } from \"./should-print.js\";\n\n/**\n * Error class used to indicate that the spinner operation failed.\n * This error is used to signal that the operation should be aborted.\n */\nexport class SpinnerError extends Error {\n  constructor(\n    message: string,\n    public readonly originalError: Error,\n  ) {\n    super(message);\n    this.name = \"SpinnerError\";\n  }\n}\n\n/**\n * Options for configuring the spinner behavior\n */\nexport interface SpinnerOptions<R> {\n  /** Message to display when spinner starts */\n  startMessage: string;\n  /** Async task to execute while spinner is active */\n  task: (spinner?: Spinner) => Promise<R>;\n  /** Message to display when spinner completes successfully */\n  stopMessage: string;\n}\n\n/**\n * Displays a loading spinner while executing an async task.\n * Shows progress with start/stop messages and handles errors.\n * Spinner is disabled in CI environments.\n *\n * @param options - Configuration options for the spinner\n * @returns The result from the executed task\n * @throws Will exit process with code 1 if task fails\n * @example\n * import { spinner } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Show spinner during async task\n * const result = await spinner({\n *   startMessage: \"Deploying...\",\n *   task: async () => {\n *     // Async work here\n *     return \"success\";\n *   },\n *   stopMessage: \"Deployed successfully!\"\n * });\n */\nexport const spinner = async <R>(options: SpinnerOptions<R>): Promise<R> => {\n  const handleError = (error: Error) => {\n    const errorMessage = maskTokens(error.message);\n    note(redBright(`${errorMessage}\\n\\n${error.stack}`));\n    throw new SpinnerError(errorMessage, error);\n  };\n  if (isInCi || !shouldPrint()) {\n    try {\n      return await options.task();\n    } catch (err) {\n      return handleError(err as Error);\n    }\n  }\n  const spinner = yoctoSpinner({ stream: process.stdout }).start(options.startMessage);\n  try {\n    const result = await options.task(spinner);\n    spinner.success(options.stopMessage);\n    // Ensure spinner success message renders before proceeding to avoid\n    // terminal output overlap issues with subsequent messages\n    await new Promise((resolve) => process.nextTick(resolve));\n    return result;\n  } catch (err) {\n    spinner.error(redBright(`${options.startMessage} --> Error!`));\n    return handleError(err as Error);\n  }\n};\n","/**\n * Capitalizes the first letter of a string.\n *\n * @param val - The string to capitalize\n * @returns The input string with its first letter capitalized\n *\n * @example\n * import { capitalizeFirstLetter } from \"@settlemint/sdk-utils\";\n *\n * const capitalized = capitalizeFirstLetter(\"hello\");\n * // Returns: \"Hello\"\n */\nexport function capitalizeFirstLetter(val: string) {\n  return String(val).charAt(0).toUpperCase() + String(val).slice(1);\n}\n\n/**\n * Converts a camelCase string to a human-readable string.\n *\n * @param s - The camelCase string to convert\n * @returns The human-readable string\n *\n * @example\n * import { camelCaseToWords } from \"@settlemint/sdk-utils\";\n *\n * const words = camelCaseToWords(\"camelCaseString\");\n * // Returns: \"Camel Case String\"\n */\nexport function camelCaseToWords(s: string) {\n  const result = s.replace(/([a-z])([A-Z])/g, \"$1 $2\");\n  const withSpaces = result.replace(/([A-Z])([a-z])/g, \" $1$2\");\n  const capitalized = capitalizeFirstLetter(withSpaces);\n  return capitalized.replace(/\\s+/g, \" \").trim();\n}\n\n/**\n * Replaces underscores and hyphens with spaces.\n *\n * @param s - The string to replace underscores and hyphens with spaces\n * @returns The input string with underscores and hyphens replaced with spaces\n *\n * @example\n * import { replaceUnderscoresAndHyphensWithSpaces } from \"@settlemint/sdk-utils\";\n *\n * const result = replaceUnderscoresAndHyphensWithSpaces(\"Already_Spaced-Second\");\n * // Returns: \"Already Spaced Second\"\n */\nexport function replaceUnderscoresAndHyphensWithSpaces(s: string) {\n  return s.replace(/[-_]/g, \" \");\n}\n\n/**\n * Truncates a string to a maximum length and appends \"...\" if it is longer.\n *\n * @param value - The string to truncate\n * @param maxLength - The maximum length of the string\n * @returns The truncated string or the original string if it is shorter than the maximum length\n *\n * @example\n * import { truncate } from \"@settlemint/sdk-utils\";\n *\n * const truncated = truncate(\"Hello, world!\", 10);\n * // Returns: \"Hello, wor...\"\n */\nexport function truncate(value: string, maxLength: number) {\n  if (value.length <= maxLength) {\n    return value;\n  }\n  return `${value.slice(0, maxLength)}...`;\n}\n","import { Table } from \"console-table-printer\";\nimport { whiteBright } from \"yoctocolors\";\nimport { camelCaseToWords } from \"@/string.js\";\nimport { note } from \"./note.js\";\nimport { shouldPrint } from \"./should-print.js\";\n/**\n * Displays data in a formatted table in the terminal.\n *\n * @param title - Title to display above the table\n * @param data - Array of objects to display in table format\n * @example\n * import { table } from \"@settlemint/sdk-utils/terminal\";\n *\n * const data = [\n *   { name: \"Item 1\", value: 100 },\n *   { name: \"Item 2\", value: 200 }\n * ];\n *\n * table(\"My Table\", data);\n */\nexport function table(title: string, data: unknown[]): void {\n  if (!shouldPrint()) {\n    return;\n  }\n\n  note(title);\n\n  if (!data || data.length === 0) {\n    note(\"No data to display\");\n    return;\n  }\n\n  const columnKeys = Object.keys(data[0] as Record<string, unknown>);\n  const table = new Table({\n    columns: columnKeys.map((key) => ({\n      name: key,\n      title: whiteBright(camelCaseToWords(key)),\n      alignment: \"left\",\n    })),\n  });\n  // biome-ignore lint/suspicious/noExplicitAny: Data structure varies based on table content\n  table.addRows(data as Array<Record<string, any>>);\n  table.printTable();\n}\n"],"mappings":"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"}

package/dist/terminal.js.map

@@ -1 +1 @@
-{"version":3,"file":"terminal.js","names":["code: number","output: string[]","items","originalError: Error","spinner","table"],"sources":["../src/terminal/should-print.ts","../src/terminal/ascii.ts","../src/logging/mask-tokens.ts","../src/terminal/cancel.ts","../src/terminal/execute-command.ts","../src/terminal/intro.ts","../src/terminal/note.ts","../src/terminal/list.ts","../src/terminal/outro.ts","../src/terminal/spinner.ts","../src/string.ts","../src/terminal/table.ts"],"sourcesContent":["/**\n * Returns true if the terminal should print, false otherwise.\n * @returns true if the terminal should print, false otherwise.\n */\nexport function shouldPrint() {\n  return process.env.SETTLEMINT_DISABLE_TERMINAL !== \"true\";\n}\n","import { magentaBright } from \"yoctocolors\";\nimport { shouldPrint } from \"./should-print.js\";\n\n/**\n * Prints the SettleMint ASCII art logo to the console in magenta color.\n * Used for CLI branding and visual identification.\n *\n * @example\n * import { ascii } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Prints the SettleMint logo\n * ascii();\n */\nexport const ascii = (): void => {\n  if (!shouldPrint()) {\n    return;\n  }\n  console.log(\n    magentaBright(`\n  _________       __    __  .__            _____  .__        __\n /   _____/ _____/  |__/  |_|  |   ____   /     \\\\ |__| _____/  |_\n \\\\_____  \\\\_/ __ \\\\   __\\\\   __\\\\  | _/ __ \\\\ /  \\\\ /  \\\\|  |/    \\\\   __\\\\\n /        \\\\  ___/|  |  |  | |  |_\\\\  ___//    Y    \\\\  |   |  \\\\  |\n/_________/\\\\_____>__|  |__| |____/\\\\_____>____|____/__|___|__/__|\n`),\n  );\n};\n","/**\n * Masks sensitive SettleMint tokens in output text by replacing them with asterisks.\n * Handles personal access tokens (PAT), application access tokens (AAT), and service account tokens (SAT).\n *\n * @param output - The text string that may contain sensitive tokens\n * @returns The text with any sensitive tokens masked with asterisks\n * @example\n * import { maskTokens } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Masks a token in text\n * const masked = maskTokens(\"Token: sm_pat_****\"); // \"Token: ***\"\n */\nexport const maskTokens = (output: string): string => {\n  return output.replace(/sm_(pat|aat|sat)_[0-9a-zA-Z]+/g, \"***\");\n};\n","import { maskTokens } from \"@/logging/mask-tokens.js\";\nimport { inverse, redBright } from \"yoctocolors\";\n\n/**\n * Error class used to indicate that the operation was cancelled.\n * This error is used to signal that the operation should be aborted.\n */\nexport class CancelError extends Error {}\n\n/**\n * Displays an error message in red inverse text and throws a CancelError.\n * Used to terminate execution with a visible error message.\n * Any sensitive tokens in the message are masked before display.\n *\n * @param msg - The error message to display\n * @returns never - Function does not return as it throws an error\n * @example\n * import { cancel } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Exits process with error message\n * cancel(\"An error occurred\");\n */\nexport const cancel = (msg: string): never => {\n  console.log(\"\");\n  console.log(inverse(redBright(maskTokens(msg))));\n  console.log(\"\");\n  throw new CancelError(msg);\n};\n","import { type SpawnOptionsWithoutStdio, spawn } from \"node:child_process\";\nimport { maskTokens } from \"../logging/mask-tokens.js\";\n\n/**\n * Options for executing a command, extending SpawnOptionsWithoutStdio\n */\nexport interface ExecuteCommandOptions extends SpawnOptionsWithoutStdio {\n  /** Whether to suppress output to stdout/stderr */\n  silent?: boolean;\n}\n\n/**\n * Error class for command execution errors\n * @extends Error\n */\nexport class CommandError extends Error {\n  /**\n   * Constructs a new CommandError\n   * @param message - The error message\n   * @param code - The exit code of the command\n   * @param output - The output of the command\n   */\n  constructor(\n    message: string,\n    public readonly code: number,\n    public readonly output: string[],\n  ) {\n    super(message);\n  }\n}\n\n/**\n * Executes a command with the given arguments in a child process.\n * Pipes stdin to the child process and captures stdout/stderr output.\n * Masks any sensitive tokens in the output before displaying or returning.\n *\n * @param command - The command to execute\n * @param args - Array of arguments to pass to the command\n * @param options - Options for customizing command execution\n * @returns Array of output strings from stdout and stderr\n * @throws {CommandError} If the process fails to start or exits with non-zero code\n * @example\n * import { executeCommand } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Execute git clone\n * await executeCommand(\"git\", [\"clone\", \"repo-url\"]);\n *\n * // Execute silently\n * await executeCommand(\"npm\", [\"install\"], { silent: true });\n */\nexport async function executeCommand(\n  command: string,\n  args: string[],\n  options?: ExecuteCommandOptions,\n): Promise<string[]> {\n  const { silent, ...spawnOptions } = options ?? {};\n  const child = spawn(command, args, { ...spawnOptions, env: { ...process.env, ...options?.env } });\n  process.stdin.pipe(child.stdin);\n  const output: string[] = [];\n  return new Promise((resolve, reject) => {\n    child.stdout.on(\"data\", (data: Buffer | string) => {\n      const maskedData = maskTokens(data.toString());\n      if (!silent) {\n        process.stdout.write(maskedData);\n      }\n      output.push(maskedData);\n    });\n    child.stderr.on(\"data\", (data: Buffer | string) => {\n      const maskedData = maskTokens(data.toString());\n      if (!silent) {\n        process.stderr.write(maskedData);\n      }\n      output.push(maskedData);\n    });\n    child.on(\"error\", (err) => {\n      process.stdin.unpipe(child.stdin);\n      reject(new CommandError(err.message, \"code\" in err && typeof err.code === \"number\" ? err.code : 1, output));\n    });\n    child.on(\"close\", (code) => {\n      process.stdin.unpipe(child.stdin);\n      if (code === 0 || code === null || code === 143) {\n        resolve(output);\n        return;\n      }\n      reject(new CommandError(`Command \"${command}\" exited with code ${code}`, code, output));\n    });\n  });\n}\n","import { maskTokens } from \"@/logging/mask-tokens.js\";\nimport { magentaBright } from \"yoctocolors\";\nimport { shouldPrint } from \"./should-print.js\";\n\n/**\n * Displays an introductory message in magenta text with padding.\n * Any sensitive tokens in the message are masked before display.\n *\n * @param msg - The message to display as introduction\n * @example\n * import { intro } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Display intro message\n * intro(\"Starting deployment...\");\n */\nexport const intro = (msg: string): void => {\n  if (!shouldPrint()) {\n    return;\n  }\n  console.log(\"\");\n  console.log(magentaBright(maskTokens(msg)));\n  console.log(\"\");\n};\n","import { maskTokens } from \"@/logging/mask-tokens.js\";\nimport { yellowBright } from \"yoctocolors\";\nimport { shouldPrint } from \"./should-print.js\";\n\n/**\n * Displays a note message with optional warning level formatting.\n * Regular notes are displayed in normal text, while warnings are shown in yellow.\n * Any sensitive tokens in the message are masked before display.\n *\n * @param message - The message to display as a note\n * @param level - The note level: \"info\" (default) or \"warn\" for warning styling\n * @example\n * import { note } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Display info note\n * note(\"Operation completed successfully\");\n *\n * // Display warning note\n * note(\"Low disk space remaining\", \"warn\");\n */\nexport const note = (message: string, level: \"info\" | \"warn\" = \"info\"): void => {\n  if (!shouldPrint()) {\n    return;\n  }\n  const maskedMessage = maskTokens(message);\n\n  console.log(\"\");\n  if (level === \"warn\") {\n    console.warn(yellowBright(maskedMessage));\n    return;\n  }\n\n  console.log(maskedMessage);\n};\n","import { note } from \"./note.js\";\n\n/**\n * Displays a list of items in a formatted manner, supporting nested items.\n *\n * @param title - The title of the list\n * @param items - The items to display, can be strings or arrays for nested items\n * @returns The formatted list\n * @example\n * import { list } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Simple list\n * list(\"Use cases\", [\"use case 1\", \"use case 2\", \"use case 3\"]);\n *\n * // Nested list\n * list(\"Providers\", [\n *   \"AWS\",\n *   [\"us-east-1\", \"eu-west-1\"],\n *   \"Azure\",\n *   [\"eastus\", \"westeurope\"]\n * ]);\n */\nexport function list(title: string, items: Array<string | string[]>) {\n  const formatItems = (items: Array<string | string[]>): string => {\n    return items\n      .map((item) => {\n        if (Array.isArray(item)) {\n          return item.map((subItem) => `    • ${subItem}`).join(\"\\n\");\n        }\n        return `  • ${item}`;\n      })\n      .join(\"\\n\");\n  };\n\n  return note(`${title}:\\n\\n${formatItems(items)}`);\n}\n","import { maskTokens } from \"@/logging/mask-tokens.js\";\nimport { shouldPrint } from \"@/terminal/should-print.js\";\nimport { greenBright, inverse } from \"yoctocolors\";\n\n/**\n * Displays a closing message in green inverted text with padding.\n * Any sensitive tokens in the message are masked before display.\n *\n * @param msg - The message to display as conclusion\n * @example\n * import { outro } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Display outro message\n * outro(\"Deployment completed successfully!\");\n */\nexport const outro = (msg: string): void => {\n  if (!shouldPrint()) {\n    return;\n  }\n  console.log(\"\");\n  console.log(inverse(greenBright(maskTokens(msg))));\n  console.log(\"\");\n};\n","import isInCi from \"is-in-ci\";\nimport yoctoSpinner, { type Spinner } from \"yocto-spinner\";\nimport { redBright } from \"yoctocolors\";\nimport { maskTokens } from \"../logging/mask-tokens.js\";\nimport { note } from \"./note.js\";\nimport { shouldPrint } from \"./should-print.js\";\n\n/**\n * Error class used to indicate that the spinner operation failed.\n * This error is used to signal that the operation should be aborted.\n */\nexport class SpinnerError extends Error {\n  constructor(\n    message: string,\n    public readonly originalError: Error,\n  ) {\n    super(message);\n    this.name = \"SpinnerError\";\n  }\n}\n\n/**\n * Options for configuring the spinner behavior\n */\nexport interface SpinnerOptions<R> {\n  /** Message to display when spinner starts */\n  startMessage: string;\n  /** Async task to execute while spinner is active */\n  task: (spinner?: Spinner) => Promise<R>;\n  /** Message to display when spinner completes successfully */\n  stopMessage: string;\n}\n\n/**\n * Displays a loading spinner while executing an async task.\n * Shows progress with start/stop messages and handles errors.\n * Spinner is disabled in CI environments.\n *\n * @param options - Configuration options for the spinner\n * @returns The result from the executed task\n * @throws Will exit process with code 1 if task fails\n * @example\n * import { spinner } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Show spinner during async task\n * const result = await spinner({\n *   startMessage: \"Deploying...\",\n *   task: async () => {\n *     // Async work here\n *     return \"success\";\n *   },\n *   stopMessage: \"Deployed successfully!\"\n * });\n */\nexport const spinner = async <R>(options: SpinnerOptions<R>): Promise<R> => {\n  const handleError = (error: Error) => {\n    const errorMessage = maskTokens(error.message);\n    note(redBright(`${errorMessage}\\n\\n${error.stack}`));\n    throw new SpinnerError(errorMessage, error);\n  };\n  if (isInCi || !shouldPrint()) {\n    try {\n      return await options.task();\n    } catch (err) {\n      return handleError(err as Error);\n    }\n  }\n  const spinner = yoctoSpinner({ stream: process.stdout }).start(options.startMessage);\n  try {\n    const result = await options.task(spinner);\n    spinner.success(options.stopMessage);\n    // Ensure spinner success message renders before proceeding to avoid\n    // terminal output overlap issues with subsequent messages\n    await new Promise((resolve) => process.nextTick(resolve));\n    return result;\n  } catch (err) {\n    spinner.error(redBright(`${options.startMessage} --> Error!`));\n    return handleError(err as Error);\n  }\n};\n","/**\n * Capitalizes the first letter of a string.\n *\n * @param val - The string to capitalize\n * @returns The input string with its first letter capitalized\n *\n * @example\n * import { capitalizeFirstLetter } from \"@settlemint/sdk-utils\";\n *\n * const capitalized = capitalizeFirstLetter(\"hello\");\n * // Returns: \"Hello\"\n */\nexport function capitalizeFirstLetter(val: string) {\n  return String(val).charAt(0).toUpperCase() + String(val).slice(1);\n}\n\n/**\n * Converts a camelCase string to a human-readable string.\n *\n * @param s - The camelCase string to convert\n * @returns The human-readable string\n *\n * @example\n * import { camelCaseToWords } from \"@settlemint/sdk-utils\";\n *\n * const words = camelCaseToWords(\"camelCaseString\");\n * // Returns: \"Camel Case String\"\n */\nexport function camelCaseToWords(s: string) {\n  const result = s.replace(/([a-z])([A-Z])/g, \"$1 $2\");\n  const withSpaces = result.replace(/([A-Z])([a-z])/g, \" $1$2\");\n  const capitalized = capitalizeFirstLetter(withSpaces);\n  return capitalized.replace(/\\s+/g, \" \").trim();\n}\n\n/**\n * Replaces underscores and hyphens with spaces.\n *\n * @param s - The string to replace underscores and hyphens with spaces\n * @returns The input string with underscores and hyphens replaced with spaces\n *\n * @example\n * import { replaceUnderscoresAndHyphensWithSpaces } from \"@settlemint/sdk-utils\";\n *\n * const result = replaceUnderscoresAndHyphensWithSpaces(\"Already_Spaced-Second\");\n * // Returns: \"Already Spaced Second\"\n */\nexport function replaceUnderscoresAndHyphensWithSpaces(s: string) {\n  return s.replace(/[-_]/g, \" \");\n}\n\n/**\n * Truncates a string to a maximum length and appends \"...\" if it is longer.\n *\n * @param value - The string to truncate\n * @param maxLength - The maximum length of the string\n * @returns The truncated string or the original string if it is shorter than the maximum length\n *\n * @example\n * import { truncate } from \"@settlemint/sdk-utils\";\n *\n * const truncated = truncate(\"Hello, world!\", 10);\n * // Returns: \"Hello, wor...\"\n */\nexport function truncate(value: string, maxLength: number) {\n  if (value.length <= maxLength) {\n    return value;\n  }\n  return `${value.slice(0, maxLength)}...`;\n}\n","import { Table } from \"console-table-printer\";\nimport { whiteBright } from \"yoctocolors\";\nimport { camelCaseToWords } from \"@/string.js\";\nimport { note } from \"./note.js\";\nimport { shouldPrint } from \"./should-print.js\";\n/**\n * Displays data in a formatted table in the terminal.\n *\n * @param title - Title to display above the table\n * @param data - Array of objects to display in table format\n * @example\n * import { table } from \"@settlemint/sdk-utils/terminal\";\n *\n * const data = [\n *   { name: \"Item 1\", value: 100 },\n *   { name: \"Item 2\", value: 200 }\n * ];\n *\n * table(\"My Table\", data);\n */\nexport function table(title: string, data: unknown[]): void {\n  if (!shouldPrint()) {\n    return;\n  }\n\n  note(title);\n\n  if (!data || data.length === 0) {\n    note(\"No data to display\");\n    return;\n  }\n\n  const columnKeys = Object.keys(data[0] as Record<string, unknown>);\n  const table = new Table({\n    columns: columnKeys.map((key) => ({\n      name: key,\n      title: whiteBright(camelCaseToWords(key)),\n      alignment: \"left\",\n    })),\n  });\n  // biome-ignore lint/suspicious/noExplicitAny: Data structure varies based on table content\n  table.addRows(data as Array<Record<string, any>>);\n  table.printTable();\n}\n"],"mappings":"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"}
+{"version":3,"file":"terminal.js","names":["code: number","output: string[]","items","originalError: Error","spinner","table"],"sources":["../src/terminal/should-print.ts","../src/terminal/ascii.ts","../src/logging/mask-tokens.ts","../src/terminal/cancel.ts","../src/terminal/execute-command.ts","../src/terminal/intro.ts","../src/terminal/note.ts","../src/terminal/list.ts","../src/terminal/outro.ts","../src/terminal/spinner.ts","../src/string.ts","../src/terminal/table.ts"],"sourcesContent":["/**\n * Returns true if the terminal should print, false otherwise.\n * @returns true if the terminal should print, false otherwise.\n */\nexport function shouldPrint() {\n  return process.env.SETTLEMINT_DISABLE_TERMINAL !== \"true\";\n}\n","import { magentaBright } from \"yoctocolors\";\nimport { shouldPrint } from \"./should-print.js\";\n\n/**\n * Prints the SettleMint ASCII art logo to the console in magenta color.\n * Used for CLI branding and visual identification.\n *\n * @example\n * import { ascii } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Prints the SettleMint logo\n * ascii();\n */\nexport const ascii = (): void => {\n  if (!shouldPrint()) {\n    return;\n  }\n  console.log(\n    magentaBright(`\n  _________       __    __  .__            _____  .__        __\n /   _____/ _____/  |__/  |_|  |   ____   /     \\\\ |__| _____/  |_\n \\\\_____  \\\\_/ __ \\\\   __\\\\   __\\\\  | _/ __ \\\\ /  \\\\ /  \\\\|  |/    \\\\   __\\\\\n /        \\\\  ___/|  |  |  | |  |_\\\\  ___//    Y    \\\\  |   |  \\\\  |\n/_________/\\\\_____>__|  |__| |____/\\\\_____>____|____/__|___|__/__|\n`),\n  );\n};\n","/**\n * Masks sensitive SettleMint tokens in output text by replacing them with asterisks.\n * Handles personal access tokens (PAT), application access tokens (AAT), and service account tokens (SAT).\n *\n * @param output - The text string that may contain sensitive tokens\n * @returns The text with any sensitive tokens masked with asterisks\n * @example\n * import { maskTokens } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Masks a token in text\n * const masked = maskTokens(\"Token: sm_pat_****\"); // \"Token: ***\"\n */\nexport const maskTokens = (output: string): string => {\n  return output.replace(/sm_(pat|aat|sat)_[0-9a-zA-Z]+/g, \"***\");\n};\n","import { maskTokens } from \"@/logging/mask-tokens.js\";\nimport { inverse, redBright } from \"yoctocolors\";\n\n/**\n * Error class used to indicate that the operation was cancelled.\n * This error is used to signal that the operation should be aborted.\n */\nexport class CancelError extends Error {}\n\n/**\n * Displays an error message in red inverse text and throws a CancelError.\n * Used to terminate execution with a visible error message.\n * Any sensitive tokens in the message are masked before display.\n *\n * @param msg - The error message to display\n * @returns never - Function does not return as it throws an error\n * @example\n * import { cancel } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Exits process with error message\n * cancel(\"An error occurred\");\n */\nexport const cancel = (msg: string): never => {\n  console.log(\"\");\n  console.log(inverse(redBright(maskTokens(msg))));\n  console.log(\"\");\n  throw new CancelError(msg);\n};\n","import { type SpawnOptionsWithoutStdio, spawn } from \"node:child_process\";\nimport { maskTokens } from \"../logging/mask-tokens.js\";\n\n/**\n * Options for executing a command, extending SpawnOptionsWithoutStdio\n */\nexport interface ExecuteCommandOptions extends SpawnOptionsWithoutStdio {\n  /** Whether to suppress output to stdout/stderr */\n  silent?: boolean;\n}\n\n/**\n * Error class for command execution errors\n * @extends Error\n */\nexport class CommandError extends Error {\n  /**\n   * Constructs a new CommandError\n   * @param message - The error message\n   * @param code - The exit code of the command\n   * @param output - The output of the command\n   */\n  constructor(\n    message: string,\n    public readonly code: number,\n    public readonly output: string[],\n  ) {\n    super(message);\n  }\n}\n\n/**\n * Executes a command with the given arguments in a child process.\n * Pipes stdin to the child process and captures stdout/stderr output.\n * Masks any sensitive tokens in the output before displaying or returning.\n *\n * @param command - The command to execute\n * @param args - Array of arguments to pass to the command\n * @param options - Options for customizing command execution\n * @returns Array of output strings from stdout and stderr\n * @throws {CommandError} If the process fails to start or exits with non-zero code\n * @example\n * import { executeCommand } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Execute git clone\n * await executeCommand(\"git\", [\"clone\", \"repo-url\"]);\n *\n * // Execute silently\n * await executeCommand(\"npm\", [\"install\"], { silent: true });\n */\nexport async function executeCommand(\n  command: string,\n  args: string[],\n  options?: ExecuteCommandOptions,\n): Promise<string[]> {\n  const { silent, ...spawnOptions } = options ?? {};\n  const child = spawn(command, args, { ...spawnOptions, env: { ...process.env, ...options?.env } });\n  process.stdin.pipe(child.stdin);\n  const output: string[] = [];\n  return new Promise((resolve, reject) => {\n    child.stdout.on(\"data\", (data: Buffer | string) => {\n      const maskedData = maskTokens(data.toString());\n      if (!silent) {\n        process.stdout.write(maskedData);\n      }\n      output.push(maskedData);\n    });\n    child.stderr.on(\"data\", (data: Buffer | string) => {\n      const maskedData = maskTokens(data.toString());\n      if (!silent) {\n        process.stderr.write(maskedData);\n      }\n      output.push(maskedData);\n    });\n    child.on(\"error\", (err) => {\n      process.stdin.unpipe(child.stdin);\n      reject(new CommandError(err.message, \"code\" in err && typeof err.code === \"number\" ? err.code : 1, output));\n    });\n    child.on(\"close\", (code) => {\n      process.stdin.unpipe(child.stdin);\n      if (code === 0 || code === null || code === 143) {\n        resolve(output);\n        return;\n      }\n      reject(new CommandError(`Command \"${command}\" exited with code ${code}`, code, output));\n    });\n  });\n}\n","import { maskTokens } from \"@/logging/mask-tokens.js\";\nimport { magentaBright } from \"yoctocolors\";\nimport { shouldPrint } from \"./should-print.js\";\n\n/**\n * Displays an introductory message in magenta text with padding.\n * Any sensitive tokens in the message are masked before display.\n *\n * @param msg - The message to display as introduction\n * @example\n * import { intro } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Display intro message\n * intro(\"Starting deployment...\");\n */\nexport const intro = (msg: string): void => {\n  if (!shouldPrint()) {\n    return;\n  }\n  console.log(\"\");\n  console.log(magentaBright(maskTokens(msg)));\n  console.log(\"\");\n};\n","import { maskTokens } from \"@/logging/mask-tokens.js\";\nimport { yellowBright } from \"yoctocolors\";\nimport { shouldPrint } from \"./should-print.js\";\n\n/**\n * Displays a note message with optional warning level formatting.\n * Regular notes are displayed in normal text, while warnings are shown in yellow.\n * Any sensitive tokens in the message are masked before display.\n *\n * @param message - The message to display as a note\n * @param level - The note level: \"info\" (default) or \"warn\" for warning styling\n * @example\n * import { note } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Display info note\n * note(\"Operation completed successfully\");\n *\n * // Display warning note\n * note(\"Low disk space remaining\", \"warn\");\n */\nexport const note = (message: string, level: \"info\" | \"warn\" = \"info\"): void => {\n  if (!shouldPrint()) {\n    return;\n  }\n  const maskedMessage = maskTokens(message);\n\n  console.log(\"\");\n  if (level === \"warn\") {\n    console.warn(yellowBright(maskedMessage));\n    return;\n  }\n\n  console.log(maskedMessage);\n};\n","import { note } from \"./note.js\";\n\n/**\n * Displays a list of items in a formatted manner, supporting nested items.\n *\n * @param title - The title of the list\n * @param items - The items to display, can be strings or arrays for nested items\n * @returns The formatted list\n * @example\n * import { list } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Simple list\n * list(\"Use cases\", [\"use case 1\", \"use case 2\", \"use case 3\"]);\n *\n * // Nested list\n * list(\"Providers\", [\n *   \"AWS\",\n *   [\"us-east-1\", \"eu-west-1\"],\n *   \"Azure\",\n *   [\"eastus\", \"westeurope\"]\n * ]);\n */\nexport function list(title: string, items: Array<string | string[]>) {\n  const formatItems = (items: Array<string | string[]>): string => {\n    return items\n      .map((item) => {\n        if (Array.isArray(item)) {\n          return item.map((subItem) => `    • ${subItem}`).join(\"\\n\");\n        }\n        return `  • ${item}`;\n      })\n      .join(\"\\n\");\n  };\n\n  return note(`${title}:\\n\\n${formatItems(items)}`);\n}\n","import { maskTokens } from \"@/logging/mask-tokens.js\";\nimport { shouldPrint } from \"@/terminal/should-print.js\";\nimport { greenBright, inverse } from \"yoctocolors\";\n\n/**\n * Displays a closing message in green inverted text with padding.\n * Any sensitive tokens in the message are masked before display.\n *\n * @param msg - The message to display as conclusion\n * @example\n * import { outro } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Display outro message\n * outro(\"Deployment completed successfully!\");\n */\nexport const outro = (msg: string): void => {\n  if (!shouldPrint()) {\n    return;\n  }\n  console.log(\"\");\n  console.log(inverse(greenBright(maskTokens(msg))));\n  console.log(\"\");\n};\n","import isInCi from \"is-in-ci\";\nimport yoctoSpinner, { type Spinner } from \"yocto-spinner\";\nimport { redBright } from \"yoctocolors\";\nimport { maskTokens } from \"../logging/mask-tokens.js\";\nimport { note } from \"./note.js\";\nimport { shouldPrint } from \"./should-print.js\";\n\n/**\n * Error class used to indicate that the spinner operation failed.\n * This error is used to signal that the operation should be aborted.\n */\nexport class SpinnerError extends Error {\n  constructor(\n    message: string,\n    public readonly originalError: Error,\n  ) {\n    super(message);\n    this.name = \"SpinnerError\";\n  }\n}\n\n/**\n * Options for configuring the spinner behavior\n */\nexport interface SpinnerOptions<R> {\n  /** Message to display when spinner starts */\n  startMessage: string;\n  /** Async task to execute while spinner is active */\n  task: (spinner?: Spinner) => Promise<R>;\n  /** Message to display when spinner completes successfully */\n  stopMessage: string;\n}\n\n/**\n * Displays a loading spinner while executing an async task.\n * Shows progress with start/stop messages and handles errors.\n * Spinner is disabled in CI environments.\n *\n * @param options - Configuration options for the spinner\n * @returns The result from the executed task\n * @throws Will exit process with code 1 if task fails\n * @example\n * import { spinner } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Show spinner during async task\n * const result = await spinner({\n *   startMessage: \"Deploying...\",\n *   task: async () => {\n *     // Async work here\n *     return \"success\";\n *   },\n *   stopMessage: \"Deployed successfully!\"\n * });\n */\nexport const spinner = async <R>(options: SpinnerOptions<R>): Promise<R> => {\n  const handleError = (error: Error) => {\n    const errorMessage = maskTokens(error.message);\n    note(redBright(`${errorMessage}\\n\\n${error.stack}`));\n    throw new SpinnerError(errorMessage, error);\n  };\n  if (isInCi || !shouldPrint()) {\n    try {\n      return await options.task();\n    } catch (err) {\n      return handleError(err as Error);\n    }\n  }\n  const spinner = yoctoSpinner({ stream: process.stdout }).start(options.startMessage);\n  try {\n    const result = await options.task(spinner);\n    spinner.success(options.stopMessage);\n    // Ensure spinner success message renders before proceeding to avoid\n    // terminal output overlap issues with subsequent messages\n    await new Promise((resolve) => process.nextTick(resolve));\n    return result;\n  } catch (err) {\n    spinner.error(redBright(`${options.startMessage} --> Error!`));\n    return handleError(err as Error);\n  }\n};\n","/**\n * Capitalizes the first letter of a string.\n *\n * @param val - The string to capitalize\n * @returns The input string with its first letter capitalized\n *\n * @example\n * import { capitalizeFirstLetter } from \"@settlemint/sdk-utils\";\n *\n * const capitalized = capitalizeFirstLetter(\"hello\");\n * // Returns: \"Hello\"\n */\nexport function capitalizeFirstLetter(val: string) {\n  return String(val).charAt(0).toUpperCase() + String(val).slice(1);\n}\n\n/**\n * Converts a camelCase string to a human-readable string.\n *\n * @param s - The camelCase string to convert\n * @returns The human-readable string\n *\n * @example\n * import { camelCaseToWords } from \"@settlemint/sdk-utils\";\n *\n * const words = camelCaseToWords(\"camelCaseString\");\n * // Returns: \"Camel Case String\"\n */\nexport function camelCaseToWords(s: string) {\n  const result = s.replace(/([a-z])([A-Z])/g, \"$1 $2\");\n  const withSpaces = result.replace(/([A-Z])([a-z])/g, \" $1$2\");\n  const capitalized = capitalizeFirstLetter(withSpaces);\n  return capitalized.replace(/\\s+/g, \" \").trim();\n}\n\n/**\n * Replaces underscores and hyphens with spaces.\n *\n * @param s - The string to replace underscores and hyphens with spaces\n * @returns The input string with underscores and hyphens replaced with spaces\n *\n * @example\n * import { replaceUnderscoresAndHyphensWithSpaces } from \"@settlemint/sdk-utils\";\n *\n * const result = replaceUnderscoresAndHyphensWithSpaces(\"Already_Spaced-Second\");\n * // Returns: \"Already Spaced Second\"\n */\nexport function replaceUnderscoresAndHyphensWithSpaces(s: string) {\n  return s.replace(/[-_]/g, \" \");\n}\n\n/**\n * Truncates a string to a maximum length and appends \"...\" if it is longer.\n *\n * @param value - The string to truncate\n * @param maxLength - The maximum length of the string\n * @returns The truncated string or the original string if it is shorter than the maximum length\n *\n * @example\n * import { truncate } from \"@settlemint/sdk-utils\";\n *\n * const truncated = truncate(\"Hello, world!\", 10);\n * // Returns: \"Hello, wor...\"\n */\nexport function truncate(value: string, maxLength: number) {\n  if (value.length <= maxLength) {\n    return value;\n  }\n  return `${value.slice(0, maxLength)}...`;\n}\n","import { Table } from \"console-table-printer\";\nimport { whiteBright } from \"yoctocolors\";\nimport { camelCaseToWords } from \"@/string.js\";\nimport { note } from \"./note.js\";\nimport { shouldPrint } from \"./should-print.js\";\n/**\n * Displays data in a formatted table in the terminal.\n *\n * @param title - Title to display above the table\n * @param data - Array of objects to display in table format\n * @example\n * import { table } from \"@settlemint/sdk-utils/terminal\";\n *\n * const data = [\n *   { name: \"Item 1\", value: 100 },\n *   { name: \"Item 2\", value: 200 }\n * ];\n *\n * table(\"My Table\", data);\n */\nexport function table(title: string, data: unknown[]): void {\n  if (!shouldPrint()) {\n    return;\n  }\n\n  note(title);\n\n  if (!data || data.length === 0) {\n    note(\"No data to display\");\n    return;\n  }\n\n  const columnKeys = Object.keys(data[0] as Record<string, unknown>);\n  const table = new Table({\n    columns: columnKeys.map((key) => ({\n      name: key,\n      title: whiteBright(camelCaseToWords(key)),\n      alignment: \"left\",\n    })),\n  });\n  // biome-ignore lint/suspicious/noExplicitAny: Data structure varies based on table content\n  table.addRows(data as Array<Record<string, any>>);\n  table.printTable();\n}\n"],"mappings":"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"}

package/dist/url.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"url.cjs","names":[],"sources":["../src/url.ts"],"sourcesContent":["/**\n * Extracts the base URL before a specific segment in a URL.\n *\n * @param baseUrl - The base URL to extract the path from\n * @param pathSegment - The path segment to start from\n * @returns The base URL before the specified segment\n * @example\n * ```typescript\n * import { extractBaseUrlBeforeSegment } from \"@settlemint/sdk-utils/url\";\n *\n * const baseUrl = extractBaseUrlBeforeSegment(\"https://example.com/api/v1/subgraphs/name/my-subgraph\", \"/subgraphs\");\n * // Returns: \"https://example.com/api/v1\"\n * ```\n */\nexport function extractBaseUrlBeforeSegment(baseUrl: string, pathSegment: string) {\n  const url = new URL(baseUrl);\n  if (pathSegment.trim() === \"\") {\n    return url.toString();\n  }\n  const segmentIndex = url.pathname.indexOf(pathSegment);\n  return url.origin + (segmentIndex >= 0 ? url.pathname.substring(0, segmentIndex) : url.pathname);\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAcA,SAAgB,4BAA4B,SAAiB,aAAqB;CAChF,MAAM,MAAM,IAAI,IAAI;AACpB,KAAI,YAAY,WAAW,IAAI;AAC7B,SAAO,IAAI;;CAEb,MAAM,eAAe,IAAI,SAAS,QAAQ;AAC1C,QAAO,IAAI,UAAU,gBAAgB,IAAI,IAAI,SAAS,UAAU,GAAG,gBAAgB,IAAI"}
+{"version":3,"file":"url.cjs","names":[],"sources":["../src/url.ts"],"sourcesContent":["/**\n * Extracts the base URL before a specific segment in a URL.\n *\n * @param baseUrl - The base URL to extract the path from\n * @param pathSegment - The path segment to start from\n * @returns The base URL before the specified segment\n * @example\n * ```typescript\n * import { extractBaseUrlBeforeSegment } from \"@settlemint/sdk-utils/url\";\n *\n * const baseUrl = extractBaseUrlBeforeSegment(\"https://example.com/api/v1/subgraphs/name/my-subgraph\", \"/subgraphs\");\n * // Returns: \"https://example.com/api/v1\"\n * ```\n */\nexport function extractBaseUrlBeforeSegment(baseUrl: string, pathSegment: string) {\n  const url = new URL(baseUrl);\n  if (pathSegment.trim() === \"\") {\n    return url.toString();\n  }\n  const segmentIndex = url.pathname.indexOf(pathSegment);\n  return url.origin + (segmentIndex >= 0 ? url.pathname.substring(0, segmentIndex) : url.pathname);\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAcA,SAAgB,4BAA4B,SAAiB,aAAqB;CAChF,MAAM,MAAM,IAAI,IAAI,QAAQ;AAC5B,KAAI,YAAY,MAAM,KAAK,IAAI;AAC7B,SAAO,IAAI,UAAU;;CAEvB,MAAM,eAAe,IAAI,SAAS,QAAQ,YAAY;AACtD,QAAO,IAAI,UAAU,gBAAgB,IAAI,IAAI,SAAS,UAAU,GAAG,aAAa,GAAG,IAAI"}

package/dist/url.js.map

@@ -1 +1 @@
-{"version":3,"file":"url.js","names":[],"sources":["../src/url.ts"],"sourcesContent":["/**\n * Extracts the base URL before a specific segment in a URL.\n *\n * @param baseUrl - The base URL to extract the path from\n * @param pathSegment - The path segment to start from\n * @returns The base URL before the specified segment\n * @example\n * ```typescript\n * import { extractBaseUrlBeforeSegment } from \"@settlemint/sdk-utils/url\";\n *\n * const baseUrl = extractBaseUrlBeforeSegment(\"https://example.com/api/v1/subgraphs/name/my-subgraph\", \"/subgraphs\");\n * // Returns: \"https://example.com/api/v1\"\n * ```\n */\nexport function extractBaseUrlBeforeSegment(baseUrl: string, pathSegment: string) {\n  const url = new URL(baseUrl);\n  if (pathSegment.trim() === \"\") {\n    return url.toString();\n  }\n  const segmentIndex = url.pathname.indexOf(pathSegment);\n  return url.origin + (segmentIndex >= 0 ? url.pathname.substring(0, segmentIndex) : url.pathname);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAcA,SAAgB,4BAA4B,SAAiB,aAAqB;CAChF,MAAM,MAAM,IAAI,IAAI;AACpB,KAAI,YAAY,WAAW,IAAI;AAC7B,SAAO,IAAI;;CAEb,MAAM,eAAe,IAAI,SAAS,QAAQ;AAC1C,QAAO,IAAI,UAAU,gBAAgB,IAAI,IAAI,SAAS,UAAU,GAAG,gBAAgB,IAAI"}
+{"version":3,"file":"url.js","names":[],"sources":["../src/url.ts"],"sourcesContent":["/**\n * Extracts the base URL before a specific segment in a URL.\n *\n * @param baseUrl - The base URL to extract the path from\n * @param pathSegment - The path segment to start from\n * @returns The base URL before the specified segment\n * @example\n * ```typescript\n * import { extractBaseUrlBeforeSegment } from \"@settlemint/sdk-utils/url\";\n *\n * const baseUrl = extractBaseUrlBeforeSegment(\"https://example.com/api/v1/subgraphs/name/my-subgraph\", \"/subgraphs\");\n * // Returns: \"https://example.com/api/v1\"\n * ```\n */\nexport function extractBaseUrlBeforeSegment(baseUrl: string, pathSegment: string) {\n  const url = new URL(baseUrl);\n  if (pathSegment.trim() === \"\") {\n    return url.toString();\n  }\n  const segmentIndex = url.pathname.indexOf(pathSegment);\n  return url.origin + (segmentIndex >= 0 ? url.pathname.substring(0, segmentIndex) : url.pathname);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAcA,SAAgB,4BAA4B,SAAiB,aAAqB;CAChF,MAAM,MAAM,IAAI,IAAI,QAAQ;AAC5B,KAAI,YAAY,MAAM,KAAK,IAAI;AAC7B,SAAO,IAAI,UAAU;;CAEvB,MAAM,eAAe,IAAI,SAAS,QAAQ,YAAY;AACtD,QAAO,IAAI,UAAU,gBAAgB,IAAI,IAAI,SAAS,UAAU,GAAG,aAAa,GAAG,IAAI"}

package/dist/validation.cjs

@@ -21,7 +21,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-const zod = __toESM(require("zod"));
+let zod = require("zod");
+zod = __toESM(zod);
 
 //#region src/validation/validate.ts
 /**

package/dist/validation.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"validation.cjs","names":["ZodError","ApplicationAccessTokenSchema: ZodString","z","PersonalAccessTokenSchema: ZodString","AccessTokenSchema: ZodString","value","z","z","z","z"],"sources":["../src/validation/validate.ts","../src/validation/access-token.schema.ts","../src/json.ts","../src/validation/unique-name.schema.ts","../src/validation/url.schema.ts","../src/validation/dot-env.schema.ts","../src/validation/id.schema.ts"],"sourcesContent":["import { ZodError, type ZodType } from \"zod\";\n\n/**\n * Validates a value against a given Zod schema.\n *\n * @param schema - The Zod schema to validate against.\n * @param value - The value to validate.\n * @returns The validated and parsed value.\n * @throws Will throw an error if validation fails, with formatted error messages.\n *\n * @example\n * import { validate } from \"@settlemint/sdk-utils/validation\";\n *\n * const validatedId = validate(IdSchema, \"550e8400-e29b-41d4-a716-446655440000\");\n */\nexport function validate<T extends ZodType>(schema: T, value: unknown): T[\"_output\"] {\n  try {\n    return schema.parse(value);\n  } catch (error) {\n    if (error instanceof ZodError) {\n      const formattedErrors = error.issues.map((err) => `- ${err.path.join(\".\")}: ${err.message}`).join(\"\\n\");\n      throw new Error(`Validation error${error.issues.length > 1 ? \"s\" : \"\"}:\\n${formattedErrors}`);\n    }\n    throw error; // Re-throw if it's not a ZodError\n  }\n}\n","import { type ZodString, z } from \"zod\";\n\n/**\n * Schema for validating application access tokens.\n * Application access tokens start with 'sm_aat_' prefix.\n */\nexport const ApplicationAccessTokenSchema: ZodString = z.string().regex(/^sm_aat_.+$/);\nexport type ApplicationAccessToken = z.infer<typeof ApplicationAccessTokenSchema>;\n\n/**\n * Schema for validating personal access tokens.\n * Personal access tokens start with 'sm_pat_' prefix.\n */\nexport const PersonalAccessTokenSchema: ZodString = z.string().regex(/^sm_pat_.+$/);\nexport type PersonalAccessToken = z.infer<typeof PersonalAccessTokenSchema>;\n\n/**\n * Schema for validating both application and personal access tokens.\n * Accepts tokens starting with either 'sm_pat_' or 'sm_aat_' prefix.\n */\nexport const AccessTokenSchema: ZodString = z.string().regex(/^(sm_pat_.+|sm_aat_.+)$/);\nexport type AccessToken = z.infer<typeof AccessTokenSchema>;\n","/**\n * Attempts to parse a JSON string into a typed value, returning a default value if parsing fails.\n *\n * @param value - The JSON string to parse\n * @param defaultValue - The value to return if parsing fails or results in null/undefined\n * @returns The parsed JSON value as type T, or the default value if parsing fails\n *\n * @example\n * import { tryParseJson } from \"@settlemint/sdk-utils\";\n *\n * const config = tryParseJson<{ port: number }>(\n *   '{\"port\": 3000}',\n *   { port: 8080 }\n * );\n * // Returns: { port: 3000 }\n *\n * const invalid = tryParseJson<string[]>(\n *   'invalid json',\n *   []\n * );\n * // Returns: []\n */\nexport function tryParseJson<T>(value: string, defaultValue: T | null = null): T | null {\n  try {\n    const parsed = JSON.parse(value) as T;\n    if (parsed === undefined || parsed === null) {\n      return defaultValue;\n    }\n    return parsed;\n  } catch (_err) {\n    // Invalid json\n    return defaultValue;\n  }\n}\n\n/**\n * Extracts a JSON object from a string.\n *\n * @param value - The string to extract the JSON object from\n * @returns The parsed JSON object, or null if no JSON object is found\n * @throws {Error} If the input string is too long (longer than 5000 characters)\n * @example\n * import { extractJsonObject } from \"@settlemint/sdk-utils\";\n *\n * const json = extractJsonObject<{ port: number }>(\n *   'port info: {\"port\": 3000}',\n * );\n * // Returns: { port: 3000 }\n */\nexport function extractJsonObject<T>(value: string): T | null {\n  if (value.length > 5000) {\n    throw new Error(\"Input too long\");\n  }\n  const result = /\\{([\\s\\S]*)\\}/.exec(value);\n  if (!result) {\n    return null;\n  }\n  return tryParseJson<T>(result[0]);\n}\n\n/**\n * Converts a value to a JSON stringifiable format.\n *\n * @param value - The value to convert\n * @returns The JSON stringifiable value\n *\n * @example\n * import { makeJsonStringifiable } from \"@settlemint/sdk-utils\";\n *\n * const json = makeJsonStringifiable<{ amount: bigint }>({ amount: BigInt(1000) });\n * // Returns: '{\"amount\":\"1000\"}'\n */\nexport function makeJsonStringifiable<T>(value: unknown): T {\n  if (value === undefined || value === null) {\n    return value as T;\n  }\n  return tryParseJson<T>(\n    JSON.stringify(\n      value,\n      (_, value) => (typeof value === \"bigint\" ? value.toString() : value), // return everything else unchanged\n    ),\n  ) as T;\n}\n","import { z } from \"zod\";\n\n/**\n * Schema for validating unique names used across the SettleMint platform.\n * Only accepts lowercase alphanumeric characters and hyphens.\n * Used for workspace names, application names, service names etc.\n *\n * @example\n * import { UniqueNameSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate a workspace name\n * const isValidName = UniqueNameSchema.safeParse(\"my-workspace-123\").success;\n * // true\n *\n * // Invalid names will fail validation\n * const isInvalidName = UniqueNameSchema.safeParse(\"My Workspace!\").success;\n * // false\n */\nexport const UniqueNameSchema = z.string().regex(/^[a-z0-9-]+$/);\n\n/**\n * Type definition for unique names, inferred from UniqueNameSchema.\n */\nexport type UniqueName = z.infer<typeof UniqueNameSchema>;\n","import { z } from \"zod\";\n\n/**\n * Schema for validating URLs.\n *\n * @example\n * import { UrlSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate a URL\n * const isValidUrl = UrlSchema.safeParse(\"https://console.settlemint.com\").success;\n * // true\n *\n * // Invalid URLs will fail validation\n * const isInvalidUrl = UrlSchema.safeParse(\"not-a-url\").success;\n * // false\n */\nexport const UrlSchema = z.string().url();\nexport type Url = z.infer<typeof UrlSchema>;\n\n/**\n * Schema for validating URL paths.\n *\n * @example\n * import { UrlPathSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate a URL path\n * const isValidPath = UrlPathSchema.safeParse(\"/api/v1/users\").success;\n * // true\n *\n * // Invalid paths will fail validation\n * const isInvalidPath = UrlPathSchema.safeParse(\"not-a-path\").success;\n * // false\n */\nexport const UrlPathSchema = z.string().regex(/^\\/(?:[a-zA-Z0-9-_]+(?:\\/[a-zA-Z0-9-_]+)*\\/?)?$/, {\n  message: \"Invalid URL path format. Must start with '/' and can contain letters, numbers, hyphens, and underscores.\",\n});\n\nexport type UrlPath = z.infer<typeof UrlPathSchema>;\n\n/**\n * Schema that accepts either a full URL or a URL path.\n *\n * @example\n * import { UrlOrPathSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate a URL\n * const isValidUrl = UrlOrPathSchema.safeParse(\"https://console.settlemint.com\").success;\n * // true\n *\n * // Validate a path\n * const isValidPath = UrlOrPathSchema.safeParse(\"/api/v1/users\").success;\n * // true\n */\nexport const UrlOrPathSchema = z.union([UrlSchema, UrlPathSchema]);\nexport type UrlOrPath = z.infer<typeof UrlOrPathSchema>;\n","import { z } from \"zod\";\nimport { tryParseJson } from \"@/json.js\";\nimport { ApplicationAccessTokenSchema, PersonalAccessTokenSchema } from \"./access-token.schema.js\";\nimport { UniqueNameSchema } from \"./unique-name.schema.js\";\nimport { UrlSchema } from \"./url.schema.js\";\n\n/**\n * Use this value to indicate that the resources are not part of the SettleMint platform.\n */\nexport const STANDALONE_INSTANCE = \"standalone\";\n/**\n * Use this value to indicate that the resources are not part of the SettleMint platform.\n */\nexport const LOCAL_INSTANCE = \"local\";\n\n/**\n * Schema for validating environment variables used by the SettleMint SDK.\n * Defines validation rules and types for configuration values like URLs,\n * access tokens, workspace names, and service endpoints.\n */\nexport const DotEnvSchema = z.object({\n  /** Base URL of the SettleMint platform instance, set to standalone if your resources are not part of the SettleMint platform */\n  SETTLEMINT_INSTANCE: z\n    .union([UrlSchema, z.literal(STANDALONE_INSTANCE), z.literal(LOCAL_INSTANCE)])\n    .default(\"https://console.settlemint.com\"),\n  /** Application access token for authenticating with SettleMint services */\n  SETTLEMINT_ACCESS_TOKEN: ApplicationAccessTokenSchema.optional(),\n  /** @internal */\n  SETTLEMINT_PERSONAL_ACCESS_TOKEN: PersonalAccessTokenSchema.optional(),\n  /** Unique name of the workspace */\n  SETTLEMINT_WORKSPACE: UniqueNameSchema.optional(),\n  /** Unique name of the application */\n  SETTLEMINT_APPLICATION: UniqueNameSchema.optional(),\n  /** Unique name of the blockchain network */\n  SETTLEMINT_BLOCKCHAIN_NETWORK: UniqueNameSchema.optional(),\n  /** Chain ID of the blockchain network */\n  SETTLEMINT_BLOCKCHAIN_NETWORK_CHAIN_ID: z.string().optional(),\n  /** Unique name of the blockchain node (should have a private key for signing transactions) */\n  SETTLEMINT_BLOCKCHAIN_NODE: UniqueNameSchema.optional(),\n  /** JSON RPC endpoint for the blockchain node */\n  SETTLEMINT_BLOCKCHAIN_NODE_JSON_RPC_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the blockchain node or load balancer */\n  SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER: UniqueNameSchema.optional(),\n  /** JSON RPC endpoint for the blockchain node or load balancer */\n  SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER_JSON_RPC_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the Hasura instance */\n  SETTLEMINT_HASURA: UniqueNameSchema.optional(),\n  /** Endpoint URL for the Hasura GraphQL API */\n  SETTLEMINT_HASURA_ENDPOINT: UrlSchema.optional(),\n  /** Admin secret for authenticating with Hasura */\n  SETTLEMINT_HASURA_ADMIN_SECRET: z.string().optional(),\n  /** Database connection URL for Hasura */\n  SETTLEMINT_HASURA_DATABASE_URL: z.string().optional(),\n  /** Unique name of The Graph instance */\n  SETTLEMINT_THEGRAPH: UniqueNameSchema.optional(),\n  /** Array of endpoint URLs for The Graph subgraphs */\n  SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS: z.preprocess(\n    (value) => tryParseJson(value as string, []),\n    z.array(UrlSchema).optional(),\n  ),\n  /** Default The Graph subgraph to use */\n  SETTLEMINT_THEGRAPH_DEFAULT_SUBGRAPH: z.string().optional(),\n  /** Unique name of the Smart Contract Portal instance */\n  SETTLEMINT_PORTAL: UniqueNameSchema.optional(),\n  /** GraphQL endpoint URL for the Portal */\n  SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT: UrlSchema.optional(),\n  /** REST endpoint URL for the Portal */\n  SETTLEMINT_PORTAL_REST_ENDPOINT: UrlSchema.optional(),\n  /** WebSocket endpoint URL for the Portal */\n  SETTLEMINT_PORTAL_WS_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the HD private key */\n  SETTLEMINT_HD_PRIVATE_KEY: UniqueNameSchema.optional(),\n  /** Address of the HD private key forwarder */\n  SETTLEMINT_HD_PRIVATE_KEY_FORWARDER_ADDRESS: z.string().optional(),\n  /** Unique name of the accessible private key */\n  SETTLEMINT_ACCESSIBLE_PRIVATE_KEY: UniqueNameSchema.optional(),\n  /** Unique name of the MinIO instance */\n  SETTLEMINT_MINIO: UniqueNameSchema.optional(),\n  /** Endpoint URL for MinIO */\n  SETTLEMINT_MINIO_ENDPOINT: UrlSchema.optional(),\n  /** Access key for MinIO authentication */\n  SETTLEMINT_MINIO_ACCESS_KEY: z.string().optional(),\n  /** Secret key for MinIO authentication */\n  SETTLEMINT_MINIO_SECRET_KEY: z.string().optional(),\n  /** Unique name of the IPFS instance */\n  SETTLEMINT_IPFS: UniqueNameSchema.optional(),\n  /** API endpoint URL for IPFS */\n  SETTLEMINT_IPFS_API_ENDPOINT: UrlSchema.optional(),\n  /** Pinning service endpoint URL for IPFS */\n  SETTLEMINT_IPFS_PINNING_ENDPOINT: UrlSchema.optional(),\n  /** Gateway endpoint URL for IPFS */\n  SETTLEMINT_IPFS_GATEWAY_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the custom deployment */\n  SETTLEMINT_CUSTOM_DEPLOYMENT: UniqueNameSchema.optional(),\n  /** Endpoint URL for the custom deployment */\n  SETTLEMINT_CUSTOM_DEPLOYMENT_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the Blockscout instance */\n  SETTLEMINT_BLOCKSCOUT: UniqueNameSchema.optional(),\n  /** GraphQL endpoint URL for Blockscout */\n  SETTLEMINT_BLOCKSCOUT_GRAPHQL_ENDPOINT: UrlSchema.optional(),\n  /** UI endpoint URL for Blockscout */\n  SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT: UrlSchema.optional(),\n  /** Name of the new project being created */\n  SETTLEMINT_NEW_PROJECT_NAME: z.string().optional(),\n  /** The log level to use */\n  SETTLEMINT_LOG_LEVEL: z.enum([\"debug\", \"info\", \"warn\", \"error\", \"none\"]).default(\"warn\"),\n});\n\n/**\n * Type definition for the environment variables schema.\n */\nexport type DotEnv = z.infer<typeof DotEnvSchema>;\n\n/**\n * Partial version of the environment variables schema where all fields are optional.\n * Useful for validating incomplete configurations during development or build time.\n */\nexport const DotEnvSchemaPartial = DotEnvSchema.partial();\n\n/**\n * Type definition for the partial environment variables schema.\n */\nexport type DotEnvPartial = z.infer<typeof DotEnvSchemaPartial>;\n","import { z } from \"zod\";\n\n/**\n * Schema for validating database IDs. Accepts both PostgreSQL UUIDs and MongoDB ObjectIDs.\n * PostgreSQL UUIDs are 32 hexadecimal characters with hyphens (e.g. 123e4567-e89b-12d3-a456-426614174000).\n * MongoDB ObjectIDs are 24 hexadecimal characters (e.g. 507f1f77bcf86cd799439011).\n *\n * @example\n * import { IdSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate PostgreSQL UUID\n * const isValidUuid = IdSchema.safeParse(\"123e4567-e89b-12d3-a456-426614174000\").success;\n *\n * // Validate MongoDB ObjectID\n * const isValidObjectId = IdSchema.safeParse(\"507f1f77bcf86cd799439011\").success;\n */\nexport const IdSchema = z.union([\n  z\n    .string()\n    .uuid(), // PostgreSQL UUID\n  z\n    .string()\n    .regex(/^[0-9a-fA-F]{24}$/), // MongoDB ObjectID\n]);\n\n/**\n * Type definition for database IDs, inferred from IdSchema.\n * Can be either a PostgreSQL UUID string or MongoDB ObjectID string.\n */\nexport type Id = z.infer<typeof IdSchema>;\n"],"mappings":"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"}
+{"version":3,"file":"validation.cjs","names":["ZodError","ApplicationAccessTokenSchema: ZodString","z","PersonalAccessTokenSchema: ZodString","AccessTokenSchema: ZodString","value","z","z","z","z"],"sources":["../src/validation/validate.ts","../src/validation/access-token.schema.ts","../src/json.ts","../src/validation/unique-name.schema.ts","../src/validation/url.schema.ts","../src/validation/dot-env.schema.ts","../src/validation/id.schema.ts"],"sourcesContent":["import { ZodError, type ZodType } from \"zod\";\n\n/**\n * Validates a value against a given Zod schema.\n *\n * @param schema - The Zod schema to validate against.\n * @param value - The value to validate.\n * @returns The validated and parsed value.\n * @throws Will throw an error if validation fails, with formatted error messages.\n *\n * @example\n * import { validate } from \"@settlemint/sdk-utils/validation\";\n *\n * const validatedId = validate(IdSchema, \"550e8400-e29b-41d4-a716-446655440000\");\n */\nexport function validate<T extends ZodType>(schema: T, value: unknown): T[\"_output\"] {\n  try {\n    return schema.parse(value);\n  } catch (error) {\n    if (error instanceof ZodError) {\n      const formattedErrors = error.issues.map((err) => `- ${err.path.join(\".\")}: ${err.message}`).join(\"\\n\");\n      throw new Error(`Validation error${error.issues.length > 1 ? \"s\" : \"\"}:\\n${formattedErrors}`);\n    }\n    throw error; // Re-throw if it's not a ZodError\n  }\n}\n","import { type ZodString, z } from \"zod\";\n\n/**\n * Schema for validating application access tokens.\n * Application access tokens start with 'sm_aat_' prefix.\n */\nexport const ApplicationAccessTokenSchema: ZodString = z.string().regex(/^sm_aat_.+$/);\nexport type ApplicationAccessToken = z.infer<typeof ApplicationAccessTokenSchema>;\n\n/**\n * Schema for validating personal access tokens.\n * Personal access tokens start with 'sm_pat_' prefix.\n */\nexport const PersonalAccessTokenSchema: ZodString = z.string().regex(/^sm_pat_.+$/);\nexport type PersonalAccessToken = z.infer<typeof PersonalAccessTokenSchema>;\n\n/**\n * Schema for validating both application and personal access tokens.\n * Accepts tokens starting with either 'sm_pat_' or 'sm_aat_' prefix.\n */\nexport const AccessTokenSchema: ZodString = z.string().regex(/^(sm_pat_.+|sm_aat_.+)$/);\nexport type AccessToken = z.infer<typeof AccessTokenSchema>;\n","/**\n * Attempts to parse a JSON string into a typed value, returning a default value if parsing fails.\n *\n * @param value - The JSON string to parse\n * @param defaultValue - The value to return if parsing fails or results in null/undefined\n * @returns The parsed JSON value as type T, or the default value if parsing fails\n *\n * @example\n * import { tryParseJson } from \"@settlemint/sdk-utils\";\n *\n * const config = tryParseJson<{ port: number }>(\n *   '{\"port\": 3000}',\n *   { port: 8080 }\n * );\n * // Returns: { port: 3000 }\n *\n * const invalid = tryParseJson<string[]>(\n *   'invalid json',\n *   []\n * );\n * // Returns: []\n */\nexport function tryParseJson<T>(value: string, defaultValue: T | null = null): T | null {\n  try {\n    const parsed = JSON.parse(value) as T;\n    if (parsed === undefined || parsed === null) {\n      return defaultValue;\n    }\n    return parsed;\n  } catch (_err) {\n    // Invalid json\n    return defaultValue;\n  }\n}\n\n/**\n * Extracts a JSON object from a string.\n *\n * @param value - The string to extract the JSON object from\n * @returns The parsed JSON object, or null if no JSON object is found\n * @throws {Error} If the input string is too long (longer than 5000 characters)\n * @example\n * import { extractJsonObject } from \"@settlemint/sdk-utils\";\n *\n * const json = extractJsonObject<{ port: number }>(\n *   'port info: {\"port\": 3000}',\n * );\n * // Returns: { port: 3000 }\n */\nexport function extractJsonObject<T>(value: string): T | null {\n  if (value.length > 5000) {\n    throw new Error(\"Input too long\");\n  }\n  const result = /\\{([\\s\\S]*)\\}/.exec(value);\n  if (!result) {\n    return null;\n  }\n  return tryParseJson<T>(result[0]);\n}\n\n/**\n * Converts a value to a JSON stringifiable format.\n *\n * @param value - The value to convert\n * @returns The JSON stringifiable value\n *\n * @example\n * import { makeJsonStringifiable } from \"@settlemint/sdk-utils\";\n *\n * const json = makeJsonStringifiable<{ amount: bigint }>({ amount: BigInt(1000) });\n * // Returns: '{\"amount\":\"1000\"}'\n */\nexport function makeJsonStringifiable<T>(value: unknown): T {\n  if (value === undefined || value === null) {\n    return value as T;\n  }\n  return tryParseJson<T>(\n    JSON.stringify(\n      value,\n      (_, value) => (typeof value === \"bigint\" ? value.toString() : value), // return everything else unchanged\n    ),\n  ) as T;\n}\n","import { z } from \"zod\";\n\n/**\n * Schema for validating unique names used across the SettleMint platform.\n * Only accepts lowercase alphanumeric characters and hyphens.\n * Used for workspace names, application names, service names etc.\n *\n * @example\n * import { UniqueNameSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate a workspace name\n * const isValidName = UniqueNameSchema.safeParse(\"my-workspace-123\").success;\n * // true\n *\n * // Invalid names will fail validation\n * const isInvalidName = UniqueNameSchema.safeParse(\"My Workspace!\").success;\n * // false\n */\nexport const UniqueNameSchema = z.string().regex(/^[a-z0-9-]+$/);\n\n/**\n * Type definition for unique names, inferred from UniqueNameSchema.\n */\nexport type UniqueName = z.infer<typeof UniqueNameSchema>;\n","import { z } from \"zod\";\n\n/**\n * Schema for validating URLs.\n *\n * @example\n * import { UrlSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate a URL\n * const isValidUrl = UrlSchema.safeParse(\"https://console.settlemint.com\").success;\n * // true\n *\n * // Invalid URLs will fail validation\n * const isInvalidUrl = UrlSchema.safeParse(\"not-a-url\").success;\n * // false\n */\nexport const UrlSchema = z.string().url();\nexport type Url = z.infer<typeof UrlSchema>;\n\n/**\n * Schema for validating URL paths.\n *\n * @example\n * import { UrlPathSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate a URL path\n * const isValidPath = UrlPathSchema.safeParse(\"/api/v1/users\").success;\n * // true\n *\n * // Invalid paths will fail validation\n * const isInvalidPath = UrlPathSchema.safeParse(\"not-a-path\").success;\n * // false\n */\nexport const UrlPathSchema = z.string().regex(/^\\/(?:[a-zA-Z0-9-_]+(?:\\/[a-zA-Z0-9-_]+)*\\/?)?$/, {\n  message: \"Invalid URL path format. Must start with '/' and can contain letters, numbers, hyphens, and underscores.\",\n});\n\nexport type UrlPath = z.infer<typeof UrlPathSchema>;\n\n/**\n * Schema that accepts either a full URL or a URL path.\n *\n * @example\n * import { UrlOrPathSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate a URL\n * const isValidUrl = UrlOrPathSchema.safeParse(\"https://console.settlemint.com\").success;\n * // true\n *\n * // Validate a path\n * const isValidPath = UrlOrPathSchema.safeParse(\"/api/v1/users\").success;\n * // true\n */\nexport const UrlOrPathSchema = z.union([UrlSchema, UrlPathSchema]);\nexport type UrlOrPath = z.infer<typeof UrlOrPathSchema>;\n","import { z } from \"zod\";\nimport { tryParseJson } from \"@/json.js\";\nimport { ApplicationAccessTokenSchema, PersonalAccessTokenSchema } from \"./access-token.schema.js\";\nimport { UniqueNameSchema } from \"./unique-name.schema.js\";\nimport { UrlSchema } from \"./url.schema.js\";\n\n/**\n * Use this value to indicate that the resources are not part of the SettleMint platform.\n */\nexport const STANDALONE_INSTANCE = \"standalone\";\n/**\n * Use this value to indicate that the resources are not part of the SettleMint platform.\n */\nexport const LOCAL_INSTANCE = \"local\";\n\n/**\n * Schema for validating environment variables used by the SettleMint SDK.\n * Defines validation rules and types for configuration values like URLs,\n * access tokens, workspace names, and service endpoints.\n */\nexport const DotEnvSchema = z.object({\n  /** Base URL of the SettleMint platform instance, set to standalone if your resources are not part of the SettleMint platform */\n  SETTLEMINT_INSTANCE: z\n    .union([UrlSchema, z.literal(STANDALONE_INSTANCE), z.literal(LOCAL_INSTANCE)])\n    .default(\"https://console.settlemint.com\"),\n  /** Application access token for authenticating with SettleMint services */\n  SETTLEMINT_ACCESS_TOKEN: ApplicationAccessTokenSchema.optional(),\n  /** @internal */\n  SETTLEMINT_PERSONAL_ACCESS_TOKEN: PersonalAccessTokenSchema.optional(),\n  /** Unique name of the workspace */\n  SETTLEMINT_WORKSPACE: UniqueNameSchema.optional(),\n  /** Unique name of the application */\n  SETTLEMINT_APPLICATION: UniqueNameSchema.optional(),\n  /** Unique name of the blockchain network */\n  SETTLEMINT_BLOCKCHAIN_NETWORK: UniqueNameSchema.optional(),\n  /** Chain ID of the blockchain network */\n  SETTLEMINT_BLOCKCHAIN_NETWORK_CHAIN_ID: z.string().optional(),\n  /** Unique name of the blockchain node (should have a private key for signing transactions) */\n  SETTLEMINT_BLOCKCHAIN_NODE: UniqueNameSchema.optional(),\n  /** JSON RPC endpoint for the blockchain node */\n  SETTLEMINT_BLOCKCHAIN_NODE_JSON_RPC_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the blockchain node or load balancer */\n  SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER: UniqueNameSchema.optional(),\n  /** JSON RPC endpoint for the blockchain node or load balancer */\n  SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER_JSON_RPC_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the Hasura instance */\n  SETTLEMINT_HASURA: UniqueNameSchema.optional(),\n  /** Endpoint URL for the Hasura GraphQL API */\n  SETTLEMINT_HASURA_ENDPOINT: UrlSchema.optional(),\n  /** Admin secret for authenticating with Hasura */\n  SETTLEMINT_HASURA_ADMIN_SECRET: z.string().optional(),\n  /** Database connection URL for Hasura */\n  SETTLEMINT_HASURA_DATABASE_URL: z.string().optional(),\n  /** Unique name of The Graph instance */\n  SETTLEMINT_THEGRAPH: UniqueNameSchema.optional(),\n  /** Array of endpoint URLs for The Graph subgraphs */\n  SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS: z.preprocess(\n    (value) => tryParseJson(value as string, []),\n    z.array(UrlSchema).optional(),\n  ),\n  /** Default The Graph subgraph to use */\n  SETTLEMINT_THEGRAPH_DEFAULT_SUBGRAPH: z.string().optional(),\n  /** Unique name of the Smart Contract Portal instance */\n  SETTLEMINT_PORTAL: UniqueNameSchema.optional(),\n  /** GraphQL endpoint URL for the Portal */\n  SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT: UrlSchema.optional(),\n  /** REST endpoint URL for the Portal */\n  SETTLEMINT_PORTAL_REST_ENDPOINT: UrlSchema.optional(),\n  /** WebSocket endpoint URL for the Portal */\n  SETTLEMINT_PORTAL_WS_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the HD private key */\n  SETTLEMINT_HD_PRIVATE_KEY: UniqueNameSchema.optional(),\n  /** Address of the HD private key forwarder */\n  SETTLEMINT_HD_PRIVATE_KEY_FORWARDER_ADDRESS: z.string().optional(),\n  /** Unique name of the accessible private key */\n  SETTLEMINT_ACCESSIBLE_PRIVATE_KEY: UniqueNameSchema.optional(),\n  /** Unique name of the MinIO instance */\n  SETTLEMINT_MINIO: UniqueNameSchema.optional(),\n  /** Endpoint URL for MinIO */\n  SETTLEMINT_MINIO_ENDPOINT: UrlSchema.optional(),\n  /** Access key for MinIO authentication */\n  SETTLEMINT_MINIO_ACCESS_KEY: z.string().optional(),\n  /** Secret key for MinIO authentication */\n  SETTLEMINT_MINIO_SECRET_KEY: z.string().optional(),\n  /** Unique name of the IPFS instance */\n  SETTLEMINT_IPFS: UniqueNameSchema.optional(),\n  /** API endpoint URL for IPFS */\n  SETTLEMINT_IPFS_API_ENDPOINT: UrlSchema.optional(),\n  /** Pinning service endpoint URL for IPFS */\n  SETTLEMINT_IPFS_PINNING_ENDPOINT: UrlSchema.optional(),\n  /** Gateway endpoint URL for IPFS */\n  SETTLEMINT_IPFS_GATEWAY_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the custom deployment */\n  SETTLEMINT_CUSTOM_DEPLOYMENT: UniqueNameSchema.optional(),\n  /** Endpoint URL for the custom deployment */\n  SETTLEMINT_CUSTOM_DEPLOYMENT_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the Blockscout instance */\n  SETTLEMINT_BLOCKSCOUT: UniqueNameSchema.optional(),\n  /** GraphQL endpoint URL for Blockscout */\n  SETTLEMINT_BLOCKSCOUT_GRAPHQL_ENDPOINT: UrlSchema.optional(),\n  /** UI endpoint URL for Blockscout */\n  SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT: UrlSchema.optional(),\n  /** Name of the new project being created */\n  SETTLEMINT_NEW_PROJECT_NAME: z.string().optional(),\n  /** The log level to use */\n  SETTLEMINT_LOG_LEVEL: z.enum([\"debug\", \"info\", \"warn\", \"error\", \"none\"]).default(\"warn\"),\n});\n\n/**\n * Type definition for the environment variables schema.\n */\nexport type DotEnv = z.infer<typeof DotEnvSchema>;\n\n/**\n * Partial version of the environment variables schema where all fields are optional.\n * Useful for validating incomplete configurations during development or build time.\n */\nexport const DotEnvSchemaPartial = DotEnvSchema.partial();\n\n/**\n * Type definition for the partial environment variables schema.\n */\nexport type DotEnvPartial = z.infer<typeof DotEnvSchemaPartial>;\n","import { z } from \"zod\";\n\n/**\n * Schema for validating database IDs. Accepts both PostgreSQL UUIDs and MongoDB ObjectIDs.\n * PostgreSQL UUIDs are 32 hexadecimal characters with hyphens (e.g. 123e4567-e89b-12d3-a456-426614174000).\n * MongoDB ObjectIDs are 24 hexadecimal characters (e.g. 507f1f77bcf86cd799439011).\n *\n * @example\n * import { IdSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate PostgreSQL UUID\n * const isValidUuid = IdSchema.safeParse(\"123e4567-e89b-12d3-a456-426614174000\").success;\n *\n * // Validate MongoDB ObjectID\n * const isValidObjectId = IdSchema.safeParse(\"507f1f77bcf86cd799439011\").success;\n */\nexport const IdSchema = z.union([\n  z\n    .string()\n    .uuid(), // PostgreSQL UUID\n  z\n    .string()\n    .regex(/^[0-9a-fA-F]{24}$/), // MongoDB ObjectID\n]);\n\n/**\n * Type definition for database IDs, inferred from IdSchema.\n * Can be either a PostgreSQL UUID string or MongoDB ObjectID string.\n */\nexport type Id = z.infer<typeof IdSchema>;\n"],"mappings":"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"}

package/dist/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","names":["ApplicationAccessTokenSchema: ZodString","PersonalAccessTokenSchema: ZodString","AccessTokenSchema: ZodString","value"],"sources":["../src/validation/validate.ts","../src/validation/access-token.schema.ts","../src/json.ts","../src/validation/unique-name.schema.ts","../src/validation/url.schema.ts","../src/validation/dot-env.schema.ts","../src/validation/id.schema.ts"],"sourcesContent":["import { ZodError, type ZodType } from \"zod\";\n\n/**\n * Validates a value against a given Zod schema.\n *\n * @param schema - The Zod schema to validate against.\n * @param value - The value to validate.\n * @returns The validated and parsed value.\n * @throws Will throw an error if validation fails, with formatted error messages.\n *\n * @example\n * import { validate } from \"@settlemint/sdk-utils/validation\";\n *\n * const validatedId = validate(IdSchema, \"550e8400-e29b-41d4-a716-446655440000\");\n */\nexport function validate<T extends ZodType>(schema: T, value: unknown): T[\"_output\"] {\n  try {\n    return schema.parse(value);\n  } catch (error) {\n    if (error instanceof ZodError) {\n      const formattedErrors = error.issues.map((err) => `- ${err.path.join(\".\")}: ${err.message}`).join(\"\\n\");\n      throw new Error(`Validation error${error.issues.length > 1 ? \"s\" : \"\"}:\\n${formattedErrors}`);\n    }\n    throw error; // Re-throw if it's not a ZodError\n  }\n}\n","import { type ZodString, z } from \"zod\";\n\n/**\n * Schema for validating application access tokens.\n * Application access tokens start with 'sm_aat_' prefix.\n */\nexport const ApplicationAccessTokenSchema: ZodString = z.string().regex(/^sm_aat_.+$/);\nexport type ApplicationAccessToken = z.infer<typeof ApplicationAccessTokenSchema>;\n\n/**\n * Schema for validating personal access tokens.\n * Personal access tokens start with 'sm_pat_' prefix.\n */\nexport const PersonalAccessTokenSchema: ZodString = z.string().regex(/^sm_pat_.+$/);\nexport type PersonalAccessToken = z.infer<typeof PersonalAccessTokenSchema>;\n\n/**\n * Schema for validating both application and personal access tokens.\n * Accepts tokens starting with either 'sm_pat_' or 'sm_aat_' prefix.\n */\nexport const AccessTokenSchema: ZodString = z.string().regex(/^(sm_pat_.+|sm_aat_.+)$/);\nexport type AccessToken = z.infer<typeof AccessTokenSchema>;\n","/**\n * Attempts to parse a JSON string into a typed value, returning a default value if parsing fails.\n *\n * @param value - The JSON string to parse\n * @param defaultValue - The value to return if parsing fails or results in null/undefined\n * @returns The parsed JSON value as type T, or the default value if parsing fails\n *\n * @example\n * import { tryParseJson } from \"@settlemint/sdk-utils\";\n *\n * const config = tryParseJson<{ port: number }>(\n *   '{\"port\": 3000}',\n *   { port: 8080 }\n * );\n * // Returns: { port: 3000 }\n *\n * const invalid = tryParseJson<string[]>(\n *   'invalid json',\n *   []\n * );\n * // Returns: []\n */\nexport function tryParseJson<T>(value: string, defaultValue: T | null = null): T | null {\n  try {\n    const parsed = JSON.parse(value) as T;\n    if (parsed === undefined || parsed === null) {\n      return defaultValue;\n    }\n    return parsed;\n  } catch (_err) {\n    // Invalid json\n    return defaultValue;\n  }\n}\n\n/**\n * Extracts a JSON object from a string.\n *\n * @param value - The string to extract the JSON object from\n * @returns The parsed JSON object, or null if no JSON object is found\n * @throws {Error} If the input string is too long (longer than 5000 characters)\n * @example\n * import { extractJsonObject } from \"@settlemint/sdk-utils\";\n *\n * const json = extractJsonObject<{ port: number }>(\n *   'port info: {\"port\": 3000}',\n * );\n * // Returns: { port: 3000 }\n */\nexport function extractJsonObject<T>(value: string): T | null {\n  if (value.length > 5000) {\n    throw new Error(\"Input too long\");\n  }\n  const result = /\\{([\\s\\S]*)\\}/.exec(value);\n  if (!result) {\n    return null;\n  }\n  return tryParseJson<T>(result[0]);\n}\n\n/**\n * Converts a value to a JSON stringifiable format.\n *\n * @param value - The value to convert\n * @returns The JSON stringifiable value\n *\n * @example\n * import { makeJsonStringifiable } from \"@settlemint/sdk-utils\";\n *\n * const json = makeJsonStringifiable<{ amount: bigint }>({ amount: BigInt(1000) });\n * // Returns: '{\"amount\":\"1000\"}'\n */\nexport function makeJsonStringifiable<T>(value: unknown): T {\n  if (value === undefined || value === null) {\n    return value as T;\n  }\n  return tryParseJson<T>(\n    JSON.stringify(\n      value,\n      (_, value) => (typeof value === \"bigint\" ? value.toString() : value), // return everything else unchanged\n    ),\n  ) as T;\n}\n","import { z } from \"zod\";\n\n/**\n * Schema for validating unique names used across the SettleMint platform.\n * Only accepts lowercase alphanumeric characters and hyphens.\n * Used for workspace names, application names, service names etc.\n *\n * @example\n * import { UniqueNameSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate a workspace name\n * const isValidName = UniqueNameSchema.safeParse(\"my-workspace-123\").success;\n * // true\n *\n * // Invalid names will fail validation\n * const isInvalidName = UniqueNameSchema.safeParse(\"My Workspace!\").success;\n * // false\n */\nexport const UniqueNameSchema = z.string().regex(/^[a-z0-9-]+$/);\n\n/**\n * Type definition for unique names, inferred from UniqueNameSchema.\n */\nexport type UniqueName = z.infer<typeof UniqueNameSchema>;\n","import { z } from \"zod\";\n\n/**\n * Schema for validating URLs.\n *\n * @example\n * import { UrlSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate a URL\n * const isValidUrl = UrlSchema.safeParse(\"https://console.settlemint.com\").success;\n * // true\n *\n * // Invalid URLs will fail validation\n * const isInvalidUrl = UrlSchema.safeParse(\"not-a-url\").success;\n * // false\n */\nexport const UrlSchema = z.string().url();\nexport type Url = z.infer<typeof UrlSchema>;\n\n/**\n * Schema for validating URL paths.\n *\n * @example\n * import { UrlPathSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate a URL path\n * const isValidPath = UrlPathSchema.safeParse(\"/api/v1/users\").success;\n * // true\n *\n * // Invalid paths will fail validation\n * const isInvalidPath = UrlPathSchema.safeParse(\"not-a-path\").success;\n * // false\n */\nexport const UrlPathSchema = z.string().regex(/^\\/(?:[a-zA-Z0-9-_]+(?:\\/[a-zA-Z0-9-_]+)*\\/?)?$/, {\n  message: \"Invalid URL path format. Must start with '/' and can contain letters, numbers, hyphens, and underscores.\",\n});\n\nexport type UrlPath = z.infer<typeof UrlPathSchema>;\n\n/**\n * Schema that accepts either a full URL or a URL path.\n *\n * @example\n * import { UrlOrPathSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate a URL\n * const isValidUrl = UrlOrPathSchema.safeParse(\"https://console.settlemint.com\").success;\n * // true\n *\n * // Validate a path\n * const isValidPath = UrlOrPathSchema.safeParse(\"/api/v1/users\").success;\n * // true\n */\nexport const UrlOrPathSchema = z.union([UrlSchema, UrlPathSchema]);\nexport type UrlOrPath = z.infer<typeof UrlOrPathSchema>;\n","import { z } from \"zod\";\nimport { tryParseJson } from \"@/json.js\";\nimport { ApplicationAccessTokenSchema, PersonalAccessTokenSchema } from \"./access-token.schema.js\";\nimport { UniqueNameSchema } from \"./unique-name.schema.js\";\nimport { UrlSchema } from \"./url.schema.js\";\n\n/**\n * Use this value to indicate that the resources are not part of the SettleMint platform.\n */\nexport const STANDALONE_INSTANCE = \"standalone\";\n/**\n * Use this value to indicate that the resources are not part of the SettleMint platform.\n */\nexport const LOCAL_INSTANCE = \"local\";\n\n/**\n * Schema for validating environment variables used by the SettleMint SDK.\n * Defines validation rules and types for configuration values like URLs,\n * access tokens, workspace names, and service endpoints.\n */\nexport const DotEnvSchema = z.object({\n  /** Base URL of the SettleMint platform instance, set to standalone if your resources are not part of the SettleMint platform */\n  SETTLEMINT_INSTANCE: z\n    .union([UrlSchema, z.literal(STANDALONE_INSTANCE), z.literal(LOCAL_INSTANCE)])\n    .default(\"https://console.settlemint.com\"),\n  /** Application access token for authenticating with SettleMint services */\n  SETTLEMINT_ACCESS_TOKEN: ApplicationAccessTokenSchema.optional(),\n  /** @internal */\n  SETTLEMINT_PERSONAL_ACCESS_TOKEN: PersonalAccessTokenSchema.optional(),\n  /** Unique name of the workspace */\n  SETTLEMINT_WORKSPACE: UniqueNameSchema.optional(),\n  /** Unique name of the application */\n  SETTLEMINT_APPLICATION: UniqueNameSchema.optional(),\n  /** Unique name of the blockchain network */\n  SETTLEMINT_BLOCKCHAIN_NETWORK: UniqueNameSchema.optional(),\n  /** Chain ID of the blockchain network */\n  SETTLEMINT_BLOCKCHAIN_NETWORK_CHAIN_ID: z.string().optional(),\n  /** Unique name of the blockchain node (should have a private key for signing transactions) */\n  SETTLEMINT_BLOCKCHAIN_NODE: UniqueNameSchema.optional(),\n  /** JSON RPC endpoint for the blockchain node */\n  SETTLEMINT_BLOCKCHAIN_NODE_JSON_RPC_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the blockchain node or load balancer */\n  SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER: UniqueNameSchema.optional(),\n  /** JSON RPC endpoint for the blockchain node or load balancer */\n  SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER_JSON_RPC_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the Hasura instance */\n  SETTLEMINT_HASURA: UniqueNameSchema.optional(),\n  /** Endpoint URL for the Hasura GraphQL API */\n  SETTLEMINT_HASURA_ENDPOINT: UrlSchema.optional(),\n  /** Admin secret for authenticating with Hasura */\n  SETTLEMINT_HASURA_ADMIN_SECRET: z.string().optional(),\n  /** Database connection URL for Hasura */\n  SETTLEMINT_HASURA_DATABASE_URL: z.string().optional(),\n  /** Unique name of The Graph instance */\n  SETTLEMINT_THEGRAPH: UniqueNameSchema.optional(),\n  /** Array of endpoint URLs for The Graph subgraphs */\n  SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS: z.preprocess(\n    (value) => tryParseJson(value as string, []),\n    z.array(UrlSchema).optional(),\n  ),\n  /** Default The Graph subgraph to use */\n  SETTLEMINT_THEGRAPH_DEFAULT_SUBGRAPH: z.string().optional(),\n  /** Unique name of the Smart Contract Portal instance */\n  SETTLEMINT_PORTAL: UniqueNameSchema.optional(),\n  /** GraphQL endpoint URL for the Portal */\n  SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT: UrlSchema.optional(),\n  /** REST endpoint URL for the Portal */\n  SETTLEMINT_PORTAL_REST_ENDPOINT: UrlSchema.optional(),\n  /** WebSocket endpoint URL for the Portal */\n  SETTLEMINT_PORTAL_WS_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the HD private key */\n  SETTLEMINT_HD_PRIVATE_KEY: UniqueNameSchema.optional(),\n  /** Address of the HD private key forwarder */\n  SETTLEMINT_HD_PRIVATE_KEY_FORWARDER_ADDRESS: z.string().optional(),\n  /** Unique name of the accessible private key */\n  SETTLEMINT_ACCESSIBLE_PRIVATE_KEY: UniqueNameSchema.optional(),\n  /** Unique name of the MinIO instance */\n  SETTLEMINT_MINIO: UniqueNameSchema.optional(),\n  /** Endpoint URL for MinIO */\n  SETTLEMINT_MINIO_ENDPOINT: UrlSchema.optional(),\n  /** Access key for MinIO authentication */\n  SETTLEMINT_MINIO_ACCESS_KEY: z.string().optional(),\n  /** Secret key for MinIO authentication */\n  SETTLEMINT_MINIO_SECRET_KEY: z.string().optional(),\n  /** Unique name of the IPFS instance */\n  SETTLEMINT_IPFS: UniqueNameSchema.optional(),\n  /** API endpoint URL for IPFS */\n  SETTLEMINT_IPFS_API_ENDPOINT: UrlSchema.optional(),\n  /** Pinning service endpoint URL for IPFS */\n  SETTLEMINT_IPFS_PINNING_ENDPOINT: UrlSchema.optional(),\n  /** Gateway endpoint URL for IPFS */\n  SETTLEMINT_IPFS_GATEWAY_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the custom deployment */\n  SETTLEMINT_CUSTOM_DEPLOYMENT: UniqueNameSchema.optional(),\n  /** Endpoint URL for the custom deployment */\n  SETTLEMINT_CUSTOM_DEPLOYMENT_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the Blockscout instance */\n  SETTLEMINT_BLOCKSCOUT: UniqueNameSchema.optional(),\n  /** GraphQL endpoint URL for Blockscout */\n  SETTLEMINT_BLOCKSCOUT_GRAPHQL_ENDPOINT: UrlSchema.optional(),\n  /** UI endpoint URL for Blockscout */\n  SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT: UrlSchema.optional(),\n  /** Name of the new project being created */\n  SETTLEMINT_NEW_PROJECT_NAME: z.string().optional(),\n  /** The log level to use */\n  SETTLEMINT_LOG_LEVEL: z.enum([\"debug\", \"info\", \"warn\", \"error\", \"none\"]).default(\"warn\"),\n});\n\n/**\n * Type definition for the environment variables schema.\n */\nexport type DotEnv = z.infer<typeof DotEnvSchema>;\n\n/**\n * Partial version of the environment variables schema where all fields are optional.\n * Useful for validating incomplete configurations during development or build time.\n */\nexport const DotEnvSchemaPartial = DotEnvSchema.partial();\n\n/**\n * Type definition for the partial environment variables schema.\n */\nexport type DotEnvPartial = z.infer<typeof DotEnvSchemaPartial>;\n","import { z } from \"zod\";\n\n/**\n * Schema for validating database IDs. Accepts both PostgreSQL UUIDs and MongoDB ObjectIDs.\n * PostgreSQL UUIDs are 32 hexadecimal characters with hyphens (e.g. 123e4567-e89b-12d3-a456-426614174000).\n * MongoDB ObjectIDs are 24 hexadecimal characters (e.g. 507f1f77bcf86cd799439011).\n *\n * @example\n * import { IdSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate PostgreSQL UUID\n * const isValidUuid = IdSchema.safeParse(\"123e4567-e89b-12d3-a456-426614174000\").success;\n *\n * // Validate MongoDB ObjectID\n * const isValidObjectId = IdSchema.safeParse(\"507f1f77bcf86cd799439011\").success;\n */\nexport const IdSchema = z.union([\n  z\n    .string()\n    .uuid(), // PostgreSQL UUID\n  z\n    .string()\n    .regex(/^[0-9a-fA-F]{24}$/), // MongoDB ObjectID\n]);\n\n/**\n * Type definition for database IDs, inferred from IdSchema.\n * Can be either a PostgreSQL UUID string or MongoDB ObjectID string.\n */\nexport type Id = z.infer<typeof IdSchema>;\n"],"mappings":"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"}
+{"version":3,"file":"validation.js","names":["ApplicationAccessTokenSchema: ZodString","PersonalAccessTokenSchema: ZodString","AccessTokenSchema: ZodString","value"],"sources":["../src/validation/validate.ts","../src/validation/access-token.schema.ts","../src/json.ts","../src/validation/unique-name.schema.ts","../src/validation/url.schema.ts","../src/validation/dot-env.schema.ts","../src/validation/id.schema.ts"],"sourcesContent":["import { ZodError, type ZodType } from \"zod\";\n\n/**\n * Validates a value against a given Zod schema.\n *\n * @param schema - The Zod schema to validate against.\n * @param value - The value to validate.\n * @returns The validated and parsed value.\n * @throws Will throw an error if validation fails, with formatted error messages.\n *\n * @example\n * import { validate } from \"@settlemint/sdk-utils/validation\";\n *\n * const validatedId = validate(IdSchema, \"550e8400-e29b-41d4-a716-446655440000\");\n */\nexport function validate<T extends ZodType>(schema: T, value: unknown): T[\"_output\"] {\n  try {\n    return schema.parse(value);\n  } catch (error) {\n    if (error instanceof ZodError) {\n      const formattedErrors = error.issues.map((err) => `- ${err.path.join(\".\")}: ${err.message}`).join(\"\\n\");\n      throw new Error(`Validation error${error.issues.length > 1 ? \"s\" : \"\"}:\\n${formattedErrors}`);\n    }\n    throw error; // Re-throw if it's not a ZodError\n  }\n}\n","import { type ZodString, z } from \"zod\";\n\n/**\n * Schema for validating application access tokens.\n * Application access tokens start with 'sm_aat_' prefix.\n */\nexport const ApplicationAccessTokenSchema: ZodString = z.string().regex(/^sm_aat_.+$/);\nexport type ApplicationAccessToken = z.infer<typeof ApplicationAccessTokenSchema>;\n\n/**\n * Schema for validating personal access tokens.\n * Personal access tokens start with 'sm_pat_' prefix.\n */\nexport const PersonalAccessTokenSchema: ZodString = z.string().regex(/^sm_pat_.+$/);\nexport type PersonalAccessToken = z.infer<typeof PersonalAccessTokenSchema>;\n\n/**\n * Schema for validating both application and personal access tokens.\n * Accepts tokens starting with either 'sm_pat_' or 'sm_aat_' prefix.\n */\nexport const AccessTokenSchema: ZodString = z.string().regex(/^(sm_pat_.+|sm_aat_.+)$/);\nexport type AccessToken = z.infer<typeof AccessTokenSchema>;\n","/**\n * Attempts to parse a JSON string into a typed value, returning a default value if parsing fails.\n *\n * @param value - The JSON string to parse\n * @param defaultValue - The value to return if parsing fails or results in null/undefined\n * @returns The parsed JSON value as type T, or the default value if parsing fails\n *\n * @example\n * import { tryParseJson } from \"@settlemint/sdk-utils\";\n *\n * const config = tryParseJson<{ port: number }>(\n *   '{\"port\": 3000}',\n *   { port: 8080 }\n * );\n * // Returns: { port: 3000 }\n *\n * const invalid = tryParseJson<string[]>(\n *   'invalid json',\n *   []\n * );\n * // Returns: []\n */\nexport function tryParseJson<T>(value: string, defaultValue: T | null = null): T | null {\n  try {\n    const parsed = JSON.parse(value) as T;\n    if (parsed === undefined || parsed === null) {\n      return defaultValue;\n    }\n    return parsed;\n  } catch (_err) {\n    // Invalid json\n    return defaultValue;\n  }\n}\n\n/**\n * Extracts a JSON object from a string.\n *\n * @param value - The string to extract the JSON object from\n * @returns The parsed JSON object, or null if no JSON object is found\n * @throws {Error} If the input string is too long (longer than 5000 characters)\n * @example\n * import { extractJsonObject } from \"@settlemint/sdk-utils\";\n *\n * const json = extractJsonObject<{ port: number }>(\n *   'port info: {\"port\": 3000}',\n * );\n * // Returns: { port: 3000 }\n */\nexport function extractJsonObject<T>(value: string): T | null {\n  if (value.length > 5000) {\n    throw new Error(\"Input too long\");\n  }\n  const result = /\\{([\\s\\S]*)\\}/.exec(value);\n  if (!result) {\n    return null;\n  }\n  return tryParseJson<T>(result[0]);\n}\n\n/**\n * Converts a value to a JSON stringifiable format.\n *\n * @param value - The value to convert\n * @returns The JSON stringifiable value\n *\n * @example\n * import { makeJsonStringifiable } from \"@settlemint/sdk-utils\";\n *\n * const json = makeJsonStringifiable<{ amount: bigint }>({ amount: BigInt(1000) });\n * // Returns: '{\"amount\":\"1000\"}'\n */\nexport function makeJsonStringifiable<T>(value: unknown): T {\n  if (value === undefined || value === null) {\n    return value as T;\n  }\n  return tryParseJson<T>(\n    JSON.stringify(\n      value,\n      (_, value) => (typeof value === \"bigint\" ? value.toString() : value), // return everything else unchanged\n    ),\n  ) as T;\n}\n","import { z } from \"zod\";\n\n/**\n * Schema for validating unique names used across the SettleMint platform.\n * Only accepts lowercase alphanumeric characters and hyphens.\n * Used for workspace names, application names, service names etc.\n *\n * @example\n * import { UniqueNameSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate a workspace name\n * const isValidName = UniqueNameSchema.safeParse(\"my-workspace-123\").success;\n * // true\n *\n * // Invalid names will fail validation\n * const isInvalidName = UniqueNameSchema.safeParse(\"My Workspace!\").success;\n * // false\n */\nexport const UniqueNameSchema = z.string().regex(/^[a-z0-9-]+$/);\n\n/**\n * Type definition for unique names, inferred from UniqueNameSchema.\n */\nexport type UniqueName = z.infer<typeof UniqueNameSchema>;\n","import { z } from \"zod\";\n\n/**\n * Schema for validating URLs.\n *\n * @example\n * import { UrlSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate a URL\n * const isValidUrl = UrlSchema.safeParse(\"https://console.settlemint.com\").success;\n * // true\n *\n * // Invalid URLs will fail validation\n * const isInvalidUrl = UrlSchema.safeParse(\"not-a-url\").success;\n * // false\n */\nexport const UrlSchema = z.string().url();\nexport type Url = z.infer<typeof UrlSchema>;\n\n/**\n * Schema for validating URL paths.\n *\n * @example\n * import { UrlPathSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate a URL path\n * const isValidPath = UrlPathSchema.safeParse(\"/api/v1/users\").success;\n * // true\n *\n * // Invalid paths will fail validation\n * const isInvalidPath = UrlPathSchema.safeParse(\"not-a-path\").success;\n * // false\n */\nexport const UrlPathSchema = z.string().regex(/^\\/(?:[a-zA-Z0-9-_]+(?:\\/[a-zA-Z0-9-_]+)*\\/?)?$/, {\n  message: \"Invalid URL path format. Must start with '/' and can contain letters, numbers, hyphens, and underscores.\",\n});\n\nexport type UrlPath = z.infer<typeof UrlPathSchema>;\n\n/**\n * Schema that accepts either a full URL or a URL path.\n *\n * @example\n * import { UrlOrPathSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate a URL\n * const isValidUrl = UrlOrPathSchema.safeParse(\"https://console.settlemint.com\").success;\n * // true\n *\n * // Validate a path\n * const isValidPath = UrlOrPathSchema.safeParse(\"/api/v1/users\").success;\n * // true\n */\nexport const UrlOrPathSchema = z.union([UrlSchema, UrlPathSchema]);\nexport type UrlOrPath = z.infer<typeof UrlOrPathSchema>;\n","import { z } from \"zod\";\nimport { tryParseJson } from \"@/json.js\";\nimport { ApplicationAccessTokenSchema, PersonalAccessTokenSchema } from \"./access-token.schema.js\";\nimport { UniqueNameSchema } from \"./unique-name.schema.js\";\nimport { UrlSchema } from \"./url.schema.js\";\n\n/**\n * Use this value to indicate that the resources are not part of the SettleMint platform.\n */\nexport const STANDALONE_INSTANCE = \"standalone\";\n/**\n * Use this value to indicate that the resources are not part of the SettleMint platform.\n */\nexport const LOCAL_INSTANCE = \"local\";\n\n/**\n * Schema for validating environment variables used by the SettleMint SDK.\n * Defines validation rules and types for configuration values like URLs,\n * access tokens, workspace names, and service endpoints.\n */\nexport const DotEnvSchema = z.object({\n  /** Base URL of the SettleMint platform instance, set to standalone if your resources are not part of the SettleMint platform */\n  SETTLEMINT_INSTANCE: z\n    .union([UrlSchema, z.literal(STANDALONE_INSTANCE), z.literal(LOCAL_INSTANCE)])\n    .default(\"https://console.settlemint.com\"),\n  /** Application access token for authenticating with SettleMint services */\n  SETTLEMINT_ACCESS_TOKEN: ApplicationAccessTokenSchema.optional(),\n  /** @internal */\n  SETTLEMINT_PERSONAL_ACCESS_TOKEN: PersonalAccessTokenSchema.optional(),\n  /** Unique name of the workspace */\n  SETTLEMINT_WORKSPACE: UniqueNameSchema.optional(),\n  /** Unique name of the application */\n  SETTLEMINT_APPLICATION: UniqueNameSchema.optional(),\n  /** Unique name of the blockchain network */\n  SETTLEMINT_BLOCKCHAIN_NETWORK: UniqueNameSchema.optional(),\n  /** Chain ID of the blockchain network */\n  SETTLEMINT_BLOCKCHAIN_NETWORK_CHAIN_ID: z.string().optional(),\n  /** Unique name of the blockchain node (should have a private key for signing transactions) */\n  SETTLEMINT_BLOCKCHAIN_NODE: UniqueNameSchema.optional(),\n  /** JSON RPC endpoint for the blockchain node */\n  SETTLEMINT_BLOCKCHAIN_NODE_JSON_RPC_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the blockchain node or load balancer */\n  SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER: UniqueNameSchema.optional(),\n  /** JSON RPC endpoint for the blockchain node or load balancer */\n  SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER_JSON_RPC_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the Hasura instance */\n  SETTLEMINT_HASURA: UniqueNameSchema.optional(),\n  /** Endpoint URL for the Hasura GraphQL API */\n  SETTLEMINT_HASURA_ENDPOINT: UrlSchema.optional(),\n  /** Admin secret for authenticating with Hasura */\n  SETTLEMINT_HASURA_ADMIN_SECRET: z.string().optional(),\n  /** Database connection URL for Hasura */\n  SETTLEMINT_HASURA_DATABASE_URL: z.string().optional(),\n  /** Unique name of The Graph instance */\n  SETTLEMINT_THEGRAPH: UniqueNameSchema.optional(),\n  /** Array of endpoint URLs for The Graph subgraphs */\n  SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS: z.preprocess(\n    (value) => tryParseJson(value as string, []),\n    z.array(UrlSchema).optional(),\n  ),\n  /** Default The Graph subgraph to use */\n  SETTLEMINT_THEGRAPH_DEFAULT_SUBGRAPH: z.string().optional(),\n  /** Unique name of the Smart Contract Portal instance */\n  SETTLEMINT_PORTAL: UniqueNameSchema.optional(),\n  /** GraphQL endpoint URL for the Portal */\n  SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT: UrlSchema.optional(),\n  /** REST endpoint URL for the Portal */\n  SETTLEMINT_PORTAL_REST_ENDPOINT: UrlSchema.optional(),\n  /** WebSocket endpoint URL for the Portal */\n  SETTLEMINT_PORTAL_WS_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the HD private key */\n  SETTLEMINT_HD_PRIVATE_KEY: UniqueNameSchema.optional(),\n  /** Address of the HD private key forwarder */\n  SETTLEMINT_HD_PRIVATE_KEY_FORWARDER_ADDRESS: z.string().optional(),\n  /** Unique name of the accessible private key */\n  SETTLEMINT_ACCESSIBLE_PRIVATE_KEY: UniqueNameSchema.optional(),\n  /** Unique name of the MinIO instance */\n  SETTLEMINT_MINIO: UniqueNameSchema.optional(),\n  /** Endpoint URL for MinIO */\n  SETTLEMINT_MINIO_ENDPOINT: UrlSchema.optional(),\n  /** Access key for MinIO authentication */\n  SETTLEMINT_MINIO_ACCESS_KEY: z.string().optional(),\n  /** Secret key for MinIO authentication */\n  SETTLEMINT_MINIO_SECRET_KEY: z.string().optional(),\n  /** Unique name of the IPFS instance */\n  SETTLEMINT_IPFS: UniqueNameSchema.optional(),\n  /** API endpoint URL for IPFS */\n  SETTLEMINT_IPFS_API_ENDPOINT: UrlSchema.optional(),\n  /** Pinning service endpoint URL for IPFS */\n  SETTLEMINT_IPFS_PINNING_ENDPOINT: UrlSchema.optional(),\n  /** Gateway endpoint URL for IPFS */\n  SETTLEMINT_IPFS_GATEWAY_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the custom deployment */\n  SETTLEMINT_CUSTOM_DEPLOYMENT: UniqueNameSchema.optional(),\n  /** Endpoint URL for the custom deployment */\n  SETTLEMINT_CUSTOM_DEPLOYMENT_ENDPOINT: UrlSchema.optional(),\n  /** Unique name of the Blockscout instance */\n  SETTLEMINT_BLOCKSCOUT: UniqueNameSchema.optional(),\n  /** GraphQL endpoint URL for Blockscout */\n  SETTLEMINT_BLOCKSCOUT_GRAPHQL_ENDPOINT: UrlSchema.optional(),\n  /** UI endpoint URL for Blockscout */\n  SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT: UrlSchema.optional(),\n  /** Name of the new project being created */\n  SETTLEMINT_NEW_PROJECT_NAME: z.string().optional(),\n  /** The log level to use */\n  SETTLEMINT_LOG_LEVEL: z.enum([\"debug\", \"info\", \"warn\", \"error\", \"none\"]).default(\"warn\"),\n});\n\n/**\n * Type definition for the environment variables schema.\n */\nexport type DotEnv = z.infer<typeof DotEnvSchema>;\n\n/**\n * Partial version of the environment variables schema where all fields are optional.\n * Useful for validating incomplete configurations during development or build time.\n */\nexport const DotEnvSchemaPartial = DotEnvSchema.partial();\n\n/**\n * Type definition for the partial environment variables schema.\n */\nexport type DotEnvPartial = z.infer<typeof DotEnvSchemaPartial>;\n","import { z } from \"zod\";\n\n/**\n * Schema for validating database IDs. Accepts both PostgreSQL UUIDs and MongoDB ObjectIDs.\n * PostgreSQL UUIDs are 32 hexadecimal characters with hyphens (e.g. 123e4567-e89b-12d3-a456-426614174000).\n * MongoDB ObjectIDs are 24 hexadecimal characters (e.g. 507f1f77bcf86cd799439011).\n *\n * @example\n * import { IdSchema } from \"@settlemint/sdk-utils/validation\";\n *\n * // Validate PostgreSQL UUID\n * const isValidUuid = IdSchema.safeParse(\"123e4567-e89b-12d3-a456-426614174000\").success;\n *\n * // Validate MongoDB ObjectID\n * const isValidObjectId = IdSchema.safeParse(\"507f1f77bcf86cd799439011\").success;\n */\nexport const IdSchema = z.union([\n  z\n    .string()\n    .uuid(), // PostgreSQL UUID\n  z\n    .string()\n    .regex(/^[0-9a-fA-F]{24}$/), // MongoDB ObjectID\n]);\n\n/**\n * Type definition for database IDs, inferred from IdSchema.\n * Can be either a PostgreSQL UUID string or MongoDB ObjectID string.\n */\nexport type Id = z.infer<typeof IdSchema>;\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@settlemint/sdk-utils",
   "description": "Shared utilities and helper functions for SettleMint SDK modules",
-  "version": "2.6.2",
+  "version": "2.6.3-mainb49d2d05",
   "type": "module",
   "private": false,
   "license": "FSL-1.1-MIT",
@@ -51,7 +51,7 @@
   },
   "scripts": {
     "build": "NODE_OPTIONS='--max-old-space-size=3072' tsdown",
-    "dev": "tsdown --watch",
+    "dev": "tsdown --watch ./src",
     "publint": "publint run --strict",
     "attw": "attw --pack .",
     "test": "bun test",
@@ -72,10 +72,10 @@
     "console-table-printer": "^2",
     "deepmerge-ts": "^7",
     "environment": "^1",
-    "find-up": "^7",
+    "find-up": "^8.0.0",
     "glob": "11.0.3",
     "is-in-ci": "^2.0.0",
-    "nano-spawn": "^1.0.0",
+    "nano-spawn": "^2.0.0",
     "package-manager-detector": "^1.0.0",
     "yocto-spinner": "^1.0.0",
     "yoctocolors": "^2",