@legible-sync/example-eda 1.2.0

package/dist/plugins/products/syncs/product-events.sync.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.productEventSyncs = void 0;
+exports.productEventSyncs = [
+    // When a product is created, publish product.created event
+    {
+        name: "PublishProductCreatedEvent",
+        when: [
+            {
+                concept: "Product",
+                action: "create"
+            }
+        ],
+        then: [
+            {
+                concept: "EventBus",
+                action: "publish",
+                input: {
+                    event: "product.created",
+                    data: {
+                        productId: "?productId",
+                        name: "?product.name",
+                        sku: "?product.sku",
+                        price: "?product.price",
+                        category: "?product.category"
+                    }
+                }
+            }
+        ]
+    },
+    // When a product is updated, publish product.updated event
+    {
+        name: "PublishProductUpdatedEvent",
+        when: [
+            {
+                concept: "Product",
+                action: "update"
+            }
+        ],
+        then: [
+            {
+                concept: "EventBus",
+                action: "publish",
+                input: {
+                    event: "product.updated",
+                    data: {
+                        productId: "?productId",
+                        updates: "?updates"
+                    }
+                }
+            }
+        ]
+    },
+    // When a product is deactivated, publish product.deactivated event
+    {
+        name: "PublishProductDeactivatedEvent",
+        when: [
+            {
+                concept: "Product",
+                action: "deactivate"
+            }
+        ],
+        then: [
+            {
+                concept: "EventBus",
+                action: "publish",
+                input: {
+                    event: "product.deactivated",
+                    data: {
+                        productId: "?productId"
+                    }
+                }
+            }
+        ]
+    }
+];
+//# sourceMappingURL=product-events.sync.js.map

package/dist/plugins/products/syncs/product-events.sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-events.sync.js","sourceRoot":"","sources":["../../../../src/plugins/products/syncs/product-events.sync.ts"],"names":[],"mappings":";;;AAGa,QAAA,iBAAiB,GAAe;IAC3C,2DAA2D;IAC3D;QACE,IAAI,EAAE,4BAA4B;QAClC,IAAI,EAAE;YACJ;gBACE,OAAO,EAAE,SAAS;gBAClB,MAAM,EAAE,QAAQ;aACjB;SACF;QACD,IAAI,EAAE;YACJ;gBACE,OAAO,EAAE,UAAU;gBACnB,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE;oBACL,KAAK,EAAE,iBAAiB;oBACxB,IAAI,EAAE;wBACJ,SAAS,EAAE,YAAY;wBACvB,IAAI,EAAE,eAAe;wBACrB,GAAG,EAAE,cAAc;wBACnB,KAAK,EAAE,gBAAgB;wBACvB,QAAQ,EAAE,mBAAmB;qBAC9B;iBACF;aACF;SACF;KACF;IAED,2DAA2D;IAC3D;QACE,IAAI,EAAE,4BAA4B;QAClC,IAAI,EAAE;YACJ;gBACE,OAAO,EAAE,SAAS;gBAClB,MAAM,EAAE,QAAQ;aACjB;SACF;QACD,IAAI,EAAE;YACJ;gBACE,OAAO,EAAE,UAAU;gBACnB,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE;oBACL,KAAK,EAAE,iBAAiB;oBACxB,IAAI,EAAE;wBACJ,SAAS,EAAE,YAAY;wBACvB,OAAO,EAAE,UAAU;qBACpB;iBACF;aACF;SACF;KACF;IAED,mEAAmE;IACnE;QACE,IAAI,EAAE,gCAAgC;QACtC,IAAI,EAAE;YACJ;gBACE,OAAO,EAAE,SAAS;gBAClB,MAAM,EAAE,YAAY;aACrB;SACF;QACD,IAAI,EAAE;YACJ;gBACE,OAAO,EAAE,UAAU;gBACnB,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE;oBACL,KAAK,EAAE,qBAAqB;oBAC5B,IAAI,EAAE;wBACJ,SAAS,EAAE,YAAY;qBACxB;iBACF;aACF;SACF;KACF;CACF,CAAC"}

