@inkress/admin-sdk 1.0.0 → 1.1.1

package/dist/resources/payment-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-links.d.ts","sourceRoot":"","sources":["../../src/resources/payment-links.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EACL,WAAW,EAEX,qBAAqB,EACrB,qBAAqB,EACrB,WAAW,EACZ,MAAM,UAAU,CAAC;AAQlB,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EAExB,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,oBAAoB;IACnB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC;IAqB3F;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAiBxD;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAkB5E;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAkBxF;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAIpD;;;;;;;;;;OAUG;IACG,KAAK,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC;IAK1F;;;;;;;;;;OAUG;IACH,kBAAkB,IAAI,uBAAuB;CAG9C"}

package/dist/resources/payment-methods.d.ts

@@ -0,0 +1,48 @@
+import { HttpClient } from '../client';
+import { PaymentMethod, CreatePaymentMethodData, UpdatePaymentMethodData, ApiResponse } from '../types';
+import { PaymentMethodQueryBuilder } from '../utils/query-builders';
+import { PaymentMethodFilterParams, PaymentMethodQueryParams, PaymentMethodListResponse } from '../types/resources';
+export declare class PaymentMethodsResource {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * List payment methods with filtering
+     */
+    list(params?: PaymentMethodFilterParams): Promise<ApiResponse<PaymentMethodListResponse>>;
+    /**
+     * Get payment method by ID
+     */
+    get(id: number): Promise<ApiResponse<PaymentMethod>>;
+    /**
+     * Create a new payment method
+     */
+    create(data: CreatePaymentMethodData): Promise<ApiResponse<PaymentMethod>>;
+    /**
+     * Update a payment method
+     */
+    update(id: number, data: UpdatePaymentMethodData): Promise<ApiResponse<PaymentMethod>>;
+    /**
+     * Delete a payment method
+     */
+    delete(id: number): Promise<ApiResponse<void>>;
+    /**
+     * Advanced query interface with full type safety
+     *
+     * @example
+     * const methods = await sdk.paymentMethods.query({
+     *   active: true,
+     *   provider: { contains: 'stripe' }
+     * });
+     */
+    query(params: PaymentMethodQueryParams): Promise<ApiResponse<PaymentMethodListResponse>>;
+    /**
+     * Create a fluent query builder for payment methods
+     *
+     * @example
+     * const methods = await sdk.paymentMethods.createQueryBuilder()
+     *   .whereActiveEquals(true)
+     *   .execute();
+     */
+    createQueryBuilder(): PaymentMethodQueryBuilder;
+}
+//# sourceMappingURL=payment-methods.d.ts.map

package/dist/resources/payment-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-methods.d.ts","sourceRoot":"","sources":["../../src/resources/payment-methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,uBAAuB,EACvB,WAAW,EACZ,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EAE1B,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,sBAAsB;IACrB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;IAI/F;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAI1D;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAIhF;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAI5F;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAIpD;;;;;;;;OAQG;IACG,KAAK,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;IAK9F;;;;;;;OAOG;IACH,kBAAkB,IAAI,yBAAyB;CAGhD"}

package/dist/resources/products.d.ts

@@ -1,28 +1,32 @@
 import { HttpClient } from '../client';
