envlink 0.0.1 → 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License Copyright (c) 2026 AbabilCore
+
+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
+(including the next paragraph) 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,62 @@
+# EnvLink
+
+Secure and anonymous environment file sharing CLI - Share `.env` files with expiration and password protection.
+
+[![npm version](https://img.shields.io/npm/v/envlink.svg)](https://www.npmjs.com/package/envlink)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Installation
+
+### Permanent Installation
+
+```bash
+npm install -g envlink
+```
+
+### One-Time Use (No Installation)
+
+You can use EnvLink without installing it permanently:
+
+```bash
+# Using npx (Node.js)
+npx envlink create
+npx envlink install el_abc123xyz456
+
+# Using bunx (Bun)
+bunx envlink create
+bunx envlink install el_abc123xyz456
+
+# Using pnpm
+pnpm dlx envlink create
+pnpm dlx envlink install el_abc123xyz456
+```
+
+## Quick Start
+
+### Create and Share
+
+```bash
+cd my-project
+envlink create
+```
+
+Share the generated EnvLink ID with your team!
+
+### Install on Another Machine
+
+```bash
+envlink install el_abc123xyz456
+```
+
+That's it! Your environment files are now installed.
+
+## Documentation
+
+For complete command reference including update, expire, and advanced options, see [commands.md](./commands.md)
+
+## Security
+
+- Auto-expiration (configurable)
+- Optional password protection
+- No signup required
+- Anonymous sharing

package/commands.md

@@ -0,0 +1,134 @@
+# EnvLink CLI Commands Reference
+
+Complete command reference for EnvLink CLI tool.
+
+## Version & Help
+
+```bash
+# Show version number
+envlink -v
+envlink -V
+envlink --version
+
+# Show help for all commands
+envlink -h
+envlink --help
+
+# Show help for a specific command
+envlink help <command>
+```
+
+## Create Commands
+
+```bash
+# Interactive creation (prompts for files, expiration, password)
+envlink create
+
+# Create with 5 day expiration
+envlink create --exp 5d
+
+# Create with password protection
+envlink create --exp-pass <password>
+
+# Create with 1 year expiration and password
+envlink create --exp 1y --exp-pass <password>
+```
+
+**Expiration units:** `m` (minutes), `M` (hours), `d` (days), `y` (years), `never`
+
+## Install Commands
+
+```bash
+# Install all files from EnvLink
+envlink install <id>
+
+# Install with file selection prompt
+envlink install <id> -s
+envlink install <id> --select-files
+```
+
+## Info Commands
+
+```bash
+# Show EnvLink details (status, files, expiry, install count)
+envlink info <id>
+```
+
+## Update Commands
+
+```bash
+# Update files from current directory
+envlink update <id> -f
+envlink update <id> --files
+
+# Update expiration to 30 days
+envlink update <id> --exp 30d
+
+# Update/set expiration password
+envlink update <id> --exp-pass <new-password>
+
+# Provide current password for protected EnvLink
+envlink update <id> --current-pass <password>
+
+# Update files and set to never expire
+envlink update <id> -f --exp never
+
+# Update files with authentication
+envlink update <id> --files --current-pass <password>
+```
+
+## Expire Commands
+
+```bash
+# Manually expire an EnvLink (if not password protected)
+envlink expire <id>
+
+# Expire EnvLink with password validation
+envlink expire <id> --exp-pass <password>
+```
+
+## Examples
+
+### Basic Workflow
+
+```bash
+# 1. Create an EnvLink
+envlink create
+
+# 2. Check EnvLink status
+envlink info el_abc123xyz456
+
+# 3. Install on another machine
+envlink install el_abc123xyz456
+```
+
+### Advanced Workflow
+
+```bash
+# 1. Create 7-day link with password
+envlink create --exp 7d --exp-pass mypass123
+
+# 2. Update files later
+envlink update el_abc123xyz456 --files --current-pass mypass123
+
+# 3. Manually expire when done
+envlink expire el_abc123xyz456 --exp-pass mypass123
+```
+
+## Common Options
+
+| Option                      | Description                                               |
+| --------------------------- | --------------------------------------------------------- |
+| `--exp <duration>`          | Expiration duration: `30m`, `24M`, `5d`, `1y`, or `never` |
+| `--exp-pass <password>`     | Password for protection/expiration                        |
+| `--current-pass <password>` | Current password (required for updating protected links)  |
+| `-f, --files`               | Update files flag                                         |
+| `-s, --select-files`        | File selection mode for install                           |
+
+## Notes
+
+- **Default expiration:** 24 days if not specified
+- **EnvLink ID format:** `el_<16-char-alphanumeric>`
+- **Password protection:** Required for updates and manual expiration of protected links
+- **Expired links:** Cannot be installed or updated
+- **Never expire:** Use `--exp never` for permanent links