@plugjs/plug 0.0.14 → 0.0.16

package/dist/async.cjs

@@ -20,40 +20,41 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // async.ts
 var async_exports = {};
 __export(async_exports, {
-  currentRun: () => currentRun,
-  currentTask: () => currentTask,
+  currentContext: () => currentContext,
+  requireContext: () => requireContext,
   runAsync: () => runAsync,
   runningTasks: () => runningTasks
 });
 module.exports = __toCommonJS(async_exports);
 var import_node_async_hooks = require("node:async_hooks");
-function runAsync(run, task, callback) {
-  return storage.run({ run, task }, () => {
-    tasks.push(task);
-    return callback().finally(() => {
-      const index = tasks.lastIndexOf(task);
-      if (index >= 0)
-        tasks.splice(index, 1);
-    });
+var import_assert = require("./assert.cjs");
+function runAsync(context, taskName, callback) {
+  return storage.run(context, async () => {
+    try {
+      tasks.add(taskName);
+      return await callback();
+    } finally {
+      tasks.delete(taskName);
+    }
   });
 }
-function currentTask() {
-  var _a;
-  return (_a = storage.getStore()) == null ? void 0 : _a.task;
+function currentContext() {
+  return storage.getStore();
 }
-function currentRun() {
-  var _a;
-  return (_a = storage.getStore()) == null ? void 0 : _a.run;
+function requireContext() {
+  const context = storage.getStore();
+  (0, import_assert.assert)(context, "Unable to retrieve current context");
+  return context;
 }
 function runningTasks() {
   return [...tasks].sort();
 }
 var storage = new import_node_async_hooks.AsyncLocalStorage();
-var tasks = [];
+var tasks = /* @__PURE__ */ new Set();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  currentRun,
-  currentTask,
+  currentContext,
+  requireContext,
   runAsync,
   runningTasks
 });

package/dist/async.cjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/async.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,8BAAkC;AAW3B,SAAS,SAAY,KAAU,MAAc,UAAwC;AAC1F,SAAO,QAAQ,IAAI,EAAE,KAAK,KAAK,GAAG,MAAM;AACtC,UAAM,KAAK,IAAI;AACf,WAAO,SAAS,EAAE,QAAQ,MAAM;AAC9B,YAAM,QAAQ,MAAM,YAAY,IAAI;AACpC,UAAI,SAAS;AAAG,cAAM,OAAO,OAAO,CAAC;AAAA,IACvC,CAAC;AAAA,EACH,CAAC;AACH;AAMO,SAAS,cAAkC;AAzBlD;AA0BE,UAAO,aAAQ,SAAS,MAAjB,mBAAoB;AAC7B;AAMO,SAAS,aAA8B;AAjC9C;AAkCE,UAAO,aAAQ,SAAS,MAAjB,mBAAoB;AAC7B;AAKO,SAAS,eAAyB;AACvC,SAAO,CAAE,GAAG,KAAM,EAAE,KAAK;AAC3B;AAMA,IAAM,UAAU,IAAI,0CAA8C;AAClE,IAAM,QAAkB,CAAC;",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,8BAAkC;AAClC,oBAAuB;AAWhB,SAAS,SACZ,SACA,UACA,UACU;AACZ,SAAO,QAAQ,IAAI,SAAS,YAAY;AACtC,QAAI;AACF,YAAM,IAAI,QAAQ;AAClB,aAAO,MAAM,SAAS;AAAA,IACxB,UAAE;AACA,YAAM,OAAO,QAAQ;AAAA,IACvB;AAAA,EACF,CAAC;AACH;AAMO,SAAS,iBAAsC;AACpD,SAAO,QAAQ,SAAS;AAC1B;AAMO,SAAS,iBAA0B;AACxC,QAAM,UAAU,QAAQ,SAAS;AACjC,4BAAO,SAAS,oCAAoC;AACpD,SAAO;AACT;AAKO,SAAS,eAAyB;AACvC,SAAO,CAAE,GAAG,KAAM,EAAE,KAAK;AAC3B;AAMA,IAAM,UAAU,IAAI,0CAA2B;AAC/C,IAAM,QAAQ,oBAAI;",
   "names": []
 }

package/dist/async.d.ts

@@ -1,19 +1,19 @@
-import { Run } from './run.js';
+import { Context } from './pipe';
 /**
- * Run the specified `callback` associating the specified {@link Run} and task
+ * Run the specified `callback` associating the specified {@link Context} and task
  * name with the current asynchronous invocation context.
  */
-export declare function runAsync<T>(run: Run, task: string, callback: () => Promise<T>): Promise<T>;
+export declare function runAsync<T>(context: Context, taskName: string, callback: () => Promise<T>): Promise<T>;
 /**
- * Returns the _task name_ associated with the current asynchronous invocation
- * context or `undefined`.
+ * Returns the {@link Context} associated with the current asynchronous
+ * invocation context or `undefined`.
  */
-export declare function currentTask(): string | undefined;
+export declare function currentContext(): Context | undefined;
 /**
- * Returns the {@link Run} associated with the current asynchronous invocation
- * context or `undefined`.
+ * Returns the {@link Context} associated with the current asynchronous
+ * invocation context and fail if none was found.
  */
-export declare function currentRun(): Run | undefined;
+export declare function requireContext(): Context;
 /**
  * Return an array of all _task names_ currently running
  */

package/dist/async.mjs

@@ -1,31 +1,32 @@
 // async.ts
 import { AsyncLocalStorage } from "node:async_hooks";
-function runAsync(run, task, callback) {
-  return storage.run({ run, task }, () => {
-    tasks.push(task);
-    return callback().finally(() => {
-      const index = tasks.lastIndexOf(task);
-      if (index >= 0)
-        tasks.splice(index, 1);
-    });
+import { assert } from "./assert.mjs";
+function runAsync(context, taskName, callback) {
+  return storage.run(context, async () => {
+    try {
+      tasks.add(taskName);
+      return await callback();
+    } finally {
+      tasks.delete(taskName);
+    }
   });
 }
-function currentTask() {
-  var _a;
-  return (_a = storage.getStore()) == null ? void 0 : _a.task;
+function currentContext() {
+  return storage.getStore();
 }
-function currentRun() {
-  var _a;
-  return (_a = storage.getStore()) == null ? void 0 : _a.run;
+function requireContext() {
+  const context = storage.getStore();
+  assert(context, "Unable to retrieve current context");
+  return context;
 }
 function runningTasks() {
   return [...tasks].sort();
 }
 var storage = new AsyncLocalStorage();
-var tasks = [];
+var tasks = /* @__PURE__ */ new Set();
 export {
-  currentRun,
-  currentTask,
+  currentContext,
+  requireContext,
   runAsync,
   runningTasks
 };

package/dist/async.mjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/async.ts"],
-  "mappings": ";AAAA,SAAS,yBAAyB;AAW3B,SAAS,SAAY,KAAU,MAAc,UAAwC;AAC1F,SAAO,QAAQ,IAAI,EAAE,KAAK,KAAK,GAAG,MAAM;AACtC,UAAM,KAAK,IAAI;AACf,WAAO,SAAS,EAAE,QAAQ,MAAM;AAC9B,YAAM,QAAQ,MAAM,YAAY,IAAI;AACpC,UAAI,SAAS;AAAG,cAAM,OAAO,OAAO,CAAC;AAAA,IACvC,CAAC;AAAA,EACH,CAAC;AACH;AAMO,SAAS,cAAkC;AAzBlD;AA0BE,UAAO,aAAQ,SAAS,MAAjB,mBAAoB;AAC7B;AAMO,SAAS,aAA8B;AAjC9C;AAkCE,UAAO,aAAQ,SAAS,MAAjB,mBAAoB;AAC7B;AAKO,SAAS,eAAyB;AACvC,SAAO,CAAE,GAAG,KAAM,EAAE,KAAK;AAC3B;AAMA,IAAM,UAAU,IAAI,kBAA8C;AAClE,IAAM,QAAkB,CAAC;",
+  "mappings": ";AAAA,SAAS,yBAAyB;AAClC,SAAS,cAAc;AAWhB,SAAS,SACZ,SACA,UACA,UACU;AACZ,SAAO,QAAQ,IAAI,SAAS,YAAY;AACtC,QAAI;AACF,YAAM,IAAI,QAAQ;AAClB,aAAO,MAAM,SAAS;AAAA,IACxB,UAAE;AACA,YAAM,OAAO,QAAQ;AAAA,IACvB;AAAA,EACF,CAAC;AACH;AAMO,SAAS,iBAAsC;AACpD,SAAO,QAAQ,SAAS;AAC1B;AAMO,SAAS,iBAA0B;AACxC,QAAM,UAAU,QAAQ,SAAS;AACjC,SAAO,SAAS,oCAAoC;AACpD,SAAO;AACT;AAKO,SAAS,eAAyB;AACvC,SAAO,CAAE,GAAG,KAAM,EAAE,KAAK;AAC3B;AAMA,IAAM,UAAU,IAAI,kBAA2B;AAC/C,IAAM,QAAQ,oBAAI;",
   "names": []
 }

package/dist/build.cjs

@@ -21,136 +21,139 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var build_exports = {};
 __export(build_exports, {
   build: () => build,
-  isBuild: () => isBuild
+  call: () => call
 });
 module.exports = __toCommonJS(build_exports);
 var import_assert = require("./assert.cjs");
 var import_async = require("./async.cjs");
 var import_log = require("./log.cjs");
-var import_paths = require("./paths.cjs");
 var import_pipe = require("./pipe.cjs");
-var import_run = require("./run.cjs");
-var import_task = require("./task.cjs");
 var import_caller = require("./utils/caller.cjs");
-var buildMarker = Symbol.for("plugjs:isBuild");
-function isBuild(build2) {
-  return build2 && build2[buildMarker] === buildMarker;
-}
-function build(definition) {
-  const buildFile = (0, import_caller.findCaller)(build).file;
-  const buildDir = (0, import_paths.getAbsoluteParent)(buildFile);
-  const tasks = {};
-  const context = { buildFile, buildDir, tasks };
-  const result = {};
-  for (const name in definition) {
-    const def = definition[name];
-    const task = "task" in def ? def.task : new import_task.TaskImpl(context, def);
-    const call = async (run) => {
-      if (!run)
-        run = run = new BuildRun(buildDir, buildFile, tasks);
-      (0, import_assert.assert)(run instanceof BuildRun, "Incompatible Run specified");
-      run.log.notice("Starting build...");
-      const now = Date.now();
-      let error = void 0;
-      try {
-        await run.call(name);
-      } catch (err) {
-        run.log.error(err);
-        error = err;
-      }
-      try {
-        await run.finish();
-        if (error !== void 0)
-          throw error;
-        run.log.notice("Build completed", (0, import_log.$ms)(Date.now() - now));
-        return run;
-      } catch (error2) {
-        run.log.error(`Build failed ${(0, import_log.$ms)(Date.now() - now)}`, error2);
-        throw (0, import_assert.failure)();
-      }
-    };
-    Object.defineProperty(call, "name", { enumerable: true, value: name });
-    if (name.length > import_log.logOptions.taskLength) {
-      import_log.logOptions.taskLength = name.length;
-    }
-    result[name] = Object.assign(call, { task });
-    tasks[name] = task;
+var import_options = require("./utils/options.cjs");
+var PipeImpl = class extends import_pipe.Pipe {
+  constructor(context, _promise) {
+    super(context, () => _promise.then((result) => {
+      (0, import_assert.assert)(result, "Unable to extend pipe");
+      return result;
+    }));
+    this._promise = _promise;
   }
-  Object.defineProperty(result, buildMarker, { value: buildMarker });
-  return result;
-}
-var BuildRun = class extends import_run.RunImpl {
-  constructor(buildDir, buildFile, _tasks, _stack = [], _cache = /* @__PURE__ */ new Map(), taskName = "") {
-    super({ taskName, buildDir, buildFile });
-    this._tasks = _tasks;
-    this._stack = _stack;
-    this._cache = _cache;
+  [Symbol.toStringTag] = "PipeImpl";
+  then(onfulfilled, onrejected) {
+    return this._promise.then(onfulfilled, onrejected);
   }
-  async finish() {
-    const names = [];
-    const promises = [];
-    for (const { name, promise } of this._cache.values()) {
-      names.push(name);
-      promises.push(promise);
-    }
-    const settlements = await Promise.allSettled(promises);
-    const failures = settlements.reduce((failures2, settlement, i) => {
-      if (settlement.status === "rejected") {
-        const name = names[i];
-        (0, import_log.getLogger)(name).error(settlement.reason);
-        failures2.push(name);
-      }
-      return failures2;
-    }, []);
-    if (failures.length) {
-      const message = `${failures.length === 1 ? "task has" : "tasks have"}`;
-      const names2 = failures.map((task) => (0, import_log.$t)(task)).join((0, import_log.$gry)(", "));
-      this.log.error(failures.length, message, "failed:", names2);
-      throw (0, import_assert.failure)();
-    }
+  catch(onrejected) {
+    return this._promise.catch(onrejected);
   }
-  call(name) {
-    const task = this._tasks[name];
-    if (!task)
-      (0, import_assert.fail)(`Task "${(0, import_log.$t)(name)}" does not exist`);
-    (0, import_assert.assert)(!this._stack.includes(task), `Circular dependency running task "${(0, import_log.$t)(name)}"`);
-    const cached = this._cache.get(task);
+  finally(onfinally) {
+    return this._promise.finally(onfinally);
+  }
+};
+var TaskImpl = class {
+  constructor(buildFile, tasks, props, _def) {
+    this.buildFile = buildFile;
+    this.tasks = tasks;
+    this.props = props;
+    this._def = _def;
+  }
+  call(state, taskName) {
+    (0, import_assert.assert)(!state.stack.includes(this), `Recursion detected calling ${(0, import_log.$t)(taskName)}`);
+    const cached = state.cache.get(this);
     if (cached)
-      return cached.promise;
-    const childRun = new BuildRun(
-      task.context.buildDir,
-      task.context.buildFile,
-      { ...task.context.tasks, ...this._tasks },
-      [...this._stack, task],
-      this._cache,
-      name
-    );
-    const promise = (0, import_async.runAsync)(childRun, name, () => childRun._run(name, task));
-    this._cache.set(task, { name, promise });
+      return cached;
+    const props = Object.assign({}, this.props, state.props);
+    const tasks = Object.assign({}, this.tasks, state.tasks);
+    const stack = [...state.stack, this];
+    const cache = state.cache;
+    const context = new import_pipe.Context(this.buildFile, taskName);
+    const build2 = new Proxy({}, {
+      get(_, name) {
+        if (name in tasks) {
+          return () => {
+            const state2 = { stack, cache, tasks, props };
+            const promise2 = tasks[name].call(state2, name);
+            return new PipeImpl(context, promise2);
+          };
+        } else if (name in props) {
+          return props[name];
+        }
+      }
+    });
+    context.log.info("Running...");
+    const now = Date.now();
+    const promise = (0, import_async.runAsync)(context, taskName, async () => {
+      let result = await this._def.call(build2);
+      if (result && "run" in result)
+        result = await result.run();
+      return result || void 0;
+    }).then((result) => {
+      context.log.notice(`Success ${(0, import_log.$ms)(Date.now() - now)}`);
+      return result;
+    }).catch((error) => {
+      context.log.error(`Failure ${(0, import_log.$ms)(Date.now() - now)}`, error);
+      throw (0, import_assert.failure)();
+    });
+    cache.set(this, promise);
     return promise;
   }
-  async _run(name, task) {
-    const now = Date.now();
-    this.log.notice(`Starting task ${(0, import_log.$t)(name)}...`);
-    const thisBuild = {};
-    for (const name2 in this._tasks) {
-      thisBuild[name2] = () => {
-        return new import_pipe.PipeImpl(this.call(name2), this);
-      };
+};
+var buildMarker = Symbol.for("plugjs:isBuild");
+function build(def) {
+  const buildFile = (0, import_caller.findCaller)(build);
+  const tasks = {};
+  const props = {};
+  for (const [key, val] of Object.entries(def)) {
+    let len = 0;
+    if (typeof val === "string") {
+      props[key] = val;
+    } else if (typeof val === "function") {
+      tasks[key] = new TaskImpl(buildFile, tasks, props, val);
+      len = key.length;
+    } else if (val instanceof TaskImpl) {
+      tasks[key] = val;
+      len = key.length;
     }
+    if (len > import_log.logOptions.taskLength)
+      import_log.logOptions.taskLength = len;
+  }
+  const call2 = async function call3(taskNames, overrideProps = {}) {
+    const logger = (0, import_log.getLogger)("");
+    const state = {
+      cache: /* @__PURE__ */ new Map(),
+      stack: [],
+      props: Object.assign({}, props, overrideProps),
+      tasks
+    };
+    logger.notice("Starting...");
+    const now = Date.now();
     try {
-      const result = await task.call(thisBuild, this);
-      this.log.notice(`Task ${(0, import_log.$t)(name)} completed`, (0, import_log.$ms)(Date.now() - now));
-      return result;
+      for (const taskName of taskNames) {
+        if (taskName in tasks) {
+          await tasks[taskName].call(state, taskName);
+        } else {
+          (0, import_assert.fail)(`Task ${(0, import_log.$t)(taskName)} not found in build`);
+        }
+      }
+      logger.notice(`Build successful ${(0, import_log.$ms)(Date.now() - now)}`);
     } catch (error) {
-      this.log.error(`Task ${(0, import_log.$t)(name)} failed ${(0, import_log.$ms)(Date.now() - now)}`, error);
+      logger.error(`Build failed ${(0, import_log.$ms)(Date.now() - now)}`, error);
       throw (0, import_assert.failure)();
     }
-  }
-};
+  };
+  const compiled = Object.assign({}, props, tasks);
+  Object.defineProperty(compiled, buildMarker, { value: call2 });
+  return compiled;
+}
+function call(build2, ...args) {
+  const { params: tasks, options: props } = (0, import_options.parseOptions)(args, {});
+  const call2 = build2[buildMarker];
+  if (typeof call2 !== "function")
+    (0, import_assert.fail)("Unknown build type");
+  return call2(tasks, props);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   build,
-  isBuild
+  call
 });
 //# sourceMappingURL=build.cjs.map

package/dist/build.cjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/build.ts"],
-  "mappings": "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",
-  "names": ["build", "error", "failures", "names", "name"]
+  "mappings": "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",
+  "names": ["build", "state", "promise", "call"]
 }

package/dist/build.d.ts

@@ -1,56 +1,14 @@
-import { Files } from './files.js';
-import { AbsolutePath } from './paths.js';
-import { Pipe } from './pipe.js';
-import { Run } from './run.js';
-import { Task } from './task.js';
-/**
- * The {@link BuildContext} interface exposes the _internal_ representation of
- * a build file, including all {@link Task | Tasks}.
- */
-export declare type BuildContext = {
-    /** The absolute file name of the build */
-    readonly buildFile: AbsolutePath;
-    /** For convenience, the directory of the build file */
-    readonly buildDir: AbsolutePath;
-    /** A record of all tasks keyed by name */
-    readonly tasks: Readonly<Record<string, Task>>;
-};
-/**
- * A {@link TaskDefinition} is a _function_ defining a {@link Task}.
- */
-export declare type TaskDefinition<B> = (this: ThisBuild<B>, self: ThisBuild<B>, run: Run) => Files | undefined | void | Promise<Files | undefined | void>;
-/**
- * A {@link TaskCall} describes a _function_ calling a {@link Task}, and
- * it is exposed to outside users of the {@link Build}.
- */
-export declare type TaskCall<T extends Files | undefined> = ((run?: Run) => Promise<Run>) & {
-    readonly task: Task<T>;
-};
-/**
- * A {@link Build} is a collection of {@link TaskCall | TaskCalls}, as produced
- * by the {@link build} function from a {@link BuildDefinition}.
- */
-export declare type Build<B> = {
-    [K in keyof B]: B[K] extends TaskCall<infer T> ? TaskCall<T> : B[K] extends () => Files | Promise<Files> ? TaskCall<Files> : B[K] extends () => undefined | void | Promise<undefined | void> ? TaskCall<undefined> : never;
-};
-/**
- * The type supplied as `this` to a {@link TaskDefinition} when invoking it.
- */
-export declare type ThisBuild<B> = {
-    [K in keyof B]: B[K] extends () => Files | Promise<Files> ? () => Pipe & Promise<Files> : B[K] extends () => undefined | void | Promise<undefined | void> ? () => Promise<undefined> : B[K] extends TaskCall<infer T> ? () => T : never;
-};
-/**
- * A {@link BuildDefinition} is a collection of
- * {@link TaskDefinition | TaskDefinitions} that the {@link build} function will
- * use to create a {@link Build}.
- *
- * A {@link BuildDefinition} can also include other {@link TaskCall | TaskCalls},
- * thus giving the ability to extend other {@link Build | Builds}.
- */
-export declare type BuildDefinition<B> = {
-    [K in keyof B]: TaskDefinition<B> | TaskCall<Files | undefined>;
-};
-/** Check if the specified build is actually a {@link Build} */
-export declare function isBuild(build: any): build is Build<any>;
-/** Create a new {@link Build} from its {@link BuildDefinition}. */
-export declare function build<D extends BuildDefinition<D>>(definition: D & ThisType<ThisBuild<D>>): Build<D>;
+import type { Build, BuildDef, Task, ThisBuild } from './types';
+/** Compile a {@link BuildDef | build definition} into a {@link Build} */
+export declare function build<D extends BuildDef, B extends ThisBuild<D>>(def: D & ThisType<B>): Build<D>;
+/** Internal type identifying all _task names_ in a {@link Build} */
+declare type TaskNames<B extends Build> = string & keyof {
+    [k in keyof B as B[k] extends Task ? k : never]?: B[k];
+};
+/** Internal type identifying all _property names_ in a {@link Build} */
+declare type OverrideProps<B extends Build> = {
+    [k in keyof B as B[k] extends string ? k : never]?: string;
+};
+/** Serially invoke tasks in a {@link Build} optionally overriding properties */
+export declare function call<B extends Build>(build: B, ...args: [...taskNames: [TaskNames<B>, ...TaskNames<B>[]]] | [...taskNames: [TaskNames<B>, ...TaskNames<B>[]], options: OverrideProps<B>]): Promise<void>;
+export {};