@synopackageland/cli 0.6.0 → 0.7.0

package/dist/standalone/native-authorization-window.js

@@ -0,0 +1,30 @@
+/** Shared host flow. CGI plans are never accepted as completed authorization. */
+export const AUTHORIZATION_RUNTIME = `function createAuthorizationAccess(options) {
+  var busy = null;
+  function fail(code) { var error = new Error(code); error.code = code; return error; }
+  function status() { return options.call("authorization.status").then(function (d) {
+    if (!d || d.command !== "authorization" || d.schema_version !== 1 || ["ready","authorization_required","not_admin","session_expired","unavailable"].indexOf(d.state) < 0) throw fail("authorization_bad_response");
+    // upgrade_reapproval is a reason-only tombstone: it can only explain a pending request.
+    if (d.reason === "upgrade_reapproval" && d.state !== "authorization_required") throw fail("authorization_bad_response");
+    return d;
+  }); }
+  function plan(method) { return options.call(method).then(function (p) {
+    if (!p || p.command !== "authorization" || p.schema_version !== 1 || p.phase !== "plan" || !Array.isArray(p.operations) || p.operations.length === 0 || p.operations.length > options.tasks.length) throw fail("authorization_bad_response");
+    var seen = {};
+    p.operations.forEach(function (op) { if (seen[op] || !options.tasks.some(function (t) { return t.op === op; })) throw fail("authorization_bad_response"); seen[op] = true; });
+    return p;
+  }); }
+  function exclusive(fn) { if (busy) return busy; busy = Promise.resolve().then(fn).then(function (s) { busy = null; return s; },function (e) { busy = null; throw e; });return busy; }
+  function authorize(ops,run) { return ops.reduce(function (previous,op) { return previous.then(function () {
+    return options.root.authorize(op).then(function (state) { if (state !== "ready") throw fail("root_cancelled"); return run ? options.root.run(op) : null; });
+  }); },Promise.resolve()); }
+  return {canManage:function () {return !!options.user && options.user().admin === true;},status:status,request:function () { return exclusive(function () {
+    return plan("authorization.request").then(function (p) { return authorize(p.operations,p.run === true); }).then(status,function (e) { if (e.code === "root_cancelled") return status();throw e; });
+  }); },revoke:function () { return exclusive(function () {
+    return plan("authorization.revoke").then(function (p) {
+      if (p.withdraw === true && typeof options.withdraw !== "function") throw fail("authorization_bad_response");
+      var disabled = p.withdraw === true ? options.withdraw() : p.disable === true ? authorize(["helper_disable"],true) : Promise.resolve();
+      return disabled.then(function () { return p.purge === true ? authorize(["helper_purge"],true) : null; }).then(function () { return p.operations.reduce(function (previous,op) {return previous.then(function () {return options.root.remove(op);});},Promise.resolve()); });
+    }).then(status,function (e) { if (e.code === "root_cancelled") return status();throw e; });
+  }); }};
+}`;

package/dist/standalone/native-layout.d.ts

@@ -0,0 +1,82 @@
+import { type PackageMetadata } from "../package-metadata.js";
+import type { CommandRunner } from './build.js';
+export declare const LAYOUT_ARCHES: {
+    readonly x86_64: readonly [2, 62];
+    readonly aarch64: readonly [2, 183];
+    readonly armv8: readonly [2, 183];
+    readonly armv7: readonly [1, 40];
+};
+export type LayoutArch = keyof typeof LAYOUT_ARCHES;
+type Hook = {
+    command: string[];
+    cwd: string;
+    env: Record<string, string>;
+};
+type Toolkit = {
+    url: string;
+    sha256: string;
+};
+type Binary = {
+    path: string;
+    linkage: 'static' | 'dynamic';
+    arches?: LayoutArch[];
+};
+export interface NativeLayout {
+    metadata?: PackageMetadata;
+    root: string;
+    package: string;
+    version: string;
+    build: number;
+    displayname: string;
+    description: string;
+    maintainer: string;
+    os_min_ver: string;
+    privilege: 'none';
+    arches: LayoutArch[];
+    schema: 2;
+    backend: {
+        kind: 'native';
+    };
+    layout: {
+        payload: string;
+        metadata: string;
+        binaries: Binary[];
+        anchors?: Record<string, string>;
+    };
+    native: {
+        prepare?: Hook;
+        hook: Hook;
+        toolkits: Partial<Record<LayoutArch, Toolkit[]>>;
+    };
+}
+export declare function isNativeLayout(root: string): boolean;
+export declare function loadNativeLayout(root: string): {
+    ok: true;
+    manifest: NativeLayout;
+} | {
+    ok: false;
+    errors: {
+        code: string;
+        message: string;
+    }[];
+};
+export declare function verifyToolkitArchive(path: string, expected: string): void;
+export declare function layoutFiles(root: string): Array<{
+    path: string;
+    mode: number;
+    sha256: string;
+}>;
+export declare function checkLayoutBinary(root: string, b: Binary, arch: LayoutArch): void;
+export declare function checkLayoutMetadata(root: string, inspection?: boolean, packageId?: string): void;
+export declare function buildNativeLayout(options: {
+    root: string;
+    arches?: string[];
+    outDir?: string;
+    build?: number;
+    minDsm?: string;
+    run?: CommandRunner;
+}): Promise<{
+    outputs: string[];
+}>;
+export declare function inspectNativeLayout(dir: string, payload: string, info: Record<string, string>): string[];
+export {};

