@cemalidev/trate 1.4.1

package/.env.example

@@ -0,0 +1,16 @@
+# trate Environment Configuration
+
+# API Configuration
+TRATE_API_URL=https://trate-api.cemali.dev/v1
+
+# Debug Mode (true/false)
+TRATE_DEBUG=false
+
+# Log Level (debug, info, warn, error)
+TRATE_LOG_LEVEL=info
+
+# Cache TTL in milliseconds (default: 300000 = 5 minutes)
+TRATE_CACHE_TTL=300000
+
+# API Timeout in milliseconds (default: 8000)
+TRATE_API_TIMEOUT=8000

package/.github/workflows/ci.yml

@@ -0,0 +1,61 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  lint-and-test:
+    name: Lint, Typecheck and Test
+    runs-on: ubuntu-latest
+    
+    strategy:
+      matrix:
+        node-version: [20.x, 22.x]
+    
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run ESLint
+        run: npm run lint
+
+      - name: Run TypeScript typecheck
+        run: npm run typecheck
+
+      - name: Run tests
+        run: npm test -- --run
+
+      - name: Run build
+        run: npm run build
+
+  coverage:
+    name: Coverage
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests with coverage
+        run: npm run test:coverage

package/.github/workflows/cleanup.yml

@@ -0,0 +1,36 @@
+name: Cleanup Old Versions
+
+on:
+  workflow_dispatch:
+
+jobs:
+  deprecate:
+    name: Deprecate old versions
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Deprecate old versions
+        run: |
+          curl -X PUT \
+            -H "Authorization: Bearer ${{ secrets.NPM_TOKEN }}" \
+            -H "Content-Type: application/json" \
+            -d '{"deprecated": "Please use v1.4.0 or later"}' \
+            "https://registry.npmjs.org/@cemalidev/trate/1.0.0"
+
+          curl -X PUT \
+            -H "Authorization: Bearer ${{ secrets.NPM_TOKEN }}" \
+            -H "Content-Type: application/json" \
+            -d '{"deprecated": "Please use v1.4.0 or later"}' \
+            "https://registry.npmjs.org/@cemalidev/trate/1.0.1"
+
+          curl -X PUT \
+            -H "Authorization: Bearer ${{ secrets.NPM_TOKEN }}" \
+            -H "Content-Type: application/json" \
+            -d '{"deprecated": "Please use v1.4.0 or later"}' \
+            "https://registry.npmjs.org/@cemalidev/trate/1.0.2"
+
+          curl -X PUT \
+            -H "Authorization: Bearer ${{ secrets.NPM_TOKEN }}" \
+            -H "Content-Type: application/json" \
+            -d '{"deprecated": "Please use v1.4.0 or later"}' \
+            "https://registry.npmjs.org/@cemalidev/trate/1.0.3"

package/.github/workflows/release.yml

