react-native-nitro-storage 0.3.0 → 0.3.2

package/src/internal.ts

@@ -4,6 +4,7 @@ export const MIGRATION_VERSION_KEY = "__nitro_storage_migration_version__";
 export const NATIVE_BATCH_MISSING_SENTINEL =
   "__nitro_storage_batch_missing__::v1";
 const PRIMITIVE_FAST_PATH_PREFIX = "__nitro_storage_primitive__:";
+const NAMESPACE_SEPARATOR = ":";
 
 export type StoredEnvelope = {
   __nitroStorageEnvelope: true;
@@ -41,7 +42,7 @@ export type ScopedBatchItem = {
 
 export function assertBatchScope(
   items: readonly ScopedBatchItem[],
-  scope: StorageScope
+  scope: StorageScope,
 ): void {
   const mismatchedItem = items.find((item) => item.scope !== scope);
   if (!mismatchedItem) {
@@ -53,12 +54,12 @@ export function assertBatchScope(
     StorageScope[mismatchedItem.scope] ?? String(mismatchedItem.scope);
 
   throw new Error(
-    `Batch scope mismatch for "${mismatchedItem.key}": expected ${expectedScope}, received ${actualScope}.`
+    `Batch scope mismatch for "${mismatchedItem.key}": expected ${expectedScope}, received ${actualScope}.`,
   );
 }
 
 export function decodeNativeBatchValue(
-  value: string | undefined
+  value: string | undefined,
 ): string | undefined {
   if (value === NATIVE_BATCH_MISSING_SENTINEL) {
     return undefined;
@@ -67,6 +68,15 @@ export function decodeNativeBatchValue(
   return value;
 }
 
+export function prefixKey(namespace: string | undefined, key: string): string {
+  if (!namespace) return key;
+  return `${namespace}${NAMESPACE_SEPARATOR}${key}`;
+}
+
+export function isNamespaced(key: string, namespace: string): boolean {
+  return key.startsWith(`${namespace}${NAMESPACE_SEPARATOR}`);
+}
+
 export function serializeWithPrimitiveFastPath<T>(value: T): string {
   if (value === null) {
     return `${PRIMITIVE_FAST_PATH_PREFIX}l`;
@@ -91,7 +101,7 @@ export function serializeWithPrimitiveFastPath<T>(value: T): string {
   const serialized = JSON.stringify(value);
   if (serialized === undefined) {
     throw new Error(
-      "Unable to serialize value with default serializer. Provide a custom serialize function."
+      "Unable to serialize value with default serializer. Provide a custom serialize function.",
     );
   }
   return serialized;

package/src/migration.ts

@@ -12,7 +12,7 @@ export type MMKVLike = {
 export function migrateFromMMKV<T>(
   mmkv: MMKVLike,
   item: StorageItem<T>,
-  deleteFromMMKV = false
+  deleteFromMMKV = false,
 ): boolean {
   const key = item.key;
   if (!mmkv.contains(key)) {

package/src/storage-hooks.ts

@@ -0,0 +1,48 @@
+import { useRef, useSyncExternalStore } from "react";
+
+type HookStorageItem<T> = {
+  get: () => T;
+  set: (value: T | ((prev: T) => T)) => void;
+  subscribe: (callback: () => void) => () => void;
+};
+
+export function useStorage<T>(
+  item: HookStorageItem<T>,
+): [T, (value: T | ((prev: T) => T)) => void] {
+  const value = useSyncExternalStore(item.subscribe, item.get, item.get);
+  return [value, item.set];
+}
+
+export function useStorageSelector<T, TSelected>(
+  item: HookStorageItem<T>,
+  selector: (value: T) => TSelected,
+  isEqual: (prev: TSelected, next: TSelected) => boolean = Object.is,
+): [TSelected, (value: T | ((prev: T) => T)) => void] {
+  const selectedRef = useRef<
+    { hasValue: false } | { hasValue: true; value: TSelected }
+  >({
+    hasValue: false,
+  });
+
+  const getSelectedSnapshot = () => {
+    const nextSelected = selector(item.get());
+    const current = selectedRef.current;
+    if (current.hasValue && isEqual(current.value, nextSelected)) {
+      return current.value;
+    }
+
+    selectedRef.current = { hasValue: true, value: nextSelected };
+    return nextSelected;
+  };
+
+  const selectedValue = useSyncExternalStore(
+    item.subscribe,
+    getSelectedSnapshot,
+    getSelectedSnapshot,
+  );
+  return [selectedValue, item.set];
+}
+
+export function useSetStorage<T>(item: HookStorageItem<T>) {
+  return item.set;
+}