@atomic-ehr/fhir-canonical-manager 0.0.14 → 0.0.16

package/dist/cache.d.ts

@@ -1,4 +1,4 @@
-import { type ReferenceManager } from "./reference/index.js";
+import { type ReferenceManager } from "./reference.js";
 import type { CacheData, CacheKey, IndexCache } from "./types/index.js";
 export interface ExtendedCache extends IndexCache {
     referenceManager: ReferenceManager;
@@ -9,8 +9,11 @@ export declare const cacheRecordPaths: (pwd: string, packages: string[]) => {
     cacheRecordPath: string;
     cacheIndexFile: string;
     npmPackagePath: string;
+    npmRootPackageJsonFile: string;
 };
+export declare const calculatePackageLockHash: (npmPackagePath: string) => Promise<string | undefined>;
 export declare const createCacheRecord: () => ExtendedCache;
 export declare const loadCacheRecordFromDisk: (pwd: string, cacheKey: CacheKey) => Promise<CacheData | undefined>;
 export declare const saveCacheRecordToDisk: (cache: ExtendedCache, pwd: string, cacheKey: CacheKey) => Promise<void>;
+export declare const flushCache: (workingDir: string) => Promise<void>;
 //# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAGA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAExE,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC7C,gBAAgB,EAAE,gBAAgB,CAAC;CACtC;AAED,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,KAAG,QAIpD,CAAC;AASF,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,EAAE,UAAU,MAAM,EAAE;;;;;CAG/D,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAO,aAOpC,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAU,KAAK,MAAM,EAAE,UAAU,QAAQ,KAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAQ5G,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAU,OAAO,aAAa,EAAE,KAAK,MAAM,EAAE,UAAU,QAAQ,KAAG,OAAO,CAAC,IAAI,CAU/G,CAAC"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAGA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAExE,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC7C,gBAAgB,EAAE,gBAAgB,CAAC;CACtC;AAED,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,KAAG,QAIpD,CAAC;AAUF,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,EAAE,UAAU,MAAM,EAAE;;;;;;CAG/D,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAU,gBAAgB,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAYjG,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAO,aAOpC,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAU,KAAK,MAAM,EAAE,UAAU,QAAQ,KAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAQ5G,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAU,OAAO,aAAa,EAAE,KAAK,MAAM,EAAE,UAAU,QAAQ,KAAG,OAAO,CAAC,IAAI,CAW/G,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,YAAY,MAAM,KAAG,OAAO,CAAC,IAAI,CASjE,CAAC"}

package/dist/cache.js

@@ -1,7 +1,7 @@
 import { createHash } from "node:crypto";
 import * as afs from "node:fs/promises";
 import * as Path from "node:path";
-import { createReferenceManager } from "./reference/index.js";
+import { createReferenceManager } from "./reference.js";
 export const computeCacheKey = (packages) => {
     const content = JSON.stringify(packages.toSorted());
     const hash = createHash("sha256").update(content).digest("hex");
@@ -10,13 +10,27 @@ export const computeCacheKey = (packages) => {
 const cacheRecordPathsFromKey = (pwd, cacheKey) => {
     const cacheRecordPath = Path.join(pwd, cacheKey);
     const npmPackagePath = Path.join(process.cwd(), cacheRecordPath, "node");
+    const npmRootPackageJsonFile = Path.join(npmPackagePath, "package.json");
     const cacheIndexFile = Path.join(cacheRecordPath, "index.json");
-    return { cacheKey, cacheRecordPath, cacheIndexFile, npmPackagePath };
+    return { cacheKey, cacheRecordPath, cacheIndexFile, npmPackagePath, npmRootPackageJsonFile };
 };
 export const cacheRecordPaths = (pwd, packages) => {
     const cacheKey = computeCacheKey(packages);
     return cacheRecordPathsFromKey(pwd, cacheKey);
 };
+export const calculatePackageLockHash = async (npmPackagePath) => {
+    const lockFiles = ["package-lock.json", "bun.lock", "bun.lockb"];
+    for (const lockFile of lockFiles) {
+        const lockPath = Path.join(npmPackagePath, lockFile);
+        try {
+            const content = await afs.readFile(lockPath);
+            return createHash("sha256").update(content).digest("hex");
+        }
+        catch {
+        }
+    }
+    return undefined;
+};
 export const createCacheRecord = () => {
     return {
         entries: {},
@@ -40,10 +54,22 @@ export const saveCacheRecordToDisk = async (cache, pwd, cacheKey) => {
         entries: cache.entries,
         packages: cache.packages,
         references: cache.referenceManager.getAllReferences(),
-        packageLockHash: cacheKey,
     };
-    const { cacheIndexFile, cacheRecordPath } = cacheRecordPathsFromKey(pwd, cacheKey);
+    const { cacheIndexFile, cacheRecordPath, npmPackagePath } = cacheRecordPathsFromKey(pwd, cacheKey);
+    cacheData.packageLockHash = await calculatePackageLockHash(npmPackagePath);
+    cacheData.cacheKey = cacheKey;
     await afs.mkdir(cacheRecordPath, { recursive: true });
     await afs.writeFile(cacheIndexFile, JSON.stringify(cacheData, null, 2));
 };
+export const flushCache = async (workingDir) => {
+    try {
+        const entries = await afs.readdir(workingDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory() && /^[a-f0-9]{64}$/i.test(entry.name)) {
+                await afs.rm(Path.join(workingDir, entry.name), { recursive: true, force: true });
+            }
+        }
+    }
+    catch { }
+};
 //# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAyB,MAAM,sBAAsB,CAAC;AAOrF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAkB,EAAY,EAAE;IAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChE,OAAO,IAAgB,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,GAAW,EAAE,QAAkB,EAAE,EAAE;IAChE,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;IACzE,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IAChE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AACzE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAE,QAAkB,EAAE,EAAE;IAChE,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC3C,OAAO,uBAAuB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAkB,EAAE;IACjD,OAAO;QACH,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,EAAE;QACd,gBAAgB,EAAE,sBAAsB,EAAE;KAC7C,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAAE,GAAW,EAAE,QAAkB,EAAkC,EAAE;IAC7G,IAAI,CAAC;QACD,MAAM,EAAE,cAAc,EAAE,GAAG,uBAAuB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACL,OAAO;IACX,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EAAE,KAAoB,EAAE,GAAW,EAAE,QAAkB,EAAiB,EAAE;IAChH,MAAM,SAAS,GAAc;QACzB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,gBAAgB,CAAC,gBAAgB,EAAE;QACrD,eAAe,EAAE,QAAQ;KAC5B,CAAC;IACF,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,GAAG,uBAAuB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACnF,MAAM,GAAG,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC5E,CAAC,CAAC"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { CanonicalManager, createCanonicalManager } from "./manager/index.js";
-export type { ReferenceManager as ReferenceManagerType } from "./reference/index.js";
-export { createReferenceManager, ReferenceManagerFactory as ReferenceManager } from "./reference/index.js";
+export type { ReferenceManager as ReferenceManagerType } from "./reference.js";
+export { createReferenceManager, ReferenceManagerFactory as ReferenceManager } from "./reference.js";
 export type { CanonicalManager as TCanonicalManager } from "./types/core.js";
 export * from "./types/index.js";
 import { createCanonicalManager } from "./manager/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,YAAY,EAAE,gBAAgB,IAAI,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,IAAI,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE3G,YAAY,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,YAAY,EAAE,gBAAgB,IAAI,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE/E,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAErG,YAAY,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,eAAe,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 export { CanonicalManager, createCanonicalManager } from "./manager/index.js";
-export { createReferenceManager, ReferenceManagerFactory as ReferenceManager } from "./reference/index.js";
+export { createReferenceManager, ReferenceManagerFactory as ReferenceManager } from "./reference.js";
 export * from "./types/index.js";
 import { createCanonicalManager } from "./manager/index.js";
 export default createCanonicalManager;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAG9E,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,IAAI,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAI3G,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAG9E,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIrG,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,eAAe,sBAAsB,CAAC"}

package/dist/local.d.ts

@@ -0,0 +1,5 @@
+import type { LocalPackageConfig, PackageId } from "./types/index.js";
+export declare const installTgzPackage: (archivePath: string, destPath: string, registry?: string) => Promise<PackageId>;
+export declare const generateIndexJson: (targetPath: string) => Promise<void>;
+export declare const installLocalFolder: (config: LocalPackageConfig, destPath: string) => Promise<PackageId>;
+//# sourceMappingURL=local.d.ts.map

package/dist/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../src/local.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAuCtE,eAAO,MAAM,iBAAiB,GAC1B,aAAa,MAAM,EACnB,UAAU,MAAM,EAChB,WAAW,MAAM,KAClB,OAAO,CAAC,SAAS,CA2CnB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAU,YAAY,MAAM,KAAG,OAAO,CAAC,IAAI,CA+CxE,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,QAAQ,kBAAkB,EAAE,UAAU,MAAM,KAAG,OAAO,CAAC,SAAS,CAwDxG,CAAC"}

package/dist/local.js

@@ -0,0 +1,148 @@
+import * as afs from "node:fs/promises";
+import * as Path from "node:path";
+import { ensureDir, fileExists } from "./fs/index.js";
+import { isPathSpec, parsePackageRef } from "./manager/package-spec.js";
+import { installPackages } from "./package.js";
+const parseDependencySpec = (spec) => {
+    const trimmed = spec.trim();
+    if (!trimmed || isPathSpec(trimmed) || trimmed.startsWith("http://") || trimmed.startsWith("https://")) {
+        return undefined;
+    }
+    try {
+        return parsePackageRef(trimmed);
+    }
+    catch {
+        return undefined;
+    }
+};
+export const installTgzPackage = async (archivePath, destPath, registry) => {
+    if (!(await fileExists(archivePath))) {
+        throw new Error(`TGZ archive not found: ${archivePath}`);
+    }
+    await installPackages([archivePath], destPath, registry);
+    const rootPackageJsonPath = Path.join(destPath, "package.json");
+    const rootPackageJson = JSON.parse(await afs.readFile(rootPackageJsonPath, "utf-8"));
+    const dependencies = rootPackageJson.dependencies || {};
+    for (const [depName, depVersion] of Object.entries(dependencies)) {
+        if (depVersion === archivePath || depVersion.includes(archivePath)) {
+            const pkgPath = depName.startsWith("@")
+                ? Path.join(destPath, "node_modules", ...depName.split("/"))
+                : Path.join(destPath, "node_modules", depName);
+            const pkgJsonPath = Path.join(pkgPath, "package.json");
+            if (await fileExists(pkgJsonPath)) {
+                const pkgJson = JSON.parse(await afs.readFile(pkgJsonPath, "utf-8"));
+                return { name: pkgJson.name, version: pkgJson.version };
+            }
+        }
+    }
+    const nodeModulesPath = Path.join(destPath, "node_modules");
+    const entries = await afs.readdir(nodeModulesPath, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const pkgPath = Path.join(nodeModulesPath, entry.name);
+        const pkgJsonPath = Path.join(pkgPath, "package.json");
+        if (await fileExists(pkgJsonPath)) {
+            const pkgJson = JSON.parse(await afs.readFile(pkgJsonPath, "utf-8"));
+            if (await fileExists(Path.join(pkgPath, ".index.json"))) {
+                return { name: pkgJson.name, version: pkgJson.version };
+            }
+        }
+    }
+    throw new Error(`Failed to identify installed package from tgz: ${archivePath}`);
+};
+export const generateIndexJson = async (targetPath) => {
+    const files = [];
+    const entries = await afs.readdir(targetPath, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        if (!entry.name.endsWith(".json"))
+            continue;
+        if (entry.name === "package.json" || entry.name === ".index.json")
+            continue;
+        const filePath = Path.join(targetPath, entry.name);
+        try {
+            const content = await afs.readFile(filePath, "utf-8");
+            const resource = JSON.parse(content);
+            if (!resource.resourceType || !resource.id)
+                continue;
+            const indexEntry = {
+                filename: entry.name,
+                resourceType: resource.resourceType,
+                id: resource.id,
+            };
+            if (resource.url)
+                indexEntry.url = resource.url;
+            if (resource.version)
+                indexEntry.version = resource.version;
+            if (resource.resourceType === "StructureDefinition") {
+                if (resource.kind)
+                    indexEntry.kind = resource.kind;
+                if (resource.type)
+                    indexEntry.type = resource.type;
+            }
+            files.push(indexEntry);
+        }
+        catch (e) {
+            console.error("Error while creating index.json", e);
+        }
+    }
+    if (files.length === 0) {
+        throw new Error(`No valid FHIR resources found in folder: ${targetPath}`);
+    }
+    const indexFile = {
+        "index-version": 1,
+        files,
+    };
+    await afs.writeFile(Path.join(targetPath, ".index.json"), JSON.stringify(indexFile, null, 2));
+};
+export const installLocalFolder = async (config, destPath) => {
+    const { name, version, path: sourcePath } = config;
+    if (!(await fileExists(sourcePath))) {
+        throw new Error(`Local package folder not found: ${sourcePath}`);
+    }
+    const nodeModulesPath = Path.join(destPath, "node_modules");
+    const targetPath = name.startsWith("@")
+        ? Path.join(nodeModulesPath, ...name.split("/"))
+        : Path.join(nodeModulesPath, name);
+    await afs.rm(targetPath, { recursive: true, force: true });
+    await ensureDir(Path.dirname(targetPath));
+    await afs.cp(sourcePath, targetPath, { recursive: true });
+    const packageJsonPath = Path.join(targetPath, "package.json");
+    let packageJson;
+    if (await fileExists(packageJsonPath)) {
+        packageJson = JSON.parse(await afs.readFile(packageJsonPath, "utf-8"));
+        packageJson.name = packageJson.name ?? name;
+        packageJson.version = packageJson.version ?? version;
+        packageJson.private = true;
+    }
+    else {
+        packageJson = {
+            name,
+            version,
+            private: true,
+        };
+    }
+    if (!packageJson.dependencies) {
+        packageJson.dependencies = {};
+    }
+    const dependencyMap = packageJson.dependencies;
+    if (config.dependencies) {
+        for (const dep of config.dependencies) {
+            const parsed = parseDependencySpec(dep);
+            if (!parsed)
+                continue;
+            if (!dependencyMap[parsed.name]) {
+                dependencyMap[parsed.name] = parsed.version;
+            }
+        }
+    }
+    await afs.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2));
+    const indexJsonPath = Path.join(targetPath, ".index.json");
+    if (!(await fileExists(indexJsonPath))) {
+        await generateIndexJson(targetPath);
+    }
+    return { name, version };
+};
+//# sourceMappingURL=local.js.map

package/dist/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../src/local.ts"],"names":[],"mappings":"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"}

package/dist/manager/canonical.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../../src/manager/canonical.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACR,gBAAgB,EAChB,MAAM,EAQT,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,sBAAsB,GAAI,QAAQ,MAAM,KAAG,gBA6SvD,CAAC"}
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../../src/manager/canonical.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EACR,gBAAgB,EAChB,MAAM,EAUT,MAAM,mBAAmB,CAAC;AA+C3B,eAAO,MAAM,sBAAsB,GAAI,QAAQ,MAAM,KAAG,gBAwfvD,CAAC"}

package/dist/manager/canonical.js

@@ -1,14 +1,93 @@
+import { createHash } from "node:crypto";
 import * as afs from "node:fs/promises";
 import * as Path from "node:path";
-import { cacheRecordPaths, createCacheRecord, loadCacheRecordFromDisk, saveCacheRecordToDisk } from "../cache.js";
+import { cacheRecordPaths, calculatePackageLockHash, createCacheRecord, flushCache as flushCacheFromDisk, loadCacheRecordFromDisk, saveCacheRecordToDisk, } from "../cache.js";
 import { DEFAULT_REGISTRY } from "../constants.js";
-import { ensureDir } from "../fs/index.js";
+import { ensureDir, fileExists } from "../fs/index.js";
+import { installLocalFolder, installTgzPackage } from "../local.js";
 import { installPackages } from "../package.js";
-import { resolveWithContext } from "../resolver/index.js";
+import { resolveWithContext } from "../resolver.js";
 import { scanDirectory } from "../scanner/index.js";
 import { filterBySmartSearch } from "../search/index.js";
+import { isPathSpec, normalizePackageSpec, parsePackageRef } from "./package-spec.js";
+const hashLocalPackageSource = async (dirPath) => {
+    const hash = createHash("sha256");
+    const walk = async (currentPath) => {
+        const entries = await afs.readdir(currentPath, { withFileTypes: true });
+        entries.sort((a, b) => a.name.localeCompare(b.name));
+        for (const entry of entries) {
+            if (entry.name === "node_modules" || entry.name === ".git") {
+                continue;
+            }
+            const fullPath = Path.join(currentPath, entry.name);
+            if (entry.isDirectory()) {
+                hash.update(`dir:${fullPath}`);
+                await walk(fullPath);
+            }
+            else if (entry.isFile()) {
+                hash.update(`file:${fullPath}`);
+                const content = await afs.readFile(fullPath);
+                hash.update(content);
+            }
+        }
+    };
+    await walk(dirPath);
+    return hash.digest("hex");
+};
+const createLocalCacheKeyPart = async (config) => {
+    const dependencies = config.dependencies ? [...config.dependencies].sort() : [];
+    const sourceHash = await hashLocalPackageSource(config.path);
+    return JSON.stringify({
+        type: "local",
+        name: config.name,
+        version: config.version,
+        path: config.path,
+        dependencies,
+        sourceHash,
+    });
+};
 export const createCanonicalManager = (config) => {
-    const { packages = [], workingDir } = config;
+    const workingDir = config.workingDir;
+    const packageSpecs = [...(config.packages ?? [])].map(normalizePackageSpec);
+    const localPackages = new Map();
+    const pathPackageMeta = new Map();
+    const getCacheKeyPackages = () => {
+        const localParts = Array.from(localPackages.values()).map((entry) => entry.cacheKeyPart);
+        return [...packageSpecs, ...localParts];
+    };
+    const refreshLocalPackageCacheKeys = async () => {
+        if (localPackages.size === 0)
+            return;
+        await Promise.all(Array.from(localPackages.values()).map(async (entry) => {
+            entry.cacheKeyPart = await createLocalCacheKeyPart(entry.config);
+        }));
+    };
+    const localPackageTargetPath = (packageName, npmPackagePath) => {
+        const segments = packageName.startsWith("@") ? packageName.split("/") : [packageName];
+        return Path.join(npmPackagePath, "node_modules", ...segments);
+    };
+    const ensureLocalPackagesPresent = async (npmPackagePath) => {
+        if (localPackages.size === 0)
+            return true;
+        for (const entry of localPackages.values()) {
+            const targetPath = localPackageTargetPath(entry.config.name, npmPackagePath);
+            if (!(await fileExists(targetPath))) {
+                return false;
+            }
+        }
+        return true;
+    };
+    const areCachedPackagePathsPresent = async (packagesRecord) => {
+        const packageInfos = Object.values(packagesRecord);
+        if (packageInfos.length === 0)
+            return true;
+        const checks = await Promise.all(packageInfos.map(async (pkg) => {
+            if (!pkg.path)
+                return true;
+            return fileExists(pkg.path);
+        }));
+        return checks.every(Boolean);
+    };
     let registry = DEFAULT_REGISTRY;
     if (config.registry) {
         registry = config.registry.endsWith("/") ? config.registry : `${config.registry}/`;
@@ -16,19 +95,106 @@ export const createCanonicalManager = (config) => {
     const cache = createCacheRecord();
     let initialized = false;
     const searchParamsCache = new Map();
+    const installConfiguredLocalPackages = async (npmPackagePath) => {
+        const skipDependencyInstall = process.env.FCM_SKIP_LOCAL_DEP_INSTALL === "1";
+        for (const entry of localPackages.values()) {
+            await installLocalFolder(entry.config, npmPackagePath);
+            if (!skipDependencyInstall && entry.config.dependencies && entry.config.dependencies.length > 0) {
+                await installPackages(entry.config.dependencies, npmPackagePath, registry);
+            }
+        }
+    };
     const ensureInitialized = () => {
         if (!initialized) {
             throw new Error("CanonicalManager not initialized. Call init() first.");
         }
     };
+    const rebuildWithCurrentConfig = async () => {
+        if (initialized) {
+            await destroy();
+        }
+        await init();
+    };
+    const packageRefToPackageMeta = async () => {
+        ensureInitialized();
+        const { npmRootPackageJsonFile } = cacheRecordPaths(workingDir, getCacheKeyPackages());
+        const rootPackageDeps = JSON.parse(await afs.readFile(npmRootPackageJsonFile, "utf8")).dependencies ?? {};
+        const res = {};
+        const resolveHttpSpec = (pkgRef) => {
+            for (const [depName, depVersion] of Object.entries(rootPackageDeps)) {
+                if (depVersion === pkgRef) {
+                    const packageInfo = cache.packages[depName];
+                    if (!packageInfo)
+                        throw new Error(`Package not found: ${depName}`);
+                    return { name: packageInfo.id.name, version: packageInfo.id.version };
+                }
+            }
+            return undefined;
+        };
+        const getMetaForRef = (pkgRef) => {
+            if (pathPackageMeta.has(pkgRef)) {
+                return pathPackageMeta.get(pkgRef);
+            }
+            if (pkgRef.startsWith("http://") || pkgRef.startsWith("https://")) {
+                return resolveHttpSpec(pkgRef);
+            }
+            if (isPathSpec(pkgRef)) {
+                const meta = pathPackageMeta.get(pkgRef);
+                if (meta)
+                    return meta;
+            }
+            const parsed = parsePackageRef(pkgRef);
+            const packageInfo = cache.packages[parsed.name];
+            if (packageInfo) {
+                return { name: packageInfo.id.name, version: packageInfo.id.version };
+            }
+            return parsed;
+        };
+        for (const pkgRef of packageSpecs) {
+            const meta = getMetaForRef(pkgRef);
+            if (meta) {
+                res[pkgRef] = meta;
+            }
+        }
+        for (const entry of localPackages.values()) {
+            res[entry.config.path] = {
+                name: entry.config.name,
+                version: entry.config.version,
+            };
+            if (entry.config.dependencies) {
+                for (const dependencyRef of entry.config.dependencies) {
+                    if (res[dependencyRef])
+                        continue;
+                    const dependencyMeta = getMetaForRef(dependencyRef);
+                    if (dependencyMeta) {
+                        res[dependencyRef] = dependencyMeta;
+                    }
+                }
+            }
+        }
+        return res;
+    };
     const init = async () => {
         if (initialized)
-            return;
+            return packageRefToPackageMeta();
+        await refreshLocalPackageCacheKeys();
         await ensureDir(workingDir);
-        const { cacheKey, npmPackagePath } = cacheRecordPaths(workingDir, packages);
+        const { cacheKey, npmPackagePath } = cacheRecordPaths(workingDir, getCacheKeyPackages());
         const cachedData = await loadCacheRecordFromDisk(workingDir, cacheKey);
-        const isCacheValid = cachedData && cachedData.packageLockHash === cacheKey;
-        if (isCacheValid) {
+        const nodeModulesPath = Path.join(npmPackagePath, "node_modules");
+        const hasInstalledPackages = await fileExists(nodeModulesPath);
+        let isCacheValid = false;
+        if (cachedData !== undefined && hasInstalledPackages) {
+            const cacheKeyMatches = cachedData.cacheKey === cacheKey;
+            const currentLockHash = await calculatePackageLockHash(npmPackagePath);
+            const lockHashMatches = currentLockHash === undefined ||
+                cachedData.packageLockHash === undefined ||
+                currentLockHash === cachedData.packageLockHash;
+            const cachedPackagesPresent = await areCachedPackagePathsPresent(cachedData.packages);
+            const localPackagesPresent = await ensureLocalPackagesPresent(npmPackagePath);
+            isCacheValid = cacheKeyMatches && lockHashMatches && cachedPackagesPresent && localPackagesPresent;
+        }
+        if (isCacheValid && cachedData) {
             cache.entries = cachedData.entries;
             cache.packages = cachedData.packages;
             Object.entries(cachedData.references).forEach(([id, metadata]) => {
@@ -36,11 +202,13 @@ export const createCanonicalManager = (config) => {
             });
         }
         else {
-            await installPackages(packages, npmPackagePath, registry);
+            await installPackages(packageSpecs, npmPackagePath, registry);
+            await installConfiguredLocalPackages(npmPackagePath);
             await scanDirectory(cache, npmPackagePath);
             await saveCacheRecordToDisk(cache, workingDir, cacheKey);
         }
         initialized = true;
+        return packageRefToPackageMeta();
     };
     const destroy = async () => {
         cache.entries = {};
@@ -55,20 +223,21 @@ export const createCanonicalManager = (config) => {
     };
     const addPackages = async (...newPackages) => {
         if (newPackages.length === 0)
-            return;
-        const packagesToAdd = newPackages.filter((pkg) => !packages.includes(pkg));
+            return packageRefToPackageMeta();
+        const normalized = newPackages.map(normalizePackageSpec);
+        const packagesToAdd = normalized.filter((pkg) => !packageSpecs.includes(pkg));
         if (packagesToAdd.length !== 0) {
-            packages.push(...packagesToAdd);
+            packageSpecs.push(...packagesToAdd);
         }
         if (!initialized) {
             await init();
-            return;
+            return packageRefToPackageMeta();
         }
         if (packagesToAdd.length > 0) {
             await destroy();
             await init();
         }
-        return;
+        return packageRefToPackageMeta();
     };
     const resolveEntry = async (canonicalUrl, options) => {
         ensureInitialized();
@@ -192,11 +361,58 @@ export const createCanonicalManager = (config) => {
         searchParamsCache.set(resourceType, results);
         return results;
     };
+    const packageJson = async (packageName) => {
+        ensureInitialized();
+        const fn = cache.packages[packageName]?.path;
+        if (!fn)
+            throw new Error(`Package ${packageName} not found`);
+        const packageJSON = JSON.parse(await afs.readFile(Path.join(fn, "package.json"), "utf8"));
+        return packageJSON;
+    };
+    const addTgzPackage = async (config) => {
+        const archivePath = Path.resolve(config.archivePath);
+        const { npmPackagePath } = cacheRecordPaths(workingDir, getCacheKeyPackages());
+        await ensureDir(npmPackagePath);
+        const { name, version } = await installTgzPackage(archivePath, npmPackagePath, registry);
+        pathPackageMeta.set(archivePath, { name, version });
+        if (!packageSpecs.includes(archivePath)) {
+            packageSpecs.push(archivePath);
+        }
+        await rebuildWithCurrentConfig();
+        return { name, version };
+    };
+    const addLocalPackage = async (config) => {
+        const normalizedConfig = {
+            ...config,
+            path: Path.resolve(config.path),
+        };
+        const cacheKeyPart = await createLocalCacheKeyPart(normalizedConfig);
+        const entry = {
+            config: normalizedConfig,
+            cacheKeyPart,
+        };
+        localPackages.set(normalizedConfig.path, entry);
+        pathPackageMeta.set(normalizedConfig.path, {
+            name: normalizedConfig.name,
+            version: normalizedConfig.version,
+        });
+        await rebuildWithCurrentConfig();
+        return { name: normalizedConfig.name, version: normalizedConfig.version };
+    };
+    const flushCache = async () => {
+        await flushCacheFromDisk(workingDir);
+        if (initialized) {
+            await destroy();
+        }
+    };
     return {
         init,
         destroy,
         packages: getPackages,
         addPackages,
+        addTgzPackage,
+        addLocalPackage,
+        flushCache,
         resolveEntry,
         resolve,
         read,
@@ -204,14 +420,7 @@ export const createCanonicalManager = (config) => {
         search,
         smartSearch,
         getSearchParametersForResource,
-        packageJson: async (packageName) => {
-            ensureInitialized();
-            const fn = cache.packages[packageName]?.path;
-            if (!fn)
-                throw new Error(`Package ${packageName} not found`);
-            const packageJSON = JSON.parse(await afs.readFile(Path.join(fn, "package.json"), "utf8"));
-            return packageJSON;
-        },
+        packageJson,
     };
 };
 //# sourceMappingURL=canonical.js.map