@hisaabo/cli 0.6.1 → 0.8.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (210) hide show
  1. package/LICENSE +31 -0
  2. package/README.md +9 -0
  3. package/dist/bin/{audit-trail-4AMEFQGB.js → audit-trail-IJ6SKACR.js} +3 -3
  4. package/dist/bin/{categories-CLCBRNWC.js → categories-O6TODPAH.js} +2 -2
  5. package/dist/bin/{check-slug-OKW7KDYG.js → check-slug-P7RFU6OP.js} +2 -2
  6. package/dist/bin/chunk-NO4FIFMS.js +0 -0
  7. package/dist/bin/{chunk-FIMJZAS4.js → chunk-QUITS2FE.js} +46 -1
  8. package/dist/bin/{chunk-GXRLFDZW.js → chunk-WDN7RIE3.js} +32 -2
  9. package/dist/bin/{chunk-T63VQXNM.js → chunk-ZPYC767N.js} +1 -0
  10. package/dist/bin/{client-2ZKMLWI6.js → client-36JX5MR3.js} +1 -1
  11. package/dist/bin/{collection-efficiency-TECE6PVQ.js → collection-efficiency-DA5RWG3V.js} +3 -3
  12. package/dist/bin/{config-335MN4I7.js → config-4LLNT4SH.js} +5 -1
  13. package/dist/bin/{create-AS2YVGRA.js → create-C5INBPQO.js} +2 -2
  14. package/dist/bin/{default-account-3RVSU7RF.js → default-account-2GMQ7ZA4.js} +2 -2
  15. package/dist/bin/{expenses-KXFQJKD6.js → expenses-S2YVA5UT.js} +3 -3
  16. package/dist/bin/{export-UHZISG7H.js → export-YOOODNVX.js} +2 -2
  17. package/dist/bin/export-ZA43MLWO.js +191 -0
  18. package/dist/bin/{factory-OBESY2LG.js → factory-6MUCSXTL.js} +3 -3
  19. package/dist/bin/{get-WUSYEMG4.js → get-GMQRROK2.js} +2 -2
  20. package/dist/bin/{get-GTL556HL.js → get-ZV3SC2VY.js} +3 -3
  21. package/dist/bin/hisaabo.js +107 -59
  22. package/dist/bin/import-UUHMLCKX.js +267 -0
  23. package/dist/bin/{invitations-U4ZNYWY7.js → invitations-OVORTTMF.js} +2 -2
  24. package/dist/bin/{invite-5S4GJKRF.js → invite-GGHBZY4U.js} +2 -2
  25. package/dist/bin/{invoice-breakdown-PP3BZQLG.js → invoice-breakdown-32XXAZDP.js} +3 -3
  26. package/dist/bin/{items-CHEFLI7C.js → items-6NOIMH6B.js} +3 -3
  27. package/dist/bin/{items-toggle-ETVCDCU6.js → items-toggle-L6W6QKQD.js} +2 -2
  28. package/dist/bin/{list-3FO4UJKC.js → list-FC5JHKHD.js} +3 -3
  29. package/dist/bin/{list-RJ34MFPR.js → list-OXAVDXH7.js} +2 -2
  30. package/dist/bin/{list-LQJGTZB4.js → list-RAR56EMQ.js} +2 -2
  31. package/dist/bin/{members-TE5K5NQC.js → members-Y6XJVHHR.js} +3 -3
  32. package/dist/bin/{monthly-comparison-Q6KPMTPS.js → monthly-comparison-IAUZ6SBJ.js} +3 -3
  33. package/dist/bin/{order-cancel-NOQDBL2N.js → order-cancel-QRTCNART.js} +2 -2
  34. package/dist/bin/{order-confirm-6WMKTGPV.js → order-confirm-LGQOMC4O.js} +2 -2
  35. package/dist/bin/{order-get-ONWR4GTW.js → order-get-4XAQCRYV.js} +3 -3
  36. package/dist/bin/{order-update-IVO4AFGV.js → order-update-KZY4H2UR.js} +3 -3
  37. package/dist/bin/output-NUOL7KJW.js +0 -0
  38. package/dist/bin/{payment-modes-FXB2G6WP.js → payment-modes-DY2ZEMK7.js} +3 -3
  39. package/dist/bin/{profit-loss-XPYELDTH.js → profit-loss-5GJBG3PL.js} +3 -3
  40. package/dist/bin/{receivables-aging-MU6Q3DZ4.js → receivables-aging-6A7XJKDT.js} +3 -3
  41. package/dist/bin/{remove-DJBOOOR4.js → remove-ZBX34TIQ.js} +2 -2
  42. package/dist/bin/{revoke-WRIK7HLY.js → revoke-XDNOA2GJ.js} +2 -2
  43. package/dist/bin/{revoke-5L5GZ4ZZ.js → revoke-ZTAMW2Q2.js} +2 -2
  44. package/dist/bin/{revoke-all-QARW2G6R.js → revoke-all-365NRBOA.js} +2 -2
  45. package/dist/bin/{revoke-invitation-ZGLJHYNB.js → revoke-invitation-PQH7XNYA.js} +2 -2
  46. package/dist/bin/{sales-trend-P5HOZJSX.js → sales-trend-D6PQ7MHY.js} +3 -3
  47. package/dist/bin/{sequence-LK6QLSI5.js → sequence-KZWADVD7.js} +2 -2
  48. package/dist/bin/{store-FU7CEILC.js → store-SVRZBUFO.js} +3 -3
  49. package/dist/bin/{summary-XONLN72I.js → summary-H6U7O5GJ.js} +3 -3
  50. package/dist/bin/{top-customers-U6HQW2GH.js → top-customers-ATBN6RDI.js} +3 -3
  51. package/dist/bin/{top-items-EAOIVZ4P.js → top-items-XXU6KYTC.js} +3 -3
  52. package/dist/bin/{top-outstanding-4546FJDH.js → top-outstanding-JTQNGGW4.js} +3 -3
  53. package/dist/bin/{unpaid-invoices-AED55PLC.js → unpaid-invoices-BTNQFWCH.js} +3 -3
  54. package/dist/bin/{untracked-ZEM2CDHC.js → untracked-PAMEDJ6Y.js} +3 -3
  55. package/dist/bin/{update-FO7AAXF5.js → update-6ZMX2OYX.js} +3 -3
  56. package/dist/bin/{update-OZPBIBME.js → update-EGHPFXLK.js} +2 -2
  57. package/dist/bin/{update-QCK32XAG.js → update-EK4NJWU4.js} +3 -3
  58. package/dist/bin/{update-role-RB35QIA5.js → update-role-24PDTNFK.js} +2 -2
  59. package/dist/bin/{update-settings-EUC2FJQJ.js → update-settings-AASI6WZX.js} +2 -2
  60. package/package.json +35 -9
  61. package/.turbo/turbo-build.log +0 -13
  62. package/.turbo/turbo-typecheck.log +0 -4
  63. package/CLI-UX-ARCHITECTURE.md +0 -1269
  64. package/src/auth.ts +0 -221
  65. package/src/bin/hisaabo.ts +0 -74
  66. package/src/bin/registrars/api-key.ts +0 -44
  67. package/src/bin/registrars/auth.ts +0 -222
  68. package/src/bin/registrars/automated-invoice.ts +0 -167
  69. package/src/bin/registrars/bank-recon.ts +0 -34
  70. package/src/bin/registrars/bank.ts +0 -124
  71. package/src/bin/registrars/business.ts +0 -120
  72. package/src/bin/registrars/dashboard.ts +0 -225
  73. package/src/bin/registrars/document.ts +0 -184
  74. package/src/bin/registrars/einvoice.ts +0 -46
  75. package/src/bin/registrars/ewb.ts +0 -37
  76. package/src/bin/registrars/expense.ts +0 -87
  77. package/src/bin/registrars/gst.ts +0 -57
  78. package/src/bin/registrars/import.ts +0 -49
  79. package/src/bin/registrars/invoice.ts +0 -117
  80. package/src/bin/registrars/itc.ts +0 -56
  81. package/src/bin/registrars/item.ts +0 -112
  82. package/src/bin/registrars/journal.ts +0 -47
  83. package/src/bin/registrars/party.ts +0 -81
  84. package/src/bin/registrars/payment.ts +0 -128
  85. package/src/bin/registrars/report.ts +0 -186
  86. package/src/bin/registrars/session.ts +0 -32
  87. package/src/bin/registrars/shipment.ts +0 -74
  88. package/src/bin/registrars/store.ts +0 -128
  89. package/src/bin/registrars/target.ts +0 -46
  90. package/src/bin/registrars/tenant.ts +0 -73
  91. package/src/client.ts +0 -2051
  92. package/src/commands/api-key/create.ts +0 -72
  93. package/src/commands/api-key/list.ts +0 -71
  94. package/src/commands/api-key/revoke.ts +0 -46
  95. package/src/commands/automated-invoice/create.ts +0 -85
  96. package/src/commands/automated-invoice/delete.ts +0 -42
  97. package/src/commands/automated-invoice/get.ts +0 -113
  98. package/src/commands/automated-invoice/history.ts +0 -65
  99. package/src/commands/automated-invoice/index.ts +0 -11
  100. package/src/commands/automated-invoice/list.ts +0 -91
  101. package/src/commands/automated-invoice/pause.ts +0 -29
  102. package/src/commands/automated-invoice/resume.ts +0 -29
  103. package/src/commands/automated-invoice/run-now.ts +0 -29
  104. package/src/commands/automated-invoice/suggestions.ts +0 -68
  105. package/src/commands/automated-invoice/update.ts +0 -54
  106. package/src/commands/automated-invoice/usage.ts +0 -68
  107. package/src/commands/bank/gateway-config.ts +0 -61
  108. package/src/commands/bank/index.ts +0 -244
  109. package/src/commands/bank/update-gateway.ts +0 -84
  110. package/src/commands/bank-recon/index.ts +0 -127
  111. package/src/commands/business/audit-trail.ts +0 -79
  112. package/src/commands/business/export.ts +0 -52
  113. package/src/commands/business/get.ts +0 -55
  114. package/src/commands/business/sequence.ts +0 -65
  115. package/src/commands/business/update.ts +0 -64
  116. package/src/commands/dashboard/collection-efficiency.ts +0 -164
  117. package/src/commands/dashboard/expenses.ts +0 -76
  118. package/src/commands/dashboard/invoice-breakdown.ts +0 -89
  119. package/src/commands/dashboard/monthly-comparison.ts +0 -193
  120. package/src/commands/dashboard/payment-modes.ts +0 -121
  121. package/src/commands/dashboard/profit-loss.ts +0 -146
  122. package/src/commands/dashboard/receivables-aging.ts +0 -169
  123. package/src/commands/dashboard/sales-trend.ts +0 -68
  124. package/src/commands/dashboard/summary.ts +0 -105
  125. package/src/commands/dashboard/top-customers.ts +0 -70
  126. package/src/commands/dashboard/top-items.ts +0 -74
  127. package/src/commands/dashboard/top-outstanding.ts +0 -61
  128. package/src/commands/dashboard.ts +0 -105
  129. package/src/commands/document/factory.ts +0 -590
  130. package/src/commands/einvoice/index.ts +0 -109
  131. package/src/commands/ewb/index.ts +0 -108
  132. package/src/commands/expense/categories.ts +0 -40
  133. package/src/commands/expense/create.ts +0 -51
  134. package/src/commands/expense/delete.ts +0 -45
  135. package/src/commands/expense/list.ts +0 -65
  136. package/src/commands/expense/update.ts +0 -58
  137. package/src/commands/gst/index.ts +0 -194
  138. package/src/commands/import/index.ts +0 -168
  139. package/src/commands/invoice/create.ts +0 -262
  140. package/src/commands/invoice/delete.ts +0 -44
  141. package/src/commands/invoice/get.ts +0 -105
  142. package/src/commands/invoice/list.ts +0 -126
  143. package/src/commands/invoice/pdf.ts +0 -75
  144. package/src/commands/invoice/status.ts +0 -41
  145. package/src/commands/itc/index.ts +0 -163
  146. package/src/commands/item/categories.ts +0 -40
  147. package/src/commands/item/create.ts +0 -98
  148. package/src/commands/item/delete.ts +0 -44
  149. package/src/commands/item/list.ts +0 -81
  150. package/src/commands/item/low-stock-count.ts +0 -32
  151. package/src/commands/item/merge.ts +0 -53
  152. package/src/commands/item/price-history.ts +0 -59
  153. package/src/commands/item/rename-unit.ts +0 -39
  154. package/src/commands/item/sales-stats.ts +0 -44
  155. package/src/commands/item/stock-history.ts +0 -70
  156. package/src/commands/item/stock.ts +0 -46
  157. package/src/commands/item/switch-base-unit.ts +0 -42
  158. package/src/commands/item/update.ts +0 -59
  159. package/src/commands/item/variants-create.ts +0 -58
  160. package/src/commands/item/variants-delete.ts +0 -47
  161. package/src/commands/item/variants-list.ts +0 -63
  162. package/src/commands/item/variants-update.ts +0 -61
  163. package/src/commands/journal/index.ts +0 -156
  164. package/src/commands/party/create.ts +0 -88
  165. package/src/commands/party/delete.ts +0 -44
  166. package/src/commands/party/get.ts +0 -42
  167. package/src/commands/party/ledger-report.ts +0 -81
  168. package/src/commands/party/ledger.ts +0 -63
  169. package/src/commands/party/list.ts +0 -69
  170. package/src/commands/party/merge.ts +0 -50
  171. package/src/commands/party/stats.ts +0 -40
  172. package/src/commands/party/top-items.ts +0 -57
  173. package/src/commands/party/update.ts +0 -65
  174. package/src/commands/payment/create.ts +0 -131
  175. package/src/commands/payment/default-account.ts +0 -56
  176. package/src/commands/payment/delete.ts +0 -46
  177. package/src/commands/payment/get.ts +0 -59
  178. package/src/commands/payment/list.ts +0 -66
  179. package/src/commands/payment/unpaid-invoices.ts +0 -69
  180. package/src/commands/payment/untracked.ts +0 -70
  181. package/src/commands/payment/update.ts +0 -54
  182. package/src/commands/report/index.ts +0 -736
  183. package/src/commands/session/list.ts +0 -91
  184. package/src/commands/session/revoke-all.ts +0 -20
  185. package/src/commands/session/revoke.ts +0 -32
  186. package/src/commands/shipment/index.ts +0 -170
  187. package/src/commands/store/check-slug.ts +0 -48
  188. package/src/commands/store/index.ts +0 -77
  189. package/src/commands/store/items-toggle.ts +0 -41
  190. package/src/commands/store/items.ts +0 -61
  191. package/src/commands/store/order-cancel.ts +0 -48
  192. package/src/commands/store/order-confirm.ts +0 -45
  193. package/src/commands/store/order-get.ts +0 -66
  194. package/src/commands/store/order-update.ts +0 -52
  195. package/src/commands/store/update-settings.ts +0 -52
  196. package/src/commands/target/index.ts +0 -118
  197. package/src/commands/tenant/invitations.ts +0 -62
  198. package/src/commands/tenant/invite.ts +0 -57
  199. package/src/commands/tenant/list.ts +0 -46
  200. package/src/commands/tenant/members.ts +0 -55
  201. package/src/commands/tenant/remove.ts +0 -47
  202. package/src/commands/tenant/revoke-invitation.ts +0 -32
  203. package/src/commands/tenant/update-role.ts +0 -41
  204. package/src/config.ts +0 -96
  205. package/src/error-handler.ts +0 -53
  206. package/src/format.ts +0 -180
  207. package/src/output.ts +0 -228
  208. package/src/spinner.ts +0 -39
  209. package/tsconfig.json +0 -22
  210. package/tsup.config.ts +0 -18