package/dist/plugins/users/concepts/User.d.ts

@@ -0,0 +1,3 @@
+import { Concept } from '@legible-sync/core';
+export declare const User: Concept;
+//# sourceMappingURL=User.d.ts.map

package/dist/plugins/users/concepts/User.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"User.d.ts","sourceRoot":"","sources":["../../../../src/plugins/users/concepts/User.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,eAAO,MAAM,IAAI,EAAE,OA4FlB,CAAC"}

package/dist/plugins/users/concepts/User.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.User = void 0;
+const uuid_1 = require("uuid");
+exports.User = {
+    state: {
+        users: new Map(),
+        emails: new Set(),
+        usernames: new Set(),
+    },
+    async execute(action, input) {
+        const state = this.state;
+        switch (action) {
+            case 'register': {
+                const { username, email, password } = input;
+                // Validation
+                if (!username || !email || !password) {
+                    throw new Error('Username, email, and password are required');
+                }
+                if (state.emails.has(email)) {
+                    throw new Error('Email already registered');
+                }
+                if (state.usernames.has(username)) {
+                    throw new Error('Username already taken');
+                }
+                // Create user
+                const userId = (0, uuid_1.v4)();
+                const user = {
+                    id: userId,
+                    username,
+                    email,
+                    createdAt: new Date(),
+                    status: 'active'
+                };
+                state.users.set(userId, user);
+                state.emails.add(email);
+                state.usernames.add(username);
+                return { userId, user };
+            }
+            case 'get': {
+                const { userId } = input;
+                const user = state.users.get(userId);
+                if (!user) {
+                    throw new Error('User not found');
+                }
+                return { user };
+            }
+            case 'update': {
+                const { userId, updates } = input;
+                const user = state.users.get(userId);
+                if (!user) {
+                    throw new Error('User not found');
+                }
+                // Update user
+                const updatedUser = { ...user, ...updates, updatedAt: new Date() };
+                state.users.set(userId, updatedUser);
+                return { user: updatedUser };
+            }
+            case 'deactivate': {
+                const { userId } = input;
+                const user = state.users.get(userId);
+                if (!user) {
+                    throw new Error('User not found');
+                }
+                user.status = 'inactive';
+                user.deactivatedAt = new Date();
+                state.users.set(userId, user);
+                return { user };
+            }
+            case 'reset': {
+                state.users.clear();
+                state.emails.clear();
+                state.usernames.clear();
+                return { reset: true };
+            }
+            default:
+                throw new Error(`Unknown action: ${action}`);
+        }
+    }
+};
+//# sourceMappingURL=User.js.map

package/dist/plugins/users/concepts/User.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"User.js","sourceRoot":"","sources":["../../../../src/plugins/users/concepts/User.ts"],"names":[],"mappings":"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"}

package/dist/plugins/users/index.d.ts

@@ -0,0 +1,3 @@
+import { Plugin } from '../../core/PluginManager';
+export declare const usersPlugin: Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/users/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/users/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAIlD,eAAO,MAAM,WAAW,EAAE,MASzB,CAAC"}

package/dist/plugins/users/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usersPlugin = void 0;
+const User_1 = require("./concepts/User");
+const user_events_sync_1 = require("./syncs/user-events.sync");
+exports.usersPlugin = {
+    name: 'users',
+    concepts: {
+        User: User_1.User
+    },
+    syncs: user_events_sync_1.userEventSyncs,
+    initialize: async (_engine) => {
+        console.log('👤 Users plugin initialized');
+    }
+};
+//# sourceMappingURL=index.js.map

package/dist/plugins/users/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/users/index.ts"],"names":[],"mappings":";;;AAEA,0CAAuC;AACvC,+DAA0D;AAE7C,QAAA,WAAW,GAAW;IACjC,IAAI,EAAE,OAAO;IACb,QAAQ,EAAE;QACR,IAAI,EAAJ,WAAI;KACL;IACD,KAAK,EAAE,iCAAc;IACrB,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC5B,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC7C,CAAC;CACF,CAAC"}

