@objectstack/spec 0.3.2 → 0.3.3

package/dist/kernel/logger.zod.d.ts

@@ -0,0 +1,111 @@
+import { z } from 'zod';
+/**
+ * Log Level Enum
+ * Standard RFC 5424 severity levels (simplified)
+ */
+export declare const LogLevel: z.ZodEnum<["debug", "info", "warn", "error", "fatal"]>;
+export type LogLevel = z.infer<typeof LogLevel>;
+/**
+ * Log Format Enum
+ */
+export declare const LogFormat: z.ZodEnum<["json", "text", "pretty"]>;
+export type LogFormat = z.infer<typeof LogFormat>;
+/**
+ * Logger Configuration Schema
+ * Configuration for the Kernel's internal logger
+ */
+export declare const LoggerConfigSchema: z.ZodObject<{
+    /**
+     * Minimum level to log
+     */
+    level: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error", "fatal"]>>;
+    /**
+     * Output format
+     */
+    format: z.ZodDefault<z.ZodEnum<["json", "text", "pretty"]>>;
+    /**
+     * Redact sensitive keys
+     */
+    redact: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Enable source location (file/line)
+     */
+    sourceLocation: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Log to file (optional)
+     */
+    file: z.ZodOptional<z.ZodString>;
+    /**
+     * Log rotation config (if file is set)
+     */
+    rotation: z.ZodOptional<z.ZodObject<{
+        maxSize: z.ZodDefault<z.ZodString>;
+        maxFiles: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxSize: string;
+        maxFiles: number;
+    }, {
+        maxSize?: string | undefined;
+        maxFiles?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    format: "text" | "json" | "pretty";
+    level: "error" | "info" | "debug" | "warn" | "fatal";
+    redact: string[];
+    sourceLocation: boolean;
+    file?: string | undefined;
+    rotation?: {
+        maxSize: string;
+        maxFiles: number;
+    } | undefined;
+}, {
+    file?: string | undefined;
+    format?: "text" | "json" | "pretty" | undefined;
+    level?: "error" | "info" | "debug" | "warn" | "fatal" | undefined;
+    redact?: string[] | undefined;
+    sourceLocation?: boolean | undefined;
+    rotation?: {
+        maxSize?: string | undefined;
+        maxFiles?: number | undefined;
+    } | undefined;
+}>;
+export type LoggerConfig = z.infer<typeof LoggerConfigSchema>;
+/**
+ * Log Entry Schema
+ * The shape of a structured log record
+ */
+export declare const LogEntrySchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    level: z.ZodEnum<["debug", "info", "warn", "error", "fatal"]>;
+    message: z.ZodString;
+    context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    error: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    /** Tracing */
+    traceId: z.ZodOptional<z.ZodString>;
+    spanId: z.ZodOptional<z.ZodString>;
+    /** Source */
+    service: z.ZodOptional<z.ZodString>;
+    component: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    timestamp: string;
+    level: "error" | "info" | "debug" | "warn" | "fatal";
+    error?: Record<string, any> | undefined;
+    service?: string | undefined;
+    context?: Record<string, any> | undefined;
+    traceId?: string | undefined;
+    spanId?: string | undefined;
+    component?: string | undefined;
+}, {
+    message: string;
+    timestamp: string;
+    level: "error" | "info" | "debug" | "warn" | "fatal";
+    error?: Record<string, any> | undefined;
+    service?: string | undefined;
+    context?: Record<string, any> | undefined;
+    traceId?: string | undefined;
+    spanId?: string | undefined;
+    component?: string | undefined;
+}>;
+export type LogEntry = z.infer<typeof LogEntrySchema>;
+//# sourceMappingURL=logger.zod.d.ts.map

package/dist/kernel/logger.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.zod.d.ts","sourceRoot":"","sources":["../../src/kernel/logger.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,QAAQ,wDAMY,CAAC;AAElC,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,SAAS,uCAIU,CAAC;AAEjC,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,kBAAkB;IAC7B;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAIH;;OAEG;;IAIH;;OAEG;;IAGH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKH,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;IAOzB,cAAc;;;IAId,aAAa;;;;;;;;;;;;;;;;;;;;;;;EAGb,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/kernel/logger.zod.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogEntrySchema = exports.LoggerConfigSchema = exports.LogFormat = exports.LogLevel = void 0;
+const zod_1 = require("zod");
+/**
+ * Log Level Enum
+ * Standard RFC 5424 severity levels (simplified)
+ */
+exports.LogLevel = zod_1.z.enum([
+    'debug',
+    'info',
+    'warn',
+    'error',
+    'fatal'
+]).describe('Log severity level');
+/**
+ * Log Format Enum
+ */
+exports.LogFormat = zod_1.z.enum([
+    'json', // Structural JSON for machine parsing
+    'text', // Simple text format
+    'pretty' // Colored generic output for CLI
+]).describe('Log output format');
+/**
+ * Logger Configuration Schema
+ * Configuration for the Kernel's internal logger
+ */
+exports.LoggerConfigSchema = zod_1.z.object({
+    /**
+     * Minimum level to log
+     */
+    level: exports.LogLevel.default('info'),
+    /**
+     * Output format
+     */
+    format: exports.LogFormat.default('json'),
+    /**
+     * Redact sensitive keys
+     */
+    redact: zod_1.z.array(zod_1.z.string()).default(['password', 'token', 'secret', 'key'])
+        .describe('Keys to redact from log context'),
+    /**
+     * Enable source location (file/line)
+     */
+    sourceLocation: zod_1.z.boolean().default(false)
+        .describe('Include file and line number'),
+    /**
+     * Log to file (optional)
+     */
+    file: zod_1.z.string().optional().describe('Path to log file'),
+    /**
+     * Log rotation config (if file is set)
+     */
+    rotation: zod_1.z.object({
+        maxSize: zod_1.z.string().default('10m'),
+        maxFiles: zod_1.z.number().default(5)
+    }).optional()
+});
+/**
+ * Log Entry Schema
+ * The shape of a structured log record
+ */
+exports.LogEntrySchema = zod_1.z.object({
+    timestamp: zod_1.z.string().datetime().describe('ISO 8601 timestamp'),
+    level: exports.LogLevel,
+    message: zod_1.z.string().describe('Log message'),
+    context: zod_1.z.record(zod_1.z.any()).optional().describe('Structured context data'),
+    error: zod_1.z.record(zod_1.z.any()).optional().describe('Error object if present'),
+    /** Tracing */
+    traceId: zod_1.z.string().optional().describe('Distributed trace ID'),
+    spanId: zod_1.z.string().optional().describe('Span ID'),
+    /** Source */
+    service: zod_1.z.string().optional().describe('Service name'),
+    component: zod_1.z.string().optional().describe('Component name (e.g. plugin id)'),
+});