specforge-mcp 0.2.2 → 0.4.0

package/dist/tools/generate-tests/generators/database-test-generator.js

@@ -0,0 +1,329 @@
+// tools/generate-tests/generators/database-test-generator.ts — SPEC-058b Section F
+// Generates database & data layer test scaffolds:
+// migrations, repository/DAO CRUD, caching, full-text search.
+const CACHE_SIGNALS = ['redis', 'memcached', 'node-cache', 'caffeine', 'ehcache', 'valkey'];
+const SEARCH_SIGNALS = [
+    'elasticsearch',
+    'meilisearch',
+    'algolia',
+    'opensearch',
+    'solr',
+    'typesense',
+];
+export function detectCaching(knowledge) {
+    const stackLower = knowledge.stack.map((s) => s.toLowerCase());
+    for (const sig of CACHE_SIGNALS) {
+        if (stackLower.some((s) => s.includes(sig))) {
+            return sig;
+        }
+    }
+    return null;
+}
+export function detectSearchEngine(knowledge) {
+    const stackLower = knowledge.stack.map((s) => s.toLowerCase());
+    for (const sig of SEARCH_SIGNALS) {
+        if (stackLower.some((s) => s.includes(sig))) {
+            return sig;
+        }
+    }
+    return null;
+}
+export function hasOrm(knowledge) {
+    return knowledge.orm !== null && knowledge.orm !== 'unknown';
+}
+export function isDatabaseTestProject(knowledge) {
+    return knowledge.database !== 'unknown';
+}
+export function generateDatabaseTestDefs(title, testDir, _testExt, knowledge) {
+    const defs = [
+        {
+            name: `${title} — migration: schema up/down and rollback safety`,
+            type: 'integration',
+            file: `${testDir}/database/`,
+            description: 'Verify schema migrations run up/down cleanly and preserve data integrity',
+            priority: 'critical',
+            automatable: true,
+        },
+        {
+            name: `${title} — repository: CRUD operations on ${knowledge.database}`,
+            type: 'integration',
+            file: `${testDir}/database/`,
+            description: 'Verify create, read, update, delete operations on the data layer',
+            priority: 'high',
+            automatable: true,
+        },
+    ];
+    if (hasOrm(knowledge)) {
+        defs.push({
+            name: `${title} — transactions and optimistic locking`,
+            type: 'integration',
+            file: `${testDir}/database/`,
+            description: 'Verify transaction commit/rollback and optimistic locking conflict detection',
+            priority: 'high',
+            automatable: true,
+        });
+    }
+    const cache = detectCaching(knowledge);
+    if (cache !== null) {
+        defs.push({
+            name: `${title} — caching (${cache}): hit/miss, TTL, invalidation`,
+            type: 'integration',
+            file: `${testDir}/database/`,
+            description: 'Verify cache hit/miss behavior, TTL expiration, and invalidation patterns',
+            priority: 'high',
+            automatable: true,
+        });
+    }
+    const search = detectSearchEngine(knowledge);
+    if (search !== null) {
+        defs.push({
+            name: `${title} — full-text search (${search}): indexing and query relevance`,
+            type: 'integration',
+            file: `${testDir}/database/`,
+            description: 'Verify document indexing, query relevance ranking, and fuzzy matching',
+            priority: 'medium',
+            automatable: true,
+        });
+    }
+    return defs;
+}
+// ---------------------------------------------------------------------------
+// Scaffold builders
+// ---------------------------------------------------------------------------
+function buildTsDatabaseTest(title, db, orm, cache, search) {
+    const cacheSection = cache
+        ? `
+  describe('Caching (${cache})', () => {
+    it('returns cached value on cache hit', async () => {
+      // await cache.set('user:1', { name: 'Test' }, { ttl: 60 });
+      // const result = await cache.get('user:1');
+      // expect(result).toMatchObject({ name: 'Test' });
+      expect(true).toBe(true);
+    });
+
+    it('returns null on cache miss', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('expires entry after TTL', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('invalidates cache on data update', async () => {
+      expect(true).toBe(true);
+    });
+  });
+`
+        : '';
+    const searchSection = search
+        ? `
+  describe('Full-text search (${search})', () => {
+    it('indexes document and makes it searchable', async () => {
+      // await searchClient.index('products').addDocuments([{ id: 1, name: 'Widget' }]);
+      // const results = await searchClient.index('products').search('Widget');
+      // expect(results.hits).toHaveLength(1);
+      expect(true).toBe(true);
+    });
+
+    it('returns relevant results ranked by score', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('supports fuzzy matching for typos', async () => {
+      expect(true).toBe(true);
+    });
+  });
+`
+        : '';
+    const ormSection = orm
+        ? `
+  describe('Transactions and locking', () => {
+    it('commits transaction on success', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('rolls back transaction on error', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('detects optimistic locking conflict', async () => {
+      // Concurrent update with stale version → should throw
+      expect(true).toBe(true);
+    });
+  });
+`
+        : '';
+    return `// Database & Data Layer tests for: ${title}
+// Generated by SpecForge SDD MCP Server (SPEC-058b)
+import { describe, it, expect } from 'vitest';
+
+describe('${title} — Database Tests (${db})', () => {
+  describe('Migrations', () => {
+    it('schema migration up applies cleanly', async () => {
+      // await migrate.up();
+      // const tables = await db.query("SELECT name FROM sqlite_master WHERE type='table'");
+      // expect(tables).toContainEqual({ name: 'users' });
+      expect(true).toBe(true); // Replace with real migration assertion
+    });
+
+    it('schema migration down reverts cleanly', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('data integrity preserved after migration', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('rollback does not lose existing data', async () => {
+      expect(true).toBe(true);
+    });
+  });
+
+  describe('Repository / DAO — CRUD', () => {
+    it('creates a record and returns its id', async () => {
+      // const user = await repo.create({ name: 'Test', email: 'test@example.com' });
+      // expect(user.id).toBeDefined();
+      expect(true).toBe(true);
+    });
+
+    it('reads a record by id', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('updates a record', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('deletes a record', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('returns null for non-existent record', async () => {
+      expect(true).toBe(true);
+    });
+  });
+${ormSection}${cacheSection}${searchSection}});
+`;
+}
+function buildPythonDatabaseTest(title, db, orm, cache, search) {
+    const cls = title.replace(/[^a-zA-Z0-9]/g, '');
+    const ormSection = orm
+        ? `
+    def test_transaction_commits_on_success(self) -> None:
+        """Transaction commits all changes on success."""
+        pass
+
+    def test_transaction_rolls_back_on_error(self) -> None:
+        """Transaction rolls back on exception."""
+        pass
+
+    def test_optimistic_locking_conflict(self) -> None:
+        """Concurrent update with stale version raises conflict."""
+        pass
+`
+        : '';
+    const cacheSection = cache
+        ? `
+    def test_cache_hit_returns_value(self) -> None:
+        """Cache returns stored value on hit."""
+        pass
+
+    def test_cache_miss_returns_none(self) -> None:
+        """Cache returns None on miss."""
+        pass
+
+    def test_cache_ttl_expiration(self) -> None:
+        """Cache entry expires after TTL."""
+        pass
+
+    def test_cache_invalidation_on_update(self) -> None:
+        """Cache is invalidated when underlying data changes."""
+        pass
+`
+        : '';
+    const searchSection = search
+        ? `
+    def test_index_document_searchable(self) -> None:
+        """Indexed document is returned by search query."""
+        pass
+
+    def test_query_relevance_ranking(self) -> None:
+        """Results are ranked by relevance score."""
+        pass
+
+    def test_fuzzy_matching_for_typos(self) -> None:
+        """Fuzzy search finds results despite typos."""
+        pass
+`
+        : '';
+    return `"""Database & Data Layer tests for: ${title}
+Generated by SpecForge SDD MCP Server (SPEC-058b).
+Database: ${db}
+"""
+import pytest
+
+
+class Test${cls}Database:
+    """Database test suite for ${title} (${db})."""
+
+    def test_migration_up_applies_cleanly(self) -> None:
+        """Schema migration up creates expected tables."""
+        # TODO: result = alembic.command.upgrade(config, 'head')
+        pass
+
+    def test_migration_down_reverts_cleanly(self) -> None:
+        """Schema migration down removes tables cleanly."""
+        pass
+
+    def test_data_integrity_after_migration(self) -> None:
+        """Existing data is preserved after migration."""
+        pass
+
+    def test_rollback_safety(self) -> None:
+        """Rollback does not lose existing data."""
+        pass
+
+    def test_create_record(self) -> None:
+        """Creates a record and returns its id."""
+        # TODO: user = repo.create(name='Test', email='test@example.com')
+        # assert user.id is not None
+        pass
+
+    def test_read_record_by_id(self) -> None:
+        """Reads a record by primary key."""
+        pass
+
+    def test_update_record(self) -> None:
+        """Updates a record field."""
+        pass
+
+    def test_delete_record(self) -> None:
+        """Deletes a record."""
+        pass
+
+    def test_read_nonexistent_returns_none(self) -> None:
+        """Reading a non-existent record returns None."""
+        pass
+${ormSection}${cacheSection}${searchSection}`;
+}
+export function generateDatabaseTestFiles(spec, testDir, framework, language, testExt, autoGenerate, knowledge) {
+    const cache = detectCaching(knowledge);
+    const search = detectSearchEngine(knowledge);
+    const orm = hasOrm(knowledge);
+    const db = knowledge.database;
+    const isPython = language === 'python';
+    const ext = isPython ? 'py' : testExt;
+    const fw = isPython ? 'pytest' : framework;
+    const content = isPython
+        ? buildPythonDatabaseTest(spec.title, db, orm, cache, search)
+        : buildTsDatabaseTest(spec.title, db, orm, cache, search);
+    return [
+        {
+            path: `${testDir}/database/${spec.slug}.database.test.${ext}`,
+            framework: fw,
+            content,
+            ready: autoGenerate,
+        },
+    ];
+}
+//# sourceMappingURL=database-test-generator.js.map