package/dist/plugins/users/syncs/user-events.sync.d.ts

@@ -0,0 +1,3 @@
+import { SyncRule } from '@legible-sync/core';
+export declare const userEventSyncs: SyncRule[];
+//# sourceMappingURL=user-events.sync.d.ts.map

package/dist/plugins/users/syncs/user-events.sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-events.sync.d.ts","sourceRoot":"","sources":["../../../../src/plugins/users/syncs/user-events.sync.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,eAAO,MAAM,cAAc,EAAE,QAAQ,EAwEpC,CAAC"}

package/dist/plugins/users/syncs/user-events.sync.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.userEventSyncs = void 0;
+exports.userEventSyncs = [
+    // When a user registers, publish user.registered event
+    {
+        name: "PublishUserRegisteredEvent",
+        when: [
+            {
+                concept: "User",
+                action: "register"
+            }
+        ],
+        then: [
+            {
+                concept: "EventBus",
+                action: "publish",
+                input: {
+                    event: "user.registered",
+                    data: {
+                        userId: "?userId",
+                        username: "?user.username",
+                        email: "?user.email"
+                    }
+                }
+            }
+        ]
+    },
+    // When a user is updated, publish user.updated event
+    {
+        name: "PublishUserUpdatedEvent",
+        when: [
+            {
+                concept: "User",
+                action: "update"
+            }
+        ],
+        then: [
+            {
+                concept: "EventBus",
+                action: "publish",
+                input: {
+                    event: "user.updated",
+                    data: {
+                        userId: "?userId",
+                        updates: "?updates"
+                    }
+                }
+            }
+        ]
+    },
+    // When a user is deactivated, publish user.deactivated event
+    {
+        name: "PublishUserDeactivatedEvent",
+        when: [
+            {
+                concept: "User",
+                action: "deactivate"
+            }
+        ],
+        then: [
+            {
+                concept: "EventBus",
+                action: "publish",
+                input: {
+                    event: "user.deactivated",
+                    data: {
+                        userId: "?userId"
+                    }
+                }
+            }
+        ]
+    }
+];
+//# sourceMappingURL=user-events.sync.js.map

package/dist/plugins/users/syncs/user-events.sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-events.sync.js","sourceRoot":"","sources":["../../../../src/plugins/users/syncs/user-events.sync.ts"],"names":[],"mappings":";;;AAGa,QAAA,cAAc,GAAe;IACxC,uDAAuD;IACvD;QACE,IAAI,EAAE,4BAA4B;QAClC,IAAI,EAAE;YACJ;gBACE,OAAO,EAAE,MAAM;gBACf,MAAM,EAAE,UAAU;aACnB;SACF;QACD,IAAI,EAAE;YACJ;gBACE,OAAO,EAAE,UAAU;gBACnB,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE;oBACL,KAAK,EAAE,iBAAiB;oBACxB,IAAI,EAAE;wBACJ,MAAM,EAAE,SAAS;wBACjB,QAAQ,EAAE,gBAAgB;wBAC1B,KAAK,EAAE,aAAa;qBACrB;iBACF;aACF;SACF;KACF;IAED,qDAAqD;IACrD;QACE,IAAI,EAAE,yBAAyB;QAC/B,IAAI,EAAE;YACJ;gBACE,OAAO,EAAE,MAAM;gBACf,MAAM,EAAE,QAAQ;aACjB;SACF;QACD,IAAI,EAAE;YACJ;gBACE,OAAO,EAAE,UAAU;gBACnB,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE;oBACL,KAAK,EAAE,cAAc;oBACrB,IAAI,EAAE;wBACJ,MAAM,EAAE,SAAS;wBACjB,OAAO,EAAE,UAAU;qBACpB;iBACF;aACF;SACF;KACF;IAED,6DAA6D;IAC7D;QACE,IAAI,EAAE,6BAA6B;QACnC,IAAI,EAAE;YACJ;gBACE,OAAO,EAAE,MAAM;gBACf,MAAM,EAAE,YAAY;aACrB;SACF;QACD,IAAI,EAAE;YACJ;gBACE,OAAO,EAAE,UAAU;gBACnB,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE;oBACL,KAAK,EAAE,kBAAkB;oBACzB,IAAI,EAAE;wBACJ,MAAM,EAAE,SAAS;qBAClB;iBACF;aACF;SACF;KACF;CACF,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@legible-sync/example-eda",
+  "version": "1.2.0",
+  "description": "Event-Driven Architecture example with plugin-based modules",
+  "main": "dist/index.js",
+  "scripts": {
+    "start": "ts-node src/index.ts",
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/**/*.ts",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
+  },
+  "dependencies": {
+    "@legible-sync/core": "^1.2.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mastepanoski/legiblesync.git",
+    "directory": "packages/example-eda"
+  },
+  "homepage": "https://github.com/mastepanoski/legiblesync",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.0",
+    "ts-node": "^10.9.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "gitHead": "0ac4e896d835d961c7efee0c7295f287d08d92a4"
+}

