freelang-v4 4.3.0

package/dist/db-jest.test.js

@@ -0,0 +1,182 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const lexer_1 = require("./lexer");
+const parser_1 = require("./parser");
+const checker_1 = require("./checker");
+const compiler_1 = require("./compiler");
+const vm_1 = require("./vm");
+const fs = __importStar(require("fs"));
+async function exec(source) {
+    const { tokens, errors: lexErrors } = new lexer_1.Lexer(source).tokenize();
+    if (lexErrors.length > 0) {
+        return { output: [], error: `lex error: ${lexErrors[0].message}` };
+    }
+    const { program, errors: parseErrors } = new parser_1.Parser(tokens).parse();
+    if (parseErrors.length > 0) {
+        return { output: [], error: `parse error: ${parseErrors[0].message}` };
+    }
+    const checkErrors = new checker_1.TypeChecker().check(program);
+    if (checkErrors.length > 0) {
+        return { output: [], error: `type error: ${checkErrors[0].message}` };
+    }
+    const chunk = new compiler_1.Compiler().compile(program);
+    return await new vm_1.VM().run(chunk);
+}
+describe("Database Operations", () => {
+    // Clean up test database files
+    afterEach(() => {
+        try {
+            if (fs.existsSync("./test_db.db")) {
+                fs.unlinkSync("./test_db.db");
+            }
+        }
+        catch {
+            // ignore
+        }
+    });
+    it("sqlite_open: creates or opens database file", async () => {
+        const { output, error } = await exec(`
+      var db = sqlite_open("./test_db.db")
+      println("DB opened")
+    `);
+        expect(error).toBeNull();
+        expect(output).toContain("DB opened");
+    });
+    it("sqlite_execute: creates table and inserts data", async () => {
+        const { output, error } = await exec(`
+      var db = sqlite_open("./test_db.db")
+      var create_result = sqlite_execute(db, "CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT NOT NULL, email TEXT UNIQUE)", [])
+      println("Table created")
+      var insert_result = sqlite_execute(db, "INSERT INTO users (name, email) VALUES (?, ?)", ["Alice", "alice@example.com"])
+      println("Record inserted")
+    `);
+        expect(error).toBeNull();
+        expect(output).toContain("Table created");
+        expect(output).toContain("Record inserted");
+    });
+    it("sqlite_query: retrieves data from table", async () => {
+        const { output, error } = await exec(`
+      var db = sqlite_open("./test_db.db")
+      sqlite_execute(db, "CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT NOT NULL, email TEXT UNIQUE)", [])
+      sqlite_execute(db, "INSERT INTO users (name, email) VALUES (?, ?)", ["Alice", "alice@example.com"])
+      sqlite_execute(db, "INSERT INTO users (name, email) VALUES (?, ?)", ["Bob", "bob@example.com"])
+      var result = sqlite_query(db, "SELECT * FROM users", [])
+      println("Query complete")
+    `);
+        expect(error).toBeNull();
+        expect(output).toContain("Query complete");
+    });
+    it("sqlite_close: closes database", async () => {
+        const { output, error } = await exec(`
+      var db = sqlite_open("./test_db.db")
+      sqlite_close(db)
+      println("DB closed")
+    `);
+        expect(error).toBeNull();
+        expect(output).toContain("DB closed");
+    });
+    it("database handle error: invalid first argument", async () => {
+        const { output, error } = await exec(`
+      var result = sqlite_query("not a db", "SELECT 1", [])
+      println("Query attempted")
+    `);
+        // Should fail because first arg is not a database
+        expect(error || output.join(" ")).toBeTruthy();
+    });
+    it("sqlite_execute: returns ok result", async () => {
+        const { output, error } = await exec(`
+      var db = sqlite_open("./test_db.db")
+      sqlite_execute(db, "CREATE TABLE IF NOT EXISTS items (id INTEGER PRIMARY KEY, name TEXT NOT NULL)", [])
+      var result = sqlite_execute(db, "INSERT INTO items (name) VALUES (?)", ["Item1"])
+      println("Executed")
+    `);
+        expect(error).toBeNull();
+        expect(output).toContain("Executed");
+    });
+    it("sqlite_query: multiple rows", async () => {
+        const { output, error } = await exec(`
+      var db = sqlite_open("./test_db.db")
+      sqlite_execute(db, "CREATE TABLE IF NOT EXISTS people (id INTEGER PRIMARY KEY, name TEXT)", [])
+      sqlite_execute(db, "INSERT INTO people (name) VALUES (?)", ["Alice"])
+      sqlite_execute(db, "INSERT INTO people (name) VALUES (?)", ["Bob"])
+      sqlite_execute(db, "INSERT INTO people (name) VALUES (?)", ["Charlie"])
+      var rows = sqlite_query(db, "SELECT * FROM people", [])
+      println("All rows retrieved")
+    `);
+        expect(error).toBeNull();
+        expect(output).toContain("All rows retrieved");
+    });
+    it("sqlite_begin/commit: manual transaction", async () => {
+        const { output, error } = await exec(`
+      var db = sqlite_open("./test_db.db")
+      sqlite_execute(db, "CREATE TABLE IF NOT EXISTS accounts (id INTEGER PRIMARY KEY, balance INTEGER)", [])
+      sqlite_begin(db, "immediate")
+      sqlite_execute(db, "INSERT INTO accounts (balance) VALUES (?)", ["1000"])
+      sqlite_commit(db)
+      println("Transaction committed")
+    `);
+        expect(error).toBeNull();
+        expect(output).toContain("Transaction committed");
+    });
+    it("sqlite_begin/rollback: transaction rollback", async () => {
+        const { output, error } = await exec(`
+      var db = sqlite_open("./test_db.db")
+      sqlite_execute(db, "CREATE TABLE IF NOT EXISTS logs (id INTEGER PRIMARY KEY, message TEXT)", [])
+      sqlite_begin(db)
+      sqlite_execute(db, "INSERT INTO logs (message) VALUES (?)", ["Before rollback"])
+      sqlite_rollback(db)
+      var count = sqlite_query(db, "SELECT COUNT(*) as cnt FROM logs", [])
+      println("Rollback done")
+    `);
+        expect(error).toBeNull();
+        expect(output).toContain("Rollback done");
+    });
+    it("pg_connect: connection attempt (no server expected)", async () => {
+        const { output, error } = await exec(`
+      var result = pg_connect("localhost", "5432", "postgres", "password", "testdb")
+      println("pg_connect called")
+    `);
+        expect(output).toContain("pg_connect called");
+    });
+    it("mysql_connect: connection attempt (no server expected)", async () => {
+        const { output, error } = await exec(`
+      var result = mysql_connect("localhost", "3306", "root", "password", "testdb")
+      println("mysql_connect called")
+    `);
+        expect(output).toContain("mysql_connect called");
+    });
+});
+//# sourceMappingURL=db-jest.test.js.map

