@zokugun/artifact 0.7.0 → 0.9.0

package/README.md

@@ -68,6 +68,26 @@ Artifacts published to npm must be prefixed with `artifact-`.
 Command Reference
 -----------------
 
+### Usage
+
+```
+Usage: artifact [options] [command]
+
+Boilerplate your project & keep your configurations up to date
+
+Options:
+  -v, --version                       output the version number
+  -h, --help                          display help for command
+
+Commands:
+  add [options] <artifacts...>        add an artifact to the current project
+  list|ls                             list the installed artifacts in the project
+  outdated|od                         check for outdated artifacts
+  remove|rm [options] [artifacts...]  remove an artifact from the current project
+  update|up [options]                 update the current project using the installed artifacts
+  help [command]                      display help for command
+```
+
 ### `artifact add`
 
 Registers and applies one or more artifacts in the current project.
@@ -78,12 +98,12 @@ Registers and applies one or more artifacts in the current project.
 
 `<artifact>` can be `name` or `name:variant`.
 
-### `artifact list` / `artifact l`
+### `artifact list` / `artifact ls`
 
 Shows the artifacts currently tracked in `.artifactrc*`, including versions and, when available, requested variants.
 
 - Syntax: `artifact list`
-- Alias: `artifact l`
+- Alias: `artifact ls`
 - Output: prints each artifact as `name@version:variant`.
 
 ### `artifact update` / `artifact up`

package/lib/cli.js

@@ -28,23 +28,28 @@ program
     .argument('<artifacts...>')
     .action(index_js_1.add);
 program
-    .command('update')
-    .description('update the current project using the installed artifacts')
-    .option('-d, --dry-run', 'fake update')
-    .option('--verbose', 'output more details')
-    .alias('up')
-    .action(index_js_1.update);
+    .command('list')
+    .description('list the installed artifacts in the project')
+    .alias('ls')
+    .action(index_js_1.list);
+program
+    .command('outdated')
+    .description('check for outdated artifacts')
+    .alias('od')
+    .action(index_js_1.outdated);
 program
     .command('remove')
     .description('remove an artifact from the current project')
     .option('-d, --dry-run', 'fake uninstall')
     .option('--verbose', 'output more details')
-    .argument('<artifacts...>')
+    .argument('[artifacts...]')
     .alias('rm')
     .action(index_js_1.remove);
 program
-    .command('list')
-    .description('list the installed artifacts in the project')
-    .alias('l')
-    .action(index_js_1.list);
+    .command('update')
+    .description('update the current project using the installed artifacts')
+    .option('-d, --dry-run', 'fake update')
+    .option('--verbose', 'output more details')
+    .alias('up')
+    .action(index_js_1.update);
 program.parse();

package/lib/commands/add.js

@@ -4,16 +4,18 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.add = add;
-const process_1 = __importDefault(require("process"));
+const node_process_1 = __importDefault(require("node:process"));
 const cli_utils_1 = require("@zokugun/cli-utils");
+const async_1 = require("@zokugun/xtry/async");
 const pacote_1 = __importDefault(require("pacote"));
 const tempy_1 = __importDefault(require("tempy"));
 const index_js_1 = require("../configs/index.js");
+const read_listing_config_js_1 = require("../configs/package/read-listing-config.js");
 const index_js_2 = require("../steps/index.js");
+const load_package_js_1 = require("../utils/load-package.js");
 const resolve_request_js_1 = require("../utils/resolve-request.js");
 const { mainFlow } = (0, index_js_2.composeSteps)([
     index_js_2.steps.readIncomingPackage,
-    index_js_2.steps.validateNotPresentPackage,
     index_js_2.steps.readIncomingConfig,
     index_js_2.steps.executeFirstBlock,
 ], [
@@ -35,7 +37,48 @@ const { mainFlow } = (0, index_js_2.composeSteps)([
 ]);
 async function add(specs, inputOptions) {
     cli_utils_1.logger.beginTimer();
-    const targetPath = process_1.default.cwd();
+    if (specs.length === 1 && /^@\w+$/.test(specs[0])) {
+        const request = `${specs.shift()}/artifact-listing`;
+        const spinner = cli_utils_1.logger.createSpinner(`${cli_utils_1.c.cyan.bold(request)}`);
+        const dir = tempy_1.default.directory();
+        const pkgResult = await (0, async_1.xtry)(pacote_1.default.extract(request, dir));
+        if (pkgResult.fails) {
+            cli_utils_1.logger.fatal(`The artifact '${request}' couldn't be found.`);
+        }
+        spinner.succeed();
+        cli_utils_1.logger.stopProgress();
+        const listing = await (0, read_listing_config_js_1.readListingConfig)(dir);
+        if (listing.fails) {
+            cli_utils_1.logger.fatal(listing.error);
+        }
+        const { value } = await (0, async_1.xtry)(cli_utils_1.enquirer.prompt({
+            type: 'multiselect',
+            name: 'specs',
+            message: 'Pick the artifacts to add',
+            // @ts-expect-error TS2353
+            limit: 7,
+            choices: listing.value.map(({ name, description }) => ({ name, message: `${name}${cli_utils_1.c.grey(`: ${description}`)}` })),
+        }));
+        const marked = value?.specs;
+        if (!marked || marked.length === 0) {
+            cli_utils_1.logger.warn('No artifacts marked for addition');
+        }
+        else {
+            const { value } = await (0, async_1.xtry)(cli_utils_1.enquirer.prompt([
+                (0, cli_utils_1.confirm)({
+                    name: 'addition',
+                    message: `Adds the following artifacts: ${marked.map((name) => cli_utils_1.c.green(name)).join(',')}`,
+                }),
+            ]));
+            if (value?.addition) {
+                specs.push(...marked);
+            }
+            else {
+                cli_utils_1.logger.warn('Artifacts addition has been rejected');
+            }
+        }
+    }
+    const targetPath = node_process_1.default.cwd();
     const options = {
         dryRun: inputOptions?.dryRun ?? false,
         force: inputOptions?.force ?? false,
@@ -52,29 +95,59 @@ async function add(specs, inputOptions) {
     if (configResult.fails) {
         cli_utils_1.logger.fatal(configResult.error);
     }
-    const { config, configStats } = configResult.value;
+    const config = configResult.value;
+    const requests = [];
     for (const spec of specs) {
-        const requestResult = (0, resolve_request_js_1.resolveRequest)(spec);
-        if (requestResult.fails) {
-            cli_utils_1.logger.fatal(requestResult.error);
+        const request = (0, resolve_request_js_1.resolveRequest)(spec);
+        if (request.fails) {
+            cli_utils_1.logger.fatal(request.error);
         }
-        const request = requestResult.value;
-        const spinner = cli_utils_1.logger.createSpinner(`${cli_utils_1.c.cyan.bold(request.name)}`);
-        const dir = tempy_1.default.directory();
-        const pkgResult = await pacote_1.default.extract(request.name, dir);
-        if (!pkgResult.resolved) {
-            if (options.force || options.skip) {
-                spinner.fail();
-                if (options.verbose) {
-                    cli_utils_1.logger.warn(`The artifact '${spec}' couldn't be found, skipping...`);
+        if (!options.force) {
+            const { name } = request.value;
+            const artifact = config.artifacts[name];
+            if (artifact) {
+                if (options.skip) {
+                    if (options.verbose) {
+                        cli_utils_1.logger.debug(`The "${name}" artifact is already present, skipping...`);
+                    }
+                }
+                else {
+                    cli_utils_1.logger.fatal(`The "${name}" artifact has already been added.`);
                 }
-                continue;
-            }
-            else {
-                cli_utils_1.logger.fatal(pkgResult.from);
             }
         }
-        const flowResult = await mainFlow(targetPath, dir, request, config, options);
+        requests.push(request.value);
+    }
+    const global = {
+        journeys: {},
+        overwrittenTextFiles: [],
+        routes: {},
+    };
+    for (const [name, { version }] of Object.entries(config.artifacts)) {
+        const spinner = cli_utils_1.logger.createSpinner(`${cli_utils_1.c.cyan.bold(name)}`);
+        const dir = await (0, load_package_js_1.loadPackage)(`${name}@${version}`, spinner, options);
+        if (!dir) {
+            continue;
+        }
+        const result = await (0, index_js_1.readPackageConfig)(dir, global.routes);
+        if (result.fails) {
+            cli_utils_1.logger.fatal(result.error);
+        }
+        for (const [name, journey] of Object.entries(result.value.journeys)) {
+            global.journeys[name] = journey;
+        }
+        for (const [name, route] of Object.entries(result.value.routes)) {
+            global.routes[name] = route;
+        }
+        spinner.succeed();
+    }
+    for (const request of requests) {
+        const spinner = cli_utils_1.logger.createSpinner(`${cli_utils_1.c.cyan.bold(request.name)}`);
+        const dir = await (0, load_package_js_1.loadPackage)(request.name, spinner, options);
+        if (!dir) {
+            continue;
+        }
+        const flowResult = await mainFlow(targetPath, dir, request, config, global, options);
         if (flowResult.fails) {
             cli_utils_1.logger.fatal(flowResult.error);
         }
@@ -83,7 +156,7 @@ async function add(specs, inputOptions) {
             continue;
         }
         (0, index_js_1.updateInstallConfig)(config, flowResult.value.result);
-        await (0, index_js_1.writeInstallConfig)(config, configStats, flowResult.value.formats, targetPath, options);
+        await (0, index_js_1.writeInstallConfig)(config, flowResult.value.formats, targetPath, options);
         spinner.succeed();
     }
     cli_utils_1.logger.finishTimer();

package/lib/commands/index.d.ts

@@ -1,4 +1,5 @@
 export { add } from './add.js';
 export { list } from './list.js';
+export { outdated } from './outdated.js';
 export { remove } from './remove.js';
 export { update } from './update.js';

package/lib/commands/index.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.update = exports.remove = exports.list = exports.add = void 0;
+exports.update = exports.remove = exports.outdated = exports.list = exports.add = void 0;
 var add_js_1 = require("./add.js");
 Object.defineProperty(exports, "add", { enumerable: true, get: function () { return add_js_1.add; } });
 var list_js_1 = require("./list.js");
 Object.defineProperty(exports, "list", { enumerable: true, get: function () { return list_js_1.list; } });
+var outdated_js_1 = require("./outdated.js");
+Object.defineProperty(exports, "outdated", { enumerable: true, get: function () { return outdated_js_1.outdated; } });
 var remove_js_1 = require("./remove.js");
 Object.defineProperty(exports, "remove", { enumerable: true, get: function () { return remove_js_1.remove; } });
 var update_js_1 = require("./update.js");

package/lib/commands/list.js

@@ -4,12 +4,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.list = list;
+const node_path_1 = __importDefault(require("node:path"));
 const process_1 = __importDefault(require("process"));
 const cli_utils_1 = require("@zokugun/cli-utils");
-const lodash_es_1 = require("lodash-es");
+const async_1 = __importDefault(require("@zokugun/fs-extra-plus/async"));
+const xtry_1 = require("@zokugun/xtry");
 const index_js_1 = require("../configs/index.js");
+const format_table_js_1 = require("../utils/format-table.js");
 function formatVariant(artifact) {
-    const variant = Array.isArray(artifact.requires) ? (0, lodash_es_1.last)(artifact.requires) ?? '' : '';
+    const variant = Array.isArray(artifact.requires) ? artifact.requires.at(-1) ?? '' : '';
     if (variant.length > 0) {
         return `:${variant}`;
     }
@@ -18,22 +21,37 @@ function formatVariant(artifact) {
     }
 }
 async function list() {
-    const targetPath = process_1.default.env.INIT_CWD;
+    const targetPath = process_1.default.cwd();
     const configResult = await (0, index_js_1.readInstallConfig)(targetPath);
     if (configResult.fails) {
         cli_utils_1.logger.fatal(configResult.error);
     }
-    const { config, configStats } = configResult.value;
+    const packageResult = await async_1.default.readJSON(node_path_1.default.resolve(targetPath, './package.json'));
+    if (packageResult.fails) {
+        cli_utils_1.logger.fatal((0, xtry_1.stringifyError)(packageResult.error));
+    }
+    const { name } = packageResult.value;
+    const config = configResult.value;
     const artifacts = Object.entries(config.artifacts);
+    cli_utils_1.logger.newLine();
     if (artifacts.length === 0) {
         cli_utils_1.logger.info('No artifacts have been installed.');
     }
     else {
-        cli_utils_1.logger.info(`List of installed artifacts (${configStats.name}):\n`);
+        cli_utils_1.logger.print(`${name} ${cli_utils_1.c.grey(config.file.name)}`);
+        cli_utils_1.logger.newLine();
+        const table = [];
         for (const [name, artifact] of artifacts) {
-            const version = artifact.version ? `@${artifact.version}` : '';
-            cli_utils_1.logger.info(`- ${name}${version}${formatVariant(artifact)}`);
+            const line = [
+                ' ',
+                name,
+                ' ',
+                artifact.version ? `${cli_utils_1.c.green(artifact.version)}${cli_utils_1.c.gray(formatVariant(artifact))}` : '',
+            ];
+            table.push(line);
         }
+        const lines = (0, format_table_js_1.formatTable)(table, 'LLLL');
+        cli_utils_1.logger.print(lines.join('\n'));
     }
     cli_utils_1.logger.newLine();
 }

package/lib/commands/outdated.d.ts

@@ -0,0 +1 @@
+export declare function outdated(): Promise<void>;

package/lib/commands/outdated.js

@@ -0,0 +1,73 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.outdated = outdated;
+const node_path_1 = __importDefault(require("node:path"));
+const process_1 = __importDefault(require("process"));
+const cli_utils_1 = require("@zokugun/cli-utils");
+const async_1 = __importDefault(require("@zokugun/fs-extra-plus/async"));
+const xtry_1 = require("@zokugun/xtry");
+const cli_progress_1 = require("cli-progress");
+const pacote_1 = __importDefault(require("pacote"));
+const semver_1 = require("semver");
+const index_js_1 = require("../configs/index.js");
+const format_table_js_1 = require("../utils/format-table.js");
+const time_difference_js_1 = require("../utils/time-difference.js");
+async function outdated() {
+    const targetPath = process_1.default.cwd();
+    const configResult = await (0, index_js_1.readInstallConfig)(targetPath);
+    if (configResult.fails) {
+        cli_utils_1.logger.fatal(configResult.error);
+    }
+    const packageResult = await async_1.default.readJSON(node_path_1.default.resolve(targetPath, './package.json'));
+    if (packageResult.fails) {
+        cli_utils_1.logger.fatal((0, xtry_1.stringifyError)(packageResult.error));
+    }
+    const { name } = packageResult.value;
+    const config = configResult.value;
+    const artifacts = Object.entries(config.artifacts);
+    cli_utils_1.logger.newLine();
+    if (artifacts.length === 0) {
+        cli_utils_1.logger.info('No artifacts have been installed.');
+    }
+    else {
+        cli_utils_1.logger.print(`${name} ${cli_utils_1.c.grey(config.file.name)}`);
+        const bar = new cli_progress_1.SingleBar({
+            clearOnComplete: true,
+            hideCursor: true,
+            format: `{bar} {value}/{total} ${cli_utils_1.c.gray('{name}')}`,
+            linewrap: false,
+            barsize: 40,
+        }, cli_progress_1.Presets.shades_classic);
+        bar.start(artifacts.length, 0);
+        const table = [];
+        for (const [index, [name, artifact]] of artifacts.entries()) {
+            const current = await pacote_1.default.manifest(`${name}@${artifact.version}`, {
+                fullMetadata: true,
+            });
+            const latest = await pacote_1.default.manifest(name, {
+                fullMetadata: true,
+            });
+            const newer = (0, semver_1.gt)(latest.version, artifact.version);
+            const line = [
+                ' ',
+                newer ? name : cli_utils_1.c.grey(name),
+                ' ',
+                (0, time_difference_js_1.timeDifference)(current._time),
+                artifact.version ? cli_utils_1.c.grey(artifact.version) : '',
+                cli_utils_1.c.dim.grey('→'),
+                newer ? latest.version : cli_utils_1.c.grey.strikethrough(latest.version),
+                newer ? (0, time_difference_js_1.timeDifference)(latest._time) : '',
+            ];
+            table.push(line);
+            bar.update(index, { name });
+        }
+        bar.stop();
+        cli_utils_1.logger.newLine();
+        const lines = (0, format_table_js_1.formatTable)(table, 'LLLLRRRL');
+        cli_utils_1.logger.print(lines.join('\n'));
+    }
+    cli_utils_1.logger.newLine();
+}

package/lib/commands/remove.js

@@ -6,10 +6,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.remove = remove;
 const process_1 = __importDefault(require("process"));
 const cli_utils_1 = require("@zokugun/cli-utils");
-const pacote_1 = __importDefault(require("pacote"));
-const tempy_1 = __importDefault(require("tempy"));
+const async_1 = require("@zokugun/xtry/async");
 const index_js_1 = require("../configs/index.js");
 const index_js_2 = require("../steps/index.js");
+const load_package_js_1 = require("../utils/load-package.js");
 const resolve_request_js_1 = require("../utils/resolve-request.js");
 const { mainFlow } = (0, index_js_2.composeSteps)([
     index_js_2.steps.readIncomingPackage,
@@ -42,7 +42,38 @@ async function remove(specs, inputOptions) {
     if (configResult.fails) {
         cli_utils_1.logger.fatal(configResult.error);
     }
-    const { config, configStats } = configResult.value;
+    const config = configResult.value;
+    if (specs.length === 0) {
+        const { value } = await (0, async_1.xtry)(cli_utils_1.enquirer.prompt({
+            type: 'multiselect',
+            name: 'specs',
+            message: 'Pick the artifacts to remove',
+            choices: Object.keys(config.artifacts).map((name) => ({ name })),
+        }));
+        const marked = value?.specs;
+        if (!marked || marked.length === 0) {
+            cli_utils_1.logger.warn('No artifacts marked for removal');
+        }
+        else {
+            const { value } = await (0, async_1.xtry)(cli_utils_1.enquirer.prompt([
+                (0, cli_utils_1.confirm)({
+                    name: 'remove',
+                    message: `Remove the following artifacts: ${marked.map((name) => cli_utils_1.c.green(name)).join(',')}`,
+                }),
+            ]));
+            if (value?.remove) {
+                specs.push(...marked);
+            }
+            else {
+                cli_utils_1.logger.warn('Artifacts removal has been rejected');
+            }
+        }
+    }
+    const global = {
+        journeys: {},
+        overwrittenTextFiles: [],
+        routes: {},
+    };
     for (const spec of specs) {
         const requestResult = (0, resolve_request_js_1.resolveRequest)(spec);
         if (requestResult.fails) {
@@ -50,21 +81,11 @@ async function remove(specs, inputOptions) {
         }
         const request = requestResult.value;
         const spinner = cli_utils_1.logger.createSpinner(`${cli_utils_1.c.cyan.bold(request.name)}`);
-        const dir = tempy_1.default.directory();
-        const pkgResult = await pacote_1.default.extract(request.name, dir);
-        if (!pkgResult.resolved) {
-            if (options.force || options.skip) {
-                spinner.fail();
-                if (options.verbose) {
-                    cli_utils_1.logger.debug(`The artifact '${spec}' couldn't be found, skipping...`);
-                }
-                continue;
-            }
-            else {
-                cli_utils_1.logger.fatal(pkgResult.from);
-            }
+        const dir = await (0, load_package_js_1.loadPackage)(request.name, spinner, options);
+        if (!dir) {
+            continue;
         }
-        const flowResult = await mainFlow(targetPath, dir, request, config, options);
+        const flowResult = await mainFlow(targetPath, dir, request, config, global, options);
         if (flowResult.fails) {
             cli_utils_1.logger.fatal(flowResult.error);
         }
@@ -73,7 +94,7 @@ async function remove(specs, inputOptions) {
             continue;
         }
         (0, index_js_1.updateUninstallConfig)(config, flowResult.value.result);
-        await (0, index_js_1.writeInstallConfig)(config, configStats, flowResult.value.formats, targetPath, options);
+        await (0, index_js_1.writeInstallConfig)(config, flowResult.value.formats, targetPath, options);
         spinner.succeed();
     }
     cli_utils_1.logger.finishTimer();

package/lib/commands/update.js

@@ -7,10 +7,9 @@ exports.update = update;
 const process_1 = __importDefault(require("process"));
 const cli_utils_1 = require("@zokugun/cli-utils");
 const lodash_es_1 = require("lodash-es");
-const pacote_1 = __importDefault(require("pacote"));
-const tempy_1 = __importDefault(require("tempy"));
 const index_js_1 = require("../configs/index.js");
 const index_js_2 = require("../steps/index.js");
+const load_package_js_1 = require("../utils/load-package.js");
 const { mainFlow } = (0, index_js_2.composeSteps)([
     index_js_2.steps.readIncomingPackage,
     index_js_2.steps.validateNewerPackage,
@@ -47,34 +46,50 @@ async function update(inputOptions) {
     if (configResult.fails) {
         cli_utils_1.logger.fatal(configResult.error);
     }
-    const { config, configStats } = configResult.value;
+    const config = configResult.value;
+    const global = {
+        journeys: {},
+        overwrittenTextFiles: [],
+        routes: {},
+    };
     for (const [name, artifact] of Object.entries(config.artifacts)) {
         const spinner = cli_utils_1.logger.createSpinner(`${cli_utils_1.c.cyan.bold(name)}`);
-        const dir = tempy_1.default.directory();
-        const pkgResult = await pacote_1.default.extract(name, dir);
-        if (!pkgResult.resolved) {
-            if (options.force) {
-                spinner.fail();
-                if (options.verbose) {
-                    cli_utils_1.logger.debug(`The artifact '${name}' couldn't be found, skipping...`);
-                }
-                continue;
+        const request = artifact.requires ? { name, variant: (0, lodash_es_1.last)(artifact.requires) } : { name };
+        const dir = await (0, load_package_js_1.loadPackage)(request.name, spinner, options);
+        if (!dir) {
+            continue;
+        }
+        const result = await mainFlow(targetPath, dir, request, config, global, options);
+        if (result.fails) {
+            cli_utils_1.logger.fatal(result.error);
+        }
+        const context = result.value;
+        if (context?.incomingConfig) {
+            for (const [name, journey] of Object.entries(context.incomingConfig.journeys)) {
+                global.journeys[name] = journey;
             }
-            else {
-                cli_utils_1.logger.fatal(pkgResult.from);
+            for (const [name, route] of Object.entries(context.incomingConfig.routes)) {
+                global.routes[name] = route;
             }
         }
-        const request = artifact.requires ? { name, variant: (0, lodash_es_1.last)(artifact.requires) } : { name };
-        const flowResult = await mainFlow(targetPath, dir, request, config, options);
-        if (flowResult.fails) {
-            cli_utils_1.logger.fatal(flowResult.error);
+        else {
+            const result = await (0, index_js_1.readPackageConfig)(dir, global.routes);
+            if (result.fails) {
+                cli_utils_1.logger.fatal(result.error);
+            }
+            for (const [name, journey] of Object.entries(result.value.journeys)) {
+                global.journeys[name] = journey;
+            }
+            for (const [name, route] of Object.entries(result.value.routes)) {
+                global.routes[name] = route;
+            }
         }
-        if (!flowResult.value?.result) {
+        if (!context?.result) {
             spinner.succeed();
             continue;
         }
-        (0, index_js_1.updateInstallConfig)(config, flowResult.value.result);
-        await (0, index_js_1.writeInstallConfig)(config, configStats, flowResult.value.formats, targetPath, options);
+        (0, index_js_1.updateInstallConfig)(config, context.result);
+        await (0, index_js_1.writeInstallConfig)(config, context.formats, targetPath, options);
         spinner.succeed();
     }
     cli_utils_1.logger.finishTimer();

package/lib/compositors/codec.d.ts

@@ -0,0 +1,3 @@
+import { type Codec } from '../types/context.js';
+import { type Route } from '../types/travel.js';
+export declare function codec(codecs: Codec[], ...routes: Array<Route<Record<string, any>>>): Route<string>;

package/lib/compositors/codec.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.codec = codec;
+const is_it_type_1 = require("@zokugun/is-it-type");
+const list_concat_js_1 = require("../routes/list-concat.js");
+const primitive_js_1 = require("../routes/primitive.js");
+const apply_transforms_js_1 = require("../utils/apply-transforms.js");
+const flow_js_1 = require("../utils/flow.js");
+const compose_js_1 = require("./compose.js");
+const fork_js_1 = require("./fork.js");
+const merge = (0, compose_js_1.compose)({
+    $$default: (0, fork_js_1.fork)([is_it_type_1.isArray, list_concat_js_1.listConcat], [is_it_type_1.isRecord, async (...args) => merge(...args)], primitive_js_1.primitive),
+});
+function codec(codecs, ...routes) {
+    return async ({ current, incoming, filters, ignores, transforms }) => {
+        if (!(0, is_it_type_1.isNonBlankString)(current)) {
+            return incoming;
+        }
+        for (const { parse, stringify } of codecs) {
+            const currentResult = parse(current);
+            if (currentResult.fails) {
+                continue;
+            }
+            if ((0, is_it_type_1.isNonBlankString)(incoming)) {
+                const incomingResult = parse(incoming);
+                if (incomingResult.fails) {
+                    continue;
+                }
+                const incomingData = incomingResult.value.data;
+                if (!(0, is_it_type_1.isArray)(incomingData) && !(0, is_it_type_1.isRecord)(incomingData)) {
+                    return incoming;
+                }
+                const mergedTransform = currentResult.value.transform
+                    ? await merge({ current: currentResult.value.transform, incoming: incomingResult.value.transform })
+                    : incomingResult.value.transform;
+                const run = (0, flow_js_1.flow)(...routes, (0, apply_transforms_js_1.applyTransforms)(transforms), (data) => stringify(data, mergedTransform));
+                return run({ current: currentResult.value.data, incoming: incomingData, filters, ignores });
+            }
+            else {
+                const run = (0, flow_js_1.flow)(...routes, (0, apply_transforms_js_1.applyTransforms)(transforms), (data) => stringify(data, currentResult.value.transform));
+                return run({ current: currentResult.value.data, filters, ignores });
+            }
+        }
+        return incoming;
+    };
+}

package/lib/compositors/compose.d.ts

@@ -2,6 +2,7 @@ import { type Route } from '../types/travel.js';
 type ComposeMap = {
     [key: string]: Route<any> | string[] | undefined;
     $$ignore?: string[];
+    $$remove?: string[];
 };
 export declare function compose(map: ComposeMap): Route<Record<string, any>>;
 export {};

package/lib/compositors/compose.js

@@ -7,7 +7,11 @@ async function apply(map, keys, current, incoming, result) {
         return;
     }
     const ignores = map.$$ignore ?? [];
+    const removes = map.$$remove ?? [];
     for (const key of keys) {
+        if (removes.includes(key)) {
+            continue;
+        }
         const currentValue = current[key];
         const transform = map[key] ?? map.$$default;
         if (!transform || !(0, lodash_es_1.has)(incoming, key) || ignores.includes(key)) {

package/lib/compositors/index.d.ts

@@ -1,3 +1,4 @@
+export { codec } from './codec.js';
 export { compose } from './compose.js';
 export { fork } from './fork.js';
 export { json } from './json.js';