@open-core/framework 0.2.9 → 0.3.0

package/dist/runtime/server/database/database.service.d.ts

@@ -1,188 +0,0 @@
-import { DatabaseContract } from './database.contract';
-import { DatabaseConfig, ExecuteResult, InsertResult, TransactionInput, TransactionSharedParams } from './types';
-export declare class DatabaseService extends DatabaseContract {
-    private adapter;
-    private isInitialized;
-    /**
-     * Initialize the database service with optional configuration
-     *
-     * @param config - Database configuration options
-     */
-    initialize(config?: DatabaseConfig): void;
-    /**
-     * Check if the service is initialized
-     */
-    get initialized(): boolean;
-    /**
-     * Register a custom database adapter
-     *
-     * @param adapter - Custom adapter implementing DatabaseContract
-     *
-     * @example
-     * ```typescript
-     * class CustomAdapter extends DatabaseContract {
-     *   // Implementation
-     * }
-     *
-     * db.setAdapter(new CustomAdapter())
-     * ```
-     */
-    setAdapter(adapter: DatabaseContract): void;
-    /**
-     * Get the current adapter
-     */
-    getAdapter(): DatabaseContract;
-    /**
-     * Ensure the service is initialized and return the adapter
-     */
-    private getInitializedAdapter;
-    /**
-     * Execute a query and return all matching rows
-     */
-    query<T = any>(sql: string, params?: any[]): Promise<T[]>;
-    /**
-     * Execute a query and return a single row
-     */
-    single<T = any>(sql: string, params?: any[]): Promise<T | null>;
-    /**
-     * Execute a query and return a single scalar value
-     */
-    scalar<T = any>(sql: string, params?: any[]): Promise<T | null>;
-    /**
-     * Execute an UPDATE or DELETE statement
-     */
-    execute(sql: string, params?: any[]): Promise<ExecuteResult>;
-    /**
-     * Execute an INSERT statement
-     */
-    insert(sql: string, params?: any[]): Promise<InsertResult>;
-    /**
-     * Execute multiple queries within a transaction
-     */
-    transaction(queries: TransactionInput, sharedParams?: TransactionSharedParams): Promise<boolean>;
-}
-/**
- * Get the global DatabaseService instance
- *
- * @returns The singleton DatabaseService instance
- *
- * @example
- * ```typescript
- * import { getDatabaseService } from '@open-core/framework/server'
- *
- * const db = getDatabaseService()
- * const users = await db.query('SELECT * FROM users')
- * ```
- */
-export declare function getDatabaseService(): DatabaseService;
-/**
- * Initialize the database service
- *
- * @param config - Database configuration options
- *
- * @example
- * ```typescript
- * import { initDatabase } from '@open-core/framework/server'
- *
- * // Initialize with default oxmysql adapter
- * initDatabase()
- *
- * // Or with custom config
- * initDatabase({ debug: true })
- * ```
- */
-export declare function initDatabase(config?: DatabaseConfig): void;
-/**
- * Standalone query function
- *
- * @example
- * ```typescript
- * import { query } from '@open-core/framework/server'
- *
- * const users = await query<User>('SELECT * FROM users WHERE active = ?', [true])
- * ```
- */
-export declare function query<T = any>(sql: string, params?: any[]): Promise<T[]>;
-/**
- * Standalone single function
- *
- * @example
- * ```typescript
- * import { single } from '@open-core/framework/server'
- *
- * const user = await single<User>('SELECT * FROM users WHERE id = ?', [userId])
- * ```
- */
-export declare function single<T = any>(sql: string, params?: any[]): Promise<T | null>;
-/**
- * Standalone scalar function
- *
- * @example
- * ```typescript
- * import { scalar } from '@open-core/framework/server'
- *
- * const count = await scalar<number>('SELECT COUNT(*) FROM users')
- * ```
- */
-export declare function scalar<T = any>(sql: string, params?: any[]): Promise<T | null>;
-/**
- * Standalone execute function
- *
- * @example
- * ```typescript
- * import { execute } from '@open-core/framework/server'
- *
- * const result = await execute('UPDATE users SET active = ? WHERE id = ?', [false, userId])
- * console.log(`Updated ${result.affectedRows} rows`)
- * ```
- */
-export declare function execute(sql: string, params?: any[]): Promise<ExecuteResult>;
-/**
- * Standalone insert function
- *
- * @example
- * ```typescript
- * import { insert } from '@open-core/framework/server'
- *
- * const result = await insert('INSERT INTO users (name) VALUES (?)', ['John'])
- * console.log(`Inserted with ID: ${result.insertId}`)
- * ```
- */
-export declare function insert(sql: string, params?: any[]): Promise<InsertResult>;
-/**
- * Standalone transaction function
- *
- * Execute multiple queries atomically. All succeed or all fail.
- *
- * @example Specific format (each query has its own params)
- * ```typescript
- * import { transaction } from '@open-core/framework/server'
- *
- * const success = await transaction([
- *   { query: 'INSERT INTO users (name) VALUES (?)', values: ['John'] },
- *   { query: 'INSERT INTO logs (action) VALUES (?)', values: ['user_created'] },
- * ])
- * ```
- *
- * @example Tuple format
- * ```typescript
- * const success = await transaction([
- *   ['INSERT INTO users (name) VALUES (?)', ['John']],
- *   ['INSERT INTO logs (action) VALUES (?)', ['user_created']],
- * ])
- * ```
- *
- * @example Shared format (named parameters)
- * ```typescript
- * const success = await transaction(
- *   [
- *     'INSERT INTO users (id, name) VALUES (@userid, @username)',
- *     'INSERT INTO profiles (user_id) VALUES (@userid)',
- *   ],
- *   { userid: 1, username: 'John' }
- * )
- * ```
- *
- * @see https://coxdocs.dev/oxmysql/Functions/transaction
- */
-export declare function transaction(queries: TransactionInput, sharedParams?: TransactionSharedParams): Promise<boolean>;

