extendvcc-cli 0.1.0__py3-none-any.whl

extendvcc_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,179 @@
+Metadata-Version: 2.4
+Name: extendvcc-cli
+Version: 0.1.0
+Summary: Unofficial CLI and Python client for the Extend virtual card API
+Project-URL: Homepage, https://github.com/4LAU/extendvcc
+Project-URL: Repository, https://github.com/4LAU/extendvcc
+Project-URL: Issues, https://github.com/4LAU/extendvcc/issues
+Project-URL: Changelog, https://github.com/4LAU/extendvcc/blob/main/CHANGELOG.md
+Author: 4LAU
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,extend,fintech,virtual-card
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: filelock>=3.0
+Requires-Dist: impit>=0.12.0
+Provides-Extra: dev
+Requires-Dist: httpx>=0.27; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# extendvcc
+
+[![CI](https://github.com/4LAU/extendvcc/actions/workflows/ci.yml/badge.svg)](https://github.com/4LAU/extendvcc/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/extendvcc-cli.svg)](https://pypi.org/project/extendvcc-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%20|%203.12%20|%203.13-blue.svg)](https://pypi.org/project/extendvcc-cli/)
+
+Unofficial CLI and Python client for the Extend virtual card API.
+
+> **Disclaimer**
+>
+> This is an unofficial, independent client for Extend's private browser
+> API (`api.paywithextend.com`). It is not affiliated with, endorsed by, or
+> supported by Extend, Inc. Use at your own risk. Your Extend account may be
+> suspended for running automation against their private API.
+
+## Install
+
+```bash
+pip install extendvcc-cli
+# or
+pipx install extendvcc-cli
+```
+
+Standalone binary (no Python required): download from [GitHub Releases](../../releases).
+
+## Quick Start
+
+```bash
+# Log in (interactive email + password, device remembered)
+extendvcc login
+
+# List parent cards
+extendvcc accounts
+
+# List virtual cards
+extendvcc cards
+```
+
+Enrolling a parent card is a three-step lifecycle: `extendvcc enroll ...` registers
+the card and triggers an issuer verification email, you click the link in that email,
+then `extendvcc activate <id>` pulls the card from PENDING to ACTIVE. Re-run `activate`
+if it still reports PENDING.
+
+## Create a One-Time Card
+
+```bash
+extendvcc create \
+  --credit-card-id cc_xxx \
+  --name "My Card" \
+  --balance-cents 5000 \
+  --valid-to 2026-12-31
+```
+
+## Create a Recurring Card
+
+```bash
+extendvcc create \
+  --credit-card-id cc_xxx \
+  --name "Monthly" \
+  --balance-cents 10000 \
+  --period MONTHLY \
+  --by-month-day 1 \
+  --terminator NONE
+```
+
+## Reveal Credentials
+
+```bash
+# Show masked card number and CVC on stdout
+extendvcc reveal <card-id>
+
+# Write full credentials to a file with 0600 permissions (owner-only)
+extendvcc reveal <card-id> --json-path creds.json
+```
+
+`--json-path` writes the full PAN, CVC, and expiry to a file. Without it, the card number is masked on stdout. `--json` is a separate global flag that controls JSON output format; it does not write a file.
+
+## Dry Run
+
+Destructive commands accept `--dry-run` to preview the exact operation without
+touching the network or mutating anything:
+
+```bash
+extendvcc create --credit-card-id cc_x --name "Test" --balance-cents 5000 --valid-to 2026-12-31 --dry-run
+extendvcc bulk cards.csv --credit-card-id cc_x --dry-run
+extendvcc cancel <card-id> --dry-run
+extendvcc close <card-id> --dry-run
+extendvcc update <card-id> --balance-cents 9000 --dry-run
+```
+
+The would-be request body (or operation descriptor) is printed as JSON to **stdout**;
+the human-readable plan goes to **stderr**. So `extendvcc create ... --dry-run > body.json`
+captures just the JSON. `create`/`bulk` resolve the recipient locally (from `--recipient`,
+else the saved session) and never call the API; the preview is labelled `approximate`
+when the recipient falls back to a placeholder. `update --dry-run` performs only the
+read-only GET needed to show the accurate merged PUT body, with no mutation.
+
+## Exit Codes
+
+The CLI uses stable exit codes so scripts and CI can branch on the outcome:
+
+| Code | Name           | Meaning                                                   |
+|------|----------------|-----------------------------------------------------------|
+| 0    | OK             | Success.                                                  |
+| 1    | ERROR          | Generic failure (library error, or an aborted confirmation). |
+| 2    | USAGE          | Bad flags or CLI input validation (e.g. missing `--valid-to`). |
+| 3    | AUTH_REQUIRED  | Login, OTP, or a saved session is required or failed.     |
+| 4    | DISABLED       | Kill switch tripped (account-risk); run `clear-disabled --manual`. |
+| 5    | API_ERROR      | Extend returned an error response.                        |
+
+## Environment Variables
+
+| Variable | Purpose |
+|---|---|
+| `EXTENDVCC_EMAIL` | Extend account email (overrides interactive prompt) |
+| `EXTENDVCC_PASSWORD` | Extend account password (overrides interactive prompt) |
+| `EXTENDVCC_IMAP_USER` | IMAP email for automatic OTP retrieval |
+| `EXTENDVCC_IMAP_PASSWORD` | IMAP app password |
+| `EXTENDVCC_IMAP_HOST` | IMAP server (default: `imap.gmail.com`) |
+| `EXTENDVCC_STATE_DIR` | Override session/state directory |
+| `EXTENDVCC_LEDGER_PATH` | Override ledger file path |
+| `EXTENDVCC_BRAND_ID` | Override Extend brand ID |
+
+## Python API
+
+```python
+from extendvcc import list_cards, get_card, create_card, reveal_card
+
+# List all virtual cards
+cards = list_cards()
+
+# Get a single card by ID
+card = get_card("card_id_here")
+
+# Reveal card credentials (PAN, CVC, expiry)
+creds = reveal_card("card_id_here")
+```
+
+See `extendvcc.__init__` for the full list of exported functions and models.
+
+## Security Notes
+
+- The ledger never stores PAN or CVC data.
+- `reveal` saves credentials with `0600` file permissions.
+- Session tokens are stored locally with restricted permissions.
+- All HTTP uses Chrome TLS fingerprinting via `impit`.
+
+## License
+
+[MIT](LICENSE)

extendvcc_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+extendvcc/__init__.py,sha256=ahjmpi5W7-veQdyqGlrZ73D8DC5TzGgzOd0-yGkxuDA,882
+extendvcc/_exit_codes.py,sha256=V2JmXpLmxoSqk62luxxRs5CN1h8KX68xW_kMgT1dJZI,1040
+extendvcc/_jsonl.py,sha256=Bp7MZKiWTFOTDE0HvAqF_-EXboA5MIy1i6t3CJ3oRGs,1245
+extendvcc/_paths.py,sha256=5EdfpXP93i0L-wUv7W2sP0UCEXHq0xER6vBpmmn1-x4,855
+extendvcc/auth.py,sha256=ZKJNmYREPPDm1d8l3a8Wwjof4DWwO0jj_SOhELiVd5A,31175
+extendvcc/cards.py,sha256=UmP3uX12en0qF9MrzfQ_dsq31pXCUJZZYfe430oyDkY,28503
+extendvcc/cli.py,sha256=KurtPKvp3hr-a6plGQ0fzAWkJ_qN-4mn_YoEYuC78FU,32704
+extendvcc/client.py,sha256=SnQPKOMystuxTwSDyQgbtDSP7XQ5NffqC2D660-mlyU,16044
+extendvcc/imap_otp.py,sha256=i6ZpVRMEYug-nXpvOaVBx5ZKBVwWKAPrGwW7n74rUk8,5681
+extendvcc/ledger.py,sha256=IAIQSkfZ8WUrb0Fa1uKanZEAob4aYQe_Ffb59F7sxz0,17504
+extendvcc/models.py,sha256=8vj-fgbvRqSkVA5MvgFtpjrPZGhrzda6ej1UETJUaaY,2010
+extendvcc/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+extendvcc_cli-0.1.0.dist-info/METADATA,sha256=QpdsmspPcLjG9p4HhGmPHusM8hhiUOvjRY6mr9PkEIw,6319
+extendvcc_cli-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+extendvcc_cli-0.1.0.dist-info/entry_points.txt,sha256=59idMYPsOCAeiK5DchQfQsB7ZCVl_3zu4CLVK2Remi0,49
+extendvcc_cli-0.1.0.dist-info/licenses/LICENSE,sha256=-vYwHs0375p9zy6wORoz-KfSRPpQnParuWoLNe0SB_M,1079
+extendvcc_cli-0.1.0.dist-info/RECORD,,

extendvcc_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

extendvcc_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+extendvcc = extendvcc.cli:main

extendvcc_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 extendvcc contributors
+
+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.