Skip to main content

@happyvertical/smrt-features

Code-first feature flags for s-m-r-t applications, with global, app-level, and tenant-hierarchy resolution.

Installation​

pnpm add @happyvertical/smrt-features

Quick start​

import {
  FeatureDefinition,
  FeatureResolver,
  FeatureSyncService,
} from '@happyvertical/smrt-features';

// 1. Sync code-defined feature definitions at startup
await FeatureSyncService.syncDefinitions({
  manifest: [
    {
      key: 'commerce.invoice.draft-mode',
      description: 'Allow users to save invoices as drafts before sending',
      defaultEffect: 'enabled',
      allowedScopes: ['global', 'tenant', 'user'],
    },
    // ...
  ],
});

// 2. Resolve at runtime
const enabled = await FeatureResolver.isEnabled('commerce.invoice.draft-mode', {
  tenantId: currentTenantId,
  userId: currentUserId,
});

Resolution​

Features resolve in this priority order:

  1. User override (most specific) — FeatureOverride row with scopeType: 'user' for the active user
  2. Tenant override — FeatureOverride row with scopeType: 'tenant'. Walks the tenant hierarchy if @happyvertical/smrt-users is installed.
  3. Global override — FeatureOverride row with scopeType: 'global'
  4. Code default — registered via FeatureSyncService from the manifest

The first match wins.

Storage​

  • _smrt_feature_definitions — code-owned feature shape (default effect, allowed scopes, metadata)
  • _smrt_feature_overrides — runtime overrides at any scope level

Documentation​