@getkist/action-terser 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 kist
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,110 @@
+# @getkist/action-terser
+
+JavaScript minification actions for kist using Terser.
+
+## Installation
+
+```bash
+npm install @getkist/action-terser
+```
+
+## Usage
+
+### As a kist plugin
+
+```yaml
+# kist.yml
+plugins:
+  - "@getkist/action-terser"
+
+pipeline:
+  - action: JavaScriptMinifyAction
+    options:
+      inputPath: "src/app.js"
+      outputPath: "dist/app.min.js"
+```
+
+### Standalone usage
+
+```typescript
+import { JavaScriptMinifyAction } from "@getkist/action-terser";
+
+const action = new JavaScriptMinifyAction();
+await action.execute({
+  inputPath: "src/app.js",
+  outputPath: "dist/app.min.js",
+  customConfig: {
+    compress: {
+      drop_console: false
+    }
+  }
+});
+```
+
+## Actions
+
+### JavaScriptMinifyAction
+
+Minifies JavaScript files using Terser to reduce file size and optimize performance.
+
+#### Options
+
+| Option | Type | Required | Description |
+|--------|------|----------|-------------|
+| `inputPath` | `string` | Yes | Path to the input JavaScript file |
+| `outputPath` | `string` | Yes | Path where the minified file will be saved |
+| `customConfig` | `object` | No | Custom Terser configuration to merge with defaults |
+
+#### Default Terser Configuration
+
+The action uses sensible defaults optimized for production:
+
+- **Compression**: Drops console statements, removes debugger, dead code elimination
+- **Mangling**: Minifies variable and function names
+- **Output**: Removes comments, no beautification
+- **ECMAScript**: Targets ES5 for broad compatibility
+
+You can override any Terser option via `customConfig`.
+
+## Configuration Examples
+
+### Preserve console.log statements
+
+```yaml
+- action: JavaScriptMinifyAction
+  options:
+    inputPath: "src/app.js"
+    outputPath: "dist/app.min.js"
+    customConfig:
+      compress:
+        drop_console: false
+```
+
+### Generate source maps
+
+```yaml
+- action: JavaScriptMinifyAction
+  options:
+    inputPath: "src/app.js"
+    outputPath: "dist/app.min.js"
+    customConfig:
+      sourceMap:
+        filename: "app.min.js.map"
+        url: "app.min.js.map"
+```
+
+### Target modern browsers (ES2020)
+
+```yaml
+- action: JavaScriptMinifyAction
+  options:
+    inputPath: "src/app.js"
+    outputPath: "dist/app.min.js"
+    customConfig:
+      ecma: 2020
+      module: true
+```
+
+## License
+
+MIT

package/dist/actions/JavaScriptMinifyAction/JavaScriptMinifyAction.d.ts

@@ -0,0 +1,49 @@
+import { Action, ActionOptionsType } from "../../types/Action.js";
+/**
+ * Options for the JavaScriptMinifyAction
+ */
+export interface JavaScriptMinifyActionOptions extends ActionOptionsType {
+    /** Path to the input JavaScript file */
+    inputPath: string;
+    /** Path where the minified file will be saved */
+    outputPath: string;
+    /** Custom Terser configuration to merge with defaults */
+    customConfig?: Record<string, unknown>;
+}
+/**
+ * JavaScriptMinifyAction handles the minification of JavaScript files.
+ * Uses Terser to reduce file size and optimize performance.
+ */
+export declare class JavaScriptMinifyAction extends Action<JavaScriptMinifyActionOptions> {
+    /**
+     * Validates the action options.
+     *
+     * @param options - The options to validate.
+     * @returns True if options are valid.
+     */
+    validateOptions(options: JavaScriptMinifyActionOptions): boolean;
+    /**
+     * Executes the JavaScript minification action.
+     *
+     * @param options - The options containing input and output file paths.
+     * @returns A Promise that resolves when the minification process completes.
+     * @throws {Error} If input file is missing, minification fails, or output cannot be written.
+     */
+    execute(options: JavaScriptMinifyActionOptions): Promise<void>;
+    /**
+     * Minifies a JavaScript file using Terser.
+     *
+     * @param inputPath - Path to the input JavaScript file.
+     * @param outputPath - Path where the minified file will be saved.
+     * @param customConfig - Custom Terser configuration.
+     * @returns A Promise that resolves when the minification is complete.
+     */
+    private minifyFile;
+    /**
+     * Provides a description of the action.
+     *
+     * @returns A string description of the action.
+     */
+    describe(): string;
+}
+//# sourceMappingURL=JavaScriptMinifyAction.d.ts.map

