@objectstack/core 4.0.1 → 4.0.3

package/dist/index.d.cts

@@ -222,6 +222,13 @@ declare class ObjectKernel {
      * Register a service factory with lifecycle management
      */
     registerServiceFactory<T>(name: string, factory: ServiceFactory<T>, lifecycle?: ServiceLifecycle, dependencies?: string[]): this;
+    /**
+     * Pre-inject in-memory fallbacks for 'core' services that were not registered
+     * by plugins during Phase 1. Called before Phase 2 so that all core services
+     * (e.g. 'metadata', 'cache', 'queue') are resolvable via ctx.getService()
+     * when plugin start() methods execute.
+     */
+    private preInjectCoreFallbacks;
     /**
      * Validate Critical System Requirements
      */
@@ -1681,6 +1688,26 @@ declare function createMemoryI18n(): {
     setDefaultLocale(locale: string): void;
 };
 
+/**
+ * In-memory metadata service fallback.
+ *
+ * Implements the IMetadataService contract with a simple Map-of-Maps store.
+ * Used by ObjectKernel as an automatic fallback when no real metadata plugin
+ * (e.g. MetadataPlugin with file-system persistence) is registered.
+ */
+declare function createMemoryMetadata(): {
+    _fallback: boolean;
+    _serviceName: string;
+    register(type: string, name: string, data: any): Promise<void>;
+    get(type: string, name: string): Promise<any>;
+    list(type: string): Promise<any[]>;
+    unregister(type: string, name: string): Promise<void>;
+    exists(type: string, name: string): Promise<boolean>;
+    listNames(type: string): Promise<string[]>;
+    getObject(name: string): Promise<any>;
+    listObjects(): Promise<any[]>;
+};
+
 /**
  * Map of core-criticality service names to their in-memory fallback factories.
  * Used by ObjectKernel.validateSystemRequirements() to auto-inject fallbacks
@@ -2113,4 +2140,4 @@ declare class PackageManager {
     getSnapshot(packageId: string): PackageSnapshot | undefined;
 }
 
-export { ApiRegistry, type ApiRegistryPluginConfig, CORE_FALLBACK_FACTORIES, DependencyResolver, HotReloadManager, type InstallResult, type InstalledPackageRecord, type KernelState, LiteKernel, type NamespaceCheckResult, type NamespaceConflict, type NamespaceEntry, NamespaceResolver, ObjectKernel, ObjectKernelBase, type ObjectKernelConfig, ObjectLogger, PackageManager, type PackageSnapshot, 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 RollbackResult, type SandboxContext, type ScanTarget, SecurePluginContext, type SecurityIssue, SemanticVersionManager, type ServiceFactory, ServiceLifecycle, type ServiceRegistration, type SignatureVerificationResult, type UpgradeResult, type VersionCompatibility, createApiRegistryPlugin, createLogger, createMemoryCache, createMemoryI18n, createMemoryJob, createMemoryQueue, createPluginConfigValidator, createPluginPermissionEnforcer, getEnv, getMemoryUsage, isNode, resolveLocale, safeExit };
+export { ApiRegistry, type ApiRegistryPluginConfig, CORE_FALLBACK_FACTORIES, DependencyResolver, HotReloadManager, type InstallResult, type InstalledPackageRecord, type KernelState, LiteKernel, type NamespaceCheckResult, type NamespaceConflict, type NamespaceEntry, NamespaceResolver, ObjectKernel, ObjectKernelBase, type ObjectKernelConfig, ObjectLogger, PackageManager, type PackageSnapshot, 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 RollbackResult, type SandboxContext, type ScanTarget, SecurePluginContext, type SecurityIssue, SemanticVersionManager, type ServiceFactory, ServiceLifecycle, type ServiceRegistration, type SignatureVerificationResult, type UpgradeResult, type VersionCompatibility, createApiRegistryPlugin, createLogger, createMemoryCache, createMemoryI18n, createMemoryJob, createMemoryMetadata, createMemoryQueue, createPluginConfigValidator, createPluginPermissionEnforcer, getEnv, getMemoryUsage, isNode, resolveLocale, safeExit };

package/dist/index.d.ts

@@ -222,6 +222,13 @@ declare class ObjectKernel {
      * Register a service factory with lifecycle management
      */
     registerServiceFactory<T>(name: string, factory: ServiceFactory<T>, lifecycle?: ServiceLifecycle, dependencies?: string[]): this;
+    /**
+     * Pre-inject in-memory fallbacks for 'core' services that were not registered
+     * by plugins during Phase 1. Called before Phase 2 so that all core services
+     * (e.g. 'metadata', 'cache', 'queue') are resolvable via ctx.getService()
+     * when plugin start() methods execute.
+     */
+    private preInjectCoreFallbacks;
     /**
      * Validate Critical System Requirements
      */
@@ -1681,6 +1688,26 @@ declare function createMemoryI18n(): {
     setDefaultLocale(locale: string): void;
 };
 
+/**
+ * In-memory metadata service fallback.
+ *
+ * Implements the IMetadataService contract with a simple Map-of-Maps store.
+ * Used by ObjectKernel as an automatic fallback when no real metadata plugin
+ * (e.g. MetadataPlugin with file-system persistence) is registered.
+ */
+declare function createMemoryMetadata(): {
+    _fallback: boolean;
+    _serviceName: string;
+    register(type: string, name: string, data: any): Promise<void>;
+    get(type: string, name: string): Promise<any>;
+    list(type: string): Promise<any[]>;
+    unregister(type: string, name: string): Promise<void>;
+    exists(type: string, name: string): Promise<boolean>;
+    listNames(type: string): Promise<string[]>;
+    getObject(name: string): Promise<any>;
+    listObjects(): Promise<any[]>;
+};
+
 /**
  * Map of core-criticality service names to their in-memory fallback factories.
  * Used by ObjectKernel.validateSystemRequirements() to auto-inject fallbacks
@@ -2113,4 +2140,4 @@ declare class PackageManager {
     getSnapshot(packageId: string): PackageSnapshot | undefined;
 }
 
-export { ApiRegistry, type ApiRegistryPluginConfig, CORE_FALLBACK_FACTORIES, DependencyResolver, HotReloadManager, type InstallResult, type InstalledPackageRecord, type KernelState, LiteKernel, type NamespaceCheckResult, type NamespaceConflict, type NamespaceEntry, NamespaceResolver, ObjectKernel, ObjectKernelBase, type ObjectKernelConfig, ObjectLogger, PackageManager, type PackageSnapshot, 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 RollbackResult, type SandboxContext, type ScanTarget, SecurePluginContext, type SecurityIssue, SemanticVersionManager, type ServiceFactory, ServiceLifecycle, type ServiceRegistration, type SignatureVerificationResult, type UpgradeResult, type VersionCompatibility, createApiRegistryPlugin, createLogger, createMemoryCache, createMemoryI18n, createMemoryJob, createMemoryQueue, createPluginConfigValidator, createPluginPermissionEnforcer, getEnv, getMemoryUsage, isNode, resolveLocale, safeExit };
+export { ApiRegistry, type ApiRegistryPluginConfig, CORE_FALLBACK_FACTORIES, DependencyResolver, HotReloadManager, type InstallResult, type InstalledPackageRecord, type KernelState, LiteKernel, type NamespaceCheckResult, type NamespaceConflict, type NamespaceEntry, NamespaceResolver, ObjectKernel, ObjectKernelBase, type ObjectKernelConfig, ObjectLogger, PackageManager, type PackageSnapshot, 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 RollbackResult, type SandboxContext, type ScanTarget, SecurePluginContext, type SecurityIssue, SemanticVersionManager, type ServiceFactory, ServiceLifecycle, type ServiceRegistration, type SignatureVerificationResult, type UpgradeResult, type VersionCompatibility, createApiRegistryPlugin, createLogger, createMemoryCache, createMemoryI18n, createMemoryJob, createMemoryMetadata, createMemoryQueue, createPluginConfigValidator, createPluginPermissionEnforcer, getEnv, getMemoryUsage, isNode, resolveLocale, safeExit };

package/dist/index.js

@@ -1091,8 +1091,50 @@ function createMemoryI18n() {
   };
 }
 
+// src/fallbacks/memory-metadata.ts
+function createMemoryMetadata() {
+  const store = /* @__PURE__ */ new Map();
+  function getTypeMap(type) {
+    let map = store.get(type);
+    if (!map) {
+      map = /* @__PURE__ */ new Map();
+      store.set(type, map);
+    }
+    return map;
+  }
+  return {
+    _fallback: true,
+    _serviceName: "metadata",
+    async register(type, name, data) {
+      getTypeMap(type).set(name, data);
+    },
+    async get(type, name) {
+      return getTypeMap(type).get(name);
+    },
+    async list(type) {
+      return Array.from(getTypeMap(type).values());
+    },
+    async unregister(type, name) {
+      getTypeMap(type).delete(name);
+    },
+    async exists(type, name) {
+      return getTypeMap(type).has(name);
+    },
+    async listNames(type) {
+      return Array.from(getTypeMap(type).keys());
+    },
+    async getObject(name) {
+      return getTypeMap("object").get(name);
+    },
+    async listObjects() {
+      return Array.from(getTypeMap("object").values());
+    }
+  };
+}
+
 // src/fallbacks/index.ts
 var CORE_FALLBACK_FACTORIES = {
+  metadata: createMemoryMetadata,
   cache: createMemoryCache,
   queue: createMemoryQueue,
   job: createMemoryJob,
@@ -1229,6 +1271,27 @@ var ObjectKernel = class {
     });
     return this;
   }
