@synopackageland/cli 0.3.9 → 0.4.0

package/dist/error-collector.d.ts

@@ -1,2 +0,0 @@
-export declare function extractReferencedErrorCodes(srcDirectory: string): Set<string>;
-export declare function extractAllStringLiterals(srcDirectory: string): Set<string>;

package/dist/error-collector.js

@@ -1,46 +0,0 @@
-import { readFileSync, readdirSync, statSync } from "node:fs";
-import { join } from "node:path";
-import { ERROR_REGISTRY } from "../src/error-registry.js";
-function getAllTsFiles(dir, excludeDirs = []) {
-    const files = [];
-    for (const entry of readdirSync(dir)) {
-        const fullPath = join(dir, entry);
-        if (statSync(fullPath).isDirectory()) {
-            if (!excludeDirs.includes(entry)) {
-                files.push(...getAllTsFiles(fullPath, excludeDirs));
-            }
-        }
-        else if (fullPath.endsWith(".ts")) {
-            files.push(fullPath);
-        }
-    }
-    return files;
-}
-export function extractReferencedErrorCodes(srcDirectory) {
-    const tsFiles = getAllTsFiles(srcDirectory, ["mock-broker"]).filter((f) => !f.endsWith("error-registry.ts"));
-    const referenced = new Set();
-    for (const file of tsFiles) {
-        const content = readFileSync(file, "utf8");
-        for (const code of Object.keys(ERROR_REGISTRY)) {
-            // Check if `code` appears as a string literal or identifier in the file
-            if (content.includes(`"${code}"`) || content.includes(`'${code}'`) || content.includes(`\`${code}\``)) {
-                referenced.add(code);
-            }
-        }
-    }
-    return referenced;
-}
-export function extractAllStringLiterals(srcDirectory) {
-    const tsFiles = getAllTsFiles(srcDirectory, ["mock-broker"]).filter((f) => !f.endsWith("error-registry.ts"));
-    const literals = new Set();
-    const codeRegex = /["']([A-Z][A-Z0-9_]{2,})["']/g;
-    for (const file of tsFiles) {
-        const content = readFileSync(file, "utf8");
-        codeRegex.lastIndex = 0;
-        let match;
-        while ((match = codeRegex.exec(content)) !== null) {
-            literals.add(match[1]);
-        }
-    }
-    return literals;
-}

package/dist/host/broker-paths.d.ts

@@ -1 +0,0 @@
-export declare const IDENTITY_CGI_PATH = "/webman/3rdparty/SynoPkgLandService/index.cgi";

package/dist/host/broker-paths.js

@@ -1 +0,0 @@
-export const IDENTITY_CGI_PATH = "/webman/3rdparty/SynoPkgLandService/index.cgi";

package/dist/host/broker-upgrade-preflight.d.ts

@@ -1,61 +0,0 @@
-export declare const BROKER_UPGRADE_TARGET_HOST = "10.17.83.200";
-export type DsmUpgradeResponseKind = "error-4552" | "success" | "consent" | "unknown";
-export interface ConsentDialogEvidence {
-    consentDialog: {
-        dependers: string[];
-    };
-}
-export interface BrokerUpgradeDependerBaseline {
-    packageIdentity: string;
-    version: string;
-    status: string;
-    running: boolean;
-}
-export interface BrokerUpgradeDepender extends BrokerUpgradeDependerBaseline {
-    healthCheckOk: boolean;
-    a23Classified: boolean;
-    dataSnapshotOk: boolean;
-}
-export interface BrokerUpgradePreflightInput {
-    targetHost: string;
-    broker: {
-        version: string;
-        status: string;
-        running: boolean;
-    };
-    dependers: BrokerUpgradeDepender[];
-    previousSpk: {
-        available: boolean;
-        sha256?: string;
-    };
-    canonicalizeGateSatisfied: boolean;
-    catalogEntry: {
-        version: string;
-    };
-}
-export type PreflightDecision = {
-    ok: true;
-} | {
-    ok: false;
-    codes: string[];
-};
-export interface Evaluate4552BranchInput {
-    response: unknown;
-    dependers: BrokerUpgradeDependerBaseline[];
-}
-/**
- * Classify only already-parsed DSM evidence. Strings are deliberately never
- * parsed or searched: a textual mention of 4552 is not a DSM error response.
- */
-export declare function classifyDsmUpgradeResponse(raw: unknown): DsmUpgradeResponseKind;
-/**
- * Evaluate every local prerequisite without performing an upgrade or
- * proposing a stop/start action. A missing or malformed prerequisite is a
- * failure, even when another part of the input looks healthy.
- */
-export declare function evaluateBrokerUpgradePreflight(input: BrokerUpgradePreflightInput): PreflightDecision;
-/**
- * The 4552 path is entered only for a numeric DSM error and a non-empty,
- * fully identified running baseline inventory.
- */
-export declare function evaluate4552Branch(input: Evaluate4552BranchInput): PreflightDecision;

package/dist/host/broker-upgrade-preflight.js

@@ -1,156 +0,0 @@
-import { comparePackageVersions } from "@synopackageland/package-source/index-manifest";
-export const BROKER_UPGRADE_TARGET_HOST = "10.17.83.200";
-/**
- * Classify only already-parsed DSM evidence. Strings are deliberately never
- * parsed or searched: a textual mention of 4552 is not a DSM error response.
- */
-export function classifyDsmUpgradeResponse(raw) {
-    if (!isRecord(raw)) {
-        return "unknown";
-    }
-    if (isRecord(raw.error) && raw.error.code === 4552) {
-        return "error-4552";
-    }
-    const hasError = Object.prototype.hasOwnProperty.call(raw, "error") &&
-        raw.error !== null &&
-        raw.error !== undefined;
-    if (raw.success === true && !hasError) {
-        return "success";
-    }
-    if (isConsentDialogEvidence(raw)) {
-        return "consent";
-    }
-    return "unknown";
-}
-/**
- * Evaluate every local prerequisite without performing an upgrade or
- * proposing a stop/start action. A missing or malformed prerequisite is a
- * failure, even when another part of the input looks healthy.
- */
-export function evaluateBrokerUpgradePreflight(input) {
-    const candidate = isRecord(input) ? input : {};
-    const codes = [];
-    const addCode = (code) => {
-        if (!codes.includes(code)) {
-            codes.push(code);
-        }
-    };
-    if (candidate.targetHost !== BROKER_UPGRADE_TARGET_HOST) {
-        addCode("PREFLIGHT_WRONG_TARGET");
-    }
-    const broker = candidate.broker;
-    if (!isRecord(broker)) {
-        addCode("PREFLIGHT_BROKER_NOT_RUNNING");
-        addCode("PREFLIGHT_BROKER_VERSION_INVALID");
-    }
-    else {
-        if (broker.running !== true || broker.status !== "running") {
-            addCode("PREFLIGHT_BROKER_NOT_RUNNING");
-        }
-        if (!isNonEmptyString(broker.version)) {
-            addCode("PREFLIGHT_BROKER_VERSION_INVALID");
-        }
-    }
-    const dependers = candidate.dependers;
-    if (!Array.isArray(dependers)) {
-        addCode("PREFLIGHT_DEPENDER_INVENTORY_INVALID");
-    }
-    else {
-        for (const depender of dependers) {
-            if (!isRecord(depender)) {
-                addCode("PREFLIGHT_DEPENDER_INVENTORY_INVALID");
-                continue;
-            }
-            if (!isNonEmptyString(depender.packageIdentity) || !isNonEmptyString(depender.version)) {
-                addCode("PREFLIGHT_DEPENDER_INVENTORY_INVALID");
-            }
-            if (depender.running !== true) {
-                addCode("PREFLIGHT_DEPENDER_NOT_RUNNING");
-            }
-            if (depender.status !== "running") {
-                addCode("PREFLIGHT_DEPENDER_UNSAFE_STATUS");
-            }
-            if (depender.healthCheckOk !== true) {
-                addCode("PREFLIGHT_DEPENDER_HEALTHCHECK_FAILED");
-            }
-            if (depender.a23Classified !== true) {
-                addCode("PREFLIGHT_DEPENDER_A23_UNCLASSIFIED");
-            }
-            if (depender.dataSnapshotOk !== true) {
-                addCode("PREFLIGHT_DEPENDER_DATA_SNAPSHOT_MISSING");
-            }
-        }
-    }
-    const previousSpk = candidate.previousSpk;
-    if (!isRecord(previousSpk) || previousSpk.available !== true) {
-        addCode("PREFLIGHT_PREVIOUS_SPK_UNAVAILABLE");
-    }
-    else if (!isSha256(previousSpk.sha256)) {
-        addCode("PREFLIGHT_PREVIOUS_SPK_DIGEST_INVALID");
-    }
-    if (candidate.canonicalizeGateSatisfied !== true) {
-        addCode("PREFLIGHT_CANONICALIZE_GATE_UNSATISFIED");
-    }
-    const catalogEntry = candidate.catalogEntry;
-    if (!isRecord(catalogEntry) || !isNonEmptyString(catalogEntry.version)) {
-        addCode("PREFLIGHT_CATALOG_VERSION_INVALID");
-    }
-    else if (!isRecord(broker) || !isNonEmptyString(broker.version)) {
-        // The broker version gate is already reported above; without both version
-        // strings there is no safe comparison to perform.
-        addCode("PREFLIGHT_VERSION_COMPARISON_INVALID");
-    }
-    else {
-        const comparison = comparePackageVersions(catalogEntry.version, broker.version);
-        if (!Number.isFinite(comparison)) {
-            addCode("PREFLIGHT_VERSION_COMPARISON_INVALID");
-        }
-        else if (comparison <= 0) {
-            addCode("PREFLIGHT_CATALOG_VERSION_NOT_NEWER");
-        }
-    }
-    return decisionFromCodes(codes);
-}
-/**
- * The 4552 path is entered only for a numeric DSM error and a non-empty,
- * fully identified running baseline inventory.
- */
-export function evaluate4552Branch(input) {
-    const candidate = isRecord(input) ? input : {};
-    const codes = [];
-    if (classifyDsmUpgradeResponse(candidate.response) !== "error-4552") {
-        codes.push("PREFLIGHT_RESPONSE_NOT_4552");
-    }
-    const dependers = candidate.dependers;
-    if (!Array.isArray(dependers) ||
-        dependers.length === 0 ||
-        dependers.some((depender) => !isRunningBaseline(depender))) {
-        codes.push("PREFLIGHT_DEPENDER_INVENTORY_INCOMPLETE");
-    }
-    return decisionFromCodes(codes);
-}
-function decisionFromCodes(codes) {
-    return codes.length === 0 ? { ok: true } : { ok: false, codes };
-}
-function isRunningBaseline(value) {
-    return (isRecord(value) &&
-        isNonEmptyString(value.packageIdentity) &&
-        isNonEmptyString(value.version) &&
-        value.status === "running" &&
-        value.running === true);
-}
-function isConsentDialogEvidence(value) {
-    const dialog = value.consentDialog;
-    return (isRecord(dialog) &&
-        Array.isArray(dialog.dependers) &&
-        dialog.dependers.every((depender) => typeof depender === "string"));
-}
-function isRecord(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function isNonEmptyString(value) {
-    return typeof value === "string" && value.length > 0;
-}
-function isSha256(value) {
-    return typeof value === "string" && /^[0-9a-fA-F]{64}$/.test(value);
-}

package/dist/host/digests.d.ts

@@ -1,5 +0,0 @@
-import type { ProjectRoot } from "../discovery.js";
-export declare function digestString(value: string): string;
-export declare function digestDirectory(root: string): string;
-export declare function digestProjectContract(project: ProjectRoot): string;
-export declare function digestProjectBundle(project: ProjectRoot): string;

package/dist/host/digests.js

@@ -1,63 +0,0 @@
-import { createHash } from "node:crypto";
-import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-export function digestString(value) {
-    return createHash("sha256").update(value).digest("hex");
-}
-export function digestDirectory(root) {
-    const hash = createHash("sha256");
-    for (const relative of walkFiles(root)) {
-        hash.update(relative);
-        hash.update("\0");
-        hash.update(readFileSync(join(root, relative)));
-        hash.update("\0");
-    }
-    return hash.digest("hex");
-}
-export function digestProjectContract(project) {
-    return digestString(readFileSync(project.contractPath, "utf8"));
-}
-export function digestProjectBundle(project) {
-    const staging = mkdtempSync(join(tmpdir(), "syno-bundle-digest-"));
-    try {
-        const packageDir = join(staging, "package");
-        mkdirSync(packageDir, { recursive: true });
-        // Runtime members are whichever of the two exist; validate already refuses
-        // a project that has both or neither. The Broker computes the same set
-        // (packages/broker/src/digest.ts), so the two digests have to agree.
-        if (existsSync(project.composePath)) {
-            cpSync(project.composePath, join(packageDir, "compose.yaml"));
-        }
-        if (project.nativePath && existsSync(project.nativePath)) {
-            cpSync(project.nativePath, join(packageDir, "native.yaml"));
-        }
-        cpSync(project.contractPath, join(packageDir, "synology-app.yaml"));
-        const htmlDir = join(project.root, "html");
-        if (existsSync(htmlDir)) {
-            cpSync(htmlDir, join(packageDir, "html"), { recursive: true });
-        }
-        return digestDirectory(packageDir);
-    }
-    finally {
-        rmSync(staging, { recursive: true, force: true });
-    }
-}
-function walkFiles(root, prefix = "") {
-    const files = [];
-    for (const entry of readdirSync(root).sort(comparePosixPaths)) {
-        const relative = prefix ? `${prefix}/${entry}` : entry;
-        const absolute = join(root, entry);
-        const stat = statSync(absolute);
-        if (stat.isDirectory()) {
-            files.push(...walkFiles(absolute, relative));
-        }
-        else if (stat.isFile()) {
-            files.push(relative);
-        }
-    }
-    return files;
-}
-function comparePosixPaths(left, right) {
-    return left < right ? -1 : left > right ? 1 : 0;
-}

package/dist/host/fake-nas.d.ts

@@ -1,41 +0,0 @@
-import type { SharePermissionRow } from "./share-permission.js";
-import type { AttestationKind, HostInstallRecord, HostOidcCompatSettings, NasHost, PackageRoute } from "./types.js";
-export type SharePermissionRowInput = {
-    name: string;
-} & Partial<Omit<SharePermissionRow, "name">>;
-export interface FakeNasHostOptions {
-    curated?: string[];
-    dsmOrigin?: string;
-    homesPath?: string;
-    installationId?: string;
-    shareNames?: string[];
-    shares?: Record<string, string>;
-    /**
-     * SYNO.Core.Share.Permission rows per Share, as partials -- every flag
-     * defaults to false, matching a row DSM grants nothing on. Omit the whole
-     * option to model a host that cannot answer the permission question.
-     */
-    sharePermissions?: Record<string, {
-        users: SharePermissionRowInput[];
-        groups: SharePermissionRowInput[];
-    }>;
-    /** Group membership per DSM user, for share-permission resolution. */
-    userGroups?: Record<string, string[]>;
-    installedEnv?: Record<string, Record<string, string>>;
-    diagnostics?: {
-        dsmResidue?: import("./types.js").DsmResidueInventory;
-        packageRoute?: PackageRoute;
-        isPackageOnly?: boolean;
-        [key: string]: unknown;
-    };
-    /** Omit to model an older Broker without the OIDC settings endpoint. */
-    oidcCompat?: HostOidcCompatSettings;
-}
-export declare function createFakeNasHost(options?: FakeNasHostOptions): NasHost & {
-    installs: HostInstallRecord[];
-    attestations: Set<string>;
-    attestationInfo(packageIdentity: string): {
-        attestationKind: AttestationKind;
-    } | undefined;
-    seedInstalled(packageIdentity: string): void;
-};

package/dist/host/fake-nas.js

@@ -1,174 +0,0 @@
-import { webStationAlias } from "../contract/web-launch.js";
-function sharePermissionRow(input) {
-    return {
-        is_admin: false,
-        is_writable: false,
-        is_readonly: false,
-        is_deny: false,
-        is_custom: false,
-        ...input,
-    };
-}
-export function createFakeNasHost(options = {}) {
-    const dsmOrigin = options.dsmOrigin ?? "http://nas.example:5000";
-    const installationId = options.installationId ?? "fake-installation";
-    const curated = new Set(options.curated ?? []);
-    const installs = [];
-    const localAttestations = new Map();
-    const installed = new Set();
-    const openUrls = new Map();
-    const shares = { ...(options.shares ?? {}) };
-    const shareNames = options.shareNames
-        ? [...options.shareNames]
-        : Object.keys(shares).length > 0
-            ? Object.keys(shares)
-            : ["docker", "home", "photo"];
-    const installedEnv = Object.fromEntries(Object.entries(options.installedEnv ?? {}).map(([packageId, env]) => [packageId, { ...env }]));
-    const host = {
-        dsmOrigin,
-        installationId,
-        installs,
-        attestations: new Set(),
-        markCurated(packageIdentity) {
-            curated.add(packageIdentity);
-            localAttestations.set(packageIdentity, "app-package");
-        },
-        seedInstalled(packageIdentity) {
-            installed.add(packageIdentity);
-        },
-        async resolveSharePath(logicalName) {
-            return shares[logicalName];
-        },
-        async listShareNames() {
-            return [...shareNames];
-        },
-        ...(options.sharePermissions
-            ? {
-                async listSharePermissions(logicalName) {
-                    const listing = options.sharePermissions?.[logicalName];
-                    if (!listing) {
-                        return undefined;
-                    }
-                    return {
-                        users: listing.users.map(sharePermissionRow),
-                        groups: listing.groups.map(sharePermissionRow),
-                    };
-                },
-            }
-            : {}),
-        ...(options.userGroups
-            ? {
-                async listUserGroups(userName) {
-                    return options.userGroups?.[userName];
-                },
-            }
-            : {}),
-        async resolveHomesPath() {
-            return options.homesPath;
-        },
-        async getInstalledProjectEnv(packageIdentity) {
-            const env = installedEnv[packageIdentity];
-            return env ? { ...env } : undefined;
-        },
-        attestationInfo(packageIdentity) {
-            const kind = localAttestations.get(packageIdentity) ?? (installed.has(packageIdentity) ? "local" : "none");
-            return kind === "none" ? undefined : { attestationKind: kind };
-        },
-        async requestAttestation(input) {
-            if (curated.has(input.packageIdentity) && !input.allowCuratedDowngrade) {
-                const error = new Error("Curated deploy refused");
-                error.code = "CURATED_DEPLOY_REFUSED";
-                throw error;
-            }
-            if (curated.has(input.packageIdentity) && input.allowCuratedDowngrade) {
-                localAttestations.set(input.packageIdentity, "local");
-            }
-            else {
-                localAttestations.set(input.packageIdentity, "local");
-            }
-            const digest = `${input.packageIdentity}:${input.bundleDigest}:${input.contractDigest}`;
-            host.attestations.add(input.packageIdentity);
-            return {
-                kind: "local",
-                attestationDigest: digest,
-                token: `fake-local-attestation.${input.packageIdentity}`,
-            };
-        },
-        async ensurePackageSource() { },
-        async installFromCatalog(input) {
-            installs.push({
-                packageId: input.packageId,
-                version: input.version,
-                source: "package-center",
-                extraValues: { ...(input.extraValues ?? {}) },
-            });
-            installed.add(input.packageId);
-            installedEnv[input.packageId] = {
-                ...(installedEnv[input.packageId] ?? {}),
-                ...(input.extraValues ?? {}),
-            };
-            openUrls.set(input.packageId, `${new URL(dsmOrigin).protocol}//${new URL(dsmOrigin).hostname}/${webStationAlias(input.packageId)}/`);
-            if (!localAttestations.has(input.packageId)) {
-                localAttestations.set(input.packageId, "local");
-            }
-        },
-        async installFromLocalSpk(input) {
-            installs.push({
-                packageId: input.packageId,
-                version: input.version,
-                source: "local-spk",
-                extraValues: { ...(input.extraValues ?? {}) },
-            });
-            installed.add(input.packageId);
-            installedEnv[input.packageId] = {
-                ...(installedEnv[input.packageId] ?? {}),
-                ...(input.extraValues ?? {}),
-            };
-            openUrls.set(input.packageId, `${new URL(dsmOrigin).protocol}//${new URL(dsmOrigin).hostname}/${webStationAlias(input.packageId)}/`);
-            if (!localAttestations.has(input.packageId)) {
-                localAttestations.set(input.packageId, "local");
-            }
-        },
-        async getInstalledPackageVersion(packageIdentity) {
-            const latest = [...installs].reverse().find((entry) => entry.packageId === packageIdentity);
-            return latest?.version;
-        },
-        async getAttestationInfo(packageIdentity) {
-            return {
-                packageIdentity,
-                attestationKind: localAttestations.get(packageIdentity) ?? (installed.has(packageIdentity) ? "local" : "none"),
-                developmentInstance: packageIdentity.endsWith(".dev"),
-                openUrl: openUrls.get(packageIdentity),
-                readiness: installed.has(packageIdentity) ? "RUNNING" : "NOT_INSTALLED",
-            };
-        },
-        async isPackageInstalled(packageIdentity) {
-            return installed.has(packageIdentity);
-        },
-        async fetchContainerLogs(packageIdentity) {
-            if (!installed.has(packageIdentity)) {
-                return [];
-            }
-            return [`[${packageIdentity}] container ready`];
-        },
-        async getDsmDiagnostics() {
-            return options.diagnostics;
-        },
-        async getOidcCompatSettings() {
-            if (!options.oidcCompat) {
-                return undefined;
-            }
-            return {
-                enabled: options.oidcCompat.enabled,
-                origin: { ...options.oidcCompat.origin },
-            };
-        },
-        async smokeRequireLogin() {
-            return { ok: true, username: "admin" };
-        },
-    };
-    for (const packageId of curated) {
-        localAttestations.set(packageId, "app-package");
-    }
-    return host;
-}

package/dist/mock-broker/bootstrap.d.ts

@@ -1,2 +0,0 @@
-import type { BrokerBootstrap } from "@synopackageland/dev-sdk/node";
-export declare function writeMockBrokerBootstrap(projectRoot: string, bootstrap: BrokerBootstrap): string;

package/dist/mock-broker/bootstrap.js

@@ -1,8 +0,0 @@
-import { mkdirSync, writeFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-export function writeMockBrokerBootstrap(projectRoot, bootstrap) {
-    const path = resolve(projectRoot, ".synopkgland", "mock-broker.json");
-    mkdirSync(dirname(path), { recursive: true });
-    writeFileSync(path, `${JSON.stringify(bootstrap, null, 2)}\n`, "utf8");
-    return path;
-}

package/dist/mock-broker/files.d.ts

@@ -1,60 +0,0 @@
-import { createReadStream } from "node:fs";
-export interface FileItem {
-    name: string;
-    type: "file" | "directory";
-    path: string;
-    size?: number;
-}
-export declare class FileStoreError extends Error {
-    readonly code: string;
-    readonly status: number;
-    constructor(code: string, status: number, message: string);
-}
-export interface MockFileStoreOptions {
-    filesRoot?: string;
-    recycleBinDisabled?: boolean;
-}
-export interface DownloadResult {
-    buffer?: Buffer;
-    stream?: ReturnType<typeof createReadStream>;
-    size: number;
-    totalSize: number;
-}
-export declare class MockFileStore {
-    private readonly filesRoot?;
-    private readonly recycleBinDisabled;
-    private readonly treeRoot;
-    constructor(options?: MockFileStoreOptions);
-    list(rawPath: string): FileItem[];
-    stat(rawPath: string): FileItem;
-    download(rawPath: string, range?: {
-        start: number;
-        end?: number;
-    }): DownloadResult;
-    upload(rawPath: string, body: Buffer, overwrite?: boolean): void;
-    mkdir(rawPath: string): void;
-    rename(rawPath: string, rawTo: string, overwrite?: boolean): void;
-    move(rawPath: string, rawTo: string, overwrite?: boolean): void;
-    copy(rawPath: string, rawTo: string, overwrite?: boolean): void;
-    trash(rawPath: string): void;
-    private resolveListPath;
-    private resolveOperationPath;
-    private listMemory;
-    private statMemory;
-    private downloadMemory;
-    private uploadMemory;
-    private mkdirMemory;
-    private moveMemory;
-    private copyMemory;
-    private trashMemory;
-    private listMapped;
-    private statMapped;
-    private downloadMapped;
-    private uploadMapped;
-    private mkdirMapped;
-    private moveMapped;
-    private copyMapped;
-    private trashMapped;
-}
-/** @deprecated Use MockFileStore.list instead */
-export declare function listFakeFiles(path: string, filesRoot?: string): FileItem[];