npm - @affectively/aeon-pages - Versions diffs - 1.3.0 - Mend

@affectively/aeon-pages 1.3.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 (124) hide show

package/CHANGELOG.md +112 -0
package/README.md +625 -0
package/examples/basic/aeon.config.ts +39 -0
package/examples/basic/components/Cursor.tsx +86 -0
package/examples/basic/components/OfflineIndicator.tsx +103 -0
package/examples/basic/components/PresenceBar.tsx +77 -0
package/examples/basic/package.json +20 -0
package/examples/basic/pages/index.tsx +80 -0
package/package.json +101 -0
package/packages/analytics/README.md +309 -0
package/packages/analytics/build.ts +35 -0
package/packages/analytics/package.json +50 -0
package/packages/analytics/src/click-tracker.ts +368 -0
package/packages/analytics/src/context-bridge.ts +319 -0
package/packages/analytics/src/data-layer.ts +302 -0
package/packages/analytics/src/gtm-loader.ts +239 -0
package/packages/analytics/src/index.ts +230 -0
package/packages/analytics/src/merkle-tree.ts +489 -0
package/packages/analytics/src/provider.tsx +300 -0
package/packages/analytics/src/types.ts +320 -0
package/packages/analytics/src/use-analytics.ts +296 -0
package/packages/analytics/tsconfig.json +19 -0
package/packages/benchmarks/src/benchmark.test.ts +691 -0
package/packages/cli/dist/index.js +61899 -0
package/packages/cli/package.json +43 -0
package/packages/cli/src/commands/build.test.ts +682 -0
package/packages/cli/src/commands/build.ts +890 -0
package/packages/cli/src/commands/dev.ts +473 -0
package/packages/cli/src/commands/init.ts +409 -0
package/packages/cli/src/commands/start.ts +297 -0
package/packages/cli/src/index.ts +105 -0
package/packages/directives/src/use-aeon.ts +272 -0
package/packages/mcp-server/package.json +51 -0
package/packages/mcp-server/src/index.ts +178 -0
package/packages/mcp-server/src/resources.ts +346 -0
package/packages/mcp-server/src/tools/index.ts +36 -0
package/packages/mcp-server/src/tools/navigation.ts +545 -0
package/packages/mcp-server/tsconfig.json +21 -0
package/packages/react/package.json +40 -0
package/packages/react/src/Link.tsx +388 -0
package/packages/react/src/components/InstallPrompt.tsx +286 -0
package/packages/react/src/components/OfflineDiagnostics.tsx +677 -0
package/packages/react/src/components/PushNotifications.tsx +453 -0
package/packages/react/src/hooks/useAeonNavigation.ts +219 -0
package/packages/react/src/hooks/useConflicts.ts +277 -0
package/packages/react/src/hooks/useNetworkState.ts +209 -0
package/packages/react/src/hooks/usePilotNavigation.ts +254 -0
package/packages/react/src/hooks/useServiceWorker.ts +278 -0
package/packages/react/src/hooks.ts +195 -0
package/packages/react/src/index.ts +151 -0
package/packages/react/src/provider.tsx +467 -0
package/packages/react/tsconfig.json +19 -0
package/packages/runtime/README.md +399 -0
package/packages/runtime/build.ts +48 -0
package/packages/runtime/package.json +71 -0
package/packages/runtime/schema.sql +40 -0
package/packages/runtime/src/api-routes.ts +465 -0
package/packages/runtime/src/benchmark.ts +171 -0
package/packages/runtime/src/cache.ts +479 -0
package/packages/runtime/src/durable-object.ts +1341 -0
package/packages/runtime/src/index.ts +360 -0
package/packages/runtime/src/navigation.test.ts +421 -0
package/packages/runtime/src/navigation.ts +422 -0
package/packages/runtime/src/nextjs-adapter.ts +272 -0
package/packages/runtime/src/offline/encrypted-queue.test.ts +607 -0
package/packages/runtime/src/offline/encrypted-queue.ts +478 -0
package/packages/runtime/src/offline/encryption.test.ts +412 -0
package/packages/runtime/src/offline/encryption.ts +397 -0
package/packages/runtime/src/offline/types.ts +465 -0
package/packages/runtime/src/predictor.ts +371 -0
package/packages/runtime/src/registry.ts +351 -0
package/packages/runtime/src/router/context-extractor.ts +661 -0
package/packages/runtime/src/router/esi-control-react.tsx +2053 -0
package/packages/runtime/src/router/esi-control.ts +541 -0
package/packages/runtime/src/router/esi-cyrano.ts +779 -0
package/packages/runtime/src/router/esi-format-react.tsx +1744 -0
package/packages/runtime/src/router/esi-react.tsx +1065 -0
package/packages/runtime/src/router/esi-translate-observer.ts +476 -0
package/packages/runtime/src/router/esi-translate-react.tsx +556 -0
package/packages/runtime/src/router/esi-translate.ts +503 -0
package/packages/runtime/src/router/esi.ts +666 -0
package/packages/runtime/src/router/heuristic-adapter.test.ts +295 -0
package/packages/runtime/src/router/heuristic-adapter.ts +557 -0
package/packages/runtime/src/router/index.ts +298 -0
package/packages/runtime/src/router/merkle-capability.ts +473 -0
package/packages/runtime/src/router/speculation.ts +451 -0
package/packages/runtime/src/router/types.ts +630 -0
package/packages/runtime/src/router.test.ts +470 -0
package/packages/runtime/src/router.ts +302 -0
package/packages/runtime/src/server.ts +481 -0
package/packages/runtime/src/service-worker-push.ts +319 -0
package/packages/runtime/src/service-worker.ts +553 -0
package/packages/runtime/src/skeleton-hydrate.ts +237 -0
package/packages/runtime/src/speculation.test.ts +389 -0
package/packages/runtime/src/speculation.ts +486 -0
package/packages/runtime/src/storage.test.ts +1297 -0
package/packages/runtime/src/storage.ts +1048 -0
package/packages/runtime/src/sync/conflict-resolver.test.ts +528 -0
package/packages/runtime/src/sync/conflict-resolver.ts +565 -0
package/packages/runtime/src/sync/coordinator.test.ts +608 -0
package/packages/runtime/src/sync/coordinator.ts +596 -0
package/packages/runtime/src/tree-compiler.ts +295 -0
package/packages/runtime/src/types.ts +728 -0
package/packages/runtime/src/worker.ts +327 -0
package/packages/runtime/tsconfig.json +20 -0
package/packages/runtime/wasm/aeon_pages_runtime.d.ts +504 -0
package/packages/runtime/wasm/aeon_pages_runtime.js +1657 -0
package/packages/runtime/wasm/aeon_pages_runtime_bg.wasm +0 -0
package/packages/runtime/wasm/aeon_pages_runtime_bg.wasm.d.ts +196 -0
package/packages/runtime/wasm/package.json +21 -0
package/packages/runtime/wrangler.toml +41 -0
package/packages/runtime-wasm/Cargo.lock +436 -0
package/packages/runtime-wasm/Cargo.toml +29 -0
package/packages/runtime-wasm/pkg/aeon_pages_runtime.d.ts +480 -0
package/packages/runtime-wasm/pkg/aeon_pages_runtime.js +1568 -0
package/packages/runtime-wasm/pkg/aeon_pages_runtime_bg.wasm +0 -0
package/packages/runtime-wasm/pkg/aeon_pages_runtime_bg.wasm.d.ts +192 -0
package/packages/runtime-wasm/pkg/package.json +21 -0
package/packages/runtime-wasm/src/hydrate.rs +352 -0
package/packages/runtime-wasm/src/lib.rs +191 -0
package/packages/runtime-wasm/src/render.rs +629 -0
package/packages/runtime-wasm/src/router.rs +298 -0
package/packages/runtime-wasm/src/skeleton.rs +430 -0
package/rfcs/RFC-001-ZERO-DEPENDENCY-RENDERING.md +1446 -0

