@gtkx/cli 2.0.0-beta.1 → 2.0.0-beta.3

package/dist/internal/entry-arg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry-arg.d.ts","sourceRoot":"","sources":["../../src/internal/entry-arg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAS5D,QAAA,MAAM,MAAM,EAAE;IAAE,GAAG,EAAE,YAAY,CAAA;CAKhC,CAAC;AAEF,QAAA,MAAM,QAAQ,EAAE;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,GAAG,EAAE,YAAY,CAAA;CAO3D,CAAC;AAEF,QAAA,MAAM,UAAU,GAAI,MAAM;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,MAAwD,CAAC;AA+BtG,QAAA,MAAM,YAAY,GAAI,KAAK,MAAM,EAAE,OAAO,MAAM,GAAG,SAAS,KAAG,MACK,CAAC;AAErE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"entry-arg.d.ts","sourceRoot":"","sources":["../../src/internal/entry-arg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAS5D,QAAA,MAAM,MAAM,EAAE;IAAE,GAAG,EAAE,YAAY,CAAA;CAKhC,CAAC;AAEF,QAAA,MAAM,SAAS,EAAE;IAAE,MAAM,EAAE,YAAY,CAAA;CAKtC,CAAC;AAEF,QAAA,MAAM,QAAQ,EAAE;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,GAAG,EAAE,YAAY,CAAA;CAO3D,CAAC;AAEF,QAAA,MAAM,UAAU,GAAI,MAAM;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,MAAwD,CAAC;AA+BtG,QAAA,MAAM,YAAY,GAAI,KAAK,MAAM,EAAE,OAAO,MAAM,GAAG,SAAS,KAAG,MACK,CAAC;AAErE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC"}

package/dist/internal/entry-arg.js

@@ -10,6 +10,12 @@ const cwdArg = {
         description: "Project root (default: current working directory)",
     },
 };
