@wasmsoft/fantastic 1.0.0

package/dist/acquire/latest.js

@@ -0,0 +1,95 @@
+import { resolveCentralUrl } from "./central-url.js";
+// AR: «ما أحدث حزمةٍ لهذا المنتج، وما بصمتها؟» — السؤال الذي يسبق التنزيل (٠٢٦).
+//
+//     **والبصمة تُقرأ قبل البايتات لا معها.** هذا قرارٌ في المنصّة منذ سطح التثبيت الأوّل، وهو ما
+//     يجعل المطابقة ذات معنى: بصمةٌ تصل مع الملفّ الذي تصفه لا تُثبت شيئًا — من بدّل الملفّ يبدّل
+//     البصمة معه.
+//
+//     ولا JSON في هذا الردّ بل ‎key=value‎: قارئه الأصليّ سكربت ‎cmd‎ يقرؤه بـ‎for /f‎، وتحليل JSON
+//     هناك سطرٌ هشّ ينكسر أوّل ما يُضاف حقل. ونقرؤه نحن بنفس بساطته.
+// EN: "What is the newest bundle for this product, and what is its digest?" — the question that
+//     precedes the download (026).
+//
+//     **The digest is read before the bytes, not with them.** That is the centre's decision from the
+//     first-install surface onward, and it is what makes the comparison meaningful: a digest arriving
+//     alongside the file it describes proves nothing — whoever swapped the file swapped the digest
+//     with it.
+//
+//     And the reply is `key=value` rather than JSON: its original reader is a `cmd` script parsing it
+//     with `for /f`, where JSON is a brittle line that breaks the first time a field is added. We
+//     read it with the same simplicity.
+export const ACTIVATION_HEADER = "X-Activation-Code";
+export class CentralRefused extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = "CentralRefused";
+    }
+}
+/**
+ * AR: يحوّل ردّ المركز إلى رسالةٍ عربية تقول ما العمل. **الأكواد لا تُعرَض للفنّي**: ‎403‎ لا
+ *     تخبره بشيء، و«رخصتك منتهية، تواصل مع الدعم» تخبره بكل شيء.
+ * EN: Turns the centre's answer into an Arabic message that says what to do. **Codes are not shown
+ *     to the technician**: `403` tells them nothing, while "your licence has expired, contact
+ *     support" tells them everything.
+ */
+function explain(status, body) {
+    if (status === 404)
+        return "كود التفعيل غير صحيح، أو لا توجد حزمة منشورة لهذا المنتج.";
+    if (status === 403)
+        return "الرخصة غير نشطة أو منتهية، أو المنتج غير مشمولٍ بها. تواصل مع الدعم.";
+    if (status === 429)
+        return "محاولات كثيرة في وقتٍ قصير. انتظر دقيقة ثم أعِد المحاولة.";
+    if (status >= 500)
+        return "المنصّة المركزية لا تستجيب الآن. أعِد المحاولة بعد قليل.";
+    const trimmed = body.trim().slice(0, 200);
+    return trimmed.length > 0 ? trimmed : `ردٌّ غير متوقَّع من المنصّة (${status}).`;
+}
+function parsePairs(text) {
+    const pairs = {};
+    for (const line of text.split("\n")) {
+        const index = line.indexOf("=");
+        if (index <= 0)
+            continue;
+        pairs[line.slice(0, index).trim()] = line.slice(index + 1).trim();
+    }
+    return pairs;
+}
+export function releaseUrl(path, product, platform = "win-x64") {
+    const { url } = resolveCentralUrl();
+    return `${url}/api/v1/setup/${path}?platform=${encodeURIComponent(platform)}&product=${encodeURIComponent(product)}`;
+}
+/**
+ * AR: يسأل المركز عن أحدث حزمة. **لا يُستعمل عميل HTTP خارجيّ**: ‎fetch‎ مدمجٌ في Node ‏20،
+ *     والدستور يمنع عميلًا ثانيًا — وحزمةٌ إضافية هنا تُشحن إلى كل جهاز فنّيّ بلا مقابل.
+ * EN: Asks the centre for the newest bundle. **No external HTTP client is used**: `fetch` is built
+ *     into Node 20 and the constitution forbids a second client — and an extra package here ships to
+ *     every technician's machine for nothing.
+ */
+export async function fetchLatest(code, product, platform = "win-x64") {
+    const response = await fetch(releaseUrl("latest", product, platform), {
+        headers: { [ACTIVATION_HEADER]: code },
+    });
+    const text = await response.text();
+    if (!response.ok)
+        throw new CentralRefused(response.status, explain(response.status, text));
+    const pairs = parsePairs(text);
+    if (!pairs.version || !pairs.sha256) {
+        throw new CentralRefused(response.status, "ردّ المنصّة لا يحمل إصدارًا ولا بصمة — تواصل مع الدعم.");
+    }
+    return {
+        version: pairs.version,
+        sha256: pairs.sha256,
+        sizeBytes: Number.parseInt(pairs.size ?? "0", 10) || 0,
+        fileName: pairs.file ?? `Fantastic-${pairs.version}-${platform}.zip`,
+        // AR: حقلان أُضيفا في ٠٢٦ ويردّهما مركزٌ محدَّث وحده. وغيابهما ليس عطلًا: مركزٌ أقدم يخدم
+        //     منتجًا واحدًا ولا يشترط إصدار واجهة، وهو بالضبط ما كان قبل هذه الميزة.
+        // EN: Two fields added in 026 and returned only by an updated centre. Their absence is not a
+        //     fault: an older centre serves one product and requires no CLI version — precisely what was
+        //     true before this feature.
+        product: pairs.product ?? product,
+        minCliVersion: pairs.minCliVersion ?? "",
+    };
+}
+//# sourceMappingURL=latest.js.map