package/dist/standalone/native-layout.js

@@ -0,0 +1,377 @@
+import { validateMetadata, metadataInfoFields } from "../package-metadata.js";
+/** Existing native products: the CLI owns archives/INFO, the project owns its layout. */
+import { createHash } from 'node:crypto';
+import { chmodSync, copyFileSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, isAbsolute, join, relative, resolve } from 'node:path';
+import { parse } from 'yaml';
+import { createReproducibleTar } from '../build-spk/reproducible-archive.js';
+import { runCommand } from './build.js';
+import { resolveMinDsm } from '../build-spk/dsm-version.js';
+export const LAYOUT_ARCHES = { x86_64: [2, 62], aarch64: [2, 183], armv8: [2, 183], armv7: [1, 40] };
+function fail(message) { throw Object.assign(new Error(`NATIVE_LAYOUT_INVALID: ${message}`), { code: 'NATIVE_LAYOUT_INVALID' }); }
+const digest = (bytes) => createHash('sha256').update(bytes).digest('hex');
+function object(value, fields) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        fail('expected object');
+    const obj = value;
+    if (Object.keys(obj).some(k => !fields.includes(k)))
+        fail('unknown field');
+    return obj;
+}
+function text(value) {
+    if (typeof value !== 'string' || !value || /[\r\n"\\\0]/.test(value))
+        fail('invalid text');
+    return value;
+}
+function pathText(value) {
+    const path = text(value);
+    if (isAbsolute(path) || path.split('/').some(p => p === '..' || p === '') || /[{}]/.test(path.replaceAll('{arch}', '')))
+        fail('path must stay inside project');
+    return path;
+}
+function inside(root, path) {
+    const full = resolve(root, path);
+    const rel = relative(realpathSync(root), realpathSync(full));
+    if (rel === '..' || rel.startsWith('../') || isAbsolute(rel))
+        fail('path escapes project');
+    return full;
+}
+// Package Center writes INFO as root, so product root helpers can trust these
+// payload digests across upgrades. The synopkgland_ prefix stays reserved.
+function anchors(value) {
+    const a = object(value, Object.keys(value ?? {}));
+    if (Object.keys(a).length > 16)
+        fail('at most 16 INFO anchors');
+    for (const [key, path] of Object.entries(a)) {
+        if (!/^[a-z][a-z0-9_]{0,48}_sha256$/.test(key) || key.startsWith('synopkgland_'))
+            fail(`invalid INFO anchor key: ${key}`);
+        if (pathText(path).includes('{arch}'))
+            fail('INFO anchor path is relative to the architecture payload');
+    }
+    return a;
+}
+function hook(value) {
+    const h = object(value, ['command', 'cwd', 'env']);
+    if (!Array.isArray(h.command) || !h.command.length || !h.command.every((x) => typeof x === 'string' && x.length > 0 && !x.includes('\0')))
+        fail('hook requires argv');
+    const env = object(h.env ?? {}, Object.keys(h.env ?? {}));
+    for (const [key, value] of Object.entries(env))
+        if (!/^[A-Z_][A-Z0-9_]*$/.test(key) || typeof value !== 'string' || value.includes('\0') || key.startsWith('SYNOPKGLAND_'))
+            fail('invalid hook environment');
+    return { command: h.command, cwd: pathText(h.cwd ?? '.'), env };
+}
+export function isNativeLayout(root) {
+    try {
+        return (() => { const raw = parse(readFileSync(join(root, 'dsm-package.yaml'), 'utf8')); return raw?.layout !== undefined || raw?.backend?.kind === 'native'; })();
+    }
+    catch {
+        return false;
+    }
+}
+export function loadNativeLayout(root) {
+    try {
+        const m = object(parse(readFileSync(join(root, 'dsm-package.yaml'), 'utf8')), ['schema', 'backend', 'package', 'version', 'build', 'displayname', 'description', 'maintainer', 'metadata', 'os_min_ver', 'privilege', 'arches', 'layout', 'native']);
+        if (m.schema !== 2)
+            fail('schema 2 required; migrate schema: 1 to schema: 2 and add backend: {kind: native}');
+        const backend = object(m.backend, ['kind']);
+        if (backend.kind !== 'native' || (m.privilege !== undefined && m.privilege !== 'none'))
+            fail('backend.kind: native and package-only privilege required');
+        m.privilege = 'none';
+        if (m.metadata !== undefined)
+            m.metadata = validateMetadata(m.metadata);
+        if (existsSync(join(root, 'compose.yaml')))
+            fail('compose.yaml and dsm-package.yaml are mutually exclusive');
+        if (!/^[A-Za-z][A-Za-z0-9]{1,63}$/.test(text(m.package)) || !/^\d+(\.\d+){0,3}$/.test(text(m.version)) || !/^7\.\d+(\.\d+)?-\d+$/.test(text(m.os_min_ver)))
+            fail('invalid package/version/DSM');
+        if (!Number.isSafeInteger(m.build) || m.build < 1 || m.build > 2147483647)
+            fail('build must be 1..2147483647');
+        for (const k of ['displayname', 'description', 'maintainer'])
+            text(m[k]);
+        if (!Array.isArray(m.arches) || !m.arches.length || new Set(m.arches).size !== m.arches.length || m.arches.some((a) => !Object.hasOwn(LAYOUT_ARCHES, a)))
+            fail('invalid architecture list');
+        const layout = object(m.layout, ['payload', 'metadata', 'binaries', 'anchors']);
+        layout.payload = pathText(layout.payload);
+        layout.metadata = pathText(layout.metadata);
+        if (!Array.isArray(layout.binaries) || !layout.binaries.length)
+            fail('binary assertions required');
+        if (layout.anchors !== undefined)
+            layout.anchors = anchors(layout.anchors);
+        for (const b of layout.binaries) {
+            object(b, ['path', 'linkage', 'arches']);
+            pathText(b.path);
+            if (!['static', 'dynamic'].includes(b.linkage))
+                fail('declare binary linkage');
+            if (b.arches !== undefined && (!Array.isArray(b.arches) || !b.arches.length || b.arches.some((a) => !m.arches.includes(a))))
+                fail('invalid binary arches');
+        }
+        const native = object(m.native, ['prepare', 'hook', 'toolkits']);
+        const toolkits = object(native.toolkits ?? {}, m.arches);
+        for (const entries of Object.values(toolkits)) {
+            if (!Array.isArray(entries) || !entries.length)
+                fail('toolkits require archives');
+            for (const t of entries) {
+                object(t, ['url', 'sha256']);
+                const u = new URL(t.url);
+                if (u.protocol !== 'https:' || u.username || u.password || !/^[a-f0-9]{64}$/.test(t.sha256))
+                    fail('toolkits require HTTPS and SHA-256');
+            }
+        }
+        return { ok: true, manifest: { ...m, root: resolve(root), native: { hook: hook(native.hook), ...(native.prepare ? { prepare: hook(native.prepare) } : {}), toolkits } } };
+    }
+    catch (error) {
+        return { ok: false, errors: [{ code: 'NATIVE_LAYOUT_INVALID', message: String(error) }] };
+    }
+}
+export function verifyToolkitArchive(path, expected) {
+    if (!lstatSync(path).isFile() || digest(readFileSync(path)) !== expected)
+        fail('toolkit checksum mismatch');
+}
+async function toolkitFor(m, arch, run) {
+    const inputs = m.native.toolkits[arch] ?? [];
+    if (!inputs.length)
+        return '';
+    const cache = resolve(process.env.SYNOPKGLAND_CACHE_DIR ?? join(m.root, '.synopkgland-cache'));
+    mkdirSync(cache, { recursive: true, mode: 0o700 });
+    if (lstatSync(cache).isSymbolicLink() || (lstatSync(cache).mode & 0o022))
+        fail('toolkit cache must be owned and private');
+    const archives = [];
+    for (const input of inputs) {
+        const archive = join(cache, `${input.sha256}.txz`);
+        if (!existsSync(archive)) {
+            const download = mkdtempSync(join(cache, '.download-'));
+            try {
+                const out = join(download, 'archive');
+                const r = run('curl', ['--fail', '--location', '--proto', '=https', '--proto-redir', '=https', '--retry', '2', '--retry-all-errors', '--connect-timeout', '20', '--max-time', '600', '--output', out, input.url], { cwd: m.root, env: { ...process.env } });
+                if (r.status !== 0)
+                    fail('toolkit download failed');
+                verifyToolkitArchive(out, input.sha256);
+                renameSync(out, archive);
+            }
+            finally {
+                rmSync(download, { recursive: true, force: true });
+            }
+        }
+        verifyToolkitArchive(archive, input.sha256);
+        archives.push(archive);
+    }
+    // Re-extract verified bytes: a package-writable marker never authenticates an extracted tree.
+    const stage = mkdtempSync(join(cache, `toolkit-${arch}-`));
+    try {
+        for (const archive of archives) {
+            const r = run('tar', ['-xJf', archive, '-C', stage, '--keep-directory-symlink'], { cwd: m.root, env: { ...process.env } });
+            if (r.status !== 0)
+                fail('toolkit extraction failed');
+        }
+        return stage;
+    }
+    catch (e) {
+        rmSync(stage, { recursive: true, force: true });
+        throw e;
+    }
+}
+function runHook(m, h, env, run) {
+    const [cmd, ...args] = h.command;
+    const r = run(cmd, args, { cwd: inside(m.root, h.cwd), env: { ...process.env, ...h.env, ...env } });
+    if (r.status !== 0 || r.missing)
+        fail(`native hook failed: ${r.stderr}`);
+}
+export function layoutFiles(root) {
+    if (!lstatSync(root).isDirectory() || lstatSync(root).isSymbolicLink())
+        fail('layout root must be a regular directory');
+    const files = [];
+    let total = 0;
+    const walk = (prefix) => {
+        for (const name of readdirSync(join(root, prefix)).sort()) {
+            const path = prefix ? `${prefix}/${name}` : name;
+            const s = lstatSync(join(root, path));
+            if (s.isSymbolicLink() || (!s.isFile() && !s.isDirectory()))
+                fail('layout contains symlink or special file');
+            if (s.mode & 0o6000)
+                fail('privileged file modes are forbidden');
+            if (s.isDirectory())
+                walk(path);
+            else {
+                total += s.size;
+                if (s.size > 256 * 1024 * 1024 || total > 1024 * 1024 * 1024)
+                    fail('layout exceeds size bound');
+                files.push({ path, mode: s.mode & 0o111 ? 0o755 : 0o644, sha256: digest(readFileSync(join(root, path))) });
+            }
+        }
+    };
+    walk('');
+    return files;
+}
+export function checkLayoutBinary(root, b, arch) {
+    const path = inside(root, b.path);
+    const bytes = readFileSync(path);
+    const [cls, machine] = LAYOUT_ARCHES[arch];
+    if (bytes.length < 64 || bytes.toString('latin1', 0, 4) !== '\x7fELF' || bytes[4] !== cls || bytes[5] !== 1 || bytes.readUInt16LE(18) !== machine || ![2, 3].includes(bytes.readUInt16LE(16)))
+        fail(`ELF architecture mismatch: ${b.path}`);
+    const offset = cls === 1 ? bytes.readUInt32LE(28) : Number(bytes.readBigUInt64LE(32));
+    const size = bytes.readUInt16LE(cls === 1 ? 42 : 54);
+    const count = bytes.readUInt16LE(cls === 1 ? 44 : 56);
+    if (!count || size < (cls === 1 ? 32 : 56) || !Number.isSafeInteger(offset) || offset + size * count > bytes.length)
+        fail('invalid ELF program headers');
+    let dynamic = false;
+    for (let i = 0; i < count; i++)
+        if (bytes.readUInt32LE(offset + size * i) === 3)
+            dynamic = true;
+    if (dynamic !== (b.linkage === 'dynamic'))
+        fail(`ELF linkage mismatch: ${b.path}`);
+    if (!(lstatSync(path).mode & 0o111))
+        fail(`binary must be executable: ${b.path}`);
+}
+function copyTree(from, to) {
+    const entries = layoutFiles(from);
+    for (const entry of entries) {
+        const out = join(to, entry.path);
+        mkdirSync(dirname(out), { recursive: true });
+        copyFileSync(join(from, entry.path), out);
+        chmodSync(out, entry.mode);
+    }
+    return entries;
+}
+export function checkLayoutMetadata(root, inspection = false, packageId) {
+    layoutFiles(root);
+    const p = object(JSON.parse(readFileSync(join(root, 'conf/privilege'), 'utf8')), ['defaults', 'username', 'groupname']);
+    object(p.defaults, ['run-as']);
+    if (p.defaults?.['run-as'] !== 'package' || Object.keys(p).some(k => !['defaults', 'username', 'groupname'].includes(k)) || ['username', 'groupname'].some(k => p[k] !== undefined && p[k] !== packageId) || Object.keys(p.defaults).some(k => k !== 'run-as'))
+        fail('native layout requires package-only lifecycle privilege');
+    if (!existsSync(join(root, 'scripts/start-stop-status')))
+        fail('start-stop-status missing');
+    if (existsSync(join(root, 'conf/resource'))) {
+        const resource = object(JSON.parse(readFileSync(join(root, 'conf/resource'), 'utf8')), ['systemd-unit']);
+        if (resource['systemd-unit'] !== undefined && Object.keys(object(resource['systemd-unit'], [])).length)
+            fail('unsupported resource worker');
+    }
+    if (existsSync(join(root, 'conf/systemd'))) {
+        for (const entry of layoutFiles(join(root, 'conf/systemd'))) {
+            const unit = readFileSync(join(root, 'conf/systemd', entry.path), 'utf8');
+            // Keep the package-only grammar unambiguous; systemd joins continued lines
+            // before interpreting Exec prefixes, which a physical-line check misses.
+            if (/\\\s*$/m.test(unit))
+                fail('systemd unit continuations are unsupported');
+            let section = '';
+            for (const line of unit.split('\n')) {
+                const heading = line.match(/^\s*\[([^\]]+)\]\s*$/);
+                if (heading)
+                    section = heading[1];
+                if (/^\s*(?:User|Group|Exec\w*)\s*=/.test(line) && section !== 'Service')
+                    fail('systemd execution directives require the package Service section');
+            }
+            if (!/^[^/]+\.service$/.test(entry.path))
+                fail('only package service units are supported');
+            const users = [...unit.matchAll(/^\s*User\s*=\s*(.*?)\s*$/gm)].map(m => m[1]);
+            const groups = [...unit.matchAll(/^\s*Group\s*=\s*(.*?)\s*$/gm)].map(m => m[1]);
+            if (!packageId || users.length !== 1 || users[0] !== packageId || groups.some(group => group !== packageId) || /^\s*(?:AmbientCapabilities|SupplementaryGroups|PermissionsStartOnly|RootDirectory|RootImage)\s*=/m.test(unit) || /^\s*Exec\w*\s*=\s*[-:@|]*[+!]/m.test(unit))
+                fail('systemd unit must run only as the package account');
+        }
+    }
+    for (const name of readdirSync(root))
+        if (!['conf', 'scripts', 'WIZARD_UIFILES', 'PACKAGE_ICON.PNG', 'PACKAGE_ICON_256.PNG', ...(inspection ? ['INFO', 'package.tgz', 'native-layout.json', 'layout-inspection', 'syno_signature.asc'] : [])].includes(name))
+            fail(`unsupported SPK metadata: ${name}`);
+    for (const f of layoutFiles(root)) {
+        if (f.path.startsWith('scripts/') && /\bsudo\b|\bchown\s+root\b|chmod\s+[ugo]*\+s\b/.test(readFileSync(join(root, f.path), 'utf8')))
+            fail('root lifecycle operation forbidden');
+    }
+}
+export async function buildNativeLayout(options) {
+    const loaded = loadNativeLayout(options.root);
+    if (!loaded.ok)
+        fail(loaded.errors.map(e => e.message).join('\n'));
+    const m = loaded.manifest;
+    if (options.minDsm !== undefined)
+        m.os_min_ver = resolveMinDsm(options.minDsm);
+    if (options.build !== undefined) {
+        if (!Number.isSafeInteger(options.build) || options.build < 1 || options.build > 2147483647)
+            fail('invalid build override');
+        m.build = options.build;
+    }
+    const arches = options.arches ?? m.arches;
+    if (!arches.length || new Set(arches).size !== arches.length || arches.some(a => !m.arches.includes(a)))
+        fail('architecture not declared');
+    const run = options.run ?? runCommand;
+    const version = `${m.version}-${String(m.build).padStart(4, '0')}`;
+    const env = { SYNOPKGLAND_PACKAGE: m.package, SYNOPKGLAND_VERSION: m.version, SYNOPKGLAND_BUILD: String(m.build), SYNOPKGLAND_SPK_VERSION: version, SYNOPKGLAND_PROJECT_DIR: m.root };
+    if (m.native.prepare)
+        runHook(m, m.native.prepare, env, run);
+    const outputs = [];
+    for (const requested of arches) {
+        const arch = requested;
+        const toolkit = await toolkitFor(m, arch, run);
+        const stage = mkdtempSync(join(tmpdir(), 'synopkgland-layout-'));
+        try {
+            runHook(m, m.native.hook, { ...env, SYNOPKGLAND_ARCH: arch, SYNOPKGLAND_TOOLKIT_DIR: toolkit }, run);
+            const payload = inside(m.root, m.layout.payload.replaceAll('{arch}', arch));
+            const metadata = inside(m.root, m.layout.metadata);
+            checkLayoutMetadata(metadata, false, m.package);
+            layoutFiles(payload);
+            const binaries = m.layout.binaries.filter(b => !b.arches || b.arches.includes(arch));
+            if (!binaries.length)
+                fail("binary assertions required for every architecture");
+            for (const b of binaries)
+                checkLayoutBinary(payload, b, arch);
+            copyTree(metadata, stage);
+            const target = join(stage, 'payload');
+            mkdirSync(target);
+            const files = copyTree(payload, target);
+            await createReproducibleTar(target, join(stage, 'package.tgz'), { gzip: true });
+            rmSync(target, { recursive: true });
+            const fields = { package: m.package, version, arch, os_min_ver: m.os_min_ver, displayname: m.displayname, description: m.description, maintainer: m.maintainer, dsmuidir: 'ui', dsmappname: `SYNO.SDS.${m.package}.Instance`, startable: 'yes', thirdparty: 'yes', checksum: createHash('md5').update(readFileSync(join(stage, 'package.tgz'))).digest('hex') };
+            const info = [...Object.entries(fields), ...metadataInfoFields(m.metadata), ...anchorFields(m.layout.anchors ?? {}, files)];
+            if (new Set(info.map(([k]) => k)).size !== info.length)
+                fail('INFO anchor collides with an INFO field');
+            writeFileSync(join(stage, 'INFO'), info.map(([k, v]) => `${k}="${v.replace(/([\\"$`])/g, '\\$1')}"\n`).join(''));
+            writeFileSync(join(stage, 'native-layout.json'), JSON.stringify({ format: 1, arch, binaries: binaries.map(({ path, linkage }) => ({ path, linkage })), files, ...(m.layout.anchors ? { anchors: m.layout.anchors } : {}) }));
+            const output = join(options.outDir ?? join(m.root, 'dist'), `${m.package}-${version}-${arch}.spk`);
+            mkdirSync(dirname(output), { recursive: true });
+            await createReproducibleTar(stage, output);
+            outputs.push(output);
+        }
+        finally {
+            rmSync(stage, { recursive: true, force: true });
+            if (toolkit)
+                rmSync(toolkit, { recursive: true, force: true });
+        }
+    }
+    return { outputs };
+}
+export function inspectNativeLayout(dir, payload, info) {
+    try {
+        if (!/^[A-Za-z][A-Za-z0-9]{1,63}$/.test(info.package ?? '') || !/^\d+(\.\d+){0,3}-\d+$/.test(info.version ?? '') || !/^7\.\d+(\.\d+)?-\d+$/.test(info.os_min_ver ?? ''))
+            fail('invalid native INFO identity/version/DSM');
+        const inv = object(JSON.parse(readFileSync(join(dir, 'native-layout.json'), 'utf8')), ['format', 'arch', 'binaries', 'files', 'anchors']);
+        if (inv.format !== 1 || inv.arch !== info.arch || !Object.hasOwn(LAYOUT_ARCHES, inv.arch))
+            fail('invalid native layout inventory');
+        checkLayoutMetadata(dir, true, info.package);
+        const actual = layoutFiles(payload);
+        if (JSON.stringify(actual) !== JSON.stringify(inv.files))
+            fail('payload checksum or mode mismatch');
+        if (!Array.isArray(inv.binaries) || !inv.binaries.length)
+            fail('missing binary assertions');
+        for (const b of inv.binaries) {
+            object(b, ['path', 'linkage']);
+            pathText(b.path);
+            if (!['static', 'dynamic'].includes(b.linkage))
+                fail('invalid linkage');
+            checkLayoutBinary(payload, b, inv.arch);
+        }
+        if (createHash('md5').update(readFileSync(join(dir, 'package.tgz'))).digest('hex') !== info.checksum)
+            fail('package checksum mismatch');
+        checkInfoAnchors(readFileSync(join(dir, 'INFO'), 'utf8'), inv.anchors === undefined ? {} : anchors(inv.anchors), actual);
+        return [];
+    }
+    catch (e) {
+        return [String(e)];
+    }
+}
+function anchorFields(declared, files) {
+    return Object.entries(declared).map(([key, path]) => [key, files.find(f => f.path === path)?.sha256 ?? fail(`INFO anchor file missing: ${path}`)]);
+}
+function checkInfoAnchors(info, declared, files) {
+    const lines = info.split('\n').filter(line => /^[a-z0-9_]+_sha256=/.test(line));
+    const expected = anchorFields(declared, files).map(([key, digest]) => `${key}="${digest}"`);
+    if (JSON.stringify(lines.sort()) !== JSON.stringify(expected.sort()))
+        fail('INFO anchors do not match the payload');
+}

