@hamak/logging 0.5.1

package/dist/spi/transport/transport-provider.d.ts

@@ -0,0 +1,89 @@
+import type { ILogTransport, TransportConfig } from '../../api/index';
+/**
+ * Transport Provider Interface
+ *
+ * Allows plugins to contribute custom log transports.
+ * Transport providers are factories that create and configure transports.
+ *
+ * @example
+ * ```typescript
+ * export class MyTransportProvider implements ITransportProvider {
+ *   readonly id = 'my-transport';
+ *   readonly name = 'My Custom Transport';
+ *
+ *   create(config?: MyTransportConfig): ILogTransport {
+ *     return new MyTransport(config);
+ *   }
+ *
+ *   getDefaultConfig(): TransportConfig {
+ *     return {
+ *       id: this.id,
+ *       enabled: true,
+ *       minLevel: LogLevel.INFO,
+ *     };
+ *   }
+ *
+ *   validateConfig(config: any): boolean {
+ *     return typeof config.endpoint === 'string';
+ *   }
+ * }
+ * ```
+ */
+export interface ITransportProvider {
+    /**
+     * Unique identifier for this transport provider
+     */
+    readonly id: string;
+    /**
+     * Human-readable name
+     */
+    readonly name: string;
+    /**
+     * Description of what this transport does
+     */
+    readonly description?: string;
+    /**
+     * Create a transport instance with the given configuration
+     *
+     * @param config Optional transport-specific configuration
+     * @returns A configured transport instance
+     */
+    create(config?: any): ILogTransport;
+    /**
+     * Get the default configuration for this transport
+     * Used when no configuration is provided
+     *
+     * @returns Default TransportConfig
+     */
+    getDefaultConfig?(): TransportConfig;
+    /**
+     * Validate transport-specific configuration
+     * Called before creating the transport
+     *
+     * @param config Configuration to validate
+     * @returns true if valid, false otherwise
+     */
+    validateConfig?(config: any): boolean;
+    /**
+     * Get configuration schema for documentation/UI
+     * Optional - useful for generating config forms
+     *
+     * @returns JSON Schema or similar
+     */
+    getConfigSchema?(): any;
+}
+/**
+ * Transport registration
+ * Used when plugins contribute transports
+ */
+export interface TransportRegistration {
+    /** The transport provider */
+    provider: ITransportProvider;
+    /** Transport configuration */
+    config?: TransportConfig;
+    /** Plugin that registered this transport */
+    plugin?: string;
+    /** Priority (higher = registered earlier) */
+    priority?: number;
+}
+//# sourceMappingURL=transport-provider.d.ts.map

package/dist/spi/transport/transport-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-provider.d.ts","sourceRoot":"","sources":["../../../src/spi/transport/transport-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,aAAa,CAAC;IAEpC;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,eAAe,CAAC;IAErC;;;;;;OAMG;IACH,cAAc,CAAC,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC;IAEtC;;;;;OAKG;IACH,eAAe,CAAC,IAAI,GAAG,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,QAAQ,EAAE,kBAAkB,CAAC;IAE7B,8BAA8B;IAC9B,MAAM,CAAC,EAAE,eAAe,CAAC;IAEzB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/spi/transport/transport-provider.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@hamak/logging",
+  "version": "0.5.1",
+  "description": "Pluggable logging system with API, SPI, and implementation",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./api": {
+      "types": "./dist/api/index.d.ts",
+      "import": "./dist/api/index.js",
+      "default": "./dist/api/index.js"
+    },
+    "./spi": {
+      "types": "./dist/spi/index.d.ts",
+      "import": "./dist/spi/index.js",
+      "default": "./dist/spi/index.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "api": [
+        "./dist/api/index.d.ts"
+      ],
+      "spi": [
+        "./dist/spi/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/amah/app-framework.git",
+    "directory": "packages/logging"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.lib.json",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "logging",
+    "microkernel",
+    "plugin"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@hamak/microkernel-api": "*",
+    "@hamak/microkernel-spi": "*"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  }
+}