@objectstack/core 3.0.2 → 3.0.4

package/dist/index.d.cts

@@ -1591,6 +1591,69 @@ declare function getMemoryUsage(): {
     heapTotal: number;
 };
 
+/**
+ * In-memory Map-backed cache fallback.
+ *
+ * Implements the ICacheService contract with basic get/set/delete/has/clear
+ * and TTL expiry.  Used by ObjectKernel as an automatic fallback when no
+ * real cache plugin (e.g. Redis) is registered.
+ */
+declare function createMemoryCache(): {
+    _fallback: boolean;
+    _serviceName: string;
+    get<T = unknown>(key: string): Promise<T | undefined>;
+    set<T = unknown>(key: string, value: T, ttl?: number): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    has(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    stats(): Promise<{
+        hits: number;
+        misses: number;
+        keyCount: number;
+    }>;
+};
+
+/**
+ * In-memory publish/subscribe queue fallback.
+ *
+ * Implements the IQueueService contract with synchronous in-process delivery.
+ * Used by ObjectKernel as an automatic fallback when no real queue plugin
+ * (e.g. BullMQ / RabbitMQ) is registered.
+ */
+declare function createMemoryQueue(): {
+    _fallback: boolean;
+    _serviceName: string;
+    publish<T = unknown>(queue: string, data: T): Promise<string>;
+    subscribe(queue: string, handler: (msg: any) => Promise<void>): Promise<void>;
+    unsubscribe(queue: string): Promise<void>;
+    getQueueSize(): Promise<number>;
+    purge(queue: string): Promise<void>;
+};
+
+/**
+ * In-memory job scheduler fallback.
+ *
+ * Implements the IJobService contract with basic schedule/cancel/trigger
+ * operations.  Used by ObjectKernel as an automatic fallback when no real
+ * job plugin (e.g. Agenda / BullMQ) is registered.
+ */
+declare function createMemoryJob(): {
+    _fallback: boolean;
+    _serviceName: string;
+    schedule(name: string, schedule: any, handler: any): Promise<void>;
+    cancel(name: string): Promise<void>;
+    trigger(name: string, data?: unknown): Promise<void>;
+    getExecutions(): Promise<any[]>;
+    listJobs(): Promise<string[]>;
+};
+
+/**
+ * Map of core-criticality service names to their in-memory fallback factories.
+ * Used by ObjectKernel.validateSystemRequirements() to auto-inject fallbacks
+ * when no real plugin provides the service.
+ */
+declare const CORE_FALLBACK_FACTORIES: Record<string, () => Record<string, any>>;
+
 /**
  * Plugin Health Monitor
  *
@@ -1786,4 +1849,4 @@ declare class DependencyResolver {
     isAcyclic(dependencies: Map<string, string[]>): boolean;
 }
 
-export { ApiRegistry, type ApiRegistryPluginConfig, DependencyResolver, HotReloadManager, type KernelState, LiteKernel, ObjectKernel, ObjectKernelBase, type ObjectKernelConfig, ObjectLogger, type PermissionCheckResult$1 as PermissionCheckResult, type PermissionGrant, type Plugin, PluginConfigValidator, type PluginContext, PluginHealthMonitor, type PluginHealthStatus, type PluginLoadResult, PluginLoader, type PluginMetadata, type PermissionCheckResult as PluginPermissionCheckResult, PluginPermissionEnforcer, PluginPermissionManager, type PluginPermissions, PluginSandboxRuntime, PluginSecurityScanner, type PluginSignatureConfig, PluginSignatureVerifier, type PluginStartupResult, index as QA, type ResourceUsage, type SandboxContext, type ScanTarget, SecurePluginContext, type SecurityIssue, SemanticVersionManager, type ServiceFactory, ServiceLifecycle, type ServiceRegistration, type SignatureVerificationResult, type VersionCompatibility, createApiRegistryPlugin, createLogger, createPluginConfigValidator, createPluginPermissionEnforcer, getEnv, getMemoryUsage, isNode, safeExit };
+export { ApiRegistry, type ApiRegistryPluginConfig, CORE_FALLBACK_FACTORIES, DependencyResolver, HotReloadManager, type KernelState, LiteKernel, ObjectKernel, ObjectKernelBase, type ObjectKernelConfig, ObjectLogger, type PermissionCheckResult$1 as PermissionCheckResult, type PermissionGrant, type Plugin, PluginConfigValidator, type PluginContext, PluginHealthMonitor, type PluginHealthStatus, type PluginLoadResult, PluginLoader, type PluginMetadata, type PermissionCheckResult as PluginPermissionCheckResult, PluginPermissionEnforcer, PluginPermissionManager, type PluginPermissions, PluginSandboxRuntime, PluginSecurityScanner, type PluginSignatureConfig, PluginSignatureVerifier, type PluginStartupResult, index as QA, type ResourceUsage, type SandboxContext, type ScanTarget, SecurePluginContext, type SecurityIssue, SemanticVersionManager, type ServiceFactory, ServiceLifecycle, type ServiceRegistration, type SignatureVerificationResult, type VersionCompatibility, createApiRegistryPlugin, createLogger, createMemoryCache, createMemoryJob, createMemoryQueue, createPluginConfigValidator, createPluginPermissionEnforcer, getEnv, getMemoryUsage, isNode, safeExit };

package/dist/index.d.ts

@@ -1591,6 +1591,69 @@ declare function getMemoryUsage(): {
     heapTotal: number;
 };
 
+/**
+ * In-memory Map-backed cache fallback.
+ *
+ * Implements the ICacheService contract with basic get/set/delete/has/clear
+ * and TTL expiry.  Used by ObjectKernel as an automatic fallback when no
+ * real cache plugin (e.g. Redis) is registered.
+ */
+declare function createMemoryCache(): {
+    _fallback: boolean;
+    _serviceName: string;
+    get<T = unknown>(key: string): Promise<T | undefined>;
+    set<T = unknown>(key: string, value: T, ttl?: number): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    has(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    stats(): Promise<{
+        hits: number;
+        misses: number;
+        keyCount: number;
+    }>;
+};
+
+/**
+ * In-memory publish/subscribe queue fallback.
+ *
+ * Implements the IQueueService contract with synchronous in-process delivery.
+ * Used by ObjectKernel as an automatic fallback when no real queue plugin
+ * (e.g. BullMQ / RabbitMQ) is registered.
+ */
+declare function createMemoryQueue(): {
+    _fallback: boolean;
+    _serviceName: string;
+    publish<T = unknown>(queue: string, data: T): Promise<string>;
+    subscribe(queue: string, handler: (msg: any) => Promise<void>): Promise<void>;
+    unsubscribe(queue: string): Promise<void>;
+    getQueueSize(): Promise<number>;
+    purge(queue: string): Promise<void>;
+};
+
+/**
+ * In-memory job scheduler fallback.
+ *
+ * Implements the IJobService contract with basic schedule/cancel/trigger
+ * operations.  Used by ObjectKernel as an automatic fallback when no real
+ * job plugin (e.g. Agenda / BullMQ) is registered.
+ */
+declare function createMemoryJob(): {
+    _fallback: boolean;
+    _serviceName: string;
+    schedule(name: string, schedule: any, handler: any): Promise<void>;
+    cancel(name: string): Promise<void>;
+    trigger(name: string, data?: unknown): Promise<void>;
+    getExecutions(): Promise<any[]>;
+    listJobs(): Promise<string[]>;
+};
+
+/**
+ * Map of core-criticality service names to their in-memory fallback factories.
+ * Used by ObjectKernel.validateSystemRequirements() to auto-inject fallbacks
+ * when no real plugin provides the service.
+ */
+declare const CORE_FALLBACK_FACTORIES: Record<string, () => Record<string, any>>;
+
 /**
  * Plugin Health Monitor
  *
@@ -1786,4 +1849,4 @@ declare class DependencyResolver {
     isAcyclic(dependencies: Map<string, string[]>): boolean;
 }
 
-export { ApiRegistry, type ApiRegistryPluginConfig, DependencyResolver, HotReloadManager, type KernelState, LiteKernel, ObjectKernel, ObjectKernelBase, type ObjectKernelConfig, ObjectLogger, type PermissionCheckResult$1 as PermissionCheckResult, type PermissionGrant, type Plugin, PluginConfigValidator, type PluginContext, PluginHealthMonitor, type PluginHealthStatus, type PluginLoadResult, PluginLoader, type PluginMetadata, type PermissionCheckResult as PluginPermissionCheckResult, PluginPermissionEnforcer, PluginPermissionManager, type PluginPermissions, PluginSandboxRuntime, PluginSecurityScanner, type PluginSignatureConfig, PluginSignatureVerifier, type PluginStartupResult, index as QA, type ResourceUsage, type SandboxContext, type ScanTarget, SecurePluginContext, type SecurityIssue, SemanticVersionManager, type ServiceFactory, ServiceLifecycle, type ServiceRegistration, type SignatureVerificationResult, type VersionCompatibility, createApiRegistryPlugin, createLogger, createPluginConfigValidator, createPluginPermissionEnforcer, getEnv, getMemoryUsage, isNode, safeExit };
+export { ApiRegistry, type ApiRegistryPluginConfig, CORE_FALLBACK_FACTORIES, DependencyResolver, HotReloadManager, type KernelState, LiteKernel, ObjectKernel, ObjectKernelBase, type ObjectKernelConfig, ObjectLogger, type PermissionCheckResult$1 as PermissionCheckResult, type PermissionGrant, type Plugin, PluginConfigValidator, type PluginContext, PluginHealthMonitor, type PluginHealthStatus, type PluginLoadResult, PluginLoader, type PluginMetadata, type PermissionCheckResult as PluginPermissionCheckResult, PluginPermissionEnforcer, PluginPermissionManager, type PluginPermissions, PluginSandboxRuntime, PluginSecurityScanner, type PluginSignatureConfig, PluginSignatureVerifier, type PluginStartupResult, index as QA, type ResourceUsage, type SandboxContext, type ScanTarget, SecurePluginContext, type SecurityIssue, SemanticVersionManager, type ServiceFactory, ServiceLifecycle, type ServiceRegistration, type SignatureVerificationResult, type VersionCompatibility, createApiRegistryPlugin, createLogger, createMemoryCache, createMemoryJob, createMemoryQueue, createPluginConfigValidator, createPluginPermissionEnforcer, getEnv, getMemoryUsage, isNode, safeExit };

package/dist/index.js

@@ -941,6 +941,102 @@ var PluginLoader = class {
   }
 };
 
+// src/fallbacks/memory-cache.ts
+function createMemoryCache() {
+  const store = /* @__PURE__ */ new Map();
+  let hits = 0;
+  let misses = 0;
+  return {
+    _fallback: true,
+    _serviceName: "cache",
+    async get(key) {
+      const entry = store.get(key);
+      if (!entry || entry.expires && Date.now() > entry.expires) {
+        store.delete(key);
+        misses++;
+        return void 0;
+      }
+      hits++;
+      return entry.value;
+    },
+    async set(key, value, ttl) {
+      store.set(key, { value, expires: ttl ? Date.now() + ttl * 1e3 : void 0 });
+    },
+    async delete(key) {
+      return store.delete(key);
+    },
+    async has(key) {
+      return store.has(key);
+    },
+    async clear() {
+      store.clear();
+    },
+    async stats() {
+      return { hits, misses, keyCount: store.size };
+    }
+  };
+}
+
+// src/fallbacks/memory-queue.ts
+function createMemoryQueue() {
+  const handlers = /* @__PURE__ */ new Map();
+  let msgId = 0;
+  return {
+    _fallback: true,
+    _serviceName: "queue",
+    async publish(queue, data) {
+      const id = `fallback-msg-${++msgId}`;
+      const fns = handlers.get(queue) ?? [];
+      for (const fn of fns) fn({ id, data, attempts: 1, timestamp: Date.now() });
+      return id;
+    },
+    async subscribe(queue, handler) {
+      handlers.set(queue, [...handlers.get(queue) ?? [], handler]);
+    },
+    async unsubscribe(queue) {
+      handlers.delete(queue);
+    },
+    async getQueueSize() {
+      return 0;
+    },
+    async purge(queue) {
+      handlers.delete(queue);
+    }
+  };
+}
+
+// src/fallbacks/memory-job.ts
+function createMemoryJob() {
+  const jobs = /* @__PURE__ */ new Map();
+  return {
+    _fallback: true,
+    _serviceName: "job",
+    async schedule(name, schedule, handler) {
+      jobs.set(name, { schedule, handler });
+    },
+    async cancel(name) {
+      jobs.delete(name);
+    },
+    async trigger(name, data) {
+      const job = jobs.get(name);
+      if (job?.handler) await job.handler({ jobId: name, data });
+    },
+    async getExecutions() {
+      return [];
+    },
+    async listJobs() {
+      return [...jobs.keys()];
+    }
+  };
+}
+
+// src/fallbacks/index.ts
+var CORE_FALLBACK_FACTORIES = {
+  cache: createMemoryCache,
+  queue: createMemoryQueue,
+  job: createMemoryJob
+};
+
 // src/kernel.ts
 var ObjectKernel = class {
   constructor(config = {}) {
@@ -1089,8 +1185,15 @@ var ObjectKernel = class {
           this.logger.error(`CRITICAL: Required service missing: ${serviceName}`);
           missingServices.push(serviceName);
         } else if (criticality === "core") {
-          this.logger.warn(`CORE: Core service missing, functionality may be degraded: ${serviceName}`);
-          missingCoreServices.push(serviceName);
+          const factory = CORE_FALLBACK_FACTORIES[serviceName];
+          if (factory) {
+            const fallback = factory();
+            this.registerService(serviceName, fallback);
+            this.logger.warn(`Service '${serviceName}' not provided \u2014 using in-memory fallback`);
+          } else {
+            this.logger.warn(`CORE: Core service missing, functionality may be degraded: ${serviceName}`);
+            missingCoreServices.push(serviceName);
+          }
         } else {
           this.logger.info(`Info: Optional service not present: ${serviceName}`);
         }
@@ -4337,6 +4440,7 @@ var DependencyResolver = class {
 };
 export {
   ApiRegistry,
+  CORE_FALLBACK_FACTORIES,
   DependencyResolver,
   HotReloadManager,
   LiteKernel,
@@ -4357,6 +4461,9 @@ export {
   ServiceLifecycle,
   createApiRegistryPlugin,
   createLogger,
+  createMemoryCache,
+  createMemoryJob,
+  createMemoryQueue,
   createPluginConfigValidator,
   createPluginPermissionEnforcer,
   getEnv,