@centry-digital/bukku-mcp 1.1.0

package/build/tools/configs/delivery-order.js

@@ -0,0 +1,20 @@
+/**
+ * Delivery Order Entity Configuration
+ *
+ * API: /sales/delivery_orders
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export const deliveryOrderConfig = {
+    entity: "delivery-order",
+    apiBasePath: "/sales/delivery_orders",
+    singularKey: "transaction",
+    pluralKey: "transactions",
+    description: "delivery order",
+    operations: ["list", "get", "create", "update", "delete"],
+    hasStatusUpdate: true,
+    listFilters: ["contact_id", "email_status", "transfer_status"],
+    businessRules: {
+        delete: "Only draft and void delivery orders can be deleted. Ready or pending approval delivery orders cannot be deleted — use update-delivery-order-status to void a ready delivery order instead.",
+        statusTransitions: "Valid transitions: draft -> pending_approval, draft -> ready, pending_approval -> ready, ready -> void. A void delivery order is final and cannot be changed. There is no way to revert from ready, pending_approval, or void back to draft.",
+    },
+};

package/build/tools/configs/file.d.ts

@@ -0,0 +1,18 @@
+import type { CrudEntityConfig } from "../../types/bukku.js";
+/**
+ * File Entity Configuration
+ *
+ * API: /files
+ * Response keys: file (singular), files (plural)
+ *
+ * Files are typically attached to sales and purchase transactions using file_ids arrays.
+ * The create operation is handled by a custom upload-file tool (not the factory create tool)
+ * because file upload requires multipart/form-data, not JSON.
+ *
+ * API limitations:
+ * - No delete endpoint (files are permanent once uploaded)
+ * - No update endpoint (files are immutable)
+ * - No pagination support for list (returns ALL files)
+ * - No list filters (API spec shows no query parameters)
+ */
+export declare const fileConfig: CrudEntityConfig;

package/build/tools/configs/file.js

@@ -0,0 +1,26 @@
+/**
+ * File Entity Configuration
+ *
+ * API: /files
+ * Response keys: file (singular), files (plural)
+ *
+ * Files are typically attached to sales and purchase transactions using file_ids arrays.
+ * The create operation is handled by a custom upload-file tool (not the factory create tool)
+ * because file upload requires multipart/form-data, not JSON.
+ *
+ * API limitations:
+ * - No delete endpoint (files are permanent once uploaded)
+ * - No update endpoint (files are immutable)
+ * - No pagination support for list (returns ALL files)
+ * - No list filters (API spec shows no query parameters)
+ */
+export const fileConfig = {
+    entity: "file",
+    apiBasePath: "/files",
+    singularKey: "file",
+    pluralKey: "files",
+    description: "file. Files are typically attached to sales and purchase transactions using file_ids arrays. Use upload-file to add new files.",
+    operations: ["list", "get"],
+    hasStatusUpdate: false,
+    listFilters: [],
+};

package/build/tools/configs/goods-received-note.d.ts

