fix(sdk): align node client with current currents api and refresh metadata

Author: Autumn-Atlas

.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: CI
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: ["18", "20", "22"]
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+      - name: Install dependencies
+        run: npm install
+      - name: Run tests
+        run: npm test

.gitignore

@@ -1,2 +1,6 @@
 node_modules
 .env
+*.log
+.DS_Store
+test/integration_test.js
+run_integration.js

CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+## 0.2.0
+
+### Added
+- Added `availableLanguages()`, `availableRegions()`, and `availableCategory()` endpoint wrappers.
+- Added GitHub Actions CI workflow.
+- Added unit tests with mocked `fetch`.
+
+### Changed
+- Migrated from module-global `API_KEY` to instance-scoped auth.
+- Migrated from `node-fetch` to native `fetch` (Node 18+).
+- Aligned `search()` and `latestNews()` parameters with the current documented API surface.
+- Modernized `package.json` metadata: updated repository URL, keywords, and engines.
+- Updated README with current docs link and usage examples.
+
+### Removed
+- Dropped callback-style API in favor of a clean Promise-based API.
+- Removed legacy Babel build step and `dist/` output.
+
+## 0.1.0
+
+- First release of the official CurrentsAPI package.

README.md

@@ -1,48 +1,63 @@
 # currentsapi
 
-A node interface for CurrentsAPI.
+The official Node.js SDK for the [Currents API](https://currentsapi.services/en/docs/).
 
-Latest news headlines and metadata in JSON from 13,000 popular news sites. Powered by Currents Api
+## Installation
 
-In order to use this package you need to register at [https://currentsapi.services/en/register](https://currentsapi.services/en/register)
+```bash
+npm install currentsapi
+```
+
+## Usage
 
-Please refer to our [documentation](https://currentsapi.services/en/documents) to see details about how to use the API. The convenience functions provided by this module is simply passing your options along as querystring parameters to the REST API, so the [documentation](https://currentsapi.services/en/documents) is totally valid. 
+```js
+const CurrentsAPI = require('currentsapi');
+const api = new CurrentsAPI('YOUR_API_KEY');
+```
 
-There are some usage examples below to see how these options should be passed in.
+## Endpoints
 
-If you use this in a project, kindly add an attribution : 'powered by Currents API' with links back to Currents Api.
+### Latest News
 
-## Add to your project
-```shell
-$ npm i -s currentsapi
+```js
+api.latestNews({ language: 'en' })
+  .then(response => console.log(response));
 ```
 
-## Test
-```shell
-$ API_KEY=<your api key> npm test
+### Search
+
+```js
+api.search({ keywords: 'OpenAI', language: 'en' })
+  .then(response => console.log(response));
 ```
 
-## Example usage of API
-All methods support promises and node-style callbacks.
+Supported parameters:
+
+- `keywords`
+- `language`
+- `country`
+- `category`
+- `start_date`
+- `end_date`
+
+### Available Resources
+
 ```js
-const CurrentsAPI = require('currentsapi');
-const currentsapi = new CurrentsAPI('YOUR_API_KEY');
-
-// To query latest news
-// All options passed to search are optional
-currentsapi.search({
-  keywords: 'Trump',
-  language: 'en',
-  country: 'US'
-}).then(response => {
-  console.log(response);
-  /*
-    {
-      status: "ok",
-      news: [...]
-    }
-  */
-});
-
-
-If you like this package you can follow us at [Twitter](https://twitter.com/currentsapi)
+api.availableLanguages();
+api.availableRegions();
+api.availableCategory();
+```
+
+## Authentication
+
+All requests are authenticated using an `Authorization` header. Pass your API key when instantiating the client:
+
+```js
+const api = new CurrentsAPI('YOUR_API_KEY');
+```
+
+Get your API key at [https://currentsapi.services/en/register](https://currentsapi.services/en/register).
+
+## License
+
+MIT