blockmine 1.0.0 → 1.0.1

package/backend/node_modules/touch/README.md

@@ -0,0 +1,52 @@
+# node-touch
+
+For all your node touching needs.
+
+## Installing
+
+```bash
+npm install touch
+```
+
+## CLI Usage:
+
+See `man touch`
+
+This package exports a binary called `nodetouch` that works mostly
+like the unix builtin `touch(1)`.
+
+## API Usage:
+
+```javascript
+var touch = require("touch")
+```
+
+Gives you the following functions:
+
+* `touch(filename, options, cb)`
+* `touch.sync(filename, options)`
+* `touch.ftouch(fd, options, cb)`
+* `touch.ftouchSync(fd, options)`
+
+All the `options` objects are optional.
+
+All the async functions return a Promise.  If a callback function is
+provided, then it's attached to the Promise.
+
+## Options
+
+* `force` like `touch -f` Boolean
+* `time` like `touch -t <date>` Can be a Date object, or any parseable
+  Date string, or epoch ms number.
+* `atime` like `touch -a` Can be either a Boolean, or a Date.
+* `mtime` like `touch -m` Can be either a Boolean, or a Date.
+* `ref` like `touch -r <file>` Must be path to a file.
+* `nocreate` like `touch -c` Boolean
+
+If neither `atime` nor `mtime` are set, then both values are set.  If
+one of them is set, then the other is not.
+
+## cli
+
+This package creates a `nodetouch` command line executable that works
+very much like the unix builtin `touch(1)`

package/backend/node_modules/touch/bin/nodetouch.js

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+const touch = require("../index.js")
+
+const usage = code => {
+  console[code ? 'error' : 'log'](
+    'usage:\n' +
+    'touch [-acfm] [-r file] [-t [[CC]YY]MMDDhhmm[.SS]] file ...'
+  )
+  process.exit(code)
+}
+
+const singleFlags = {
+  a: 'atime',
+  m: 'mtime',
+  c: 'nocreate',
+  f: 'force'
+}
+
+const singleOpts = {
+  r: 'ref',
+  t: 'time'
+}
+
+const files = []
+const args = process.argv.slice(2)
+const options = {}
+for (let i = 0; i < args.length; i++) {
+  const arg = args[i]
+  if (!arg.match(/^-/)) {
+    files.push(arg)
+    continue
+  }
+
+  // expand shorthands
+  if (arg.charAt(1) !== '-') {
+    const expand = []
+    for (let f = 1; f < arg.length; f++) {
+      const fc = arg.charAt(f)
+      const sf = singleFlags[fc]
+      const so = singleOpts[fc]
+      if (sf)
+        expand.push('--' + sf)
+      else if (so) {
+        const soslice = arg.slice(f + 1)
+        const soval = soslice.charAt(0) === '=' ? soslice : '=' + soslice
+        expand.push('--' + so + soval)
+        f = arg.length
+      } else if (arg !== '-' + fc)
+        expand.push('-' + fc)
+    }
+    if (expand.length) {
+      args.splice.apply(args, [i, 1].concat(expand))
+      i--
+      continue
+    }
+  }
+
+  const argsplit = arg.split('=')
+  const key = argsplit.shift().replace(/^\-\-/, '')
+  const val = argsplit.length ? argsplit.join('=') : null
+
+  switch (key) {
+    case 'time':
+      const timestr = val || args[++i]
+      // [-t [[CC]YY]MMDDhhmm[.SS]]
+      const parsedtime = timestr.match(
+        /^(([0-9]{2})?([0-9]{2}))?([0-9]{2})([0-9]{2})([0-9]{2})([0-9]{2})(\.([0-9]{2}))?$/
+      )
+      if (!parsedtime) {
+        console.error('touch: out of range or illegal ' +
+                      'time specification: ' +
+                      '[[CC]YY]MMDDhhmm[.SS]')
+        process.exit(1)
+      } else {
+        const y = +parsedtime[1]
+        const year = parsedtime[2] ? y
+          : y <= 68 ? 2000 + y
+          : 1900 + y
+
+        const MM = +parsedtime[4] - 1
+        const dd = +parsedtime[5]
+        const hh = +parsedtime[6]
+        const mm = +parsedtime[7]
+        const ss = +parsedtime[8]
+
+        options.time = new Date(Date.UTC(year, MM, dd, hh, mm, ss))
+      }
+      continue
+
+    case 'ref':
+      options.ref = val || args[++i]
+      continue
+
+    case 'mtime':
+    case 'nocreate':
+    case 'atime':
+    case 'force':
+      options[key] = true
+      continue
+
+    default:
+      console.error('touch: illegal option -- ' + arg)
+      usage(1)
+  }
+}
+
+if (!files.length)
+  usage()
+
+process.exitCode = 0
+Promise.all(files.map(f => touch(f, options)))
+  .catch(er => process.exitCode = 1)

