@makaio/framework 1.0.0-dev-1781117225170 → 1.0.0-dev-1781354548379

package/dist/runtime-node/index.d.mts

@@ -1,18 +1,17 @@
 import { RuntimeSubjects } from "./bus/runtime/namespace.mjs";
-import { a as FilesystemDescriptorDiscovery, n as ExplicitDescriptorDiscovery, o as FilesystemDescriptorDiscoveryOptions, r as ExtensionDiscovery, t as DiscoveredExtension } from "../extension-discovery-BD1-oNU_.mjs";
-import { a as isMakaioExtensionLike, c as resolveConventionEntrypoint, i as isCliContributionLike, n as LoadExtensionsOptions, o as isWithinDirectory, r as entrypointStem, s as loadExtensions, t as DescriptorSourcePackageGroup } from "../load-extensions-DE8qDIqi.mjs";
-import { A as normalizeNodeHostCapabilities, B as HttpContributionPhase, C as TransportReadyInfo, D as WorkflowWorkerEntryResolverOptions, E as WorkflowWorkerEntryMode, F as NodeFrameworkModuleResolver, H as HonoRouteGraph, I as NoopFrameworkModuleResolver, L as resolveFrameworkSpecifier, M as ShutdownStep, N as BridgeBrowserOptions, O as resolveWorkflowWorkerEntry, P as FrameworkModuleResolver, R as HttpRouteGraphBuilder, S as ServerTransportProvider, T as WorkflowRunnerBootOptions, U as HonoRouteGraphOptions, V as HttpRouteContribution, W as createHonoRouteGraph, _ as WorkflowRunResult, a as InProcessWorkflowRunnerOptions, b as CoreBootOptions, g as ThinWorkflowPiscinaRunnerOptions, h as IWorkflowRunner, i as InProcessWorkflowRunner, j as selectFrameworkCorePackages, k as HostCapabilityDeclaration, m as ThinWorkflowPiscinaRunner, v as BootCoordinatorSetupContext, w as UpstreamTelemetryBootOptions, x as MakaioRuntime, y as BootMakaioRuntimeOptions, z as createHttpRouteGraphBuilder } from "../index-i7o6FtS0.mjs";
+import { a as FilesystemDescriptorDiscovery, n as ExplicitDescriptorDiscovery, o as FilesystemDescriptorDiscoveryOptions, r as ExtensionDiscovery, t as DiscoveredExtension } from "../extension-discovery-CkV_VRdJ.mjs";
+import { a as isMakaioExtensionLike, c as resolveConventionEntrypoint, i as isCliContributionLike, n as LoadExtensionsOptions, o as isWithinDirectory, r as entrypointStem, s as loadExtensions, t as DescriptorSourcePackageGroup } from "../load-extensions-D9nbDIiW.mjs";
+import { A as InitializeNodeDatabaseOptions, B as NoopFrameworkModuleResolver, C as TransportReadyInfo, D as WorkflowWorkerEntryResolverOptions, E as WorkflowWorkerEntryMode, F as selectFrameworkCorePackages, G as HttpRouteContribution, H as HttpRouteGraphBuilder, I as ShutdownStep, J as createHonoRouteGraph, K as HonoRouteGraph, L as BridgeBrowserOptions, M as initializeNodeDatabase, N as HostCapabilityDeclaration, O as resolveWorkflowWorkerEntry, P as normalizeNodeHostCapabilities, R as FrameworkModuleResolver, S as ServerTransportProvider, T as WorkflowRunnerBootOptions, U as createHttpRouteGraphBuilder, V as resolveFrameworkSpecifier, W as HttpContributionPhase, _ as WorkflowRunResult, a as InProcessWorkflowRunnerOptions, b as CoreBootOptions, g as ThinWorkflowPiscinaRunnerOptions, h as IWorkflowRunner, i as InProcessWorkflowRunner, j as InitializeNodeDatabaseResult, k as DatabaseBootOptions, m as ThinWorkflowPiscinaRunner, q as HonoRouteGraphOptions, v as BootCoordinatorSetupContext, w as UpstreamTelemetryBootOptions, x as MakaioRuntime, y as BootMakaioRuntimeOptions, z as NodeFrameworkModuleResolver } from "../index-BDRKAxIV.mjs";
 import { ConfiguredRuntimeOptions, LoadMakaioConfigOptions, LoadedMakaioConfig, MAKAIO_CONFIG_FILE_ENV, MAKAIO_HOME_ENV, MakaioConfig, ParseMakaioConfigOptions, ParsedMakaioConfig, WorkflowRunnerConfig, buildConfiguredRuntimeOptions, createMakaioConfigDiscovery, defineMakaioConfig, loadMakaioConfig, parseMakaioConfig, resolveMakaioConfigPath, resolveMakaioHome, shouldIncludeExtension } from "./makaio-config.mjs";
 import { z } from "zod";
 import { IConfigStorage } from "@makaio/framework/core";
 import { BusTransport, IMakaioBus } from "@makaio/framework/bus";
 import { AdapterClientRef, AdapterProviderDefinitionContract, Config, MakaioNodeExtension, ProtocolId } from "@makaio/framework/contracts";
 import { BaseService } from "@makaio/framework/service-base";
