@open-core/framework 0.1.0-alpha.1 → 0.2.0-beta.1

package/dist/kernel/di/index.js

@@ -0,0 +1,20 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./class-constructor"), exports);
+__exportStar(require("./container"), exports);
+__exportStar(require("./decorator-processor"), exports);
+__exportStar(require("./metadata.scanner"), exports);

package/dist/{system → kernel/di}/metadata.scanner.d.ts

@@ -1,5 +1,4 @@
-import { DecoratorProcessor } from './decorator-processor';
-import { ClassConstructor } from './class-constructor';
+import { type ClassConstructor, type DecoratorProcessor } from './index';
 export declare class MetadataScanner {
     private processors;
     constructor(processors: DecoratorProcessor[]);

package/dist/kernel/di/tokens.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Dependency Injection Tokens for OpenCore.
+ *
+ * Using string tokens instead of class references for injection
+ * avoids issues with circular dependencies and "TypeInfo not known"
+ * errors in certain build environments.
+ */
+export declare const DI_TOKENS: {
+    readonly CommandExecutionPort: symbol;
+    readonly PlayerDirectoryPort: symbol;
+    readonly PrincipalPort: symbol;
+    readonly DecoratorProcessor: "DecoratorProcessor";
+    readonly DatabaseService: symbol;
+    readonly HttpService: symbol;
+    readonly ChatService: symbol;
+    readonly RateLimiterService: symbol;
+    readonly PrincipalProvider: symbol;
+    readonly AuthProvider: symbol;
+    readonly Exports: symbol;
+    readonly EngineEvents: symbol;
+    readonly NetTransport: symbol;
+    readonly Tick: symbol;
+    readonly PlayerInfo: symbol;
+    readonly ResourceInfo: symbol;
+    readonly EntityServer: symbol;
+    readonly VehicleServer: symbol;
+    readonly PlayerServer: symbol;
+    readonly Hasher: symbol;
+    readonly PedAppearanceServer: symbol;
+};

package/dist/kernel/di/tokens.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DI_TOKENS = void 0;
+/**
+ * Dependency Injection Tokens for OpenCore.
+ *
+ * Using string tokens instead of class references for injection
+ * avoids issues with circular dependencies and "TypeInfo not known"
+ * errors in certain build environments.
+ */
+exports.DI_TOKENS = {
+    // Ports
+    CommandExecutionPort: Symbol.for('CommandExecutionPort'),
+    PlayerDirectoryPort: Symbol.for('PlayerDirectoryPort'),
+    PrincipalPort: Symbol.for('PrincipalPort'),
+    // Decorator Processors
+    DecoratorProcessor: 'DecoratorProcessor',
+    // Services
+    DatabaseService: Symbol.for('DatabaseService'),
+    HttpService: Symbol.for('HttpService'),
+    ChatService: Symbol.for('ChatService'),
+    RateLimiterService: Symbol.for('RateLimiterService'),
+    // Providers
+    PrincipalProvider: Symbol.for('PrincipalProvider'),
+    AuthProvider: Symbol.for('AuthProvider'),
+    // Adapters
+    Exports: Symbol.for('IExports'),
+    EngineEvents: Symbol.for('IEngineEvents'),
+    NetTransport: Symbol.for('INetTransport'),
+    Tick: Symbol.for('ITick'),
+    PlayerInfo: Symbol.for('IPlayerInfo'),
+    ResourceInfo: Symbol.for('IResourceInfo'),
+    EntityServer: Symbol.for('IEntityServer'),
+    VehicleServer: Symbol.for('IVehicleServer'),
+    PlayerServer: Symbol.for('IPlayerServer'),
+    Hasher: Symbol.for('IHasher'),
+    PedAppearanceServer: Symbol.for('IPedAppearanceServer'),
+};

package/dist/kernel/index.d.ts

@@ -0,0 +1,7 @@
+export * from './di/class-constructor';
+export { di } from './di/container';
+export * from './di/decorator-processor';
+export * from './di/metadata.scanner';
+export * from './schema';
+export * from './shared/logger';
+export * from './utils';

package/dist/kernel/index.js

@@ -0,0 +1,30 @@
+"use strict";
+// Kernel - Core infrastructure and rules (engine-agnostic)
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.di = void 0;
+__exportStar(require("./di/class-constructor"), exports);
+var container_1 = require("./di/container");
+Object.defineProperty(exports, "di", { enumerable: true, get: function () { return container_1.di; } });
+// Dependency Injection
+__exportStar(require("./di/decorator-processor"), exports);
+__exportStar(require("./di/metadata.scanner"), exports);
+// Schema utilities (Zod helpers)
+__exportStar(require("./schema"), exports);
+// Shared utilities
+__exportStar(require("./shared/logger"), exports);
+// Utils
+__exportStar(require("./utils"), exports);

package/dist/kernel/schema/index.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+/**
+ * Infers the output type from a Zod schema.
+ *
+ * @example
+ * ```ts
+ * import { z, Infer } from '@open-core/framework'
+ *
+ * const UserSchema = z.object({
+ *   name: z.string(),
+ *   age: z.number(),
+ * })
+ *
+ * // In handler parameter
+ * onEvent(player: Player, data: Infer<typeof UserSchema>) {
+ *   data.name  // string
+ *   data.age   // number
+ * }
+ * ```
+ */
+export type Infer<T extends z.ZodType> = z.infer<T>;
+/**
+ * Infers the input type from a Zod schema.
+ * Useful when schema has transforms that change the output type.
+ */
+export type Input<T extends z.ZodType> = z.input<T>;
+/**
+ * Infers the output type from a Zod schema.
+ * Alias for Infer<T>.
+ */
+export type Output<T extends z.ZodType> = z.output<T>;
+export { z };

package/dist/kernel/schema/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.z = void 0;
+const zod_1 = require("zod");
+Object.defineProperty(exports, "z", { enumerable: true, get: function () { return zod_1.z; } });

package/dist/kernel/shared/appearance/appearance.interface.d.ts

@@ -0,0 +1,276 @@
+/**
+ * Component variation data for a ped.
+ *
+ * @remarks
+ * Used for clothing, hair, and other visual components.
+ * Component IDs range from 0 to 11.
+ */
+export interface ComponentVariation {
+    /** Drawable index for the component */
+    drawable: number;
+    /** Texture index for the drawable */
+    texture: number;
+}
+/**
+ * Prop data for a ped.
+ *
+ * @remarks
+ * Used for hats, glasses, watches, and other accessories.
+ * Prop IDs range from 0 to 7.
+ */
+export interface PropVariation {
+    /** Drawable index for the prop (-1 to remove) */
+    drawable: number;
+    /** Texture index for the drawable */
+    texture: number;
+}
+/**
+ * Head blend data for freemode character creation.
+ *
+ * @remarks
+ * Controls the facial structure inheritance from parent faces.
+ * Shape and skin IDs range from 0 to 45.
+ * Mix values range from 0.0 to 1.0.
+ */
+export interface HeadBlendData {
+    /** First parent shape ID (0-45) */
+    shapeFirst: number;
+    /** Second parent shape ID (0-45) */
+    shapeSecond: number;
+    /** Third parent shape ID (0-45), optional */
+    shapeThird?: number;
+    /** First parent skin ID (0-45) */
+    skinFirst: number;
+    /** Second parent skin ID (0-45) */
+    skinSecond: number;
+    /** Third parent skin ID (0-45), optional */
+    skinThird?: number;
+    /** Shape mix between first and second parent (0.0-1.0) */
+    shapeMix: number;
+    /** Skin mix between first and second parent (0.0-1.0) */
+    skinMix: number;
+    /** Third parent mix (0.0-1.0), optional */
+    thirdMix?: number;
+}
+/**
+ * Head overlay data for facial features like makeup, beard, etc.
+ *
+ * @remarks
+ * Overlay IDs range from 0 to 12:
+ * - 0: Blemishes (0-23)
+ * - 1: Facial Hair (0-28)
+ * - 2: Eyebrows (0-33)
+ * - 3: Ageing (0-14)
+ * - 4: Makeup (0-74)
+ * - 5: Blush (0-6)
+ * - 6: Complexion (0-11)
+ * - 7: Sun Damage (0-10)
+ * - 8: Lipstick (0-9)
+ * - 9: Moles/Freckles (0-17)
+ * - 10: Chest Hair (0-16)
+ * - 11: Body Blemishes (0-11)
+ * - 12: Add Body Blemishes (0-1)
+ *
+ * Set index to 255 to disable the overlay.
+ */
+export interface HeadOverlayData {
+    /** Overlay variation index (use 255 to disable) */
+    index: number;
+    /** Opacity of the overlay (0.0-1.0) */
+    opacity: number;
+    /**
+     * Color type for the overlay.
+     * - 0: Default
+     * - 1: Hair colors (eyebrows, beards, chest hair)
+     * - 2: Makeup colors (blush, lipstick)
+     */
+    colorType?: number;
+    /** Primary color ID */
+    colorId?: number;
+    /** Secondary color ID */
+    secondColorId?: number;
+}
+/**
+ * Hair color data including highlights.
+ */
+export interface HairColorData {
+    /** Primary hair color ID */
+    colorId: number;
+    /** Highlight color ID */
+    highlightColorId: number;
+}
+/**
+ * Tattoo/decoration data.
+ *
+ * @remarks
+ * Tattoos are applied using collection and overlay hashes.
+ * Collections are defined in game files (e.g., "mpbeach_overlays").
+ */
+export interface TattooData {
+    /** Collection name hash (e.g., "mpbeach_overlays") */
+    collection: string;
+    /** Overlay name hash within the collection */
+    overlay: string;
+}
+/**
+ * Complete player appearance data structure.
+ *
+ * @remarks
+ * This interface contains all customization options for a freemode ped.
+ * Not all fields are required - only include what needs to be changed.
+ *
+ * @example
+ * ```typescript
+ * const appearance: PlayerAppearance = {
+ *   model: 'mp_m_freemode_01',
+ *   headBlend: {
+ *     shapeFirst: 0,
+ *     shapeSecond: 21,
+ *     skinFirst: 0,
+ *     skinSecond: 21,
+ *     shapeMix: 0.5,
+ *     skinMix: 0.5
+ *   },
+ *   components: {
+ *     3: { drawable: 15, texture: 0 }, // Torso
+ *     4: { drawable: 21, texture: 0 }, // Legs
+ *     6: { drawable: 34, texture: 0 }, // Shoes
+ *   },
+ *   eyeColor: 3,
+ *   hairColor: { colorId: 5, highlightColorId: 0 }
+ * }
+ * ```
+ */
+export interface PlayerAppearance {
+    /**
+     * Ped model name.
+     * @example "mp_m_freemode_01" or "mp_f_freemode_01"
+     */
+    model?: string;
+    /**
+     * Component variations (clothing, hair, etc.).
+     * Keys are component IDs (0-11).
+     */
+    components?: Record<number, ComponentVariation>;
+    /**
+     * Prop variations (hats, glasses, etc.).
+     * Keys are prop IDs (0-7).
+     */
+    props?: Record<number, PropVariation>;
+    /**
+     * Face feature morphs.
+     * Keys are feature indices (0-19), values range from -1.0 to 1.0.
+     *
+     * @remarks
+     * Feature indices:
+     * - 0-5: Nose (width, peak, length, curve, tip, twist)
+     * - 6-7: Eyebrows (up/down, in/out)
+     * - 8-10: Cheeks (height, width, puffed)
+     * - 11: Eye opening
+     * - 12: Lip thickness
+     * - 13-14: Jaw (width, shape)
+     * - 15-18: Chin (height, length, shape, hole)
+     * - 19: Neck thickness
+     */
+    faceFeatures?: Record<number, number>;
+    /**
+     * Head blend data for facial structure.
+     */
+    headBlend?: HeadBlendData;
+    /**
+     * Head overlays (makeup, facial hair, etc.).
+     * Keys are overlay IDs (0-12).
+     */
+    headOverlays?: Record<number, HeadOverlayData>;
+    /**
+     * Hair color and highlights.
+     */
+    hairColor?: HairColorData;
+    /**
+     * Eye color index (0-31).
+     */
+    eyeColor?: number;
+    /**
+     * Tattoos/decorations to apply.
+     */
+    tattoos?: TattooData[];
+}
+/**
+ * Result of appearance validation.
+ */
+export interface AppearanceValidationResult {
+    /** Whether the appearance data is valid */
+    valid: boolean;
+    /** List of validation errors if any */
+    errors: string[];
+}
+/**
+ * Component ID enum for better code readability.
+ */
+export declare enum ComponentId {
+    Face = 0,
+    Mask = 1,
+    Hair = 2,
+    Torso = 3,
+    Legs = 4,
+    Parachute = 5,
+    Shoes = 6,
+    Accessory = 7,
+    Undershirt = 8,
+    Kevlar = 9,
+    Badge = 10,
+    Torso2 = 11
+}
+/**
+ * Prop ID enum for better code readability.
+ */
+export declare enum PropId {
+    Hat = 0,
+    Glasses = 1,
+    Ears = 2,
+    Watch = 6,
+    Bracelet = 7
+}
+/**
+ * Overlay ID enum for better code readability.
+ */
+export declare enum OverlayId {
+    Blemishes = 0,
+    FacialHair = 1,
+    Eyebrows = 2,
+    Ageing = 3,
+    Makeup = 4,
+    Blush = 5,
+    Complexion = 6,
+    SunDamage = 7,
+    Lipstick = 8,
+    MolesFreckles = 9,
+    ChestHair = 10,
+    BodyBlemishes = 11,
+    AddBodyBlemishes = 12
+}
+/**
+ * Face feature index enum for better code readability.
+ */
+export declare enum FaceFeatureIndex {
+    NoseWidth = 0,
+    NosePeak = 1,
+    NoseLength = 2,
+    NoseCurve = 3,
+    NoseTip = 4,
+    NoseTwist = 5,
+    EyebrowHeight = 6,
+    EyebrowDepth = 7,
+    CheekHeight = 8,
+    CheekWidth = 9,
+    CheekDepth = 10,
+    EyeOpening = 11,
+    LipThickness = 12,
+    JawWidth = 13,
+    JawShape = 14,
+    ChinHeight = 15,
+    ChinLength = 16,
+    ChinShape = 17,
+    ChinHole = 18,
+    NeckThickness = 19
+}

package/dist/kernel/shared/appearance/appearance.interface.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FaceFeatureIndex = exports.OverlayId = exports.PropId = exports.ComponentId = void 0;
+/**
+ * Component ID enum for better code readability.
+ */
+var ComponentId;
+(function (ComponentId) {
+    ComponentId[ComponentId["Face"] = 0] = "Face";
+    ComponentId[ComponentId["Mask"] = 1] = "Mask";
+    ComponentId[ComponentId["Hair"] = 2] = "Hair";
+    ComponentId[ComponentId["Torso"] = 3] = "Torso";
+    ComponentId[ComponentId["Legs"] = 4] = "Legs";
+    ComponentId[ComponentId["Parachute"] = 5] = "Parachute";
+    ComponentId[ComponentId["Shoes"] = 6] = "Shoes";
+    ComponentId[ComponentId["Accessory"] = 7] = "Accessory";
+    ComponentId[ComponentId["Undershirt"] = 8] = "Undershirt";
+    ComponentId[ComponentId["Kevlar"] = 9] = "Kevlar";
+    ComponentId[ComponentId["Badge"] = 10] = "Badge";
+    ComponentId[ComponentId["Torso2"] = 11] = "Torso2";
+})(ComponentId || (exports.ComponentId = ComponentId = {}));
+/**
+ * Prop ID enum for better code readability.
+ */
+var PropId;
+(function (PropId) {
+    PropId[PropId["Hat"] = 0] = "Hat";
+    PropId[PropId["Glasses"] = 1] = "Glasses";
+    PropId[PropId["Ears"] = 2] = "Ears";
+    PropId[PropId["Watch"] = 6] = "Watch";
+    PropId[PropId["Bracelet"] = 7] = "Bracelet";
+})(PropId || (exports.PropId = PropId = {}));
+/**
+ * Overlay ID enum for better code readability.
+ */
+var OverlayId;
+(function (OverlayId) {
+    OverlayId[OverlayId["Blemishes"] = 0] = "Blemishes";
+    OverlayId[OverlayId["FacialHair"] = 1] = "FacialHair";
+    OverlayId[OverlayId["Eyebrows"] = 2] = "Eyebrows";
+    OverlayId[OverlayId["Ageing"] = 3] = "Ageing";
+    OverlayId[OverlayId["Makeup"] = 4] = "Makeup";
+    OverlayId[OverlayId["Blush"] = 5] = "Blush";
+    OverlayId[OverlayId["Complexion"] = 6] = "Complexion";
+    OverlayId[OverlayId["SunDamage"] = 7] = "SunDamage";
+    OverlayId[OverlayId["Lipstick"] = 8] = "Lipstick";
+    OverlayId[OverlayId["MolesFreckles"] = 9] = "MolesFreckles";
+    OverlayId[OverlayId["ChestHair"] = 10] = "ChestHair";
+    OverlayId[OverlayId["BodyBlemishes"] = 11] = "BodyBlemishes";
+    OverlayId[OverlayId["AddBodyBlemishes"] = 12] = "AddBodyBlemishes";
+})(OverlayId || (exports.OverlayId = OverlayId = {}));
+/**
+ * Face feature index enum for better code readability.
+ */
+var FaceFeatureIndex;
+(function (FaceFeatureIndex) {
+    FaceFeatureIndex[FaceFeatureIndex["NoseWidth"] = 0] = "NoseWidth";
+    FaceFeatureIndex[FaceFeatureIndex["NosePeak"] = 1] = "NosePeak";
+    FaceFeatureIndex[FaceFeatureIndex["NoseLength"] = 2] = "NoseLength";
+    FaceFeatureIndex[FaceFeatureIndex["NoseCurve"] = 3] = "NoseCurve";
+    FaceFeatureIndex[FaceFeatureIndex["NoseTip"] = 4] = "NoseTip";
+    FaceFeatureIndex[FaceFeatureIndex["NoseTwist"] = 5] = "NoseTwist";
+    FaceFeatureIndex[FaceFeatureIndex["EyebrowHeight"] = 6] = "EyebrowHeight";
+    FaceFeatureIndex[FaceFeatureIndex["EyebrowDepth"] = 7] = "EyebrowDepth";
+    FaceFeatureIndex[FaceFeatureIndex["CheekHeight"] = 8] = "CheekHeight";
+    FaceFeatureIndex[FaceFeatureIndex["CheekWidth"] = 9] = "CheekWidth";
+    FaceFeatureIndex[FaceFeatureIndex["CheekDepth"] = 10] = "CheekDepth";
+    FaceFeatureIndex[FaceFeatureIndex["EyeOpening"] = 11] = "EyeOpening";
+    FaceFeatureIndex[FaceFeatureIndex["LipThickness"] = 12] = "LipThickness";
+    FaceFeatureIndex[FaceFeatureIndex["JawWidth"] = 13] = "JawWidth";
+    FaceFeatureIndex[FaceFeatureIndex["JawShape"] = 14] = "JawShape";
+    FaceFeatureIndex[FaceFeatureIndex["ChinHeight"] = 15] = "ChinHeight";
+    FaceFeatureIndex[FaceFeatureIndex["ChinLength"] = 16] = "ChinLength";
+    FaceFeatureIndex[FaceFeatureIndex["ChinShape"] = 17] = "ChinShape";
+    FaceFeatureIndex[FaceFeatureIndex["ChinHole"] = 18] = "ChinHole";
+    FaceFeatureIndex[FaceFeatureIndex["NeckThickness"] = 19] = "NeckThickness";
+})(FaceFeatureIndex || (exports.FaceFeatureIndex = FaceFeatureIndex = {}));

package/dist/kernel/shared/appearance/index.d.ts

@@ -0,0 +1 @@
+export * from './appearance.interface';

package/dist/kernel/shared/appearance/index.js

@@ -0,0 +1,17 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./appearance.interface"), exports);

package/dist/kernel/shared/index.d.ts

@@ -0,0 +1,2 @@
+export * from './appearance';
+export * from './logger';

package/dist/{shared → kernel/shared}/index.js

@@ -14,4 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./appearance"), exports);
 __exportStar(require("./logger"), exports);

package/dist/{shared → kernel/shared}/logger/core-logger.d.ts

@@ -6,6 +6,19 @@ import { LoggerService } from './logger.service';
  * be used by OpenCore internals. Resource developers should inject LoggerService
  * via DI instead.
  *
+ * Configuration:
+ * - Set `logLevel` in opencore.config.ts to control log verbosity
+ * - Values: TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF
+ * - Default: INFO
+ *
+ * @example
+ * ```typescript
+ * // opencore.config.ts
+ * export default {
+ *   logLevel: 'DEBUG',
+ * }
+ * ```
+ *
  * @internal
  */
 export declare const coreLogger: LoggerService;

package/dist/{shared → kernel/shared}/logger/core-logger.js

@@ -1,9 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loggers = exports.coreLogger = void 0;
-const logger_types_1 = require("./logger.types");
+const logger_env_1 = require("./logger.env");
 const logger_service_1 = require("./logger.service");
+const logger_types_1 = require("./logger.types");
 const console_transport_1 = require("./transports/console.transport");
+const simple_console_transport_1 = require("./transports/simple-console.transport");
+/**
+ * Creates the appropriate transport based on the runtime environment.
+ * - Client: SimpleConsoleTransport (no ANSI colors)
+ * - Server: ConsoleTransport (with ANSI colors)
+ */
+function createTransport() {
+    const logLevel = (0, logger_env_1.getLogLevel)();
+    if ((0, logger_env_1.isClientEnvironment)()) {
+        return new simple_console_transport_1.SimpleConsoleTransport({
+            minLevel: logLevel,
+            timestamps: true,
+            showContext: false,
+        });
+    }
+    return new console_transport_1.ConsoleTransport({
+        minLevel: logLevel,
+        colors: true,
+        timestamps: true,
+    });
+}
 /**
  * Singleton logger instance for internal OpenCore framework use.
  *
@@ -11,19 +33,26 @@ const console_transport_1 = require("./transports/console.transport");
  * be used by OpenCore internals. Resource developers should inject LoggerService
  * via DI instead.
  *
+ * Configuration:
+ * - Set `logLevel` in opencore.config.ts to control log verbosity
+ * - Values: TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF
+ * - Default: INFO
+ *
+ * @example
+ * ```typescript
+ * // opencore.config.ts
+ * export default {
+ *   logLevel: 'DEBUG',
+ * }
+ * ```
+ *
  * @internal
  */
 exports.coreLogger = new logger_service_1.LoggerService({
-    minLevel: logger_types_1.LogLevel.DEBUG,
+    minLevel: (0, logger_env_1.getLogLevel)(),
     defaultDomain: logger_types_1.LogDomain.FRAMEWORK,
     defaultSource: 'Core',
-    transports: [
-        new console_transport_1.ConsoleTransport({
-            minLevel: logger_types_1.LogLevel.DEBUG,
-            colors: true,
-            timestamps: true,
-        }),
-    ],
+    transports: [createTransport()],
 });
 // Pre-configured child loggers for common framework components
 exports.loggers = {

package/dist/{shared → kernel/shared}/logger/index.d.ts

@@ -1,11 +1,14 @@
-export { LogLevel, LogLevelLabels, LogDomain, LogDomainLabels, parseLogLevel } from './logger.types';
-export type { LogContext, LogEntry } from './logger.types';
-export { createLoggerConfig, DEFAULT_LOGGER_CONFIG } from './logger.config';
-export type { LoggerConfig } from './logger.config';
-export { LoggerService, ChildLogger } from './logger.service';
 export { coreLogger, loggers } from './core-logger';
-export type { LogTransport } from './transports/transport.interface';
-export { ConsoleTransport } from './transports/console.transport';
-export type { ConsoleTransportOptions } from './transports/console.transport';
-export { BufferedTransport } from './transports/buffered.transport';
+export type { LoggerConfig } from './logger.config';
+export { createLoggerConfig, DEFAULT_LOGGER_CONFIG } from './logger.config';
+export { getLogLevel, isClientEnvironment, isDebugMode, isFiveMEnvironment, isServerEnvironment, } from './logger.env';
+export { ChildLogger, LoggerService } from './logger.service';
+export type { LogContext, LogEntry } from './logger.types';
+export { LogDomain, LogDomainLabels, LogLevel, LogLevelLabels, parseLogLevel } from './logger.types';
 export type { BufferedTransportOptions, LogOutputFormat } from './transports/buffered.transport';
+export { BufferedTransport } from './transports/buffered.transport';
+export type { ConsoleTransportOptions } from './transports/console.transport';
+export { ConsoleTransport } from './transports/console.transport';
+export type { SimpleConsoleTransportOptions } from './transports/simple-console.transport';
+export { SimpleConsoleTransport } from './transports/simple-console.transport';
+export type { LogTransport } from './transports/transport.interface';