@@ -0,0 +1,8 @@
+import type { CrudEntityConfig } from "../../types/bukku.js";
+/**
+ * Goods Received Note Entity Configuration
+ *
+ * API: /purchases/goods_received_notes
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export declare const goodsReceivedNoteConfig: CrudEntityConfig;

package/build/tools/configs/goods-received-note.js

@@ -0,0 +1,20 @@
+/**
+ * Goods Received Note Entity Configuration
+ *
+ * API: /purchases/goods_received_notes
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export const goodsReceivedNoteConfig = {
+    entity: "goods-received-note",
+    apiBasePath: "/purchases/goods_received_notes",
+    singularKey: "transaction",
+    pluralKey: "transactions",
+    description: "goods received note",
+    operations: ["list", "get", "create", "update", "delete"],
+    hasStatusUpdate: true,
+    listFilters: ["contact_id", "email_status", "transfer_status"],
+    businessRules: {
+        delete: "Only draft and void goods received notes can be deleted. Ready or pending approval goods received notes cannot be deleted — use update-goods-received-note-status to void a ready goods received note instead.",
+        statusTransitions: "Valid transitions: draft -> pending_approval, draft -> ready, pending_approval -> ready, ready -> void. A void goods received note is final and cannot be changed. There is no way to revert from ready, pending_approval, or void back to draft.",
+    },
+};

package/build/tools/configs/journal-entry.d.ts

@@ -0,0 +1,14 @@
+import type { CrudEntityConfig } from "../../types/bukku.js";
+/**
+ * Journal Entry Entity Configuration
+ *
+ * API: /journal_entries
+ * Response keys: transaction (singular), transactions (plural)
+ * Operations: list, get, delete ONLY
+ * - Create and update are handled by custom tools (journal-entry-tools.ts)
+ *   because they require double-entry validation (debits == credits)
+ * - Status updates use standard factory pattern (hasStatusUpdate: true)
+ * Status lifecycle: draft -> ready (posted), ready -> void (final)
+ * Delete constraint: Only draft and void entries can be deleted
+ */
+export declare const journalEntryConfig: CrudEntityConfig;

package/build/tools/configs/journal-entry.js

@@ -0,0 +1,26 @@
+/**
+ * Journal Entry Entity Configuration
+ *
+ * API: /journal_entries
+ * Response keys: transaction (singular), transactions (plural)
+ * Operations: list, get, delete ONLY
+ * - Create and update are handled by custom tools (journal-entry-tools.ts)
+ *   because they require double-entry validation (debits == credits)
+ * - Status updates use standard factory pattern (hasStatusUpdate: true)
+ * Status lifecycle: draft -> ready (posted), ready -> void (final)
+ * Delete constraint: Only draft and void entries can be deleted
+ */
+export const journalEntryConfig = {
+    entity: "journal-entry",
+    apiBasePath: "/journal_entries",
+    singularKey: "transaction",
+    pluralKey: "transactions",
+    description: "journal entry",
+    operations: ["list", "get", "delete"],
+    hasStatusUpdate: true,
+    listFilters: [],
+    businessRules: {
+        delete: "Only draft and void journal entries can be deleted. Ready journal entries cannot be deleted -- use update-journal-entry-status to void a ready entry instead.",
+        statusTransitions: "Valid transitions: draft -> ready, ready -> void. A void entry is final and cannot be changed.",
+    },
+};

package/build/tools/configs/location.d.ts

@@ -0,0 +1,20 @@
+import type { CrudEntityConfig } from "../../types/bukku.js";
+/**
+ * Location Entity Configuration
+ *
+ * API: /locations (list, create) and /location/{id} (get, update, delete)
+ * Response keys: location (singular), locations (plural)
+ *
+ * API PATH INCONSISTENCY:
+ * - List/create use /locations (plural)
+ * - Get/update/delete use /location/{id} (singular)
+ *
+ * The factory generates tools based on apiBasePath, which would produce:
+ * - /locations for list/create ✓
+ * - /locations/{id} for get/update/delete ✗ (incorrect)
+ *
+ * Therefore, this config only enables list and create operations.
+ * Get/update/delete operations are handled by custom tools in location-tools.ts
+ * which use the correct /location/{id} singular path.
+ */
+export declare const locationConfig: CrudEntityConfig;

package/build/tools/configs/location.js

@@ -0,0 +1,28 @@
+/**
+ * Location Entity Configuration
+ *
+ * API: /locations (list, create) and /location/{id} (get, update, delete)
+ * Response keys: location (singular), locations (plural)
+ *
+ * API PATH INCONSISTENCY:
+ * - List/create use /locations (plural)
+ * - Get/update/delete use /location/{id} (singular)
+ *
+ * The factory generates tools based on apiBasePath, which would produce:
+ * - /locations for list/create ✓
+ * - /locations/{id} for get/update/delete ✗ (incorrect)
+ *
+ * Therefore, this config only enables list and create operations.
+ * Get/update/delete operations are handled by custom tools in location-tools.ts
+ * which use the correct /location/{id} singular path.
+ */
+export const locationConfig = {
+    entity: "location",
+    apiBasePath: "/locations",
+    singularKey: "location",
+    pluralKey: "locations",
+    description: "location for multi-branch accounting. Use locations to track which branch or office a transaction belongs to.",
+    operations: ["list", "create"],
+    hasStatusUpdate: false,
+    listFilters: ["include_archived"],
+};