-import { MakaioDatabase } from "@makaio/framework/storage/drizzle";
+import { MakaioDatabase, StorageDialect as StorageDialect$1 } from "@makaio/framework/storage/drizzle";
 import { AdapterFile, CredentialRef, ProviderConfigFile } from "@makaio/framework/contracts/config";
 import { IAdapterConfigRepository, IAdapterConfigRepository as IAdapterConfigRepository$1 } from "@makaio/framework/services/adapter-subsystem";
 import { DispatchingAuth } from "@makaio/framework/node/transports";
-import { DatabaseClient } from "@makaio/framework/storage/drizzle/client";
 import { ContributionProcessor, ExtensionCoordinator, KernelMakaioExtension, TransportProvider } from "@makaio/framework/kernel";
 import { IModelRegistryCache, ModelRegistry } from "@makaio/framework/services/model-registry";
 import { MachineKeyStatus, MachineKeyValidation, PersistedMachineIdentity, loadOrCreateMachineIdentity, machineKeysExist, validateMachineKeys } from "@makaio/framework/node/machine-identity";
@@ -167,14 +166,17 @@ declare function activateAdapterRuntimeIdentity(input: ActivateAdapterRuntimeIde
 //#region runtimes/node/src/db-migrations.d.ts
 /** Options for applying framework central migrations. */
 interface RunMigrationsOptions {
-  /** Optional filesystem path to a bundled framework `drizzle/` migrations directory. */
+  /**
+   * Optional filesystem path to a bundled framework migrations directory.
+   * Defaults to the bundled chain matching the handle's dialect.
+   */
   readonly migrationsDir?: string;
 }
 /**
  * Run all database migrations.
  *
  * 1. Runs Drizzle-generated migrations for all framework tables
- * 2. Creates framework-owned FTS5 virtual tables and triggers (not supported by Drizzle)
+ * 2. Provisions the storage engine's full-text-search index (engine-owned)
  * @param db - Drizzle database instance
  * @param options - Optional migration source overrides for bundled hosts.
  */
@@ -406,44 +408,63 @@ interface NodeRuntimeOptions extends ConfiguredRuntimeOptions {
  */
 declare function buildNodeRuntimeOptions(options: LoadMakaioConfigOptions): Promise<NodeRuntimeOptions>;
 //#endregion
-//#region runtimes/node/src/initialize-node-database.d.ts
+//#region runtimes/node/src/resolve-bundled-migrations-dir.d.ts
 /**
- * Options for {@link initializeNodeDatabase}.
+ * Environment-dependent probe inputs for {@link resolveBundledMigrationsDir}.
+ *
+ * Production callers omit this and resolve against the real environment: this
+ * module's directory for the built-layout probe and `getMigrationsFolder` from
+ * `@makaio/storage-migrations` for the source-checkout probe. Tests inject
+ * controlled values to pin both probe outcomes against on-disk fixtures
+ * without module-level mocking.
  */
-interface InitializeNodeDatabaseOptions {
-  /** Override database file path. Defaults to MAKAIO_DATABASE_PATH env var, then `<makaioHome>/makaio.db`. */
-  dbPath?: string;
+interface BundledMigrationsProbes {
   /**
-   * Override framework central migrations directory.
-   *
-   * Bundled hosts copy migrations next to their entrypoint and pass that
-   * runtime asset path explicitly because package-local source paths are not
-   * available in the final image.
+   * Base directory of the built-layout probe; the candidate is
+   * `<moduleDir>/../<chainDirName>`. Defaults to this module's directory.
    */
-  migrationsDir?: string;
+  readonly moduleDir?: string;
   /**
-   * Makaio home directory used to derive the default database path.
-   * Superseded by `dbPath` and `MAKAIO_DATABASE_PATH`.
+   * Source-checkout probe returning the workspace migration chain for a
+   * dialect. Defaults to `getMigrationsFolder` from
+   * `@makaio/storage-migrations`; bundled hosts replace that implementation
+   * with a stub that throws.
    */
-  makaioHome: string;
-}
-/**
- * Result returned by {@link initializeNodeDatabase}.
- */
-interface InitializeNodeDatabaseResult {
-  databaseClient: DatabaseClient;
-  dbPath: string;
+  readonly getMigrationsFolder?: (dialect: StorageDialect$1) => string;
 }
 /**
- * Initialize SQLite database for Node runtime persistence.
- *
- * Supports `MAKAIO_DATABASE_PATH` for test or custom environments.
- * When `options.dbPath` is provided it takes precedence over the environment
- * variable, avoiding the need for callers to mutate `process.env`.
- * @param options - Configuration; see {@link InitializeNodeDatabaseOptions}.
- * @returns Initialized database client and resolved database path.
- */
-declare function initializeNodeDatabase(options: InitializeNodeDatabaseOptions): Promise<InitializeNodeDatabaseResult>;
+ * Resolve the bundled Drizzle migrations directory for a dialect.
+ *
+ * Probe order:
+ * 1. `path.resolve(moduleDir, '..', <chainDirName>)` — the published package
+ *    layout, where this module is built into `dist/runtime-node` and the
+ *    bundled chain is copied alongside under the engine-provided chain
+ *    directory name (`StorageEngine.migrations.chainDirName`). Only the
+ *    SQLite chain (`drizzle`) ships in the published framework layout; chains
+ *    owned by engine packages (e.g. the Postgres chain of
+ *    `@makaio/storage-pg`) are not found here and resolve through probe 2.
+ * 2. `getMigrationsFolder(dialect)` from `@makaio/storage-migrations`, wrapped
+ *    in try/catch — engines whose chain ships in their own package resolve
+ *    here via `StorageEngine.migrations.resolveSourceChainDir`. Bundled hosts
+ *    replace the module with a stub that throws; treat a throw as a failed
+ *    probe and carry its message into the final error.
+ *
+ * A candidate is valid iff `<candidate>/meta/_journal.json` exists. Returns the
+ * first valid candidate.
+ *
+ * Pass an explicit `migrationsDir` (boot option `centralMigrationsDir` or
+ * `InitializeNodeDatabaseOptions.migrationsDir`) when the migrations directory
+ * is staged elsewhere.
+ *
+ * When neither probe yields the requested dialect's chain, resolution fails
+ * loudly rather than silently falling back to the other dialect's chain.
+ * @param dialect - Storage dialect whose migration chain to locate.
+ * @param probes - Optional probe overrides; production callers omit this.
+ * @returns Absolute path of the migrations directory for the given dialect.
+ * @throws Error listing every probed path, the `meta/_journal.json` requirement,
+ *   and the explicit override remedy (`centralMigrationsDir`).
+ */
+declare function resolveBundledMigrationsDir(dialect: StorageDialect$1, probes?: BundledMigrationsProbes): string;
 //#endregion
 //#region runtimes/node/src/bus-server-transport.d.ts
 /**
@@ -661,6 +682,24 @@ declare class FileRegistryCache implements IModelRegistryCache {
   set(registry: ModelRegistry): Promise<void>;
 }
 //#endregion
+//#region runtimes/node/src/bus/runtime/get-runtime-database.d.ts
+/**
+ * Resolve the runtime database handle with `db` narrowed to
+ * {@link MakaioDatabase}.
+ *
+ * Wraps the `runtime.database` request so the single cast from the opaque
+ * wire shape lives here — at the runtime boundary — instead of being repeated
+ * at every consumer. For storage handler registration prefer
+ * `registerDrizzleHandlers` from `@makaio/storage-drizzle`, which receives the
+ * handle through the extension storage lifecycle; this helper covers typed
+ * ad-hoc access outside that seam.
+ * @typeParam TSchema - Drizzle table schema record. Defaults to an empty schema.
+ * @param bus - Connected bus instance.
+ * @returns The runtime's Drizzle database handle.
+ * @throws When no runtime registered a database provider (memory-only runtimes).
+ */
+declare function getRuntimeDatabase<TSchema extends Record<string, unknown> = Record<string, never>>(bus: IMakaioBus): Promise<MakaioDatabase<TSchema>>;
+//#endregion
 //#region runtimes/node/src/extension-browser-entry-paths.d.ts
 /**
  * Build the Rollup input name for a descriptor browser entry.
@@ -742,4 +781,4 @@ declare function findWorkspaceRoot(startDir: string): string;
  */
 declare function findWorkspaceRootInfo(startDir: string): WorkspaceRootInfo;
 //#endregion
-export { type ActivateAdapterRuntimeIdentityInput, type ActivatedAdapterRuntimeIdentity, type AttachedUpstreamTelemetry, type BootCoordinatorSetupContext, type BootMakaioRuntimeOptions, type BridgeBrowserOptions, type BusServerTransportOptions, BusServerTransportProvider, type ConfiguredRuntimeOptions, type CoreBootOptions, type CredentialProvider, type DescriptorSourcePackageGroup, type DiscoveredExtension, ExplicitDescriptorDiscovery, type ExtensionDiscovery, FileConfigStorage, FileRegistryCache, FilesystemDescriptorDiscovery, type FilesystemDescriptorDiscoveryOptions, type FrameworkModuleResolver, type HonoRouteGraph, type HonoRouteGraphOptions, type HttpContributionPhase, type HttpRouteContribution, type HttpRouteGraphBuilder, type IWorkflowRunner, InProcessWorkflowRunner, type InProcessWorkflowRunnerOptions, type InitializeNodeDatabaseOptions, type InitializeNodeDatabaseResult, type LoadExtensionsOptions, type LoadMakaioConfigOptions, type LoadedMakaioConfig, MAKAIO_CONFIG_FILE_ENV, MAKAIO_HOME_ENV, MAKAIO_UPSTREAM_SECRET_ENV, MAKAIO_UPSTREAM_URL_ENV, type MachineKeyStatus, type MachineKeyValidation, type MakaioConfig, type MakaioRuntime, NodeCredentialProvider, NodeFrameworkModuleResolver, type NodeRuntimeOptions, NoopFrameworkModuleResolver, type ParseMakaioConfigOptions, type ParsedMakaioConfig, type PersistedMachineIdentity, type PrepareAdapterRuntimeInput, type PreparedAdapterRuntime, type ResolveUpstreamTelemetryBootOptionsFromEnvOptions, RuntimeSubjects, type ServerTransportProvider, StoredCredentialProvider, ThinWorkflowPiscinaRunner, type ThinWorkflowPiscinaRunnerOptions, type TransportReadyInfo, type UpstreamTelemetryBootOptions, type UpstreamTelemetryEnv, type UpstreamTelemetryTransportConfig, type WorkflowRunResult, type WorkflowRunnerBootOptions, type WorkflowRunnerConfig, type WorkflowWorkerEntryMode, type WorkflowWorkerEntryResolverOptions, type WorkspaceRootInfo, WorkspaceRootNotFoundError, activateAdapterRuntimeIdentity, attachUpstreamTelemetry, bootMakaioRuntime, bootMakaioRuntimeCore, bridgeExtensionBrowserEntries, buildConfiguredRuntimeOptions, buildExtensionBrowserRollupInputName, buildExtensionBrowserRuntimeEntrypoint, buildNodeRuntimeOptions, createHonoRouteGraph, createHttpRouteGraphBuilder, createMakaioConfigDiscovery, createUpstreamTelemetryTransport, defineMakaioConfig, entrypointStem, findWorkspaceRoot, findWorkspaceRootInfo, initializeNodeDatabase, isCliContributionLike, isMakaioExtensionLike, isMissingOptionalRuntimePackage, isWithinDirectory, loadExtensions, loadMakaioConfig, loadOrCreateMachineIdentity, machineKeysExist, normalizeNodeHostCapabilities, parseMakaioConfig, prepareAdapterRuntime, readFrameworkVersion, registerAdapterNameResolver, resolveConventionEntrypoint, resolveFrameworkSpecifier, resolveListeningPort, resolveMakaioConfigPath, resolveMakaioHome, resolveStaticModelRegistryPath, resolveUpstreamTelemetryBootOptionsFromEnv, resolveWorkflowWorkerEntry, runMigrations, selectFrameworkCorePackages, shouldIncludeExtension, tryImport, validateMachineKeys, waitForServerListening };
+export { type ActivateAdapterRuntimeIdentityInput, type ActivatedAdapterRuntimeIdentity, type AttachedUpstreamTelemetry, type BootCoordinatorSetupContext, type BootMakaioRuntimeOptions, type BridgeBrowserOptions, type BundledMigrationsProbes, type BusServerTransportOptions, BusServerTransportProvider, type ConfiguredRuntimeOptions, type CoreBootOptions, type CredentialProvider, type DatabaseBootOptions, type DescriptorSourcePackageGroup, type DiscoveredExtension, ExplicitDescriptorDiscovery, type ExtensionDiscovery, FileConfigStorage, FileRegistryCache, FilesystemDescriptorDiscovery, type FilesystemDescriptorDiscoveryOptions, type FrameworkModuleResolver, type HonoRouteGraph, type HonoRouteGraphOptions, type HttpContributionPhase, type HttpRouteContribution, type HttpRouteGraphBuilder, type IWorkflowRunner, InProcessWorkflowRunner, type InProcessWorkflowRunnerOptions, type InitializeNodeDatabaseOptions, type InitializeNodeDatabaseResult, type LoadExtensionsOptions, type LoadMakaioConfigOptions, type LoadedMakaioConfig, MAKAIO_CONFIG_FILE_ENV, MAKAIO_HOME_ENV, MAKAIO_UPSTREAM_SECRET_ENV, MAKAIO_UPSTREAM_URL_ENV, type MachineKeyStatus, type MachineKeyValidation, type MakaioConfig, type MakaioRuntime, NodeCredentialProvider, NodeFrameworkModuleResolver, type NodeRuntimeOptions, NoopFrameworkModuleResolver, type ParseMakaioConfigOptions, type ParsedMakaioConfig, type PersistedMachineIdentity, type PrepareAdapterRuntimeInput, type PreparedAdapterRuntime, type ResolveUpstreamTelemetryBootOptionsFromEnvOptions, RuntimeSubjects, type ServerTransportProvider, StoredCredentialProvider, ThinWorkflowPiscinaRunner, type ThinWorkflowPiscinaRunnerOptions, type TransportReadyInfo, type UpstreamTelemetryBootOptions, type UpstreamTelemetryEnv, type UpstreamTelemetryTransportConfig, type WorkflowRunResult, type WorkflowRunnerBootOptions, type WorkflowRunnerConfig, type WorkflowWorkerEntryMode, type WorkflowWorkerEntryResolverOptions, type WorkspaceRootInfo, WorkspaceRootNotFoundError, activateAdapterRuntimeIdentity, attachUpstreamTelemetry, bootMakaioRuntime, bootMakaioRuntimeCore, bridgeExtensionBrowserEntries, buildConfiguredRuntimeOptions, buildExtensionBrowserRollupInputName, buildExtensionBrowserRuntimeEntrypoint, buildNodeRuntimeOptions, createHonoRouteGraph, createHttpRouteGraphBuilder, createMakaioConfigDiscovery, createUpstreamTelemetryTransport, defineMakaioConfig, entrypointStem, findWorkspaceRoot, findWorkspaceRootInfo, getRuntimeDatabase, initializeNodeDatabase, isCliContributionLike, isMakaioExtensionLike, isMissingOptionalRuntimePackage, isWithinDirectory, loadExtensions, loadMakaioConfig, loadOrCreateMachineIdentity, machineKeysExist, normalizeNodeHostCapabilities, parseMakaioConfig, prepareAdapterRuntime, readFrameworkVersion, registerAdapterNameResolver, resolveBundledMigrationsDir, resolveConventionEntrypoint, resolveFrameworkSpecifier, resolveListeningPort, resolveMakaioConfigPath, resolveMakaioHome, resolveStaticModelRegistryPath, resolveUpstreamTelemetryBootOptionsFromEnv, resolveWorkflowWorkerEntry, runMigrations, selectFrameworkCorePackages, shouldIncludeExtension, tryImport, validateMachineKeys, waitForServerListening };