+const configArg = {
+    config: {
+        type: "string",
+        description: "Project-relative configuration file (default: gtkx.config.*)",
+    },
+};
 const entryArg = {
     entry: {
         type: "positional",
@@ -39,5 +45,5 @@ const resolveGivenEntry = (cwd, entry) => {
     return path;
 };
 const resolveEntry = (cwd, entry) => entry ? resolveGivenEntry(cwd, entry) : resolveDefaultEntry(cwd);
-export { cwdArg, entryArg, resolveCwd, resolveEntry };
+export { configArg, cwdArg, entryArg, resolveCwd, resolveEntry };
 //# sourceMappingURL=entry-arg.js.map

package/dist/internal/entry-arg.js.map

@@ -1 +1 @@
-{"version":3,"file":"entry-arg.js","sourceRoot":"","sources":["../../src/internal/entry-arg.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,kBAAkB,GAAG,WAAW,CAAC;AACvC,MAAM,wBAAwB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAChE,MAAM,wBAAwB,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,kBAAkB,GAAG,SAAS,EAAE,CAAC,CAAC;AAClH,MAAM,aAAa,GAAG,GAAG,kBAAkB,IAAI,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAErF,MAAM,MAAM,GAA0B;IAClC,GAAG,EAAE;QACD,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,mDAAmD;KACnE;CACJ,CAAC;AAEF,MAAM,QAAQ,GAAmD;IAC7D,KAAK,EAAE;QACH,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,wBAAwB,aAAa,GAAG;QACrD,QAAQ,EAAE,KAAK;KAClB;IACD,GAAG,MAAM;CACZ,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,IAAsB,EAAU,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACtG,MAAM,MAAM,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;AAEvG,MAAM,wBAAwB,GAAG,CAAC,GAAW,EAAS,EAAE,CACpD,IAAI,KAAK,CACL,0BAA0B,GAAG,gBAAgB,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;IACpF,qCAAqC,CACxC,CAAC;AAEN,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAU,EAAE;IAChD,KAAK,MAAM,SAAS,IAAI,wBAAwB,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAErC,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED,MAAM,wBAAwB,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,GAAW,EAAE,KAAa,EAAU,EAAE;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAEjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,GAAG,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,KAAyB,EAAU,EAAE,CACpE,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;AAErE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC","sourcesContent":["import type { PositionalArgDef, StringArgDef } from \"citty\";\nimport { statSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nconst DEFAULT_ENTRY_BASE = \"src/index\";\nconst DEFAULT_ENTRY_EXTENSIONS = [\".tsx\", \".jsx\", \".ts\", \".js\"];\nconst DEFAULT_ENTRY_CANDIDATES = DEFAULT_ENTRY_EXTENSIONS.map((extension) => `${DEFAULT_ENTRY_BASE}${extension}`);\nconst DEFAULT_ENTRY = `${DEFAULT_ENTRY_BASE}{${DEFAULT_ENTRY_EXTENSIONS.join(\",\")}}`;\n\nconst cwdArg: { cwd: StringArgDef } = {\n    cwd: {\n        type: \"string\",\n        description: \"Project root (default: current working directory)\",\n    },\n};\n\nconst entryArg: { entry: PositionalArgDef; cwd: StringArgDef } = {\n    entry: {\n        type: \"positional\",\n        description: `Entry file (default: ${DEFAULT_ENTRY})`,\n        required: false,\n    },\n    ...cwdArg,\n};\n\nconst resolveCwd = (args: { cwd?: string }): string => (args.cwd ? resolve(args.cwd) : process.cwd());\nconst isFile = (path: string): boolean => statSync(path, { throwIfNoEntry: false })?.isFile() === true;\n\nconst missingDefaultEntryError = (cwd: string): Error =>\n    new Error(\n        `No entry file found in ${cwd}. Looked for ${DEFAULT_ENTRY_CANDIDATES.join(\", \")}; ` +\n        \"pass the entry file as an argument.\",\n    );\n\nconst resolveDefaultEntry = (cwd: string): string => {\n    for (const candidate of DEFAULT_ENTRY_CANDIDATES) {\n        const path = resolve(cwd, candidate);\n\n        if (isFile(path)) {\n            return path;\n        }\n    }\n\n    throw missingDefaultEntryError(cwd);\n};\n\nconst resolveGivenEntry = (cwd: string, entry: string): string => {\n    const path = resolve(cwd, entry);\n\n    if (!isFile(path)) {\n        throw new Error(`No entry file at ${path}.`);\n    }\n\n    return path;\n};\n\nconst resolveEntry = (cwd: string, entry: string | undefined): string =>\n    entry ? resolveGivenEntry(cwd, entry) : resolveDefaultEntry(cwd);\n\nexport { cwdArg, entryArg, resolveCwd, resolveEntry };\n"]}
+{"version":3,"file":"entry-arg.js","sourceRoot":"","sources":["../../src/internal/entry-arg.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,kBAAkB,GAAG,WAAW,CAAC;AACvC,MAAM,wBAAwB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAChE,MAAM,wBAAwB,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,kBAAkB,GAAG,SAAS,EAAE,CAAC,CAAC;AAClH,MAAM,aAAa,GAAG,GAAG,kBAAkB,IAAI,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAErF,MAAM,MAAM,GAA0B;IAClC,GAAG,EAAE;QACD,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,mDAAmD;KACnE;CACJ,CAAC;AAEF,MAAM,SAAS,GAA6B;IACxC,MAAM,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,8DAA8D;KAC9E;CACJ,CAAC;AAEF,MAAM,QAAQ,GAAmD;IAC7D,KAAK,EAAE;QACH,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,wBAAwB,aAAa,GAAG;QACrD,QAAQ,EAAE,KAAK;KAClB;IACD,GAAG,MAAM;CACZ,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,IAAsB,EAAU,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACtG,MAAM,MAAM,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;AAEvG,MAAM,wBAAwB,GAAG,CAAC,GAAW,EAAS,EAAE,CACpD,IAAI,KAAK,CACL,0BAA0B,GAAG,gBAAgB,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;IACpF,qCAAqC,CACxC,CAAC;AAEN,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAU,EAAE;IAChD,KAAK,MAAM,SAAS,IAAI,wBAAwB,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAErC,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED,MAAM,wBAAwB,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,GAAW,EAAE,KAAa,EAAU,EAAE;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAEjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,GAAG,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,KAAyB,EAAU,EAAE,CACpE,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;AAErE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC","sourcesContent":["import type { PositionalArgDef, StringArgDef } from \"citty\";\nimport { statSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nconst DEFAULT_ENTRY_BASE = \"src/index\";\nconst DEFAULT_ENTRY_EXTENSIONS = [\".tsx\", \".jsx\", \".ts\", \".js\"];\nconst DEFAULT_ENTRY_CANDIDATES = DEFAULT_ENTRY_EXTENSIONS.map((extension) => `${DEFAULT_ENTRY_BASE}${extension}`);\nconst DEFAULT_ENTRY = `${DEFAULT_ENTRY_BASE}{${DEFAULT_ENTRY_EXTENSIONS.join(\",\")}}`;\n\nconst cwdArg: { cwd: StringArgDef } = {\n    cwd: {\n        type: \"string\",\n        description: \"Project root (default: current working directory)\",\n    },\n};\n\nconst configArg: { config: StringArgDef } = {\n    config: {\n        type: \"string\",\n        description: \"Project-relative configuration file (default: gtkx.config.*)\",\n    },\n};\n\nconst entryArg: { entry: PositionalArgDef; cwd: StringArgDef } = {\n    entry: {\n        type: \"positional\",\n        description: `Entry file (default: ${DEFAULT_ENTRY})`,\n        required: false,\n    },\n    ...cwdArg,\n};\n\nconst resolveCwd = (args: { cwd?: string }): string => (args.cwd ? resolve(args.cwd) : process.cwd());\nconst isFile = (path: string): boolean => statSync(path, { throwIfNoEntry: false })?.isFile() === true;\n\nconst missingDefaultEntryError = (cwd: string): Error =>\n    new Error(\n        `No entry file found in ${cwd}. Looked for ${DEFAULT_ENTRY_CANDIDATES.join(\", \")}; ` +\n        \"pass the entry file as an argument.\",\n    );\n\nconst resolveDefaultEntry = (cwd: string): string => {\n    for (const candidate of DEFAULT_ENTRY_CANDIDATES) {\n        const path = resolve(cwd, candidate);\n\n        if (isFile(path)) {\n            return path;\n        }\n    }\n\n    throw missingDefaultEntryError(cwd);\n};\n\nconst resolveGivenEntry = (cwd: string, entry: string): string => {\n    const path = resolve(cwd, entry);\n\n    if (!isFile(path)) {\n        throw new Error(`No entry file at ${path}.`);\n    }\n\n    return path;\n};\n\nconst resolveEntry = (cwd: string, entry: string | undefined): string =>\n    entry ? resolveGivenEntry(cwd, entry) : resolveDefaultEntry(cwd);\n\nexport { configArg, cwdArg, entryArg, resolveCwd, resolveEntry };\n"]}

package/dist/internal/errors.d.ts

@@ -1,4 +1,5 @@
 import type { ArgsDef, CommandDef } from "citty";
+declare const printError: (cause: unknown) => never;
 declare const withErrorBoundary: <T extends ArgsDef>(command: CommandDef<T>) => CommandDef<T>;
-export { withErrorBoundary };
+export { printError, withErrorBoundary };
 //# sourceMappingURL=errors.d.ts.map

package/dist/internal/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/internal/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAgBjD,QAAA,MAAM,iBAAiB,GAAI,CAAC,SAAS,OAAO,EAAE,SAAS,UAAU,CAAC,CAAC,CAAC,KAAG,UAAU,CAAC,CAAC,CAiBlF,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/internal/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAKjD,QAAA,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,KASpC,CAAC;AAEF,QAAA,MAAM,iBAAiB,GAAI,CAAC,SAAS,OAAO,EAAE,SAAS,UAAU,CAAC,CAAC,CAAC,KAAG,UAAU,CAAC,CAAC,CAiBlF,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/internal/errors.js

@@ -25,5 +25,5 @@ const withErrorBoundary = (command) => {
         },
     };
 };
-export { withErrorBoundary };
+export { printError, withErrorBoundary };
 //# sourceMappingURL=errors.js.map

package/dist/internal/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/internal/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,MAAM,UAAU,GAAG,CAAC,KAAc,EAAS,EAAE;IACzC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEtB,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAoB,OAAsB,EAAiB,EAAE;IACnF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAExB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACpB,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,OAAO;QACH,GAAG,OAAO;QACV,GAAG,EAAE,KAAK,EAAE,OAAO,EAAoB,EAAE;YACrC,IAAI,CAAC;gBACD,OAAO,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC;QACL,CAAC;KACJ,CAAC;AACN,CAAC,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,CAAC","sourcesContent":["import type { ArgsDef, CommandDef } from \"citty\";\nimport { logger } from \"@gtkx/utils\";\n\nconst ERROR_EXIT_CODE = 1;\n\nconst printError = (cause: unknown): never => {\n    const message = cause instanceof Error ? cause.message : String(cause);\n    logger.error(message);\n\n    if (cause instanceof Error && cause.stack !== undefined) {\n        logger.debug(cause.stack);\n    }\n\n    process.exit(ERROR_EXIT_CODE);\n};\n\nconst withErrorBoundary = <T extends ArgsDef>(command: CommandDef<T>): CommandDef<T> => {\n    const run = command.run;\n\n    if (run === undefined) {\n        return command;\n    }\n\n    return {\n        ...command,\n        run: async (context): Promise<unknown> => {\n            try {\n                return await run(context);\n            } catch (error) {\n                return printError(error);\n            }\n        },\n    };\n};\n\nexport { withErrorBoundary };\n"]}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/internal/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,MAAM,UAAU,GAAG,CAAC,KAAc,EAAS,EAAE;IACzC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEtB,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAoB,OAAsB,EAAiB,EAAE;IACnF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAExB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACpB,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,OAAO;QACH,GAAG,OAAO;QACV,GAAG,EAAE,KAAK,EAAE,OAAO,EAAoB,EAAE;YACrC,IAAI,CAAC;gBACD,OAAO,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC;QACL,CAAC;KACJ,CAAC;AACN,CAAC,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC","sourcesContent":["import type { ArgsDef, CommandDef } from \"citty\";\nimport { logger } from \"@gtkx/utils\";\n\nconst ERROR_EXIT_CODE = 1;\n\nconst printError = (cause: unknown): never => {\n    const message = cause instanceof Error ? cause.message : String(cause);\n    logger.error(message);\n\n    if (cause instanceof Error && cause.stack !== undefined) {\n        logger.debug(cause.stack);\n    }\n\n    process.exit(ERROR_EXIT_CODE);\n};\n\nconst withErrorBoundary = <T extends ArgsDef>(command: CommandDef<T>): CommandDef<T> => {\n    const run = command.run;\n\n    if (run === undefined) {\n        return command;\n    }\n\n    return {\n        ...command,\n        run: async (context): Promise<unknown> => {\n            try {\n                return await run(context);\n            } catch (error) {\n                return printError(error);\n            }\n        },\n    };\n};\n\nexport { printError, withErrorBoundary };\n"]}

