feat: add global useState helper

packages/core/src/storages/utils.ts

@@ -1,5 +1,6 @@
-import type { StorageClient } from '@crawlee/types';
+import type { Dictionary, StorageClient } from '@crawlee/types';
 import { Configuration } from '../configuration';
+import { KeyValueStore } from './key_value_store';
 
 /**
  * Cleans up the local storage folder (defaults to `./storage`) created when running code locally.
@@ -22,3 +23,16 @@ export async function purgeDefaultStorages(config = Configuration.getGlobalConfi
         await client.purge?.();
     }
 }
+
+/**
+ * Easily create and manage state values. All state values are automatically persisted.
+ *
+ * Values can be modified by simply using the assignment operator.
+ *
+ * @param name The name of the store to use.
+ * @param defaultValue If the store does not yet have a value in it, the value will be initialized with the `defaultValue` you provide.
+ */
+export async function useState<T extends Dictionary = Dictionary>(name: string, defaultValue = {} as T) {
+    const kvStore = await KeyValueStore.open(null, { config: Configuration.getGlobalConfig() });
+    return kvStore.getAutoSavedValue<T>(name, defaultValue);
+}