guarden 1.0.0

package/dist/cjs/index.js

@@ -0,0 +1,135 @@
+"use strict";
+// ============================================================================
+// Guarden — Main Entry Point
+// TypeScript-First Runtime Safety Toolkit
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tuple = exports.shape = exports.not = exports.or = exports.and = exports.isInstanceOf = exports.isMaxLength = exports.isMinLength = exports.isMatch = exports.isOneOf = exports.isInRange = exports.isNonEmptyArray = exports.isSafeInteger = exports.isInteger = exports.isNegativeNumber = exports.isPositiveNumber = exports.isHexColor = exports.isJSONString = exports.isISO8601 = exports.isUUID = exports.isURL = exports.isEmail = exports.isNonEmptyString = exports.isTypedArray = exports.isArrayBuffer = exports.isPromise = exports.isError = exports.isRegExp = exports.isValidDate = exports.isDate = exports.isWeakSet = exports.isWeakMap = exports.isSet = exports.isMap = exports.isPlainObject = exports.isObject = exports.isArray = exports.isPrimitive = exports.isFunction = exports.isNonNullish = exports.isNullish = exports.isUndefined = exports.isNull = exports.isSymbol = exports.isBigInt = exports.isBoolean = exports.isFiniteNumber = exports.isNumberIncludingNaN = exports.isNumber = exports.isString = void 0;
+exports.countOccurrences = exports.reverse = exports.padEnd = exports.padStart = exports.collapseWhitespace = exports.removeWhitespace = exports.slugify = exports.truncate = exports.unescapeHtml = exports.escapeHtml = exports.stripHtml = exports.snakeCase = exports.kebabCase = exports.camelCase = exports.titleCase = exports.capitalize = exports.uppercase = exports.lowercase = exports.trimEnd = exports.trimStart = exports.trim = exports.toInteger = exports.toArray = exports.toDate = exports.toBoolean = exports.toString = exports.toNumber = exports.flow = exports.pipe = exports.OptionAsync = exports.ResultAsync = exports.OptionUtils = exports.None = exports.Some = exports.ResultUtils = exports.Err = exports.Ok = exports.unreachable = exports.invariant = exports.assertTruthy = exports.assertType = exports.assertNonNull = exports.assertDefined = exports.assert = exports.nullable = exports.optional = exports.refine = exports.recordOf = exports.mapOf = exports.arrayOf = void 0;
+exports.UnreachableError = exports.EnvConfigError = exports.EnvValidationError = exports.CoercionError = exports.InvariantError = exports.AssertionError = exports.GuardenError = exports.EnvField = exports.envEnum = exports.envBoolean = exports.envNumber = exports.envString = exports.createEnv = void 0;
+// Guards
+var index_js_1 = require("./guards/index.js");
+Object.defineProperty(exports, "isString", { enumerable: true, get: function () { return index_js_1.isString; } });
+Object.defineProperty(exports, "isNumber", { enumerable: true, get: function () { return index_js_1.isNumber; } });
+Object.defineProperty(exports, "isNumberIncludingNaN", { enumerable: true, get: function () { return index_js_1.isNumberIncludingNaN; } });
+Object.defineProperty(exports, "isFiniteNumber", { enumerable: true, get: function () { return index_js_1.isFiniteNumber; } });
+Object.defineProperty(exports, "isBoolean", { enumerable: true, get: function () { return index_js_1.isBoolean; } });
+Object.defineProperty(exports, "isBigInt", { enumerable: true, get: function () { return index_js_1.isBigInt; } });
+Object.defineProperty(exports, "isSymbol", { enumerable: true, get: function () { return index_js_1.isSymbol; } });
+Object.defineProperty(exports, "isNull", { enumerable: true, get: function () { return index_js_1.isNull; } });
+Object.defineProperty(exports, "isUndefined", { enumerable: true, get: function () { return index_js_1.isUndefined; } });
+Object.defineProperty(exports, "isNullish", { enumerable: true, get: function () { return index_js_1.isNullish; } });
+Object.defineProperty(exports, "isNonNullish", { enumerable: true, get: function () { return index_js_1.isNonNullish; } });
+Object.defineProperty(exports, "isFunction", { enumerable: true, get: function () { return index_js_1.isFunction; } });
+Object.defineProperty(exports, "isPrimitive", { enumerable: true, get: function () { return index_js_1.isPrimitive; } });
+Object.defineProperty(exports, "isArray", { enumerable: true, get: function () { return index_js_1.isArray; } });
+Object.defineProperty(exports, "isObject", { enumerable: true, get: function () { return index_js_1.isObject; } });
+Object.defineProperty(exports, "isPlainObject", { enumerable: true, get: function () { return index_js_1.isPlainObject; } });
+Object.defineProperty(exports, "isMap", { enumerable: true, get: function () { return index_js_1.isMap; } });
+Object.defineProperty(exports, "isSet", { enumerable: true, get: function () { return index_js_1.isSet; } });
+Object.defineProperty(exports, "isWeakMap", { enumerable: true, get: function () { return index_js_1.isWeakMap; } });
+Object.defineProperty(exports, "isWeakSet", { enumerable: true, get: function () { return index_js_1.isWeakSet; } });
+Object.defineProperty(exports, "isDate", { enumerable: true, get: function () { return index_js_1.isDate; } });
+Object.defineProperty(exports, "isValidDate", { enumerable: true, get: function () { return index_js_1.isValidDate; } });
+Object.defineProperty(exports, "isRegExp", { enumerable: true, get: function () { return index_js_1.isRegExp; } });
+Object.defineProperty(exports, "isError", { enumerable: true, get: function () { return index_js_1.isError; } });
+Object.defineProperty(exports, "isPromise", { enumerable: true, get: function () { return index_js_1.isPromise; } });
+Object.defineProperty(exports, "isArrayBuffer", { enumerable: true, get: function () { return index_js_1.isArrayBuffer; } });
+Object.defineProperty(exports, "isTypedArray", { enumerable: true, get: function () { return index_js_1.isTypedArray; } });
+Object.defineProperty(exports, "isNonEmptyString", { enumerable: true, get: function () { return index_js_1.isNonEmptyString; } });
+Object.defineProperty(exports, "isEmail", { enumerable: true, get: function () { return index_js_1.isEmail; } });
+Object.defineProperty(exports, "isURL", { enumerable: true, get: function () { return index_js_1.isURL; } });
+Object.defineProperty(exports, "isUUID", { enumerable: true, get: function () { return index_js_1.isUUID; } });
+Object.defineProperty(exports, "isISO8601", { enumerable: true, get: function () { return index_js_1.isISO8601; } });
+Object.defineProperty(exports, "isJSONString", { enumerable: true, get: function () { return index_js_1.isJSONString; } });
+Object.defineProperty(exports, "isHexColor", { enumerable: true, get: function () { return index_js_1.isHexColor; } });
+Object.defineProperty(exports, "isPositiveNumber", { enumerable: true, get: function () { return index_js_1.isPositiveNumber; } });
+Object.defineProperty(exports, "isNegativeNumber", { enumerable: true, get: function () { return index_js_1.isNegativeNumber; } });
+Object.defineProperty(exports, "isInteger", { enumerable: true, get: function () { return index_js_1.isInteger; } });
+Object.defineProperty(exports, "isSafeInteger", { enumerable: true, get: function () { return index_js_1.isSafeInteger; } });
+Object.defineProperty(exports, "isNonEmptyArray", { enumerable: true, get: function () { return index_js_1.isNonEmptyArray; } });
+Object.defineProperty(exports, "isInRange", { enumerable: true, get: function () { return index_js_1.isInRange; } });
+Object.defineProperty(exports, "isOneOf", { enumerable: true, get: function () { return index_js_1.isOneOf; } });
+Object.defineProperty(exports, "isMatch", { enumerable: true, get: function () { return index_js_1.isMatch; } });
+Object.defineProperty(exports, "isMinLength", { enumerable: true, get: function () { return index_js_1.isMinLength; } });
+Object.defineProperty(exports, "isMaxLength", { enumerable: true, get: function () { return index_js_1.isMaxLength; } });
+Object.defineProperty(exports, "isInstanceOf", { enumerable: true, get: function () { return index_js_1.isInstanceOf; } });
+Object.defineProperty(exports, "and", { enumerable: true, get: function () { return index_js_1.and; } });
+Object.defineProperty(exports, "or", { enumerable: true, get: function () { return index_js_1.or; } });
+Object.defineProperty(exports, "not", { enumerable: true, get: function () { return index_js_1.not; } });
+Object.defineProperty(exports, "shape", { enumerable: true, get: function () { return index_js_1.shape; } });
+Object.defineProperty(exports, "tuple", { enumerable: true, get: function () { return index_js_1.tuple; } });
+Object.defineProperty(exports, "arrayOf", { enumerable: true, get: function () { return index_js_1.arrayOf; } });
+Object.defineProperty(exports, "mapOf", { enumerable: true, get: function () { return index_js_1.mapOf; } });
+Object.defineProperty(exports, "recordOf", { enumerable: true, get: function () { return index_js_1.recordOf; } });
+Object.defineProperty(exports, "refine", { enumerable: true, get: function () { return index_js_1.refine; } });
+Object.defineProperty(exports, "optional", { enumerable: true, get: function () { return index_js_1.optional; } });
+Object.defineProperty(exports, "nullable", { enumerable: true, get: function () { return index_js_1.nullable; } });
+// Assert
+var index_js_2 = require("./assert/index.js");
+Object.defineProperty(exports, "assert", { enumerable: true, get: function () { return index_js_2.assert; } });
+Object.defineProperty(exports, "assertDefined", { enumerable: true, get: function () { return index_js_2.assertDefined; } });
+Object.defineProperty(exports, "assertNonNull", { enumerable: true, get: function () { return index_js_2.assertNonNull; } });
+Object.defineProperty(exports, "assertType", { enumerable: true, get: function () { return index_js_2.assertType; } });
+Object.defineProperty(exports, "assertTruthy", { enumerable: true, get: function () { return index_js_2.assertTruthy; } });
+Object.defineProperty(exports, "invariant", { enumerable: true, get: function () { return index_js_2.invariant; } });
+Object.defineProperty(exports, "unreachable", { enumerable: true, get: function () { return index_js_2.unreachable; } });
+// Result & Option
+var index_js_3 = require("./result/index.js");
+Object.defineProperty(exports, "Ok", { enumerable: true, get: function () { return index_js_3.Ok; } });
+Object.defineProperty(exports, "Err", { enumerable: true, get: function () { return index_js_3.Err; } });
+Object.defineProperty(exports, "ResultUtils", { enumerable: true, get: function () { return index_js_3.ResultUtils; } });
+Object.defineProperty(exports, "Some", { enumerable: true, get: function () { return index_js_3.Some; } });
+Object.defineProperty(exports, "None", { enumerable: true, get: function () { return index_js_3.None; } });
+Object.defineProperty(exports, "OptionUtils", { enumerable: true, get: function () { return index_js_3.OptionUtils; } });
+Object.defineProperty(exports, "ResultAsync", { enumerable: true, get: function () { return index_js_3.ResultAsync; } });
+Object.defineProperty(exports, "OptionAsync", { enumerable: true, get: function () { return index_js_3.OptionAsync; } });
+// Transform
+var index_js_4 = require("./transform/index.js");
+Object.defineProperty(exports, "pipe", { enumerable: true, get: function () { return index_js_4.pipe; } });
+Object.defineProperty(exports, "flow", { enumerable: true, get: function () { return index_js_4.flow; } });
+Object.defineProperty(exports, "toNumber", { enumerable: true, get: function () { return index_js_4.toNumber; } });
+Object.defineProperty(exports, "toString", { enumerable: true, get: function () { return index_js_4.toString; } });
+Object.defineProperty(exports, "toBoolean", { enumerable: true, get: function () { return index_js_4.toBoolean; } });
+Object.defineProperty(exports, "toDate", { enumerable: true, get: function () { return index_js_4.toDate; } });
+Object.defineProperty(exports, "toArray", { enumerable: true, get: function () { return index_js_4.toArray; } });
+Object.defineProperty(exports, "toInteger", { enumerable: true, get: function () { return index_js_4.toInteger; } });
+Object.defineProperty(exports, "trim", { enumerable: true, get: function () { return index_js_4.trim; } });
+Object.defineProperty(exports, "trimStart", { enumerable: true, get: function () { return index_js_4.trimStart; } });
+Object.defineProperty(exports, "trimEnd", { enumerable: true, get: function () { return index_js_4.trimEnd; } });
+Object.defineProperty(exports, "lowercase", { enumerable: true, get: function () { return index_js_4.lowercase; } });
+Object.defineProperty(exports, "uppercase", { enumerable: true, get: function () { return index_js_4.uppercase; } });
+Object.defineProperty(exports, "capitalize", { enumerable: true, get: function () { return index_js_4.capitalize; } });
+Object.defineProperty(exports, "titleCase", { enumerable: true, get: function () { return index_js_4.titleCase; } });
+Object.defineProperty(exports, "camelCase", { enumerable: true, get: function () { return index_js_4.camelCase; } });
+Object.defineProperty(exports, "kebabCase", { enumerable: true, get: function () { return index_js_4.kebabCase; } });
+Object.defineProperty(exports, "snakeCase", { enumerable: true, get: function () { return index_js_4.snakeCase; } });
+Object.defineProperty(exports, "stripHtml", { enumerable: true, get: function () { return index_js_4.stripHtml; } });
+Object.defineProperty(exports, "escapeHtml", { enumerable: true, get: function () { return index_js_4.escapeHtml; } });
+Object.defineProperty(exports, "unescapeHtml", { enumerable: true, get: function () { return index_js_4.unescapeHtml; } });
+Object.defineProperty(exports, "truncate", { enumerable: true, get: function () { return index_js_4.truncate; } });
+Object.defineProperty(exports, "slugify", { enumerable: true, get: function () { return index_js_4.slugify; } });
+Object.defineProperty(exports, "removeWhitespace", { enumerable: true, get: function () { return index_js_4.removeWhitespace; } });
+Object.defineProperty(exports, "collapseWhitespace", { enumerable: true, get: function () { return index_js_4.collapseWhitespace; } });
+Object.defineProperty(exports, "padStart", { enumerable: true, get: function () { return index_js_4.padStart; } });
+Object.defineProperty(exports, "padEnd", { enumerable: true, get: function () { return index_js_4.padEnd; } });
+Object.defineProperty(exports, "reverse", { enumerable: true, get: function () { return index_js_4.reverse; } });
+Object.defineProperty(exports, "countOccurrences", { enumerable: true, get: function () { return index_js_4.countOccurrences; } });
+// Env
+var index_js_5 = require("./env/index.js");
+Object.defineProperty(exports, "createEnv", { enumerable: true, get: function () { return index_js_5.createEnv; } });
+Object.defineProperty(exports, "envString", { enumerable: true, get: function () { return index_js_5.envString; } });
+Object.defineProperty(exports, "envNumber", { enumerable: true, get: function () { return index_js_5.envNumber; } });
+Object.defineProperty(exports, "envBoolean", { enumerable: true, get: function () { return index_js_5.envBoolean; } });
+Object.defineProperty(exports, "envEnum", { enumerable: true, get: function () { return index_js_5.envEnum; } });
+Object.defineProperty(exports, "EnvField", { enumerable: true, get: function () { return index_js_5.EnvField; } });
+// Errors
+var errors_js_1 = require("./utils/errors.js");
+Object.defineProperty(exports, "GuardenError", { enumerable: true, get: function () { return errors_js_1.GuardenError; } });
+Object.defineProperty(exports, "AssertionError", { enumerable: true, get: function () { return errors_js_1.AssertionError; } });
+Object.defineProperty(exports, "InvariantError", { enumerable: true, get: function () { return errors_js_1.InvariantError; } });
+Object.defineProperty(exports, "CoercionError", { enumerable: true, get: function () { return errors_js_1.CoercionError; } });
+Object.defineProperty(exports, "EnvValidationError", { enumerable: true, get: function () { return errors_js_1.EnvValidationError; } });
+Object.defineProperty(exports, "EnvConfigError", { enumerable: true, get: function () { return errors_js_1.EnvConfigError; } });
+Object.defineProperty(exports, "UnreachableError", { enumerable: true, get: function () { return errors_js_1.UnreachableError; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

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

package/dist/cjs/result/async.js

@@ -0,0 +1,132 @@
+"use strict";
+// ============================================================================
+// Guarden — Async Result & Option
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OptionAsync = exports.ResultAsync = void 0;
+const result_js_1 = require("./result.js");
+const option_js_1 = require("./option.js");
+/**
+ * A Result wrapped in a Promise, with chainable async operations.
+ *
+ * @example
+ * ```ts
+ * const result = ResultAsync.from(fetch('/api/user'))
+ *   .map(res => res.json())
+ *   .mapErr(err => new ApiError(err.message));
+ * ```
+ */
+class ResultAsync {
+    promise;
+    constructor(promise) {
+        this.promise = promise;
+    }
+    /**
+     * Create from a Promise that may reject.
+     */
+    static from(promise) {
+        return new ResultAsync(result_js_1.ResultUtils.fromPromise(promise));
+    }
+    /**
+     * Create from a Result.
+     */
+    static fromResult(result) {
+        return new ResultAsync(Promise.resolve(result));
+    }
+    /**
+     * Create an Ok ResultAsync.
+     */
+    static ok(value) {
+        return new ResultAsync(Promise.resolve((0, result_js_1.Ok)(value)));
+    }
+    /**
+     * Create an Err ResultAsync.
+     */
+    static err(error) {
+        return new ResultAsync(Promise.resolve((0, result_js_1.Err)(error)));
+    }
+    /** Transform the success value. */
+    map(fn) {
+        return new ResultAsync(this.promise.then((r) => r.map(fn)));
+    }
+    /** Transform the error value. */
+    mapErr(fn) {
+        return new ResultAsync(this.promise.then((r) => r.mapErr(fn)));
+    }
+    /** Chain async operations. */
+    andThen(fn) {
+        return new ResultAsync(this.promise.then((r) => {
+            if (r.isErr())
+                return (0, result_js_1.Err)(r.unwrapErr());
+            return fn(r.unwrap()).toPromise();
+        }));
+    }
+    /** Extract the underlying Promise<Result>. */
+    toPromise() {
+        return this.promise;
+    }
+    /** Unwrap or throw. */
+    async unwrap() {
+        const result = await this.promise;
+        return result.unwrap();
+    }
+    /** Unwrap or return default. */
+    async unwrapOr(defaultValue) {
+        const result = await this.promise;
+        return result.unwrapOr(defaultValue);
+    }
+    /** Pattern match on the resolved Result. */
+    async match(handlers) {
+        const result = await this.promise;
+        return result.match(handlers);
+    }
+}
+exports.ResultAsync = ResultAsync;
+/**
+ * An Option wrapped in a Promise.
+ */
+class OptionAsync {
+    promise;
+    constructor(promise) {
+        this.promise = promise;
+    }
+    /**
+     * Create from a Promise that resolves to a nullable value.
+     */
+    static from(promise) {
+        return new OptionAsync(promise.then((v) => v === null || v === undefined ? (0, option_js_1.None)() : (0, option_js_1.Some)(v)));
+    }
+    static some(value) {
+        return new OptionAsync(Promise.resolve((0, option_js_1.Some)(value)));
+    }
+    static none() {
+        return new OptionAsync(Promise.resolve((0, option_js_1.None)()));
+    }
+    map(fn) {
+        return new OptionAsync(this.promise.then((o) => o.map(fn)));
+    }
+    andThen(fn) {
+        return new OptionAsync(this.promise.then((o) => {
+            if (o.isNone())
+                return (0, option_js_1.None)();
+            return fn(o.unwrap()).toPromise();
+        }));
+    }
+    toPromise() {
+        return this.promise;
+    }
+    async unwrap() {
+        const option = await this.promise;
+        return option.unwrap();
+    }
+    async unwrapOr(defaultValue) {
+        const option = await this.promise;
+        return option.unwrapOr(defaultValue);
+    }
+    async match(handlers) {
+        const option = await this.promise;
+        return option.match(handlers);
+    }
+}
+exports.OptionAsync = OptionAsync;
+//# sourceMappingURL=async.js.map

package/dist/cjs/result/async.js.map

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

package/dist/cjs/result/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OptionAsync = exports.ResultAsync = exports.OptionUtils = exports.None = exports.Some = exports.ResultUtils = exports.Err = exports.Ok = void 0;
+var result_js_1 = require("./result.js");
+Object.defineProperty(exports, "Ok", { enumerable: true, get: function () { return result_js_1.Ok; } });
+Object.defineProperty(exports, "Err", { enumerable: true, get: function () { return result_js_1.Err; } });
+Object.defineProperty(exports, "ResultUtils", { enumerable: true, get: function () { return result_js_1.ResultUtils; } });
+var option_js_1 = require("./option.js");
+Object.defineProperty(exports, "Some", { enumerable: true, get: function () { return option_js_1.Some; } });
+Object.defineProperty(exports, "None", { enumerable: true, get: function () { return option_js_1.None; } });
+Object.defineProperty(exports, "OptionUtils", { enumerable: true, get: function () { return option_js_1.OptionUtils; } });
+var async_js_1 = require("./async.js");
+Object.defineProperty(exports, "ResultAsync", { enumerable: true, get: function () { return async_js_1.ResultAsync; } });
+Object.defineProperty(exports, "OptionAsync", { enumerable: true, get: function () { return async_js_1.OptionAsync; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/result/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/result/index.ts"],"names":[],"mappings":";;;AAAA,yCAAgE;AAAvD,+FAAA,EAAE,OAAA;AAAE,gGAAA,GAAG,OAAA;AAAE,wGAAA,WAAW,OAAA;AAC7B,yCAAmE;AAA1D,iGAAA,IAAI,OAAA;AAAE,iGAAA,IAAI,OAAA;AAAE,wGAAA,WAAW,OAAA;AAChC,uCAAsD;AAA7C,uGAAA,WAAW,OAAA;AAAE,uGAAA,WAAW,OAAA"}

package/dist/cjs/result/option.js

@@ -0,0 +1,175 @@
+"use strict";
+// ============================================================================
+// Guarden — Option<T> Monadic Null Handling
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OptionUtils = void 0;
+exports.Some = Some;
+exports.None = None;
+class SomeOption {
+    value;
+    _tag = 'Some';
+    constructor(value) {
+        this.value = value;
+    }
+    isSome() {
+        return true;
+    }
+    isNone() {
+        return false;
+    }
+    /** Transform the contained value. */
+    map(fn) {
+        return new SomeOption(fn(this.value));
+    }
+    /** Chain operations that return an Option (flatMap). */
+    andThen(fn) {
+        return fn(this.value);
+    }
+    /** Return this Option if Some, otherwise return the other. */
+    orElse(_fn) {
+        return this;
+    }
+    /** Get the value, or throw if None. */
+    unwrap() {
+        return this.value;
+    }
+    /** Get the value, or return a default. */
+    unwrapOr(_defaultValue) {
+        return this.value;
+    }
+    /** Get the value, or compute a default. */
+    unwrapOrElse(_fn) {
+        return this.value;
+    }
+    /** Pattern match on the Option. */
+    match(handlers) {
+        return handlers.some(this.value);
+    }
+    /** Filter: return None if the predicate fails. */
+    filter(predicate) {
+        return predicate(this.value) ? this : new NoneOption();
+    }
+    /** Apply a side-effect function if Some. */
+    tap(fn) {
+        fn(this.value);
+        return this;
+    }
+    /** Zip with another Option. */
+    zip(other) {
+        if (other.isSome()) {
+            return new SomeOption([this.value, other.value]);
+        }
+        return new NoneOption();
+    }
+    toJSON() {
+        return { tag: 'Some', value: this.value };
+    }
+    toString() {
+        return `Some(${JSON.stringify(this.value)})`;
+    }
+}
+class NoneOption {
+    _tag = 'None';
+    isSome() {
+        return false;
+    }
+    isNone() {
+        return true;
+    }
+    map(_fn) {
+        return new NoneOption();
+    }
+    andThen(_fn) {
+        return new NoneOption();
+    }
+    orElse(fn) {
+        return fn();
+    }
+    unwrap() {
+        throw new Error('Called unwrap on None');
+    }
+    unwrapOr(defaultValue) {
+        return defaultValue;
+    }
+    unwrapOrElse(fn) {
+        return fn();
+    }
+    match(handlers) {
+        return handlers.none();
+    }
+    filter(_predicate) {
+        return this;
+    }
+    tap(_fn) {
+        return this;
+    }
+    zip(_other) {
+        return new NoneOption();
+    }
+    toJSON() {
+        return { tag: 'None' };
+    }
+    toString() {
+        return 'None';
+    }
+}
+// -- Public constructors -----------------------------------------------------
+/**
+ * Create an Option containing a value.
+ */
+function Some(value) {
+    return new SomeOption(value);
+}
+/**
+ * Create an empty Option.
+ */
+function None() {
+    return new NoneOption();
+}
+// -- Static utilities --------------------------------------------------------
+exports.OptionUtils = {
+    /**
+     * Create an Option from a nullable value.
+     * null | undefined → None, everything else → Some.
+     *
+     * @example
+     * ```ts
+     * Option.from(null)      // None
+     * Option.from(undefined) // None
+     * Option.from(42)        // Some(42)
+     * Option.from('')        // Some('')  (empty string is still Some)
+     * ```
+     */
+    from(value) {
+        return value === null || value === undefined
+            ? new NoneOption()
+            : new SomeOption(value);
+    },
+    /**
+     * Create an Option from a predicate check.
+     */
+    fromPredicate(value, predicate) {
+        return predicate(value) ? new SomeOption(value) : new NoneOption();
+    },
+    /**
+     * Check if a value is an Option.
+     */
+    isOption(value) {
+        return value instanceof SomeOption || value instanceof NoneOption;
+    },
+    /**
+     * Collect an array of Options into an Option of array.
+     * Returns None if any Option is None.
+     */
+    all(options) {
+        const values = [];
+        for (const opt of options) {
+            if (opt.isNone())
+                return new NoneOption();
+            values.push(opt.unwrap());
+        }
+        return new SomeOption(values);
+    },
+};
+//# sourceMappingURL=option.js.map

package/dist/cjs/result/option.js.map

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