package/dist/runtime/server/database/database.service.js

@@ -1,287 +0,0 @@
-"use strict";
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DatabaseService = void 0;
-exports.getDatabaseService = getDatabaseService;
-exports.initDatabase = initDatabase;
-exports.query = query;
-exports.single = single;
-exports.scalar = scalar;
-exports.execute = execute;
-exports.insert = insert;
-exports.transaction = transaction;
-const tsyringe_1 = require("tsyringe");
-const oxmysql_adapter_1 = require("../../../adapters/database/oxmysql.adapter");
-const resource_adapter_1 = require("../../../adapters/database/resource.adapter");
-const adapter_registry_1 = require("./adapter.registry");
-const database_contract_1 = require("./database.contract");
-let defaultFactoriesRegistered = false;
-function registerDefaultDatabaseFactories() {
-    if (defaultFactoriesRegistered)
-        return;
-    (0, adapter_registry_1.registerDatabaseAdapterFactory)('resource', () => new resource_adapter_1.ResourceDatabaseAdapter());
-    (0, adapter_registry_1.registerDatabaseAdapterFactory)('oxmysql', () => new oxmysql_adapter_1.OxMySQLAdapter());
-    defaultFactoriesRegistered = true;
-}
-let DatabaseService = class DatabaseService extends database_contract_1.DatabaseContract {
-    constructor() {
-        super(...arguments);
-        this.adapter = null;
-        this.isInitialized = false;
-    }
-    /**
-     * Initialize the database service with optional configuration
-     *
-     * @param config - Database configuration options
-     */
-    initialize(config = {}) {
-        var _a, _b;
-        if (this.isInitialized)
-            return;
-        registerDefaultDatabaseFactories();
-        if (!this.adapter) {
-            const adapterName = ((_a = config.adapter) === null || _a === void 0 ? void 0 : _a.trim()) || ((_b = globalThis.GetConvar) === null || _b === void 0 ? void 0 : _b.call(globalThis, 'opencore_db_adapter', '')) || '';
-            if (!adapterName) {
-                throw new Error("[OpenCore] Database adapter is not configured. Set 'opencore_db_adapter' (recommended: 'resource') or call initDatabase({ adapter: 'resource' }).");
-            }
-            const factory = (0, adapter_registry_1.resolveDatabaseAdapterFactory)(adapterName);
-            if (!factory) {
-                throw new Error(`[OpenCore] Unknown database adapter '${adapterName}'. Register it via registerDatabaseAdapterFactory('${adapterName}', factory).`);
-            }
-            this.adapter = factory();
-        }
-        this.isInitialized = true;
-    }
-    /**
-     * Check if the service is initialized
-     */
-    get initialized() {
-        return this.isInitialized;
-    }
-    /**
-     * Register a custom database adapter
-     *
-     * @param adapter - Custom adapter implementing DatabaseContract
-     *
-     * @example
-     * ```typescript
-     * class CustomAdapter extends DatabaseContract {
-     *   // Implementation
-     * }
-     *
-     * db.setAdapter(new CustomAdapter())
-     * ```
-     */
-    setAdapter(adapter) {
-        this.adapter = adapter;
-    }
-    /**
-     * Get the current adapter
-     */
-    getAdapter() {
-        return this.getInitializedAdapter();
-    }
-    /**
-     * Ensure the service is initialized and return the adapter
-     */
-    getInitializedAdapter() {
-        if (!this.isInitialized) {
-            this.initialize();
-        }
-        if (!this.adapter) {
-            throw new Error('[OpenCore] Database adapter not initialized');
-        }
-        return this.adapter;
-    }
-    /**
-     * Execute a query and return all matching rows
-     */
-    async query(sql, params) {
-        return this.getInitializedAdapter().query(sql, params);
-    }
-    /**
-     * Execute a query and return a single row
-     */
-    async single(sql, params) {
-        return this.getInitializedAdapter().single(sql, params);
-    }
-    /**
-     * Execute a query and return a single scalar value
-     */
-    async scalar(sql, params) {
-        return this.getInitializedAdapter().scalar(sql, params);
-    }
-    /**
-     * Execute an UPDATE or DELETE statement
-     */
-    async execute(sql, params) {
-        return this.getInitializedAdapter().execute(sql, params);
-    }
-    /**
-     * Execute an INSERT statement
-     */
-    async insert(sql, params) {
-        return this.getInitializedAdapter().insert(sql, params);
-    }
-    /**
-     * Execute multiple queries within a transaction
-     */
-    async transaction(queries, sharedParams) {
-        return this.getInitializedAdapter().transaction(queries, sharedParams);
-    }
-};
-exports.DatabaseService = DatabaseService;
-exports.DatabaseService = DatabaseService = __decorate([
-    (0, tsyringe_1.injectable)()
-], DatabaseService);
-// Singleton instance for standalone usage
-let databaseServiceInstance = null;
-/**
- * Get the global DatabaseService instance
- *
- * @returns The singleton DatabaseService instance
- *
- * @example
- * ```typescript
- * import { getDatabaseService } from '@open-core/framework/server'
- *
- * const db = getDatabaseService()
- * const users = await db.query('SELECT * FROM users')
- * ```
- */
-function getDatabaseService() {
-    if (!databaseServiceInstance) {
-        databaseServiceInstance = new DatabaseService();
-    }
-    return databaseServiceInstance;
-}
-/**
- * Initialize the database service
- *
- * @param config - Database configuration options
- *
- * @example
- * ```typescript
- * import { initDatabase } from '@open-core/framework/server'
- *
- * // Initialize with default oxmysql adapter
- * initDatabase()
- *
- * // Or with custom config
- * initDatabase({ debug: true })
- * ```
- */
-function initDatabase(config = {}) {
-    getDatabaseService().initialize(config);
-}
-/**
- * Standalone query function
- *
- * @example
- * ```typescript
- * import { query } from '@open-core/framework/server'
- *
- * const users = await query<User>('SELECT * FROM users WHERE active = ?', [true])
- * ```
- */
-async function query(sql, params) {
-    return getDatabaseService().query(sql, params);
-}
-/**
- * Standalone single function
- *
- * @example
- * ```typescript
- * import { single } from '@open-core/framework/server'
- *
- * const user = await single<User>('SELECT * FROM users WHERE id = ?', [userId])
- * ```
- */
-async function single(sql, params) {
-    return getDatabaseService().single(sql, params);
-}
-/**
- * Standalone scalar function
- *
- * @example
- * ```typescript
- * import { scalar } from '@open-core/framework/server'
- *
- * const count = await scalar<number>('SELECT COUNT(*) FROM users')
- * ```
- */
-async function scalar(sql, params) {
-    return getDatabaseService().scalar(sql, params);
-}
-/**
- * Standalone execute function
- *
- * @example
- * ```typescript
- * import { execute } from '@open-core/framework/server'
- *
- * const result = await execute('UPDATE users SET active = ? WHERE id = ?', [false, userId])
- * console.log(`Updated ${result.affectedRows} rows`)
- * ```
- */
-async function execute(sql, params) {
-    return getDatabaseService().execute(sql, params);
-}
-/**
- * Standalone insert function
- *
- * @example
- * ```typescript
- * import { insert } from '@open-core/framework/server'
- *
- * const result = await insert('INSERT INTO users (name) VALUES (?)', ['John'])
- * console.log(`Inserted with ID: ${result.insertId}`)
- * ```
- */
-async function insert(sql, params) {
-    return getDatabaseService().insert(sql, params);
-}
-/**
- * Standalone transaction function
- *
- * Execute multiple queries atomically. All succeed or all fail.
- *
- * @example Specific format (each query has its own params)
- * ```typescript
- * import { transaction } from '@open-core/framework/server'
- *
- * const success = await transaction([
- *   { query: 'INSERT INTO users (name) VALUES (?)', values: ['John'] },
- *   { query: 'INSERT INTO logs (action) VALUES (?)', values: ['user_created'] },
- * ])
- * ```
- *
- * @example Tuple format
- * ```typescript
- * const success = await transaction([
- *   ['INSERT INTO users (name) VALUES (?)', ['John']],
- *   ['INSERT INTO logs (action) VALUES (?)', ['user_created']],
- * ])
- * ```
- *
- * @example Shared format (named parameters)
- * ```typescript
- * const success = await transaction(
- *   [
- *     'INSERT INTO users (id, name) VALUES (@userid, @username)',
- *     'INSERT INTO profiles (user_id) VALUES (@userid)',
- *   ],
- *   { userid: 1, username: 'John' }
- * )
- * ```
- *
- * @see https://coxdocs.dev/oxmysql/Functions/transaction
- */
-async function transaction(queries, sharedParams) {
-    return getDatabaseService().transaction(queries, sharedParams);
-}