package/dist/tools/generate-tests/generators/database-test-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-test-generator.js","sourceRoot":"","sources":["../../../../src/tools/generate-tests/generators/database-test-generator.ts"],"names":[],"mappings":"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"}

package/dist/tools/generate-tests/generators/graphql-test-generator.d.ts

@@ -0,0 +1,17 @@
+import type { TestDefinition, TestFile, ProjectKnowledge } from '../../../types/index.js';
+/**
+ * Returns true when the project uses GraphQL (Apollo, Urql, Relay, Hasura, etc.).
+ */
+export declare function isGraphqlProject(knowledge: ProjectKnowledge): boolean;
+/**
+ * Generate GraphQL test definitions covering schema, queries, mutations, and security.
+ */
+export declare function generateGraphqlTestDefs(title: string, testDir: string, _testExt: string): TestDefinition[];
+/**
+ * Generate GraphQL test file scaffolds.
+ */
+export declare function generateGraphqlTestFiles(spec: {
+    title: string;
+    slug: string;
+}, testDir: string, framework: string, language: string, testExt: string, autoGenerate: boolean): TestFile[];
+//# sourceMappingURL=graphql-test-generator.d.ts.map

package/dist/tools/generate-tests/generators/graphql-test-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-test-generator.d.ts","sourceRoot":"","sources":["../../../../src/tools/generate-tests/generators/graphql-test-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAI1F;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAKrE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,cAAc,EAAE,CA2DlB;AAmJD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACrC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,OAAO,GACpB,QAAQ,EAAE,CAcZ"}

