@objectstack/spec 0.6.1 → 0.7.2

package/dist/automation/workflow.zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.zod.d.ts","sourceRoot":"","sources":["../../src/automation/workflow.zod.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workflow.zod.d.ts","sourceRoot":"","sources":["../../src/automation/workflow.zod.ts"],"names":[],"mappings":"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"}

package/dist/automation/workflow.zod.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkflowRuleSchema = exports.TimeTriggerSchema = exports.WorkflowActionSchema = exports.CustomScriptActionSchema = exports.PushNotificationActionSchema = exports.TaskCreationActionSchema = exports.WebhookTriggerActionSchema = exports.HttpCallActionSchema = exports.TeamsMessageActionSchema = exports.SlackMessageActionSchema = exports.SmsNotificationActionSchema = exports.EmailAlertActionSchema = exports.FieldUpdateActionSchema = exports.WorkflowTriggerType = void 0;
 const zod_1 = require("zod");
 const identifiers_zod_1 = require("../shared/identifiers.zod");
+const webhook_zod_1 = require("./webhook.zod");
 /**
  * Trigger events for workflow automation
  */
@@ -84,16 +85,12 @@ exports.HttpCallActionSchema = zod_1.z.object({
 });
 /**
  * Schema for Workflow Webhook Trigger Action
+ * References the canonical WebhookSchema from automation/webhook.zod.ts
  */
 exports.WebhookTriggerActionSchema = zod_1.z.object({
     name: zod_1.z.string().describe('Action name'),
     type: zod_1.z.literal('webhook_trigger'),
-    url: zod_1.z.string().describe('Webhook URL to call'),
-    method: zod_1.z.enum(['POST', 'PUT']).default('POST').describe('HTTP method'),
-    headers: zod_1.z.record(zod_1.z.string()).optional().describe('Custom headers'),
-    payload: zod_1.z.any().optional().describe('Webhook payload (uses record data if not specified)'),
-    retryOnFailure: zod_1.z.boolean().default(true).describe('Retry if webhook fails'),
-    maxRetries: zod_1.z.number().default(3).describe('Maximum retry attempts'),
+    config: webhook_zod_1.WebhookSchema.describe('Webhook configuration (references canonical schema)'),
 });
 /**
  * Schema for Workflow Task Creation Action

package/dist/contracts/data-engine.d.ts

@@ -0,0 +1,61 @@
+import { DataEngineQueryOptions, DataEngineInsertOptions, DataEngineUpdateOptions, DataEngineDeleteOptions, DataEngineAggregateOptions, DataEngineCountOptions, DataEngineRequest, QueryAST, DriverOptions } from '../data/index.js';
+/**
+ * IDataEngine - Standard Data Engine Interface
+ *
+ * Abstract interface for data persistence capabilities.
+ * Following the Dependency Inversion Principle - plugins depend on this interface,
+ * not on concrete database implementations.
+ *
+ * Aligned with 'src/data/data-engine.zod.ts' in @objectstack/spec.
+ */
+export interface IDataEngine {
+    find(objectName: string, query?: DataEngineQueryOptions): Promise<any[]>;
+    findOne(objectName: string, query?: DataEngineQueryOptions): Promise<any>;
+    insert(objectName: string, data: any | any[], options?: DataEngineInsertOptions): Promise<any>;
+    update(objectName: string, data: any, options?: DataEngineUpdateOptions): Promise<any>;
+    delete(objectName: string, options?: DataEngineDeleteOptions): Promise<any>;
+    count(objectName: string, query?: DataEngineCountOptions): Promise<number>;
+    aggregate(objectName: string, query: DataEngineAggregateOptions): Promise<any[]>;
+    /**
+     * Vector Search (AI/RAG)
+     */
+    vectorFind?(objectName: string, vector: number[], options?: {
+        filter?: any;
+        limit?: number;
+        select?: string[];
+        threshold?: number;
+    }): Promise<any[]>;
+    /**
+     * Batch Operations (Transactional)
+     */
+    batch?(requests: DataEngineRequest[], options?: {
+        transaction?: boolean;
+    }): Promise<any[]>;
+    /**
+     * Execute raw command (Escape hatch)
+     */
+    execute?(command: any, options?: Record<string, any>): Promise<any>;
+}
+export interface DriverInterface {
+    name: string;
+    version: string;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    find(object: string, query: QueryAST, options?: DriverOptions): Promise<any[]>;
+    findOne(object: string, query: QueryAST, options?: DriverOptions): Promise<any>;
+    create(object: string, data: any, options?: DriverOptions): Promise<any>;
+    update(object: string, id: any, data: any, options?: DriverOptions): Promise<any>;
+    delete(object: string, id: any, options?: DriverOptions): Promise<any>;
+    /**
+     * Bulk & Batch Operations
+     */
+    bulkCreate?(object: string, data: any[], options?: DriverOptions): Promise<any>;
+    updateMany?(object: string, query: QueryAST, data: any, options?: DriverOptions): Promise<any>;
+    deleteMany?(object: string, query: QueryAST, options?: DriverOptions): Promise<any>;
+    count?(object: string, query: QueryAST, options?: DriverOptions): Promise<number>;
+    /**
+     * Raw Execution
+     */
+    execute?(command: any, params?: any, options?: DriverOptions): Promise<any>;
+}
+//# sourceMappingURL=data-engine.d.ts.map