package/dist/runtime/server/database/index.d.ts

@@ -1,5 +0,0 @@
-export { ResourceDatabaseAdapter } from '../../../adapters/database/resource.adapter';
-export { registerDatabaseAdapterFactory, resolveDatabaseAdapterFactory } from './adapter.registry';
-export { DatabaseContract } from './database.contract';
-export { DatabaseService, execute, getDatabaseService, initDatabase, insert, query, scalar, single, transaction, } from './database.service';
-export type { DatabaseAdapterFactory, DatabaseConfig, ExecuteResult, InsertResult, TransactionInput, TransactionQuery, TransactionQueryTuple, TransactionSharedParams, } from './types';

package/dist/runtime/server/database/index.js

@@ -1,25 +0,0 @@
-"use strict";
-// Types
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.transaction = exports.single = exports.scalar = exports.query = exports.insert = exports.initDatabase = exports.getDatabaseService = exports.execute = exports.DatabaseService = exports.DatabaseContract = exports.resolveDatabaseAdapterFactory = exports.registerDatabaseAdapterFactory = exports.ResourceDatabaseAdapter = void 0;
-// Adapters
-var resource_adapter_1 = require("../../../adapters/database/resource.adapter");
-Object.defineProperty(exports, "ResourceDatabaseAdapter", { enumerable: true, get: function () { return resource_adapter_1.ResourceDatabaseAdapter; } });
-var adapter_registry_1 = require("./adapter.registry");
-Object.defineProperty(exports, "registerDatabaseAdapterFactory", { enumerable: true, get: function () { return adapter_registry_1.registerDatabaseAdapterFactory; } });
-Object.defineProperty(exports, "resolveDatabaseAdapterFactory", { enumerable: true, get: function () { return adapter_registry_1.resolveDatabaseAdapterFactory; } });
-// Contract
-var database_contract_1 = require("./database.contract");
-Object.defineProperty(exports, "DatabaseContract", { enumerable: true, get: function () { return database_contract_1.DatabaseContract; } });
-// Service
-// Standalone functions
-var database_service_1 = require("./database.service");
-Object.defineProperty(exports, "DatabaseService", { enumerable: true, get: function () { return database_service_1.DatabaseService; } });
-Object.defineProperty(exports, "execute", { enumerable: true, get: function () { return database_service_1.execute; } });
-Object.defineProperty(exports, "getDatabaseService", { enumerable: true, get: function () { return database_service_1.getDatabaseService; } });
-Object.defineProperty(exports, "initDatabase", { enumerable: true, get: function () { return database_service_1.initDatabase; } });
-Object.defineProperty(exports, "insert", { enumerable: true, get: function () { return database_service_1.insert; } });
-Object.defineProperty(exports, "query", { enumerable: true, get: function () { return database_service_1.query; } });
-Object.defineProperty(exports, "scalar", { enumerable: true, get: function () { return database_service_1.scalar; } });
-Object.defineProperty(exports, "single", { enumerable: true, get: function () { return database_service_1.single; } });
-Object.defineProperty(exports, "transaction", { enumerable: true, get: function () { return database_service_1.transaction; } });

