@stravigor/banner 0.4.4 → 0.4.5

package/README.md

@@ -0,0 +1,66 @@
+# @stravigor/banner
+
+Feature flags for the [Strav](https://www.npmjs.com/package/@stravigor/core) framework. Define, scope, and toggle features with database persistence, in-memory drivers, and per-user/team targeting.
+
+## Install
+
+```bash
+bun add @stravigor/banner
+bun strav package:install banner
+```
+
+Requires `@stravigor/core` as a peer dependency.
+
+## Setup
+
+```ts
+import { BannerProvider } from '@stravigor/banner'
+
+app.use(new BannerProvider())
+```
+
+## Usage
+
+```ts
+import { banner } from '@stravigor/banner'
+
+// Check if a feature is active
+if (await banner.active('dark-mode')) {
+  // feature is enabled
+}
+
+// Scoped to a user or team
+if (await banner.for(user).active('beta-dashboard')) {
+  // enabled for this user
+}
+
+// Rich values
+const limit = await banner.value('upload-limit', 10)
+```
+
+## Middleware
+
+```ts
+import { ensureFeature } from '@stravigor/banner'
+
+router.get('/beta', ensureFeature('beta-dashboard'), betaHandler)
+```
+
+## Drivers
+
+- **Database** — persistent feature flags in `_strav_features`
+- **Array** — in-memory driver for testing
+
+## CLI
+
+```bash
+bun strav banner:setup    # Create the features table
+```
+
+## Documentation
+
+See the full [Banner guide](../../guides/banner.md).
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stravigor/banner",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "type": "module",
   "description": "Feature flags for the Strav framework",
   "license": "MIT",
@@ -18,7 +18,7 @@
     "tsconfig.json"
   ],
   "peerDependencies": {
-    "@stravigor/core": "0.4.3"
+    "@stravigor/core": "0.4.4"
   },
   "scripts": {
     "test": "bun test tests/",

package/src/banner_manager.ts

@@ -65,10 +65,7 @@ export default class BannerManager {
 
   /** Get all defined feature names (closures + classes). */
   static defined(): string[] {
-    return [
-      ...BannerManager._definitions.keys(),
-      ...BannerManager._classFeatures.keys(),
-    ]
+    return [...BannerManager._definitions.keys(), ...BannerManager._classFeatures.keys()]
   }
 
   // ── Scope helpers ──────────────────────────────────────────────────
@@ -76,9 +73,7 @@ export default class BannerManager {
   static serializeScope(scope: Scopeable | null | undefined): ScopeKey {
     if (!scope) return GLOBAL_SCOPE
     const type =
-      typeof scope.featureScope === 'function'
-        ? scope.featureScope()
-        : scope.constructor.name
+      typeof scope.featureScope === 'function' ? scope.featureScope() : scope.constructor.name
     return `${type}:${scope.id}`
   }
 
@@ -118,7 +113,7 @@ export default class BannerManager {
   }
 
   static async inactive(feature: string, scope?: Scopeable | null): Promise<boolean> {
-    return !await BannerManager.active(feature, scope)
+    return !(await BannerManager.active(feature, scope))
   }
 
   static async when<TActive, TInactive>(

package/src/commands/banner_commands.ts

@@ -76,11 +76,16 @@ export function register(program: Command): void {
         console.log(chalk.bold(`Stored feature flags (${names.length}):\n`))
         for (const name of names) {
           const records = await BannerManager.store().allFor(name)
-          console.log(`  ${chalk.cyan(name)} ${chalk.dim(`(${records.length} scope${records.length === 1 ? '' : 's'})`)}`)
+          console.log(
+            `  ${chalk.cyan(name)} ${chalk.dim(`(${records.length} scope${records.length === 1 ? '' : 's'})`)}`
+          )
           for (const r of records) {
-            const val = typeof r.value === 'boolean'
-              ? (r.value ? chalk.green('active') : chalk.red('inactive'))
-              : chalk.yellow(JSON.stringify(r.value))
+            const val =
+              typeof r.value === 'boolean'
+                ? r.value
+                  ? chalk.green('active')
+                  : chalk.red('inactive')
+                : chalk.yellow(JSON.stringify(r.value))
             console.log(`    ${chalk.dim(r.scope)} → ${val}`)
           }
         }

package/src/drivers/array_driver.ts

@@ -33,7 +33,9 @@ export class ArrayDriver implements FeatureStore {
     })
   }
 
-  async setMany(entries: Array<{ feature: string; scope: ScopeKey; value: unknown }>): Promise<void> {
+  async setMany(
+    entries: Array<{ feature: string; scope: ScopeKey; value: unknown }>
+  ): Promise<void> {
     for (const e of entries) await this.set(e.feature, e.scope, e.value)
   }
 

package/src/drivers/database_driver.ts

@@ -61,7 +61,9 @@ export class DatabaseDriver implements FeatureStore {
     `
   }
 
-  async setMany(entries: Array<{ feature: string; scope: ScopeKey; value: unknown }>): Promise<void> {
+  async setMany(
+    entries: Array<{ feature: string; scope: ScopeKey; value: unknown }>
+  ): Promise<void> {
     if (entries.length === 0) return
     for (const e of entries) await this.set(e.feature, e.scope, e.value)
   }

package/src/helpers.ts

@@ -1,12 +1,7 @@
 import BannerManager from './banner_manager.ts'
 import PendingScopedFeature from './pending_scope.ts'
 import type { FeatureStore } from './feature_store.ts'
-import type {
-  Scopeable,
-  FeatureResolver,
-  FeatureClassConstructor,
-  DriverConfig,
-} from './types.ts'
+import type { Scopeable, FeatureResolver, FeatureClassConstructor, DriverConfig } from './types.ts'
 
 /**
  * Banner helper — the primary convenience API.

package/src/middleware/ensure_feature.ts

@@ -20,7 +20,7 @@ export function ensureFeature(
   return async (ctx, next) => {
     const scope = scopeExtractor
       ? scopeExtractor(ctx)
-      : (ctx.get('user') as Scopeable | undefined) ?? null
+      : ((ctx.get('user') as Scopeable | undefined) ?? null)
 
     const isActive = await BannerManager.active(feature, scope)