@wasmsoft/fantastic 1.0.0

package/dist/probes/internal.client.js

@@ -0,0 +1,123 @@
+import { findService, serviceOrigin } from "../profiles/types.js";
+import { INTERNAL_PATHS } from "./internal-paths.js";
+// AR: عميل السطح الداخلي. هو الطريق **الوحيد** الذي يسأل به الـ CLI النواةَ عن بيانات، تطبيقًا لحدّ
+//     المعمارية «الـ CLI يعرض والنواة تقرّر»: لا عميل قاعدة بيانات في هذه المساحة، ولا قراءة ملف
+//     لتخمين ما تعرفه النواة (017/FR-014، FR-033).
+//
+//     **الفشل هنا حالة عادية لا استثناء.** النواة قد تكون متوقّفة، وهو أوّل ما يُشخَّص لا ما يُخفى:
+//     ‎doctor‎ يجب أن يعمل والنواة ميّتة ويقول ذلك بوضوح. لذلك يُعيد هذا العميل نتيجةً موسومة ولا
+//     يرمي استثناءً يوقف أمرًا كاملًا (017/FR-015).
+//
+// EN: The internal-surface client. It is the **only** way the CLI asks the core for data, honouring
+//     the architecture's boundary — "the CLI displays, the core decides": no database client lives in
+//     this workspace, and no file is read to guess what the core knows (017/FR-014, FR-033).
+//
+//     **Failure here is ordinary, not exceptional.** The core may be down, and that is the first
+//     thing to diagnose rather than hide: `doctor` must work with a dead core and say so plainly.
+//     So this client returns a tagged result and never throws in a way that aborts a whole command
+//     (017/FR-015).
+const DEFAULT_TIMEOUT_MS = 2_500;
+/** غلاف D4: النواة تلفّ كل استجابة JSON ناجحة في ‎{ data }‎، فننزعه هنا مرّة واحدة. */
+function unwrapEnvelope(body) {
+    if (typeof body === "object" && body !== null && "data" in body) {
+        return body.data;
+    }
+    return body;
+}
+/**
+ * أصل السطح الداخلي: النواة على هذه الآلة.
+ *
+ * نستعمل ‎127.0.0.1‎ دائمًا لا عنوان الشبكة، وليس ذلك تفصيلًا: الحارس على الطرف الآخر يقبل
+ * اللوب-باك وحده، فطلبٌ إلى عنوان الشبكة الخاص بالجهاز نفسه **سيُرفَض** رغم أنه الجهاز ذاته.
+ * ‎serviceOrigin‎ يطبّق هذا التحويل حين تستمع الخدمة على ‎0.0.0.0‎.
+ */
+function internalOrigin(profile) {
+    const core = findService(profile, "core");
+    return core ? serviceOrigin(core) : undefined;
+}
+async function request(profile, path, timeoutMs, init) {
+    const origin = internalOrigin(profile);
+    if (!origin)
+        return { ok: false, reason: "no core service in this profile", unreachable: true };
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(`${origin}${path}`, {
+            signal: controller.signal,
+            ...(init
+                ? {
+                    method: init.method,
+                    headers: { "content-type": "application/json" },
+                    body: JSON.stringify(init.body),
+                }
+                : {}),
+        });
+        if (!response.ok) {
+            const envelope = (await response.json().catch(() => undefined));
+            const error = envelope?.error;
+            return {
+                ok: false,
+                // رسالة النواة إن وُجدت، وحالةُ HTTP حين لا تكون هناك رسالة أصلًا.
+                reason: error?.message ?? `the core responded with status ${response.status}`,
+                // ردّ بخطأ يعني أنه **حيّ**: التمييز يغيّر العلاج المقترح في ‎doctor‎.
+                unreachable: false,
+                ...(error?.code && error.message
+                    ? { error: { code: error.code, message: error.message, details: error.details } }
+                    : {}),
+            };
+        }
+        const body = (await response.json().catch(() => undefined));
+        return { ok: true, data: unwrapEnvelope(body) };
+    }
+    catch (error) {
+        const aborted = error instanceof Error && error.name === "AbortError";
+        return {
+            ok: false,
+            reason: aborted ? `the core did not answer within ${timeoutMs}ms` : "the core is not reachable",
+            unreachable: true,
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** اللقطة الغنيّة من ‎/internal/health‎. الحقول الاختيارية الغائبة تُرسَم شرطةً لا صفرًا. */
+export function fetchInternalHealth(profile, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    return request(profile, INTERNAL_PATHS.HEALTH, timeoutMs);
+}
+/** قراءة عامة من السطح الداخلي. */
+export function getInternal(profile, path, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    return request(profile, path, timeoutMs);
+}
+/**
+ * كتابة على السطح الداخلي. المهلة أطول بكثير من القراءة: ‎VACUUM INTO‎ على قاعدة كبيرة يستغرق
+ * ثوانيَ حقيقية، وقطعُه في منتصفه يترك أرشيفًا ناقصًا — وهو بالضبط ما بُني هذا المسار لتفاديه.
+ */
+export function postInternal(profile, path, body, timeoutMs = 120_000) {
+    return request(profile, path, timeoutMs, { method: "POST", body });
+}
+// ── الترخيص (P4.4) ────────────────────────────────────────────────────────────
+/** حالة الرخصة على هذا الجهاز، كما تصفها النواة لشاشة التفعيل حرفًا بحرف. */
+export function fetchLicenseStatus(profile, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    return request(profile, INTERNAL_PATHS.LICENSE_STATUS, timeoutMs);
+}
+/**
+ * AR: يفعّل هذا الجهاز. المهلة **دقيقة كاملة** لا الافتراضيةَ القصيرة: النداء يعبر النواةَ إلى
+ *     المركز عبر الإنترنت، والنواة تعيد المحاولة ثلاثًا بتباعد أسّي حين لا يجيب. قطعُه بعد
+ *     ثانيتين ونصف كان يقول «النواة لا تجيب» بينما هي تنتظر ردًّا سيصل.
+ * EN: Activates this machine. The timeout is **a full minute** rather than the short default: the
+ *     call travels through the core to the centre over the internet, and the core retries three
+ *     times with exponential backoff when there is no answer. Cutting it off after 2.5 seconds
+ *     reported "the core is not answering" while it was waiting for a reply that would arrive.
+ */
+export function activateLicense(profile, code) {
+    return request(profile, INTERNAL_PATHS.LICENSE_ACTIVATE, 60_000, {
+        method: "POST",
+        body: { code },
+    });
+}
+/** يوقف تفعيل هذا الجهاز ويحرّر مقعده في المركز. يُنادى من ‎uninstall‎ قبل حذف أي ملف. */
+export function deactivateLicense(profile) {
+    return request(profile, INTERNAL_PATHS.LICENSE_DEACTIVATE, 30_000, { method: "POST", body: {} });
+}
+//# sourceMappingURL=internal.client.js.map

package/dist/probes/internal.client.js.map

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

package/dist/probes/port.probe.d.ts

@@ -0,0 +1,21 @@
+export interface PortHolder {
+    pid: number;
+    name: string;
+}
+/**
+ * هل المنفذ حرّ؟ نفحص بمحاولة الاستماع لا بمحاولة الاتصال: خدمة تستمع على 127.0.0.1 فقط تجعل اتصالًا
+ * على 0.0.0.0 يفشل رغم أن الإقلاع سيصطدم بها.
+ */
+export declare function isPortFree(port: number, host?: string): Promise<boolean>;
+/**
+ * من يستمع على المنفذ. PowerShell هو الطريق الوحيد الموثوق على ويندوز؛ على غيره نُرجع undefined
+ * ونكتفي بأن المنفذ محجوز، لأن الرسالة الناقصة أفضل من أمر يفشل.
+ */
+export declare function findPortHolder(port: number): Promise<PortHolder | undefined>;
+export interface PortConflict {
+    port: number;
+    holder?: PortHolder;
+}
+/** يفحص عدة منافذ معًا ويعيد المتعارض منها فقط، مع صاحبه إن أمكن التعرّف عليه. */
+export declare function findPortConflicts(ports: number[]): Promise<PortConflict[]>;
+//# sourceMappingURL=port.probe.d.ts.map

package/dist/probes/port.probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.probe.d.ts","sourceRoot":"","sources":["../../src/probes/port.probe.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAWjF;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAmBlF;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,kFAAkF;AAClF,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAUhF"}

package/dist/probes/port.probe.js

@@ -0,0 +1,42 @@
+import { createServer } from "node:net";
+import { execa } from "execa";
+/**
+ * هل المنفذ حرّ؟ نفحص بمحاولة الاستماع لا بمحاولة الاتصال: خدمة تستمع على 127.0.0.1 فقط تجعل اتصالًا
+ * على 0.0.0.0 يفشل رغم أن الإقلاع سيصطدم بها.
+ */
+export async function isPortFree(port, host = "0.0.0.0") {
+    return new Promise((resolvePromise) => {
+        const server = createServer();
+        server.once("error", () => resolvePromise(false));
+        server.once("listening", () => {
+            server.close(() => resolvePromise(true));
+        });
+        server.listen(port, host);
+    });
+}
+/**
+ * من يستمع على المنفذ. PowerShell هو الطريق الوحيد الموثوق على ويندوز؛ على غيره نُرجع undefined
+ * ونكتفي بأن المنفذ محجوز، لأن الرسالة الناقصة أفضل من أمر يفشل.
+ */
+export async function findPortHolder(port) {
+    if (process.platform !== "win32")
+        return undefined;
+    const script = `$c = Get-NetTCPConnection -LocalPort ${port} -State Listen -ErrorAction SilentlyContinue | Select-Object -First 1; if ($c) { $p = Get-Process -Id $c.OwningProcess -ErrorAction SilentlyContinue; if ($p) { "$($p.Id)|$($p.ProcessName)" } }`;
+    try {
+        const { stdout } = await execa("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], { timeout: 8_000, reject: false });
+        const [pid, name] = stdout.trim().split("|");
+        if (!pid || !name)
+            return undefined;
+        return { pid: Number(pid), name };
+    }
+    catch {
+        return undefined;
+    }
+}
+/** يفحص عدة منافذ معًا ويعيد المتعارض منها فقط، مع صاحبه إن أمكن التعرّف عليه. */
+export async function findPortConflicts(ports) {
+    const results = await Promise.all(ports.map(async (port) => ({ port, free: await isPortFree(port) })));
+    const busy = results.filter((result) => !result.free);
+    return Promise.all(busy.map(async ({ port }) => ({ port, holder: await findPortHolder(port) })));
+}
+//# sourceMappingURL=port.probe.js.map

package/dist/probes/port.probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.probe.js","sourceRoot":"","sources":["../../src/probes/port.probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAa9B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,IAAI,GAAG,SAAS;IAC7D,OAAO,IAAI,OAAO,CAAC,CAAC,cAAc,EAAE,EAAE;QACpC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAE9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IAEnD,MAAM,MAAM,GAAG,wCAAwC,IAAI,kMAAkM,CAAC;IAE9P,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAC5B,gBAAgB,EAChB,CAAC,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,CAAC,EACrD,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAClC,CAAC;QAEF,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAEpC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAOD,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAe;IACrD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CACpE,CAAC;IAEF,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEtD,OAAO,OAAO,CAAC,GAAG,CAChB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAC7E,CAAC;AACJ,CAAC"}

package/dist/probes/service.probe.d.ts

@@ -0,0 +1,29 @@
+import { type ServiceDefinition } from "../profiles/types.js";
+export interface ProbeResult {
+    reachable: boolean;
+    /** حمولة الخدمة إن ردّت. يُستعمل في ‎status‎ و‎health‎ لعرض النسخة ومدة التشغيل. */
+    payload?: unknown;
+    /** سبب الفشل بالعربية، للعرض لا للتحليل. */
+    reason?: string;
+}
+/** يسبر خدمة واحدة بالطريقة التي يقرّرها تعريفها. */
+export declare function probeService(service: ServiceDefinition, timeoutMs?: number): Promise<ProbeResult>;
+/** لقطة صحة النواة كما تعيدها اليوم. الحقول اختيارية لأن العقد سيتوسّع في C3. */
+export interface CoreHealthPayload {
+    status?: string;
+    version?: string;
+    environment?: string;
+    uptimeSeconds?: number;
+    checks?: {
+        name: string;
+        status: string;
+    }[];
+}
+export declare function asCoreHealth(payload: unknown): CoreHealthPayload | undefined;
+/** لقطة خدمة البث: ‎{ status, channels }‎ من ‎/internal/health‎. */
+export interface LiveHealthPayload {
+    status?: string;
+    channels?: number;
+}
+export declare function asLiveHealth(payload: unknown): LiveHealthPayload | undefined;
+//# sourceMappingURL=service.probe.d.ts.map

package/dist/probes/service.probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.probe.d.ts","sourceRoot":"","sources":["../../src/probes/service.probe.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAQ7E,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,oFAAoF;IACpF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAsDD,qDAAqD;AACrD,wBAAsB,YAAY,CAChC,OAAO,EAAE,iBAAiB,EAC1B,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,WAAW,CAAC,CAMtB;AAED,iFAAiF;AACjF,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7C;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAG5E;AAED,oEAAoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAG5E"}

package/dist/probes/service.probe.js

@@ -0,0 +1,65 @@
+import { Socket } from "node:net";
+import { serviceOrigin } from "../profiles/types.js";
+const DEFAULT_TIMEOUT_MS = 2_500;
+/** غلاف D4: كل استجابة ناجحة من النواة ملفوفة في ‎{ data }‎، فننزع الغلاف هنا مرة واحدة. */
+function unwrapEnvelope(body) {
+    if (typeof body === "object" && body !== null && "data" in body) {
+        return body.data;
+    }
+    return body;
+}
+async function probeHttp(url, timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, { signal: controller.signal });
+        if (!response.ok) {
+            return { reachable: false, reason: `responded with status ${response.status}` };
+        }
+        const body = (await response.json().catch(() => undefined));
+        return { reachable: true, payload: unwrapEnvelope(body) };
+    }
+    catch (error) {
+        const aborted = error instanceof Error && error.name === "AbortError";
+        return { reachable: false, reason: aborted ? "timed out" : "no connection" };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function probeTcp(host, port, timeoutMs) {
+    return new Promise((resolvePromise) => {
+        const socket = new Socket();
+        let settled = false;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            socket.destroy();
+            resolvePromise(result);
+        };
+        socket.setTimeout(timeoutMs);
+        socket.once("connect", () => finish({ reachable: true }));
+        socket.once("timeout", () => finish({ reachable: false, reason: "timed out" }));
+        socket.once("error", () => finish({ reachable: false, reason: "no connection" }));
+        socket.connect(port, host === "0.0.0.0" || host === "::" ? "127.0.0.1" : host);
+    });
+}
+/** يسبر خدمة واحدة بالطريقة التي يقرّرها تعريفها. */
+export async function probeService(service, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    if (service.readiness.kind === "http") {
+        return probeHttp(`${serviceOrigin(service)}${service.readiness.path}`, timeoutMs);
+    }
+    return probeTcp(service.host, service.port, timeoutMs);
+}
+export function asCoreHealth(payload) {
+    if (typeof payload !== "object" || payload === null)
+        return undefined;
+    return payload;
+}
+export function asLiveHealth(payload) {
+    if (typeof payload !== "object" || payload === null)
+        return undefined;
+    return payload;
+}
+//# sourceMappingURL=service.probe.js.map

package/dist/probes/service.probe.js.map

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

package/dist/profiles/appliance.profile.d.ts

@@ -0,0 +1,20 @@
+import type { Profile } from "./types.js";
+/** جذر التثبيت كما نصّت المعمارية v3 §09. */
+export declare const APPLIANCE_ROOT = "C:\\Fantastic";
+export interface ApplianceProfileOptions {
+    root: string;
+    corePort: number;
+    livePort: number;
+    logLevel: string;
+    /** عنوان البوّابة المركزية. غيابه يترك افتراض النواة كما هو. */
+    centralApiUrl?: string;
+    /** المفتاح العام الذي يُتحقَّق به من الرخص. ليس سرًّا: يتحقّق ولا يوقّع. */
+    licensePublicKey?: string;
+}
+export declare const APPLIANCE_DEFAULTS: {
+    readonly corePort: 80;
+    readonly livePort: 8081;
+    readonly logLevel: "info";
+};
+export declare function createApplianceProfile(options: ApplianceProfileOptions): Profile;
+//# sourceMappingURL=appliance.profile.d.ts.map

package/dist/profiles/appliance.profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appliance.profile.d.ts","sourceRoot":"","sources":["../../src/profiles/appliance.profile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAqB,MAAM,YAAY,CAAC;AAsB7D,6CAA6C;AAC7C,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAE9C,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,kBAAkB;;;;CAKrB,CAAC;AAEX,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAkHhF"}

package/dist/profiles/appliance.profile.js

@@ -0,0 +1,137 @@
+import { join } from "node:path";
+// AR: ملفّ تشغيل الجهاز المركّب عند العميل. خدمتان لا ثلاث: الواجهة ملفات ثابتة تقدّمها النواة عبر
+//     ‎PORTAL_DIST‎ ولا تحتاج عملية. هذا الملف هو كامل الفرق بين ما نشغّله نحن وما يشغّله الفني.
+//     بقيّة الـ CLI لا تعرف أيّ ملف تشغيل تعمل تحته.
+//
+//     **تبديل استراتيجية التغليف يكلّف سطرين هنا ولا شيء سواهما (017/SC-009).**
+//     كان هذا الملف يشير إلى ‎core\fantastic-core.exe‎ و‎fantastic-live.exe‎ — ملفّين لم يُنتَجا قط،
+//     فكان وضع الجهاز غير قابل للاستنتاج أصلًا. صار يشير إلى ما تُنتجه الحزمة فعلًا:
+//     ‎runtime\node.exe‎ ومدخل كل خدمة. وحين يصل الترخيص وتُترجَم الخدمات إلى ملفّات تنفيذية،
+//     يعود السطران إلى شكلهما الأول ولا يُعاد كتابة أمر ولا عارضة ولا مسبار ولا مشرف.
+// EN: The installed-appliance profile. Two services, not three: the portal is static files the core
+//     serves via PORTAL_DIST and needs no process. This file is the entire difference between what we
+//     run and what the technician runs; the rest of the CLI never knows which profile it is under.
+//
+//     **Switching packaging strategy costs two lines here and nothing else (017/SC-009).**
+//     This file used to point at core\fantastic-core.exe and fantastic-live.exe — two files that were
+//     never produced, which made appliance mode impossible to detect at all. It now points at what
+//     the bundle actually produces: runtime\node.exe and each service's entry. When licensing lands
+//     and the services are compiled into executables, these two lines revert to their original shape
+//     and no command, renderer, probe or supervisor is rewritten.
+/** جذر التثبيت كما نصّت المعمارية v3 §09. */
+export const APPLIANCE_ROOT = "C:\\Fantastic";
+export const APPLIANCE_DEFAULTS = {
+    // الجهاز عند العميل يخدم المشاهدين على المنفذ 80 فلا يكتب أحد رقم منفذ في المتصفح.
+    corePort: 80,
+    livePort: 8081,
+    logLevel: "info",
+};
+export function createApplianceProfile(options) {
+    const { root, corePort, livePort, logLevel, centralApiUrl, licensePublicKey } = options;
+    /**
+     * AR: إعداد المركز، يُمرَّر **فقط حين يُعرَّف**. تمريرُ سلسلة فارغة أسوأ من الغياب: النواة
+     *     تراها قيمةً مضبوطة فتتخطّى افتراضها، فتقلع بعنوان فارغ ينتهي كل نداء إليه بخطأ عنوان
+     *     لا يشير إلى الإعداد الناقص.
+     * EN: The centre's configuration, passed **only when defined**. Passing an empty string is worse
+     *     than passing nothing: the core reads it as a set value and skips its own default, booting
+     *     with an empty address whose every call ends in a URL error that points nowhere near the
+     *     missing setting.
+     */
+    const centralEnv = {
+        ...(centralApiUrl ? { CENTRAL_API_URL: centralApiUrl } : {}),
+        ...(licensePublicKey ? { LICENSE_PUBLIC_KEY: licensePublicKey } : {}),
+    };
+    const dataDir = join(root, "data");
+    // زمن التشغيل المُجمَّع داخل الحزمة. الجهاز لا يحتاج Node مثبَّتًا (الدستور I).
+    const node = join(root, "runtime", "node.exe");
+    // أدوات الوسائط المُجمَّعة. تُمرَّر صراحةً لأن حزمتَي المُثبِّت مُستبعَدتان من شجرة كل خدمة —
+    // كانتا تُشحنان ثلاث مرّات (017/T034). الخدمتان ترجعان إلى حزمة المُثبِّت إن غاب المتغيّر.
+    const ffmpeg = join(root, "runtime", "ffmpeg.exe");
+    const ffprobe = join(root, "runtime", "ffprobe.exe");
+    const live = {
+        name: "live",
+        label: "Live service",
+        command: node,
+        args: [join(root, "live", "main.js")],
+        cwd: root,
+        env: {
+            LIVE_PORT: String(livePort),
+            LIVE_HOST: "127.0.0.1",
+            DATA_DIR: dataDir,
+            LOG_LEVEL: logLevel,
+            FFMPEG_PATH: ffmpeg,
+            FFPROBE_PATH: ffprobe,
+            NODE_ENV: "production",
+        },
+        host: "127.0.0.1",
+        port: livePort,
+        readiness: { kind: "http", path: "/internal/health" },
+        // AR: **نفس درس النواة، والخطأ نفسه كان هنا أيضًا.** عشرون ثانية بينما الإقلاع التجريبي — على
+        //     آلة تطوير لا على عتاد عميل — قاس ‎21.9‎ و‎22.3‎ و‎27.2‎ في دورات متتالية. أي أن المهلة كانت
+        //     **دون** الزمن المقيس فعلًا، فيفشل التثبيت بعد الهجرات ويتراجع عن نظام صحيح، والرسالة
+        //     «الخدمات لم تبدأ» لا تسمّي خدمة ولا سببًا. الجاهزية تُستقصى فلا يكلّف الانتظار الأطول شيئًا
+        //     حين تُقلع الخدمة في وقتها.
+        // EN: **The core's lesson again, and the same mistake was here too.** Twenty seconds, while the
+        //     smoke boot — on a development machine, not customer hardware — measured 21.9, 22.3 and 27.2
+        //     across consecutive runs. The timeout sat **below** the times actually measured, so the
+        //     install failed after the migrations and rolled back a sound system under a "the services did
+        //     not start" message that named neither service nor cause. Readiness is polled, so a longer
+        //     ceiling costs nothing when the service comes up on time.
+        readyTimeoutMs: 60_000,
+    };
+    const core = {
+        name: "core",
+        label: "Core",
+        command: node,
+        args: [join(root, "core", "main.js")],
+        cwd: root,
+        env: {
+            PORT: String(corePort),
+            HOST: "0.0.0.0",
+            DATA_DIR: dataDir,
+            LOG_LEVEL: logLevel,
+            FFMPEG_PATH: ffmpeg,
+            FFPROBE_PATH: ffprobe,
+            // مجلد الحالة نفسه الذي نقرأ منه ‎config.json‎: تغيير المنفذ من لوحة التحكّم يكتبه هناك،
+            // فيقلع التشغيل التالي عليه. بدونه يبقى إعداد المالك محفوظًا في قاعدته وحدها ولا يُطبَّق (016).
+            FANTASTIC_STATE_DIR: root,
+            // هنا وحده تخدم النواة الواجهة كملفات ثابتة، فلا عملية ثالثة.
+            PORTAL_DIST: join(root, "interface", "client"),
+            LIVE_PORT: String(livePort),
+            LIVE_INTERNAL_URL: `http://127.0.0.1:${livePort}`,
+            NODE_ENV: "production",
+            // التفعيل والتحديثات: بدونهما تقلع النواة بعنوان مركزٍ افتراضيّ ومفتاحٍ عامّ فارغ.
+            ...centralEnv,
+        },
+        host: "0.0.0.0",
+        port: corePort,
+        readiness: { kind: "http", path: "/api/health" },
+        // AR: **أطول مهلة في النظام لأنها على أبطأ آلة.** كانت ٣٠ ثانية — أقلّ من مهلة جهاز التطوير (٤٥)
+        //     ومن مهلة الإقلاع التجريبي (٦٠)، وهو ترتيب مقلوب: جهاز العميل أضعف عتادًا، وأوّل إقلاع
+        //     عنده يحمل ما لا يحمله غيره (هجرات، زرع أوّليّ، تهيئة الصور). والإقلاع التجريبي نفسه قاس
+        //     ‎42‎ و‎47‎ و‎52.7‎ ثانية في ثلاث دورات متتالية على آلة تطوير — أي أن الثلاثين كانت تفشل
+        //     بفارق يسير على أيّ آلة مشغولة.
+        //     وثمن التجاوز فادح: ‎install‎ يعدّ الخدمة ميّتة فيتراجع عن تثبيت **صحيح تمامًا** ويمحوه.
+        //     والانتظار الأطول لا يكلّف شيئًا حين تُقلع الخدمة في وقتها: الجاهزية تُستقصى ولا تُنتظَر كاملة.
+        // EN: **The longest timeout in the system, because it runs on the slowest machine.** It was 30
+        //     seconds — below the development profile's 45 and the smoke boot's 60, which is backwards:
+        //     the customer's appliance is the weaker hardware, and its first boot carries what no other
+        //     does (migrations, initial seeding, image preparation). The smoke boot itself measured 42,
+        //     47 and 52.7 seconds across three consecutive runs on a development machine — so 30 was
+        //     failing by a narrow margin on any busy host.
+        //     And the price of overrunning is severe: `install` reads the service as dead and rolls back a
+        //     **perfectly correct** installation, erasing it. Waiting longer costs nothing when the service
+        //     comes up on time: readiness is polled, not waited out.
+        readyTimeoutMs: 90_000,
+    };
+    return {
+        kind: "appliance",
+        root,
+        dataDir,
+        stateDir: root,
+        logDir: join(root, "logs"),
+        runDir: join(root, "run"),
+        services: [live, core],
+    };
+}
+//# sourceMappingURL=appliance.profile.js.map

package/dist/profiles/appliance.profile.js.map

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

package/dist/profiles/dev.profile.d.ts

@@ -0,0 +1,22 @@
+import type { Profile } from "./types.js";
+export interface DevProfileOptions {
+    /** جذر المستودع. */
+    root: string;
+    corePort: number;
+    livePort: number;
+    portalPort: number;
+    logLevel: string;
+    /**
+     * تجاوز مجلد البيانات. يبقى **مصدرًا واحدًا** رغم التجاوز: النواة وخدمة البث تأخذانه من هنا معًا،
+     * فلا يمكن أن يفترقا. وجوده يتيح تشغيل نسخة اختبار معزولة بلا مساس ببيانات التطوير القائمة.
+     */
+    dataDir?: string;
+}
+export declare const DEV_DEFAULTS: {
+    readonly corePort: 8080;
+    readonly livePort: 8081;
+    readonly portalPort: 3000;
+    readonly logLevel: "debug";
+};
+export declare function createDevProfile(options: DevProfileOptions): Profile;
+//# sourceMappingURL=dev.profile.d.ts.map

package/dist/profiles/dev.profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.profile.d.ts","sourceRoot":"","sources":["../../src/profiles/dev.profile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAqB,MAAM,YAAY,CAAC;AAqB7D,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAoFpE"}

package/dist/profiles/dev.profile.js

@@ -0,0 +1,104 @@
+import { join, resolve } from "node:path";
+// AR: ملفّ التشغيل التطويري: ثلاث عمليات تعمل من المستودع مباشرة عبر سكربتات npm الموجودة أصلًا،
+//     فلا يخترع الـ CLI طريقة إطلاق ثانية تنحرف عن ‎package.json‎ مع الوقت.
+// EN: The development profile: three processes launched straight from the repository through the npm
+//     scripts that already exist, so the CLI does not invent a second launch path that drifts from
+//     package.json over time.
+/**
+ * أمر منطقي لا مسار: طبقة الإطلاق تترجمه إلى استدعاء فعلي (‎node npm-cli.js‎ على ويندوز).
+ * ملفّ التشغيل يقول ماذا نشغّل، لا كيف يُطلق على هذا النظام.
+ */
+const NPM = "npm";
+/**
+ * تُثبَّت صراحةً لأن ‎apps/core/.env‎ يضبطها على ‎production‎، وبيئة العملية تتقدّم على ملف ‎.env‎ في
+ * NestJS. لولا التثبيت لأقلعت النواة في وضع الإنتاج أثناء التطوير: بلا ‎pino-pretty‎ وبسلوك إنتاجي
+ * في كل ما يفحص ‎isProduction‎. اكتُشف بالتشغيل الفعلي لا بالقراءة.
+ */
+const DEV_NODE_ENV = "development";
+export const DEV_DEFAULTS = {
+    corePort: 8080,
+    livePort: 8081,
+    portalPort: 3000,
+    logLevel: "debug",
+};
+export function createDevProfile(options) {
+    const { root, corePort, livePort, portalPort, logLevel } = options;
+    // مجلد بيانات النواة، مطلقًا. هذا هو **الموضع الوحيد** الذي يُقرَّر فيه مكان القاعدة في dev.
+    const dataDir = options.dataDir ? resolve(options.dataDir) : resolve(root, "apps/core/data");
+    const stateDir = join(root, ".fantastic");
+    // خدمة البث تقرأ قاعدة النواة نفسها. تمرير المسار المطلق المشتقّ من ‎dataDir‎ يلغي فخّ الانحراف
+    // الموثّق في ‎apps/live/src/config/env.schema.ts‎: خدمة فتحت ملفًا غير موجود فردّت 403 بلا تفسير.
+    const live = {
+        name: "live",
+        label: "Live service",
+        command: NPM,
+        args: ["run", "dev", "--workspace", "apps/live"],
+        cwd: root,
+        env: {
+            NODE_ENV: DEV_NODE_ENV,
+            LIVE_PORT: String(livePort),
+            LIVE_HOST: "127.0.0.1",
+            DATA_DIR: dataDir,
+            LOG_LEVEL: logLevel,
+        },
+        host: "127.0.0.1",
+        port: livePort,
+        readiness: { kind: "http", path: "/internal/health" },
+        readyTimeoutMs: 20_000,
+    };
+    const core = {
+        name: "core",
+        label: "Core",
+        command: NPM,
+        args: ["run", "dev", "--workspace", "apps/core"],
+        cwd: root,
+        env: {
+            NODE_ENV: DEV_NODE_ENV,
+            PORT: String(corePort),
+            HOST: "0.0.0.0",
+            DATA_DIR: dataDir,
+            LOG_LEVEL: logLevel,
+            // نفس ‎stateDir‎ الذي يقرأ منه ‎resolveProfile‎ ملفَّ ‎config.json‎: تغيير المنفذ من اللوحة
+            // يكتبه هناك، فيلتقطه التشغيل التالي بدل أن يبقى محفوظًا بلا أثر (016).
+            FANTASTIC_STATE_DIR: stateDir,
+            // فارغ في التطوير: Vite يقدّم الواجهة على منفذه، فلا تخدمها النواة كملفات ثابتة.
+            PORTAL_DIST: "",
+            LIVE_PORT: String(livePort),
+            LIVE_INTERNAL_URL: `http://127.0.0.1:${livePort}`,
+        },
+        host: "0.0.0.0",
+        port: corePort,
+        readiness: { kind: "http", path: "/api/health" },
+        readyTimeoutMs: 45_000,
+    };
+    // Vite لا يقدّم نقطة صحة، فاتصال TCP هو الدليل المتاح. مهلته أطول لأن أول تشغيل يبني الاعتماديات.
+    // ‎--port‎ يُمرَّر صراحةً لأن Vite يقرأ منفذه من ‎vite.config.ts‎ لا من البيئة؛ بدونه يصير منفذ
+    // الواجهة في ملفّ التشغيل زينةً لا مصدرًا، وينكسر وعد «مصدر واحد للمنافذ».
+    const portal = {
+        name: "portal",
+        label: "Portal",
+        command: NPM,
+        args: ["run", "dev", "--workspace", "apps/client-portal", "--", "--port", String(portalPort), "--strictPort"],
+        cwd: root,
+        env: {
+            NODE_ENV: DEV_NODE_ENV,
+            VITE_DEV_API_TARGET: `http://localhost:${corePort}`,
+        },
+        host: "0.0.0.0",
+        port: portalPort,
+        readiness: { kind: "tcp" },
+        readyTimeoutMs: 90_000,
+    };
+    return {
+        kind: "dev",
+        root,
+        dataDir,
+        stateDir,
+        logDir: join(stateDir, "logs"),
+        runDir: join(stateDir, "run"),
+        // ترتيب الإقلاع مقصود: النواة بوّابة تجيّر ‎/live/*‎ إلى 8081، فبدؤها قبل خدمة البث يفتح نافذة
+        // ترجع فيها كل قناة 502. الإيقاف يعكس هذا الترتيب.
+        services: [live, core, portal],
+    };
+}
+//# sourceMappingURL=dev.profile.js.map

package/dist/profiles/dev.profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.profile.js","sourceRoot":"","sources":["../../src/profiles/dev.profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG1C,iGAAiG;AACjG,4EAA4E;AAC5E,qGAAqG;AACrG,mGAAmG;AACnG,8BAA8B;AAE9B;;;GAGG;AACH,MAAM,GAAG,GAAG,KAAK,CAAC;AAElB;;;;GAIG;AACH,MAAM,YAAY,GAAG,aAAa,CAAC;AAgBnC,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,IAAI;IAChB,QAAQ,EAAE,OAAO;CACT,CAAC;AAEX,MAAM,UAAU,gBAAgB,CAAC,OAA0B;IACzD,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAEnE,6FAA6F;IAC7F,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAC7F,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAE1C,gGAAgG;IAChG,kGAAkG;IAClG,MAAM,IAAI,GAAsB;QAC9B,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,cAAc;QACrB,OAAO,EAAE,GAAG;QACZ,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,CAAC;QAChD,GAAG,EAAE,IAAI;QACT,GAAG,EAAE;YACH,QAAQ,EAAE,YAAY;YACtB,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC;YAC3B,SAAS,EAAE,WAAW;YACtB,QAAQ,EAAE,OAAO;YACjB,SAAS,EAAE,QAAQ;SACpB;QACD,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE;QACrD,cAAc,EAAE,MAAM;KACvB,CAAC;IAEF,MAAM,IAAI,GAAsB;QAC9B,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,GAAG;QACZ,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,CAAC;QAChD,GAAG,EAAE,IAAI;QACT,GAAG,EAAE;YACH,QAAQ,EAAE,YAAY;YACtB,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC;YACtB,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,OAAO;YACjB,SAAS,EAAE,QAAQ;YACnB,4FAA4F;YAC5F,wEAAwE;YACxE,mBAAmB,EAAE,QAAQ;YAC7B,iFAAiF;YACjF,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC;YAC3B,iBAAiB,EAAE,oBAAoB,QAAQ,EAAE;SAClD;QACD,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE;QAChD,cAAc,EAAE,MAAM;KACvB,CAAC;IAEF,kGAAkG;IAClG,gGAAgG;IAChG,2EAA2E;IAC3E,MAAM,MAAM,GAAsB;QAChC,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,GAAG;QACZ,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC;QAC7G,GAAG,EAAE,IAAI;QACT,GAAG,EAAE;YACH,QAAQ,EAAE,YAAY;YACtB,mBAAmB,EAAE,oBAAoB,QAAQ,EAAE;SACpD;QACD,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;QAC1B,cAAc,EAAE,MAAM;KACvB,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,KAAK;QACX,IAAI;QACJ,OAAO;QACP,QAAQ;QACR,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC9B,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC;QAC7B,+FAA+F;QAC/F,mDAAmD;QACnD,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC;KAC/B,CAAC;AACJ,CAAC"}