package/dist/actions/JavaScriptMinifyAction/JavaScriptMinifyAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JavaScriptMinifyAction.d.ts","sourceRoot":"","sources":["../../../src/actions/JavaScriptMinifyAction/JavaScriptMinifyAction.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAOlE;;GAEG;AACH,MAAM,WAAW,6BAA8B,SAAQ,iBAAiB;IACpE,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAMD;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,MAAM,CAAC,6BAA6B,CAAC;IAC7E;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO;IAYhE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBpE;;;;;;;OAOG;YACW,UAAU;IAyCxB;;;;OAIG;IACH,QAAQ,IAAI,MAAM;CAGrB"}

package/dist/actions/JavaScriptMinifyAction/JavaScriptMinifyAction.js

@@ -0,0 +1,103 @@
+// ============================================================================
+// Import
+// ============================================================================
+import { promises as fs } from "fs";
+import path from "path";
+import { minify } from "terser";
+import { Action } from "../../types/Action.js";
+import terserConfig from "./terser.config.js";
+// ============================================================================
+// Classes
+// ============================================================================
+/**
+ * JavaScriptMinifyAction handles the minification of JavaScript files.
+ * Uses Terser to reduce file size and optimize performance.
+ */
+export class JavaScriptMinifyAction extends Action {
+    /**
+     * Validates the action options.
+     *
+     * @param options - The options to validate.
+     * @returns True if options are valid.
+     */
+    validateOptions(options) {
+        if (!options.inputPath || typeof options.inputPath !== "string") {
+            this.logError("Invalid options: 'inputPath' is required and must be a string.");
+            return false;
+        }
+        if (!options.outputPath || typeof options.outputPath !== "string") {
+            this.logError("Invalid options: 'outputPath' is required and must be a string.");
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Executes the JavaScript minification action.
+     *
+     * @param options - The options containing input and output file paths.
+     * @returns A Promise that resolves when the minification process completes.
+     * @throws {Error} If input file is missing, minification fails, or output cannot be written.
+     */
+    async execute(options) {
+        if (!this.validateOptions(options)) {
+            throw new Error("Invalid options: 'inputPath' and 'outputPath' are required.");
+        }
+        const { inputPath, outputPath, customConfig = {} } = options;
+        this.logInfo(`Minifying JavaScript file: ${inputPath} → ${outputPath}`);
+        try {
+            await this.minifyFile(inputPath, outputPath, customConfig);
+            this.logInfo(`JavaScript minification completed: ${outputPath}`);
+        }
+        catch (error) {
+            this.logError("JavaScript minification failed.", error);
+            throw error;
+        }
+    }
+    /**
+     * Minifies a JavaScript file using Terser.
+     *
+     * @param inputPath - Path to the input JavaScript file.
+     * @param outputPath - Path where the minified file will be saved.
+     * @param customConfig - Custom Terser configuration.
+     * @returns A Promise that resolves when the minification is complete.
+     */
+    async minifyFile(inputPath, outputPath, customConfig) {
+        try {
+            const resolvedInputPath = path.resolve(inputPath);
+            const resolvedOutputPath = path.resolve(outputPath);
+            // Read JavaScript file
+            const inputCode = await fs.readFile(resolvedInputPath, "utf8");
+            // Merge Terser configuration with explicit type casting
+            const terserOptions = {
+                ...terserConfig,
+                ...customConfig,
+                ecma: terserConfig.ecma,
+                nameCache: terserConfig.nameCache ?? undefined,
+            };
+            // Minify using Terser
+            const result = await minify(inputCode, terserOptions);
+            if (!result.code) {
+                throw new Error("Minification resulted in empty output.");
+            }
+            // Ensure output directory exists
+            const outputDir = path.dirname(resolvedOutputPath);
+            await fs.mkdir(outputDir, { recursive: true });
+            // Write minified file
+            await fs.writeFile(resolvedOutputPath, result.code, "utf8");
+            this.logDebug(`Minified JavaScript file saved to ${resolvedOutputPath}`);
+        }
+        catch (error) {
+            this.logError(`Error minifying JavaScript file: ${inputPath}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Provides a description of the action.
+     *
+     * @returns A string description of the action.
+     */
+    describe() {
+        return "Minifies JavaScript files using Terser to reduce size and optimize performance.";
+    }
+}
+//# sourceMappingURL=JavaScriptMinifyAction.js.map

package/dist/actions/JavaScriptMinifyAction/JavaScriptMinifyAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JavaScriptMinifyAction.js","sourceRoot":"","sources":["../../../src/actions/JavaScriptMinifyAction/JavaScriptMinifyAction.ts"],"names":[],"mappings":"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"}

package/dist/actions/JavaScriptMinifyAction/index.d.ts

@@ -0,0 +1,3 @@
+import { JavaScriptMinifyAction, JavaScriptMinifyActionOptions } from "./JavaScriptMinifyAction.js";
+export { JavaScriptMinifyAction, JavaScriptMinifyActionOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/JavaScriptMinifyAction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/actions/JavaScriptMinifyAction/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAMpG,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,CAAC"}

package/dist/actions/JavaScriptMinifyAction/index.js

@@ -0,0 +1,9 @@
+// ============================================================================
+// Import
+// ============================================================================
+import { JavaScriptMinifyAction } from "./JavaScriptMinifyAction.js";
+// ============================================================================
+// Export
+// ============================================================================
+export { JavaScriptMinifyAction };
+//# sourceMappingURL=index.js.map

package/dist/actions/JavaScriptMinifyAction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/JavaScriptMinifyAction/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EAAE,sBAAsB,EAAiC,MAAM,6BAA6B,CAAC;AAEpG,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EAAE,sBAAsB,EAAiC,CAAC"}

package/dist/actions/JavaScriptMinifyAction/terser.config.d.ts

@@ -0,0 +1,28 @@
+declare const terserConfig: {
+    parse: {};
+    compress: {
+        drop_console: boolean;
+        drop_debugger: boolean;
+        pure_funcs: string[];
+        arrows: boolean;
+    };
+    mangle: {
+        properties: boolean;
+    };
+    format: {
+        comments: boolean;
+        beautify: boolean;
+    };
+    sourceMap: {};
+    ecma: number;
+    enclose: boolean;
+    keep_classnames: boolean;
+    keep_fnames: boolean;
+    ie8: boolean;
+    module: boolean;
+    nameCache: null;
+    safari10: boolean;
+    toplevel: boolean;
+};
+export default terserConfig;
+//# sourceMappingURL=terser.config.d.ts.map

package/dist/actions/JavaScriptMinifyAction/terser.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terser.config.d.ts","sourceRoot":"","sources":["../../../src/actions/JavaScriptMinifyAction/terser.config.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;CAgGjB,CAAC;AAMF,eAAe,YAAY,CAAC"}

package/dist/actions/JavaScriptMinifyAction/terser.config.js

@@ -0,0 +1,103 @@
+// ============================================================================
+// Terser Configuration
+// ============================================================================
+// https://terser.org/docs/api-reference/
+const terserConfig = {
+    parse: {
+    // parse options
+    },
+    compress: {
+        // compress options
+        drop_console: true, // Remove console.log statements
+        drop_debugger: true, // Remove debugger statements
+        pure_funcs: ["console.info", "console.debug", "console.warn"], // Remove specific console functions
+        // defaults (default: true) -- Pass false to disable most default enabled compress transforms.
+        // Useful when you only want to enable a few compress options while disabling the rest.
+        // Class and object literal methods are converted will also be
+        // converted to arrow expressions if the resultant code is shorter:
+        // m(){return x} becomes m:()=>x. To do this to regular ES5 functions
+        // which don't use this or arguments, see unsafe_arrows.
+        arrows: true, // (default: true)
+        // arguments (default: false) -- replace arguments[index] with function parameter name whenever possible.
+        // booleans (default: true) -- various optimizations for boolean context, for example !!a ? b : c → a ? b : c
+        // booleans_as_integers (default: false) -- Turn booleans into 0 and 1
+        // collapse_vars (default: true) -- Collapse single-use non-constant variables, side effects permitting.
+        // comparisons (default: true) -- apply certain optimizations to binary nodes
+        // computed_props (default: true) -- Transforms constant computed properties into regular ones
+        // conditionals (default: true) -- apply optimizations for if-s and conditional expressions
+        // dead_code (default: true) -- remove unreachable code
+        // directives (default: true) -- remove redundant or non-standard directives
+        // drop_console (default: false) -- Pass true to discard calls to console.* functions
+        // drop_debugger (default: true) -- remove debugger; statements
+        // ecma (default: 5) -- Pass 2015 or greater to enable compress options that will transform ES5 code
+        // evaluate (default: true) -- attempt to evaluate constant expressions
+        // expression (default: false) -- Pass true to preserve completion values from terminal statements
+        // global_defs (default: {}) -- see conditional compilation
+        // hoist_funs (default: false) -- hoist function declarations
+        // hoist_props (default: true) -- hoist properties from constant object and array literals
+        // hoist_vars (default: false) -- hoist var declarations
+        // if_return (default: true) -- optimizations for if/return and if/continue
+        // inline (default: true) -- inline calls to function with simple/return statement
+        // join_vars (default: true) -- join consecutive var, let and const statements
+        // keep_classnames (default: false) -- Pass true to prevent discarding class names
+        // keep_fargs (default: true) -- Prevents discarding unused function arguments
+        // keep_fnames (default: false) -- Pass true to prevent discarding function names
+        // keep_infinity (default: false) -- Pass true to prevent Infinity from being compressed into 1/0
+        // lhs_constants (default: true) -- Moves constant values to the left-hand side of binary nodes
+        // loops (default: true) -- optimizations for do, while and for loops
+        // module (default false) -- Pass true when compressing an ES6 module
+        // negate_iife (default: true) -- negate "Immediately-Called Function Expressions"
+        // passes (default: 1) -- The maximum number of times to run compress
+        // properties (default: true) -- rewrite property access using the dot notation
+        // pure_funcs (default: null) -- array of function names that don't produce side effects
+        // pure_getters (default: "strict") -- assume object property access doesn't have side effects
+        // pure_new (default: false) -- Set to true to assume new X() never has side effects
+        // reduce_vars (default: true) -- Improve optimization on variables assigned as constants
+        // reduce_funcs (default: true) -- Inline single-use functions when possible
+        // sequences (default: true) -- join consecutive simple statements using the comma operator
+        // side_effects (default: true) -- Remove expressions which have no side effects
+        // switches (default: true) -- de-duplicate and remove unreachable switch branches
+        // toplevel (default: false) -- drop unreferenced functions and/or variables in toplevel scope
+        // top_retain (default: null) -- prevent specific toplevel functions and variables from removal
+        // typeofs (default: true) -- Transforms typeof foo == "undefined" into foo === void 0
+        // unsafe (default: false) -- apply "unsafe" transformations
+        // unsafe_arrows (default: false) -- Convert ES5 style anonymous function expressions to arrow functions
+        // unsafe_comps (default: false) -- Reverse < and <= to > and >=
+        // unsafe_Function (default: false) -- compress and mangle Function(args, code)
+        // unsafe_math (default: false) -- optimize numerical expressions
+        // unsafe_symbols (default: false) -- removes keys from native Symbol declarations
+        // unsafe_methods (default: false) -- Converts { m: function(){} } to { m(){} }
+        // unsafe_proto (default: false) -- optimize expressions like Array.prototype.slice.call(a)
+        // unsafe_regexp (default: false) -- enable substitutions of variables with RegExp values
+        // unsafe_undefined (default: false) -- substitute void 0 if there is undefined in scope
+        // unused (default: true) -- drop unreferenced functions and variables
+    },
+    mangle: {
+        // mangle options
+        // Mangle names for obfuscation and size reduction
+        properties: false, // Don't mangle property names (can break code)
+    },
+    format: {
+        // format options (can also use `output` for backwards compatibility)
+        comments: false, // Remove comments to reduce file size
+        beautify: false, // Disable beautification for smaller file size
+    },
+    sourceMap: {
+    // source map options
+    },
+    // Define ECMAScript target version
+    ecma: 5, // specify one of: 5, 2015, 2016, etc.
+    enclose: false, // or specify true, or "args:values"
+    keep_classnames: false, // Remove class names
+    keep_fnames: false, // Remove function names
+    ie8: false,
+    module: false,
+    nameCache: null, // or specify a name cache object
+    safari10: false,
+    toplevel: false, // Don't remove top-level variables by default (can break exports)
+};
+// ============================================================================
+// Export
+// ============================================================================
+export default terserConfig;
+//# sourceMappingURL=terser.config.js.map

package/dist/actions/JavaScriptMinifyAction/terser.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terser.config.js","sourceRoot":"","sources":["../../../src/actions/JavaScriptMinifyAction/terser.config.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,yCAAyC;AAEzC,MAAM,YAAY,GAAG;IACjB,KAAK,EAAE;IACH,gBAAgB;KACnB;IACD,QAAQ,EAAE;QACN,mBAAmB;QACnB,YAAY,EAAE,IAAI,EAAE,gCAAgC;QACpD,aAAa,EAAE,IAAI,EAAE,6BAA6B;QAClD,UAAU,EAAE,CAAC,cAAc,EAAE,eAAe,EAAE,cAAc,CAAC,EAAE,oCAAoC;QAEnG,8FAA8F;QAC9F,uFAAuF;QAEvF,8DAA8D;QAC9D,mEAAmE;QACnE,qEAAqE;QACrE,wDAAwD;QACxD,MAAM,EAAE,IAAI,EAAE,kBAAkB;QAEhC,yGAAyG;QACzG,6GAA6G;QAC7G,sEAAsE;QACtE,wGAAwG;QACxG,6EAA6E;QAC7E,8FAA8F;QAC9F,2FAA2F;QAC3F,uDAAuD;QACvD,4EAA4E;QAC5E,qFAAqF;QACrF,+DAA+D;QAC/D,oGAAoG;QACpG,uEAAuE;QACvE,kGAAkG;QAClG,2DAA2D;QAC3D,6DAA6D;QAC7D,0FAA0F;QAC1F,wDAAwD;QACxD,2EAA2E;QAC3E,kFAAkF;QAClF,8EAA8E;QAC9E,kFAAkF;QAClF,8EAA8E;QAC9E,iFAAiF;QACjF,iGAAiG;QACjG,+FAA+F;QAC/F,qEAAqE;QACrE,qEAAqE;QACrE,kFAAkF;QAClF,qEAAqE;QACrE,+EAA+E;QAC/E,wFAAwF;QACxF,8FAA8F;QAC9F,oFAAoF;QACpF,yFAAyF;QACzF,4EAA4E;QAC5E,2FAA2F;QAC3F,gFAAgF;QAChF,kFAAkF;QAClF,8FAA8F;QAC9F,+FAA+F;QAC/F,sFAAsF;QACtF,4DAA4D;QAC5D,wGAAwG;QACxG,gEAAgE;QAChE,+EAA+E;QAC/E,iEAAiE;QACjE,kFAAkF;QAClF,+EAA+E;QAC/E,2FAA2F;QAC3F,yFAAyF;QACzF,wFAAwF;QACxF,sEAAsE;KACzE;IACD,MAAM,EAAE;QACJ,iBAAiB;QACjB,kDAAkD;QAClD,UAAU,EAAE,KAAK,EAAE,+CAA+C;KACrE;IACD,MAAM,EAAE;QACJ,qEAAqE;QACrE,QAAQ,EAAE,KAAK,EAAE,sCAAsC;QACvD,QAAQ,EAAE,KAAK,EAAE,+CAA+C;KACnE;IACD,SAAS,EAAE;IACP,qBAAqB;KACxB;IACD,mCAAmC;IACnC,IAAI,EAAE,CAAC,EAAE,sCAAsC;IAC/C,OAAO,EAAE,KAAK,EAAE,oCAAoC;IACpD,eAAe,EAAE,KAAK,EAAE,qBAAqB;IAC7C,WAAW,EAAE,KAAK,EAAE,wBAAwB;IAC5C,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,IAAI,EAAE,iCAAiC;IAClD,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,KAAK,EAAE,kEAAkE;CACtF,CAAC;AAEF,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,eAAe,YAAY,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { ActionPlugin } from "./types/Action.js";
+import { JavaScriptMinifyAction } from "./actions/JavaScriptMinifyAction/index.js";
+declare const plugin: ActionPlugin;
+export default plugin;
+export type { JavaScriptMinifyActionOptions } from "./actions/JavaScriptMinifyAction/index.js";
+export { JavaScriptMinifyAction };
+export { Action, ActionPlugin, ActionOptionsType } from "./types/Action.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAEnF,QAAA,MAAM,MAAM,EAAE,YAIb,CAAC;AAEF,eAAe,MAAM,CAAC;AACtB,YAAY,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+import { JavaScriptMinifyAction } from "./actions/JavaScriptMinifyAction/index.js";
+const plugin = {
+    name: "@getkist/action-terser",
+    version: "1.0.0",
+    actions: { JavaScriptMinifyAction },
+};
+export default plugin;
+export { JavaScriptMinifyAction };
+export { Action } from "./types/Action.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAEnF,MAAM,MAAM,GAAiB;IACzB,IAAI,EAAE,wBAAwB;IAC9B,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,EAAE,sBAAsB,EAAE;CACtC,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAClC,OAAO,EAAE,MAAM,EAAmC,MAAM,mBAAmB,CAAC"}

package/dist/types/Action.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Base Action types for kist action plugins
+ * These types match the kist Action interface for compatibility
+ */
+/**
+ * Action options type - a generic record of key-value pairs
+ */
+export type ActionOptionsType = Record<string, unknown>;
+/**
+ * Abstract base class for all kist actions
+ * Provides logging and execution interface
+ */
+export declare abstract class Action<T extends ActionOptionsType = ActionOptionsType> {
+    /**
+     * Gets the unique name of the action.
+     */
+    get name(): string;
+    /**
+     * Validates options before execution
+     * Override in subclasses for specific validation
+     */
+    validateOptions(_options: T): boolean;
+    /**
+     * Execute the action with given options
+     * Must be implemented by subclasses
+     */
+    abstract execute(options: T): Promise<void>;
+    /**
+     * Provides a description of the action
+     */
+    describe(): string;
+    /**
+     * Log an info message
+     */
+    protected logInfo(message: string): void;
+    /**
+     * Log an error message
+     */
+    protected logError(message: string, error?: unknown): void;
+    /**
+     * Log a debug message
+     */
+    protected logDebug(message: string): void;
+    /**
+     * Log a warning message
+     */
+    protected logWarning(message: string): void;
+}
+/**
+ * Plugin interface for kist action packages
+ */
+export interface ActionPlugin {
+    /** Plugin name */
+    name: string;
+    /** Plugin version */
+    version: string;
+    /** Map of action names to action classes */
+    actions: Record<string, new () => Action>;
+}
+//# sourceMappingURL=Action.d.ts.map

package/dist/types/Action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Action.d.ts","sourceRoot":"","sources":["../../src/types/Action.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD;;;GAGG;AACH,8BAAsB,MAAM,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IACxE;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,CAAC,GAAG,OAAO;IAIrC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3C;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIxC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAI1D;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMzC;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG9C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,MAAM,CAAC,CAAC;CAC7C"}

package/dist/types/Action.js

@@ -0,0 +1,56 @@
+/**
+ * Base Action types for kist action plugins
+ * These types match the kist Action interface for compatibility
+ */
+/**
+ * Abstract base class for all kist actions
+ * Provides logging and execution interface
+ */
+export class Action {
+    /**
+     * Gets the unique name of the action.
+     */
+    get name() {
+        return this.constructor.name;
+    }
+    /**
+     * Validates options before execution
+     * Override in subclasses for specific validation
+     */
+    validateOptions(_options) {
+        return true;
+    }
+    /**
+     * Provides a description of the action
+     */
+    describe() {
+        return `${this.name} action`;
+    }
+    /**
+     * Log an info message
+     */
+    logInfo(message) {
+        console.log(`[${this.name}] ${message}`);
+    }
+    /**
+     * Log an error message
+     */
+    logError(message, error) {
+        console.error(`[${this.name}] ERROR: ${message}`, error || "");
+    }
+    /**
+     * Log a debug message
+     */
+    logDebug(message) {
+        if (process.env.DEBUG) {
+            console.debug(`[${this.name}] DEBUG: ${message}`);
+        }
+    }
+    /**
+     * Log a warning message
+     */
+    logWarning(message) {
+        console.warn(`[${this.name}] WARNING: ${message}`);
+    }
+}
+//# sourceMappingURL=Action.js.map

package/dist/types/Action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Action.js","sourceRoot":"","sources":["../../src/types/Action.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;;GAGG;AACH,MAAM,OAAgB,MAAM;IACxB;;OAEG;IACH,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,QAAW;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAQD;;OAEG;IACH,QAAQ;QACJ,OAAO,GAAG,IAAI,CAAC,IAAI,SAAS,CAAC;IACjC,CAAC;IAED;;OAEG;IACO,OAAO,CAAC,OAAe;QAC7B,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACO,QAAQ,CAAC,OAAe,EAAE,KAAe;QAC/C,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,YAAY,OAAO,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACO,QAAQ,CAAC,OAAe;QAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,YAAY,OAAO,EAAE,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;IAED;;OAEG;IACO,UAAU,CAAC,OAAe;QAChC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,cAAc,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;CACJ"}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@getkist/action-terser",
+  "version": "1.0.1",
+  "description": "JavaScript minification actions for kist using Terser",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "keywords": [
+    "kist",
+    "kist-action",
+    "terser",
+    "minify",
+    "javascript",
+    "minification",
+    "compression"
+  ],
+  "author": "kist",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/getkist/kist-action-terser.git"
+  },
+  "bugs": {
+    "url": "https://github.com/getkist/kist-action-terser/issues"
+  },
+  "homepage": "https://github.com/getkist/kist-action-terser#readme",
+  "engines": {
+    "node": ">=20.0.0",
+    "npm": ">=10.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "test": "NODE_OPTIONS='--experimental-vm-modules' jest",
+    "test:watch": "NODE_OPTIONS='--experimental-vm-modules' jest --watch",
+    "test:coverage": "NODE_OPTIONS='--experimental-vm-modules' jest --coverage",
+    "test:unit": "NODE_OPTIONS='--experimental-vm-modules' jest --testPathPatterns=\\.test\\.ts$",
+    "test:integration": "NODE_OPTIONS='--experimental-vm-modules' jest --testPathPatterns=\\.integration\\.test\\.ts$",
+    "lint": "eslint 'src/**/*.ts'",
+    "lint:fix": "eslint 'src/**/*.ts' --fix",
+    "format": "prettier --write 'src/**/*.ts'",
+    "docs": "typedoc",
+    "docs:watch": "typedoc --watch",
+    "clean": "rm -rf dist docs/api coverage",
+    "prepublishOnly": "npm run clean && npm run build && npm test"
+  },
+  "peerDependencies": {
+    "kist": ">=0.1.58"
+  },
+  "dependencies": {
+    "terser": "^5.37.0"
+  },
+  "devDependencies": {
+    "@types/jest": "30.0.0",
+    "@types/node": "25.2.2",
+    "@typescript-eslint/eslint-plugin": "8.54.0",
+    "@typescript-eslint/parser": "8.54.0",
+    "eslint": "10.0.0",
+    "jest": "30.2.0",
+    "ts-jest": "^29.4.6",
+    "typedoc": "^0.28.0",
+    "typedoc-plugin-markdown": "^4.10.0",
+    "typescript": "^5.9.3"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false
+}