@wasmsoft/fantastic 1.0.0

package/README.md

@@ -0,0 +1,65 @@
+# Fantastic
+
+الواجهة الطرفية لمنتجات Fantastic: تُثبِّت النظام على الجهاز، وتفعّله، وتشغّله وتوقفه، وتقرأ
+سجلّاته، وتشخّصه، وتحدّثه — من أمرٍ واحد.
+
+```powershell
+npm i -g @wasmsoft/fantastic
+fantastic
+```
+
+## المتطلَّب الوحيد
+
+بيئة تشغيل JavaScript بإصدار **‏20 أو أحدث**. لا شيء غيرها.
+
+```powershell
+winget install OpenJS.NodeJS.LTS
+node -v
+```
+
+## الاستعمال
+
+```powershell
+fantastic                      # يفتح الصَدَفة التفاعلية
+fantastic install estraha      # يقتني النظام من المنصّة ويركّبه ويشغّله
+fantastic status               # حالة ما هو مثبَّت على هذه الآلة
+fantastic doctor               # تشخيصٌ كامل، بلا إنترنت
+fantastic update               # تحديثٌ موقَّع، يمرّ بالنواة، ويتراجع عند الفشل
+fantastic uninstall estraha    # إزالة، مع إبقاء بيانات العميل
+```
+
+الصَدَفة تُفتح بـ`fantastic` بلا وسائط **داخل طرفية**. أمّا في سكربت، فالأمر نفسه يطبع المساعدة
+ولا ينتظر أحدًا — الشرط ثلاثيّ عمدًا: لا وسائط، ومُدخَلٌ طرفية، ومخرَجٌ طرفية.
+
+## التركيب في موقعٍ بلا إنترنت
+
+ثلاثة ملفّاتٍ على ذاكرةٍ محمولة، وثلاث خطوات:
+
+```powershell
+node-v20.x-x64.msi                                   # 1 — بيئة التشغيل
+npm i -g .\wasmsoft-fantastic-1.0.0.tgz              # 2 — الواجهة، من الملفّ لا من السِّجلّ
+fantastic install estraha --from .\Fantastic-x.y.z-win-x64.zip   # 3 — النظام، من القرص
+```
+
+ملفّ `.tgz` مرفوعٌ مع كل إصدارٍ في صفحة الإصدارات.
+
+## ماذا تفعل وماذا لا تفعل
+
+الواجهة تجيب عن **العمليات والمنافذ والملفّات وحالتها هي**. النواة تجيب عن **البيانات** عبر HTTP.
+
+ولا تحمل الواجهة سرًّا: لا مفتاح تحقّق، ولا كود تفعيلٍ مخزَّن، ولا وصولًا إلى قاعدة بيانات. توقيع
+التحديث تتحقّق منه النواة لا هي — الحزمة عامّةٌ يقرؤها من شاء، فأيّ سرٍّ فيها سرٌّ منشور.
+
+## التطوير
+
+```powershell
+npm install
+npm run build
+npm run lint
+npm run typecheck
+npm test
+npm link          # لتجريب الأمر عالميًّا من المصدر
+```
+
+النشر آليٌّ عند وسم `v*`: بناء ← فحص أنواع ← اختبارات ← نشرٌ على السِّجلّ ← رفع `.tgz` أصلًا في
+الإصدار.

package/bin/run.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+
+// AR: نقطة دخول oclif. تُبقى رفيعة عمدًا: كل المنطق في ‎src/‎، وهذا الملف يُنفَّذ من ‎dist/‎ بعد البناء.
+//     الطرفية تُضبط على UTF-8 قبل أي طباعة، وإلا تحوّلت المخرجات العربية والمسارات إلى علامات استفهام.
+// EN: The oclif entry point. Deliberately thin: all logic lives in src/, and this runs against dist/
+//     after a build. The console is switched to UTF-8 before anything prints, otherwise Arabic output
+//     and Arabic paths degrade into question marks.
+
+import { execute } from "@oclif/core";
+
+if (process.platform === "win32") {
+  process.stdout.setDefaultEncoding?.("utf8");
+  process.stderr.setDefaultEncoding?.("utf8");
+}
+
+// AR: ‎fantastic‎ بلا وسائط **داخل طرفية** يفتح الصَدَفة التفاعلية بدل صفحة المساعدة. الشرط ثلاثيّ
+//     عن قصد: لا وسائط، ومُدخَل طرفية، ومخرَج طرفية. غياب أيٍّ منها يعني أن المُنادي سكربت لا إنسان
+//     — و‎fantastic | grep‎ في سكربت قديم يجب أن يبقى يطبع المساعدة كما كان، لا أن يعلّق على مِحَثّ
+//     لا أحد يجيبه.
+// EN: `fantastic` with no arguments **inside a terminal** opens the interactive shell rather than the
+//     help page. The condition is deliberately threefold: no arguments, a TTY stdin and a TTY stdout.
+//     Any one of them missing means the caller is a script rather than a person — and `fantastic |
+//     grep` in an old script must keep printing help as it did, not hang on a prompt nobody answers.
+const interactive =
+  process.argv.length === 2 && Boolean(process.stdin.isTTY) && Boolean(process.stdout.isTTY);
+
+await execute({ dir: import.meta.url, ...(interactive ? { args: ["shell"] } : {}) });

