@demokit-ai/core 0.2.0 → 0.3.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@demokit-ai/core",
-  "version": "0.2.0",
-  "description": "Framework-agnostic demo mode SDK with fetch interception",
+  "version": "0.3.0",
+  "description": "Framework-agnostic demo mode SDK with fetch interception and fixture generation",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -21,30 +21,49 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "test": "vitest",
-    "typecheck": "tsc --noEmit"
+  "dependencies": {
+    "@scalar/openapi-parser": "^0.10.0",
+    "@scalar/openapi-types": "^0.2.0",
+    "zod": "^3.24.0"
   },
   "devDependencies": {
+    "@types/node": "^22.10.2",
+    "@vitest/coverage-v8": "^2.1.9",
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
-    "vitest": "^2.1.8"
+    "vitest": "^2.1.9"
   },
-  "keywords": [
-    "demo",
-    "mock",
-    "api",
-    "fetch",
-    "interceptor",
-    "saas"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/your-org/demokit",
-    "directory": "packages/core"
+  "peerDependencies": {
+    "@ai-sdk/anthropic": ">=1.0.0",
+    "@mastra/core": ">=1.0.0-beta.0",
+    "@mastra/langfuse": ">=0.2.0",
+    "@supabase/supabase-js": ">=2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/anthropic": {
+      "optional": true
+    },
+    "@mastra/core": {
+      "optional": true
+    },
+    "@mastra/langfuse": {
+      "optional": true
+    },
+    "@supabase/supabase-js": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18"
   },
-  "sideEffects": false
-}
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch --no-dts",
+    "test": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}

package/README.md

@@ -1,190 +0,0 @@
-# @demokit-ai/core
-
-![Tests](https://img.shields.io/badge/tests-154%20passing-brightgreen)
-![Coverage](https://img.shields.io/badge/coverage-36%25-red)
-
-Framework-agnostic demo mode SDK with fetch interception. The foundation for all DemoKit adapters.
-
-## Installation
-
-```bash
-npm install @demokit-ai/core
-```
-
-## Features
-
-- **Fetch Interception** - Intercept and mock API calls at the network level
-- **Session Management** - Manage demo mode state with storage adapters
-- **State Machine** - Declarative demo state management
-- **Scenario Support** - Define and switch between demo scenarios
-- **Framework Agnostic** - Works with any JavaScript framework
-- Full TypeScript support
-
-## Usage
-
-### Basic Fetch Interception
-
-```ts
-import { createDemoInterceptor, enableDemoMode } from '@demokit-ai/core'
-
-const interceptor = createDemoInterceptor({
-  fixtures: {
-    '/api/users': [
-      { id: '1', name: 'Demo User' },
-      { id: '2', name: 'Another User' },
-    ],
-    '/api/users/:id': (req) => ({
-      id: req.params.id,
-      name: 'Demo User',
-      email: 'demo@example.com',
-    }),
-  },
-})
-
-// Enable demo mode
-enableDemoMode()
-
-// All fetch calls to matched routes will return fixtures
-const response = await fetch('/api/users')
-const users = await response.json()
-// [{ id: '1', name: 'Demo User' }, ...]
-```
-
-### Session Management
-
-```ts
-import { createDemoSession, DemoSession } from '@demokit-ai/core'
-
-const session = createDemoSession({
-  storage: 'localStorage', // or 'sessionStorage', 'memory', custom adapter
-  key: 'demo-mode',
-})
-
-// Check if demo mode is active
-if (session.isActive()) {
-  console.log('Demo mode is enabled')
-}
-
-// Toggle demo mode
-session.toggle()
-
-// Set with expiry
-session.enable({ expiresIn: 3600000 }) // 1 hour
-```
-
-### State Management
-
-```ts
-import { createDemoState } from '@demokit-ai/core'
-
-const state = createDemoState({
-  initial: {
-    user: null,
-    features: ['basic'],
-  },
-  scenarios: {
-    free: { user: { plan: 'free' }, features: ['basic'] },
-    pro: { user: { plan: 'pro' }, features: ['basic', 'advanced'] },
-    enterprise: { user: { plan: 'enterprise' }, features: ['basic', 'advanced', 'enterprise'] },
-  },
-})
-
-// Switch scenarios
-state.setScenario('pro')
-
-// Get current state
-const { user, features } = state.get()
-
-// Subscribe to changes
-state.subscribe((newState) => {
-  console.log('Demo state changed:', newState)
-})
-```
-
-### URL-based Activation
-
-```ts
-import { createUrlActivator } from '@demokit-ai/core'
-
-const activator = createUrlActivator({
-  param: 'demo', // ?demo=true or ?demo=enterprise
-  scenarios: {
-    true: 'default',
-    enterprise: 'enterprise',
-  },
-})
-
-// Check URL and activate if param present
-activator.check(window.location.href)
-```
-
-### Custom Storage Adapter
-
-```ts
-import { createDemoSession, StorageAdapter } from '@demokit-ai/core'
-
-const customStorage: StorageAdapter = {
-  get: (key) => myDatabase.get(key),
-  set: (key, value) => myDatabase.set(key, value),
-  remove: (key) => myDatabase.delete(key),
-}
-
-const session = createDemoSession({
-  storage: customStorage,
-})
-```
-
-## API Reference
-
-### Interceptor
-
-#### `createDemoInterceptor(options)`
-
-Creates a fetch interceptor for demo mode.
-
-Options:
-- `fixtures` - Route fixtures (static or function)
-- `delay` - Simulated network delay in ms
-- `onIntercept` - Callback when a request is intercepted
-- `shouldIntercept` - Custom function to determine if request should be intercepted
-
-### Session
-
-#### `createDemoSession(options)`
-
-Creates a demo session manager.
-
-Options:
-- `storage` - Storage adapter ('localStorage', 'sessionStorage', 'memory', or custom)
-- `key` - Storage key name
-- `defaultScenario` - Default scenario name
-
-Returns:
-- `isActive()` - Check if demo mode is enabled
-- `enable(options?)` - Enable demo mode
-- `disable()` - Disable demo mode
-- `toggle()` - Toggle demo mode
-- `getScenario()` - Get current scenario
-- `setScenario(name)` - Set scenario
-
-### State
-
-#### `createDemoState(options)`
-
-Creates a demo state manager.
-
-Options:
-- `initial` - Initial state object
-- `scenarios` - Named scenario configurations
-- `onChange` - Callback when state changes
-
-Returns:
-- `get()` - Get current state
-- `set(state)` - Set state
-- `setScenario(name)` - Switch to named scenario
-- `subscribe(callback)` - Subscribe to state changes
-- `reset()` - Reset to initial state
-
-## License
-
-MIT