{"_id":"@alshakero/ez-s","_rev":"4-2d85c508ad8df21f248dcbfc568fd99a","name":"@alshakero/ez-s","dist-tags":{"latest":"0.0.3"},"versions":{"0.0.0":{"name":"@alshakero/ez-s","version":"0.0.0","description":"Zero-config HTTPS static file serving and directory listing","files":["bin"],"repository":{"type":"git","url":"git+https://github.com/alshakero/ez-s.git"},"bin":{"ez-s":"./bin/ez-s.js"},"scripts":{"test":"ava --serial"},"keywords":["now","serve","ez-s","micro","http-server"],"author":{"name":"alshaker"},"license":"MIT","dependencies":{"@zeit/schemas":"1.7.0","ajv":"6.5.2","arg":"2.0.0","boxen":"1.3.0","chalk":"2.4.1","clipboardy":"1.2.3","serve-handler":"3.6.0","update-check":"1.5.2"},"devDependencies":{"ava":"^0.25.0","request":"^2.87.0"},"gitHead":"087f6f494bd85788f0c6f88d745b38f8dc40c8da","bugs":{"url":"https://github.com/alshakero/ez-s/issues"},"homepage":"https://github.com/alshakero/ez-s#readme","_id":"@alshakero/ez-s@0.0.0","_npmVersion":"6.2.0","_nodeVersion":"8.11.1","_npmUser":{"name":"alshakero","email":"omar@omaralshaker.com"},"dist":{"integrity":"sha512-a5O/Iw9Vj0sSX4Ol6vkPrFCert5gEApi7V/0ODkZ7USH3qB07zEU3Xj/cGIv68E4w/9j6lXMaZ/4yNJu6j9Ujg==","shasum":"c808538387bc06ac722dbb2ca524885cd39301bf","tarball":"https://registry.npmjs.org/@alshakero/ez-s/-/ez-s-0.0.0.tgz","fileCount":4,"unpackedSize":12607,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJbXzu2CRA9TVsSAnZWagAA5hMP/1plClJgyYvkTM4INfpp\nACkXEr+AmQKtEM/guX95zbOI82WRkrmvzdGNjF9WVkAPDHNRUO0+hNx+QKEh\nUrwH76bvXrx36XzOPchuZZq89idq2fjUaB4QtSZ4/ECk6qzN4qbZl+GTcTOp\n3kINDIgMPZmVF3B6WZK0oQDktVWpkmC5AQ1oG0V9bD68hCtkr5WD63AfCJok\nGFyD+cqCiux5kHfQZefb5YxNEJmP1pz1GmGoSflTscyVKQZhiL1PLQ9TskFs\nLSXv6JCPylEq7PN1UU39VtNkJutdcm2MJyRju+cIwxjjhFdrYsywxYGA6dNJ\n3wc4kjQ9e6hfI0v4VTYZygQo/SNR3a53BP+xF2QmwuHqcFSNjmUmhFRqjaar\nEi7yzwZQC4d7/3PvUef0RcwGaclpZA/ENh7NTf58P0vgZckdNRuRSk5omUQx\nvaTcTlm4qTrQN6QFqflgNJIki9NaXnQnHgYIHsmpxbUsqtknLQBVOt0lZml1\nHy5KnVuBZ7BrETLphD2VQjtY6oruisSF05K3aAvyVE44oX1gb/injUn7wTK9\n33ScL9pOa+hQ3LDE57ApgZVruuOw5T7sRJOgH8fT2jsE6loeyHIX9qvYfiAQ\nX71V61cd0qyL4LVb1Tb1q4H5JiMeB7a3+snLgyV/LyZOWQsgrIBOszmmw82H\nZNEI\r\n=SuMw\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIHXlWXxwbo0LN2FpS+OA+8xTOWboPuJjk8F586jDx9asAiBXGOg60DhcqWemtRM6Zh/EY0+UHNdX2FUx4C4YLNf6qA=="}]},"maintainers":[{"name":"alshakero","email":"omar@omaralshaker.com"}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/ez-s_0.0.0_1532967859483_0.26745498402824697"},"_hasShrinkwrap":false},"0.0.1":{"name":"@alshakero/ez-s","version":"0.0.1","description":"Zero-config HTTPS static file serving and directory listing","files":["bin"],"repository":{"type":"git","url":"git+https://github.com/alshakero/ez-s.git"},"bin":{"ez-s":"./bin/ez-s.js"},"scripts":{"test":"ava --serial"},"keywords":["now","serve","ez-s","micro","http-server"],"author":{"name":"alshaker"},"license":"MIT","dependencies":{"@zeit/schemas":"1.7.0","ajv":"6.5.2","arg":"2.0.0","boxen":"1.3.0","chalk":"2.4.1","clipboardy":"1.2.3","serve-handler":"3.6.0","update-check":"1.5.2"},"devDependencies":{"ava":"^0.25.0","request":"^2.87.0"},"gitHead":"3eeb822ea26fe6929f371a7067620068c746d0cf","bugs":{"url":"https://github.com/alshakero/ez-s/issues"},"homepage":"https://github.com/alshakero/ez-s#readme","_id":"@alshakero/ez-s@0.0.1","_npmVersion":"6.2.0","_nodeVersion":"8.11.1","_npmUser":{"name":"alshakero","email":"omar@omaralshaker.com"},"dist":{"integrity":"sha512-7yTOmz2y/Np0lzv4JSmLPh+vMEJOjsiarA+Gjvd7PNfAiZdjWv+K4AE5AV5xXkXSZVbRJ+nLy0EseEMgxWHzpQ==","shasum":"d1ed30af7ff0f83a5da0d785d5f6a5e462b8115e","tarball":"https://registry.npmjs.org/@alshakero/ez-s/-/ez-s-0.0.1.tgz","fileCount":4,"unpackedSize":12831,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJbXz8YCRA9TVsSAnZWagAAI+8P/0W4PD3KVM2x9iKHZxeN\neJLu/p2iebSC9dO8XQOItNjoSNwF+hn9K3C3+W1q282oKz8znS3T4+jFCKCk\n0lXzJdW9msLaLME0cFncPz3/YtCHJLuvDLLdLT5HXpHPJNbbTySkArQ99sbF\n6bl0zmNjzn6XFJ6+rRiCCQHVKpLxHMajHXkIj+lhrQ8InBIPmI44TXnwKjny\nMYeoiRAU+eMNyK72YIJXLLfR4xQ9Qf+pFpYLHv/MEKORnEb4f1M2Sdq7/rwa\nsxVpy+M2OQ81y3TmhseEvDzQYoB+sdd8DF9SJTpG6r2DI9EhHtYq58hfjesz\nCQaHwpM/LdaYnTLlnaZOf7rvqOCu4eCYExWwFNg2ek845rsC8pYelcIu66gq\ncu6rXy+pfeA/LvaZ1o79iWrfKYSlCAw+YGEBZhE/RJxJqascaSaU4d4cYGs5\nYoadlCDdZgryQkp1EmgLijgDC3OLGV73qpsdz3k+ctmS9DoB/T7W6DaEGIA4\na6M70PlemM0WIlXXnmw0PC7rHf0z1WrwTZaeXuXC3KJL/g+liitHPeL205AW\nFwU3Girhe/olULeHjoX2hCa7BAfl2pGCL9bE/lOI4xfa75thjcZMKCPQlBB4\ntDvUnKXpYLkA+43VBeqQ9ubm4jsyDsmPXktA2dG1o5kqL/NhQ7RZntQBXEwE\n/dOs\r\n=dNJI\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIBTx585OPuU2fKrLxDxnlIvqDAN9hr3MuLhZsuuYDSlTAiBeRtg0y505ghAh8jsqUCJdoM8I44f0cAoG5fwxHB8nNw=="}]},"maintainers":[{"name":"alshakero","email":"omar@omaralshaker.com"}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/ez-s_0.0.1_1532968728288_0.7785616125672057"},"_hasShrinkwrap":false},"0.0.2":{"name":"@alshakero/ez-s","version":"0.0.2","description":"Zero-config HTTPS static file serving and directory listing","files":["bin","certs"],"repository":{"type":"git","url":"git+https://github.com/alshakero/ez-s.git"},"bin":{"ez-s":"./bin/ez-s.js"},"scripts":{"test":"ava --serial"},"keywords":["now","serve","ez-s","micro","http-server"],"author":{"name":"alshaker"},"license":"MIT","dependencies":{"@zeit/schemas":"1.7.0","ajv":"6.5.2","arg":"2.0.0","boxen":"1.3.0","chalk":"2.4.1","clipboardy":"1.2.3","serve-handler":"3.6.0","update-check":"1.5.2"},"devDependencies":{"ava":"^0.25.0","request":"^2.87.0"},"gitHead":"d9c70a2978ba5c4bed5182cfba086b7d0305c9b7","bugs":{"url":"https://github.com/alshakero/ez-s/issues"},"homepage":"https://github.com/alshakero/ez-s#readme","_id":"@alshakero/ez-s@0.0.2","_npmVersion":"6.2.0","_nodeVersion":"8.11.1","_npmUser":{"name":"alshakero","email":"omar@omaralshaker.com"},"dist":{"integrity":"sha512-zYFoVaEOcW0oxau85yoNwKrVabpMJZGBj+6tkJsTz1w/Ephf9onWdT5J2wq8ORnwRFbFUpT2TigmnD+htB5SFA==","shasum":"72f142e55d6ddf46984d44a4b212ed03438bf8e9","tarball":"https://registry.npmjs.org/@alshakero/ez-s/-/ez-s-0.0.2.tgz","fileCount":7,"unpackedSize":20455,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJbXz/vCRA9TVsSAnZWagAAnU4QAIq6wlBAdoJImiePvi+H\nRoFPbs9CERzjObHdIzy0DbrrhpIDxzgI9jhjURRWhnjBH3CuFdBiemDIG91D\nkaoEa20FFCUk5DwS1nlw3mPjbxwmZZZZ2BkvkC/xDJH2OX0xG5QZzTJRDNMG\nHV8sxO1Q/42p1DJzhReqQNWANLXjB2+R/WBJKJQOxjylVAbve41qCNjWElCE\n7Zq6PHCRObW5CKVIqsgEDugic/fa7aKW6ZLXkGcKc8KF+b2xrh1PzSFdIMtO\nACZs/Zlzi4AKusAjuYZNVGbtI12pjEH2KoMiE2CH2yxnM8fe4XcGhNAA0Qbf\nRtZz3tVIoMoTceaOEl19pfrxCUr2fnkiarKTdxLNs/e7TiYF0OyYyt9fR18n\nN0W1gtTFzKJCotjw0t2usQfiI3HV+71oS41Q7Ont9uPGNLnzkynZPdhbPRDS\n3ywrWdbA5pV0HU8XOla7/YFibppM1lfYXCnveoOmhHljdaR5Di+lH5ovGp8d\nj4k9fkLIJXF/ZuURf1C8YAthLVvPx73EzYI1r4Gb56RtfJ5bT5Akut6zYm48\nmClfwvhQaXwJaxjmIwZOR7I8laHFTP2JYEvf7Hz1v4ZZdJQnKSnIGnUMljoj\nibUUOi78b6M4gfkRIXsePEW4Hjst5RjwGciyMtxZPQ9AYHPp2o2GzkNX9wTc\ndsz3\r\n=56/g\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIGp3X2wmcH6wuqxzsOZCQyAFML3DiO26VR3iHiNFjbRfAiAOihSVEhKLw9s3vt9UsEzIaYiyyf3UC1KAKG2c9s1S2Q=="}]},"maintainers":[{"name":"alshakero","email":"omar@omaralshaker.com"}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/ez-s_0.0.2_1532968943061_0.2766675281454585"},"_hasShrinkwrap":false},"0.0.3":{"name":"@alshakero/ez-s","version":"0.0.3","description":"Zero-config HTTPS static file serving and directory listing","files":["bin","certs"],"repository":{"type":"git","url":"git+https://github.com/alshakero/ez-s.git"},"bin":{"ez-s":"./bin/ez-s.js"},"scripts":{"test":"ava --serial"},"keywords":["now","serve","ez-s","micro","http-server"],"author":{"name":"alshaker"},"license":"MIT","dependencies":{"@zeit/schemas":"1.7.0","ajv":"6.5.2","arg":"2.0.0","boxen":"1.3.0","chalk":"2.4.1","clipboardy":"1.2.3","serve-handler":"3.6.0","update-check":"1.5.2"},"devDependencies":{"ava":"^0.25.0","request":"^2.87.0"},"gitHead":"0c6195a1190553c8762d6e96d1fe275dfb61ff40","bugs":{"url":"https://github.com/alshakero/ez-s/issues"},"homepage":"https://github.com/alshakero/ez-s#readme","_id":"@alshakero/ez-s@0.0.3","_npmVersion":"6.2.0","_nodeVersion":"8.11.1","_npmUser":{"name":"alshakero","email":"omar@omaralshaker.com"},"dist":{"integrity":"sha512-T3qVDZ6B037z2/dRzgQe2+s4/kZNDiWAP8YLP3JRlavAsb0nxailm1qeQqWzQ5GBejcW16IqW6KCEYzyAvwQdQ==","shasum":"750cf08a4c056c000ac049072405fa29b7f336ad","tarball":"https://registry.npmjs.org/@alshakero/ez-s/-/ez-s-0.0.3.tgz","fileCount":7,"unpackedSize":21282,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJbYC3zCRA9TVsSAnZWagAAB7EP/2seIQNtwGlJq/bqb/kk\n5UKgJxQxuXXgTETtecRosoKcf3CQ2dzjsx0dtuOdcEGuDFzGW+kKsTVicRuk\npEc/IwHCh9gt9Q8CEwDvLzMwrAeDh+1SpwRmjxdh5AZ1WJ4eg4BxwByrk2eN\n4uT8VhxlJS5C/hWP8gejJpeLD5PcLCZL+iiKJuZilfqvA+rjZxnblzrYumQI\nbI1ijXNW/C4xRStiturEnI/mNcVCDc8YtMOW4aoL4QkVZ793X2p/Sn0DLgeV\nzxisllpv+wYttnT+VzqYodxgwh1A0o45EOQzoH+vwX8T0104P4kPb78O+WZR\nImapkg9wzysoB8Dqw11bs43X08Hp6QidxiXGuviXMRXKEU82JLZ47enkDfic\nTejS+9prJyczvdyqVssW61wFiJ15gUNPtpzakubS1nyByEK7DKt3htariIb5\nTmDB/Y4TxICIwTVsz2rWbX+WNODc7SZaNr/txzayH5qXNuYsvtI6DwVZVCyo\nqTAP66cUFarYqZjSH7ACY0GEfPrEHtF23vFSVJ8UdkF08oOt4i65ZHVwdICe\nLqZEQSwBPZUDhmYJsFRRypDvZpVUQ//weXEkAczddI60wUIOcUQvQse+lEwp\n9OpxqG7w3Pc54c2uAQf9Idad3Or69kuqTJ5hZrFhtCQYZl91PKtiy/jgEHbi\nFM5v\r\n=hq+g\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIBwJm9LZjsHkQP1O7SPaSrATpSMEyh8cY45NkU4OHyqxAiAa2jYWJcJ/L2yloirzlboNoOyvLoNDKqu9azgsEfzJ0g=="}]},"maintainers":[{"name":"alshakero","email":"omar@omaralshaker.com"}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/ez-s_0.0.3_1533029875494_0.9158187133129849"},"_hasShrinkwrap":false}},"time":{"created":"2018-07-30T16:24:19.002Z","0.0.0":"2018-07-30T16:24:22.041Z","modified":"2022-04-04T13:38:57.831Z","0.0.1":"2018-07-30T16:38:48.559Z","0.0.2":"2018-07-30T16:42:23.137Z","0.0.3":"2018-07-31T09:37:55.582Z"},"maintainers":[{"name":"alshakero","email":"omar@omaralshaker.com"}],"description":"Zero-config HTTPS static file serving and directory listing","homepage":"https://github.com/alshakero/ez-s#readme","keywords":["now","serve","ez-s","micro","http-server"],"repository":{"type":"git","url":"git+https://github.com/alshakero/ez-s.git"},"author":{"name":"alshaker"},"bugs":{"url":"https://github.com/alshakero/ez-s/issues"},"license":"MIT","readme":"![EZ-S Logo](https://user-images.githubusercontent.com/17054134/43371384-dc63dbbc-9390-11e8-9866-42a7e9410047.png)\r\n\r\n> Serving HTTP for development is fairly easy. Serving HTTPS is not. This tools gives your HTTP an easy S.\r\n\r\nEZ-S is a fork of [zeit/serve](https://github.com/zeit/serve) that gives you the ability to locally run a green-badge HTTPS server with zero configuration! No certificate creation, no tunnels, no hassle. Just run `ez-s` and access `https://ez-s.io:5000` to see your folder served with a lovely green badge 🤯. Test your Service Workers, secure cookies etc.. [_(but how?)_](#how-this-works).\r\n\r\n[![Build Status](https://travis-ci.org/alshakero/ez-s.svg?branch=master)](https://travis-ci.org/alshakero/ez-s)\r\n\r\n## Usage\r\n\r\nFirstly, install the package using Yarn or NPM (you'll need at least [Node.js LTS](https://nodejs.org/en/)):\r\n\r\n```bash\r\nyarn global add @alshakero/ez-s\r\n# or\r\nnpm install -g @alshakero/ez-s\r\n```\r\n\r\n_Sadly, there is another package called ezs. And NPM won't let me publish my package unscoped due to name similiarity._.\r\n\r\nOnce that's done, you can run this command inside your project's directory:\r\n\r\n```bash\r\nez-s\r\n```\r\n\r\nFinally, run this command to see a list of all available options:\r\n\r\n```bash\r\nez-s --help\r\n```\r\nNow you understand how the package works! :tada:\r\n\r\nIf you're fimiliar with `serve`, `ez-s` accepts exactly the same arguments except `-l, --listen`. It accepts `--port` instead. The reasoning is explained in How this works section below.\r\n\r\n## How this works?\r\n\r\n1. The domain `ez-s.io` has a single `A` DNS record pointing to the IP address `127.0.0.1`. \r\n2. In this package there are included certificates generated by letsencrypt.\r\n3. The HTTPS server uses the aforementioned certificates including the private key. So when you access `ez-s.io` the certificate provided will actually match letsecrypt's, the IP address of the host does not matter. As long as letsencrypt records match the certificates provided by the server, Chrome will not object.\r\n\r\nWait what? Public private keys?! Yes. Because the domain will forever point to 127.0.0.1, _impersonating it_ will not take the impersonator anywhere. Unless the impersonator has power over the victims DNS server, which makes ez-s the least of the victim's worries 😁\r\n\r\n### Caveat\r\n\r\nSince `ez-s.io` points to `localhost`, your app will be only accessible locally. You can't test it on your phone or using another machine. Using a SauceLabs tunnel would perfectly work though. \r\n\r\nDue to this caveat, `serve`'s `--listen` argument is useless in this case. The only configurble network-related parameter is the port. \r\n\r\n## Configuration\r\n\r\nPlease see `serve`'s [configuration](https://github.com/zeit/serve#configuration) section.\r\n\r\n## Supporting this tool\r\n\r\nIf you like it, please give it a star ⭐\r\n\r\n## Contributing\r\n\r\n1. [Fork](https://help.github.com/articles/fork-a-repo/) this repository to your own GitHub account and then [clone](https://help.github.com/articles/cloning-a-repository/) it to your local device\r\n2. Uninstall `ez-s` if it's already installed: `npm uninstall -g @alshakero/ez-s`\r\n3. Link it to the global module directory: `npm link`\r\n\r\nAfter that, you can use the `ez-s` command everywhere.\r\n\r\n## What if you don't want to use `serve` \r\n\r\nYou can download the certificates from `certs` folder and use them with any server you want. After you set your server up, access `https://ez-s.io` and it should work.\r\n\r\n### Upcoming features\r\n\r\n- Soon, there will be a `--tunnel` argument. This argument will **locally** tunnel your own HTTP server to an HTTPS endpoint. All on your machine in a single command. \r\n- Your suggested feature. Please create an issue if you think if you have a feature request.\r\n\r\n## Credits\r\n\r\nThis project is almost identical to Zeit's. The best part of the credit goes to them. My idea was to offer HTTPS and found it wasteful to re-create the underlaying HTTP logic. Huge thanks to Zeit!\r\n\r\n## Author\r\n\r\nOmar Alshaker \r\n","readmeFilename":"README.md"}