package/bin/supervisor.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+
+// AR: مدخل المُشرِف المشحون داخل الحزمة (٠٢٦). **يُنفَّذ من ‎<root>\supervisor\bin\supervisor.js‎
+//     بزمن تشغيل الحزمة نفسها**، تناديه شيمة ‎bin\fantastic.cmd‎ التي تناديها مهمّة الإقلاع.
+//
+//     **ولا oclif هنا ولا تحليل وسائط.** هذا الملفّ لا يناديه إنسان: تناديه جدولة ويندوز عند بدء
+//     التشغيل، بلا أحدٍ أمام الشاشة، وربما بحساب ‎SYSTEM‎. ما يحتاجه شيءٌ واحد — أين جذر التثبيت —
+//     وهو يعرفه من موقعه هو، لا من مجلد عملٍ لا يتحكّم به ولا من متغيّر بيئةٍ قد لا يرثه.
+//
+//     والترميز يُضبَط قبل أيّ طباعة كما في ‎bin/run.js‎: سجلّ المُشرِف يُقرأ عند تشخيص عطل، ومسارٌ
+//     عربيٌّ تحوّل إلى علامات استفهام يجعله بلا قيمة في اللحظة التي يُحتاج فيها.
+// EN: The entry point of the supervisor shipped inside the bundle (026). **It runs from
+//     `<root>\supervisor\bin\supervisor.js` on the bundle's own runtime**, called by the
+//     `bin\fantastic.cmd` shim that the boot task invokes.
+//
+//     **No oclif here and no argument parsing.** No human calls this file: the Windows scheduler
+//     does, at startup, with nobody at the screen, possibly as `SYSTEM`. It needs exactly one thing
+//     — where the install root is — and it knows that from its own location, not from a working
+//     directory it does not control and not from an environment variable it may not inherit.
+//
+//     The encoding is set before anything prints, as in `bin/run.js`: the supervisor's log is read
+//     while diagnosing a fault, and an Arabic path turned into question marks makes it worthless at
+//     the very moment it is needed.
+
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { main } from "../dist/supervisor/entry.js";
+import { VERSION } from "../dist/version.js";
+
+if (process.platform === "win32") {
+  process.stdout.setDefaultEncoding?.("utf8");
+  process.stderr.setDefaultEncoding?.("utf8");
+}
+
+// AR: ‎--check‎ هو **الفحص الوحيد الذي يقبله هذا الملفّ**، ووجوده ليس ترفًا.
+//
+//     الإقلاع التجريبي في خطّ الإنتاج كان يشغّل ‎<entry> --version‎ ويشترط خروجًا نظيفًا — وهو
+//     أرخص فحصٍ وأكثره كشفًا: يُجبر شجرة الوحدات كلّها على التحمّل على زمن تشغيل الحزمة، وهو
+//     بالضبط ما ينكسر حين تنقص اعتمادية من الشجرة المشحونة أو حين يعجز زمن التشغيل عن قراءة
+//     صياغتنا. **أربعة أعطالٍ ميدانية كانت من هذا الصنف** (٠١٨/T19).
+//
+//     ولا يصلح ‎--version‎ هنا: هذا الملفّ يبدأ الإشراف **ولا يعود**، فالفحص كان سيُعلّق البناء إلى
+//     أن ينتهي مهلته. و‎--check‎ يحفظ الغاية نفسها بحرفها: الاستيراد أعلاه حمّل الشجرة كاملةً
+//     فعلًا، فيبقى أن يُطبَع سطرٌ ويُخرَج بصفر.
+// EN: `--check` is **the only flag this file accepts**, and it is not a luxury.
+//
+//     The pipeline's smoke boot used to run `<entry> --version` and require a clean exit — the
+//     cheapest and most revealing check there is: it forces the entire module graph to load on the
+//     bundle's own runtime, which is exactly what breaks when a dependency is missing from the
+//     shipped tree or when that runtime cannot parse the syntax we wrote. **Four field failures were
+//     of this kind** (018/T19).
+//
+//     `--version` cannot serve here: this file starts supervising and **never returns**, so the check
+//     would hang the build until it timed out. `--check` keeps the purpose exactly: the import above
+//     has already loaded the whole graph, so all that remains is to print a line and exit zero.
+if (process.argv.includes("--check")) {
+  console.log(`fantastic-supervisor ${VERSION}`);
+  process.exit(0);
+}
+
+// ‎<root>/supervisor/bin/supervisor.js‎ ← صعودُ ثلاثة يبلغ جذر التثبيت.
+const here = dirname(fileURLToPath(import.meta.url));
+const bundleRoot = join(here, "..", "..");
+
+await main(bundleRoot);

