zaileys 3.0.0 → 3.1.0

package/packages/mysql-adapter/dist/index.mjs

@@ -0,0 +1,101 @@
+// src/index.ts
+import { Mutex } from "async-mutex";
+import mysql from "mysql2/promise";
+var MySQLAdapter = class {
+  pool;
+  table;
+  batchInterval;
+  batchSize;
+  writeBuffer = /* @__PURE__ */ new Map();
+  deleteBuffer = /* @__PURE__ */ new Set();
+  mutex = new Mutex();
+  timer = null;
+  constructor(config, options = {}) {
+    this.pool = mysql.createPool({
+      ...config,
+      waitForConnections: true,
+      connectionLimit: 10,
+      queueLimit: 0
+    });
+    this.table = options.table || "zaileys_store";
+    this.batchInterval = options.batchInterval || 1e3;
+    this.batchSize = options.batchSize || 500;
+    this.init();
+  }
+  async init() {
+    await this.pool.execute(`
+      CREATE TABLE IF NOT EXISTS \`${this.table}\` (
+        \`id\` VARCHAR(255) PRIMARY KEY,
+        \`data\` JSON NOT NULL,
+        \`updatedAt\` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+      )
+    `);
+    this.startTimer();
+  }
+  startTimer() {
+    if (this.timer) return;
+    this.timer = setInterval(() => this.flush(), this.batchInterval);
+  }
+  async get(id) {
+    if (this.deleteBuffer.has(id)) return null;
+    if (this.writeBuffer.has(id)) return this.writeBuffer.get(id);
+    const [rows] = await this.pool.execute(
+      `SELECT \`data\` FROM \`${this.table}\` WHERE \`id\` = ?`,
+      [id]
+    );
+    return rows.length ? rows[0].data : null;
+  }
+  async set(id, value) {
+    this.deleteBuffer.delete(id);
+    this.writeBuffer.set(id, value);
+    if (this.writeBuffer.size >= this.batchSize) {
+      await this.flush();
+    }
+  }
+  async del(id) {
+    this.writeBuffer.delete(id);
+    this.deleteBuffer.add(id);
+    if (this.deleteBuffer.size >= this.batchSize) {
+      await this.flush();
+    }
+  }
+  async flush() {
+    if (this.writeBuffer.size === 0 && this.deleteBuffer.size === 0) return;
+    await this.mutex.runExclusive(async () => {
+      const writes = Array.from(this.writeBuffer.entries());
+      const deletes = Array.from(this.deleteBuffer);
+      this.writeBuffer.clear();
+      this.deleteBuffer.clear();
+      try {
+        if (deletes.length > 0) {
+          await this.pool.query(
+            `DELETE FROM \`${this.table}\` WHERE \`id\` IN (?)`,
+            [deletes]
+          );
+        }
+        if (writes.length > 0) {
+          const values = writes.map(([id, data]) => [id, JSON.stringify(data)]);
+          await this.pool.query(
+            `INSERT INTO \`${this.table}\` (\`id\`, \`data\`) VALUES ? 
+             ON DUPLICATE KEY UPDATE \`data\` = VALUES(\`data\`)`,
+            [values]
+          );
+        }
+      } catch (error) {
+        console.error(`[MySQLAdapter] Flush failed:`, error);
+      }
+    });
+  }
+  async close() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    await this.flush();
+    await this.pool.end();
+  }
+};
+export {
+  MySQLAdapter
+};
+//# sourceMappingURL=index.mjs.map