package/build/tools/configs/product-bundle.d.ts

@@ -0,0 +1,18 @@
+import type { CrudEntityConfig } from "../../types/bukku.js";
+/**
+ * Product Bundle Entity Configuration
+ *
+ * API: /products/bundles
+ * Response keys: bundle (singular), bundles (plural) — custom wrapper keys
+ * Bundles aggregate multiple products with optional discounts.
+ * Archive/unarchive is handled by separate custom tools (product-archive.ts),
+ * NOT the factory status tool, because the API expects { is_archived: boolean }
+ * instead of { status: string }.
+ *
+ * Note: Bukku API has no GET /products/bundles endpoint.
+ * To list bundles, use GET /products?type=bundle (the list-products tool with type=bundle filter).
+ *
+ * Cross-references:
+ * - Use list-products to find product IDs for bundle items
+ */
+export declare const productBundleConfig: CrudEntityConfig;

package/build/tools/configs/product-bundle.js

@@ -0,0 +1,29 @@
+/**
+ * Product Bundle Entity Configuration
+ *
+ * API: /products/bundles
+ * Response keys: bundle (singular), bundles (plural) — custom wrapper keys
+ * Bundles aggregate multiple products with optional discounts.
+ * Archive/unarchive is handled by separate custom tools (product-archive.ts),
+ * NOT the factory status tool, because the API expects { is_archived: boolean }
+ * instead of { status: string }.
+ *
+ * Note: Bukku API has no GET /products/bundles endpoint.
+ * To list bundles, use GET /products?type=bundle (the list-products tool with type=bundle filter).
+ *
+ * Cross-references:
+ * - Use list-products to find product IDs for bundle items
+ */
+export const productBundleConfig = {
+    entity: "product-bundle",
+    apiBasePath: "/products/bundles",
+    singularKey: "bundle",
+    pluralKey: "bundles",
+    description: "product bundle. Bundles aggregate multiple products with optional discounts. To list bundles, use list-products with type=bundle. Use list-products to find product IDs for bundle items.",
+    operations: ["get", "create", "update", "delete"],
+    hasStatusUpdate: false,
+    listFilters: [],
+    businessRules: {
+        delete: "Only bundles that are not used in any transactions can be deleted.",
+    },
+};

package/build/tools/configs/product-group.d.ts

@@ -0,0 +1,14 @@
+import type { CrudEntityConfig } from "../../types/bukku.js";
+/**
+ * Product Group Entity Configuration
+ *
+ * API: /products/groups
+ * Response keys: group (singular), groups (plural)
+ * Groups organize products into categories.
+ * Simplest entity config — no status operations, no entity-specific filters,
+ * no business rules. Factory provides base pagination parameters.
+ *
+ * Cross-references:
+ * - Use list-products to find product IDs for the product_ids array
+ */
+export declare const productGroupConfig: CrudEntityConfig;

package/build/tools/configs/product-group.js

@@ -0,0 +1,22 @@
+/**
+ * Product Group Entity Configuration
+ *
+ * API: /products/groups
+ * Response keys: group (singular), groups (plural)
+ * Groups organize products into categories.
+ * Simplest entity config — no status operations, no entity-specific filters,
+ * no business rules. Factory provides base pagination parameters.
+ *
+ * Cross-references:
+ * - Use list-products to find product IDs for the product_ids array
+ */
+export const productGroupConfig = {
+    entity: "product-group",
+    apiBasePath: "/products/groups",
+    singularKey: "group",
+    pluralKey: "groups",
+    description: "product group. Groups organize products into categories. Use list-products to find product IDs for the product_ids array.",
+    operations: ["list", "get", "create", "update", "delete"],
+    hasStatusUpdate: false,
+    listFilters: [],
+};