package/dist/acquire/central-url.d.ts

@@ -0,0 +1,9 @@
+/** ملفّ إعدادات المستخدم للواجهة نفسها — لا لجهازٍ مثبَّت. */
+export declare function userConfigPath(): string;
+export type CentralSource = "environment" | "user config" | "built in";
+export interface CentralResolution {
+    url: string;
+    source: CentralSource;
+}
+export declare function resolveCentralUrl(): CentralResolution;
+//# sourceMappingURL=central-url.d.ts.map

package/dist/acquire/central-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"central-url.d.ts","sourceRoot":"","sources":["../../src/acquire/central-url.ts"],"names":[],"mappings":"AAuCA,8DAA8D;AAC9D,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,aAAa,GAAG,UAAU,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,aAAa,CAAC;CACvB;AAgBD,wBAAgB,iBAAiB,IAAI,iBAAiB,CAQrD"}

package/dist/acquire/central-url.js

@@ -0,0 +1,74 @@
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+// AR: عنوان المنصّة المركزية، **قبل أن يوجد جهازٌ يسأل عنه**.
+//
+//     بعد التثبيت تسأل الواجهةُ النواةَ عن كل شيء (الرخصة، التحديث)، والنواة تحمل العنوان في
+//     ‎config.json‎ الخاصّ بجهازها. أمّا قبل التثبيت فلا جهاز ولا نواة ولا ملفّ — والواجهة تحتاج أن
+//     تعرف أين تسأل عن الحزمة أصلًا. هذه الوحدة تجيب ذلك السؤال وحده.
+//
+//     **وليس سرًّا.** عنوان خادمٍ عامّ يعرفه كل من ثبّت النظام، ويظهر في أيّ التقاط شبكة. القاعدة
+//     التي تحكم الواجهة — «لا تحمل سرًّا» — تمنع المفتاح العام وكود التفعيل، لا عنوانًا معلنًا.
+//
+//     **والترتيب مقصود**: متغيّر بيئةٍ يتقدّم كل شيء ليختبر مطوّرٌ مقابل منصّةٍ محلّية بلا تعديل ملفّ؛
+//     ثم ملفّ المستخدم لمن يشغّل منصّةً خاصّة به دائمًا؛ ثم القيمة المخبوزة. وبهذا لا يُنشَر إصدارٌ
+//     جديد من الواجهة لأن عنوانًا تغيّر.
+// EN: The central platform's address, **before any appliance exists to ask about it**.
+//
+//     After installation the CLI asks the core about everything (licence, updates), and the core
+//     carries the address in its own appliance's `config.json`. Before installation there is no
+//     appliance, no core and no file — and the CLI still needs to know where to ask for the bundle.
+//     This module answers that one question.
+//
+//     **And it is not a secret.** A public server address known to everyone who installed the system
+//     and visible in any packet capture. The rule governing the CLI — "it holds no secrets" — bars
+//     the public key and the activation code, not a published address.
+//
+//     **The order is deliberate**: an environment variable outranks everything so a developer can
+//     test against a local platform without editing a file; then the user's file, for whoever always
+//     runs their own platform; then the baked-in value. So no new CLI release is published because an
+//     address changed.
+/**
+ * AR: القيمة المخبوزة. تُقرأ من متغيّر بناءٍ يومًا إن لزم؛ واليوم ثابتٌ واحد لأن المنصّة واحدة.
+ * EN: The baked-in value. It may be read from a build-time variable one day; today it is a single
+ *     constant because there is one platform.
+ */
+const BUILT_IN = "https://backend.fantatstic-central.wasmsoft.com";
+/** ملفّ إعدادات المستخدم للواجهة نفسها — لا لجهازٍ مثبَّت. */
+export function userConfigPath() {
+    return join(homedir(), ".fantastic", "cli.json");
+}
+function readUserConfig() {
+    const path = userConfigPath();
+    if (!existsSync(path))
+        return undefined;
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        const url = parsed.central?.url?.trim();
+        return url && url.length > 0 ? url : undefined;
+    }
+    catch {
+        // إعداداتٌ تالفة لا تمنع تثبيتًا: نمضي بالمخبوز، ويصحّحها ‎doctor‎ حين يُنادى.
+        return undefined;
+    }
+}
+export function resolveCentralUrl() {
+    const fromEnvironment = process.env.FANTASTIC_CENTRAL_URL?.trim();
+    if (fromEnvironment)
+        return { url: trimSlash(fromEnvironment), source: "environment" };
+    const fromFile = readUserConfig();
+    if (fromFile)
+        return { url: trimSlash(fromFile), source: "user config" };
+    return { url: trimSlash(BUILT_IN), source: "built in" };
+}
+/**
+ * AR: شرطةٌ خلفية واحدة تُنتج ‎//api/v1/…‎ في كل رابط بعدها. وبعض الوسطاء يردّ ‎404‎ عليها وبعضهم
+ *     يقبلها — فيعمل التثبيت في مكانٍ ويفشل في آخر بلا فرقٍ ظاهر.
+ * EN: One trailing slash yields `//api/v1/…` in every URL after it. Some proxies answer `404` to that
+ *     and others accept it — so an install works in one place and fails in another with no visible
+ *     difference.
+ */
+function trimSlash(url) {
+    return url.replace(/\/+$/, "");
+}
+//# sourceMappingURL=central-url.js.map

