superlib 1.0.21 → 1.2.0

package/package.json

@@ -1,27 +1,67 @@
 {
   "name": "superlib",
-  "version": "1.0.21",
-  "description": "Awesomest npm/elm dependencies analysis tool",
-  "main": "index.js",
-  "author": "davidhq",
-  "license": "ISC",
+  "version": "1.2.0",
+  "description": "A missing standard library for TypeScript, providing utilities for async orchestration, error handling, filesystem abstraction, and common patterns",
+  "keywords": [
+    "async",
+    "result",
+    "stdlib",
+    "task",
+    "typescript",
+    "utilities"
+  ],
+  "license": "MIT",
+  "author": "Kris Kaczor",
   "repository": {
     "type": "git",
-    "url": "https://github.com/davidhq/superlib"
+    "url": "git+https://github.com/superlibdotdev/superlib.git"
   },
-  "bin": {
-    "lib": "lib.js",
-    "libm": "libm.js"
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./platform/filesystem": {
+      "types": "./dist/platform/filesystem/index.d.ts",
+      "default": "./dist/platform/filesystem/index.js"
+    },
+    "./platform/get-port": {
+      "types": "./dist/platform/get-port/index.d.ts",
+      "default": "./dist/platform/get-port/index.js"
+    },
+    "./platform/JsonHttpClient": {
+      "types": "./dist/platform/JsonHttpClient/index.d.ts",
+      "default": "./dist/platform/JsonHttpClient/index.js"
+    },
+    "./platform/ProcessContext": {
+      "types": "./dist/platform/ProcessContext/index.d.ts",
+      "default": "./dist/platform/ProcessContext/index.js"
+    },
+    "./platform/safeFetch": {
+      "types": "./dist/platform/safeFetch/index.d.ts",
+      "default": "./dist/platform/safeFetch/index.js"
+    }
   },
-  "engines": {
-    "node": ">=5.7.0"
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && bun run scripts/fix-imports.ts",
+    "lint": "oxlint --type-aware --type-check --deny-warnings",
+    "lint:fix": "bun run lint --fix",
+    "test": "bun test",
+    "fix": "cd ../.. && bun run fix"
   },
   "dependencies": {
-    "colors": "^1.1.2",
-    "commander": "^2.9.0",
-    "open": "0.0.5",
-    "superagent": "^1.8.0-beta.1",
-    "tape": "^4.5.1",
-    "x-ray": "^2.0.3"
+    "remeda": "^2.32.0",
+    "temporal-polyfill": "^0.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "zod": "^4.3.5"
   }
 }

package/README.md

