@objectstack/core 3.0.8 → 3.0.9

package/dist/index.d.cts

@@ -1849,4 +1849,234 @@ declare class DependencyResolver {
     isAcyclic(dependencies: Map<string, string[]>): boolean;
 }
 
-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 };
+/**
+ * Namespace entry representing an object/view/flow etc. registered by a package.
+ */
+interface NamespaceEntry {
+    /** The namespace path (e.g. "objects.project_task", "views.task_list") */
+    namespace: string;
+    /** The package that owns this namespace */
+    packageId: string;
+    /** When this entry was registered */
+    registeredAt: string;
+}
+/**
+ * Result of a namespace conflict check.
+ */
+interface NamespaceConflict {
+    /** The conflicting namespace path */
+    namespace: string;
+    /** The package that currently owns this namespace */
+    existingPackageId: string;
+    /** The package attempting to register the same namespace */
+    incomingPackageId: string;
+    /** A suggested alternative name to avoid the conflict */
+    suggestion?: string;
+}
+/**
+ * Result of namespace availability check.
+ */
+interface NamespaceCheckResult {
+    /** Whether all requested namespaces are available */
+    available: boolean;
+    /** List of conflicts detected */
+    conflicts: NamespaceConflict[];
+    /** Suggested alternatives for each conflict */
+    suggestions: Record<string, string>;
+}
+/**
+ * Namespace Resolver
+ *
+ * Manages namespace registration for installed packages and detects collisions
+ * during install-time. Each metadata item (object, view, flow, page, etc.)
+ * produces a namespace like `objects.<name>` or `views.<name>`.
+ *
+ * When a new package declares objects, views, or other metadata that would
+ * collide with an existing package's metadata, this resolver reports the
+ * conflicts and suggests prefixed alternatives.
+ */
+declare class NamespaceResolver {
+    private logger;
+    private registry;
+    constructor(logger: ObjectLogger);
+    /**
+     * Register namespaces owned by a package.
+     */
+    register(packageId: string, namespaces: string[]): void;
+    /**
+     * Unregister all namespaces belonging to a package.
+     */
+    unregister(packageId: string): string[];
+    /**
+     * Check whether a set of namespaces is available for a given package.
+     */
+    checkAvailability(packageId: string, namespaces: string[]): NamespaceCheckResult;
+    /**
+     * Extract namespace strings from a package's metadata definition.
+     */
+    extractNamespaces(config: Record<string, unknown>): string[];
+    /**
+     * Get all registered entries.
+     */
+    getRegistry(): ReadonlyMap<string, NamespaceEntry>;
+    /**
+     * Get all namespaces belonging to a specific package.
+     */
+    getPackageNamespaces(packageId: string): string[];
+    /**
+     * Generate a prefixed alternative namespace to avoid conflicts.
+     */
+    private suggestAlternative;
+}
+
+/**
+ * Installed package record in the runtime registry.
+ */
+interface InstalledPackageRecord {
+    /** Package identifier */
+    packageId: string;
+    /** Package version */
+    version: string;
+    /** Package manifest */
+    manifest: Record<string, unknown>;
+    /** Installation timestamp */
+    installedAt: string;
+    /** Current status */
+    status: 'installed' | 'disabled' | 'installing' | 'upgrading' | 'uninstalling' | 'error';
+    /** Namespaces registered by this package */
+    namespaces: string[];
+    /** Dependencies of this package */
+    dependencies: string[];
+}
+/**
+ * Snapshot of a package's state before upgrade (for rollback).
+ */
+interface PackageSnapshot {
+    /** Package identifier */
+    packageId: string;
+    /** Version before upgrade */
+    previousVersion: string;
+    /** Full manifest before upgrade */
+    previousManifest: Record<string, unknown>;
+    /** Namespaces before upgrade */
+    previousNamespaces: string[];
+    /** Original installation timestamp */
+    installedAt: string;
+    /** Snapshot timestamp */
+    createdAt: string;
+}
+/**
+ * Result of a package installation attempt.
+ */
+interface InstallResult {
+    success: boolean;
+    packageId: string;
+    version: string;
+    installedDependencies: string[];
+    namespaceConflicts: Array<{
+        namespace: string;
+        existingPackageId: string;
+    }>;
+    errorMessage?: string;
+}
+/**
+ * Result of an upgrade attempt.
+ */
+interface UpgradeResult {
+    success: boolean;
+    packageId: string;
+    fromVersion: string;
+    toVersion: string;
+    snapshot: PackageSnapshot;
+    errorMessage?: string;
+}
+/**
+ * Result of a rollback attempt.
+ */
+interface RollbackResult {
+    success: boolean;
+    packageId: string;
+    restoredVersion: string;
+    errorMessage?: string;
+}
+/**
+ * Package Manager
+ *
+ * Runtime implementation for the full package lifecycle:
+ * install → upgrade → rollback → uninstall.
+ *
+ * Consumes the protocol schemas defined in @objectstack/spec:
+ * - DependencyResolutionResultSchema
+ * - NamespaceConflictErrorSchema
+ * - UpgradePlanSchema / UpgradeSnapshotSchema
+ * - PackageArtifactSchema
+ *
+ * Coordinates with:
+ * - DependencyResolver for topological ordering and conflict detection
+ * - NamespaceResolver for metadata collision prevention
+ */
+declare class PackageManager {
+    private logger;
+    private packages;
+    private snapshots;
+    private dependencyResolver;
+    private namespaceResolver;
+    private platformVersion;
+    constructor(logger: ObjectLogger, options?: {
+        platformVersion?: string;
+    });
+    /**
+     * Install a package with full dependency resolution and namespace checking.
+     */
+    install(packageId: string, version: string, manifest: Record<string, unknown>): Promise<InstallResult>;
+    /**
+     * Uninstall a package, checking for dependents first.
+     */
+    uninstall(packageId: string): Promise<{
+        success: boolean;
+        errorMessage?: string;
+    }>;
+    /**
+     * Upgrade a package: snapshot → update → register.
+     */
+    upgrade(packageId: string, newVersion: string, newManifest: Record<string, unknown>): Promise<UpgradeResult>;
+    /**
+     * Rollback a package to its pre-upgrade snapshot.
+     */
+    rollback(packageId: string): Promise<RollbackResult>;
+    /**
+     * Get an installed package record.
+     */
+    getPackage(packageId: string): InstalledPackageRecord | undefined;
+    /**
+     * List all installed packages.
+     */
+    listPackages(): InstalledPackageRecord[];
+    /**
+     * Resolve dependencies for a set of packages.
+     */
+    resolveDependencies(packages: Map<string, {
+        version?: string;
+        dependencies?: string[];
+    }>): string[];
+    /**
+     * Check namespace availability for a package's metadata.
+     */
+    checkNamespaces(packageId: string, config: Record<string, unknown>): {
+        available: boolean;
+        conflicts: Array<{
+            namespace: string;
+            existingPackageId: string;
+        }>;
+    };
+    /**
+     * Get the namespace resolver instance.
+     */
+    getNamespaceResolver(): NamespaceResolver;
+    /**
+     * Get a snapshot for a given package (if available).
+     */
+    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, createMemoryJob, createMemoryQueue, createPluginConfigValidator, createPluginPermissionEnforcer, getEnv, getMemoryUsage, isNode, safeExit };