package/dist/tools/generate-tests/generators/graphql-test-generator.js

@@ -0,0 +1,235 @@
+// tools/generate-tests/generators/graphql-test-generator.ts — SPEC-058a Section D
+// Generates GraphQL API test scaffolds: schema validation, queries, mutations, security.
+const GRAPHQL_SIGNALS = ['graphql', 'apollo', 'urql', 'relay', 'hasura', '@graphql-codegen'];
+/**
+ * Returns true when the project uses GraphQL (Apollo, Urql, Relay, Hasura, etc.).
+ */
+export function isGraphqlProject(knowledge) {
+    const stackLower = knowledge.stack.map((s) => s.toLowerCase());
+    const hasSignal = GRAPHQL_SIGNALS.some((sig) => stackLower.some((s) => s.includes(sig)));
+    const hasContract = knowledge.apiContracts.some((c) => c.type.toLowerCase() === 'graphql');
+    return hasSignal || hasContract;
+}
+/**
+ * Generate GraphQL test definitions covering schema, queries, mutations, and security.
+ */
+export function generateGraphqlTestDefs(title, testDir, _testExt) {
+    return [
+        {
+            name: `${title} — GraphQL: schema validation passes introspection`,
+            type: 'integration',
+            file: `${testDir}/graphql/`,
+            description: 'Verify the GraphQL schema is valid and all types resolve correctly',
+            priority: 'critical',
+            automatable: true,
+        },
+        {
+            name: `${title} — GraphQL: query with variables returns expected data shape`,
+            type: 'integration',
+            file: `${testDir}/graphql/`,
+            description: 'Execute a parameterized query and assert the response matches the schema',
+            priority: 'high',
+            automatable: true,
+        },
+        {
+            name: `${title} — GraphQL: mutation creates resource and returns it`,
+            type: 'integration',
+            file: `${testDir}/graphql/`,
+            description: 'Execute a create mutation and verify the returned payload and side-effects',
+            priority: 'high',
+            automatable: true,
+        },
+        {
+            name: `${title} — GraphQL: introspection disabled in production`,
+            type: 'integration',
+            file: `${testDir}/graphql/`,
+            description: 'Verify introspection query returns an error when NODE_ENV=production',
+            priority: 'critical',
+            automatable: true,
+        },
+        {
+            name: `${title} — GraphQL: N+1 query detection on nested resolvers`,
+            type: 'integration',
+            file: `${testDir}/graphql/`,
+            description: 'Assert that nested list queries do not trigger N+1 database calls',
+            priority: 'high',
+            automatable: true,
+        },
+        {
+            name: `${title} — GraphQL: query depth limiting rejects deep queries`,
+            type: 'integration',
+            file: `${testDir}/graphql/`,
+            description: 'Verify that queries exceeding the configured depth limit are rejected',
+            priority: 'medium',
+            automatable: true,
+        },
+        {
+            name: `${title} — GraphQL: auth resolver rejects unauthenticated requests`,
+            type: 'integration',
+            file: `${testDir}/graphql/`,
+            description: 'Verify that protected resolvers return UNAUTHENTICATED error without a token',
+            priority: 'critical',
+            automatable: true,
+        },
+    ];
+}
+// ---------------------------------------------------------------------------
+// Content generators
+// ---------------------------------------------------------------------------
+function buildTsGraphqlTest(title) {
+    return `// GraphQL API tests for: ${title}
+// Generated by SpecForge SDD MCP Server (SPEC-058a)
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+// Adjust import path to match your server setup
+// import { createTestServer } from '../helpers/test-server';
+// import { request } from 'graphql-request';
+
+describe('${title} — GraphQL API Tests', () => {
+  // let server: ReturnType<typeof createTestServer>;
+  // let endpoint: string;
+
+  beforeAll(async () => {
+    // server = await createTestServer();
+    // endpoint = \`http://localhost:\${server.port}/graphql\`;
+  });
+
+  afterAll(async () => {
+    // await server.close();
+  });
+
+  describe('Schema validation', () => {
+    it('schema passes introspection query', async () => {
+      // const result = await request(endpoint, \`{ __schema { types { name } } }\`);
+      // expect(result.__schema.types.length).toBeGreaterThan(0);
+      expect(true).toBe(true); // Replace with real introspection assertion
+    });
+  });
+
+  describe('Query with variables', () => {
+    it('returns expected data shape for parameterized query', async () => {
+      // const query = \`
+      //   query GetItem($id: ID!) {
+      //     item(id: $id) { id name createdAt }
+      //   }
+      // \`;
+      // const result = await request(endpoint, query, { id: 'test-id' });
+      // expect(result.item).toMatchObject({ id: 'test-id' });
+      expect(true).toBe(true); // Replace with real query assertion
+    });
+  });
+
+  describe('Mutation', () => {
+    it('creates resource and returns it', async () => {
+      // const mutation = \`
+      //   mutation CreateItem($input: CreateItemInput!) {
+      //     createItem(input: $input) { id name }
+      //   }
+      // \`;
+      // const result = await request(endpoint, mutation, { input: { name: 'Test' } });
+      // expect(result.createItem.name).toBe('Test');
+      expect(true).toBe(true); // Replace with real mutation assertion
+    });
+  });
+
+  describe('Security', () => {
+    it('rejects introspection in production mode', async () => {
+      // const originalEnv = process.env['NODE_ENV'];
+      // process.env['NODE_ENV'] = 'production';
+      // try {
+      //   await expect(request(endpoint, \`{ __schema { types { name } } }\`)).rejects.toThrow();
+      // } finally {
+      //   process.env['NODE_ENV'] = originalEnv;
+      // }
+      expect(true).toBe(true); // Replace with production introspection test
+    });
+
+    it('rejects queries exceeding depth limit', async () => {
+      // const deepQuery = \`{ a { b { c { d { e { f { name } } } } } } }\`;
+      // await expect(request(endpoint, deepQuery)).rejects.toThrow();
+      expect(true).toBe(true); // Replace with depth-limit assertion
+    });
+
+    it('returns UNAUTHENTICATED error for protected resolver without token', async () => {
+      // const result = await request(endpoint, \`{ protectedData { secret } }\`);
+      // expect(result.errors?.[0]?.extensions?.code).toBe('UNAUTHENTICATED');
+      expect(true).toBe(true); // Replace with auth assertion
+    });
+  });
+});
+`;
+}
+function buildPythonGraphqlTest(title) {
+    const cls = title.replace(/\s+/g, '');
+    return `"""GraphQL API tests for: ${title}
+Generated by SpecForge SDD MCP Server (SPEC-058a).
+Supports strawberry-graphql and graphene.
+"""
+import pytest
+# from strawberry.test import Client  # strawberry
+# from graphene_django.utils.testing import GraphQLTestCase  # graphene-django
+
+
+class Test${cls}GraphQL:
+    """GraphQL API test suite for ${title}."""
+
+    def test_schema_passes_introspection(self) -> None:
+        """Schema is valid and all types are resolvable via introspection."""
+        # TODO: client = Client(schema)
+        # result = client.execute("{ __schema { types { name } } }")
+        # assert "errors" not in result
+        pass
+
+    def test_query_with_variables_returns_expected_shape(self) -> None:
+        """Parameterized query returns correct data shape."""
+        # TODO: result = client.execute(
+        #     "query GetItem($id: ID!) { item(id: $id) { id name } }",
+        #     variable_values={"id": "test-id"}
+        # )
+        # assert result["data"]["item"]["id"] == "test-id"
+        pass
+
+    def test_mutation_creates_resource(self) -> None:
+        """Create mutation returns the newly created resource."""
+        # TODO: result = client.execute(
+        #     'mutation { createItem(name: "Test") { id name } }'
+        # )
+        # assert result["data"]["createItem"]["name"] == "Test"
+        pass
+
+    def test_introspection_disabled_in_production(self) -> None:
+        """Introspection returns an error when running in production mode."""
+        # TODO: assert introspection_disabled_for_production()
+        pass
+
+    def test_deep_query_rejected_by_depth_limiter(self) -> None:
+        """Queries exceeding the depth limit are rejected with an error."""
+        # TODO: deep_query = "{ a { b { c { d { e { f { name } } } } } } }"
+        # result = client.execute(deep_query)
+        # assert "errors" in result
+        pass
+
+    def test_protected_resolver_requires_auth(self) -> None:
+        """Protected resolver returns UNAUTHENTICATED error without token."""
+        # TODO: result = unauthenticated_client.execute("{ protectedData { secret } }")
+        # assert result["errors"][0]["extensions"]["code"] == "UNAUTHENTICATED"
+        pass
+`;
+}
+/**
+ * Generate GraphQL test file scaffolds.
+ */
+export function generateGraphqlTestFiles(spec, testDir, framework, language, testExt, autoGenerate) {
+    const isPython = language === 'python';
+    const resolvedExt = isPython ? 'py' : testExt;
+    const resolvedFramework = isPython ? 'pytest' : framework;
+    const content = isPython ? buildPythonGraphqlTest(spec.title) : buildTsGraphqlTest(spec.title);
+    return [
+        {
+            path: `${testDir}/graphql/${spec.slug}.graphql.test.${resolvedExt}`,
+            framework: resolvedFramework,
+            content,
+            ready: autoGenerate,
+        },
+    ];
+}
+//# sourceMappingURL=graphql-test-generator.js.map