package/dist/acquire/central-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"central-url.js","sourceRoot":"","sources":["../../src/acquire/central-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,8DAA8D;AAC9D,EAAE;AACF,6FAA6F;AAC7F,oGAAoG;AACpG,sEAAsE;AACtE,EAAE;AACF,kGAAkG;AAClG,gGAAgG;AAChG,EAAE;AACF,uGAAuG;AACvG,oGAAoG;AACpG,yCAAyC;AACzC,uFAAuF;AACvF,EAAE;AACF,iGAAiG;AACjG,gGAAgG;AAChG,oGAAoG;AACpG,6CAA6C;AAC7C,EAAE;AACF,qGAAqG;AACrG,mGAAmG;AACnG,uEAAuE;AACvE,EAAE;AACF,kGAAkG;AAClG,qGAAqG;AACrG,sGAAsG;AACtG,uBAAuB;AAEvB;;;;GAIG;AACH,MAAM,QAAQ,GAAG,iDAAiD,CAAC;AAEnE,8DAA8D;AAC9D,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;AACnD,CAAC;AASD,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAExC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAmC,CAAC;QACxF,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QACxC,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,+EAA+E;QAC/E,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,CAAC;IAClE,IAAI,eAAe;QAAE,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAEvF,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAClC,IAAI,QAAQ;QAAE,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAEzE,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;;GAMG;AACH,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC"}

package/dist/acquire/code.d.ts

@@ -0,0 +1,21 @@
+export declare const ACTIVATION_CODE_ENV = "FANTASTIC_ACTIVATION_CODE";
+export declare class MissingActivationCode extends Error {
+    constructor();
+}
+export interface CodeSources {
+    /** ما مُرِّر في ‎--code‎، إن مُرِّر. */
+    flag?: string;
+    /** هل يوجد إنسانٌ يجيب؟ يُمرَّر ليكون القرار قابلًا للاختبار بلا طرفية حقيقية. */
+    interactive: boolean;
+}
+/**
+ * AR: يتحقّق من شكل الكود قبل إرساله. **الغاية رسالةٌ أوضح لا أمانٌ إضافيّ**: المركز هو من يقرّر
+ *     صحّة الكود، لكن نصًّا فارغًا أو حرفًا واحدًا لا يستحقّ نداءً شبكيًّا ولا ردًّا يقول «غير
+ *     صحيح» بعد ثانيتين من الانتظار.
+ * EN: Checks the code's shape before sending it. **The aim is a clearer message, not extra
+ *     security**: the centre decides whether a code is valid, but an empty string or a single
+ *     character deserves neither a network call nor a "not valid" answer two seconds later.
+ */
+export declare function looksLikeCode(value: string): boolean;
+export declare function readActivationCode(sources: CodeSources): Promise<string>;
+//# sourceMappingURL=code.d.ts.map