package/dist/index.d.ts

@@ -1849,4 +1849,234 @@ declare class DependencyResolver {
     isAcyclic(dependencies: Map<string, string[]>): boolean;
 }
 
-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 };
+/**
+ * Namespace entry representing an object/view/flow etc. registered by a package.
+ */
+interface NamespaceEntry {
+    /** The namespace path (e.g. "objects.project_task", "views.task_list") */
+    namespace: string;
+    /** The package that owns this namespace */
+    packageId: string;
+    /** When this entry was registered */
+    registeredAt: string;
+}
+/**
+ * Result of a namespace conflict check.
+ */
+interface NamespaceConflict {
+    /** The conflicting namespace path */
+    namespace: string;
+    /** The package that currently owns this namespace */
+    existingPackageId: string;
+    /** The package attempting to register the same namespace */
+    incomingPackageId: string;
+    /** A suggested alternative name to avoid the conflict */
+    suggestion?: string;
+}
+/**
+ * Result of namespace availability check.
+ */
+interface NamespaceCheckResult {
+    /** Whether all requested namespaces are available */
+    available: boolean;
+    /** List of conflicts detected */
+    conflicts: NamespaceConflict[];
+    /** Suggested alternatives for each conflict */
+    suggestions: Record<string, string>;
+}
+/**
+ * Namespace Resolver
+ *
+ * Manages namespace registration for installed packages and detects collisions
+ * during install-time. Each metadata item (object, view, flow, page, etc.)
+ * produces a namespace like `objects.<name>` or `views.<name>`.
+ *
+ * When a new package declares objects, views, or other metadata that would
+ * collide with an existing package's metadata, this resolver reports the
+ * conflicts and suggests prefixed alternatives.
+ */
+declare class NamespaceResolver {
+    private logger;
+    private registry;
+    constructor(logger: ObjectLogger);
+    /**
+     * Register namespaces owned by a package.
+     */
+    register(packageId: string, namespaces: string[]): void;
+    /**
+     * Unregister all namespaces belonging to a package.
+     */
+    unregister(packageId: string): string[];
+    /**
+     * Check whether a set of namespaces is available for a given package.
+     */
+    checkAvailability(packageId: string, namespaces: string[]): NamespaceCheckResult;
+    /**
+     * Extract namespace strings from a package's metadata definition.
+     */
+    extractNamespaces(config: Record<string, unknown>): string[];
+    /**
+     * Get all registered entries.
+     */
+    getRegistry(): ReadonlyMap<string, NamespaceEntry>;
+    /**
+     * Get all namespaces belonging to a specific package.
+     */
+    getPackageNamespaces(packageId: string): string[];
+    /**
+     * Generate a prefixed alternative namespace to avoid conflicts.
+     */
+    private suggestAlternative;
+}
+
+/**
+ * Installed package record in the runtime registry.
+ */
+interface InstalledPackageRecord {
+    /** Package identifier */
+    packageId: string;
+    /** Package version */
+    version: string;
+    /** Package manifest */
+    manifest: Record<string, unknown>;
+    /** Installation timestamp */
+    installedAt: string;
+    /** Current status */
+    status: 'installed' | 'disabled' | 'installing' | 'upgrading' | 'uninstalling' | 'error';
+    /** Namespaces registered by this package */
+    namespaces: string[];
+    /** Dependencies of this package */
+    dependencies: string[];
+}
+/**
+ * Snapshot of a package's state before upgrade (for rollback).
+ */
+interface PackageSnapshot {
+    /** Package identifier */
+    packageId: string;
+    /** Version before upgrade */
+    previousVersion: string;
+    /** Full manifest before upgrade */
+    previousManifest: Record<string, unknown>;
+    /** Namespaces before upgrade */
+    previousNamespaces: string[];
+    /** Original installation timestamp */
+    installedAt: string;
+    /** Snapshot timestamp */
+    createdAt: string;
+}
+/**
+ * Result of a package installation attempt.
+ */
+interface InstallResult {
+    success: boolean;
+    packageId: string;
+    version: string;
+    installedDependencies: string[];
+    namespaceConflicts: Array<{
+        namespace: string;
+        existingPackageId: string;
+    }>;
+    errorMessage?: string;
+}
+/**
+ * Result of an upgrade attempt.
+ */
+interface UpgradeResult {
+    success: boolean;
+    packageId: string;
+    fromVersion: string;
+    toVersion: string;
+    snapshot: PackageSnapshot;
+    errorMessage?: string;
+}
+/**
+ * Result of a rollback attempt.
+ */
+interface RollbackResult {
+    success: boolean;
+    packageId: string;
+    restoredVersion: string;
+    errorMessage?: string;
+}
+/**
+ * Package Manager
+ *
+ * Runtime implementation for the full package lifecycle:
+ * install → upgrade → rollback → uninstall.
+ *
+ * Consumes the protocol schemas defined in @objectstack/spec:
+ * - DependencyResolutionResultSchema
+ * - NamespaceConflictErrorSchema
+ * - UpgradePlanSchema / UpgradeSnapshotSchema
+ * - PackageArtifactSchema
+ *
+ * Coordinates with:
+ * - DependencyResolver for topological ordering and conflict detection
+ * - NamespaceResolver for metadata collision prevention
+ */
+declare class PackageManager {
+    private logger;
+    private packages;
+    private snapshots;
+    private dependencyResolver;
+    private namespaceResolver;
+    private platformVersion;
+    constructor(logger: ObjectLogger, options?: {
+        platformVersion?: string;
+    });
+    /**
+     * Install a package with full dependency resolution and namespace checking.
+     */
+    install(packageId: string, version: string, manifest: Record<string, unknown>): Promise<InstallResult>;
+    /**
+     * Uninstall a package, checking for dependents first.
+     */
+    uninstall(packageId: string): Promise<{
+        success: boolean;
+        errorMessage?: string;
+    }>;
+    /**
+     * Upgrade a package: snapshot → update → register.
+     */
+    upgrade(packageId: string, newVersion: string, newManifest: Record<string, unknown>): Promise<UpgradeResult>;
+    /**
+     * Rollback a package to its pre-upgrade snapshot.
+     */
+    rollback(packageId: string): Promise<RollbackResult>;
+    /**
+     * Get an installed package record.
+     */
+    getPackage(packageId: string): InstalledPackageRecord | undefined;
+    /**
+     * List all installed packages.
+     */
+    listPackages(): InstalledPackageRecord[];
+    /**
+     * Resolve dependencies for a set of packages.
+     */
+    resolveDependencies(packages: Map<string, {
+        version?: string;
+        dependencies?: string[];
+    }>): string[];
+    /**
+     * Check namespace availability for a package's metadata.
+     */
+    checkNamespaces(packageId: string, config: Record<string, unknown>): {
+        available: boolean;
+        conflicts: Array<{
+            namespace: string;
+            existingPackageId: string;
+        }>;
+    };
+    /**
+     * Get the namespace resolver instance.
+     */
+    getNamespaceResolver(): NamespaceResolver;
+    /**
+     * Get a snapshot for a given package (if available).
+     */
+    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, createMemoryJob, createMemoryQueue, createPluginConfigValidator, createPluginPermissionEnforcer, getEnv, getMemoryUsage, isNode, safeExit };