package/dist/tools/generate-tests/generators/graphql-test-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-test-generator.js","sourceRoot":"","sources":["../../../../src/tools/generate-tests/generators/graphql-test-generator.ts"],"names":[],"mappings":"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"}

package/dist/tools/generate-tests/generators/grpc-test-generator.d.ts

@@ -0,0 +1,17 @@
+import type { TestDefinition, TestFile, ProjectKnowledge } from '../../../types/index.js';
+/**
+ * Returns true when the project uses gRPC / Protocol Buffers.
+ */
+export declare function isGrpcProject(knowledge: ProjectKnowledge): boolean;
+/**
+ * Generate gRPC test definitions: proto contracts, unary, streaming, deadlines.
+ */
+export declare function generateGrpcTestDefs(title: string, testDir: string, _testExt: string): TestDefinition[];
+/**
+ * Generate gRPC test file scaffolds for the target language.
+ */
+export declare function generateGrpcTestFiles(spec: {
+    title: string;
+    slug: string;
+}, testDir: string, framework: string, language: string, testExt: string, autoGenerate: boolean): TestFile[];
+//# sourceMappingURL=grpc-test-generator.d.ts.map

package/dist/tools/generate-tests/generators/grpc-test-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc-test-generator.d.ts","sourceRoot":"","sources":["../../../../src/tools/generate-tests/generators/grpc-test-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAI1F;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAMlE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,cAAc,EAAE,CAmDlB;AA6LD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACrC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,OAAO,GACpB,QAAQ,EAAE,CA2BZ"}