@crawlee/types 4.0.0-beta.118 → 4.0.0-beta.119

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@crawlee/types",
-    "version": "4.0.0-beta.118",
+    "version": "4.0.0-beta.119",
     "description": "Shared types for the crawlee projects",
     "engines": {
         "node": ">=22.0.0"
@@ -52,5 +52,5 @@
             }
         }
     },
-    "gitHead": "7306bd05a126662898a4f2fe7779f6b53425cadf"
+    "gitHead": "552fe2371a3c6e9e9f3514010536ea6abdc27eb4"
 }

package/storages.d.ts

@@ -334,10 +334,12 @@ export interface RequestQueueBackend {
  * Identifies a storage by its ID, name, or alias. At most one may be provided.
  *
  * - `{ id }` — open a pre-existing storage by its unique ID.
- * - `{ name }` — open or create a globally named storage (persists across runs).
+ * - `{ name }` — open or create a globally named storage (persists across runs). The name `default`
+ *   is reserved: it resolves to the default storage, and is emptied on start along with it.
  * - `{ alias }` — open or create a run-scoped unnamed storage identified by this alias.
  *   The alias is used locally (e.g. as a directory name or cache key) but the storage
- *   itself has no persistent name. Use this for non-default unnamed storages.
+ *   itself has no persistent name. Use this for non-default unnamed storages. Like the
+ *   default storage, an aliased one is emptied on start unless `purgeOnStart` is disabled.
  * - `{}` / omitted — open the default storage.
  */
 export type StorageIdentifier = {
@@ -409,6 +411,10 @@ export interface StorageBackend {
      * `StorageBackend` implementations automatically get separate cache partitions.
      */
     getStorageBackendCacheKey?(): string;
+    /**
+     * Empty the run-scoped storages — the default one and every alias-keyed one, including any left
+     * behind by a previous run. Named storages persist across runs, as does the default store's `INPUT`.
+     */
     purge?(): Promise<void>;
     teardown?(): Promise<void>;
     stats?: {