@@ -1,46 +0,0 @@
-# Simple dependency analysis tool for Node and Elm
-
-[NpmJs](https://www.npmjs.com/package/superlib)
-
-## Install
-
-    npm install -g superlib
-
-## Requirements
-
-    Node 5.7.0+
-
-## Help
-
-```bash
-lib --help
-libm --help
-```
-
-## Usage
-
-Go to npm/elm project or a folder with many npm project subdirectories and run one of these commands:
-
-    lib
-    lib [dep]
-    libm
-    libm [dep]
-
-or
-
-    lib --path /Path/To/Project
-    libm --path /Path/To/Project
-
-## Tips
-
-If you use `iTerm2 v3.0`, you can click on the links in terminal with `CMD+click`.
-
-## Screenshots
-
-    lib
-
-![](http://cl.ly/3n3Q3W0c2i10/Screen%20Shot%202016-03-31%20at%2023.47.51.png)
-
-    libm
-
-![](http://cl.ly/3k352J3O1m2D/Screen%20Shot%202016-03-31%20at%2023.48.20.png)

package/elm-projects.js

@@ -1,62 +0,0 @@
-var fs = require('fs');
-var pth = require('path');
-var util = require('./utilities');
-var colors = require('colors');
-
-class ElmProjects {
-  // scan(path) {
-  //   return util.scanDirSync(path)
-  //     .filter(dir => this.valid(dir))
-  //     .map(dir => this.info(dir))
-  // }
-
-  valid(path) {
-    return util.fileExists(`${path}/elm-package.json`);
-    //return util.fileExists(`${path}/elm-stuff/exact-dependencies.json`)
-  }
-
-  // returns the info for one project
-  info(path) {
-    if (this.valid(path)) {
-      let pkg = require(`${path}/elm-package.json`);
-      return pkg;
-    }
-  }
-
-  exactDeps(path) {
-    return new Promise((s, r) => {
-      let exactDepsPath = `${path}/elm-stuff/exact-dependencies.json`;
-      if (util.fileExists(exactDepsPath)) {
-        s(require(exactDepsPath));
-      } else {
-        r('Run "elm package install" first');
-      }
-    });
-  }
-
-  exactDepsFullInfo(path) {
-    if (this.valid(path)) {
-      return new Promise((s, r) => {
-        let info = this.info(path);
-        this.exactDeps(path)
-          .then(projectInfo => {
-            s(
-              Object.keys(projectInfo).map(dep => {
-                let depPkg = require(`${path}/elm-stuff/packages/${dep}/${projectInfo[dep]}/elm-package.json`);
-                let original = !!Object.keys(info.dependencies).find(d => d == dep);
-                return {
-                  name: dep,
-                  original: original,
-                  version: projectInfo[dep],
-                  summary: depPkg.summary
-                };
-              })
-            );
-          })
-          .catch(e => r(e));
-      });
-    }
-  }
-}
-
-module.exports = ElmProjects;

package/index.js

@@ -1,3 +0,0 @@
-module.exports = {
-  projects: require('./projects')
-};

package/lib.js

@@ -1,117 +0,0 @@
-#!/usr/bin/env node
-var colors = require('colors');
-var fs = require('fs');
-var util = require('./utilities');
-var path = require('path');
-
-var Projects = require('./projects');
-var projects = new Projects();
-
-var ElmProjects = require('./elm-projects');
-var elmProjects = new ElmProjects();
-
-// Parse command line options
-var program = require('commander');
-
-var pkg = require(path.join(__dirname, 'package.json'));
-
-program
-  .version(pkg.version)
-  .description('Awesomest npm dependencies analysis tool')
-  .option('-p, --path <path>', 'Project(s) on which to run the command')
-  .parse(process.argv);
-
-let dep = program.args[0];
-
-function isDepInstalled(projectPath, dep) {
-  return util.isDirectory(path.join(projectPath, dep));
-}
-
-function colorizeDeps(projectPath, deps) {
-  let modulesPath = path.join(projectPath, 'node_modules');
-  return deps.map(d => {
-    let str = isDepInstalled(modulesPath, d) ? colors.yellow(d) : colors.red(d);
-    return dep && d.toLowerCase().indexOf(dep.toLowerCase()) > -1 ? colors.bold(str) : str;
-  });
-}
-
-function showProject(project, dep) {
-  if ((dep && projects.hasDep(project, dep)) || !dep) {
-    let dir = '';
-    if (project.name != project.folder) {
-      dir = ` (directory: ${project.folder})`;
-    }
-
-    console.log(colors.cyan(`[ ${project.name} ]`) + dir);
-
-    if (project.dependencies) {
-      let deps = projects.depList(project);
-      console.log(`Deps (${deps.length}): ${colorizeDeps(project.path, deps).join(', ')}`);
-
-      if (dep) {
-        for (let match of projects.findDeps(project, dep)) {
-          console.log(colors.yellow.bold(match) + ': ' + colors.green(`https://www.npmjs.com/package/${match}`));
-        }
-      }
-    }
-
-    // check for linked npm projects
-    let modulesPath = path.join(project.path, 'node_modules');
-    if (util.isDirectory(modulesPath)) {
-      fs.readdir(modulesPath, function(err, dirs) {
-        for (let dir of dirs) {
-          fs.lstat(`${modulesPath}/${dir}`, function(err, stats) {
-            //fs.statSync can't read isSymbolicLink()
-            if (err) throw err;
-            if (stats.isSymbolicLink()) {
-              console.log(colors.red(`<${project.name}> linked package: ${dir}`));
-            }
-          });
-        }
-      });
-    }
-
-    if (project.bin) {
-      console.log();
-      let bin = project.bin;
-      for (let key in bin) {
-        if (bin.hasOwnProperty(key)) {
-          console.log('%s -> %s', colors.green(`bin/${key}`), bin[key]);
-        }
-      }
-    }
-
-    console.log();
-  }
-}
-
-let cwd = process.cwd();
-let projecPath = program.path || cwd;
-
-// ELM
-if (elmProjects.valid(projecPath)) {
-  let info = elmProjects.info(projecPath);
-  elmProjects
-    .exactDepsFullInfo(projecPath)
-    .then(deps => {
-      deps.forEach(dep => {
-        let depName = dep.original ? colors.yellow(dep.name) : dep.name;
-        console.log(`${depName}: ${colors.green(dep.version)}`);
-        console.log(colors.green(dep.summary));
-        console.log();
-      });
-    })
-    .catch(e => console.log(colors.red(e)));
-} else {
-  // NPM
-  let project = projects.info(projecPath);
-
-  if (project) {
-    showProject(project, dep);
-    projects.showDep(projects.projectDepInfoFormat(project.path));
-  } else {
-    for (let project of projects.scan(projecPath)) {
-      showProject(project, dep);
-    }
-  }
-}

package/libm.js

@@ -1,52 +0,0 @@
-#!/usr/bin/env node
-var colors = require('colors');
-var fs = require('fs');
-var util = require('./utilities');
-var path = require('path');
-
-var npmjs = require('./providers/npmjs');
-
-var Projects = require('./projects');
-var projects = new Projects();
-
-// Parse command line options
-var program = require('commander');
-
-var pkg = require(path.join(__dirname, 'package.json'));
-
-program
-  .version(pkg.version)
-  .description('Awesomest npm dependencies analysis tool')
-  .option('-p, --path <path>', 'Project(s) on which to run the command')
-  .parse(process.argv);
-
-function nameEmail(name, email) {
-  return email ? `${name} <${email}>` : name;
-}
-
-let filter = program.args[0];
-
-let projecPath = program.path || process.cwd();
-let project = projects.info(projecPath);
-
-let deps = project ? projects.depsWithInfo(project) : projects.depsWithInfoPath(projecPath);
-deps = util.arraySortByKey(deps, 'name');
-
-util
-  .asyncMap(deps, function(dep, callback) {
-    if (dep.missing) {
-      npmjs.info(dep.name, info => callback(Object.assign(info, { projects: dep.projects })));
-    } else {
-      callback(dep);
-    }
-  })
-  .then(deps => {
-    for (let dep of deps) {
-      if (!filter || (filter && util.cointainsStringInsensitive(dep.name, filter))) {
-        projects.showDep(dep);
-      }
-    }
-  })
-  .catch(error => {
-    console.log(error);
-  });

package/projects.js

@@ -1,145 +0,0 @@
-var fs = require('fs');
-var pth = require('path');
-var colors = require('colors');
-
-var util = require('./utilities');
-
-var GitHub = require('./providers/github');
-let github = new GitHub();
-
-class Projects {
-  scan(path) {
-    return util
-      .scanDirSync(path)
-      .filter(dir => this.valid(dir))
-      .map(dir => this.info(dir));
-  }
-
-  valid(path) {
-    return util.fileExists(`${path}/package.json`);
-  }
-
-  // returns the info for one project
-  info(path) {
-    if (this.valid(path)) {
-      let pkg = JSON.parse(fs.readFileSync(`${path}/package.json`));
-
-      return {
-        name: pkg.name,
-        folder: pth.basename(path),
-        version: pkg.version,
-        path: path,
-        dependencies: pkg.dependencies,
-        bin: pkg.bin
-      };
-    }
-  }
-
-  depList(project) {
-    return project.dependencies ? Object.keys(project.dependencies) : [];
-  }
-
-  hasDep(project, term) {
-    return project.dependencies && this.findDeps(project, term).length > 0;
-  }
-
-  findDeps(project, term) {
-    return util.listSearch(this.depList(project), term);
-  }
-
-  projectDepInfoFormat(projectPath, dep) {
-    let pkgFile = `${projectPath}/package.json`;
-    if (util.fileExists(pkgFile)) {
-      let pkg = JSON.parse(fs.readFileSync(pkgFile));
-
-      let obj = {
-        name: pkg.name,
-        version: pkg.version,
-        description: pkg.description,
-        homepage: pkg.homepage,
-        author: pkg.author, // email, name, url
-        npmuser: pkg._npmUser // email, name, url
-      };
-
-      if (pkg['repository']) {
-        if (pkg['repository']['url']) {
-          let repo = github.repoName(pkg['repository']['url']);
-          obj.github = `https://github.com/${repo}`;
-        } else {
-          // "repository": "expressjs/express"
-          obj.github = `https://github.com/${pkg['repository']}`;
-        }
-      } else {
-        obj.github = '<missing>';
-      }
-
-      return obj;
-    } else {
-      return {
-        missing: true,
-        name: dep,
-        description: '<missing>',
-        github: '<missing>',
-        homepage: '<missing>'
-      };
-    }
-  }
-
-  depInfo(projectPath, dep) {
-    return this.projectDepInfoFormat(`${projectPath}/node_modules/${dep}`, dep);
-  }
-
-  // scans all the dependencies for the project and reads the package.json of each one
-  depsWithInfo(project) {
-    return this.depList(project).map(function(dep) {
-      return Object.assign(this.depInfo(project.path, dep), {
-        project: project.name
-      });
-    }, this);
-  }
-
-  // get all unique dependencies across all projects
-  // if some project doesn't have node_modules currently but another one has, then dependency info is still gathered from where it can be
-  // each dependency has to be present only once across all scanned projects
-  depsWithInfoPath(path) {
-    let depProjects = {};
-
-    let list = this.scan(path).reduce(
-      (deps, project) =>
-        deps.concat(
-          this.depsWithInfo(project).filter(dep => {
-            if (!depProjects[dep.name]) {
-              depProjects[dep.name] = [];
-            }
-            depProjects[dep.name] = depProjects[dep.name].concat(dep.project);
-            let match = deps.find(d => d.name == dep.name);
-            return !match || match.missing;
-          })
-        ),
-      []
-    );
-
-    // remove missing but only if they are not the only occurence
-    let condition = dep => dep.missing && list.filter(d => d.name == dep.name && !d.missing).length > 0;
-    return list.filter(dep => !condition(dep)).map(dep => Object.assign(dep, { projects: depProjects[dep.name].sort() }));
-  }
-
-  showDep(dep) {
-    console.log(colors.yellow(`${dep.name} >>> `) + colors.green(dep.description));
-    if (dep.github) {
-      console.log('GitHub: ' + colors.cyan(dep.github));
-    }
-    if (dep.homepage) {
-      console.log('Homepage: ' + colors.cyan(dep.homepage));
-    }
-    console.log('Version: ' + colors.green(dep.version));
-    if (dep.projects) {
-      console.log('Projects: ' + colors.yellow(dep.projects.join(', ')));
-    }
-    //if(dep.author) console.log('Author: ' + nameEmail(dep.author.name, dep.author.email))
-    //console.log('Npm User: ' + nameEmail(dep.npmuser.name, dep.npmuser.email))
-    console.log();
-  }
-}
-
-module.exports = Projects;

package/providers/github.js

@@ -1,22 +0,0 @@
-let Connection = require('./lib/connection');
-
-class GitHub {
-  constructor() {
-    this.conn = new Connection('https://api.github.com');
-  }
-
-  repoInfo(repo, callback) {
-    this.conn.get(`repos/${repo}`, {}, callback);
-  }
-
-  repoName(url) {
-    url = url.trim();
-    if (url.endsWith('.git')) url = url.slice(0, url.length - 4);
-    // git@github.com:documentationjs/documentation.git
-    // https://github.com/davidhq/superlib
-    let matches = /github.com[\/\:]([\w\.\-_]+)\/([\w\.\-_]+)/i.exec(url);
-    if (matches) return `${matches[1]}/${matches[2]}`;
-  }
-}
-
-module.exports = GitHub;

package/providers/lib/connection.js

@@ -1,19 +0,0 @@
-var request = require('superagent');
-
-class Connection {
-  constructor(api_base) {
-    this.api_base = api_base;
-  }
-
-  get(path, options, callback) {
-    request.get(`${this.api_base}/${path}`).send(options).set('Content-Type', 'application/json').set('Accept', 'application/json').end(function(err, res) {
-      if (res.ok) {
-        callback(res.body);
-      } else {
-        console.log('Oh no! error ' + res.text);
-      }
-    });
-  }
-}
-
-module.exports = Connection;

package/providers/npmjs.js

@@ -1,22 +0,0 @@
-// --
-var util = require('../utilities');
-var Xray = require('x-ray');
-var x = Xray();
-
-module.exports = {
-  info: (pkg, callback) => {
-    let url = `https://www.npmjs.com/package/${pkg}`;
-    x(url, {
-      description: '.package-description',
-      links: x('.sidebar .box', ['a@href'])
-    })((err, obj) => {
-      let github_url = obj.links.filter(link => link.startsWith('https://github.com') && util.countOccurences(link, '/') == 4)[0];
-      callback({
-        name: pkg,
-        description: obj.description,
-        github: github_url,
-        github_repo: github_url && github_url.replace('https://github.com/', '')
-      });
-    });
-  }
-};

package/tests/providers.js

@@ -1,13 +0,0 @@
-var test = require('tape');
-
-test('github parsing repo from url', function(t) {
-  t.plan(4);
-
-  var GitHub = require('../providers/github');
-  let github = new GitHub();
-
-  t.equal(github.repoName('https://github.com/davidhq/cryptonite'), 'davidhq/cryptonite');
-  t.equal(github.repoName('https://GitHub.com/davidhq/cryptonite'), 'davidhq/cryptonite');
-  t.equal(github.repoName('https://github.com/visionmedia/superagent#readme'), 'visionmedia/superagent');
-  t.equal(github.repoName('git+ssh://git@github.com/Marak/colors.js.git'), 'Marak/colors.js');
-});

package/tests/utilities.js

@@ -1,13 +0,0 @@
-var test = require('tape');
-var util = require('../utilities');
-
-test('utilities', function (t) {
-  t.plan(5)
-
-  t.true(util.listSearch(['aaa', 'bbb', 'ccc'], 'BB').length == 1)
-
-  t.deepEqual(util.arraySortByKey([ { name: 'b' }, { name: 'z' }, { name: 'a' } ], 'name'), [ { name: 'a' }, { name: 'b' }, { name: 'z' } ])
-  t.deepEqual(util.arraySortByKey([ { name: 'b' }, { }, { name: 'a' } ], 'name'), [ { name: 'a' }, { name: 'b' }, { } ])
-  t.deepEqual(util.arraySortByKey([ { name: 2 }, { name: 1000 }, { name: 1 } ], 'name', true), [ { name: 1 }, { name: 2 }, { name: 1000 } ])
-  t.deepEqual(util.arraySortByKey([ { name: 2 }, { }, { name: 1 } ], 'name', true), [ { name: 1 }, { name: 2 }, { } ])
-})