fix: rewrite all types to match actual API serializer output

BREAKING: Resource types, list params, create/update inputs all
rewritten to exactly match what the API returns. Removed phantom
fields, added missing fields, fixed field name mismatches.

Key changes:
- Invoice: taxes (not taxTotal), totalAmount (not total), added
  customerName/Email, paidAmount, hasDeposit, depositAmount, memo
- Customer/Vendor: flat address fields (not nested Address object)
- Bill: subtotalAmount/taxAmount/totalAmount (not subtotal/taxTotal)
- Item: added discountRate, removed phantom sku/unit/cost
- Account: accountCode/accountName/accountType (not code/name/type),
  added 10 missing fields (normalBalance, path, level, etc.)
- Status enums: Invoice finalized/deposit_paid/deposit_due, Bill
  in_review/pending_approval/approved/awaiting_payment/scheduled
- ListParams: page-based (not offset), actual filter names from Zod
- Removed phantom methods: invoices.create(), bills.create(),
  accounts.create/update/delete()

Author: hazlijohar95

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cynco/sdk",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Official TypeScript SDK for the Cynco REST API",
   "author": "Cynco Sdn Bhd",
   "license": "MIT",

src/index.ts

@@ -149,20 +149,14 @@ export type {
   BankTransactionListParams,
   WebhookListParams,
   // Create / update inputs
-  InvoiceCreateInput,
   InvoiceUpdateInput,
-  InvoiceLineItemInput,
   CustomerCreateInput,
   CustomerUpdateInput,
   VendorCreateInput,
   VendorUpdateInput,
-  BillCreateInput,
   BillUpdateInput,
-  BillLineItemInput,
   ItemCreateInput,
   ItemUpdateInput,
-  AccountCreateInput,
-  AccountUpdateInput,
   JournalEntryCreateInput,
   JournalEntryUpdateInput,
   JournalEntryLineInput,
@@ -172,12 +166,10 @@ export type {
   WebhookUpdateInput,
   // Resource types
   Invoice,
-  InvoiceLineItem,
   InvoiceStatus,
   Customer,
   Vendor,
   Bill,
-  BillLineItem,
   BillStatus,
   Item,
   Account,
@@ -197,7 +189,4 @@ export type {
   TrialBalanceRow,
   ReportSection,
   ReportRow,
-  // Shared
-  Address,
-  BankDetails,
 } from './types.js';

src/pagination.ts

@@ -57,10 +57,12 @@ export class Page<T> implements AsyncIterable<T> {
       return null;
     }
 
-    const nextOffset = this.pagination.offset + this.pagination.limit;
+    // The API uses page-based params but returns offset in the pagination response.
+    // Compute the next page number from the current offset + limit.
+    const nextPage = Math.floor(this.pagination.offset / this.pagination.limit) + 2;
     const nextParams: ListParams = {
       ...this._params,
-      offset: nextOffset,
+      page: nextPage,
     };
 
     const response = await this._fetchPage(nextParams);

src/resources/accounts.ts

@@ -3,21 +3,19 @@ import { Page, PagePromise } from '../pagination.js';
 import type {
   Account,
   AccountListParams,
-  AccountCreateInput,
-  AccountUpdateInput,
   PaginatedResponse,
-  RequestOptions,
 } from '../types.js';
 
 export class Accounts {
   constructor(private readonly _client: CyncoClient) {}
 
   /**
-   * List chart of accounts with pagination.
+   * List chart of accounts.
    *
    * ```ts
-   * for await (const account of cynco.accounts.list({ type: 'revenue' })) {
-   *   console.log(`${account.code} — ${account.name}`);
+   * const page = await cynco.accounts.list({ account_type: 'revenue' });
+   * for (const account of page.data) {
+   *   console.log(`${account.accountCode} — ${account.accountName}`);
    * }
    * ```
    */
@@ -40,39 +38,7 @@ export class Accounts {
 
   /** Retrieve a single account by ID. */
   async retrieve(id: string): Promise<Account> {
-    const response = await this._client.get<Account>(`/accounts/${id}`);
-    return response.data;
-  }
-
-  /** Create a new account. */
-  async create(
-    data: AccountCreateInput,
-    options?: RequestOptions,
-  ): Promise<Account> {
-    const response = await this._client.post<Account>(
-      '/accounts',
-      data,
-      options,
-    );
-    return response.data;
-  }
-
-  /** Update an existing account. */
-  async update(
-    id: string,
-    data: AccountUpdateInput,
-    options?: RequestOptions,
-  ): Promise<Account> {
-    const response = await this._client.patch<Account>(
-      `/accounts/${id}`,
-      data,
-      options,
-    );
-    return response.data;
-  }
-
-  /** Delete an account. Only unused accounts can be deleted. */
-  async delete(id: string, options?: RequestOptions): Promise<void> {
-    await this._client.delete(`/accounts/${id}`, options);
+    const response = await this._client.get<Account>(`/accounts?id=${encodeURIComponent(id)}`);
+    return response.data;  // accounts uses ?id= since there's no /:id route
   }
 }

src/resources/bills.ts

@@ -3,7 +3,6 @@ import { Page, PagePromise } from '../pagination.js';
 import type {
   Bill,
   BillListParams,
-  BillCreateInput,
   BillUpdateInput,
   PaginatedResponse,
   RequestOptions,
@@ -44,15 +43,6 @@ export class Bills {
     return response.data;
   }
 
-  /** Create a new bill. */
-  async create(
-    data: BillCreateInput,
-    options?: RequestOptions,
-  ): Promise<Bill> {
-    const response = await this._client.post<Bill>('/bills', data, options);
-    return response.data;
-  }
-
   /** Update an existing bill. */
   async update(
     id: string,

src/resources/invoices.ts

@@ -3,7 +3,6 @@ import { Page, PagePromise } from '../pagination.js';
 import type {
   Invoice,
   InvoiceListParams,
-  InvoiceCreateInput,
   InvoiceUpdateInput,
   PaginatedResponse,
   RequestOptions,
@@ -48,20 +47,7 @@ export class Invoices {
     return response.data;
   }
 
-  /** Create a new invoice. */
-  async create(
-    data: InvoiceCreateInput,
-    options?: RequestOptions,
-  ): Promise<Invoice> {
-    const response = await this._client.post<Invoice>(
-      '/invoices',
-      data,
-      options,
-    );
-    return response.data;
-  }
-
-  /** Update an existing invoice. */
+  /** Update an existing invoice (memo, paymentTerms, dueDate only). */
   async update(
     id: string,
     data: InvoiceUpdateInput,