package/dist/runtime/server/database/types.d.ts

@@ -1,67 +0,0 @@
-/**
- * Database Module Types
- *
- * Core types for the database abstraction layer.
- */
-/**
- * Result of an execute/update operation
- */
-export interface ExecuteResult {
-    /** Number of rows affected by the operation */
-    affectedRows: number;
-}
-/**
- * Result of an insert operation
- */
-export interface InsertResult {
-    /** The auto-generated ID of the inserted row */
-    insertId: number;
-}
-/**
- * Configuration for database adapters
- */
-export interface DatabaseConfig {
-    /** Adapter identifier (e.g., 'oxmysql', 'mysql-async') */
-    adapter?: string;
-    /** Enable debug logging */
-    debug?: boolean;
-    /** Connection timeout in milliseconds */
-    timeout?: number;
-}
-/**
- * Transaction query definition for oxmysql (specific format)
- *
- * @see https://coxdocs.dev/oxmysql/Functions/transaction
- */
-export interface TransactionQuery {
-    query: string;
-    /** Parameter values for the query (oxmysql uses 'values') */
-    values?: any[];
-}
-/**
- * Transaction query as tuple format [query, values]
- */
-export type TransactionQueryTuple = [string, any[]?];
-/**
- * Shared parameters for transaction queries (named parameters format)
- *
- * @example
- * ```typescript
- * const params: TransactionSharedParams = {
- *   someid: 2,
- *   somename: 'John Doe',
- *   newname: 'John Notdoe'
- * }
- * ```
- */
-export interface TransactionSharedParams {
-    [key: string]: any;
-}
-/**
- * Transaction input - can be specific format, tuple format, or just strings
- */
-export type TransactionInput = TransactionQuery[] | TransactionQueryTuple[] | string[];
-/**
- * Database adapter factory function type
- */
-export type DatabaseAdapterFactory = () => import('./database.contract').DatabaseContract;

