guarden 1.0.0

package/dist/types/transform/coerce.d.ts

@@ -0,0 +1,73 @@
+import { type Result } from '../result/result.js';
+import { CoercionError } from '../utils/errors.js';
+/**
+ * Coerce a value to a number.
+ * Handles strings, booleans, and Date objects.
+ *
+ * @example
+ * ```ts
+ * toNumber("42")       // Ok(42)
+ * toNumber("abc")      // Err(CoercionError)
+ * toNumber(true)       // Ok(1)
+ * toNumber(null)       // Err(CoercionError)
+ * ```
+ */
+export declare function toNumber(value: unknown): Result<number, CoercionError>;
+/**
+ * Coerce a value to a string.
+ * Handles numbers, booleans, null, undefined, and objects.
+ *
+ * @example
+ * ```ts
+ * toString(42)        // "42"
+ * toString(null)      // ""
+ * toString(undefined) // ""
+ * toString(true)      // "true"
+ * ```
+ */
+export declare function toString(value: unknown): string;
+/**
+ * Coerce a value to a boolean.
+ * Handles common truthy/falsy string representations.
+ *
+ * @example
+ * ```ts
+ * toBoolean("true")   // true
+ * toBoolean("yes")    // true
+ * toBoolean("1")      // true
+ * toBoolean("false")  // false
+ * toBoolean("no")     // false
+ * toBoolean("0")      // false
+ * toBoolean(1)        // true
+ * toBoolean(0)        // false
+ * ```
+ */
+export declare function toBoolean(value: unknown): boolean;
+/**
+ * Coerce a value to a Date.
+ *
+ * @example
+ * ```ts
+ * toDate("2024-01-15")      // Ok(Date)
+ * toDate(1705276800000)     // Ok(Date)
+ * toDate("not-a-date")      // Err(CoercionError)
+ * ```
+ */
+export declare function toDate(value: unknown): Result<Date, CoercionError>;
+/**
+ * Wrap a non-array value in an array. Arrays are returned as-is.
+ *
+ * @example
+ * ```ts
+ * toArray(42)       // [42]
+ * toArray([1, 2])   // [1, 2]
+ * toArray(null)     // []
+ * toArray(undefined)// []
+ * ```
+ */
+export declare function toArray<T>(value: T | T[] | null | undefined): T[];
+/**
+ * Coerce a value to an integer.
+ */
+export declare function toInteger(value: unknown): Result<number, CoercionError>;
+//# sourceMappingURL=coerce.d.ts.map

package/dist/types/transform/coerce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce.d.ts","sourceRoot":"","sources":["../../../src/transform/coerce.ts"],"names":[],"mappings":"AAIA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAgBtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAW/C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQjD;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAalE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,EAAE,CAIjE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAKvE"}

package/dist/types/transform/index.d.ts

@@ -0,0 +1,4 @@
+export { pipe, flow } from './pipe.js';
+export { toNumber, toString, toBoolean, toDate, toArray, toInteger } from './coerce.js';
+export { trim, trimStart, trimEnd, lowercase, uppercase, capitalize, titleCase, camelCase, kebabCase, snakeCase, stripHtml, escapeHtml, unescapeHtml, truncate, slugify, removeWhitespace, collapseWhitespace, padStart, padEnd, reverse, countOccurrences, } from './sanitize.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/transform/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transform/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EACL,IAAI,EACJ,SAAS,EACT,OAAO,EACP,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,gBAAgB,EAChB,kBAAkB,EAClB,QAAQ,EACR,MAAM,EACN,OAAO,EACP,gBAAgB,GACjB,MAAM,eAAe,CAAC"}