package/dist/acquire/latest.js.map

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

package/dist/backup/archive.d.ts

@@ -0,0 +1,26 @@
+import type { Profile } from "../profiles/types.js";
+export declare const ARCHIVE_VERSION = 1;
+export declare const SNAPSHOT_NAME = "fantastic.db";
+export interface BackupManifest {
+    archiveVersion: number;
+    createdAt: string;
+    profile: string;
+    /** إصدار النواة وقت النسخ، لتشخيص استعادة عبر إصدارات. */
+    coreVersion?: string;
+    /** عدد الهجرات المطبَّقة. الاستعادة إلى قاعدة أقدم تُرفَض عليه. */
+    schemaRevision: number;
+    includesLogs: boolean;
+}
+export interface BackupOptions {
+    outDir: string;
+    includeLogs?: boolean;
+    /** يُستدعى عند كل خطوة للعرض. */
+    onStep?: (message: string) => void;
+}
+export interface BackupResult {
+    file: string;
+    bytes: number;
+    manifest: BackupManifest;
+}
+export declare function createBackup(profile: Profile, options: BackupOptions): Promise<BackupResult>;
+//# sourceMappingURL=archive.d.ts.map

package/dist/backup/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/backup/archive.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAmCpD,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iCAAiC;IACjC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAyBD,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAgElG"}

package/dist/backup/archive.js