package/dist/runtime/server/database/types.js

@@ -1,7 +0,0 @@
-"use strict";
-/**
- * Database Module Types
- *
- * Core types for the database abstraction layer.
- */
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/runtime/server/database.d.ts

@@ -1,7 +0,0 @@
-/**
- * Database Module Re-export
- *
- * This file re-exports the database module for backwards compatibility.
- * Prefer importing directly from '@open-core/framework/server' or './database/index'
- */
-export * from './database/index';

package/dist/runtime/server/devmode/hot-reload.server.d.ts

@@ -1,74 +0,0 @@
-import { HotReloadOptions } from './types';
-/**
- * Log message structure for HTTP transport.
- */
-export interface LogMessage {
-    level: number;
-    domain: string;
-    message: string;
-    timestamp: number;
-    context?: Record<string, unknown>;
-    error?: {
-        name: string;
-        message: string;
-        stack?: string;
-    };
-}
-/**
- * HTTP server for handling hot reload requests from the CLI.
- *
- * Provides an endpoint that the CLI can call to restart resources
- * after file changes are detected.
- *
- * @example
- * ```typescript
- * const server = new HotReloadServer({ enabled: true, port: 3847 })
- * server.start()
- * // CLI calls POST /restart?resource=my-resource
- * ```
- */
-export declare class HotReloadServer {
-    private server;
-    private options;
-    private logBuffer;
-    private maxLogBuffer;
-    private logListeners;
-    constructor(options: HotReloadOptions);
-    /**
-     * Adds logs to the buffer (called by HttpLogTransport).
-     */
-    addLogs(logs: LogMessage[]): void;
-    /**
-     * Gets and clears buffered logs.
-     */
-    consumeLogs(): LogMessage[];
-    /**
-     * Adds a listener for new logs.
-     */
-    onLogs(listener: (logs: LogMessage[]) => void): () => void;
-    /**
-     * Starts the hot reload HTTP server.
-     */
-    start(): void;
-    /**
-     * Stops the hot reload server.
-     */
-    stop(): void;
-    /**
-     * Checks if the server is running.
-     */
-    isRunning(): boolean;
-    private handleRequest;
-    private handleRestart;
-    private handleRefresh;
-    private handleHealth;
-    private isResourceAllowed;
-    /**
-     * Handles GET /logs - CLI polls for buffered logs.
-     */
-    private handleGetLogs;
-    /**
-     * Handles POST /logs - Framework pushes logs to buffer.
-     */
-    private handlePostLogs;
-}