@objectstack/spec 0.3.2 → 0.4.1

package/dist/system/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;
+    component?: string | undefined;
+    context?: Record<string, any> | undefined;
+    service?: string | undefined;
+    traceId?: string | undefined;
+    spanId?: string | undefined;
+}, {
+    message: string;
+    timestamp: string;
+    level: "error" | "info" | "debug" | "warn" | "fatal";
+    error?: Record<string, any> | undefined;
+    component?: string | undefined;
+    context?: Record<string, any> | undefined;
+    service?: string | undefined;
+    traceId?: string | undefined;
+    spanId?: string | undefined;
+}>;
+export type LogEntry = z.infer<typeof LogEntrySchema>;
+//# sourceMappingURL=logger.zod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.zod.d.ts","sourceRoot":"","sources":["../../src/system/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/system/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)'),
+});

package/dist/system/manifest.zod.d.ts

@@ -66,25 +66,25 @@ export declare const ManifestSchema: z.ZodObject<{
             enum: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
             type: "string" | "number" | "boolean" | "object" | "array";
+            required?: boolean | undefined;
             default?: any;
             description?: string | undefined;
-            required?: boolean | undefined;
             secret?: boolean | undefined;
             enum?: string[] | undefined;
         }, {
             type: "string" | "number" | "boolean" | "object" | "array";
+            required?: boolean | undefined;
             default?: any;
             description?: string | undefined;
-            required?: boolean | undefined;
             secret?: boolean | undefined;
             enum?: string[] | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         properties: Record<string, {
             type: "string" | "number" | "boolean" | "object" | "array";
+            required?: boolean | undefined;
             default?: any;
             description?: string | undefined;
-            required?: boolean | undefined;
             secret?: boolean | undefined;
             enum?: string[] | undefined;
         }>;
@@ -92,9 +92,9 @@ export declare const ManifestSchema: z.ZodObject<{
     }, {
         properties: Record<string, {
             type: "string" | "number" | "boolean" | "object" | "array";
+            required?: boolean | undefined;
             default?: any;
             description?: string | undefined;
-            required?: boolean | undefined;
             secret?: boolean | undefined;
             enum?: string[] | undefined;
         }>;
@@ -197,7 +197,67 @@ export declare const ManifestSchema: z.ZodObject<{
             input?: any;
             output?: any;
         }>, "many">>;
+        /**
+         * Register Storage Drivers.
+         * Enables connecting to new types of datasources.
+         */
+        drivers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            id: string;
+            description?: string | undefined;
+        }, {
+            label: string;
+            id: string;
+            description?: string | undefined;
+        }>, "many">>;
+        /**
+         * Register Custom Field Types.
+         * Extends the data model with new widget types.
+         */
+        fieldTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            name: string;
+            description?: string | undefined;
+        }, {
+            label: string;
+            name: string;
+            description?: string | undefined;
+        }>, "many">>;
+        /**
+         * Register Custom Query Operators/Functions.
+         * Extends ObjectQL with new functions (e.g. distance()).
+         */
+        functions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            returnType: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            description?: string | undefined;
+            args?: string[] | undefined;
+            returnType?: string | undefined;
+        }, {
+            name: string;
+            description?: string | undefined;
+            args?: string[] | undefined;
+            returnType?: string | undefined;
+        }>, "many">>;
     }, "strip", z.ZodTypeAny, {
+        events?: string[] | undefined;
+        fieldTypes?: {
+            label: string;
+            name: string;
+            description?: string | undefined;
+        }[] | undefined;
         actions?: {
             name: string;
             label?: string | undefined;
@@ -210,7 +270,6 @@ export declare const ManifestSchema: z.ZodObject<{
             globs: string[];
             description?: string | undefined;
         }[] | undefined;
-        events?: string[] | undefined;
         menus?: Record<string, {
             label: string;
             id: string;
@@ -225,7 +284,24 @@ export declare const ManifestSchema: z.ZodObject<{
             path: string;
             locale: string;
         }[] | undefined;
+        drivers?: {
+            label: string;
+            id: string;
+            description?: string | undefined;
+        }[] | undefined;
+        functions?: {
+            name: string;
+            description?: string | undefined;
+            args?: string[] | undefined;
+            returnType?: string | undefined;
+        }[] | undefined;
     }, {
+        events?: string[] | undefined;
+        fieldTypes?: {
+            label: string;
+            name: string;
+            description?: string | undefined;
+        }[] | undefined;
         actions?: {
             name: string;
             label?: string | undefined;
@@ -238,7 +314,6 @@ export declare const ManifestSchema: z.ZodObject<{
             globs: string[];
             description?: string | undefined;
         }[] | undefined;
-        events?: string[] | undefined;
         menus?: Record<string, {
             label: string;
             id: string;
@@ -253,6 +328,17 @@ export declare const ManifestSchema: z.ZodObject<{
             path: string;
             locale: string;
         }[] | undefined;
+        drivers?: {
+            label: string;
+            id: string;
+            description?: string | undefined;
+        }[] | undefined;
+        functions?: {
+            name: string;
+            description?: string | undefined;
+            args?: string[] | undefined;
+            returnType?: string | undefined;
+        }[] | undefined;
     }>>;
     /**
      * Initial data seeding configuration.
@@ -264,12 +350,12 @@ export declare const ManifestSchema: z.ZodObject<{
         mode: z.ZodDefault<z.ZodEnum<["upsert", "insert", "ignore"]>>;
     }, "strip", z.ZodTypeAny, {
         object: string;
-        mode: "upsert" | "insert" | "ignore";
+        mode: "insert" | "upsert" | "ignore";
         records: Record<string, any>[];
     }, {
         object: string;
         records: Record<string, any>[];
-        mode?: "upsert" | "insert" | "ignore" | undefined;
+        mode?: "insert" | "upsert" | "ignore" | undefined;
     }>, "many">>;
     /**
      * Extension points contributed by this package.
@@ -277,7 +363,7 @@ export declare const ManifestSchema: z.ZodObject<{
      */
     extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
 }, "strip", z.ZodTypeAny, {
-    type: "app" | "plugin" | "driver" | "module";
+    type: "app" | "module" | "plugin" | "driver";
     name: string;
     id: string;
     version: string;
@@ -285,24 +371,30 @@ export declare const ManifestSchema: z.ZodObject<{
     objects?: string[] | undefined;
     data?: {
         object: string;
-        mode: "upsert" | "insert" | "ignore";
+        mode: "insert" | "upsert" | "ignore";
         records: Record<string, any>[];
     }[] | undefined;
+    dependencies?: Record<string, string> | undefined;
     permissions?: string[] | undefined;
     datasources?: string[] | undefined;
-    dependencies?: Record<string, string> | undefined;
     configuration?: {
         properties: Record<string, {
             type: "string" | "number" | "boolean" | "object" | "array";
+            required?: boolean | undefined;
             default?: any;
             description?: string | undefined;
-            required?: boolean | undefined;
             secret?: boolean | undefined;
             enum?: string[] | undefined;
         }>;
         title?: string | undefined;
     } | undefined;
     contributes?: {
+        events?: string[] | undefined;
+        fieldTypes?: {
+            label: string;
+            name: string;
+            description?: string | undefined;
+        }[] | undefined;
         actions?: {
             name: string;
             label?: string | undefined;
@@ -315,7 +407,6 @@ export declare const ManifestSchema: z.ZodObject<{
             globs: string[];
             description?: string | undefined;
         }[] | undefined;
-        events?: string[] | undefined;
         menus?: Record<string, {
             label: string;
             id: string;
@@ -330,10 +421,21 @@ export declare const ManifestSchema: z.ZodObject<{
             path: string;
             locale: string;
         }[] | undefined;
+        drivers?: {
+            label: string;
+            id: string;
+            description?: string | undefined;
+        }[] | undefined;
+        functions?: {
+            name: string;
+            description?: string | undefined;
+            args?: string[] | undefined;
+            returnType?: string | undefined;
+        }[] | undefined;
     } | undefined;
     extensions?: Record<string, any> | undefined;
 }, {
-    type: "app" | "plugin" | "driver" | "module";
+    type: "app" | "module" | "plugin" | "driver";
     name: string;
     id: string;
     version: string;
@@ -342,23 +444,29 @@ export declare const ManifestSchema: z.ZodObject<{
     data?: {
         object: string;
         records: Record<string, any>[];
-        mode?: "upsert" | "insert" | "ignore" | undefined;
+        mode?: "insert" | "upsert" | "ignore" | undefined;
     }[] | undefined;
+    dependencies?: Record<string, string> | undefined;
     permissions?: string[] | undefined;
     datasources?: string[] | undefined;
-    dependencies?: Record<string, string> | undefined;
     configuration?: {
         properties: Record<string, {
             type: "string" | "number" | "boolean" | "object" | "array";
+            required?: boolean | undefined;
             default?: any;
             description?: string | undefined;
-            required?: boolean | undefined;
             secret?: boolean | undefined;
             enum?: string[] | undefined;
         }>;
         title?: string | undefined;
     } | undefined;
     contributes?: {
+        events?: string[] | undefined;
+        fieldTypes?: {
+            label: string;
+            name: string;
+            description?: string | undefined;
+        }[] | undefined;
         actions?: {
             name: string;
             label?: string | undefined;
@@ -371,7 +479,6 @@ export declare const ManifestSchema: z.ZodObject<{
             globs: string[];
             description?: string | undefined;
         }[] | undefined;
-        events?: string[] | undefined;
         menus?: Record<string, {
             label: string;
             id: string;
@@ -386,6 +493,17 @@ export declare const ManifestSchema: z.ZodObject<{
             path: string;
             locale: string;
         }[] | undefined;
+        drivers?: {
+            label: string;
+            id: string;
+            description?: string | undefined;
+        }[] | undefined;
+        functions?: {
+            name: string;
+            description?: string | undefined;
+            args?: string[] | undefined;
+            returnType?: string | undefined;
+        }[] | undefined;
     } | undefined;
     extensions?: Record<string, any> | undefined;
 }>;

package/dist/system/manifest.zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.zod.d.ts","sourceRoot":"","sources":["../../src/system/manifest.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,cAAc;IACzB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;;;OAMG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAaH;;;OAGG;;QAED;;;;WAIG;;;;;;;;;;;;;;QAOH;;;WAGG;;QAGH;;WAEG;;;;;;;;;;;;;;QAOH;;WAEG;;;;;;;;;;;;;;QAOH;;;WAGG;;;;;;;;;;;QAMH;;;WAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUL;;;OAGG;;;;;;;;;;;;;;IAOH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"manifest.zod.d.ts","sourceRoot":"","sources":["../../src/system/manifest.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,cAAc;IACzB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;;;OAMG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAaH;;;OAGG;;QAED;;;;WAIG;;;;;;;;;;;;;;QAOH;;;WAGG;;QAGH;;WAEG;;;;;;;;;;;;;;QAOH;;WAEG;;;;;;;;;;;;;;QAOH;;;WAGG;;;;;;;;;;;QAMH;;;WAGG;;;;;;;;;;;;;;;;;;;;QASH;;;WAGG;;;;;;;;;;;;;;QAOH;;;WAGG;;;;;;;;;;;;;;QAOH;;;WAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASL;;;OAGG;;;;;;;;;;;;;;IAOH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/system/manifest.zod.js

@@ -124,6 +124,34 @@ exports.ManifestSchema = zod_1.z.object({
             input: zod_1.z.any().optional().describe('Input validation schema'),
             output: zod_1.z.any().optional().describe('Output schema'),
         })).optional().describe('Exposed server actions'),
+        /**
+         * Register Storage Drivers.
+         * Enables connecting to new types of datasources.
+         */
+        drivers: zod_1.z.array(zod_1.z.object({
+            id: zod_1.z.string().describe('Driver unique identifier (e.g. "postgres", "mongo")'),
+            label: zod_1.z.string().describe('Human readable name'),
+            description: zod_1.z.string().optional(),
+        })).optional().describe('Driver contributions'),
+        /**
+         * Register Custom Field Types.
+         * Extends the data model with new widget types.
+         */
+        fieldTypes: zod_1.z.array(zod_1.z.object({
+            name: zod_1.z.string().describe('Unique field type name (e.g. "vector")'),
+            label: zod_1.z.string().describe('Display label'),
+            description: zod_1.z.string().optional(),
+        })).optional().describe('Field Type contributions'),
+        /**
+         * Register Custom Query Operators/Functions.
+         * Extends ObjectQL with new functions (e.g. distance()).
+         */
+        functions: zod_1.z.array(zod_1.z.object({
+            name: zod_1.z.string().describe('Function name (e.g. "distance")'),
+            description: zod_1.z.string().optional(),
+            args: zod_1.z.array(zod_1.z.string()).optional().describe('Argument types'),
+            returnType: zod_1.z.string().optional(),
+        })).optional().describe('Query Function contributions'),
     }).optional().describe('Platform contributions'),
     /**
      * Initial data seeding configuration.