fcemail 0.1.11

package/.github/workflows/release.yml

@@ -0,0 +1,90 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  goreleaser:
+    runs-on: windows-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.22'
+
+      - name: Run GoReleaser
+        uses: goreleaser/goreleaser-action@v6
+        continue-on-error: true
+        with:
+          distribution: goreleaser
+          version: latest
+          args: release --clean
+        env:
+          GITHUB_TOKEN: ${{ secrets.GORELEASER_PAT || secrets.GITHUB_TOKEN }}
+          CHOCOLATEY_API_KEY: ${{ secrets.CHOCOLATEY_API_KEY }}
+
+  publish-npm:
+    needs: goreleaser
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Publish to NPM
+        run: |
+          VERSION=${GITHUB_REF#refs/tags/v}
+          cat <<EOF > package.json
+          {
+            "name": "fcemail",
+            "version": "${VERSION}",
+            "description": "FreeCustom.Email CLI — Manage disposable inboxes from your terminal.",
+            "bin": {
+              "fce": "bin/fce"
+            },
+            "scripts": {
+              "postinstall": "node scripts/install-binary.js"
+            },
+            "repository": {
+              "type": "git",
+              "url": "git+https://github.com/DishIs/fce-cli.git"
+            },
+            "author": "DishIs",
+            "license": "MIT"
+          }
+          EOF
+          # Create a minimal install script for NPM users
+          mkdir -p bin
+          touch bin/fce
+          mkdir -p scripts
+          cat <<EOF > scripts/install-binary.js
+          const { execSync } = require('child_process');
+          const fs = require('fs');
+          const path = require('path');
+          
+          console.log('Downloading fce-cli binary...');
+          try {
+            execSync('curl -fsSL https://raw.githubusercontent.com/DishIs/fce-cli/main/scripts/install.sh | BIN_DIR=./bin sh');
+          } catch (err) {
+            console.error('Failed to download binary:', err.message);
+            process.exit(1);
+          }
+          EOF
+          npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.goreleaser.yaml

@@ -0,0 +1,83 @@
+# .goreleaser.yaml
+version: 2
+project_name: fce
+
+before:
+  hooks:
+    - go mod tidy
+
+builds:
+  - id: fce
+    binary: fce
+    env:
+      - CGO_ENABLED=0
+    goos:
+      - linux
+      - windows
+      - darwin
+    goarch:
+      - amd64
+      - arm64
+    ldflags:
+      - -s -w -X github.com/DishIs/fce-cli/cmd.Version={{.Version}} -X github.com/DishIs/fce-cli/cmd.Commit={{.Commit}} -X github.com/DishIs/fce-cli/cmd.Date={{.Date}}
+
+archives:
+  - id: fce
+    formats:
+      - tar.gz
+    # use zip for windows archives
+    format_overrides:
+      - goos: windows
+        formats:
+          - zip
+    name_template: "{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
+
+checksum:
+  name_template: 'checksums.txt'
+
+snapshot:
+  version_template: "{{ incpatch .Version }}-next"
+
+changelog:
+  sort: asc
+  filters:
+    exclude:
+      - '^docs:'
+      - '^test:'
+
+brews:
+  - name: fce
+    repository:
+      owner: DishIs
+      name: homebrew-tap
+    homepage: "https://github.com/DishIs/fce-cli"
+    description: "FreeCustom.Email CLI — Manage disposable inboxes from your terminal."
+    install: |
+      bin.install "fce"
+
+scoops:
+  - name: fce
+    repository:
+      owner: DishIs
+      name: scoop-bucket
+    homepage: "https://github.com/DishIs/fce-cli"
+    description: "FreeCustom.Email CLI — Manage disposable inboxes from your terminal."
+    license: MIT
+
+chocolateys:
+  - name: fce
+    owners: DishIs
+    authors: DishIs
+    title: "FreeCustom.Email CLI"
+    description: "Manage disposable inboxes, extract OTPs, and stream real-time email events from your terminal."
+    summary: "FreeCustom.Email CLI — Disposable Email API"
+    project_url: "https://github.com/DishIs/fce-cli"
+    icon_url: "https://github.com/DishIs/fce-cli/logo.webp"
+    license_url: "https://github.com/DishIs/fce-cli/blob/main/LICENSE"
+    docs_url: "https://github.com/DishIs/fce-cli/blob/main/README.md"
+    bug_tracker_url: "https://github.com/DishIs/fce-cli/issues"
+    package_source_url: "https://github.com/DishIs/fce-cli"
+    project_source_url: "https://github.com/DishIs/fce-cli"
+    release_notes: "https://github.com/DishIs/fce-cli/releases/tag/{{ .Tag }}"
+    tags: "cli email disposable-email otp websocket"
+    api_key: "{{ .Env.CHOCOLATEY_API_KEY }}"

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 FreeCustom.Email
+
+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/README.md

@@ -0,0 +1,226 @@
+# fce — FreeCustom.Email CLI
+
+```
+______             _____           _                    _____                _ _ 
+|  ___|           /  __ \         | |                  |  ___|              (_) |
+| |_ _ __ ___  ___| /  \/_   _ ___| |_ ___  _ __ ___   | |__ _ __ ___   __ _ _| |
+|  _| '__/ _ \/ _ \ |   | | | / __| __/ _ \| '_ ` _ \  |  __| '_ ` _ \ / _` | | |
+| | | | |  __/  __/ \__/\ |_| \__ \ || (_) | | | | | |_| |__| | | | | | (_| | | |
+\_| |_|  \___|\___|\____/\__,_|___/\__\___/|_| |_| |_(_)____/_| |_| |_|\__,_|_|_|
+                                                                                 
+                                                                                 
+  FreeCustom.Email
+  disposable inbox API
+```
+
+Manage disposable inboxes, extract OTPs, and stream real-time email events from your terminal — in under 30 seconds.
+
+---
+
+## Install
+
+```bash
+curl -fsSL freecustom.email/install.sh | sh
+```
+
+*(Or use your preferred package manager below)*
+
+**macOS/Linux (Homebrew)**
+```bash
+brew tap DishIs/homebrew-tap
+brew install fce
+```
+
+**Windows (Scoop)**
+```powershell
+scoop bucket add fce https://github.com/DishIs/scoop-bucket
+scoop install fce
+```
+
+**Windows (Chocolatey)**
+```powershell
+choco install fce
+```
+
+**Shell Script (macOS/Linux)**
+```bash
+curl -sSfL https://raw.githubusercontent.com/DishIs/fce-cli/main/scripts/install.sh | sh
+```
+
+**Go install**
+```bash
+go install github.com/DishIs/fce-cli@latest
+```
+
+---
+
+## Update
+
+When a new version is released, you can update the CLI using your package manager:
+
+**Homebrew**
+```bash
+brew update
+brew upgrade fce
+```
+
+**Scoop**
+```powershell
+scoop update fce
+```
+
+**Chocolatey**
+```powershell
+choco upgrade fce
+```
+
+**NPM**
+```bash
+npm install -g fcemail@latest
+```
+
+**Shell Script**
+Simply re-run the installation command or use the built-in update:
+```bash
+fce update
+```
+
+---
+
+## Uninstall
+
+To remove the CLI and all local configuration:
+
+1. **Clear Config & Credentials**
+   ```bash
+   fce uninstall
+   ```
+   *(This clears your API key and local cache)*
+
+2. **Remove the Binary**
+   - **Homebrew**: `brew uninstall fce`
+   - **Scoop**: `scoop uninstall fce`
+   - **Choco**: `choco uninstall fce`
+    - **NPM**: `npm uninstall -g fcemail`
+    - **Manual**: `sudo rm /usr/local/bin/fce`
+
+Or download a binary from [Releases](https://github.com/DishIs/fce-cli/releases).
+
+---
+
+## Quick start
+
+```bash
+# 1. Login — opens your browser
+fce login
+
+# 2. Watch a random inbox for emails in real time
+fce watch random
+
+# 3. Or watch a specific one
+fce watch mytest@ditmail.info
+```
+
+---
+
+## Commands
+
+| Command | Description | Plan required |
+|---------|-------------|---------------|
+| `fce login` | Authenticate via browser | Any |
+| `fce logout` | Remove stored credentials | Any |
+| `fce status` | Account info, plan, inbox counts | Any |
+| `fce usage` | Request usage for current period | Any |
+| `fce inbox list` | List registered inboxes | Any |
+| `fce inbox add <addr>` | Register a new inbox | Any |
+| `fce inbox add random` | Register a random inbox | Any |
+| `fce inbox remove <addr>` | Unregister an inbox | Any |
+| `fce messages <inbox>` | List messages in an inbox | Any |
+| `fce domains` | List available domains | Any |
+| `fce watch [inbox\|random]` | Stream emails via WebSocket | **Startup+** |
+| `fce otp <inbox>` | Get latest OTP from an inbox | **Growth+** |
+
+### Examples
+
+```bash
+# Register + watch a random inbox
+fce inbox add random
+fce watch random
+
+# Watch a specific inbox (Startup plan+)
+fce watch alerts@ditmail.info
+
+# Get the latest OTP (Growth plan+)
+fce otp mytest@ditmail.info
+
+# Check quota
+fce usage
+
+# List all your inboxes
+fce inbox ls
+```
+
+---
+
+## Authentication
+
+`fce login` opens your browser to `www.freecustom.email`. Sign in with GitHub, Google, or a magic link — a new API key is created and stored securely in your OS keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service / libsecret).
+
+You can also set the `FCE_API_KEY` environment variable to skip the keychain entirely — useful in CI:
+
+```bash
+export FCE_API_KEY=fce_your_key_here
+fce status
+```
+
+---
+
+## Plan limits
+
+| Feature | Free | Developer | Startup | Growth | Enterprise |
+|---------|------|-----------|---------|--------|------------|
+| All basic commands | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `fce watch` (WebSocket) | ✗ | ✗ | ✓ | ✓ | ✓ |
+| `fce otp` | ✗ | ✗ | ✗ | ✓ | ✓ |
+
+Upgrade at: https://www.freecustom.email/api/pricing
+
+---
+
+## Build from source
+
+```bash
+git clone https://github.com/DishIs/fce-cli
+cd fce
+go build -o fce .
+./fce --help
+```
+
+**Cross-platform release build** (requires [goreleaser](https://goreleaser.com)):
+```bash
+goreleaser build --clean --snapshot
+# Binaries in dist/
+```
+
+---
+
+## CI usage
+
+```yaml
+# GitHub Actions example
+- name: Get OTP
+  env:
+    FCE_API_KEY: ${{ secrets.FCE_API_KEY }}
+  run: |
+    fce inbox add random > /tmp/inbox.txt
+    INBOX=$(cat /tmp/inbox.txt | grep -o '[a-z0-9@.]*')
+    # trigger your app to send email to $INBOX
+    OTP=$(fce otp $INBOX)
+    echo "OTP: $OTP"
+```
+
+---
+
+## License
+
+MIT © FreeCustom.Email