package/packages/analytics/README.md ADDED Viewed

@@ -0,0 +1,309 @@
+# @affectively/aeon-pages-analytics
+**Zero-instrumentation analytics.** Automatic click tracking with Merkle tree node IDs and rich ESI context.
+```bash
+bun add @affectively/aeon-pages-analytics
+```
+## What is this?
+Aeon Analytics automatically tracks every click in your application without any manual instrumentation. Each click event includes:
+- **Merkle hash** of the clicked component (content-addressable, stable across renders)
+- **Full tree path** from root to clicked node
+- **Rich ESI context** (user tier, emotion state, features, session info)
+- **Element metadata** (text, aria-label, role, href)
+- **Position data** (viewport and document coordinates)
+Everything flows to GTM dataLayer for GA4 custom events.
+## Quick Start
+### 1. Server-Side: Inject GTM
+```typescript
+// In your HTML template
+const gtmContainerId = env.GTM_CONTAINER_ID;
+const html = `
+<!DOCTYPE html>
+<html>
+<head>
+  <!-- GTM Script -->
+  <script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
+  new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
+  j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
+  'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
+  })(window,document,'script','dataLayer','${gtmContainerId}');</script>
+</head>
+<body>
+  <!-- GTM noscript -->
+  <noscript><iframe src="https://www.googletagmanager.com/ns.html?id=${gtmContainerId}"
+  height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
+  ...
+</body>
+</html>
+`;
+```
+### 2. Client-Side: Initialize Tracking
+```typescript
+import {
+  initClickTracker,
+  initContextBridgeWithRetry,
+  pushPageView,
+  syncESIToDataLayer,
+} from '@affectively/aeon-pages-analytics';
+// Initialize on page load
+initContextBridgeWithRetry({ maxRetries: 3, retryDelayMs: 500 });
+initClickTracker({
+  debounceMs: 100,
+  maxTextLength: 150,
+  excludeSelectors: ['.no-track', '[data-no-track]'],
+  includePosition: true,
+});
+pushPageView();
+// Track SPA navigation
+history.pushState = function(...args) {
+  originalPushState(...args);
+  syncESIToDataLayer();
+  pushPageView();
+};
+```
+### 3. React Provider (Optional)
+```tsx
+import { AeonAnalyticsProvider } from '@affectively/aeon-pages-analytics';
+export default function App({ Component, pageProps }) {
+  return (
+    <AeonAnalyticsProvider
+      gtmContainerId="GTM-XXXXXX"
+      trackClicks={true}
+      syncESIContext={true}
+    >
+      <Component {...pageProps} />
+    </AeonAnalyticsProvider>
+  );
+}
+```
+## Merkle Tree Hashing
+Each component gets a deterministic hash based on its content:
+```typescript
+import { hashNodeSync, buildMerkleTreeSync } from '@affectively/aeon-pages-analytics';
+// Hash = SHA-256(type + sorted_props + child_hashes)
+const hash = hashNodeSync('Button', { onClick: fn }, ['child1hash']);
+// Returns: "a1b2c3d4e5f6" (12-char truncated hash)
+// Build tree from component tree
+const merkleTree = buildMerkleTreeSync(componentTree);
+// Map<nodeId, MerkleNode> with hashes and paths
+```
+### Why Merkle Trees?
+- **Stable IDs** - Same content = same hash, even if DOM order changes
+- **Tree paths** - Full ancestry for every click
+- **Change detection** - Compare trees to find what changed
+- **Cacheable** - Same tree = same hashes
+## DataLayer Events
+### Context Event (on page load)
+```javascript
+{
+  event: 'aeon.context',
+  user: { tier: 'pro', id: 'user_123', sessionId: 'sess_abc' },
+  emotion: { primary: 'focused', valence: 0.3, arousal: 0.6 },
+  features: { aiInference: true, emotionTracking: true },
+  device: { viewport: { width: 1920, height: 1080 }, connection: '4g' },
+  time: { localHour: 14, timezone: 'America/New_York' }
+}
+```
+### Click Event
+```javascript
+{
+  event: 'aeon.click',
+  aeon: { version: '0.1.0', timestamp: 1707321600000 },
+  click: {
+    merkleHash: 'a1b2c3d4e5f6',
+    treePath: ['root', 'layout', 'header', 'nav', 'settings-button'],
+    treePathHashes: ['f1e2d3c4b5a6', 'b2c3d4e5f6a1', ...],
+    element: {
+      tagName: 'BUTTON',
+      text: 'Settings',
+      ariaLabel: 'Open settings menu',
+      role: 'button'
+    },
+    position: { x: 1450, y: 32, viewportX: 1450, viewportY: 32 }
+  },
+  context: {
+    userTier: 'pro',
+    emotionState: { primary: 'focused', valence: 0.3, arousal: 0.6 },
+    sessionId: 'sess_abc'
+  }
+}
+```
+### Page View Event
+```javascript
+{
+  event: 'aeon.pageview',
+  page: {
+    path: '/dashboard',
+    title: 'Dashboard - AFFECTIVELY',
+    merkleRoot: 'abc123def456'
+  },
+  user: { tier: 'pro', sessionId: 'sess_abc' }
+}
+```
+## API Reference
+### Click Tracking
+```typescript
+// Initialize
+initClickTracker(options?: ClickTrackingOptions): void
+// Stop tracking
+stopClickTracker(): void
+// Check status
+isClickTrackerActive(): boolean
+// Manual tracking
+trackClick(element: HTMLElement, event: MouseEvent): void
+trackInteraction(type: string, data: Record<string, unknown>): void
+```
+### Context Bridge
+```typescript
+// ESI state access
+getESIState(): ESIState | null
+hasESIState(): boolean
+getESIProperty<K extends keyof ESIState>(key: K): ESIState[K] | null
+// Sync to dataLayer
+syncESIToDataLayer(): void
+pushPageView(): void
+// Watch for changes
+watchESIChanges(): () => void
+initContextBridge(): void
+initContextBridgeWithRetry(options: { maxRetries: number, retryDelayMs: number }): void
+// Utilities
+isAdmin(): boolean
+hasFeature(feature: string): boolean
+meetsTierRequirement(tier: UserTier): boolean
+getUserTier(): UserTier
+getEmotionState(): EmotionState | null
+```
+### Merkle Tree
+```typescript
+// Sync hashing (uses djb2)
+hashNodeSync(type: string, props: object, childHashes: string[]): string
+buildMerkleTreeSync(tree: ComponentTree): MerkleTree
+// Async hashing (uses SHA-256)
+hashNodeAsync(type: string, props: object, childHashes: string[]): Promise<string>
+buildMerkleTree(tree: ComponentTree): Promise<MerkleTree>
+// DOM helpers
+getMerkleAttributes(node: MerkleNode): Record<string, string>
+parseMerkleFromElement(el: HTMLElement): MerkleNode | null
+findNearestMerkleElement(el: HTMLElement): HTMLElement | null
+// Verification
+verifyMerkleTree(tree: MerkleTree): boolean
+diffMerkleTrees(a: MerkleTree, b: MerkleTree): MerkleDiff
+```
+### GTM Loader
+```typescript
+// Inject GTM
+injectGTM(config: GTMConfig): void
+injectGTMNoScript(containerId: string): void
+initializeGTM(config: GTMConfig): void
+// SSR helpers
+generateGTMScriptTag(containerId: string): string
+generateGTMNoScriptTag(containerId: string): string
+generateDataLayerScript(initialData: object): string
+// Status
+isGTMInjected(): boolean
+isGTMReady(): boolean
+waitForGTM(timeout?: number): Promise<void>
+```
+## Configuration
+```typescript
+interface AnalyticsConfig {
+  // Required: GTM container ID
+  gtmContainerId: string;           // 'GTM-XXXXXX'
+  // Optional: Customize behavior
+  trackClicks?: boolean;            // Default: true
+  trackPageViews?: boolean;         // Default: true
+  syncESIContext?: boolean;         // Default: true
+  // Click tracking options
+  clickOptions?: {
+    debounceMs?: number;            // Default: 0
+    maxTextLength?: number;         // Default: 100
+    excludeSelectors?: string[];    // e.g., ['.no-track']
+    includePosition?: boolean;      // Default: true
+  };
+  // Data layer customization
+  dataLayerName?: string;           // Default: 'dataLayer'
+  eventPrefix?: string;             // Default: 'aeon'
+}
+```
+## ESI State Types
+```typescript
+type UserTier = 'free' | 'starter' | 'pro' | 'enterprise' | 'admin';
+interface ESIState {
+  userTier: UserTier;
+  isAdmin?: boolean;
+  userId?: string;
+  sessionId?: string;
+  isNewSession?: boolean;
+  emotionState?: {
+    primary: string;
+    valence: number;
+    arousal: number;
+  };
+  preferences?: Record<string, unknown>;
+  features?: Record<string, boolean>;
+  recentPages?: string[];
+  viewport?: { width: number; height: number };
+  connection?: string;
+  localHour?: number;
+  timezone?: string;
+}
+```
+## License
+MIT