package/dist/acquire/code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/acquire/code.ts"],"names":[],"mappings":"AA0BA,eAAO,MAAM,mBAAmB,8BAA8B,CAAC;AAE/D,qBAAa,qBAAsB,SAAQ,KAAK;;CAQ/C;AAED,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAqB9E"}

package/dist/acquire/code.js

@@ -0,0 +1,66 @@
+import { password } from "@inquirer/prompts";
+// AR: كود التفعيل — **ما يملكه العميل قبل أن يوجد جهازه** (٠٢٦/FR-007).
+//
+//     هو المصادقة الوحيدة الممكنة في هذه اللحظة: لا رخصة على قرصٍ بعد، ولا بصمة جهازٍ مسجَّلة،
+//     ولا شيء يُثبت من يطلب الحزمة غير الكود الذي اشتراه.
+//
+//     **ولا يُكتب على قرص ولا يُطبع.** يُقرأ، ويُرسَل في ترويسة، ويُنسى مع انتهاء العملية. حفظه
+//     «تسهيلًا» يعني سرًّا مكتوبًا على جهاز الفنّي — وأجهزة الفنّيين تُعار وتُباع وتُسرَق.
+//
+//     **وترتيب المصادر يخدم حالتين لا واحدة**: إنسانٌ يقف أمام جهاز، وسكربتٌ يعمل بلا أحد.
+//     والفارق بينهما ليس تفضيلًا: مِحَثٌّ يُفتَح في مهمّةٍ مجدولة يعلّقها إلى الأبد بلا أن يقرأ
+//     أحدٌ سؤاله.
+// EN: The activation code — **what the customer holds before their appliance exists** (026/FR-007).
+//
+//     It is the only authentication possible at this moment: no licence on a disk yet, no registered
+//     device fingerprint, nothing to prove who is asking for the bundle but the code they bought.
+//
+//     **It is never written to disk and never printed.** It is read, sent in a header, and forgotten
+//     when the operation ends. Saving it "for convenience" means a secret written onto a
+//     technician's machine — and technicians' machines are lent, sold and stolen.
+//
+//     **The order of sources serves two situations, not one**: a human standing at a machine, and a
+//     script running with nobody there. The difference is not a preference: a prompt opened inside a
+//     scheduled task hangs it forever with nobody to read the question.
+export const ACTIVATION_CODE_ENV = "FANTASTIC_ACTIVATION_CODE";
+export class MissingActivationCode extends Error {
+    constructor() {
+        super(`no activation code. Pass --code, or set ${ACTIVATION_CODE_ENV}. ` +
+            "A code is only asked for interactively when a terminal is attached.");
+        this.name = "MissingActivationCode";
+    }
+}
+/**
+ * AR: يتحقّق من شكل الكود قبل إرساله. **الغاية رسالةٌ أوضح لا أمانٌ إضافيّ**: المركز هو من يقرّر
+ *     صحّة الكود، لكن نصًّا فارغًا أو حرفًا واحدًا لا يستحقّ نداءً شبكيًّا ولا ردًّا يقول «غير
+ *     صحيح» بعد ثانيتين من الانتظار.
+ * EN: Checks the code's shape before sending it. **The aim is a clearer message, not extra
+ *     security**: the centre decides whether a code is valid, but an empty string or a single
+ *     character deserves neither a network call nor a "not valid" answer two seconds later.
+ */
+export function looksLikeCode(value) {
+    const trimmed = value.trim();
+    return trimmed.length >= 5 && trimmed.length <= 40;
+}
+export async function readActivationCode(sources) {
+    const fromFlag = sources.flag?.trim();
+    if (fromFlag)
+        return fromFlag;
+    const fromEnvironment = process.env[ACTIVATION_CODE_ENV]?.trim();
+    if (fromEnvironment)
+        return fromEnvironment;
+    if (!sources.interactive)
+        throw new MissingActivationCode();
+    // AR: ‎password‎ لا ‎input‎: الكود سرٌّ، وطرفيةٌ تُعرَض على شاشةٍ في استراحة أو تُصوَّر في
+    //     مكالمة دعمٍ تعرضه لمن لا يخصّه. ولا يُحفظ في تاريخ الصدفة كما يُحفظ ‎--code‎.
+    // EN: `password` rather than `input`: the code is a secret, and a terminal shown on a screen in a
+    //     rest-house or captured in a support call exposes it to whoever is looking. Nor does it land
+    //     in shell history the way `--code` does.
+    const answer = await password({
+        message: "كود التفعيل:",
+        mask: "•",
+        validate: (value) => (looksLikeCode(value) ? true : "الكود قصير أو فارغ."),
+    });
+    return answer.trim();
+}
+//# sourceMappingURL=code.js.map