package/dist/standalone/native-root-window.d.ts

@@ -0,0 +1,26 @@
+/** Build-time adapter for explicitly approved native product tasks. */
+/** What the window embeds per root operation: the task it may create, and how to recognize it. */
+export interface RootTask {
+    op: string;
+    name: string;
+    header: string;
+    script: string;
+    /** Whether the package backend serves `root.output` for this op; helper ops report through the helper instead. */
+    output: boolean;
+}
+/**
+ * `createRootAccess(options)` → `{ state, authorize, run, remove }`, plain
+ * ES5 for DSM's desktop. Every DSM call goes through `options.send` (the
+ * AppWindow's sendWebAPI) as the signed-in administrator:
+ *
+ * - authorize: DSM's own password confirmation, then one disabled root task
+ *   with exactly the embedded script. The one-use token goes into that single
+ *   create call and is never kept.
+ * - run: re-reads the task and runs it only if it is still exactly ours, then
+ *   waits for its history entry and asks the backend for the output. Repair
+ *   additionally requires fresh PasswordConfirm and another exact task check.
+ * - an older version of our task is "outdated" and never runs; authorizing
+ *   again replaces it. A same-named task that is not ours is a "conflict" and
+ *   is never run, replaced or deleted.
+ */
+export declare const ROOT_RUNTIME = "function createRootAccess(options) {\n  var API = \"SYNO.Core.TaskScheduler\";\n  var POLL_MS = 500, POLLS = 60;\n  var byOp = {}, running = {};\n  var legacy = null, probe = null;\n  options.tasks.forEach(function (task) { byOp[task.op] = task; });\n\n  function fail(code) {\n    var error = new Error(code);\n    error.code = code;\n    return error;\n  }\n  function begin(op) {\n    if (!Object.prototype.hasOwnProperty.call(byOp, op)) return Promise.reject(fail(\"root_unknown_op\"));\n    if (options.user().admin !== true) return Promise.reject(fail(\"admin_required\"));\n    return Promise.resolve(byOp[op]);\n  }\n  function readOutput(task) {\n    return task.output ? options.call(\"root.output\", { op: task.op }) : Promise.resolve(null);\n  }\n  function isRootTask(summary) {\n    return summary.owner === \"root\" && summary.real_owner === \"root\" && summary.enable === false && summary.type === \"script\";\n  }\n  function listTasks() {\n    if (legacy === false) return options.send(API, \"list\", 3, { start: 0, limit: 500 });\n    if (legacy === true) return legacyList();\n    if (!probe) {\n      probe = options.send(API, \"list\", 3, { start: 0, limit: 500 }).then(function (data) {\n        legacy = false;\n        return data;\n      }, function (error) {\n        if (!error || (error.code !== \"dsm_103\" && error.code !== 103)) {\n          probe = null;\n          throw error;\n        }\n        legacy = true;\n        return legacyList();\n      });\n    }\n    return probe;\n  }\n  function legacyList() {\n    return options.send(API, \"list\", 2, { offset: 0, limit: 500 }).then(function (data) {\n      // Refuse a truncated snapshot: a same-named task could lie outside it.\n      if (!data || !Array.isArray(data.tasks) || data.tasks.length > 500\n          || !(typeof data.total === \"number\" && isFinite(data.total) && Math.floor(data.total) === data.total) || data.total !== data.tasks.length) throw fail(\"root_bad_response\");\n      return data;\n    });\n  }\n  function readTask(ref) {\n    return options.send(API, \"get\", legacy ? 3 : 4, ref);\n  }\n  function createTask(params) {\n    return options.send(legacy ? API : API + \".Root\", \"create\", legacy ? 3 : 4, params);\n  }\n  function deleteTask(ref) {\n    return options.send(API, \"delete\", 2, { tasks: [ref] });\n  }\n  function runTask(ref) {\n    return options.send(API, \"run\", 2, { tasks: [ref] });\n  }\n  function find(task) {\n    return listTasks().then(function (data) {\n      if (!data || !Array.isArray(data.tasks)) throw fail(\"root_bad_response\");\n      var named = data.tasks.filter(function (summary) { return summary && summary.name === task.name; });\n      if (named.length === 0) return { state: \"missing\" };\n      if (named.length > 1 || !isRootTask(named[0])) return { state: \"conflict\" };\n      var ref = { id: named[0].id, real_owner: named[0].real_owner };\n      return readTask(ref).then(function (detail) {\n        var script = detail && detail.extra && detail.extra.script;\n        if (!detail || String(detail.id) !== String(ref.id) || detail.name !== task.name\n            || detail.owner !== \"root\" || detail.real_owner !== ref.real_owner || detail.enable !== false || detail.type !== \"script\" || typeof script !== \"string\") {\n          return { state: \"conflict\" };\n        }\n        if (script === task.script) return { state: \"ready\", ref: ref };\n        if (script.indexOf(task.header) === 0) return { state: \"outdated\", ref: ref };\n        return { state: \"conflict\" };\n      });\n    });\n  }\n  function definition(task, user) {\n    var hours = [];\n    for (var h = 1; h <= 23; h++) hours.push(h);\n    return {\n      name: task.name,\n      real_owner: user,\n      owner: \"root\",\n      enable: false,\n      type: \"script\",\n      schedule: {\n        date_type: 0, week_day: \"0,1,2,3,4,5,6\", repeat_date: 1001, monthly_week: [], hour: 0, minute: 0,\n        repeat_hour: 0, repeat_min: 0, last_work_hour: 0,\n        repeat_min_store_config: [1, 5, 10, 15, 20, 30], repeat_hour_store_config: hours\n      },\n      extra: { notify_enable: false, script: task.script, notify_mail: \"\", notify_if_error: false }\n    };\n  }\n  function newest(history) {\n    if (!Array.isArray(history)) throw fail(\"root_bad_response\");\n    return history.reduce(function (latest, entry) {\n      return entry && (!latest || Number(entry.timestamp) > Number(latest.timestamp)) ? entry : latest;\n    }, null);\n  }\n  function history(ref) {\n    return options.send(API, \"get_history_status_list\", 1, { id: ref.id }).then(newest);\n  }\n  function waitForRun(ref, before, polls) {\n    return history(ref).then(function (latest) {\n      var finished = latest && (!before || latest.timestamp !== before.timestamp)\n        && latest.exit_type !== \"running\" && latest.stop_time;\n      if (finished) {\n        if (latest.exit_code !== 0) throw fail(\"root_task_failed\");\n        return;\n      }\n      if (polls <= 1) throw fail(\"root_timeout\");\n      return options.wait(POLL_MS).then(function () { return waitForRun(ref, before, polls - 1); });\n    });\n  }\n\n  function validTime(value) {\n    if (typeof value !== \"string\" || !/^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$/.test(value)) return false;\n    var normalized = value.replace(\" \", \"T\") + \"Z\";\n    var date = new Date(normalized);\n    return !isNaN(date.getTime()) && date.toISOString().slice(0, 19) === normalized.slice(0, 19);\n  }\n  function bounded(call, deadline) {\n    // A poll count alone cannot bound a stalled DSM callback. Discard late replies.\n    return new Promise(function (resolve, reject) {\n      var remaining = deadline - Date.now();\n      if (remaining <= 0) { reject(fail(\"root_timeout\")); return; }\n      var timer = setTimeout(function () { reject(fail(\"root_timeout\")); }, remaining);\n      Promise.resolve().then(call).then(function (value) {\n        clearTimeout(timer);\n        if (Date.now() >= deadline) reject(fail(\"root_timeout\"));\n        else resolve(value);\n      }, function (error) { clearTimeout(timer); reject(error); });\n    });\n  }\n  function legacyHistory(ref, deadline) {\n    return bounded(function () { return options.send(API, \"view\", 1, { id: ref.id }); }, deadline).then(function (records) {\n      // DSM 7.1 omits data entirely when a task has never run.\n      if (records === undefined) records = [];\n      if (!Array.isArray(records) || records.length > 500) throw fail(\"root_bad_response\");\n      var seen = {};\n      records.forEach(function (record) {\n        if (!record || !validTime(record.start_time) || typeof record.stop_time !== \"string\"\n            || (record.stop_time && (!validTime(record.stop_time) || record.stop_time < record.start_time))\n            || typeof record.exit_type !== \"string\" || !(typeof record.exit_code === \"number\" && isFinite(record.exit_code) && Math.floor(record.exit_code) === record.exit_code)\n            || seen[record.start_time]) throw fail(\"root_bad_response\");\n        seen[record.start_time] = true;\n      });\n      return records;\n    });\n  }\n  function waitForLegacyRun(ref, before, deadline, polls) {\n    return legacyHistory(ref, deadline).then(function (records) {\n      var previous = before.map(function (record) { return record.start_time; });\n      var newestBefore = previous.slice().sort().pop();\n      var fresh = records.filter(function (record) { return previous.indexOf(record.start_time) === -1; });\n      if (fresh.length > 1) throw fail(\"root_bad_response\");\n      var latest = fresh[0];\n      if (latest && (!newestBefore || latest.start_time > newestBefore) && latest.stop_time) {\n        if (latest.exit_code !== 0 || latest.exit_type !== \"normal\") throw fail(\"root_task_failed\");\n        return;\n      }\n      if (polls <= 1 || Date.now() >= deadline) throw fail(\"root_timeout\");\n      return options.wait(Math.min(POLL_MS, deadline - Date.now())).then(function () {\n        return waitForLegacyRun(ref, before, deadline, polls - 1);\n      });\n    });\n  }\n  function execute(task, verified) {\n    if (!legacy) {\n      return history(verified.ref).then(function (before) {\n        return runTask(verified.ref).then(function () { return waitForRun(verified.ref, before, POLLS); });\n      });\n    }\n    var deadline = Date.now() + POLL_MS * POLLS;\n    return legacyHistory(verified.ref, deadline).then(function (before) {\n      if (before.some(function (record) { return !record.stop_time || record.exit_type === \"running\"; })) throw fail(\"root_not_ready\");\n      // Mutating calls are sent exactly once, never retried with another profile.\n      return bounded(function () { return runTask(verified.ref); }, deadline).then(function () {\n        return waitForLegacyRun(verified.ref, before, deadline, POLLS);\n      });\n    }).then(function () {\n      return bounded(function () { return find(task); }, deadline).then(function (after) {\n        if (after.state !== \"ready\" || String(after.ref.id) !== String(verified.ref.id)) throw fail(\"root_verify_failed\");\n      });\n    });\n  }\n  function performRun(op) {\n    return begin(op).then(function (task) {\n      return find(task).then(function (found) {\n        if (found.state !== \"ready\") throw fail(\"root_not_ready\");\n        var consent = op === \"helper_repair\" ? options.confirmPassword() : Promise.resolve({ confirmed: true });\n        return consent.then(function (confirmation) {\n          if (!confirmation || confirmation.confirmed !== true) throw fail(\"root_cancelled\");\n          return op === \"helper_repair\" ? begin(op).then(find) : found;\n        }).then(function (verified) {\n          if (verified.state !== \"ready\") throw fail(\"root_not_ready\");\n          return execute(task, verified);\n        });\n      }).then(function () { return readOutput(task); });\n    });\n  }\n\n  return {\n    state: function (op) {\n      return begin(op).then(find).then(function (found) { return found.state; });\n    },\n    authorize: function (op) {\n      return begin(op).then(function (task) {\n        return find(task).then(function (found) {\n          if (found.state === \"ready\") return \"ready\";\n          if (found.state === \"conflict\") throw fail(\"root_conflict\");\n          return options.confirmPassword().then(function (confirmation) {\n            if (!confirmation || confirmation.confirmed !== true) return \"cancelled\";\n            if (!legacy && (typeof confirmation.token !== \"string\" || !confirmation.token)) throw fail(\"root_verify_failed\");\n            var params = definition(task, options.user().name);\n            if (!legacy) params.SynoConfirmPWToken = confirmation.token;\n            // Re-read after the legacy client-side dialog before replacing a task.\n            var checked = legacy ? begin(op).then(find) : Promise.resolve(found);\n            return checked.then(function (current) {\n              if (current.state === \"conflict\") throw fail(\"root_conflict\");\n              if (current.state === \"ready\") return;\n              var replaced = current.state === \"outdated\" ? deleteTask(current.ref) : Promise.resolve();\n              return replaced.then(function () { return createTask(params); });\n            }).then(function () {\n              return find(task);\n            }).then(function (after) {\n              if (after.state !== \"ready\") throw fail(\"root_verify_failed\");\n              return \"ready\";\n            });\n          });\n        });\n      });\n    },\n    run: function (op) {\n      if (!Object.prototype.hasOwnProperty.call(byOp, op)) return Promise.reject(fail(\"root_unknown_op\"));\n      if (options.user().admin !== true) return Promise.reject(fail(\"admin_required\"));\n      if (running[op]) return running[op];\n      var pending = performRun(op).then(function (value) {\n        delete running[op];\n        return value;\n      }, function (error) { delete running[op]; throw error; });\n      running[op] = pending;\n      return pending;\n    },\n    remove: function (op) {\n      return begin(op).then(function (task) {\n        return find(task).then(function (found) {\n          if (found.state === \"missing\") return \"missing\";\n          if (found.state === \"conflict\") throw fail(\"root_conflict\");\n          return deleteTask(found.ref).then(function () {\n            return find(task);\n          }).then(function (after) {\n            if (after.state !== \"missing\") throw fail(\"root_verify_failed\");\n            return \"missing\";\n          });\n        });\n      });\n    },\n    output: function (op) {\n      return begin(op).then(readOutput);\n    }\n  };\n}";