bodrumtaxi 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Taximatic
+
+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,470 @@
+# bodrumtaxi
+
+> A lightweight Node.js toolkit for **Bodrum taxi & transfer** information and **estimated** fare calculations across the Bodrum peninsula.
+
+[![npm version](https://img.shields.io/npm/v/bodrumtaxi.svg)](https://www.npmjs.com/package/bodrumtaxi)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+[![node](https://img.shields.io/node/v/bodrumtaxi.svg)](https://nodejs.org)
+
+🌐 **Website:** [bodrumtaxi.pages.dev](https://bodrumtaxi.pages.dev)
+
+---
+
+## Why this package?
+
+Planning a trip to Bodrum, Türkiye? Whether you are landing at **Milas-Bodrum Airport (BJV)** and need a transfer to your hotel in Yalıkavak, building a travel app, or just curious how much a ride from Bodrum Center to Turgutreis might cost — `bodrumtaxi` gives you a tiny, dependency-free helper to:
+
+- Look up basic information about Bodrum taxi & transfer services.
+- Get the list of popular destinations across the peninsula.
+- Compute a **rough fare estimate** between any two supported locations.
+- Use it from code (CommonJS / ESM-interop) or directly from the command line.
+
+The package is intentionally small (under 100 lines of logic, **zero dependencies**), so it loads instantly and is safe to embed anywhere — serverless functions, chatbots, travel widgets, CLI tools, or static-site build steps.
+
+---
+
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [API Reference](#api-reference)
+  - [`info()`](#info)
+  - [`services()`](#services)
+  - [`locations()`](#locations)
+  - [`transferPrice(from, to)`](#transferpricefrom-to)
+  - [Constants](#constants)
+- [How pricing works](#how-pricing-works)
+- [Supported locations](#supported-locations)
+- [CLI usage](#cli-usage)
+- [Examples](#examples)
+- [Error handling](#error-handling)
+- [About Bodrum](#about-bodrum)
+- [Disclaimer](#disclaimer)
+- [Roadmap](#roadmap)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+## Features
+
+- ✅ **Zero dependencies** — installs in milliseconds, ships in ~3 KB.
+- ✅ **Synchronous API** — every function returns a plain object/array, no promises required.
+- ✅ **Diacritic-tolerant lookups** — `"yalıkavak"`, `"Yalikavak"`, and `"YALIKAVAK"` all match.
+- ✅ **Bidirectional distance lookup** — `A → B` and `B → A` resolve from a single table entry.
+- ✅ **CLI mode** — runnable with `node node_modules/bodrumtaxi` for a quick overview.
+- ✅ **Transparent pricing** — base fare, per-km rate and currency are exposed as exported constants.
+- ✅ **Node.js 14+** — works on every actively supported runtime.
+
+---
+
+## Installation
+
+```bash
+npm install bodrumtaxi
+```
+
+or with Yarn / pnpm:
+
+```bash
+yarn add bodrumtaxi
+pnpm add bodrumtaxi
+```
+
+---
+
+## Quick Start
+
+```javascript
+const bodrumtaxi = require('bodrumtaxi');
+
+// 1. Basic service info
+console.log(bodrumtaxi.info().website);
+// → 'https://bodrumtaxi.pages.dev'
+
+// 2. List services
+console.log(bodrumtaxi.services());
+// → [ 'Airport Transfer (Milas-Bodrum)', 'City Taxi', 'VIP Transfer', ... ]
+
+// 3. Estimate a fare
+const fare = bodrumtaxi.transferPrice('Milas-Bodrum Airport', 'Yalıkavak');
+console.log(`${fare.distanceKm} km — ~${fare.estimatedPrice} ${fare.currency}`);
+// → '65 km — ~1825 TRY'
+```
+
+---
+
+## API Reference
+
+All functions are **synchronous** and return plain JavaScript values. There are no side effects and no network calls.
+
+### `info()`
+
+Returns a snapshot of the service.
+
+```javascript
+bodrumtaxi.info();
+// {
+//   name: 'Bodrum Taxi',
+//   website: 'https://bodrumtaxi.pages.dev',
+//   region: 'Bodrum, Muğla, Türkiye',
+//   availability: '24/7',
+//   description: 'Bodrum peninsula taxi and transfer services: airport transfers, ...'
+// }
+```
+
+| Field          | Type     | Description                                            |
+| -------------- | -------- | ------------------------------------------------------ |
+| `name`         | `string` | Brand name.                                            |
+| `website`      | `string` | Canonical URL of the service.                          |
+| `region`       | `string` | Operational region.                                    |
+| `availability` | `string` | Operating hours (always `'24/7'`).                     |
+| `description`  | `string` | One-sentence summary of the offering.                  |
+
+---
+
+### `services()`
+
+Returns the list of service categories.
+
+```javascript
+bodrumtaxi.services();
+// [
+//   'Airport Transfer (Milas-Bodrum)',
+//   'City Taxi',
+//   'VIP Transfer',
+//   'Hotel Transfer',
+//   'Boat / Marina Transfer',
+//   'Intercity Transfer'
+// ]
+```
+
+**Returns:** `string[]` — six service categories, ordered from most-requested to least.
+
+---
+
+### `locations()`
+
+Returns every location supported by the pricing engine.
+
+```javascript
+bodrumtaxi.locations();
+// [
+//   'Milas-Bodrum Airport',
+//   'Bodrum Center',
+//   'Gümbet',
+//   'Bitez',
+//   'Ortakent',
+//   'Yalıkavak',
+//   'Türkbükü',
+//   'Göltürkbükü',
+//   'Turgutreis',
+//   'Gündoğan',
+//   'Akyarlar',
+//   'Yalı'
+// ]
+```
+
+**Returns:** `string[]` — canonical names. You can pass *any* casing or any (de)diacriticised variant to `transferPrice` and it will still match.
+
+---
+
+### `transferPrice(from, to)`
+
+Estimate the fare between two locations.
+
+```javascript
+bodrumtaxi.transferPrice('Milas-Bodrum Airport', 'Yalıkavak');
+// {
+//   from: 'Milas-Bodrum Airport',
+//   to: 'Yalıkavak',
+//   distanceKm: 65,
+//   estimatedPrice: 1825,
+//   currency: 'TRY',
+//   note: 'Estimated fare. For an exact quote visit https://bodrumtaxi.pages.dev'
+// }
+```
+
+**Parameters**
+
+| Name   | Type     | Description                                      |
+| ------ | -------- | ------------------------------------------------ |
+| `from` | `string` | Origin location name (case/diacritic insensitive). |
+| `to`   | `string` | Destination location name.                       |
+
+**Returns** an object with:
+
+| Field            | Type     | Description                                                  |
+| ---------------- | -------- | ------------------------------------------------------------ |
+| `from`           | `string` | The origin you passed in (echoed back, untouched).           |
+| `to`             | `string` | The destination you passed in.                               |
+| `distanceKm`     | `number` | Approximate road distance in kilometres.                     |
+| `estimatedPrice` | `number` | `BASE_FARE + (distanceKm × PER_KM)` in TRY.                  |
+| `currency`       | `string` | Always `'TRY'` in v1.                                        |
+| `note`           | `string` | Reminder that this is an estimate, plus a link to the site.  |
+
+**Failure mode** — when either name cannot be resolved, the function returns:
+
+```javascript
+{
+  error: true,
+  message: 'Location not found: "Mars" → "Yalıkavak". Use locations() to list supported names.'
+}
+```
+
+> Calling `transferPrice('Bodrum Center', 'Bodrum Center')` returns a valid result with `distanceKm: 0` and `estimatedPrice: 200` (the base fare).
+
+---
+
+### Constants
+
+For full transparency, the pricing constants and version are exported:
+
+```javascript
+const { BASE_FARE, PER_KM, CURRENCY, VERSION } = require('bodrumtaxi');
+console.log(BASE_FARE); // 200
+console.log(PER_KM);    // 25
+console.log(CURRENCY);  // 'TRY'
+console.log(VERSION);   // '1.0.0'
+```
+
+---
+
+## How pricing works
+
+The fare formula is intentionally simple and easy to audit:
+
+```
+estimatedPrice = BASE_FARE + (distanceKm × PER_KM)
+```
+
+| Constant    | Value    | Meaning                                       |
+| ----------- | -------- | --------------------------------------------- |
+| `BASE_FARE` | `200`    | Pickup / start charge in TRY                  |
+| `PER_KM`    | `25`     | Per-kilometre cost in TRY                     |
+| `CURRENCY`  | `'TRY'`  | Turkish Lira                                  |
+
+Distances are stored in a hand-curated lookup table built from typical road routes across the Bodrum peninsula. Lookups are bidirectional — only one direction needs to be in the table for both `A → B` and `B → A` to resolve.
+
+This is **not** a routing engine and does **not** factor in:
+
+- Real-time traffic
+- Time of day / night surcharge
+- Vehicle class (sedan, minibus, VIP)
+- Tolls or seasonal price changes
+- Number of passengers or luggage
+
+Treat the returned `estimatedPrice` as a rough order-of-magnitude figure, not a quote.
+
+---
+
+## Supported locations
+
+Approximate road distances used by the engine:
+
+| Route                                  | Distance |
+| -------------------------------------- | -------- |
+| Milas-Bodrum Airport → Bodrum Center   | 36 km    |
+| Milas-Bodrum Airport → Gümbet          | 38 km    |
+| Milas-Bodrum Airport → Bitez           | 40 km    |
+| Milas-Bodrum Airport → Ortakent        | 42 km    |
+| Milas-Bodrum Airport → Yalı            | 45 km    |
+| Milas-Bodrum Airport → Gündoğan        | 48 km    |
+| Milas-Bodrum Airport → Türkbükü        | 50 km    |
+| Milas-Bodrum Airport → Göltürkbükü     | 52 km    |
+| Milas-Bodrum Airport → Turgutreis      | 55 km    |
+| Milas-Bodrum Airport → Akyarlar        | 60 km    |
+| Milas-Bodrum Airport → Yalıkavak       | 65 km    |
+| Bodrum Center      → Gümbet            | 3 km     |
+| Bodrum Center      → Bitez             | 6 km     |
+| Bodrum Center      → Ortakent          | 10 km    |
+| Bodrum Center      → Yalı              | 12 km    |
+| Bodrum Center      → Gündoğan          | 14 km    |
+| Bodrum Center      → Türkbükü          | 16 km    |
+| Bodrum Center      → Yalıkavak         | 18 km    |
+| Bodrum Center      → Göltürkbükü       | 18 km    |
+| Bodrum Center      → Turgutreis        | 20 km    |
+| Bodrum Center      → Akyarlar          | 25 km    |
+
+Need a route that is not in the table? [Open an issue](https://bodrumtaxi.pages.dev) and we will add it in a minor release.
+
+---
+
+## CLI usage
+
+After installing the package you can invoke it directly:
+
+```bash
+node node_modules/bodrumtaxi
+```
+
+You will see a friendly summary like:
+
+```
+===================================
+  bodrumtaxi v1.0.0
+  Bodrum Taxi & Transfer
+===================================
+Website: https://bodrumtaxi.pages.dev
+
+Services:
+  - Airport Transfer (Milas-Bodrum)
+  - City Taxi
+  - VIP Transfer
+  - Hotel Transfer
+  - Boat / Marina Transfer
+  - Intercity Transfer
+
+Sample fare (Airport → Yalıkavak):
+  65 km, ~1825 TRY
+
+API: info(), services(), locations(), transferPrice(from, to)
+```
+
+---
+
+## Examples
+
+### Build a tiny "fare of the day" widget
+
+```javascript
+const { transferPrice, locations } = require('bodrumtaxi');
+
+const all = locations();
+const from = 'Milas-Bodrum Airport';
+const to = all[Math.floor(Math.random() * all.length)];
+
+const fare = transferPrice(from, to);
+if (fare.error) {
+  console.error(fare.message);
+} else {
+  console.log(`Today's pick: ${from} → ${to} ≈ ${fare.estimatedPrice} ${fare.currency}`);
+}
+```
+
+### List every airport-departure fare, sorted
+
+```javascript
+const { transferPrice, locations } = require('bodrumtaxi');
+
+const fares = locations()
+  .filter(loc => loc !== 'Milas-Bodrum Airport')
+  .map(to => transferPrice('Milas-Bodrum Airport', to))
+  .filter(f => !f.error)
+  .sort((a, b) => a.estimatedPrice - b.estimatedPrice);
+
+for (const f of fares) {
+  console.log(`${f.to.padEnd(20)} ${f.distanceKm.toString().padStart(3)} km   ~${f.estimatedPrice} ${f.currency}`);
+}
+```
+
+### Use it inside an Express endpoint
+
+```javascript
+const express = require('express');
+const { transferPrice } = require('bodrumtaxi');
+
+const app = express();
+
+app.get('/fare', (req, res) => {
+  const { from, to } = req.query;
+  const result = transferPrice(from, to);
+  if (result.error) return res.status(400).json(result);
+  return res.json(result);
+});
+
+app.listen(3000);
+```
+
+### Forgiving input (diacritics & casing)
+
+```javascript
+const { transferPrice } = require('bodrumtaxi');
+
+transferPrice('milas-bodrum airport', 'YALIKAVAK').distanceKm; // 65
+transferPrice('Yalıkavak', 'Milas-Bodrum Airport').distanceKm; // 65 (reverse)
+transferPrice('  Bodrum Center  ', 'gumbet').distanceKm;       // 3
+```
+
+---
+
+## Error handling
+
+`transferPrice` never throws. On unrecognised input it returns an error-shaped object instead, so you can branch with a simple `if`:
+
+```javascript
+const result = transferPrice('Atlantis', 'Bitez');
+if (result.error) {
+  // Handle gracefully — show suggestions, log, fall back, etc.
+  console.warn(result.message);
+} else {
+  // Happy path
+  renderQuote(result);
+}
+```
+
+This shape was chosen so the function can be used safely inside `Array.prototype.map` and other pipelines without try/catch noise.
+
+---
+
+## About Bodrum
+
+[Bodrum](https://en.wikipedia.org/wiki/Bodrum) is a coastal town and district in Muğla Province on Türkiye's southwestern Aegean coast. It sits across from the Greek island of Kos and is known for its castle, marina, vibrant nightlife and the surrounding peninsula villages — Yalıkavak, Türkbükü, Bitez, Gümbet, Turgutreis and more — each with its own character.
+
+Most international visitors arrive at **Milas-Bodrum Airport (IATA: BJV)**, located about 36 km north of Bodrum Center. From there, the most common onward transport is a **pre-booked taxi or transfer**, which is exactly the use case this package was built around.
+
+---
+
+## Disclaimer
+
+This package is an **independent open-source utility**. The fare formula and distance table are best-effort approximations and **do not constitute a price quote**. Real-world pricing varies with:
+
+- Vehicle type and capacity
+- Time of day and seasonal demand
+- Traffic and route choice
+- Tolls, luggage handling and waiting time
+- Local regulations and operator pricing
+
+For an accurate, bookable quote please visit **[bodrumtaxi.pages.dev](https://bodrumtaxi.pages.dev)**.
+
+---
+
+## Roadmap
+
+Possible future additions (no commitments):
+
+- 🌍 Additional Bodrum peninsula villages and stops.
+- 💱 Currency conversion helper (`EUR`, `USD`, `GBP`).
+- 🌙 Night-tariff and seasonal multipliers.
+- 🛣️ Distance lookup as a standalone export.
+- 📦 ESM build alongside CommonJS.
+- 🧪 Test suite with `vitest` once the API stabilises.
+
+If any of these would be useful to you, please open a feature request on the [website](https://bodrumtaxi.pages.dev).
+
+---
+
+## Contributing
+
+Bug reports, distance corrections and new locations are very welcome. Because the package is tiny, contributions usually consist of:
+
+1. Adding or correcting a row in the internal `_DISTANCES` table.
+2. Updating the documentation table above to match.
+3. Bumping the patch version.
+
+Please keep the package **dependency-free** — that is a deliberate design constraint.
+
+---
+
+## License
+
+[MIT](./LICENSE) © 2026 [Taximatic](https://bodrumtaxi.pages.dev)
+
+---
+
+## Links
+
+- 🌐 Website: [bodrumtaxi.pages.dev](https://bodrumtaxi.pages.dev)
+- 📦 npm: [npmjs.com/package/bodrumtaxi](https://www.npmjs.com/package/bodrumtaxi)
+- 🧶 Yarn: [yarnpkg.com/package/bodrumtaxi](https://yarnpkg.com/package/bodrumtaxi)

package/index.js

@@ -0,0 +1,169 @@
+// bodrumtaxi - Bodrum taxi & transfer module
+// Information lookup and estimated transfer pricing for the Bodrum peninsula.
+// https://bodrumtaxi.pages.dev
+
+'use strict';
+
+const SITE = 'https://bodrumtaxi.pages.dev';
+const VERSION = '1.0.0';
+
+// ----- Constants -----
+
+const BASE_FARE = 200;   // TRY
+const PER_KM = 25;       // TRY per km
+const CURRENCY = 'TRY';
+
+// ----- Public: information -----
+
+function info() {
+  return {
+    name: 'Bodrum Taxi',
+    website: SITE,
+    region: 'Bodrum, Muğla, Türkiye',
+    availability: '24/7',
+    description:
+      'Bodrum peninsula taxi and transfer services: airport transfers, ' +
+      'city rides, hotel pickups, marina transfers and VIP transport.'
+  };
+}
+
+function services() {
+  return [
+    'Airport Transfer (Milas-Bodrum)',
+    'City Taxi',
+    'VIP Transfer',
+    'Hotel Transfer',
+    'Boat / Marina Transfer',
+    'Intercity Transfer'
+  ];
+}
+
+function locations() {
+  return [
+    'Milas-Bodrum Airport',
+    'Bodrum Center',
+    'Gümbet',
+    'Bitez',
+    'Ortakent',
+    'Yalıkavak',
+    'Türkbükü',
+    'Göltürkbükü',
+    'Turgutreis',
+    'Gündoğan',
+    'Akyarlar',
+    'Yalı'
+  ];
+}
+
+// ----- Internal: location matching -----
+
+function _normalize(s) {
+  if (typeof s !== 'string') return '';
+  return s
+    .toLowerCase()
+    .trim()
+    .replace(/ı/g, 'i')
+    .replace(/ş/g, 's')
+    .replace(/ğ/g, 'g')
+    .replace(/ü/g, 'u')
+    .replace(/ö/g, 'o')
+    .replace(/ç/g, 'c')
+    .replace(/[^a-z0-9]/g, '');
+}
+
+// Distances in km. Keys: normalized "from|to". Lookups try both directions.
+const _DISTANCES = {
+  // From Milas-Bodrum Airport
+  'milasbodrumairport|bodrumcenter': 36,
+  'milasbodrumairport|gumbet': 38,
+  'milasbodrumairport|bitez': 40,
+  'milasbodrumairport|ortakent': 42,
+  'milasbodrumairport|yalikavak': 65,
+  'milasbodrumairport|turkbuku': 50,
+  'milasbodrumairport|golturkbuku': 52,
+  'milasbodrumairport|turgutreis': 55,
+  'milasbodrumairport|gundogan': 48,
+  'milasbodrumairport|akyarlar': 60,
+  'milasbodrumairport|yali': 45,
+  // From Bodrum Center
+  'bodrumcenter|gumbet': 3,
+  'bodrumcenter|bitez': 6,
+  'bodrumcenter|ortakent': 10,
+  'bodrumcenter|yalikavak': 18,
+  'bodrumcenter|turkbuku': 16,
+  'bodrumcenter|golturkbuku': 18,
+  'bodrumcenter|turgutreis': 20,
+  'bodrumcenter|gundogan': 14,
+  'bodrumcenter|akyarlar': 25,
+  'bodrumcenter|yali': 12
+};
+
+function _distanceBetween(a, b) {
+  const na = _normalize(a);
+  const nb = _normalize(b);
+  if (!na || !nb) return null;
+  if (na === nb) return 0;
+  return _DISTANCES[na + '|' + nb] ?? _DISTANCES[nb + '|' + na] ?? null;
+}
+
+// ----- Public: pricing -----
+
+/**
+ * Estimate the transfer price between two Bodrum locations.
+ *
+ * @param {string} from - origin location name
+ * @param {string} to   - destination location name
+ * @returns {object} a price object on success, or `{ error: true, message }` on failure.
+ */
+function transferPrice(from, to) {
+  const km = _distanceBetween(from, to);
+  if (km === null) {
+    return {
+      error: true,
+      message:
+        'Location not found: "' + from + '" → "' + to +
+        '". Use locations() to list supported names.'
+    };
+  }
+  return {
+    from: from,
+    to: to,
+    distanceKm: km,
+    estimatedPrice: BASE_FARE + (km * PER_KM),
+    currency: CURRENCY,
+    note: 'Estimated fare. For an exact quote visit ' + SITE
+  };
+}
+
+// ----- Exports -----
+
+module.exports = {
+  info,
+  services,
+  locations,
+  transferPrice,
+  // pricing constants exposed for transparency
+  BASE_FARE,
+  PER_KM,
+  CURRENCY,
+  VERSION
+};
+
+// ----- CLI mode -----
+
+if (require.main === module) {
+  console.log('===================================');
+  console.log('  bodrumtaxi v' + VERSION);
+  console.log('  Bodrum Taxi & Transfer');
+  console.log('===================================');
+  console.log('Website: ' + SITE);
+  console.log('');
+  console.log('Services:');
+  services().forEach(function (s) { console.log('  - ' + s); });
+  console.log('');
+  console.log('Sample fare (Airport → Yalıkavak):');
+  const sample = transferPrice('Milas-Bodrum Airport', 'Yalıkavak');
+  console.log('  ' + sample.distanceKm + ' km, ~' + sample.estimatedPrice + ' ' + sample.currency);
+  console.log('');
+  console.log('API: info(), services(), locations(), transferPrice(from, to)');
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "bodrumtaxi",
+  "version": "1.0.0",
+  "description": "Bodrum taxi & transfer toolkit — service info, supported locations, and estimated transfer pricing for the Bodrum peninsula.",
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "node index.js",
+    "test": "node -e \"const m=require('./index.js'); console.log(m.info()); console.log(m.transferPrice('Milas-Bodrum Airport','Yalıkavak'));\""
+  },
+  "keywords": [
+    "bodrum",
+    "taxi",
+    "transfer",
+    "airport",
+    "milas",
+    "yalikavak",
+    "turgutreis",
+    "vip",
+    "shuttle",
+    "fare",
+    "estimate",
+    "turkey"
+  ],
+  "author": "Taximatic",
+  "license": "MIT",
+  "homepage": "https://bodrumtaxi.pages.dev",
+  "engines": {
+    "node": ">=14"
+  }
+}