+  /**
+   * Pre-inject in-memory fallbacks for 'core' services that were not registered
+   * by plugins during Phase 1. Called before Phase 2 so that all core services
+   * (e.g. 'metadata', 'cache', 'queue') are resolvable via ctx.getService()
+   * when plugin start() methods execute.
+   */
+  preInjectCoreFallbacks() {
+    if (this.config.skipSystemValidation) return;
+    for (const [serviceName, criticality] of Object.entries(ServiceRequirementDef)) {
+      if (criticality !== "core") continue;
+      const hasService = this.services.has(serviceName) || this.pluginLoader.hasService(serviceName);
+      if (!hasService) {
+        const factory = CORE_FALLBACK_FACTORIES[serviceName];
+        if (factory) {
+          const fallback = factory();
+          this.registerService(serviceName, fallback);
+          this.logger.debug(`[Kernel] Pre-injected in-memory fallback for '${serviceName}' before Phase 2`);
+        }
+      }
+    }
+  }
   /**
    * Validate Critical System Requirements
    */
@@ -1290,6 +1353,7 @@ var ObjectKernel = class {
       for (const plugin of orderedPlugins) {
         await this.initPluginWithTimeout(plugin);
       }
+      this.preInjectCoreFallbacks();
       this.logger.info("Phase 2: Start plugins");
       this.state = "running";
       for (const plugin of orderedPlugins) {
@@ -4920,6 +4984,7 @@ export {
   createMemoryCache,
   createMemoryI18n,
   createMemoryJob,
+  createMemoryMetadata,
   createMemoryQueue,
   createPluginConfigValidator,
   createPluginPermissionEnforcer,