chore: remove lodash.uniq, add dist/clean scripts, verify-publish, update repository format

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: stringparser

.github/workflows/ci.yml

@@ -30,7 +30,7 @@ jobs:
         run: npm run lint
 
       - name: Build
-        run: npm run build
+        run: npm run dist
 
       - name: Test
         run: npm test

.gitignore

@@ -1,3 +1,6 @@
 node_modules
 dist
 coverage
+*.tgz
+test/verify-publish/node_modules
+test/verify-publish/package-lock.json

README.md

@@ -2,39 +2,42 @@
 
 [![CI][b-build]][x-actions]
 
-Simple REPL for gulp compatible with gulp 3.x and gulp 4.x.
+Simple REPL for gulp.
 
 ### usage
 
-```js
-// gulpfile example
-var gulp = require('gulp');
-var repl = require('gulp-repl');
+```ts
+// gulpfile.ts
+import gulp from 'gulp';
+import repl from 'gulp-repl';
 
-gulp.task('repl-start', function (cb) {
+gulp.task('repl-start', (cb) => {
   gulp.repl = repl.start(gulp);
+  cb();
 });
 
-gulp.task('repl-stop', function (cb) {
+gulp.task('repl-stop', (cb) => {
   if (gulp.repl) {
     gulp.repl.close(); // same as nodejs.org/api/readline.html#readline_rl_close
   }
   cb();
 });
 
-gulp.task('foo', function (cb) {
+gulp.task('foo', (cb) => {
   // do foo stuff
   cb();
 });
 
-gulp.task('bar', function (cb) {
+gulp.task('bar', (cb) => {
   // do bar stuff
   cb();
 });
 
-gulp.task('default');
+gulp.task('default', gulp.series('foo', 'bar'));
 ```
 
+> **Note:** For `gulpfile.ts`, ensure `ts-node` or `tsx` is available. Use `gulpfile.js` with `require()` if you prefer plain JavaScript.
+
 Then, on your terminal write:
 
 ```
@@ -64,38 +67,38 @@ foo      bar      default
 
 The module exports an object with the following methods:
 
-```js
-var repl = require('gulp-repl');
+```ts
+import repl from 'gulp-repl';
 ```
 
 #### repl.add
 
-```js
-function add(Gulp gulp)
+```ts
+add(gulp: Gulp): typeof repl
 ```
 
 Adds the `gulp` instance tasks for the REPL and _returns_ the module again.
 
 #### repl.remove
 
-```js
-function remove(Gulp gulp)
+```ts
+remove(gulp: Gulp): typeof repl
 ```
 
 Removes the `gulp` instance tasks from the REPL and _returns_ the module again.
 
 #### repl.reset
 
-```js
-function reset()
+```ts
+reset(): typeof repl
 ```
 
 Removes all of the previously added instances and _returns_ the module again.
 
 #### repl.get
 
-```js
-function get(Gulp gulp)
+```ts
+get(gulp?: Gulp): ReplInstance[] | ReplInstance | null
 ```
 
 Takes a `gulp` instance as argument.
@@ -107,8 +110,8 @@ _returns_
 
 #### repl.start
 
-```js
-function start(Gulp gulp)
+```ts
+start(gulp?: Gulp): readline.Interface
 ```
 
 Takes a `gulp` instance as argument.

license

@@ -1,10 +1,13 @@
 {
   "name": "gulp-repl",
   "version": "3.0.0",
-  "description": "a simple repl for gulp",
+  "description": "A simple repl for gulp",
   "author": "Javier Carrillo <stringparser@gmail.com>",
   "license": "MIT",
-  "repository": "https://github.com/stringparser/gulp-repl",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stringparser/gulp-repl.git"
+  },
   "keywords": [
     "gulp",
     "repl",
@@ -18,27 +21,30 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "dist": "tsc -p tsconfig.build.json",
     "lint": "eslint src test",
     "test": "jest",
-    "prepare": "npm run build"
-  },
-  "dependencies": {
-    "lodash.uniq": "4.5.0"
+    "posttest": "npm run verify:publish",
+    "verify:publish": "bash test/verify-publish/test.sh",
+    "prepublishOnly": "npm run dist",
+    "clean": "rm -rf test/verify-publish/node_modules test/verify-publish/package-lock.json && rm -f *.tgz"
   },
   "devDependencies": {
     "@eslint/js": "9.16.0",
     "@types/jest": "^29.5.14",
-    "@types/lodash.uniq": "4.5.9",
     "@types/node": "22.10.1",
     "eslint": "9.16.0",
-    "gulp": "^4.0.2",
+    "gulp": "5.0.1",
     "jest": "29.7.0",
     "ts-jest": "29.2.5",
     "typescript": "5.7.2",
     "typescript-eslint": "8.16.0"
   },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=20.0.0"
+  },
+  "homepage": "https://github.com/stringparser/gulp-repl",
+  "bugs": {
+    "url": "https://github.com/stringparser/gulp-repl/issues"
   }
-}
+}

package.json

@@ -1,5 +1,3 @@
-import uniq from 'lodash.uniq';
-
 export interface GulpLike {
   task?: (name: string, fn?: (cb?: () => void) => void) => void;
   start?: (...tasks: string[]) => (() => void) | void;
@@ -116,7 +114,7 @@ export function completer(
     completion.push(...matches.found);
   });
 
-  const hits = uniq(completion).filter((elem) => !elem.indexOf(line));
+  const hits = Array.from(new Set(completion)).filter((elem) => !elem.indexOf(line));
 
   return [hits.length ? hits : completion, line];
 }

src/lib.ts

@@ -0,0 +1,9 @@
+{
+  "name": "gulp-repl-verify",
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "gulp": "5.0.1",
+    "gulp-repl": "file:../../gulp-repl-3.0.0.tgz"
+  }
+}

test/verify-publish/package.json

@@ -0,0 +1,28 @@
+import replPkg from 'gulp-repl';
+import gulp from 'gulp';
+
+const repl = replPkg.default ?? replPkg;
+
+// Create gulp instance and register a task
+const gulpInst = gulp;
+gulpInst.task('smoke-task', (cb) => {
+  cb();
+});
+
+// Add gulp to repl
+repl.add(gulpInst);
+
+// Verify get returns the instance
+const instance = repl.get(gulpInst);
+if (!instance) throw new Error('Expected instance from get(gulp)');
+if (instance.gulp !== gulpInst) throw new Error('Expected instance.gulp to match');
+
+// Verify start returns readline interface
+const rl = repl.start(gulpInst);
+if (typeof rl.prompt !== 'function') throw new Error('Expected readline Interface with prompt');
+
+// Verify reset
+repl.reset();
+if (repl.get().length !== 0) throw new Error('Expected empty instances after reset');
+
+console.log('Smoke test passed');

test/verify-publish/smoke-test.mjs

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+set -e
+cd "$(dirname "$0")/../.."
+
+echo "Building..."
+npm run dist
+
+echo "Packing..."
+npm pack
+TARBALL="gulp-repl-$(node -p "require('./package.json').version").tgz"
+
+echo "Installing in test/verify-publish..."
+cd test/verify-publish
+npm install "../../${TARBALL}"
+cd ../..
+
+echo "Running smoke test..."
+node test/verify-publish/smoke-test.mjs
+
+echo "Cleaning up..."
+rm -f "${TARBALL}"
+rm -rf test/verify-publish/node_modules test/verify-publish/package-lock.json
+
+echo "verify:publish passed"