@peekling/cli 0.1.0

package/dist/doctor.js

@@ -0,0 +1,121 @@
+import { preflight } from "@peekling/preflight";
+import { parseDataText } from "@peekling/runtime/pack";
+import { lstat, open } from "node:fs/promises";
+import path from "node:path";
+const MAX_DOCTOR_INPUT_BYTES = 64 * 1024;
+export async function runDoctor(configPath, options = {}) {
+    let configuration;
+    try {
+        configuration = await readJsonData(configPath, "configuration");
+    }
+    catch (cause) {
+        return inputFailure("$input.configuration", cause, "Pass a readable JSON Configuration file", options.json);
+    }
+    let pack;
+    if (options.packPath) {
+        try {
+            pack = await readJsonData(options.packPath, "Pack");
+        }
+        catch (cause) {
+            return inputFailure("$input.pack", cause, "Pass a readable JSON Pack file", options.json);
+        }
+    }
+    const report = preflight(configuration, {
+        ...(pack !== undefined ? { pack } : {}),
+        ...(options.baseUrl ? { baseUrl: options.baseUrl } : {}),
+    });
+    return {
+        report,
+        output: options.json ? formatJson(report) : formatHuman(report),
+        exitCode: report.valid ? 0 : 1,
+    };
+}
+function inputFailure(path, cause, fix, json = false) {
+    const report = {
+        valid: false,
+        errors: [
+            {
+                code: "invalid-input",
+                path,
+                message: cause instanceof Error ? cause.message : "Input is invalid",
+                fix,
+            },
+        ],
+        warnings: [],
+    };
+    return {
+        report,
+        output: json ? formatJson(report) : formatHuman(report),
+        exitCode: 1,
+    };
+}
+async function readJsonData(target, label) {
+    if (path.extname(target).toLowerCase() !== ".json") {
+        throw new Error(`${label} input must be a JSON data file. Doctor never imports project code.`);
+    }
+    const initial = await lstat(target);
+    if (initial.isSymbolicLink())
+        throw new Error(`${label} input must not be a symbolic link`);
+    if (!initial.isFile())
+        throw new Error(`${label} input must be a regular file`);
+    if (initial.size > MAX_DOCTOR_INPUT_BYTES) {
+        throw new Error(`${label} input exceeds 65536 bytes`);
+    }
+    const handle = await open(target, "r");
+    try {
+        const opened = await handle.stat();
+        if (!opened.isFile()) {
+            throw new Error(`${label} input must be a regular file`);
+        }
+        if (opened.dev !== initial.dev || opened.ino !== initial.ino) {
+            throw new Error(`${label} input changed before it could be read`);
+        }
+        if (opened.size > MAX_DOCTOR_INPUT_BYTES) {
+            throw new Error(`${label} input exceeds 65536 bytes`);
+        }
+        const bytes = Buffer.alloc(MAX_DOCTOR_INPUT_BYTES + 1);
+        let offset = 0;
+        while (offset < bytes.byteLength) {
+            const result = await handle.read(bytes, offset, bytes.byteLength - offset, offset);
+            if (result.bytesRead === 0)
+                break;
+            offset += result.bytesRead;
+        }
+        if (offset > MAX_DOCTOR_INPUT_BYTES) {
+            throw new Error(`${label} input exceeds 65536 bytes`);
+        }
+        let text;
+        try {
+            text = new TextDecoder("utf-8", { fatal: true }).decode(bytes.subarray(0, offset));
+        }
+        catch (cause) {
+            throw new Error(`${label} input must be valid UTF-8`, { cause });
+        }
+        return parseDataText(text, `${label} ${target}`);
+    }
+    finally {
+        await handle.close();
+    }
+}
+function formatJson(report) {
+    return `${JSON.stringify(report, null, 2)}\n`;
+}
+function formatHuman(report) {
+    const lines = [
+        report.valid
+            ? "Peekling Doctor found no configuration errors."
+            : `Peekling Doctor found ${report.errors.length} configuration error${report.errors.length === 1 ? "" : "s"}.`,
+    ];
+    for (const [label, issues] of [
+        ["ERROR", report.errors],
+        ["WARNING", report.warnings],
+    ]) {
+        for (const issue of issues) {
+            lines.push("", `${label} ${issue.code} at ${issue.path}`, `  ${issue.message}`, `  Fix: ${issue.fix}`);
+        }
+    }
+    if (report.warnings.length > 0) {
+        lines.push("", `${report.warnings.length} warning${report.warnings.length === 1 ? "" : "s"} need review.`);
+    }
+    return `${lines.join("\n")}\n`;
+}

package/dist/image.d.ts

@@ -0,0 +1,4 @@
+import type { ImageStructure } from "@peekling/runtime/pack";
+export type ImageInfo = ImageStructure;
+export declare function inspectImage(buffer: Buffer, fileName: string): ImageInfo;
+//# sourceMappingURL=image.d.ts.map

package/dist/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,MAAM,MAAM,SAAS,GAAG,cAAc,CAAC;AAEvC,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAIxE"}

package/dist/image.js

@@ -0,0 +1,7 @@
+import { inspectImageStructure } from "@peekling/runtime/pack";
+import { inspectPng } from "./png.js";
+export function inspectImage(buffer, fileName) {
+    if (fileName.toLowerCase().endsWith(".png"))
+        return { ...inspectPng(buffer), mimeType: "image/png" };
+    return inspectImageStructure(buffer, "image/webp");
+}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export interface ValidationResult {
+    name: string;
+    version: string;
+    atlas: {
+        width: number;
+        height: number;
+        bytes: number;
+    };
+    states: number;
+}
+export declare function packAuthoringSource(sourceDirectory: string, output: string): Promise<void>;
+export declare function createPack(target: string, name: string): Promise<void>;
+export declare function validatePackDirectory(target: string): Promise<ValidationResult>;
+export interface CodexImportMetadata {
+    license: string;
+    author: string;
+    source: string;
+    rights: string;
+    allowPng?: boolean;
+}
+export declare function importCodexPet(input: string, output: string, metadata: CodexImportMetadata): Promise<void>;
+export { createFixtureAtlas } from "./png.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA6BA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,MAAM,EAAE,MAAM,CAAC;CAChB;AA2FD,wBAAsB,mBAAmB,CACvC,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAmSf;AA+CD,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B5E;AAkHD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC,CAyE3B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA4DD,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,mBAAmB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAsDf;AAED,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}