@@ -0,0 +1,123 @@
+import { createWriteStream, existsSync, mkdirSync, readdirSync, rmSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+import { ZipArchive } from "archiver";
+import { INTERNAL_PATHS } from "../probes/internal-paths.js";
+import { postInternal } from "../probes/internal.client.js";
+// AR: بناء أرشيف النسخ الاحتياطي.
+//
+//     **ما يدخل وما لا يدخل قرارٌ لا تفصيل.**
+//     يدخل: لقطة القاعدة (‎VACUUM INTO‎ من النواة)، وأصول لا تُولَّد ثانيةً — الشعار وشعارات القنوات
+//     وأغلفة المزوّدين — و‎provider-keys.key‎، ومِلفّ إعدادات الـ CLI.
+//     لا يدخل: **الوسائط أبدًا** (الدستور II: الأقراص هي مصدر الحقيقة، وأرشيفٌ ينسخها كذبةٌ عن قدرته
+//     على الاستعادة)، ولا المخابئ المُولَّدة (‎image-cache‎، ‎transcode-cache‎، ‎live-relay‎) لأنها
+//     تُبنى ثانيةً ولا شيء يضيع بغيابها.
+//
+//     ‎provider-keys.key‎ يدخل عمدًا وهو الأدقّ في القائمة: مفاتيح التكاملات مخزَّنة **مشفَّرة** في
+//     القاعدة، فأرشيفٌ يحمل القاعدة بلا المفتاح يُستعاد بمفاتيح لا تُفَكّ — نسخة تبدو كاملة وتفشل
+//     في أوّل مزامنة.
+// EN: Building the backup archive.
+//
+//     **What goes in and what stays out is a decision, not a detail.**
+//     In: the database snapshot (VACUUM INTO, performed by the core), assets that cannot be
+//     regenerated — the brand logo, channel logos, provider artwork — provider-keys.key, and the
+//     CLI's config file.
+//     Out: **media, never** (constitution II: the drives are the source of truth, and an archive
+//     that copies them lies about what it can restore), and generated caches (image-cache,
+//     transcode-cache, live-relay), which rebuild themselves and lose nothing.
+//
+//     provider-keys.key is included deliberately and is the subtlest item here: integration keys are
+//     stored **encrypted** in the database, so an archive carrying the database without the key
+//     restores to keys that cannot be decrypted — a backup that looks complete and fails at the
+//     first sync.
+/** مجلدات داخل ‎data/‎ تُولَّد ثانيةً، فلا معنى لتضخيم الأرشيف بها. */
+const REGENERABLE = new Set(["image-cache", "transcode-cache", "live-relay"]);
+/** ملفات القاعدة الحيّة. تُستبعَد لأن اللقطة تحلّ محلّها؛ نسخها حيّةً هو الخطأ الذي نتفاداه أصلًا. */
+const LIVE_DB_FILES = new Set(["fantastic.db", "fantastic.db-wal", "fantastic.db-shm"]);
+export const ARCHIVE_VERSION = 1;
+export const SNAPSHOT_NAME = "fantastic.db";
+function timestamp(date) {
+    const pad = (value) => String(value).padStart(2, "0");
+    return (`${date.getFullYear()}${pad(date.getMonth() + 1)}${pad(date.getDate())}` +
+        `-${pad(date.getHours())}${pad(date.getMinutes())}${pad(date.getSeconds())}`);
+}
+/** عدد ملفات الهجرة المطبَّقة، كتقريب لمراجعة المخطَّط. يُقرأ من القرص لا من القاعدة. */
+function schemaRevision(profile) {
+    const candidates = [
+        join(profile.root, "apps", "core", "dist", "db", "migrations"),
+        join(profile.root, "core", "db", "migrations"),
+    ];
+    for (const dir of candidates) {
+        if (!existsSync(dir))
+            continue;
+        return readdirSync(dir).filter((entry) => entry.endsWith(".sql")).length;
+    }
+    return 0;
+}
+export async function createBackup(profile, options) {
+    const { outDir, includeLogs = false, onStep } = options;
+    mkdirSync(outDir, { recursive: true });
+    const stamp = timestamp(new Date());
+    const file = join(outDir, `fantastic-backup-${stamp}.zip`);
+    const staging = join(outDir, `.staging-${stamp}`);
+    mkdirSync(staging, { recursive: true });
+    try {
+        // ١ — لقطة القاعدة من النواة. تفشل بوضوح إن كانت متوقّفة: نسخةٌ بلا قاعدة ليست نسخة.
+        onStep?.("asking the core for a consistent database snapshot…");
+        const snapshotPath = join(staging, SNAPSHOT_NAME);
+        const snapshot = await postInternal(profile, INTERNAL_PATHS.BACKUP_SNAPSHOT, {
+            destination: snapshotPath,
+        });
+        if (!snapshot.ok) {
+            throw new Error(`the core could not produce a database snapshot (${snapshot.reason}). ` +
+                "Start it first: fantastic start");
+        }
+        const manifest = {
+            archiveVersion: ARCHIVE_VERSION,
+            createdAt: new Date().toISOString(),
+            profile: profile.kind,
+            schemaRevision: schemaRevision(profile),
+            includesLogs: includeLogs,
+        };
+        // ٢ — الأرشفة بالتدفّق. ‎archiver‎ يمرّر البايتات ولا يحمل أرشيفًا بحجم القاعدة في الذاكرة.
+        onStep?.("packing…");
+        const output = createWriteStream(file);
+        const archive = new ZipArchive({ zlib: { level: 9 } });
+        const finished = new Promise((resolvePromise, rejectPromise) => {
+            output.on("close", () => resolvePromise());
+            output.on("error", rejectPromise);
+            archive.on("error", rejectPromise);
+        });
+        archive.pipe(output);
+        archive.append(JSON.stringify(manifest, null, 2), { name: "manifest.json" });
+        archive.file(snapshotPath, { name: `database/${SNAPSHOT_NAME}` });
+        appendDataDirectory(archive, profile);
+        const configFile = join(profile.stateDir, "config.json");
+        if (existsSync(configFile))
+            archive.file(configFile, { name: "state/config.json" });
+        if (includeLogs && existsSync(profile.logDir)) {
+            archive.directory(profile.logDir, "logs");
+        }
+        await archive.finalize();
+        await finished;
+        return { file, bytes: statSync(file).size, manifest };
+    }
+    finally {
+        rmSync(staging, { recursive: true, force: true });
+    }
+}
+/** يضيف ‎data/‎ عدا المخابئ وملفات القاعدة الحيّة. */
+function appendDataDirectory(archive, profile) {
+    if (!existsSync(profile.dataDir))
+        return;
+    for (const entry of readdirSync(profile.dataDir, { withFileTypes: true })) {
+        if (REGENERABLE.has(entry.name) || LIVE_DB_FILES.has(entry.name))
+            continue;
+        const full = join(profile.dataDir, entry.name);
+        const name = `data/${relative(profile.dataDir, full).replace(/\\/g, "/")}`;
+        if (entry.isDirectory())
+            archive.directory(full, name);
+        else if (entry.isFile())
+            archive.file(full, { name });
+    }
+}
+//# sourceMappingURL=archive.js.map

package/dist/backup/archive.js.map

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

package/dist/backup/restore.d.ts

@@ -0,0 +1,46 @@
+import type { Profile } from "../profiles/types.js";
+import { type BackupManifest } from "./archive.js";
+export interface ArchiveEntry {
+    name: string;
+    bytes: number;
+}
+export interface ArchiveContents {
+    manifest: BackupManifest;
+    entries: ArchiveEntry[];
+}
+/** يقرأ البيان وقائمة المحتويات بلا كتابة أي بايت. أساس ‎--dry-run‎. */
+export declare function inspectArchive(file: string): Promise<ArchiveContents>;
+export declare class RestoreRefused extends Error {
+}
+/**
+ * يتحقّق من التوافق **قبل** أي كتابة.
+ *
+ * أحدث ⇒ رفض. أقدم ⇒ مقبول: الهجرات تمضي إلى الأمام عند أول إقلاع، وذاك مسار مدعوم.
+ */
+export declare function assertCompatible(manifest: BackupManifest, currentRevision: number): void;
+/**
+ * وجهة كل مدخل داخل الأرشيف. يُعيد ‎undefined‎ لما لا يُستعاد (السجلّات مثلًا).
+ *
+ * **يرفض المسارات الهاربة.** أرشيف مُعَدّ يدويًا يستطيع حمل ‎../../windows/system32/...‎، وفكّه
+ * بلا فحص يكتب خارج مجلد التثبيت. الفحص هنا لأن هذا هو الموضع الوحيد الذي يتحوّل فيه اسمٌ داخل
+ * أرشيف إلى مسار على القرص.
+ */
+export declare function destinationFor(profile: Profile, entryName: string): string | undefined;
+export interface RestorePlanEntry {
+    from: string;
+    to: string;
+    bytes: number;
+    overwrites: boolean;
+}
+/** ما الذي سيُكتب وما الذي سيُكتب **فوقه**. هذا هو مخرَج ‎--dry-run‎. */
+export declare function planRestore(profile: Profile, contents: ArchiveContents): RestorePlanEntry[];
+/** يفكّ الأرشيف فعلًا. يُستدعى بعد ‎assertCompatible‎ وبعد تأكيد صريح من المستخدم. */
+export declare function extractArchive(profile: Profile, file: string): Promise<number>;
+/**
+ * يزيل ملفَّي WAL المرافقَين قبل الاستعادة.
+ *
+ * لولا ذلك لبقي ‎-wal‎ قديمٌ بجوار قاعدةٍ مستعادة، فيعيد SQLite تشغيل كتاباتٍ لا تخصّها ويُنتج حالةً
+ * مختلطة: نصف القاعدة من الأرشيف ونصفها من قبل الاستعادة. تُحذَف بعد التحقّق وقبل الكتابة.
+ */
+export declare function clearWalSiblings(profile: Profile): void;
+//# sourceMappingURL=restore.d.ts.map

package/dist/backup/restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../src/backup/restore.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAkC,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAcnF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAwBD,wEAAwE;AACxE,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAqC3E;AAED,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAE5C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAaxF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuBtF;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,GAAG,gBAAgB,EAAE,CAa3F;AAED,sFAAsF;AACtF,wBAAsB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsCpF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAKvD"}

package/dist/backup/restore.js

@@ -0,0 +1,164 @@
+import { createWriteStream, existsSync, mkdirSync, rmSync } from "node:fs";
+import { dirname, join, normalize, resolve, sep } from "node:path";
+import { pipeline } from "node:stream/promises";
+import yauzl from "yauzl";
+import { ARCHIVE_VERSION, SNAPSHOT_NAME } from "./archive.js";
+function openArchive(file) {
+    return new Promise((resolvePromise, rejectPromise) => {
+        yauzl.open(file, { lazyEntries: true, autoClose: false }, (error, zip) => {
+            if (error || !zip)
+                rejectPromise(error ?? new Error("the archive could not be opened"));
+            else
+                resolvePromise(zip);
+        });
+    });
+}
+function readEntryText(zip, entry) {
+    return new Promise((resolvePromise, rejectPromise) => {
+        zip.openReadStream(entry, (error, stream) => {
+            if (error || !stream)
+                return rejectPromise(error ?? new Error("unreadable entry"));
+            const chunks = [];
+            stream.on("data", (chunk) => chunks.push(chunk));
+            stream.on("end", () => resolvePromise(Buffer.concat(chunks).toString("utf8")));
+            stream.on("error", rejectPromise);
+        });
+    });
+}
+/** يقرأ البيان وقائمة المحتويات بلا كتابة أي بايت. أساس ‎--dry-run‎. */
+export async function inspectArchive(file) {
+    const zip = await openArchive(file);
+    const entries = [];
+    let manifest;
+    await new Promise((resolvePromise, rejectPromise) => {
+        zip.on("entry", (entry) => {
+            if (entry.fileName.endsWith("/")) {
+                zip.readEntry();
+                return;
+            }
+            entries.push({ name: entry.fileName, bytes: entry.uncompressedSize });
+            if (entry.fileName === "manifest.json") {
+                readEntryText(zip, entry)
+                    .then((text) => {
+                    manifest = JSON.parse(text);
+                    zip.readEntry();
+                })
+                    .catch(rejectPromise);
+                return;
+            }
+            zip.readEntry();
+        });
+        zip.on("end", () => resolvePromise());
+        zip.on("error", rejectPromise);
+        zip.readEntry();
+    });
+    zip.close();
+    if (!manifest)
+        throw new Error("this archive has no manifest.json — it was not produced by fantastic backup.");
+    return { manifest, entries };
+}
+export class RestoreRefused extends Error {
+}
+/**
+ * يتحقّق من التوافق **قبل** أي كتابة.
+ *
+ * أحدث ⇒ رفض. أقدم ⇒ مقبول: الهجرات تمضي إلى الأمام عند أول إقلاع، وذاك مسار مدعوم.
+ */
+export function assertCompatible(manifest, currentRevision) {
+    if (manifest.archiveVersion > ARCHIVE_VERSION) {
+        throw new RestoreRefused(`This archive uses format ${manifest.archiveVersion}; this CLI understands ${ARCHIVE_VERSION}. Update the CLI.`);
+    }
+    if (manifest.schemaRevision > currentRevision) {
+        throw new RestoreRefused(`This archive was taken at schema revision ${manifest.schemaRevision}, but this installation is at ` +
+            `${currentRevision}. Restoring it would leave the database ahead of the code. Update Fantastic first.`);
+    }
+}
+/**
+ * وجهة كل مدخل داخل الأرشيف. يُعيد ‎undefined‎ لما لا يُستعاد (السجلّات مثلًا).
+ *
+ * **يرفض المسارات الهاربة.** أرشيف مُعَدّ يدويًا يستطيع حمل ‎../../windows/system32/...‎، وفكّه
+ * بلا فحص يكتب خارج مجلد التثبيت. الفحص هنا لأن هذا هو الموضع الوحيد الذي يتحوّل فيه اسمٌ داخل
+ * أرشيف إلى مسار على القرص.
+ */
+export function destinationFor(profile, entryName) {
+    const parts = entryName.split("/");
+    const [top, ...rest] = parts;
+    if (rest.length === 0 && top !== "manifest.json")
+        return undefined;
+    const base = top === "database"
+        ? profile.dataDir
+        : top === "data"
+            ? profile.dataDir
+            : top === "state"
+                ? profile.stateDir
+                : undefined;
+    if (!base)
+        return undefined;
+    const target = resolve(base, ...rest);
+    const root = resolve(base);
+    // خارج الجذر ⇒ محاولة هروب. لا نصحّحها بل نتجاهل المدخل ونمضي.
+    if (target !== root && !normalize(target).startsWith(root + sep))
+        return undefined;
+    return target;
+}
+/** ما الذي سيُكتب وما الذي سيُكتب **فوقه**. هذا هو مخرَج ‎--dry-run‎. */
+export function planRestore(profile, contents) {
+    const plan = [];
+    for (const entry of contents.entries) {
+        if (entry.name === "manifest.json")
+            continue;
+        const to = destinationFor(profile, entry.name);
+        if (!to)
+            continue;
+        plan.push({ from: entry.name, to, bytes: entry.bytes, overwrites: existsSync(to) });
+    }
+    return plan;
+}
+/** يفكّ الأرشيف فعلًا. يُستدعى بعد ‎assertCompatible‎ وبعد تأكيد صريح من المستخدم. */
+export async function extractArchive(profile, file) {
+    const zip = await openArchive(file);
+    let written = 0;
+    await new Promise((resolvePromise, rejectPromise) => {
+        zip.on("entry", (entry) => {
+            if (entry.fileName.endsWith("/") || entry.fileName === "manifest.json") {
+                zip.readEntry();
+                return;
+            }
+            const destination = destinationFor(profile, entry.fileName);
+            if (!destination) {
+                zip.readEntry();
+                return;
+            }
+            zip.openReadStream(entry, (error, stream) => {
+                if (error || !stream)
+                    return rejectPromise(error ?? new Error(`unreadable: ${entry.fileName}`));
+                mkdirSync(dirname(destination), { recursive: true });
+                pipeline(stream, createWriteStream(destination))
+                    .then(() => {
+                    written += 1;
+                    zip.readEntry();
+                })
+                    .catch(rejectPromise);
+            });
+        });
+        zip.on("end", () => resolvePromise());
+        zip.on("error", rejectPromise);
+        zip.readEntry();
+    });
+    zip.close();
+    return written;
+}
+/**
+ * يزيل ملفَّي WAL المرافقَين قبل الاستعادة.
+ *
+ * لولا ذلك لبقي ‎-wal‎ قديمٌ بجوار قاعدةٍ مستعادة، فيعيد SQLite تشغيل كتاباتٍ لا تخصّها ويُنتج حالةً
+ * مختلطة: نصف القاعدة من الأرشيف ونصفها من قبل الاستعادة. تُحذَف بعد التحقّق وقبل الكتابة.
+ */
+export function clearWalSiblings(profile) {
+    for (const suffix of ["-wal", "-shm"]) {
+        const path = join(profile.dataDir, `${SNAPSHOT_NAME}${suffix}`);
+        if (existsSync(path))
+            rmSync(path, { force: true });
+    }
+}
+//# sourceMappingURL=restore.js.map

package/dist/backup/restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../src/backup/restore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,aAAa,EAAuB,MAAM,cAAc,CAAC;AAwBnF,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,cAAc,EAAE,aAAa,EAAE,EAAE;QACnD,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACvE,IAAI,KAAK,IAAI,CAAC,GAAG;gBAAE,aAAa,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;;gBACnF,cAAc,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,GAAkB,EAAE,KAAkB;IAC3D,OAAO,IAAI,OAAO,CAAC,CAAC,cAAc,EAAE,aAAa,EAAE,EAAE;QACnD,GAAG,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YAC1C,IAAI,KAAK,IAAI,CAAC,MAAM;gBAAE,OAAO,aAAa,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;YAEnF,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACzD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC/E,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,IAAI,QAAoC,CAAC;IAEzC,MAAM,IAAI,OAAO,CAAO,CAAC,cAAc,EAAE,aAAa,EAAE,EAAE;QACxD,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAkB,EAAE,EAAE;YACrC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjC,GAAG,CAAC,SAAS,EAAE,CAAC;gBAChB,OAAO;YACT,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC;YAEtE,IAAI,KAAK,CAAC,QAAQ,KAAK,eAAe,EAAE,CAAC;gBACvC,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC;qBACtB,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;oBACb,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;oBAC9C,GAAG,CAAC,SAAS,EAAE,CAAC;gBAClB,CAAC,CAAC;qBACD,KAAK,CAAC,aAAa,CAAC,CAAC;gBACxB,OAAO;YACT,CAAC;YAED,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC,CAAC;QACtC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC/B,GAAG,CAAC,SAAS,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,KAAK,EAAE,CAAC;IAEZ,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAE/G,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;CAAG;AAE5C;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAwB,EAAE,eAAuB;IAChF,IAAI,QAAQ,CAAC,cAAc,GAAG,eAAe,EAAE,CAAC;QAC9C,MAAM,IAAI,cAAc,CACtB,4BAA4B,QAAQ,CAAC,cAAc,0BAA0B,eAAe,mBAAmB,CAChH,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,cAAc,GAAG,eAAe,EAAE,CAAC;QAC9C,MAAM,IAAI,cAAc,CACtB,6CAA6C,QAAQ,CAAC,cAAc,gCAAgC;YAClG,GAAG,eAAe,oFAAoF,CACzG,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,SAAiB;IAChE,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC;IAC7B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,KAAK,eAAe;QAAE,OAAO,SAAS,CAAC;IAEnE,MAAM,IAAI,GACR,GAAG,KAAK,UAAU;QAChB,CAAC,CAAC,OAAO,CAAC,OAAO;QACjB,CAAC,CAAC,GAAG,KAAK,MAAM;YACd,CAAC,CAAC,OAAO,CAAC,OAAO;YACjB,CAAC,CAAC,GAAG,KAAK,OAAO;gBACf,CAAC,CAAC,OAAO,CAAC,QAAQ;gBAClB,CAAC,CAAC,SAAS,CAAC;IAEpB,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAE5B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3B,+DAA+D;IAC/D,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAEnF,OAAO,MAAM,CAAC;AAChB,CAAC;AASD,yEAAyE;AACzE,MAAM,UAAU,WAAW,CAAC,OAAgB,EAAE,QAAyB;IACrE,MAAM,IAAI,GAAuB,EAAE,CAAC;IAEpC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe;YAAE,SAAS;QAE7C,MAAM,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,EAAE;YAAE,SAAS;QAElB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAgB,EAAE,IAAY;IACjE,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,MAAM,IAAI,OAAO,CAAO,CAAC,cAAc,EAAE,aAAa,EAAE,EAAE;QACxD,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAkB,EAAE,EAAE;YACrC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,KAAK,eAAe,EAAE,CAAC;gBACvE,GAAG,CAAC,SAAS,EAAE,CAAC;gBAChB,OAAO;YACT,CAAC;YAED,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC5D,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,GAAG,CAAC,SAAS,EAAE,CAAC;gBAChB,OAAO;YACT,CAAC;YAED,GAAG,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;gBAC1C,IAAI,KAAK,IAAI,CAAC,MAAM;oBAAE,OAAO,aAAa,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;gBAEhG,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAErD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;qBAC7C,IAAI,CAAC,GAAG,EAAE;oBACT,OAAO,IAAI,CAAC,CAAC;oBACb,GAAG,CAAC,SAAS,EAAE,CAAC;gBAClB,CAAC,CAAC;qBACD,KAAK,CAAC,aAAa,CAAC,CAAC;YAC1B,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC,CAAC;QACtC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC/B,GAAG,CAAC,SAAS,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,KAAK,EAAE,CAAC;IACZ,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,KAAK,MAAM,MAAM,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,aAAa,GAAG,MAAM,EAAE,CAAC,CAAC;QAChE,IAAI,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/base-command.d.ts

@@ -0,0 +1,54 @@
+import { Command } from "@oclif/core";
+import type { Profile } from "./profiles/types.js";
+/**
+ * AR: عقد رموز الخروج، معروضًا في مساعدة كل أمر (017/FR-032، T075). ليس تفصيلًا داخليًا: سكربت
+ *     بوّابة يفرّق به بين «المنفذ محجوز» و«التشخيص وجد عائقًا» دون أن يحلّل نصًّا إنجليزيًا.
+ * EN: The exit-code contract, shown in every command's help (017/FR-032, T075). Not an internal
+ *     detail: a gate script uses it to tell "the port was busy" from "diagnosis found a blocker"
+ *     without parsing English prose.
+ */
+export declare const EXIT_CODE_HELP: string;
+export declare abstract class BaseCommand extends Command {
+    static baseFlags: {
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        /**
+         * AR: أيّ منتجٍ يقصد هذا الأمر؟ (٠٢٦)
+         *
+         *     **يُستنتَج عند الوحدة ويُطلَب عند التعدّد.** أمرُ إيقافٍ يصيب الجهاز الخطأ في استراحةٍ
+         *     تعمل أسوأ من أمرٍ يسأل — ولذلك لا تخمين هنا، والرفض يعدّد الأسماء بدل أن يقول «حدّد».
+         *
+         *     وموضعه في الأساس لا في كل أمر: سطرٌ يُكرَّر في ستّةٍ وثلاثين ملفًّا يُنسى في السابع
+         *     والثلاثين، فيصير أمرٌ واحدٌ لا يقبل العَلَم بلا أن يلاحظ أحد.
+         * EN: Which product does this command act on? (026)
+         *
+         *     **Inferred when there is one, required when there are several.** A stop command hitting
+         *     the wrong appliance in a working rest-house is worse than a command that asks — so nothing
+         *     is guessed here, and the refusal lists the names rather than saying "specify one".
+         *
+         *     It belongs in the base rather than in every command: a line repeated across thirty-six
+         *     files is forgotten in the thirty-seventh, leaving one command that ignores the flag with
+         *     nobody noticing.
+         */
+        product: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    /**
+     * AR: يُنفَّذ قبل جسم أيّ أمر (‎oclif‎ يناديها لكل أمر). وهو الموضع الوحيد الذي يضمن أن **كل**
+     *     أمرٍ يمرّ بفحص بيئة التشغيل، بلا سطرٍ مكرَّرٍ في ستّةٍ وثلاثين ملفًّا يُنسى في السابع
+     *     والثلاثين.
+     * EN: Runs before any command's body (oclif calls it for every command). It is the one place that
+     *     guarantees **every** command passes the runtime check, with no line repeated across
+     *     thirty-six files and forgotten in the thirty-seventh.
+     */
+    init(): Promise<void>;
+    protected loadProfile(kind?: string, ensureDirs?: boolean, product?: string): Profile;
+    /**
+     * جواب موحّد حين لا تُجيب النواة (017/FR-015).
+     *
+     * كل أمر إدارة يمرّ بهذه الحالة، وتكرار صياغتها في اثني عشر ملفًا يُنتج اثنتي عشرة صياغة تختلف
+     * قليلًا وتتباعد مع الوقت. **ولا يتراجع أي أمر إلى قراءة البيانات بنفسه**: هذا هو الحدّ الذي
+     * يفصل «الـ CLI يعرض» عن «الـ CLI يقرّر».
+     */
+    protected coreUnreachable(command: string, profile: Profile, reason: string, json: boolean): never;
+}
+//# sourceMappingURL=base-command.d.ts.map

package/dist/base-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,qBAAqB,CAAC;AAahE;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,QAOkC,CAAC;AAE9D,8BAAsB,WAAY,SAAQ,OAAO;IAC/C,MAAM,CAAC,SAAS;;;QASd;;;;;;;;;;;;;;;;;WAiBG;;MAIH;IAEF;;;;;;;OAOG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAalC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,UAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;IAWlF;;;;;;OAMG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,KAAK;CA0BnG"}