package/dist/contracts/data-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-engine.d.ts","sourceRoot":"","sources":["../../src/contracts/data-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,iBAAiB,EACjB,QAAQ,EACR,aAAa,EACd,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;GAQG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACzE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1E,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/F,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACvF,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5E,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3E,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEjF;;OAEG;IACH,UAAU,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAErJ;;OAEG;IACH,KAAK,CAAC,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAE3F;;OAEG;IACH,OAAO,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/E,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAChF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACzE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAClF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEvE;;OAEG;IACH,UAAU,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAChF,UAAU,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/F,UAAU,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEpF,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAElF;;OAEG;IACH,OAAO,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAC7E"}

package/dist/contracts/data-engine.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/http-server.d.ts

@@ -0,0 +1,119 @@
+/**
+ * IHttpServer - Standard HTTP Server Interface
+ *
+ * Abstract interface for HTTP server capabilities.
+ * This allows plugins to interact with HTTP servers without knowing
+ * the underlying implementation (Express, Fastify, Hono, etc.).
+ *
+ * Follows Dependency Inversion Principle - plugins depend on this interface,
+ * not on concrete HTTP framework implementations.
+ */
+/**
+ * Generic HTTP Request type
+ * Abstraction over framework-specific request objects
+ */
+export interface IHttpRequest {
+    /** Request path parameters */
+    params: Record<string, string>;
+    /** Request query parameters */
+    query: Record<string, string | string[]>;
+    /** Request body */
+    body?: any;
+    /** Request headers */
+    headers: Record<string, string | string[]>;
+    /** HTTP method */
+    method: string;
+    /** Request path */
+    path: string;
+}
+/**
+ * Generic HTTP Response type
+ * Abstraction over framework-specific response objects
+ */
+export interface IHttpResponse {
+    /**
+     * Send a JSON response
+     * @param data - Data to send
+     */
+    json(data: any): void | Promise<void>;
+    /**
+     * Send a text/html response
+     * @param data - Data to send
+     */
+    send(data: string): void | Promise<void>;
+    /**
+     * Set HTTP status code
+     * @param code - HTTP status code
+     */
+    status(code: number): IHttpResponse;
+    /**
+     * Set response header
+     * @param name - Header name
+     * @param value - Header value (string or array of strings for multi-value headers)
+     */
+    header(name: string, value: string | string[]): IHttpResponse;
+}
+/**
+ * Route handler function
+ */
+export type RouteHandler = (req: IHttpRequest, res: IHttpResponse) => void | Promise<void>;
+/**
+ * Middleware function
+ */
+export type Middleware = (req: IHttpRequest, res: IHttpResponse, next: () => void | Promise<void>) => void | Promise<void>;
+/**
+ * IHttpServer - HTTP Server capability interface
+ *
+ * Defines the contract for HTTP server implementations.
+ * Concrete implementations (Express, Fastify, Hono) should implement this interface.
+ */
+export interface IHttpServer {
+    /**
+     * Register a GET route handler
+     * @param path - Route path (e.g., '/api/users/:id')
+     * @param handler - Route handler function
+     */
+    get(path: string, handler: RouteHandler): void;
+    /**
+     * Register a POST route handler
+     * @param path - Route path
+     * @param handler - Route handler function
+     */
+    post(path: string, handler: RouteHandler): void;
+    /**
+     * Register a PUT route handler
+     * @param path - Route path
+     * @param handler - Route handler function
+     */
+    put(path: string, handler: RouteHandler): void;
+    /**
+     * Register a DELETE route handler
+     * @param path - Route path
+     * @param handler - Route handler function
+     */
+    delete(path: string, handler: RouteHandler): void;
+    /**
+     * Register a PATCH route handler
+     * @param path - Route path
+     * @param handler - Route handler function
+     */
+    patch(path: string, handler: RouteHandler): void;
+    /**
+     * Register middleware
+     * @param path - Optional path to apply middleware to (if omitted, applies globally)
+     * @param handler - Middleware function
+     */
+    use(path: string | Middleware, handler?: Middleware): void;
+    /**
+     * Start the HTTP server
+     * @param port - Port number to listen on
+     * @returns Promise that resolves when server is ready
+     */
+    listen(port: number): Promise<void>;
+    /**
+     * Stop the HTTP server
+     * @returns Promise that resolves when server is stopped
+     */
+    close?(): Promise<void>;
+}
+//# sourceMappingURL=http-server.d.ts.map