package/dist/internal/output-directory.d.ts

@@ -0,0 +1,15 @@
+type DirectoryValidator = (path: string) => boolean;
+type OutputDirectoryTransaction = Disposable & {
+    commit: (preservedNames?: ReadonlySet<string>, isFresh?: DirectoryValidator) => void;
+    path: string;
+};
+type PreparedOutputDirectory = {
+    status: "prepared";
+    transaction: OutputDirectoryTransaction;
+} | {
+    status: "unsafe";
+};
+declare const readRegularFile: (path: string) => string | null;
+declare const prepareOutputDirectory: (rootPath: string, path: string, isReusable: DirectoryValidator) => PreparedOutputDirectory;
+export { type OutputDirectoryTransaction, prepareOutputDirectory, readRegularFile, };
+//# sourceMappingURL=output-directory.d.ts.map

package/dist/internal/output-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-directory.d.ts","sourceRoot":"","sources":["../../src/internal/output-directory.ts"],"names":[],"mappings":"AAmBA,KAAK,kBAAkB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;AAoBpD,KAAK,0BAA0B,GAAG,UAAU,GAAG;IAC3C,MAAM,EAAE,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACrF,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AACF,KAAK,uBAAuB,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,0BAA0B,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC;AAiBtH,QAAA,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,IAkBhD,CAAC;AAklBF,QAAA,MAAM,sBAAsB,GACxB,UAAU,MAAM,EAChB,MAAM,MAAM,EACZ,YAAY,kBAAkB,KAC/B,uBAgBF,CAAC;AAEF,OAAO,EACH,KAAK,0BAA0B,EAC/B,sBAAsB,EACtB,eAAe,GAClB,CAAC"}