package/dist/acquire/code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.js","sourceRoot":"","sources":["../../src/acquire/code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,wEAAwE;AACxE,EAAE;AACF,+FAA+F;AAC/F,0DAA0D;AAC1D,EAAE;AACF,gGAAgG;AAChG,2FAA2F;AAC3F,EAAE;AACF,2FAA2F;AAC3F,gGAAgG;AAChG,kBAAkB;AAClB,oGAAoG;AACpG,EAAE;AACF,qGAAqG;AACrG,kGAAkG;AAClG,EAAE;AACF,qGAAqG;AACrG,yFAAyF;AACzF,kFAAkF;AAClF,EAAE;AACF,oGAAoG;AACpG,qGAAqG;AACrG,wEAAwE;AAExE,MAAM,CAAC,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAE/D,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C;QACE,KAAK,CACH,2CAA2C,mBAAmB,IAAI;YAChE,qEAAqE,CACxE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AASD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAoB;IAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IACtC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,CAAC;IACjE,IAAI,eAAe;QAAE,OAAO,eAAe,CAAC;IAE5C,IAAI,CAAC,OAAO,CAAC,WAAW;QAAE,MAAM,IAAI,qBAAqB,EAAE,CAAC;IAE5D,2FAA2F;IAC3F,oFAAoF;IACpF,kGAAkG;IAClG,kGAAkG;IAClG,8CAA8C;IAC9C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC;QAC5B,OAAO,EAAE,cAAc;QACvB,IAAI,EAAE,GAAG;QACT,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC;KACnF,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC"}

package/dist/acquire/compatibility.d.ts

@@ -0,0 +1,18 @@
+export type CompatibilityVerdict = {
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+    remedy: string;
+};
+/** يقارن ‎a‎ بـ‎b‎ رقمًا رقمًا. اللواحق (‎-beta.1‎) تُهمَل: عقدُنا على الأرقام الثلاثة. */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * AR: هل تستطيع هذه الواجهة تركيب حزمةٍ تشترط ‎required‎؟ فراغُ الاشتراط يعني «لا اشتراط» —
+ *     وهو حال كل حزمةٍ بُنيت قبل ٠٢٦، وهي كثيرةٌ ومثبَّتةٌ عند عملاء.
+ * EN: Can this CLI install a bundle requiring `required`? An empty requirement means "no
+ *     requirement" — the state of every bundle built before 026, of which there are many, installed
+ *     at customer sites.
+ */
+export declare function checkCompatibility(required: string | undefined, current?: string): CompatibilityVerdict;
+//# sourceMappingURL=compatibility.d.ts.map

package/dist/acquire/compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../src/acquire/compatibility.ts"],"names":[],"mappings":"AA4BA,MAAM,MAAM,oBAAoB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAgB5D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,GAAE,MAAgB,GAAG,oBAAoB,CAWhH"}

package/dist/acquire/compatibility.js

@@ -0,0 +1,36 @@
+import { VERSION } from "../version.js";
+/** يقارن ‎a‎ بـ‎b‎ رقمًا رقمًا. اللواحق (‎-beta.1‎) تُهمَل: عقدُنا على الأرقام الثلاثة. */
+export function compareVersions(a, b) {
+    const parts = (value) => value
+        .split("-")[0]
+        .split(".")
+        .map((piece) => Number.parseInt(piece, 10) || 0);
+    const left = parts(a);
+    const right = parts(b);
+    for (let index = 0; index < 3; index += 1) {
+        const difference = (left[index] ?? 0) - (right[index] ?? 0);
+        if (difference !== 0)
+            return difference > 0 ? 1 : -1;
+    }
+    return 0;
+}
+/**
+ * AR: هل تستطيع هذه الواجهة تركيب حزمةٍ تشترط ‎required‎؟ فراغُ الاشتراط يعني «لا اشتراط» —
+ *     وهو حال كل حزمةٍ بُنيت قبل ٠٢٦، وهي كثيرةٌ ومثبَّتةٌ عند عملاء.
+ * EN: Can this CLI install a bundle requiring `required`? An empty requirement means "no
+ *     requirement" — the state of every bundle built before 026, of which there are many, installed
+ *     at customer sites.
+ */
+export function checkCompatibility(required, current = VERSION) {
+    const wanted = required?.trim();
+    if (!wanted)
+        return { ok: true };
+    if (compareVersions(current, wanted) >= 0)
+        return { ok: true };
+    return {
+        ok: false,
+        message: `هذه الحزمة تحتاج واجهة ‎${wanted}‎ أو أحدث، والمثبَّتة هنا ‎${current}‎.`,
+        remedy: "حدّث الواجهة ثم أعِد المحاولة:  npm i -g @wasmsoft/fantastic@latest",
+    };
+}
+//# sourceMappingURL=compatibility.js.map