package/packages/mysql-adapter/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { Mutex } from 'async-mutex';\nimport mysql, { Pool } from 'mysql2/promise';\n\n/**\n * Interface definition copied from zaileys/src/Types/store.ts\n * (Since we are in a sibling package, we'll keep it decoupled)\n */\nexport interface IStoreAdapter {\n  get(id: string): Promise<any | null>;\n  set(id: string, value: any): Promise<void>;\n  del(id: string): Promise<void>;\n}\n\nexport interface MySQLAdapterOptions {\n  table?: string;\n  batchInterval?: number;\n  batchSize?: number;\n}\n\nexport class MySQLAdapter implements IStoreAdapter {\n  private pool: Pool;\n  private table: string;\n  private batchInterval: number;\n  private batchSize: number;\n  \n  private writeBuffer = new Map<string, any>();\n  private deleteBuffer = new Set<string>();\n  private mutex = new Mutex();\n  private timer: NodeJS.Timeout | null = null;\n\n  constructor(config: mysql.PoolOptions, options: MySQLAdapterOptions = {}) {\n    this.pool = mysql.createPool({\n      ...config,\n      waitForConnections: true,\n      connectionLimit: 10,\n      queueLimit: 0\n    });\n\n    this.table = options.table || 'zaileys_store';\n    this.batchInterval = options.batchInterval || 1000;\n    this.batchSize = options.batchSize || 500;\n\n    this.init();\n  }\n\n  private async init() {\n    await this.pool.execute(`\n      CREATE TABLE IF NOT EXISTS \\`${this.table}\\` (\n        \\`id\\` VARCHAR(255) PRIMARY KEY,\n        \\`data\\` JSON NOT NULL,\n        \\`updatedAt\\` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP\n      )\n    `);\n    \n    this.startTimer();\n  }\n\n  private startTimer() {\n    if (this.timer) return;\n    this.timer = setInterval(() => this.flush(), this.batchInterval);\n  }\n\n  async get(id: string): Promise<any | null> {\n    // Check buffers first\n    if (this.deleteBuffer.has(id)) return null;\n    if (this.writeBuffer.has(id)) return this.writeBuffer.get(id);\n\n    const [rows]: any = await this.pool.execute(\n      `SELECT \\`data\\` FROM \\`${this.table}\\` WHERE \\`id\\` = ?`,\n      [id]\n    );\n\n    return rows.length ? rows[0].data : null;\n  }\n\n  async set(id: string, value: any): Promise<void> {\n    this.deleteBuffer.delete(id);\n    this.writeBuffer.set(id, value);\n    \n    if (this.writeBuffer.size >= this.batchSize) {\n      await this.flush();\n    }\n  }\n\n  async del(id: string): Promise<void> {\n    this.writeBuffer.delete(id);\n    this.deleteBuffer.add(id);\n\n    if (this.deleteBuffer.size >= this.batchSize) {\n      await this.flush();\n    }\n  }\n\n  async flush(): Promise<void> {\n    if (this.writeBuffer.size === 0 && this.deleteBuffer.size === 0) return;\n\n    await this.mutex.runExclusive(async () => {\n      const writes = Array.from(this.writeBuffer.entries());\n      const deletes = Array.from(this.deleteBuffer);\n\n      // Reset buffers immediately\n      this.writeBuffer.clear();\n      this.deleteBuffer.clear();\n\n      try {\n        // Handle deletions\n        if (deletes.length > 0) {\n          await this.pool.query(\n            `DELETE FROM \\`${this.table}\\` WHERE \\`id\\` IN (?)`,\n            [deletes]\n          );\n        }\n\n        // Handle upserts\n        if (writes.length > 0) {\n          const values = writes.map(([id, data]) => [id, JSON.stringify(data)]);\n          await this.pool.query(\n            `INSERT INTO \\`${this.table}\\` (\\`id\\`, \\`data\\`) VALUES ? \n             ON DUPLICATE KEY UPDATE \\`data\\` = VALUES(\\`data\\`)`,\n            [values]\n          );\n        }\n      } catch (error) {\n        console.error(`[MySQLAdapter] Flush failed:`, error);\n        // Re-buffer on failure? (Optional: based on retry strategy)\n      }\n    });\n  }\n\n  async close() {\n    if (this.timer) {\n      clearInterval(this.timer);\n      this.timer = null;\n    }\n    await this.flush();\n    await this.pool.end();\n  }\n}\n"],"mappings":"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","names":[]}

package/packages/mysql-adapter/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@zaileys/mysql-adapter",
+  "version": "1.0.0",
+  "description": "High-performance MySQL storage adapter for Zaileys",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "keywords": [
+    "baileys",
+    "whatsapp",
+    "mysql",
+    "storage",
+    "zaileys"
+  ],
+  "author": "zaadevofc",
+  "license": "MIT",
+  "dependencies": {
+    "async-mutex": "^0.5.0",
+    "mysql2": "^3.12.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "tsup": "^8.0.2",
+    "typescript": "^5.3.3"
+  },
+  "peerDependencies": {
+    "baileys": "^7.0.0-rc.9"
+  }
+}

package/pnpm-workspace.yaml

@@ -0,0 +1,3 @@
+packages:
+  - '.'
+  - 'packages/*'

package/.agent/skills/codebase-mapper/SKILL.md

@@ -1,226 +0,0 @@
----
-name: GSD Codebase Mapper
-description: Analyzes existing codebases to understand structure, patterns, and technical debt
----
-
-# GSD Codebase Mapper Agent
-
-<role>
-You are a GSD codebase mapper. You analyze existing codebases to produce documentation that enables informed planning.
-
-**Core responsibilities:**
-- Scan and understand project structure
-- Identify patterns and conventions
-- Map dependencies and integrations
-- Surface technical debt
-- Produce ARCHITECTURE.md and STACK.md
-</role>
-
-## Analysis Domains
-
-### 1. Structure Analysis
-Understand how the project is organized:
-- Source directories and their purposes
-- Entry points (main files, index files)
-- Test locations and patterns
-- Configuration locations
-- Asset directories
-
-### 2. Dependency Analysis
-Map what the project depends on:
-- Runtime dependencies (production)
-- Development dependencies
-- Peer dependencies
-- Outdated packages
-- Security vulnerabilities
-
-### 3. Pattern Analysis
-Identify how code is written:
-- Naming conventions
-- File organization patterns
-- Error handling approaches
-- State management patterns
-- API patterns
-
-### 4. Integration Analysis
-Map external connections:
-- APIs consumed
-- Databases used
-- Third-party services
-- Environment dependencies
-
-### 5. Technical Debt Analysis
-Surface issues to address:
-- TODOs and FIXMEs
-- Deprecated code
-- Missing tests
-- Inconsistent patterns
-- Known vulnerabilities
-
----
-
-## Scanning Process
-
-### Phase 1: Project Type Detection
-
-Identify project type from markers:
-```powershell
-# Node.js/JavaScript
-Test-Path "package.json"
-
-# Python
-Test-Path "requirements.txt" -or Test-Path "pyproject.toml"
-
-# Rust
-Test-Path "Cargo.toml"
-
-# Go
-Test-Path "go.mod"
-
-# .NET
-Get-ChildItem "*.csproj"
-```
-
-### Phase 2: Structure Scan
-
-```powershell
-# Get directory structure
-Get-ChildItem -Recurse -Directory | 
-    Where-Object { $_.Name -notmatch "node_modules|\.git|__pycache__|dist|build|\.next" } |
-    Select-Object FullName
-```
-
-### Phase 3: Dependency Extraction
-
-For each ecosystem:
-
-**Node.js:**
-```powershell
-$pkg = Get-Content "package.json" | ConvertFrom-Json
-$pkg.dependencies
-$pkg.devDependencies
-```
-
-**Python:**
-```powershell
-Get-Content "requirements.txt"
-```
-
-### Phase 4: Pattern Discovery
-
-Search for common patterns:
-```powershell
-# Components
-Get-ChildItem -Recurse -Include "*.tsx","*.jsx" | Select-Object Name
-
-# API routes
-Get-ChildItem -Recurse -Path "**/api/**" -Include "*.ts","*.js"
-
-# Models/schemas
-Select-String -Path "**/*.ts" -Pattern "interface|type|schema"
-```
-
-### Phase 5: Debt Discovery
-
-```powershell
-# TODOs
-Select-String -Path "src/**/*" -Pattern "TODO|FIXME|HACK|XXX"
-
-# Deprecated
-Select-String -Path "**/*" -Pattern "@deprecated|DEPRECATED"
-
-# Console statements (often debug leftovers)
-Select-String -Path "src/**/*" -Pattern "console\.(log|debug|warn)"
-```
-
----
-
-## Output Format
-
-### ARCHITECTURE.md
-
-```markdown
-# Architecture
-
-> Generated by /map on {date}
-
-## Overview
-{High-level system description}
-
-## System Diagram
-```
-{ASCII or description of component relationships}
-```
-
-## Components
-
-### {Component Name}
-- **Purpose:** {what it does}
-- **Location:** `{path}`
-- **Dependencies:** {what it imports}
-- **Dependents:** {what imports it}
-
-## Data Flow
-{How data moves through the system}
-
-## Integration Points
-| External Service | Type | Purpose |
-|------------------|------|---------|
-| {service} | {API/DB/etc} | {purpose} |
-
-## Conventions
-- **Naming:** {patterns}
-- **Structure:** {organization}
-- **Testing:** {approach}
-
-## Technical Debt
-- [ ] {Debt item with location}
-```
-
-### STACK.md
-
-```markdown
-# Technology Stack
-
-> Generated by /map on {date}
-
-## Runtime
-| Technology | Version | Purpose |
-|------------|---------|---------|
-| {tech} | {version} | {purpose} |
-
-## Production Dependencies
-| Package | Version | Purpose |
-|---------|---------|---------|
-| {pkg} | {version} | {purpose} |
-
-## Development Dependencies
-| Package | Version | Purpose |
-|---------|---------|---------|
-| {pkg} | {version} | {purpose} |
-
-## Infrastructure
-| Service | Provider | Purpose |
-|---------|----------|---------|
-| {svc} | {provider} | {purpose} |
-
-## Configuration
-| Variable | Purpose | Required |
-|----------|---------|----------|
-| {var} | {purpose} | {yes/no} |
-```
-
----
-
-## Checklist
-
-Before Completing Map:
-- [ ] Project type identified
-- [ ] All source directories documented
-- [ ] Entry points found
-- [ ] Dependencies extracted and categorized
-- [ ] Key patterns identified
-- [ ] Integrations mapped
-- [ ] Technical debt surfaced
-- [ ] ARCHITECTURE.md created
-- [ ] STACK.md created

package/.agent/skills/context-compressor/SKILL.md

@@ -1,201 +0,0 @@
----
-name: Context Compressor
-description: Strategies for compressing context to maximize token efficiency
----
-
-# Context Compressor Skill
-
-<role>
-You are a context compression specialist. Your job is to maintain rich understanding while using minimal tokens.
-
-**Core principle:** Compress aggressively, decompress only when needed.
-</role>
-
----
-
-## Compression Strategies
-
-### Strategy 1: Summary Mode
-
-**When:** You've fully understood a file and may need to reference it later.
-
-**How:**
-```markdown
-## File Summary: src/auth/login.ts
-
-**Purpose:** Handles user login via email/password
-**Key functions:**
-- handleLogin(req, res) → Validates credentials, returns JWT
-- validateCredentials(email, password) → Checks against DB
-**Dependencies:** bcrypt, jose, database
-**Tokens saved:** ~400 (95 lines not reloaded)
-```
-
-**Use instead of:** Re-reading the full file
-
----
-
-### Strategy 2: Outline Mode
-
-**When:** You need to understand a file's structure but not implementation details.
-
-**How:**
-```markdown
-## Outline: src/services/payment.ts (127 lines)
-
-- L1-15: Imports and types
-- L17-35: PaymentService class
-  - L20: constructor(config)
-  - L25: processPayment(amount, method)
-  - L45: refund(transactionId)
-  - L67: getHistory(userId)
-- L90-127: Helper functions
-```
-
-**Tokens:** ~50 vs ~500 for full file
-
----
-
-### Strategy 3: Diff-Only Mode
-
-**When:** You've already seen a file and need to understand changes.
-
-**How:**
-```markdown
-## Changes to: src/config.ts
-
-Added:
-- L45: TOKEN_BUDGET_THRESHOLD = 0.5
-- L46: COMPRESSION_ENABLED = true
-
-Modified:
-- L12: MAX_CONTEXT → increased from 100000 to 150000
-```
-
-**Use for:** Reviewing modifications, understanding updates
-
----
-
-### Strategy 4: Reference Mode
-
-**When:** You need to track a file without loading it.
-
-**How:**
-```markdown
-## References
-
-| File | Last Seen | Summary | Load If |
-|------|-----------|---------|---------|
-| auth.ts | Task 2 | Login handling | Auth bugs |
-| db.ts | Task 1 | Postgres client | DB errors |
-| utils.ts | Never | Utility funcs | Helper needed |
-```
-
-**Cost:** ~10 tokens vs ~200+ per file
-
----
-
-### Strategy 5: Progressive Disclosure
-
-**When:** Unsure how much detail is needed.
-
-**Process:**
-1. Start with outline (Level 1)
-2. If insufficient, load key functions (Level 2)
-3. If still stuck, load related code (Level 3)
-4. Full file only as last resort (Level 4)
-
-```
-L1: Outline → "I see handleLogin at L25"
-L2: Function → "handleLogin validates then calls createToken"
-L3: Related → "createToken uses jose.sign with HS256"
-L4: Full → Only for complex debugging
-```
-
----
-
-## Compression Triggers
-
-### Automatic Compression Points
-
-| Trigger | Action |
-|---------|--------|
-| After understanding a file | Create summary |
-| Switching tasks | Compress previous context |
-| Budget at 50% | Aggressive outline mode |
-| Budget at 70% | Summary-only mode |
-| End of wave | Full compression pass |
-
----
-
-## Decompression Protocol
-
-When you need details from compressed context:
-
-1. **Check summary first** — Often sufficient
-2. **Load specific section** — If summary incomplete
-3. **Full load as last resort** — And re-compress after
-
-```markdown
-## Decompression Log
-
-| File | Reason | Level | Tokens |
-|------|--------|-------|--------|
-| auth.ts | Debug login | L2 (func) | +150 |
-| db.ts | Check query | L3 (snippet) | +50 |
-```
-
----
-
-## Compression Format Templates
-
-### Summary Template
-
-```markdown
-## 📦 [filename]
-**Purpose:** [one line]
-**Key exports:** [list]
-**Dependencies:** [list]
-**Patterns:** [notable patterns used]
-**Watch for:** [gotchas or edge cases]
-```
-
-### Outline Template
-
-```markdown
-## 📋 [filename] (N lines)
-- L[start]-[end]: [section name]
-  - L[n]: [key item]
-  - L[n]: [key item]
-```
-
-### Diff Template
-
-```markdown
-## Δ [filename]
-**+** [additions]
-**-** [removals]
-**~** [modifications]
-```
-
----
-
-## Integration
-
-Works with:
-- `token-budget` — Triggers compression at thresholds
-- `context-fetch` — Provides input for compression
-- `context-health-monitor` — Monitors compression effectiveness
-
----
-
-## Anti-Patterns
-
-❌ **Keeping full files in mental context** — Compress after understanding
-❌ **Re-reading instead of referencing** — Use summaries
-❌ **Loading full file for one function** — Use outline + target
-❌ **Skipping compression "to save time"** — Costs more later
-
----
-
-*Part of GSD v1.6 Token Optimization. See docs/token-optimization-guide.md for examples.*