package/backend/node_modules/touch/index.js

@@ -0,0 +1,224 @@
+'use strict'
+
+const EE = require('events').EventEmitter
+const cons = require('constants')
+const fs = require('fs')
+
+module.exports = (f, options, cb) => {
+  if (typeof options === 'function')
+    cb = options, options = {}
+
+  const p = new Promise((res, rej) => {
+    new Touch(validOpts(options, f, null))
+      .on('done', res).on('error', rej)
+  })
+
+  return cb ? p.then(res => cb(null, res), cb) : p
+}
+
+module.exports.sync = module.exports.touchSync = (f, options) =>
+  (new TouchSync(validOpts(options, f, null)), undefined)
+
+module.exports.ftouch = (fd, options, cb) => {
+  if (typeof options === 'function')
+    cb = options, options = {}
+
+  const p = new Promise((res, rej) => {
+    new Touch(validOpts(options, null, fd))
+      .on('done', res).on('error', rej)
+  })
+
+  return cb ? p.then(res => cb(null, res), cb) : p
+}
+
+module.exports.ftouchSync = (fd, opt) =>
+  (new TouchSync(validOpts(opt, null, fd)), undefined)
+
+const validOpts = (options, path, fd) => {
+  options = Object.create(options || {})
+  options.fd = fd
+  options.path = path
+
+  // {mtime: true}, {ctime: true}
+  // If set to something else, then treat as epoch ms value
+  const now = new Date(options.time || Date.now()).getTime() / 1000
+  if (!options.atime && !options.mtime)
+    options.atime = options.mtime = now
+  else {
+    if (true === options.atime)
+      options.atime = now
+
+    if (true === options.mtime)
+      options.mtime = now
+  }
+
+  let oflags = 0
+  if (!options.force)
+    oflags = oflags | cons.O_RDWR
+
+  if (!options.nocreate)
+    oflags = oflags | cons.O_CREAT
+
+  options.oflags = oflags
+  return options
+}
+
+class Touch extends EE {
+  constructor (options) {
+    super(options)
+    this.fd = options.fd
+    this.path = options.path
+    this.atime = options.atime
+    this.mtime = options.mtime
+    this.ref = options.ref
+    this.nocreate = !!options.nocreate
+    this.force = !!options.force
+    this.closeAfter = options.closeAfter
+    this.oflags = options.oflags
+    this.options = options
+
+    if (typeof this.fd !== 'number') {
+      this.closeAfter = true
+      this.open()
+    } else
+      this.onopen(null, this.fd)
+  }
+
+  emit (ev, data) {
+    // we only emit when either done or erroring
+    // in both cases, need to close
+    this.close()
+    return super.emit(ev, data)
+  }
+
+  close () {
+    if (typeof this.fd === 'number' && this.closeAfter)
+      fs.close(this.fd, () => {})
+  }
+
+  open () {
+    fs.open(this.path, this.oflags, (er, fd) => this.onopen(er, fd))
+  }
+
+  onopen (er, fd) {
+    if (er) {
+      if (er.code === 'EISDIR')
+        this.onopen(null, null)
+      else if (er.code === 'ENOENT' && this.nocreate)
+        this.emit('done')
+      else
+        this.emit('error', er)
+    } else {
+      this.fd = fd
+      if (this.ref)
+        this.statref()
+      else if (!this.atime || !this.mtime)
+        this.fstat()
+      else
+        this.futimes()
+    }
+  }
+
+  statref () {
+    fs.stat(this.ref, (er, st) => {
+      if (er)
+        this.emit('error', er)
+      else
+        this.onstatref(st)
+    })
+  }
+
+  onstatref (st) {
+    this.atime = this.atime && st.atime.getTime()/1000
+    this.mtime = this.mtime && st.mtime.getTime()/1000
+    if (!this.atime || !this.mtime)
+      this.fstat()
+    else
+      this.futimes()
+  }
+
+  fstat () {
+    const stat = this.fd ? 'fstat' : 'stat'
+    const target = this.fd || this.path
+    fs[stat](target, (er, st) => {
+      if (er)
+        this.emit('error', er)
+      else
+        this.onfstat(st)
+    })
+  }
+
+  onfstat (st) {
+    if (typeof this.atime !== 'number')
+      this.atime = st.atime.getTime()/1000
+
+    if (typeof this.mtime !== 'number')
+      this.mtime = st.mtime.getTime()/1000
+
+    this.futimes()
+  }
+
+  futimes () {
+    const utimes = this.fd ? 'futimes' : 'utimes'
+    const target = this.fd || this.path
+    fs[utimes](target, ''+this.atime, ''+this.mtime, er => {
+      if (er)
+        this.emit('error', er)
+      else
+        this.emit('done')
+    })
+  }
+}
+
+class TouchSync extends Touch {
+  open () {
+    try {
+      this.onopen(null, fs.openSync(this.path, this.oflags))
+    } catch (er) {
+      this.onopen(er)
+    }
+  }
+
+  statref () {
+    let threw = true
+    try {
+      this.onstatref(fs.statSync(this.ref))
+      threw = false
+    } finally {
+      if (threw)
+        this.close()
+    }
+  }
+
+  fstat () {
+    let threw = true
+    const stat = this.fd ? 'fstatSync' : 'statSync'
+    const target = this.fd || this.path
+    try {
+      this.onfstat(fs[stat](target))
+      threw = false
+    } finally {
+      if (threw)
+        this.close()
+    }
+  }
+
+  futimes () {
+    let threw = true
+    const utimes = this.fd ? 'futimesSync' : 'utimesSync'
+    const target = this.fd || this.path
+    try {
+      fs[utimes](target, this.atime, this.mtime)
+      threw = false
+    } finally {
+      if (threw)
+        this.close()
+    }
+    this.emit('done')
+  }
+
+  close () {
+    if (typeof this.fd === 'number' && this.closeAfter)
+      try { fs.closeSync(this.fd) } catch (er) {}
+  }
+}

