nicefox-graphdb 0.1.0

package/packages/nicefox-graphdb/README.md

@@ -0,0 +1,417 @@
+# NiceFox GraphDB
+
+[![npm version](https://img.shields.io/npm/v/nicefox-graphdb.svg)](https://www.npmjs.com/package/nicefox-graphdb)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A lightweight graph database with Cypher query support, powered by SQLite.
+
+## Installation
+
+```bash
+npm install nicefox-graphdb
+```
+
+## Quick Start
+
+```typescript
+import { GraphDB } from 'nicefox-graphdb';
+
+const db = await GraphDB({
+  url: 'https://my-graphdb.example.com',
+  project: 'myapp',
+  apiKey: process.env.GRAPHDB_API_KEY,
+});
+
+// Create nodes and relationships
+await db.execute(`
+  CREATE (alice:User {name: 'Alice'})-[:FOLLOWS]->(bob:User {name: 'Bob'})
+`);
+
+// Query the graph
+const users = await db.query('MATCH (u:User) RETURN u.name AS name');
+console.log(users); // [{ name: 'Alice' }, { name: 'Bob' }]
+
+db.close();
+```
+
+## Development vs Production Mode
+
+NiceFox GraphDB automatically adapts based on the `NODE_ENV` environment variable:
+
+| Mode | `NODE_ENV` | Behavior |
+|------|-----------|----------|
+| **Development** | `development` | Uses local SQLite database. `url` and `apiKey` are ignored. |
+| **Production** | `production` (or unset) | Connects to remote server via HTTP. `url` and `apiKey` are required. |
+
+This means you can use the **exact same code** in both environments:
+
+```typescript
+// Works in both development and production!
+const db = await GraphDB({
+  url: 'https://my-graphdb.example.com',
+  project: 'myapp',
+  apiKey: process.env.GRAPHDB_API_KEY,
+});
+```
+
+### Development Mode
+
+When `NODE_ENV=development`:
+- A local SQLite database is created automatically
+- No server setup required
+- `url` and `apiKey` parameters are ignored
+- Data persists at `./data/{env}/{project}.db` by default
+
+```bash
+# Run your app in development mode
+NODE_ENV=development node app.js
+```
+
+### Production Mode
+
+When `NODE_ENV=production` (or unset):
+- Connects to a remote GraphDB server via HTTP
+- `url` and `apiKey` are required
+
+```bash
+# Run your app in production mode
+NODE_ENV=production GRAPHDB_API_KEY=xxx node app.js
+```
+
+## Configuration Options
+
+| Option | Type | Required | Default | Description |
+|--------|------|----------|---------|-------------|
+| `url` | `string` | Yes | - | Base URL of the GraphDB server (used in production) |
+| `project` | `string` | Yes | - | Project name |
+| `apiKey` | `string` | No | - | API key for authentication (used in production) |
+| `env` | `'production' \| 'test'` | No | `'production'` | Environment (determines database isolation) |
+| `dataPath` | `string` | No | `'./data'` | Path for local data storage (development only). Use `':memory:'` for in-memory database |
+
+### Examples
+
+```typescript
+// Production: connect to remote server
+const db = await GraphDB({
+  url: 'https://graphdb.example.com',
+  project: 'myapp',
+  apiKey: 'your-api-key',
+  env: 'production',
+});
+
+// Development: use local SQLite (url/apiKey ignored)
+// NODE_ENV=development
+const db = await GraphDB({
+  url: 'https://graphdb.example.com', // ignored
+  project: 'myapp',
+  apiKey: 'your-api-key',             // ignored
+  dataPath: './local-data',           // custom data directory
+});
+
+// Testing: use in-memory database
+// NODE_ENV=development
+const db = await GraphDB({
+  url: 'https://graphdb.example.com',
+  project: 'test-project',
+  dataPath: ':memory:',               // resets on each run
+});
+```
+
+## API Reference
+
+### `GraphDB(options): Promise<GraphDBClient>`
+
+Create a new GraphDB client. Returns a promise that resolves to a client instance.
+
+### `db.query<T>(cypher, params?): Promise<T[]>`
+
+Execute a Cypher query and return results as an array.
+
+```typescript
+const users = await db.query<{ name: string; age: number }>(
+  'MATCH (u:User) WHERE u.age > $minAge RETURN u.name AS name, u.age AS age',
+  { minAge: 21 }
+);
+// users = [{ name: 'Alice', age: 25 }, { name: 'Bob', age: 30 }]
+```
+
+### `db.execute(cypher, params?): Promise<void>`
+
+Execute a mutating query (CREATE, SET, DELETE, MERGE) without expecting return data.
+
+```typescript
+await db.execute('CREATE (n:User {name: $name, email: $email})', {
+  name: 'Alice',
+  email: 'alice@example.com'
+});
+```
+
+### `db.queryRaw<T>(cypher, params?): Promise<QueryResponse<T>>`
+
+Execute a query and return the full response including metadata.
+
+```typescript
+const response = await db.queryRaw('MATCH (n) RETURN n LIMIT 10');
+console.log(response.meta.count);   // Number of rows
+console.log(response.meta.time_ms); // Query execution time in ms
+console.log(response.data);         // Array of results
+```
+
+### `db.createNode(label, properties?): Promise<string>`
+
+Create a node and return its ID.
+
+```typescript
+const userId = await db.createNode('User', { name: 'Alice', email: 'alice@example.com' });
+```
+
+### `db.getNode(label, filter): Promise<Record<string, unknown> | null>`
+
+Find a node by label and properties.
+
+```typescript
+const user = await db.getNode('User', { email: 'alice@example.com' });
+if (user) {
+  console.log(user.name); // 'Alice'
+}
+```
+
+### `db.updateNode(id, properties): Promise<void>`
+
+Update properties on a node.
+
+```typescript
+await db.updateNode(userId, { name: 'Alice Smith', verified: true });
+```
+
+### `db.deleteNode(id): Promise<void>`
+
+Delete a node and all its relationships (DETACH DELETE).
+
+```typescript
+await db.deleteNode(userId);
+```
+
+### `db.createEdge(sourceId, type, targetId, properties?): Promise<void>`
+
+Create a relationship between two nodes.
+
+```typescript
+await db.createEdge(aliceId, 'FOLLOWS', bobId, { since: '2024-01-01' });
+```
+
+### `db.health(): Promise<{ status: string; timestamp: string }>`
+
+Check server health. In development mode, always returns `{ status: 'ok', ... }`.
+
+### `db.close(): void`
+
+Close the client and release resources. **Always call this when done.**
+
+```typescript
+const db = await GraphDB({ ... });
+try {
+  // ... use db
+} finally {
+  db.close();
+}
+```
+
+## Cypher Quick Reference
+
+### Supported Clauses
+
+| Clause | Example |
+|--------|---------|
+| `CREATE` | `CREATE (n:User {name: 'Alice'})` |
+| `MATCH` | `MATCH (n:User) RETURN n` |
+| `OPTIONAL MATCH` | `OPTIONAL MATCH (n)-[:KNOWS]->(m) RETURN m` |
+| `MERGE` | `MERGE (n:User {email: $email})` |
+| `WHERE` | `WHERE n.age > 21 AND n.active = true` |
+| `SET` | `SET n.name = 'Bob', n.updated = true` |
+| `DELETE` | `DELETE n` |
+| `DETACH DELETE` | `DETACH DELETE n` |
+| `RETURN` | `RETURN n.name AS name, count(*) AS total` |
+| `WITH` | `WITH n, count(*) AS cnt WHERE cnt > 1` |
+| `UNWIND` | `UNWIND $list AS item CREATE (n {value: item})` |
+| `UNION / UNION ALL` | `MATCH (n:A) RETURN n UNION MATCH (m:B) RETURN m` |
+| `ORDER BY` | `ORDER BY n.name DESC` |
+| `SKIP / LIMIT` | `SKIP 10 LIMIT 5` |
+| `DISTINCT` | `RETURN DISTINCT n.category` |
+| `CASE/WHEN` | `RETURN CASE WHEN n.age > 18 THEN 'adult' ELSE 'minor' END` |
+| `CALL` | `CALL db.labels() YIELD label RETURN label` |
+
+### Operators
+
+| Category | Operators |
+|----------|-----------|
+| Comparison | `=`, `<>`, `<`, `>`, `<=`, `>=` |
+| Logical | `AND`, `OR`, `NOT` |
+| String | `CONTAINS`, `STARTS WITH`, `ENDS WITH` |
+| List | `IN` |
+| Null | `IS NULL`, `IS NOT NULL` |
+| Pattern | `EXISTS` |
+| Arithmetic | `+`, `-`, `*`, `/`, `%` |
+
+### Functions
+
+**Aggregation:** `COUNT`, `SUM`, `AVG`, `MIN`, `MAX`, `COLLECT`
+
+**Scalar:** `ID`, `coalesce`
+
+**String:** `toUpper`, `toLower`, `trim`, `substring`, `replace`, `toString`, `split`
+
+**List:** `size`, `head`, `last`, `tail`, `keys`, `range`
+
+**Node/Relationship:** `labels`, `type`, `properties`
+
+**Math:** `abs`, `ceil`, `floor`, `round`, `rand`, `sqrt`
+
+**Date/Time:** `date`, `datetime`, `timestamp`
+
+### Variable-Length Paths
+
+```cypher
+-- Find friends of friends (1 to 3 hops)
+MATCH (a:User {name: 'Alice'})-[:KNOWS*1..3]->(b:User)
+RETURN DISTINCT b.name
+```
+
+### Procedures
+
+```cypher
+-- List all labels
+CALL db.labels() YIELD label RETURN label
+
+-- List all relationship types
+CALL db.relationshipTypes() YIELD type RETURN type
+
+-- List all property keys
+CALL db.propertyKeys() YIELD key RETURN key
+```
+
+## Running the Server (Production)
+
+For production deployments, run a dedicated server:
+
+```bash
+# Start the server
+npx nicefox-graphdb serve --port 3000 --data ./data
+
+# Or with custom host binding
+npx nicefox-graphdb serve --port 3000 --host 0.0.0.0 --data ./data
+```
+
+### Creating Projects
+
+```bash
+# Create a new project (generates API keys)
+npx nicefox-graphdb create myapp --data ./data
+
+# Output:
+#   [created] production/myapp.db
+#   [created] test/myapp.db
+#   API Keys:
+#     production: nfx_abc123...
+#     test:       nfx_def456...
+```
+
+### CLI Reference
+
+```bash
+# Server
+nicefox-graphdb serve [options]
+  -p, --port <port>     Port to listen on (default: 3000)
+  -d, --data <path>     Data directory (default: /var/data/nicefox-graphdb)
+  -H, --host <host>     Host to bind to (default: localhost)
+  -b, --backup <path>   Backup directory (enables backup endpoints)
+
+# Project management
+nicefox-graphdb create <project>   Create new project with API keys
+nicefox-graphdb delete <project>   Delete project (use --force)
+nicefox-graphdb list               List all projects
+
+# Environment management
+nicefox-graphdb clone <project>    Copy production to test
+nicefox-graphdb wipe <project>     Clear test database
+
+# Direct queries
+nicefox-graphdb query <env> <project> "CYPHER"
+
+# Backup
+nicefox-graphdb backup [options]
+  -o, --output <path>   Backup directory
+  -p, --project <name>  Backup specific project
+  --status              Show backup status
+
+# API keys
+nicefox-graphdb apikey add <project>
+nicefox-graphdb apikey list
+nicefox-graphdb apikey remove <prefix>
+```
+
+## Why NiceFox?
+
+| Feature | NiceFox GraphDB | Neo4j |
+|---------|-----------------|-------|
+| **Deployment** | Single package, zero config | Complex setup, JVM required |
+| **Development** | Local SQLite, no server needed | Server required |
+| **Backup** | Just copy the SQLite file | Enterprise license required |
+| **Resource usage** | ~50MB RAM | 1GB+ RAM minimum |
+| **Cypher support** | Core subset | Full |
+| **Cost** | Free, MIT license | Free tier limited |
+
+NiceFox is ideal for:
+- Applications needing graph queries without ops burden
+- Projects that outgrow JSON but don't need a full graph database
+- Self-hosted deployments where simplicity matters
+- Development and testing with instant local databases
+
+## Advanced Usage
+
+### Direct Database Access
+
+For advanced use cases, you can access the underlying components:
+
+```typescript
+import { GraphDatabase, Executor, parse, translate } from 'nicefox-graphdb';
+
+// Direct database access
+const db = new GraphDatabase('./my-database.db');
+db.initialize();
+
+const executor = new Executor(db);
+const result = executor.execute('MATCH (n) RETURN n LIMIT 10');
+
+db.close();
+
+// Parse Cypher to AST
+const parseResult = parse('MATCH (n:User) RETURN n');
+if (parseResult.success) {
+  console.log(parseResult.query);
+}
+
+// Translate AST to SQL
+const translation = translate(parseResult.query, {});
+console.log(translation.statements);
+```
+
+### Running a Custom Server
+
+```typescript
+import { createServer } from 'nicefox-graphdb';
+import { serve } from '@hono/node-server';
+
+const { app, dbManager } = createServer({
+  dataPath: './data',
+  apiKeys: {
+    'my-api-key': { project: 'myapp', env: 'production' }
+  }
+});
+
+serve({ fetch: app.fetch, port: 3000 });
+```
+
+## License
+
+[MIT](https://github.com/co-l/nicefox-graphdb/blob/main/LICENSE) - Conrad Lelubre

package/packages/nicefox-graphdb/dist/auth.d.ts

@@ -0,0 +1,66 @@
+import { Context, Next } from "hono";
+export interface ApiKeyConfig {
+    project?: string;
+    env?: string;
+    admin?: boolean;
+}
+export interface ValidationResult {
+    valid: boolean;
+    project?: string;
+    env?: string;
+    admin?: boolean;
+}
+export interface KeyInfo {
+    prefix: string;
+    project?: string;
+    env?: string;
+    admin?: boolean;
+}
+export declare class ApiKeyStore {
+    private keys;
+    /**
+     * Add an API key with its configuration.
+     */
+    addKey(key: string, config: ApiKeyConfig): void;
+    /**
+     * Remove an API key.
+     */
+    removeKey(key: string): void;
+    /**
+     * Validate an API key and return its permissions.
+     */
+    validate(key: string): ValidationResult;
+    /**
+     * List all keys (with prefixes only for security).
+     */
+    listKeys(): KeyInfo[];
+    /**
+     * Check if any keys are configured.
+     */
+    hasKeys(): boolean;
+    /**
+     * Load keys from an object (for initialization from config).
+     */
+    loadKeys(keys: Record<string, ApiKeyConfig>): void;
+}
+/**
+ * Hono middleware for API key authentication.
+ *
+ * - Skips authentication for /health endpoint
+ * - Requires Bearer token in Authorization header
+ * - Checks project/env restrictions for /query endpoints
+ * - Requires admin flag for /admin endpoints
+ */
+export declare function authMiddleware(store: ApiKeyStore): (c: Context, next: Next) => Promise<void | (Response & import("hono").TypedResponse<{
+    success: false;
+    error: {
+        message: string;
+    };
+}, 401, "json">) | (Response & import("hono").TypedResponse<{
+    success: false;
+    error: {
+        message: string;
+    };
+}, 403, "json">)>;
+export declare function generateApiKey(): string;
+//# sourceMappingURL=auth.d.ts.map

package/packages/nicefox-graphdb/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAMrC,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAMD,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAwC;IAEpD;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAI/C;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI5B;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB;IAevC;;OAEG;IACH,QAAQ,IAAI,OAAO,EAAE;IAerB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,IAAI;CAKnD;AAMD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,IACjC,GAAG,OAAO,EAAE,MAAM,IAAI;;;;;;;;;;kBA0FrC;AAMD,wBAAgB,cAAc,IAAI,MAAM,CASvC"}

package/packages/nicefox-graphdb/dist/auth.js

@@ -0,0 +1,148 @@
+// API Key Authentication for NiceFox GraphDB
+// ============================================================================
+// ApiKeyStore
+// ============================================================================
+export class ApiKeyStore {
+    keys = new Map();
+    /**
+     * Add an API key with its configuration.
+     */
+    addKey(key, config) {
+        this.keys.set(key, config);
+    }
+    /**
+     * Remove an API key.
+     */
+    removeKey(key) {
+        this.keys.delete(key);
+    }
+    /**
+     * Validate an API key and return its permissions.
+     */
+    validate(key) {
+        const config = this.keys.get(key);
+        if (!config) {
+            return { valid: false };
+        }
+        return {
+            valid: true,
+            project: config.project,
+            env: config.env,
+            admin: config.admin,
+        };
+    }
+    /**
+     * List all keys (with prefixes only for security).
+     */
+    listKeys() {
+        const result = [];
+        for (const [key, config] of this.keys) {
+            result.push({
+                prefix: key.slice(0, 4) + "...",
+                project: config.project,
+                env: config.env,
+                admin: config.admin,
+            });
+        }
+        return result;
+    }
+    /**
+     * Check if any keys are configured.
+     */
+    hasKeys() {
+        return this.keys.size > 0;
+    }
+    /**
+     * Load keys from an object (for initialization from config).
+     */
+    loadKeys(keys) {
+        for (const [key, config] of Object.entries(keys)) {
+            this.addKey(key, config);
+        }
+    }
+}
+// ============================================================================
+// Auth Middleware
+// ============================================================================
+/**
+ * Hono middleware for API key authentication.
+ *
+ * - Skips authentication for /health endpoint
+ * - Requires Bearer token in Authorization header
+ * - Checks project/env restrictions for /query endpoints
+ * - Requires admin flag for /admin endpoints
+ */
+export function authMiddleware(store) {
+    return async (c, next) => {
+        const path = c.req.path;
+        // Skip auth for health endpoint
+        if (path === "/health") {
+            return next();
+        }
+        // Get authorization header
+        const authHeader = c.req.header("Authorization");
+        if (!authHeader) {
+            return c.json({
+                success: false,
+                error: { message: "Missing Authorization header" },
+            }, 401);
+        }
+        // Check Bearer format
+        if (!authHeader.startsWith("Bearer ")) {
+            return c.json({
+                success: false,
+                error: { message: "Authorization header must use Bearer scheme" },
+            }, 401);
+        }
+        const apiKey = authHeader.slice(7); // Remove "Bearer "
+        const validation = store.validate(apiKey);
+        if (!validation.valid) {
+            return c.json({
+                success: false,
+                error: { message: "Invalid API key" },
+            }, 401);
+        }
+        // Check admin access for /admin endpoints
+        if (path.startsWith("/admin") && !validation.admin) {
+            return c.json({
+                success: false,
+                error: { message: "Admin access required for this endpoint" },
+            }, 403);
+        }
+        // Check project/env restrictions for query endpoints
+        if (path.startsWith("/query/")) {
+            const parts = path.split("/");
+            const env = parts[2];
+            const project = parts[3];
+            // Check project restriction
+            if (validation.project && validation.project !== project) {
+                return c.json({
+                    success: false,
+                    error: { message: `Access denied for project: ${project}` },
+                }, 403);
+            }
+            // Check environment restriction
+            if (validation.env && validation.env !== env) {
+                return c.json({
+                    success: false,
+                    error: { message: `Access denied for environment: ${env}` },
+                }, 403);
+            }
+        }
+        // Store validation result in context for later use
+        c.set("auth", validation);
+        return next();
+    };
+}
+// ============================================================================
+// Helper: Generate a random API key
+// ============================================================================
+export function generateApiKey() {
+    const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+    let key = "";
+    for (let i = 0; i < 32; i++) {
+        key += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return key;
+}
+//# sourceMappingURL=auth.js.map

package/packages/nicefox-graphdb/dist/auth.js.map

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

package/packages/nicefox-graphdb/dist/backup.d.ts

@@ -0,0 +1,51 @@
+export interface BackupResult {
+    success: boolean;
+    project: string;
+    sourcePath: string;
+    backupPath?: string;
+    error?: string;
+    durationMs?: number;
+    sizeBytes?: number;
+}
+export interface BackupStatus {
+    totalBackups: number;
+    totalSizeBytes: number;
+    projects: string[];
+    oldestBackup?: string;
+    newestBackup?: string;
+}
+export interface BackupAllOptions {
+    includeTest?: boolean;
+}
+export declare class BackupManager {
+    private backupDir;
+    constructor(backupDir: string);
+    /**
+     * Create a backup of a single database file using SQLite's backup API.
+     * This is a "hot" backup - it works even if the database is open and in use.
+     */
+    backupDatabase(sourcePath: string, project: string): Promise<BackupResult>;
+    /**
+     * Backup all databases in a data directory.
+     * By default, only backs up production databases.
+     */
+    backupAll(dataDir: string, options?: BackupAllOptions): Promise<BackupResult[]>;
+    /**
+     * List all backups for a specific project, sorted by date (newest first).
+     */
+    listBackups(project: string): string[];
+    /**
+     * Delete old backups, keeping only the specified number of recent ones.
+     * Returns the number of deleted backups.
+     */
+    cleanOldBackups(project: string, keepCount: number): number;
+    /**
+     * Get overall backup status and statistics.
+     */
+    getBackupStatus(): BackupStatus;
+    /**
+     * Restore a backup to a target path.
+     */
+    restoreBackup(backupFilename: string, targetPath: string): BackupResult;
+}
+//# sourceMappingURL=backup.d.ts.map

package/packages/nicefox-graphdb/dist/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../src/backup.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAMD,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,EAAE,MAAM;IAI7B;;;OAGG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAsDhF;;;OAGG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAwBzF;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAYtC;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAuB3D;;OAEG;IACH,eAAe,IAAI,YAAY;IA4C/B;;OAEG;IACH,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY;CAqCxE"}