@@ -0,0 +1,56 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+          cache: 'npm'
+          registry-url: 'https://registry.npmjs.org'
+          scope: '@cemalidev'
+
+      - name: Set tag version in package.json
+        run: |
+          TAG_VERSION=${GITHUB_REF#refs/tags/v}
+          sed -i "s/\"version\": \".*\"/\"version\": \"$TAG_VERSION\"/" package.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test -- --run
+
+      - name: Build
+        run: npm run build
+
+      - name: Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create GitHub Release
+        run: |
+          gh release create ${{ github.ref_name }} \
+            --title "Release ${{ github.ref_name }}" \
+            --notes "See CHANGELOG.md for details" \
+            dist/**
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+npx lint-staged

package/.prettierrc

@@ -0,0 +1,10 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "arrowParens": "avoid",
+  "endOfLine": "lf"
+}

package/CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Multi-language support (English, Turkish, German, French, Spanish)
+- System language auto-detection
+- `set-lang` command for manual language selection
+- Graceful shutdown handling (SIGINT/SIGTERM)
+- Error handling with `TrateError` class
+- Logging utility with levels (debug, info, warn, error)
+- Vitest testing framework with 44 tests
+- ESLint and Prettier configuration
+- GitHub Actions CI/CD workflows
+- Test coverage reporting
+
+### Changed
+- Refactored all hardcoded strings to use i18n system
+- Updated config system to support locale preference
+- Improved TypeScript strict mode compliance
+
+### Fixed
+- Removed unused React configuration from tsconfig.json
+- Added missing `@types/figlet` dev dependency
+- Fixed in-memory cache type safety
+
+## [0.1.0] - Initial Release
+
+### Added
+- Basic currency conversion (fiat, crypto, metals, Turkish gold)
+- Favorites dashboard
+- Configuration persistence with `conf` package
+- Multiple API fallbacks
+- ASCII art logo
+- 5-minute API cache

package/CONTRIBUTING.md

@@ -0,0 +1,120 @@
+# Contributing to trate
+
+Thank you for your interest in contributing to trate!
+
+## Development Setup
+
+1. Fork the repository
+2. Clone your fork:
+   ```bash
+   git clone https://github.com/YOUR_USERNAME/trate.git
+   cd trate
+   ```
+3. Install dependencies:
+   ```bash
+   npm install
+   ```
+4. Create a branch for your changes:
+   ```bash
+   git checkout -b feature/my-new-feature
+   ```
+
+## Development Workflow
+
+### Code Style
+
+We use ESLint and Prettier for code formatting:
+
+```bash
+# Check lint
+npm run lint
+
+# Auto-fix lint issues
+npm run lint:fix
+
+# Format with Prettier
+npx prettier --write src tests
+```
+
+### Testing
+
+All new features should include tests:
+
+```bash
+# Run tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+
+# Run tests with coverage
+npm run test:coverage
+```
+
+### Type Safety
+
+We use TypeScript with strict mode:
+
+```bash
+npm run typecheck
+```
+
+### Building
+
+```bash
+npm run build
+```
+
+## Commit Messages
+
+We follow [Conventional Commits](https://www.conventionalcommits.org/):
+
+- `feat:` New feature
+- `fix:` Bug fix
+- `docs:` Documentation changes
+- `style:` Code style changes (formatting, etc.)
+- `refactor:` Code refactoring
+- `test:` Adding or updating tests
+- `chore:` Build process or auxiliary tool changes
+
+Example:
+```
+feat: add Spanish translation
+fix: handle network timeout gracefully
+docs: update README with new commands
+```
+
+## Pull Request Process
+
+1. Update the README.md if you add new features
+2. Update CHANGELOG.md under "Unreleased"
+3. Ensure all tests pass
+4. Ensure lint passes
+5. Update the version in package.json if applicable
+6. The PR will be reviewed and merged
+
+## Adding Translations
+
+To add a new language:
+
+1. Create a new file in `src/i18n/` (e.g., `pt.ts`)
+2. Copy the structure from `en.ts`
+3. Translate all strings
+4. Update `src/i18n/index.ts`:
+   - Add to imports
+   - Add to `translations` object
+   - Add to `supportedLocales` array
+5. Add tests for the new language
+
+## Reporting Issues
+
+Please include:
+- Node.js version
+- Operating system
+- Steps to reproduce
+- Expected vs actual behavior
+- Error messages if applicable
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Trate
+
+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,140 @@
+# Trate
+
+> Terminal-based currency tracker - convert fiat, crypto, and precious metals instantly.
+
+[![CI](https://github.com/cemalidev/trate/actions/workflows/ci.yml/badge.svg)](https://github.com/cemalidev/trate/actions)
+[![npm version](https://img.shields.io/npm/v/trate.svg)](https://www.npmjs.com/package/trate)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
+
+## Features
+
+- **Multi-currency support**: Fiat, cryptocurrency, and precious metals
+- **Real-time rates**: Live exchange rates from multiple APIs
+- **Favorites dashboard**: Track your favorite currencies
+- **Multi-language**: English, Turkish, German, French, Spanish
+- **Fast & lightweight**: Built with TypeScript and esbuild
+
+## Quick Start
+
+### Install
+
+```bash
+npm install -g @cemalidev/trate
+```
+
+### Usage
+
+```bash
+# Convert currency
+trate 100 usd try
+
+# Quick rate lookup
+trate btc
+
+# List favorites
+trate list
+```
+
+## Supported Currencies
+
+| Type             | Examples                                                                            |
+| ---------------- | ----------------------------------------------------------------------------------- |
+| **Fiat**         | USD, EUR, GBP, JPY, CHF, CAD, AUD, NZD, CNY, HKD, SGD, INR, RUB, TRY, BRL, ZAR, MXN |
+| **Crypto**       | BTC, ETH, SOL, BNB, XRP, ADA, DOGE, DOT, AVAX, MATIC, LINK, UNI, LTC, ATOM          |
+| **Metals**       | ONS (Gold), GRAM_ALTIN (Gram Gold), GUMUS_OZ (Silver)                               |
+| **Turkish Gold** | CEYREK_ALTIN, YARIM_ALTIN, TAM_ALTIN, ATA_ALTIN                                     |
+
+## Commands
+
+| Command                      | Description                          |
+| ---------------------------- | ------------------------------------ |
+| `trate <amount> <from> <to>` | Convert currency                     |
+| `trate <currency>`           | Quick rate lookup                    |
+| `trate set-base <currency>`  | Set base currency                    |
+| `trate add <currency>`       | Add to favorites                     |
+| `trate remove <currency>`    | Remove from favorites                |
+| `trate list`                 | Show favorites dashboard             |
+| `trate set-lang <lang>`      | Change language (tr, en, de, fr, es) |
+| `trate refresh`              | Clear cache                          |
+| `trate help`                 | Show help                            |
+
+## Custom Aliases
+
+Create shortcuts for currencies you use frequently:
+
+```bash
+# Add alias
+trate alias add ceyrek CEYREK_ALTIN
+trate alias add gram ALTIN_KG
+trate alias add gumus GUMUS_OZ
+
+# Use alias in conversions
+trate 100 usd ceyrek    # 100 USD → CEYREK_ALTIN
+trate ceyrek            # Quick rate lookup
+
+# List all aliases
+trate alias list
+
+# Remove alias
+trate alias remove ceyrek
+```
+
+| Command                        | Description      |
+| ------------------------------ | ---------------- |
+| `trate alias list`             | List all aliases |
+| `trate alias add <alias> <to>` | Add alias        |
+| `trate alias remove <alias>`   | Remove alias     |
+
+## Installation from Source
+
+```bash
+git clone https://github.com/cemalidev/trate.git
+cd trate
+npm install
+npm run build
+npm link
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Lint
+npm run lint
+
+# Type check
+npm run typecheck
+```
+
+## Language Support
+
+| Language | Code |
+| -------- | ---- |
+| Türkçe   | `tr` |
+| English  | `en` |
+| Deutsch  | `de` |
+| Français | `fr` |
+| Español  | `es` |
+
+Change language with `trate set-lang <code>`
+
+## Architecture
+
+See [ARCHITECTURE.md](docs/ARCHITECTURE.md) for technical details.
+
+## Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](docs/CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

package/build.cjs

@@ -0,0 +1,27 @@
+const esbuild = require('esbuild');
+const fs = require('fs');
+
+async function build() {
+  await esbuild.build({
+    entryPoints: ['src/index.ts'],
+    bundle: true,
+    platform: 'node',
+    target: 'node18',
+    outfile: 'dist/index.js',
+    external: ['commander', 'conf', 'node-fetch', 'figlet', 'inquirer'],
+    format: 'esm',
+    sourcemap: false,
+    minify: false,
+    banner: {
+      js: '#!/usr/bin/env node',
+    },
+  });
+
+  fs.chmodSync('dist/index.js', '755');
+  console.log('Build complete!');
+}
+
+build().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});