package/backend/node_modules/touch/package.json

@@ -0,0 +1,25 @@
+{
+  "author": "Isaac Z. Schlueter <i@izs.me> (http://blog.izs.me/)",
+  "name": "touch",
+  "description": "like touch(1) in node",
+  "version": "3.1.1",
+  "repository": "git://github.com/isaacs/node-touch.git",
+  "bin": {
+    "nodetouch": "./bin/nodetouch.js"
+  },
+  "license": "ISC",
+  "scripts": {
+    "test": "tap test/*.js --100 -J",
+    "preversion": "npm test",
+    "postversion": "npm publish",
+    "postpublish": "git push origin --all; git push origin --tags"
+  },
+  "devDependencies": {
+    "mutate-fs": "^1.1.0",
+    "tap": "^10.7.0"
+  },
+  "files": [
+    "index.js",
+    "bin/nodetouch.js"
+  ]
+}

package/backend/node_modules/undefsafe/.github/workflows/release.yml

@@ -0,0 +1,25 @@
+name: Release
+on:
+  push:
+    branches:
+      - master
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-18.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v1
+      - name: Setup Node.js
+        uses: actions/setup-node@v1
+        with:
+          node-version: 16
+      - name: Install dependencies
+        run: npm ci
+      - name: Test
+        run: npm run test
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npx semantic-release

