.env.example

# Zoho Inventory CLI environment variables.
# Copy to `.env` (gitignored) and fill in values, or set them in the shell.

# --- Auth: option A (recommended) — OAuth refresh flow ---
# The CLI exchanges this refresh token for a short-lived access token on each
# run (cached on disk) and sends `Authorization: Zoho-oauthtoken <token>`.
# Refresh tokens never expire; access tokens last ~1 hour.

# @required
# @how-to-get https://www.zoho.com/inventory/api/v1/oauth/  (Self Client → Generate refresh token; scope ZohoInventory.fullaccess.all)
# @format Zoho refresh token (starts with "1000.")
# @validation-command organizations list
ZOHO_INVENTORY_API_KEY=your_zoho_inventory_api_key_here
# Use ZOHO_INVENTORY_API_KEY only if you want to paste a static access token
# (expires hourly). Prefer the refresh-token trio below.

# @required
# @how-to-get Same Self Client used to mint the refresh token.
ZOHO_INVENTORY_REFRESH_TOKEN=your_zoho_refresh_token_here

# @required
ZOHO_INVENTORY_CLIENT_ID=1000.your_client_id_here

# @required
ZOHO_INVENTORY_CLIENT_SECRET=your_client_secret_here

# --- Required everywhere ---
# Organization id (from Zoho Inventory → Settings → Manage Organizations).
# Auto-injected as `?organization_id=` on every request.
# @required
ZOHO_INVENTORY_ORG_ID=your_organization_id_here

# --- Datacenter routing ---
# Datacenter for the Zoho account: com | eu | in | com.au | jp | ca | com.cn | sa
# Picks the base URL https://www.zohoapis.<dc>/inventory/v1 and the matching
# accounts.zoho.<dc> for OAuth refresh. Default: com.
ZOHO_INVENTORY_DC=in

# --- Test / mock override ---
# @optional
# @validation-command organizations list
# Overrides the API base URL — used by integration tests to point at a mock server.
# ZOHO_INVENTORY_BASE_URL=http://127.0.0.1:3000

# @optional
# Overrides the OAuth accounts URL. Rarely needed; tests can point this at a mock.
# ZOHO_INVENTORY_ACCOUNTS_URL=http://127.0.0.1:3001

# @optional
# Stateless mode: do not read/write ~/.config/zoho-inventory-cli/credentials.json.
# ZOHO_INVENTORY_NO_CACHE=1

# @optional
# Full OAuth token URL override for tests or non-standard routing.
# ZOHO_INVENTORY_TOKEN_URL=http://127.0.0.1:3001/oauth/v2/token