package/dist/types/transform/pipe.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Compose functions left-to-right with full type inference.
+ * Each function receives the output of the previous one.
+ *
+ * @example
+ * ```ts
+ * const result = pipe(
+ *   "  Hello World  ",
+ *   (s) => s.trim(),
+ *   (s) => s.toLowerCase(),
+ *   (s) => s.replace(/\s+/g, '-'),
+ * );
+ * // result === "hello-world"
+ * ```
+ */
+export declare function pipe<A>(value: A): A;
+export declare function pipe<A, B>(value: A, fn1: (a: A) => B): B;
+export declare function pipe<A, B, C>(value: A, fn1: (a: A) => B, fn2: (b: B) => C): C;
+export declare function pipe<A, B, C, D>(value: A, fn1: (a: A) => B, fn2: (b: B) => C, fn3: (c: C) => D): D;
+export declare function pipe<A, B, C, D, E>(value: A, fn1: (a: A) => B, fn2: (b: B) => C, fn3: (c: C) => D, fn4: (d: D) => E): E;
+export declare function pipe<A, B, C, D, E, F>(value: A, fn1: (a: A) => B, fn2: (b: B) => C, fn3: (c: C) => D, fn4: (d: D) => E, fn5: (e: E) => F): F;
+export declare function pipe<A, B, C, D, E, F, G>(value: A, fn1: (a: A) => B, fn2: (b: B) => C, fn3: (c: C) => D, fn4: (d: D) => E, fn5: (e: E) => F, fn6: (f: F) => G): G;
+export declare function pipe<A, B, C, D, E, F, G, H>(value: A, fn1: (a: A) => B, fn2: (b: B) => C, fn3: (c: C) => D, fn4: (d: D) => E, fn5: (e: E) => F, fn6: (f: F) => G, fn7: (g: G) => H): H;
+export declare function pipe<A, B, C, D, E, F, G, H, I>(value: A, fn1: (a: A) => B, fn2: (b: B) => C, fn3: (c: C) => D, fn4: (d: D) => E, fn5: (e: E) => F, fn6: (f: F) => G, fn7: (g: G) => H, fn8: (h: H) => I): I;
+export declare function pipe<A, B, C, D, E, F, G, H, I, J>(value: A, fn1: (a: A) => B, fn2: (b: B) => C, fn3: (c: C) => D, fn4: (d: D) => E, fn5: (e: E) => F, fn6: (f: F) => G, fn7: (g: G) => H, fn8: (h: H) => I, fn9: (i: I) => J): J;
+/**
+ * Create a composed function from multiple functions (left-to-right).
+ *
+ * @example
+ * ```ts
+ * const processName = flow(
+ *   (s: string) => s.trim(),
+ *   (s) => s.toLowerCase(),
+ *   (s) => s.replace(/\s+/g, '-'),
+ * );
+ * processName("  Hello World  "); // "hello-world"
+ * ```
+ */
+export declare function flow<A, B>(fn1: (a: A) => B): (a: A) => B;
+export declare function flow<A, B, C>(fn1: (a: A) => B, fn2: (b: B) => C): (a: A) => C;
+export declare function flow<A, B, C, D>(fn1: (a: A) => B, fn2: (b: B) => C, fn3: (c: C) => D): (a: A) => D;
+export declare function flow<A, B, C, D, E>(fn1: (a: A) => B, fn2: (b: B) => C, fn3: (c: C) => D, fn4: (d: D) => E): (a: A) => E;
+export declare function flow<A, B, C, D, E, F>(fn1: (a: A) => B, fn2: (b: B) => C, fn3: (c: C) => D, fn4: (d: D) => E, fn5: (e: E) => F): (a: A) => F;
+//# sourceMappingURL=pipe.d.ts.map

package/dist/types/transform/pipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.d.ts","sourceRoot":"","sources":["../../../src/transform/pipe.ts"],"names":[],"mappings":"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"}

