@ecoaloha/sdk 0.1.0

package/README.md

@@ -0,0 +1,21 @@
+# EcoAloha JavaScript SDK and CLI
+
+Official source: https://github.com/ArneFfm/ecoaloha-agents.
+API documentation: https://ecoaloha.com/developers.
+Registry publication is pending. Node.js 20 or later is required.
+
+From a checkout, run `npm install ./packages/sdk-js` in your integration project.
+
+```js
+import { EcoAloha } from "@ecoaloha/sdk";
+const client = new EcoAloha({ baseUrl: "https://ecoaloha.com/api/sandbox/v1" });
+console.log(await client.experiences({ destinationId: "paris" }));
+```
+
+Run `node packages/sdk-js/cli.js --sandbox destinations` from the repository root.
+Run `ecoaloha --help` after package installation.
+
+The client returns the complete response envelope, including `nextCursor`.
+Use `request(path, options)` for other documented operations.
+Errors expose `status`, `body`, and `retryAfter`. The client does not retry writes.
+No key is required. Respect rate limits and affiliate disclosure rules.

package/cli.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { EcoAloha } from "./index.js";
+
+const args = process.argv.slice(2);
+const sandbox = args[0] === "--sandbox";
+if (sandbox) args.shift();
+const [command, ...params] = args;
+if (!command || command === "--help") {
+  console.log("Usage: ecoaloha [--sandbox] destinations | experiences destinationId [interest]");
+} else {
+  try {
+    const client = new EcoAloha(sandbox ? { baseUrl: "https://ecoaloha.com/api/sandbox/v1" } : {});
+    let result;
+    if (command === "destinations" && params.length === 0) result = await client.destinations();
+    else if (command === "experiences" && params.length >= 1 && params.length <= 2) {
+      result = await client.experiences({ destinationId: params[0], interest: params[1] });
+    } else throw new Error("Unknown command or arguments. Run ecoaloha --help.");
+    console.log(JSON.stringify(result, null, 2));
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : "Request failed");
+    process.exitCode = 1;
+  }
+}

package/index.d.ts

@@ -0,0 +1,27 @@
+export interface ApiResponse<T = unknown> {
+  data: T;
+  nextCursor?: string | null;
+}
+export interface RequestOptions {
+  method?: "GET" | "POST" | "DELETE";
+  query?: Record<string, string | number | boolean | undefined>;
+  body?: unknown;
+  signal?: AbortSignal;
+}
+export class EcoAlohaError extends Error {
+  status: number;
+  body: unknown;
+  retryAfter: string | null;
+}
+export class EcoAloha {
+  constructor(options?: { baseUrl?: string; fetch?: typeof fetch });
+  request<T = unknown>(path: string, options?: RequestOptions): Promise<ApiResponse<T>>;
+  destinations(): Promise<ApiResponse<Array<{ id: string; name: string; country: string }>>>;
+  experiences(
+    query: { destinationId: string } & NonNullable<RequestOptions["query"]>,
+  ): Promise<ApiResponse<unknown[]>>;
+  compare(
+    experienceIds: string[],
+    currency?: "EUR" | "USD" | "GBP",
+  ): Promise<ApiResponse<unknown[]>>;
+}

package/index.js

@@ -0,0 +1,48 @@
+export class EcoAlohaError extends Error {
+  constructor(status, body, retryAfter) {
+    super(body?.detail ?? `EcoAloha request failed (${status})`);
+    this.status = status;
+    this.body = body;
+    this.retryAfter = retryAfter;
+  }
+}
+
+export class EcoAloha {
+  constructor({ baseUrl = "https://ecoaloha.com/api/v1", fetch: fetcher = globalThis.fetch } = {}) {
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.fetch = fetcher;
+  }
+
+  async request(path, { method = "GET", query = {}, body, signal } = {}) {
+    if (!/^\/[a-zA-Z0-9_/-]*$/.test(path) || path.includes("//")) {
+      throw new TypeError("Use an API-relative path, such as /destinations");
+    }
+    const url = new URL(this.baseUrl + path);
+    for (const [key, value] of Object.entries(query)) {
+      if (value !== undefined) url.searchParams.set(key, String(value));
+    }
+    const response = await this.fetch(url, {
+      method,
+      signal,
+      headers: {
+        Accept: "application/json",
+        ...(body === undefined ? {} : { "Content-Type": "application/json" }),
+      },
+      ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+    });
+    const payload = await response.json();
+    if (!response.ok)
+      throw new EcoAlohaError(response.status, payload, response.headers.get("Retry-After"));
+    return payload;
+  }
+
+  destinations() {
+    return this.request("/destinations");
+  }
+  experiences(query) {
+    return this.request("/experiences", { query });
+  }
+  compare(experienceIds, currency = "EUR") {
+    return this.request("/compare", { method: "POST", body: { experienceIds, currency } });
+  }
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@ecoaloha/sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Official EcoAloha JavaScript SDK and CLI",
+  "homepage": "https://ecoaloha.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ArneFfm/ecoaloha-agents.git",
+    "directory": "packages/sdk-js"
+  },
+  "license": "UNLICENSED",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js"
+    }
+  },
+  "bin": {
+    "ecoaloha": "cli.js"
+  },
+  "files": ["index.js", "index.d.ts", "cli.js", "README.md"],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.js"
+  }
+}