@wasmsoft/fantastic 1.0.0

package/dist/packaging/install.d.ts

@@ -0,0 +1,154 @@
+import type { BundleManifest } from "../contracts/core.js";
+export interface InstallCheck {
+    name: string;
+    ok: boolean;
+    detail: string;
+    remedy?: string;
+}
+export interface InstallSource {
+    /** مجلد حزمة مفكوك، أو أرشيف ‎.zip‎. */
+    path: string;
+    isArchive: boolean;
+}
+export declare function classifySource(path: string): InstallSource;
+/** يقرأ البيان من أرشيف بلا فكّه — نحتاجه للتحقّق من المنصّة قبل أي كتابة. */
+export declare function manifestFromArchive(file: string): Promise<BundleManifest | undefined>;
+/**
+ * AR: منفذ تحتاجه خدمة، وهل هو حرّ. **قائمة لا رقمًا واحدًا**: الجهاز خدمتان، وفحص منفذ النواة وحده
+ *     كان يمرّر تثبيتًا يفشل بعد الهجرات عند تشغيل خدمة البثّ — أي بعد الكتابة، فيتراجع كل شيء
+ *     برسالة «الخدمات لم تبدأ» لا تسمّي المنفذ المتعارض. الفحص قبل الكتابة يجب أن يشمل ما يُحتاج
+ *     فعلًا، لا أشهره.
+ * EN: A port a service needs, and whether it is free. **A list, not a single number**: the appliance
+ *     has two services, and checking the core's port alone let an install proceed that then failed
+ *     after the migrations, when the live service started — that is, after writing, so everything
+ *     rolled back under a "the services did not start" message that named no port. A pre-write check
+ *     must cover what is actually needed, not what is best known.
+ */
+export interface RequiredPort {
+    label: string;
+    port: number;
+    free: boolean;
+    /** العَلَم الذي يغيّر هذا المنفذ. يُذكَر في العلاج فيعرف القارئ ماذا يكتب لا أن «يحرّر منفذًا». */
+    flag: string;
+}
+export interface PreInstallInput {
+    source: InstallSource;
+    root: string;
+    ports: RequiredPort[];
+    /** هل تعمل هذه العملية بصلاحيات مسؤول؟ يقرّر إن كان ‎PATH‎ سيُسجَّل أصلًا. */
+    elevated: boolean;
+    expectedSha256?: string;
+}
+/**
+ * AR: هل نملك صلاحيات المسؤول؟ الدليل عمليّ لا نظريّ: نحاول فتح مفتاح سِجل لا يُفتَح للكتابة إلّا
+ *     بها. سؤال ويندوز عن «الدور» يكذب تحت UAC، والمحاولة تصدق.
+ * EN: Do we hold administrator rights? The evidence is practical rather than declared: we try to open
+ *     a registry key that only opens for writing with them. Asking Windows about the "role" lies under
+ *     UAC; attempting the thing tells the truth.
+ */
+export declare function hasAdminRights(): Promise<boolean>;
+/**
+ * الفحوص قبل الكتابة. تُعيد قائمة، والأمر يرفض إن كان فيها فشل واحد.
+ */
+export declare function preInstallChecks(input: PreInstallInput): Promise<InstallCheck[]>;
+/** يفكّ أرشيف حزمة إلى الجذر، رافضًا أي مدخل يخرج منه. */
+export declare function extractBundle(archive: string, root: string): Promise<number>;
+/**
+ * AR: ينسخ مجلد حزمة مفكوك، **مُكوِّنًا مُكوِّنًا لا شجرةً واحدة**، و‎data/‎ لا يُنسَخ إطلاقًا.
+ *
+ *     كان هذا نداءً واحدًا على الجذر كلّه. وقد فشل فشلًا صامتًا حين تكون الوجهة تحوي ‎data/‎ عامرًا:
+ *     العملية تموت بلا استثناء يُلتقَط وبلا سطر في السجلّ، ولا يُنسَخ بايت — بينما النسخ إلى مجلد
+ *     فارغ ينجح، والنسخ مُكوِّنًا مُكوِّنًا إلى الوجهة **نفسها** ينجح. (قِيس على ويندوز أثناء ٠١٨؛
+ *     السبب الجذري لم يُحسَم — عملية النسخ الضخمة قد تكون أوقفها دفاعٌ على الجهاز — لكن الشكل الذي
+ *     يعمل معلوم ومُثبَت.)
+ *
+ *     وللشكل الجديد فائدتان تتجاوزان تفادي العطب:
+ *     ١ — **‎data/‎ يُستثنى صراحةً** بدل الاتّكال على أن دمج مجلد فارغ فوق مكتبة العميل غير مؤذٍ.
+ *         القاعدة الرابعة تصير سطرًا في الشيفرة لا نتيجةً عرَضية.
+ *     ٢ — الفشل يُنسَب إلى مكوّنه، فيقول الخطأ **أيّ** جزء تعذّر بدل «تعذّر النسخ».
+ * EN: Copies an extracted bundle directory, **component by component rather than as one tree**, and
+ *     `data/` is never copied at all.
+ *
+ *     This used to be a single call on the whole root. It failed silently when the destination held a
+ *     populated `data/`: the process died with no catchable exception and no log line, and not one
+ *     byte was copied — while copying into an empty directory succeeded, and copying component by
+ *     component into the **same** destination succeeded. (Measured on Windows during 018; the root
+ *     cause is unresolved — a security product may have stopped the bulk write — but the shape that
+ *     works is known and proven.)
+ *
+ *     The new shape earns two things beyond avoiding the fault:
+ *     1 — **`data/` is excluded explicitly** rather than relying on merging an empty directory over a
+ *         customer's library being harmless. Rule IV becomes a line of code, not an incidental
+ *         outcome.
+ *     2 — A failure names its component, so the error says **which** part could not be copied instead
+ *         of "the copy failed".
+ */
+export declare function copyBundle(source: string, root: string): void;
+/**
+ * AR: ما الذي ينقص شجرةً كي تُعدّ حزمةً مكتملة؟ **سؤال المُثبِّت، فانتقل معه** (٠٢٦).
+ *
+ *     كانت هذه القائمة في خطّ الإنتاج (‎packaging/pipeline.ts‎) لأن الباني كان يقرأها ليتحقّق ممّا
+ *     أنتج. وقد افترق المستودعان: الباني في مستودع المنتج، والمُثبِّت هنا. وموضعها الصحيح **حيث
+ *     يُقرأ الجواب لا حيث يُكتب**: الحزمة تُبنى مرّةً وتُقرأ على أجهزةٍ كثيرة لسنوات.
+ *
+ *     وتُفحَص بعد الفكّ وقبل تشغيل أيّ خدمة، فأرشيفٌ وصل ناقصًا يُوقف التثبيت ويُتراجَع عنه بدل
+ *     أن يُنتج جهازًا نصف مركَّب يفشل عند أول مشاهد.
+ * EN: What must a tree contain before it counts as a complete bundle? **The installer's question, so
+ *     it travelled with the installer** (026).
+ *
+ *     This list used to live in the production pipeline (`packaging/pipeline.ts`), because the
+ *     builder read it to verify what it had produced. The repositories have since separated: the
+ *     builder lives in the product repository and the installer here. Its right home is **where the
+ *     answer is read, not where it is written**: a bundle is built once and read on many machines
+ *     for years.
+ *
+ *     It runs after extraction and before any service starts, so an archive that arrived incomplete
+ *     stops the install and is rolled back, rather than producing a half-assembled appliance that
+ *     fails in front of the first viewer.
+ */
+export declare function verifyInstalled(root: string): string[];
+/**
+ * التراجع: يزيل ما كُتب ويترك ‎data/‎ كما كان.
+ *
+ * يُستدعى عند أي فشل **قبل** بدء الخدمات، فتعود الآلة إلى حالتها السابقة بدل أن تبقى نصف مثبَّتة.
+ */
+/**
+ * AR: **التراجع لا يُفشِل نفسه، ولا يحجب سبب الفشل الذي استدعاه.**
+ *
+ *     كان يرمي عند أوّل ملفّ متعذّر، وهو يجري داخل ‎catch‎ الأصلي — فيحلّ خطؤه محلّ الخطأ الحقيقي:
+ *     يقرأ الفنّي «‎EBUSY … fantastic.db‎» ولا يعرف شيئًا عمّا فشل أصلًا. والأسوأ أن الحلقة تتوقّف
+ *     عند ذلك الملفّ، فتبقى الشجرة **نصف محذوفة**: بعض المكوّنات ذهب وبعضها بقي — وهي الحالة التي
+ *     وُجد التراجع ليمنعها.
+ *     وسبب ‎EBUSY‎ معروف ومتوقَّع: عملية بدأت للتوّ ثم تعثّر إقلاعها ما تزال تمسك قاعدة البيانات
+ *     لحظاتٍ بعد قتلها. إعادة المحاولة تكفي، وما يبقى متعذّرًا يُبلَّغ عنه ولا يُخفى.
+ * EN: **The rollback neither fails itself nor hides the failure that summoned it.**
+ *
+ *     It used to throw on the first stubborn file, and it runs inside the original `catch` — so its
+ *     error replaced the real one: the technician reads "EBUSY … fantastic.db" and learns nothing
+ *     about what actually failed. Worse, the loop stopped at that file, leaving the tree **half
+ *     deleted**: some components gone, others left — precisely the state a rollback exists to prevent.
+ *     And the cause of that EBUSY is known and expected: a process that had just started and then
+ *     failed to come up still holds the database for a moment after being killed. Retrying is enough,
+ *     and whatever remains is reported rather than concealed.
+ */
+export declare function rollbackInstall(root: string, dataExistedBefore: boolean): string[];
+export interface RemovalPlan {
+    removed: string[];
+    kept: string[];
+}
+/** ما تُزيله الإزالة وما تُبقيه. ‎data/‎ يبقى ما لم يُطلَب حذفه صراحةً. */
+export declare function planRemoval(root: string, purge: boolean): RemovalPlan;
+/**
+ * AR: ينفّذ الخطة ويعيد ما تعذّر حذفه. **لا يتوقّف عند أول عثرة**: التوقّف يترك الشجرة نصف محذوفة —
+ *     الشيمة والواجهة ذهبتا والخدمات باقية — وهي حالة لا يستطيع الفنّي أن يصلحها بأمر، لأن الأمر
+ *     الذي يصلحها هو ما حُذف للتوّ. يُحذَف ما يمكن، ويُسمَّى ما بقي، فيبقى القرار بيد قارئٍ يعرف.
+ * EN: Applies the plan and returns whatever could not be deleted. **It does not stop at the first
+ *     stumble**: stopping leaves the tree half removed — the shim and the CLI gone, the services still
+ *     there — a state the technician cannot repair with a command, because the command that would
+ *     repair it is the one just deleted. What can go, goes; what remains is named, leaving the
+ *     decision with a reader who knows.
+ */
+export declare function applyRemoval(root: string, plan: RemovalPlan): string[];
+/** حجم شجرة للتقرير. */
+export declare function sizeOf(root: string): number;
+//# sourceMappingURL=install.d.ts.map

