dotdo 0.0.1 → 0.0.2

package/dist/lib/safe-stringify.js

@@ -0,0 +1,223 @@
+/**
+ * Safe JSON stringify utility that handles circular references,
+ * large objects, and non-serializable values.
+ */
+const DEFAULT_OPTIONS = {
+    maxDepth: 10,
+    maxLength: 10000,
+    circularReplacement: '[Circular]',
+    functionReplacement: '[Function]',
+    includeStacks: true,
+};
+/**
+ * Safely stringify a value to JSON, handling:
+ * - Circular references
+ * - Functions
+ * - BigInt
+ * - Symbols
+ * - Very long strings
+ * - Deep nesting
+ * - Error objects with stack traces
+ *
+ * @param value - The value to stringify
+ * @param options - Stringification options
+ * @returns JSON string representation
+ */
+export function safeStringify(value, options) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const seen = new WeakSet();
+    function serialize(obj, depth) {
+        // Handle primitives
+        if (obj === null || obj === undefined)
+            return obj;
+        if (typeof obj === 'boolean' || typeof obj === 'number')
+            return obj;
+        if (typeof obj === 'string') {
+            return obj.length > opts.maxLength
+                ? obj.slice(0, opts.maxLength) + `... [truncated ${obj.length - opts.maxLength} chars]`
+                : obj;
+        }
+        if (typeof obj === 'bigint')
+            return obj.toString() + 'n';
+        if (typeof obj === 'symbol')
+            return obj.toString();
+        if (typeof obj === 'function')
+            return opts.functionReplacement;
+        // Check depth
+        if (depth > opts.maxDepth)
+            return '[Max depth exceeded]';
+        // Handle objects
+        if (typeof obj === 'object') {
+            // Check for circular reference
+            if (seen.has(obj))
+                return opts.circularReplacement;
+            seen.add(obj);
+            // Handle Error objects specially
+            if (obj instanceof Error) {
+                const errorObj = {
+                    name: obj.name,
+                    message: obj.message,
+                };
+                if (opts.includeStacks && obj.stack) {
+                    errorObj.stack = obj.stack;
+                }
+                // Copy custom properties
+                for (const key of Object.keys(obj)) {
+                    if (key !== 'name' && key !== 'message' && key !== 'stack') {
+                        errorObj[key] = serialize(obj[key], depth + 1);
+                    }
+                }
+                return errorObj;
+            }
+            // Handle Date
+            if (obj instanceof Date)
+                return obj.toISOString();
+            // Handle RegExp
+            if (obj instanceof RegExp)
+                return obj.toString();
+            // Handle Map
+            if (obj instanceof Map) {
+                const mapObj = {};
+                for (const [key, val] of obj) {
+                    const keyStr = typeof key === 'string' ? key : String(key);
+                    mapObj[keyStr] = serialize(val, depth + 1);
+                }
+                return { __type: 'Map', entries: mapObj };
+            }
+            // Handle Set
+            if (obj instanceof Set) {
+                return { __type: 'Set', values: Array.from(obj).map(v => serialize(v, depth + 1)) };
+            }
+            // Handle Arrays
+            if (Array.isArray(obj)) {
+                return obj.map(item => serialize(item, depth + 1));
+            }
+            // Handle plain objects
+            const result = {};
+            for (const key of Object.keys(obj)) {
+                result[key] = serialize(obj[key], depth + 1);
+            }
+            return result;
+        }
+        return String(obj);
+    }
+    const serialized = serialize(value, 0);
+    const jsonString = JSON.stringify(serialized, null, 2);
+    // Final length check
+    if (jsonString.length > opts.maxLength) {
+        return jsonString.slice(0, opts.maxLength) + `\n... [truncated ${jsonString.length - opts.maxLength} chars]`;
+    }
+    return jsonString;
+}
+/**
+ * Parse JSON safely, returning null on error instead of throwing
+ */
+export function safeParse(json) {
+    try {
+        return JSON.parse(json);
+    }
+    catch {
+        return null;
+    }
+}
+export function safeJsonParse(input, fallback, options) {
+    try {
+        return JSON.parse(input);
+    }
+    catch (error) {
+        // Log parse failures for debugging (unless explicitly disabled)
+        const shouldLog = options?.log !== false && typeof process !== 'undefined' && process.env?.NODE_ENV !== 'test';
+        if (shouldLog && error instanceof SyntaxError) {
+            const context = options?.context ? `[${options.context}] ` : '';
+            const preview = input.length > 50 ? input.slice(0, 50) + '...' : input;
+            console.warn(`${context}JSON parse failed: ${error.message}. Input preview: "${preview}"`);
+        }
+        return fallback;
+    }
+}
+/**
+ * Parse JSON safely and return a Result type for explicit error handling.
+ *
+ * Use this when you need to distinguish between:
+ * - Successfully parsed null/undefined values
+ * - Parse failures
+ *
+ * @param input - The JSON string to parse
+ * @returns Result object with either the parsed value or the error
+ *
+ * @example
+ * const result = safeJsonParseResult(userInput)
+ * if (!result.ok) {
+ *   console.error('Parse failed:', result.error.message)
+ *   return
+ * }
+ * // result.value is safely typed
+ */
+export function safeJsonParseResult(input) {
+    try {
+        return { ok: true, value: JSON.parse(input) };
+    }
+    catch (error) {
+        return { ok: false, error: error };
+    }
+}
+/**
+ * Safely deep-clone an object using JSON serialization.
+ *
+ * Handles non-serializable values gracefully:
+ * - Circular references: Returns fallback
+ * - BigInt: Returns fallback
+ * - Functions: Silently dropped (standard JSON.stringify behavior)
+ * - undefined: Silently dropped (standard JSON.stringify behavior)
+ *
+ * @param obj - The object to clone
+ * @param fallback - Value to return if cloning fails (default: empty object)
+ * @param options - Optional configuration for logging
+ * @returns A deep clone of the object or fallback on error
+ */
+export function safeJsonClone(obj, fallback = {}, options) {
+    try {
+        return JSON.parse(JSON.stringify(obj));
+    }
+    catch (error) {
+        // Log clone failures for debugging
+        const shouldLog = options?.log !== false && typeof process !== 'undefined' && process.env?.NODE_ENV !== 'test';
+        if (shouldLog) {
+            const context = options?.context ? `[${options.context}] ` : '';
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            console.warn(`${context}JSON clone failed: ${errorMsg}`);
+        }
+        return fallback;
+    }
+}
+/**
+ * Serialize an error object for logging/transmission
+ */
+export function serializeError(error) {
+    if (error instanceof Error) {
+        const serialized = {
+            name: error.name,
+            message: error.message,
+        };
+        if (error.stack) {
+            serialized.stack = error.stack;
+        }
+        // Include cause if present
+        if ('cause' in error && error.cause) {
+            serialized.cause = serializeError(error.cause);
+        }
+        // Copy custom properties
+        for (const key of Object.keys(error)) {
+            if (!['name', 'message', 'stack', 'cause'].includes(key)) {
+                serialized[key] = error[key];
+            }
+        }
+        return serialized;
+    }
+    if (typeof error === 'object' && error !== null) {
+        return error;
+    }
+    return { message: String(error) };
+}
+export default safeStringify;
+//# sourceMappingURL=safe-stringify.js.map

package/dist/lib/safe-stringify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-stringify.js","sourceRoot":"","sources":["../../lib/safe-stringify.ts"],"names":[],"mappings":"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"}