package/src/core/EventBus.ts

@@ -0,0 +1,55 @@
+// core/EventBus.ts
+
+export interface Event {
+  type: string;
+  payload: Record<string, any>;
+  source: string;
+  timestamp: Date;
+  flowId: string;
+}
+
+export type EventHandler = (event: Event) => Promise<void>;
+
+export class EventBus {
+  private handlers: Map<string, EventHandler[]> = new Map();
+
+  constructor() {
+    // EventBus is independent of the LegibleEngine
+  }
+
+  subscribe(eventType: string, handler: EventHandler): void {
+    if (!this.handlers.has(eventType)) {
+      this.handlers.set(eventType, []);
+    }
+    this.handlers.get(eventType)!.push(handler);
+  }
+
+  async publish(event: Omit<Event, 'timestamp'>): Promise<void> {
+    const fullEvent: Event = {
+      ...event,
+      timestamp: new Date()
+    };
+
+    console.log(`📢 Event: ${fullEvent.type} from ${fullEvent.source}`, fullEvent.payload);
+
+    const handlers = this.handlers.get(event.type) || [];
+    for (const handler of handlers) {
+      try {
+        await handler(fullEvent);
+      } catch (error) {
+        // Handler errors are silently ignored to prevent cascading failures
+      }
+    }
+  }
+
+  // Helper to create events from engine actions
+  createEventFromAction(concept: string, action: string, input: any, output: any, flowId: string): Event {
+    return {
+      type: `${concept}.${action}`,
+      payload: { input, output },
+      source: concept,
+      timestamp: new Date(),
+      flowId
+    };
+  }
+}

package/src/core/PluginManager.ts

@@ -0,0 +1,51 @@
+// core/PluginManager.ts
+import { LegibleEngine, Concept, SyncRule } from '@legible-sync/core';
+
+export interface Plugin {
+  name: string;
+  concepts: Record<string, Concept>;
+  syncs: SyncRule[];
+  initialize?: (engine: LegibleEngine) => Promise<void>;
+}
+
+export class PluginManager {
+  private engine: LegibleEngine;
+  private loadedPlugins: Map<string, Plugin> = new Map();
+
+  constructor(engine: LegibleEngine) {
+    this.engine = engine;
+  }
+
+  async loadPlugin(plugin: Plugin): Promise<void> {
+    console.log(`🔌 Loading plugin: ${plugin.name}`);
+
+    // Register concepts
+    for (const [name, concept] of Object.entries(plugin.concepts)) {
+      this.engine.registerConcept(name, concept);
+      console.log(`  ✓ Registered concept: ${name}`);
+    }
+
+    // Register sync rules
+    for (const sync of plugin.syncs) {
+      this.engine.registerSync(sync);
+      console.log(`  ✓ Registered sync: ${sync.name}`);
+    }
+
+    // Initialize plugin if needed
+    if (plugin.initialize) {
+      await plugin.initialize(this.engine);
+      console.log(`  ✓ Initialized plugin: ${plugin.name}`);
+    }
+
+    this.loadedPlugins.set(plugin.name, plugin);
+    console.log(`✅ Plugin ${plugin.name} loaded successfully\n`);
+  }
+
+  getLoadedPlugins(): string[] {
+    return Array.from(this.loadedPlugins.keys());
+  }
+
+  getPlugin(name: string): Plugin | undefined {
+    return this.loadedPlugins.get(name);
+  }
+}

