@datviet/nbp-sdk 0.0.327 → 0.0.329

package/README.md

@@ -26,16 +26,19 @@ Khoá gắn chết vào một workspace — không cần gửi `X-Workspace-ID`,
 ```ts
 import { createOpencodeClient } from "@datviet/nbp-sdk/v2/client"
 
-const nbp = createOpencodeClient({
+const client = createOpencodeClient({
   baseUrl: "https://nbp.datviet.ai",
   headers: { Authorization: `Bearer ${process.env.NBP_API_KEY}` },
   throwOnError: true,
 })
 
-const listings = await nbp.listings.list({ limit: 20 })
-const clients = await nbp.clients.list({ limit: 20 })
+const listings = await client.nbp.listings.list({ limit: 20 })
+const clients = await client.nbp.clients.list({ limit: 20 })
 ```
 
+Endpoint bất động sản nằm dưới namespace `nbp` (`client.nbp.listings`, `client.nbp.clients`,
+`client.nbp.tasks`…); còn `workspaces`, `session`, `agent` nằm thẳng ở gốc.
+
 Tham số đi **phẳng** — không bọc `query` / `body`. SDK tự xếp cái nào vào query, cái nào vào body.
 
 Hai mức quyền, chọn lúc tạo khoá:
@@ -60,7 +63,7 @@ const auth = createNbpAuth({
   redirectURI: `${location.origin}/auth/callback`,
 })
 
-const nbp = createOpencodeClient({ baseUrl: "https://nbp.datviet.ai", fetch: auth.fetch })
+const client = createOpencodeClient({ baseUrl: "https://nbp.datviet.ai", fetch: auth.fetch })
 
 // Nút đăng nhập
 await auth.login()
@@ -70,7 +73,7 @@ const params = new URLSearchParams(location.search)
 const ok = await auth.handleCallback(params.get("code")!, params.get("state") ?? undefined)
 
 // Chọn workspace rồi mọi request sau đó tự mang X-Workspace-ID
-const ws = await nbp.workspaces.list()
+const ws = await client.workspaces.list()
 auth.setWorkspace(ws.data!.data[0]!.id)
 ```
 
@@ -94,7 +97,7 @@ CORS đã mở cho `*.datviet.ai`, `*.ankapong.com` và mọi `http://localhost:
 
 ```ts
 // Tin mới nhất, có ảnh, nhà phố dưới 10 tỷ ở Quận 2
-const res = await nbp.listings.list({
+const res = await client.nbp.listings.list({
   limit: 12,
   sortBy: "time_created",
   sortDirection: "desc",
@@ -105,17 +108,17 @@ const res = await nbp.listings.list({
 })
 
 // Tạo tin (khoá phải là "Đọc & ghi")
-await nbp.listings.create({
+await client.nbp.listings.create({
   price: 8_500_000_000,
   tags: { category: "sale", property_type: "house", district: "Quận 2", area: 80 },
 })
 
 // Quản lý khoá API — chỉ JWT của owner/admin gọi được, khoá `sk-` bị chặn 403
-await nbp.workspaces.apiKeys.list({ id: workspaceID })
+await client.workspaces.apiKeys.list({ id: workspaceID })
 ```
 
 Tag lưu trong DB bằng **key tiếng Anh** (`"house"`), UI hiện nhãn Việt (`"Nhà phố"`) — nhớ gửi key.
 
 ## Bản `v2` vs bản gốc
 
-`@datviet/nbp-sdk/v2/client` là bản đang dùng (client theo class, `nbp.listings.list()`). Export ở root (`@datviet/nbp-sdk`) là bản cũ kế thừa từ opencode, giữ cho tương thích — code mới dùng `/v2/client`.
+`@datviet/nbp-sdk/v2/client` là bản đang dùng (client theo class, `client.nbp.listings.list()`). Export ở root (`@datviet/nbp-sdk`) là bản cũ kế thừa từ opencode, giữ cho tương thích — code mới dùng `/v2/client`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datviet/nbp-sdk",
-  "version": "0.0.327",
+  "version": "0.0.329",
   "description": "TypeScript SDK cho NBP API (nbp.datviet.ai) — listings, clients, tasks, agent sessions.",
   "license": "MIT",
   "type": "module",

package/v2/gen/sdk.gen.d.ts

@@ -1350,6 +1350,7 @@ export declare class Clients extends HeyApiClient {
     interactionsFeed<ThrowOnError extends boolean = false>(parameters?: {
         directory?: string;
         limit?: number;
+        offset?: number;
     }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<NbpClientsInteractionsFeedResponses, unknown, ThrowOnError, "fields">;
     /**
      * List clients

package/v2/gen/sdk.gen.js

@@ -1371,6 +1371,7 @@ export class Clients extends HeyApiClient {
                 args: [
                     { in: "query", key: "directory" },
                     { in: "query", key: "limit" },
+                    { in: "query", key: "offset" },
                 ],
             },
         ]);

package/v2/gen/types.gen.d.ts

@@ -1191,6 +1191,7 @@ export type Task = {
     clientId?: string | null;
     clientName?: string | null;
     listingId?: string | null;
+    listingCode?: string | null;
     createdAt: string;
     updatedAt: string;
 };
@@ -6208,6 +6209,7 @@ export type NbpClientsStatsResponses = {
         bySourceChannel: {
             [key: string]: number;
         };
+        pipelineValue: number;
     };
 };
 export type NbpClientsStatsResponse = NbpClientsStatsResponses[keyof NbpClientsStatsResponses];
@@ -6234,6 +6236,7 @@ export type NbpClientsInteractionsFeedData = {
     query?: {
         directory?: string;
         limit?: number;
+        offset?: number;
     };
     url: "/nbp/clients/interactions";
 };