package/backend/node_modules/undefsafe/.jscsrc

@@ -0,0 +1,13 @@
+{
+  "preset": "node-style-guide",
+  "requireCapitalizedComments": null,
+  "requireSpacesInAnonymousFunctionExpression": {
+    "beforeOpeningCurlyBrace": true,
+    "beforeOpeningRoundBrace": true
+  },
+  "disallowSpacesInNamedFunctionExpression": {
+    "beforeOpeningRoundBrace": true
+  },
+  "excludeFiles": ["node_modules/**"],
+  "disallowSpacesInFunction": null
+}

package/backend/node_modules/undefsafe/.jshintrc

@@ -0,0 +1,16 @@
+{
+  "browser": false,
+  "camelcase": true,
+  "curly": true,
+  "devel": true,
+  "eqeqeq": true,
+  "forin": true,
+  "indent": 2,
+  "noarg": true,
+  "node": true,
+  "quotmark": "single",
+  "undef": true,
+  "strict": false,
+  "unused": true
+}
+

package/backend/node_modules/undefsafe/.travis.yml

@@ -0,0 +1,18 @@
+sudo: false
+language: node_js
+cache:
+  directories:
+    - node_modules
+notifications:
+  email: false
+node_js:
+  - '4'
+before_install:
+  - npm i -g npm@^2.0.0
+before_script:
+  - npm prune
+after_success:
+  - npm run semantic-release
+branches:
+  except:
+    - "/^v\\d+\\.\\d+\\.\\d+$/"

package/backend/node_modules/undefsafe/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright © 2016 Remy Sharp, http://remysharp.com <remy@remysharp.com>
+
+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/backend/node_modules/undefsafe/README.md

@@ -0,0 +1,63 @@
+# undefsafe
+
+Simple *function* for retrieving deep object properties without getting "Cannot read property 'X' of undefined"
+
+Can also be used to safely set deep values.
+
+## Usage
+
+```js
+var object = {
+  a: {
+    b: {
+      c: 1,
+      d: [1,2,3],
+      e: 'remy'
+    }
+  }
+};
+
+console.log(undefsafe(object, 'a.b.e')); // "remy"
+console.log(undefsafe(object, 'a.b.not.found')); // undefined
+```
+
+Demo: [https://jsbin.com/eroqame/3/edit?js,console](https://jsbin.com/eroqame/3/edit?js,console)
+
+## Setting
+
+```js
+var object = {
+  a: {
+    b: [1,2,3]
+  }
+};
+
+// modified object
+var res = undefsafe(object, 'a.b.0', 10);
+
+console.log(object); // { a: { b: [10, 2, 3] } }
+console.log(res); // 1 - previous value
+```
+
+## Star rules in paths
+
+As of 1.2.0, `undefsafe` supports a `*` in the path if you want to search all of the properties (or array elements) for a particular element.
+
+The function will only return a single result, either the 3rd argument validation value, or the first positive match. For example, the following github data:
+
+```js
+const githubData = {
+        commits: [{
+          modified: [
+            "one",
+            "two"
+          ]
+        }, /* ... */ ]
+      };
+
+// first modified file found in the first commit
+console.log(undefsafe(githubData, 'commits.*.modified.0'));
+
+// returns `two` or undefined if not found
+console.log(undefsafe(githubData, 'commits.*.modified.*', 'two'));
+```

package/backend/node_modules/undefsafe/example.js

@@ -0,0 +1,14 @@
+var undefsafe = require('undefsafe');
+
+var object = {
+  a: {
+    b: {
+      c: 1,
+      d: [1, 2, 3],
+      e: 'remy'
+    }
+  }
+};
+
+console.log(undefsafe(object, 'a.b.e')); // "remy"
+console.log(undefsafe(object, 'a.b.not.found')); // undefined