package/dist/types/transform/sanitize.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Trim whitespace from both ends.
+ */
+export declare function trim(value: string): string;
+/**
+ * Trim whitespace from the start.
+ */
+export declare function trimStart(value: string): string;
+/**
+ * Trim whitespace from the end.
+ */
+export declare function trimEnd(value: string): string;
+/**
+ * Convert to lowercase.
+ */
+export declare function lowercase(value: string): string;
+/**
+ * Convert to uppercase.
+ */
+export declare function uppercase(value: string): string;
+/**
+ * Capitalize the first letter.
+ */
+export declare function capitalize(value: string): string;
+/**
+ * Capitalize the first letter of each word.
+ */
+export declare function titleCase(value: string): string;
+/**
+ * Convert to camelCase.
+ */
+export declare function camelCase(value: string): string;
+/**
+ * Convert to kebab-case.
+ */
+export declare function kebabCase(value: string): string;
+/**
+ * Convert to snake_case.
+ */
+export declare function snakeCase(value: string): string;
+/**
+ * Strip HTML tags from a string.
+ *
+ * @example
+ * ```ts
+ * stripHtml("<p>Hello <b>world</b></p>") // "Hello world"
+ * ```
+ */
+export declare function stripHtml(value: string): string;
+/**
+ * Escape HTML special characters to prevent XSS.
+ *
+ * @example
+ * ```ts
+ * escapeHtml('<script>alert("xss")</script>')
+ * // '&lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;'
+ * ```
+ */
+export declare function escapeHtml(value: string): string;
+/**
+ * Unescape HTML entities.
+ */
+export declare function unescapeHtml(value: string): string;
+/**
+ * Truncate a string to a maximum length.
+ *
+ * @example
+ * ```ts
+ * truncate("Hello, World!", 8)        // "Hello..."
+ * truncate("Hello, World!", 8, "…")   // "Hello, …"
+ * ```
+ */
+export declare function truncate(value: string, maxLength: number, suffix?: string): string;
+/**
+ * Convert a string to a URL-friendly slug.
+ *
+ * @example
+ * ```ts
+ * slugify("Hello, World! 🌍")  // "hello-world"
+ * slugify("  Foo   BAR  baz ") // "foo-bar-baz"
+ * ```
+ */
+export declare function slugify(value: string): string;
+/**
+ * Remove all whitespace from a string.
+ */
+export declare function removeWhitespace(value: string): string;
+/**
+ * Collapse multiple spaces into a single space.
+ */
+export declare function collapseWhitespace(value: string): string;
+/**
+ * Pad a string to a minimum length (left-pads by default).
+ */
+export declare function padStart(value: string, length: number, fillChar?: string): string;
+/**
+ * Pad a string to a minimum length (right-pads).
+ */
+export declare function padEnd(value: string, length: number, fillChar?: string): string;
+/**
+ * Reverse a string (Unicode-aware).
+ */
+export declare function reverse(value: string): string;
+/**
+ * Count occurrences of a substring.
+ */
+export declare function countOccurrences(value: string, search: string): number;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/types/transform/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../../src/transform/sanitize.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUlD;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAQ,GAAG,MAAM,CAGjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ7C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,MAAM,CAE9E;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,MAAM,CAE5E;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAStE"}