package/dist/acquire/compatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.js","sourceRoot":"","sources":["../../src/acquire/compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AA8BxC,2FAA2F;AAC3F,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,KAAK,GAAG,CAAC,KAAa,EAAY,EAAE,CACxC,KAAK;SACF,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE;SACd,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAErD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEvB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,IAAI,UAAU,KAAK,CAAC;YAAE,OAAO,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAA4B,EAAE,UAAkB,OAAO;IACxF,MAAM,MAAM,GAAG,QAAQ,EAAE,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAEjC,IAAI,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAE/D,OAAO;QACL,EAAE,EAAE,KAAK;QACT,OAAO,EAAE,2BAA2B,MAAM,8BAA8B,OAAO,IAAI;QACnF,MAAM,EAAE,qEAAqE;KAC9E,CAAC;AACJ,CAAC"}

package/dist/acquire/fetch.d.ts

@@ -0,0 +1,26 @@
+import { type AvailableRelease } from "./latest.js";
+export interface DownloadProgress {
+    /** ما نُزِّل حتى الآن، شاملًا ما كان موجودًا قبل هذه المحاولة. */
+    received: number;
+    total: number;
+    /** صحيح حين بدأت هذه المحاولة من ملفٍّ جزئيّ سابق. */
+    resumed: boolean;
+}
+export interface DownloadOptions {
+    code: string;
+    release: AvailableRelease;
+    platform?: string;
+    onProgress?: (progress: DownloadProgress) => void;
+}
+export declare function partialPathFor(release: AvailableRelease): string;
+/**
+ * AR: ينزّل إلى ملفٍّ جزئيّ ويعيد مساره. **لا يتحقّق من البصمة**: ذلك عمل ‎updating/verify.ts‎
+ *     القائم منذ P5.4، ونسخةٌ ثانية منه هنا تعني خوارزميتَي تحقّقٍ تتباعدان.
+ * EN: Downloads into a partial file and returns its path. **It does not verify the digest**: that is
+ *     `updating/verify.ts`'s job, in place since P5.4, and a second copy here would mean two
+ *     verification paths drifting apart.
+ */
+export declare function downloadBundle(options: DownloadOptions): Promise<string>;
+/** يُنادى بعد نجاح التركيب، أو بعد فشل بصمةٍ لا يُصلحه استئناف. */
+export declare function discardPartial(release: AvailableRelease): void;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/acquire/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/acquire/fetch.ts"],"names":[],"mappings":"AAKA,OAAO,EAAiD,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AA6BnG,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACnD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAIhE;AAMD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAoD9E;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAG9D"}

package/dist/acquire/fetch.js

