@hylithiumjs.com/core 1.1.3 → 1.1.5

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export * from "./types";
-import type { EventHandler, EventType, EventTitleUtil as EventTitleUtilType } from "./types";
+import type { EventHandler, EventType, EventTitleUtil as EventTitleUtilType, MySQLManager as MySQLManagerType, TableBuilderConstructor } from "./types";
 export declare const EventTitleUtil: EventTitleUtilType;
+export declare const MySQL: MySQLManagerType;
+export declare const TableBuilder: TableBuilderConstructor;
 export declare const handlers: EventHandler[];
 export declare function EventListener(eventType: EventType): (target: unknown, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAG7F,eAAO,MAAM,cAAc,EAAyC,kBAAkB,CAAC;AAGvF,eAAO,MAAM,QAAQ,EAAE,YAAY,EAAwE,CAAC;AAE5G,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,IAC/B,QAAQ,OAAO,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,wBAOtF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,cAAc,IAAI,kBAAkB,EACpC,YAAY,IAAI,gBAAgB,EAChC,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAGjB,eAAO,MAAM,cAAc,EAAyC,kBAAkB,CAAC;AAGvF,eAAO,MAAM,KAAK,EAAuC,gBAAgB,CAAC;AAC1E,eAAO,MAAM,YAAY,EAAuC,uBAAuB,CAAC;AAExF,eAAO,MAAM,QAAQ,EAAE,YAAY,EAAwE,CAAC;AAE5G,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,IAC/B,QAAQ,OAAO,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,wBAOtF"}

package/dist/index.js

@@ -1,6 +1,9 @@
 export * from "./types";
 // Exportar EventTitleUtil como valor (injetado pelo Java runtime)
 export const EventTitleUtil = globalThis.EventTitleUtil;
+// MySQL exports (injetado pelo Java runtime)
+export const MySQL = globalThis.MySQLManager;
+export const TableBuilder = globalThis.TableBuilder;
 // Usar array global existente ou criar novo (evita sobrescrever handlers de outros plugins)
 export const handlers = globalThis.handlers || (globalThis.handlers = []);
 export function EventListener(eventType) {

package/dist/types.d.ts

@@ -1,3 +1,301 @@
+/**
+ * Represents a row returned from a MySQL query.
+ * Keys are column names, values are the column data.
+ */
+export interface MySQLRow {
+    [key: string]: string | number | boolean | null | Date;
+}
+/**
+ * Column information returned from getColumns().
+ */
+export interface MySQLColumnInfo {
+    name: string;
+    type: string;
+    size: number;
+    nullable: boolean;
+}
+/**
+ * MySQL Manager for database connections and operations.
+ * Uses HikariCP connection pooling for efficient connection management.
+ */
+export interface MySQLManager {
+    /**
+     * Gets the singleton instance of MySQLManager.
+     */
+    getInstance(): MySQLManager;
+    /**
+     * Connects to a MySQL database.
+     * @param host Database host
+     * @param port Database port (typically 3306)
+     * @param database Database name
+     * @param user Username
+     * @param password Password
+     * @returns true if connection successful
+     */
+    connect(host: string, port: number, database: string, user: string, password: string): boolean;
+    /**
+     * Disconnects from the database and closes the connection pool.
+     */
+    disconnect(): void;
+    /**
+     * Checks if currently connected to the database.
+     */
+    isConnected(): boolean;
+    /**
+     * Executes an UPDATE, INSERT, or DELETE statement.
+     * @param sql SQL statement
+     * @returns Number of affected rows, or -1 on error
+     */
+    executeUpdate(sql: string): number;
+    /**
+     * Executes a SELECT query and returns results.
+     * @param sql SQL query
+     * @returns Array of row objects
+     */
+    executeQuery(sql: string): MySQLRow[];
+    /**
+     * Creates a prepared statement builder.
+     * @param sql SQL with ? placeholders
+     * @returns PreparedStatementBuilder instance
+     */
+    prepareStatement(sql: string): PreparedStatementBuilder;
+    /**
+     * Creates a table using a TableBuilder.
+     * @param builder TableBuilder instance
+     * @returns true if table created successfully
+     */
+    createTable(builder: TableBuilder): boolean;
+    /**
+     * Drops a table.
+     * @param tableName Table name
+     * @returns true if table dropped successfully
+     */
+    dropTable(tableName: string): boolean;
+    /**
+     * Checks if a table exists.
+     * @param tableName Table name
+     * @returns true if table exists
+     */
+    tableExists(tableName: string): boolean;
+    /**
+     * Truncates a table (removes all data).
+     * @param tableName Table name
+     * @returns true if successful
+     */
+    truncateTable(tableName: string): boolean;
+    /**
+     * Gets all table names in the current database.
+     * @returns Array of table names
+     */
+    getTables(): string[];
+    /**
+     * Gets column info for a table.
+     * @param tableName Table name
+     * @returns Array of column info objects
+     */
+    getColumns(tableName: string): MySQLColumnInfo[];
+    /**
+     * Begins a transaction.
+     * @returns Transaction instance
+     */
+    beginTransaction(): MySQLTransaction;
+}
+/**
+ * Transaction wrapper for atomic database operations.
+ */
+export interface MySQLTransaction {
+    /**
+     * Executes an UPDATE within the transaction.
+     */
+    executeUpdate(sql: string): number;
+    /**
+     * Creates a prepared statement within the transaction.
+     */
+    prepareStatement(sql: string): PreparedStatementBuilder;
+    /**
+     * Commits the transaction.
+     */
+    commit(): boolean;
+    /**
+     * Rolls back the transaction.
+     */
+    rollback(): boolean;
+}
+/**
+ * Prepared Statement Builder for safe parameterized SQL queries.
+ * Prevents SQL injection by using parameterized queries.
+ */
+export interface PreparedStatementBuilder {
+    /**
+     * Sets a string parameter.
+     * @param index Parameter index (1-based)
+     * @param value String value
+     */
+    setString(index: number, value: string): PreparedStatementBuilder;
+    /**
+     * Sets an integer parameter.
+     * @param index Parameter index (1-based)
+     * @param value Integer value
+     */
+    setInt(index: number, value: number): PreparedStatementBuilder;
+    /**
+     * Sets a long parameter.
+     * @param index Parameter index (1-based)
+     * @param value Long value
+     */
+    setLong(index: number, value: number): PreparedStatementBuilder;
+    /**
+     * Sets a double parameter.
+     * @param index Parameter index (1-based)
+     * @param value Double value
+     */
+    setDouble(index: number, value: number): PreparedStatementBuilder;
+    /**
+     * Sets a float parameter.
+     * @param index Parameter index (1-based)
+     * @param value Float value
+     */
+    setFloat(index: number, value: number): PreparedStatementBuilder;
+    /**
+     * Sets a boolean parameter.
+     * @param index Parameter index (1-based)
+     * @param value Boolean value
+     */
+    setBoolean(index: number, value: boolean): PreparedStatementBuilder;
+    /**
+     * Sets a null parameter.
+     * @param index Parameter index (1-based)
+     */
+    setNull(index: number): PreparedStatementBuilder;
+    /**
+     * Sets a timestamp parameter.
+     * @param index Parameter index (1-based)
+     * @param timestamp Unix timestamp in milliseconds
+     */
+    setTimestamp(index: number, timestamp: number): PreparedStatementBuilder;
+    /**
+     * Executes an UPDATE, INSERT, or DELETE statement.
+     * @returns Number of affected rows, or -1 on error
+     */
+    executeUpdate(): number;
+    /**
+     * Executes an INSERT and returns the generated key.
+     * @returns Generated key, or -1 on error
+     */
+    executeInsert(): number;
+    /**
+     * Executes a SELECT query and returns results.
+     * @returns Array of row objects
+     */
+    executeQuery(): MySQLRow[];
+    /**
+     * Executes a SELECT query and returns the first result.
+     * @returns First row object, or null if no results
+     */
+    executeQuerySingle(): MySQLRow | null;
+}
+/**
+ * Fluent builder for creating MySQL CREATE TABLE statements.
+ */
+export interface TableBuilder {
+    /**
+     * Adds a column with type only.
+     * @param name Column name
+     * @param type Column type (e.g., "INT", "VARCHAR")
+     */
+    addColumn(name: string, type: string): TableBuilder;
+    /**
+     * Adds a column with type and size.
+     * @param name Column name
+     * @param type Column type
+     * @param size Column size
+     */
+    addColumn(name: string, type: string, size: number): TableBuilder;
+    /**
+     * Adds a column with type, size, and default value.
+     */
+    addColumn(name: string, type: string, size: number, defaultValue: string): TableBuilder;
+    /** Adds VARCHAR column */
+    addVarchar(name: string, size: number): TableBuilder;
+    /** Adds INT column */
+    addInt(name: string): TableBuilder;
+    /** Adds BIGINT column */
+    addBigInt(name: string): TableBuilder;
+    /** Adds TEXT column */
+    addText(name: string): TableBuilder;
+    /** Adds BOOLEAN column */
+    addBoolean(name: string): TableBuilder;
+    /** Adds DATETIME column */
+    addDatetime(name: string): TableBuilder;
+    /** Adds TIMESTAMP column */
+    addTimestamp(name: string): TableBuilder;
+    /** Adds DOUBLE column */
+    addDouble(name: string): TableBuilder;
+    /** Adds FLOAT column */
+    addFloat(name: string): TableBuilder;
+    /** Adds BLOB column */
+    addBlob(name: string): TableBuilder;
+    /** Adds JSON column */
+    addJson(name: string): TableBuilder;
+    /**
+     * Sets a column as primary key.
+     * @param column Column name
+     */
+    primaryKey(column: string): TableBuilder;
+    /**
+     * Sets a column as auto increment.
+     * @param column Column name
+     */
+    autoIncrement(column: string): TableBuilder;
+    /**
+     * Sets a column as NOT NULL.
+     * @param column Column name
+     */
+    notNull(column: string): TableBuilder;
+    /**
+     * Sets a column as UNIQUE.
+     * @param column Column name
+     */
+    unique(column: string): TableBuilder;
+    /**
+     * Adds a foreign key constraint.
+     * @param column Local column name
+     * @param refTable Reference table name
+     * @param refColumn Reference column name
+     */
+    foreignKey(column: string, refTable: string, refColumn: string): TableBuilder;
+    /**
+     * Sets whether to use IF NOT EXISTS.
+     * @param value true to use IF NOT EXISTS
+     */
+    ifNotExists(value: boolean): TableBuilder;
+    /**
+     * Sets the storage engine.
+     * @param engine Engine name (e.g., "InnoDB", "MyISAM")
+     */
+    engine(engine: string): TableBuilder;
+    /**
+     * Sets the character set.
+     * @param charset Character set (e.g., "utf8mb4")
+     */
+    charset(charset: string): TableBuilder;
+    /**
+     * Sets the collation.
+     * @param collate Collation (e.g., "utf8mb4_unicode_ci")
+     */
+    collate(collate: string): TableBuilder;
+    /**
+     * Builds the CREATE TABLE SQL statement.
+     * @returns SQL statement
+     */
+    build(): string;
+}
+/**
+ * TableBuilder constructor interface.
+ */
+export interface TableBuilderConstructor {
+    new (tableName: string): TableBuilder;
+}
 export interface BootEvent {
     toString(): string;
 }
@@ -160,6 +458,20 @@ export interface LivingEntityUseBlockEvent {
     getBlockType(): string;
 }
 export interface BreakBlockEvent {
+    getPlayer(): Player | null;
+    getEvent(): BreakBlockEventData;
+    getItemInHand(): ItemStack;
+    getTargetBlock(): Vector3i;
+    getBlockType(): BlockType;
+    setTargetBlock(arg0: Vector3i): void;
+    isCancelled(): boolean;
+    setCancelled(arg0: boolean): void;
+}
+/**
+ * The inner event data for BreakBlockEvent.
+ * Access via event.getEvent() when you need the raw event.
+ */
+export interface BreakBlockEventData {
     getItemInHand(): ItemStack;
     getTargetBlock(): Vector3i;
     getBlockType(): BlockType;
@@ -168,6 +480,21 @@ export interface BreakBlockEvent {
     setCancelled(arg0: boolean): void;
 }
 export interface PlaceBlockEvent {
+    getPlayer(): Player | null;
+    getEvent(): PlaceBlockEventData;
+    getRotation(): RotationTuple;
+    setRotation(arg0: RotationTuple): void;
+    getItemInHand(): ItemStack;
+    getTargetBlock(): Vector3i;
+    setTargetBlock(arg0: Vector3i): void;
+    isCancelled(): boolean;
+    setCancelled(arg0: boolean): void;
+}
+/**
+ * The inner event data for PlaceBlockEvent.
+ * Access via event.getEvent() when you need the raw event.
+ */
+export interface PlaceBlockEventData {
     getRotation(): RotationTuple;
     setRotation(arg0: RotationTuple): void;
     getItemInHand(): ItemStack;
@@ -5403,5 +5730,7 @@ declare global {
     const WhitelistRemoveCommand: WhitelistRemoveCommand;
     const WhitelistStatusCommand: WhitelistStatusCommand;
     const EventTitleUtil: EventTitleUtil;
+    const MySQLManager: MySQLManager;
+    const TableBuilder: TableBuilderConstructor;
 }
 //# sourceMappingURL=types.d.ts.map