package/dist/types/utils/errors.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Base error class for all Guarden errors.
+ * Provides clean stack traces and error identification.
+ */
+export declare class GuardenError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/**
+ * Thrown when a runtime assertion fails.
+ */
+export declare class AssertionError extends GuardenError {
+    constructor(message: string);
+}
+/**
+ * Thrown when an invariant is violated.
+ * Indicates a bug in the program logic.
+ */
+export declare class InvariantError extends GuardenError {
+    constructor(message: string);
+}
+/**
+ * Thrown when type coercion fails.
+ */
+export declare class CoercionError extends GuardenError {
+    readonly originalValue: unknown;
+    readonly targetType: string;
+    constructor(value: unknown, targetType: string);
+}
+/**
+ * Thrown when environment variable validation fails.
+ */
+export declare class EnvValidationError extends GuardenError {
+    readonly variableName: string;
+    readonly errors: string[];
+    constructor(variableName: string, errors: string[]);
+}
+/**
+ * Thrown when multiple environment variables fail validation.
+ */
+export declare class EnvConfigError extends GuardenError {
+    readonly validationErrors: EnvValidationError[];
+    constructor(errors: EnvValidationError[]);
+}
+/**
+ * Thrown when code reaches a state that should be unreachable.
+ */
+export declare class UnreachableError extends GuardenError {
+    constructor(value: never);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAO1C;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,YAAY;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,YAAY;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,SAAgB,aAAa,EAAE,OAAO,CAAC;IACvC,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM;CAS/C;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,MAAM,EAAE,MAAM,EAAE,CAAC;gBAErB,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;CASnD;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,SAAgB,gBAAgB,EAAE,kBAAkB,EAAE,CAAC;gBAE3C,MAAM,EAAE,kBAAkB,EAAE;CAMzC;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;gBACpC,KAAK,EAAE,KAAK;CAOzB"}

package/dist/types/utils/types.d.ts

@@ -0,0 +1,29 @@
+/** A type guard function that narrows `unknown` to `T` */
+export type Guard<T> = (value: unknown) => value is T;
+/** Extract the guarded type from a Guard */
+export type GuardType<G> = G extends Guard<infer T> ? T : never;
+/** Make all properties required and non-nullable */
+export type RequiredDeep<T> = {
+    [K in keyof T]-?: NonNullable<T[K]>;
+};
+/** A value that could be null or undefined */
+export type Nullish = null | undefined;
+/** A value that is neither null nor undefined */
+export type NonNullish<T> = Exclude<T, Nullish>;
+/** Primitive JavaScript types */
+export type Primitive = string | number | boolean | bigint | symbol | null | undefined;
+/** A plain object with string keys */
+export type PlainObject = Record<string, unknown>;
+/** Function type shorthand */
+export type AnyFunction = (...args: unknown[]) => unknown;
+/** A readonly tuple type */
+export type ReadonlyTuple<T extends readonly unknown[]> = readonly [...T];
+/** Branded type for nominal typing */
+export type Brand<T, B extends string> = T & {
+    readonly __brand: B;
+};
+/** Infer the shape from a guard record */
+export type ShapeGuardType<T extends Record<string, Guard<unknown>>> = {
+    [K in keyof T]: GuardType<T[K]>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types/utils/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/types.ts"],"names":[],"mappings":"AAIA,0DAA0D;AAC1D,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC;AAEtD,4CAA4C;AAC5C,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEhE,oDAAoD;AACpD,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;KAC3B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACpC,CAAC;AAEF,8CAA8C;AAC9C,MAAM,MAAM,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAEvC,iDAAiD;AACjD,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAEhD,iCAAiC;AACjC,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEvF,sCAAsC;AACtC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAElD,8BAA8B;AAC9B,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAE1D,4BAA4B;AAC5B,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1E,sCAAsC;AACtC,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;CAAE,CAAC;AAErE,0CAA0C;AAC1C,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI;KACpE,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAChC,CAAC"}

package/package.json

@@ -0,0 +1,144 @@
+{
+  "name": "guarden",
+  "version": "1.0.0",
+  "description": "Blazing-fast, tree-shakeable TypeScript-first runtime safety toolkit. Type guards, assertions, Result/Option monads, data pipelines, and env validation — zero dependencies.",
+  "author": "Avinashvelu03",
+  "sideEffects": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Avinashvelu03/guarden.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Avinashvelu03/guarden/issues"
+  },
+  "homepage": "https://github.com/Avinashvelu03/guarden#readme",
+  "keywords": [
+    "typescript",
+    "type-guard",
+    "runtime-validation",
+    "type-safety",
+    "assertions",
+    "invariant",
+    "result-type",
+    "option-type",
+    "monad",
+    "functional-programming",
+    "error-handling",
+    "data-pipeline",
+    "pipe",
+    "coerce",
+    "sanitize",
+    "env-validation",
+    "environment-variables",
+    "type-narrowing",
+    "runtime-checks",
+    "zero-dependencies",
+    "tree-shakeable",
+    "guards",
+    "validation",
+    "typescript-utility",
+    "developer-tools"
+  ],
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./guards": {
+      "import": {
+        "types": "./dist/types/guards/index.d.ts",
+        "default": "./dist/esm/guards/index.js"
+      },
+      "require": {
+        "types": "./dist/types/guards/index.d.ts",
+        "default": "./dist/cjs/guards/index.js"
+      }
+    },
+    "./assert": {
+      "import": {
+        "types": "./dist/types/assert/index.d.ts",
+        "default": "./dist/esm/assert/index.js"
+      },
+      "require": {
+        "types": "./dist/types/assert/index.d.ts",
+        "default": "./dist/cjs/assert/index.js"
+      }
+    },
+    "./result": {
+      "import": {
+        "types": "./dist/types/result/index.d.ts",
+        "default": "./dist/esm/result/index.js"
+      },
+      "require": {
+        "types": "./dist/types/result/index.d.ts",
+        "default": "./dist/cjs/result/index.js"
+      }
+    },
+    "./transform": {
+      "import": {
+        "types": "./dist/types/transform/index.d.ts",
+        "default": "./dist/esm/transform/index.js"
+      },
+      "require": {
+        "types": "./dist/types/transform/index.d.ts",
+        "default": "./dist/cjs/transform/index.js"
+      }
+    },
+    "./env": {
+      "import": {
+        "types": "./dist/types/env/index.d.ts",
+        "default": "./dist/esm/env/index.js"
+      },
+      "require": {
+        "types": "./dist/types/env/index.d.ts",
+        "default": "./dist/cjs/env/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs && npm run build:types",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/ tests/ --ext .ts",
+    "lint:fix": "eslint src/ tests/ --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist coverage",
+    "prepublishOnly": "npm run clean && npm run build && npm run test"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.37",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "@vitest/coverage-v8": "^1.6.1",
+    "eslint": "^8.57.1",
+    "prettier": "^3.8.1",
+    "rimraf": "^5.0.10",
+    "typescript": "^5.9.3",
+    "vitest": "^1.6.1"
+  }
+}