@bzbs/react-api-client 2.0.3 → 2.1.1

package/README.md

@@ -2,7 +2,7 @@
 
 A TypeScript library providing a type-safe API client for Buzzebees loyalty and reward services. Supports authentication, campaigns, user profiles, shopping carts, notifications, stamps, consent management, and more.
 
-**Version:** 1.4.15 | **License:** ISC | **Author:** Buzzebees Co., Ltd.
+**Version:** 2.1.0 | **License:** ISC | **Author:** Buzzebees Co., Ltd.
 **Repository:** [Azure DevOps](https://dev.azure.com/buzzebees/Buzzebees/_git/React_API_Client)
 
 ---
@@ -34,6 +34,7 @@ A TypeScript library providing a type-safe API client for Buzzebees loyalty and
   - [LineApi](#lineapi)
   - [PlaceApi](#placeapi)
   - [PointLogApi](#pointlogapi)
+  - [PointApi](#pointapi)
   - [StampApi](#stampapi)
   - [RequestHelpApi (Forum)](#requesthelpapi-forum)
   - [SettingApi](#settingapi)
@@ -180,6 +181,7 @@ BzbsService (entry point)
  ├── NotificationApi     → notification/
  ├── PlaceApi            → place/
  ├── PointLogApi         → log/points
+ ├── PointApi            → point/
  ├── ProfileApi          → profile/
  ├── RegistrationApi     → auth/register
  ├── AddressApi          → profile/address, address/
@@ -224,6 +226,7 @@ src/
 │   ├── notification/notification-api.ts
 │   ├── place/place-api.ts
 │   ├── point-log/point-log-api.ts
+│   ├── points/point-api.ts
 │   ├── profile/profile-api.ts
 │   ├── registration/registration-api.ts
 │   ├── request-help/request-help-api.ts
@@ -252,6 +255,7 @@ src/
 | `notificationApi` | `NotificationApi` | Push notifications |
 | `placeApi` | `PlaceApi` | Locations / stores |
 | `pointLogApi` | `PointLogApi` | Point transaction logs |
+| `pointApi` | `PointApi` | Multi-unit point balances and transaction history |
 | `profileApi` | `ProfileApi` | User profile, points, account |
 | `registerApi` | `RegistrationApi` | User registration |
 | `addressApi` | `AddressApi` | Addresses, provinces, districts |
@@ -396,6 +400,9 @@ const response = await bzbsService.profileApi.profile(undefined, {
 | `placeApi` | `addToFavourite` | POST | `place/{id}/favourite` | id | `unknown` | `#place` |
 | `placeApi` | `removeFromFavourite` | POST | `place/{id}/unfavourite` | id | `unknown` | `#place` |
 | `pointLogApi` | `getPointLog` | GET | `log/points` | month; opt: type, lastRowKey, top | `PointLog[]` | `#points #profile` |
+| `pointApi` | `balance` | GET | `point/balance` | opt: units, boxIds, onlyVisible | `PointBalance[]` | `#points` |
+| `pointApi` | `detail` | GET | `point/detail` | opt: units, boxIds, onlyVisible | `PointBalance[]` | `#points` |
+| `pointApi` | `history` | GET | `point/history` | start, end; opt: onlyVisible, skip, top, sortType, units, boxIds, references, transactionIds, includeActions, excludeActions, includeTypes, excludeTypes | `PointHistory[]` | `#points` |
 | `profileApi` | `profile` | GET | `profile/info` | opt: options | `ProfileResponse` | `#profile` |
 | `profileApi` | `updateProfile` | POST | `profile/info` | opt: firstName, lastName, contactNumber, email, notification, locale, title, gender, birthDate, address, subdistrictCode, districtCode, provinceCode, countryCode, zipCode, idCard, passport, maritalStatus, displayName, latitude, longitude, income, interests, region, occupation, remark, ... (JSON body) | `ProfileResponse` | `#profile` |
 | `profileApi` | `updateProfileImage` | POST | `profile/picture` | image (File or `{uri, name, type}`, sent as `multipart/form-data` with key `data`) | `ProfileResponse` | `#profile` |
@@ -910,6 +917,65 @@ const logs = await bzbsService.pointLogApi.getPointLog({
 
 ---
 
+### PointApi
+
+`bzbsService.pointApi` — Multi-unit point balances, breakdowns, and transaction history (earn/burn/transfer).
+
+| Method | Description | Returns |
+|---|---|---|
+| `balance(params?)` | Current point balance for the user across requested units | `PointBalance[]` |
+| `detail(params?)` | Point balance with `Currents` and `Expires` breakdowns keyed by date | `PointBalance[]` |
+| `history(params)` | Paginated list of earn/burn/transfer transactions in a date range | `PointHistory[]` |
+
+**Common params (`balance` / `detail`):**
+
+| Param | Type | Required | Description |
+|---|---|---|---|
+| `units` | `string` | No | Point unit codes (e.g. `Point`, `Coin`). Omit for all configured units. Sent as `units[]`. |
+| `boxIds` | `string` | No | Box (sub-bucket) identifiers. Sent as `boxIds[]`. |
+| `onlyVisible` | `boolean` | No | When `true` (default), only units marked visible for the app are considered. |
+
+**`history` params:**
+
+| Param | Type | Required | Description |
+|---|---|---|---|
+| `start` | `string` | Yes | Start of the range (inclusive), ISO-8601 with offset |
+| `end` | `string` | Yes | End of the range (inclusive), ISO-8601 with offset |
+| `skip` | `number` | No | Offset pagination |
+| `top` | `number` | No | Maximum records to return |
+| `sortType` | `'Asc' \| 'Desc'` | No | Sort direction by `Timestamp` |
+| `units` | `string` | No | Filter by point unit codes (sent as `units[]`) |
+| `boxIds` | `string` | No | Filter by box ids (sent as `boxIds[]`) |
+| `references` | `string` | No | Filter by transaction reference (sent as `references[]`) |
+| `transactionIds` | `string` | No | Filter by exact transaction ids (sent as `transactionIds[]`) |
+| `includeActions` | `string` | No | Only include actions (e.g. `Earn`, `Burn`, `Transfer`) — sent as `includeActions[]` |
+| `excludeActions` | `string` | No | Exclude actions — sent as `excludeActions[]` |
+| `includeTypes` | `string` | No | Only include types — sent as `includeTypes[]` |
+| `excludeTypes` | `string` | No | Exclude types — sent as `excludeTypes[]` |
+| `onlyVisible` | `boolean` | No | Restrict to visible units (default `true`) |
+
+```typescript
+// Current balance across all configured units
+const balance = await bzbsService.pointApi.balance();
+
+// Specific units only
+const coinBalance = await bzbsService.pointApi.balance({ units: 'Coin' });
+
+// Balance with current/expiring breakdowns
+const detail = await bzbsService.pointApi.detail({ onlyVisible: true });
+
+// Paginated transaction history
+const history = await bzbsService.pointApi.history({
+  start: '2025-01-01T00:00:00+07:00',
+  end: '2025-01-31T23:59:59+07:00',
+  top: 50,
+  sortType: 'Desc',
+  includeActions: 'Earn',
+});
+```
+
+---
+
 ### StampApi
 
 `bzbsService.stampApi` — Stamp card system.
@@ -1064,6 +1130,8 @@ import {
 | `Badge` | badgeId, name, description, imageUrl, missions (Mission[]) |
 | `Mission` | missionId, name, current, target, isCompleted |
 | `PointLog` | UserId, Info, Detail, Points, Type, Timestamp |
+| `PointBalance` | Unit, Balance, Currents (date → amount map), Expires (date → amount map) |
+| `PointHistory` | Unit, TransactionId, Reference, Timestamp, TotalChange, Action, Type, Message, Data |
 
 ### Address & Location Models
 

package/dist/index.d.mts

@@ -1252,6 +1252,31 @@ interface ConsentVersionValue {
     current_version: string;
 }
 
+interface PointBalance {
+    Unit: string;
+    Balance: number;
+    Currents?: {
+        [date: string]: number;
+    };
+    Expires?: {
+        [date: string]: number;
+    };
+}
+
+interface PointHistory {
+    Unit: string;
+    TransactionId: string;
+    Reference: string;
+    Timestamp: number;
+    TotalChange: number;
+    Action: string;
+    Type: string;
+    Message: string | null;
+    Data: {
+        [key: string]: any;
+    } | null;
+}
+
 declare class AuthenticateApi extends BaseService {
     constructor(client: AxiosInstance, baseUrl: string);
     /**
@@ -1935,6 +1960,7 @@ declare class CampaignApi extends BaseService {
      * @param params.contactNumber - The contact number of the user.
      * @param params.options - Additional options for the redemption.
      * @param params.spPoints - Point Per Unit x Quantity (Donate only).
+     * @param params.pointUnit - The point unit of the campaign (Point Service Only).
      * @param requestOptions - The options for the HTTP request.
      * @returns A promise that resolves to a service response containing the redeem response.
      */
@@ -2402,6 +2428,89 @@ declare class PointLogApi extends BaseService {
     }, requestOption?: RequestOptions): Promise<ServiceResponse<PointLog[]>>;
 }
 
+declare class PointApi extends BaseService {
+    constructor(client: AxiosInstance, baseUrl: string);
+    /**
+     * Retrieves the current point balance for the authenticated user across the requested point units.
+     *
+     * @param params - The parameters for retrieving the point balance.
+     * @param params.units - (Optional) Point unit codes (e.g. Point, Coin). Omit to use all units configured for the app.
+     * @param params.boxIds - (Optional) Box (sub-bucket) identifiers to filter by.
+     * @param params.onlyVisible - (Optional) When true (default), only units marked visible for the app are considered.
+     * @param params.options - (Optional) Additional options for the request.
+     * @param requestOptions - (Optional) The request options.
+     * @returns A promise that resolves to a service response containing an array of point balances.
+     */
+    balance(params?: {
+        units?: string;
+        boxIds?: string;
+        onlyVisible?: boolean;
+        options?: {
+            [key: string]: unknown;
+        };
+    }, requestOptions?: RequestOptions): Promise<ServiceResponse<PointBalance[]>>;
+    /**
+     * Retrieves the point balance with Currents and Expires breakdowns keyed by date.
+     *
+     * @param params - The parameters for retrieving the point detail.
+     * @param params.units - (Optional) Point unit codes (e.g. Point, Coin). Omit to use all units configured for the app.
+     * @param params.boxIds - (Optional) Box (sub-bucket) identifiers to filter by.
+     * @param params.onlyVisible - (Optional) When true (default), only units marked visible for the app are considered.
+     * @param params.options - (Optional) Additional options for the request.
+     * @param requestOptions - (Optional) The request options.
+     * @returns A promise that resolves to a service response containing an array of point balances with breakdowns.
+     */
+    detail(params?: {
+        units?: string;
+        boxIds?: string;
+        onlyVisible?: boolean;
+        options?: {
+            [key: string]: unknown;
+        };
+    }, requestOptions?: RequestOptions): Promise<ServiceResponse<PointBalance[]>>;
+    /**
+     * Retrieves a paginated list of earn/burn/transfer transactions between start and end dates.
+     *
+     * @param params - The parameters for retrieving the point history.
+     * @param params.start - Start of the range (inclusive), ISO-8601 with offset.
+     * @param params.end - End of the range (inclusive), ISO-8601 with offset.
+     * @param params.onlyVisible - (Optional) When true (default), only units marked visible for the app are considered.
+     * @param params.skip - (Optional) Number of records to skip (offset pagination).
+     * @param params.top - (Optional) Maximum number of records to return.
+     * @param params.sortType - (Optional) Sort direction for Timestamp: Asc|Desc.
+     * @param params.units - (Optional) Point unit codes to filter by.
+     * @param params.boxIds - (Optional) Box (sub-bucket) identifiers to filter by.
+     * @param params.references - (Optional) Filter by transaction reference.
+     * @param params.transactionIds - (Optional) Filter by exact transaction IDs.
+     * @param params.includeActions - (Optional) Only include transactions whose Action matches (e.g. Earn, Burn, Transfer).
+     * @param params.excludeActions - (Optional) Exclude transactions whose Action matches.
+     * @param params.includeTypes - (Optional) Only include transactions whose Type matches.
+     * @param params.excludeTypes - (Optional) Exclude transactions whose Type matches.
+     * @param params.options - (Optional) Additional options for the request.
+     * @param requestOptions - (Optional) The request options.
+     * @returns A promise that resolves to a service response containing an array of point history transactions.
+     */
+    history(params: {
+        start: string;
+        end: string;
+        onlyVisible?: boolean;
+        skip?: number;
+        top?: number;
+        sortType?: 'Asc' | 'Desc';
+        units?: string;
+        boxIds?: string;
+        references?: string;
+        transactionIds?: string;
+        includeActions?: string;
+        excludeActions?: string;
+        includeTypes?: string;
+        excludeTypes?: string;
+        options?: {
+            [key: string]: unknown;
+        };
+    }, requestOptions?: RequestOptions): Promise<ServiceResponse<PointHistory[]>>;
+}
+
 declare class ProfileApi extends BaseService {
     constructor(client: AxiosInstance, baseUrl: string);
     /**
@@ -3143,6 +3252,7 @@ declare class BzbsService {
     notificationApi: NotificationApi;
     placeApi: PlaceApi;
     pointLogApi: PointLogApi;
+    pointApi: PointApi;
     profileApi: ProfileApi;
     registerApi: RegistrationApi;
     addressApi: AddressApi;
@@ -3156,4 +3266,4 @@ declare class BzbsService {
     setLineUrl(lineUrl: string): this;
 }
 
-export { type AccessTokenResponse, type Address, AddressApi, type ApiResponse, type AppleToken, AuthenticateApi, type Badge, BadgeApi, BaseService, Blob, type Buzzebees, type BzbsErrorResponse, BzbsService, type Campaign, CampaignApi, type CampaignDetail, type CartAccessResponse, CartApi, type CartCountResponse, type Category, CategoryApi, type ChatMessage, type ClientError, type ConfirmOtpResponse, type Consent, ConsentApi, type ConsentVersion, type ConsentVersionValue, CouponApi, type CouponResponse, type CouponResponseData, type CreateStampResponse, type CrossPlatformFile, type Dashboard, DashboardApi, type Detail, type District, type ErrorResponse, type ExpiringPoints, type FavoriteResponse, type ForgetPasswordResponse, HistoryApi, type LikeForumResponse, LineApi, type LineAuthResponse, type LoginResponse, type Maintenance, type Mission, type Notification, NotificationApi, type OtpResponse, type Picture, type Place, PlaceApi, type PlaceService, type PointLog, PointLogApi, type PointUnit, ProfileApi, type ProfileResponse, type Province, type Purchase, type RedeemResponse, RegistrationApi, type RegistrationResponse, RequestHelpApi, type RequestHelpCode, type RequestOptions, type ResumeResponse, type ServerError, type ServiceResponse, SettingApi, type Stamp, StampApi, type StampCampaign, type StampHistory, type StampProfileResponse, type StatusResponse, type Style, type SubCampaign, type SubCampaignStyle, type SubDistrict, type SuccessResponse, type Trace, type UpdatedPoints, type UseCampaignResponse, type ValidateOtpResponse, type Version, type ZipCode };
+export { type AccessTokenResponse, type Address, AddressApi, type ApiResponse, type AppleToken, AuthenticateApi, type Badge, BadgeApi, BaseService, Blob, type Buzzebees, type BzbsErrorResponse, BzbsService, type Campaign, CampaignApi, type CampaignDetail, type CartAccessResponse, CartApi, type CartCountResponse, type Category, CategoryApi, type ChatMessage, type ClientError, type ConfirmOtpResponse, type Consent, ConsentApi, type ConsentVersion, type ConsentVersionValue, CouponApi, type CouponResponse, type CouponResponseData, type CreateStampResponse, type CrossPlatformFile, type Dashboard, DashboardApi, type Detail, type District, type ErrorResponse, type ExpiringPoints, type FavoriteResponse, type ForgetPasswordResponse, HistoryApi, type LikeForumResponse, LineApi, type LineAuthResponse, type LoginResponse, type Maintenance, type Mission, type Notification, NotificationApi, type OtpResponse, type Picture, type Place, PlaceApi, type PlaceService, PointApi, type PointBalance, type PointHistory, type PointLog, PointLogApi, type PointUnit, ProfileApi, type ProfileResponse, type Province, type Purchase, type RedeemResponse, RegistrationApi, type RegistrationResponse, RequestHelpApi, type RequestHelpCode, type RequestOptions, type ResumeResponse, type ServerError, type ServiceResponse, SettingApi, type Stamp, StampApi, type StampCampaign, type StampHistory, type StampProfileResponse, type StatusResponse, type Style, type SubCampaign, type SubCampaignStyle, type SubDistrict, type SuccessResponse, type Trace, type UpdatedPoints, type UseCampaignResponse, type ValidateOtpResponse, type Version, type ZipCode };

package/dist/index.d.ts

@@ -1252,6 +1252,31 @@ interface ConsentVersionValue {
     current_version: string;
 }
 
+interface PointBalance {
+    Unit: string;
+    Balance: number;
+    Currents?: {
+        [date: string]: number;
+    };
+    Expires?: {
+        [date: string]: number;
+    };
+}
+
+interface PointHistory {
+    Unit: string;
+    TransactionId: string;
+    Reference: string;
+    Timestamp: number;
+    TotalChange: number;
+    Action: string;
+    Type: string;
+    Message: string | null;
+    Data: {
+        [key: string]: any;
+    } | null;
+}
+
 declare class AuthenticateApi extends BaseService {
     constructor(client: AxiosInstance, baseUrl: string);
     /**
@@ -1935,6 +1960,7 @@ declare class CampaignApi extends BaseService {
      * @param params.contactNumber - The contact number of the user.
      * @param params.options - Additional options for the redemption.
      * @param params.spPoints - Point Per Unit x Quantity (Donate only).
+     * @param params.pointUnit - The point unit of the campaign (Point Service Only).
      * @param requestOptions - The options for the HTTP request.
      * @returns A promise that resolves to a service response containing the redeem response.
      */
@@ -2402,6 +2428,89 @@ declare class PointLogApi extends BaseService {
     }, requestOption?: RequestOptions): Promise<ServiceResponse<PointLog[]>>;
 }
 
+declare class PointApi extends BaseService {
+    constructor(client: AxiosInstance, baseUrl: string);
+    /**
+     * Retrieves the current point balance for the authenticated user across the requested point units.
+     *
+     * @param params - The parameters for retrieving the point balance.
+     * @param params.units - (Optional) Point unit codes (e.g. Point, Coin). Omit to use all units configured for the app.
+     * @param params.boxIds - (Optional) Box (sub-bucket) identifiers to filter by.
+     * @param params.onlyVisible - (Optional) When true (default), only units marked visible for the app are considered.
+     * @param params.options - (Optional) Additional options for the request.
+     * @param requestOptions - (Optional) The request options.
+     * @returns A promise that resolves to a service response containing an array of point balances.
+     */
+    balance(params?: {
+        units?: string;
+        boxIds?: string;
+        onlyVisible?: boolean;
+        options?: {
+            [key: string]: unknown;
+        };
+    }, requestOptions?: RequestOptions): Promise<ServiceResponse<PointBalance[]>>;
+    /**
+     * Retrieves the point balance with Currents and Expires breakdowns keyed by date.
+     *
+     * @param params - The parameters for retrieving the point detail.
+     * @param params.units - (Optional) Point unit codes (e.g. Point, Coin). Omit to use all units configured for the app.
+     * @param params.boxIds - (Optional) Box (sub-bucket) identifiers to filter by.
+     * @param params.onlyVisible - (Optional) When true (default), only units marked visible for the app are considered.
+     * @param params.options - (Optional) Additional options for the request.
+     * @param requestOptions - (Optional) The request options.
+     * @returns A promise that resolves to a service response containing an array of point balances with breakdowns.
+     */
+    detail(params?: {
+        units?: string;
+        boxIds?: string;
+        onlyVisible?: boolean;
+        options?: {
+            [key: string]: unknown;
+        };
+    }, requestOptions?: RequestOptions): Promise<ServiceResponse<PointBalance[]>>;
+    /**
+     * Retrieves a paginated list of earn/burn/transfer transactions between start and end dates.
+     *
+     * @param params - The parameters for retrieving the point history.
+     * @param params.start - Start of the range (inclusive), ISO-8601 with offset.
+     * @param params.end - End of the range (inclusive), ISO-8601 with offset.
+     * @param params.onlyVisible - (Optional) When true (default), only units marked visible for the app are considered.
+     * @param params.skip - (Optional) Number of records to skip (offset pagination).
+     * @param params.top - (Optional) Maximum number of records to return.
+     * @param params.sortType - (Optional) Sort direction for Timestamp: Asc|Desc.
+     * @param params.units - (Optional) Point unit codes to filter by.
+     * @param params.boxIds - (Optional) Box (sub-bucket) identifiers to filter by.
+     * @param params.references - (Optional) Filter by transaction reference.
+     * @param params.transactionIds - (Optional) Filter by exact transaction IDs.
+     * @param params.includeActions - (Optional) Only include transactions whose Action matches (e.g. Earn, Burn, Transfer).
+     * @param params.excludeActions - (Optional) Exclude transactions whose Action matches.
+     * @param params.includeTypes - (Optional) Only include transactions whose Type matches.
+     * @param params.excludeTypes - (Optional) Exclude transactions whose Type matches.
+     * @param params.options - (Optional) Additional options for the request.
+     * @param requestOptions - (Optional) The request options.
+     * @returns A promise that resolves to a service response containing an array of point history transactions.
+     */
+    history(params: {
+        start: string;
+        end: string;
+        onlyVisible?: boolean;
+        skip?: number;
+        top?: number;
+        sortType?: 'Asc' | 'Desc';
+        units?: string;
+        boxIds?: string;
+        references?: string;
+        transactionIds?: string;
+        includeActions?: string;
+        excludeActions?: string;
+        includeTypes?: string;
+        excludeTypes?: string;
+        options?: {
+            [key: string]: unknown;
+        };
+    }, requestOptions?: RequestOptions): Promise<ServiceResponse<PointHistory[]>>;
+}
+
 declare class ProfileApi extends BaseService {
     constructor(client: AxiosInstance, baseUrl: string);
     /**
@@ -3143,6 +3252,7 @@ declare class BzbsService {
     notificationApi: NotificationApi;
     placeApi: PlaceApi;
     pointLogApi: PointLogApi;
+    pointApi: PointApi;
     profileApi: ProfileApi;
     registerApi: RegistrationApi;
     addressApi: AddressApi;
@@ -3156,4 +3266,4 @@ declare class BzbsService {
     setLineUrl(lineUrl: string): this;
 }
 
-export { type AccessTokenResponse, type Address, AddressApi, type ApiResponse, type AppleToken, AuthenticateApi, type Badge, BadgeApi, BaseService, Blob, type Buzzebees, type BzbsErrorResponse, BzbsService, type Campaign, CampaignApi, type CampaignDetail, type CartAccessResponse, CartApi, type CartCountResponse, type Category, CategoryApi, type ChatMessage, type ClientError, type ConfirmOtpResponse, type Consent, ConsentApi, type ConsentVersion, type ConsentVersionValue, CouponApi, type CouponResponse, type CouponResponseData, type CreateStampResponse, type CrossPlatformFile, type Dashboard, DashboardApi, type Detail, type District, type ErrorResponse, type ExpiringPoints, type FavoriteResponse, type ForgetPasswordResponse, HistoryApi, type LikeForumResponse, LineApi, type LineAuthResponse, type LoginResponse, type Maintenance, type Mission, type Notification, NotificationApi, type OtpResponse, type Picture, type Place, PlaceApi, type PlaceService, type PointLog, PointLogApi, type PointUnit, ProfileApi, type ProfileResponse, type Province, type Purchase, type RedeemResponse, RegistrationApi, type RegistrationResponse, RequestHelpApi, type RequestHelpCode, type RequestOptions, type ResumeResponse, type ServerError, type ServiceResponse, SettingApi, type Stamp, StampApi, type StampCampaign, type StampHistory, type StampProfileResponse, type StatusResponse, type Style, type SubCampaign, type SubCampaignStyle, type SubDistrict, type SuccessResponse, type Trace, type UpdatedPoints, type UseCampaignResponse, type ValidateOtpResponse, type Version, type ZipCode };
+export { type AccessTokenResponse, type Address, AddressApi, type ApiResponse, type AppleToken, AuthenticateApi, type Badge, BadgeApi, BaseService, Blob, type Buzzebees, type BzbsErrorResponse, BzbsService, type Campaign, CampaignApi, type CampaignDetail, type CartAccessResponse, CartApi, type CartCountResponse, type Category, CategoryApi, type ChatMessage, type ClientError, type ConfirmOtpResponse, type Consent, ConsentApi, type ConsentVersion, type ConsentVersionValue, CouponApi, type CouponResponse, type CouponResponseData, type CreateStampResponse, type CrossPlatformFile, type Dashboard, DashboardApi, type Detail, type District, type ErrorResponse, type ExpiringPoints, type FavoriteResponse, type ForgetPasswordResponse, HistoryApi, type LikeForumResponse, LineApi, type LineAuthResponse, type LoginResponse, type Maintenance, type Mission, type Notification, NotificationApi, type OtpResponse, type Picture, type Place, PlaceApi, type PlaceService, PointApi, type PointBalance, type PointHistory, type PointLog, PointLogApi, type PointUnit, ProfileApi, type ProfileResponse, type Province, type Purchase, type RedeemResponse, RegistrationApi, type RegistrationResponse, RequestHelpApi, type RequestHelpCode, type RequestOptions, type ResumeResponse, type ServerError, type ServiceResponse, SettingApi, type Stamp, StampApi, type StampCampaign, type StampHistory, type StampProfileResponse, type StatusResponse, type Style, type SubCampaign, type SubCampaignStyle, type SubDistrict, type SuccessResponse, type Trace, type UpdatedPoints, type UseCampaignResponse, type ValidateOtpResponse, type Version, type ZipCode };

package/dist/index.js

@@ -73,6 +73,7 @@ __export(index_exports, {
   LineApi: () => LineApi,
   NotificationApi: () => NotificationApi,
   PlaceApi: () => PlaceApi,
+  PointApi: () => PointApi,
   PointLogApi: () => PointLogApi,
   ProfileApi: () => ProfileApi,
   RegistrationApi: () => RegistrationApi,
@@ -1063,6 +1064,7 @@ var CampaignApi = class extends BaseService {
    * @param params.contactNumber - The contact number of the user.
    * @param params.options - Additional options for the redemption.
    * @param params.spPoints - Point Per Unit x Quantity (Donate only).
+   * @param params.pointUnit - The point unit of the campaign (Point Service Only).
    * @param requestOptions - The options for the HTTP request.
    * @returns A promise that resolves to a service response containing the redeem response.
    */
@@ -1692,6 +1694,107 @@ var PointLogApi = class extends BaseService {
   }
 };
 
+// src/api/points/point-api.ts
+var PointApi = class extends BaseService {
+  constructor(client, baseUrl) {
+    super(client, baseUrl);
+  }
+  /**
+   * Retrieves the current point balance for the authenticated user across the requested point units.
+   *
+   * @param params - The parameters for retrieving the point balance.
+   * @param params.units - (Optional) Point unit codes (e.g. Point, Coin). Omit to use all units configured for the app.
+   * @param params.boxIds - (Optional) Box (sub-bucket) identifiers to filter by.
+   * @param params.onlyVisible - (Optional) When true (default), only units marked visible for the app are considered.
+   * @param params.options - (Optional) Additional options for the request.
+   * @param requestOptions - (Optional) The request options.
+   * @returns A promise that resolves to a service response containing an array of point balances.
+   */
+  balance(params, requestOptions) {
+    return __async(this, null, function* () {
+      return yield this.get(
+        "point/balance",
+        __spreadValues({
+          "units[]": params == null ? void 0 : params.units,
+          "boxIds[]": params == null ? void 0 : params.boxIds,
+          onlyVisible: params == null ? void 0 : params.onlyVisible
+        }, params == null ? void 0 : params.options),
+        requestOptions
+      );
+    });
+  }
+  /**
+   * Retrieves the point balance with Currents and Expires breakdowns keyed by date.
+   *
+   * @param params - The parameters for retrieving the point detail.
+   * @param params.units - (Optional) Point unit codes (e.g. Point, Coin). Omit to use all units configured for the app.
+   * @param params.boxIds - (Optional) Box (sub-bucket) identifiers to filter by.
+   * @param params.onlyVisible - (Optional) When true (default), only units marked visible for the app are considered.
+   * @param params.options - (Optional) Additional options for the request.
+   * @param requestOptions - (Optional) The request options.
+   * @returns A promise that resolves to a service response containing an array of point balances with breakdowns.
+   */
+  detail(params, requestOptions) {
+    return __async(this, null, function* () {
+      return yield this.get(
+        "point/detail",
+        __spreadValues({
+          "units[]": params == null ? void 0 : params.units,
+          "boxIds[]": params == null ? void 0 : params.boxIds,
+          onlyVisible: params == null ? void 0 : params.onlyVisible
+        }, params == null ? void 0 : params.options),
+        requestOptions
+      );
+    });
+  }
+  /**
+   * Retrieves a paginated list of earn/burn/transfer transactions between start and end dates.
+   *
+   * @param params - The parameters for retrieving the point history.
+   * @param params.start - Start of the range (inclusive), ISO-8601 with offset.
+   * @param params.end - End of the range (inclusive), ISO-8601 with offset.
+   * @param params.onlyVisible - (Optional) When true (default), only units marked visible for the app are considered.
+   * @param params.skip - (Optional) Number of records to skip (offset pagination).
+   * @param params.top - (Optional) Maximum number of records to return.
+   * @param params.sortType - (Optional) Sort direction for Timestamp: Asc|Desc.
+   * @param params.units - (Optional) Point unit codes to filter by.
+   * @param params.boxIds - (Optional) Box (sub-bucket) identifiers to filter by.
+   * @param params.references - (Optional) Filter by transaction reference.
+   * @param params.transactionIds - (Optional) Filter by exact transaction IDs.
+   * @param params.includeActions - (Optional) Only include transactions whose Action matches (e.g. Earn, Burn, Transfer).
+   * @param params.excludeActions - (Optional) Exclude transactions whose Action matches.
+   * @param params.includeTypes - (Optional) Only include transactions whose Type matches.
+   * @param params.excludeTypes - (Optional) Exclude transactions whose Type matches.
+   * @param params.options - (Optional) Additional options for the request.
+   * @param requestOptions - (Optional) The request options.
+   * @returns A promise that resolves to a service response containing an array of point history transactions.
+   */
+  history(params, requestOptions) {
+    return __async(this, null, function* () {
+      return yield this.get(
+        "point/history",
+        __spreadValues({
+          start: params.start,
+          end: params.end,
+          onlyVisible: params.onlyVisible,
+          skip: params.skip,
+          top: params.top,
+          sortType: params.sortType,
+          "units[]": params.units,
+          "boxIds[]": params.boxIds,
+          "references[]": params.references,
+          "transactionIds[]": params.transactionIds,
+          "includeActions[]": params.includeActions,
+          "excludeActions[]": params.excludeActions,
+          "includeTypes[]": params.includeTypes,
+          "excludeTypes[]": params.excludeTypes
+        }, params.options),
+        requestOptions
+      );
+    });
+  }
+};
+
 // src/api/profile/profile-api.ts
 var ProfileApi = class extends BaseService {
   constructor(client, baseUrl) {
@@ -2651,6 +2754,7 @@ var BzbsService = class {
     this.notificationApi = new NotificationApi(this.client, this.baseUrl);
     this.placeApi = new PlaceApi(this.client, this.baseUrl);
     this.pointLogApi = new PointLogApi(this.client, this.baseUrl);
+    this.pointApi = new PointApi(this.client, this.baseUrl);
     this.profileApi = new ProfileApi(this.client, this.baseUrl);
     this.registerApi = new RegistrationApi(this.client, this.baseUrl);
     this.addressApi = new AddressApi(this.client, this.baseUrl);
@@ -2673,6 +2777,7 @@ var BzbsService = class {
     this.notificationApi.setBaseUrl(baseUrl);
     this.placeApi.setBaseUrl(baseUrl);
     this.pointLogApi.setBaseUrl(baseUrl);
+    this.pointApi.setBaseUrl(baseUrl);
     this.profileApi.setBaseUrl(baseUrl);
     this.registerApi.setBaseUrl(baseUrl);
     this.addressApi.setBaseUrl(baseUrl);
@@ -2709,6 +2814,7 @@ var BzbsService = class {
   LineApi,
   NotificationApi,
   PlaceApi,
+  PointApi,
   PointLogApi,
   ProfileApi,
   RegistrationApi,