@objectstack/core 0.9.0 → 0.9.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @objectstack/core
 
+## 0.9.1
+
+### Patch Changes
+
+- Patch release for maintenance and stability improvements. All packages updated with unified versioning.
+- Updated dependencies
+  - @objectstack/spec@0.9.1
+
 ## 0.8.2
 
 ### Patch Changes

package/README.md

@@ -82,6 +82,42 @@ const service = kernel.getService('my-service');
 await kernel.shutdown();
 ```
 
+## 🤖 AI Quick Reference
+
+**For AI Agents:** This package implements a microkernel architecture. Key concepts:
+
+1. **Plugin Lifecycle**: `init()` → `start()` → `destroy()`
+2. **Service Registry**: Share functionality via `ctx.registerService(name, service)` and `ctx.getService(name)`
+3. **Dependencies**: Declare plugin dependencies for automatic load ordering
+4. **Hooks/Events**: Decouple plugins with `ctx.hook(event, handler)` and `ctx.trigger(event, ...args)`
+5. **Logger**: Always use `ctx.logger` for consistent, structured logging
+
+**Common Plugin Pattern:**
+```typescript
+const plugin: Plugin = {
+  name: 'my-plugin',
+  dependencies: ['other-plugin'], // Load after these plugins
+  
+  async init(ctx: PluginContext) {
+    // Register services and hooks
+    const otherService = ctx.getService('other-service');
+    ctx.registerService('my-service', new MyService(otherService));
+    ctx.hook('data:created', async (data) => { /* ... */ });
+  },
+  
+  async start(ctx: PluginContext) {
+    // Execute business logic
+    const service = ctx.getService('my-service');
+    await service.initialize();
+  },
+  
+  async destroy() {
+    // Cleanup resources
+    await service.close();
+  }
+};
+```
+
 ## Configurable Logger
 
 The logger uses **[Pino](https://github.com/pinojs/pino)** for Node.js environments (high-performance, low-overhead) and a simple console-based logger for browsers. It automatically detects the runtime environment.

package/dist/logger.d.ts

@@ -20,6 +20,7 @@ export declare class ObjectLogger implements Logger {
     private isNode;
     private pinoLogger?;
     private pinoInstance?;
+    private require?;
     constructor(config?: Partial<LoggerConfig>);
     /**
      * Initialize Pino logger for Node.js

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAE1D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAa,YAAW,MAAM;IACvC,OAAO,CAAC,MAAM,CAAkJ;IAChK,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,UAAU,CAAC,CAAM;IACzB,OAAO,CAAC,YAAY,CAAC,CAAM;gBAEf,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAwB9C;;OAEG;IACH,OAAO,CAAC,cAAc;IA+EtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsCxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAelB;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAQxD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAQvD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAQvD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IASvE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IASvE;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,YAAY;IAYjD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY;IAIzD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;CAG7C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAEzE"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAE1D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAa,YAAW,MAAM;IACvC,OAAO,CAAC,MAAM,CAAkJ;IAChK,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,UAAU,CAAC,CAAM;IACzB,OAAO,CAAC,YAAY,CAAC,CAAM;IAC3B,OAAO,CAAC,OAAO,CAAC,CAAM;gBAEV,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAwB9C;;OAEG;IACH,OAAO,CAAC,cAAc;IAuGtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsCxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAelB;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAQxD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAQvD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAQvD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IASvE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IASvE;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,YAAY;IAYjD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY;IAIzD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;CAG7C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAEzE"}

package/dist/logger.js

@@ -42,8 +42,12 @@ export class ObjectLogger {
         if (!this.isNode)
             return;
         try {
-            // Dynamic import for Pino (Node.js only)
-            const pino = require('pino');
+            // Create require function dynamically for Node.js (avoids bundling issues in browser)
+            // @ts-ignore - dynamic import of Node.js module
+            const { createRequire } = eval('require("module")');
+            this.require = createRequire(import.meta.url);
+            // Synchronous import for Pino using createRequire (works in ESM)
+            const pino = this.require('pino');
             // Build Pino options
             const pinoOptions = {
                 level: this.config.level,
@@ -60,15 +64,35 @@ export class ObjectLogger {
             const targets = [];
             // Console transport
             if (this.config.format === 'pretty') {
-                targets.push({
-                    target: 'pino-pretty',
-                    options: {
-                        colorize: true,
-                        translateTime: 'SYS:standard',
-                        ignore: 'pid,hostname'
-                    },
-                    level: this.config.level
-                });
+                // Check if pino-pretty is available
+                let hasPretty = false;
+                try {
+                    this.require.resolve('pino-pretty');
+                    hasPretty = true;
+                }
+                catch (e) {
+                    // ignore
+                }
+                if (hasPretty) {
+                    targets.push({
+                        target: 'pino-pretty',
+                        options: {
+                            colorize: true,
+                            translateTime: 'SYS:standard',
+                            ignore: 'pid,hostname'
+                        },
+                        level: this.config.level
+                    });
+                }
+                else {
+                    console.warn('[Logger] pino-pretty not found. Install it for pretty logging: pnpm add -D pino-pretty');
+                    // Fallback to text/simple
+                    targets.push({
+                        target: 'pino/file',
+                        options: { destination: 1 },
+                        level: this.config.level
+                    });
+                }
             }
             else if (this.config.format === 'json') {
                 // JSON to stdout

package/dist/security/plugin-signature-verifier.js

@@ -2,9 +2,9 @@
 let cryptoModule = null;
 if (typeof globalThis.window === 'undefined') {
     try {
-        // Dynamic import for Node.js crypto module
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        cryptoModule = require('crypto');
+        // Dynamic import for Node.js crypto module (using eval to avoid bundling issues)
+        // @ts-ignore - dynamic require for Node.js
+        cryptoModule = eval('require("crypto")');
     }
     catch {
         // Crypto module not available (e.g., browser environment)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/core",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Microkernel Core for ObjectStack",
   "type": "module",
   "main": "dist/index.js",
@@ -14,7 +14,7 @@
     "pino": "^8.17.0",
     "pino-pretty": "^10.3.0",
     "zod": "^4.3.6",
-    "@objectstack/spec": "0.9.0"
+    "@objectstack/spec": "0.9.1"
   },
   "peerDependencies": {
     "pino": "^8.0.0"

package/src/logger.ts

@@ -21,6 +21,7 @@ export class ObjectLogger implements Logger {
     private isNode: boolean;
     private pinoLogger?: any; // Pino logger instance for Node.js
     private pinoInstance?: any; // Base Pino instance for creating child loggers
+    private require?: any; // CommonJS require function for Node.js
 
     constructor(config: Partial<LoggerConfig> = {}) {
         // Detect runtime environment
@@ -53,8 +54,13 @@ export class ObjectLogger implements Logger {
         if (!this.isNode) return;
 
         try {
-            // Dynamic import for Pino (Node.js only)
-            const pino = require('pino');
+            // Create require function dynamically for Node.js (avoids bundling issues in browser)
+            // @ts-ignore - dynamic import of Node.js module
+            const { createRequire } = eval('require("module")');
+            this.require = createRequire(import.meta.url);
+            
+            // Synchronous import for Pino using createRequire (works in ESM)
+            const pino = this.require('pino');
             
             // Build Pino options
             const pinoOptions: any = {
@@ -75,15 +81,34 @@ export class ObjectLogger implements Logger {
 
             // Console transport
             if (this.config.format === 'pretty') {
-                targets.push({
-                    target: 'pino-pretty',
-                    options: {
-                        colorize: true,
-                        translateTime: 'SYS:standard',
-                        ignore: 'pid,hostname'
-                    },
-                    level: this.config.level
-                });
+                // Check if pino-pretty is available
+                let hasPretty = false;
+                try {
+                    this.require.resolve('pino-pretty');
+                    hasPretty = true;
+                } catch (e) {
+                    // ignore
+                }
+
+                if (hasPretty) {
+                    targets.push({
+                        target: 'pino-pretty',
+                        options: {
+                            colorize: true,
+                            translateTime: 'SYS:standard',
+                            ignore: 'pid,hostname'
+                        },
+                        level: this.config.level
+                    });
+                } else {
+                     console.warn('[Logger] pino-pretty not found. Install it for pretty logging: pnpm add -D pino-pretty');
+                     // Fallback to text/simple
+                     targets.push({
+                        target: 'pino/file',
+                        options: { destination: 1 },
+                        level: this.config.level
+                    });
+                }
             } else if (this.config.format === 'json') {
                 // JSON to stdout
                 targets.push({

package/src/security/plugin-signature-verifier.ts

@@ -5,9 +5,9 @@ import type { PluginMetadata } from '../plugin-loader.js';
 let cryptoModule: typeof import('crypto') | null = null;
 if (typeof (globalThis as any).window === 'undefined') {
   try {
-    // Dynamic import for Node.js crypto module
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
-    cryptoModule = require('crypto');
+    // Dynamic import for Node.js crypto module (using eval to avoid bundling issues)
+    // @ts-ignore - dynamic require for Node.js
+    cryptoModule = eval('require("crypto")');
   } catch {
     // Crypto module not available (e.g., browser environment)
   }