tempest-react-sdk 0.63.0 → 0.65.0

package/dist/utils/storage.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"storage.cjs","names":[],"sources":["../../src/utils/storage.ts"],"sourcesContent":["/** How a {@link createJsonStorage} store turns values into text and back. */\nexport interface StorageCodec {\n    /** Encode a value for storage. */\n    serialize: <T>(value: T) => string;\n    /** Decode a stored string. */\n    deserialize: <T>(raw: string) => T;\n}\n\n/** The surface every store built by {@link createJsonStorage} exposes. */\nexport interface JsonStorage {\n    /**\n     * Read and decode a key.\n     *\n     * @typeParam T - The expected value shape.\n     * @param key - Storage key.\n     * @param fallback - Returned when the key is absent, unreadable, or corrupt.\n     * @returns The stored value, or `fallback`.\n     */\n    get<T>(key: string, fallback: T): T;\n    /**\n     * Encode and write a key.\n     *\n     * @typeParam T - The value being stored.\n     * @param key - Storage key.\n     * @param value - Any value the codec can represent.\n     */\n    set<T>(key: string, value: T): void;\n    /**\n     * Delete a key.\n     *\n     * @param key - Storage key.\n     */\n    remove(key: string): void;\n}\n\nconst jsonCodec: StorageCodec = {\n    serialize: (value) => JSON.stringify(value),\n    deserialize: (raw) => JSON.parse(raw),\n};\n\n/**\n * Encode with the codec, degrading to plain JSON when the codec itself fails.\n *\n * A codec that throws — a compressor running out of room on a huge value —\n * should cost size, not the record: a slightly larger row still loads, an absent\n * one does not. `null` means not even JSON could represent the value, which is\n * the one case where dropping the write is the only option left.\n *\n * @param codec - The store's codec.\n * @param value - The value to encode.\n * @returns The encoded string, or `null` when the value cannot be represented.\n */\nfunction encode<T>(codec: StorageCodec, value: T): string | null {\n    try {\n        return codec.serialize(value);\n    } catch {\n        try {\n            return JSON.stringify(value);\n        } catch {\n            return null;\n        }\n    }\n}\n\n/**\n * Build a typed `localStorage` wrapper around a codec.\n *\n * One implementation behind every store the SDK ships, so they cannot drift in\n * surface. {@link storage} and {@link compressedStorage} are both this function —\n * before it, the compressed one was a hand-written copy of the same guards and\n * had no `remove`, while its own docstring promised the two were interchangeable\n * at the call site. They were not, and the promise failed exactly where somebody\n * followed it.\n *\n * @example\n * const session = createJsonStorage();\n * session.set(\"draft\", { title: \"Sem título\" });\n *\n * @example\n * const packed = createJsonStorage(compressedStorageCodec);\n *\n * @param codec - Encoder pair. Defaults to plain JSON.\n * @returns A store with `get` / `set` / `remove`.\n *\n * @tempest-limits empty-catch — every method is best-effort by contract:\n * `localStorage` throws on quota exhaustion, in Safari private mode, and when a\n * cross-origin frame has storage blocked. A caller persisting a preference has no\n * recovery to run and no user-facing message to show, so the write is dropped and\n * the app keeps the value in memory for the session.\n */\nexport function createJsonStorage(codec: StorageCodec = jsonCodec): JsonStorage {\n    return {\n        get<T>(key: string, fallback: T): T {\n            if (typeof window === \"undefined\") return fallback;\n            try {\n                const raw = window.localStorage.getItem(key);\n                return raw === null ? fallback : codec.deserialize<T>(raw);\n            } catch {\n                return fallback;\n            }\n        },\n\n        set<T>(key: string, value: T): void {\n            if (typeof window === \"undefined\") return;\n            const encoded = encode(codec, value);\n            if (encoded === null) return;\n            try {\n                window.localStorage.setItem(key, encoded);\n            } catch {\n                /* empty */\n            }\n        },\n\n        remove(key: string): void {\n            if (typeof window === \"undefined\") return;\n            try {\n                window.localStorage.removeItem(key);\n            } catch {\n                /* empty */\n            }\n        },\n    };\n}\n\n/**\n * Typed wrapper around `localStorage` that JSON-encodes values and silently\n * handles environments where storage is unavailable (SSR, private mode).\n */\nexport const storage: JsonStorage = createJsonStorage();\n"],"mappings":"AAmCA,IAAM,EAA0B,CAC5B,UAAY,GAAU,KAAK,UAAU,CAAK,EAC1C,YAAc,GAAQ,KAAK,MAAM,CAAG,CACxC,EAcA,SAAS,EAAU,EAAqB,EAAyB,CAC7D,GAAI,CACA,OAAO,EAAM,UAAU,CAAK,CAChC,MAAQ,CACJ,GAAI,CACA,OAAO,KAAK,UAAU,CAAK,CAC/B,MAAQ,CACJ,OAAO,IACX,CACJ,CACJ,CA4BA,SAAgB,EAAkB,EAAsB,EAAwB,CAC5E,MAAO,CACH,IAAO,EAAa,EAAgB,CAChC,GAAI,OAAO,OAAW,IAAa,OAAO,EAC1C,GAAI,CACA,IAAM,EAAM,OAAO,aAAa,QAAQ,CAAG,EAC3C,OAAO,IAAQ,KAAO,EAAW,EAAM,YAAe,CAAG,CAC7D,MAAQ,CACJ,OAAO,CACX,CACJ,EAEA,IAAO,EAAa,EAAgB,CAChC,GAAI,OAAO,OAAW,IAAa,OACnC,IAAM,EAAU,EAAO,EAAO,CAAK,EAC/B,OAAY,KAChB,GAAI,CACA,OAAO,aAAa,QAAQ,EAAK,CAAO,CAC5C,MAAQ,CAER,CACJ,EAEA,OAAO,EAAmB,CAClB,YAAO,OAAW,KACtB,GAAI,CACA,OAAO,aAAa,WAAW,CAAG,CACtC,MAAQ,CAER,CACJ,CACJ,CACJ,CAMA,IAAa,EAAuB,EAAkB"}
+{"version":3,"file":"storage.cjs","names":[],"sources":["../../src/utils/storage.ts"],"sourcesContent":["/** How a {@link createJsonStorage} store turns values into text and back. */\nexport interface StorageCodec {\n    /** Encode a value for storage. */\n    serialize: <T>(value: T) => string;\n    /** Decode a stored string. */\n    deserialize: <T>(raw: string) => T;\n}\n\n/** The surface every store built by {@link createJsonStorage} exposes. */\nexport interface JsonStorage {\n    /**\n     * Read and decode a key.\n     *\n     * The value is decoded by the store's codec — JSON for {@link storage} —\n     * which is what makes a key written as a bare string unreadable here: it is\n     * not the shape this method writes. {@link JsonStorage.getRaw} reads those.\n     *\n     * @typeParam T - The expected value shape.\n     * @param key - Storage key.\n     * @param fallback - Returned when the key is absent, unreadable, or corrupt.\n     * @returns The stored value, or `fallback`.\n     */\n    get<T>(key: string, fallback: T): T;\n    /**\n     * Encode and write a key.\n     *\n     * The value is **encoded** — `set(\"theme\", \"dark\")` stores `\"dark\"` with the\n     * quotes, not `dark`. That matters when an existing key is being adopted:\n     * whatever read it before will no longer recognise what this writes, and the\n     * old value will no longer parse here. {@link JsonStorage.setRaw} is the\n     * passthrough.\n     *\n     * @typeParam T - The value being stored.\n     * @param key - Storage key.\n     * @param value - Any value the codec can represent.\n     */\n    set<T>(key: string, value: T): void;\n    /**\n     * Read a key exactly as `localStorage` holds it, with no decoding.\n     *\n     * The escape hatch {@link JsonStorage.get} cannot be: `get` runs the codec,\n     * so a key holding a bare `dark` — written by another library, by the app\n     * before it adopted this wrapper, or by the SDK's own `ThemeProvider` —\n     * fails to parse and comes back as the fallback. Reading that key is a\n     * different operation, not a variant of the same one.\n     *\n     * @param key - Storage key.\n     * @returns The stored string, or `null` when the key is absent or storage is\n     *   unavailable.\n     */\n    getRaw(key: string): string | null;\n    /**\n     * Write a string exactly as given, with no encoding.\n     *\n     * The counterpart of {@link JsonStorage.getRaw}, and what keeps adoption from\n     * being a silent migration: `set(\"theme\", \"dark\")` stores `\"dark\"` **with the\n     * quotes**, which the app's previous reader no longer recognises.\n     *\n     * @param key - Storage key.\n     * @param value - The exact string to store.\n     */\n    setRaw(key: string, value: string): void;\n    /**\n     * Delete a key.\n     *\n     * @param key - Storage key.\n     */\n    remove(key: string): void;\n}\n\nconst jsonCodec: StorageCodec = {\n    serialize: (value) => JSON.stringify(value),\n    deserialize: (raw) => JSON.parse(raw),\n};\n\n/**\n * Encode with the codec, degrading to plain JSON when the codec itself fails.\n *\n * A codec that throws — a compressor running out of room on a huge value —\n * should cost size, not the record: a slightly larger row still loads, an absent\n * one does not. `null` means not even JSON could represent the value, which is\n * the one case where dropping the write is the only option left.\n *\n * @param codec - The store's codec.\n * @param value - The value to encode.\n * @returns The encoded string, or `null` when the value cannot be represented.\n */\nfunction encode<T>(codec: StorageCodec, value: T): string | null {\n    try {\n        return codec.serialize(value);\n    } catch {\n        try {\n            return JSON.stringify(value);\n        } catch {\n            return null;\n        }\n    }\n}\n\n/**\n * Build a typed `localStorage` wrapper around a codec.\n *\n * One implementation behind every store the SDK ships, so they cannot drift in\n * surface. {@link storage} and {@link compressedStorage} are both this function —\n * before it, the compressed one was a hand-written copy of the same guards and\n * had no `remove`, while its own docstring promised the two were interchangeable\n * at the call site. They were not, and the promise failed exactly where somebody\n * followed it.\n *\n * @example\n * const session = createJsonStorage();\n * session.set(\"draft\", { title: \"Sem título\" });\n *\n * @example\n * const packed = createJsonStorage(compressedStorageCodec);\n *\n * @param codec - Encoder pair. Defaults to plain JSON.\n * @returns A store with `get` / `set` / `getRaw` / `setRaw` / `remove`.\n *\n * @tempest-limits empty-catch — every method is best-effort by contract:\n * `localStorage` throws on quota exhaustion, in Safari private mode, and when a\n * cross-origin frame has storage blocked. A caller persisting a preference has no\n * recovery to run and no user-facing message to show, so the write is dropped and\n * the app keeps the value in memory for the session.\n */\nexport function createJsonStorage(codec: StorageCodec = jsonCodec): JsonStorage {\n    return {\n        get<T>(key: string, fallback: T): T {\n            if (typeof window === \"undefined\") return fallback;\n            try {\n                const raw = window.localStorage.getItem(key);\n                return raw === null ? fallback : codec.deserialize<T>(raw);\n            } catch {\n                return fallback;\n            }\n        },\n\n        set<T>(key: string, value: T): void {\n            if (typeof window === \"undefined\") return;\n            const encoded = encode(codec, value);\n            if (encoded === null) return;\n            try {\n                window.localStorage.setItem(key, encoded);\n            } catch {\n                /* empty */\n            }\n        },\n\n        getRaw(key: string): string | null {\n            if (typeof window === \"undefined\") return null;\n            try {\n                return window.localStorage.getItem(key);\n            } catch {\n                return null;\n            }\n        },\n\n        setRaw(key: string, value: string): void {\n            if (typeof window === \"undefined\") return;\n            try {\n                window.localStorage.setItem(key, value);\n            } catch {\n                /* empty */\n            }\n        },\n\n        remove(key: string): void {\n            if (typeof window === \"undefined\") return;\n            try {\n                window.localStorage.removeItem(key);\n            } catch {\n                /* empty */\n            }\n        },\n    };\n}\n\n/**\n * Typed wrapper around `localStorage` that JSON-encodes values and silently\n * handles environments where storage is unavailable (SSR, private mode).\n *\n * `get`/`set` encode; `getRaw`/`setRaw` do not. Reach for the raw pair when the\n * key is shared with something that does not speak JSON — an existing key in an\n * app adopting this wrapper, a key another library owns, or the theme\n * preference the SDK's own `ThemeProvider` stores as a bare string.\n */\nexport const storage: JsonStorage = createJsonStorage();\n"],"mappings":"AAsEA,IAAM,EAA0B,CAC5B,UAAY,GAAU,KAAK,UAAU,CAAK,EAC1C,YAAc,GAAQ,KAAK,MAAM,CAAG,CACxC,EAcA,SAAS,EAAU,EAAqB,EAAyB,CAC7D,GAAI,CACA,OAAO,EAAM,UAAU,CAAK,CAChC,MAAQ,CACJ,GAAI,CACA,OAAO,KAAK,UAAU,CAAK,CAC/B,MAAQ,CACJ,OAAO,IACX,CACJ,CACJ,CA4BA,SAAgB,EAAkB,EAAsB,EAAwB,CAC5E,MAAO,CACH,IAAO,EAAa,EAAgB,CAChC,GAAI,OAAO,OAAW,IAAa,OAAO,EAC1C,GAAI,CACA,IAAM,EAAM,OAAO,aAAa,QAAQ,CAAG,EAC3C,OAAO,IAAQ,KAAO,EAAW,EAAM,YAAe,CAAG,CAC7D,MAAQ,CACJ,OAAO,CACX,CACJ,EAEA,IAAO,EAAa,EAAgB,CAChC,GAAI,OAAO,OAAW,IAAa,OACnC,IAAM,EAAU,EAAO,EAAO,CAAK,EAC/B,OAAY,KAChB,GAAI,CACA,OAAO,aAAa,QAAQ,EAAK,CAAO,CAC5C,MAAQ,CAER,CACJ,EAEA,OAAO,EAA4B,CAC/B,GAAI,OAAO,OAAW,IAAa,OAAO,KAC1C,GAAI,CACA,OAAO,OAAO,aAAa,QAAQ,CAAG,CAC1C,MAAQ,CACJ,OAAO,IACX,CACJ,EAEA,OAAO,EAAa,EAAqB,CACjC,YAAO,OAAW,KACtB,GAAI,CACA,OAAO,aAAa,QAAQ,EAAK,CAAK,CAC1C,MAAQ,CAER,CACJ,EAEA,OAAO,EAAmB,CAClB,YAAO,OAAW,KACtB,GAAI,CACA,OAAO,aAAa,WAAW,CAAG,CACtC,MAAQ,CAER,CACJ,CACJ,CACJ,CAWA,IAAa,EAAuB,EAAkB"}

