@settlemint/sdk-utils 2.3.2-pr6cb5dd2e → 2.3.2-pr73b9d054

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (97) hide show
  1. package/README.md +51 -7
  2. package/dist/environment.cjs +17708 -383
  3. package/dist/environment.cjs.map +1 -1
  4. package/dist/environment.d.cts +263 -98
  5. package/dist/environment.d.ts +263 -98
  6. package/dist/environment.js +17746 -0
  7. package/dist/environment.js.map +1 -0
  8. package/dist/filesystem.cjs +6746 -113
  9. package/dist/filesystem.cjs.map +1 -1
  10. package/dist/filesystem.d.cts +22 -1
  11. package/dist/filesystem.d.ts +22 -1
  12. package/dist/filesystem.js +6766 -0
  13. package/dist/filesystem.js.map +1 -0
  14. package/dist/http.cjs +214 -142
  15. package/dist/http.cjs.map +1 -1
  16. package/dist/http.d.cts +14 -1
  17. package/dist/http.d.ts +14 -1
  18. package/dist/http.js +226 -0
  19. package/dist/{http.mjs.map → http.js.map} +1 -1
  20. package/dist/index.cjs +290 -165
  21. package/dist/index.cjs.map +1 -1
  22. package/dist/index.d.cts +26 -1
  23. package/dist/index.d.ts +26 -1
  24. package/dist/index.js +306 -0
  25. package/dist/index.js.map +1 -0
  26. package/dist/json.cjs +83 -0
  27. package/dist/json.cjs.map +1 -0
  28. package/dist/json.d.cts +56 -0
  29. package/dist/json.d.ts +56 -0
  30. package/dist/json.js +80 -0
  31. package/dist/json.js.map +1 -0
  32. package/dist/logging.cjs +209 -137
  33. package/dist/logging.cjs.map +1 -1
  34. package/dist/logging.d.cts +23 -14
  35. package/dist/logging.d.ts +23 -14
  36. package/dist/logging.js +221 -0
  37. package/dist/logging.js.map +1 -0
  38. package/dist/package-manager.cjs +7353 -173
  39. package/dist/package-manager.cjs.map +1 -1
  40. package/dist/package-manager.d.cts +26 -3
  41. package/dist/package-manager.d.ts +26 -3
  42. package/dist/package-manager.js +7385 -0
  43. package/dist/package-manager.js.map +1 -0
  44. package/dist/retry.cjs +137 -0
  45. package/dist/retry.cjs.map +1 -0
  46. package/dist/retry.d.cts +19 -0
  47. package/dist/retry.d.ts +19 -0
  48. package/dist/retry.js +136 -0
  49. package/dist/retry.js.map +1 -0
  50. package/dist/runtime.cjs +58 -40
  51. package/dist/runtime.cjs.map +1 -1
  52. package/dist/runtime.d.cts +3 -0
  53. package/dist/runtime.d.ts +3 -0
  54. package/dist/runtime.js +45 -0
  55. package/dist/runtime.js.map +1 -0
  56. package/dist/string.cjs +76 -0
  57. package/dist/string.cjs.map +1 -0
  58. package/dist/string.d.cts +58 -0
  59. package/dist/string.d.ts +58 -0
  60. package/dist/string.js +72 -0
  61. package/dist/string.js.map +1 -0
  62. package/dist/terminal.cjs +426 -229
  63. package/dist/terminal.cjs.map +1 -1
  64. package/dist/terminal.d.cts +54 -24
  65. package/dist/terminal.d.ts +54 -24
  66. package/dist/terminal.js +441 -0
  67. package/dist/terminal.js.map +1 -0
  68. package/dist/url.cjs +25 -0
  69. package/dist/url.cjs.map +1 -0
  70. package/dist/url.d.cts +20 -0
  71. package/dist/url.d.ts +20 -0
  72. package/dist/url.js +24 -0
  73. package/dist/url.js.map +1 -0
  74. package/dist/validation.cjs +10486 -190
  75. package/dist/validation.cjs.map +1 -1
  76. package/dist/validation.d.cts +128 -94
  77. package/dist/validation.d.ts +128 -94
  78. package/dist/validation.js +10482 -0
  79. package/dist/validation.js.map +1 -0
  80. package/package.json +6 -6
  81. package/dist/environment.mjs +0 -383
  82. package/dist/environment.mjs.map +0 -1
  83. package/dist/filesystem.mjs +0 -105
  84. package/dist/filesystem.mjs.map +0 -1
  85. package/dist/http.mjs +0 -129
  86. package/dist/index.mjs +0 -156
  87. package/dist/index.mjs.map +0 -1
  88. package/dist/logging.mjs +0 -123
  89. package/dist/logging.mjs.map +0 -1
  90. package/dist/package-manager.mjs +0 -167
  91. package/dist/package-manager.mjs.map +0 -1
  92. package/dist/runtime.mjs +0 -23
  93. package/dist/runtime.mjs.map +0 -1
  94. package/dist/terminal.mjs +0 -230
  95. package/dist/terminal.mjs.map +0 -1
  96. package/dist/validation.mjs +0 -159
  97. package/dist/validation.mjs.map +0 -1
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/filesystem/project-root.ts","../src/filesystem/exists.ts","../src/filesystem/mono-repo.ts","../src/json.ts"],"sourcesContent":["import { dirname } from \"node:path\";\nimport { findUp } from \"find-up\";\n\n/**\n * Finds the root directory of the current project by locating the nearest package.json file\n *\n * @param fallbackToCwd - If true, will return the current working directory if no package.json is found\n * @param cwd - The directory to start searching for the package.json file from (defaults to process.cwd())\n * @returns Promise that resolves to the absolute path of the project root directory\n * @throws Will throw an error if no package.json is found in the directory tree\n * @example\n * import { projectRoot } from \"@settlemint/sdk-utils/filesystem\";\n *\n * // Get project root path\n * const rootDir = await projectRoot();\n * console.log(`Project root is at: ${rootDir}`);\n */\nexport async function projectRoot(fallbackToCwd = false, cwd?: string): Promise<string> {\n const packageJsonPath = await findUp(\"package.json\", { cwd });\n if (!packageJsonPath) {\n if (fallbackToCwd) {\n return process.cwd();\n }\n throw new Error(\"Unable to find project root (no package.json found)\");\n }\n return dirname(packageJsonPath);\n}\n","import type { PathLike } from \"node:fs\";\nimport { stat } from \"node:fs/promises\";\n\n/**\n * Checks if a file or directory exists at the given path\n *\n * @param path - The file system path to check for existence\n * @returns Promise that resolves to true if the path exists, false otherwise\n * @example\n * import { exists } from \"@settlemint/sdk-utils/filesystem\";\n *\n * // Check if file exists before reading\n * if (await exists('/path/to/file.txt')) {\n * // File exists, safe to read\n * }\n */\nexport async function exists(path: PathLike): Promise<boolean> {\n try {\n await stat(path);\n return true;\n } catch {\n return false;\n }\n}\n","import { readFile } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\nimport { exists } from \"@/filesystem.js\";\nimport { tryParseJson } from \"@/json.js\";\nimport { findUp } from \"find-up\";\nimport { glob } from \"glob\";\n\n/**\n * Finds the root directory of a monorepo\n *\n * @param startDir - The directory to start searching from\n * @returns The root directory of the monorepo or null if not found\n * @example\n * import { findMonoRepoRoot } from \"@settlemint/sdk-utils/filesystem\";\n *\n * const root = await findMonoRepoRoot(\"/path/to/your/project\");\n * console.log(root); // Output: /path/to/your/project/packages/core\n */\nexport async function findMonoRepoRoot(startDir: string): Promise<string | null> {\n const lockFilePath = await findUp([\"package-lock.json\", \"yarn.lock\", \"pnpm-lock.yaml\", \"bun.lockb\", \"bun.lock\"], {\n cwd: startDir,\n });\n if (lockFilePath) {\n const packageJsonPath = join(dirname(lockFilePath), \"package.json\");\n const hasWorkSpaces = await packageJsonHasWorkspaces(packageJsonPath);\n return hasWorkSpaces ? dirname(lockFilePath) : null;\n }\n\n let currentDir = startDir;\n\n while (currentDir !== \"/\") {\n const packageJsonPath = join(currentDir, \"package.json\");\n\n if (await packageJsonHasWorkspaces(packageJsonPath)) {\n return currentDir;\n }\n\n const parentDir = dirname(currentDir);\n if (parentDir === currentDir) {\n break; // We've reached the root\n }\n currentDir = parentDir;\n }\n\n return null;\n}\n\n/**\n * Finds all packages in a monorepo\n *\n * @param projectDir - The directory to start searching from\n * @returns An array of package directories\n * @example\n * import { findMonoRepoPackages } from \"@settlemint/sdk-utils/filesystem\";\n *\n * const packages = await findMonoRepoPackages(\"/path/to/your/project\");\n * console.log(packages); // Output: [\"/path/to/your/project/packages/core\", \"/path/to/your/project/packages/ui\"]\n */\nexport async function findMonoRepoPackages(projectDir: string): Promise<string[]> {\n try {\n const monoRepoRoot = await findMonoRepoRoot(projectDir);\n if (!monoRepoRoot) {\n return [projectDir];\n }\n\n const packageJsonPath = join(monoRepoRoot, \"package.json\");\n const packageJson = tryParseJson<{ workspaces: string[] }>(await readFile(packageJsonPath, \"utf-8\"));\n const workspaces = packageJson?.workspaces ?? [];\n\n const packagePaths = await Promise.all(\n workspaces.map(async (workspace: string) => {\n const matches = await glob(join(monoRepoRoot, workspace, \"package.json\"));\n return matches.map((match) => join(match, \"..\"));\n }),\n );\n\n const allPaths = packagePaths.flat();\n // If no packages found in workspaces, treat as non-monorepo\n return allPaths.length === 0 ? [projectDir] : [monoRepoRoot, ...allPaths];\n } catch (error) {\n // If any error occurs, treat as non-monorepo\n return [projectDir];\n }\n}\n\nasync function packageJsonHasWorkspaces(packageJsonPath: string): Promise<boolean> {\n if (await exists(packageJsonPath)) {\n const packageJson = tryParseJson<{ workspaces: string[] }>(await readFile(packageJsonPath, \"utf-8\"));\n if (packageJson?.workspaces && Array.isArray(packageJson?.workspaces) && packageJson?.workspaces.length > 0) {\n return true;\n }\n }\n return false;\n}\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"],"mappings":";AAAA,SAAS,eAAe;AACxB,SAAS,cAAc;AAgBvB,eAAsB,YAAY,gBAAgB,OAAO,KAA+B;AACtF,QAAM,kBAAkB,MAAM,OAAO,gBAAgB,EAAE,IAAI,CAAC;AAC5D,MAAI,CAAC,iBAAiB;AACpB,QAAI,eAAe;AACjB,aAAO,QAAQ,IAAI;AAAA,IACrB;AACA,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE;AACA,SAAO,QAAQ,eAAe;AAChC;;;ACzBA,SAAS,YAAY;AAerB,eAAsB,OAAO,MAAkC;AAC7D,MAAI;AACF,UAAM,KAAK,IAAI;AACf,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;;;ACvBA,SAAS,gBAAgB;AACzB,SAAS,WAAAA,UAAS,YAAY;;;ACqBvB,SAAS,aAAgB,OAAe,eAAyB,MAAgB;AACtF,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,QAAI,WAAW,UAAa,WAAW,MAAM;AAC3C,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT,SAAS,KAAK;AAEZ,WAAO;AAAA,EACT;AACF;;;AD7BA,SAAS,UAAAC,eAAc;AACvB,SAAS,YAAY;AAarB,eAAsB,iBAAiB,UAA0C;AAC/E,QAAM,eAAe,MAAMA,QAAO,CAAC,qBAAqB,aAAa,kBAAkB,aAAa,UAAU,GAAG;AAAA,IAC/G,KAAK;AAAA,EACP,CAAC;AACD,MAAI,cAAc;AAChB,UAAM,kBAAkB,KAAKC,SAAQ,YAAY,GAAG,cAAc;AAClE,UAAM,gBAAgB,MAAM,yBAAyB,eAAe;AACpE,WAAO,gBAAgBA,SAAQ,YAAY,IAAI;AAAA,EACjD;AAEA,MAAI,aAAa;AAEjB,SAAO,eAAe,KAAK;AACzB,UAAM,kBAAkB,KAAK,YAAY,cAAc;AAEvD,QAAI,MAAM,yBAAyB,eAAe,GAAG;AACnD,aAAO;AAAA,IACT;AAEA,UAAM,YAAYA,SAAQ,UAAU;AACpC,QAAI,cAAc,YAAY;AAC5B;AAAA,IACF;AACA,iBAAa;AAAA,EACf;AAEA,SAAO;AACT;AAaA,eAAsB,qBAAqB,YAAuC;AAChF,MAAI;AACF,UAAM,eAAe,MAAM,iBAAiB,UAAU;AACtD,QAAI,CAAC,cAAc;AACjB,aAAO,CAAC,UAAU;AAAA,IACpB;AAEA,UAAM,kBAAkB,KAAK,cAAc,cAAc;AACzD,UAAM,cAAc,aAAuC,MAAM,SAAS,iBAAiB,OAAO,CAAC;AACnG,UAAM,aAAa,aAAa,cAAc,CAAC;AAE/C,UAAM,eAAe,MAAM,QAAQ;AAAA,MACjC,WAAW,IAAI,OAAO,cAAsB;AAC1C,cAAM,UAAU,MAAM,KAAK,KAAK,cAAc,WAAW,cAAc,CAAC;AACxE,eAAO,QAAQ,IAAI,CAAC,UAAU,KAAK,OAAO,IAAI,CAAC;AAAA,MACjD,CAAC;AAAA,IACH;AAEA,UAAM,WAAW,aAAa,KAAK;AAEnC,WAAO,SAAS,WAAW,IAAI,CAAC,UAAU,IAAI,CAAC,cAAc,GAAG,QAAQ;AAAA,EAC1E,SAAS,OAAO;AAEd,WAAO,CAAC,UAAU;AAAA,EACpB;AACF;AAEA,eAAe,yBAAyB,iBAA2C;AACjF,MAAI,MAAM,OAAO,eAAe,GAAG;AACjC,UAAM,cAAc,aAAuC,MAAM,SAAS,iBAAiB,OAAO,CAAC;AACnG,QAAI,aAAa,cAAc,MAAM,QAAQ,aAAa,UAAU,KAAK,aAAa,WAAW,SAAS,GAAG;AAC3G,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;","names":["dirname","findUp","dirname"]}
package/dist/http.mjs DELETED
@@ -1,129 +0,0 @@
1
- // src/logging/mask-tokens.ts
2
- var maskTokens = (output) => {
3
- return output.replace(/sm_(pat|aat|sat)_[0-9a-zA-Z]+/g, "***");
4
- };
5
-
6
- // src/logging/logger.ts
7
- function createLogger(options = {}) {
8
- const { level = "warn", prefix = "" } = options;
9
- const logLevels = {
10
- debug: 0,
11
- info: 1,
12
- warn: 2,
13
- error: 3,
14
- none: 4
15
- };
16
- const currentLevelValue = logLevels[level];
17
- const formatArgs = (args) => {
18
- if (args.length === 0 || args.every((arg) => arg === void 0 || arg === null)) {
19
- return "";
20
- }
21
- const formatted = args.map((arg) => {
22
- if (arg instanceof Error) {
23
- return `
24
- ${arg.stack || arg.message}`;
25
- }
26
- if (typeof arg === "object" && arg !== null) {
27
- return `
28
- ${JSON.stringify(arg, null, 2)}`;
29
- }
30
- return ` ${String(arg)}`;
31
- }).join("");
32
- return `, args:${formatted}`;
33
- };
34
- const shouldLog = (level2) => {
35
- return logLevels[level2] >= currentLevelValue;
36
- };
37
- return {
38
- debug: (message, ...args) => {
39
- if (shouldLog("debug")) {
40
- console.debug(`\x1B[32m${prefix}[DEBUG] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1B[0m`);
41
- }
42
- },
43
- info: (message, ...args) => {
44
- if (shouldLog("info")) {
45
- console.info(`\x1B[34m${prefix}[INFO] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1B[0m`);
46
- }
47
- },
48
- warn: (message, ...args) => {
49
- if (shouldLog("warn")) {
50
- console.warn(`\x1B[33m${prefix}[WARN] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1B[0m`);
51
- }
52
- },
53
- error: (message, ...args) => {
54
- if (shouldLog("error")) {
55
- console.error(`\x1B[31m${prefix}[ERROR] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1B[0m`);
56
- }
57
- }
58
- };
59
- }
60
- var logger = createLogger();
61
-
62
- // src/retry.ts
63
- async function retryWhenFailed(fn, maxRetries = 5, initialSleepTime = 1e3, stopOnError) {
64
- let retries = 0;
65
- const maxAttempts = maxRetries + 1;
66
- while (retries < maxAttempts) {
67
- try {
68
- return await fn();
69
- } catch (e) {
70
- const error = e;
71
- if (typeof stopOnError === "function") {
72
- if (stopOnError(error)) {
73
- throw error;
74
- }
75
- }
76
- if (retries >= maxRetries) {
77
- throw e;
78
- }
79
- const baseDelay = 2 ** retries * initialSleepTime;
80
- const jitterAmount = initialSleepTime * (Math.random() / 10);
81
- const delay = baseDelay + jitterAmount;
82
- retries += 1;
83
- logger.warn(
84
- `An error occurred ${error.message}, retrying in ${delay.toFixed(0)}ms (retry ${retries} of ${maxRetries})...`
85
- );
86
- await new Promise((resolve) => setTimeout(resolve, delay));
87
- }
88
- }
89
- throw new Error("Retry failed");
90
- }
91
-
92
- // src/http/fetch-with-retry.ts
93
- async function fetchWithRetry(input, init, maxRetries = 5, initialSleepTime = 3e3) {
94
- return retryWhenFailed(
95
- async () => {
96
- const response = await fetch(input, init);
97
- if (response.ok) {
98
- return response;
99
- }
100
- if (response.status < 500 && response.status !== 429 && response.status !== 408 && response.status !== 0) {
101
- return response;
102
- }
103
- throw new Error(`HTTP error! status: ${response.status} ${response.statusText}`);
104
- },
105
- maxRetries,
106
- initialSleepTime
107
- );
108
- }
109
-
110
- // src/http/graphql-fetch-with-retry.ts
111
- async function graphqlFetchWithRetry(input, init, maxRetries = 5, initialSleepTime = 3e3) {
112
- return retryWhenFailed(
113
- async () => {
114
- const response = await fetchWithRetry(input, init);
115
- const json = await response.json();
116
- if (json.errors) {
117
- throw new Error(`GraphQL errors in response: ${json.errors.map((error) => error.message).join(", ")}`);
118
- }
119
- return json.data;
120
- },
121
- maxRetries,
122
- initialSleepTime
123
- );
124
- }
125
- export {
126
- fetchWithRetry,
127
- graphqlFetchWithRetry
128
- };
129
- //# sourceMappingURL=http.mjs.map
package/dist/index.mjs DELETED
@@ -1,156 +0,0 @@
1
- // src/json.ts
2
- function tryParseJson(value, defaultValue = null) {
3
- try {
4
- const parsed = JSON.parse(value);
5
- if (parsed === void 0 || parsed === null) {
6
- return defaultValue;
7
- }
8
- return parsed;
9
- } catch (err) {
10
- return defaultValue;
11
- }
12
- }
13
- function extractJsonObject(value) {
14
- if (value.length > 5e3) {
15
- throw new Error("Input too long");
16
- }
17
- const result = /\{([\s\S]*)\}/.exec(value);
18
- if (!result) {
19
- return null;
20
- }
21
- return tryParseJson(result[0]);
22
- }
23
- function makeJsonStringifiable(value) {
24
- if (value === void 0 || value === null) {
25
- return value;
26
- }
27
- return tryParseJson(
28
- JSON.stringify(
29
- value,
30
- (_, value2) => typeof value2 === "bigint" ? value2.toString() : value2
31
- // return everything else unchanged
32
- )
33
- );
34
- }
35
-
36
- // src/logging/mask-tokens.ts
37
- var maskTokens = (output) => {
38
- return output.replace(/sm_(pat|aat|sat)_[0-9a-zA-Z]+/g, "***");
39
- };
40
-
41
- // src/logging/logger.ts
42
- function createLogger(options = {}) {
43
- const { level = "warn", prefix = "" } = options;
44
- const logLevels = {
45
- debug: 0,
46
- info: 1,
47
- warn: 2,
48
- error: 3,
49
- none: 4
50
- };
51
- const currentLevelValue = logLevels[level];
52
- const formatArgs = (args) => {
53
- if (args.length === 0 || args.every((arg) => arg === void 0 || arg === null)) {
54
- return "";
55
- }
56
- const formatted = args.map((arg) => {
57
- if (arg instanceof Error) {
58
- return `
59
- ${arg.stack || arg.message}`;
60
- }
61
- if (typeof arg === "object" && arg !== null) {
62
- return `
63
- ${JSON.stringify(arg, null, 2)}`;
64
- }
65
- return ` ${String(arg)}`;
66
- }).join("");
67
- return `, args:${formatted}`;
68
- };
69
- const shouldLog = (level2) => {
70
- return logLevels[level2] >= currentLevelValue;
71
- };
72
- return {
73
- debug: (message, ...args) => {
74
- if (shouldLog("debug")) {
75
- console.debug(`\x1B[32m${prefix}[DEBUG] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1B[0m`);
76
- }
77
- },
78
- info: (message, ...args) => {
79
- if (shouldLog("info")) {
80
- console.info(`\x1B[34m${prefix}[INFO] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1B[0m`);
81
- }
82
- },
83
- warn: (message, ...args) => {
84
- if (shouldLog("warn")) {
85
- console.warn(`\x1B[33m${prefix}[WARN] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1B[0m`);
86
- }
87
- },
88
- error: (message, ...args) => {
89
- if (shouldLog("error")) {
90
- console.error(`\x1B[31m${prefix}[ERROR] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1B[0m`);
91
- }
92
- }
93
- };
94
- }
95
- var logger = createLogger();
96
-
97
- // src/retry.ts
98
- async function retryWhenFailed(fn, maxRetries = 5, initialSleepTime = 1e3, stopOnError) {
99
- let retries = 0;
100
- const maxAttempts = maxRetries + 1;
101
- while (retries < maxAttempts) {
102
- try {
103
- return await fn();
104
- } catch (e) {
105
- const error = e;
106
- if (typeof stopOnError === "function") {
107
- if (stopOnError(error)) {
108
- throw error;
109
- }
110
- }
111
- if (retries >= maxRetries) {
112
- throw e;
113
- }
114
- const baseDelay = 2 ** retries * initialSleepTime;
115
- const jitterAmount = initialSleepTime * (Math.random() / 10);
116
- const delay = baseDelay + jitterAmount;
117
- retries += 1;
118
- logger.warn(
119
- `An error occurred ${error.message}, retrying in ${delay.toFixed(0)}ms (retry ${retries} of ${maxRetries})...`
120
- );
121
- await new Promise((resolve) => setTimeout(resolve, delay));
122
- }
123
- }
124
- throw new Error("Retry failed");
125
- }
126
-
127
- // src/string.ts
128
- function capitalizeFirstLetter(val) {
129
- return String(val).charAt(0).toUpperCase() + String(val).slice(1);
130
- }
131
- function camelCaseToWords(s) {
132
- const result = s.replace(/([a-z])([A-Z])/g, "$1 $2");
133
- const withSpaces = result.replace(/([A-Z])([a-z])/g, " $1$2");
134
- const capitalized = capitalizeFirstLetter(withSpaces);
135
- return capitalized.replace(/\s+/g, " ").trim();
136
- }
137
- function replaceUnderscoresAndHyphensWithSpaces(s) {
138
- return s.replace(/[-_]/g, " ");
139
- }
140
- function truncate(value, maxLength) {
141
- if (value.length <= maxLength) {
142
- return value;
143
- }
144
- return `${value.slice(0, maxLength)}...`;
145
- }
146
- export {
147
- camelCaseToWords,
148
- capitalizeFirstLetter,
149
- extractJsonObject,
150
- makeJsonStringifiable,
151
- replaceUnderscoresAndHyphensWithSpaces,
152
- retryWhenFailed,
153
- truncate,
154
- tryParseJson
155
- };
156
- //# sourceMappingURL=index.mjs.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/json.ts","../src/logging/mask-tokens.ts","../src/logging/logger.ts","../src/retry.ts","../src/string.ts"],"sourcesContent":["/**\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","/**\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 \"./mask-tokens.js\";\n\n/**\n * Log levels supported by the logger\n */\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"none\";\n\n/**\n * Configuration options for the logger\n * @interface LoggerOptions\n */\nexport interface LoggerOptions {\n /** The minimum log level to output */\n level?: LogLevel;\n /** The prefix to add to the log message */\n prefix?: string;\n}\n\n/**\n * Simple logger interface with basic logging methods\n * @interface Logger\n */\nexport interface Logger {\n /** Log debug information */\n debug: (message: string, ...args: unknown[]) => void;\n /** Log general information */\n info: (message: string, ...args: unknown[]) => void;\n /** Log warnings */\n warn: (message: string, ...args: unknown[]) => void;\n /** Log errors */\n error: (message: string, ...args: unknown[]) => void;\n}\n\n/**\n * Creates a simple logger with configurable log level\n *\n * @param options - Configuration options for the logger\n * @param options.level - The minimum log level to output (default: warn)\n * @param options.prefix - The prefix to add to the log message (default: \"\")\n * @returns A logger instance with debug, info, warn, and error methods\n *\n * @example\n * import { createLogger } from \"@/utils/logging/logger\";\n *\n * const logger = createLogger({ level: 'info' });\n *\n * logger.info('User logged in', { userId: '123' });\n * logger.error('Operation failed', new Error('Connection timeout'));\n */\nexport function createLogger(options: LoggerOptions = {}): Logger {\n const { level = \"warn\", prefix = \"\" } = options;\n\n const logLevels: Record<LogLevel, number> = {\n debug: 0,\n info: 1,\n warn: 2,\n error: 3,\n none: 4,\n };\n\n const currentLevelValue = logLevels[level];\n\n const formatArgs = (args: unknown[]): string => {\n if (args.length === 0 || args.every((arg) => arg === undefined || arg === null)) {\n return \"\";\n }\n\n const formatted = args\n .map((arg) => {\n if (arg instanceof Error) {\n return `\\n${arg.stack || arg.message}`;\n }\n if (typeof arg === \"object\" && arg !== null) {\n return `\\n${JSON.stringify(arg, null, 2)}`;\n }\n return ` ${String(arg)}`;\n })\n .join(\"\");\n\n return `, args:${formatted}`;\n };\n\n const shouldLog = (level: LogLevel): boolean => {\n return logLevels[level] >= currentLevelValue;\n };\n\n return {\n debug: (message: string, ...args: unknown[]) => {\n if (shouldLog(\"debug\")) {\n console.debug(`\\x1b[32m${prefix}[DEBUG] ${maskTokens(message)}${maskTokens(formatArgs(args))}\\x1b[0m`);\n }\n },\n info: (message: string, ...args: unknown[]) => {\n if (shouldLog(\"info\")) {\n console.info(`\\x1b[34m${prefix}[INFO] ${maskTokens(message)}${maskTokens(formatArgs(args))}\\x1b[0m`);\n }\n },\n warn: (message: string, ...args: unknown[]) => {\n if (shouldLog(\"warn\")) {\n console.warn(`\\x1b[33m${prefix}[WARN] ${maskTokens(message)}${maskTokens(formatArgs(args))}\\x1b[0m`);\n }\n },\n error: (message: string, ...args: unknown[]) => {\n if (shouldLog(\"error\")) {\n console.error(`\\x1b[31m${prefix}[ERROR] ${maskTokens(message)}${maskTokens(formatArgs(args))}\\x1b[0m`);\n }\n },\n };\n}\n\n/**\n * Default logger instance with standard configuration\n */\nexport const logger = createLogger();\n","import { logger } from \"./logging/logger.js\";\n\n/**\n * Retry a function when it fails.\n * @param fn - The function to retry.\n * @param maxRetries - The maximum number of retries.\n * @param initialSleepTime - The initial time to sleep between exponential backoff retries.\n * @param stopOnError - The function to stop on error.\n * @returns The result of the function or undefined if it fails.\n * @example\n * import { retryWhenFailed } from \"@settlemint/sdk-utils\";\n * import { readFile } from \"node:fs/promises\";\n *\n * const result = await retryWhenFailed(() => readFile(\"/path/to/file.txt\"), 3, 1_000);\n */\nexport async function retryWhenFailed<T>(\n fn: () => Promise<T>,\n maxRetries = 5,\n initialSleepTime = 1_000,\n stopOnError?: (error: Error) => boolean,\n): Promise<T> {\n let retries = 0;\n const maxAttempts = maxRetries + 1;\n\n while (retries < maxAttempts) {\n try {\n return await fn();\n } catch (e) {\n const error = e as Error;\n if (typeof stopOnError === \"function\") {\n if (stopOnError(error)) {\n throw error;\n }\n }\n if (retries >= maxRetries) {\n throw e;\n }\n // Exponential backoff with jitter to prevent thundering herd\n // Jitter: Random value between 0-10% of initialSleepTime\n const baseDelay = 2 ** retries * initialSleepTime;\n const jitterAmount = initialSleepTime * (Math.random() / 10);\n const delay = baseDelay + jitterAmount;\n retries += 1;\n logger.warn(\n `An error occurred ${error.message}, retrying in ${delay.toFixed(0)}ms (retry ${retries} of ${maxRetries})...`,\n );\n await new Promise((resolve) => setTimeout(resolve, delay));\n }\n }\n\n throw new Error(\"Retry failed\");\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"],"mappings":"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","names":["value","level"]}
package/dist/logging.mjs DELETED
@@ -1,123 +0,0 @@
1
- // src/logging/mask-tokens.ts
2
- var maskTokens = (output) => {
3
- return output.replace(/sm_(pat|aat|sat)_[0-9a-zA-Z]+/g, "***");
4
- };
5
-
6
- // src/logging/logger.ts
7
- function createLogger(options = {}) {
8
- const { level = "warn", prefix = "" } = options;
9
- const logLevels = {
10
- debug: 0,
11
- info: 1,
12
- warn: 2,
13
- error: 3,
14
- none: 4
15
- };
16
- const currentLevelValue = logLevels[level];
17
- const formatArgs = (args) => {
18
- if (args.length === 0 || args.every((arg) => arg === void 0 || arg === null)) {
19
- return "";
20
- }
21
- const formatted = args.map((arg) => {
22
- if (arg instanceof Error) {
23
- return `
24
- ${arg.stack || arg.message}`;
25
- }
26
- if (typeof arg === "object" && arg !== null) {
27
- return `
28
- ${JSON.stringify(arg, null, 2)}`;
29
- }
30
- return ` ${String(arg)}`;
31
- }).join("");
32
- return `, args:${formatted}`;
33
- };
34
- const shouldLog = (level2) => {
35
- return logLevels[level2] >= currentLevelValue;
36
- };
37
- return {
38
- debug: (message, ...args) => {
39
- if (shouldLog("debug")) {
40
- console.debug(`\x1B[32m${prefix}[DEBUG] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1B[0m`);
41
- }
42
- },
43
- info: (message, ...args) => {
44
- if (shouldLog("info")) {
45
- console.info(`\x1B[34m${prefix}[INFO] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1B[0m`);
46
- }
47
- },
48
- warn: (message, ...args) => {
49
- if (shouldLog("warn")) {
50
- console.warn(`\x1B[33m${prefix}[WARN] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1B[0m`);
51
- }
52
- },
53
- error: (message, ...args) => {
54
- if (shouldLog("error")) {
55
- console.error(`\x1B[31m${prefix}[ERROR] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1B[0m`);
56
- }
57
- }
58
- };
59
- }
60
- var logger = createLogger();
61
-
62
- // src/string.ts
63
- function truncate(value, maxLength) {
64
- if (value.length <= maxLength) {
65
- return value;
66
- }
67
- return `${value.slice(0, maxLength)}...`;
68
- }
69
-
70
- // src/logging/request-logger.ts
71
- var WARNING_THRESHOLD = 500;
72
- var TRUNCATE_LENGTH = 50;
73
- function requestLogger(logger2, name, fn) {
74
- return async (...args) => {
75
- const start = Date.now();
76
- try {
77
- return await fn(...args);
78
- } finally {
79
- const end = Date.now();
80
- const duration = end - start;
81
- const body = extractInfoFromBody(args[1]?.body ?? "{}");
82
- const message = `${name} path: ${args[0]}, took ${formatDuration(duration)}`;
83
- if (duration > WARNING_THRESHOLD) {
84
- logger2.warn(message, body);
85
- } else {
86
- logger2.info(message, body);
87
- }
88
- }
89
- };
90
- }
91
- function formatDuration(duration) {
92
- return duration < 1e3 ? `${duration}ms` : `${(duration / 1e3).toFixed(3)}s`;
93
- }
94
- function extractInfoFromBody(body) {
95
- try {
96
- const parsedBody = typeof body === "string" ? JSON.parse(body) : body;
97
- if (parsedBody === null || parsedBody === void 0 || Object.keys(parsedBody).length === 0) {
98
- return null;
99
- }
100
- const dataToKeep = {};
101
- if ("query" in parsedBody) {
102
- dataToKeep.query = truncate(parsedBody.query, TRUNCATE_LENGTH);
103
- }
104
- if ("variables" in parsedBody) {
105
- dataToKeep.variables = truncate(JSON.stringify(parsedBody.variables), TRUNCATE_LENGTH);
106
- }
107
- if ("operationName" in parsedBody) {
108
- dataToKeep.operationName = truncate(parsedBody.operationName, TRUNCATE_LENGTH);
109
- }
110
- if (Object.keys(dataToKeep).length > 0) {
111
- return JSON.stringify(dataToKeep);
112
- }
113
- return truncate(JSON.stringify(parsedBody || "{}"), TRUNCATE_LENGTH);
114
- } catch {
115
- return "{}";
116
- }
117
- }
118
- export {
119
- createLogger,
120
- maskTokens,
121
- requestLogger
122
- };
123
- //# sourceMappingURL=logging.mjs.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/logging/mask-tokens.ts","../src/logging/logger.ts","../src/string.ts","../src/logging/request-logger.ts"],"sourcesContent":["/**\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 \"./mask-tokens.js\";\n\n/**\n * Log levels supported by the logger\n */\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"none\";\n\n/**\n * Configuration options for the logger\n * @interface LoggerOptions\n */\nexport interface LoggerOptions {\n /** The minimum log level to output */\n level?: LogLevel;\n /** The prefix to add to the log message */\n prefix?: string;\n}\n\n/**\n * Simple logger interface with basic logging methods\n * @interface Logger\n */\nexport interface Logger {\n /** Log debug information */\n debug: (message: string, ...args: unknown[]) => void;\n /** Log general information */\n info: (message: string, ...args: unknown[]) => void;\n /** Log warnings */\n warn: (message: string, ...args: unknown[]) => void;\n /** Log errors */\n error: (message: string, ...args: unknown[]) => void;\n}\n\n/**\n * Creates a simple logger with configurable log level\n *\n * @param options - Configuration options for the logger\n * @param options.level - The minimum log level to output (default: warn)\n * @param options.prefix - The prefix to add to the log message (default: \"\")\n * @returns A logger instance with debug, info, warn, and error methods\n *\n * @example\n * import { createLogger } from \"@/utils/logging/logger\";\n *\n * const logger = createLogger({ level: 'info' });\n *\n * logger.info('User logged in', { userId: '123' });\n * logger.error('Operation failed', new Error('Connection timeout'));\n */\nexport function createLogger(options: LoggerOptions = {}): Logger {\n const { level = \"warn\", prefix = \"\" } = options;\n\n const logLevels: Record<LogLevel, number> = {\n debug: 0,\n info: 1,\n warn: 2,\n error: 3,\n none: 4,\n };\n\n const currentLevelValue = logLevels[level];\n\n const formatArgs = (args: unknown[]): string => {\n if (args.length === 0 || args.every((arg) => arg === undefined || arg === null)) {\n return \"\";\n }\n\n const formatted = args\n .map((arg) => {\n if (arg instanceof Error) {\n return `\\n${arg.stack || arg.message}`;\n }\n if (typeof arg === \"object\" && arg !== null) {\n return `\\n${JSON.stringify(arg, null, 2)}`;\n }\n return ` ${String(arg)}`;\n })\n .join(\"\");\n\n return `, args:${formatted}`;\n };\n\n const shouldLog = (level: LogLevel): boolean => {\n return logLevels[level] >= currentLevelValue;\n };\n\n return {\n debug: (message: string, ...args: unknown[]) => {\n if (shouldLog(\"debug\")) {\n console.debug(`\\x1b[32m${prefix}[DEBUG] ${maskTokens(message)}${maskTokens(formatArgs(args))}\\x1b[0m`);\n }\n },\n info: (message: string, ...args: unknown[]) => {\n if (shouldLog(\"info\")) {\n console.info(`\\x1b[34m${prefix}[INFO] ${maskTokens(message)}${maskTokens(formatArgs(args))}\\x1b[0m`);\n }\n },\n warn: (message: string, ...args: unknown[]) => {\n if (shouldLog(\"warn\")) {\n console.warn(`\\x1b[33m${prefix}[WARN] ${maskTokens(message)}${maskTokens(formatArgs(args))}\\x1b[0m`);\n }\n },\n error: (message: string, ...args: unknown[]) => {\n if (shouldLog(\"error\")) {\n console.error(`\\x1b[31m${prefix}[ERROR] ${maskTokens(message)}${maskTokens(formatArgs(args))}\\x1b[0m`);\n }\n },\n };\n}\n\n/**\n * Default logger instance with standard configuration\n */\nexport const logger = createLogger();\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 { truncate } from \"../string.js\";\nimport type { Logger } from \"./logger.js\";\n\nconst WARNING_THRESHOLD = 500;\nconst TRUNCATE_LENGTH = 50;\n\n/**\n * Logs the request and duration of a fetch call (> 500ms is logged as warn, otherwise info)\n * @param logger - The logger to use\n * @param name - The name of the request\n * @param fn - The fetch function to use\n * @returns The fetch function\n */\nexport function requestLogger(logger: Logger, name: string, fn: typeof fetch) {\n return async (...args: Parameters<typeof fetch>) => {\n const start = Date.now();\n try {\n return await fn(...args);\n } finally {\n const end = Date.now();\n const duration = end - start;\n const body = extractInfoFromBody(args[1]?.body ?? \"{}\");\n const message = `${name} path: ${args[0]}, took ${formatDuration(duration)}`;\n if (duration > WARNING_THRESHOLD) {\n logger.warn(message, body);\n } else {\n logger.info(message, body);\n }\n }\n };\n}\n\nfunction formatDuration(duration: number) {\n return duration < 1000 ? `${duration}ms` : `${(duration / 1000).toFixed(3)}s`;\n}\n\nfunction extractInfoFromBody(body: BodyInit) {\n try {\n const parsedBody = typeof body === \"string\" ? JSON.parse(body) : body;\n\n if (parsedBody === null || parsedBody === undefined || Object.keys(parsedBody).length === 0) {\n return null;\n }\n\n const dataToKeep: Record<string, unknown> = {};\n // Check for graphql fields\n if (\"query\" in parsedBody) {\n dataToKeep.query = truncate(parsedBody.query, TRUNCATE_LENGTH);\n }\n if (\"variables\" in parsedBody) {\n dataToKeep.variables = truncate(JSON.stringify(parsedBody.variables), TRUNCATE_LENGTH);\n }\n if (\"operationName\" in parsedBody) {\n dataToKeep.operationName = truncate(parsedBody.operationName, TRUNCATE_LENGTH);\n }\n\n if (Object.keys(dataToKeep).length > 0) {\n return JSON.stringify(dataToKeep);\n }\n\n // Not graphql, return the body as is\n return truncate(JSON.stringify(parsedBody || \"{}\"), TRUNCATE_LENGTH);\n } catch {\n return \"{}\";\n }\n}\n"],"mappings":"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","names":["level","logger"]}
@@ -1,167 +0,0 @@
1
- // src/package-manager/download-and-extract.ts
2
- import { readdir, rm } from "fs/promises";
3
- import { resolve } from "path";
4
-
5
- // src/filesystem/project-root.ts
6
- import { dirname } from "path";
7
- import { findUp } from "find-up";
8
- async function projectRoot(fallbackToCwd = false, cwd) {
9
- const packageJsonPath = await findUp("package.json", { cwd });
10
- if (!packageJsonPath) {
11
- if (fallbackToCwd) {
12
- return process.cwd();
13
- }
14
- throw new Error("Unable to find project root (no package.json found)");
15
- }
16
- return dirname(packageJsonPath);
17
- }
18
-
19
- // src/filesystem/exists.ts
20
- import { stat } from "fs/promises";
21
- async function exists(path) {
22
- try {
23
- await stat(path);
24
- return true;
25
- } catch {
26
- return false;
27
- }
28
- }
29
-
30
- // src/filesystem/mono-repo.ts
31
- import { readFile } from "fs/promises";
32
- import { dirname as dirname2, join } from "path";
33
- import { findUp as findUp2 } from "find-up";
34
- import { glob } from "glob";
35
-
36
- // src/package-manager/download-and-extract.ts
37
- function formatTargetDir(targetDir) {
38
- return targetDir?.trim().replace(/\/+$/g, "");
39
- }
40
- async function isEmpty(path) {
41
- const files = await readdir(path);
42
- return files.length === 0 || files.length === 1 && files[0] === ".git";
43
- }
44
- async function emptyDir(dir) {
45
- if (!await exists(dir)) return;
46
- for (const file of await readdir(dir)) {
47
- if (file === ".git") continue;
48
- await rm(resolve(dir, file), { recursive: true, force: true });
49
- }
50
- }
51
-
52
- // src/package-manager/get-package-manager.ts
53
- import { detect } from "package-manager-detector/detect";
54
- async function getPackageManager(targetDir) {
55
- const packageManager = await detect({ cwd: targetDir || process.cwd() });
56
- return packageManager?.name ?? "npm";
57
- }
58
-
59
- // src/package-manager/get-package-manager-executable.ts
60
- async function getPackageManagerExecutable(targetDir) {
61
- const packageManager = await getPackageManager(targetDir ?? process.cwd());
62
- switch (packageManager) {
63
- case "pnpm":
64
- return { command: "pnpm", args: ["dlx"] };
65
- case "bun":
66
- return { command: "bunx", args: [] };
67
- case "yarn":
68
- return { command: "yarn", args: ["create"] };
69
- }
70
- return { command: "npx", args: [] };
71
- }
72
-
73
- // src/package-manager/install-dependencies.ts
74
- import { installPackage } from "@antfu/install-pkg";
75
-
76
- // src/terminal/ascii.ts
77
- import { magentaBright } from "yoctocolors";
78
-
79
- // src/terminal/should-print.ts
80
- function shouldPrint() {
81
- return process.env.SETTLEMINT_DISABLE_TERMINAL !== "true";
82
- }
83
-
84
- // src/logging/mask-tokens.ts
85
- var maskTokens = (output) => {
86
- return output.replace(/sm_(pat|aat|sat)_[0-9a-zA-Z]+/g, "***");
87
- };
88
-
89
- // src/terminal/cancel.ts
90
- import { inverse, redBright } from "yoctocolors";
91
-
92
- // src/terminal/execute-command.ts
93
- import { spawn } from "child_process";
94
-
95
- // src/terminal/intro.ts
96
- import { magentaBright as magentaBright2 } from "yoctocolors";
97
-
98
- // src/terminal/note.ts
99
- import { yellowBright } from "yoctocolors";
100
- var note = (message, level = "info") => {
101
- if (!shouldPrint()) {
102
- return;
103
- }
104
- const maskedMessage = maskTokens(message);
105
- console.log("");
106
- if (level === "warn") {
107
- console.warn(yellowBright(maskedMessage));
108
- return;
109
- }
110
- console.log(maskedMessage);
111
- };
112
-
113
- // src/terminal/outro.ts
114
- import { greenBright, inverse as inverse2 } from "yoctocolors";
115
-
116
- // src/terminal/spinner.ts
117
- import isInCi from "is-in-ci";
118
- import yoctoSpinner from "yocto-spinner";
119
- import { redBright as redBright2 } from "yoctocolors";
120
-
121
- // src/terminal/table.ts
122
- import { Table } from "console-table-printer";
123
- import { whiteBright } from "yoctocolors";
124
-
125
- // src/package-manager/install-dependencies.ts
126
- async function installDependencies(pkgs, cwd) {
127
- try {
128
- await installPackage(pkgs, { silent: true, additionalArgs: ["--exact"], cwd });
129
- } catch (err) {
130
- const error = err instanceof Error ? err.message : "Unknown error";
131
- note(
132
- `Failed to install ${Array.isArray(pkgs) ? `dependencies '${pkgs.join(", ")}'` : `dependency '${pkgs}'`}: ${error}`,
133
- "warn"
134
- );
135
- }
136
- }
137
-
138
- // src/package-manager/is-package-installed.ts
139
- import pkgjs from "@npmcli/package-json";
140
- async function isPackageInstalled(name, path) {
141
- const pkgJson = await pkgjs.load(path ?? await projectRoot());
142
- const inDependencies = !!pkgJson.content.dependencies?.[name];
143
- const inDevDependencies = !!pkgJson.content.devDependencies?.[name];
144
- const inPeerDependencies = !!pkgJson.content.peerDependencies?.[name];
145
- return inDependencies || inDevDependencies || inPeerDependencies;
146
- }
147
-
148
- // src/package-manager/set-name.ts
149
- import pkgjs2 from "@npmcli/package-json";
150
- async function setName(name, path) {
151
- const pkgJson = await pkgjs2.load(path ?? await projectRoot());
152
- pkgJson.update({
153
- name
154
- });
155
- await pkgJson.save();
156
- }
157
- export {
158
- emptyDir,
159
- formatTargetDir,
160
- getPackageManager,
161
- getPackageManagerExecutable,
162
- installDependencies,
163
- isEmpty,
164
- isPackageInstalled,
165
- setName
166
- };
167
- //# sourceMappingURL=package-manager.mjs.map