@nextxai/sdk 0.0.0-stage → 0.1.0-beta.5

package/dist/cjs/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION = "0.1.0-beta.5";

package/dist/cjs/version.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = void 0;
+exports.VERSION = "0.1.0-beta.5";

package/dist/esm/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * NextX SDK cho Node.js/TypeScript. Kiểu `paths` sinh từ https://developers.nextx.vn/openapi.json — chỉ gồm các tuyến
+ * đối tác gọi được — nên trình soạn thảo gợi đúng đường, tham số và hình dạng phản hồi.
+ *
+ *   const nx = createNextXClient({ apiKey: process.env.NEXTX_API_KEY! });
+ *   const { data, error } = await nx.GET("/api/v1/crm/contacts", { params: { query: { pageSize: 20 } } });
+ */
+import { type Client } from "openapi-fetch";
+import type { paths } from "./schema.js";
+import { VERSION } from "./version.js";
+export type { paths, components, operations } from "./schema.js";
+export { VERSION };
+export declare const PROD_URL = "https://api.nextx.vn";
+export declare const SANDBOX_URL = "https://api-dev.nextx.vn";
+export type NextXOptions = {
+    /** Mặc định prod; thử nghiệm dùng `SANDBOX_URL` (khoá sandbox không gọi được prod và ngược lại). */
+    baseUrl?: string;
+    /** Ngôn ngữ thông báo lỗi: `vi` (mặc định) hoặc `en`. */
+    language?: "vi" | "en";
+    /** Thay fetch (proxy, đo đạc, kiểm thử). */
+    fetch?: typeof globalThis.fetch;
+} & (
+/** Khoá API của workspace (`nxk_…`) — gửi ở header `X-Api-Key`. */
+{
+    apiKey: string;
+    accessToken?: never;
+}
+/** Access token OAuth 2.0 của ứng dụng đối tác — gửi `Authorization: Bearer`; có thể là hàm để lấy token mới mỗi lần gọi. */
+ | {
+    accessToken: string | (() => string | Promise<string>);
+    apiKey?: never;
+});
+export type NextXClient = Client<paths>;
+/** Lỗi theo RFC 7807 mà API trả về khi `error` khác rỗng. */
+export interface NextXProblem {
+    type?: string;
+    title?: string;
+    status?: number;
+    detail?: string;
+    traceId?: string;
+    errors?: Record<string, string[]> | string[] | null;
+}
+export declare function createNextXClient(opts: NextXOptions): NextXClient;

package/dist/esm/index.js

@@ -0,0 +1,38 @@
+/**
+ * NextX SDK cho Node.js/TypeScript. Kiểu `paths` sinh từ https://developers.nextx.vn/openapi.json — chỉ gồm các tuyến
+ * đối tác gọi được — nên trình soạn thảo gợi đúng đường, tham số và hình dạng phản hồi.
+ *
+ *   const nx = createNextXClient({ apiKey: process.env.NEXTX_API_KEY! });
+ *   const { data, error } = await nx.GET("/api/v1/crm/contacts", { params: { query: { pageSize: 20 } } });
+ */
+import createClient from "openapi-fetch";
+import { VERSION } from "./version.js";
+export { VERSION };
+export const PROD_URL = "https://api.nextx.vn";
+export const SANDBOX_URL = "https://api-dev.nextx.vn";
+export function createNextXClient(opts) {
+    const { baseUrl = PROD_URL, language = "vi", fetch } = opts;
+    if (!opts.apiKey && !opts.accessToken)
+        throw new Error("NextX SDK: cần apiKey hoặc accessToken");
+    const client = createClient({
+        baseUrl: baseUrl.replace(/\/+$/, ""),
+        fetch,
+        headers: {
+            "Accept-Language": language,
+            // Trình duyệt tự bỏ User-Agent nên chỉ có tác dụng phía máy chủ.
+            "User-Agent": `nextx-sdk-node/${VERSION}`,
+            ...(opts.apiKey ? { "X-Api-Key": opts.apiKey } : {}),
+        },
+    });
+    const token = opts.accessToken;
+    if (token) {
+        const auth = {
+            async onRequest({ request }) {
+                request.headers.set("Authorization", `Bearer ${typeof token === "function" ? await token() : token}`);
+                return request;
+            },
+        };
+        client.use(auth);
+    }
+    return client;
+}