Skip to content

Commit d8e9bfb

Browse files
committed
docs(stack-supabase): clarify v2 decrypt path in changeset
v2 read via this adapter is intentionally removed; v2 ciphertext still decrypts through the core @cipherstash/stack client. Mixed-generation handling is customer-side (install both), per #707 out-of-scope stance.
1 parent b04424f commit d8e9bfb

1 file changed

Lines changed: 9 additions & 3 deletions

File tree

.changeset/remove-eql-v2-supabase-authoring.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,9 +23,15 @@ unsuffixed names (part of the EQL v2 removal, #707).
2323
the rest of the `*V3` key-helper types. Each keeps a type-identical
2424
`@deprecated` `*V3` alias.
2525

26-
**Not affected: reading existing data.** Only the v2 *authoring/emission* surface
27-
is removed. Decryption in `@cipherstash/stack` is generation-agnostic, so rows
28-
written as EQL v2 payloads still decrypt through the wrapper's read path.
26+
**Reading existing v2 data.** Only the v2 *authoring/emission* surface is removed
27+
— no v2 ciphertext is stranded. Decryption in `@cipherstash/stack` is
28+
generation-agnostic, so EQL v2 payloads still decrypt through the core client
29+
(`decrypt` / `decryptModel`). This adapter, however, is now EQL v3 only and will
30+
not auto-read an `eql_v2_encrypted` column: to read legacy v2 data during
31+
migration, decrypt fetched rows with `@cipherstash/stack` directly, or run a
32+
v2-configured setup alongside the v3 one and route per column. Mixed-generation
33+
handling is a customer-side concern (install both and handle it explicitly), not
34+
adapter auto-detection.
2935

3036
Internally the v3 query builder (`query-builder-v3.ts`) was folded into the base
3137
`EncryptedQueryBuilderImpl`, which is now natively EQL v3; no runtime behaviour or

0 commit comments

Comments
 (0)