Initial commit

Author: karroch-a

.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [16.x, 18.x, 20.x]
+
+    steps:
+      - uses: actions/checkout@v3
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v3
+        with:
+          node-version: ${{ matrix.node-version }}
+      - run: npm ci
+      - run: npm run build
+      - run: npm test

.gitignore

@@ -0,0 +1,29 @@
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+dist/
+*.tsbuildinfo
+
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+
+coverage/
+
+.env
+.env.local
+.env.*.local
+
+# Logs
+logs/
+*.log
+
+.npm
+
+.eslintcache
+
+.node_repl_history 

README.md

@@ -0,0 +1,43 @@
+# Country Flags Converter
+
+Convert ISO 3166-1 country codes to flag emojis. Simple and lightweight.
+
+## Installation
+
+```bash
+npm install @karroch/country-flags-emoji
+```
+
+## Usage
+
+```typescript
+import { countryFlags } from "@karroch/country-flags-emoji";
+
+// Convert country codes to flags
+console.log(countryFlags("US")); // 🇺🇸
+console.log(countryFlags("MA")); // 🇲🇦
+console.log(countryFlags("GB")); // 🇬🇧
+console.log(countryFlags("ES")); // 🇪🇸
+```
+
+## API
+
+### `countryFlags(countryCode: string): string`
+
+Converts a two-letter country code to its corresponding emoji flag.
+
+- `countryCode`: A two-letter ISO 3166-1 country code (case insensitive)
+- Returns: The emoji flag representation
+- Throws: Error if input is invalid
+
+## Features
+
+- TypeScript support
+- Zero dependencies
+- Lightweight
+- Case insensitive
+- Input validation
+
+## License
+
+MIT © [Your Name]

jest.config.js

@@ -0,0 +1,9 @@
+module.exports = {
+  preset: "ts-jest",
+  testEnvironment: "node",
+  testMatch: ["**/*.test.ts"],
+  moduleFileExtensions: ["ts", "js"],
+  transform: {
+    "^.+\\.ts$": "ts-jest",
+  },
+};