pinia-plugin-subscription 0.1.3 → 0.1.4-beta.1

package/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.4-beta.0] - 2026-08-16
+
+### Added
+- Added `defineAStoreCtx()` with mandatory setup context argument for improved developer experience.
+- Added `DefineAStoreSetupExtensions` with `enhancedStore` and `extending` extension keys.
+- Added `getEnhancedStore()` and `setEnhancedStore()` helpers for context-based store enhancements.
+
+### Changed
+- `getDefineAStoreSetupContext()` now falls back to store ID lookup during plugin execution timing.
+- Public exports now include `defineAStoreCtx`, `getEnhancedStore`, and `setEnhancedStore`.
+
+### Deprecated
+- `ctx.extensions.extending` is deprecated. Use `ctx.extensions.enhancedStore`.
+- `getExtendingStore()` is deprecated. Use `getEnhancedStore()`.
+
 ## [0.1.3] - 2026-08-15
 
 ### Added

package/README.md

@@ -17,7 +17,7 @@ Ensure Pinia is installed, then register the plugin in your `main.ts`:
 ```typescript
 import { createApp } from 'vue'
 import { createPinia } from 'pinia'
-import { createPlugin } from 'pinia-plugin-subscription'
+import { createPlugin, PLUGIN_NAME as PPS } from 'pinia-plugin-subscription'
 import { myStoreSubscriber } from './src/core/my-store'
 import App from './App.vue'
 
@@ -25,7 +25,7 @@ const app = createApp(App)
 const pinia = createPinia()
 
 // Register plugin (subscribers array, debug mode)
-pinia.use(createPlugin([myStoreSubscriber], true))
+pinia.use(createPlugin([myStoreSubscriber], [PPS]))
 
 app.use(pinia)
 app.mount('#app')
@@ -90,6 +90,28 @@ export const myStoreSubscriber: PluginSubscriberInterface = {
 
 Creates and returns a Pinia plugin from the provided `subscribers`. Each subscriber is invoked when a store is registered.
 
+### `defineAStoreCtx(id, setup, options?)`
+
+Use this helper when your setup callback must always receive a typed `ctx`.
+
+```typescript
+import { defineAStoreCtx, getEnhancedStore } from 'pinia-plugin-subscription'
+
+type EnhancedStore = { addItem: (value: unknown) => void }
+
+export const useMyStore = defineAStoreCtx('myStore', (ctx) => {
+  const enhanced = getEnhancedStore<EnhancedStore>(ctx)
+
+  return {
+    addViaEnhanced: (value: unknown) => enhanced.addItem(value)
+  }
+})
+```
+
+`ctx.extensions` now supports:
+- `enhancedStore` (recommended)
+- `extending` (deprecated alias for backward compatibility)
+
 ### `PluginSubscriberInterface`
 
 An object with at least an `invoke(context: PiniaPluginContext, debug?: boolean)` method, plus optional properties: