load-populate-files 0.0.11 → 0.1.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Jacob Ley
+Copyright (c) 2025 Jacob Ley
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -58,6 +58,11 @@ export default [
 await loadAndPopulateFiles('./config.js');
 ```
 
+This is also exposed as a CLI:
+
+`pnpx load-populate-files --help`
+`pnpx load-populate-files --file-path ./config.js`
+
 ## API
 
 ### loadAndPopulateFiles(filePath, options)
@@ -66,15 +71,19 @@ Loads the config specified at `filePath`, and passes that to [populateFiles()](h
 
 The loaded file may either be a single object config, or an array of separate configs.
 
+If using the CLI, the `--file-path` parameter is required.
+
 #### options
 
 An optional object as the secondary parameter. Passed to underlying `populateFiles()` call.
 
-| property | type | default | description |
-|----------|------|---------|-------------|
-| check | `boolean` | `true` if in a CI environment. Else `false` | If `true`, will fail if writing the file would result in changing the files content. Useful for CI environments to make sure the version-controlled code is up to date before deployment. |
-| dryRun | `boolean` | `false` | If `true`, will not write file regardless of changes. Can still fail if `check` is `true`. |
-| cwd | `string \| URL` | `process.env.PWD` | Used as the current working directory if `filePath` is a relative file. Will be re-used in filePaths derived from loaded config |
+They are also available as optional flags in the CLI.
+
+| property | CLI flag | type | default | description |
+|----------|----------|------|---------|-------------|
+| check | `--ci` | `boolean` | `true` if in a CI environment. Else `false` | If `true`, will fail if writing the file would result in changing the files content. Useful for CI environments to make sure the version-controlled code is up to date before deployment. |
+| dryRun | `--dry-run` | | `boolean` | `false` | If `true`, will not write file regardless of changes. Can still fail if `check` is `true`. |
+| cwd | `--cwd` | `string \| URL` | `process.env.PWD` | Used as the current working directory if `filePath` is a relative file. Will be re-used in filePaths derived from loaded config |
 
 ## Types
 

package/bin.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+export { default } from './dist/bin.js';

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("haywire-launcher").WrapperMain;
+export default _default;
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.js

@@ -0,0 +1,16 @@
+import { EntryScript } from "entry-script";
+import { bind, singletonScope } from 'haywire';
+import { launch } from 'haywire-launcher';
+import { LoadPopulateFilesCli } from './cli.js';
+import { commandsId, commandsModule } from './commands/index.js';
+import { consoleErrorId, consoleLogId, exitCodeId } from './commands/lib/dependencies.js';
+export default launch(commandsModule.addBinding(bind(EntryScript).withDependencies([
+    LoadPopulateFilesCli
+]).withProvider((cli)=>cli).scoped(singletonScope)).addBinding(bind(LoadPopulateFilesCli).withDependencies([
+    commandsId.supplier(),
+    consoleLogId,
+    consoleErrorId,
+    exitCodeId
+]).withConstructorProvider().scoped(singletonScope)).toContainer());
+
+//# sourceMappingURL=bin.js.map

package/dist/cli.d.ts

@@ -0,0 +1,22 @@
+import { EntryScript } from 'entry-script';
+import type { Supplier } from 'haywire';
+import type { ConsoleLog, ExitCode } from './commands/lib/dependencies.js';
+import type { AbstractCommand } from './commands/lib/types.js';
+/**
+ * LoadPopulateFiles CLI. Run `./bin.mjs --help` for options.
+ *
+ * Uses `yargs` package for command line parsing and logic flow.
+ */
+export declare class LoadPopulateFilesCli extends EntryScript {
+    #private;
+    constructor(getCommands: Supplier<AbstractCommand[]>, logger: ConsoleLog, errorLogger: ConsoleLog, exitCode: ExitCode);
+    /**
+     * Entry point to CLI script.
+     *
+     * Sets high level Yargs settings. Command/options logic is implemented in individual command modules.
+     *
+     * @param argv - process arguments
+     */
+    main(argv: string[]): Promise<void>;
+}
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.js

@@ -0,0 +1,45 @@
+import yargs from 'yargs';
+import { EntryScript } from "entry-script";
+export class LoadPopulateFilesCli extends EntryScript {
+    #getCommands;
+    #logger;
+    #errorLogger;
+    #exitCode;
+    constructor(getCommands, logger, errorLogger, exitCode){
+        super();
+        this.#getCommands = getCommands;
+        this.#logger = logger;
+        this.#errorLogger = errorLogger;
+        this.#exitCode = exitCode;
+    }
+    async main(argv) {
+        const packageJson = await import('../package.json', {
+            with: {
+                type: 'json'
+            }
+        });
+        const yarg = yargs().scriptName('load-populate-files').option({
+            cwd: {
+                type: 'string',
+                default: '.',
+                describe: 'Relative working directory for all paths'
+            }
+        }).strict().help().alias('help', 'info').version(packageJson.default.version);
+        for (const command of this.#getCommands()){
+            yarg.command(command);
+        }
+        await yarg.parseAsync(argv, {}, this.#yargsOutput.bind(this));
+    }
+    #yargsOutput(e, _argv, log) {
+        if (e) {
+            this.#exitCode(1);
+            if (log) {
+                this.#errorLogger(log);
+            }
+        } else if (log) {
+            this.#logger(log);
+        }
+    }
+}
+
+//# sourceMappingURL=cli.js.map

package/dist/commands/index.d.ts

@@ -0,0 +1,5 @@
+import type { AbstractCommand } from './lib/types.js';
+import { LoadPopulateFilesCommand } from './load-populate-files-command.js';
+export declare const commandsId: import("haywire").HaywireId<AbstractCommand[], null, null, false, false, false, false>;
+export declare const commandsModule: import("haywire").Module<[import("haywire").NonExtendable<import("./lib/dependencies.js").ConsoleLog | null | undefined, null, "log">] | [import("haywire").NonExtendable<import("./lib/dependencies.js").ConsoleLog | null, null, "log">] | [import("haywire").NonExtendable<import("./lib/dependencies.js").ConsoleLog | undefined, null, "log">] | [import("haywire").NonExtendable<import("./lib/dependencies.js").ConsoleLog, null, "log">] | [import("haywire").NonExtendable<import("./lib/dependencies.js").ConsoleLog | null | undefined, null, "error">] | [import("haywire").NonExtendable<import("./lib/dependencies.js").ConsoleLog | null, null, "error">] | [import("haywire").NonExtendable<import("./lib/dependencies.js").ConsoleLog | undefined, null, "error">] | [import("haywire").NonExtendable<import("./lib/dependencies.js").ConsoleLog, null, "error">] | [import("haywire").NonExtendable<import("./lib/dependencies.js").ExitCode | null | undefined, null, null>] | [import("haywire").NonExtendable<import("./lib/dependencies.js").ExitCode | null, null, null>] | [import("haywire").NonExtendable<import("./lib/dependencies.js").ExitCode | undefined, null, null>] | [import("haywire").NonExtendable<import("./lib/dependencies.js").ExitCode, null, null>] | [import("haywire").NonExtendable<import("../lib/lib/dependencies.js").Importer | null | undefined, null, null>] | [import("haywire").NonExtendable<import("../lib/lib/dependencies.js").Importer | null, null, null>] | [import("haywire").NonExtendable<import("../lib/lib/dependencies.js").Importer | undefined, null, null>] | [import("haywire").NonExtendable<import("../lib/lib/dependencies.js").Importer, null, null>] | [import("haywire").NonExtendable<import("parse-cwd").ParseCwd | null | undefined, null, null>] | [import("haywire").NonExtendable<import("parse-cwd").ParseCwd | null, null, null>] | [import("haywire").NonExtendable<import("parse-cwd").ParseCwd | undefined, null, null>] | [import("haywire").NonExtendable<import("parse-cwd").ParseCwd, null, null>] | [import("haywire").NonExtendable<import("populate-files").PopulateFiles | null | undefined, null, null>] | [import("haywire").NonExtendable<import("populate-files").PopulateFiles | null, null, null>] | [import("haywire").NonExtendable<import("populate-files").PopulateFiles | undefined, null, null>] | [import("haywire").NonExtendable<import("populate-files").PopulateFiles, null, null>] | [import("haywire").NonExtendable<import("../lib/load-populate-files.js").LoadPopulateFilesFactory | null | undefined, typeof import("../lib/load-populate-files.js").LoadPopulateFilesFactory, null>] | [import("haywire").NonExtendable<import("../lib/load-populate-files.js").LoadPopulateFilesFactory | null, typeof import("../lib/load-populate-files.js").LoadPopulateFilesFactory, null>] | [import("haywire").NonExtendable<import("../lib/load-populate-files.js").LoadPopulateFilesFactory | undefined, typeof import("../lib/load-populate-files.js").LoadPopulateFilesFactory, null>] | [import("haywire").NonExtendable<import("../lib/load-populate-files.js").LoadPopulateFilesFactory, typeof import("../lib/load-populate-files.js").LoadPopulateFilesFactory, null>] | [import("haywire").NonExtendable<import("../lib/normalize.js").NormalizeParams, null, null>] | [import("haywire").NonExtendable<import("../lib/loader.js").LoadFile, null, null>] | [import("haywire").NonExtendable<import("../index.js").LoadAndPopulateFiles | null | undefined, null, null>] | [import("haywire").NonExtendable<import("../index.js").LoadAndPopulateFiles | null, null, null>] | [import("haywire").NonExtendable<import("../index.js").LoadAndPopulateFiles | undefined, null, null>] | [import("haywire").NonExtendable<import("../index.js").LoadAndPopulateFiles, null, null>] | [import("haywire").NonExtendable<import("../lib/loader.js").LoadFile | null | undefined, null, null>] | [import("haywire").NonExtendable<import("../lib/loader.js").LoadFile | null, null, null>] | [import("haywire").NonExtendable<import("../lib/loader.js").LoadFile | undefined, null, null>] | [import("haywire").NonExtendable<import("../lib/normalize.js").NormalizeParams | null | undefined, null, null>] | [import("haywire").NonExtendable<import("../lib/normalize.js").NormalizeParams | null, null, null>] | [import("haywire").NonExtendable<import("../lib/normalize.js").NormalizeParams | undefined, null, null>] | [import("haywire").NonExtendable<AbstractCommand[] | null | undefined, null, null>] | [import("haywire").NonExtendable<AbstractCommand[] | null, null, null>] | [import("haywire").NonExtendable<AbstractCommand[] | undefined, null, null>] | [import("haywire").NonExtendable<AbstractCommand[], null, null>] | [import("haywire").NonExtendable<LoadPopulateFilesCommand, typeof LoadPopulateFilesCommand, null>] | [import("haywire").NonExtendable<LoadPopulateFilesCommand | null | undefined, typeof LoadPopulateFilesCommand, null>] | [import("haywire").NonExtendable<LoadPopulateFilesCommand | null, typeof LoadPopulateFilesCommand, null>] | [import("haywire").NonExtendable<LoadPopulateFilesCommand | undefined, typeof LoadPopulateFilesCommand, null>], [import("haywire").NonExtendable<import("../lib/lib/dependencies.js").Importer, null, null>] | [import("haywire").NonExtendable<import("parse-cwd").ParseCwd, null, null>] | [import("haywire").NonExtendable<import("populate-files").PopulateFiles, null, null>] | [import("haywire").NonExtendable<import("../lib/load-populate-files.js").LoadPopulateFilesFactory, typeof import("../lib/load-populate-files.js").LoadPopulateFilesFactory, null>] | [import("haywire").NonExtendable<import("../lib/normalize.js").NormalizeParams, null, null>] | [import("haywire").NonExtendable<import("../lib/loader.js").LoadFile, null, null>] | [import("haywire").NonExtendable<import("../index.js").LoadAndPopulateFiles, null, null>] | [import("haywire").NonExtendable<LoadPopulateFilesCommand, typeof LoadPopulateFilesCommand, null>], false>;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.js

@@ -0,0 +1,12 @@
+import { bind, identifier } from 'haywire';
+import { loadAndPopulateFilesId, loadAndPopulateFilesModule } from '../lib/index.js';
+import { dependenciesModule } from './lib/dependencies.js';
+import { LoadPopulateFilesCommand } from './load-populate-files-command.js';
+export const commandsId = identifier();
+export const commandsModule = dependenciesModule.mergeModule(loadAndPopulateFilesModule).addBinding(bind(commandsId).withDependencies([
+    LoadPopulateFilesCommand
+]).withProvider((...commands)=>commands)).addBinding(bind(LoadPopulateFilesCommand).withDependencies([
+    loadAndPopulateFilesId
+]).withConstructorProvider());
+
+//# sourceMappingURL=index.js.map

package/dist/commands/lib/dependencies.d.ts

@@ -0,0 +1,7 @@
+export type ConsoleLog = (log: unknown) => void;
+export declare const consoleLogId: import("haywire").HaywireId<ConsoleLog, null, "log", false, false, false, false>;
+export declare const consoleErrorId: import("haywire").HaywireId<ConsoleLog, null, "error", false, false, false, false>;
+export type ExitCode = (code: number) => void;
+export declare const exitCodeId: import("haywire").HaywireId<ExitCode, null, null, false, false, false, false>;
+export declare const dependenciesModule: import("haywire").Module<[import("haywire").NonExtendable<ConsoleLog | null | undefined, null, "log">] | [import("haywire").NonExtendable<ConsoleLog | null, null, "log">] | [import("haywire").NonExtendable<ConsoleLog | undefined, null, "log">] | [import("haywire").NonExtendable<ConsoleLog, null, "log">] | [import("haywire").NonExtendable<ConsoleLog | null | undefined, null, "error">] | [import("haywire").NonExtendable<ConsoleLog | null, null, "error">] | [import("haywire").NonExtendable<ConsoleLog | undefined, null, "error">] | [import("haywire").NonExtendable<ConsoleLog, null, "error">] | [import("haywire").NonExtendable<ExitCode | null | undefined, null, null>] | [import("haywire").NonExtendable<ExitCode | null, null, null>] | [import("haywire").NonExtendable<ExitCode | undefined, null, null>] | [import("haywire").NonExtendable<ExitCode, null, null>], never, false>;
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/commands/lib/dependencies.js

@@ -0,0 +1,9 @@
+import { bind, createModule, identifier } from 'haywire';
+export const consoleLogId = identifier().named('log');
+export const consoleErrorId = identifier().named('error');
+export const exitCodeId = identifier();
+export const dependenciesModule = createModule(bind(consoleLogId).withInstance(console.log)).addBinding(bind(consoleErrorId).withInstance(console.error)).addBinding(bind(exitCodeId).withInstance((code)=>{
+    process.exitCode = code;
+}));
+
+//# sourceMappingURL=dependencies.js.map

package/dist/commands/lib/types.d.ts

@@ -0,0 +1,9 @@
+import type { CommandModule } from 'yargs';
+export interface LoadPopulateFilesCommandInput {
+    cwd: string;
+}
+export type Command<ExtendedInput extends LoadPopulateFilesCommandInput> = Pick<CommandModule<LoadPopulateFilesCommandInput, ExtendedInput>, 'builder' | 'command' | 'describe' | 'handler'>;
+export interface AbstractCommand extends Pick<CommandModule<LoadPopulateFilesCommandInput, LoadPopulateFilesCommandInput>, 'builder' | 'command' | 'describe'> {
+    handler: (args: any) => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/commands/lib/types.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=types.js.map

package/dist/commands/load-populate-files-command.d.ts

@@ -0,0 +1,21 @@
+import type { Argv } from 'yargs';
+import type { LoadAndPopulateFiles } from 'load-populate-files';
+import type { Command, LoadPopulateFilesCommandInput } from './lib/types.js';
+interface LoadPopulateFilesCommandExtendedInput extends LoadPopulateFilesCommandInput {
+    filePath: string;
+    ci: boolean;
+    dryRun: boolean;
+}
+/**
+ * Main `load-populate-files` command
+ */
+export declare class LoadPopulateFilesCommand implements Command<LoadPopulateFilesCommandExtendedInput> {
+    #private;
+    readonly command: string[];
+    readonly describe = "Read pre-generated content and write to file";
+    constructor(loadPopulateFiles: LoadAndPopulateFiles);
+    builder(this: void, yargs: Argv<LoadPopulateFilesCommandInput>): Argv<LoadPopulateFilesCommandExtendedInput>;
+    handler(options: LoadPopulateFilesCommandExtendedInput): Promise<void>;
+}
+export {};
+//# sourceMappingURL=load-populate-files-command.d.ts.map

package/dist/commands/load-populate-files-command.js

@@ -0,0 +1,44 @@
+import { isCI } from 'ci-info';
+export class LoadPopulateFilesCommand {
+    command = [
+        '$0',
+        'load-populate-files'
+    ];
+    describe = 'Read pre-generated content and write to file';
+    #loadPopulateFiles;
+    constructor(loadPopulateFiles){
+        this.#loadPopulateFiles = loadPopulateFiles;
+        this.handler = this.handler.bind(this);
+    }
+    builder(yargs) {
+        return yargs.options({
+            filePath: {
+                describe: 'File that exports data content to populate',
+                type: 'string',
+                required: true
+            },
+            ci: {
+                describe: 'Fail if file is not up to date. Implies --dry-run',
+                type: 'boolean',
+                default: isCI,
+                alias: 'check'
+            },
+            dryRun: {
+                describe: 'Do not write file',
+                type: 'boolean',
+                default: false
+            }
+        }).strict();
+    }
+    async handler(options) {
+        await this.#loadPopulateFiles({
+            filePath: options.filePath
+        }, {
+            cwd: options.cwd,
+            check: options.ci,
+            dryRun: options.dryRun
+        });
+    }
+}
+
+//# sourceMappingURL=load-populate-files-command.js.map

package/dist/index.d.ts

@@ -1,5 +1,4 @@
-import { type PopulationResponse } from 'populate-files';
-import type { RawOptions, RawParams } from './lib/types.js';
-export type { FileContent, PopulateFileParams } from 'populate-files';
-export declare const loadAndPopulateFiles: (params: RawParams, options?: RawOptions) => Promise<PopulationResponse[]>;
+export type { PopulateFileParams } from 'populate-files';
+export type { LoadAndPopulateFiles } from './lib/load-populate-files.js';
+export declare const loadAndPopulateFiles: import("./lib/load-populate-files.js").LoadAndPopulateFiles;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,9 +1,5 @@
-import { populateFiles } from 'populate-files';
-import { loadFile } from './lib/loader.js';
-import { normalizeParams } from './lib/normalize.js';
-export const loadAndPopulateFiles = async (params, options)=>{
-    const normalized = await normalizeParams(params, options);
-    const files = await loadFile(normalized.filePath);
-    return populateFiles(files, normalized.options);
-};
-//# sourceMappingURL=index.js.map
+import { createContainer } from 'haywire';
+import { loadAndPopulateFilesId, loadAndPopulateFilesModule } from './lib/index.js';
+export const loadAndPopulateFiles = createContainer(loadAndPopulateFilesModule).get(loadAndPopulateFilesId);
+
+//# sourceMappingURL=index.js.map

package/dist/lib/index.d.ts

@@ -0,0 +1,6 @@
+import { type LoadAndPopulateFiles, LoadPopulateFilesFactory } from './load-populate-files.js';
+import { type LoadFile } from './loader.js';
+import { type NormalizeParams } from './normalize.js';
+export declare const loadAndPopulateFilesId: import("haywire").HaywireId<LoadAndPopulateFiles, null, null, false, false, false, false>;
+export declare const loadAndPopulateFilesModule: import("haywire").Module<[import("haywire").NonExtendable<import("./lib/dependencies.js").Importer | null | undefined, null, null>] | [import("haywire").NonExtendable<import("./lib/dependencies.js").Importer | null, null, null>] | [import("haywire").NonExtendable<import("./lib/dependencies.js").Importer | undefined, null, null>] | [import("haywire").NonExtendable<import("./lib/dependencies.js").Importer, null, null>] | [import("haywire").NonExtendable<import("parse-cwd").ParseCwd | null | undefined, null, null>] | [import("haywire").NonExtendable<import("parse-cwd").ParseCwd | null, null, null>] | [import("haywire").NonExtendable<import("parse-cwd").ParseCwd | undefined, null, null>] | [import("haywire").NonExtendable<import("parse-cwd").ParseCwd, null, null>] | [import("haywire").NonExtendable<import("populate-files").PopulateFiles | null | undefined, null, null>] | [import("haywire").NonExtendable<import("populate-files").PopulateFiles | null, null, null>] | [import("haywire").NonExtendable<import("populate-files").PopulateFiles | undefined, null, null>] | [import("haywire").NonExtendable<import("populate-files").PopulateFiles, null, null>] | [import("haywire").NonExtendable<LoadPopulateFilesFactory | null | undefined, typeof LoadPopulateFilesFactory, null>] | [import("haywire").NonExtendable<LoadPopulateFilesFactory | null, typeof LoadPopulateFilesFactory, null>] | [import("haywire").NonExtendable<LoadPopulateFilesFactory | undefined, typeof LoadPopulateFilesFactory, null>] | [import("haywire").NonExtendable<LoadPopulateFilesFactory, typeof LoadPopulateFilesFactory, null>] | [import("haywire").NonExtendable<NormalizeParams, null, null>] | [import("haywire").NonExtendable<LoadFile, null, null>] | [import("haywire").NonExtendable<LoadAndPopulateFiles | null | undefined, null, null>] | [import("haywire").NonExtendable<LoadAndPopulateFiles | null, null, null>] | [import("haywire").NonExtendable<LoadAndPopulateFiles | undefined, null, null>] | [import("haywire").NonExtendable<LoadAndPopulateFiles, null, null>] | [import("haywire").NonExtendable<LoadFile | null | undefined, null, null>] | [import("haywire").NonExtendable<LoadFile | null, null, null>] | [import("haywire").NonExtendable<LoadFile | undefined, null, null>] | [import("haywire").NonExtendable<NormalizeParams | null | undefined, null, null>] | [import("haywire").NonExtendable<NormalizeParams | null, null, null>] | [import("haywire").NonExtendable<NormalizeParams | undefined, null, null>], [import("haywire").NonExtendable<import("./lib/dependencies.js").Importer, null, null>] | [import("haywire").NonExtendable<import("parse-cwd").ParseCwd, null, null>] | [import("haywire").NonExtendable<import("populate-files").PopulateFiles, null, null>] | [import("haywire").NonExtendable<LoadPopulateFilesFactory, typeof LoadPopulateFilesFactory, null>] | [import("haywire").NonExtendable<NormalizeParams, null, null>] | [import("haywire").NonExtendable<LoadFile, null, null>], false>;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/index.js

@@ -0,0 +1,21 @@
+import { bind, identifier, singletonScope } from 'haywire';
+import { dependencies, importerId, parseCwdId, populateFilesId } from './lib/dependencies.js';
+import { LoadPopulateFilesFactory } from './load-populate-files.js';
+import { loadFileProvider } from './loader.js';
+import { normalizeParamsProvider } from './normalize.js';
+const normalizeParamsId = identifier();
+const loadFileId = identifier();
+export const loadAndPopulateFilesId = identifier();
+export const loadAndPopulateFilesModule = dependencies.addBinding(bind(LoadPopulateFilesFactory).withDependencies([
+    normalizeParamsId,
+    loadFileId,
+    populateFilesId
+]).withConstructorProvider().scoped(singletonScope)).addBinding(bind(loadAndPopulateFilesId).withDependencies([
+    LoadPopulateFilesFactory
+]).withProvider((factory)=>factory.loadAndPopulateFiles)).addBinding(bind(loadFileId).withDependencies([
+    importerId
+]).withProvider(loadFileProvider)).addBinding(bind(normalizeParamsId).withDependencies([
+    parseCwdId
+]).withProvider(normalizeParamsProvider));
+
+//# sourceMappingURL=index.js.map

package/dist/lib/lib/dependencies.d.ts

@@ -0,0 +1,8 @@
+import { type ParseCwd } from 'parse-cwd';
+import { type PopulateFiles } from 'populate-files';
+export type Importer = (specifier: string) => Promise<unknown>;
+export declare const importerId: import("haywire").HaywireId<Importer, null, null, false, false, false, false>;
+export declare const parseCwdId: import("haywire").HaywireId<ParseCwd, null, null, false, false, false, false>;
+export declare const populateFilesId: import("haywire").HaywireId<PopulateFiles, null, null, false, false, false, false>;
+export declare const dependencies: import("haywire").Module<[import("haywire").NonExtendable<Importer | null | undefined, null, null>] | [import("haywire").NonExtendable<Importer | null, null, null>] | [import("haywire").NonExtendable<Importer | undefined, null, null>] | [import("haywire").NonExtendable<Importer, null, null>] | [import("haywire").NonExtendable<ParseCwd | null | undefined, null, null>] | [import("haywire").NonExtendable<ParseCwd | null, null, null>] | [import("haywire").NonExtendable<ParseCwd | undefined, null, null>] | [import("haywire").NonExtendable<ParseCwd, null, null>] | [import("haywire").NonExtendable<PopulateFiles | null | undefined, null, null>] | [import("haywire").NonExtendable<PopulateFiles | null, null, null>] | [import("haywire").NonExtendable<PopulateFiles | undefined, null, null>] | [import("haywire").NonExtendable<PopulateFiles, null, null>], never, false>;
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/lib/lib/dependencies.js

@@ -0,0 +1,9 @@
+import { bind, createModule, identifier } from 'haywire';
+import { parseCwd } from 'parse-cwd';
+import { populateFiles } from 'populate-files';
+export const importerId = identifier();
+export const parseCwdId = identifier();
+export const populateFilesId = identifier();
+export const dependencies = createModule(bind(importerId).withInstance(async (specifier)=>import(specifier))).addBinding(bind(parseCwdId).withInstance(parseCwd)).addBinding(bind(populateFilesId).withInstance(populateFiles));
+
+//# sourceMappingURL=dependencies.js.map

package/dist/lib/lib/populate-files-validator.d.ts

@@ -0,0 +1,15 @@
+import AjvDefault from 'ajv/dist/2020.js';
+export declare const isPopulateFileParams: AjvDefault.ValidateFunction<(Partial<{
+    filePath: string;
+    content: import("populate-files").FileContent | Promise<import("populate-files").FileContent>;
+}> & Required<Pick<{
+    filePath: string;
+    content: import("populate-files").FileContent | Promise<import("populate-files").FileContent>;
+}, "content" | "filePath">>) | (Partial<{
+    filePath: string;
+    content: import("populate-files").FileContent | Promise<import("populate-files").FileContent>;
+}> & Required<Pick<{
+    filePath: string;
+    content: import("populate-files").FileContent | Promise<import("populate-files").FileContent>;
+}, "content" | "filePath">>)[]>;
+//# sourceMappingURL=populate-files-validator.d.ts.map

package/dist/lib/lib/populate-files-validator.js

@@ -0,0 +1,25 @@
+import AjvDefault from 'ajv/dist/2020.js';
+import { defaultImport } from 'default-import';
+import { arraySchema, mergeSchema, objectSchema, stringSchema } from 'juniper';
+const Ajv = defaultImport(AjvDefault);
+const populateFileParam = objectSchema({
+    properties: {
+        filePath: stringSchema(),
+        content: mergeSchema().cast()
+    },
+    required: [
+        'filePath',
+        'content'
+    ]
+});
+const populateFileParams = mergeSchema().oneOf([
+    populateFileParam,
+    arraySchema({
+        items: populateFileParam
+    })
+]);
+export const isPopulateFileParams = new Ajv({
+    strict: true
+}).compile(populateFileParams.toJSON());
+
+//# sourceMappingURL=populate-files-validator.js.map

package/dist/lib/load-populate-files.d.ts

@@ -0,0 +1,14 @@
+import type { PopulateFiles, PopulationResponse } from 'populate-files';
+import type { LoadFile } from './loader.js';
+import type { NormalizeParams } from './normalize.js';
+import type { RawOptions, RawParams } from './types.js';
+export type LoadAndPopulateFiles = (params: RawParams, options?: RawOptions) => Promise<PopulationResponse[]>;
+/**
+ * Factory for generating primary `loadAndPopulateFiles` function
+ */
+export declare class LoadPopulateFilesFactory {
+    #private;
+    readonly loadAndPopulateFiles: LoadAndPopulateFiles;
+    constructor(normalizeParams: NormalizeParams, loadFile: LoadFile, populateFiles: PopulateFiles);
+}
+//# sourceMappingURL=load-populate-files.d.ts.map

package/dist/lib/load-populate-files.js

@@ -0,0 +1,19 @@
+export class LoadPopulateFilesFactory {
+    #normalizeParams;
+    #loadFile;
+    #populateFiles;
+    loadAndPopulateFiles;
+    constructor(normalizeParams, loadFile, populateFiles){
+        this.#normalizeParams = normalizeParams;
+        this.#loadFile = loadFile;
+        this.#populateFiles = populateFiles;
+        this.loadAndPopulateFiles = this.#loadAndPopulateFiles.bind(this);
+    }
+    async #loadAndPopulateFiles(params, options = {}) {
+        const normalized = await this.#normalizeParams(params, options);
+        const files = await this.#loadFile(normalized.filePath);
+        return this.#populateFiles(files, normalized.options);
+    }
+}
+
+//# sourceMappingURL=load-populate-files.js.map

package/dist/lib/loader.d.ts

@@ -1,3 +1,5 @@
 import type { PopulateFileParams } from 'populate-files';
-export declare const loadFile: (filePath: string) => Promise<PopulateFileParams[]>;
+import type { Importer } from './lib/dependencies.js';
+export type LoadFile = (filePath: string) => Promise<PopulateFileParams[]>;
+export declare const loadFileProvider: (importer: Importer) => LoadFile;
 //# sourceMappingURL=loader.d.ts.map

package/dist/lib/loader.js

@@ -1,9 +1,19 @@
 import { defaultImport } from 'default-import';
-export const loadFile = async (filePath)=>{
-    const mod = await import(filePath);
-    const params = defaultImport(mod);
-    return [
-        params
-    ].flat();
-};
-//# sourceMappingURL=loader.js.map
+import { isPopulateFileParams } from './lib/populate-files-validator.js';
+export const loadFileProvider = (importer)=>async (filePath)=>{
+        const mod = await importer(filePath).catch((err)=>{
+            if (String(err).includes('ERR_MODULE_NOT_FOUND')) {
+                throw new Error(`JS file not found: ${filePath}`);
+            }
+            throw err;
+        });
+        const params = defaultImport(mod);
+        if (isPopulateFileParams(params)) {
+            return [
+                params
+            ].flat();
+        }
+        throw new Error(`File content does not fulfill populate-file input at: ${filePath}`);
+    };
+
+//# sourceMappingURL=loader.js.map

package/dist/lib/normalize.d.ts

@@ -1,3 +1,5 @@
+import type { ParseCwd } from 'parse-cwd';
 import type { NormalizedParams, RawOptions, RawParams } from './types.js';
-export declare const normalizeParams: (params: RawParams, options?: RawOptions) => Promise<NormalizedParams>;
+export type NormalizeParams = (params: RawParams, options?: RawOptions) => Promise<NormalizedParams>;
+export declare const normalizeParamsProvider: (parseCwd: ParseCwd) => NormalizeParams;
 //# sourceMappingURL=normalize.d.ts.map

package/dist/lib/normalize.js

@@ -1,14 +1,14 @@
 import Path from 'node:path';
-import { parseCwd } from 'npm-parse-cwd';
-export const normalizeParams = async (params, options = {})=>{
-    const cwd = await parseCwd(options.cwd);
-    return {
-        filePath: Path.resolve(cwd, params.filePath),
-        options: {
-            cwd,
-            check: options.check,
-            dryRun: options.dryRun
-        }
+export const normalizeParamsProvider = (parseCwd)=>async (params, options = {})=>{
+        const cwd = await parseCwd(options.cwd);
+        return {
+            filePath: Path.resolve(cwd, params.filePath),
+            options: {
+                cwd,
+                check: options.check,
+                dryRun: options.dryRun
+            }
+        };
     };
-};
-//# sourceMappingURL=normalize.js.map
+
+//# sourceMappingURL=normalize.js.map

package/dist/lib/types.d.ts

@@ -1,4 +1,4 @@
-import type { Directory } from 'npm-parse-cwd';
+import type { Directory } from 'parse-cwd';
 export interface RawParams {
     filePath: string;
 }

package/dist/lib/types.js

@@ -1,2 +1,3 @@
 export { };
-//# sourceMappingURL=types.js.map
+
+//# sourceMappingURL=types.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "load-populate-files",
-  "version": "0.0.11",
+  "version": "0.1.1",
   "description": "Load and dynamically populate file content",
   "engines": {
     "node": ">=20"
@@ -16,27 +16,46 @@
   "keywords": [
     "content",
     "write",
-    "build"
+    "build",
+    "cli"
   ],
   "sideEffects": false,
   "exports": {
     ".": "./dist/index.js"
   },
+  "bin": {
+    "load-populate-files": "./bin.mjs"
+  },
   "dependencies": {
-    "npm-parse-cwd": "npm:parse-cwd@latest",
-    "populate-files": "^0.1.2",
-    "default-import": "^2.0.4"
+    "ajv": "^8.17.1",
+    "ci-info": "^4.1.0",
+    "yargs": "^17.7.2",
+    "default-import": "^2.0.7",
+    "haywire-launcher": "^0.1.10",
+    "juniper": "^1.2.4",
+    "parse-cwd": "^1.1.1",
+    "populate-files": "^0.2.3",
+    "entry-script": "^3.0.8",
+    "haywire": "^0.1.7"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
+    "@swc/cli": "^0.5.2",
+    "@swc/core": "^1.10.4",
     "@types/chai": "^5.0.1",
-    "@types/mocha": "^10.0.9",
-    "@types/node": "^22.8.6",
+    "@types/chai-as-promised": "^8.0.1",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^22.10.2",
+    "@types/yargs": "^17.0.33",
+    "c8": "^10.1.3",
     "chai": "^5.1.2",
-    "mocha": "^10.8.2",
-    "npm-nx-update-ts-references": "npm:nx-update-ts-references@latest",
-    "typescript": "^5.6.3",
-    "@leyman/eslint-config": "^0.0.4",
-    "nx-tsc": "^0.0.13"
+    "chai-as-promised": "^8.0.1",
+    "eslint": "^9.17.0",
+    "mocha": "^11.0.1",
+    "typescript": "^5.7.2",
+    "@leyman/eslint-config": "^0.0.5",
+    "mocha-chain": "^0.0.10",
+    "nx-update-ts-references": "^0.2.0",
+    "pnpm-dedicated-lockfile": "^0.0.3"
   }
 }