package/src/client.ts DELETED
@@ -1,2051 +0,0 @@
1
- /**
2
- * HisaaboClient — thin fetch wrapper over the tRPC HTTP API.
3
- * CLI variant: adds x-client-type: "cli" header.
4
- */
5
-
6
- import superjson from "superjson";
7
-
8
- export interface ClientConfig {
9
- apiUrl: string;
10
- token: string;
11
- tenantId: string;
12
- businessId: string;
13
- }
14
-
15
- // ── Structured error types ──────────────────────────────────────────────────
16
-
17
- export type HisaaboError =
18
- | { code: "unauthorized"; message: string }
19
- | { code: "forbidden"; message: string }
20
- | { code: "not_found"; resource: string }
21
- | { code: "validation_failed"; fields: Record<string, string[]> }
22
- | { code: "network_error"; message: string }
23
- | { code: "rate_limited"; retryAfterMs: number; message: string }
24
- | { code: "api_error"; message: string };
25
-
26
- export class HisaaboApiError extends Error {
27
- constructor(public readonly hisaaboError: HisaaboError) {
28
- super(formatHisaaboError(hisaaboError));
29
- this.name = "HisaaboApiError";
30
- }
31
- }
32
-
33
- export function formatHisaaboError(err: HisaaboError): string {
34
- switch (err.code) {
35
- case "unauthorized":
36
- return `Authentication required: ${err.message}`;
37
- case "forbidden":
38
- return `Permission denied: ${err.message}`;
39
- case "not_found":
40
- return `Not found: ${err.resource}`;
41
- case "validation_failed":
42
- return (
43
- `Validation failed:\n` +
44
- Object.entries(err.fields)
45
- .map(([field, msgs]) => ` ${field}: ${msgs.join(", ")}`)
46
- .join("\n")
47
- );
48
- case "rate_limited":
49
- return `Rate limited: ${err.message}`;
50
- case "network_error":
51
- return `Network error: ${err.message}`;
52
- case "api_error":
53
- return `API error: ${err.message}`;
54
- }
55
- }
56
-
57
- function normalizeTrpcError(raw: unknown): HisaaboError {
58
- if (!raw || typeof raw !== "object") {
59
- return { code: "api_error", message: "Unknown error from API" };
60
- }
61
- const err = raw as Record<string, unknown>;
62
- const code = err["code"] as string | undefined;
63
- const message = (err["message"] as string | undefined) ?? "Unknown error";
64
-
65
- if (code === "UNAUTHORIZED") return { code: "unauthorized", message };
66
- if (code === "FORBIDDEN") return { code: "forbidden", message };
67
- if (code === "NOT_FOUND") return { code: "not_found", resource: message };
68
-
69
- if (code === "BAD_REQUEST") {
70
- const data = err["data"] as Record<string, unknown> | undefined;
71
- const zodError = data?.["zodError"] as { fieldErrors?: Record<string, string[]> } | undefined;
72
- if (zodError?.fieldErrors) {
73
- return { code: "validation_failed", fields: zodError.fieldErrors };
74
- }
75
- return { code: "validation_failed", fields: { _: [message] } };
76
- }
77
-
78
- return { code: "api_error", message };
79
- }
80
-
81
- // ── HTTP client ────────────────────────────────────────────────────────────
82
-
83
- export class HisaaboClient {
84
- readonly apiUrl: string;
85
-
86
- constructor(private readonly config: ClientConfig) {
87
- this.apiUrl = config.apiUrl;
88
- }
89
-
90
- private buildHeaders(): Record<string, string> {
91
- return {
92
- "Authorization": `Bearer ${this.config.token}`,
93
- "x-business-id": this.config.businessId,
94
- "x-tenant-id": this.config.tenantId,
95
- "x-client-type": "cli",
96
- };
97
- }
98
-
99
- private async unwrap<T>(res: Response): Promise<T> {
100
- // Detect rate limiting before tRPC error parsing
101
- if (res.status === 429) {
102
- const retryAfter = res.headers.get("retry-after");
103
- let retryMs = 60_000;
104
- if (retryAfter) {
105
- const parsed = Number(retryAfter);
106
- if (Number.isFinite(parsed) && parsed > 0) {
107
- retryMs = Math.min(parsed * 1000, 120_000); // cap at 2 minutes
108
- }
109
- }
110
- throw new HisaaboApiError({
111
- code: "rate_limited",
112
- retryAfterMs: retryMs,
113
- message: `Rate limited. Try again in ${Math.ceil(retryMs / 1000)}s.`,
114
- });
115
- }
116
-
117
- const body = await res.json() as unknown;
118
-
119
- if (typeof body !== "object" || body === null) {
120
- throw new HisaaboApiError({ code: "api_error", message: "Unexpected response format from API" });
121
- }
122
-
123
- const envelope = body as Record<string, unknown>;
124
-
125
- if (!res.ok || "error" in envelope) {
126
- throw new HisaaboApiError(normalizeTrpcError(envelope["error"] ?? { code: "api_error", message: `HTTP ${res.status}` }));
127
- }
128
-
129
- const result = (envelope["result"] as Record<string, unknown> | undefined);
130
- if (!result) {
131
- throw new HisaaboApiError({ code: "api_error", message: "Missing result in API response" });
132
- }
133
-
134
- const data = result["data"] as unknown;
135
- return superjson.deserialize(data as Parameters<typeof superjson.deserialize>[0]) as T;
136
- }
137
-
138
- async query<T>(path: string, input?: unknown): Promise<T> {
139
- const maxRetries = 2;
140
- for (let attempt = 0; attempt <= maxRetries; attempt++) {
141
- try {
142
- const url = new URL(`${this.config.apiUrl}/api/trpc/${path}`);
143
- if (input !== undefined) {
144
- url.searchParams.set("input", JSON.stringify(superjson.serialize(input)));
145
- }
146
- const res = await fetch(url.toString(), { headers: this.buildHeaders() });
147
- return await this.unwrap<T>(res);
148
- } catch (e) {
149
- // Auto-retry on rate limit for idempotent reads
150
- if (e instanceof HisaaboApiError && e.hisaaboError.code === "rate_limited" && attempt < maxRetries) {
151
- const waitMs = Math.min((e.hisaaboError as { retryAfterMs: number }).retryAfterMs, 10_000);
152
- await new Promise((r) => setTimeout(r, waitMs));
153
- continue;
154
- }
155
- if (e instanceof HisaaboApiError) throw e;
156
- throw new HisaaboApiError({ code: "network_error", message: String(e instanceof Error ? e.message : e) });
157
- }
158
- }
159
- throw new HisaaboApiError({ code: "api_error", message: "Max retries exceeded" });
160
- }
161
-
162
- async mutate<T>(path: string, input: unknown): Promise<T> {
163
- try {
164
- const res = await fetch(`${this.config.apiUrl}/api/trpc/${path}`, {
165
- method: "POST",
166
- headers: { ...this.buildHeaders(), "Content-Type": "application/json" },
167
- body: JSON.stringify(superjson.serialize(input)),
168
- });
169
- return this.unwrap<T>(res);
170
- } catch (e) {
171
- if (e instanceof HisaaboApiError) throw e;
172
- throw new HisaaboApiError({ code: "network_error", message: String(e instanceof Error ? e.message : e) });
173
- }
174
- }
175
-
176
- // ── Auth ──────────────────────────────────────────────────────
177
-
178
- get auth() {
179
- const c = this;
180
- return {
181
- login(input: { email: string; password: string }) {
182
- return c.mutate<{ sessionId: string; user: AuthUser }>("auth.login", input);
183
- },
184
- logout() {
185
- return c.mutate<{ success: boolean }>("auth.logout", {});
186
- },
187
- me() {
188
- return c.query<AuthUser>("auth.me");
189
- },
190
- completeProfile(input: { name: string }) {
191
- return c.mutate<any>("auth.completeProfile", input);
192
- },
193
- logoutAll() {
194
- return c.mutate<any>("auth.logoutAll", {});
195
- },
196
- register(input: any) {
197
- return c.mutate<any>("auth.register", input);
198
- },
199
- updateName(input: { name: string }) {
200
- return c.mutate<any>("auth.updateName", input);
201
- },
202
- listSessions(input: { expired: boolean }) {
203
- return c.query<any>("auth.listSessions", input);
204
- },
205
- revokeSession(input: { sessionId: string }) {
206
- return c.mutate<any>("auth.revokeSession", input);
207
- },
208
- };
209
- }
210
-
211
- // ── Business ──────────────────────────────────────────────────
212
-
213
- get business() {
214
- const c = this;
215
- return {
216
- list() {
217
- return c.query<BusinessSummary[]>("business.list");
218
- },
219
- get() {
220
- return c.query<BusinessDetail>("business.getById");
221
- },
222
- create(input: any) {
223
- return c.mutate<any>("business.create", input);
224
- },
225
- update(input: any) {
226
- return c.mutate<any>("business.update", input);
227
- },
228
- updateSequenceNumber(input: any) {
229
- return c.mutate<any>("business.updateSequenceNumber", input);
230
- },
231
- auditTrail(input?: { page?: number; limit?: number }) {
232
- return c.query<any>("business.auditTrail", input);
233
- },
234
- exportData() {
235
- return c.mutate<any>("business.exportData", {});
236
- },
237
- };
238
- }
239
-
240
- // ── Invoice ───────────────────────────────────────────────────
241
-
242
- get invoice() {
243
- const c = this;
244
- return {
245
- list(input: InvoiceListInput) {
246
- return c.query<PaginatedResult<InvoiceSummary>>("invoice.list", input);
247
- },
248
- get(id: string) {
249
- return c.query<InvoiceDetail>("invoice.getById", { id });
250
- },
251
- create(input: InvoiceCreateInput) {
252
- return c.mutate<InvoiceDetail>("invoice.create", input);
253
- },
254
- update(input: any) {
255
- return c.mutate<any>("invoice.update", input);
256
- },
257
- updateStatus(id: string, status: InvoiceStatus) {
258
- return c.mutate<InvoiceSummary>("invoice.updateStatus", { id, status });
259
- },
260
- delete(id: string) {
261
- return c.mutate<{ success: boolean }>("invoice.delete", { id });
262
- },
263
- };
264
- }
265
-
266
- // ── Party ─────────────────────────────────────────────────────
267
-
268
- get party() {
269
- const c = this;
270
- return {
271
- list(input: PartyListInput) {
272
- return c.query<PaginatedResult<PartySummary>>("party.list", input);
273
- },
274
- get(id: string) {
275
- return c.query<PartyDetail>("party.getById", { id });
276
- },
277
- create(input: PartyCreateInput) {
278
- return c.mutate<PartySummary>("party.create", input);
279
- },
280
- update(id: string, data: Partial<PartyCreateInput>) {
281
- return c.mutate<PartyDetail>("party.update", { id, data });
282
- },
283
- delete(id: string) {
284
- return c.mutate<{ success: boolean }>("party.delete", { id });
285
- },
286
- ledger(partyId: string, input?: LedgerInput) {
287
- return c.query<LedgerResult>("party.ledger", { partyId, ...input });
288
- },
289
- ledgerReport(input: any) {
290
- return c.query<any>("party.ledgerReport", input);
291
- },
292
- getStats(input: any) {
293
- return c.query<any>("party.getStats", input);
294
- },
295
- topItems(input: any) {
296
- return c.query<any>("party.topItems", input);
297
- },
298
- merge(input: any) {
299
- return c.mutate<any>("party.merge", input);
300
- },
301
- };
302
- }
303
-
304
- // ── Item ──────────────────────────────────────────────────────
305
-
306
- get item() {
307
- const c = this;
308
- return {
309
- list(input: ItemListInput) {
310
- return c.query<PaginatedResult<ItemSummary>>("item.list", input);
311
- },
312
- get(id: string) {
313
- return c.query<ItemDetail>("item.getById", { id });
314
- },
315
- create(input: ItemCreateInput) {
316
- return c.mutate<ItemSummary>("item.create", input);
317
- },
318
- update(id: string, data: Partial<ItemCreateInput>) {
319
- return c.mutate<ItemDetail>("item.update", { id, data });
320
- },
321
- delete(id: string) {
322
- return c.mutate<{ success: boolean }>("item.delete", { id });
323
- },
324
- adjustStock(input: StockAdjustInput) {
325
- return c.mutate<ItemSummary>("item.adjustStock", input);
326
- },
327
- categories() {
328
- return c.query<string[]>("item.categories");
329
- },
330
- createVariant(input: any) {
331
- return c.mutate<any>("item.createVariant", input);
332
- },
333
- updateVariant(input: any) {
334
- return c.mutate<any>("item.updateVariant", input);
335
- },
336
- deleteVariant(input: any) {
337
- return c.mutate<any>("item.deleteVariant", input);
338
- },
339
- listVariants(input: any) {
340
- return c.query<any>("item.listVariants", input);
341
- },
342
- merge(input: any) {
343
- return c.mutate<any>("item.merge", input);
344
- },
345
- switchBaseUnit(input: any) {
346
- return c.mutate<any>("item.switchBaseUnit", input);
347
- },
348
- renameUnit(input: any) {
349
- return c.mutate<any>("item.renameUnit", input);
350
- },
351
- stockAdjustmentHistory(input: any) {
352
- return c.query<any>("item.stockAdjustmentHistory", input);
353
- },
354
- lowStockCount() {
355
- return c.query<any>("item.lowStockCount");
356
- },
357
- priceHistory(input: any) {
358
- return c.query<any>("item.priceHistory", input);
359
- },
360
- salesStats(input: any) {
361
- return c.query<any>("item.salesStats", input);
362
- },
363
- stockMovements(input: any) {
364
- return c.query<any>("item.stockMovements", input);
365
- },
366
- };
367
- }
368
-
369
- // ── Payment ───────────────────────────────────────────────────
370
-
371
- get payment() {
372
- const c = this;
373
- return {
374
- list(input: PaymentListInput) {
375
- return c.query<PaginatedResult<PaymentSummary>>("payment.list", input);
376
- },
377
- getById(id: string) {
378
- return c.query<PaymentDetail | null>("payment.getById", { id });
379
- },
380
- create(input: PaymentCreateInput) {
381
- return c.mutate<PaymentSummary>("payment.create", input);
382
- },
383
- update(input: PaymentUpdateInput) {
384
- return c.mutate<PaymentSummary>("payment.update", input);
385
- },
386
- delete(id: string) {
387
- return c.mutate<{ success: boolean }>("payment.delete", { id });
388
- },
389
- unpaidInvoices(input: any) {
390
- return c.query<any>("payment.unpaidInvoices", input);
391
- },
392
- untrackedPayments(input: any) {
393
- return c.query<any>("payment.untrackedPayments", input);
394
- },
395
- defaultAccount(input?: any) {
396
- return c.query<any>("payment.defaultAccount", input);
397
- },
398
- assignAccount(input: any) {
399
- return c.mutate<any>("payment.assignAccount", input);
400
- },
401
- };
402
- }
403
-
404
- // ── Expense ───────────────────────────────────────────────────
405
-
406
- get expense() {
407
- const c = this;
408
- return {
409
- list(input: ExpenseListInput) {
410
- return c.query<PaginatedResult<ExpenseSummary>>("expense.list", input);
411
- },
412
- create(input: ExpenseCreateInput) {
413
- return c.mutate<ExpenseSummary>("expense.create", input);
414
- },
415
- update(id: string, data: Partial<ExpenseCreateInput>) {
416
- return c.mutate<ExpenseSummary>("expense.update", { id, data });
417
- },
418
- delete(id: string) {
419
- return c.mutate<{ success: boolean }>("expense.delete", { id });
420
- },
421
- categories() {
422
- return c.query<string[]>("expense.categories");
423
- },
424
- };
425
- }
426
-
427
- // ── Dashboard ─────────────────────────────────────────────────
428
-
429
- get dashboard() {
430
- const c = this;
431
- return {
432
- summary(input?: DashboardInput) {
433
- return c.query<DashboardSummary>("dashboard.summary", input);
434
- },
435
- salesTrend(input: { months?: number; fromDate?: string; toDate?: string; granularity?: string }) {
436
- return c.query<any>("dashboard.salesTrend", input);
437
- },
438
- topOutstanding(input?: { limit?: number }) {
439
- return c.query<any>("dashboard.topOutstanding", input);
440
- },
441
- topCustomers(input?: { limit?: number; fromDate?: string; toDate?: string }) {
442
- return c.query<any>("dashboard.topCustomers", input);
443
- },
444
- topSellingItems(input?: { limit?: number; itemType?: string; fromDate?: string; toDate?: string }) {
445
- return c.query<any>("dashboard.topSellingItems", input);
446
- },
447
- expensesByCategory(input?: { fromDate?: string; toDate?: string }) {
448
- return c.query<any>("dashboard.expensesByCategory", input);
449
- },
450
- invoiceStatusBreakdown(input?: { fromDate?: string; toDate?: string }) {
451
- return c.query<any>("dashboard.invoiceStatusBreakdown", input);
452
- },
453
- profitAndLoss(input?: { fromDate?: string; toDate?: string }) {
454
- return c.query<any>("dashboard.profitAndLoss", input);
455
- },
456
- receivablesAging() {
457
- return c.query<any>("dashboard.receivablesAging");
458
- },
459
- paymentModeBreakdown(input?: { fromDate?: string; toDate?: string }) {
460
- return c.query<any>("dashboard.paymentModeBreakdown", input);
461
- },
462
- collectionEfficiency(input?: { fromDate?: string; toDate?: string }) {
463
- return c.query<any>("dashboard.collectionEfficiency", input);
464
- },
465
- monthlyComparison() {
466
- return c.query<any>("dashboard.monthlyComparison");
467
- },
468
- shippingSummary(input?: { fromDate?: string; toDate?: string }) {
469
- return c.query<any>("dashboard.shippingSummary", input);
470
- },
471
- };
472
- }
473
-
474
- // ── GST ───────────────────────────────────────────────────────
475
-
476
- get gst() {
477
- const c = this;
478
- return {
479
- gstr1(input: GstReportInput) {
480
- return c.query<GstReportResult>("gst.gstr1", input);
481
- },
482
- gstr3b(input: GstReportInput) {
483
- return c.query<GstReportResult>("gst.gstr3b", input);
484
- },
485
- gstr1CSV(input: GstReportInput) {
486
- return c.query<{ csv: string; filename: string }>("gst.gstr1CSV", input);
487
- },
488
- gstr9(input: { financialYear: string }) {
489
- return c.query<any>("gst.gstr9", input);
490
- },
491
- gstr2bUploads(input?: Record<string, unknown>) {
492
- return c.query<any>("gstr2b.uploads", input ?? {});
493
- },
494
- };
495
- }
496
-
497
- // ── Shipment ──────────────────────────────────────────────────
498
-
499
- get shipment() {
500
- const c = this;
501
- return {
502
- list(input: ShipmentListInput) {
503
- return c.query<PaginatedResult<ShipmentSummary>>("shipment.list", input);
504
- },
505
- get(id: string) {
506
- return c.query<ShipmentDetail | null>("shipment.getById", { id });
507
- },
508
- create(input: ShipmentCreateInput) {
509
- return c.mutate<ShipmentDetail>("shipment.create", input);
510
- },
511
- update(input: ShipmentUpdateInput) {
512
- return c.mutate<ShipmentDetail>("shipment.update", input);
513
- },
514
- delete(id: string) {
515
- return c.mutate<{ success: boolean }>("shipment.delete", { id });
516
- },
517
- };
518
- }
519
-
520
- // ── Bank Account ──────────────────────────────────────────────
521
-
522
- get bankAccount() {
523
- const c = this;
524
- return {
525
- list() {
526
- return c.query<BankAccountSummary[]>("bankAccount.list");
527
- },
528
- get(id: string) {
529
- return c.query<BankAccountDetail | null>("bankAccount.getById", { id });
530
- },
531
- create(input: BankAccountCreateInput) {
532
- return c.mutate<BankAccountSummary>("bankAccount.create", input);
533
- },
534
- update(id: string, data: Partial<BankAccountCreateInput>) {
535
- return c.mutate<BankAccountSummary>("bankAccount.update", { id, data });
536
- },
537
- delete(id: string) {
538
- return c.mutate<{ success: boolean }>("bankAccount.delete", { id });
539
- },
540
- transfer(input: BankTransferInput) {
541
- return c.mutate<BankTransferResult>("bankAccount.transfer", input);
542
- },
543
- listTransactions(input: BankTransactionListInput) {
544
- return c.query<PaginatedResult<BankTransactionRow>>("bankAccount.listTransactions", input);
545
- },
546
- summary() {
547
- return c.query<BankSummary>("bankAccount.summary");
548
- },
549
- getGatewayConfig(bankAccountId: string) {
550
- return c.query<GatewayConfig | null>("bankAccount.getGatewayConfig", { bankAccountId });
551
- },
552
- upsertGatewayConfig(input: UpsertGatewayConfigInput) {
553
- return c.mutate<GatewayConfig>("bankAccount.upsertGatewayConfig", input);
554
- },
555
- };
556
- }
557
-
558
- // ── Reports ───────────────────────────────────────────────────
559
-
560
- get reports() {
561
- const c = this;
562
- return {
563
- daybook(input: DaybookInput) {
564
- return c.query<DaybookResult>("reports.daybook", input);
565
- },
566
- outstanding(input: OutstandingInput) {
567
- return c.query<OutstandingResult>("reports.outstanding", input);
568
- },
569
- taxSummary(input: TaxSummaryInput) {
570
- return c.query<TaxSummaryResult>("reports.taxSummary", input);
571
- },
572
- itemSales(input: ItemSalesInput) {
573
- return c.query<ItemSalesResult>("reports.itemSales", input);
574
- },
575
- stockSummary(input: StockSummaryInput) {
576
- return c.query<StockSummaryResult>("reports.stockSummary", input);
577
- },
578
- partyStatement(input: PartyStatementInput) {
579
- return c.query<PartyStatementResult>("reports.partyStatement", input);
580
- },
581
- paymentSummary(input: PaymentSummaryInput) {
582
- return c.query<PaymentSummaryResult>("reports.paymentSummary", input);
583
- },
584
- salesRegister(input: { fromDate: string; toDate: string; partyId?: string }) {
585
- return c.query<any>("reports.salesRegister", input);
586
- },
587
- purchaseRegister(input: { fromDate: string; toDate: string; partyId?: string }) {
588
- return c.query<any>("reports.purchaseRegister", input);
589
- },
590
- cashFlowForecast(input?: Record<string, unknown>) {
591
- return c.query<any>("reports.cashFlowForecast", input ?? {});
592
- },
593
- collectionEfficiency(input: { fromDate: string; toDate: string }) {
594
- return c.query<any>("reports.collectionEfficiency", input);
595
- },
596
- trialBalance(input?: Record<string, unknown>) {
597
- return c.query<any>("reports.trialBalance", input ?? {});
598
- },
599
- balanceSheet(input?: Record<string, unknown>) {
600
- return c.query<any>("reports.balanceSheet", input ?? {});
601
- },
602
- profitAndLoss(input?: Record<string, unknown>) {
603
- return c.query<any>("reports.profitAndLoss", input ?? {});
604
- },
605
- cashFlowStatement(input?: Record<string, unknown>) {
606
- return c.query<any>("reports.cashFlowStatement", input ?? {});
607
- },
608
- generalLedger(input: { accountId: string; fromDate?: string; toDate?: string }) {
609
- return c.query<any>("reports.generalLedger", input);
610
- },
611
- comparativeTrialBalance(input?: Record<string, unknown>) {
612
- return c.query<any>("reports.comparativeTrialBalance", input ?? {});
613
- },
614
- comparativeBalanceSheet(input?: Record<string, unknown>) {
615
- return c.query<any>("reports.comparativeBalanceSheet", input ?? {});
616
- },
617
- comparativeProfitAndLoss(input?: Record<string, unknown>) {
618
- return c.query<any>("reports.comparativeProfitAndLoss", input ?? {});
619
- },
620
- tallyExport(input?: Record<string, unknown>) {
621
- return c.query<any>("reports.tallyExport", input ?? {});
622
- },
623
- };
624
- }
625
-
626
- // ── Store ─────────────────────────────────────────────────────
627
-
628
- get store() {
629
- const c = this;
630
- return {
631
- getSettings() {
632
- return c.query<StoreSettings>("store.getSettings");
633
- },
634
- updateSettings(input: StoreSettingsUpdateInput) {
635
- return c.mutate<StoreSettings>("store.updateSettings", input);
636
- },
637
- listOrders(input: StoreOrderListInput) {
638
- return c.query<PaginatedResult<StoreOrderSummary>>("store.listOrders", input);
639
- },
640
- getOrder(id: string) {
641
- return c.query<StoreOrderDetail | null>("store.getOrder", { id });
642
- },
643
- updateOrder(input: { orderId: string; status: "preparing" | "ready" | "delivered" }) {
644
- return c.mutate<{ success: boolean; status: string }>("store.updateOrderStatus", input);
645
- },
646
- confirmOrder(input: any) {
647
- return c.mutate<any>("store.confirmOrder", input);
648
- },
649
- cancelOrder(input: any) {
650
- return c.mutate<any>("store.cancelOrder", input);
651
- },
652
- checkSlug(input: any) {
653
- return c.query<any>("store.checkSlug", input);
654
- },
655
- listStoreItems(input: any) {
656
- return c.query<any>("store.listStoreItems", input);
657
- },
658
- bulkToggleItems(input: any) {
659
- return c.mutate<any>("store.bulkToggleItems", input);
660
- },
661
- };
662
- }
663
-
664
- // ── Target ────────────────────────────────────────────────────
665
-
666
- get target() {
667
- const c = this;
668
- return {
669
- list(input: TargetListInput) {
670
- return c.query<TargetRow[]>("target.list", input);
671
- },
672
- create(input: TargetCreateInput) {
673
- return c.mutate<TargetRow>("target.create", input);
674
- },
675
- getProgress(id: string) {
676
- return c.query<TargetWithProgress>("target.getProgress", { id });
677
- },
678
- update(input: TargetUpdateInput) {
679
- return c.mutate<TargetRow>("target.update", input);
680
- },
681
- delete(id: string) {
682
- return c.mutate<{ success: boolean }>("target.delete", { id });
683
- },
684
- myTargets() {
685
- return c.query<TargetWithProgress[]>("target.myTargets");
686
- },
687
- };
688
- }
689
-
690
- // ── Tenant ───────────────────────────────────────────────────
691
-
692
- get tenant() {
693
- const c = this;
694
- return {
695
- list() {
696
- return c.query<any>("tenant.list");
697
- },
698
- select(input: any) {
699
- return c.mutate<any>("tenant.select", input);
700
- },
701
- members() {
702
- return c.query<any>("tenant.members");
703
- },
704
- inviteMember(input: any) {
705
- return c.mutate<any>("tenant.inviteMember", input);
706
- },
707
- removeMember(input: any) {
708
- return c.mutate<any>("tenant.removeMember", input);
709
- },
710
- updateMemberRole(input: any) {
711
- return c.mutate<any>("tenant.updateMemberRole", input);
712
- },
713
- pendingInvitations() {
714
- return c.query<any>("tenant.pendingInvitations");
715
- },
716
- revokeInvitation(input: { invitationId: string }) {
717
- return c.mutate<any>("tenant.revokeInvitation", input);
718
- },
719
- };
720
- }
721
-
722
- // ── Document ──────────────────────────────────────────────────
723
-
724
- get document() {
725
- const c = this;
726
- return {
727
- convert(input: any) {
728
- return c.mutate<any>("document.convert", input);
729
- },
730
- };
731
- }
732
-
733
- // ── Quotation ─────────────────────────────────────────────────
734
-
735
- get quotation() {
736
- const c = this;
737
- return {
738
- list(input: any) {
739
- return c.query<any>("quotation.list", input);
740
- },
741
- getById(input: any) {
742
- return c.query<any>("quotation.getById", input);
743
- },
744
- create(input: any) {
745
- return c.mutate<any>("quotation.create", input);
746
- },
747
- updateStatus(input: any) {
748
- return c.mutate<any>("quotation.updateStatus", input);
749
- },
750
- delete(input: any) {
751
- return c.mutate<any>("quotation.delete", input);
752
- },
753
- };
754
- }
755
-
756
- // ── Credit Note ───────────────────────────────────────────────
757
-
758
- get creditNote() {
759
- const c = this;
760
- return {
761
- list(input: any) {
762
- return c.query<any>("creditNote.list", input);
763
- },
764
- getById(input: any) {
765
- return c.query<any>("creditNote.getById", input);
766
- },
767
- create(input: any) {
768
- return c.mutate<any>("creditNote.create", input);
769
- },
770
- updateStatus(input: any) {
771
- return c.mutate<any>("creditNote.updateStatus", input);
772
- },
773
- delete(input: any) {
774
- return c.mutate<any>("creditNote.delete", input);
775
- },
776
- };
777
- }
778
-
779
- // ── Debit Note ────────────────────────────────────────────────
780
-
781
- get debitNote() {
782
- const c = this;
783
- return {
784
- list(input: any) {
785
- return c.query<any>("debitNote.list", input);
786
- },
787
- getById(input: any) {
788
- return c.query<any>("debitNote.getById", input);
789
- },
790
- create(input: any) {
791
- return c.mutate<any>("debitNote.create", input);
792
- },
793
- updateStatus(input: any) {
794
- return c.mutate<any>("debitNote.updateStatus", input);
795
- },
796
- delete(input: any) {
797
- return c.mutate<any>("debitNote.delete", input);
798
- },
799
- };
800
- }
801
-
802
- // ── Delivery Challan ──────────────────────────────────────────
803
-
804
- get deliveryChallan() {
805
- const c = this;
806
- return {
807
- list(input: any) {
808
- return c.query<any>("deliveryChallan.list", input);
809
- },
810
- getById(input: any) {
811
- return c.query<any>("deliveryChallan.getById", input);
812
- },
813
- create(input: any) {
814
- return c.mutate<any>("deliveryChallan.create", input);
815
- },
816
- updateStatus(input: any) {
817
- return c.mutate<any>("deliveryChallan.updateStatus", input);
818
- },
819
- delete(input: any) {
820
- return c.mutate<any>("deliveryChallan.delete", input);
821
- },
822
- };
823
- }
824
-
825
- // ── Proforma ──────────────────────────────────────────────────
826
-
827
- get proforma() {
828
- const c = this;
829
- return {
830
- list(input: any) {
831
- return c.query<any>("proforma.list", input);
832
- },
833
- getById(input: any) {
834
- return c.query<any>("proforma.getById", input);
835
- },
836
- create(input: any) {
837
- return c.mutate<any>("proforma.create", input);
838
- },
839
- updateStatus(input: any) {
840
- return c.mutate<any>("proforma.updateStatus", input);
841
- },
842
- delete(input: any) {
843
- return c.mutate<any>("proforma.delete", input);
844
- },
845
- };
846
- }
847
-
848
- // ── Sales Return ──────────────────────────────────────────────
849
-
850
- get salesReturn() {
851
- const c = this;
852
- return {
853
- list(input: any) {
854
- return c.query<any>("salesReturn.list", input);
855
- },
856
- getById(input: any) {
857
- return c.query<any>("salesReturn.getById", input);
858
- },
859
- create(input: any) {
860
- return c.mutate<any>("salesReturn.create", input);
861
- },
862
- updateStatus(input: any) {
863
- return c.mutate<any>("salesReturn.updateStatus", input);
864
- },
865
- delete(input: any) {
866
- return c.mutate<any>("salesReturn.delete", input);
867
- },
868
- };
869
- }
870
-
871
- // ── Purchase Return ───────────────────────────────────────────
872
-
873
- get purchaseReturn() {
874
- const c = this;
875
- return {
876
- list(input: any) {
877
- return c.query<any>("purchaseReturn.list", input);
878
- },
879
- getById(input: any) {
880
- return c.query<any>("purchaseReturn.getById", input);
881
- },
882
- create(input: any) {
883
- return c.mutate<any>("purchaseReturn.create", input);
884
- },
885
- updateStatus(input: any) {
886
- return c.mutate<any>("purchaseReturn.updateStatus", input);
887
- },
888
- delete(input: any) {
889
- return c.mutate<any>("purchaseReturn.delete", input);
890
- },
891
- };
892
- }
893
-
894
- // ── Recurring Invoice ─────────────────────────────────────────
895
-
896
- get recurringInvoice() {
897
- const c = this;
898
- return {
899
- list(input: RecurringInvoiceListInput) {
900
- return c.query<PaginatedResult<RecurringInvoiceSummary>>("recurringInvoice.list", input);
901
- },
902
- getById(id: string) {
903
- return c.query<RecurringInvoiceDetail>("recurringInvoice.getById", { id });
904
- },
905
- create(input: RecurringInvoiceCreateInput) {
906
- return c.mutate<RecurringInvoiceDetail>("recurringInvoice.create", input);
907
- },
908
- update(id: string, data: Partial<RecurringInvoiceCreateInput>) {
909
- return c.mutate<RecurringInvoiceDetail>("recurringInvoice.update", { id, data });
910
- },
911
- delete(id: string) {
912
- return c.mutate<{ success: boolean }>("recurringInvoice.delete", { id });
913
- },
914
- pause(id: string) {
915
- return c.mutate<{ success: boolean }>("recurringInvoice.pause", { id });
916
- },
917
- resume(id: string) {
918
- return c.mutate<{ success: boolean }>("recurringInvoice.resume", { id });
919
- },
920
- runNow(id: string) {
921
- return c.mutate<{ success: boolean; invoiceId?: string }>("recurringInvoice.runNow", { id });
922
- },
923
- executionHistory(templateId: string, page?: number, limit?: number) {
924
- return c.query<PaginatedResult<RecurringInvoiceExecution>>("recurringInvoice.executionHistory", { templateId, page, limit });
925
- },
926
- planUsage() {
927
- return c.query<RecurringInvoicePlanUsage>("recurringInvoice.planUsage");
928
- },
929
- suggestions() {
930
- return c.query<RecurringInvoiceSuggestion[]>("recurringInvoice.suggestions");
931
- },
932
- };
933
- }
934
-
935
- // ── API Key ───────────────────────────────────────────────────
936
-
937
- get apiKey() {
938
- const c = this;
939
- return {
940
- list() {
941
- return c.query<any>("apiKey.list");
942
- },
943
- create(input: any) {
944
- return c.mutate<any>("apiKey.create", input);
945
- },
946
- revoke(input: any) {
947
- return c.mutate<any>("apiKey.revoke", input);
948
- },
949
- };
950
- }
951
-
952
- // ── Import ────────────────────────────────────────────────────
953
-
954
- get import() {
955
- const c = this;
956
- return {
957
- importParties(input: ImportPartiesInput) {
958
- return c.mutate<ImportResult>("import.importParties", input);
959
- },
960
- importItems(input: ImportItemsInput) {
961
- return c.mutate<ImportItemsResult>("import.importItems", input);
962
- },
963
- importInvoices(input: ImportInvoicesInput) {
964
- return c.mutate<ImportResult>("import.importInvoices", input);
965
- },
966
- importPayments(input: ImportPaymentsInput) {
967
- return c.mutate<ImportResult>("import.importPayments", input);
968
- },
969
- };
970
- }
971
-
972
- // ── Journal ───────────────────────────────────────────────────
973
-
974
- get journal() {
975
- const c = this;
976
- return {
977
- list(input?: Record<string, unknown>) {
978
- return c.query<any>("journal.list", input ?? {});
979
- },
980
- getById(id: string) {
981
- return c.query<any>("journal.getById", { id });
982
- },
983
- create(input: Record<string, unknown>) {
984
- return c.mutate<any>("journal.create", input);
985
- },
986
- update(input: Record<string, unknown>) {
987
- return c.mutate<any>("journal.update", input);
988
- },
989
- void(id: string) {
990
- return c.mutate<any>("journal.void", { id });
991
- },
992
- delete(id: string) {
993
- return c.mutate<any>("journal.delete", { id });
994
- },
995
- templateList() {
996
- return c.query<any>("journal.templateList");
997
- },
998
- templateCreate(input: Record<string, unknown>) {
999
- return c.mutate<any>("journal.templateCreate", input);
1000
- },
1001
- templateDelete(id: string) {
1002
- return c.mutate<any>("journal.templateDelete", { id });
1003
- },
1004
- createFromTemplate(input: Record<string, unknown>) {
1005
- return c.mutate<any>("journal.createFromTemplate", input);
1006
- },
1007
- };
1008
- }
1009
-
1010
- // ── ITC ───────────────────────────────────────────────────────
1011
-
1012
- get itc() {
1013
- const c = this;
1014
- return {
1015
- dashboard(input?: Record<string, unknown>) {
1016
- return c.query<any>("itc.dashboard", input ?? {});
1017
- },
1018
- ledger(input?: Record<string, unknown>) {
1019
- return c.query<any>("itc.ledger", input ?? {});
1020
- },
1021
- agingAlerts() {
1022
- return c.query<any>("itc.agingAlerts");
1023
- },
1024
- markBlocked(input: Record<string, unknown>) {
1025
- return c.mutate<any>("itc.markBlocked", input);
1026
- },
1027
- markEligible(input: Record<string, unknown>) {
1028
- return c.mutate<any>("itc.markEligible", input);
1029
- },
1030
- recordUtilization(input: Record<string, unknown>) {
1031
- return c.mutate<any>("itc.recordUtilization", input);
1032
- },
1033
- gstr3bTable4(input?: Record<string, unknown>) {
1034
- return c.query<any>("itc.gstr3bTable4", input ?? {});
1035
- },
1036
- };
1037
- }
1038
-
1039
- // ── Bank Recon ────────────────────────────────────────────────
1040
-
1041
- get bankRecon() {
1042
- const c = this;
1043
- return {
1044
- importList(input?: Record<string, unknown>) {
1045
- return c.query<any>("bankRecon.importList", input ?? {});
1046
- },
1047
- importDetail(importId: string) {
1048
- return c.query<any>("bankRecon.importDetail", { importId });
1049
- },
1050
- summary(importId: string) {
1051
- return c.query<any>("bankRecon.summary", { importId });
1052
- },
1053
- lines(input: Record<string, unknown>) {
1054
- return c.query<any>("bankRecon.lines", input);
1055
- },
1056
- ruleList() {
1057
- return c.query<any>("bankRecon.ruleList");
1058
- },
1059
- ruleCreate(input: Record<string, unknown>) {
1060
- return c.mutate<any>("bankRecon.ruleCreate", input);
1061
- },
1062
- ruleUpdate(input: Record<string, unknown>) {
1063
- return c.mutate<any>("bankRecon.ruleUpdate", input);
1064
- },
1065
- ruleDelete(id: string) {
1066
- return c.mutate<any>("bankRecon.ruleDelete", { id });
1067
- },
1068
- templateList() {
1069
- return c.query<any>("bankRecon.templateList");
1070
- },
1071
- confirmMatch(input: Record<string, unknown>) {
1072
- return c.mutate<any>("bankRecon.confirmMatch", input);
1073
- },
1074
- manualMatch(input: Record<string, unknown>) {
1075
- return c.mutate<any>("bankRecon.manualMatch", input);
1076
- },
1077
- unmatch(input: Record<string, unknown>) {
1078
- return c.mutate<any>("bankRecon.unmatch", input);
1079
- },
1080
- createExpense(input: Record<string, unknown>) {
1081
- return c.mutate<any>("bankRecon.createExpense", input);
1082
- },
1083
- ignoreLine(input: Record<string, unknown>) {
1084
- return c.mutate<any>("bankRecon.ignoreLine", input);
1085
- },
1086
- };
1087
- }
1088
-
1089
- // ── E-Invoice ─────────────────────────────────────────────────
1090
-
1091
- get eInvoice() {
1092
- const c = this;
1093
- return {
1094
- dashboard(input?: Record<string, unknown>) {
1095
- return c.query<any>("eInvoice.dashboard", input ?? {});
1096
- },
1097
- generate(input: Record<string, unknown>) {
1098
- return c.mutate<any>("eInvoice.generate", input);
1099
- },
1100
- cancel(input: Record<string, unknown>) {
1101
- return c.mutate<any>("eInvoice.cancel", input);
1102
- },
1103
- retryFailed(input: Record<string, unknown>) {
1104
- return c.mutate<any>("eInvoice.retryFailed", input);
1105
- },
1106
- bulkRetry(input?: Record<string, unknown>) {
1107
- return c.mutate<any>("eInvoice.bulkRetry", input ?? {});
1108
- },
1109
- getStatus(invoiceId: string) {
1110
- return c.query<any>("eInvoice.getStatus", { invoiceId });
1111
- },
1112
- };
1113
- }
1114
-
1115
- // ── E-Way Bill ────────────────────────────────────────────────
1116
-
1117
- get ewayBill() {
1118
- const c = this;
1119
- return {
1120
- dashboard(input?: Record<string, unknown>) {
1121
- return c.query<any>("ewayBill.dashboard", input ?? {});
1122
- },
1123
- generate(input: Record<string, unknown>) {
1124
- return c.mutate<any>("ewayBill.generate", input);
1125
- },
1126
- cancel(input: Record<string, unknown>) {
1127
- return c.mutate<any>("ewayBill.cancel", input);
1128
- },
1129
- updateVehicle(input: Record<string, unknown>) {
1130
- return c.mutate<any>("ewayBill.updateVehicle", input);
1131
- },
1132
- extend(input: Record<string, unknown>) {
1133
- return c.mutate<any>("ewayBill.extend", input);
1134
- },
1135
- getByInvoice(invoiceId: string) {
1136
- return c.query<any>("ewayBill.getByInvoice", { invoiceId });
1137
- },
1138
- expiringList(input?: Record<string, unknown>) {
1139
- return c.query<any>("ewayBill.expiringList", input ?? {});
1140
- },
1141
- };
1142
- }
1143
-
1144
- // ── GSTR-2B ───────────────────────────────────────────────────
1145
-
1146
- get gstr2b() {
1147
- const c = this;
1148
- return {
1149
- uploads(input?: Record<string, unknown>) {
1150
- return c.query<any>("gstr2b.uploads", input ?? {});
1151
- },
1152
- records(input: Record<string, unknown>) {
1153
- return c.query<any>("gstr2b.records", input);
1154
- },
1155
- summary(input: Record<string, unknown>) {
1156
- return c.query<any>("gstr2b.summary", input);
1157
- },
1158
- missingInBooks(input: Record<string, unknown>) {
1159
- return c.query<any>("gstr2b.missingInBooks", input);
1160
- },
1161
- missingIn2B(input: Record<string, unknown>) {
1162
- return c.query<any>("gstr2b.missingIn2B", input);
1163
- },
1164
- };
1165
- }
1166
-
1167
- // ── Account ───────────────────────────────────────────────────
1168
-
1169
- get account() {
1170
- const c = this;
1171
- return {
1172
- list(input?: Record<string, unknown>) {
1173
- return c.query<any>("account.list", input ?? {});
1174
- },
1175
- create(input: Record<string, unknown>) {
1176
- return c.mutate<any>("account.create", input);
1177
- },
1178
- update(input: Record<string, unknown>) {
1179
- return c.mutate<any>("account.update", input);
1180
- },
1181
- delete(id: string) {
1182
- return c.mutate<any>("account.delete", { id });
1183
- },
1184
- };
1185
- }
1186
- }
1187
-
1188
- // ── Type definitions ───────────────────────────────────────────────────────
1189
-
1190
- export interface PaginatedResult<T> {
1191
- data: T[];
1192
- total: number;
1193
- page: number;
1194
- limit: number;
1195
- }
1196
-
1197
- export interface AuthUser {
1198
- id: string;
1199
- email: string;
1200
- name: string;
1201
- role: string;
1202
- }
1203
-
1204
- export type InvoiceStatus =
1205
- | "draft" | "unfulfilled" | "sent" | "paid" | "partial" | "overdue" | "cancelled";
1206
-
1207
- export type DocumentType =
1208
- | "invoice" | "quotation" | "credit_note" | "debit_note"
1209
- | "delivery_challan" | "proforma" | "sales_return" | "purchase_return";
1210
-
1211
- export interface InvoiceSummary {
1212
- id: string;
1213
- invoiceNumber: string;
1214
- partyName: string;
1215
- partyId: string;
1216
- type: "sale" | "purchase";
1217
- documentType: DocumentType;
1218
- status: InvoiceStatus;
1219
- invoiceDate: string;
1220
- dueDate: string | null;
1221
- totalAmount: string;
1222
- amountPaid: string;
1223
- balanceDue: string;
1224
- }
1225
-
1226
- export interface LineItem {
1227
- id?: string;
1228
- itemId?: string | null;
1229
- description: string;
1230
- quantity: string;
1231
- unitPrice: string;
1232
- taxPercent: string;
1233
- discountPercent: string;
1234
- amount: string;
1235
- selectedUnit?: string | null;
1236
- variantId?: string | null;
1237
- }
1238
-
1239
- export interface InvoiceDetail extends InvoiceSummary {
1240
- notes: string | null;
1241
- termsAndConditions: string | null;
1242
- lineItems: LineItem[];
1243
- charges?: Array<{ label: string; amount: string }>;
1244
- invoiceDiscount: string;
1245
- roundOff: string;
1246
- deliveryMethod?: string | null;
1247
- createdByName?: string | null;
1248
- createdAt?: string;
1249
- }
1250
-
1251
- export interface InvoiceListInput {
1252
- type?: "sale" | "purchase" | null;
1253
- status?: InvoiceStatus | InvoiceStatus[] | null;
1254
- documentType?: DocumentType;
1255
- partyId?: string | null;
1256
- fromDate?: string | null;
1257
- toDate?: string | null;
1258
- itemId?: string | null;
1259
- search?: string | null;
1260
- sortBy?: "date" | "amount" | "number" | null;
1261
- sortDir?: "asc" | "desc" | null;
1262
- page?: number;
1263
- limit?: number;
1264
- }
1265
-
1266
- export interface InvoiceLineItemInput {
1267
- itemId?: string;
1268
- description: string;
1269
- quantity: string;
1270
- unitPrice: string;
1271
- taxPercent?: string;
1272
- discountPercent?: string;
1273
- selectedUnit?: string | null;
1274
- variantId?: string | null;
1275
- }
1276
-
1277
- export interface InvoiceCreateInput {
1278
- partyId: string;
1279
- type: "sale" | "purchase";
1280
- documentType?: DocumentType;
1281
- invoiceDate?: string;
1282
- dueDate?: string;
1283
- notes?: string;
1284
- termsAndConditions?: string;
1285
- additionalCharges?: string;
1286
- charges?: Array<{ label: string; amount: string }>;
1287
- invoiceDiscount?: string;
1288
- invoiceDiscountType?: "amount" | "percent";
1289
- roundOff?: string;
1290
- referenceDocumentId?: string;
1291
- deliveryMethod?: string;
1292
- lineItems: InvoiceLineItemInput[];
1293
- }
1294
-
1295
- export interface PartySummary {
1296
- id: string;
1297
- name: string;
1298
- type: "customer" | "supplier";
1299
- phone: string | null;
1300
- email: string | null;
1301
- gstin: string | null;
1302
- balance: string;
1303
- city: string | null;
1304
- category: string | null;
1305
- }
1306
-
1307
- export interface PartyDetail extends PartySummary {
1308
- billingAddress: string | null;
1309
- shippingAddress: string | null;
1310
- pan: string | null;
1311
- state: string | null;
1312
- creditPeriodDays: number | null;
1313
- creditLimit: string | null;
1314
- contactPersonName: string | null;
1315
- openingBalance: string;
1316
- }
1317
-
1318
- export interface PartyListInput {
1319
- type?: "customer" | "supplier" | null;
1320
- filter?: "all" | "customer" | "supplier" | "outstanding" | "overdue" | null;
1321
- search?: string | null;
1322
- category?: string | null;
1323
- sortBy?: "name" | "balance" | null;
1324
- sortDir?: "asc" | "desc" | null;
1325
- page?: number;
1326
- limit?: number;
1327
- }
1328
-
1329
- export interface PartyCreateInput {
1330
- type: "customer" | "supplier";
1331
- name: string;
1332
- phone?: string;
1333
- email?: string;
1334
- gstin?: string;
1335
- pan?: string;
1336
- billingAddress?: string;
1337
- shippingAddress?: string;
1338
- city?: string;
1339
- state?: string;
1340
- stateCode?: string;
1341
- pincode?: string;
1342
- openingBalance?: string;
1343
- category?: string;
1344
- creditPeriodDays?: number;
1345
- creditLimit?: string;
1346
- contactPersonName?: string;
1347
- }
1348
-
1349
- export interface LedgerEntry {
1350
- date: string;
1351
- description: string;
1352
- debit: string;
1353
- credit: string;
1354
- balance: string;
1355
- referenceType: string;
1356
- referenceId: string;
1357
- }
1358
-
1359
- export interface LedgerResult {
1360
- partyName: string;
1361
- partyType: string;
1362
- openingBalance: string;
1363
- closingBalance: string;
1364
- entries: LedgerEntry[];
1365
- }
1366
-
1367
- export interface LedgerInput {
1368
- fromDate?: string;
1369
- toDate?: string;
1370
- page?: number;
1371
- limit?: number;
1372
- }
1373
-
1374
- export interface ItemSummary {
1375
- id: string;
1376
- name: string;
1377
- sku: string | null;
1378
- unit: string;
1379
- salePrice: string | null;
1380
- purchasePrice: string | null;
1381
- taxPercent: string;
1382
- stockQuantity: string;
1383
- lowStockAlert: string | null;
1384
- category: string | null;
1385
- itemType: "product" | "service";
1386
- }
1387
-
1388
- export interface ItemDetail extends ItemSummary {
1389
- description: string | null;
1390
- hsn: string | null;
1391
- itemMode: "simple" | "alt_units" | "variants";
1392
- taxInclusive: boolean;
1393
- unitVariants?: Array<{
1394
- unit: string;
1395
- conversionFactor: number;
1396
- salePrice: string;
1397
- purchasePrice?: string;
1398
- }>;
1399
- variants?: Array<{
1400
- id: string;
1401
- attributeValues: Record<string, string>;
1402
- sku?: string;
1403
- salePrice?: string;
1404
- purchasePrice?: string;
1405
- stockQuantity: string;
1406
- }>;
1407
- }
1408
-
1409
- export interface ItemListInput {
1410
- search?: string | null;
1411
- category?: string | null;
1412
- itemType?: "product" | "service" | null;
1413
- lowStock?: boolean | null;
1414
- page?: number;
1415
- limit?: number;
1416
- }
1417
-
1418
- export interface ItemCreateInput {
1419
- name: string;
1420
- unit?: string;
1421
- salePrice?: string;
1422
- purchasePrice?: string;
1423
- taxPercent?: string;
1424
- stockQuantity?: string;
1425
- lowStockAlert?: string;
1426
- description?: string;
1427
- hsn?: string;
1428
- sku?: string;
1429
- itemType?: "product" | "service";
1430
- category?: string;
1431
- }
1432
-
1433
- export interface StockAdjustInput {
1434
- itemId: string;
1435
- adjustment: string;
1436
- reason?: string;
1437
- }
1438
-
1439
- export interface PaymentSummary {
1440
- id: string;
1441
- paymentNumber: string;
1442
- amount: string;
1443
- discount: string;
1444
- mode: string;
1445
- paymentDate: string;
1446
- referenceNumber: string | null;
1447
- notes: string | null;
1448
- partyName: string;
1449
- partyId: string;
1450
- invoiceId: string | null;
1451
- }
1452
-
1453
- export interface PaymentDetail extends PaymentSummary {
1454
- bankAccountId: string | null;
1455
- linkedInvoices: Array<{
1456
- invoiceId: string;
1457
- invoiceNumber: string;
1458
- invoiceDate: string;
1459
- totalAmount: string;
1460
- amountPaid: string;
1461
- status: string;
1462
- amount: string;
1463
- }>;
1464
- }
1465
-
1466
- export interface PaymentListInput {
1467
- partyId?: string | null;
1468
- invoiceId?: string | null;
1469
- fromDate?: string | null;
1470
- toDate?: string | null;
1471
- search?: string | null;
1472
- page?: number;
1473
- limit?: number;
1474
- }
1475
-
1476
- export interface PaymentCreateInput {
1477
- partyId: string;
1478
- amount: string;
1479
- mode: "cash" | "bank" | "upi" | "cheque" | "other";
1480
- invoiceId?: string;
1481
- discount?: string;
1482
- referenceNumber?: string;
1483
- paymentDate?: string;
1484
- notes?: string;
1485
- bankAccountId?: string;
1486
- allocations?: Array<{ invoiceId: string; amount: string }>;
1487
- }
1488
-
1489
- export interface PaymentUpdateInput {
1490
- id: string;
1491
- amount?: string;
1492
- mode?: "cash" | "bank" | "upi" | "cheque" | "other";
1493
- discount?: string;
1494
- referenceNumber?: string | null;
1495
- paymentDate?: string;
1496
- notes?: string | null;
1497
- bankAccountId?: string | null;
1498
- allocations?: Array<{ invoiceId: string; amount: string }>;
1499
- }
1500
-
1501
- export interface ExpenseSummary {
1502
- id: string;
1503
- category: string;
1504
- description: string | null;
1505
- amount: string;
1506
- mode: string;
1507
- expenseDate: string;
1508
- referenceNumber: string | null;
1509
- }
1510
-
1511
- export interface ExpenseListInput {
1512
- category?: string | null;
1513
- fromDate?: string | null;
1514
- toDate?: string | null;
1515
- search?: string | null;
1516
- page?: number;
1517
- limit?: number;
1518
- }
1519
-
1520
- export interface ExpenseCreateInput {
1521
- category: string;
1522
- amount: string;
1523
- mode: "cash" | "bank" | "upi" | "cheque" | "other";
1524
- description?: string;
1525
- expenseDate?: string;
1526
- referenceNumber?: string;
1527
- }
1528
-
1529
- export interface DashboardInput {
1530
- fromDate?: string;
1531
- toDate?: string;
1532
- }
1533
-
1534
- export interface DashboardSummary {
1535
- totalSales: string;
1536
- totalPurchases: string;
1537
- totalExpenses: string;
1538
- receivable: string;
1539
- payable: string;
1540
- cashInHand: string;
1541
- recentInvoices: Array<{
1542
- id: string;
1543
- invoiceNumber: string;
1544
- partyName: string;
1545
- totalAmount: string;
1546
- status: string;
1547
- invoiceDate: string;
1548
- }>;
1549
- }
1550
-
1551
- export interface BusinessSummary {
1552
- id: string;
1553
- name: string;
1554
- legalName: string | null;
1555
- gstin: string | null;
1556
- gstRegistrationType: string;
1557
- }
1558
-
1559
- export interface BusinessDetail extends BusinessSummary {
1560
- pan: string;
1561
- phone: string;
1562
- email: string | null;
1563
- address: string;
1564
- city: string | null;
1565
- state: string | null;
1566
- stateCode: string | null;
1567
- pincode: string | null;
1568
- invoicePrefix: string;
1569
- currency: string;
1570
- financialYearStart: number;
1571
- }
1572
-
1573
- export interface GstReportInput {
1574
- month: number;
1575
- year: number;
1576
- }
1577
-
1578
- export interface GstReportResult {
1579
- period: string;
1580
- b2b?: unknown;
1581
- b2c?: unknown;
1582
- summary?: unknown;
1583
- [key: string]: unknown;
1584
- }
1585
-
1586
- export type ShipmentStatus = "pending" | "shipped" | "in_transit" | "delivered" | "returned";
1587
-
1588
- export interface ShipmentSummary {
1589
- id: string;
1590
- invoiceId: string | null;
1591
- partyId: string | null;
1592
- carrier: string | null;
1593
- mode: string | null;
1594
- trackingNumber: string | null;
1595
- trackingUrl: string | null;
1596
- cost: string;
1597
- weight: string | null;
1598
- status: ShipmentStatus;
1599
- shipmentDate: string | null;
1600
- estimatedDelivery: string | null;
1601
- actualDelivery: string | null;
1602
- notes: string | null;
1603
- createdAt: string;
1604
- invoiceNumber: string | null;
1605
- partyName: string | null;
1606
- }
1607
-
1608
- export interface ShipmentDetail extends ShipmentSummary {
1609
- businessId: string;
1610
- shippingAddress: string | null;
1611
- shippingCity: string | null;
1612
- shippingPincode: string | null;
1613
- updatedAt: string;
1614
- }
1615
-
1616
- export interface ShipmentListInput {
1617
- status?: ShipmentStatus | null;
1618
- invoiceId?: string | null;
1619
- partyId?: string | null;
1620
- page?: number;
1621
- limit?: number;
1622
- }
1623
-
1624
- export interface ShipmentCreateInput {
1625
- invoiceId?: string;
1626
- partyId?: string;
1627
- carrier?: string;
1628
- mode?: string;
1629
- trackingNumber?: string;
1630
- trackingUrl?: string;
1631
- cost?: string;
1632
- weight?: string;
1633
- shippingAddress?: string;
1634
- shippingCity?: string;
1635
- shippingPincode?: string;
1636
- status?: ShipmentStatus;
1637
- shipmentDate?: string;
1638
- estimatedDelivery?: string;
1639
- notes?: string;
1640
- }
1641
-
1642
- export interface ShipmentUpdateInput {
1643
- id: string;
1644
- carrier?: string;
1645
- mode?: string;
1646
- trackingNumber?: string;
1647
- trackingUrl?: string;
1648
- cost?: string;
1649
- weight?: string;
1650
- status?: ShipmentStatus;
1651
- shipmentDate?: string;
1652
- estimatedDelivery?: string;
1653
- actualDelivery?: string;
1654
- notes?: string;
1655
- }
1656
-
1657
- export type BankAccountType = "savings" | "current" | "cash" | "credit" | "other" | "payment_gateway";
1658
-
1659
- export interface GatewayChargeRate {
1660
- type: "percentage" | "flat";
1661
- value: string;
1662
- }
1663
-
1664
- export interface GatewayChargeConfig {
1665
- credit_card?: GatewayChargeRate;
1666
- debit_card?: GatewayChargeRate;
1667
- upi?: GatewayChargeRate;
1668
- net_banking?: GatewayChargeRate;
1669
- wallet?: GatewayChargeRate;
1670
- default?: GatewayChargeRate;
1671
- }
1672
-
1673
- export interface GatewayConfig {
1674
- id: string;
1675
- businessId: string;
1676
- bankAccountId: string;
1677
- settlementAccountId: string;
1678
- chargeConfig: GatewayChargeConfig;
1679
- expenseCategory: string;
1680
- autoSettle: boolean;
1681
- isActive: boolean;
1682
- createdAt: string;
1683
- updatedAt: string;
1684
- }
1685
-
1686
- export interface UpsertGatewayConfigInput {
1687
- bankAccountId: string;
1688
- settlementAccountId: string;
1689
- chargeConfig: GatewayChargeConfig;
1690
- expenseCategory?: string;
1691
- autoSettle?: boolean;
1692
- }
1693
-
1694
- export interface BankAccountSummary {
1695
- id: string;
1696
- accountName: string;
1697
- accountNumber: string | null;
1698
- ifsc: string | null;
1699
- bankName: string | null;
1700
- accountType: BankAccountType;
1701
- openingBalance: string;
1702
- currentBalance: string;
1703
- isDefault: boolean;
1704
- createdAt: string;
1705
- }
1706
-
1707
- export interface BankAccountDetail extends BankAccountSummary {
1708
- recentTransactions: BankTransactionRow[];
1709
- }
1710
-
1711
- export interface BankTransactionRow {
1712
- id: string;
1713
- businessId: string;
1714
- bankAccountId: string;
1715
- type: "deposit" | "withdrawal" | "transfer";
1716
- amount: string;
1717
- description: string | null;
1718
- referenceType: string | null;
1719
- referenceId: string | null;
1720
- transactionDate: string;
1721
- createdAt: string;
1722
- balanceAfter: string;
1723
- }
1724
-
1725
- export interface BankAccountCreateInput {
1726
- accountName: string;
1727
- accountNumber?: string;
1728
- ifsc?: string;
1729
- bankName?: string;
1730
- accountType: BankAccountType;
1731
- openingBalance?: string;
1732
- isDefault?: boolean;
1733
- }
1734
-
1735
- export interface BankTransferInput {
1736
- fromAccountId: string;
1737
- toAccountId: string;
1738
- amount: string;
1739
- description?: string;
1740
- transactionDate?: string;
1741
- }
1742
-
1743
- export interface BankTransferResult {
1744
- withdrawal: BankTransactionRow;
1745
- deposit: BankTransactionRow;
1746
- }
1747
-
1748
- export interface BankTransactionListInput {
1749
- bankAccountId: string;
1750
- fromDate?: string;
1751
- toDate?: string;
1752
- type?: "deposit" | "withdrawal" | "transfer";
1753
- page?: number;
1754
- limit?: number;
1755
- }
1756
-
1757
- export interface BankSummary {
1758
- totalBalance: string;
1759
- cashInHand: string;
1760
- bankBalance: string;
1761
- accountCount: number;
1762
- }
1763
-
1764
- export interface DaybookInput {
1765
- fromDate: string;
1766
- toDate: string;
1767
- typeFilter?: "all" | "invoices" | "payments" | "expenses";
1768
- }
1769
-
1770
- export interface DaybookEntry {
1771
- id: string;
1772
- time: string;
1773
- entryType: "invoice" | "payment" | "expense";
1774
- number: string | null;
1775
- partyOrCategory: string;
1776
- debit: string;
1777
- credit: string;
1778
- mode: string | null;
1779
- status: string | null;
1780
- meta: Record<string, string | null>;
1781
- }
1782
-
1783
- export interface DaybookResult {
1784
- entries: DaybookEntry[];
1785
- summary: {
1786
- totalSalesInvoiced: string;
1787
- totalPurchaseInvoiced: string;
1788
- totalPaymentsReceived: string;
1789
- totalPaymentsMade: string;
1790
- totalExpenses: string;
1791
- netCashMovement: string;
1792
- };
1793
- }
1794
-
1795
- export interface OutstandingInput {
1796
- type?: "receivable" | "payable" | "both";
1797
- asOfDate?: string;
1798
- }
1799
-
1800
- export interface OutstandingResult {
1801
- receivables: unknown | null;
1802
- payables: unknown | null;
1803
- }
1804
-
1805
- export interface TaxSummaryInput {
1806
- fromDate: string;
1807
- toDate: string;
1808
- type?: "sales" | "purchases" | "both";
1809
- }
1810
-
1811
- export interface TaxSummaryResult {
1812
- rows: unknown[];
1813
- summary: unknown;
1814
- }
1815
-
1816
- export interface ItemSalesInput {
1817
- fromDate: string;
1818
- toDate: string;
1819
- category?: string;
1820
- itemType?: "product" | "service";
1821
- sortBy?: "revenue" | "quantity" | "invoices" | "margin";
1822
- compareToPrevious?: boolean;
1823
- }
1824
-
1825
- export interface ItemSalesResult {
1826
- rows: unknown[];
1827
- summary: unknown;
1828
- [key: string]: unknown;
1829
- }
1830
-
1831
- export interface StockSummaryInput {
1832
- category?: string;
1833
- showZeroStock?: boolean;
1834
- }
1835
-
1836
- export interface StockSummaryResult {
1837
- rows: unknown[];
1838
- summary: unknown;
1839
- [key: string]: unknown;
1840
- }
1841
-
1842
- export interface PartyStatementInput {
1843
- partyId: string;
1844
- fromDate?: string;
1845
- toDate?: string;
1846
- }
1847
-
1848
- export interface PartyStatementResult {
1849
- [key: string]: unknown;
1850
- }
1851
-
1852
- export interface PaymentSummaryInput {
1853
- fromDate: string;
1854
- toDate: string;
1855
- type?: "received" | "made" | "both";
1856
- bankAccountId?: string;
1857
- }
1858
-
1859
- export interface PaymentSummaryResult {
1860
- [key: string]: unknown;
1861
- }
1862
-
1863
- export interface StoreSettings {
1864
- storeEnabled: boolean;
1865
- storeSlug: string | null;
1866
- storeName: string | null;
1867
- storeDescription: string | null;
1868
- [key: string]: unknown;
1869
- }
1870
-
1871
- export interface StoreSettingsUpdateInput {
1872
- storeEnabled?: boolean;
1873
- storeSlug?: string;
1874
- storeName?: string;
1875
- storeDescription?: string;
1876
- [key: string]: unknown;
1877
- }
1878
-
1879
- export interface StoreOrderSummary {
1880
- id: string;
1881
- orderNumber: string;
1882
- customerName: string;
1883
- totalAmount: string;
1884
- status: string;
1885
- createdAt: string;
1886
- }
1887
-
1888
- export interface StoreOrderDetail extends StoreOrderSummary {
1889
- items: Array<{ name: string; quantity: number; price: string }>;
1890
- shippingAddress: string | null;
1891
- notes: string | null;
1892
- }
1893
-
1894
- export interface StoreOrderListInput {
1895
- status?: string | null;
1896
- page?: number;
1897
- limit?: number;
1898
- }
1899
-
1900
- export type TargetType = "order_count" | "order_value" | "item_quantity";
1901
- export type TargetPeriod = "daily" | "weekly" | "monthly" | "quarterly" | "custom";
1902
-
1903
- export interface TargetRow {
1904
- id: string;
1905
- type: TargetType;
1906
- period: TargetPeriod;
1907
- targetValue: string;
1908
- startDate: string;
1909
- endDate: string | null;
1910
- assignedToId: string | null;
1911
- itemId: string | null;
1912
- notes: string | null;
1913
- }
1914
-
1915
- export interface TargetWithProgress extends TargetRow {
1916
- currentValue: string;
1917
- percentComplete: number;
1918
- }
1919
-
1920
- export interface TargetListInput {
1921
- type?: TargetType | null;
1922
- period?: TargetPeriod | null;
1923
- page?: number;
1924
- limit?: number;
1925
- }
1926
-
1927
- export interface TargetCreateInput {
1928
- type: TargetType;
1929
- period: TargetPeriod;
1930
- targetValue: string;
1931
- startDate: string;
1932
- endDate?: string;
1933
- assignedToId?: string;
1934
- itemId?: string;
1935
- notes?: string;
1936
- }
1937
-
1938
- export interface TargetUpdateInput {
1939
- id: string;
1940
- targetValue?: string;
1941
- endDate?: string;
1942
- notes?: string;
1943
- }
1944
-
1945
- export interface ImportPartiesInput {
1946
- parties: Array<Record<string, unknown>>;
1947
- }
1948
-
1949
- export interface ImportItemsInput {
1950
- items: Array<Record<string, unknown>>;
1951
- }
1952
-
1953
- export interface ImportInvoicesInput {
1954
- invoices: Array<Record<string, unknown>>;
1955
- }
1956
-
1957
- export interface ImportPaymentsInput {
1958
- payments: Array<Record<string, unknown>>;
1959
- }
1960
-
1961
- export interface ImportResult {
1962
- imported: number;
1963
- skipped: number;
1964
- errors: Array<{ row: number; message: string }>;
1965
- }
1966
-
1967
- export interface ImportItemsResult extends ImportResult {
1968
- created: number;
1969
- }
1970
-
1971
- // ── Recurring Invoice types ───────────────────────────────────────────────
1972
-
1973
- export type RecurringInvoiceStatus = "active" | "paused" | "completed" | "expired";
1974
- export type RecurringInvoiceFrequency = "weekly" | "biweekly" | "monthly" | "quarterly" | "half_yearly" | "yearly" | "custom";
1975
-
1976
- export interface RecurringInvoiceSummary {
1977
- id: string;
1978
- name: string;
1979
- partyName: string;
1980
- type: "sale" | "purchase";
1981
- frequency: RecurringInvoiceFrequency;
1982
- status: RecurringInvoiceStatus;
1983
- nextRunDate: string | null;
1984
- lastRunDate: string | null;
1985
- totalRuns: number;
1986
- maxRuns: number | null;
1987
- startDate: string;
1988
- endDate: string | null;
1989
- createdAt: string;
1990
- }
1991
-
1992
- export interface RecurringInvoiceLineItem {
1993
- description: string;
1994
- quantity: string;
1995
- unitPrice: string;
1996
- taxPercent?: string;
1997
- discountPercent?: string;
1998
- }
1999
-
2000
- export interface RecurringInvoiceDetail extends RecurringInvoiceSummary {
2001
- partyId: string;
2002
- customIntervalDays: number | null;
2003
- lineItems: RecurringInvoiceLineItem[];
2004
- notes: string | null;
2005
- }
2006
-
2007
- export interface RecurringInvoiceListInput {
2008
- status?: RecurringInvoiceStatus;
2009
- page?: number;
2010
- limit?: number;
2011
- }
2012
-
2013
- export interface RecurringInvoiceCreateInput {
2014
- partyId: string;
2015
- name: string;
2016
- type: "sale" | "purchase";
2017
- frequency: RecurringInvoiceFrequency;
2018
- customIntervalDays?: number;
2019
- lineItems: Array<{
2020
- description: string;
2021
- quantity: string;
2022
- unitPrice: string;
2023
- taxPercent?: string;
2024
- discountPercent?: string;
2025
- }>;
2026
- startDate: string;
2027
- endDate?: string;
2028
- maxRuns?: number;
2029
- notes?: string;
2030
- }
2031
-
2032
- export interface RecurringInvoiceExecution {
2033
- id: string;
2034
- invoiceNumber: string;
2035
- status: string;
2036
- errorMessage: string | null;
2037
- executedAt: string;
2038
- }
2039
-
2040
- export interface RecurringInvoicePlanUsage {
2041
- runsThisMonth: number;
2042
- totalTemplates: number;
2043
- }
2044
-
2045
- export interface RecurringInvoiceSuggestion {
2046
- partyId: string;
2047
- partyName: string;
2048
- frequency: string;
2049
- confidence: number;
2050
- reason: string;
2051
- }