package/build/tools/configs/product.d.ts

@@ -0,0 +1,24 @@
+import type { CrudEntityConfig } from "../../types/bukku.js";
+/**
+ * Product Entity Configuration
+ *
+ * API: /products
+ * Response keys: product (singular), products (plural) — NOT transaction/transactions
+ * Products are non-transaction entities with custom wrapper keys.
+ * Archive/unarchive is handled by separate custom tools (product-archive.ts),
+ * NOT the factory status tool, because the API expects { is_archived: boolean }
+ * instead of { status: string }.
+ *
+ * List filters:
+ * - search: Text search across product name/code
+ * - stock_level: Filter by stock level (low, medium, high)
+ * - mode: Filter by product mode (sale, purchase, both)
+ * - type: Filter by product type (tracked, untracked, service)
+ * - include_archived: Boolean to include archived products in results
+ *
+ * Cross-references:
+ * - Use list-tax-codes to find valid tax code IDs for sale_tax_code_id and purchase_tax_code_id
+ * - Use list-accounts to find valid account IDs for sale_account_id, purchase_account_id, and inventory_account_id
+ * - Use list-product-groups to find group IDs for group_ids array
+ */
+export declare const productConfig: CrudEntityConfig;

package/build/tools/configs/product.js

@@ -0,0 +1,35 @@
+/**
+ * Product Entity Configuration
+ *
+ * API: /products
+ * Response keys: product (singular), products (plural) — NOT transaction/transactions
+ * Products are non-transaction entities with custom wrapper keys.
+ * Archive/unarchive is handled by separate custom tools (product-archive.ts),
+ * NOT the factory status tool, because the API expects { is_archived: boolean }
+ * instead of { status: string }.
+ *
+ * List filters:
+ * - search: Text search across product name/code
+ * - stock_level: Filter by stock level (low, medium, high)
+ * - mode: Filter by product mode (sale, purchase, both)
+ * - type: Filter by product type (tracked, untracked, service)
+ * - include_archived: Boolean to include archived products in results
+ *
+ * Cross-references:
+ * - Use list-tax-codes to find valid tax code IDs for sale_tax_code_id and purchase_tax_code_id
+ * - Use list-accounts to find valid account IDs for sale_account_id, purchase_account_id, and inventory_account_id
+ * - Use list-product-groups to find group IDs for group_ids array
+ */
+export const productConfig = {
+    entity: "product",
+    apiBasePath: "/products",
+    singularKey: "product",
+    pluralKey: "products",
+    description: "product. Use list-tax-codes to find valid tax code IDs for sale_tax_code_id and purchase_tax_code_id. Use list-accounts to find valid account IDs for sale_account_id, purchase_account_id, and inventory_account_id. Use list-product-groups to find group IDs for group_ids.",
+    operations: ["list", "get", "create", "update", "delete"],
+    hasStatusUpdate: false,
+    listFilters: ["search", "stock_level", "mode", "type", "include_archived"],
+    businessRules: {
+        delete: "Only products that are not used in any transactions can be deleted. Archive instead if the product has transaction history.",
+    },
+};

package/build/tools/configs/purchase-bill.d.ts

@@ -0,0 +1,9 @@
+import type { CrudEntityConfig } from "../../types/bukku.js";
+/**
+ * Purchase Bill Entity Configuration
+ *
+ * API: /purchases/bills
+ * Response keys: transaction (singular), transactions (plural)
+ * Note: payment_mode filter includes 'claim' option for expense claims/reimbursements
+ */
+export declare const purchaseBillConfig: CrudEntityConfig;

package/build/tools/configs/purchase-bill.js