package/dist/contracts/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../../src/contracts/http-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACzC,mBAAmB;IACnB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC3C,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;IAEpC;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,aAAa,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CACvB,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,aAAa,KACjB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CACrB,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAC/B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IACxB;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAE/C;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAEhD;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAE/C;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAElD;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAEjD;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAE3D;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;;OAGG;IACH,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}

package/dist/contracts/http-server.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * IHttpServer - Standard HTTP Server Interface
+ *
+ * Abstract interface for HTTP server capabilities.
+ * This allows plugins to interact with HTTP servers without knowing
+ * the underlying implementation (Express, Fastify, Hono, etc.).
+ *
+ * Follows Dependency Inversion Principle - plugins depend on this interface,
+ * not on concrete HTTP framework implementations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * ObjectStack Contracts
+ *
+ * Core interface definitions following "Protocol First" principle.
+ * All interfaces should be defined in @objectstack/spec to avoid circular dependencies.
+ */
+export * from './logger.js';
+export * from './data-engine.js';
+export * from './http-server.js';
+export * from './service-registry.js';
+export * from './plugin-validator.js';
+export * from './startup-orchestrator.js';
+export * from './plugin-lifecycle-events.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC"}

package/dist/contracts/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * ObjectStack Contracts
+ *
+ * Core interface definitions following "Protocol First" principle.
+ * All interfaces should be defined in @objectstack/spec to avoid circular dependencies.
+ */
+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("./logger.js"), exports);
+__exportStar(require("./data-engine.js"), exports);
+__exportStar(require("./http-server.js"), exports);
+__exportStar(require("./service-registry.js"), exports);
+__exportStar(require("./plugin-validator.js"), exports);
+__exportStar(require("./startup-orchestrator.js"), exports);
+__exportStar(require("./plugin-lifecycle-events.js"), exports);

