newtqnia-node 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NewTqnia Offical account
+
+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,121 @@
+# NewTqnia Node.js SDK
+
+[![CI](https://github.com/newtqnia/newtqnia-node/actions/workflows/ci.yml/badge.svg)](https://github.com/newtqnia/newtqnia-node/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/newtqnia-node)](https://www.npmjs.com/package/newtqnia-node)
+[![Node](https://img.shields.io/node/v/newtqnia-node)](package.json)
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+
+The official, TypeScript-first SDK for the [NewTqnia technology news API](https://newtqnia.com/en/developers). It supports Node.js 18+, native Fetch, ESM and CommonJS, strong types, cancellation, timeouts, typed errors, and safe retries with no runtime dependencies.
+
+![Live NewTqnia Node.js SDK demo](docs/images/node-sdk-live-demo.png)
+
+> When displaying API content, preserve returned article URLs and show the attribution supplied in the response, normally a visible [Powered by NewTqnia](https://newtqnia.com/en) link.
+
+## Installation
+
+```bash
+npm install newtqnia-node
+```
+
+## Quick start
+
+```ts
+import { NewTqniaClient } from "newtqnia-node";
+
+const client = new NewTqniaClient({
+  apiKey: process.env.NEWTQNIA_API_KEY,
+});
+
+const digest = await client.news.latest({ locale: "en", limit: 5 });
+for (const article of digest.articles) {
+  console.log(article.title, article.url);
+}
+```
+
+The public API currently exposes the two endpoints in NewTqnia's [OpenAPI document](https://newtqnia.com/openapi.yaml):
+
+```ts
+await client.news.today({ locale: "ar", limit: 10 });
+await client.news.latest({ category: "ai" });
+```
+
+The API contract does not currently define free-text search, individual article lookup, category listing, or pagination. The SDK deliberately does not synthesize those operations. Category slugs can be passed to either collection as shown above.
+
+## Authentication
+
+The public digest can be used without a key. When `apiKey` is provided, the SDK sends it as a Bearer token. Keep keys in environment variables and never ship them to browsers.
+
+## Configuration
+
+```ts
+const client = new NewTqniaClient({
+  apiKey: process.env.NEWTQNIA_API_KEY,
+  baseUrl: "https://newtqnia.com",
+  timeout: 15_000,
+  retry: { maxRetries: 3, initialDelayMs: 500, maxDelayMs: 8_000 },
+  userAgent: "my-service/2.0",
+  defaultHeaders: { "X-Application": "my-service" },
+  fetch: customFetch,
+  signal: applicationShutdownSignal,
+});
+```
+
+Retries use exponential backoff for temporary network failures and HTTP 429, 500, 502, 503, and 504 responses. `Retry-After` is honored. Authentication and validation failures are never retried.
+
+Cancel one request with an `AbortController`:
+
+```ts
+const controller = new AbortController();
+const pending = client.news.latest({ signal: controller.signal });
+controller.abort();
+await pending;
+```
+
+## Error handling
+
+```ts
+import { NewTqniaError, RateLimitError } from "newtqnia-node";
+
+try {
+  await client.news.latest();
+} catch (error) {
+  if (error instanceof RateLimitError) console.error(error.retryAfter);
+  else if (error instanceof NewTqniaError) {
+    console.error(error.status, error.requestId, error.code, error.message);
+  }
+}
+```
+
+Exported subclasses are `AuthenticationError`, `AuthorizationError`, `ValidationError`, `NotFoundError`, `ConflictError`, `RateLimitError`, `ServerError`, `TimeoutError`, and `NetworkError`.
+
+## TypeScript and modules
+
+Request and response types are exported from the single package entry point. Low-level types are generated from `openapi/openapi.yaml` and isolated under `src/generated`; the public API exposes ergonomic names such as `Digest`, `Article`, and `NewsListParams`.
+
+```ts
+import type { Article, Digest, NewsListParams } from "newtqnia-node";
+const sdk = require("newtqnia-node"); // CommonJS is also supported
+```
+
+## Examples
+
+Runnable TypeScript examples cover [latest news](examples/latest-news.ts), [category filtering](examples/categories.ts), [retry configuration](examples/retries.ts), [AbortController](examples/cancellation.ts), and [error handling](examples/error-handling.ts).
+
+## Development
+
+```bash
+npm install
+npm run generate
+npm run check
+npm run docs
+npm run openapi:check
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) and [SECURITY.md](SECURITY.md). The SDK follows Semantic Versioning and is MIT licensed.
+
+## Related resources
+
+- [NewTqnia](https://newtqnia.com/) — current technology coverage
+- [Developer documentation](https://newtqnia.com/en/developers) — endpoints, limits, response formats, and terms
+- [Embeddable news widget](https://newtqnia.com/en/widget) — responsive headlines without a custom integration
+- [NewTqnia Start Chrome extension](https://newtqnia.com/en/start) — technology coverage on the browser new-tab page

package/dist/index.cjs

@@ -0,0 +1,252 @@
+'use strict';
+
+// src/errors/index.ts
+var NewTqniaError = class extends Error {
+  status;
+  requestId;
+  retryAfter;
+  code;
+  constructor(message, options = {}) {
+    super(message, options.cause === void 0 ? void 0 : { cause: options.cause });
+    this.name = new.target.name;
+    this.status = options.status;
+    this.requestId = options.requestId;
+    this.retryAfter = options.retryAfter;
+    this.code = options.code;
+  }
+};
+var AuthenticationError = class extends NewTqniaError {
+};
+var AuthorizationError = class extends NewTqniaError {
+};
+var ValidationError = class extends NewTqniaError {
+};
+var NotFoundError = class extends NewTqniaError {
+};
+var ConflictError = class extends NewTqniaError {
+};
+var RateLimitError = class extends NewTqniaError {
+};
+var ServerError = class extends NewTqniaError {
+};
+var TimeoutError = class extends NewTqniaError {
+};
+var NetworkError = class extends NewTqniaError {
+};
+
+// src/resources/news.ts
+var NewsResource = class {
+  /** @internal */
+  constructor(transport) {
+    this.transport = transport;
+  }
+  transport;
+  /** Get articles published today using the Asia/Dubai day boundary. */
+  today(params = {}) {
+    return this.get("today", params);
+  }
+  /** Get the latest published articles. */
+  latest(params = {}) {
+    return this.get("latest", params);
+  }
+  get(collection, params) {
+    if (params.locale !== void 0 && params.locale !== "en" && params.locale !== "ar") {
+      throw new ValidationError('locale must be "en" or "ar".');
+    }
+    if (params.limit !== void 0 && (!Number.isInteger(params.limit) || params.limit < 1 || params.limit > 10)) {
+      throw new ValidationError("limit must be an integer between 1 and 10.");
+    }
+    if (params.category !== void 0 && params.category.trim() === "") {
+      throw new ValidationError("category cannot be empty.");
+    }
+    return this.transport.request({
+      method: "GET",
+      path: `/v1/news/${collection}`,
+      query: { locale: params.locale, limit: params.limit, category: params.category },
+      ...params.signal ? { signal: params.signal } : {}
+    });
+  }
+};
+
+// src/utils/query.ts
+function serializeQuery(values) {
+  const search = new URLSearchParams();
+  for (const [key, value] of Object.entries(values)) {
+    if (value !== void 0) search.append(key, String(value));
+  }
+  return search.toString();
+}
+
+// src/transport/transport.ts
+var RETRYABLE = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
+var Transport = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  async request(request) {
+    const query = request.query ? serializeQuery(request.query) : "";
+    const url = `${this.options.baseUrl}${request.path}${query ? `?${query}` : ""}`;
+    let lastError;
+    for (let attempt = 0; attempt <= this.options.retry.maxRetries; attempt += 1) {
+      try {
+        const response = await this.fetchOnce(url, request);
+        if (response.ok) return await this.decode(response);
+        if (RETRYABLE.has(response.status) && attempt < this.options.retry.maxRetries) {
+          await this.pause(this.retryDelay(response, attempt), request.signal);
+          continue;
+        }
+        throw await this.apiError(response);
+      } catch (error) {
+        if (error instanceof NewTqniaError) throw error;
+        if (this.wasCancelled(request.signal)) throw error;
+        if (this.isTimeout(error)) throw new TimeoutError(`Request timed out after ${this.options.timeout}ms`, { cause: error });
+        lastError = error;
+        if (attempt < this.options.retry.maxRetries) {
+          await this.pause(this.backoff(attempt), request.signal);
+          continue;
+        }
+      }
+    }
+    throw new NetworkError("Unable to reach the NewTqnia API.", { cause: lastError });
+  }
+  async fetchOnce(url, request) {
+    const timeout = AbortSignal.timeout(this.options.timeout);
+    const signals = [timeout, this.options.signal, request.signal].filter((signal2) => signal2 !== void 0);
+    const signal = this.combineSignals(signals);
+    const headers = new Headers(this.options.headers);
+    headers.set("Accept", "application/json");
+    headers.set("User-Agent", this.options.userAgent);
+    if (this.options.apiKey) headers.set("Authorization", `Bearer ${this.options.apiKey}`);
+    return this.options.fetch(url, { method: request.method, headers, signal: signal ?? null });
+  }
+  async decode(response) {
+    try {
+      return await response.json();
+    } catch (cause) {
+      throw new NewTqniaError("The API returned invalid JSON.", {
+        status: response.status,
+        requestId: this.requestId(response),
+        cause
+      });
+    }
+  }
+  async apiError(response) {
+    const data = await response.json().catch(() => ({}));
+    const message = typeof data.message === "string" ? data.message : `NewTqnia API request failed with status ${response.status}.`;
+    const retryAfter = this.parseRetryAfter(response.headers.get("retry-after"));
+    const options = {
+      status: response.status,
+      requestId: this.requestId(response),
+      retryAfter,
+      code: typeof data.code === "string" ? data.code : void 0
+    };
+    if (response.status === 401) return new AuthenticationError(message, options);
+    if (response.status === 403) return new AuthorizationError(message, options);
+    if (response.status === 404) return new NotFoundError(message, options);
+    if (response.status === 409) return new ConflictError(message, options);
+    if (response.status === 422 || response.status === 400) return new ValidationError(message, options);
+    if (response.status === 429) return new RateLimitError(message, options);
+    if (response.status >= 500) return new ServerError(message, options);
+    return new NewTqniaError(message, options);
+  }
+  retryDelay(response, attempt) {
+    return this.parseRetryAfter(response.headers.get("retry-after")) ?? this.backoff(attempt);
+  }
+  parseRetryAfter(value) {
+    if (!value) return void 0;
+    const seconds = Number(value);
+    if (Number.isFinite(seconds)) return Math.max(0, seconds * 1e3);
+    const date = Date.parse(value);
+    return Number.isNaN(date) ? void 0 : Math.max(0, date - Date.now());
+  }
+  backoff(attempt) {
+    const raw = this.options.retry.initialDelayMs * 2 ** attempt;
+    return Math.min(raw, this.options.retry.maxDelayMs);
+  }
+  async pause(ms, signal) {
+    await new Promise((resolve, reject) => {
+      const timer = setTimeout(resolve, ms);
+      signal?.addEventListener("abort", () => {
+        clearTimeout(timer);
+        reject(signal.reason);
+      }, { once: true });
+    });
+  }
+  requestId(response) {
+    return response.headers.get("x-request-id") ?? void 0;
+  }
+  combineSignals(signals) {
+    if (signals.length === 0) return void 0;
+    if (signals.length === 1) return signals[0];
+    const controller = new AbortController();
+    const abort = (signal) => {
+      if (!controller.signal.aborted) controller.abort(signal.reason);
+    };
+    for (const signal of signals) {
+      if (signal.aborted) {
+        abort(signal);
+        break;
+      }
+      signal.addEventListener("abort", () => abort(signal), { once: true });
+    }
+    return controller.signal;
+  }
+  wasCancelled(signal) {
+    return Boolean(signal?.aborted || this.options.signal?.aborted);
+  }
+  isTimeout(error) {
+    return error instanceof DOMException && (error.name === "TimeoutError" || error.name === "AbortError") && !this.options.signal?.aborted;
+  }
+};
+
+// src/client/client.ts
+var NewTqniaClient = class {
+  /** Localized news endpoints. */
+  news;
+  constructor(options = {}) {
+    const baseUrl = (options.baseUrl ?? "https://newtqnia.com").replace(/\/+$/, "");
+    this.validate(baseUrl, options.timeout);
+    const transport = new Transport({
+      ...options.apiKey ? { apiKey: options.apiKey } : {},
+      baseUrl,
+      timeout: options.timeout ?? 3e4,
+      fetch: options.fetch ?? globalThis.fetch.bind(globalThis),
+      retry: {
+        maxRetries: options.retry?.maxRetries ?? 2,
+        initialDelayMs: options.retry?.initialDelayMs ?? 500,
+        maxDelayMs: options.retry?.maxDelayMs ?? 8e3
+      },
+      userAgent: options.userAgent ?? "newtqnia-node/1.0.0",
+      headers: options.defaultHeaders ?? {},
+      ...options.signal ? { signal: options.signal } : {}
+    });
+    this.news = new NewsResource(transport);
+  }
+  validate(baseUrl, timeout) {
+    let url;
+    try {
+      url = new URL(baseUrl);
+    } catch {
+      throw new ValidationError("baseUrl must be an absolute HTTP(S) URL.");
+    }
+    if (!["http:", "https:"].includes(url.protocol)) throw new ValidationError("baseUrl must be an absolute HTTP(S) URL.");
+    const local = ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname);
+    if (url.protocol !== "https:" && !local) throw new ValidationError("baseUrl must use HTTPS except for local development.");
+    if (timeout !== void 0 && (!Number.isFinite(timeout) || timeout <= 0)) throw new ValidationError("timeout must be a positive number.");
+  }
+};
+
+exports.AuthenticationError = AuthenticationError;
+exports.AuthorizationError = AuthorizationError;
+exports.ConflictError = ConflictError;
+exports.NetworkError = NetworkError;
+exports.NewTqniaClient = NewTqniaClient;
+exports.NewTqniaError = NewTqniaError;
+exports.NotFoundError = NotFoundError;
+exports.RateLimitError = RateLimitError;
+exports.ServerError = ServerError;
+exports.TimeoutError = TimeoutError;
+exports.ValidationError = ValidationError;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/index.ts","../src/resources/news.ts","../src/utils/query.ts","../src/transport/transport.ts","../src/client/client.ts"],"names":["signal"],"mappings":"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","file":"index.cjs","sourcesContent":["export interface ErrorOptions {\n  status?: number | undefined;\n  requestId?: string | undefined;\n  retryAfter?: number | undefined;\n  code?: string | undefined;\n  cause?: unknown | undefined;\n}\n\n/** Base class for all SDK errors. */\nexport class NewTqniaError extends Error {\n  readonly status: number | undefined;\n  readonly requestId: string | undefined;\n  readonly retryAfter: number | undefined;\n  readonly code: string | undefined;\n\n  constructor(message: string, options: ErrorOptions = {}) {\n    super(message, options.cause === undefined ? undefined : { cause: options.cause });\n    this.name = new.target.name;\n    this.status = options.status;\n    this.requestId = options.requestId;\n    this.retryAfter = options.retryAfter;\n    this.code = options.code;\n  }\n}\nexport class AuthenticationError extends NewTqniaError {}\nexport class AuthorizationError extends NewTqniaError {}\nexport class ValidationError extends NewTqniaError {}\nexport class NotFoundError extends NewTqniaError {}\nexport class ConflictError extends NewTqniaError {}\nexport class RateLimitError extends NewTqniaError {}\nexport class ServerError extends NewTqniaError {}\nexport class TimeoutError extends NewTqniaError {}\nexport class NetworkError extends NewTqniaError {}\n","import { ValidationError } from \"../errors/index.js\";\nimport type { Digest, NewsListParams } from \"../models/index.js\";\nimport type { Transport } from \"../transport/transport.js\";\n\n/** Access localized NewTqnia news collections. */\nexport class NewsResource {\n  /** @internal */\n  constructor(private readonly transport: Transport) {}\n\n  /** Get articles published today using the Asia/Dubai day boundary. */\n  today(params: NewsListParams = {}): Promise<Digest> {\n    return this.get(\"today\", params);\n  }\n\n  /** Get the latest published articles. */\n  latest(params: NewsListParams = {}): Promise<Digest> {\n    return this.get(\"latest\", params);\n  }\n\n  private get(collection: \"today\" | \"latest\", params: NewsListParams): Promise<Digest> {\n    if (params.locale !== undefined && params.locale !== \"en\" && params.locale !== \"ar\") {\n      throw new ValidationError('locale must be \"en\" or \"ar\".');\n    }\n    if (params.limit !== undefined && (!Number.isInteger(params.limit) || params.limit < 1 || params.limit > 10)) {\n      throw new ValidationError(\"limit must be an integer between 1 and 10.\");\n    }\n    if (params.category !== undefined && params.category.trim() === \"\") {\n      throw new ValidationError(\"category cannot be empty.\");\n    }\n    return this.transport.request<Digest>({\n      method: \"GET\",\n      path: `/v1/news/${collection}`,\n      query: { locale: params.locale, limit: params.limit, category: params.category },\n      ...(params.signal ? { signal: params.signal } : {}),\n    });\n  }\n}\n","export function serializeQuery(values: Record<string, string | number | boolean | undefined>): string {\n  const search = new URLSearchParams();\n  for (const [key, value] of Object.entries(values)) {\n    if (value !== undefined) search.append(key, String(value));\n  }\n  return search.toString();\n}\n","import {\n  AuthenticationError, AuthorizationError, ConflictError, NetworkError, NewTqniaError,\n  NotFoundError, RateLimitError, ServerError, TimeoutError, ValidationError,\n} from \"../errors/index.js\";\nimport { serializeQuery } from \"../utils/query.js\";\nimport type { Fetch, RequestOptions, RetryOptions } from \"./types.js\";\n\nconst RETRYABLE = new Set([429, 500, 502, 503, 504]);\n\nexport interface TransportOptions {\n  apiKey?: string;\n  baseUrl: string;\n  timeout: number;\n  fetch: Fetch;\n  retry: Required<RetryOptions>;\n  userAgent: string;\n  headers: Record<string, string>;\n  signal?: AbortSignal;\n}\n\nexport class Transport {\n  constructor(private readonly options: TransportOptions) {}\n\n  async request<T>(request: RequestOptions): Promise<T> {\n    const query = request.query ? serializeQuery(request.query) : \"\";\n    const url = `${this.options.baseUrl}${request.path}${query ? `?${query}` : \"\"}`;\n    let lastError: unknown;\n\n    for (let attempt = 0; attempt <= this.options.retry.maxRetries; attempt += 1) {\n      try {\n        const response = await this.fetchOnce(url, request);\n        if (response.ok) return await this.decode<T>(response);\n        if (RETRYABLE.has(response.status) && attempt < this.options.retry.maxRetries) {\n          await this.pause(this.retryDelay(response, attempt), request.signal);\n          continue;\n        }\n        throw await this.apiError(response);\n      } catch (error) {\n        if (error instanceof NewTqniaError) throw error;\n        if (this.wasCancelled(request.signal)) throw error;\n        if (this.isTimeout(error)) throw new TimeoutError(`Request timed out after ${this.options.timeout}ms`, { cause: error });\n        lastError = error;\n        if (attempt < this.options.retry.maxRetries) {\n          await this.pause(this.backoff(attempt), request.signal);\n          continue;\n        }\n      }\n    }\n    throw new NetworkError(\"Unable to reach the NewTqnia API.\", { cause: lastError });\n  }\n\n  private async fetchOnce(url: string, request: RequestOptions): Promise<Response> {\n    const timeout = AbortSignal.timeout(this.options.timeout);\n    const signals = [timeout, this.options.signal, request.signal].filter((signal): signal is AbortSignal => signal !== undefined);\n    const signal = this.combineSignals(signals);\n    const headers = new Headers(this.options.headers);\n    headers.set(\"Accept\", \"application/json\");\n    headers.set(\"User-Agent\", this.options.userAgent);\n    if (this.options.apiKey) headers.set(\"Authorization\", `Bearer ${this.options.apiKey}`);\n    return this.options.fetch(url, { method: request.method, headers, signal: signal ?? null });\n  }\n\n  private async decode<T>(response: Response): Promise<T> {\n    try {\n      return await response.json() as T;\n    } catch (cause) {\n      throw new NewTqniaError(\"The API returned invalid JSON.\", {\n        status: response.status, requestId: this.requestId(response), cause,\n      });\n    }\n  }\n\n  private async apiError(response: Response): Promise<NewTqniaError> {\n    const data = await response.json().catch(() => ({})) as Record<string, unknown>;\n    const message = typeof data.message === \"string\" ? data.message : `NewTqnia API request failed with status ${response.status}.`;\n    const retryAfter = this.parseRetryAfter(response.headers.get(\"retry-after\"));\n    const options = {\n      status: response.status,\n      requestId: this.requestId(response),\n      retryAfter,\n      code: typeof data.code === \"string\" ? data.code : undefined,\n    };\n    if (response.status === 401) return new AuthenticationError(message, options);\n    if (response.status === 403) return new AuthorizationError(message, options);\n    if (response.status === 404) return new NotFoundError(message, options);\n    if (response.status === 409) return new ConflictError(message, options);\n    if (response.status === 422 || response.status === 400) return new ValidationError(message, options);\n    if (response.status === 429) return new RateLimitError(message, options);\n    if (response.status >= 500) return new ServerError(message, options);\n    return new NewTqniaError(message, options);\n  }\n\n  private retryDelay(response: Response, attempt: number): number {\n    return this.parseRetryAfter(response.headers.get(\"retry-after\")) ?? this.backoff(attempt);\n  }\n  private parseRetryAfter(value: string | null): number | undefined {\n    if (!value) return undefined;\n    const seconds = Number(value);\n    if (Number.isFinite(seconds)) return Math.max(0, seconds * 1000);\n    const date = Date.parse(value);\n    return Number.isNaN(date) ? undefined : Math.max(0, date - Date.now());\n  }\n  private backoff(attempt: number): number {\n    const raw = this.options.retry.initialDelayMs * (2 ** attempt);\n    return Math.min(raw, this.options.retry.maxDelayMs);\n  }\n  private async pause(ms: number, signal?: AbortSignal): Promise<void> {\n    await new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(resolve, ms);\n      signal?.addEventListener(\"abort\", () => { clearTimeout(timer); reject(signal.reason); }, { once: true });\n    });\n  }\n  private requestId(response: Response): string | undefined {\n    return response.headers.get(\"x-request-id\") ?? undefined;\n  }\n  private combineSignals(signals: AbortSignal[]): AbortSignal | undefined {\n    if (signals.length === 0) return undefined;\n    if (signals.length === 1) return signals[0];\n    const controller = new AbortController();\n    const abort = (signal: AbortSignal) => {\n      if (!controller.signal.aborted) controller.abort(signal.reason);\n    };\n    for (const signal of signals) {\n      if (signal.aborted) {\n        abort(signal);\n        break;\n      }\n      signal.addEventListener(\"abort\", () => abort(signal), { once: true });\n    }\n    return controller.signal;\n  }\n  private wasCancelled(signal?: AbortSignal): boolean {\n    return Boolean(signal?.aborted || this.options.signal?.aborted);\n  }\n  private isTimeout(error: unknown): boolean {\n    return error instanceof DOMException && (error.name === \"TimeoutError\" || error.name === \"AbortError\")\n      && !this.options.signal?.aborted;\n  }\n}\n","import { ValidationError } from \"../errors/index.js\";\nimport { NewsResource } from \"../resources/news.js\";\nimport { Transport } from \"../transport/transport.js\";\nimport type { Fetch, RetryOptions } from \"../transport/types.js\";\n\nexport interface NewTqniaClientOptions {\n  /** Optional bearer API key. */\n  apiKey?: string;\n  /** API origin. @default \"https://newtqnia.com\" */\n  baseUrl?: string;\n  /** Request timeout in milliseconds. @default 30000 */\n  timeout?: number;\n  /** Cancels every request made by this client. */\n  signal?: AbortSignal;\n  /** Custom Fetch-compatible implementation. */\n  fetch?: Fetch;\n  /** Retry behavior for rate limits, server errors, and temporary network failures. */\n  retry?: RetryOptions;\n  /** User-Agent header. @default \"newtqnia-node/1.0.0\" */\n  userAgent?: string;\n  /** Headers included with every request. */\n  defaultHeaders?: Record<string, string>;\n}\n\n/** Official NewTqnia API client. */\nexport class NewTqniaClient {\n  /** Localized news endpoints. */\n  readonly news: NewsResource;\n\n  constructor(options: NewTqniaClientOptions = {}) {\n    const baseUrl = (options.baseUrl ?? \"https://newtqnia.com\").replace(/\\/+$/, \"\");\n    this.validate(baseUrl, options.timeout);\n    const transport = new Transport({\n      ...(options.apiKey ? { apiKey: options.apiKey } : {}),\n      baseUrl,\n      timeout: options.timeout ?? 30_000,\n      fetch: options.fetch ?? globalThis.fetch.bind(globalThis),\n      retry: {\n        maxRetries: options.retry?.maxRetries ?? 2,\n        initialDelayMs: options.retry?.initialDelayMs ?? 500,\n        maxDelayMs: options.retry?.maxDelayMs ?? 8_000,\n      },\n      userAgent: options.userAgent ?? \"newtqnia-node/1.0.0\",\n      headers: options.defaultHeaders ?? {},\n      ...(options.signal ? { signal: options.signal } : {}),\n    });\n    this.news = new NewsResource(transport);\n  }\n\n  private validate(baseUrl: string, timeout?: number): void {\n    let url: URL;\n    try { url = new URL(baseUrl); } catch { throw new ValidationError(\"baseUrl must be an absolute HTTP(S) URL.\"); }\n    if (![\"http:\", \"https:\"].includes(url.protocol)) throw new ValidationError(\"baseUrl must be an absolute HTTP(S) URL.\");\n    const local = [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(url.hostname);\n    if (url.protocol !== \"https:\" && !local) throw new ValidationError(\"baseUrl must use HTTPS except for local development.\");\n    if (timeout !== undefined && (!Number.isFinite(timeout) || timeout <= 0)) throw new ValidationError(\"timeout must be a positive number.\");\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,204 @@
+interface components {
+    schemas: {
+        Digest: {
+            /** @constant */
+            api_version: "v1";
+            /** @enum {string} */
+            collection: "today" | "latest";
+            /** Format: date */
+            date?: string;
+            /** @constant */
+            timezone: "Asia/Dubai";
+            /** @enum {string} */
+            locale: "en" | "ar";
+            /** @enum {string} */
+            direction: "ltr" | "rtl";
+            publisher: components["schemas"]["LinkLabel"];
+            attribution: {
+                text: string;
+                /** Format: uri */
+                url: string;
+                required: boolean;
+            };
+            /** Format: date-time */
+            generated_at: string;
+            articles: components["schemas"]["Article"][];
+            _links: {
+                [key: string]: string;
+            };
+        };
+        Article: {
+            id: number;
+            title: string;
+            summary: string;
+            category: {
+                slug: string;
+                name: string;
+            };
+            /** Format: uri */
+            image: string;
+            /** Format: uri */
+            url: string;
+            /** Format: date-time */
+            published_at: string;
+            read_time: number;
+        };
+        LinkLabel: {
+            name: string;
+            /** Format: uri */
+            url: string;
+        };
+    };
+    responses: never;
+    parameters: {
+        Locale: "en" | "ar";
+        Limit: number;
+        /** @description Optional category slug. */
+        Category: string;
+    };
+    requestBodies: never;
+    headers: {
+        /** @description Validator for conditional requests using If-None-Match. */
+        ETag: string;
+        /** @description Public caching instructions. */
+        CacheControl: string;
+    };
+    pathItems: never;
+}
+
+/** A localized NewTqnia article. */
+type Article = components["schemas"]["Article"];
+/** A localized collection of NewTqnia articles and attribution metadata. */
+type Digest = components["schemas"]["Digest"];
+/** A publisher name and URL. */
+type LinkLabel = components["schemas"]["LinkLabel"];
+/** Supported response locale. */
+type Locale = Digest["locale"];
+/** Filters accepted by both news collections. */
+interface NewsListParams {
+    /** Response language. @default "en" */
+    locale?: Locale;
+    /** Number of articles, from 1 through 10. @default 10 */
+    limit?: number;
+    /** Optional category slug. */
+    category?: string;
+    /** Cancels this request without affecting other client requests. */
+    signal?: AbortSignal;
+}
+
+type Fetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+interface RetryOptions {
+    /** Maximum retry attempts after the initial request. @default 2 */
+    maxRetries?: number;
+    /** Initial exponential-backoff delay in milliseconds. @default 500 */
+    initialDelayMs?: number;
+    /** Maximum backoff delay in milliseconds. @default 8000 */
+    maxDelayMs?: number;
+}
+interface RequestOptions {
+    method: "GET";
+    path: string;
+    query?: Record<string, string | number | boolean | undefined>;
+    signal?: AbortSignal;
+}
+
+interface TransportOptions {
+    apiKey?: string;
+    baseUrl: string;
+    timeout: number;
+    fetch: Fetch;
+    retry: Required<RetryOptions>;
+    userAgent: string;
+    headers: Record<string, string>;
+    signal?: AbortSignal;
+}
+declare class Transport {
+    private readonly options;
+    constructor(options: TransportOptions);
+    request<T>(request: RequestOptions): Promise<T>;
+    private fetchOnce;
+    private decode;
+    private apiError;
+    private retryDelay;
+    private parseRetryAfter;
+    private backoff;
+    private pause;
+    private requestId;
+    private combineSignals;
+    private wasCancelled;
+    private isTimeout;
+}
+
+/** Access localized NewTqnia news collections. */
+declare class NewsResource {
+    private readonly transport;
+    /** @internal */
+    constructor(transport: Transport);
+    /** Get articles published today using the Asia/Dubai day boundary. */
+    today(params?: NewsListParams): Promise<Digest>;
+    /** Get the latest published articles. */
+    latest(params?: NewsListParams): Promise<Digest>;
+    private get;
+}
+
+interface NewTqniaClientOptions {
+    /** Optional bearer API key. */
+    apiKey?: string;
+    /** API origin. @default "https://newtqnia.com" */
+    baseUrl?: string;
+    /** Request timeout in milliseconds. @default 30000 */
+    timeout?: number;
+    /** Cancels every request made by this client. */
+    signal?: AbortSignal;
+    /** Custom Fetch-compatible implementation. */
+    fetch?: Fetch;
+    /** Retry behavior for rate limits, server errors, and temporary network failures. */
+    retry?: RetryOptions;
+    /** User-Agent header. @default "newtqnia-node/1.0.0" */
+    userAgent?: string;
+    /** Headers included with every request. */
+    defaultHeaders?: Record<string, string>;
+}
+/** Official NewTqnia API client. */
+declare class NewTqniaClient {
+    /** Localized news endpoints. */
+    readonly news: NewsResource;
+    constructor(options?: NewTqniaClientOptions);
+    private validate;
+}
+
+interface ErrorOptions {
+    status?: number | undefined;
+    requestId?: string | undefined;
+    retryAfter?: number | undefined;
+    code?: string | undefined;
+    cause?: unknown | undefined;
+}
+/** Base class for all SDK errors. */
+declare class NewTqniaError extends Error {
+    readonly status: number | undefined;
+    readonly requestId: string | undefined;
+    readonly retryAfter: number | undefined;
+    readonly code: string | undefined;
+    constructor(message: string, options?: ErrorOptions);
+}
+declare class AuthenticationError extends NewTqniaError {
+}
+declare class AuthorizationError extends NewTqniaError {
+}
+declare class ValidationError extends NewTqniaError {
+}
+declare class NotFoundError extends NewTqniaError {
+}
+declare class ConflictError extends NewTqniaError {
+}
+declare class RateLimitError extends NewTqniaError {
+}
+declare class ServerError extends NewTqniaError {
+}
+declare class TimeoutError extends NewTqniaError {
+}
+declare class NetworkError extends NewTqniaError {
+}
+
+export { type Article, AuthenticationError, AuthorizationError, ConflictError, type Digest, type Fetch, type LinkLabel, type Locale, NetworkError, NewTqniaClient, type NewTqniaClientOptions, NewTqniaError, type NewsListParams, NotFoundError, RateLimitError, type RetryOptions, ServerError, TimeoutError, ValidationError };

package/dist/index.d.ts

@@ -0,0 +1,204 @@
+interface components {
+    schemas: {
+        Digest: {
+            /** @constant */
+            api_version: "v1";
+            /** @enum {string} */
+            collection: "today" | "latest";
+            /** Format: date */
+            date?: string;
+            /** @constant */
+            timezone: "Asia/Dubai";
+            /** @enum {string} */
+            locale: "en" | "ar";
+            /** @enum {string} */
+            direction: "ltr" | "rtl";
+            publisher: components["schemas"]["LinkLabel"];
+            attribution: {
+                text: string;
+                /** Format: uri */
+                url: string;
+                required: boolean;
+            };
+            /** Format: date-time */
+            generated_at: string;
+            articles: components["schemas"]["Article"][];
+            _links: {
+                [key: string]: string;
+            };
+        };
+        Article: {
+            id: number;
+            title: string;
+            summary: string;
+            category: {
+                slug: string;
+                name: string;
+            };
+            /** Format: uri */
+            image: string;
+            /** Format: uri */
+            url: string;
+            /** Format: date-time */
+            published_at: string;
+            read_time: number;
+        };
+        LinkLabel: {
+            name: string;
+            /** Format: uri */
+            url: string;
+        };
+    };
+    responses: never;
+    parameters: {
+        Locale: "en" | "ar";
+        Limit: number;
+        /** @description Optional category slug. */
+        Category: string;
+    };
+    requestBodies: never;
+    headers: {
+        /** @description Validator for conditional requests using If-None-Match. */
+        ETag: string;
+        /** @description Public caching instructions. */
+        CacheControl: string;
+    };
+    pathItems: never;
+}
+
+/** A localized NewTqnia article. */
+type Article = components["schemas"]["Article"];
+/** A localized collection of NewTqnia articles and attribution metadata. */
+type Digest = components["schemas"]["Digest"];
+/** A publisher name and URL. */
+type LinkLabel = components["schemas"]["LinkLabel"];
+/** Supported response locale. */
+type Locale = Digest["locale"];
+/** Filters accepted by both news collections. */
+interface NewsListParams {
+    /** Response language. @default "en" */
+    locale?: Locale;
+    /** Number of articles, from 1 through 10. @default 10 */
+    limit?: number;
+    /** Optional category slug. */
+    category?: string;
+    /** Cancels this request without affecting other client requests. */
+    signal?: AbortSignal;
+}
+
+type Fetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+interface RetryOptions {
+    /** Maximum retry attempts after the initial request. @default 2 */
+    maxRetries?: number;
+    /** Initial exponential-backoff delay in milliseconds. @default 500 */
+    initialDelayMs?: number;
+    /** Maximum backoff delay in milliseconds. @default 8000 */
+    maxDelayMs?: number;
+}
+interface RequestOptions {
+    method: "GET";
+    path: string;
+    query?: Record<string, string | number | boolean | undefined>;
+    signal?: AbortSignal;
+}
+
+interface TransportOptions {
+    apiKey?: string;
+    baseUrl: string;
+    timeout: number;
+    fetch: Fetch;
+    retry: Required<RetryOptions>;
+    userAgent: string;
+    headers: Record<string, string>;
+    signal?: AbortSignal;
+}
+declare class Transport {
+    private readonly options;
+    constructor(options: TransportOptions);
+    request<T>(request: RequestOptions): Promise<T>;
+    private fetchOnce;
+    private decode;
+    private apiError;
+    private retryDelay;
+    private parseRetryAfter;
+    private backoff;
+    private pause;
+    private requestId;
+    private combineSignals;
+    private wasCancelled;
+    private isTimeout;
+}
+
+/** Access localized NewTqnia news collections. */
+declare class NewsResource {
+    private readonly transport;
+    /** @internal */
+    constructor(transport: Transport);
+    /** Get articles published today using the Asia/Dubai day boundary. */
+    today(params?: NewsListParams): Promise<Digest>;
+    /** Get the latest published articles. */
+    latest(params?: NewsListParams): Promise<Digest>;
+    private get;
+}
+
+interface NewTqniaClientOptions {
+    /** Optional bearer API key. */
+    apiKey?: string;
+    /** API origin. @default "https://newtqnia.com" */
+    baseUrl?: string;
+    /** Request timeout in milliseconds. @default 30000 */
+    timeout?: number;
+    /** Cancels every request made by this client. */
+    signal?: AbortSignal;
+    /** Custom Fetch-compatible implementation. */
+    fetch?: Fetch;
+    /** Retry behavior for rate limits, server errors, and temporary network failures. */
+    retry?: RetryOptions;
+    /** User-Agent header. @default "newtqnia-node/1.0.0" */
+    userAgent?: string;
+    /** Headers included with every request. */
+    defaultHeaders?: Record<string, string>;
+}
+/** Official NewTqnia API client. */
+declare class NewTqniaClient {
+    /** Localized news endpoints. */
+    readonly news: NewsResource;
+    constructor(options?: NewTqniaClientOptions);
+    private validate;
+}
+
+interface ErrorOptions {
+    status?: number | undefined;
+    requestId?: string | undefined;
+    retryAfter?: number | undefined;
+    code?: string | undefined;
+    cause?: unknown | undefined;
+}
+/** Base class for all SDK errors. */
+declare class NewTqniaError extends Error {
+    readonly status: number | undefined;
+    readonly requestId: string | undefined;
+    readonly retryAfter: number | undefined;
+    readonly code: string | undefined;
+    constructor(message: string, options?: ErrorOptions);
+}
+declare class AuthenticationError extends NewTqniaError {
+}
+declare class AuthorizationError extends NewTqniaError {
+}
+declare class ValidationError extends NewTqniaError {
+}
+declare class NotFoundError extends NewTqniaError {
+}
+declare class ConflictError extends NewTqniaError {
+}
+declare class RateLimitError extends NewTqniaError {
+}
+declare class ServerError extends NewTqniaError {
+}
+declare class TimeoutError extends NewTqniaError {
+}
+declare class NetworkError extends NewTqniaError {
+}
+
+export { type Article, AuthenticationError, AuthorizationError, ConflictError, type Digest, type Fetch, type LinkLabel, type Locale, NetworkError, NewTqniaClient, type NewTqniaClientOptions, NewTqniaError, type NewsListParams, NotFoundError, RateLimitError, type RetryOptions, ServerError, TimeoutError, ValidationError };

package/dist/index.js

@@ -0,0 +1,240 @@
+// src/errors/index.ts
+var NewTqniaError = class extends Error {
+  status;
+  requestId;
+  retryAfter;
+  code;
+  constructor(message, options = {}) {
+    super(message, options.cause === void 0 ? void 0 : { cause: options.cause });
+    this.name = new.target.name;
+    this.status = options.status;
+    this.requestId = options.requestId;
+    this.retryAfter = options.retryAfter;
+    this.code = options.code;
+  }
+};
+var AuthenticationError = class extends NewTqniaError {
+};
+var AuthorizationError = class extends NewTqniaError {
+};
+var ValidationError = class extends NewTqniaError {
+};
+var NotFoundError = class extends NewTqniaError {
+};
+var ConflictError = class extends NewTqniaError {
+};
+var RateLimitError = class extends NewTqniaError {
+};
+var ServerError = class extends NewTqniaError {
+};
+var TimeoutError = class extends NewTqniaError {
+};
+var NetworkError = class extends NewTqniaError {
+};
+
+// src/resources/news.ts
+var NewsResource = class {
+  /** @internal */
+  constructor(transport) {
+    this.transport = transport;
+  }
+  transport;
+  /** Get articles published today using the Asia/Dubai day boundary. */
+  today(params = {}) {
+    return this.get("today", params);
+  }
+  /** Get the latest published articles. */
+  latest(params = {}) {
+    return this.get("latest", params);
+  }
+  get(collection, params) {
+    if (params.locale !== void 0 && params.locale !== "en" && params.locale !== "ar") {
+      throw new ValidationError('locale must be "en" or "ar".');
+    }
+    if (params.limit !== void 0 && (!Number.isInteger(params.limit) || params.limit < 1 || params.limit > 10)) {
+      throw new ValidationError("limit must be an integer between 1 and 10.");
+    }
+    if (params.category !== void 0 && params.category.trim() === "") {
+      throw new ValidationError("category cannot be empty.");
+    }
+    return this.transport.request({
+      method: "GET",
+      path: `/v1/news/${collection}`,
+      query: { locale: params.locale, limit: params.limit, category: params.category },
+      ...params.signal ? { signal: params.signal } : {}
+    });
+  }
+};
+
+// src/utils/query.ts
+function serializeQuery(values) {
+  const search = new URLSearchParams();
+  for (const [key, value] of Object.entries(values)) {
+    if (value !== void 0) search.append(key, String(value));
+  }
+  return search.toString();
+}
+
+// src/transport/transport.ts
+var RETRYABLE = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
+var Transport = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  async request(request) {
+    const query = request.query ? serializeQuery(request.query) : "";
+    const url = `${this.options.baseUrl}${request.path}${query ? `?${query}` : ""}`;
+    let lastError;
+    for (let attempt = 0; attempt <= this.options.retry.maxRetries; attempt += 1) {
+      try {
+        const response = await this.fetchOnce(url, request);
+        if (response.ok) return await this.decode(response);
+        if (RETRYABLE.has(response.status) && attempt < this.options.retry.maxRetries) {
+          await this.pause(this.retryDelay(response, attempt), request.signal);
+          continue;
+        }
+        throw await this.apiError(response);
+      } catch (error) {
+        if (error instanceof NewTqniaError) throw error;
+        if (this.wasCancelled(request.signal)) throw error;
+        if (this.isTimeout(error)) throw new TimeoutError(`Request timed out after ${this.options.timeout}ms`, { cause: error });
+        lastError = error;
+        if (attempt < this.options.retry.maxRetries) {
+          await this.pause(this.backoff(attempt), request.signal);
+          continue;
+        }
+      }
+    }
+    throw new NetworkError("Unable to reach the NewTqnia API.", { cause: lastError });
+  }
+  async fetchOnce(url, request) {
+    const timeout = AbortSignal.timeout(this.options.timeout);
+    const signals = [timeout, this.options.signal, request.signal].filter((signal2) => signal2 !== void 0);
+    const signal = this.combineSignals(signals);
+    const headers = new Headers(this.options.headers);
+    headers.set("Accept", "application/json");
+    headers.set("User-Agent", this.options.userAgent);
+    if (this.options.apiKey) headers.set("Authorization", `Bearer ${this.options.apiKey}`);
+    return this.options.fetch(url, { method: request.method, headers, signal: signal ?? null });
+  }
+  async decode(response) {
+    try {
+      return await response.json();
+    } catch (cause) {
+      throw new NewTqniaError("The API returned invalid JSON.", {
+        status: response.status,
+        requestId: this.requestId(response),
+        cause
+      });
+    }
+  }
+  async apiError(response) {
+    const data = await response.json().catch(() => ({}));
+    const message = typeof data.message === "string" ? data.message : `NewTqnia API request failed with status ${response.status}.`;
+    const retryAfter = this.parseRetryAfter(response.headers.get("retry-after"));
+    const options = {
+      status: response.status,
+      requestId: this.requestId(response),
+      retryAfter,
+      code: typeof data.code === "string" ? data.code : void 0
+    };
+    if (response.status === 401) return new AuthenticationError(message, options);
+    if (response.status === 403) return new AuthorizationError(message, options);
+    if (response.status === 404) return new NotFoundError(message, options);
+    if (response.status === 409) return new ConflictError(message, options);
+    if (response.status === 422 || response.status === 400) return new ValidationError(message, options);
+    if (response.status === 429) return new RateLimitError(message, options);
+    if (response.status >= 500) return new ServerError(message, options);
+    return new NewTqniaError(message, options);
+  }
+  retryDelay(response, attempt) {
+    return this.parseRetryAfter(response.headers.get("retry-after")) ?? this.backoff(attempt);
+  }
+  parseRetryAfter(value) {
+    if (!value) return void 0;
+    const seconds = Number(value);
+    if (Number.isFinite(seconds)) return Math.max(0, seconds * 1e3);
+    const date = Date.parse(value);
+    return Number.isNaN(date) ? void 0 : Math.max(0, date - Date.now());
+  }
+  backoff(attempt) {
+    const raw = this.options.retry.initialDelayMs * 2 ** attempt;
+    return Math.min(raw, this.options.retry.maxDelayMs);
+  }
+  async pause(ms, signal) {
+    await new Promise((resolve, reject) => {
+      const timer = setTimeout(resolve, ms);
+      signal?.addEventListener("abort", () => {
+        clearTimeout(timer);
+        reject(signal.reason);
+      }, { once: true });
+    });
+  }
+  requestId(response) {
+    return response.headers.get("x-request-id") ?? void 0;
+  }
+  combineSignals(signals) {
+    if (signals.length === 0) return void 0;
+    if (signals.length === 1) return signals[0];
+    const controller = new AbortController();
+    const abort = (signal) => {
+      if (!controller.signal.aborted) controller.abort(signal.reason);
+    };
+    for (const signal of signals) {
+      if (signal.aborted) {
+        abort(signal);
+        break;
+      }
+      signal.addEventListener("abort", () => abort(signal), { once: true });
+    }
+    return controller.signal;
+  }
+  wasCancelled(signal) {
+    return Boolean(signal?.aborted || this.options.signal?.aborted);
+  }
+  isTimeout(error) {
+    return error instanceof DOMException && (error.name === "TimeoutError" || error.name === "AbortError") && !this.options.signal?.aborted;
+  }
+};
+
+// src/client/client.ts
+var NewTqniaClient = class {
+  /** Localized news endpoints. */
+  news;
+  constructor(options = {}) {
+    const baseUrl = (options.baseUrl ?? "https://newtqnia.com").replace(/\/+$/, "");
+    this.validate(baseUrl, options.timeout);
+    const transport = new Transport({
+      ...options.apiKey ? { apiKey: options.apiKey } : {},
+      baseUrl,
+      timeout: options.timeout ?? 3e4,
+      fetch: options.fetch ?? globalThis.fetch.bind(globalThis),
+      retry: {
+        maxRetries: options.retry?.maxRetries ?? 2,
+        initialDelayMs: options.retry?.initialDelayMs ?? 500,
+        maxDelayMs: options.retry?.maxDelayMs ?? 8e3
+      },
+      userAgent: options.userAgent ?? "newtqnia-node/1.0.0",
+      headers: options.defaultHeaders ?? {},
+      ...options.signal ? { signal: options.signal } : {}
+    });
+    this.news = new NewsResource(transport);
+  }
+  validate(baseUrl, timeout) {
+    let url;
+    try {
+      url = new URL(baseUrl);
+    } catch {
+      throw new ValidationError("baseUrl must be an absolute HTTP(S) URL.");
+    }
+    if (!["http:", "https:"].includes(url.protocol)) throw new ValidationError("baseUrl must be an absolute HTTP(S) URL.");
+    const local = ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname);
+    if (url.protocol !== "https:" && !local) throw new ValidationError("baseUrl must use HTTPS except for local development.");
+    if (timeout !== void 0 && (!Number.isFinite(timeout) || timeout <= 0)) throw new ValidationError("timeout must be a positive number.");
+  }
+};
+
+export { AuthenticationError, AuthorizationError, ConflictError, NetworkError, NewTqniaClient, NewTqniaError, NotFoundError, RateLimitError, ServerError, TimeoutError, ValidationError };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/index.ts","../src/resources/news.ts","../src/utils/query.ts","../src/transport/transport.ts","../src/client/client.ts"],"names":["signal"],"mappings":"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","file":"index.js","sourcesContent":["export interface ErrorOptions {\n  status?: number | undefined;\n  requestId?: string | undefined;\n  retryAfter?: number | undefined;\n  code?: string | undefined;\n  cause?: unknown | undefined;\n}\n\n/** Base class for all SDK errors. */\nexport class NewTqniaError extends Error {\n  readonly status: number | undefined;\n  readonly requestId: string | undefined;\n  readonly retryAfter: number | undefined;\n  readonly code: string | undefined;\n\n  constructor(message: string, options: ErrorOptions = {}) {\n    super(message, options.cause === undefined ? undefined : { cause: options.cause });\n    this.name = new.target.name;\n    this.status = options.status;\n    this.requestId = options.requestId;\n    this.retryAfter = options.retryAfter;\n    this.code = options.code;\n  }\n}\nexport class AuthenticationError extends NewTqniaError {}\nexport class AuthorizationError extends NewTqniaError {}\nexport class ValidationError extends NewTqniaError {}\nexport class NotFoundError extends NewTqniaError {}\nexport class ConflictError extends NewTqniaError {}\nexport class RateLimitError extends NewTqniaError {}\nexport class ServerError extends NewTqniaError {}\nexport class TimeoutError extends NewTqniaError {}\nexport class NetworkError extends NewTqniaError {}\n","import { ValidationError } from \"../errors/index.js\";\nimport type { Digest, NewsListParams } from \"../models/index.js\";\nimport type { Transport } from \"../transport/transport.js\";\n\n/** Access localized NewTqnia news collections. */\nexport class NewsResource {\n  /** @internal */\n  constructor(private readonly transport: Transport) {}\n\n  /** Get articles published today using the Asia/Dubai day boundary. */\n  today(params: NewsListParams = {}): Promise<Digest> {\n    return this.get(\"today\", params);\n  }\n\n  /** Get the latest published articles. */\n  latest(params: NewsListParams = {}): Promise<Digest> {\n    return this.get(\"latest\", params);\n  }\n\n  private get(collection: \"today\" | \"latest\", params: NewsListParams): Promise<Digest> {\n    if (params.locale !== undefined && params.locale !== \"en\" && params.locale !== \"ar\") {\n      throw new ValidationError('locale must be \"en\" or \"ar\".');\n    }\n    if (params.limit !== undefined && (!Number.isInteger(params.limit) || params.limit < 1 || params.limit > 10)) {\n      throw new ValidationError(\"limit must be an integer between 1 and 10.\");\n    }\n    if (params.category !== undefined && params.category.trim() === \"\") {\n      throw new ValidationError(\"category cannot be empty.\");\n    }\n    return this.transport.request<Digest>({\n      method: \"GET\",\n      path: `/v1/news/${collection}`,\n      query: { locale: params.locale, limit: params.limit, category: params.category },\n      ...(params.signal ? { signal: params.signal } : {}),\n    });\n  }\n}\n","export function serializeQuery(values: Record<string, string | number | boolean | undefined>): string {\n  const search = new URLSearchParams();\n  for (const [key, value] of Object.entries(values)) {\n    if (value !== undefined) search.append(key, String(value));\n  }\n  return search.toString();\n}\n","import {\n  AuthenticationError, AuthorizationError, ConflictError, NetworkError, NewTqniaError,\n  NotFoundError, RateLimitError, ServerError, TimeoutError, ValidationError,\n} from \"../errors/index.js\";\nimport { serializeQuery } from \"../utils/query.js\";\nimport type { Fetch, RequestOptions, RetryOptions } from \"./types.js\";\n\nconst RETRYABLE = new Set([429, 500, 502, 503, 504]);\n\nexport interface TransportOptions {\n  apiKey?: string;\n  baseUrl: string;\n  timeout: number;\n  fetch: Fetch;\n  retry: Required<RetryOptions>;\n  userAgent: string;\n  headers: Record<string, string>;\n  signal?: AbortSignal;\n}\n\nexport class Transport {\n  constructor(private readonly options: TransportOptions) {}\n\n  async request<T>(request: RequestOptions): Promise<T> {\n    const query = request.query ? serializeQuery(request.query) : \"\";\n    const url = `${this.options.baseUrl}${request.path}${query ? `?${query}` : \"\"}`;\n    let lastError: unknown;\n\n    for (let attempt = 0; attempt <= this.options.retry.maxRetries; attempt += 1) {\n      try {\n        const response = await this.fetchOnce(url, request);\n        if (response.ok) return await this.decode<T>(response);\n        if (RETRYABLE.has(response.status) && attempt < this.options.retry.maxRetries) {\n          await this.pause(this.retryDelay(response, attempt), request.signal);\n          continue;\n        }\n        throw await this.apiError(response);\n      } catch (error) {\n        if (error instanceof NewTqniaError) throw error;\n        if (this.wasCancelled(request.signal)) throw error;\n        if (this.isTimeout(error)) throw new TimeoutError(`Request timed out after ${this.options.timeout}ms`, { cause: error });\n        lastError = error;\n        if (attempt < this.options.retry.maxRetries) {\n          await this.pause(this.backoff(attempt), request.signal);\n          continue;\n        }\n      }\n    }\n    throw new NetworkError(\"Unable to reach the NewTqnia API.\", { cause: lastError });\n  }\n\n  private async fetchOnce(url: string, request: RequestOptions): Promise<Response> {\n    const timeout = AbortSignal.timeout(this.options.timeout);\n    const signals = [timeout, this.options.signal, request.signal].filter((signal): signal is AbortSignal => signal !== undefined);\n    const signal = this.combineSignals(signals);\n    const headers = new Headers(this.options.headers);\n    headers.set(\"Accept\", \"application/json\");\n    headers.set(\"User-Agent\", this.options.userAgent);\n    if (this.options.apiKey) headers.set(\"Authorization\", `Bearer ${this.options.apiKey}`);\n    return this.options.fetch(url, { method: request.method, headers, signal: signal ?? null });\n  }\n\n  private async decode<T>(response: Response): Promise<T> {\n    try {\n      return await response.json() as T;\n    } catch (cause) {\n      throw new NewTqniaError(\"The API returned invalid JSON.\", {\n        status: response.status, requestId: this.requestId(response), cause,\n      });\n    }\n  }\n\n  private async apiError(response: Response): Promise<NewTqniaError> {\n    const data = await response.json().catch(() => ({})) as Record<string, unknown>;\n    const message = typeof data.message === \"string\" ? data.message : `NewTqnia API request failed with status ${response.status}.`;\n    const retryAfter = this.parseRetryAfter(response.headers.get(\"retry-after\"));\n    const options = {\n      status: response.status,\n      requestId: this.requestId(response),\n      retryAfter,\n      code: typeof data.code === \"string\" ? data.code : undefined,\n    };\n    if (response.status === 401) return new AuthenticationError(message, options);\n    if (response.status === 403) return new AuthorizationError(message, options);\n    if (response.status === 404) return new NotFoundError(message, options);\n    if (response.status === 409) return new ConflictError(message, options);\n    if (response.status === 422 || response.status === 400) return new ValidationError(message, options);\n    if (response.status === 429) return new RateLimitError(message, options);\n    if (response.status >= 500) return new ServerError(message, options);\n    return new NewTqniaError(message, options);\n  }\n\n  private retryDelay(response: Response, attempt: number): number {\n    return this.parseRetryAfter(response.headers.get(\"retry-after\")) ?? this.backoff(attempt);\n  }\n  private parseRetryAfter(value: string | null): number | undefined {\n    if (!value) return undefined;\n    const seconds = Number(value);\n    if (Number.isFinite(seconds)) return Math.max(0, seconds * 1000);\n    const date = Date.parse(value);\n    return Number.isNaN(date) ? undefined : Math.max(0, date - Date.now());\n  }\n  private backoff(attempt: number): number {\n    const raw = this.options.retry.initialDelayMs * (2 ** attempt);\n    return Math.min(raw, this.options.retry.maxDelayMs);\n  }\n  private async pause(ms: number, signal?: AbortSignal): Promise<void> {\n    await new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(resolve, ms);\n      signal?.addEventListener(\"abort\", () => { clearTimeout(timer); reject(signal.reason); }, { once: true });\n    });\n  }\n  private requestId(response: Response): string | undefined {\n    return response.headers.get(\"x-request-id\") ?? undefined;\n  }\n  private combineSignals(signals: AbortSignal[]): AbortSignal | undefined {\n    if (signals.length === 0) return undefined;\n    if (signals.length === 1) return signals[0];\n    const controller = new AbortController();\n    const abort = (signal: AbortSignal) => {\n      if (!controller.signal.aborted) controller.abort(signal.reason);\n    };\n    for (const signal of signals) {\n      if (signal.aborted) {\n        abort(signal);\n        break;\n      }\n      signal.addEventListener(\"abort\", () => abort(signal), { once: true });\n    }\n    return controller.signal;\n  }\n  private wasCancelled(signal?: AbortSignal): boolean {\n    return Boolean(signal?.aborted || this.options.signal?.aborted);\n  }\n  private isTimeout(error: unknown): boolean {\n    return error instanceof DOMException && (error.name === \"TimeoutError\" || error.name === \"AbortError\")\n      && !this.options.signal?.aborted;\n  }\n}\n","import { ValidationError } from \"../errors/index.js\";\nimport { NewsResource } from \"../resources/news.js\";\nimport { Transport } from \"../transport/transport.js\";\nimport type { Fetch, RetryOptions } from \"../transport/types.js\";\n\nexport interface NewTqniaClientOptions {\n  /** Optional bearer API key. */\n  apiKey?: string;\n  /** API origin. @default \"https://newtqnia.com\" */\n  baseUrl?: string;\n  /** Request timeout in milliseconds. @default 30000 */\n  timeout?: number;\n  /** Cancels every request made by this client. */\n  signal?: AbortSignal;\n  /** Custom Fetch-compatible implementation. */\n  fetch?: Fetch;\n  /** Retry behavior for rate limits, server errors, and temporary network failures. */\n  retry?: RetryOptions;\n  /** User-Agent header. @default \"newtqnia-node/1.0.0\" */\n  userAgent?: string;\n  /** Headers included with every request. */\n  defaultHeaders?: Record<string, string>;\n}\n\n/** Official NewTqnia API client. */\nexport class NewTqniaClient {\n  /** Localized news endpoints. */\n  readonly news: NewsResource;\n\n  constructor(options: NewTqniaClientOptions = {}) {\n    const baseUrl = (options.baseUrl ?? \"https://newtqnia.com\").replace(/\\/+$/, \"\");\n    this.validate(baseUrl, options.timeout);\n    const transport = new Transport({\n      ...(options.apiKey ? { apiKey: options.apiKey } : {}),\n      baseUrl,\n      timeout: options.timeout ?? 30_000,\n      fetch: options.fetch ?? globalThis.fetch.bind(globalThis),\n      retry: {\n        maxRetries: options.retry?.maxRetries ?? 2,\n        initialDelayMs: options.retry?.initialDelayMs ?? 500,\n        maxDelayMs: options.retry?.maxDelayMs ?? 8_000,\n      },\n      userAgent: options.userAgent ?? \"newtqnia-node/1.0.0\",\n      headers: options.defaultHeaders ?? {},\n      ...(options.signal ? { signal: options.signal } : {}),\n    });\n    this.news = new NewsResource(transport);\n  }\n\n  private validate(baseUrl: string, timeout?: number): void {\n    let url: URL;\n    try { url = new URL(baseUrl); } catch { throw new ValidationError(\"baseUrl must be an absolute HTTP(S) URL.\"); }\n    if (![\"http:\", \"https:\"].includes(url.protocol)) throw new ValidationError(\"baseUrl must be an absolute HTTP(S) URL.\");\n    const local = [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(url.hostname);\n    if (url.protocol !== \"https:\" && !local) throw new ValidationError(\"baseUrl must use HTTPS except for local development.\");\n    if (timeout !== undefined && (!Number.isFinite(timeout) || timeout <= 0)) throw new ValidationError(\"timeout must be a positive number.\");\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "newtqnia-node",
+  "version": "1.0.0",
+  "description": "Official Node.js and TypeScript SDK for the NewTqnia technology news API",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "docs/images",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "generate": "openapi-typescript openapi/openapi.yaml -o src/generated/schema.ts",
+    "openapi:check": "node scripts/check-openapi.mjs",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "test": "vitest run --coverage",
+    "docs": "typedoc",
+    "check": "npm run generate && npm run typecheck && npm run lint && npm test && npm run build"
+  },
+  "keywords": [
+    "newtqnia",
+    "news",
+    "technology",
+    "typescript",
+    "sdk"
+  ],
+  "author": "NewTqnia <hello@newtqnia.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/newtqnia/newtqnia-node.git"
+  },
+  "homepage": "https://newtqnia.com/en/developers",
+  "bugs": {
+    "url": "https://github.com/newtqnia/newtqnia-node/issues"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^3.0.0",
+    "eslint": "^9.0.0",
+    "openapi-typescript": "^7.0.0",
+    "tsup": "^8.0.0",
+    "typedoc": "^0.28.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.0.0",
+    "vitest": "^3.0.0",
+    "yaml": "^2.9.0"
+  }
+}