package/dist/packaging/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/packaging/install.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAsB3D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAE1D;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAuCrF;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,mGAAmG;IACnG,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAkBvD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAkGtF;AAED,0DAA0D;AAC1D,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA8ClF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAe7D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAUtD;AAED;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,GAAG,MAAM,EAAE,CAiBlF;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,CAYrE;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,EAAE,CAYtE;AAED,wBAAwB;AACxB,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW3C"}

package/dist/packaging/install.js

@@ -0,0 +1,381 @@
+import { createWriteStream, cpSync, existsSync, mkdirSync, readdirSync, rmSync, statSync } from "node:fs";
+import { dirname, join, normalize, resolve, sep } from "node:path";
+import { pipeline as streamPipeline } from "node:stream/promises";
+import { execa } from "execa";
+import yauzl from "yauzl";
+import { BUNDLE_DIRS, SUPERVISOR_ENTRY, MANIFEST_FILE, RUNTIME_FILES } from "./layout.js";
+import { hashFile, readManifest } from "./manifest.js";
+export function classifySource(path) {
+    return { path, isArchive: path.toLowerCase().endsWith(".zip") };
+}
+/** يقرأ البيان من أرشيف بلا فكّه — نحتاجه للتحقّق من المنصّة قبل أي كتابة. */
+export function manifestFromArchive(file) {
+    return new Promise((resolvePromise, rejectPromise) => {
+        yauzl.open(file, { lazyEntries: true }, (error, zip) => {
+            if (error || !zip)
+                return rejectPromise(error ?? new Error("the archive could not be opened"));
+            const wanted = MANIFEST_FILE.replace(/\\/g, "/");
+            let found = false;
+            zip.on("entry", (entry) => {
+                if (entry.fileName !== wanted) {
+                    zip.readEntry();
+                    return;
+                }
+                found = true;
+                zip.openReadStream(entry, (streamError, stream) => {
+                    if (streamError || !stream)
+                        return rejectPromise(streamError ?? new Error("unreadable manifest"));
+                    const chunks = [];
+                    stream.on("data", (chunk) => chunks.push(chunk));
+                    stream.on("end", () => {
+                        try {
+                            resolvePromise(JSON.parse(Buffer.concat(chunks).toString("utf8")));
+                        }
+                        catch {
+                            resolvePromise(undefined);
+                        }
+                        zip.close();
+                    });
+                    stream.on("error", rejectPromise);
+                });
+            });
+            zip.on("end", () => {
+                if (!found)
+                    resolvePromise(undefined);
+            });
+            zip.on("error", rejectPromise);
+            zip.readEntry();
+        });
+    });
+}
+/**
+ * AR: هل نملك صلاحيات المسؤول؟ الدليل عمليّ لا نظريّ: نحاول فتح مفتاح سِجل لا يُفتَح للكتابة إلّا
+ *     بها. سؤال ويندوز عن «الدور» يكذب تحت UAC، والمحاولة تصدق.
+ * EN: Do we hold administrator rights? The evidence is practical rather than declared: we try to open
+ *     a registry key that only opens for writing with them. Asking Windows about the "role" lies under
+ *     UAC; attempting the thing tells the truth.
+ */
+export async function hasAdminRights() {
+    if (process.platform !== "win32")
+        return true;
+    try {
+        await execa("powershell.exe", [
+            "-NoProfile",
+            "-NonInteractive",
+            "-Command",
+            "try { [void][Microsoft.Win32.Registry]::LocalMachine.OpenSubKey('SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment', $true); exit 0 } catch { exit 1 }",
+        ], { timeout: 15_000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * الفحوص قبل الكتابة. تُعيد قائمة، والأمر يرفض إن كان فيها فشل واحد.
+ */
+export async function preInstallChecks(input) {
+    const checks = [];
+    // ١ — المصدر موجود.
+    if (!existsSync(input.source.path)) {
+        checks.push({
+            name: "Source",
+            ok: false,
+            detail: `not found: ${input.source.path}`,
+            remedy: "Check the path passed to --from.",
+        });
+        return checks;
+    }
+    checks.push({ name: "Source", ok: true, detail: input.source.isArchive ? "archive" : "directory" });
+    // ٢ — البصمة إن أُعطيت. تكشف تلف النقل، ولا تثبت الأصالة (لا توقيع بعد).
+    if (input.source.isArchive && input.expectedSha256) {
+        const actual = hashFile(input.source.path);
+        const matches = actual === input.expectedSha256;
+        checks.push({
+            name: "Archive fingerprint",
+            ok: matches,
+            detail: matches ? "matches" : "does not match",
+            remedy: matches ? undefined : "The archive was damaged in transfer. Copy it again.",
+        });
+    }
+    // ٣ — البيان والمنصّة. عدم التطابق **يرفض** ولا يحذّر: حزمة لمنصّة أخرى لن تعمل أبدًا.
+    const manifest = input.source.isArchive
+        ? await manifestFromArchive(input.source.path)
+        : readManifest(input.source.path);
+    if (!manifest) {
+        checks.push({
+            name: "Bundle manifest",
+            ok: false,
+            detail: "missing or unreadable",
+            remedy: "This is not a Fantastic bundle, or it was produced by an older CLI.",
+        });
+    }
+    else {
+        const platformOk = manifest.bundle.platform === "win32-x64";
+        checks.push({
+            name: "Platform",
+            ok: platformOk,
+            detail: manifest.bundle.platform,
+            remedy: platformOk ? undefined : "This bundle targets another platform. Build one for win32-x64.",
+        });
+        if (manifest.bundle.unverified) {
+            checks.push({
+                name: "Verification",
+                ok: false,
+                detail: "this bundle was produced with --skip-smoke and never booted",
+                remedy: "Rebuild without --skip-smoke. An unverified bundle must not reach a customer.",
+            });
+        }
+    }
+    // ٤ — لا تثبيت سابق. الترقية في المكان هي ميزة التحديثات المؤجَّلة، لا هذه.
+    const installed = existsSync(join(input.root, BUNDLE_DIRS.core, "main.js"));
+    checks.push({
+        name: "Prior installation",
+        ok: !installed,
+        detail: installed ? `already installed at ${input.root}` : "none",
+        remedy: installed
+            ? "Remove it first (fantastic uninstall keeps data/ by default), or install to another --root."
+            : undefined,
+    });
+    // AR: ٥ — الصلاحيات. **يُعلَن قبل الكتابة لا بعدها.** التثبيت بلا صلاحيات مسؤول ينجح في كل شيء
+    //     إلّا تسجيل ‎PATH‎، فينتهي بنظام يعمل وأمرٍ لا يعرفه ويندوز — والفنّي لا يملك ما يربط بينهما.
+    //     وهو **ليس فشلًا حاجبًا**: النظام يعمل بمساره الكامل، وإجبار المسؤول على كل تثبيت ثمنٌ أكبر
+    //     من فائدته. فيُقال هنا صراحةً ليَعرف قبل أن يبدأ.
+    // EN: 5 — rights. **Stated before writing, not after.** An install without administrator rights
+    //     succeeds at everything except registering PATH, ending with a working system and a command
+    //     Windows does not know — and the technician has nothing connecting the two. It is **not
+    //     blocking**: the system runs by its full path, and forcing an elevated prompt on every install
+    //     costs more than it earns. So it is said here, plainly, before anything begins.
+    checks.push({
+        name: "Administrator",
+        ok: true,
+        detail: input.elevated ? "yes · PATH will be registered" : "no · the `fantastic` command will need its full path",
+        remedy: input.elevated
+            ? undefined
+            : "Run install.cmd from a terminal opened as administrator if you want the bare `fantastic` command to work.",
+    });
+    // ٦ — المنافذ، كلّها. العلاج يسمّي العَلَم الذي يغيّر هذا المنفذ بعينه لا علمًا عامًّا.
+    for (const required of input.ports) {
+        checks.push({
+            name: `Port ${required.port}`,
+            ok: required.free,
+            detail: required.free ? `free · ${required.label}` : `in use · needed by ${required.label}`,
+            remedy: required.free ? undefined : `Free it, or install with ${required.flag} <other>.`,
+        });
+    }
+    return checks;
+}
+/** يفكّ أرشيف حزمة إلى الجذر، رافضًا أي مدخل يخرج منه. */
+export async function extractBundle(archive, root) {
+    const zip = await new Promise((resolvePromise, rejectPromise) => {
+        yauzl.open(archive, { lazyEntries: true, autoClose: false }, (error, handle) => {
+            if (error || !handle)
+                rejectPromise(error ?? new Error("the archive could not be opened"));
+            else
+                resolvePromise(handle);
+        });
+    });
+    let written = 0;
+    const rootResolved = resolve(root);
+    await new Promise((resolvePromise, rejectPromise) => {
+        zip.on("entry", (entry) => {
+            if (entry.fileName.endsWith("/")) {
+                zip.readEntry();
+                return;
+            }
+            const target = resolve(root, entry.fileName);
+            // نفس فحص الهروب في الاستعادة، وللسبب نفسه: اسمٌ داخل أرشيف يصير مسارًا على القرص هنا.
+            if (target !== rootResolved && !normalize(target).startsWith(rootResolved + sep)) {
+                zip.readEntry();
+                return;
+            }
+            zip.openReadStream(entry, (error, stream) => {
+                if (error || !stream)
+                    return rejectPromise(error ?? new Error(`unreadable: ${entry.fileName}`));
+                mkdirSync(dirname(target), { recursive: true });
+                streamPipeline(stream, createWriteStream(target))
+                    .then(() => {
+                    written += 1;
+                    zip.readEntry();
+                })
+                    .catch(rejectPromise);
+            });
+        });
+        zip.on("end", () => resolvePromise());
+        zip.on("error", rejectPromise);
+        zip.readEntry();
+    });
+    zip.close();
+    return written;
+}
+/**
+ * AR: ينسخ مجلد حزمة مفكوك، **مُكوِّنًا مُكوِّنًا لا شجرةً واحدة**، و‎data/‎ لا يُنسَخ إطلاقًا.
+ *
+ *     كان هذا نداءً واحدًا على الجذر كلّه. وقد فشل فشلًا صامتًا حين تكون الوجهة تحوي ‎data/‎ عامرًا:
+ *     العملية تموت بلا استثناء يُلتقَط وبلا سطر في السجلّ، ولا يُنسَخ بايت — بينما النسخ إلى مجلد
+ *     فارغ ينجح، والنسخ مُكوِّنًا مُكوِّنًا إلى الوجهة **نفسها** ينجح. (قِيس على ويندوز أثناء ٠١٨؛
+ *     السبب الجذري لم يُحسَم — عملية النسخ الضخمة قد تكون أوقفها دفاعٌ على الجهاز — لكن الشكل الذي
+ *     يعمل معلوم ومُثبَت.)
+ *
+ *     وللشكل الجديد فائدتان تتجاوزان تفادي العطب:
+ *     ١ — **‎data/‎ يُستثنى صراحةً** بدل الاتّكال على أن دمج مجلد فارغ فوق مكتبة العميل غير مؤذٍ.
+ *         القاعدة الرابعة تصير سطرًا في الشيفرة لا نتيجةً عرَضية.
+ *     ٢ — الفشل يُنسَب إلى مكوّنه، فيقول الخطأ **أيّ** جزء تعذّر بدل «تعذّر النسخ».
+ * EN: Copies an extracted bundle directory, **component by component rather than as one tree**, and
+ *     `data/` is never copied at all.
+ *
+ *     This used to be a single call on the whole root. It failed silently when the destination held a
+ *     populated `data/`: the process died with no catchable exception and no log line, and not one
+ *     byte was copied — while copying into an empty directory succeeded, and copying component by
+ *     component into the **same** destination succeeded. (Measured on Windows during 018; the root
+ *     cause is unresolved — a security product may have stopped the bulk write — but the shape that
+ *     works is known and proven.)
+ *
+ *     The new shape earns two things beyond avoiding the fault:
+ *     1 — **`data/` is excluded explicitly** rather than relying on merging an empty directory over a
+ *         customer's library being harmless. Rule IV becomes a line of code, not an incidental
+ *         outcome.
+ *     2 — A failure names its component, so the error says **which** part could not be copied instead
+ *         of "the copy failed".
+ */
+export function copyBundle(source, root) {
+    mkdirSync(root, { recursive: true });
+    for (const entry of readdirSync(source)) {
+        if (entry === BUNDLE_DIRS.data)
+            continue;
+        try {
+            cpSync(join(source, entry), join(root, entry), { recursive: true, dereference: true });
+        }
+        catch (error) {
+            throw new Error(`could not copy ${entry}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // مجلد بيانات فارغ لأوّل تثبيت، وبلا مساس بما وُجد: ‎mkdir‎ على قائم لا يفعل شيئًا.
+    mkdirSync(join(root, BUNDLE_DIRS.data), { recursive: true });
+}
+/**
+ * AR: ما الذي ينقص شجرةً كي تُعدّ حزمةً مكتملة؟ **سؤال المُثبِّت، فانتقل معه** (٠٢٦).
+ *
+ *     كانت هذه القائمة في خطّ الإنتاج (‎packaging/pipeline.ts‎) لأن الباني كان يقرأها ليتحقّق ممّا
+ *     أنتج. وقد افترق المستودعان: الباني في مستودع المنتج، والمُثبِّت هنا. وموضعها الصحيح **حيث
+ *     يُقرأ الجواب لا حيث يُكتب**: الحزمة تُبنى مرّةً وتُقرأ على أجهزةٍ كثيرة لسنوات.
+ *
+ *     وتُفحَص بعد الفكّ وقبل تشغيل أيّ خدمة، فأرشيفٌ وصل ناقصًا يُوقف التثبيت ويُتراجَع عنه بدل
+ *     أن يُنتج جهازًا نصف مركَّب يفشل عند أول مشاهد.
+ * EN: What must a tree contain before it counts as a complete bundle? **The installer's question, so
+ *     it travelled with the installer** (026).
+ *
+ *     This list used to live in the production pipeline (`packaging/pipeline.ts`), because the
+ *     builder read it to verify what it had produced. The repositories have since separated: the
+ *     builder lives in the product repository and the installer here. Its right home is **where the
+ *     answer is read, not where it is written**: a bundle is built once and read on many machines
+ *     for years.
+ *
+ *     It runs after extraction and before any service starts, so an archive that arrived incomplete
+ *     stops the install and is rolled back, rather than producing a half-assembled appliance that
+ *     fails in front of the first viewer.
+ */
+export function verifyInstalled(root) {
+    const required = [
+        join(BUNDLE_DIRS.runtime, RUNTIME_FILES.node),
+        join(BUNDLE_DIRS.core, "main.js"),
+        join(BUNDLE_DIRS.live, "main.js"),
+        join(BUNDLE_DIRS.interfaceClient, "index.html"),
+        SUPERVISOR_ENTRY,
+    ];
+    return required.filter((relative) => !existsSync(join(root, relative)));
+}
+/**
+ * التراجع: يزيل ما كُتب ويترك ‎data/‎ كما كان.
+ *
+ * يُستدعى عند أي فشل **قبل** بدء الخدمات، فتعود الآلة إلى حالتها السابقة بدل أن تبقى نصف مثبَّتة.
+ */
+/**
+ * AR: **التراجع لا يُفشِل نفسه، ولا يحجب سبب الفشل الذي استدعاه.**
+ *
+ *     كان يرمي عند أوّل ملفّ متعذّر، وهو يجري داخل ‎catch‎ الأصلي — فيحلّ خطؤه محلّ الخطأ الحقيقي:
+ *     يقرأ الفنّي «‎EBUSY … fantastic.db‎» ولا يعرف شيئًا عمّا فشل أصلًا. والأسوأ أن الحلقة تتوقّف
+ *     عند ذلك الملفّ، فتبقى الشجرة **نصف محذوفة**: بعض المكوّنات ذهب وبعضها بقي — وهي الحالة التي
+ *     وُجد التراجع ليمنعها.
+ *     وسبب ‎EBUSY‎ معروف ومتوقَّع: عملية بدأت للتوّ ثم تعثّر إقلاعها ما تزال تمسك قاعدة البيانات
+ *     لحظاتٍ بعد قتلها. إعادة المحاولة تكفي، وما يبقى متعذّرًا يُبلَّغ عنه ولا يُخفى.
+ * EN: **The rollback neither fails itself nor hides the failure that summoned it.**
+ *
+ *     It used to throw on the first stubborn file, and it runs inside the original `catch` — so its
+ *     error replaced the real one: the technician reads "EBUSY … fantastic.db" and learns nothing
+ *     about what actually failed. Worse, the loop stopped at that file, leaving the tree **half
+ *     deleted**: some components gone, others left — precisely the state a rollback exists to prevent.
+ *     And the cause of that EBUSY is known and expected: a process that had just started and then
+ *     failed to come up still holds the database for a moment after being killed. Retrying is enough,
+ *     and whatever remains is reported rather than concealed.
+ */
+export function rollbackInstall(root, dataExistedBefore) {
+    if (!existsSync(root))
+        return [];
+    const stubborn = [];
+    for (const entry of readdirSync(root)) {
+        // بيانات العميل لا تُحذف في التراجع إن كانت موجودة قبله.
+        if (entry === BUNDLE_DIRS.data && dataExistedBefore)
+            continue;
+        try {
+            rmSync(join(root, entry), { recursive: true, force: true, maxRetries: 5, retryDelay: 300 });
+        }
+        catch {
+            stubborn.push(entry);
+        }
+    }
+    return stubborn;
+}
+/** ما تُزيله الإزالة وما تُبقيه. ‎data/‎ يبقى ما لم يُطلَب حذفه صراحةً. */
+export function planRemoval(root, purge) {
+    const removed = [];
+    const kept = [];
+    if (!existsSync(root))
+        return { removed, kept };
+    for (const entry of readdirSync(root)) {
+        if (entry === BUNDLE_DIRS.data && !purge)
+            kept.push(entry);
+        else
+            removed.push(entry);
+    }
+    return { removed, kept };
+}
+/**
+ * AR: ينفّذ الخطة ويعيد ما تعذّر حذفه. **لا يتوقّف عند أول عثرة**: التوقّف يترك الشجرة نصف محذوفة —
+ *     الشيمة والواجهة ذهبتا والخدمات باقية — وهي حالة لا يستطيع الفنّي أن يصلحها بأمر، لأن الأمر
+ *     الذي يصلحها هو ما حُذف للتوّ. يُحذَف ما يمكن، ويُسمَّى ما بقي، فيبقى القرار بيد قارئٍ يعرف.
+ * EN: Applies the plan and returns whatever could not be deleted. **It does not stop at the first
+ *     stumble**: stopping leaves the tree half removed — the shim and the CLI gone, the services still
+ *     there — a state the technician cannot repair with a command, because the command that would
+ *     repair it is the one just deleted. What can go, goes; what remains is named, leaving the
+ *     decision with a reader who knows.
+ */
+export function applyRemoval(root, plan) {
+    const stubborn = [];
+    for (const entry of plan.removed) {
+        try {
+            rmSync(join(root, entry), { recursive: true, force: true, maxRetries: 5, retryDelay: 300 });
+        }
+        catch {
+            stubborn.push(entry);
+        }
+    }
+    return stubborn;
+}
+/** حجم شجرة للتقرير. */
+export function sizeOf(root) {
+    let bytes = 0;
+    const walk = (dir) => {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            const full = join(dir, entry.name);
+            if (entry.isDirectory())
+                walk(full);
+            else if (entry.isFile())
+                bytes += statSync(full).size;
+        }
+    };
+    if (existsSync(root))
+        walk(root);
+    return bytes;
+}
+//# sourceMappingURL=install.js.map

package/dist/packaging/install.js.map

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