package/packages/analytics/build.ts ADDED Viewed

@@ -0,0 +1,35 @@
+/**
+ * Build script for @affectively/aeon-pages-analytics
+ */
+import { build } from 'bun';
+async function runBuild() {
+  console.log('Building @affectively/aeon-pages-analytics...');
+  // Build main entry point
+  await build({
+    entrypoints: ['./src/index.ts'],
+    outdir: './dist',
+    format: 'esm',
+    target: 'browser',
+    minify: false,
+    sourcemap: 'external',
+    external: ['react'],
+  });
+  // Build provider separately for /react export
+  await build({
+    entrypoints: ['./src/provider.tsx'],
+    outdir: './dist',
+    format: 'esm',
+    target: 'browser',
+    minify: false,
+    sourcemap: 'external',
+    external: ['react'],
+  });
+  console.log('Build complete!');
+}
+runBuild().catch(console.error);

package/packages/analytics/package.json ADDED Viewed

@@ -0,0 +1,50 @@
+{
+  "name": "@affectively/aeon-pages-analytics",
+  "version": "0.1.0",
+  "description": "Automatic click tracking and GTM integration for @affectively/aeon-pages",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./react": {
+      "import": "./dist/provider.js",
+      "types": "./dist/provider.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "bun run build.ts && tsc --declaration --emitDeclarationOnly",
+    "dev": "bun --watch ./src/index.ts",
+    "test": "bun test",
+    "prepublishOnly": "bun run build"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/affectively/aeon-pages"
+  },
+  "keywords": [
+    "aeon",
+    "pages",
+    "analytics",
+    "gtm",
+    "google-tag-manager",
+    "click-tracking",
+    "merkle-tree"
+  ]
+}