@webiny/stdlib 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Webiny
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,60 @@
+# @webiny/stdlib
+
+Opinionated standard library for [Webiny](https://www.webiny.com). This is an internal package — we make breaking changes freely and do not follow semver for external consumers.
+
+## Design
+
+Services are built on a lightweight dependency injection system. Each feature follows the same three-layer pattern: an **abstraction** (DI token + interface), an **implementation** (concrete class), and a **feature** (registers the implementation in the DI container). This keeps code testable and lets different environments (Node.js, browser) swap implementations behind the same interface.
+
+## Subpath exports
+
+The package is ESM-only and ships three subpath exports. Because each is a separate entry point, Node.js-specific code is never bundled into a browser build and vice versa — unless you explicitly import the wrong subpath.
+
+| Import                   | Environment | Description                 |
+| ------------------------ | ----------- | --------------------------- |
+| `@webiny/stdlib`         | Any         | Platform-agnostic utilities |
+| `@webiny/stdlib/node`    | Node.js     | Node.js-specific tools      |
+| `@webiny/stdlib/browser` | Browser     | Browser-specific tools      |
+
+---
+
+## `@webiny/stdlib` — Common
+
+| Feature                                                                              | Description                                                                                 |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------- |
+| `Result` / `ResultAsync`                                                             | Typed success/failure values — synchronous and async                                        |
+| `BaseError`                                                                          | Abstract base class for typed domain errors                                                 |
+| `Logger` / `ConsoleLogger` / `ConsoleLoggerFeature`                                  | Logging abstraction + console implementation — [docs](src/common/features/Logger/README.md) |
+| `Cache` / `MemoryCacheFeature`                                                       | Synchronous key-value cache — [docs](src/common/features/Cache/README.md)                   |
+| `AsyncCache` / `AsyncMemoryCacheFeature`                                             | Async key-value cache — [docs](src/common/features/Cache/README.md)                         |
+| `immutableGet` / `immutableSet` / `immutableDelete` / `mutableSet` / `mutableDelete` | Dot-notation get/set/delete on nested objects — [docs](src/common/utils/README.md#dotprop)  |
+| `toBoolean` / `isTruthy` / `isFalsy`                                                 | Semantic boolean coercion — [docs](src/common/utils/README.md#boolean)                      |
+
+---
+
+## `@webiny/stdlib/node` — Node.js
+
+| Feature                                              | Description                                                                                                                         |
+| ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `FileTool` / `FileToolFeature`                       | Read, write, copy, remove files — [docs](src/node/features/FileTool/README.md)                                                      |
+| `DirectoryTool` / `DirectoryToolFeature`             | Create, read, remove, copy, glob directories — [docs](src/node/features/DirectoryTool/README.md)                                    |
+| `JsonFileTool` / `JsonFileToolFeature`               | Read and write JSON files with optional schema validation — [docs](src/node/features/JsonFileTool/README.md)                        |
+| `PathTool` / `PathToolFeature`                       | `node:path` wrapper + `resolvePackageFile` for package-relative paths — [docs](src/node/features/PathTool/README.md)                |
+| `PinoLogger` / `PinoLoggerFeature`                   | pino-based `Logger` implementation — [docs](src/node/features/PinoLogger/README.md)                                                 |
+| `NdJsonReaderTool` / `NdJsonReaderToolFeature`       | Parse NDJSON from files, streams, or in-memory lines with checkpoint support — [docs](src/node/features/NdJsonReaderTool/README.md) |
+| `ReadStreamFactory` / `ReadStreamFactoryFeature`     | Disposable `node:fs` read streams via `AsyncDisposable` — [docs](src/node/features/ReadStreamFactory/README.md)                     |
+| `PackageJsonFileTool` / `PackageJsonFileToolFeature` | Read, validate, mutate, and write `package.json` files — [docs](src/node/features/PackageJsonFileTool/README.md)                    |
+
+---
+
+## `@webiny/stdlib/browser` — Browser
+
+| Feature                    | Description                                                                                                       |
+| -------------------------- | ----------------------------------------------------------------------------------------------------------------- |
+| `LocalStorageCacheFeature` | `Cache` implementation backed by `window.localStorage` — [docs](src/browser/features/LocalStorageCache/README.md) |
+
+---
+
+## Versioning
+
+The package version in `package.json` is always `0.0.0`. The real version is injected at publish time by the release pipeline using conventional commits: `feat` bumps the minor, everything else (`fix`, `chore`, `refactor`, …) bumps the patch. There are no major version bumps — breaking changes may land on minor releases.

package/dist/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Webiny
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/README.md

@@ -0,0 +1,60 @@
+# @webiny/stdlib
+
+Opinionated standard library for [Webiny](https://www.webiny.com). This is an internal package — we make breaking changes freely and do not follow semver for external consumers.
+
+## Design
+
+Services are built on a lightweight dependency injection system. Each feature follows the same three-layer pattern: an **abstraction** (DI token + interface), an **implementation** (concrete class), and a **feature** (registers the implementation in the DI container). This keeps code testable and lets different environments (Node.js, browser) swap implementations behind the same interface.
+
+## Subpath exports
+
+The package is ESM-only and ships three subpath exports. Because each is a separate entry point, Node.js-specific code is never bundled into a browser build and vice versa — unless you explicitly import the wrong subpath.
+
+| Import                   | Environment | Description                 |
+| ------------------------ | ----------- | --------------------------- |
+| `@webiny/stdlib`         | Any         | Platform-agnostic utilities |
+| `@webiny/stdlib/node`    | Node.js     | Node.js-specific tools      |
+| `@webiny/stdlib/browser` | Browser     | Browser-specific tools      |
+
+---
+
+## `@webiny/stdlib` — Common
+
+| Feature                                                                              | Description                                                                                 |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------- |
+| `Result` / `ResultAsync`                                                             | Typed success/failure values — synchronous and async                                        |
+| `BaseError`                                                                          | Abstract base class for typed domain errors                                                 |
+| `Logger` / `ConsoleLogger` / `ConsoleLoggerFeature`                                  | Logging abstraction + console implementation — [docs](src/common/features/Logger/README.md) |
+| `Cache` / `MemoryCacheFeature`                                                       | Synchronous key-value cache — [docs](src/common/features/Cache/README.md)                   |
+| `AsyncCache` / `AsyncMemoryCacheFeature`                                             | Async key-value cache — [docs](src/common/features/Cache/README.md)                         |
+| `immutableGet` / `immutableSet` / `immutableDelete` / `mutableSet` / `mutableDelete` | Dot-notation get/set/delete on nested objects — [docs](src/common/utils/README.md#dotprop)  |
+| `toBoolean` / `isTruthy` / `isFalsy`                                                 | Semantic boolean coercion — [docs](src/common/utils/README.md#boolean)                      |
+
+---
+
+## `@webiny/stdlib/node` — Node.js
+
+| Feature                                              | Description                                                                                                                         |
+| ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `FileTool` / `FileToolFeature`                       | Read, write, copy, remove files — [docs](src/node/features/FileTool/README.md)                                                      |
+| `DirectoryTool` / `DirectoryToolFeature`             | Create, read, remove, copy, glob directories — [docs](src/node/features/DirectoryTool/README.md)                                    |
+| `JsonFileTool` / `JsonFileToolFeature`               | Read and write JSON files with optional schema validation — [docs](src/node/features/JsonFileTool/README.md)                        |
+| `PathTool` / `PathToolFeature`                       | `node:path` wrapper + `resolvePackageFile` for package-relative paths — [docs](src/node/features/PathTool/README.md)                |
+| `PinoLogger` / `PinoLoggerFeature`                   | pino-based `Logger` implementation — [docs](src/node/features/PinoLogger/README.md)                                                 |
+| `NdJsonReaderTool` / `NdJsonReaderToolFeature`       | Parse NDJSON from files, streams, or in-memory lines with checkpoint support — [docs](src/node/features/NdJsonReaderTool/README.md) |
+| `ReadStreamFactory` / `ReadStreamFactoryFeature`     | Disposable `node:fs` read streams via `AsyncDisposable` — [docs](src/node/features/ReadStreamFactory/README.md)                     |
+| `PackageJsonFileTool` / `PackageJsonFileToolFeature` | Read, validate, mutate, and write `package.json` files — [docs](src/node/features/PackageJsonFileTool/README.md)                    |
+
+---
+
+## `@webiny/stdlib/browser` — Browser
+
+| Feature                    | Description                                                                                                       |
+| -------------------------- | ----------------------------------------------------------------------------------------------------------------- |
+| `LocalStorageCacheFeature` | `Cache` implementation backed by `window.localStorage` — [docs](src/browser/features/LocalStorageCache/README.md) |
+
+---
+
+## Versioning
+
+The package version in `package.json` is always `0.0.0`. The real version is injected at publish time by the release pipeline using conventional commits: `feat` bumps the minor, everything else (`fix`, `chore`, `refactor`, …) bumps the patch. There are no major version bumps — breaking changes may land on minor releases.

package/dist/browser/features/LocalStorageCache/LocalStorageCache.d.ts

@@ -0,0 +1,26 @@
+import { Result } from "../../../common/index.js";
+import { Cache as CacheAbstraction } from "../../../common/index.js";
+import { LocalStorageParseError, LocalStorageQuotaExceededError, LocalStorageUnavailableError } from "./errors.js";
+type LocalStorageCacheError = LocalStorageParseError | LocalStorageQuotaExceededError | LocalStorageUnavailableError;
+declare class LocalStorageCacheImpl implements CacheAbstraction.Interface {
+    private prefix;
+    private readonly localStorage;
+    constructor();
+    private static fromPrefix;
+    private prefixedKey;
+    private unavailable;
+    get<T>(key: string): Result<T | null, LocalStorageCacheError>;
+    set<T>(key: string, value: T): Result<void, LocalStorageCacheError>;
+    remove(key: string): Result<void, LocalStorageCacheError>;
+    has(key: string): Result<boolean, LocalStorageCacheError>;
+    clear(): Result<void, LocalStorageCacheError>;
+    keys(): Result<string[], LocalStorageCacheError>;
+    getOrSet<T>(key: string, factory: () => T): Result<T, LocalStorageCacheError>;
+    byPrefix(prefix: string): CacheAbstraction.Interface;
+}
+export declare const LocalStorageCache: typeof LocalStorageCacheImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("../../../common/index.js").ICache>;
+};
+export declare function createLocalStorageCache(): CacheAbstraction.Interface;
+export {};
+//# sourceMappingURL=LocalStorageCache.d.ts.map

package/dist/browser/features/LocalStorageCache/LocalStorageCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalStorageCache.d.ts","sourceRoot":"","sources":["../../../../src/browser/features/LocalStorageCache/LocalStorageCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,KAAK,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EACH,sBAAsB,EACtB,8BAA8B,EAC9B,4BAA4B,EAC/B,MAAM,aAAa,CAAC;AAErB,KAAK,sBAAsB,GACrB,sBAAsB,GACtB,8BAA8B,GAC9B,4BAA4B,CAAC;AAEnC,cAAM,qBAAsB,YAAW,gBAAgB,CAAC,SAAS;IAC7D,OAAO,CAAC,MAAM,CAAc;IAE5B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiB;IAE9C,cAGC;IAED,OAAO,CAAC,MAAM,CAAC,UAAU;IAMzB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,WAAW;IAQZ,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,GAAG,IAAI,EAAE,sBAAsB,CAAC,CAkBnE;IAEM,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAgBzE;IAEM,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAM/D;IAEM,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAK/D;IAEM,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAoBnD;IAEM,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,sBAAsB,CAAC,CAuBtD;IAEM,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,sBAAsB,CAAC,CA+BnF;IAEM,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAG1D;CACJ;AAED,eAAO,MAAM,iBAAiB;;CAG5B,CAAC;AAEH,wBAAgB,uBAAuB,IAAI,gBAAgB,CAAC,SAAS,CAEpE"}

package/dist/browser/features/LocalStorageCache/LocalStorageCache.js

@@ -0,0 +1,159 @@
+import { Result } from "../../../common/index.js";
+import { Cache as CacheAbstraction } from "../../../common/index.js";
+import { LocalStorageParseError, LocalStorageQuotaExceededError, LocalStorageUnavailableError } from "./errors.js";
+class LocalStorageCacheImpl {
+    prefix = "";
+    localStorage;
+    constructor() {
+        this.localStorage =
+            typeof window !== "undefined" && window?.localStorage ? window.localStorage : null;
+    }
+    static fromPrefix(prefix) {
+        const instance = new LocalStorageCacheImpl();
+        instance.prefix = prefix;
+        return instance;
+    }
+    prefixedKey(key) {
+        return this.prefix ? `${this.prefix}.${key}` : key;
+    }
+    unavailable() {
+        return Result.fail(new LocalStorageUnavailableError({
+            message: "localStorage is not available"
+        }));
+    }
+    get(key) {
+        if (!this.localStorage) {
+            return this.unavailable();
+        }
+        const raw = this.localStorage.getItem(this.prefixedKey(key));
+        if (raw === null) {
+            return Result.ok(null);
+        }
+        try {
+            return Result.ok(JSON.parse(raw));
+        }
+        catch {
+            return Result.fail(new LocalStorageParseError({
+                message: `Failed to parse cache entry for key "${key}"`,
+                data: { key }
+            }));
+        }
+    }
+    set(key, value) {
+        if (!this.localStorage) {
+            return this.unavailable();
+        }
+        const serialised = JSON.stringify(value);
+        try {
+            this.localStorage.setItem(this.prefixedKey(key), serialised);
+            return Result.ok();
+        }
+        catch {
+            return Result.fail(new LocalStorageQuotaExceededError({
+                message: `Storage quota exceeded for key "${key}"`,
+                data: { key, valueSize: serialised.length }
+            }));
+        }
+    }
+    remove(key) {
+        if (!this.localStorage) {
+            return this.unavailable();
+        }
+        this.localStorage.removeItem(this.prefixedKey(key));
+        return Result.ok();
+    }
+    has(key) {
+        if (!this.localStorage) {
+            return this.unavailable();
+        }
+        return Result.ok(this.localStorage.getItem(this.prefixedKey(key)) !== null);
+    }
+    clear() {
+        if (!this.localStorage) {
+            return this.unavailable();
+        }
+        if (this.prefix) {
+            const scopePrefix = `${this.prefix}.`;
+            const keysToRemove = [];
+            for (let i = 0; i < this.localStorage.length; i++) {
+                const k = this.localStorage.key(i);
+                if (k !== null && k.startsWith(scopePrefix)) {
+                    keysToRemove.push(k);
+                }
+            }
+            for (const k of keysToRemove) {
+                this.localStorage.removeItem(k);
+            }
+        }
+        else {
+            this.localStorage.clear();
+        }
+        return Result.ok();
+    }
+    keys() {
+        if (!this.localStorage) {
+            return this.unavailable();
+        }
+        if (this.prefix) {
+            const scopePrefix = `${this.prefix}.`;
+            const result = [];
+            for (let i = 0; i < this.localStorage.length; i++) {
+                const k = this.localStorage.key(i);
+                if (k !== null && k.startsWith(scopePrefix)) {
+                    result.push(k.slice(scopePrefix.length));
+                }
+            }
+            return Result.ok(result);
+        }
+        const result = [];
+        for (let i = 0; i < this.localStorage.length; i++) {
+            const k = this.localStorage.key(i);
+            if (k !== null) {
+                result.push(k);
+            }
+        }
+        return Result.ok(result);
+    }
+    getOrSet(key, factory) {
+        if (!this.localStorage) {
+            return this.unavailable();
+        }
+        const prefixed = this.prefixedKey(key);
+        const existing = this.localStorage.getItem(prefixed);
+        if (existing !== null) {
+            try {
+                return Result.ok(JSON.parse(existing));
+            }
+            catch {
+                return Result.fail(new LocalStorageParseError({
+                    message: `Failed to parse cache entry for key "${key}"`,
+                    data: { key }
+                }));
+            }
+        }
+        const value = factory();
+        const serialised = JSON.stringify(value);
+        try {
+            this.localStorage.setItem(prefixed, serialised);
+        }
+        catch {
+            return Result.fail(new LocalStorageQuotaExceededError({
+                message: `Storage quota exceeded for key "${key}"`,
+                data: { key, valueSize: serialised.length }
+            }));
+        }
+        return Result.ok(value);
+    }
+    byPrefix(prefix) {
+        const combined = this.prefix ? `${this.prefix}.${prefix}` : prefix;
+        return LocalStorageCacheImpl.fromPrefix(combined);
+    }
+}
+export const LocalStorageCache = CacheAbstraction.createImplementation({
+    implementation: LocalStorageCacheImpl,
+    dependencies: []
+});
+export function createLocalStorageCache() {
+    return new LocalStorageCacheImpl();
+}
+//# sourceMappingURL=LocalStorageCache.js.map

package/dist/browser/features/LocalStorageCache/LocalStorageCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalStorageCache.js","sourceRoot":"","sources":["../../../../src/browser/features/LocalStorageCache/LocalStorageCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,KAAK,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EACH,sBAAsB,EACtB,8BAA8B,EAC9B,4BAA4B,EAC/B,MAAM,aAAa,CAAC;AAOrB,MAAM,qBAAqB;IACf,MAAM,GAAW,EAAE,CAAC;IAEX,YAAY,CAAiB;IAE9C;QACI,IAAI,CAAC,YAAY;YACb,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3F,CAAC;IAEO,MAAM,CAAC,UAAU,CAAC,MAAc;QACpC,MAAM,QAAQ,GAAG,IAAI,qBAAqB,EAAE,CAAC;QAC7C,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,OAAO,QAAQ,CAAC;IACpB,CAAC;IAEO,WAAW,CAAC,GAAW;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IACvD,CAAC;IAEO,WAAW;QACf,OAAO,MAAM,CAAC,IAAI,CACd,IAAI,4BAA4B,CAAC;YAC7B,OAAO,EAAE,+BAA+B;SAC3C,CAAC,CACL,CAAC;IACN,CAAC;IAEM,GAAG,CAAI,GAAW;QACrB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7D,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACf,OAAO,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC;YACD,OAAO,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,MAAM,CAAC,IAAI,CACd,IAAI,sBAAsB,CAAC;gBACvB,OAAO,EAAE,wCAAwC,GAAG,GAAG;gBACvD,IAAI,EAAE,EAAE,GAAG,EAAE;aAChB,CAAC,CACL,CAAC;QACN,CAAC;IACL,CAAC;IAEM,GAAG,CAAI,GAAW,EAAE,KAAQ;QAC/B,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;YAC7D,OAAO,MAAM,CAAC,EAAE,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,MAAM,CAAC,IAAI,CACd,IAAI,8BAA8B,CAAC;gBAC/B,OAAO,EAAE,mCAAmC,GAAG,GAAG;gBAClD,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,MAAM,EAAE;aAC9C,CAAC,CACL,CAAC;QACN,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,GAAW;QACrB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;QACpD,OAAO,MAAM,CAAC,EAAE,EAAE,CAAC;IACvB,CAAC;IAEM,GAAG,CAAC,GAAW;QAClB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,CAAC;QACD,OAAO,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAChF,CAAC;IAEM,KAAK;QACR,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,MAAM,WAAW,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;YACtC,MAAM,YAAY,GAAa,EAAE,CAAC;YAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAChD,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACnC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC1C,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACzB,CAAC;YACL,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;gBAC3B,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACpC,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC9B,CAAC;QACD,OAAO,MAAM,CAAC,EAAE,EAAE,CAAC;IACvB,CAAC;IAEM,IAAI;QACP,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,MAAM,WAAW,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;YACtC,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAChD,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACnC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC1C,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC7C,CAAC;YACL,CAAC;YACD,OAAO,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChD,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACnC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAEM,QAAQ,CAAI,GAAW,EAAE,OAAgB;QAC5C,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC;gBACD,OAAO,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAM,CAAC,CAAC;YAChD,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,MAAM,CAAC,IAAI,CACd,IAAI,sBAAsB,CAAC;oBACvB,OAAO,EAAE,wCAAwC,GAAG,GAAG;oBACvD,IAAI,EAAE,EAAE,GAAG,EAAE;iBAChB,CAAC,CACL,CAAC;YACN,CAAC;QACL,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC;QACxB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,MAAM,CAAC,IAAI,CACd,IAAI,8BAA8B,CAAC;gBAC/B,OAAO,EAAE,mCAAmC,GAAG,GAAG;gBAClD,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,MAAM,EAAE;aAC9C,CAAC,CACL,CAAC;QACN,CAAC;QACD,OAAO,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAEM,QAAQ,CAAC,MAAc;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QACnE,OAAO,qBAAqB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;CACJ;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,oBAAoB,CAAC;IACnE,cAAc,EAAE,qBAAqB;IACrC,YAAY,EAAE,EAAE;CACnB,CAAC,CAAC;AAEH,MAAM,UAAU,uBAAuB;IACnC,OAAO,IAAI,qBAAqB,EAAE,CAAC;AACvC,CAAC"}

package/dist/browser/features/LocalStorageCache/errors.d.ts

@@ -0,0 +1,26 @@
+import { CacheError } from "../../../common/index.js";
+import type { ErrorInput } from "../../../common/index.js";
+interface ParseErrorData {
+    key: string;
+}
+interface QuotaExceededData {
+    key: string;
+    valueSize: number;
+}
+/** Thrown when JSON.parse fails on a stored cache entry. */
+export declare class LocalStorageParseError extends CacheError<ParseErrorData> {
+    readonly code: "PARSE_ERROR";
+    constructor(input: ErrorInput<ParseErrorData>);
+}
+/** Thrown when localStorage.setItem throws a QuotaExceededError. */
+export declare class LocalStorageQuotaExceededError extends CacheError<QuotaExceededData> {
+    readonly code: "QUOTA_EXCEEDED";
+    constructor(input: ErrorInput<QuotaExceededData>);
+}
+/** Thrown when window.localStorage is not available (e.g. SSR, security restrictions). */
+export declare class LocalStorageUnavailableError extends CacheError {
+    readonly code: "STORAGE_UNAVAILABLE";
+    constructor(input: ErrorInput);
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/browser/features/LocalStorageCache/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/browser/features/LocalStorageCache/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,UAAU,cAAc;IACpB,GAAG,EAAE,MAAM,CAAC;CACf;AAED,UAAU,iBAAiB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,4DAA4D;AAC5D,qBAAa,sBAAuB,SAAQ,UAAU,CAAC,cAAc,CAAC;IAClE,SAAgB,IAAI,EAAG,aAAa,CAAU;IAC9C,YAAmB,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC,EAEnD;CACJ;AAED,oEAAoE;AACpE,qBAAa,8BAA+B,SAAQ,UAAU,CAAC,iBAAiB,CAAC;IAC7E,SAAgB,IAAI,EAAG,gBAAgB,CAAU;IACjD,YAAmB,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,EAEtD;CACJ;AAED,0FAA0F;AAC1F,qBAAa,4BAA6B,SAAQ,UAAU;IACxD,SAAgB,IAAI,EAAG,qBAAqB,CAAU;IACtD,YAAmB,KAAK,EAAE,UAAU,EAEnC;CACJ"}

package/dist/browser/features/LocalStorageCache/errors.js

@@ -0,0 +1,23 @@
+import { CacheError } from "../../../common/index.js";
+/** Thrown when JSON.parse fails on a stored cache entry. */
+export class LocalStorageParseError extends CacheError {
+    code = "PARSE_ERROR";
+    constructor(input) {
+        super(input);
+    }
+}
+/** Thrown when localStorage.setItem throws a QuotaExceededError. */
+export class LocalStorageQuotaExceededError extends CacheError {
+    code = "QUOTA_EXCEEDED";
+    constructor(input) {
+        super(input);
+    }
+}
+/** Thrown when window.localStorage is not available (e.g. SSR, security restrictions). */
+export class LocalStorageUnavailableError extends CacheError {
+    code = "STORAGE_UNAVAILABLE";
+    constructor(input) {
+        super(input);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/browser/features/LocalStorageCache/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/browser/features/LocalStorageCache/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAY/C,4DAA4D;AAC5D,MAAM,OAAO,sBAAuB,SAAQ,UAA0B;IAClD,IAAI,GAAG,aAAsB,CAAC;IAC9C,YAAmB,KAAiC;QAChD,KAAK,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;CACJ;AAED,oEAAoE;AACpE,MAAM,OAAO,8BAA+B,SAAQ,UAA6B;IAC7D,IAAI,GAAG,gBAAyB,CAAC;IACjD,YAAmB,KAAoC;QACnD,KAAK,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;CACJ;AAED,0FAA0F;AAC1F,MAAM,OAAO,4BAA6B,SAAQ,UAAU;IACxC,IAAI,GAAG,qBAA8B,CAAC;IACtD,YAAmB,KAAiB;QAChC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;CACJ"}

package/dist/browser/features/LocalStorageCache/feature.d.ts

@@ -0,0 +1,6 @@
+/** Registers LocalStorageCache as the Cache implementation. */
+export declare const LocalStorageCacheFeature: {
+    name: string;
+    register(container: import("@webiny/di").Container): void;
+};
+//# sourceMappingURL=feature.d.ts.map

package/dist/browser/features/LocalStorageCache/feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.d.ts","sourceRoot":"","sources":["../../../../src/browser/features/LocalStorageCache/feature.ts"],"names":[],"mappings":"AAGA,+DAA+D;AAC/D,eAAO,MAAM,wBAAwB;;;CAKnC,CAAC"}

package/dist/browser/features/LocalStorageCache/feature.js

@@ -0,0 +1,10 @@
+import { createFeature } from "../../../common/index.js";
+import { LocalStorageCache } from "./LocalStorageCache.js";
+/** Registers LocalStorageCache as the Cache implementation. */
+export const LocalStorageCacheFeature = createFeature({
+    name: "Browser/LocalStorageCacheFeature",
+    register(container) {
+        container.register(LocalStorageCache).inSingletonScope();
+    }
+});
+//# sourceMappingURL=feature.js.map

package/dist/browser/features/LocalStorageCache/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../../../src/browser/features/LocalStorageCache/feature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,+DAA+D;AAC/D,MAAM,CAAC,MAAM,wBAAwB,GAAG,aAAa,CAAC;IAClD,IAAI,EAAE,kCAAkC;IACxC,QAAQ,CAAC,SAAS;QACd,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAC7D,CAAC;CACJ,CAAC,CAAC"}

package/dist/browser/features/LocalStorageCache/index.d.ts

@@ -0,0 +1,4 @@
+export { LocalStorageCacheFeature } from "./feature.js";
+export { createLocalStorageCache } from "./LocalStorageCache.js";
+export { LocalStorageParseError, LocalStorageQuotaExceededError, LocalStorageUnavailableError } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/features/LocalStorageCache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/browser/features/LocalStorageCache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EACH,sBAAsB,EACtB,8BAA8B,EAC9B,4BAA4B,EAC/B,MAAM,aAAa,CAAC"}

package/dist/browser/features/LocalStorageCache/index.js

@@ -0,0 +1,4 @@
+export { LocalStorageCacheFeature } from "./feature.js";
+export { createLocalStorageCache } from "./LocalStorageCache.js";
+export { LocalStorageParseError, LocalStorageQuotaExceededError, LocalStorageUnavailableError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/browser/features/LocalStorageCache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/browser/features/LocalStorageCache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EACH,sBAAsB,EACtB,8BAA8B,EAC9B,4BAA4B,EAC/B,MAAM,aAAa,CAAC"}

package/dist/browser/index.d.ts

@@ -0,0 +1,2 @@
+export { LocalStorageCacheFeature, createLocalStorageCache, LocalStorageParseError, LocalStorageQuotaExceededError, LocalStorageUnavailableError } from "./features/LocalStorageCache/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,8BAA8B,EAC9B,4BAA4B,EAC/B,MAAM,uCAAuC,CAAC"}

package/dist/browser/index.js

@@ -0,0 +1,2 @@
+export { LocalStorageCacheFeature, createLocalStorageCache, LocalStorageParseError, LocalStorageQuotaExceededError, LocalStorageUnavailableError } from "./features/LocalStorageCache/index.js";
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,8BAA8B,EAC9B,4BAA4B,EAC/B,MAAM,uCAAuC,CAAC"}

package/dist/common/core/BaseError.d.ts

@@ -0,0 +1,13 @@
+export type ErrorInput<TData = void> = TData extends void ? {
+    message: string;
+    data?: never;
+} : {
+    message: string;
+    data: TData;
+};
+export declare abstract class BaseError<TData = void> extends Error {
+    abstract readonly code: string;
+    readonly data: TData extends void ? undefined : TData;
+    protected constructor(input: ErrorInput<TData>);
+}
+//# sourceMappingURL=BaseError.d.ts.map

package/dist/common/core/BaseError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseError.d.ts","sourceRoot":"","sources":["../../../src/common/core/BaseError.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,KAAK,GAAG,IAAI,IAAI,KAAK,SAAS,IAAI,GACnD;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,KAAK,CAAA;CAAE,GACjC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AAEvC,8BAAsB,SAAS,CAAC,KAAK,GAAG,IAAI,CAAE,SAAQ,KAAK;IACvD,kBAAyB,IAAI,EAAE,MAAM,CAAC;IACtC,SAAgB,IAAI,EAAE,KAAK,SAAS,IAAI,GAAG,SAAS,GAAG,KAAK,CAAC;IAE7D,SAAS,aAAa,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,EAG7C;CACJ"}

package/dist/common/core/BaseError.js

@@ -0,0 +1,8 @@
+export class BaseError extends Error {
+    data;
+    constructor(input) {
+        super(input.message);
+        this.data = input.data;
+    }
+}
+//# sourceMappingURL=BaseError.js.map

package/dist/common/core/BaseError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseError.js","sourceRoot":"","sources":["../../../src/common/core/BaseError.ts"],"names":[],"mappings":"AAIA,MAAM,OAAgB,SAAwB,SAAQ,KAAK;IAEvC,IAAI,CAAyC;IAE7D,YAAsB,KAAwB;QAC1C,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAW,CAAC;IAClC,CAAC;CACJ"}

package/dist/common/core/Result.d.ts

@@ -0,0 +1,103 @@
+/**
+ * A container type that represents either a successful result (`ok`) or a failure (`fail`).
+ * Inspired by functional programming constructs like `Either` or `Result` in other languages.
+ *
+ * @template TValue - The type of the success value.
+ * @template TError - The type of the error value.
+ */
+export declare class Result<TValue, TError = never> {
+    protected readonly _isOk: boolean;
+    protected readonly _value?: TValue;
+    protected readonly _error?: TError;
+    private constructor();
+    /**
+     * Creates a successful `Result` containing the provided value.
+     * If no value is provided, returns Result<void, never>.
+     *
+     * @param value - The value to wrap in a successful result (optional).
+     * @returns A `Result` instance with the value.
+     */
+    static ok<T>(value: T): Result<T, never>;
+    static ok(): Result<void, never>;
+    /**
+     * Creates a failed `Result` containing the provided error.
+     *
+     * @param error - The error to wrap in a failed result.
+     * @returns A `Result` instance with the error.
+     */
+    static fail<E>(error: E): Result<never, E>;
+    /**
+     * Checks whether the result is successful.
+     *
+     * @returns `true` if the result is `ok`, otherwise `false`.
+     *          Acts as a type guard to narrow the type to a successful result.
+     */
+    isOk(): this is {
+        _value: TValue;
+    } & Result<TValue, TError>;
+    /**
+     * Checks whether the result is a failure.
+     *
+     * @returns `true` if the result is `fail`, otherwise `false`.
+     *          Acts as a type guard to narrow the type to a failed result.
+     */
+    isFail(): this is {
+        _error: TError;
+    } & Result<TValue, TError>;
+    /**
+     * Gets the value inside a successful result.
+     *
+     * @throws If the result is a failure.
+     * @returns The success value.
+     */
+    get value(): TValue;
+    /**
+     * Gets the error inside a failed result.
+     *
+     * @throws If the result is successful.
+     * @returns The error value.
+     */
+    get error(): TError;
+    /**
+     * Transforms the success value using the provided mapping function.
+     *
+     * @template U - The type of the new success value.
+     * @param fn - Function to apply to the value if the result is successful.
+     * @returns A new `Result` containing the mapped value, or the original error if failed.
+     */
+    map<U>(fn: (value: TValue) => U): Result<U, TError>;
+    /**
+     * Transforms the error value using the provided mapping function.
+     *
+     * @template F - The type of the new error.
+     * @param fn - Function to apply to the error if the result is a failure.
+     * @returns A new `Result` containing the original value or the mapped error.
+     */
+    mapError<F>(fn: (error: TError) => F): Result<TValue, F>;
+    /**
+     * Chains another `Result`-producing function onto this result.
+     * If this result is successful, the function is applied to the value.
+     * If this result is a failure, the original error is returned.
+     *
+     * @template U - The type of the next success value.
+     * @param fn - A function that takes the current value and returns another `Result`.
+     * @returns A new `Result` from applying the function or the original failure.
+     */
+    flatMap<U>(fn: (value: TValue) => Result<U, TError>): Result<U, TError>;
+    /**
+     * Pattern-matches the result to handle both success and failure cases.
+     *
+     * @template U - The return type of both match functions.
+     * @param handlers - An object containing `ok` and `fail` handlers.
+     * @returns The return value from the corresponding handler.
+     */
+    match<U>(handlers: {
+        ok: (value: TValue) => U;
+        fail: (error: TError) => U;
+    }): U;
+}
+export declare namespace Result {
+    type UnwrapResult<T> = Awaited<T> extends Result<infer Ok, any> ? Ok : never;
+    type UnwrapError<T> = Awaited<T> extends Result<any, infer Err> ? Err : never;
+}
+//# sourceMappingURL=Result.d.ts.map