package/src/index.ts

@@ -0,0 +1,169 @@
+// example-eda/src/index.ts
+import { LegibleEngine } from '@legible-sync/core';
+import { PluginManager } from './core/PluginManager';
+import { EventBus } from './core/EventBus';
+
+// Import all plugins
+import { usersPlugin } from './plugins/users';
+import { productsPlugin } from './plugins/products';
+import { ordersPlugin } from './plugins/orders';
+import { inventoryPlugin } from './plugins/inventory';
+import { notificationsPlugin } from './plugins/notifications';
+import { analyticsPlugin } from './plugins/analytics';
+import { paymentsPlugin } from './plugins/payments';
+
+async function main() {
+  console.log('🚀 Starting Event-Driven Architecture Example\n');
+
+// Initialize core systems
+const engine = new LegibleEngine();
+const pluginManager = new PluginManager(engine);
+const eventBus = new EventBus();
+
+  // Register EventBus as a concept so plugins can publish events
+  engine.registerConcept('EventBus', {
+    state: {},
+    async execute(action: string, input: any) {
+      if (action === 'publish') {
+        const { event, data } = input;
+        await eventBus.publish({
+          type: event,
+          payload: data,
+          source: 'system',
+          flowId: input.flowId || 'system'
+        });
+        return { published: true };
+      }
+      throw new Error(`Unknown EventBus action: ${action}`);
+    }
+  });
+
+  // Load all plugins
+  const plugins = [
+    usersPlugin,
+    productsPlugin,
+    inventoryPlugin,
+    ordersPlugin,
+    paymentsPlugin,
+    notificationsPlugin,
+    analyticsPlugin
+  ];
+
+  for (const plugin of plugins) {
+    await pluginManager.loadPlugin(plugin);
+  }
+
+  console.log('\n✅ All plugins loaded successfully!');
+  console.log('Loaded plugins:', pluginManager.getLoadedPlugins());
+
+  // Demonstrate the EDA system with a complete e-commerce flow
+  console.log('\n🛍️  Demonstrating E-commerce Flow:\n');
+
+  try {
+    // 1. Create a user
+    console.log('1. 👤 Creating user...');
+    const userFlow = 'user-flow-1';
+    const userResult = await engine.invoke('User', 'register', {
+      username: 'johndoe',
+      email: 'john@example.com',
+      password: 'password123'
+    }, userFlow);
+
+    console.log('   User created:', userResult.user.username);
+
+    // 2. Create a product
+    console.log('\n2. 📦 Creating product...');
+    const productFlow = 'product-flow-1';
+    const productResult = await engine.invoke('Product', 'create', {
+      name: 'Wireless Headphones',
+      sku: 'WH-001',
+      price: 99.99,
+      description: 'High-quality wireless headphones',
+      category: 'electronics'
+    }, productFlow);
+
+    console.log('   Product created:', productResult.product.name);
+
+    // 3. Set inventory for the product
+    console.log('\n3. 📊 Setting inventory...');
+    await engine.invoke('Inventory', 'setStock', {
+      productId: productResult.productId,
+      quantity: 10
+    }, 'inventory-flow-1');
+
+    console.log('   Inventory set: 10 units');
+
+    // 4. Create an order
+    console.log('\n4. 🛒 Creating order...');
+    const orderFlow = 'order-flow-1';
+    const orderResult = await engine.invoke('Order', 'create', {
+      userId: userResult.userId,
+      items: [
+        {
+          productId: productResult.productId,
+          quantity: 2,
+          price: productResult.product.price
+        }
+      ]
+    }, orderFlow);
+
+    console.log('   Order created, checking inventory...');
+
+    // The system should automatically:
+    // - Check inventory availability
+    // - Confirm the order if available
+    // - Initiate and process payment
+    // - Deduct inventory
+    // - Send confirmation notification
+    // - Track analytics events
+
+    // Wait a bit for async operations
+    await new Promise(resolve => setTimeout(resolve, 100));
+
+    // 5. Check order status
+    console.log('\n5. 📋 Checking order status...');
+    const orderStatus = await engine.invoke('Order', 'get', {
+      orderId: orderResult.orderId
+    }, 'status-flow-1');
+
+    console.log('   Order status:', orderStatus.order.status);
+    console.log('   Order total: $' + orderStatus.order.total);
+
+    // 6. Check payment status
+    console.log('\n6. 💳 Checking payment status...');
+    const paymentStatus = await engine.invoke('Payment', 'getByOrderId', {
+      orderId: orderResult.orderId
+    }, 'payment-check-flow-1');
+
+    console.log('   Payment status:', paymentStatus.payment.status);
+    console.log('   Payment amount: $' + paymentStatus.payment.amount);
+
+    // 7. Check inventory after order
+    console.log('\n7. 📊 Checking inventory after order...');
+    const inventoryStatus = await engine.invoke('Inventory', 'getStock', {
+      productId: productResult.productId
+    }, 'inventory-check-flow-1');
+
+    console.log('   Remaining stock:', inventoryStatus.quantity, 'units');
+
+    // 8. Check analytics
+    console.log('\n8. 📈 Checking analytics...');
+    const analytics = await engine.invoke('Analytics', 'getMetrics', {}, 'analytics-flow-1');
+    console.log('   Events tracked:', analytics.metrics);
+
+    console.log('\n🎉 E-commerce flow completed successfully!');
+    console.log('The system automatically handled:');
+    console.log('  ✓ Inventory validation');
+    console.log('  ✓ Order confirmation');
+    console.log('  ✓ Payment processing');
+    console.log('  ✓ Stock deduction');
+    console.log('  ✓ Email notifications');
+    console.log('  ✓ Analytics tracking');
+
+  } catch (error) {
+    console.error('❌ Error in demo:', error);
+  }
+}
+
+// Run the demo
+main().catch(console.error);