package/dist/contracts/logger.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Logger Contract
+ *
+ * Defines the interface for logging in ObjectStack.
+ * Compatible with both browser console and structured logging systems.
+ */
+export interface Logger {
+    /**
+     * Log a debug message
+     * @param message - The message to log
+     * @param meta - Optional metadata to include
+     */
+    debug(message: string, meta?: Record<string, any>): void;
+    /**
+     * Log an informational message
+     * @param message - The message to log
+     * @param meta - Optional metadata to include
+     */
+    info(message: string, meta?: Record<string, any>): void;
+    /**
+     * Log a warning message
+     * @param message - The message to log
+     * @param meta - Optional metadata to include
+     */
+    warn(message: string, meta?: Record<string, any>): void;
+    /**
+     * Log an error message
+     * @param message - The message to log
+     * @param error - Optional error object
+     * @param meta - Optional metadata to include
+     */
+    error(message: string, error?: Error, meta?: Record<string, any>): void;
+    /**
+     * Log a fatal error message
+     * @param message - The message to log
+     * @param error - Optional error object
+     * @param meta - Optional metadata to include
+     */
+    fatal?(message: string, error?: Error, meta?: Record<string, any>): void;
+    /**
+     * Create a child logger with additional context
+     * @param context - Context to add to all logs from this child
+     */
+    child?(context: Record<string, any>): Logger;
+    /**
+     * Set trace context for distributed tracing
+     * @param traceId - Trace identifier
+     * @param spanId - Span identifier
+     */
+    withTrace?(traceId: string, spanId?: string): Logger;
+    /**
+     * Compatibility method for console.log usage
+     * @param message - The message to log
+     * @param args - Additional arguments
+     */
+    log?(message: string, ...args: any[]): void;
+    /**
+     * Cleanup resources (close file streams, etc.)
+     * Should be called when the logger is no longer needed
+     */
+    destroy?(): Promise<void>;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/contracts/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/contracts/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACnB;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAEzD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAExD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAExD;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAExE;;;;;OAKG;IACH,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAEzE;;;OAGG;IACH,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC;IAE7C;;;;OAIG;IACH,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAErD;;;;OAIG;IACH,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE5C;;;OAGG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B"}

package/dist/contracts/logger.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/plugin-lifecycle-events.d.ts

@@ -0,0 +1,150 @@
+/**
+ * IPluginLifecycleEvents - Typed Plugin Lifecycle Events
+ *
+ * Type-safe event definitions for plugin and kernel lifecycle.
+ * Provides strong typing for event emitters and listeners.
+ *
+ * This replaces the generic Map<string, any[]> approach with typed events.
+ */
+/**
+ * Plugin lifecycle event types and their payloads
+ */
+export interface IPluginLifecycleEvents {
+    /**
+     * Emitted when kernel is ready (all plugins initialized)
+     * Payload: []
+     */
+    'kernel:ready': [];
+    /**
+     * Emitted when kernel is shutting down
+     * Payload: []
+     */
+    'kernel:shutdown': [];
+    /**
+     * Emitted before kernel initialization starts
+     * Payload: []
+     */
+    'kernel:before-init': [];
+    /**
+     * Emitted after kernel initialization completes
+     * Payload: [duration: number (milliseconds)]
+     */
+    'kernel:after-init': [duration: number];
+    /**
+     * Emitted when a plugin is registered
+     * Payload: [pluginName: string]
+     */
+    'plugin:registered': [pluginName: string];
+    /**
+     * Emitted before a plugin's init method is called
+     * Payload: [pluginName: string]
+     */
+    'plugin:before-init': [pluginName: string];
+    /**
+     * Emitted when a plugin has been initialized
+     * Payload: [pluginName: string]
+     */
+    'plugin:init': [pluginName: string];
+    /**
+     * Emitted after a plugin's init method completes
+     * Payload: [pluginName: string, duration: number (milliseconds)]
+     */
+    'plugin:after-init': [pluginName: string, duration: number];
+    /**
+     * Emitted before a plugin's start method is called
+     * Payload: [pluginName: string]
+     */
+    'plugin:before-start': [pluginName: string];
+    /**
+     * Emitted when a plugin has started successfully
+     * Payload: [pluginName: string, duration: number (milliseconds)]
+     */
+    'plugin:started': [pluginName: string, duration: number];
+    /**
+     * Emitted after a plugin's start method completes
+     * Payload: [pluginName: string, duration: number (milliseconds)]
+     */
+    'plugin:after-start': [pluginName: string, duration: number];
+    /**
+     * Emitted before a plugin's destroy method is called
+     * Payload: [pluginName: string]
+     */
+    'plugin:before-destroy': [pluginName: string];
+    /**
+     * Emitted when a plugin has been destroyed
+     * Payload: [pluginName: string]
+     */
+    'plugin:destroyed': [pluginName: string];
+    /**
+     * Emitted after a plugin's destroy method completes
+     * Payload: [pluginName: string, duration: number (milliseconds)]
+     */
+    'plugin:after-destroy': [pluginName: string, duration: number];
+    /**
+     * Emitted when a plugin encounters an error
+     * Payload: [pluginName: string, error: Error, phase: 'init' | 'start' | 'destroy']
+     */
+    'plugin:error': [pluginName: string, error: Error, phase: 'init' | 'start' | 'destroy'];
+    /**
+     * Emitted when a service is registered
+     * Payload: [serviceName: string]
+     */
+    'service:registered': [serviceName: string];
+    /**
+     * Emitted when a service is unregistered
+     * Payload: [serviceName: string]
+     */
+    'service:unregistered': [serviceName: string];
+    /**
+     * Emitted when a hook is registered
+     * Payload: [hookName: string, handlerCount: number]
+     */
+    'hook:registered': [hookName: string, handlerCount: number];
+    /**
+     * Emitted when a hook is triggered
+     * Payload: [hookName: string, args: any[]]
+     */
+    'hook:triggered': [hookName: string, args: any[]];
+}
+/**
+ * Type-safe event emitter interface
+ * Provides compile-time type checking for event names and payloads
+ */
+export interface ITypedEventEmitter<Events extends Record<string, any[]>> {
+    /**
+     * Register an event listener
+     * @param event - Event name (type-checked)
+     * @param handler - Event handler (type-checked against event payload)
+     */
+    on<K extends keyof Events>(event: K, handler: (...args: Events[K]) => void | Promise<void>): void;
+    /**
+     * Unregister an event listener
+     * @param event - Event name (type-checked)
+     * @param handler - Event handler to remove
+     */
+    off<K extends keyof Events>(event: K, handler: (...args: Events[K]) => void | Promise<void>): void;
+    /**
+     * Emit an event with type-checked payload
+     * @param event - Event name (type-checked)
+     * @param args - Event payload (type-checked)
+     */
+    emit<K extends keyof Events>(event: K, ...args: Events[K]): Promise<void>;
+    /**
+     * Register a one-time event listener
+     * @param event - Event name (type-checked)
+     * @param handler - Event handler (type-checked against event payload)
+     */
+    once?<K extends keyof Events>(event: K, handler: (...args: Events[K]) => void | Promise<void>): void;
+    /**
+     * Get the number of listeners for an event
+     * @param event - Event name
+     * @returns Number of registered listeners
+     */
+    listenerCount?<K extends keyof Events>(event: K): number;
+    /**
+     * Remove all listeners for an event (or all events if not specified)
+     * @param event - Optional event name
+     */
+    removeAllListeners?<K extends keyof Events>(event?: K): void;
+}
+//# sourceMappingURL=plugin-lifecycle-events.d.ts.map

package/dist/contracts/plugin-lifecycle-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-lifecycle-events.d.ts","sourceRoot":"","sources":["../../src/contracts/plugin-lifecycle-events.ts"],"names":[],"mappings":"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"}

package/dist/contracts/plugin-lifecycle-events.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * IPluginLifecycleEvents - Typed Plugin Lifecycle Events
+ *
+ * Type-safe event definitions for plugin and kernel lifecycle.
+ * Provides strong typing for event emitters and listeners.
+ *
+ * This replaces the generic Map<string, any[]> approach with typed events.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/plugin-validator.d.ts

@@ -0,0 +1,106 @@
+/**
+ * IPluginValidator - Plugin Validator Interface
+ *
+ * Abstract interface for validating plugins before registration and startup.
+ * Extracted from PluginLoader to follow Single Responsibility Principle.
+ */
+/**
+ * Validation result for a plugin
+ */
+export interface ValidationResult {
+    /**
+     * Whether the plugin passed validation
+     */
+    valid: boolean;
+    /**
+     * Validation errors (if any)
+     */
+    errors?: Array<{
+        field: string;
+        message: string;
+        code?: string;
+    }>;
+    /**
+     * Validation warnings (non-fatal issues)
+     */
+    warnings?: Array<{
+        field: string;
+        message: string;
+        code?: string;
+    }>;
+}
+/**
+ * Plugin metadata for validation
+ */
+export interface Plugin {
+    /**
+     * Unique plugin identifier
+     */
+    name: string;
+    /**
+     * Plugin version (semver)
+     */
+    version?: string;
+    /**
+     * Plugin dependencies
+     */
+    dependencies?: string[];
+    /**
+     * Plugin initialization function
+     */
+    init?: (context: any) => void | Promise<void>;
+    /**
+     * Plugin startup function
+     */
+    start?: (context: any) => void | Promise<void>;
+    /**
+     * Plugin destruction function
+     */
+    destroy?: (context: any) => void | Promise<void>;
+    /**
+     * Plugin signature for verification (optional)
+     */
+    signature?: string;
+    /**
+     * Additional plugin metadata
+     */
+    [key: string]: any;
+}
+/**
+ * IPluginValidator - Plugin validation interface
+ */
+export interface IPluginValidator {
+    /**
+     * Validate a plugin object structure
+     * @param plugin - Plugin to validate
+     * @returns Validation result
+     */
+    validate(plugin: unknown): ValidationResult;
+    /**
+     * Validate plugin version format (semver)
+     * @param version - Version string to validate
+     * @returns True if version is valid, false otherwise
+     */
+    validateVersion(version: string): boolean;
+    /**
+     * Validate plugin cryptographic signature (optional)
+     * Used for plugin security verification
+     * @param plugin - Plugin to validate
+     * @returns Promise resolving to true if signature is valid
+     */
+    validateSignature?(plugin: Plugin): Promise<boolean>;
+    /**
+     * Validate plugin dependencies are satisfied
+     * @param plugin - Plugin to validate
+     * @param registry - Map of already registered plugins
+     * @throws Error if dependencies are not satisfied
+     */
+    validateDependencies(plugin: Plugin, registry: Map<string, Plugin>): void;
+    /**
+     * Validate plugin has required lifecycle methods
+     * @param plugin - Plugin to validate
+     * @returns True if plugin has valid lifecycle methods
+     */
+    validateLifecycle?(plugin: Plugin): boolean;
+}
+//# sourceMappingURL=plugin-validator.d.ts.map

package/dist/contracts/plugin-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-validator.d.ts","sourceRoot":"","sources":["../../src/contracts/plugin-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IAEH;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACN;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB;;OAEG;IACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAE5C;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAE1C;;;;;OAKG;IACH,iBAAiB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErD;;;;;OAKG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAE1E;;;;OAIG;IACH,iBAAiB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/C"}