fhir-engine 0.3.0 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +23 -0
- package/README.md +32 -0
- package/dist/cjs/index.cjs +125 -4
- package/dist/cjs/index.cjs.map +4 -4
- package/dist/cjs/index.d.ts +68 -0
- package/dist/esm/index.d.ts +68 -0
- package/dist/esm/index.mjs +121 -1
- package/dist/esm/index.mjs.map +4 -4
- package/dist/index.d.ts +68 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,29 @@ All notable changes to this project will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [0.4.0] - 2026-03-15
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
|
|
12
|
+
- **`resolvePackages(config, options?)`** — New top-level API that ensures FHIR IG packages are available in the project's `packages.path` directory before engine bootstrap. Resolution order: local → system cache (`~/.fhir/packages`) → FHIR Package Registry download. Returns `ResolvePackagesResult` with per-package status and errors.
|
|
13
|
+
- **`config.igs`** — New optional `FhirEngineConfig` field listing IG packages to resolve (e.g. `[{ name: 'hl7.fhir.r4.core', version: '4.0.1' }]`). When set, `createFhirEngine()` automatically calls `resolvePackages()` before loading definitions.
|
|
14
|
+
- **`config.packageResolve`** — New optional config field for resolution options (e.g. `{ allowDownload: false }` for offline mode).
|
|
15
|
+
- **Type exports** — `ResolvePackagesOptions`, `ResolvedPackage`, `ResolvePackagesResult`
|
|
16
|
+
- **New source file** — `src/package-resolver.ts`
|
|
17
|
+
|
|
18
|
+
### Changed
|
|
19
|
+
|
|
20
|
+
- **`createFhirEngine()` bootstrap** — Now includes a package resolution step (§1a) before loading definitions, triggered when `config.igs` is present. Backward compatible: omitting `igs` preserves v0.3.0 behavior.
|
|
21
|
+
- **Test suite expanded** — from 84 to 95 tests:
|
|
22
|
+
- resolvePackages(): 11 tests covering local detection, cache linking, offline errors, idempotency, option overrides, directory creation, and re-export verification
|
|
23
|
+
|
|
24
|
+
### Notes
|
|
25
|
+
|
|
26
|
+
- Resolves `FHIR_ENGINE_RESOLVE_PACKAGES_API.md` — fhir-cli `fhir new` / `fhir ig install` workflows can now use `resolvePackages()` to ensure packages are available before engine startup
|
|
27
|
+
- Uses Windows `junction` links (no admin required) and Unix `symlink` for linking cached packages
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
8
31
|
## [0.3.0] - 2026-03-15
|
|
9
32
|
|
|
10
33
|
### Added
|
package/README.md
CHANGED
|
@@ -10,6 +10,7 @@
|
|
|
10
10
|
## Features
|
|
11
11
|
|
|
12
12
|
- **One-call bootstrap** — `createFhirEngine(config)` initializes definitions, runtime, and persistence
|
|
13
|
+
- **Package resolution** — `resolvePackages()` downloads/caches FHIR IG packages automatically
|
|
13
14
|
- **Plugin system** — lifecycle hooks (`init` / `start` / `ready` / `stop`) for extensibility
|
|
14
15
|
- **Config file support** — `fhir.config.ts` / `.js` / `.json` with env variable overrides
|
|
15
16
|
- **Multi-adapter** — SQLite (native + WASM) out of the box, PostgreSQL planned
|
|
@@ -167,6 +168,8 @@ Creates and bootstraps a fully initialized FHIR engine.
|
|
|
167
168
|
interface FhirEngineConfig {
|
|
168
169
|
database: DatabaseConfig; // sqlite | sqlite-wasm | postgres
|
|
169
170
|
packages: PackagesConfig; // { path: string }
|
|
171
|
+
igs?: Array<{ name: string; version?: string }>; // IG packages to resolve
|
|
172
|
+
packageResolve?: { allowDownload?: boolean }; // resolution options
|
|
170
173
|
packageName?: string; // IG migration label
|
|
171
174
|
packageVersion?: string; // IG migration version
|
|
172
175
|
logger?: Logger; // custom logger (default: console)
|
|
@@ -174,6 +177,17 @@ interface FhirEngineConfig {
|
|
|
174
177
|
}
|
|
175
178
|
```
|
|
176
179
|
|
|
180
|
+
When `igs` is provided, `createFhirEngine()` automatically resolves packages before loading definitions:
|
|
181
|
+
|
|
182
|
+
```ts
|
|
183
|
+
const engine = await createFhirEngine({
|
|
184
|
+
database: { type: "sqlite", path: ":memory:" },
|
|
185
|
+
packages: { path: "./fhir-packages" },
|
|
186
|
+
igs: [{ name: "hl7.fhir.r4.core", version: "4.0.1" }],
|
|
187
|
+
});
|
|
188
|
+
// Packages are downloaded/linked into ./fhir-packages/ automatically
|
|
189
|
+
```
|
|
190
|
+
|
|
177
191
|
### `FhirEngineStatus`
|
|
178
192
|
|
|
179
193
|
Returned by `engine.status()`:
|
|
@@ -230,6 +244,24 @@ const active = evalFhirPathBoolean("Patient.active", patient); // boolean
|
|
|
230
244
|
const family = evalFhirPathString("Patient.name.family", patient); // string | undefined
|
|
231
245
|
```
|
|
232
246
|
|
|
247
|
+
### `resolvePackages(config, options?)`
|
|
248
|
+
|
|
249
|
+
Ensure FHIR IG packages are available in the project's packages directory.
|
|
250
|
+
|
|
251
|
+
Resolution order: local directory → system cache (`~/.fhir/packages`) → FHIR Package Registry download.
|
|
252
|
+
|
|
253
|
+
```ts
|
|
254
|
+
import { resolvePackages } from "fhir-engine";
|
|
255
|
+
|
|
256
|
+
const result = await resolvePackages(config);
|
|
257
|
+
console.log(result.success); // true if all resolved
|
|
258
|
+
console.log(result.packages); // ResolvedPackage[] with name, version, path, source
|
|
259
|
+
console.log(result.errors); // any failures
|
|
260
|
+
|
|
261
|
+
// Offline mode — cache only, no downloads
|
|
262
|
+
const offline = await resolvePackages(config, { allowDownload: false });
|
|
263
|
+
```
|
|
264
|
+
|
|
233
265
|
### `defineConfig(config)`
|
|
234
266
|
|
|
235
267
|
Type-safe identity helper for config files. Returns the config unchanged.
|
package/dist/cjs/index.cjs
CHANGED
|
@@ -30,12 +30,13 @@ __export(index_exports, {
|
|
|
30
30
|
evalFhirPathTyped: () => import_fhir_runtime2.evalFhirPathTyped,
|
|
31
31
|
executeSearch: () => import_fhir_persistence3.executeSearch,
|
|
32
32
|
loadFhirConfig: () => loadFhirConfig,
|
|
33
|
-
parseSearchRequest: () => import_fhir_persistence3.parseSearchRequest
|
|
33
|
+
parseSearchRequest: () => import_fhir_persistence3.parseSearchRequest,
|
|
34
|
+
resolvePackages: () => resolvePackages
|
|
34
35
|
});
|
|
35
36
|
module.exports = __toCommonJS(index_exports);
|
|
36
37
|
|
|
37
38
|
// src/engine.ts
|
|
38
|
-
var
|
|
39
|
+
var import_fhir_definition2 = require("fhir-definition");
|
|
39
40
|
var import_fhir_runtime = require("fhir-runtime");
|
|
40
41
|
var import_fhir_persistence2 = require("fhir-persistence");
|
|
41
42
|
|
|
@@ -187,6 +188,113 @@ function createConsoleLogger() {
|
|
|
187
188
|
};
|
|
188
189
|
}
|
|
189
190
|
|
|
191
|
+
// src/package-resolver.ts
|
|
192
|
+
var import_node_path2 = require("node:path");
|
|
193
|
+
var import_node_fs2 = require("node:fs");
|
|
194
|
+
var import_fhir_definition = require("fhir-definition");
|
|
195
|
+
function ensureDirSync(dir) {
|
|
196
|
+
if (!(0, import_node_fs2.existsSync)(dir)) {
|
|
197
|
+
(0, import_node_fs2.mkdirSync)(dir, { recursive: true });
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
function hasManifest(dir) {
|
|
201
|
+
return (0, import_node_fs2.existsSync)((0, import_node_path2.join)(dir, "package.json")) || (0, import_node_fs2.existsSync)((0, import_node_path2.join)(dir, "package", "package.json"));
|
|
202
|
+
}
|
|
203
|
+
function readLocalVersion(pkgDir) {
|
|
204
|
+
for (const candidate of [(0, import_node_path2.join)(pkgDir, "package.json"), (0, import_node_path2.join)(pkgDir, "package", "package.json")]) {
|
|
205
|
+
try {
|
|
206
|
+
const raw = (0, import_node_fs2.readFileSync)(candidate, "utf-8");
|
|
207
|
+
const manifest = JSON.parse(raw);
|
|
208
|
+
return manifest.version ?? "local";
|
|
209
|
+
} catch {
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
return "local";
|
|
213
|
+
}
|
|
214
|
+
async function resolvePackages(config, options) {
|
|
215
|
+
const packagesPath = (0, import_node_path2.resolve)(options?.packagesPath ?? config.packages.path);
|
|
216
|
+
const igs = options?.packages ?? config.igs ?? [];
|
|
217
|
+
const allowDownload = options?.allowDownload ?? config.packageResolve?.allowDownload ?? true;
|
|
218
|
+
const logger = options?.logger ?? config.logger;
|
|
219
|
+
const cache = new import_fhir_definition.PackageCache();
|
|
220
|
+
const client = new import_fhir_definition.PackageRegistryClient();
|
|
221
|
+
const results = [];
|
|
222
|
+
const errors = [];
|
|
223
|
+
ensureDirSync(packagesPath);
|
|
224
|
+
for (const ig of igs) {
|
|
225
|
+
try {
|
|
226
|
+
const localPath = (0, import_node_path2.join)(packagesPath, ig.name);
|
|
227
|
+
if (hasManifest(localPath)) {
|
|
228
|
+
const localVersion = readLocalVersion(localPath);
|
|
229
|
+
logger?.debug(`Package ${ig.name} already exists locally at ${localPath}`);
|
|
230
|
+
results.push({ name: ig.name, version: localVersion, path: localPath, source: "local" });
|
|
231
|
+
continue;
|
|
232
|
+
}
|
|
233
|
+
let version = ig.version ?? "latest";
|
|
234
|
+
if (version === "latest") {
|
|
235
|
+
if (!allowDownload) {
|
|
236
|
+
errors.push({
|
|
237
|
+
name: ig.name,
|
|
238
|
+
error: `Cannot resolve "latest" version for ${ig.name} without network access`
|
|
239
|
+
});
|
|
240
|
+
continue;
|
|
241
|
+
}
|
|
242
|
+
logger?.info(`Resolving latest version for ${ig.name}...`);
|
|
243
|
+
version = await client.getLatestVersion(ig.name);
|
|
244
|
+
logger?.info(`Latest version for ${ig.name}: ${version}`);
|
|
245
|
+
}
|
|
246
|
+
const cachePath = cache.getPath(ig.name, version);
|
|
247
|
+
if (cachePath) {
|
|
248
|
+
logger?.info(`Found ${ig.name}@${version} in system cache, linking...`);
|
|
249
|
+
createLink(cachePath, localPath);
|
|
250
|
+
results.push({ name: ig.name, version, path: localPath, source: "cache" });
|
|
251
|
+
continue;
|
|
252
|
+
}
|
|
253
|
+
if (!allowDownload) {
|
|
254
|
+
errors.push({
|
|
255
|
+
name: ig.name,
|
|
256
|
+
error: `Package ${ig.name}@${version} not found in cache, and downloads are disabled`
|
|
257
|
+
});
|
|
258
|
+
continue;
|
|
259
|
+
}
|
|
260
|
+
logger?.info(`Downloading ${ig.name}@${version} from registry...`);
|
|
261
|
+
const tarball = await client.download(ig.name, version);
|
|
262
|
+
cache.put(ig.name, version, tarball);
|
|
263
|
+
logger?.info(`Downloaded and cached ${ig.name}@${version}`);
|
|
264
|
+
const newCachePath = cache.getPath(ig.name, version);
|
|
265
|
+
if (!newCachePath) {
|
|
266
|
+
errors.push({ name: ig.name, error: `Failed to locate cached package after download` });
|
|
267
|
+
continue;
|
|
268
|
+
}
|
|
269
|
+
createLink(newCachePath, localPath);
|
|
270
|
+
results.push({ name: ig.name, version, path: localPath, source: "download" });
|
|
271
|
+
} catch (err) {
|
|
272
|
+
errors.push({
|
|
273
|
+
name: ig.name,
|
|
274
|
+
error: err instanceof Error ? err.message : String(err)
|
|
275
|
+
});
|
|
276
|
+
}
|
|
277
|
+
}
|
|
278
|
+
return {
|
|
279
|
+
success: errors.length === 0,
|
|
280
|
+
packages: results,
|
|
281
|
+
errors
|
|
282
|
+
};
|
|
283
|
+
}
|
|
284
|
+
function createLink(target, linkPath) {
|
|
285
|
+
if ((0, import_node_fs2.existsSync)(linkPath)) {
|
|
286
|
+
try {
|
|
287
|
+
const stat = (0, import_node_fs2.lstatSync)(linkPath);
|
|
288
|
+
if (stat.isSymbolicLink() || stat.isDirectory()) {
|
|
289
|
+
return;
|
|
290
|
+
}
|
|
291
|
+
} catch {
|
|
292
|
+
}
|
|
293
|
+
}
|
|
294
|
+
const linkType = process.platform === "win32" ? "junction" : "dir";
|
|
295
|
+
(0, import_node_fs2.symlinkSync)(target, linkPath, linkType);
|
|
296
|
+
}
|
|
297
|
+
|
|
190
298
|
// src/engine.ts
|
|
191
299
|
function resolveDialect(type) {
|
|
192
300
|
switch (type) {
|
|
@@ -234,8 +342,20 @@ async function createFhirEngine(config) {
|
|
|
234
342
|
const logger = config.logger ?? createConsoleLogger();
|
|
235
343
|
const plugins = config.plugins ?? [];
|
|
236
344
|
logger.info("Initializing fhir-engine...");
|
|
345
|
+
if (config.igs && config.igs.length > 0) {
|
|
346
|
+
logger.info(`Resolving ${config.igs.length} IG package(s)...`);
|
|
347
|
+
const resolveResult = await resolvePackages(config, { logger });
|
|
348
|
+
for (const pkg of resolveResult.packages) {
|
|
349
|
+
logger.info(`Resolved ${pkg.name}@${pkg.version} (${pkg.source})`);
|
|
350
|
+
}
|
|
351
|
+
if (!resolveResult.success) {
|
|
352
|
+
for (const err of resolveResult.errors) {
|
|
353
|
+
logger.warn(`Failed to resolve package ${err.name}: ${err.error}`);
|
|
354
|
+
}
|
|
355
|
+
}
|
|
356
|
+
}
|
|
237
357
|
logger.info(`Loading FHIR packages from: ${config.packages.path}`);
|
|
238
|
-
const { registry, result } = (0,
|
|
358
|
+
const { registry, result } = (0, import_fhir_definition2.loadDefinitionPackages)(config.packages.path);
|
|
239
359
|
logger.info(
|
|
240
360
|
`Loaded ${result.packages.length} package(s): ${result.packages.map((p) => `${p.name}@${p.version}`).join(", ")}`
|
|
241
361
|
);
|
|
@@ -355,6 +475,7 @@ var import_fhir_runtime2 = require("fhir-runtime");
|
|
|
355
475
|
evalFhirPathTyped,
|
|
356
476
|
executeSearch,
|
|
357
477
|
loadFhirConfig,
|
|
358
|
-
parseSearchRequest
|
|
478
|
+
parseSearchRequest,
|
|
479
|
+
resolvePackages
|
|
359
480
|
});
|
|
360
481
|
//# sourceMappingURL=index.cjs.map
|
package/dist/cjs/index.cjs.map
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
|
-
"sources": ["../../src/index.ts", "../../src/engine.ts", "../../src/adapter-factory.ts", "../../src/config.ts", "../../src/logger.ts"],
|
|
4
|
-
"sourcesContent": ["// fhir-engine \u2014 public API\n\nexport { createFhirEngine } from './engine.js';\nexport { defineConfig, loadFhirConfig } from './config.js';\nexport { createConsoleLogger } from './logger.js';\nexport { createAdapter } from './adapter-factory.js';\n\nexport type {\n FhirEngine,\n FhirEngineConfig,\n FhirEnginePlugin,\n FhirEngineStatus,\n EngineContext,\n DatabaseConfig,\n SqliteDatabaseConfig,\n SqliteWasmDatabaseConfig,\n PostgresDatabaseConfig,\n PackagesConfig,\n Logger,\n} from './types.js';\n\n// Re-export key upstream types for convenience\nexport type { DefinitionRegistry, DefinitionProvider } from 'fhir-definition';\nexport type { FhirRuntimeInstance } from 'fhir-runtime';\nexport type { FhirPersistence, StorageAdapter } from 'fhir-persistence';\n\n// ---------------------------------------------------------------------------\n// Search utilities (from fhir-persistence)\n// ---------------------------------------------------------------------------\n\nexport { parseSearchRequest, executeSearch } from 'fhir-persistence';\nexport type { SearchRequest, SearchResult, SearchOptions } from 'fhir-persistence';\n\n// ---------------------------------------------------------------------------\n// FHIRPath evaluation (from fhir-runtime)\n// ---------------------------------------------------------------------------\n\nexport { evalFhirPath, evalFhirPathBoolean, evalFhirPathString, evalFhirPathTyped } from 'fhir-runtime';\n", "import { loadDefinitionPackages } from 'fhir-definition';\nimport { createRuntime, extractSearchValues, extractAllSearchValues, extractReferences } from 'fhir-runtime';\nimport { FhirDefinitionBridge, FhirRuntimeProvider, FhirSystem, parseSearchRequest, executeSearch } from 'fhir-persistence';\n\nimport { createAdapter } from './adapter-factory.js';\nimport { loadFhirConfig } from './config.js';\nimport { createConsoleLogger } from './logger.js';\nimport type { EngineContext, FhirEngine, FhirEngineConfig, FhirEnginePlugin, FhirEngineStatus } from './types.js';\n\n/**\n * Resolve the SQL dialect from the database config type.\n */\nfunction resolveDialect(type: FhirEngineConfig['database']['type']): 'sqlite' | 'postgres' {\n switch (type) {\n case 'sqlite':\n case 'sqlite-wasm':\n return 'sqlite';\n case 'postgres':\n return 'postgres';\n }\n}\n\n/**\n * Validate the engine configuration, throwing on missing required fields.\n */\nfunction validateConfig(config: FhirEngineConfig): void {\n if (!config.database) {\n throw new Error('fhir-engine: config.database is required');\n }\n if (!config.database.type) {\n throw new Error('fhir-engine: config.database.type is required (sqlite | sqlite-wasm | postgres)');\n }\n if (!config.packages) {\n throw new Error('fhir-engine: config.packages is required');\n }\n if (!config.packages.path) {\n throw new Error('fhir-engine: config.packages.path is required');\n }\n}\n\n/**\n * Run a lifecycle hook on all plugins in order.\n * Wraps errors with the plugin name for clear diagnostics.\n */\nasync function runPluginHook(\n plugins: FhirEnginePlugin[],\n hook: 'init' | 'start' | 'ready',\n ctx: EngineContext,\n): Promise<void> {\n for (const plugin of plugins) {\n const fn = plugin[hook];\n if (fn) {\n try {\n await fn.call(plugin, ctx);\n } catch (err) {\n throw new Error(\n `fhir-engine: plugin \"${plugin.name}\" failed during ${hook}: ${err instanceof Error ? err.message : String(err)}`,\n { cause: err },\n );\n }\n }\n }\n}\n\n/**\n * Create and bootstrap a fully initialized FHIR engine.\n *\n * This is the single entry point for all FHIR applications.\n * It assembles fhir-definition, fhir-runtime, and fhir-persistence\n * into a running system from a single configuration object.\n *\n * @example\n * ```ts\n * const engine = await createFhirEngine({\n * database: { type: 'sqlite', path: ':memory:' },\n * packages: { path: './fhir-packages' },\n * });\n *\n * const patient = await engine.persistence.createResource('Patient', {\n * resourceType: 'Patient',\n * name: [{ family: 'Smith', given: ['John'] }],\n * });\n *\n * await engine.stop();\n * ```\n */\nexport async function createFhirEngine(config?: FhirEngineConfig): Promise<FhirEngine> {\n // \u2500\u2500 0. Resolve config \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n if (!config) {\n config = await loadFhirConfig();\n }\n validateConfig(config);\n\n const logger = config.logger ?? createConsoleLogger();\n const plugins = config.plugins ?? [];\n logger.info('Initializing fhir-engine...');\n\n // \u2500\u2500 1. Load FHIR definitions \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n logger.info(`Loading FHIR packages from: ${config.packages.path}`);\n const { registry, result } = loadDefinitionPackages(config.packages.path);\n logger.info(\n `Loaded ${result.packages.length} package(s): ${result.packages.map((p) => `${p.name}@${p.version}`).join(', ')}`,\n );\n\n // \u2500\u2500 2. Create fhir-runtime \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n logger.info('Creating fhir-runtime instance...');\n const runtime = await createRuntime({ definitions: registry, preloadCore: false });\n\n // \u2500\u2500 3. Build provider bridges \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n const definitionBridge = new FhirDefinitionBridge(registry);\n const runtimeProvider = new FhirRuntimeProvider({\n extractSearchValues,\n extractAllSearchValues,\n extractReferences,\n });\n\n // \u2500\u2500 4. Create storage adapter \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n const adapter = createAdapter(config.database, logger);\n\n // \u2500\u2500 5. Build EngineContext \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n const ctx: { -readonly [K in keyof EngineContext]: EngineContext[K] } = {\n config,\n definitions: registry,\n runtime,\n adapter,\n persistence: undefined,\n logger,\n };\n\n // \u2500\u2500 6. INIT phase \u2014 plugins run before persistence \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n if (plugins.length > 0) {\n logger.info(`Running init for ${plugins.length} plugin(s): ${plugins.map((p) => p.name).join(', ')}`);\n await runPluginHook(plugins, 'init', ctx);\n }\n\n // \u2500\u2500 7. Initialize FhirSystem \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n const dialect = resolveDialect(config.database.type);\n const system = new FhirSystem(adapter, {\n dialect,\n runtimeProvider,\n packageName: config.packageName ?? 'fhir-engine.default',\n packageVersion: config.packageVersion ?? '1.0.0',\n });\n\n logger.info('Initializing persistence system (schema + migration)...');\n const { persistence, sdRegistry, spRegistry, igResult, resourceTypes } =\n await system.initialize(definitionBridge);\n\n logger.info(`Persistence ready \u2014 IG action: ${igResult.action}, ${resourceTypes.length} resource type(s)`);\n\n // ctx.persistence now available\n ctx.persistence = persistence;\n\n // \u2500\u2500 8. START phase \u2014 plugins can access persistence \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n if (plugins.length > 0) {\n logger.info(`Running start for ${plugins.length} plugin(s)...`);\n await runPluginHook(plugins, 'start', ctx);\n }\n\n // \u2500\u2500 9. READY phase \u2014 system fully operational \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n if (plugins.length > 0) {\n logger.info(`Running ready for ${plugins.length} plugin(s)...`);\n await runPluginHook(plugins, 'ready', ctx);\n }\n\n // \u2500\u2500 10. Return FhirEngine \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n let stopped = false;\n const startedAt = new Date();\n const loadedPackages = result.packages.map((p) => `${p.name}@${p.version}`);\n const fhirVersions = [...new Set(\n result.packages\n .map((p) => {\n if (p.name.includes('.r4.')) return '4.0';\n if (p.name.includes('.r4b.')) return '4.3';\n if (p.name.includes('.r5.')) return '5.0';\n return undefined;\n })\n .filter(Boolean),\n )] as string[];\n\n const engine: FhirEngine = {\n definitions: registry,\n runtime,\n adapter,\n persistence,\n sdRegistry,\n spRegistry,\n igResult,\n resourceTypes,\n logger,\n context: ctx as EngineContext,\n\n async search(resourceType, queryParams, options) {\n const request = parseSearchRequest(resourceType, queryParams, spRegistry);\n return executeSearch(adapter, request, spRegistry, options);\n },\n\n status(): FhirEngineStatus {\n return {\n fhirVersions,\n loadedPackages,\n resourceTypes,\n databaseType: config.database.type,\n igAction: igResult.action,\n startedAt,\n plugins: plugins.map((p) => p.name),\n };\n },\n\n async stop() {\n if (stopped) return;\n stopped = true;\n logger.info('Stopping fhir-engine...');\n\n // Stop plugins in reverse registration order\n for (let i = plugins.length - 1; i >= 0; i--) {\n const plugin = plugins[i];\n if (plugin.stop) {\n try {\n await plugin.stop.call(plugin, ctx as EngineContext);\n } catch (err) {\n logger.error(\n `Plugin \"${plugin.name}\" failed during stop: ${err instanceof Error ? err.message : String(err)}`,\n );\n }\n }\n }\n\n await adapter.close();\n logger.info('fhir-engine stopped.');\n },\n };\n\n logger.info('fhir-engine ready.');\n return engine;\n}\n", "import { BetterSqlite3Adapter, SQLiteAdapter } from 'fhir-persistence';\nimport type { StorageAdapter } from 'fhir-persistence';\nimport type { DatabaseConfig, Logger } from './types.js';\n\n/**\n * Create a StorageAdapter from the database configuration.\n *\n * Supported adapters:\n * - `sqlite` \u2192 BetterSqlite3Adapter (native, Node.js / Electron)\n * - `sqlite-wasm` \u2192 SQLiteAdapter (sql.js WASM, browser / cross-platform)\n * - `postgres` \u2192 not yet available (PostgresAdapter not exported from fhir-persistence)\n */\nexport function createAdapter(config: DatabaseConfig, logger: Logger): StorageAdapter {\n switch (config.type) {\n case 'sqlite': {\n logger.info(`Creating BetterSqlite3Adapter (path: ${config.path})`);\n return new BetterSqlite3Adapter({\n path: config.path,\n wal: config.wal ?? true,\n busyTimeout: config.busyTimeout ?? 5000,\n });\n }\n\n case 'sqlite-wasm': {\n logger.info(`Creating SQLiteAdapter (WASM, path: ${config.path})`);\n return new SQLiteAdapter(config.path);\n }\n\n case 'postgres': {\n throw new Error(\n 'fhir-engine: PostgreSQL adapter is not yet available. ' +\n 'PostgresAdapter is not exported from fhir-persistence v0.1.0. ' +\n 'Use database.type = \"sqlite\" for now.',\n );\n }\n\n default: {\n const _exhaustive: never = config;\n throw new Error(`fhir-engine: unknown database type: ${(_exhaustive as DatabaseConfig).type}`);\n }\n }\n}\n", "import { existsSync, readFileSync } from 'node:fs';\nimport { resolve, extname } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport type { FhirEngineConfig, DatabaseConfig } from './types.js';\n\n// ---------------------------------------------------------------------------\n// defineConfig \u2014 typed identity helper for fhir.config.ts / .js\n// ---------------------------------------------------------------------------\n\n/**\n * Type-safe config helper for `fhir.config.ts` / `fhir.config.js`.\n *\n * @example\n * ```ts\n * // fhir.config.ts\n * import { defineConfig } from 'fhir-engine';\n *\n * export default defineConfig({\n * database: { type: 'sqlite', path: './fhir.db' },\n * packages: { path: './fhir-packages' },\n * });\n * ```\n */\nexport function defineConfig(config: FhirEngineConfig): FhirEngineConfig {\n return config;\n}\n\n// ---------------------------------------------------------------------------\n// Config file discovery order\n// ---------------------------------------------------------------------------\n\nconst CONFIG_FILENAMES = [\n 'fhir.config.ts',\n 'fhir.config.js',\n 'fhir.config.mjs',\n 'fhir.config.json',\n] as const;\n\n// ---------------------------------------------------------------------------\n// loadFhirConfig \u2014 auto-discover and load config\n// ---------------------------------------------------------------------------\n\n/**\n * Load engine configuration from a file.\n *\n * If `configPath` is provided, loads that exact file.\n * Otherwise, searches the current working directory for config files\n * in this order: `fhir.config.ts` \u2192 `fhir.config.js` \u2192 `fhir.config.mjs` \u2192 `fhir.config.json`.\n *\n * Environment variable overrides are applied on top of the loaded config.\n *\n * @param configPath - Explicit path to a config file (optional).\n * @returns The resolved `FhirEngineConfig`.\n */\nexport async function loadFhirConfig(configPath?: string): Promise<FhirEngineConfig> {\n let resolvedPath: string;\n\n if (configPath) {\n resolvedPath = resolve(configPath);\n if (!existsSync(resolvedPath)) {\n throw new Error(`fhir-engine: config file not found: ${resolvedPath}`);\n }\n } else {\n const cwd = process.cwd();\n const found = CONFIG_FILENAMES\n .map((name) => resolve(cwd, name))\n .find((p) => existsSync(p));\n if (!found) {\n throw new Error(\n `fhir-engine: no config file found in ${cwd}. ` +\n `Expected one of: ${CONFIG_FILENAMES.join(', ')}`,\n );\n }\n resolvedPath = found;\n }\n\n const config = await loadConfigFile(resolvedPath);\n return applyEnvOverrides(config);\n}\n\n// ---------------------------------------------------------------------------\n// File loaders\n// ---------------------------------------------------------------------------\n\nasync function loadConfigFile(filePath: string): Promise<FhirEngineConfig> {\n const ext = extname(filePath);\n\n if (ext === '.json') {\n return loadJsonConfig(filePath);\n }\n\n if (ext === '.ts' || ext === '.js' || ext === '.mjs') {\n return loadModuleConfig(filePath);\n }\n\n throw new Error(`fhir-engine: unsupported config file extension: ${ext}`);\n}\n\nfunction loadJsonConfig(filePath: string): FhirEngineConfig {\n try {\n const raw = readFileSync(filePath, 'utf-8');\n return JSON.parse(raw) as FhirEngineConfig;\n } catch (err) {\n throw new Error(\n `fhir-engine: failed to parse config file ${filePath}: ${err instanceof Error ? err.message : String(err)}`,\n { cause: err },\n );\n }\n}\n\nasync function loadModuleConfig(filePath: string): Promise<FhirEngineConfig> {\n try {\n const fileUrl = pathToFileURL(filePath).href;\n const mod = await import(fileUrl);\n const config = mod.default ?? mod;\n\n if (!config || typeof config !== 'object') {\n throw new Error('config file must export a FhirEngineConfig object as default export');\n }\n\n return config as FhirEngineConfig;\n } catch (err) {\n if (err instanceof Error && err.message.includes('must export')) {\n throw err;\n }\n throw new Error(\n `fhir-engine: failed to load config file ${filePath}: ${err instanceof Error ? err.message : String(err)}`,\n { cause: err },\n );\n }\n}\n\n// ---------------------------------------------------------------------------\n// Environment variable overrides\n// ---------------------------------------------------------------------------\n\nconst VALID_DB_TYPES = ['sqlite', 'sqlite-wasm', 'postgres'] as const;\n\n/**\n * Apply environment variable overrides on top of a loaded config.\n *\n * | Env Variable | Overrides |\n * |---------------------|----------------------------------|\n * | FHIR_DATABASE_TYPE | config.database.type |\n * | FHIR_DATABASE_URL | config.database.path / .url |\n * | FHIR_PACKAGES_PATH | config.packages.path |\n * | FHIR_LOG_LEVEL | (stored for logger filtering) |\n */\nexport function applyEnvOverrides(config: FhirEngineConfig): FhirEngineConfig {\n const result = structuredClone(config);\n\n const dbType = process.env.FHIR_DATABASE_TYPE;\n const dbUrl = process.env.FHIR_DATABASE_URL;\n const pkgPath = process.env.FHIR_PACKAGES_PATH;\n\n if (dbType) {\n if (!VALID_DB_TYPES.includes(dbType as typeof VALID_DB_TYPES[number])) {\n throw new Error(\n `fhir-engine: FHIR_DATABASE_TYPE must be one of: ${VALID_DB_TYPES.join(', ')}. Got: \"${dbType}\"`,\n );\n }\n // Rebuild database config with overridden type\n const validType = dbType as DatabaseConfig['type'];\n if (validType === 'postgres') {\n result.database = { type: 'postgres', url: (result.database as { url?: string }).url ?? '' };\n } else if (validType === 'sqlite-wasm') {\n result.database = { type: 'sqlite-wasm', path: (result.database as { path?: string }).path ?? '' };\n } else {\n result.database = { type: 'sqlite', path: (result.database as { path?: string }).path ?? '' };\n }\n }\n\n if (dbUrl) {\n const type = result.database?.type;\n if (type === 'postgres') {\n result.database = { ...result.database, type: 'postgres', url: dbUrl };\n } else if (type === 'sqlite-wasm') {\n result.database = { ...result.database, type: 'sqlite-wasm', path: dbUrl };\n } else {\n result.database = { ...result.database, type: 'sqlite', path: dbUrl };\n }\n }\n\n if (pkgPath) {\n result.packages = { ...result.packages, path: pkgPath };\n }\n\n return result;\n}\n", "import type { Logger } from './types.js';\n\n/**\n * Default console-based logger.\n */\nexport function createConsoleLogger(): Logger {\n return {\n debug: (message: string, ...args: unknown[]) => console.debug(`[fhir-engine] ${message}`, ...args),\n info: (message: string, ...args: unknown[]) => console.info(`[fhir-engine] ${message}`, ...args),\n warn: (message: string, ...args: unknown[]) => console.warn(`[fhir-engine] ${message}`, ...args),\n error: (message: string, ...args: unknown[]) => console.error(`[fhir-engine] ${message}`, ...args),\n };\n}\n"],
|
|
5
|
-
"mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,
|
|
6
|
-
"names": ["import_fhir_persistence", "import_fhir_persistence", "import_fhir_runtime"]
|
|
3
|
+
"sources": ["../../src/index.ts", "../../src/engine.ts", "../../src/adapter-factory.ts", "../../src/config.ts", "../../src/logger.ts", "../../src/package-resolver.ts"],
|
|
4
|
+
"sourcesContent": ["// fhir-engine \u2014 public API\n\nexport { createFhirEngine } from './engine.js';\nexport { defineConfig, loadFhirConfig } from './config.js';\nexport { createConsoleLogger } from './logger.js';\nexport { createAdapter } from './adapter-factory.js';\nexport { resolvePackages } from './package-resolver.js';\n\nexport type {\n FhirEngine,\n FhirEngineConfig,\n FhirEnginePlugin,\n FhirEngineStatus,\n EngineContext,\n DatabaseConfig,\n SqliteDatabaseConfig,\n SqliteWasmDatabaseConfig,\n PostgresDatabaseConfig,\n PackagesConfig,\n Logger,\n ResolvePackagesOptions,\n ResolvedPackage,\n ResolvePackagesResult,\n} from './types.js';\n\n// Re-export key upstream types for convenience\nexport type { DefinitionRegistry, DefinitionProvider } from 'fhir-definition';\nexport type { FhirRuntimeInstance } from 'fhir-runtime';\nexport type { FhirPersistence, StorageAdapter } from 'fhir-persistence';\n\n// ---------------------------------------------------------------------------\n// Search utilities (from fhir-persistence)\n// ---------------------------------------------------------------------------\n\nexport { parseSearchRequest, executeSearch } from 'fhir-persistence';\nexport type { SearchRequest, SearchResult, SearchOptions } from 'fhir-persistence';\n\n// ---------------------------------------------------------------------------\n// FHIRPath evaluation (from fhir-runtime)\n// ---------------------------------------------------------------------------\n\nexport { evalFhirPath, evalFhirPathBoolean, evalFhirPathString, evalFhirPathTyped } from 'fhir-runtime';\n", "import { loadDefinitionPackages } from 'fhir-definition';\nimport { createRuntime, extractSearchValues, extractAllSearchValues, extractReferences } from 'fhir-runtime';\nimport { FhirDefinitionBridge, FhirRuntimeProvider, FhirSystem, parseSearchRequest, executeSearch } from 'fhir-persistence';\n\nimport { createAdapter } from './adapter-factory.js';\nimport { loadFhirConfig } from './config.js';\nimport { createConsoleLogger } from './logger.js';\nimport { resolvePackages } from './package-resolver.js';\nimport type { EngineContext, FhirEngine, FhirEngineConfig, FhirEnginePlugin, FhirEngineStatus } from './types.js';\n\n/**\n * Resolve the SQL dialect from the database config type.\n */\nfunction resolveDialect(type: FhirEngineConfig['database']['type']): 'sqlite' | 'postgres' {\n switch (type) {\n case 'sqlite':\n case 'sqlite-wasm':\n return 'sqlite';\n case 'postgres':\n return 'postgres';\n }\n}\n\n/**\n * Validate the engine configuration, throwing on missing required fields.\n */\nfunction validateConfig(config: FhirEngineConfig): void {\n if (!config.database) {\n throw new Error('fhir-engine: config.database is required');\n }\n if (!config.database.type) {\n throw new Error('fhir-engine: config.database.type is required (sqlite | sqlite-wasm | postgres)');\n }\n if (!config.packages) {\n throw new Error('fhir-engine: config.packages is required');\n }\n if (!config.packages.path) {\n throw new Error('fhir-engine: config.packages.path is required');\n }\n}\n\n/**\n * Run a lifecycle hook on all plugins in order.\n * Wraps errors with the plugin name for clear diagnostics.\n */\nasync function runPluginHook(\n plugins: FhirEnginePlugin[],\n hook: 'init' | 'start' | 'ready',\n ctx: EngineContext,\n): Promise<void> {\n for (const plugin of plugins) {\n const fn = plugin[hook];\n if (fn) {\n try {\n await fn.call(plugin, ctx);\n } catch (err) {\n throw new Error(\n `fhir-engine: plugin \"${plugin.name}\" failed during ${hook}: ${err instanceof Error ? err.message : String(err)}`,\n { cause: err },\n );\n }\n }\n }\n}\n\n/**\n * Create and bootstrap a fully initialized FHIR engine.\n *\n * This is the single entry point for all FHIR applications.\n * It assembles fhir-definition, fhir-runtime, and fhir-persistence\n * into a running system from a single configuration object.\n *\n * @example\n * ```ts\n * const engine = await createFhirEngine({\n * database: { type: 'sqlite', path: ':memory:' },\n * packages: { path: './fhir-packages' },\n * });\n *\n * const patient = await engine.persistence.createResource('Patient', {\n * resourceType: 'Patient',\n * name: [{ family: 'Smith', given: ['John'] }],\n * });\n *\n * await engine.stop();\n * ```\n */\nexport async function createFhirEngine(config?: FhirEngineConfig): Promise<FhirEngine> {\n // \u2500\u2500 0. Resolve config \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n if (!config) {\n config = await loadFhirConfig();\n }\n validateConfig(config);\n\n const logger = config.logger ?? createConsoleLogger();\n const plugins = config.plugins ?? [];\n logger.info('Initializing fhir-engine...');\n\n // \u2500\u2500 1a. Resolve packages (download/link if config.igs is set) \u2500\n if (config.igs && config.igs.length > 0) {\n logger.info(`Resolving ${config.igs.length} IG package(s)...`);\n const resolveResult = await resolvePackages(config, { logger });\n for (const pkg of resolveResult.packages) {\n logger.info(`Resolved ${pkg.name}@${pkg.version} (${pkg.source})`);\n }\n if (!resolveResult.success) {\n for (const err of resolveResult.errors) {\n logger.warn(`Failed to resolve package ${err.name}: ${err.error}`);\n }\n }\n }\n\n // \u2500\u2500 1b. Load FHIR definitions \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n logger.info(`Loading FHIR packages from: ${config.packages.path}`);\n const { registry, result } = loadDefinitionPackages(config.packages.path);\n logger.info(\n `Loaded ${result.packages.length} package(s): ${result.packages.map((p) => `${p.name}@${p.version}`).join(', ')}`,\n );\n\n // \u2500\u2500 2. Create fhir-runtime \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n logger.info('Creating fhir-runtime instance...');\n const runtime = await createRuntime({ definitions: registry, preloadCore: false });\n\n // \u2500\u2500 3. Build provider bridges \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n const definitionBridge = new FhirDefinitionBridge(registry);\n const runtimeProvider = new FhirRuntimeProvider({\n extractSearchValues,\n extractAllSearchValues,\n extractReferences,\n });\n\n // \u2500\u2500 4. Create storage adapter \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n const adapter = createAdapter(config.database, logger);\n\n // \u2500\u2500 5. Build EngineContext \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n const ctx: { -readonly [K in keyof EngineContext]: EngineContext[K] } = {\n config,\n definitions: registry,\n runtime,\n adapter,\n persistence: undefined,\n logger,\n };\n\n // \u2500\u2500 6. INIT phase \u2014 plugins run before persistence \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n if (plugins.length > 0) {\n logger.info(`Running init for ${plugins.length} plugin(s): ${plugins.map((p) => p.name).join(', ')}`);\n await runPluginHook(plugins, 'init', ctx);\n }\n\n // \u2500\u2500 7. Initialize FhirSystem \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n const dialect = resolveDialect(config.database.type);\n const system = new FhirSystem(adapter, {\n dialect,\n runtimeProvider,\n packageName: config.packageName ?? 'fhir-engine.default',\n packageVersion: config.packageVersion ?? '1.0.0',\n });\n\n logger.info('Initializing persistence system (schema + migration)...');\n const { persistence, sdRegistry, spRegistry, igResult, resourceTypes } =\n await system.initialize(definitionBridge);\n\n logger.info(`Persistence ready \u2014 IG action: ${igResult.action}, ${resourceTypes.length} resource type(s)`);\n\n // ctx.persistence now available\n ctx.persistence = persistence;\n\n // \u2500\u2500 8. START phase \u2014 plugins can access persistence \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n if (plugins.length > 0) {\n logger.info(`Running start for ${plugins.length} plugin(s)...`);\n await runPluginHook(plugins, 'start', ctx);\n }\n\n // \u2500\u2500 9. READY phase \u2014 system fully operational \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n if (plugins.length > 0) {\n logger.info(`Running ready for ${plugins.length} plugin(s)...`);\n await runPluginHook(plugins, 'ready', ctx);\n }\n\n // \u2500\u2500 10. Return FhirEngine \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n let stopped = false;\n const startedAt = new Date();\n const loadedPackages = result.packages.map((p) => `${p.name}@${p.version}`);\n const fhirVersions = [...new Set(\n result.packages\n .map((p) => {\n if (p.name.includes('.r4.')) return '4.0';\n if (p.name.includes('.r4b.')) return '4.3';\n if (p.name.includes('.r5.')) return '5.0';\n return undefined;\n })\n .filter(Boolean),\n )] as string[];\n\n const engine: FhirEngine = {\n definitions: registry,\n runtime,\n adapter,\n persistence,\n sdRegistry,\n spRegistry,\n igResult,\n resourceTypes,\n logger,\n context: ctx as EngineContext,\n\n async search(resourceType, queryParams, options) {\n const request = parseSearchRequest(resourceType, queryParams, spRegistry);\n return executeSearch(adapter, request, spRegistry, options);\n },\n\n status(): FhirEngineStatus {\n return {\n fhirVersions,\n loadedPackages,\n resourceTypes,\n databaseType: config.database.type,\n igAction: igResult.action,\n startedAt,\n plugins: plugins.map((p) => p.name),\n };\n },\n\n async stop() {\n if (stopped) return;\n stopped = true;\n logger.info('Stopping fhir-engine...');\n\n // Stop plugins in reverse registration order\n for (let i = plugins.length - 1; i >= 0; i--) {\n const plugin = plugins[i];\n if (plugin.stop) {\n try {\n await plugin.stop.call(plugin, ctx as EngineContext);\n } catch (err) {\n logger.error(\n `Plugin \"${plugin.name}\" failed during stop: ${err instanceof Error ? err.message : String(err)}`,\n );\n }\n }\n }\n\n await adapter.close();\n logger.info('fhir-engine stopped.');\n },\n };\n\n logger.info('fhir-engine ready.');\n return engine;\n}\n", "import { BetterSqlite3Adapter, SQLiteAdapter } from 'fhir-persistence';\nimport type { StorageAdapter } from 'fhir-persistence';\nimport type { DatabaseConfig, Logger } from './types.js';\n\n/**\n * Create a StorageAdapter from the database configuration.\n *\n * Supported adapters:\n * - `sqlite` \u2192 BetterSqlite3Adapter (native, Node.js / Electron)\n * - `sqlite-wasm` \u2192 SQLiteAdapter (sql.js WASM, browser / cross-platform)\n * - `postgres` \u2192 not yet available (PostgresAdapter not exported from fhir-persistence)\n */\nexport function createAdapter(config: DatabaseConfig, logger: Logger): StorageAdapter {\n switch (config.type) {\n case 'sqlite': {\n logger.info(`Creating BetterSqlite3Adapter (path: ${config.path})`);\n return new BetterSqlite3Adapter({\n path: config.path,\n wal: config.wal ?? true,\n busyTimeout: config.busyTimeout ?? 5000,\n });\n }\n\n case 'sqlite-wasm': {\n logger.info(`Creating SQLiteAdapter (WASM, path: ${config.path})`);\n return new SQLiteAdapter(config.path);\n }\n\n case 'postgres': {\n throw new Error(\n 'fhir-engine: PostgreSQL adapter is not yet available. ' +\n 'PostgresAdapter is not exported from fhir-persistence v0.1.0. ' +\n 'Use database.type = \"sqlite\" for now.',\n );\n }\n\n default: {\n const _exhaustive: never = config;\n throw new Error(`fhir-engine: unknown database type: ${(_exhaustive as DatabaseConfig).type}`);\n }\n }\n}\n", "import { existsSync, readFileSync } from 'node:fs';\nimport { resolve, extname } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport type { FhirEngineConfig, DatabaseConfig } from './types.js';\n\n// ---------------------------------------------------------------------------\n// defineConfig \u2014 typed identity helper for fhir.config.ts / .js\n// ---------------------------------------------------------------------------\n\n/**\n * Type-safe config helper for `fhir.config.ts` / `fhir.config.js`.\n *\n * @example\n * ```ts\n * // fhir.config.ts\n * import { defineConfig } from 'fhir-engine';\n *\n * export default defineConfig({\n * database: { type: 'sqlite', path: './fhir.db' },\n * packages: { path: './fhir-packages' },\n * });\n * ```\n */\nexport function defineConfig(config: FhirEngineConfig): FhirEngineConfig {\n return config;\n}\n\n// ---------------------------------------------------------------------------\n// Config file discovery order\n// ---------------------------------------------------------------------------\n\nconst CONFIG_FILENAMES = [\n 'fhir.config.ts',\n 'fhir.config.js',\n 'fhir.config.mjs',\n 'fhir.config.json',\n] as const;\n\n// ---------------------------------------------------------------------------\n// loadFhirConfig \u2014 auto-discover and load config\n// ---------------------------------------------------------------------------\n\n/**\n * Load engine configuration from a file.\n *\n * If `configPath` is provided, loads that exact file.\n * Otherwise, searches the current working directory for config files\n * in this order: `fhir.config.ts` \u2192 `fhir.config.js` \u2192 `fhir.config.mjs` \u2192 `fhir.config.json`.\n *\n * Environment variable overrides are applied on top of the loaded config.\n *\n * @param configPath - Explicit path to a config file (optional).\n * @returns The resolved `FhirEngineConfig`.\n */\nexport async function loadFhirConfig(configPath?: string): Promise<FhirEngineConfig> {\n let resolvedPath: string;\n\n if (configPath) {\n resolvedPath = resolve(configPath);\n if (!existsSync(resolvedPath)) {\n throw new Error(`fhir-engine: config file not found: ${resolvedPath}`);\n }\n } else {\n const cwd = process.cwd();\n const found = CONFIG_FILENAMES\n .map((name) => resolve(cwd, name))\n .find((p) => existsSync(p));\n if (!found) {\n throw new Error(\n `fhir-engine: no config file found in ${cwd}. ` +\n `Expected one of: ${CONFIG_FILENAMES.join(', ')}`,\n );\n }\n resolvedPath = found;\n }\n\n const config = await loadConfigFile(resolvedPath);\n return applyEnvOverrides(config);\n}\n\n// ---------------------------------------------------------------------------\n// File loaders\n// ---------------------------------------------------------------------------\n\nasync function loadConfigFile(filePath: string): Promise<FhirEngineConfig> {\n const ext = extname(filePath);\n\n if (ext === '.json') {\n return loadJsonConfig(filePath);\n }\n\n if (ext === '.ts' || ext === '.js' || ext === '.mjs') {\n return loadModuleConfig(filePath);\n }\n\n throw new Error(`fhir-engine: unsupported config file extension: ${ext}`);\n}\n\nfunction loadJsonConfig(filePath: string): FhirEngineConfig {\n try {\n const raw = readFileSync(filePath, 'utf-8');\n return JSON.parse(raw) as FhirEngineConfig;\n } catch (err) {\n throw new Error(\n `fhir-engine: failed to parse config file ${filePath}: ${err instanceof Error ? err.message : String(err)}`,\n { cause: err },\n );\n }\n}\n\nasync function loadModuleConfig(filePath: string): Promise<FhirEngineConfig> {\n try {\n const fileUrl = pathToFileURL(filePath).href;\n const mod = await import(fileUrl);\n const config = mod.default ?? mod;\n\n if (!config || typeof config !== 'object') {\n throw new Error('config file must export a FhirEngineConfig object as default export');\n }\n\n return config as FhirEngineConfig;\n } catch (err) {\n if (err instanceof Error && err.message.includes('must export')) {\n throw err;\n }\n throw new Error(\n `fhir-engine: failed to load config file ${filePath}: ${err instanceof Error ? err.message : String(err)}`,\n { cause: err },\n );\n }\n}\n\n// ---------------------------------------------------------------------------\n// Environment variable overrides\n// ---------------------------------------------------------------------------\n\nconst VALID_DB_TYPES = ['sqlite', 'sqlite-wasm', 'postgres'] as const;\n\n/**\n * Apply environment variable overrides on top of a loaded config.\n *\n * | Env Variable | Overrides |\n * |---------------------|----------------------------------|\n * | FHIR_DATABASE_TYPE | config.database.type |\n * | FHIR_DATABASE_URL | config.database.path / .url |\n * | FHIR_PACKAGES_PATH | config.packages.path |\n * | FHIR_LOG_LEVEL | (stored for logger filtering) |\n */\nexport function applyEnvOverrides(config: FhirEngineConfig): FhirEngineConfig {\n const result = structuredClone(config);\n\n const dbType = process.env.FHIR_DATABASE_TYPE;\n const dbUrl = process.env.FHIR_DATABASE_URL;\n const pkgPath = process.env.FHIR_PACKAGES_PATH;\n\n if (dbType) {\n if (!VALID_DB_TYPES.includes(dbType as typeof VALID_DB_TYPES[number])) {\n throw new Error(\n `fhir-engine: FHIR_DATABASE_TYPE must be one of: ${VALID_DB_TYPES.join(', ')}. Got: \"${dbType}\"`,\n );\n }\n // Rebuild database config with overridden type\n const validType = dbType as DatabaseConfig['type'];\n if (validType === 'postgres') {\n result.database = { type: 'postgres', url: (result.database as { url?: string }).url ?? '' };\n } else if (validType === 'sqlite-wasm') {\n result.database = { type: 'sqlite-wasm', path: (result.database as { path?: string }).path ?? '' };\n } else {\n result.database = { type: 'sqlite', path: (result.database as { path?: string }).path ?? '' };\n }\n }\n\n if (dbUrl) {\n const type = result.database?.type;\n if (type === 'postgres') {\n result.database = { ...result.database, type: 'postgres', url: dbUrl };\n } else if (type === 'sqlite-wasm') {\n result.database = { ...result.database, type: 'sqlite-wasm', path: dbUrl };\n } else {\n result.database = { ...result.database, type: 'sqlite', path: dbUrl };\n }\n }\n\n if (pkgPath) {\n result.packages = { ...result.packages, path: pkgPath };\n }\n\n return result;\n}\n", "import type { Logger } from './types.js';\n\n/**\n * Default console-based logger.\n */\nexport function createConsoleLogger(): Logger {\n return {\n debug: (message: string, ...args: unknown[]) => console.debug(`[fhir-engine] ${message}`, ...args),\n info: (message: string, ...args: unknown[]) => console.info(`[fhir-engine] ${message}`, ...args),\n warn: (message: string, ...args: unknown[]) => console.warn(`[fhir-engine] ${message}`, ...args),\n error: (message: string, ...args: unknown[]) => console.error(`[fhir-engine] ${message}`, ...args),\n };\n}\n", "import { resolve, join } from 'node:path';\nimport { existsSync, mkdirSync, symlinkSync, readFileSync, lstatSync } from 'node:fs';\nimport { PackageCache, PackageRegistryClient } from 'fhir-definition';\n\nimport type { FhirEngineConfig, ResolvePackagesOptions, ResolvedPackage, ResolvePackagesResult, Logger } from './types.js';\n\n/**\n * Ensure the given directory exists (recursive mkdir).\n */\nfunction ensureDirSync(dir: string): void {\n if (!existsSync(dir)) {\n mkdirSync(dir, { recursive: true });\n }\n}\n\n/**\n * Check if a directory contains a FHIR package manifest.\n * Checks both root/package.json and package/package.json\n * (cached packages store content in a 'package' subdirectory).\n */\nfunction hasManifest(dir: string): boolean {\n return existsSync(join(dir, 'package.json')) || existsSync(join(dir, 'package', 'package.json'));\n}\n\n/**\n * Read the version from a package.json file.\n * Checks both root and package/ subdirectory.\n * Returns the version string or 'local' if not found.\n */\nfunction readLocalVersion(pkgDir: string): string {\n for (const candidate of [join(pkgDir, 'package.json'), join(pkgDir, 'package', 'package.json')]) {\n try {\n const raw = readFileSync(candidate, 'utf-8');\n const manifest = JSON.parse(raw);\n return manifest.version ?? 'local';\n } catch {\n // try next candidate\n }\n }\n return 'local';\n}\n\n/**\n * Resolve FHIR packages into a project's packages directory.\n *\n * Resolution order for each package:\n * 1. Already exists in packagesPath \u2192 use as-is (source: 'local')\n * 2. Found in system cache (~/.fhir/packages) \u2192 create symlink/junction (source: 'cache')\n * 3. Download from FHIR Package Registry \u2192 cache \u2192 create symlink (source: 'download')\n *\n * @param config Engine configuration (uses config.igs and config.packages.path)\n * @param options Override packages list, target path, download policy, or logger\n * @returns Result with resolved packages and any errors\n *\n * @example\n * ```ts\n * const result = await resolvePackages(config);\n * if (!result.success) {\n * console.warn('Some packages failed:', result.errors);\n * }\n * ```\n */\nexport async function resolvePackages(\n config: FhirEngineConfig,\n options?: ResolvePackagesOptions,\n): Promise<ResolvePackagesResult> {\n const packagesPath = resolve(options?.packagesPath ?? config.packages.path);\n const igs = options?.packages ?? config.igs ?? [];\n const allowDownload = options?.allowDownload ?? config.packageResolve?.allowDownload ?? true;\n const logger: Logger | undefined = options?.logger ?? config.logger;\n\n const cache = new PackageCache();\n const client = new PackageRegistryClient();\n const results: ResolvedPackage[] = [];\n const errors: Array<{ name: string; error: string }> = [];\n\n ensureDirSync(packagesPath);\n\n for (const ig of igs) {\n try {\n // 1. Already exists locally?\n const localPath = join(packagesPath, ig.name);\n if (hasManifest(localPath)) {\n const localVersion = readLocalVersion(localPath);\n logger?.debug(`Package ${ig.name} already exists locally at ${localPath}`);\n results.push({ name: ig.name, version: localVersion, path: localPath, source: 'local' });\n continue;\n }\n\n // 2. Resolve version\n let version = ig.version ?? 'latest';\n if (version === 'latest') {\n if (!allowDownload) {\n errors.push({\n name: ig.name,\n error: `Cannot resolve \"latest\" version for ${ig.name} without network access`,\n });\n continue;\n }\n logger?.info(`Resolving latest version for ${ig.name}...`);\n version = await client.getLatestVersion(ig.name);\n logger?.info(`Latest version for ${ig.name}: ${version}`);\n }\n\n // 3. Check system cache\n const cachePath = cache.getPath(ig.name, version);\n if (cachePath) {\n // Cache hit \u2014 create symlink\n logger?.info(`Found ${ig.name}@${version} in system cache, linking...`);\n createLink(cachePath, localPath);\n results.push({ name: ig.name, version, path: localPath, source: 'cache' });\n continue;\n }\n\n // 4. Download\n if (!allowDownload) {\n errors.push({\n name: ig.name,\n error: `Package ${ig.name}@${version} not found in cache, and downloads are disabled`,\n });\n continue;\n }\n\n logger?.info(`Downloading ${ig.name}@${version} from registry...`);\n const tarball = await client.download(ig.name, version);\n cache.put(ig.name, version, tarball);\n logger?.info(`Downloaded and cached ${ig.name}@${version}`);\n\n // Create symlink from cache to project packages dir\n const newCachePath = cache.getPath(ig.name, version);\n if (!newCachePath) {\n errors.push({ name: ig.name, error: `Failed to locate cached package after download` });\n continue;\n }\n createLink(newCachePath, localPath);\n results.push({ name: ig.name, version, path: localPath, source: 'download' });\n } catch (err) {\n errors.push({\n name: ig.name,\n error: err instanceof Error ? err.message : String(err),\n });\n }\n }\n\n return {\n success: errors.length === 0,\n packages: results,\n errors,\n };\n}\n\n/**\n * Create a directory junction (Windows) or symlink (Unix) from target to linkPath.\n * Idempotent \u2014 if link already exists, does nothing.\n */\nfunction createLink(target: string, linkPath: string): void {\n if (existsSync(linkPath)) {\n // Already exists (either real dir or symlink) \u2014 skip\n try {\n const stat = lstatSync(linkPath);\n if (stat.isSymbolicLink() || stat.isDirectory()) {\n return;\n }\n } catch {\n // If stat fails, try to create anyway\n }\n }\n // Use 'junction' on Windows (no admin needed), 'dir' on Unix\n const linkType = process.platform === 'win32' ? 'junction' : 'dir';\n symlinkSync(target, linkPath, linkType);\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
|
+
"names": ["import_fhir_definition", "import_fhir_persistence", "import_node_path", "import_node_fs", "import_fhir_persistence", "import_fhir_runtime"]
|
|
7
7
|
}
|
package/dist/cjs/index.d.ts
CHANGED
|
@@ -143,6 +143,15 @@ export declare interface FhirEngineConfig {
|
|
|
143
143
|
database: DatabaseConfig;
|
|
144
144
|
/** FHIR package loading configuration. */
|
|
145
145
|
packages: PackagesConfig;
|
|
146
|
+
/** IG list to resolve before loading (downloaded/linked into packages.path). */
|
|
147
|
+
igs?: Array<{
|
|
148
|
+
name: string;
|
|
149
|
+
version?: string;
|
|
150
|
+
}>;
|
|
151
|
+
/** Package resolution options. */
|
|
152
|
+
packageResolve?: {
|
|
153
|
+
allowDownload?: boolean;
|
|
154
|
+
};
|
|
146
155
|
/** IG migration label (default: package.json name or 'fhir-engine.default'). */
|
|
147
156
|
packageName?: string;
|
|
148
157
|
/** IG migration version (default: package.json version or '1.0.0'). */
|
|
@@ -221,6 +230,65 @@ export declare interface PostgresDatabaseConfig {
|
|
|
221
230
|
url: string;
|
|
222
231
|
}
|
|
223
232
|
|
|
233
|
+
export declare interface ResolvedPackage {
|
|
234
|
+
/** Package name (e.g. 'hl7.fhir.r4.core'). */
|
|
235
|
+
name: string;
|
|
236
|
+
/** Resolved version. */
|
|
237
|
+
version: string;
|
|
238
|
+
/** Path in the project packages directory. */
|
|
239
|
+
path: string;
|
|
240
|
+
/** How the package was resolved. */
|
|
241
|
+
source: 'cache' | 'download' | 'local';
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
/**
|
|
245
|
+
* Resolve FHIR packages into a project's packages directory.
|
|
246
|
+
*
|
|
247
|
+
* Resolution order for each package:
|
|
248
|
+
* 1. Already exists in packagesPath → use as-is (source: 'local')
|
|
249
|
+
* 2. Found in system cache (~/.fhir/packages) → create symlink/junction (source: 'cache')
|
|
250
|
+
* 3. Download from FHIR Package Registry → cache → create symlink (source: 'download')
|
|
251
|
+
*
|
|
252
|
+
* @param config Engine configuration (uses config.igs and config.packages.path)
|
|
253
|
+
* @param options Override packages list, target path, download policy, or logger
|
|
254
|
+
* @returns Result with resolved packages and any errors
|
|
255
|
+
*
|
|
256
|
+
* @example
|
|
257
|
+
* ```ts
|
|
258
|
+
* const result = await resolvePackages(config);
|
|
259
|
+
* if (!result.success) {
|
|
260
|
+
* console.warn('Some packages failed:', result.errors);
|
|
261
|
+
* }
|
|
262
|
+
* ```
|
|
263
|
+
*/
|
|
264
|
+
export declare function resolvePackages(config: FhirEngineConfig, options?: ResolvePackagesOptions): Promise<ResolvePackagesResult>;
|
|
265
|
+
|
|
266
|
+
export declare interface ResolvePackagesOptions {
|
|
267
|
+
/** Packages to resolve. Defaults to config.igs. */
|
|
268
|
+
packages?: Array<{
|
|
269
|
+
name: string;
|
|
270
|
+
version?: string;
|
|
271
|
+
}>;
|
|
272
|
+
/** Target directory for resolved packages. Defaults to config.packages.path. */
|
|
273
|
+
packagesPath?: string;
|
|
274
|
+
/** Allow network downloads. Default: true. */
|
|
275
|
+
allowDownload?: boolean;
|
|
276
|
+
/** Logger instance. */
|
|
277
|
+
logger?: Logger;
|
|
278
|
+
}
|
|
279
|
+
|
|
280
|
+
export declare interface ResolvePackagesResult {
|
|
281
|
+
/** True if all packages resolved without errors. */
|
|
282
|
+
success: boolean;
|
|
283
|
+
/** Successfully resolved packages. */
|
|
284
|
+
packages: ResolvedPackage[];
|
|
285
|
+
/** Packages that failed to resolve. */
|
|
286
|
+
errors: Array<{
|
|
287
|
+
name: string;
|
|
288
|
+
error: string;
|
|
289
|
+
}>;
|
|
290
|
+
}
|
|
291
|
+
|
|
224
292
|
export { SearchOptions }
|
|
225
293
|
|
|
226
294
|
export { SearchRequest }
|
package/dist/esm/index.d.ts
CHANGED
|
@@ -143,6 +143,15 @@ export declare interface FhirEngineConfig {
|
|
|
143
143
|
database: DatabaseConfig;
|
|
144
144
|
/** FHIR package loading configuration. */
|
|
145
145
|
packages: PackagesConfig;
|
|
146
|
+
/** IG list to resolve before loading (downloaded/linked into packages.path). */
|
|
147
|
+
igs?: Array<{
|
|
148
|
+
name: string;
|
|
149
|
+
version?: string;
|
|
150
|
+
}>;
|
|
151
|
+
/** Package resolution options. */
|
|
152
|
+
packageResolve?: {
|
|
153
|
+
allowDownload?: boolean;
|
|
154
|
+
};
|
|
146
155
|
/** IG migration label (default: package.json name or 'fhir-engine.default'). */
|
|
147
156
|
packageName?: string;
|
|
148
157
|
/** IG migration version (default: package.json version or '1.0.0'). */
|
|
@@ -221,6 +230,65 @@ export declare interface PostgresDatabaseConfig {
|
|
|
221
230
|
url: string;
|
|
222
231
|
}
|
|
223
232
|
|
|
233
|
+
export declare interface ResolvedPackage {
|
|
234
|
+
/** Package name (e.g. 'hl7.fhir.r4.core'). */
|
|
235
|
+
name: string;
|
|
236
|
+
/** Resolved version. */
|
|
237
|
+
version: string;
|
|
238
|
+
/** Path in the project packages directory. */
|
|
239
|
+
path: string;
|
|
240
|
+
/** How the package was resolved. */
|
|
241
|
+
source: 'cache' | 'download' | 'local';
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
/**
|
|
245
|
+
* Resolve FHIR packages into a project's packages directory.
|
|
246
|
+
*
|
|
247
|
+
* Resolution order for each package:
|
|
248
|
+
* 1. Already exists in packagesPath → use as-is (source: 'local')
|
|
249
|
+
* 2. Found in system cache (~/.fhir/packages) → create symlink/junction (source: 'cache')
|
|
250
|
+
* 3. Download from FHIR Package Registry → cache → create symlink (source: 'download')
|
|
251
|
+
*
|
|
252
|
+
* @param config Engine configuration (uses config.igs and config.packages.path)
|
|
253
|
+
* @param options Override packages list, target path, download policy, or logger
|
|
254
|
+
* @returns Result with resolved packages and any errors
|
|
255
|
+
*
|
|
256
|
+
* @example
|
|
257
|
+
* ```ts
|
|
258
|
+
* const result = await resolvePackages(config);
|
|
259
|
+
* if (!result.success) {
|
|
260
|
+
* console.warn('Some packages failed:', result.errors);
|
|
261
|
+
* }
|
|
262
|
+
* ```
|
|
263
|
+
*/
|
|
264
|
+
export declare function resolvePackages(config: FhirEngineConfig, options?: ResolvePackagesOptions): Promise<ResolvePackagesResult>;
|
|
265
|
+
|
|
266
|
+
export declare interface ResolvePackagesOptions {
|
|
267
|
+
/** Packages to resolve. Defaults to config.igs. */
|
|
268
|
+
packages?: Array<{
|
|
269
|
+
name: string;
|
|
270
|
+
version?: string;
|
|
271
|
+
}>;
|
|
272
|
+
/** Target directory for resolved packages. Defaults to config.packages.path. */
|
|
273
|
+
packagesPath?: string;
|
|
274
|
+
/** Allow network downloads. Default: true. */
|
|
275
|
+
allowDownload?: boolean;
|
|
276
|
+
/** Logger instance. */
|
|
277
|
+
logger?: Logger;
|
|
278
|
+
}
|
|
279
|
+
|
|
280
|
+
export declare interface ResolvePackagesResult {
|
|
281
|
+
/** True if all packages resolved without errors. */
|
|
282
|
+
success: boolean;
|
|
283
|
+
/** Successfully resolved packages. */
|
|
284
|
+
packages: ResolvedPackage[];
|
|
285
|
+
/** Packages that failed to resolve. */
|
|
286
|
+
errors: Array<{
|
|
287
|
+
name: string;
|
|
288
|
+
error: string;
|
|
289
|
+
}>;
|
|
290
|
+
}
|
|
291
|
+
|
|
224
292
|
export { SearchOptions }
|
|
225
293
|
|
|
226
294
|
export { SearchRequest }
|
package/dist/esm/index.mjs
CHANGED
|
@@ -151,6 +151,113 @@ function createConsoleLogger() {
|
|
|
151
151
|
};
|
|
152
152
|
}
|
|
153
153
|
|
|
154
|
+
// src/package-resolver.ts
|
|
155
|
+
import { resolve as resolve2, join } from "node:path";
|
|
156
|
+
import { existsSync as existsSync2, mkdirSync, symlinkSync, readFileSync as readFileSync2, lstatSync } from "node:fs";
|
|
157
|
+
import { PackageCache, PackageRegistryClient } from "fhir-definition";
|
|
158
|
+
function ensureDirSync(dir) {
|
|
159
|
+
if (!existsSync2(dir)) {
|
|
160
|
+
mkdirSync(dir, { recursive: true });
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
function hasManifest(dir) {
|
|
164
|
+
return existsSync2(join(dir, "package.json")) || existsSync2(join(dir, "package", "package.json"));
|
|
165
|
+
}
|
|
166
|
+
function readLocalVersion(pkgDir) {
|
|
167
|
+
for (const candidate of [join(pkgDir, "package.json"), join(pkgDir, "package", "package.json")]) {
|
|
168
|
+
try {
|
|
169
|
+
const raw = readFileSync2(candidate, "utf-8");
|
|
170
|
+
const manifest = JSON.parse(raw);
|
|
171
|
+
return manifest.version ?? "local";
|
|
172
|
+
} catch {
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
return "local";
|
|
176
|
+
}
|
|
177
|
+
async function resolvePackages(config, options) {
|
|
178
|
+
const packagesPath = resolve2(options?.packagesPath ?? config.packages.path);
|
|
179
|
+
const igs = options?.packages ?? config.igs ?? [];
|
|
180
|
+
const allowDownload = options?.allowDownload ?? config.packageResolve?.allowDownload ?? true;
|
|
181
|
+
const logger = options?.logger ?? config.logger;
|
|
182
|
+
const cache = new PackageCache();
|
|
183
|
+
const client = new PackageRegistryClient();
|
|
184
|
+
const results = [];
|
|
185
|
+
const errors = [];
|
|
186
|
+
ensureDirSync(packagesPath);
|
|
187
|
+
for (const ig of igs) {
|
|
188
|
+
try {
|
|
189
|
+
const localPath = join(packagesPath, ig.name);
|
|
190
|
+
if (hasManifest(localPath)) {
|
|
191
|
+
const localVersion = readLocalVersion(localPath);
|
|
192
|
+
logger?.debug(`Package ${ig.name} already exists locally at ${localPath}`);
|
|
193
|
+
results.push({ name: ig.name, version: localVersion, path: localPath, source: "local" });
|
|
194
|
+
continue;
|
|
195
|
+
}
|
|
196
|
+
let version = ig.version ?? "latest";
|
|
197
|
+
if (version === "latest") {
|
|
198
|
+
if (!allowDownload) {
|
|
199
|
+
errors.push({
|
|
200
|
+
name: ig.name,
|
|
201
|
+
error: `Cannot resolve "latest" version for ${ig.name} without network access`
|
|
202
|
+
});
|
|
203
|
+
continue;
|
|
204
|
+
}
|
|
205
|
+
logger?.info(`Resolving latest version for ${ig.name}...`);
|
|
206
|
+
version = await client.getLatestVersion(ig.name);
|
|
207
|
+
logger?.info(`Latest version for ${ig.name}: ${version}`);
|
|
208
|
+
}
|
|
209
|
+
const cachePath = cache.getPath(ig.name, version);
|
|
210
|
+
if (cachePath) {
|
|
211
|
+
logger?.info(`Found ${ig.name}@${version} in system cache, linking...`);
|
|
212
|
+
createLink(cachePath, localPath);
|
|
213
|
+
results.push({ name: ig.name, version, path: localPath, source: "cache" });
|
|
214
|
+
continue;
|
|
215
|
+
}
|
|
216
|
+
if (!allowDownload) {
|
|
217
|
+
errors.push({
|
|
218
|
+
name: ig.name,
|
|
219
|
+
error: `Package ${ig.name}@${version} not found in cache, and downloads are disabled`
|
|
220
|
+
});
|
|
221
|
+
continue;
|
|
222
|
+
}
|
|
223
|
+
logger?.info(`Downloading ${ig.name}@${version} from registry...`);
|
|
224
|
+
const tarball = await client.download(ig.name, version);
|
|
225
|
+
cache.put(ig.name, version, tarball);
|
|
226
|
+
logger?.info(`Downloaded and cached ${ig.name}@${version}`);
|
|
227
|
+
const newCachePath = cache.getPath(ig.name, version);
|
|
228
|
+
if (!newCachePath) {
|
|
229
|
+
errors.push({ name: ig.name, error: `Failed to locate cached package after download` });
|
|
230
|
+
continue;
|
|
231
|
+
}
|
|
232
|
+
createLink(newCachePath, localPath);
|
|
233
|
+
results.push({ name: ig.name, version, path: localPath, source: "download" });
|
|
234
|
+
} catch (err) {
|
|
235
|
+
errors.push({
|
|
236
|
+
name: ig.name,
|
|
237
|
+
error: err instanceof Error ? err.message : String(err)
|
|
238
|
+
});
|
|
239
|
+
}
|
|
240
|
+
}
|
|
241
|
+
return {
|
|
242
|
+
success: errors.length === 0,
|
|
243
|
+
packages: results,
|
|
244
|
+
errors
|
|
245
|
+
};
|
|
246
|
+
}
|
|
247
|
+
function createLink(target, linkPath) {
|
|
248
|
+
if (existsSync2(linkPath)) {
|
|
249
|
+
try {
|
|
250
|
+
const stat = lstatSync(linkPath);
|
|
251
|
+
if (stat.isSymbolicLink() || stat.isDirectory()) {
|
|
252
|
+
return;
|
|
253
|
+
}
|
|
254
|
+
} catch {
|
|
255
|
+
}
|
|
256
|
+
}
|
|
257
|
+
const linkType = process.platform === "win32" ? "junction" : "dir";
|
|
258
|
+
symlinkSync(target, linkPath, linkType);
|
|
259
|
+
}
|
|
260
|
+
|
|
154
261
|
// src/engine.ts
|
|
155
262
|
function resolveDialect(type) {
|
|
156
263
|
switch (type) {
|
|
@@ -198,6 +305,18 @@ async function createFhirEngine(config) {
|
|
|
198
305
|
const logger = config.logger ?? createConsoleLogger();
|
|
199
306
|
const plugins = config.plugins ?? [];
|
|
200
307
|
logger.info("Initializing fhir-engine...");
|
|
308
|
+
if (config.igs && config.igs.length > 0) {
|
|
309
|
+
logger.info(`Resolving ${config.igs.length} IG package(s)...`);
|
|
310
|
+
const resolveResult = await resolvePackages(config, { logger });
|
|
311
|
+
for (const pkg of resolveResult.packages) {
|
|
312
|
+
logger.info(`Resolved ${pkg.name}@${pkg.version} (${pkg.source})`);
|
|
313
|
+
}
|
|
314
|
+
if (!resolveResult.success) {
|
|
315
|
+
for (const err of resolveResult.errors) {
|
|
316
|
+
logger.warn(`Failed to resolve package ${err.name}: ${err.error}`);
|
|
317
|
+
}
|
|
318
|
+
}
|
|
319
|
+
}
|
|
201
320
|
logger.info(`Loading FHIR packages from: ${config.packages.path}`);
|
|
202
321
|
const { registry, result } = loadDefinitionPackages(config.packages.path);
|
|
203
322
|
logger.info(
|
|
@@ -318,6 +437,7 @@ export {
|
|
|
318
437
|
evalFhirPathTyped,
|
|
319
438
|
executeSearch2 as executeSearch,
|
|
320
439
|
loadFhirConfig,
|
|
321
|
-
parseSearchRequest2 as parseSearchRequest
|
|
440
|
+
parseSearchRequest2 as parseSearchRequest,
|
|
441
|
+
resolvePackages
|
|
322
442
|
};
|
|
323
443
|
//# sourceMappingURL=index.mjs.map
|
package/dist/esm/index.mjs.map
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
|
-
"sources": ["../../src/engine.ts", "../../src/adapter-factory.ts", "../../src/config.ts", "../../src/logger.ts", "../../src/index.ts"],
|
|
4
|
-
"sourcesContent": ["import { loadDefinitionPackages } from 'fhir-definition';\nimport { createRuntime, extractSearchValues, extractAllSearchValues, extractReferences } from 'fhir-runtime';\nimport { FhirDefinitionBridge, FhirRuntimeProvider, FhirSystem, parseSearchRequest, executeSearch } from 'fhir-persistence';\n\nimport { createAdapter } from './adapter-factory.js';\nimport { loadFhirConfig } from './config.js';\nimport { createConsoleLogger } from './logger.js';\nimport type { EngineContext, FhirEngine, FhirEngineConfig, FhirEnginePlugin, FhirEngineStatus } from './types.js';\n\n/**\n * Resolve the SQL dialect from the database config type.\n */\nfunction resolveDialect(type: FhirEngineConfig['database']['type']): 'sqlite' | 'postgres' {\n switch (type) {\n case 'sqlite':\n case 'sqlite-wasm':\n return 'sqlite';\n case 'postgres':\n return 'postgres';\n }\n}\n\n/**\n * Validate the engine configuration, throwing on missing required fields.\n */\nfunction validateConfig(config: FhirEngineConfig): void {\n if (!config.database) {\n throw new Error('fhir-engine: config.database is required');\n }\n if (!config.database.type) {\n throw new Error('fhir-engine: config.database.type is required (sqlite | sqlite-wasm | postgres)');\n }\n if (!config.packages) {\n throw new Error('fhir-engine: config.packages is required');\n }\n if (!config.packages.path) {\n throw new Error('fhir-engine: config.packages.path is required');\n }\n}\n\n/**\n * Run a lifecycle hook on all plugins in order.\n * Wraps errors with the plugin name for clear diagnostics.\n */\nasync function runPluginHook(\n plugins: FhirEnginePlugin[],\n hook: 'init' | 'start' | 'ready',\n ctx: EngineContext,\n): Promise<void> {\n for (const plugin of plugins) {\n const fn = plugin[hook];\n if (fn) {\n try {\n await fn.call(plugin, ctx);\n } catch (err) {\n throw new Error(\n `fhir-engine: plugin \"${plugin.name}\" failed during ${hook}: ${err instanceof Error ? err.message : String(err)}`,\n { cause: err },\n );\n }\n }\n }\n}\n\n/**\n * Create and bootstrap a fully initialized FHIR engine.\n *\n * This is the single entry point for all FHIR applications.\n * It assembles fhir-definition, fhir-runtime, and fhir-persistence\n * into a running system from a single configuration object.\n *\n * @example\n * ```ts\n * const engine = await createFhirEngine({\n * database: { type: 'sqlite', path: ':memory:' },\n * packages: { path: './fhir-packages' },\n * });\n *\n * const patient = await engine.persistence.createResource('Patient', {\n * resourceType: 'Patient',\n * name: [{ family: 'Smith', given: ['John'] }],\n * });\n *\n * await engine.stop();\n * ```\n */\nexport async function createFhirEngine(config?: FhirEngineConfig): Promise<FhirEngine> {\n // \u2500\u2500 0. Resolve config \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n if (!config) {\n config = await loadFhirConfig();\n }\n validateConfig(config);\n\n const logger = config.logger ?? createConsoleLogger();\n const plugins = config.plugins ?? [];\n logger.info('Initializing fhir-engine...');\n\n // \u2500\u2500 1. Load FHIR definitions \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n logger.info(`Loading FHIR packages from: ${config.packages.path}`);\n const { registry, result } = loadDefinitionPackages(config.packages.path);\n logger.info(\n `Loaded ${result.packages.length} package(s): ${result.packages.map((p) => `${p.name}@${p.version}`).join(', ')}`,\n );\n\n // \u2500\u2500 2. Create fhir-runtime \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n logger.info('Creating fhir-runtime instance...');\n const runtime = await createRuntime({ definitions: registry, preloadCore: false });\n\n // \u2500\u2500 3. Build provider bridges \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n const definitionBridge = new FhirDefinitionBridge(registry);\n const runtimeProvider = new FhirRuntimeProvider({\n extractSearchValues,\n extractAllSearchValues,\n extractReferences,\n });\n\n // \u2500\u2500 4. Create storage adapter \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n const adapter = createAdapter(config.database, logger);\n\n // \u2500\u2500 5. Build EngineContext \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n const ctx: { -readonly [K in keyof EngineContext]: EngineContext[K] } = {\n config,\n definitions: registry,\n runtime,\n adapter,\n persistence: undefined,\n logger,\n };\n\n // \u2500\u2500 6. INIT phase \u2014 plugins run before persistence \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n if (plugins.length > 0) {\n logger.info(`Running init for ${plugins.length} plugin(s): ${plugins.map((p) => p.name).join(', ')}`);\n await runPluginHook(plugins, 'init', ctx);\n }\n\n // \u2500\u2500 7. Initialize FhirSystem \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n const dialect = resolveDialect(config.database.type);\n const system = new FhirSystem(adapter, {\n dialect,\n runtimeProvider,\n packageName: config.packageName ?? 'fhir-engine.default',\n packageVersion: config.packageVersion ?? '1.0.0',\n });\n\n logger.info('Initializing persistence system (schema + migration)...');\n const { persistence, sdRegistry, spRegistry, igResult, resourceTypes } =\n await system.initialize(definitionBridge);\n\n logger.info(`Persistence ready \u2014 IG action: ${igResult.action}, ${resourceTypes.length} resource type(s)`);\n\n // ctx.persistence now available\n ctx.persistence = persistence;\n\n // \u2500\u2500 8. START phase \u2014 plugins can access persistence \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n if (plugins.length > 0) {\n logger.info(`Running start for ${plugins.length} plugin(s)...`);\n await runPluginHook(plugins, 'start', ctx);\n }\n\n // \u2500\u2500 9. READY phase \u2014 system fully operational \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n if (plugins.length > 0) {\n logger.info(`Running ready for ${plugins.length} plugin(s)...`);\n await runPluginHook(plugins, 'ready', ctx);\n }\n\n // \u2500\u2500 10. Return FhirEngine \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n let stopped = false;\n const startedAt = new Date();\n const loadedPackages = result.packages.map((p) => `${p.name}@${p.version}`);\n const fhirVersions = [...new Set(\n result.packages\n .map((p) => {\n if (p.name.includes('.r4.')) return '4.0';\n if (p.name.includes('.r4b.')) return '4.3';\n if (p.name.includes('.r5.')) return '5.0';\n return undefined;\n })\n .filter(Boolean),\n )] as string[];\n\n const engine: FhirEngine = {\n definitions: registry,\n runtime,\n adapter,\n persistence,\n sdRegistry,\n spRegistry,\n igResult,\n resourceTypes,\n logger,\n context: ctx as EngineContext,\n\n async search(resourceType, queryParams, options) {\n const request = parseSearchRequest(resourceType, queryParams, spRegistry);\n return executeSearch(adapter, request, spRegistry, options);\n },\n\n status(): FhirEngineStatus {\n return {\n fhirVersions,\n loadedPackages,\n resourceTypes,\n databaseType: config.database.type,\n igAction: igResult.action,\n startedAt,\n plugins: plugins.map((p) => p.name),\n };\n },\n\n async stop() {\n if (stopped) return;\n stopped = true;\n logger.info('Stopping fhir-engine...');\n\n // Stop plugins in reverse registration order\n for (let i = plugins.length - 1; i >= 0; i--) {\n const plugin = plugins[i];\n if (plugin.stop) {\n try {\n await plugin.stop.call(plugin, ctx as EngineContext);\n } catch (err) {\n logger.error(\n `Plugin \"${plugin.name}\" failed during stop: ${err instanceof Error ? err.message : String(err)}`,\n );\n }\n }\n }\n\n await adapter.close();\n logger.info('fhir-engine stopped.');\n },\n };\n\n logger.info('fhir-engine ready.');\n return engine;\n}\n", "import { BetterSqlite3Adapter, SQLiteAdapter } from 'fhir-persistence';\nimport type { StorageAdapter } from 'fhir-persistence';\nimport type { DatabaseConfig, Logger } from './types.js';\n\n/**\n * Create a StorageAdapter from the database configuration.\n *\n * Supported adapters:\n * - `sqlite` \u2192 BetterSqlite3Adapter (native, Node.js / Electron)\n * - `sqlite-wasm` \u2192 SQLiteAdapter (sql.js WASM, browser / cross-platform)\n * - `postgres` \u2192 not yet available (PostgresAdapter not exported from fhir-persistence)\n */\nexport function createAdapter(config: DatabaseConfig, logger: Logger): StorageAdapter {\n switch (config.type) {\n case 'sqlite': {\n logger.info(`Creating BetterSqlite3Adapter (path: ${config.path})`);\n return new BetterSqlite3Adapter({\n path: config.path,\n wal: config.wal ?? true,\n busyTimeout: config.busyTimeout ?? 5000,\n });\n }\n\n case 'sqlite-wasm': {\n logger.info(`Creating SQLiteAdapter (WASM, path: ${config.path})`);\n return new SQLiteAdapter(config.path);\n }\n\n case 'postgres': {\n throw new Error(\n 'fhir-engine: PostgreSQL adapter is not yet available. ' +\n 'PostgresAdapter is not exported from fhir-persistence v0.1.0. ' +\n 'Use database.type = \"sqlite\" for now.',\n );\n }\n\n default: {\n const _exhaustive: never = config;\n throw new Error(`fhir-engine: unknown database type: ${(_exhaustive as DatabaseConfig).type}`);\n }\n }\n}\n", "import { existsSync, readFileSync } from 'node:fs';\nimport { resolve, extname } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport type { FhirEngineConfig, DatabaseConfig } from './types.js';\n\n// ---------------------------------------------------------------------------\n// defineConfig \u2014 typed identity helper for fhir.config.ts / .js\n// ---------------------------------------------------------------------------\n\n/**\n * Type-safe config helper for `fhir.config.ts` / `fhir.config.js`.\n *\n * @example\n * ```ts\n * // fhir.config.ts\n * import { defineConfig } from 'fhir-engine';\n *\n * export default defineConfig({\n * database: { type: 'sqlite', path: './fhir.db' },\n * packages: { path: './fhir-packages' },\n * });\n * ```\n */\nexport function defineConfig(config: FhirEngineConfig): FhirEngineConfig {\n return config;\n}\n\n// ---------------------------------------------------------------------------\n// Config file discovery order\n// ---------------------------------------------------------------------------\n\nconst CONFIG_FILENAMES = [\n 'fhir.config.ts',\n 'fhir.config.js',\n 'fhir.config.mjs',\n 'fhir.config.json',\n] as const;\n\n// ---------------------------------------------------------------------------\n// loadFhirConfig \u2014 auto-discover and load config\n// ---------------------------------------------------------------------------\n\n/**\n * Load engine configuration from a file.\n *\n * If `configPath` is provided, loads that exact file.\n * Otherwise, searches the current working directory for config files\n * in this order: `fhir.config.ts` \u2192 `fhir.config.js` \u2192 `fhir.config.mjs` \u2192 `fhir.config.json`.\n *\n * Environment variable overrides are applied on top of the loaded config.\n *\n * @param configPath - Explicit path to a config file (optional).\n * @returns The resolved `FhirEngineConfig`.\n */\nexport async function loadFhirConfig(configPath?: string): Promise<FhirEngineConfig> {\n let resolvedPath: string;\n\n if (configPath) {\n resolvedPath = resolve(configPath);\n if (!existsSync(resolvedPath)) {\n throw new Error(`fhir-engine: config file not found: ${resolvedPath}`);\n }\n } else {\n const cwd = process.cwd();\n const found = CONFIG_FILENAMES\n .map((name) => resolve(cwd, name))\n .find((p) => existsSync(p));\n if (!found) {\n throw new Error(\n `fhir-engine: no config file found in ${cwd}. ` +\n `Expected one of: ${CONFIG_FILENAMES.join(', ')}`,\n );\n }\n resolvedPath = found;\n }\n\n const config = await loadConfigFile(resolvedPath);\n return applyEnvOverrides(config);\n}\n\n// ---------------------------------------------------------------------------\n// File loaders\n// ---------------------------------------------------------------------------\n\nasync function loadConfigFile(filePath: string): Promise<FhirEngineConfig> {\n const ext = extname(filePath);\n\n if (ext === '.json') {\n return loadJsonConfig(filePath);\n }\n\n if (ext === '.ts' || ext === '.js' || ext === '.mjs') {\n return loadModuleConfig(filePath);\n }\n\n throw new Error(`fhir-engine: unsupported config file extension: ${ext}`);\n}\n\nfunction loadJsonConfig(filePath: string): FhirEngineConfig {\n try {\n const raw = readFileSync(filePath, 'utf-8');\n return JSON.parse(raw) as FhirEngineConfig;\n } catch (err) {\n throw new Error(\n `fhir-engine: failed to parse config file ${filePath}: ${err instanceof Error ? err.message : String(err)}`,\n { cause: err },\n );\n }\n}\n\nasync function loadModuleConfig(filePath: string): Promise<FhirEngineConfig> {\n try {\n const fileUrl = pathToFileURL(filePath).href;\n const mod = await import(fileUrl);\n const config = mod.default ?? mod;\n\n if (!config || typeof config !== 'object') {\n throw new Error('config file must export a FhirEngineConfig object as default export');\n }\n\n return config as FhirEngineConfig;\n } catch (err) {\n if (err instanceof Error && err.message.includes('must export')) {\n throw err;\n }\n throw new Error(\n `fhir-engine: failed to load config file ${filePath}: ${err instanceof Error ? err.message : String(err)}`,\n { cause: err },\n );\n }\n}\n\n// ---------------------------------------------------------------------------\n// Environment variable overrides\n// ---------------------------------------------------------------------------\n\nconst VALID_DB_TYPES = ['sqlite', 'sqlite-wasm', 'postgres'] as const;\n\n/**\n * Apply environment variable overrides on top of a loaded config.\n *\n * | Env Variable | Overrides |\n * |---------------------|----------------------------------|\n * | FHIR_DATABASE_TYPE | config.database.type |\n * | FHIR_DATABASE_URL | config.database.path / .url |\n * | FHIR_PACKAGES_PATH | config.packages.path |\n * | FHIR_LOG_LEVEL | (stored for logger filtering) |\n */\nexport function applyEnvOverrides(config: FhirEngineConfig): FhirEngineConfig {\n const result = structuredClone(config);\n\n const dbType = process.env.FHIR_DATABASE_TYPE;\n const dbUrl = process.env.FHIR_DATABASE_URL;\n const pkgPath = process.env.FHIR_PACKAGES_PATH;\n\n if (dbType) {\n if (!VALID_DB_TYPES.includes(dbType as typeof VALID_DB_TYPES[number])) {\n throw new Error(\n `fhir-engine: FHIR_DATABASE_TYPE must be one of: ${VALID_DB_TYPES.join(', ')}. Got: \"${dbType}\"`,\n );\n }\n // Rebuild database config with overridden type\n const validType = dbType as DatabaseConfig['type'];\n if (validType === 'postgres') {\n result.database = { type: 'postgres', url: (result.database as { url?: string }).url ?? '' };\n } else if (validType === 'sqlite-wasm') {\n result.database = { type: 'sqlite-wasm', path: (result.database as { path?: string }).path ?? '' };\n } else {\n result.database = { type: 'sqlite', path: (result.database as { path?: string }).path ?? '' };\n }\n }\n\n if (dbUrl) {\n const type = result.database?.type;\n if (type === 'postgres') {\n result.database = { ...result.database, type: 'postgres', url: dbUrl };\n } else if (type === 'sqlite-wasm') {\n result.database = { ...result.database, type: 'sqlite-wasm', path: dbUrl };\n } else {\n result.database = { ...result.database, type: 'sqlite', path: dbUrl };\n }\n }\n\n if (pkgPath) {\n result.packages = { ...result.packages, path: pkgPath };\n }\n\n return result;\n}\n", "import type { Logger } from './types.js';\n\n/**\n * Default console-based logger.\n */\nexport function createConsoleLogger(): Logger {\n return {\n debug: (message: string, ...args: unknown[]) => console.debug(`[fhir-engine] ${message}`, ...args),\n info: (message: string, ...args: unknown[]) => console.info(`[fhir-engine] ${message}`, ...args),\n warn: (message: string, ...args: unknown[]) => console.warn(`[fhir-engine] ${message}`, ...args),\n error: (message: string, ...args: unknown[]) => console.error(`[fhir-engine] ${message}`, ...args),\n };\n}\n", "// fhir-engine \u2014 public API\n\nexport { createFhirEngine } from './engine.js';\nexport { defineConfig, loadFhirConfig } from './config.js';\nexport { createConsoleLogger } from './logger.js';\nexport { createAdapter } from './adapter-factory.js';\n\nexport type {\n FhirEngine,\n FhirEngineConfig,\n FhirEnginePlugin,\n FhirEngineStatus,\n EngineContext,\n DatabaseConfig,\n SqliteDatabaseConfig,\n SqliteWasmDatabaseConfig,\n PostgresDatabaseConfig,\n PackagesConfig,\n Logger,\n} from './types.js';\n\n// Re-export key upstream types for convenience\nexport type { DefinitionRegistry, DefinitionProvider } from 'fhir-definition';\nexport type { FhirRuntimeInstance } from 'fhir-runtime';\nexport type { FhirPersistence, StorageAdapter } from 'fhir-persistence';\n\n// ---------------------------------------------------------------------------\n// Search utilities (from fhir-persistence)\n// ---------------------------------------------------------------------------\n\nexport { parseSearchRequest, executeSearch } from 'fhir-persistence';\nexport type { SearchRequest, SearchResult, SearchOptions } from 'fhir-persistence';\n\n// ---------------------------------------------------------------------------\n// FHIRPath evaluation (from fhir-runtime)\n// ---------------------------------------------------------------------------\n\nexport { evalFhirPath, evalFhirPathBoolean, evalFhirPathString, evalFhirPathTyped } from 'fhir-runtime';\n"],
|
|
5
|
-
"mappings": "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
|
|
6
|
-
"names": ["parseSearchRequest", "executeSearch"]
|
|
3
|
+
"sources": ["../../src/engine.ts", "../../src/adapter-factory.ts", "../../src/config.ts", "../../src/logger.ts", "../../src/package-resolver.ts", "../../src/index.ts"],
|
|
4
|
+
"sourcesContent": ["import { loadDefinitionPackages } from 'fhir-definition';\nimport { createRuntime, extractSearchValues, extractAllSearchValues, extractReferences } from 'fhir-runtime';\nimport { FhirDefinitionBridge, FhirRuntimeProvider, FhirSystem, parseSearchRequest, executeSearch } from 'fhir-persistence';\n\nimport { createAdapter } from './adapter-factory.js';\nimport { loadFhirConfig } from './config.js';\nimport { createConsoleLogger } from './logger.js';\nimport { resolvePackages } from './package-resolver.js';\nimport type { EngineContext, FhirEngine, FhirEngineConfig, FhirEnginePlugin, FhirEngineStatus } from './types.js';\n\n/**\n * Resolve the SQL dialect from the database config type.\n */\nfunction resolveDialect(type: FhirEngineConfig['database']['type']): 'sqlite' | 'postgres' {\n switch (type) {\n case 'sqlite':\n case 'sqlite-wasm':\n return 'sqlite';\n case 'postgres':\n return 'postgres';\n }\n}\n\n/**\n * Validate the engine configuration, throwing on missing required fields.\n */\nfunction validateConfig(config: FhirEngineConfig): void {\n if (!config.database) {\n throw new Error('fhir-engine: config.database is required');\n }\n if (!config.database.type) {\n throw new Error('fhir-engine: config.database.type is required (sqlite | sqlite-wasm | postgres)');\n }\n if (!config.packages) {\n throw new Error('fhir-engine: config.packages is required');\n }\n if (!config.packages.path) {\n throw new Error('fhir-engine: config.packages.path is required');\n }\n}\n\n/**\n * Run a lifecycle hook on all plugins in order.\n * Wraps errors with the plugin name for clear diagnostics.\n */\nasync function runPluginHook(\n plugins: FhirEnginePlugin[],\n hook: 'init' | 'start' | 'ready',\n ctx: EngineContext,\n): Promise<void> {\n for (const plugin of plugins) {\n const fn = plugin[hook];\n if (fn) {\n try {\n await fn.call(plugin, ctx);\n } catch (err) {\n throw new Error(\n `fhir-engine: plugin \"${plugin.name}\" failed during ${hook}: ${err instanceof Error ? err.message : String(err)}`,\n { cause: err },\n );\n }\n }\n }\n}\n\n/**\n * Create and bootstrap a fully initialized FHIR engine.\n *\n * This is the single entry point for all FHIR applications.\n * It assembles fhir-definition, fhir-runtime, and fhir-persistence\n * into a running system from a single configuration object.\n *\n * @example\n * ```ts\n * const engine = await createFhirEngine({\n * database: { type: 'sqlite', path: ':memory:' },\n * packages: { path: './fhir-packages' },\n * });\n *\n * const patient = await engine.persistence.createResource('Patient', {\n * resourceType: 'Patient',\n * name: [{ family: 'Smith', given: ['John'] }],\n * });\n *\n * await engine.stop();\n * ```\n */\nexport async function createFhirEngine(config?: FhirEngineConfig): Promise<FhirEngine> {\n // \u2500\u2500 0. Resolve config \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n if (!config) {\n config = await loadFhirConfig();\n }\n validateConfig(config);\n\n const logger = config.logger ?? createConsoleLogger();\n const plugins = config.plugins ?? [];\n logger.info('Initializing fhir-engine...');\n\n // \u2500\u2500 1a. Resolve packages (download/link if config.igs is set) \u2500\n if (config.igs && config.igs.length > 0) {\n logger.info(`Resolving ${config.igs.length} IG package(s)...`);\n const resolveResult = await resolvePackages(config, { logger });\n for (const pkg of resolveResult.packages) {\n logger.info(`Resolved ${pkg.name}@${pkg.version} (${pkg.source})`);\n }\n if (!resolveResult.success) {\n for (const err of resolveResult.errors) {\n logger.warn(`Failed to resolve package ${err.name}: ${err.error}`);\n }\n }\n }\n\n // \u2500\u2500 1b. Load FHIR definitions \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n logger.info(`Loading FHIR packages from: ${config.packages.path}`);\n const { registry, result } = loadDefinitionPackages(config.packages.path);\n logger.info(\n `Loaded ${result.packages.length} package(s): ${result.packages.map((p) => `${p.name}@${p.version}`).join(', ')}`,\n );\n\n // \u2500\u2500 2. Create fhir-runtime \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n logger.info('Creating fhir-runtime instance...');\n const runtime = await createRuntime({ definitions: registry, preloadCore: false });\n\n // \u2500\u2500 3. Build provider bridges \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n const definitionBridge = new FhirDefinitionBridge(registry);\n const runtimeProvider = new FhirRuntimeProvider({\n extractSearchValues,\n extractAllSearchValues,\n extractReferences,\n });\n\n // \u2500\u2500 4. Create storage adapter \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n const adapter = createAdapter(config.database, logger);\n\n // \u2500\u2500 5. Build EngineContext \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n const ctx: { -readonly [K in keyof EngineContext]: EngineContext[K] } = {\n config,\n definitions: registry,\n runtime,\n adapter,\n persistence: undefined,\n logger,\n };\n\n // \u2500\u2500 6. INIT phase \u2014 plugins run before persistence \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n if (plugins.length > 0) {\n logger.info(`Running init for ${plugins.length} plugin(s): ${plugins.map((p) => p.name).join(', ')}`);\n await runPluginHook(plugins, 'init', ctx);\n }\n\n // \u2500\u2500 7. Initialize FhirSystem \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n const dialect = resolveDialect(config.database.type);\n const system = new FhirSystem(adapter, {\n dialect,\n runtimeProvider,\n packageName: config.packageName ?? 'fhir-engine.default',\n packageVersion: config.packageVersion ?? '1.0.0',\n });\n\n logger.info('Initializing persistence system (schema + migration)...');\n const { persistence, sdRegistry, spRegistry, igResult, resourceTypes } =\n await system.initialize(definitionBridge);\n\n logger.info(`Persistence ready \u2014 IG action: ${igResult.action}, ${resourceTypes.length} resource type(s)`);\n\n // ctx.persistence now available\n ctx.persistence = persistence;\n\n // \u2500\u2500 8. START phase \u2014 plugins can access persistence \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n if (plugins.length > 0) {\n logger.info(`Running start for ${plugins.length} plugin(s)...`);\n await runPluginHook(plugins, 'start', ctx);\n }\n\n // \u2500\u2500 9. READY phase \u2014 system fully operational \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n if (plugins.length > 0) {\n logger.info(`Running ready for ${plugins.length} plugin(s)...`);\n await runPluginHook(plugins, 'ready', ctx);\n }\n\n // \u2500\u2500 10. Return FhirEngine \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n let stopped = false;\n const startedAt = new Date();\n const loadedPackages = result.packages.map((p) => `${p.name}@${p.version}`);\n const fhirVersions = [...new Set(\n result.packages\n .map((p) => {\n if (p.name.includes('.r4.')) return '4.0';\n if (p.name.includes('.r4b.')) return '4.3';\n if (p.name.includes('.r5.')) return '5.0';\n return undefined;\n })\n .filter(Boolean),\n )] as string[];\n\n const engine: FhirEngine = {\n definitions: registry,\n runtime,\n adapter,\n persistence,\n sdRegistry,\n spRegistry,\n igResult,\n resourceTypes,\n logger,\n context: ctx as EngineContext,\n\n async search(resourceType, queryParams, options) {\n const request = parseSearchRequest(resourceType, queryParams, spRegistry);\n return executeSearch(adapter, request, spRegistry, options);\n },\n\n status(): FhirEngineStatus {\n return {\n fhirVersions,\n loadedPackages,\n resourceTypes,\n databaseType: config.database.type,\n igAction: igResult.action,\n startedAt,\n plugins: plugins.map((p) => p.name),\n };\n },\n\n async stop() {\n if (stopped) return;\n stopped = true;\n logger.info('Stopping fhir-engine...');\n\n // Stop plugins in reverse registration order\n for (let i = plugins.length - 1; i >= 0; i--) {\n const plugin = plugins[i];\n if (plugin.stop) {\n try {\n await plugin.stop.call(plugin, ctx as EngineContext);\n } catch (err) {\n logger.error(\n `Plugin \"${plugin.name}\" failed during stop: ${err instanceof Error ? err.message : String(err)}`,\n );\n }\n }\n }\n\n await adapter.close();\n logger.info('fhir-engine stopped.');\n },\n };\n\n logger.info('fhir-engine ready.');\n return engine;\n}\n", "import { BetterSqlite3Adapter, SQLiteAdapter } from 'fhir-persistence';\nimport type { StorageAdapter } from 'fhir-persistence';\nimport type { DatabaseConfig, Logger } from './types.js';\n\n/**\n * Create a StorageAdapter from the database configuration.\n *\n * Supported adapters:\n * - `sqlite` \u2192 BetterSqlite3Adapter (native, Node.js / Electron)\n * - `sqlite-wasm` \u2192 SQLiteAdapter (sql.js WASM, browser / cross-platform)\n * - `postgres` \u2192 not yet available (PostgresAdapter not exported from fhir-persistence)\n */\nexport function createAdapter(config: DatabaseConfig, logger: Logger): StorageAdapter {\n switch (config.type) {\n case 'sqlite': {\n logger.info(`Creating BetterSqlite3Adapter (path: ${config.path})`);\n return new BetterSqlite3Adapter({\n path: config.path,\n wal: config.wal ?? true,\n busyTimeout: config.busyTimeout ?? 5000,\n });\n }\n\n case 'sqlite-wasm': {\n logger.info(`Creating SQLiteAdapter (WASM, path: ${config.path})`);\n return new SQLiteAdapter(config.path);\n }\n\n case 'postgres': {\n throw new Error(\n 'fhir-engine: PostgreSQL adapter is not yet available. ' +\n 'PostgresAdapter is not exported from fhir-persistence v0.1.0. ' +\n 'Use database.type = \"sqlite\" for now.',\n );\n }\n\n default: {\n const _exhaustive: never = config;\n throw new Error(`fhir-engine: unknown database type: ${(_exhaustive as DatabaseConfig).type}`);\n }\n }\n}\n", "import { existsSync, readFileSync } from 'node:fs';\nimport { resolve, extname } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport type { FhirEngineConfig, DatabaseConfig } from './types.js';\n\n// ---------------------------------------------------------------------------\n// defineConfig \u2014 typed identity helper for fhir.config.ts / .js\n// ---------------------------------------------------------------------------\n\n/**\n * Type-safe config helper for `fhir.config.ts` / `fhir.config.js`.\n *\n * @example\n * ```ts\n * // fhir.config.ts\n * import { defineConfig } from 'fhir-engine';\n *\n * export default defineConfig({\n * database: { type: 'sqlite', path: './fhir.db' },\n * packages: { path: './fhir-packages' },\n * });\n * ```\n */\nexport function defineConfig(config: FhirEngineConfig): FhirEngineConfig {\n return config;\n}\n\n// ---------------------------------------------------------------------------\n// Config file discovery order\n// ---------------------------------------------------------------------------\n\nconst CONFIG_FILENAMES = [\n 'fhir.config.ts',\n 'fhir.config.js',\n 'fhir.config.mjs',\n 'fhir.config.json',\n] as const;\n\n// ---------------------------------------------------------------------------\n// loadFhirConfig \u2014 auto-discover and load config\n// ---------------------------------------------------------------------------\n\n/**\n * Load engine configuration from a file.\n *\n * If `configPath` is provided, loads that exact file.\n * Otherwise, searches the current working directory for config files\n * in this order: `fhir.config.ts` \u2192 `fhir.config.js` \u2192 `fhir.config.mjs` \u2192 `fhir.config.json`.\n *\n * Environment variable overrides are applied on top of the loaded config.\n *\n * @param configPath - Explicit path to a config file (optional).\n * @returns The resolved `FhirEngineConfig`.\n */\nexport async function loadFhirConfig(configPath?: string): Promise<FhirEngineConfig> {\n let resolvedPath: string;\n\n if (configPath) {\n resolvedPath = resolve(configPath);\n if (!existsSync(resolvedPath)) {\n throw new Error(`fhir-engine: config file not found: ${resolvedPath}`);\n }\n } else {\n const cwd = process.cwd();\n const found = CONFIG_FILENAMES\n .map((name) => resolve(cwd, name))\n .find((p) => existsSync(p));\n if (!found) {\n throw new Error(\n `fhir-engine: no config file found in ${cwd}. ` +\n `Expected one of: ${CONFIG_FILENAMES.join(', ')}`,\n );\n }\n resolvedPath = found;\n }\n\n const config = await loadConfigFile(resolvedPath);\n return applyEnvOverrides(config);\n}\n\n// ---------------------------------------------------------------------------\n// File loaders\n// ---------------------------------------------------------------------------\n\nasync function loadConfigFile(filePath: string): Promise<FhirEngineConfig> {\n const ext = extname(filePath);\n\n if (ext === '.json') {\n return loadJsonConfig(filePath);\n }\n\n if (ext === '.ts' || ext === '.js' || ext === '.mjs') {\n return loadModuleConfig(filePath);\n }\n\n throw new Error(`fhir-engine: unsupported config file extension: ${ext}`);\n}\n\nfunction loadJsonConfig(filePath: string): FhirEngineConfig {\n try {\n const raw = readFileSync(filePath, 'utf-8');\n return JSON.parse(raw) as FhirEngineConfig;\n } catch (err) {\n throw new Error(\n `fhir-engine: failed to parse config file ${filePath}: ${err instanceof Error ? err.message : String(err)}`,\n { cause: err },\n );\n }\n}\n\nasync function loadModuleConfig(filePath: string): Promise<FhirEngineConfig> {\n try {\n const fileUrl = pathToFileURL(filePath).href;\n const mod = await import(fileUrl);\n const config = mod.default ?? mod;\n\n if (!config || typeof config !== 'object') {\n throw new Error('config file must export a FhirEngineConfig object as default export');\n }\n\n return config as FhirEngineConfig;\n } catch (err) {\n if (err instanceof Error && err.message.includes('must export')) {\n throw err;\n }\n throw new Error(\n `fhir-engine: failed to load config file ${filePath}: ${err instanceof Error ? err.message : String(err)}`,\n { cause: err },\n );\n }\n}\n\n// ---------------------------------------------------------------------------\n// Environment variable overrides\n// ---------------------------------------------------------------------------\n\nconst VALID_DB_TYPES = ['sqlite', 'sqlite-wasm', 'postgres'] as const;\n\n/**\n * Apply environment variable overrides on top of a loaded config.\n *\n * | Env Variable | Overrides |\n * |---------------------|----------------------------------|\n * | FHIR_DATABASE_TYPE | config.database.type |\n * | FHIR_DATABASE_URL | config.database.path / .url |\n * | FHIR_PACKAGES_PATH | config.packages.path |\n * | FHIR_LOG_LEVEL | (stored for logger filtering) |\n */\nexport function applyEnvOverrides(config: FhirEngineConfig): FhirEngineConfig {\n const result = structuredClone(config);\n\n const dbType = process.env.FHIR_DATABASE_TYPE;\n const dbUrl = process.env.FHIR_DATABASE_URL;\n const pkgPath = process.env.FHIR_PACKAGES_PATH;\n\n if (dbType) {\n if (!VALID_DB_TYPES.includes(dbType as typeof VALID_DB_TYPES[number])) {\n throw new Error(\n `fhir-engine: FHIR_DATABASE_TYPE must be one of: ${VALID_DB_TYPES.join(', ')}. Got: \"${dbType}\"`,\n );\n }\n // Rebuild database config with overridden type\n const validType = dbType as DatabaseConfig['type'];\n if (validType === 'postgres') {\n result.database = { type: 'postgres', url: (result.database as { url?: string }).url ?? '' };\n } else if (validType === 'sqlite-wasm') {\n result.database = { type: 'sqlite-wasm', path: (result.database as { path?: string }).path ?? '' };\n } else {\n result.database = { type: 'sqlite', path: (result.database as { path?: string }).path ?? '' };\n }\n }\n\n if (dbUrl) {\n const type = result.database?.type;\n if (type === 'postgres') {\n result.database = { ...result.database, type: 'postgres', url: dbUrl };\n } else if (type === 'sqlite-wasm') {\n result.database = { ...result.database, type: 'sqlite-wasm', path: dbUrl };\n } else {\n result.database = { ...result.database, type: 'sqlite', path: dbUrl };\n }\n }\n\n if (pkgPath) {\n result.packages = { ...result.packages, path: pkgPath };\n }\n\n return result;\n}\n", "import type { Logger } from './types.js';\n\n/**\n * Default console-based logger.\n */\nexport function createConsoleLogger(): Logger {\n return {\n debug: (message: string, ...args: unknown[]) => console.debug(`[fhir-engine] ${message}`, ...args),\n info: (message: string, ...args: unknown[]) => console.info(`[fhir-engine] ${message}`, ...args),\n warn: (message: string, ...args: unknown[]) => console.warn(`[fhir-engine] ${message}`, ...args),\n error: (message: string, ...args: unknown[]) => console.error(`[fhir-engine] ${message}`, ...args),\n };\n}\n", "import { resolve, join } from 'node:path';\nimport { existsSync, mkdirSync, symlinkSync, readFileSync, lstatSync } from 'node:fs';\nimport { PackageCache, PackageRegistryClient } from 'fhir-definition';\n\nimport type { FhirEngineConfig, ResolvePackagesOptions, ResolvedPackage, ResolvePackagesResult, Logger } from './types.js';\n\n/**\n * Ensure the given directory exists (recursive mkdir).\n */\nfunction ensureDirSync(dir: string): void {\n if (!existsSync(dir)) {\n mkdirSync(dir, { recursive: true });\n }\n}\n\n/**\n * Check if a directory contains a FHIR package manifest.\n * Checks both root/package.json and package/package.json\n * (cached packages store content in a 'package' subdirectory).\n */\nfunction hasManifest(dir: string): boolean {\n return existsSync(join(dir, 'package.json')) || existsSync(join(dir, 'package', 'package.json'));\n}\n\n/**\n * Read the version from a package.json file.\n * Checks both root and package/ subdirectory.\n * Returns the version string or 'local' if not found.\n */\nfunction readLocalVersion(pkgDir: string): string {\n for (const candidate of [join(pkgDir, 'package.json'), join(pkgDir, 'package', 'package.json')]) {\n try {\n const raw = readFileSync(candidate, 'utf-8');\n const manifest = JSON.parse(raw);\n return manifest.version ?? 'local';\n } catch {\n // try next candidate\n }\n }\n return 'local';\n}\n\n/**\n * Resolve FHIR packages into a project's packages directory.\n *\n * Resolution order for each package:\n * 1. Already exists in packagesPath \u2192 use as-is (source: 'local')\n * 2. Found in system cache (~/.fhir/packages) \u2192 create symlink/junction (source: 'cache')\n * 3. Download from FHIR Package Registry \u2192 cache \u2192 create symlink (source: 'download')\n *\n * @param config Engine configuration (uses config.igs and config.packages.path)\n * @param options Override packages list, target path, download policy, or logger\n * @returns Result with resolved packages and any errors\n *\n * @example\n * ```ts\n * const result = await resolvePackages(config);\n * if (!result.success) {\n * console.warn('Some packages failed:', result.errors);\n * }\n * ```\n */\nexport async function resolvePackages(\n config: FhirEngineConfig,\n options?: ResolvePackagesOptions,\n): Promise<ResolvePackagesResult> {\n const packagesPath = resolve(options?.packagesPath ?? config.packages.path);\n const igs = options?.packages ?? config.igs ?? [];\n const allowDownload = options?.allowDownload ?? config.packageResolve?.allowDownload ?? true;\n const logger: Logger | undefined = options?.logger ?? config.logger;\n\n const cache = new PackageCache();\n const client = new PackageRegistryClient();\n const results: ResolvedPackage[] = [];\n const errors: Array<{ name: string; error: string }> = [];\n\n ensureDirSync(packagesPath);\n\n for (const ig of igs) {\n try {\n // 1. Already exists locally?\n const localPath = join(packagesPath, ig.name);\n if (hasManifest(localPath)) {\n const localVersion = readLocalVersion(localPath);\n logger?.debug(`Package ${ig.name} already exists locally at ${localPath}`);\n results.push({ name: ig.name, version: localVersion, path: localPath, source: 'local' });\n continue;\n }\n\n // 2. Resolve version\n let version = ig.version ?? 'latest';\n if (version === 'latest') {\n if (!allowDownload) {\n errors.push({\n name: ig.name,\n error: `Cannot resolve \"latest\" version for ${ig.name} without network access`,\n });\n continue;\n }\n logger?.info(`Resolving latest version for ${ig.name}...`);\n version = await client.getLatestVersion(ig.name);\n logger?.info(`Latest version for ${ig.name}: ${version}`);\n }\n\n // 3. Check system cache\n const cachePath = cache.getPath(ig.name, version);\n if (cachePath) {\n // Cache hit \u2014 create symlink\n logger?.info(`Found ${ig.name}@${version} in system cache, linking...`);\n createLink(cachePath, localPath);\n results.push({ name: ig.name, version, path: localPath, source: 'cache' });\n continue;\n }\n\n // 4. Download\n if (!allowDownload) {\n errors.push({\n name: ig.name,\n error: `Package ${ig.name}@${version} not found in cache, and downloads are disabled`,\n });\n continue;\n }\n\n logger?.info(`Downloading ${ig.name}@${version} from registry...`);\n const tarball = await client.download(ig.name, version);\n cache.put(ig.name, version, tarball);\n logger?.info(`Downloaded and cached ${ig.name}@${version}`);\n\n // Create symlink from cache to project packages dir\n const newCachePath = cache.getPath(ig.name, version);\n if (!newCachePath) {\n errors.push({ name: ig.name, error: `Failed to locate cached package after download` });\n continue;\n }\n createLink(newCachePath, localPath);\n results.push({ name: ig.name, version, path: localPath, source: 'download' });\n } catch (err) {\n errors.push({\n name: ig.name,\n error: err instanceof Error ? err.message : String(err),\n });\n }\n }\n\n return {\n success: errors.length === 0,\n packages: results,\n errors,\n };\n}\n\n/**\n * Create a directory junction (Windows) or symlink (Unix) from target to linkPath.\n * Idempotent \u2014 if link already exists, does nothing.\n */\nfunction createLink(target: string, linkPath: string): void {\n if (existsSync(linkPath)) {\n // Already exists (either real dir or symlink) \u2014 skip\n try {\n const stat = lstatSync(linkPath);\n if (stat.isSymbolicLink() || stat.isDirectory()) {\n return;\n }\n } catch {\n // If stat fails, try to create anyway\n }\n }\n // Use 'junction' on Windows (no admin needed), 'dir' on Unix\n const linkType = process.platform === 'win32' ? 'junction' : 'dir';\n symlinkSync(target, linkPath, linkType);\n}\n", "// fhir-engine \u2014 public API\n\nexport { createFhirEngine } from './engine.js';\nexport { defineConfig, loadFhirConfig } from './config.js';\nexport { createConsoleLogger } from './logger.js';\nexport { createAdapter } from './adapter-factory.js';\nexport { resolvePackages } from './package-resolver.js';\n\nexport type {\n FhirEngine,\n FhirEngineConfig,\n FhirEnginePlugin,\n FhirEngineStatus,\n EngineContext,\n DatabaseConfig,\n SqliteDatabaseConfig,\n SqliteWasmDatabaseConfig,\n PostgresDatabaseConfig,\n PackagesConfig,\n Logger,\n ResolvePackagesOptions,\n ResolvedPackage,\n ResolvePackagesResult,\n} from './types.js';\n\n// Re-export key upstream types for convenience\nexport type { DefinitionRegistry, DefinitionProvider } from 'fhir-definition';\nexport type { FhirRuntimeInstance } from 'fhir-runtime';\nexport type { FhirPersistence, StorageAdapter } from 'fhir-persistence';\n\n// ---------------------------------------------------------------------------\n// Search utilities (from fhir-persistence)\n// ---------------------------------------------------------------------------\n\nexport { parseSearchRequest, executeSearch } from 'fhir-persistence';\nexport type { SearchRequest, SearchResult, SearchOptions } from 'fhir-persistence';\n\n// ---------------------------------------------------------------------------\n// FHIRPath evaluation (from fhir-runtime)\n// ---------------------------------------------------------------------------\n\nexport { evalFhirPath, evalFhirPathBoolean, evalFhirPathString, evalFhirPathTyped } from 'fhir-runtime';\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
|
+
"names": ["resolve", "existsSync", "readFileSync", "parseSearchRequest", "executeSearch"]
|
|
7
7
|
}
|
package/dist/index.d.ts
CHANGED
|
@@ -143,6 +143,15 @@ export declare interface FhirEngineConfig {
|
|
|
143
143
|
database: DatabaseConfig;
|
|
144
144
|
/** FHIR package loading configuration. */
|
|
145
145
|
packages: PackagesConfig;
|
|
146
|
+
/** IG list to resolve before loading (downloaded/linked into packages.path). */
|
|
147
|
+
igs?: Array<{
|
|
148
|
+
name: string;
|
|
149
|
+
version?: string;
|
|
150
|
+
}>;
|
|
151
|
+
/** Package resolution options. */
|
|
152
|
+
packageResolve?: {
|
|
153
|
+
allowDownload?: boolean;
|
|
154
|
+
};
|
|
146
155
|
/** IG migration label (default: package.json name or 'fhir-engine.default'). */
|
|
147
156
|
packageName?: string;
|
|
148
157
|
/** IG migration version (default: package.json version or '1.0.0'). */
|
|
@@ -221,6 +230,65 @@ export declare interface PostgresDatabaseConfig {
|
|
|
221
230
|
url: string;
|
|
222
231
|
}
|
|
223
232
|
|
|
233
|
+
export declare interface ResolvedPackage {
|
|
234
|
+
/** Package name (e.g. 'hl7.fhir.r4.core'). */
|
|
235
|
+
name: string;
|
|
236
|
+
/** Resolved version. */
|
|
237
|
+
version: string;
|
|
238
|
+
/** Path in the project packages directory. */
|
|
239
|
+
path: string;
|
|
240
|
+
/** How the package was resolved. */
|
|
241
|
+
source: 'cache' | 'download' | 'local';
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
/**
|
|
245
|
+
* Resolve FHIR packages into a project's packages directory.
|
|
246
|
+
*
|
|
247
|
+
* Resolution order for each package:
|
|
248
|
+
* 1. Already exists in packagesPath → use as-is (source: 'local')
|
|
249
|
+
* 2. Found in system cache (~/.fhir/packages) → create symlink/junction (source: 'cache')
|
|
250
|
+
* 3. Download from FHIR Package Registry → cache → create symlink (source: 'download')
|
|
251
|
+
*
|
|
252
|
+
* @param config Engine configuration (uses config.igs and config.packages.path)
|
|
253
|
+
* @param options Override packages list, target path, download policy, or logger
|
|
254
|
+
* @returns Result with resolved packages and any errors
|
|
255
|
+
*
|
|
256
|
+
* @example
|
|
257
|
+
* ```ts
|
|
258
|
+
* const result = await resolvePackages(config);
|
|
259
|
+
* if (!result.success) {
|
|
260
|
+
* console.warn('Some packages failed:', result.errors);
|
|
261
|
+
* }
|
|
262
|
+
* ```
|
|
263
|
+
*/
|
|
264
|
+
export declare function resolvePackages(config: FhirEngineConfig, options?: ResolvePackagesOptions): Promise<ResolvePackagesResult>;
|
|
265
|
+
|
|
266
|
+
export declare interface ResolvePackagesOptions {
|
|
267
|
+
/** Packages to resolve. Defaults to config.igs. */
|
|
268
|
+
packages?: Array<{
|
|
269
|
+
name: string;
|
|
270
|
+
version?: string;
|
|
271
|
+
}>;
|
|
272
|
+
/** Target directory for resolved packages. Defaults to config.packages.path. */
|
|
273
|
+
packagesPath?: string;
|
|
274
|
+
/** Allow network downloads. Default: true. */
|
|
275
|
+
allowDownload?: boolean;
|
|
276
|
+
/** Logger instance. */
|
|
277
|
+
logger?: Logger;
|
|
278
|
+
}
|
|
279
|
+
|
|
280
|
+
export declare interface ResolvePackagesResult {
|
|
281
|
+
/** True if all packages resolved without errors. */
|
|
282
|
+
success: boolean;
|
|
283
|
+
/** Successfully resolved packages. */
|
|
284
|
+
packages: ResolvedPackage[];
|
|
285
|
+
/** Packages that failed to resolve. */
|
|
286
|
+
errors: Array<{
|
|
287
|
+
name: string;
|
|
288
|
+
error: string;
|
|
289
|
+
}>;
|
|
290
|
+
}
|
|
291
|
+
|
|
224
292
|
export { SearchOptions }
|
|
225
293
|
|
|
226
294
|
export { SearchRequest }
|