npm - featuredrop - Versions diffs - 1.0.1 → 1.1.0 - Mend

featuredrop 1.0.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/README.md CHANGED Viewed

@@ -1,37 +1,76 @@
-# featuredrop
+<p align="center">
+  <h1 align="center">featuredrop</h1>
+  <p align="center">
+    <strong>"New" badges that actually expire.</strong>
+    <br />
+    Lightweight feature discovery for SaaS sidebars, dashboards, and nav menus.
+  </p>
+</p>
-**Lightweight feature discovery system. Show "New" badges that auto-expire.**
+<p align="center">
+  <a href="https://www.npmjs.com/package/featuredrop"><img src="https://img.shields.io/npm/v/featuredrop?color=f59e0b&label=npm" alt="npm version"></a>
+  <a href="https://bundlephobia.com/package/featuredrop"><img src="https://img.shields.io/bundlephobia/minzip/featuredrop?color=22c55e&label=size" alt="bundle size"></a>
+  <a href="https://github.com/GLINCKER/featuredrop/actions/workflows/ci.yml"><img src="https://github.com/GLINCKER/featuredrop/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://github.com/GLINCKER/featuredrop/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/featuredrop?color=blue" alt="license"></a>
+</p>
-[![npm version](https://img.shields.io/npm/v/featuredrop)](https://www.npmjs.com/package/featuredrop)
-[![license](https://img.shields.io/npm/l/featuredrop)](https://github.com/GLINCKER/featuredrop/blob/main/LICENSE)
-[![bundle size](https://img.shields.io/bundlephobia/minzip/featuredrop)](https://bundlephobia.com/package/featuredrop)
-[![CI](https://github.com/GLINCKER/featuredrop/actions/workflows/ci.yml/badge.svg)](https://github.com/GLINCKER/featuredrop/actions/workflows/ci.yml)
+<p align="center">
+  <a href="#quick-start">Quick Start</a> &bull;
+  <a href="#components">Components</a> &bull;
+  <a href="#react">React</a> &bull;
+  <a href="https://github.com/GLINCKER/featuredrop/blob/main/docs/API.md">API Docs</a> &bull;
+  <a href="https://github.com/GLINCKER/featuredrop/blob/main/docs/ARCHITECTURE.md">Architecture</a>
+</p>
 ---
-## Why featuredrop?
+## The Problem
-Every SaaS needs "New" badges on sidebar items when features ship. But most solutions are either too complex (LaunchDarkly), too coupled (Beamer), or don't actually expire.
+Every SaaS ships features. Users miss them. You need "New" badges on sidebar items, but:
-**featuredrop** solves this with a dead-simple API:
+- **LaunchDarkly / PostHog** — Feature flags, not discovery badges. Overkill.
+- **Beamer / Headway** — External widget, vendor lock-in, $59-299/mo.
+- **Joyride / Shepherd.js** — Product tours, not persistent badges.
+- **DIY** — You build it, forget expiry, badges stay forever. Users stop noticing.
-- Define features in a manifest (just an array of objects)
-- Badges auto-expire based on time windows
-- Users can dismiss individually or "mark all as seen"
-- Works with any framework — React bindings included
-- Zero dependencies, < 2 kB minzipped
+## The Solution
-## Quick Start
+**featuredrop** is a free, self-hosted alternative to Beamer, Headway, and AnnounceKit. Zero deps, < 10 kB, headless-first.
-### Install
+```
+npm install featuredrop          # 0 dependencies, < 2 kB core
+```
-```bash
-npm install featuredrop
-# or
-pnpm add featuredrop
+```
+┌─────────────────────────────────────────┐
+│  ☰  My SaaS App                    🔔  │
+├──────────┬──────────────────────────────┤
+│          │                              │
+│ Dashboard│   Welcome back, Sarah!       │
+│          │                              │
+│ Journal ●│   ┌─────────────────────┐    │
+│          │   │  What's New (2)     │    │
+│ Analytics│   │                     │    │
+│     NEW  │   │  ★ AI Journal       │    │
+│          │   │  Track decisions    │    │
+│ Billing  │   │  with AI insights.  │    │
+│          │   │       [Try it →]    │    │
+│ Settings │   │                     │    │
+│          │   │  ★ Analytics v2     │    │
+│          │   │  Real-time charts   │    │
+│          │   │  and CSV export.    │    │
+│          │   │                     │    │
+│          │   │  [Mark all as read] │    │
+│          │   └─────────────────────┘    │
+│          │                              │
+└──────────┴──────────────────────────────┘
+  ● = dot badge    NEW = pill badge    (2) = count badge
 ```
-### 1. Define your feature manifest
+## Quick Start
+**1. Define features** (just an array of objects):
 ```ts
 import { createManifest } from 'featuredrop'
@@ -40,254 +79,283 @@ export const FEATURES = createManifest([
   {
     id: 'ai-journal',
     label: 'AI Decision Journal',
-    description: 'Track decisions with AI-powered insights',
+    description: 'Track decisions with AI-powered insights.',
     releasedAt: '2026-02-20T00:00:00Z',
     showNewUntil: '2026-03-20T00:00:00Z',
     sidebarKey: '/journal',
-    category: 'ai',
-  },
-  {
-    id: 'analytics-v2',
-    label: 'Analytics Dashboard v2',
-    releasedAt: '2026-02-25T00:00:00Z',
-    showNewUntil: '2026-03-25T00:00:00Z',
-    sidebarKey: '/analytics',
+    type: 'feature',
+    priority: 'critical',
+    cta: { label: 'Try it', url: '/journal' },
   },
 ])
 ```
-### 2. Create a storage adapter
+**2. Create a storage adapter:**
 ```ts
 import { LocalStorageAdapter } from 'featuredrop'
 const storage = new LocalStorageAdapter({
-  // Server-side watermark from user profile (e.g. user.featuresSeenAt)
-  watermark: user.featuresSeenAt,
-  // Optional: callback when user clicks "Mark all as seen"
-  onDismissAll: async (now) => {
-    await api.updateUser({ featuresSeenAt: now.toISOString() })
-  },
+  watermark: user.featuresSeenAt, // from your server
+  onDismissAll: (now) => api.markFeaturesSeen(now), // optional server sync
 })
 ```
-### 3. Check what's new
+**3. Check what's new:**
 ```ts
 import { getNewFeatures, hasNewFeature } from 'featuredrop'
-// Get all new features
 const newFeatures = getNewFeatures(FEATURES, storage)
-console.log(`${newFeatures.length} new features!`)
-// Check a specific sidebar item
-if (hasNewFeature(FEATURES, '/journal', storage)) {
-  showBadge('/journal')
-}
+hasNewFeature(FEATURES, '/journal', storage) // true/false
 ```
-## React Integration
+Works with **any framework**. Zero React dependency for vanilla use.
-```bash
-# React is an optional peer dependency — only needed if you use featuredrop/react
-npm install featuredrop react
-```
+## Components
+Everything you'd expect from Beamer or Headway — but free, self-hosted, and headless-first.
-### Wrap your app with the provider
+### Changelog Widget
+The #1 feature people install these tools for. Trigger button with unread count badge, slide-out panel with rich changelog feed.
 ```tsx
-import { FeatureDropProvider } from 'featuredrop/react'
-import { LocalStorageAdapter } from 'featuredrop'
+import { ChangelogWidget } from 'featuredrop/react'
-const storage = new LocalStorageAdapter({
-  watermark: user.featuresSeenAt,
-  onDismissAll: (now) => api.markFeaturesSeen(now),
-})
+// Default: slide-out panel with all features
+<ChangelogWidget />
-function App() {
-  return (
-    <FeatureDropProvider manifest={FEATURES} storage={storage}>
-      <Sidebar />
-    </FeatureDropProvider>
-  )
-}
+// Or modal / popover variant
+<ChangelogWidget variant="modal" title="Release Notes" />
+// Fully headless
+<ChangelogWidget>
+  {({ isOpen, toggle, features, count, dismissAll }) => (
+    <YourCustomUI />
+  )}
+</ChangelogWidget>
 ```
-### Use hooks in your components
+### Spotlight Beacon
+Pulsing beacon that attaches to any DOM element. Click to see feature tooltip.
 ```tsx
-import { useNewFeature, NewBadge } from 'featuredrop/react'
+import { Spotlight } from 'featuredrop/react'
-function SidebarItem({ path, label }: { path: string; label: string }) {
-  const { isNew, dismiss } = useNewFeature(path)
+const ref = useRef<HTMLButtonElement>(null)
+<button ref={ref}>Analytics</button>
+<Spotlight featureId="analytics-v2" targetRef={ref} />
-  return (
-    <a href={path} onClick={() => isNew && dismiss()}>
-      {label}
-      {isNew && <NewBadge />}
-    </a>
-  )
-}
+// Or with CSS selector
+<Spotlight featureId="analytics-v2" targetSelector="#analytics-btn" />
 ```
-### "What's New" panel
+### Announcement Banner
-```tsx
-import { useFeatureDrop } from 'featuredrop/react'
+Top-of-page or inline banner for major announcements. Auto-expires like badges.
-function WhatsNew() {
-  const { newFeatures, newCount, dismissAll } = useFeatureDrop()
+```tsx
+import { Banner } from 'featuredrop/react'
-  return (
-    <div>
-      <h2>What's New ({newCount})</h2>
-      {newFeatures.map(f => (
-        <div key={f.id}>
-          <h3>{f.label}</h3>
-          <p>{f.description}</p>
-        </div>
-      ))}
-      <button onClick={dismissAll}>Mark all as seen</button>
-    </div>
-  )
-}
+<Banner featureId="v2-launch" variant="announcement" />
+<Banner featureId="breaking-change" variant="warning" />
+<Banner featureId="security-fix" variant="info" position="fixed" />
 ```
-## How It Works
+### Toast Notifications
+Brief popup notifications for new features. Auto-dismiss, stackable, configurable position.
+```tsx
+import { Toast } from 'featuredrop/react'
+<Toast position="bottom-right" maxVisible={3} />
+// Specific features only
+<Toast featureIds={["ai-journal"]} autoDismissMs={5000} />
 ```
-  Feature Manifest (static)     Storage Adapter
-  ┌─────────────────────┐      ┌──────────────────────┐
-  │ id: "ai-journal"    │      │ watermark: server     │
-  │ releasedAt: Feb 20  │      │ dismissed: localStorage│
-  │ showNewUntil: Mar 20│      └──────────┬───────────┘
-  └─────────┬───────────┘                 │
-            │                             │
-            ▼                             ▼
-       ┌─────────────────────────────────────┐
-       │            isNew(feature)            │
-       │                                     │
-       │  1. Not dismissed?          ✓       │
-       │  2. Before showNewUntil?    ✓       │
-       │  3. Released after watermark? ✓     │
-       │                                     │
-       │  → Show "New" badge                 │
-       └─────────────────────────────────────┘
+### NewBadge
+Headless badge component with variants. Zero CSS framework dependency.
+```tsx
+import { NewBadge } from 'featuredrop/react'
+<NewBadge />                          // "New" pill
+<NewBadge variant="dot" />            // Pulsing dot
+<NewBadge variant="count" count={3} /> // Count badge
 ```
-**Three-check algorithm:**
+### Tab Title Notification
-1. **Dismissed?** — Has the user clicked to dismiss this specific feature? (client-side, per-device)
-2. **Expired?** — Is the current time past `showNewUntil`? (automatic, no user action needed)
-3. **After watermark?** — Was the feature released after the user's "features seen at" timestamp? (server-side, cross-device)
+Updates the browser tab title with unread count. Restores when all read.
-This hybrid approach means:
-- New users see all recent features (no watermark = everything is new)
-- Returning users only see features released since their last visit
-- Individual dismissals are instant (localStorage, no server call)
-- "Mark all as seen" syncs across devices (server watermark update)
+```tsx
+import { useTabNotification } from 'featuredrop/react'
-## API Reference
+useTabNotification() // "(3) My App"
+useTabNotification({ template: "[{count} new] {title}", flash: true })
+```
-### Core Functions
+## React
-| Function | Description |
-|----------|-------------|
-| `isNew(feature, watermark, dismissedIds, now?)` | Check if a single feature is "new" |
-| `getNewFeatures(manifest, storage, now?)` | Get all currently new features |
-| `getNewFeatureCount(manifest, storage, now?)` | Get count of new features |
-| `hasNewFeature(manifest, sidebarKey, storage, now?)` | Check if a sidebar key has new features |
+```bash
+npm install featuredrop react    # react is an optional peer dep
+```
-### Helpers
+**Wrap your app:**
-| Function | Description |
-|----------|-------------|
-| `createManifest(entries)` | Create a frozen, typed manifest |
-| `getFeatureById(manifest, id)` | Find a feature by ID |
-| `getNewFeaturesByCategory(manifest, category, storage, now?)` | Filter new features by category |
+```tsx
+import { FeatureDropProvider } from 'featuredrop/react'
-### Adapters
+<FeatureDropProvider manifest={FEATURES} storage={storage}>
+  <App />
+</FeatureDropProvider>
+```
-| Adapter | Description |
-|---------|-------------|
-| `LocalStorageAdapter` | Browser localStorage + server watermark |
-| `MemoryAdapter` | In-memory (testing, SSR) |
+**Add badges to your sidebar:**
-### React (`featuredrop/react`)
+```tsx
+import { useNewFeature, NewBadge } from 'featuredrop/react'
-| Export | Description |
-|--------|-------------|
-| `FeatureDropProvider` | Context provider — wraps your app |
-| `useFeatureDrop()` | Full context: `{ newFeatures, newCount, isNew, dismiss, dismissAll }` |
-| `useNewFeature(key)` | Single item: `{ isNew, feature, dismiss }` |
-| `useNewCount()` | Just the count number |
-| `NewBadge` | Headless badge: `variant="pill" \| "dot" \| "count"` |
-### NewBadge Styling
-Zero CSS framework dependency. Style via CSS custom properties:
-```css
-/* In your global CSS or CSS-in-JS */
-[data-featuredrop] {
-  --featuredrop-color: #b45309;
-  --featuredrop-bg: rgba(245, 158, 11, 0.15);
-  --featuredrop-font-size: 10px;
-  --featuredrop-dot-size: 8px;
-  --featuredrop-glow: rgba(245, 158, 11, 0.6);
-  --featuredrop-count-size: 18px;
-  --featuredrop-count-color: white;
-  --featuredrop-count-bg: #f59e0b;
+function SidebarItem({ path, label }: { path: string; label: string }) {
+  const { isNew, dismiss } = useNewFeature(path)
+  return (
+    <a href={path} onClick={() => isNew && dismiss()}>
+      {label}
+      {isNew && <NewBadge />}
+    </a>
+  )
 }
 ```
-## Custom Storage Adapter
+**Or drop in the full changelog widget:**
-Implement the `StorageAdapter` interface for your persistence layer:
+```tsx
+import { ChangelogWidget } from 'featuredrop/react'
-```ts
-import type { StorageAdapter } from 'featuredrop'
+<ChangelogWidget variant="panel" />
+```
+**Hooks & Components:**
+| Export | What it does |
+|--------|-------------|
+| `useFeatureDrop()` | Full context: features, count, dismiss, dismissAll |
+| `useNewFeature(key)` | Single nav item: `{ isNew, feature, dismiss }` |
+| `useNewCount()` | Just the badge count |
+| `useTabNotification()` | Updates browser tab title with count |
+| `<NewBadge />` | Headless badge: `pill`, `dot`, or `count` variant |
+| `<ChangelogWidget />` | Full changelog feed with trigger button |
+| `<Spotlight />` | Pulsing beacon attached to DOM elements |
+| `<Banner />` | Announcement banner with variants |
+| `<Toast />` | Stackable toast notifications |
+**Analytics integration:**
-class RedisAdapter implements StorageAdapter {
-  getWatermark(): string | null {
-    return this.cache.get('watermark')
-  }
+```tsx
+<FeatureDropProvider
+  manifest={FEATURES}
+  storage={storage}
+  analytics={{
+    onFeatureSeen: (f) => posthog.capture('feature_seen', { id: f.id }),
+    onFeatureDismissed: (f) => posthog.capture('feature_dismissed', { id: f.id }),
+    onFeatureClicked: (f) => posthog.capture('feature_clicked', { id: f.id }),
+    onWidgetOpened: () => posthog.capture('changelog_opened'),
+  }}
+>
+```
-  getDismissedIds(): ReadonlySet<string> {
-    return new Set(this.cache.get('dismissed') ?? [])
-  }
+All components accept an optional `analytics` prop for component-level tracking too.
-  dismiss(id: string): void {
-    this.cache.append('dismissed', id)
-  }
+## How It Works
-  async dismissAll(now: Date): Promise<void> {
-    await this.cache.set('watermark', now.toISOString())
-    await this.cache.delete('dismissed')
-  }
-}
 ```
+  Manifest (static)              Storage (runtime)
+  ┌───────────────────┐         ┌──────────────────────┐
+  │ releasedAt: Feb 20 │         │ watermark ← server   │
+  │ showNewUntil: Mar 20│         │ dismissed ← localStorage│
+  └────────┬──────────┘         └──────────┬───────────┘
+           │                               │
+           └──────────┐  ┌────────────────┘
+                      ▼  ▼
+              ┌───────────────┐
+              │   isNew()     │
+              │               │
+              │ !dismissed    │
+              │ !expired      │
+              │ afterWatermark│
+              │ afterPublishAt│
+              └───────┬───────┘
+                      │
+                 true / false
+```
+New users see everything (no watermark). Returning users only see features shipped since their last visit. Individual dismissals are instant (localStorage). "Mark all seen" syncs across devices (one server write).
+**Scheduled publishing**: Set `publishAt` to hide entries until a specific date — ship code now, reveal later.
+**Priority sorting**: Critical features surface first in widgets and toasts. Priority levels: `critical`, `normal`, `low`.
+**Entry types**: `feature`, `improvement`, `fix`, `breaking` — each with default icon/color in built-in components.
+Read the full [Architecture doc](docs/ARCHITECTURE.md) for cross-device sync flow and custom adapter patterns.
 ## Comparison
-| Feature | featuredrop | LaunchDarkly | Beamer | Joyride |
-|---------|------------|-------------|--------|---------|
-| Auto-expiring badges | Yes | No | No | No |
-| Zero dependencies | Yes | No | No | No |
-| Framework agnostic | Yes | Yes | No | No |
-| React bindings | Yes | Yes | No | Yes |
-| Server watermark | Yes | N/A | Yes | No |
-| Per-feature dismiss | Yes | N/A | No | No |
-| < 2 kB bundle | Yes | No | No | No |
-| TypeScript | Yes | Yes | No | Partial |
-| Free & OSS | Yes | No | Freemium | Yes |
+| | featuredrop | Beamer | Headway | AnnounceKit | Canny |
+|---|:---:|:---:|:---:|:---:|:---:|
+| **Price** | **Free** | $59-399/mo | $49-249/mo | $79-299/mo | $79+ |
+| Auto-expiring badges | Yes | - | - | - | - |
+| Changelog widget | Yes | Yes | Yes | Yes | Yes |
+| Spotlight/beacon | Yes | - | - | - | - |
+| Toast notifications | Yes | - | - | - | - |
+| Announcement banner | Yes | - | - | - | - |
+| Tab title notification | Yes | - | - | - | - |
+| Zero dependencies | Yes | - | - | - | - |
+| Framework agnostic | Yes | - | - | - | - |
+| React bindings | Yes | - | - | - | - |
+| Headless mode | Yes | - | - | - | - |
+| Cross-device sync | Yes | Yes | Yes | Yes | Yes |
+| Per-feature dismiss | Yes | - | - | - | - |
+| Scheduled publishing | Yes | Yes | Yes | Yes | - |
+| Priority levels | Yes | - | - | - | - |
+| Analytics callbacks | Yes | Built-in | Built-in | Built-in | Built-in |
+| < 10 kB minzipped | Yes | - | - | - | - |
+| Self-hosted | Yes | - | - | - | - |
+| Open source | Yes | - | - | - | - |
+## Framework Support
+| Framework | Status | Import |
+|-----------|--------|--------|
+| React / Next.js | Stable | `featuredrop/react` |
+| Vanilla JS | Stable | `featuredrop` |
+| Vue 3 | Planned | `featuredrop/vue` |
+| Svelte 5 | Planned | `featuredrop/svelte` |
+## Documentation
+- [API Reference](docs/API.md) — All functions, adapters, hooks, components
+- [Architecture](docs/ARCHITECTURE.md) — Three-check algorithm, cross-device sync, custom adapters
+- [Next.js Example](examples/nextjs/) — Full App Router integration
+- [Vanilla Example](examples/vanilla/) — Plain HTML, zero build step
+## Contributing
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, commit conventions, and how releases work.
 ## License
-MIT - [Glincker](https://glincker.com)
+MIT &copy; [Glincker](https://glincker.com)
 ---
 <p align="center">
-  <strong>A <a href="https://glincker.com">GLINCKER</a> Open Source Project</strong>
+  <sub>Built and battle-tested at <a href="https://askverdict.ai">AskVerdict</a>.</sub>
+  <br />
+  <strong>A <a href="https://glincker.com">GLINCKER</a> open source project.</strong>
 </p>

package/dist/index.cjs CHANGED Viewed

@@ -4,6 +4,10 @@
 function isNew(feature, watermark, dismissedIds, now = /* @__PURE__ */ new Date()) {
   if (dismissedIds.has(feature.id)) return false;
   const nowMs = now.getTime();
+  if (feature.publishAt) {
+    const publishMs = new Date(feature.publishAt).getTime();
+    if (nowMs < publishMs) return false;
+  }
   const showUntilMs = new Date(feature.showNewUntil).getTime();
   if (nowMs >= showUntilMs) return false;
   if (watermark) {
@@ -28,6 +32,15 @@ function hasNewFeature(manifest, sidebarKey, storage, now = /* @__PURE__ */ new
     (f) => f.sidebarKey === sidebarKey && isNew(f, watermark, dismissedIds, now)
   );
 }
+function getNewFeaturesSorted(manifest, storage, now = /* @__PURE__ */ new Date()) {
+  const priorityOrder = { critical: 0, normal: 1, low: 2 };
+  return getNewFeatures(manifest, storage, now).sort((a, b) => {
+    const pa = priorityOrder[a.priority ?? "normal"];
+    const pb = priorityOrder[b.priority ?? "normal"];
+    if (pa !== pb) return pa - pb;
+    return new Date(b.releasedAt).getTime() - new Date(a.releasedAt).getTime();
+  });
+}
 // src/helpers.ts
 function createManifest(entries) {
@@ -127,6 +140,7 @@ exports.getFeatureById = getFeatureById;
 exports.getNewFeatureCount = getNewFeatureCount;
 exports.getNewFeatures = getNewFeatures;
 exports.getNewFeaturesByCategory = getNewFeaturesByCategory;
+exports.getNewFeaturesSorted = getNewFeaturesSorted;
 exports.hasNewFeature = hasNewFeature;
 exports.isNew = isNew;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/core.ts","../src/helpers.ts","../src/adapters/local-storage.ts","../src/adapters/memory.ts"],"names":[],"mappings":";;;AAUO,SAAS,MACd,OAAA,EACA,SAAA,EACA,cACA,GAAA,mBAAY,IAAI,MAAK,EACZ;AAET,EAAA,IAAI,YAAA,CAAa,GAAA,CAAI,OAAA,CAAQ,EAAE,GAAG,OAAO,KAAA;AAEzC,EAAA,MAAM,KAAA,GAAQ,IAAI,OAAA,EAAQ;AAC1B,EAAA,MAAM,cAAc,IAAI,IAAA,CAAK,OAAA,CAAQ,YAAY,EAAE,OAAA,EAAQ;AAG3D,EAAA,IAAI,KAAA,IAAS,aAAa,OAAO,KAAA;AAGjC,EAAA,IAAI,SAAA,EAAW;AACb,IAAA,MAAM,WAAA,GAAc,IAAI,IAAA,CAAK,SAAS,EAAE,OAAA,EAAQ;AAChD,IAAA,MAAM,aAAa,IAAI,IAAA,CAAK,OAAA,CAAQ,UAAU,EAAE,OAAA,EAAQ;AACxD,IAAA,IAAI,UAAA,IAAc,aAAa,OAAO,KAAA;AAAA,EACxC;AAEA,EAAA,OAAO,IAAA;AACT;AAKO,SAAS,eACd,QAAA,EACA,OAAA,EACA,GAAA,mBAAY,IAAI,MAAK,EACL;AAChB,EAAA,MAAM,SAAA,GAAY,QAAQ,YAAA,EAAa;AACvC,EAAA,MAAM,YAAA,GAAe,QAAQ,eAAA,EAAgB;AAC7C,EAAA,OAAO,QAAA,CAAS,OAAO,CAAC,CAAA,KAAM,MAAM,CAAA,EAAG,SAAA,EAAW,YAAA,EAAc,GAAG,CAAC,CAAA;AACtE;AAKO,SAAS,mBACd,QAAA,EACA,OAAA,EACA,GAAA,mBAAY,IAAI,MAAK,EACb;AACR,EAAA,OAAO,cAAA,CAAe,QAAA,EAAU,OAAA,EAAS,GAAG,CAAA,CAAE,MAAA;AAChD;AAKO,SAAS,cACd,QAAA,EACA,UAAA,EACA,SACA,GAAA,mBAAY,IAAI,MAAK,EACZ;AACT,EAAA,MAAM,SAAA,GAAY,QAAQ,YAAA,EAAa;AACvC,EAAA,MAAM,YAAA,GAAe,QAAQ,eAAA,EAAgB;AAC7C,EAAA,OAAO,QAAA,CAAS,IAAA;AAAA,IACd,CAAC,MAAM,CAAA,CAAE,UAAA,KAAe,cAAc,KAAA,CAAM,CAAA,EAAG,SAAA,EAAW,YAAA,EAAc,GAAG;AAAA,GAC7E;AACF;;;AClEO,SAAS,eACd,OAAA,EACiB;AACjB,EAAA,OAAO,MAAA,CAAO,MAAA,CAAO,CAAC,GAAG,OAAO,CAAC,CAAA;AACnC;AAMO,SAAS,cAAA,CACd,UACA,EAAA,EAC0B;AAC1B,EAAA,OAAO,SAAS,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,OAAO,EAAE,CAAA;AACzC;AAKO,SAAS,yBACd,QAAA,EACA,QAAA,EACA,SACA,GAAA,mBAAY,IAAI,MAAK,EACL;AAChB,EAAA,MAAM,SAAA,GAAY,QAAQ,YAAA,EAAa;AACvC,EAAA,MAAM,YAAA,GAAe,QAAQ,eAAA,EAAgB;AAC7C,EAAA,OAAO,QAAA,CAAS,MAAA;AAAA,IACd,CAAC,MAAM,CAAA,CAAE,QAAA,KAAa,YAAY,KAAA,CAAM,CAAA,EAAG,SAAA,EAAW,YAAA,EAAc,GAAG;AAAA,GACzE;AACF;;;AC3BA,IAAM,gBAAA,GAAmB,YAAA;AAYlB,IAAM,sBAAN,MAAoD;AAAA,EACxC,MAAA;AAAA,EACA,cAAA;AAAA,EACA,oBAAA;AAAA,EACA,YAAA;AAAA,EAEjB,WAAA,CAAY,OAAA,GAAsC,EAAC,EAAG;AACpD,IAAA,IAAA,CAAK,MAAA,GAAS,QAAQ,MAAA,IAAU,aAAA;AAChC,IAAA,IAAA,CAAK,cAAA,GAAiB,QAAQ,SAAA,IAAa,IAAA;AAC3C,IAAA,IAAA,CAAK,uBAAuB,OAAA,CAAQ,YAAA;AACpC,IAAA,IAAA,CAAK,YAAA,GAAe,CAAA,EAAG,IAAA,CAAK,MAAM,GAAG,gBAAgB,CAAA,CAAA;AAAA,EACvD;AAAA,EAEA,YAAA,GAA8B;AAC5B,IAAA,OAAO,IAAA,CAAK,cAAA;AAAA,EACd;AAAA,EAEA,eAAA,GAAuC;AACrC,IAAA,IAAI;AACF,MAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,2BAAW,GAAA,EAAI;AAClD,MAAA,MAAM,GAAA,GAAM,YAAA,CAAa,OAAA,CAAQ,IAAA,CAAK,YAAY,CAAA;AAClD,MAAA,IAAI,CAAC,GAAA,EAAK,uBAAO,IAAI,GAAA,EAAI;AACzB,MAAA,MAAM,MAAA,GAAkB,IAAA,CAAK,KAAA,CAAM,GAAG,CAAA;AACtC,MAAA,IAAI,MAAM,OAAA,CAAQ,MAAM,GAAG,OAAO,IAAI,IAAI,MAAkB,CAAA;AAC5D,MAAA,2BAAW,GAAA,EAAI;AAAA,IACjB,CAAA,CAAA,MAAQ;AACN,MAAA,2BAAW,GAAA,EAAI;AAAA,IACjB;AAAA,EACF;AAAA,EAEA,QAAQ,EAAA,EAAkB;AACxB,IAAA,IAAI;AACF,MAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACnC,MAAA,MAAM,GAAA,GAAM,YAAA,CAAa,OAAA,CAAQ,IAAA,CAAK,YAAY,CAAA;AAClD,MAAA,MAAM,WAAqB,GAAA,GAAO,IAAA,CAAK,KAAA,CAAM,GAAG,IAAiB,EAAC;AAClE,MAAA,IAAI,CAAC,QAAA,CAAS,QAAA,CAAS,EAAE,CAAA,EAAG;AAC1B,QAAA,QAAA,CAAS,KAAK,EAAE,CAAA;AAChB,QAAA,YAAA,CAAa,QAAQ,IAAA,CAAK,YAAA,EAAc,IAAA,CAAK,SAAA,CAAU,QAAQ,CAAC,CAAA;AAAA,MAClE;AAAA,IACF,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AAAA,EAEA,MAAM,WAAW,GAAA,EAA0B;AACzC,IAAA,IAAI;AACF,MAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,QAAA,YAAA,CAAa,UAAA,CAAW,KAAK,YAAY,CAAA;AAAA,MAC3C;AAAA,IACF,CAAA,CAAA,MAAQ;AAAA,IAER;AAEA,IAAA,IAAI,KAAK,oBAAA,EAAsB;AAC7B,MAAA,MAAM,IAAA,CAAK,qBAAqB,GAAG,CAAA;AAAA,IACrC;AAAA,EACF;AACF;;;ACtEO,IAAM,gBAAN,MAA8C;AAAA,EAC3C,SAAA;AAAA,EACA,SAAA;AAAA,EAER,WAAA,CAAY,OAAA,GAAyC,EAAC,EAAG;AACvD,IAAA,IAAA,CAAK,SAAA,GAAY,QAAQ,SAAA,IAAa,IAAA;AACtC,IAAA,IAAA,CAAK,SAAA,uBAAgB,GAAA,EAAI;AAAA,EAC3B;AAAA,EAEA,YAAA,GAA8B;AAC5B,IAAA,OAAO,IAAA,CAAK,SAAA;AAAA,EACd;AAAA,EAEA,eAAA,GAAuC;AACrC,IAAA,OAAO,IAAA,CAAK,SAAA;AAAA,EACd;AAAA,EAEA,QAAQ,EAAA,EAAkB;AACxB,IAAA,IAAA,CAAK,SAAA,CAAU,IAAI,EAAE,CAAA;AAAA,EACvB;AAAA,EAEA,MAAM,WAAW,GAAA,EAA0B;AACzC,IAAA,IAAA,CAAK,SAAA,GAAY,IAAI,WAAA,EAAY;AACjC,IAAA,IAAA,CAAK,UAAU,KAAA,EAAM;AAAA,EACvB;AACF","file":"index.cjs","sourcesContent":["import type { FeatureEntry, FeatureManifest, StorageAdapter } from \"./types\";\n\n/*\n Check if a single feature should show as \"new\".\n \n A feature is \"new\" when ALL of these are true:\n * 1. Current time is before `showNewUntil`\n * 2. Feature was released after the watermark (or no watermark exists)\n * 3. Feature has not been individually dismissed\n /\nexport function isNew(\n feature: FeatureEntry,\n watermark: string \| null,\n dismissedIds: ReadonlySet<string>,\n now: Date = new Date(),\n): boolean {\n // Already dismissed by the user on this device\n if (dismissedIds.has(feature.id)) return false;\n\n const nowMs = now.getTime();\n const showUntilMs = new Date(feature.showNewUntil).getTime();\n\n // Past the display window\n if (nowMs >= showUntilMs) return false;\n\n // If there's a watermark, feature must have been released after it\n if (watermark) {\n const watermarkMs = new Date(watermark).getTime();\n const releasedMs = new Date(feature.releasedAt).getTime();\n if (releasedMs <= watermarkMs) return false;\n }\n\n return true;\n}\n\n/\n Get all features that are currently \"new\" for this user.\n /\nexport function getNewFeatures(\n manifest: FeatureManifest,\n storage: StorageAdapter,\n now: Date = new Date(),\n): FeatureEntry[] {\n const watermark = storage.getWatermark();\n const dismissedIds = storage.getDismissedIds();\n return manifest.filter((f) => isNew(f, watermark, dismissedIds, now));\n}\n\n/\n Get the count of new features.\n /\nexport function getNewFeatureCount(\n manifest: FeatureManifest,\n storage: StorageAdapter,\n now: Date = new Date(),\n): number {\n return getNewFeatures(manifest, storage, now).length;\n}\n\n/\n Check if a specific sidebar key has a new feature.\n /\nexport function hasNewFeature(\n manifest: FeatureManifest,\n sidebarKey: string,\n storage: StorageAdapter,\n now: Date = new Date(),\n): boolean {\n const watermark = storage.getWatermark();\n const dismissedIds = storage.getDismissedIds();\n return manifest.some(\n (f) => f.sidebarKey === sidebarKey && isNew(f, watermark, dismissedIds, now),\n );\n}\n","import type { FeatureEntry, FeatureManifest, StorageAdapter } from \"./types\";\nimport { isNew } from \"./core\";\n\n/\n Create a frozen feature manifest from an array of entries.\n * Ensures the manifest is immutable at runtime.\n /\nexport function createManifest(\n entries: FeatureEntry[],\n): FeatureManifest {\n return Object.freeze([...entries]);\n}\n\n/\n Find a feature by its ID in the manifest.\n * Returns `undefined` if not found.\n /\nexport function getFeatureById(\n manifest: FeatureManifest,\n id: string,\n): FeatureEntry \| undefined {\n return manifest.find((f) => f.id === id);\n}\n\n/\n Get all new features in a specific category.\n /\nexport function getNewFeaturesByCategory(\n manifest: FeatureManifest,\n category: string,\n storage: StorageAdapter,\n now: Date = new Date(),\n): FeatureEntry[] {\n const watermark = storage.getWatermark();\n const dismissedIds = storage.getDismissedIds();\n return manifest.filter(\n (f) => f.category === category && isNew(f, watermark, dismissedIds, now),\n );\n}\n","import type { StorageAdapter } from \"../types\";\n\nexport interface LocalStorageAdapterOptions {\n /* Key prefix for localStorage entries. Default: \"featuredrop\" /\n prefix?: string;\n /* Server-side watermark (ISO string). Typically from user profile. /\n watermark?: string \| null;\n /* Callback when dismissAll is called. Use for server-side watermark updates. /\n onDismissAll?: (now: Date) => Promise<void>;\n}\n\nconst DISMISSED_SUFFIX = \":dismissed\";\n\n/\n localStorage-based storage adapter.\n \n Architecture:\n * - Watermark comes from the server (passed at construction time)\n * - Per-feature dismissals are stored in localStorage (zero server writes)\n * - dismissAll() optionally calls a server callback, then clears localStorage\n \n Gracefully handles SSR environments where `window`/`localStorage` is unavailable.\n /\nexport class LocalStorageAdapter implements StorageAdapter {\n private readonly prefix: string;\n private readonly watermarkValue: string \| null;\n private readonly onDismissAllCallback?: (now: Date) => Promise<void>;\n private readonly dismissedKey: string;\n\n constructor(options: LocalStorageAdapterOptions = {}) {\n this.prefix = options.prefix ?? \"featuredrop\";\n this.watermarkValue = options.watermark ?? null;\n this.onDismissAllCallback = options.onDismissAll;\n this.dismissedKey = `${this.prefix}${DISMISSED_SUFFIX}`;\n }\n\n getWatermark(): string \| null {\n return this.watermarkValue;\n }\n\n getDismissedIds(): ReadonlySet<string> {\n try {\n if (typeof window === \"undefined\") return new Set();\n const raw = localStorage.getItem(this.dismissedKey);\n if (!raw) return new Set();\n const parsed: unknown = JSON.parse(raw);\n if (Array.isArray(parsed)) return new Set(parsed as string[]);\n return new Set();\n } catch {\n return new Set();\n }\n }\n\n dismiss(id: string): void {\n try {\n if (typeof window === \"undefined\") return;\n const raw = localStorage.getItem(this.dismissedKey);\n const existing: string[] = raw ? (JSON.parse(raw) as string[]) : [];\n if (!existing.includes(id)) {\n existing.push(id);\n localStorage.setItem(this.dismissedKey, JSON.stringify(existing));\n }\n } catch {\n // localStorage unavailable — silent fail\n }\n }\n\n async dismissAll(now: Date): Promise<void> {\n try {\n if (typeof window !== \"undefined\") {\n localStorage.removeItem(this.dismissedKey);\n }\n } catch {\n // localStorage unavailable — silent fail\n }\n\n if (this.onDismissAllCallback) {\n await this.onDismissAllCallback(now);\n }\n }\n}\n","import type { StorageAdapter } from \"../types\";\n\n/\n In-memory storage adapter.\n \n Useful for:\n * - Testing (no side effects)\n * - Server-side rendering (no `window`/`localStorage`)\n * - Environments without persistent storage\n */\nexport class MemoryAdapter implements StorageAdapter {\n private watermark: string \| null;\n private dismissed: Set<string>;\n\n constructor(options: { watermark?: string \| null } = {}) {\n this.watermark = options.watermark ?? null;\n this.dismissed = new Set();\n }\n\n getWatermark(): string \| null {\n return this.watermark;\n }\n\n getDismissedIds(): ReadonlySet<string> {\n return this.dismissed;\n }\n\n dismiss(id: string): void {\n this.dismissed.add(id);\n }\n\n async dismissAll(now: Date): Promise<void> {\n this.watermark = now.toISOString();\n this.dismissed.clear();\n }\n}\n"]}
1	+ {"version":3,"sources":["../src/core.ts","../src/helpers.ts","../src/adapters/local-storage.ts","../src/adapters/memory.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { FeatureEntry, FeatureManifest, StorageAdapter } from \"./types\";\n\n/*\n Check if a single feature should show as \"new\".\n \n A feature is \"new\" when ALL of these are true:\n * 1. Current time is before `showNewUntil`\n * 2. Feature was released after the watermark (or no watermark exists)\n * 3. Feature has not been individually dismissed\n * 4. If `publishAt` is set, current time must be after it (scheduled publishing)\n /\nexport function isNew(\n feature: FeatureEntry,\n watermark: string \| null,\n dismissedIds: ReadonlySet<string>,\n now: Date = new Date(),\n): boolean {\n // Already dismissed by the user on this device\n if (dismissedIds.has(feature.id)) return false;\n\n const nowMs = now.getTime();\n\n // Scheduled publishing — hidden until publishAt\n if (feature.publishAt) {\n const publishMs = new Date(feature.publishAt).getTime();\n if (nowMs < publishMs) return false;\n }\n\n const showUntilMs = new Date(feature.showNewUntil).getTime();\n\n // Past the display window\n if (nowMs >= showUntilMs) return false;\n\n // If there's a watermark, feature must have been released after it\n if (watermark) {\n const watermarkMs = new Date(watermark).getTime();\n const releasedMs = new Date(feature.releasedAt).getTime();\n if (releasedMs <= watermarkMs) return false;\n }\n\n return true;\n}\n\n/\n Get all features that are currently \"new\" for this user.\n /\nexport function getNewFeatures(\n manifest: FeatureManifest,\n storage: StorageAdapter,\n now: Date = new Date(),\n): FeatureEntry[] {\n const watermark = storage.getWatermark();\n const dismissedIds = storage.getDismissedIds();\n return manifest.filter((f) => isNew(f, watermark, dismissedIds, now));\n}\n\n/\n Get the count of new features.\n /\nexport function getNewFeatureCount(\n manifest: FeatureManifest,\n storage: StorageAdapter,\n now: Date = new Date(),\n): number {\n return getNewFeatures(manifest, storage, now).length;\n}\n\n/\n Check if a specific sidebar key has a new feature.\n /\nexport function hasNewFeature(\n manifest: FeatureManifest,\n sidebarKey: string,\n storage: StorageAdapter,\n now: Date = new Date(),\n): boolean {\n const watermark = storage.getWatermark();\n const dismissedIds = storage.getDismissedIds();\n return manifest.some(\n (f) => f.sidebarKey === sidebarKey && isNew(f, watermark, dismissedIds, now),\n );\n}\n\n/\n Get all features sorted by priority (critical first) then by release date (newest first).\n /\nexport function getNewFeaturesSorted(\n manifest: FeatureManifest,\n storage: StorageAdapter,\n now: Date = new Date(),\n): FeatureEntry[] {\n const priorityOrder = { critical: 0, normal: 1, low: 2 };\n return getNewFeatures(manifest, storage, now).sort((a, b) => {\n const pa = priorityOrder[a.priority ?? \"normal\"];\n const pb = priorityOrder[b.priority ?? \"normal\"];\n if (pa !== pb) return pa - pb;\n return new Date(b.releasedAt).getTime() - new Date(a.releasedAt).getTime();\n });\n}\n","import type { FeatureEntry, FeatureManifest, StorageAdapter } from \"./types\";\nimport { isNew } from \"./core\";\n\n/\n Create a frozen feature manifest from an array of entries.\n * Ensures the manifest is immutable at runtime.\n /\nexport function createManifest(\n entries: FeatureEntry[],\n): FeatureManifest {\n return Object.freeze([...entries]);\n}\n\n/\n Find a feature by its ID in the manifest.\n * Returns `undefined` if not found.\n /\nexport function getFeatureById(\n manifest: FeatureManifest,\n id: string,\n): FeatureEntry \| undefined {\n return manifest.find((f) => f.id === id);\n}\n\n/\n Get all new features in a specific category.\n /\nexport function getNewFeaturesByCategory(\n manifest: FeatureManifest,\n category: string,\n storage: StorageAdapter,\n now: Date = new Date(),\n): FeatureEntry[] {\n const watermark = storage.getWatermark();\n const dismissedIds = storage.getDismissedIds();\n return manifest.filter(\n (f) => f.category === category && isNew(f, watermark, dismissedIds, now),\n );\n}\n","import type { StorageAdapter } from \"../types\";\n\nexport interface LocalStorageAdapterOptions {\n /* Key prefix for localStorage entries. Default: \"featuredrop\" /\n prefix?: string;\n /* Server-side watermark (ISO string). Typically from user profile. /\n watermark?: string \| null;\n /* Callback when dismissAll is called. Use for server-side watermark updates. /\n onDismissAll?: (now: Date) => Promise<void>;\n}\n\nconst DISMISSED_SUFFIX = \":dismissed\";\n\n/\n localStorage-based storage adapter.\n \n Architecture:\n * - Watermark comes from the server (passed at construction time)\n * - Per-feature dismissals are stored in localStorage (zero server writes)\n * - dismissAll() optionally calls a server callback, then clears localStorage\n \n Gracefully handles SSR environments where `window`/`localStorage` is unavailable.\n /\nexport class LocalStorageAdapter implements StorageAdapter {\n private readonly prefix: string;\n private readonly watermarkValue: string \| null;\n private readonly onDismissAllCallback?: (now: Date) => Promise<void>;\n private readonly dismissedKey: string;\n\n constructor(options: LocalStorageAdapterOptions = {}) {\n this.prefix = options.prefix ?? \"featuredrop\";\n this.watermarkValue = options.watermark ?? null;\n this.onDismissAllCallback = options.onDismissAll;\n this.dismissedKey = `${this.prefix}${DISMISSED_SUFFIX}`;\n }\n\n getWatermark(): string \| null {\n return this.watermarkValue;\n }\n\n getDismissedIds(): ReadonlySet<string> {\n try {\n if (typeof window === \"undefined\") return new Set();\n const raw = localStorage.getItem(this.dismissedKey);\n if (!raw) return new Set();\n const parsed: unknown = JSON.parse(raw);\n if (Array.isArray(parsed)) return new Set(parsed as string[]);\n return new Set();\n } catch {\n return new Set();\n }\n }\n\n dismiss(id: string): void {\n try {\n if (typeof window === \"undefined\") return;\n const raw = localStorage.getItem(this.dismissedKey);\n const existing: string[] = raw ? (JSON.parse(raw) as string[]) : [];\n if (!existing.includes(id)) {\n existing.push(id);\n localStorage.setItem(this.dismissedKey, JSON.stringify(existing));\n }\n } catch {\n // localStorage unavailable — silent fail\n }\n }\n\n async dismissAll(now: Date): Promise<void> {\n try {\n if (typeof window !== \"undefined\") {\n localStorage.removeItem(this.dismissedKey);\n }\n } catch {\n // localStorage unavailable — silent fail\n }\n\n if (this.onDismissAllCallback) {\n await this.onDismissAllCallback(now);\n }\n }\n}\n","import type { StorageAdapter } from \"../types\";\n\n/\n In-memory storage adapter.\n \n Useful for:\n * - Testing (no side effects)\n * - Server-side rendering (no `window`/`localStorage`)\n * - Environments without persistent storage\n */\nexport class MemoryAdapter implements StorageAdapter {\n private watermark: string \| null;\n private dismissed: Set<string>;\n\n constructor(options: { watermark?: string \| null } = {}) {\n this.watermark = options.watermark ?? null;\n this.dismissed = new Set();\n }\n\n getWatermark(): string \| null {\n return this.watermark;\n }\n\n getDismissedIds(): ReadonlySet<string> {\n return this.dismissed;\n }\n\n dismiss(id: string): void {\n this.dismissed.add(id);\n }\n\n async dismissAll(now: Date): Promise<void> {\n this.watermark = now.toISOString();\n this.dismissed.clear();\n }\n}\n"]}