package/dist/internal/output-directory.js

@@ -0,0 +1,490 @@
+import { closeSync, constants, fstatSync, lstatSync, mkdirSync, mkdtempSync, openSync, readdirSync, readFileSync, realpathSync, renameSync, rmdirSync, rmSync, } from "node:fs";
+import { basename, dirname, isAbsolute, join, relative, sep } from "node:path";
+const hasErrorCode = (value, code) => typeof value === "object" && value !== null && "code" in value && value.code === code;
+const readRegularFile = (path) => {
+    let descriptor = null;
+    try {
+        descriptor = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+        if (!fstatSync(descriptor).isFile()) {
+            return null;
+        }
+        return readFileSync(descriptor, "utf8");
+    }
+    catch {
+        return null;
+    }
+    finally {
+        if (descriptor !== null) {
+            closeSync(descriptor);
+        }
+    }
+};
+const openDirectoryLease = (path) => {
+    let descriptor = null;
+    try {
+        descriptor = openSync(path, constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW);
+        const stats = fstatSync(descriptor, { bigint: true });
+        let retainedDescriptor = descriptor;
+        return {
+            identity: { device: stats.dev, inode: stats.ino },
+            path: join("/proc/self/fd", String(descriptor)),
+            release: () => {
+                if (retainedDescriptor === null) {
+                    return;
+                }
+                const releasedDescriptor = retainedDescriptor;
+                retainedDescriptor = null;
+                closeSync(releasedDescriptor);
+            },
+        };
+    }
+    catch {
+        if (descriptor !== null) {
+            closeSync(descriptor);
+        }
+        return null;
+    }
+};
+const readDirectoryIdentity = (path) => {
+    const lease = openDirectoryLease(path);
+    if (lease === null) {
+        return null;
+    }
+    lease.release();
+    return lease.identity;
+};
+const hasDirectoryIdentity = (path, expected) => {
+    const actual = readDirectoryIdentity(path);
+    return actual !== null && actual.device === expected.device && actual.inode === expected.inode;
+};
+const hasResolvedDirectoryIdentity = (path, expected) => {
+    try {
+        return hasDirectoryIdentity(realpathSync(path), expected);
+    }
+    catch {
+        return false;
+    }
+};
+const capturePath = (source, destination) => {
+    try {
+        renameSync(source, destination);
+        return "captured";
+    }
+    catch (error) {
+        if (hasErrorCode(error, "ENOENT")) {
+            return "missing";
+        }
+        throw error;
+    }
+};
+const createQuarantineDirectory = (parent, displayParent) => {
+    const created = mkdtempSync(join(parent.path, ".gtkx-output-"));
+    const name = basename(created);
+    const entry = join(parent.path, name);
+    const lease = openDirectoryLease(entry);
+    if (lease === null) {
+        rmdirSync(entry);
+        throw new Error("Could not secure the output quarantine directory");
+    }
+    return {
+        displayPath: join(displayParent, name),
+        path: lease.path,
+        release: lease.release,
+        remove: () => {
+            if (!hasDirectoryIdentity(entry, lease.identity)) {
+                throw new Error(`The output quarantine changed; retained files are in ${join(displayParent, name)}`);
+            }
+            rmdirSync(entry);
+        },
+    };
+};
+const releaseTransactionLeases = (fresh, quarantine, parent, root) => {
+    try {
+        fresh.release();
+    }
+    finally {
+        try {
+            quarantine.release();
+        }
+        finally {
+            try {
+                parent.release();
+            }
+            finally {
+                root.release();
+            }
+        }
+    }
+};
+const releasePreparationLeases = (quarantine, parent, root) => {
+    try {
+        quarantine.release();
+    }
+    finally {
+        try {
+            parent.release();
+        }
+        finally {
+            root.release();
+        }
+    }
+};
+const movePath = (source, destination, operations) => {
+    renameSync(source, destination);
+    operations.push({ source, destination });
+};
+const moveNames = (source, destination, names, operations) => {
+    for (const name of names) {
+        movePath(join(source, name), join(destination, name), operations);
+    }
+};
+const reverseOperations = (operations) => {
+    for (const operation of operations.toReversed()) {
+        renameSync(operation.destination, operation.source);
+    }
+};
+const overlayDirectory = (source, destination, backup, operations) => {
+    for (const name of readdirSync(source)) {
+        overlayEntry({
+            source: join(source, name),
+            destination: join(destination, name),
+            backup: join(backup, name),
+            operations,
+        });
+    }
+};
+const overlayEntry = (request) => {
+    const destinationStats = lstatSync(request.destination, { throwIfNoEntry: false });
+    if (destinationStats === undefined) {
+        movePath(request.source, request.destination, request.operations);
+        return;
+    }
+    const sourceStats = lstatSync(request.source);
+    if (sourceStats.isDirectory() && destinationStats.isDirectory()) {
+        overlayDirectory(request.source, request.destination, request.backup, request.operations);
+        return;
+    }
+    if (!sourceStats.isFile() || !destinationStats.isFile()) {
+        throw new Error("Cannot merge conflicting preserved output entries");
+    }
+    mkdirSync(dirname(request.backup), { recursive: true });
+    movePath(request.destination, request.backup, request.operations);
+    movePath(request.source, request.destination, request.operations);
+};
+const restoreUnexpectedOutput = (unexpected, target, quarantine, previous) => {
+    try {
+        renameSync(unexpected, target);
+        if (previous === null) {
+            quarantine.remove();
+        }
+    }
+    catch (error) {
+        throw new Error(`Output recovery failed; retained files are in ${quarantine.displayPath}`, { cause: error });
+    }
+    throw new Error(`Output changed during the operation; the previous output is retained in ${quarantine.displayPath}`);
+};
+const recoverUnsecuredPublicPath = (target, quarantine, previous, error) => {
+    const unsecured = join(quarantine.path, "unsecured");
+    const publicCapture = capturePath(target, unsecured);
+    try {
+        if (previous !== null) {
+            renameSync(previous, target);
+        }
+        else if (publicCapture === "captured") {
+            renameSync(unsecured, target);
+        }
+        if (previous === null || publicCapture === "missing") {
+            quarantine.remove();
+        }
+    }
+    catch (recoveryError) {
+        throw new AggregateError([error, recoveryError], `Could not recover the output directory; retained files are in ${quarantine.displayPath}`, { cause: recoveryError });
+    }
+    throw new Error(`Could not secure the output directory; retained files are in ${quarantine.displayPath}`, {
+        cause: error,
+    });
+};
+const recoverFailedCapture = (quarantine, error) => {
+    try {
+        quarantine.remove();
+    }
+    catch (recoveryError) {
+        throw new AggregateError([error, recoveryError], `Could not clean the output quarantine; retained files are in ${quarantine.displayPath}`, { cause: recoveryError });
+    }
+    throw error;
+};
+const rollbackOutputDirectory = (target, quarantine, previous, freshIdentity) => {
+    const failed = join(quarantine.path, "failed");
+    const freshCapture = capturePath(target, failed);
+    if (freshCapture === "captured" && !hasDirectoryIdentity(failed, freshIdentity)) {
+        restoreUnexpectedOutput(failed, target, quarantine, previous);
+    }
+    if (previous !== null) {
+        renameSync(previous, target);
+    }
+    if (freshCapture === "captured") {
+        rmSync(failed, { recursive: true, force: true, maxRetries: 5 });
+    }
+    quarantine.remove();
+};
+const restoreMissingFreshOutput = (target, quarantine, previous) => {
+    try {
+        if (previous !== null) {
+            renameSync(previous, target);
+        }
+        quarantine.remove();
+    }
+    catch (error) {
+        throw new Error(`The fresh output disappeared; retained files are in ${quarantine.displayPath}`, {
+            cause: error,
+        });
+    }
+    throw new Error("The fresh output directory disappeared before it could be committed");
+};
+const captureVerifiedFreshOutput = (target, quarantine, previous, freshIdentity) => {
+    const fresh = join(quarantine.path, "fresh");
+    if (capturePath(target, fresh) === "missing") {
+        restoreMissingFreshOutput(target, quarantine, previous);
+    }
+    if (!hasDirectoryIdentity(fresh, freshIdentity)) {
+        restoreUnexpectedOutput(fresh, target, quarantine, previous);
+    }
+    return fresh;
+};
+const recoverCommit = (request) => {
+    const { backup, error, fresh, operations, previous, quarantine, target } = request;
+    try {
+        reverseOperations(operations);
+        renameSync(previous, target);
+        rmSync(fresh, { recursive: true, force: true, maxRetries: 5 });
+        rmSync(backup, { recursive: true, force: true, maxRetries: 5 });
+        quarantine.remove();
+    }
+    catch (recoveryError) {
+        throw new AggregateError([error, recoveryError], `Could not restore the previous output; retained files are in ${quarantine.displayPath}`, { cause: recoveryError });
+    }
+    throw error;
+};
+const installFreshOutput = (request) => {
+    const { fresh, preservedNames, previous, quarantine, target } = request;
+    const backup = join(quarantine.path, "backup");
+    const operations = [];
+    try {
+        const oldNames = readdirSync(previous).filter((name) => !preservedNames.has(name));
+        const freshNames = readdirSync(fresh);
+        const ordinaryFreshNames = freshNames.filter((name) => !preservedNames.has(name));
+        const preservedFreshNames = freshNames.filter((name) => preservedNames.has(name));
+        mkdirSync(backup);
+        moveNames(previous, backup, oldNames, operations);
+        moveNames(fresh, previous, ordinaryFreshNames, operations);
+        for (const name of preservedFreshNames) {
+            overlayEntry({
+                source: join(fresh, name),
+                destination: join(previous, name),
+                backup: join(backup, name),
+                operations,
+            });
+        }
+        renameSync(previous, target);
+    }
+    catch (error) {
+        recoverCommit({ ...request, backup, operations, error });
+    }
+    rmSync(fresh, { recursive: true, force: true, maxRetries: 5 });
+    rmSync(backup, { recursive: true, force: true, maxRetries: 5 });
+    quarantine.remove();
+};
+const commitOutputDirectory = (request) => {
+    const { freshIdentity, preservedNames, previous, quarantine, target } = request;
+    const fresh = captureVerifiedFreshOutput(target, quarantine, previous, freshIdentity);
+    if (previous === null) {
+        renameSync(fresh, target);
+        quarantine.remove();
+        return;
+    }
+    installFreshOutput({ target, quarantine, previous, fresh, preservedNames });
+};
+const assertFreshOutput = (path, isFresh) => {
+    if (isFresh !== undefined && !isFresh(path)) {
+        throw new Error("The build did not write to the secured output directory");
+    }
+};
+const createOutputDirectoryTransaction = (request) => {
+    const { fresh, parent, previous, publicParent, publicPath, publicRoot, quarantine, root, target } = request;
+    let state = "prepared";
+    const commit = (preservedNames = new Set(), isFresh) => {
+        if (state !== "prepared") {
+            throw new Error("The output directory transaction has already finished");
+        }
+        if (!hasResolvedDirectoryIdentity(publicRoot, root.identity) ||
+            !hasResolvedDirectoryIdentity(publicParent, parent.identity)) {
+            throw new Error(`The output parent changed; previous output is retained in ${quarantine.displayPath}`);
+        }
+        assertFreshOutput(target, isFresh);
+        state = "retained";
+        try {
+            commitOutputDirectory({
+                target,
+                quarantine,
+                previous,
+                freshIdentity: fresh.identity,
+                preservedNames,
+            });
+            state = "committed";
+        }
+        finally {
+            releaseTransactionLeases(fresh, quarantine, parent, root);
+        }
+    };
+    const rollback = () => {
+        if (state !== "prepared") {
+            return;
+        }
+        state = "retained";
+        try {
+            rollbackOutputDirectory(target, quarantine, previous, fresh.identity);
+            state = "rolled-back";
+        }
+        finally {
+            releaseTransactionLeases(fresh, quarantine, parent, root);
+        }
+    };
+    return { path: publicPath, commit, [Symbol.dispose]: rollback };
+};
+const rollbackAfterError = (transaction, error) => {
+    try {
+        transaction[Symbol.dispose]();
+    }
+    catch (rollbackError) {
+        throw new AggregateError([error, rollbackError], "Could not roll back the output directory transaction", { cause: rollbackError });
+    }
+    throw error;
+};
+const requireFreshDirectoryLease = (resources) => {
+    const { parent, previous, quarantine, root, target } = resources;
+    const lease = openDirectoryLease(target);
+    if (lease !== null) {
+        return lease;
+    }
+    try {
+        return recoverUnsecuredPublicPath(target, quarantine, previous, new Error("Could not record the fresh output directory identity"));
+    }
+    finally {
+        releasePreparationLeases(quarantine, parent, root);
+    }
+};
+const requireDirectoryLease = (path, message) => {
+    const lease = openDirectoryLease(path);
+    if (lease === null) {
+        throw new Error(message);
+    }
+    return lease;
+};
+const createChildDirectoryLease = (parent, name) => {
+    const path = join(parent.path, name);
+    try {
+        mkdirSync(path);
+    }
+    catch (error) {
+        if (!hasErrorCode(error, "EEXIST")) {
+            throw error;
+        }
+    }
+    return requireDirectoryLease(path, "Could not secure the output parent directory");
+};
+const openOutputParent = (root, rootPath, outputPath) => {
+    const relativeParent = relative(rootPath, dirname(outputPath));
+    if (relativeParent === ".." || isAbsolute(relativeParent) || relativeParent.startsWith(`..${sep}`)) {
+        throw new Error("The output directory must be below the project root");
+    }
+    let parent = requireDirectoryLease(`${root.path}/.`, "Could not secure the project root directory");
+    const segments = relativeParent.split(sep);
+    try {
+        for (const segment of segments) {
+            if (segment.length === 0) {
+                continue;
+            }
+            const child = createChildDirectoryLease(parent, segment);
+            parent.release();
+            parent = child;
+        }
+        return parent;
+    }
+    catch (error) {
+        parent.release();
+        throw error;
+    }
+};
+const createPreparationResources = (rootPath, path) => {
+    const canonicalRoot = realpathSync(rootPath);
+    const root = requireDirectoryLease(canonicalRoot, "Could not secure the project root directory");
+    let parent;
+    try {
+        parent = openOutputParent(root, rootPath, path);
+    }
+    catch (error) {
+        root.release();
+        throw error;
+    }
+    let quarantine;
+    try {
+        quarantine = createQuarantineDirectory(root, canonicalRoot);
+    }
+    catch (error) {
+        parent.release();
+        root.release();
+        throw error;
+    }
+    const target = join(parent.path, basename(path));
+    const captured = join(quarantine.path, "previous");
+    let previous = null;
+    try {
+        previous = capturePath(target, captured) === "captured" ? captured : null;
+    }
+    catch (error) {
+        try {
+            recoverFailedCapture(quarantine, error);
+        }
+        finally {
+            releasePreparationLeases(quarantine, parent, root);
+        }
+    }
+    try {
+        mkdirSync(target);
+    }
+    catch (error) {
+        try {
+            recoverUnsecuredPublicPath(target, quarantine, previous, error);
+        }
+        finally {
+            releasePreparationLeases(quarantine, parent, root);
+        }
+    }
+    return {
+        target,
+        publicPath: path,
+        publicRoot: rootPath,
+        publicParent: dirname(path),
+        parent,
+        quarantine,
+        previous,
+        root,
+    };
+};
+const prepareOutputDirectory = (rootPath, path, isReusable) => {
+    const resources = createPreparationResources(rootPath, path);
+    const fresh = requireFreshDirectoryLease(resources);
+    const transaction = createOutputDirectoryTransaction({ ...resources, fresh });
+    try {
+        if (resources.previous === null || isReusable(resources.previous)) {
+            return { status: "prepared", transaction };
+        }
+    }
+    catch (error) {
+        rollbackAfterError(transaction, error);
+    }
+    transaction[Symbol.dispose]();
+    return { status: "unsafe" };
+};
+export { prepareOutputDirectory, readRegularFile, };
+//# sourceMappingURL=output-directory.js.map