package/src/plugins/analytics/concepts/Analytics.ts

@@ -0,0 +1,53 @@
+// plugins/analytics/concepts/Analytics.ts
+import { Concept } from '@legible-sync/core';
+
+export const Analytics: Concept = {
+  state: {
+    events: new Map<string, any[]>(),
+    metrics: new Map<string, number>(),
+  },
+
+  async execute(action: string, input: any) {
+    const state = this.state;
+
+    switch (action) {
+      case 'track': {
+        const { event, data } = input;
+
+        if (!state.events.has(event)) {
+          state.events.set(event, []);
+        }
+
+        const eventData = {
+          ...data,
+          timestamp: new Date(),
+          id: `event_${Date.now()}`
+        };
+
+        state.events.get(event)!.push(eventData);
+
+        // Update metrics
+        const count = state.metrics.get(event) || 0;
+        state.metrics.set(event, count + 1);
+
+        console.log(`📊 Tracked: ${event}`, data);
+
+        return { eventId: eventData.id };
+      }
+
+      case 'getMetrics': {
+        const metrics = Object.fromEntries(state.metrics);
+        return { metrics };
+      }
+
+      case 'getEvents': {
+        const { event, limit = 10 } = input;
+        const events = state.events.get(event) || [];
+        return { events: events.slice(-limit) };
+      }
+
+      default:
+        throw new Error(`Unknown action: ${action}`);
+    }
+  }
+};