package/dist/db-jest.test.js.map

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

package/dist/db-runtime.d.ts

@@ -0,0 +1,24 @@
+/**
+ * FreeLang v4 Database Runtime
+ * 100M Clone 데이터베이스 구축 및 테스트
+ */
+interface Record {
+    [key: string]: any;
+}
+export declare class DBRuntime {
+    private tables;
+    private variables;
+    insert(tableName: string, record: Record): boolean;
+    selectById(tableName: string, id: number): Record | null;
+    selectAll(tableName: string): Record[];
+    createTable(name: string, schema: {
+        [key: string]: string;
+    }): void;
+    getStats(tableName: string): {
+        table: string;
+        rows: number;
+        memory_mb: number;
+    };
+    bulkInsert(tableName: string, records: Record[]): number;
+}
+export {};

package/dist/db-runtime.js

@@ -0,0 +1,204 @@
+"use strict";
+/**
+ * FreeLang v4 Database Runtime
+ * 100M Clone 데이터베이스 구축 및 테스트
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DBRuntime = void 0;
+// ============================================================
+// FreeLang v4 DB Runtime
+// ============================================================
+class DBRuntime {
+    constructor() {
+        this.tables = new Map();
+        this.variables = new Map();
+    }
+    // INSERT
+    insert(tableName, record) {
+        const table = this.tables.get(tableName);
+        if (!table) {
+            console.error(`Table "${tableName}" not found`);
+            return false;
+        }
+        // 스키마 검증
+        for (const [key, type] of Object.entries(table.schema)) {
+            if (!(key in record)) {
+                console.error(`Missing field "${key}" in record`);
+                return false;
+            }
+        }
+        table.rows.push(record);
+        // 인덱스 업데이트
+        for (const [field, index] of table.indices) {
+            const value = record[field];
+            if (!index.has(value)) {
+                index.set(value, []);
+            }
+            index.get(value).push(table.rows.length - 1);
+        }
+        return true;
+    }
+    // SELECT by ID
+    selectById(tableName, id) {
+        const table = this.tables.get(tableName);
+        if (!table)
+            return null;
+        // 인덱스로 빠른 조회
+        const idIndex = table.indices.get('id');
+        if (idIndex && idIndex.has(id)) {
+            const indices = idIndex.get(id);
+            return table.rows[indices[0]] || null;
+        }
+        // 풀 스캔
+        for (const row of table.rows) {
+            if (row['id'] === id)
+                return row;
+        }
+        return null;
+    }
+    // SELECT all
+    selectAll(tableName) {
+        const table = this.tables.get(tableName);
+        return table ? table.rows : [];
+    }
+    // CREATE TABLE
+    createTable(name, schema) {
+        this.tables.set(name, {
+            schema,
+            rows: [],
+            indices: new Map([['id', new Map()]])
+        });
+    }
+    // STATS
+    getStats(tableName) {
+        const table = this.tables.get(tableName);
+        if (!table)
+            return { table: tableName, rows: 0, memory_mb: 0 };
+        // 대략적인 메모리 계산 (JSON 직렬화)
+        const json = JSON.stringify(table.rows);
+        const memory_bytes = Buffer.byteLength(json, 'utf8');
+        const memory_mb = memory_bytes / (1024 * 1024);
+        return {
+            table: tableName,
+            rows: table.rows.length,
+            memory_mb: Math.round(memory_mb * 100) / 100
+        };
+    }
+    // BULK INSERT (고성능)
+    bulkInsert(tableName, records) {
+        const table = this.tables.get(tableName);
+        if (!table)
+            return 0;
+        let count = 0;
+        for (const record of records) {
+            table.rows.push(record);
+            // 인덱스 업데이트
+            for (const [field, index] of table.indices) {
+                const value = record[field];
+                if (!index.has(value)) {
+                    index.set(value, []);
+                }
+                index.get(value).push(table.rows.length - 1);
+            }
+            count++;
+        }
+        return count;
+    }
+}
+exports.DBRuntime = DBRuntime;
+// ============================================================
+// 메인: 100M Clone Database Test
+// ============================================================
+async function main() {
+    console.log('\n🚀 FreeLang v4 Database Runtime');
+    console.log('================================\n');
+    const db = new DBRuntime();
+    // 스키마 정의
+    db.createTable('clone_results', {
+        id: 'i32',
+        app: 'string',
+        clone_id: 'i32',
+        status: 'string',
+        test_time_ms: 'f64'
+    });
+    // Phase 1: 작은 규모 테스트
+    console.log('📊 Phase 1: Inserting 100K records...');
+    const start1 = Date.now();
+    for (let i = 0; i < 100000; i++) {
+        db.insert('clone_results', {
+            id: i,
+            app: ['proof_ai', 'cwm', 'freelang', 'kim_ai_os'][i % 4],
+            clone_id: i,
+            status: Math.random() > 0.01 ? 'success' : 'failed',
+            test_time_ms: Math.random() * 100
+        });
+    }
+    const time1 = Date.now() - start1;
+    let stats1 = db.getStats('clone_results');
+    console.log(`✅ 100K inserted in ${time1}ms`);
+    console.log(`   Rows: ${stats1.rows}, Memory: ${stats1.memory_mb}MB\n`);
+    // Phase 2: 대규모 테스트 (100K → 1M)
+    console.log('📊 Phase 2: Scaling to 1M records...');
+    const start2 = Date.now();
+    for (let i = 100000; i < 1000000; i++) {
+        db.insert('clone_results', {
+            id: i,
+            app: ['proof_ai', 'cwm', 'freelang', 'kim_ai_os'][i % 4],
+            clone_id: i,
+            status: Math.random() > 0.01 ? 'success' : 'failed',
+            test_time_ms: Math.random() * 100
+        });
+    }
+    const time2 = Date.now() - start2;
+    stats1 = db.getStats('clone_results');
+    console.log(`✅ 900K inserted in ${time2}ms`);
+    console.log(`   Total: ${stats1.rows} rows, Memory: ${stats1.memory_mb}MB\n`);
+    // Phase 3: 쿼리 성능 (SELECT)
+    console.log('📊 Phase 3: Query Performance...');
+    const queries = 10000;
+    const start3 = Date.now();
+    for (let i = 0; i < queries; i++) {
+        const randomId = Math.floor(Math.random() * 1000000);
+        db.selectById('clone_results', randomId);
+    }
+    const time3 = Date.now() - start3;
+    const qps = Math.round((queries / time3) * 1000);
+    console.log(`✅ ${queries} queries in ${time3}ms`);
+    console.log(`   ${qps.toLocaleString()} queries/sec\n`);
+    // Phase 4: BULK INSERT 성능
+    console.log('📊 Phase 4: Bulk Insert (추가 100K)...');
+    const bulkRecords = [];
+    for (let i = 1000000; i < 1100000; i++) {
+        bulkRecords.push({
+            id: i,
+            app: ['proof_ai', 'cwm', 'freelang', 'kim_ai_os'][i % 4],
+            clone_id: i,
+            status: 'success',
+            test_time_ms: Math.random() * 100
+        });
+    }
+    const start4 = Date.now();
+    const inserted = db.bulkInsert('clone_results', bulkRecords);
+    const time4 = Date.now() - start4;
+    stats1 = db.getStats('clone_results');
+    console.log(`✅ ${inserted.toLocaleString()} records inserted in ${time4}ms`);
+    console.log(`   Total: ${stats1.rows.toLocaleString()} rows, Memory: ${stats1.memory_mb}MB`);
+    console.log(`   Rate: ${Math.round((inserted / time4) * 1000).toLocaleString()} inserts/sec\n`);
+    // 최종 리포트
+    console.log('═══════════════════════════════════════════════');
+    console.log('📊 FINAL REPORT');
+    console.log('═══════════════════════════════════════════════\n');
+    const finalStats = db.getStats('clone_results');
+    console.log(`Table:          clone_results`);
+    console.log(`Total Records:  ${finalStats.rows.toLocaleString()}`);
+    console.log(`Memory Used:    ${finalStats.memory_mb}MB`);
+    console.log(`Avg Per Record: ${(finalStats.memory_mb * 1024 / finalStats.rows).toFixed(2)}KB\n`);
+    console.log(`Operations Summary:`);
+    console.log(`  Phase 1 (100K):  ${time1}ms`);
+    console.log(`  Phase 2 (900K):  ${time2}ms`);
+    console.log(`  Phase 3 (Queries): ${time3}ms (${qps.toLocaleString()} qps)`);
+    console.log(`  Phase 4 (Bulk):  ${time4}ms (${Math.round((inserted / time4) * 1000).toLocaleString()} inserts/sec)`);
+    console.log('\n✅ FreeLang v4 Database Test Complete!');
+}
+main().catch(console.error);
+//# sourceMappingURL=db-runtime.js.map

package/dist/db-runtime.js.map

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

package/dist/db.d.ts

@@ -0,0 +1,249 @@
+/**
+ * FreeLang Database API
+ * 모든 데이터베이스 작업을 통일된 인터페이스로 제공
+ */
+export interface Row {
+    [key: string]: any;
+}
+export interface QueryResult {
+    rows: Row[];
+    changes: number;
+}
+export interface TransactionOptions {
+    isolation?: "deferred" | "immediate" | "exclusive";
+}
+/**
+ * 모든 DB 드라이버가 구현해야 하는 공통 인터페이스
+ */
+export interface DBAdapter {
+    query(sql: string, params?: any[]): Promise<Row[]>;
+    execute(sql: string, params?: any[]): Promise<{
+        changes: number;
+    }>;
+    begin(isolation?: string): Promise<void>;
+    commit(): Promise<void>;
+    rollback(): Promise<void>;
+    close(): Promise<void>;
+    readonly driverName: string;
+}
+/**
+ * SQLite 데이터베이스 구현 (sql.js 기반)
+ */
+export declare class SQLiteDB implements DBAdapter {
+    private db;
+    private filename;
+    private inTransaction;
+    private initialized;
+    readonly driverName = "sqlite";
+    constructor(filename: string);
+    /**
+     * 초기화 (비동기)
+     */
+    init(): Promise<void>;
+    /**
+     * 디스크에 저장
+     */
+    save(): void;
+    /**
+     * SELECT 쿼리 실행
+     */
+    query(sql: string, params?: any[]): Promise<Row[]>;
+    /**
+     * 단일 행 조회
+     */
+    queryOne(sql: string, params?: any[]): Promise<Row | null>;
+    /**
+     * INSERT/UPDATE/DELETE 실행
+     */
+    execute(sql: string, params?: any[]): Promise<{
+        changes: number;
+    }>;
+    /**
+     * 트랜잭션 실행
+     */
+    transaction<T>(callback: () => Promise<T> | T): Promise<T>;
+    /**
+     * 트랜잭션 시작 (수동)
+     */
+    begin(isolation?: "deferred" | "immediate" | "exclusive"): Promise<void>;
+    /**
+     * 트랜잭션 커밋
+     */
+    commit(): Promise<void>;
+    /**
+     * 트랜잭션 롤백
+     */
+    rollback(): Promise<void>;
+    /**
+     * 테이블 생성
+     */
+    createTable(tableName: string, columns: {
+        [key: string]: string;
+    }): Promise<void>;
+    /**
+     * 테이블 삭제
+     */
+    dropTable(tableName: string): Promise<void>;
+    /**
+     * 모든 테이블 목록
+     */
+    listTables(): Promise<string[]>;
+    /**
+     * 테이블 스키마 조회
+     */
+    getTableSchema(tableName: string): Promise<any[]>;
+    /**
+     * 데이터베이스 연결 종료
+     */
+    close(): Promise<void>;
+    /**
+     * 데이터베이스 정보
+     */
+    getInfo(): {
+        filename: string;
+        initialized: boolean;
+        inTransaction: boolean;
+    };
+}
+/**
+ * 쿼리 빌더
+ */
+export declare class QueryBuilder {
+    private table;
+    private whereConditions;
+    private orderByClause;
+    private limitValue;
+    private offsetValue;
+    private selectColumns;
+    private joinClauses;
+    private params;
+    constructor(table: string);
+    select(...columns: string[]): QueryBuilder;
+    where(condition: string, ...params: any[]): QueryBuilder;
+    join(table: string, on: string): QueryBuilder;
+    orderBy(column: string, direction?: "ASC" | "DESC"): QueryBuilder;
+    limit(n: number): QueryBuilder;
+    offset(n: number): QueryBuilder;
+    build(): {
+        sql: string;
+        params: any[];
+    };
+    execute(db: SQLiteDB): Promise<Row[]>;
+}
+/**
+ * 마이그레이션 관리자
+ */
+export declare class MigrationManager {
+    private db;
+    private migrationsDir;
+    constructor(db: SQLiteDB, migrationsDir?: string);
+    private init;
+    /**
+     * 모든 마이그레이션 실행
+     */
+    up(): Promise<void>;
+    /**
+     * 마이그레이션 이력 조회
+     */
+    status(): Promise<Row[]>;
+    /**
+     * 마이그레이션 롤백 (역순 실행)
+     */
+    down(): Promise<void>;
+}
+/**
+ * PostgreSQL 데이터베이스 구현 (pg 드라이버 기반)
+ */
+export declare class PostgreSQLDB implements DBAdapter {
+    private config;
+    private client;
+    private connected;
+    readonly driverName = "postgresql";
+    constructor(config: {
+        host: string;
+        port: number;
+        user: string;
+        password: string;
+        database: string;
+    });
+    /**
+     * 연결 초기화
+     */
+    connect(): Promise<void>;
+    /**
+     * SQL 플레이스홀더 변환 (? → $1, $2, ...)
+     */
+    private convertPlaceholders;
+    /**
+     * SELECT 쿼리 실행
+     */
+    query(sql: string, params?: any[]): Promise<Row[]>;
+    /**
+     * INSERT/UPDATE/DELETE 실행
+     */
+    execute(sql: string, params?: any[]): Promise<{
+        changes: number;
+    }>;
+    /**
+     * 트랜잭션 시작
+     */
+    begin(isolation?: string): Promise<void>;
+    /**
+     * 트랜잭션 커밋
+     */
+    commit(): Promise<void>;
+    /**
+     * 트랜잭션 롤백
+     */
+    rollback(): Promise<void>;
+    /**
+     * 연결 종료
+     */
+    close(): Promise<void>;
+}
+/**
+ * MySQL 데이터베이스 구현 (mysql2/promise 드라이버 기반)
+ */
+export declare class MySQLDB implements DBAdapter {
+    private config;
+    private conn;
+    private connected;
+    readonly driverName = "mysql";
+    constructor(config: {
+        host: string;
+        port: number;
+        user: string;
+        password: string;
+        database: string;
+    });
+    /**
+     * 연결 초기화
+     */
+    connect(): Promise<void>;
+    /**
+     * SELECT 쿼리 실행
+     */
+    query(sql: string, params?: any[]): Promise<Row[]>;
+    /**
+     * INSERT/UPDATE/DELETE 실행
+     */
+    execute(sql: string, params?: any[]): Promise<{
+        changes: number;
+    }>;
+    /**
+     * 트랜잭션 시작
+     */
+    begin(isolation?: string): Promise<void>;
+    /**
+     * 트랜잭션 커밋
+     */
+    commit(): Promise<void>;
+    /**
+     * 트랜잭션 롤백
+     */
+    rollback(): Promise<void>;
+    /**
+     * 연결 종료
+     */
+    close(): Promise<void>;
+}