@@ -0,0 +1,72 @@
+import { createWriteStream, existsSync, mkdirSync, statSync, unlinkSync } from "node:fs";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { ACTIVATION_HEADER, releaseUrl, CentralRefused } from "./latest.js";
+export function partialPathFor(release) {
+    const directory = join(tmpdir(), "fantastic-downloads");
+    mkdirSync(directory, { recursive: true });
+    return join(directory, `${release.product}-${release.version}.zip.part`);
+}
+function bytesOnDisk(path) {
+    return existsSync(path) ? statSync(path).size : 0;
+}
+/**
+ * AR: ينزّل إلى ملفٍّ جزئيّ ويعيد مساره. **لا يتحقّق من البصمة**: ذلك عمل ‎updating/verify.ts‎
+ *     القائم منذ P5.4، ونسخةٌ ثانية منه هنا تعني خوارزميتَي تحقّقٍ تتباعدان.
+ * EN: Downloads into a partial file and returns its path. **It does not verify the digest**: that is
+ *     `updating/verify.ts`'s job, in place since P5.4, and a second copy here would mean two
+ *     verification paths drifting apart.
+ */
+export async function downloadBundle(options) {
+    const { code, release } = options;
+    const target = partialPathFor(release);
+    const already = bytesOnDisk(target);
+    // AR: **ملفٌّ أكبر من المتوقَّع لا يُستأنَف.** يعني إصدارًا آخر بقي باسمٍ متشابه، أو كتابةً
+    //     تلفت؛ والاستئناف فوقه يُنتج أرشيفًا لا تطابق بصمته شيئًا ويُقرأ «تلفًا» بلا سبب مفهوم.
+    // EN: **A file larger than expected is never resumed.** It means another release left under a
+    //     similar name, or a corrupt write; resuming over it produces an archive whose digest matches
+    //     nothing and reads as "corruption" for no intelligible reason.
+    const resumable = already > 0 && (release.sizeBytes === 0 || already < release.sizeBytes);
+    if (already > 0 && !resumable)
+        unlinkSync(target);
+    const from = resumable ? already : 0;
+    const response = await fetch(releaseUrl("download", release.product, options.platform), {
+        headers: {
+            [ACTIVATION_HEADER]: code,
+            ...(from > 0 ? { Range: `bytes=${from}-` } : {}),
+        },
+    });
+    if (!response.ok && response.status !== 206) {
+        throw new CentralRefused(response.status, `تعذّر تنزيل الحزمة (${response.status}).`);
+    }
+    if (!response.body)
+        throw new CentralRefused(response.status, "المنصّة ردّت بلا محتوى.");
+    // AR: **ردٌّ بـ‎200‎ على طلب مدى يعني أن الخادم لا يدعم الاستئناف**، فيبدأ الملفّ من أوّله ولا
+    //     يجوز أن نُلحق عليه — الإلحاق كان سيُنتج ملفًّا فيه بدايةٌ مكرّرة يفشل فكّه بلا سبب ظاهر.
+    //     هذه هي حال أيّ مركزٍ لم يُحدَّث بعد ٠٢٦، وهي تعمل — أبطأ فقط.
+    // EN: **A `200` answer to a range request means the server does not support resumption**, so the
+    //     file starts from its beginning and must not be appended to — appending would produce a file
+    //     with a duplicated head that fails to extract for no visible reason. This is the state of any
+    //     centre not yet updated for 026, and it works — only slower.
+    const serverResumed = response.status === 206;
+    const startedAt = serverResumed ? from : 0;
+    const total = release.sizeBytes > 0 ? release.sizeBytes : startedAt + Number(response.headers.get("content-length") ?? 0);
+    let received = startedAt;
+    options.onProgress?.({ received, total, resumed: serverResumed && from > 0 });
+    const source = Readable.fromWeb(response.body);
+    source.on("data", (chunk) => {
+        received += chunk.length;
+        options.onProgress?.({ received, total, resumed: serverResumed && from > 0 });
+    });
+    await pipeline(source, createWriteStream(target, { flags: serverResumed && from > 0 ? "a" : "w" }));
+    return target;
+}
+/** يُنادى بعد نجاح التركيب، أو بعد فشل بصمةٍ لا يُصلحه استئناف. */
+export function discardPartial(release) {
+    const path = partialPathFor(release);
+    if (existsSync(path))
+        unlinkSync(path);
+}
+//# sourceMappingURL=fetch.js.map

package/dist/acquire/fetch.js.map

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

package/dist/acquire/latest.d.ts

@@ -0,0 +1,24 @@
+export declare const ACTIVATION_HEADER = "X-Activation-Code";
+export interface AvailableRelease {
+    version: string;
+    sha256: string;
+    sizeBytes: number;
+    fileName: string;
+    product: string;
+    /** فارغٌ لحزمٍ رُفعت قبل ٠٢٦. الواجهة تعامل الفراغ كـ«بلا اشتراط». */
+    minCliVersion: string;
+}
+export declare class CentralRefused extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+export declare function releaseUrl(path: string, product: string, platform?: string): string;
+/**
+ * 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 declare function fetchLatest(code: string, product: string, platform?: string): Promise<AvailableRelease>;
+//# sourceMappingURL=latest.d.ts.map

package/dist/acquire/latest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latest.d.ts","sourceRoot":"","sources":["../../src/acquire/latest.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,cAAe,SAAQ,KAAK;IAErC,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM;CAKlB;AA+BD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,MAAM,CAGtF;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4BhH"}