@@ -0,0 +1,21 @@
+/**
+ * Purchase Bill Entity Configuration
+ *
+ * API: /purchases/bills
+ * Response keys: transaction (singular), transactions (plural)
+ * Note: payment_mode filter includes 'claim' option for expense claims/reimbursements
+ */
+export const purchaseBillConfig = {
+    entity: "purchase-bill",
+    apiBasePath: "/purchases/bills",
+    singularKey: "transaction",
+    pluralKey: "transactions",
+    description: "purchase bill",
+    operations: ["list", "get", "create", "update", "delete"],
+    hasStatusUpdate: true,
+    listFilters: ["contact_id", "payment_status", "payment_mode"],
+    businessRules: {
+        delete: "Only draft and void bills can be deleted. Ready or pending approval bills cannot be deleted — use update-purchase-bill-status to void a ready bill instead.",
+        statusTransitions: "Valid transitions: draft -> pending_approval, draft -> ready, pending_approval -> ready, ready -> void. A void bill is final and cannot be changed. There is no way to revert from ready, pending_approval, or void back to draft.",
+    },
+};

package/build/tools/configs/purchase-credit-note.d.ts

@@ -0,0 +1,8 @@
+import type { CrudEntityConfig } from "../../types/bukku.js";
+/**
+ * Purchase Credit Note Entity Configuration
+ *
+ * API: /purchases/credit_notes
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export declare const purchaseCreditNoteConfig: CrudEntityConfig;

package/build/tools/configs/purchase-credit-note.js

@@ -0,0 +1,20 @@
+/**
+ * Purchase Credit Note Entity Configuration
+ *
+ * API: /purchases/credit_notes
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export const purchaseCreditNoteConfig = {
+    entity: "purchase-credit-note",
+    apiBasePath: "/purchases/credit_notes",
+    singularKey: "transaction",
+    pluralKey: "transactions",
+    description: "purchase credit note",
+    operations: ["list", "get", "create", "update", "delete"],
+    hasStatusUpdate: true,
+    listFilters: ["contact_id", "payment_status"],
+    businessRules: {
+        delete: "Only draft and void credit notes can be deleted. Ready or pending approval credit notes cannot be deleted — use update-purchase-credit-note-status to void a ready credit note instead.",
+        statusTransitions: "Valid transitions: draft -> pending_approval, draft -> ready, pending_approval -> ready, ready -> void. A void credit note is final and cannot be changed. There is no way to revert from ready, pending_approval, or void back to draft.",
+    },
+};

package/build/tools/configs/purchase-order.d.ts

@@ -0,0 +1,8 @@
+import type { CrudEntityConfig } from "../../types/bukku.js";
+/**
+ * Purchase Order Entity Configuration
+ *
+ * API: /purchases/orders
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export declare const purchaseOrderConfig: CrudEntityConfig;

package/build/tools/configs/purchase-order.js

@@ -0,0 +1,20 @@
+/**
+ * Purchase Order Entity Configuration
+ *
+ * API: /purchases/orders
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export const purchaseOrderConfig = {
+    entity: "purchase-order",
+    apiBasePath: "/purchases/orders",
+    singularKey: "transaction",
+    pluralKey: "transactions",
+    description: "purchase order",
+    operations: ["list", "get", "create", "update", "delete"],
+    hasStatusUpdate: true,
+    listFilters: ["contact_id", "email_status", "transfer_status"],
+    businessRules: {
+        delete: "Only draft and void purchase orders can be deleted. Ready or pending approval purchase orders cannot be deleted — use update-purchase-order-status to void a ready purchase order instead.",
+        statusTransitions: "Valid transitions: draft -> pending_approval, draft -> ready, pending_approval -> ready, ready -> void. A void purchase order is final and cannot be changed. There is no way to revert from ready, pending_approval, or void back to draft.",
+    },
+};

package/build/tools/configs/purchase-payment.d.ts

@@ -0,0 +1,8 @@
+import type { CrudEntityConfig } from "../../types/bukku.js";
+/**
+ * Purchase Payment Entity Configuration
+ *
+ * API: /purchases/payments
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export declare const purchasePaymentConfig: CrudEntityConfig;

package/build/tools/configs/purchase-payment.js

@@ -0,0 +1,20 @@
+/**
+ * Purchase Payment Entity Configuration
+ *
+ * API: /purchases/payments
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export const purchasePaymentConfig = {
+    entity: "purchase-payment",
+    apiBasePath: "/purchases/payments",
+    singularKey: "transaction",
+    pluralKey: "transactions",
+    description: "purchase payment",
+    operations: ["list", "get", "create", "update", "delete"],
+    hasStatusUpdate: true,
+    listFilters: ["contact_id", "email_status", "payment_status", "account_id"],
+    businessRules: {
+        delete: "Only draft and void payments can be deleted. Ready or pending approval payments cannot be deleted — use update-purchase-payment-status to void a ready payment instead.",
+        statusTransitions: "Valid transitions: draft -> pending_approval, draft -> ready, pending_approval -> ready, ready -> void. A void payment is final and cannot be changed. There is no way to revert from ready, pending_approval, or void back to draft.",
+    },
+};

package/build/tools/configs/purchase-refund.d.ts

@@ -0,0 +1,8 @@
+import type { CrudEntityConfig } from "../../types/bukku.js";
+/**
+ * Purchase Refund Entity Configuration
+ *
+ * API: /purchases/refunds
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export declare const purchaseRefundConfig: CrudEntityConfig;

package/build/tools/configs/purchase-refund.js

@@ -0,0 +1,20 @@
+/**
+ * Purchase Refund Entity Configuration
+ *
+ * API: /purchases/refunds
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export const purchaseRefundConfig = {
+    entity: "purchase-refund",
+    apiBasePath: "/purchases/refunds",
+    singularKey: "transaction",
+    pluralKey: "transactions",
+    description: "purchase refund",
+    operations: ["list", "get", "create", "update", "delete"],
+    hasStatusUpdate: true,
+    listFilters: ["contact_id", "email_status", "payment_status", "account_id"],
+    businessRules: {
+        delete: "Only draft and void refunds can be deleted. Ready or pending approval refunds cannot be deleted — use update-purchase-refund-status to void a ready refund instead.",
+        statusTransitions: "Valid transitions: draft -> pending_approval, draft -> ready, pending_approval -> ready, ready -> void. A void refund is final and cannot be changed. There is no way to revert from ready, pending_approval, or void back to draft.",
+    },
+};

package/build/tools/configs/sales-credit-note.d.ts

@@ -0,0 +1,8 @@
+import type { CrudEntityConfig } from "../../types/bukku.js";
+/**
+ * Sales Credit Note Entity Configuration
+ *
+ * API: /sales/credit_notes
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export declare const salesCreditNoteConfig: CrudEntityConfig;

package/build/tools/configs/sales-credit-note.js

@@ -0,0 +1,20 @@
+/**
+ * Sales Credit Note Entity Configuration
+ *
+ * API: /sales/credit_notes
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export const salesCreditNoteConfig = {
+    entity: "sales-credit-note",
+    apiBasePath: "/sales/credit_notes",
+    singularKey: "transaction",
+    pluralKey: "transactions",
+    description: "sales credit note",
+    operations: ["list", "get", "create", "update", "delete"],
+    hasStatusUpdate: true,
+    listFilters: ["contact_id", "email_status"],
+    businessRules: {
+        delete: "Only draft and void credit notes can be deleted. Ready or pending approval credit notes cannot be deleted — use update-sales-credit-note-status to void a ready credit note instead.",
+        statusTransitions: "Valid transitions: draft -> pending_approval, draft -> ready, pending_approval -> ready, ready -> void. A void credit note is final and cannot be changed. There is no way to revert from ready, pending_approval, or void back to draft.",
+    },
+};

package/build/tools/configs/sales-invoice.d.ts

@@ -0,0 +1,8 @@
+import type { CrudEntityConfig } from "../../types/bukku.js";
+/**
+ * Sales Invoice Entity Configuration
+ *
+ * API: /sales/invoices
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export declare const salesInvoiceConfig: CrudEntityConfig;

package/build/tools/configs/sales-invoice.js

@@ -0,0 +1,20 @@
+/**
+ * Sales Invoice Entity Configuration
+ *
+ * API: /sales/invoices
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export const salesInvoiceConfig = {
+    entity: "sales-invoice",
+    apiBasePath: "/sales/invoices",
+    singularKey: "transaction",
+    pluralKey: "transactions",
+    description: "sales invoice",
+    operations: ["list", "get", "create", "update", "delete"],
+    hasStatusUpdate: true,
+    listFilters: ["contact_id", "email_status", "transfer_status", "payment_status"],
+    businessRules: {
+        delete: "Only draft and void invoices can be deleted. Ready or pending approval invoices cannot be deleted — use update-sales-invoice-status to void a ready invoice instead.",
+        statusTransitions: "Valid transitions: draft -> pending_approval, draft -> ready, pending_approval -> ready, ready -> void. A void invoice is final and cannot be changed. There is no way to revert from ready, pending_approval, or void back to draft.",
+    },
+};

package/build/tools/configs/sales-order.d.ts

@@ -0,0 +1,8 @@
+import type { CrudEntityConfig } from "../../types/bukku.js";
+/**
+ * Sales Order Entity Configuration
+ *
+ * API: /sales/orders
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export declare const salesOrderConfig: CrudEntityConfig;

package/build/tools/configs/sales-order.js

@@ -0,0 +1,20 @@
+/**
+ * Sales Order Entity Configuration
+ *
+ * API: /sales/orders
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export const salesOrderConfig = {
+    entity: "sales-order",
+    apiBasePath: "/sales/orders",
+    singularKey: "transaction",
+    pluralKey: "transactions",
+    description: "sales order",
+    operations: ["list", "get", "create", "update", "delete"],
+    hasStatusUpdate: true,
+    listFilters: ["contact_id", "email_status", "transfer_status"],
+    businessRules: {
+        delete: "Only draft and void orders can be deleted. Ready or pending approval orders cannot be deleted — use update-sales-order-status to void a ready order instead.",
+        statusTransitions: "Valid transitions: draft -> pending_approval, draft -> ready, pending_approval -> ready, ready -> void. A void order is final and cannot be changed. There is no way to revert from ready, pending_approval, or void back to draft.",
+    },
+};

package/build/tools/configs/sales-payment.d.ts

@@ -0,0 +1,8 @@
+import type { CrudEntityConfig } from "../../types/bukku.js";
+/**
+ * Sales Payment Entity Configuration
+ *
+ * API: /sales/payments
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export declare const salesPaymentConfig: CrudEntityConfig;

package/build/tools/configs/sales-payment.js

@@ -0,0 +1,20 @@
+/**
+ * Sales Payment Entity Configuration
+ *
+ * API: /sales/payments
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export const salesPaymentConfig = {
+    entity: "sales-payment",
+    apiBasePath: "/sales/payments",
+    singularKey: "transaction",
+    pluralKey: "transactions",
+    description: "sales payment",
+    operations: ["list", "get", "create", "update", "delete"],
+    hasStatusUpdate: true,
+    listFilters: ["contact_id", "payment_mode"],
+    businessRules: {
+        delete: "Only draft and void payments can be deleted. Ready or pending approval payments cannot be deleted — use update-sales-payment-status to void a ready payment instead.",
+        statusTransitions: "Valid transitions: draft -> pending_approval, draft -> ready, pending_approval -> ready, ready -> void. A void payment is final and cannot be changed. There is no way to revert from ready, pending_approval, or void back to draft.",
+    },
+};

package/build/tools/configs/sales-quote.d.ts

@@ -0,0 +1,8 @@
+import type { CrudEntityConfig } from "../../types/bukku.js";
+/**
+ * Sales Quote Entity Configuration
+ *
+ * API: /sales/quotes
+ * Response keys: transaction (singular), transactions (plural)
+ */
+export declare const salesQuoteConfig: CrudEntityConfig;