package/dist/utils/storage.js

@@ -32,6 +32,19 @@ function n(n = e) {
 				window.localStorage.setItem(e, i);
 			} catch {}
 		},
+		getRaw(e) {
+			if (typeof window > "u") return null;
+			try {
+				return window.localStorage.getItem(e);
+			} catch {
+				return null;
+			}
+		},
+		setRaw(e, t) {
+			if (!(typeof window > "u")) try {
+				window.localStorage.setItem(e, t);
+			} catch {}
+		},
 		remove(e) {
 			if (!(typeof window > "u")) try {
 				window.localStorage.removeItem(e);

package/dist/utils/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","names":[],"sources":["../../src/utils/storage.ts"],"sourcesContent":["/** How a {@link createJsonStorage} store turns values into text and back. */\nexport interface StorageCodec {\n    /** Encode a value for storage. */\n    serialize: <T>(value: T) => string;\n    /** Decode a stored string. */\n    deserialize: <T>(raw: string) => T;\n}\n\n/** The surface every store built by {@link createJsonStorage} exposes. */\nexport interface JsonStorage {\n    /**\n     * Read and decode a key.\n     *\n     * @typeParam T - The expected value shape.\n     * @param key - Storage key.\n     * @param fallback - Returned when the key is absent, unreadable, or corrupt.\n     * @returns The stored value, or `fallback`.\n     */\n    get<T>(key: string, fallback: T): T;\n    /**\n     * Encode and write a key.\n     *\n     * @typeParam T - The value being stored.\n     * @param key - Storage key.\n     * @param value - Any value the codec can represent.\n     */\n    set<T>(key: string, value: T): void;\n    /**\n     * Delete a key.\n     *\n     * @param key - Storage key.\n     */\n    remove(key: string): void;\n}\n\nconst jsonCodec: StorageCodec = {\n    serialize: (value) => JSON.stringify(value),\n    deserialize: (raw) => JSON.parse(raw),\n};\n\n/**\n * Encode with the codec, degrading to plain JSON when the codec itself fails.\n *\n * A codec that throws — a compressor running out of room on a huge value —\n * should cost size, not the record: a slightly larger row still loads, an absent\n * one does not. `null` means not even JSON could represent the value, which is\n * the one case where dropping the write is the only option left.\n *\n * @param codec - The store's codec.\n * @param value - The value to encode.\n * @returns The encoded string, or `null` when the value cannot be represented.\n */\nfunction encode<T>(codec: StorageCodec, value: T): string | null {\n    try {\n        return codec.serialize(value);\n    } catch {\n        try {\n            return JSON.stringify(value);\n        } catch {\n            return null;\n        }\n    }\n}\n\n/**\n * Build a typed `localStorage` wrapper around a codec.\n *\n * One implementation behind every store the SDK ships, so they cannot drift in\n * surface. {@link storage} and {@link compressedStorage} are both this function —\n * before it, the compressed one was a hand-written copy of the same guards and\n * had no `remove`, while its own docstring promised the two were interchangeable\n * at the call site. They were not, and the promise failed exactly where somebody\n * followed it.\n *\n * @example\n * const session = createJsonStorage();\n * session.set(\"draft\", { title: \"Sem título\" });\n *\n * @example\n * const packed = createJsonStorage(compressedStorageCodec);\n *\n * @param codec - Encoder pair. Defaults to plain JSON.\n * @returns A store with `get` / `set` / `remove`.\n *\n * @tempest-limits empty-catch — every method is best-effort by contract:\n * `localStorage` throws on quota exhaustion, in Safari private mode, and when a\n * cross-origin frame has storage blocked. A caller persisting a preference has no\n * recovery to run and no user-facing message to show, so the write is dropped and\n * the app keeps the value in memory for the session.\n */\nexport function createJsonStorage(codec: StorageCodec = jsonCodec): JsonStorage {\n    return {\n        get<T>(key: string, fallback: T): T {\n            if (typeof window === \"undefined\") return fallback;\n            try {\n                const raw = window.localStorage.getItem(key);\n                return raw === null ? fallback : codec.deserialize<T>(raw);\n            } catch {\n                return fallback;\n            }\n        },\n\n        set<T>(key: string, value: T): void {\n            if (typeof window === \"undefined\") return;\n            const encoded = encode(codec, value);\n            if (encoded === null) return;\n            try {\n                window.localStorage.setItem(key, encoded);\n            } catch {\n                /* empty */\n            }\n        },\n\n        remove(key: string): void {\n            if (typeof window === \"undefined\") return;\n            try {\n                window.localStorage.removeItem(key);\n            } catch {\n                /* empty */\n            }\n        },\n    };\n}\n\n/**\n * Typed wrapper around `localStorage` that JSON-encodes values and silently\n * handles environments where storage is unavailable (SSR, private mode).\n */\nexport const storage: JsonStorage = createJsonStorage();\n"],"mappings":";AAmCA,IAAM,IAA0B;CAC5B,YAAY,MAAU,KAAK,UAAU,CAAK;CAC1C,cAAc,MAAQ,KAAK,MAAM,CAAG;AACxC;AAcA,SAAS,EAAU,GAAqB,GAAyB;CAC7D,IAAI;EACA,OAAO,EAAM,UAAU,CAAK;CAChC,QAAQ;EACJ,IAAI;GACA,OAAO,KAAK,UAAU,CAAK;EAC/B,QAAQ;GACJ,OAAO;EACX;CACJ;AACJ;AA4BA,SAAgB,EAAkB,IAAsB,GAAwB;CAC5E,OAAO;EACH,IAAO,GAAa,GAAgB;GAChC,IAAI,OAAO,SAAW,KAAa,OAAO;GAC1C,IAAI;IACA,IAAM,IAAM,OAAO,aAAa,QAAQ,CAAG;IAC3C,OAAO,MAAQ,OAAO,IAAW,EAAM,YAAe,CAAG;GAC7D,QAAQ;IACJ,OAAO;GACX;EACJ;EAEA,IAAO,GAAa,GAAgB;GAChC,IAAI,OAAO,SAAW,KAAa;GACnC,IAAM,IAAU,EAAO,GAAO,CAAK;GAC/B,UAAY,MAChB,IAAI;IACA,OAAO,aAAa,QAAQ,GAAK,CAAO;GAC5C,QAAQ,CAER;EACJ;EAEA,OAAO,GAAmB;GAClB,aAAO,SAAW,MACtB,IAAI;IACA,OAAO,aAAa,WAAW,CAAG;GACtC,QAAQ,CAER;EACJ;CACJ;AACJ;AAMA,IAAa,IAAuB,EAAkB"}
+{"version":3,"file":"storage.js","names":[],"sources":["../../src/utils/storage.ts"],"sourcesContent":["/** How a {@link createJsonStorage} store turns values into text and back. */\nexport interface StorageCodec {\n    /** Encode a value for storage. */\n    serialize: <T>(value: T) => string;\n    /** Decode a stored string. */\n    deserialize: <T>(raw: string) => T;\n}\n\n/** The surface every store built by {@link createJsonStorage} exposes. */\nexport interface JsonStorage {\n    /**\n     * Read and decode a key.\n     *\n     * The value is decoded by the store's codec — JSON for {@link storage} —\n     * which is what makes a key written as a bare string unreadable here: it is\n     * not the shape this method writes. {@link JsonStorage.getRaw} reads those.\n     *\n     * @typeParam T - The expected value shape.\n     * @param key - Storage key.\n     * @param fallback - Returned when the key is absent, unreadable, or corrupt.\n     * @returns The stored value, or `fallback`.\n     */\n    get<T>(key: string, fallback: T): T;\n    /**\n     * Encode and write a key.\n     *\n     * The value is **encoded** — `set(\"theme\", \"dark\")` stores `\"dark\"` with the\n     * quotes, not `dark`. That matters when an existing key is being adopted:\n     * whatever read it before will no longer recognise what this writes, and the\n     * old value will no longer parse here. {@link JsonStorage.setRaw} is the\n     * passthrough.\n     *\n     * @typeParam T - The value being stored.\n     * @param key - Storage key.\n     * @param value - Any value the codec can represent.\n     */\n    set<T>(key: string, value: T): void;\n    /**\n     * Read a key exactly as `localStorage` holds it, with no decoding.\n     *\n     * The escape hatch {@link JsonStorage.get} cannot be: `get` runs the codec,\n     * so a key holding a bare `dark` — written by another library, by the app\n     * before it adopted this wrapper, or by the SDK's own `ThemeProvider` —\n     * fails to parse and comes back as the fallback. Reading that key is a\n     * different operation, not a variant of the same one.\n     *\n     * @param key - Storage key.\n     * @returns The stored string, or `null` when the key is absent or storage is\n     *   unavailable.\n     */\n    getRaw(key: string): string | null;\n    /**\n     * Write a string exactly as given, with no encoding.\n     *\n     * The counterpart of {@link JsonStorage.getRaw}, and what keeps adoption from\n     * being a silent migration: `set(\"theme\", \"dark\")` stores `\"dark\"` **with the\n     * quotes**, which the app's previous reader no longer recognises.\n     *\n     * @param key - Storage key.\n     * @param value - The exact string to store.\n     */\n    setRaw(key: string, value: string): void;\n    /**\n     * Delete a key.\n     *\n     * @param key - Storage key.\n     */\n    remove(key: string): void;\n}\n\nconst jsonCodec: StorageCodec = {\n    serialize: (value) => JSON.stringify(value),\n    deserialize: (raw) => JSON.parse(raw),\n};\n\n/**\n * Encode with the codec, degrading to plain JSON when the codec itself fails.\n *\n * A codec that throws — a compressor running out of room on a huge value —\n * should cost size, not the record: a slightly larger row still loads, an absent\n * one does not. `null` means not even JSON could represent the value, which is\n * the one case where dropping the write is the only option left.\n *\n * @param codec - The store's codec.\n * @param value - The value to encode.\n * @returns The encoded string, or `null` when the value cannot be represented.\n */\nfunction encode<T>(codec: StorageCodec, value: T): string | null {\n    try {\n        return codec.serialize(value);\n    } catch {\n        try {\n            return JSON.stringify(value);\n        } catch {\n            return null;\n        }\n    }\n}\n\n/**\n * Build a typed `localStorage` wrapper around a codec.\n *\n * One implementation behind every store the SDK ships, so they cannot drift in\n * surface. {@link storage} and {@link compressedStorage} are both this function —\n * before it, the compressed one was a hand-written copy of the same guards and\n * had no `remove`, while its own docstring promised the two were interchangeable\n * at the call site. They were not, and the promise failed exactly where somebody\n * followed it.\n *\n * @example\n * const session = createJsonStorage();\n * session.set(\"draft\", { title: \"Sem título\" });\n *\n * @example\n * const packed = createJsonStorage(compressedStorageCodec);\n *\n * @param codec - Encoder pair. Defaults to plain JSON.\n * @returns A store with `get` / `set` / `getRaw` / `setRaw` / `remove`.\n *\n * @tempest-limits empty-catch — every method is best-effort by contract:\n * `localStorage` throws on quota exhaustion, in Safari private mode, and when a\n * cross-origin frame has storage blocked. A caller persisting a preference has no\n * recovery to run and no user-facing message to show, so the write is dropped and\n * the app keeps the value in memory for the session.\n */\nexport function createJsonStorage(codec: StorageCodec = jsonCodec): JsonStorage {\n    return {\n        get<T>(key: string, fallback: T): T {\n            if (typeof window === \"undefined\") return fallback;\n            try {\n                const raw = window.localStorage.getItem(key);\n                return raw === null ? fallback : codec.deserialize<T>(raw);\n            } catch {\n                return fallback;\n            }\n        },\n\n        set<T>(key: string, value: T): void {\n            if (typeof window === \"undefined\") return;\n            const encoded = encode(codec, value);\n            if (encoded === null) return;\n            try {\n                window.localStorage.setItem(key, encoded);\n            } catch {\n                /* empty */\n            }\n        },\n\n        getRaw(key: string): string | null {\n            if (typeof window === \"undefined\") return null;\n            try {\n                return window.localStorage.getItem(key);\n            } catch {\n                return null;\n            }\n        },\n\n        setRaw(key: string, value: string): void {\n            if (typeof window === \"undefined\") return;\n            try {\n                window.localStorage.setItem(key, value);\n            } catch {\n                /* empty */\n            }\n        },\n\n        remove(key: string): void {\n            if (typeof window === \"undefined\") return;\n            try {\n                window.localStorage.removeItem(key);\n            } catch {\n                /* empty */\n            }\n        },\n    };\n}\n\n/**\n * Typed wrapper around `localStorage` that JSON-encodes values and silently\n * handles environments where storage is unavailable (SSR, private mode).\n *\n * `get`/`set` encode; `getRaw`/`setRaw` do not. Reach for the raw pair when the\n * key is shared with something that does not speak JSON — an existing key in an\n * app adopting this wrapper, a key another library owns, or the theme\n * preference the SDK's own `ThemeProvider` stores as a bare string.\n */\nexport const storage: JsonStorage = createJsonStorage();\n"],"mappings":";AAsEA,IAAM,IAA0B;CAC5B,YAAY,MAAU,KAAK,UAAU,CAAK;CAC1C,cAAc,MAAQ,KAAK,MAAM,CAAG;AACxC;AAcA,SAAS,EAAU,GAAqB,GAAyB;CAC7D,IAAI;EACA,OAAO,EAAM,UAAU,CAAK;CAChC,QAAQ;EACJ,IAAI;GACA,OAAO,KAAK,UAAU,CAAK;EAC/B,QAAQ;GACJ,OAAO;EACX;CACJ;AACJ;AA4BA,SAAgB,EAAkB,IAAsB,GAAwB;CAC5E,OAAO;EACH,IAAO,GAAa,GAAgB;GAChC,IAAI,OAAO,SAAW,KAAa,OAAO;GAC1C,IAAI;IACA,IAAM,IAAM,OAAO,aAAa,QAAQ,CAAG;IAC3C,OAAO,MAAQ,OAAO,IAAW,EAAM,YAAe,CAAG;GAC7D,QAAQ;IACJ,OAAO;GACX;EACJ;EAEA,IAAO,GAAa,GAAgB;GAChC,IAAI,OAAO,SAAW,KAAa;GACnC,IAAM,IAAU,EAAO,GAAO,CAAK;GAC/B,UAAY,MAChB,IAAI;IACA,OAAO,aAAa,QAAQ,GAAK,CAAO;GAC5C,QAAQ,CAER;EACJ;EAEA,OAAO,GAA4B;GAC/B,IAAI,OAAO,SAAW,KAAa,OAAO;GAC1C,IAAI;IACA,OAAO,OAAO,aAAa,QAAQ,CAAG;GAC1C,QAAQ;IACJ,OAAO;GACX;EACJ;EAEA,OAAO,GAAa,GAAqB;GACjC,aAAO,SAAW,MACtB,IAAI;IACA,OAAO,aAAa,QAAQ,GAAK,CAAK;GAC1C,QAAQ,CAER;EACJ;EAEA,OAAO,GAAmB;GAClB,aAAO,SAAW,MACtB,IAAI;IACA,OAAO,aAAa,WAAW,CAAG;GACtC,QAAQ,CAER;EACJ;CACJ;AACJ;AAWA,IAAa,IAAuB,EAAkB"}

package/loader/css-loader-hooks.mjs

@@ -0,0 +1,37 @@
+/**
+ * ESM loader hooks that resolve a stylesheet import to an empty module.
+ *
+ * Runs on the loader thread, which is why it is a separate file from the
+ * `register()` call in `css-loader.mjs`.
+ */
+
+const STYLESHEET = /\.(css|scss|sass|less)$/;
+
+/**
+ * Resolve a stylesheet specifier without asking Node to identify its format.
+ *
+ * @param {string} specifier - The import specifier.
+ * @param {{ parentURL?: string }} context - Resolution context.
+ * @param {Function} next - The next hook in the chain.
+ * @returns {object} The resolution result.
+ */
+export function resolve(specifier, context, next) {
+    if (!STYLESHEET.test(specifier)) return next(specifier, context);
+    const url = context.parentURL
+        ? new URL(specifier, context.parentURL).href
+        : new URL(specifier, "file:///").href;
+    return { url, format: "module", shortCircuit: true };
+}
+
+/**
+ * Load a stylesheet as an empty ES module.
+ *
+ * @param {string} url - The resolved URL.
+ * @param {object} context - Load context.
+ * @param {Function} next - The next hook in the chain.
+ * @returns {object} The load result.
+ */
+export function load(url, context, next) {
+    if (!STYLESHEET.test(new URL(url).pathname)) return next(url, context);
+    return { format: "module", source: "", shortCircuit: true };
+}

package/loader/css-loader.mjs

@@ -0,0 +1,46 @@
+/**
+ * Let Node import this SDK without a bundler.
+ *
+ * Every component module imports its own stylesheet, which is what lets a bundler
+ * ship the CSS of the components an app mounts and drop the rest. Node has no
+ * loader for `.css`, so importing the package in plain Node — a script, a Jest
+ * suite with no stylesheet transform, anything reading the surface for
+ * introspection — fails at import time with:
+ *
+ *     TypeError [ERR_UNKNOWN_FILE_EXTENSION]: Unknown file extension ".css"
+ *
+ * This registers the missing loader, for ESM and CommonJS both, and resolves every
+ * stylesheet to an empty module. Nothing about the styles is emulated: it makes the
+ * import a no-op, which is the correct answer in a context that paints nothing.
+ *
+ * Use it before importing the SDK:
+ *
+ *     node --import tempest-react-sdk/node-css-loader your-script.mjs
+ *
+ * Or from inside a script, before the first import of the package:
+ *
+ *     import "tempest-react-sdk/node-css-loader";
+ *     const sdk = await import("tempest-react-sdk");
+ *
+ * A bundler needs none of this — it is the tool that has the CSS loader. Vitest
+ * handles stylesheets on its own too. This is for plain Node.
+ */
+
+import { createRequire, register } from "node:module";
+
+register("./css-loader-hooks.mjs", import.meta.url);
+
+/**
+ * Teach `require` the same thing, for a CommonJS consumer.
+ *
+ * `register()` covers the ESM graph only; `require("…/Button.css")` would still
+ * reach the CommonJS extension table, which tries to parse the file as JavaScript.
+ */
+const require = createRequire(import.meta.url);
+/** @type {{ _extensions: Record<string, (module: { exports: unknown }, filename: string) => void> }} */
+const Module = require("node:module");
+for (const extension of [".css", ".scss", ".sass", ".less"]) {
+    Module._extensions[extension] = (module) => {
+        module.exports = {};
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tempest-react-sdk",
-  "version": "0.63.0",
+  "version": "0.65.0",
   "description": "SDK público da Tempest com componentes, hooks e integrações para projetos React.",
   "type": "module",
   "license": "MIT",
@@ -24,6 +24,7 @@
   "files": [
     "dist",
     "bin",
+    "loader",
     "template",
     "template-pwa",
     "README.md",
@@ -45,6 +46,7 @@
       "import": "./dist/tempest-react-sdk.js",
       "require": "./dist/tempest-react-sdk.cjs"
     },
+    "./node-css-loader": "./loader/css-loader.mjs",
     "./testing": {
       "types": "./dist/testing.d.ts",
       "import": "./dist/testing.js",