Documentation only: no code, API or dist/ change.

Changed​

• README: the CI badge is gone (releases are built and verified locally; there is no hosted CI), and the Limitations section says the gates run before every release.

Full history: the changelog. Install: yarn add strata-storage@3.1.3.

No JavaScript or API change: dist/ is equivalent to 3.1.1's.

Removed​

• The postinstall script. Installing the package no longer runs anything in your project; the setup steps it printed (including npx cap sync for Capacitor apps) are in the README's Quick Start.

Changed​

• The npx strata-storage CLI moved from scripts/ to bin/. The command is unchanged.
• Android: the fallback compileSdkVersion and targetSdkVersion (used only when your app does not set them) are now 36. Your app's own values still win.
• Build and gates: tsc + tsc-alias replace the custom build script, and yarn gates runs typecheck, lint, build and a Vitest suite against the built dist/ (the storage-ownership predicate and the README version row).

Full history: the changelog. Install: yarn add strata-storage@3.1.2.

Fixed​

• Same-key raw imports preserve the migrated value (ISSUE-14). When keyPrefix: false makes the named raw source and destination the same physical key, importRawSync now keeps the newly written Strata envelope instead of deleting it. Distinct-key imports still remove the source only after the destination write succeeds.

Full history: the changelog. Install: yarn add strata-storage@3.1.1.

Fixed​

• Android: consuming apps on current AGP failed to configure :strata-storage (ISSUE-12). android/build.gradle referenced getDefaultProguardFile('proguard-android.txt'), which current Android Gradle Plugin versions reject at configuration time because it includes -dontoptimize — so the whole app build failed even though the library sets minifyEnabled false. Now uses proguard-android-optimize.txt, like every official Capacitor plugin. No JavaScript or API change.

Full history: the changelog. Install: yarn add strata-storage@3.0.1.

Added​

• importRawSync(rawKey, key, options) — adopt ONE foreign localStorage / sessionStorage entry, named by its exact physical key, into a strata key, deleting the original. The migration path for data written by something other than this library (a pre-strata zustand store, a raw setItem), which the implicit paths deliberately never adopt. The raw string is kept as-is; an existing value at key wins and nothing is moved. Found while moving ZTools' 22 zustand stores onto strata.

Fixed​

• sessionStorage keys were not prefixed (ISSUE-13). 3.0.0 documented both web areas as written under strata:, but SessionStorageAdapter's constructor defaulted its prefix to '', overriding the shared default. It now uses DEFAULT_WEB_KEY_PREFIX; existing bare envelope keys migrate themselves on read.

Full history: the changelog. Install: yarn add strata-storage@3.1.0.

Breaking: the web adapters now prefix their keys with strata:. One line restores the old behaviour, and existing data migrates itself on read — but read the migration notes before upgrading, because a consumer that reads a physical key from outside this library must opt out.

Breaking​

• localStorage and sessionStorage keys are now written under strata:. DEFAULT_WEB_KEY_PREFIX is exported. Before this release the default prefix was the empty string, so this library's keys sat unprefixed among every other script's on the origin. 2.9.0 made that safe — a key is ours only if its value is a StorageValue envelope — and this makes it tidy, so our keys are identifiable by name too.
  • cookies are unchanged: they already defaulted to strata_, and moving them would break existing cookies for no gain.
  • indexedDB and cache own a named store, memory owns its own Map, and the URL adapter already prefixes its params. None of them can collide with another script's keys, so none of them change.
  • namespace is a separate mechanism and is unaffected. The physical key is <keyPrefix><namespace>:<key>.

Added​

• keyPrefix — set false (or '') for the pre-3.0 behaviour, or a string for your own prefix. A per-adapter adapters.localStorage.prefix still wins over it.
• migrateLegacyKeys (default true) — adopt pre-3.0 unprefixed entries on read.

Migration​

Most consumers need to do nothing. On a miss at strata:<key>, the adapter looks for the bare <key> and, if the value is one of ours, moves it under the prefix and returns it. Your data stays reachable.

Three properties of that migration, each verified in a browser:

• It is per key, on read — never a bulk sweep. A sweep would adopt every unprefixed envelope on the origin, including keys belonging to an instance that opted out or to a sibling app still on 2.x.
• It never adopts a value that is not ours — the 2.9.0 envelope check is what makes it safe at all. A planted _cltk is left exactly where it is.
• It never overwrites. A value already at the prefixed key wins and the legacy entry is left alone.

🔴 Take keyPrefix: false if anything outside this library reads a physical key directly — a pre-paint theme script that runs before any module loads, or a logger reading its own level. Those readers know the exact key name, and a prefix changes it underneath them. Migration keeps the data reachable through this library; it cannot fix a hard-coded reader.

// Frozen physical key names, or an external reader — keep 2.x behaviour:
export const storage = defineStorage({ keyPrefix: false });

🔴 Two applications sharing one origin, one still on 2.x: set migrateLegacyKeys: false on the upgraded one, so it does not move keys the other still reads. Better, give each app a namespace — they were already colliding before this release.

Fixed​

• A live timer no longer keeps a Node process alive. setInterval holds the event loop open, so a short-lived script — a build step, a CLI, an SSR warmup — that created an instance never exited unless it also called close(). Measured: a script doing one set/get hung until killed at 120s, and now exits immediately. All three timers (adapter TTL, cross-adapter cleanup, auto-backup) are unref'd; it is a no-op in browsers.

Full history: the changelog. Install: yarn add strata-storage@3.0.0.