-import { Product, CreateProductData, UpdateProductData, ApiResponse, PaginationParams } from '../types';
-export interface ProductListParams extends PaginationParams {
-    search?: string;
-    status?: number;
-    category?: string;
-    limit?: number;
-}
-export interface ProductListResponse {
-    entries: Product[];
-    page_info: {
-        current_page: number;
-        total_pages: number;
-        total_entries: number;
-        page_size: number;
-    };
+import { Product, CreateProductData, UpdateProductData, ApiResponse } from '../types';
+import { ProductQueryBuilder } from '../utils/query-builders';
+import { ProductFilterParams, ProductQueryParams, ProductListResponse } from '../types/resources';
+/**
+ * @deprecated Use ProductFilterParams from types/resources instead
+ */
+export interface LegacyProductFilterParams {
 }
 export declare class ProductsResource {
     private client;
     constructor(client: HttpClient);
+    /**
+     * Convert internal product data (integers) to user-facing data (strings)
+     */
+    private translateProductToUserFacing;
+    /**
+     * Convert user-facing product data (strings) to internal data (integers)
+     */
+    private translateProductToInternal;
+    /**
+     * Convert filter parameters (strings to integers where needed)
+     */
+    private translateFilters;
     /**
      * List products with pagination and filtering
      * Requires Client-Id header to be set in the configuration
      */
-    list(params?: ProductListParams): Promise<ApiResponse<ProductListResponse>>;
+    list(params?: ProductFilterParams): Promise<ApiResponse<ProductListResponse>>;
     /**
      * Get a specific product by ID
      * Requires Client-Id header to be set in the configuration
@@ -43,5 +47,47 @@ export declare class ProductsResource {
      * Requires Client-Id header to be set in the configuration
      */
     delete(id: number): Promise<ApiResponse<void>>;
+    /**
+     * List products with enhanced query support
+     * Supports filtering by any database field using the new query system
+     * Requires Client-Id header to be set in the configuration
+     *
+     * @example
+     * // Simple queries
+     * await products.query({ status: 'published', public: true })
+     *
+     * // Array queries (IN operations)
+     * await products.query({ category_id: [1, 2, 3], status: ['published', 'draft'] })
+     *
+     * // Range queries
+     * await products.query({ price: { min: 10, max: 100 } })
+     *
+     * // String searches
+     * await products.query({ title: { contains: 'shirt' } })
+     *
+     * // Combined queries
+     * await products.query({
+     *   status: 'published',
+     *   price: { min: 20 },
+     *   public: true,
+     *   page: 1,
+     *   page_size: 20
+     * })
+     */
+    query(params?: ProductQueryParams): Promise<ApiResponse<ProductListResponse>>;
+    /**
+     * Create a query builder for products
+     * Provides a fluent interface for building complex queries
+     *
+     * @example
+     * const products = await sdk.products.createQueryBuilder()
+     *   .whereStatus('published')
+     *   .wherePriceRange(10, 100)
+     *   .whereTitleContains('shirt')
+     *   .wherePublic(true)
+     *   .paginate(1, 20)
+     *   .execute();
+     */
+    createQueryBuilder(initialQuery?: ProductQueryParams): ProductQueryBuilder;
 }
 //# sourceMappingURL=products.d.ts.map

package/dist/resources/products.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../src/resources/products.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,SAAS,EAAE;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;;OAGG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAIjF;;;OAGG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAIpD;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAIpE;;;OAGG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAIhF;;;OAGG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;CAGrD"}
+{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../src/resources/products.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EAGZ,MAAM,UAAU,CAAC;AAMlB,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EAEpB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,yBAAyB;CAEzC;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAOpC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAYlC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;;OAGG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAqBnF;;;OAGG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAiBpD;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAkBpE;;;OAGG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAkBhF;;;OAGG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAIpD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,KAAK,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAuBnF;;;;;;;;;;;;OAYG;IACH,kBAAkB,CAAC,YAAY,CAAC,EAAE,kBAAkB,GAAG,mBAAmB;CAG3E"}

package/dist/resources/public.d.ts

@@ -1,9 +1,28 @@
 import { HttpClient } from '../client';
-import { Product, PublicMerchantFees, ApiResponse, PaginationParams, PublicMerchant } from '../types';
-export interface PublicProductListParams extends PaginationParams {
+import { Product, PublicMerchantFees, ApiResponse, BaseFilterParams, PublicMerchant } from '../types';
+export interface PublicProductFilterParams extends BaseFilterParams {
     search?: string;
     category?: string;
     limit?: number;
+    id?: number;
+    title?: string;
+    teaser?: string;
+    price?: number;
+    permalink?: string;
+    image?: string;
+    public?: boolean;
+    unlimited?: boolean;
+    units_remaining?: number;
+    units_sold?: number;
+    rating_sum?: number;
+    rating_count?: number;
+    tag_ids?: number[];
+    uid?: string;
+    category_id?: number;
+    currency_id?: number;
+    user_id?: number;
+    inserted_at?: string;
+    updated_at?: string;
 }
 export interface PublicProductListResponse {
     entries: Product[];
@@ -18,6 +37,16 @@ export interface PublicMerchantParams {
     username?: string;
     'domain.cname'?: string;
 }
+export interface MerchantFeesParams {
+    /** Order total amount (required) */
+    total: number;
+    /** Currency code (required) */
+    currency_code: string;
+    /** Optional fulfillment/shipping cost */
+    fulfillment_total?: number;
+    /** Optional payment method ID */
+    method_id?: number;
+}
 export declare class PublicResource {
     private client;
     constructor(client: HttpClient);
@@ -28,13 +57,10 @@ export declare class PublicResource {
     /**
      * Get merchant fees (public endpoint - no auth required)
      */
-    getMerchantFees(merchantUsername: string, params: {
-        currency: string;
-        total: number;
-    }): Promise<ApiResponse<PublicMerchantFees>>;
+    getMerchantFees(merchantUsername: string, params: MerchantFeesParams): Promise<ApiResponse<PublicMerchantFees>>;
     /**
      * Get merchant products (public endpoint - no auth required)
      */
-    getMerchantProducts(merchantUsername: string, params?: PublicProductListParams): Promise<ApiResponse<PublicProductListResponse>>;
+    getMerchantProducts(merchantUsername: string, params?: PublicProductFilterParams): Promise<ApiResponse<PublicProductListResponse>>;
 }
 //# sourceMappingURL=public.d.ts.map

package/dist/resources/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/resources/public.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EACL,OAAO,EACP,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,cAAc,EACf,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,SAAS,EAAE;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAIrF;;OAEG;IACG,eAAe,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAItI;;OAEG;IACG,mBAAmB,CACvB,gBAAgB,EAAE,MAAM,EACxB,MAAM,CAAC,EAAE,uBAAuB,GAC/B,OAAO,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;CAGnD"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/resources/public.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EACL,OAAO,EACP,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,cAAc,EACf,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IAEjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,SAAS,EAAE;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IAEd,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IAEtB,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAIrF;;OAEG;IACG,eAAe,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAIrH;;OAEG;IACG,mBAAmB,CACvB,gBAAgB,EAAE,MAAM,EACxB,MAAM,CAAC,EAAE,yBAAyB,GACjC,OAAO,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;CAGnD"}

package/dist/resources/subscriptions.d.ts

@@ -1,24 +1,12 @@
 import { HttpClient } from '../client';
-import { Subscription, SubscriptionPeriod, ApiResponse, PaginationParams } from '../types';
-export interface SubscriptionListParams extends PaginationParams {
-    status?: number;
-    billing_plan_id?: number;
-    customer_id?: number;
-    limit?: number;
-}
-export interface SubscriptionListResponse {
-    entries: Subscription[];
-    page_info: {
-        current_page: number;
-        total_pages: number;
-        total_entries: number;
-        page_size: number;
-    };
-}
+import { Subscription, SubscriptionPeriod, CreateSubscriptionData, SubscriptionChargeData, SubscriptionUsageResponse, SubscriptionCancelResponse, ApiResponse, PaginationParams } from '../types';
+import { SubscriptionQueryBuilder } from '../utils/query-builders';
+import { SubscriptionFilterParams, SubscriptionQueryParams, SubscriptionListResponse } from '../types/resources';
 export interface CreateSubscriptionLinkData {
     reference_id: string;
     title: string;
-    plan_id: string;
+    plan_uid: string;
+    meta_data?: Record<string, any>;
     customer: {
         first_name: string;
         last_name: string;
@@ -26,11 +14,12 @@ export interface CreateSubscriptionLinkData {
     };
 }
 export interface CreateSubscriptionLinkResponse {
-    id: number;
-    payment_urls: {
-        short_link: string;
-    };
-    subscription: Subscription;
+    status: 'paid';
+    total: number;
+    reference: string;
+    currency: string;
+    subscription_status: string;
+    subscription_uid: string;
 }
 export interface ChargeSubscriptionData {
     reference_id: string;
@@ -42,7 +31,13 @@ export interface ChargeSubscriptionResponse {
     payment_urls: {
         short_link: string;
     };
-    transaction: any;
+    transaction: {
+        id: number;
+        amount: number;
+        status: string;
+        reference_id: string;
+        [key: string]: any;
+    };
 }
 export interface SubscriptionPeriodsParams extends PaginationParams {
     status?: 'pending' | 'paid' | 'failed' | 'cancelled';
@@ -60,11 +55,43 @@ export interface SubscriptionPeriodsResponse {
 export declare class SubscriptionsResource {
     private client;
     constructor(client: HttpClient);
+    /**
+     * Convert internal subscription data (integers) to user-facing data (strings)
+     */
+    private translateToUserFacing;
+    /**
+     * Convert internal billing plan data to user-facing billing plan
+     */
+    private translateBillingPlanToUserFacing;
+    /**
+     * Convert filter parameters (strings to integers where needed)
+     * @deprecated This method is no longer needed as processQuery handles translation
+     */
+    private translateFilters;
+    /**
+     * Translate subscription data for API (contextual strings to integers)
+     */
+    private translateToInternal;
     /**
      * List billing subscriptions with pagination and filtering
      * Requires Client-Id header to be set in the configuration
      */
-    list(params?: SubscriptionListParams): Promise<ApiResponse<SubscriptionListResponse>>;
+    list(params?: SubscriptionFilterParams): Promise<ApiResponse<SubscriptionListResponse>>;
+    /**
+     * Gets a billing subscription by ID
+     * Requires Client-Id header to be set in the configuration
+     */
+    get(id?: number): Promise<ApiResponse<Subscription>>;
+    /**
+     * Create a new subscription
+     * Requires Client-Id header to be set in the configuration
+     */
+    create(data: CreateSubscriptionData): Promise<ApiResponse<Subscription>>;
+    /**
+     * Delete a subscription
+     * Requires Client-Id header to be set in the configuration
+     */
+    delete(id: number): Promise<ApiResponse<void>>;
     /**
      * Create a subscription payment link
      * Requires Client-Id header to be set in the configuration
@@ -75,6 +102,11 @@ export declare class SubscriptionsResource {
      * Requires Client-Id header to be set in the configuration
      */
     charge(uid: string, data: ChargeSubscriptionData): Promise<ApiResponse<ChargeSubscriptionResponse>>;
+    /**
+     * Record usage for a subscription (for usage-based billing)
+     * Requires Client-Id header to be set in the configuration
+     */
+    usage(uid: string, data: SubscriptionChargeData): Promise<ApiResponse<SubscriptionUsageResponse>>;
     /**
      * Get subscription billing periods
      * Requires Client-Id header to be set in the configuration
@@ -84,6 +116,18 @@ export declare class SubscriptionsResource {
      * Cancel a subscription
      * Requires Client-Id header to be set in the configuration
      */
-    cancel(uid: number, code: string): Promise<ApiResponse<any>>;
+    cancel(uid: number, code: string): Promise<ApiResponse<SubscriptionCancelResponse>>;
+    /**
+     * Query subscriptions with enhanced query support
+     * @example
+     * await subscriptions.query({ status: 'active', billing_plan_id: 123 })
+     */
+    query(params?: SubscriptionQueryParams): Promise<ApiResponse<SubscriptionListResponse>>;
+    /**
+     * Create a query builder for subscriptions
+     * @example
+     * await sdk.subscriptions.createQueryBuilder().whereStatus('active').execute()
+     */
+    createQueryBuilder(initialQuery?: SubscriptionQueryParams): SubscriptionQueryBuilder;
 }
 //# sourceMappingURL=subscriptions.d.ts.map

package/dist/resources/subscriptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../src/resources/subscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAIlB,WAAW,EACX,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,SAAS,EAAE;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,WAAW,EAAE,GAAG,CAAC;CAClB;AAED,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IACjE,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,SAAS,EAAE;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,qBAAa,qBAAqB;IACpB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;;OAGG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC;IAI3F;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,WAAW,CAAC,8BAA8B,CAAC,CAAC;IAIxG;;;OAGG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,0BAA0B,CAAC,CAAC;IAIzG;;;OAGG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC;IAIpH;;;OAGG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;CAGnE"}
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../src/resources/subscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EACL,YAAY,EAKZ,kBAAkB,EAClB,sBAAsB,EAEtB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,WAAW,EACX,gBAAgB,EAEjB,MAAM,UAAU,CAAC;AAQlB,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EAEzB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,WAAW,EAAE;QACX,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IACjE,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,SAAS,EAAE;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,qBAAa,qBAAqB;IACpB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;IACH,OAAO,CAAC,gCAAgC;IAQxC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;;OAGG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC;IAqB7F;;;OAGG;IACG,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAiB1D;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAkB9E;;;OAGG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAIpD;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,WAAW,CAAC,8BAA8B,CAAC,CAAC;IAIxG;;;OAGG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,0BAA0B,CAAC,CAAC;IAIzG;;;OAGG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;IAIvG;;;OAGG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC;IAIpH;;;OAGG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,0BAA0B,CAAC,CAAC;IAIzF;;;;OAIG;IACG,KAAK,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC;IAK7F;;;;OAIG;IACH,kBAAkB,CAAC,YAAY,CAAC,EAAE,uBAAuB,GAAG,wBAAwB;CAGrF"}

package/dist/resources/tokens.d.ts

@@ -0,0 +1,62 @@
+import { HttpClient } from '../client';
+import { Token, CreateTokenData, ApiResponse } from '../types';
+import { TokenQueryBuilder } from '../utils/query-builders';
+import { TokenFilterParams, TokenQueryParams, TokenListResponse } from '../types/resources';
+/**
+ * Tokens Resource
+ *
+ * ⚠️ LIMITED ACCESS WARNING:
+ * This resource is primarily for super_admin and platform_affiliate roles.
+ * organisation_admin has limited access (view/list/create/delete only, no update).
+ * Use with caution and be aware of permission restrictions.
+ */
+export declare class TokensResource {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Convert filter parameters (strings to integers where needed)
+     */
+    private translateFilters;
+    /**
+     * Convert user-facing data to internal format
+     */
+    private translateToInternal;
+    /**
+     * List tokens with filtering
+     */
+    list(params?: TokenFilterParams): Promise<ApiResponse<TokenListResponse>>;
+    /**
+     * Get token by ID
+     */
+    get(id: number): Promise<ApiResponse<Token>>;
+    /**
+     * Create a new token
+     */
+    create(data: CreateTokenData): Promise<ApiResponse<Token>>;
+    /**
+     * Delete a token
+     */
+    delete(id: number): Promise<ApiResponse<void>>;
+    /**
+     * Advanced query interface with full type safety
+     *
+     * @example
+     * const tokens = await sdk.tokens.query({
+     *   enabled: true,
+     *   kind: [1, 2],
+     *   user_id: 123
+     * });
+     */
+    query(params: TokenQueryParams): Promise<ApiResponse<TokenListResponse>>;
+    /**
+     * Create a fluent query builder for tokens
+     *
+     * @example
+     * const tokens = await sdk.tokens.createQueryBuilder()
+     *   .whereEnabledEquals(true)
+     *   .whereKindIn([1, 2])
+     *   .execute();
+     */
+    createQueryBuilder(): TokenQueryBuilder;
+}
+//# sourceMappingURL=tokens.d.ts.map

package/dist/resources/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/resources/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EACL,KAAK,EACL,eAAe,EAEf,WAAW,EACZ,MAAM,UAAU,CAAC;AAKlB,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAElB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;GAOG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAK/E;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAIlD;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAKhE;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAIpD;;;;;;;;;OASG;IACG,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAK9E;;;;;;;;OAQG;IACH,kBAAkB,IAAI,iBAAiB;CAGxC"}

package/dist/resources/transaction-entries.d.ts

@@ -0,0 +1,48 @@
+import { HttpClient } from '../client';
+import { TransactionEntry, ApiResponse } from '../types';
+import { TransactionEntryQueryBuilder } from '../utils/query-builders';
+import { TransactionEntryFilterParams, TransactionEntryQueryParams, TransactionEntryListResponse } from '../types/resources';
+/**
+ * Transaction Entries Resource
+ *
+ * ⚠️ READ-ONLY RESOURCE:
+ * This resource is READ-ONLY for organisation_admin and owner roles.
+ * Only view and list operations are supported.
+ * Create/update/delete operations require super_admin privileges.
+ */
+export declare class TransactionEntriesResource {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * List transaction entries with filtering
+     */
+    list(params?: TransactionEntryFilterParams): Promise<ApiResponse<TransactionEntryListResponse>>;
+    /**
+     * Get transaction entry by ID
+     */
+    get(id: number): Promise<ApiResponse<TransactionEntry>>;
+    /**
+     * Advanced query interface with full type safety
+     * Note: Transaction entries are read-only for organisation_admin.
+     * Create/update/delete operations require super_admin privileges.
+     *
+     * @example
+     * const entries = await sdk.transactionEntries.query({
+     *   amount: { gte: 100 },
+     *   type: [1, 2],
+     *   transaction_id: 123
+     * });
+     */
+    query(params: TransactionEntryQueryParams): Promise<ApiResponse<TransactionEntryListResponse>>;
+    /**
+     * Create a fluent query builder for transaction entries
+     *
+     * @example
+     * const entries = await sdk.transactionEntries.createQueryBuilder()
+     *   .whereAmountGreaterThan(100)
+     *   .whereTypeIn([1, 2])
+     *   .execute();
+     */
+    createQueryBuilder(): TransactionEntryQueryBuilder;
+}
+//# sourceMappingURL=transaction-entries.d.ts.map

package/dist/resources/transaction-entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-entries.d.ts","sourceRoot":"","sources":["../../src/resources/transaction-entries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EACL,gBAAgB,EAGhB,WAAW,EACZ,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,EAE7B,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;GAOG;AACH,qBAAa,0BAA0B;IACzB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,4BAA4B,GAAG,OAAO,CAAC,WAAW,CAAC,4BAA4B,CAAC,CAAC;IAIrG;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAI7D;;;;;;;;;;;OAWG;IACG,KAAK,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,WAAW,CAAC,4BAA4B,CAAC,CAAC;IAKpG;;;;;;;;OAQG;IACH,kBAAkB,IAAI,4BAA4B;CAGnD"}

package/dist/resources/users.d.ts

@@ -1,38 +1,48 @@
 import { HttpClient } from '../client';
-import { User, CreateUserData, UpdateUserData, ApiResponse, PaginationParams } from '../types';
-export interface UserListParams extends PaginationParams {
-    search?: string;
-    status?: number;
-    level?: number;
-    role_id?: number;
-    organisation_id?: number;
-    limit?: number;
-}
-export interface UserListResponse {
-    entries: User[];
-    page_info: {
-        current_page: number;
-        total_pages: number;
-        total_entries: number;
-        page_size: number;
-    };
+import { User, CreateUserData, UpdateUserData, ApiResponse } from '../types';
+import { UserQueryBuilder } from '../utils/query-builders';
+import { UserFilterParams, UserQueryParams, UserListResponse } from '../types/resources';
+/**
+ * @deprecated Use UserFilterParams from types/resources instead
+ */
+export interface LegacyUserFilterParams {
 }
-export interface CreateUserRequestData extends CreateUserData {
+export interface CreateUserRequestData {
+    email: string;
+    phone?: string;
+    first_name: string;
+    last_name: string;
+    username?: string;
+    password: string;
+    status?: number;
     level?: number;
     dob?: number | null;
     sex?: number | null;
     image?: string | null;
+    kind?: number;
     organisation_id?: number | null;
-    merchant_id?: number | null;
+    role_id?: number;
 }
 export declare class UsersResource {
     private client;
     constructor(client: HttpClient);
+    /**
+     * Convert internal user data (integers) to user-facing data (strings)
+     */
+    private translateUserToUserFacing;
+    /**
+     * Convert user-facing user data (strings) to internal data (integers)
+     */
+    private translateUserToInternal;
+    /**
+     * Convert filter parameters (strings to integers where needed)
+     */
+    private translateFilters;
     /**
      * List users with pagination and filtering
      * Requires Client-Id header to be set in the configuration
      */
-    list(params?: UserListParams): Promise<ApiResponse<UserListResponse>>;
+    list(params?: UserFilterParams): Promise<ApiResponse<UserListResponse>>;
     /**
      * Get a specific user by ID
      * Requires Client-Id header to be set in the configuration
@@ -42,7 +52,7 @@ export declare class UsersResource {
      * Create a new user
      * Requires Client-Id header to be set in the configuration
      */
-    create(data: CreateUserRequestData): Promise<ApiResponse<User>>;
+    create(data: CreateUserData): Promise<ApiResponse<User>>;
     /**
      * Update an existing user
      * Requires Client-Id header to be set in the configuration
@@ -53,5 +63,17 @@ export declare class UsersResource {
      * Requires Client-Id header to be set in the configuration
      */
     delete(id: number): Promise<ApiResponse<void>>;
+    /**
+     * Query users with enhanced query support
+     * @example
+     * await users.query({ status: 'approved', level: { min: 5 } })
+     */
+    query(params?: UserQueryParams): Promise<ApiResponse<UserListResponse>>;
+    /**
+     * Create a query builder for users
+     * @example
+     * await sdk.users.createQueryBuilder().whereStatus('approved').execute()
+     */
+    createQueryBuilder(initialQuery?: UserQueryParams): UserQueryBuilder;
 }
 //# sourceMappingURL=users.d.ts.map

package/dist/resources/users.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/resources/users.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EACL,IAAI,EACJ,cAAc,EACd,cAAc,EACd,WAAW,EACX,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,IAAI,EAAE,CAAC;IAChB,SAAS,EAAE;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;;OAGG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAI3E;;;OAGG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAIjD;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAIrE;;;OAGG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAI1E;;;OAGG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;CAGrD"}
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/resources/users.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EACL,IAAI,EACJ,cAAc,EACd,cAAc,EACd,WAAW,EAIZ,MAAM,UAAU,CAAC;AAQlB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAEjB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,sBAAsB;CAEtC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAQjC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsB/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;OAGG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAK7E;;;OAGG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAIjD;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAK9D;;;OAGG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAK1E;;;OAGG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAIpD;;;;OAIG;IACG,KAAK,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAgB7E;;;;OAIG;IACH,kBAAkB,CAAC,YAAY,CAAC,EAAE,eAAe,GAAG,gBAAgB;CAGrE"}