@spaceinvoices/js-sdk 2.0.0

package/README.md

@@ -0,0 +1,109 @@
+# @spaceinvoices/js-sdk
+
+Official JavaScript/TypeScript SDK for the Space Invoices API.
+
+## Installation
+
+```bash
+npm install @spaceinvoices/js-sdk
+# or
+bun add @spaceinvoices/js-sdk
+```
+
+## Usage
+
+### Full SDK (Recommended)
+
+```typescript
+import SpaceInvoices from '@spaceinvoices/js-sdk';
+
+const sdk = new SpaceInvoices({ accessToken: 'your-api-key' });
+
+// List invoices
+const invoices = await sdk.invoices.list();
+
+// Create an invoice
+const invoice = await sdk.invoices.create({
+  entityId: 'entity_123',
+  body: {
+    date: '2024-01-15',
+    items: [{ name: 'Service', price: 100 }]
+  }
+});
+```
+
+### Tree-Shakeable Import (Smaller Bundles)
+
+```typescript
+import { initSDK, invoices, customers } from '@spaceinvoices/js-sdk';
+
+// Initialize once at app startup
+initSDK({ accessToken: 'your-api-key' });
+
+// Use individual modules anywhere
+const result = await invoices.list();
+```
+
+### Configuration Options
+
+```typescript
+const sdk = new SpaceInvoices({
+  accessToken: 'your-api-key',
+  // Optional: custom API base URL
+  basePath: 'https://eu.spaceinvoices.com',
+  // Optional: callback for 401 responses
+  onUnauthorized: (response) => {
+    console.log('Token expired, refreshing...');
+  }
+});
+```
+
+### Dynamic Token
+
+```typescript
+const sdk = new SpaceInvoices({
+  accessToken: async () => {
+    // Fetch token from your auth system
+    return await getAccessToken();
+  }
+});
+```
+
+## Features
+
+- **Full TypeScript Support** - Complete type definitions for all API methods
+- **Tree-Shakeable** - Import only what you need for smaller bundles
+- **ESM & CJS** - Works in Node.js, browsers, and modern bundlers
+- **Zod Schemas** - Optional Zod schemas for form validation
+
+## Zod Schemas
+
+For form validation, import Zod schemas:
+
+```typescript
+import { zod } from '@spaceinvoices/js-sdk';
+
+const result = zod.invoices.createInvoiceBodySchema.safeParse(formData);
+if (!result.success) {
+  console.log(result.error.issues);
+}
+```
+
+## Documentation
+
+- [API Documentation](https://docs.spaceinvoices.com)
+- [API Reference](https://eu.spaceinvoices.com/explorer)
+
+## Development
+
+```bash
+# Generate SDK (requires API running at localhost:3000)
+bun run generate
+
+# Build for distribution
+bun run build
+```
+
+## License
+
+MIT

package/dist/compat.d.cts

@@ -0,0 +1,54 @@
+/**
+ * Compatibility layer for SDK type aliases.
+ *
+ * This file provides backward-compatible type aliases for code migrating
+ * from the old SDK to the new Orval-generated SDK.
+ *
+ * OLD SDK -> NEW SDK type mappings:
+ * - Create*Request -> Create*Body
+ * - Patch*Request -> Patch*Body
+ * - Get*Response -> Get*200
+ * - Activity -> GetActivities200DataItem
+ * - entity_id in params -> SDKMethodOptions
+ * - Response with .status/.data -> auto-unwrapped data
+ */
+import type { PaginationMetadata } from "./generated/model";
+export type { GetActivities200DataItem as Activity, GetAdvanceInvoiceById200 as AdvanceInvoiceWithItems, GetCreditNoteById200 as CreditNoteWithItems, GetEstimateById200 as EstimateWithItems, GetInvoiceById200 as InvoiceWithItems, } from "./generated/model";
+export type { CreateAdvanceInvoiceBody as CreateAdvanceInvoiceRequest, CreateCreditNoteBody as CreateCreditNoteRequest, CreateCustomerBody as CreateCustomerRequest, CreateEntityBody as CreateEntityRequest, CreateEstimateBody as CreateEstimateRequest, CreateInvoiceBody as CreateInvoiceRequest, CreateItemBody as CreateItemRequest, CreatePaymentBody as CreatePaymentRequest, CreateTaxBody as CreateTaxRequest, } from "./generated/model";
+export type { PatchEntityBody as PatchEntityRequest } from "./generated/model";
+export type { GetActivities200 as GetActivitiesResponse, GetAdvanceInvoices200 as GetAdvanceInvoicesResponse, GetCreditNotes200 as GetCreditNotesResponse, GetCustomers200 as GetCustomersResponse, GetCustomers200 as GetCustomers200Response, GetEntities200 as GetEntitiesResponse, GetEstimates200 as GetEstimatesResponse, GetEstimates200 as GetEstimates200Response, GetFursSettings200 as GetFursSettingsResponse, GetFursSettings200 as GetFursSettings200Response, GetInvoices200 as GetInvoicesResponse, GetItems200 as GetItemsResponse, GetItems200 as GetItems200Response, GetPayments200 as GetPaymentsResponse, GetTaxes200 as GetTaxesResponse, GetTaxes200 as GetTaxes200Response, } from "./generated/model";
+/**
+ * Generic paginated response type for backward compatibility.
+ * The new SDK returns specific types like GetTaxes200, GetCustomers200, etc.
+ * This generic type can be used when the specific response type is not important.
+ */
+export interface PaginatedResponse<T> {
+    data: T[];
+    pagination: PaginationMetadata;
+}
+/**
+ * Configuration class for backward compatibility with old SDK patterns.
+ *
+ * OLD USAGE:
+ * ```ts
+ * const api = new PublicLinksApi(new Configuration({ basePath: '...' }));
+ * ```
+ *
+ * NEW USAGE:
+ * ```ts
+ * const sdk = new SpaceInvoices({ accessToken: '...', basePath: '...' });
+ * sdk.publicLinks.getPublicDocument({ shareableId });
+ * ```
+ *
+ * Note: This class is provided for compatibility but the new SDK uses a
+ * different architecture. You should migrate to the new SpaceInvoices class.
+ */
+export declare class Configuration {
+    basePath?: string;
+    accessToken?: string;
+    constructor(config?: {
+        basePath?: string;
+        accessToken?: string;
+    });
+}
+//# sourceMappingURL=compat.d.ts.map

package/dist/compat.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Compatibility layer for SDK type aliases.
+ *
+ * This file provides backward-compatible type aliases for code migrating
+ * from the old SDK to the new Orval-generated SDK.
+ *
+ * OLD SDK -> NEW SDK type mappings:
+ * - Create*Request -> Create*Body
+ * - Patch*Request -> Patch*Body
+ * - Get*Response -> Get*200
+ * - Activity -> GetActivities200DataItem
+ * - entity_id in params -> SDKMethodOptions
+ * - Response with .status/.data -> auto-unwrapped data
+ */
+import type { PaginationMetadata } from "./generated/model";
+export type { GetActivities200DataItem as Activity, GetAdvanceInvoiceById200 as AdvanceInvoiceWithItems, GetCreditNoteById200 as CreditNoteWithItems, GetEstimateById200 as EstimateWithItems, GetInvoiceById200 as InvoiceWithItems, } from "./generated/model";
+export type { CreateAdvanceInvoiceBody as CreateAdvanceInvoiceRequest, CreateCreditNoteBody as CreateCreditNoteRequest, CreateCustomerBody as CreateCustomerRequest, CreateEntityBody as CreateEntityRequest, CreateEstimateBody as CreateEstimateRequest, CreateInvoiceBody as CreateInvoiceRequest, CreateItemBody as CreateItemRequest, CreatePaymentBody as CreatePaymentRequest, CreateTaxBody as CreateTaxRequest, } from "./generated/model";
+export type { PatchEntityBody as PatchEntityRequest } from "./generated/model";
+export type { GetActivities200 as GetActivitiesResponse, GetAdvanceInvoices200 as GetAdvanceInvoicesResponse, GetCreditNotes200 as GetCreditNotesResponse, GetCustomers200 as GetCustomersResponse, GetCustomers200 as GetCustomers200Response, GetEntities200 as GetEntitiesResponse, GetEstimates200 as GetEstimatesResponse, GetEstimates200 as GetEstimates200Response, GetFursSettings200 as GetFursSettingsResponse, GetFursSettings200 as GetFursSettings200Response, GetInvoices200 as GetInvoicesResponse, GetItems200 as GetItemsResponse, GetItems200 as GetItems200Response, GetPayments200 as GetPaymentsResponse, GetTaxes200 as GetTaxesResponse, GetTaxes200 as GetTaxes200Response, } from "./generated/model";
+/**
+ * Generic paginated response type for backward compatibility.
+ * The new SDK returns specific types like GetTaxes200, GetCustomers200, etc.
+ * This generic type can be used when the specific response type is not important.
+ */
+export interface PaginatedResponse<T> {
+    data: T[];
+    pagination: PaginationMetadata;
+}
+/**
+ * Configuration class for backward compatibility with old SDK patterns.
+ *
+ * OLD USAGE:
+ * ```ts
+ * const api = new PublicLinksApi(new Configuration({ basePath: '...' }));
+ * ```
+ *
+ * NEW USAGE:
+ * ```ts
+ * const sdk = new SpaceInvoices({ accessToken: '...', basePath: '...' });
+ * sdk.publicLinks.getPublicDocument({ shareableId });
+ * ```
+ *
+ * Note: This class is provided for compatibility but the new SDK uses a
+ * different architecture. You should migrate to the new SpaceInvoices class.
+ */
+export declare class Configuration {
+    basePath?: string;
+    accessToken?: string;
+    constructor(config?: {
+        basePath?: string;
+        accessToken?: string;
+    });
+}
+//# sourceMappingURL=compat.d.ts.map

package/dist/compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat.d.ts","sourceRoot":"","sources":["../src/compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAU5D,YAAY,EACV,wBAAwB,IAAI,QAAQ,EACpC,wBAAwB,IAAI,uBAAuB,EACnD,oBAAoB,IAAI,mBAAmB,EAC3C,kBAAkB,IAAI,iBAAiB,EACvC,iBAAiB,IAAI,gBAAgB,GACtC,MAAM,mBAAmB,CAAC;AAM3B,YAAY,EACV,wBAAwB,IAAI,2BAA2B,EACvD,oBAAoB,IAAI,uBAAuB,EAC/C,kBAAkB,IAAI,qBAAqB,EAC3C,gBAAgB,IAAI,mBAAmB,EACvC,kBAAkB,IAAI,qBAAqB,EAC3C,iBAAiB,IAAI,oBAAoB,EACzC,cAAc,IAAI,iBAAiB,EACnC,iBAAiB,IAAI,oBAAoB,EACzC,aAAa,IAAI,gBAAgB,GAClC,MAAM,mBAAmB,CAAC;AAM3B,YAAY,EAAE,eAAe,IAAI,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAM/E,YAAY,EACV,gBAAgB,IAAI,qBAAqB,EACzC,qBAAqB,IAAI,0BAA0B,EACnD,iBAAiB,IAAI,sBAAsB,EAC3C,eAAe,IAAI,oBAAoB,EACvC,eAAe,IAAI,uBAAuB,EAC1C,cAAc,IAAI,mBAAmB,EACrC,eAAe,IAAI,oBAAoB,EACvC,eAAe,IAAI,uBAAuB,EAC1C,kBAAkB,IAAI,uBAAuB,EAC7C,kBAAkB,IAAI,0BAA0B,EAChD,cAAc,IAAI,mBAAmB,EACrC,WAAW,IAAI,gBAAgB,EAC/B,WAAW,IAAI,mBAAmB,EAClC,cAAc,IAAI,mBAAmB,EACrC,WAAW,IAAI,gBAAgB,EAC/B,WAAW,IAAI,mBAAmB,GACnC,MAAM,mBAAmB,CAAC;AAM3B;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;gBAET,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;CAIjE"}

package/dist/generated/activities/activities.d.cts

@@ -0,0 +1,46 @@
+/**
+ * Generated by orval v8.2.0 🍺
+ * Do not edit manually.
+ * Space Invoices API
+ * REST API for invoice management, customer management, and accounting operations. Features include cursor-based pagination for efficient data navigation, flexible JSON querying with MongoDB-style operators, full-text search across multiple fields, and comprehensive metadata support for custom tracking.
+ * OpenAPI spec version: 1.0.0
+ */
+import type { Error, GetActivities200, GetActivitiesParams } from '.././model';
+/**
+ * Retrieve a paginated list of activities for the entity. Supports filtering by resource_type, resource_id, and action. Activities are ordered by created_at descending by default.
+ * @summary List activities
+ */
+export type getActivitiesResponse200 = {
+    data: GetActivities200;
+    status: 200;
+};
+export type getActivitiesResponse400 = {
+    data: Error;
+    status: 400;
+};
+export type getActivitiesResponse401 = {
+    data: Error;
+    status: 401;
+};
+export type getActivitiesResponse403 = {
+    data: Error;
+    status: 403;
+};
+export type getActivitiesResponse404 = {
+    data: Error;
+    status: 404;
+};
+export type getActivitiesResponse500 = {
+    data: Error;
+    status: 500;
+};
+export type getActivitiesResponseSuccess = (getActivitiesResponse200) & {
+    headers: Headers;
+};
+export type getActivitiesResponseError = (getActivitiesResponse400 | getActivitiesResponse401 | getActivitiesResponse403 | getActivitiesResponse404 | getActivitiesResponse500) & {
+    headers: Headers;
+};
+export type getActivitiesResponse = (getActivitiesResponseSuccess | getActivitiesResponseError);
+export declare const getGetActivitiesUrl: (params?: GetActivitiesParams) => string;
+export declare const getActivities: (params?: GetActivitiesParams, options?: RequestInit) => Promise<getActivitiesResponse>;
+//# sourceMappingURL=activities.d.ts.map

package/dist/generated/activities/activities.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Generated by orval v8.2.0 🍺
+ * Do not edit manually.
+ * Space Invoices API
+ * REST API for invoice management, customer management, and accounting operations. Features include cursor-based pagination for efficient data navigation, flexible JSON querying with MongoDB-style operators, full-text search across multiple fields, and comprehensive metadata support for custom tracking.
+ * OpenAPI spec version: 1.0.0
+ */
+import type { Error, GetActivities200, GetActivitiesParams } from '.././model';
+/**
+ * Retrieve a paginated list of activities for the entity. Supports filtering by resource_type, resource_id, and action. Activities are ordered by created_at descending by default.
+ * @summary List activities
+ */
+export type getActivitiesResponse200 = {
+    data: GetActivities200;
+    status: 200;
+};
+export type getActivitiesResponse400 = {
+    data: Error;
+    status: 400;
+};
+export type getActivitiesResponse401 = {
+    data: Error;
+    status: 401;
+};
+export type getActivitiesResponse403 = {
+    data: Error;
+    status: 403;
+};
+export type getActivitiesResponse404 = {
+    data: Error;
+    status: 404;
+};
+export type getActivitiesResponse500 = {
+    data: Error;
+    status: 500;
+};
+export type getActivitiesResponseSuccess = (getActivitiesResponse200) & {
+    headers: Headers;
+};
+export type getActivitiesResponseError = (getActivitiesResponse400 | getActivitiesResponse401 | getActivitiesResponse403 | getActivitiesResponse404 | getActivitiesResponse500) & {
+    headers: Headers;
+};
+export type getActivitiesResponse = (getActivitiesResponseSuccess | getActivitiesResponseError);
+export declare const getGetActivitiesUrl: (params?: GetActivitiesParams) => string;
+export declare const getActivities: (params?: GetActivitiesParams, options?: RequestInit) => Promise<getActivitiesResponse>;
+//# sourceMappingURL=activities.d.ts.map

package/dist/generated/activities/activities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activities.d.ts","sourceRoot":"","sources":["../../../src/generated/activities/activities.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,KAAK,EACL,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAIpB;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,gBAAgB,CAAA;IACtB,MAAM,EAAE,GAAG,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,KAAK,CAAA;IACX,MAAM,EAAE,GAAG,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,KAAK,CAAA;IACX,MAAM,EAAE,GAAG,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,KAAK,CAAA;IACX,MAAM,EAAE,GAAG,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,KAAK,CAAA;IACX,MAAM,EAAE,GAAG,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,KAAK,CAAA;IACX,MAAM,EAAE,GAAG,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG,CAAC,wBAAwB,CAAC,GAAG;IACtE,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,wBAAwB,GAAG,wBAAwB,GAAG,wBAAwB,GAAG,wBAAwB,GAAG,wBAAwB,CAAC,GAAG;IAChL,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,4BAA4B,GAAG,0BAA0B,CAAC,CAAA;AAE/F,eAAO,MAAM,mBAAmB,GAAI,SAAS,mBAAmB,WAa/D,CAAA;AAED,eAAO,MAAM,aAAa,GAAU,SAAS,mBAAmB,EAAE,UAAU,WAAW,KAAG,OAAO,CAAC,qBAAqB,CASpH,CAAA"}

package/dist/generated/advance-invoices/advance-invoices.d.cts

@@ -0,0 +1,334 @@
+/**
+ * Generated by orval v8.2.0 🍺
+ * Do not edit manually.
+ * Space Invoices API
+ * REST API for invoice management, customer management, and accounting operations. Features include cursor-based pagination for efficient data navigation, flexible JSON querying with MongoDB-style operators, full-text search across multiple fields, and comprehensive metadata support for custom tracking.
+ * OpenAPI spec version: 1.0.0
+ */
+import type { CompleteAdvanceInvoicePreview, CreateAdvanceInvoice201, CreateAdvanceInvoiceBody, DocumentVersion, DocumentVersionList, Error, GetAdvanceInvoiceById200, GetAdvanceInvoiceByIdParams, GetAdvanceInvoices200, GetAdvanceInvoicesParams, GetShareableAdvanceInvoice200, GetShareableAdvanceInvoiceHtmlParams, GetShareableAdvanceInvoicePdfParams, PartialAdvanceInvoicePreview, RenderAdvanceInvoicePreviewParams, UpdateAdvanceInvoice200, UpdateAdvanceInvoiceBody, ValidationError } from '.././model';
+/**
+ * Retrieve advance invoice data using a shareable token. No authentication required. Returns full advance invoice data for rendering.
+ * @summary View shareable advance invoice
+ */
+export type getShareableAdvanceInvoiceResponse200 = {
+    data: GetShareableAdvanceInvoice200;
+    status: 200;
+};
+export type getShareableAdvanceInvoiceResponse404 = {
+    data: void;
+    status: 404;
+};
+export type getShareableAdvanceInvoiceResponseSuccess = (getShareableAdvanceInvoiceResponse200) & {
+    headers: Headers;
+};
+export type getShareableAdvanceInvoiceResponseError = (getShareableAdvanceInvoiceResponse404) & {
+    headers: Headers;
+};
+export type getShareableAdvanceInvoiceResponse = (getShareableAdvanceInvoiceResponseSuccess | getShareableAdvanceInvoiceResponseError);
+export declare const getGetShareableAdvanceInvoiceUrl: (shareableId: string) => string;
+export declare const getShareableAdvanceInvoice: (shareableId: string, options?: RequestInit) => Promise<getShareableAdvanceInvoiceResponse>;
+/**
+ * Get advance invoice as HTML preview using a shareable token. No authentication required. Supports multiple languages via locale query parameter.
+ * @summary Get shareable advance invoice as HTML
+ */
+export type getShareableAdvanceInvoiceHtmlResponse200 = {
+    data: string;
+    status: 200;
+};
+export type getShareableAdvanceInvoiceHtmlResponse404 = {
+    data: void;
+    status: 404;
+};
+export type getShareableAdvanceInvoiceHtmlResponseSuccess = (getShareableAdvanceInvoiceHtmlResponse200) & {
+    headers: Headers;
+};
+export type getShareableAdvanceInvoiceHtmlResponseError = (getShareableAdvanceInvoiceHtmlResponse404) & {
+    headers: Headers;
+};
+export type getShareableAdvanceInvoiceHtmlResponse = (getShareableAdvanceInvoiceHtmlResponseSuccess | getShareableAdvanceInvoiceHtmlResponseError);
+export declare const getGetShareableAdvanceInvoiceHtmlUrl: (shareableId: string, params?: GetShareableAdvanceInvoiceHtmlParams) => string;
+export declare const getShareableAdvanceInvoiceHtml: (shareableId: string, params?: GetShareableAdvanceInvoiceHtmlParams, options?: RequestInit) => Promise<getShareableAdvanceInvoiceHtmlResponse>;
+/**
+ * Download advance invoice as PDF using a shareable token. No authentication required. Supports multiple languages via locale query parameter.
+ * @summary Download shareable advance invoice as PDF
+ */
+export type getShareableAdvanceInvoicePdfResponse200 = {
+    data: Blob;
+    status: 200;
+};
+export type getShareableAdvanceInvoicePdfResponse404 = {
+    data: void;
+    status: 404;
+};
+export type getShareableAdvanceInvoicePdfResponseSuccess = (getShareableAdvanceInvoicePdfResponse200) & {
+    headers: Headers;
+};
+export type getShareableAdvanceInvoicePdfResponseError = (getShareableAdvanceInvoicePdfResponse404) & {
+    headers: Headers;
+};
+export type getShareableAdvanceInvoicePdfResponse = (getShareableAdvanceInvoicePdfResponseSuccess | getShareableAdvanceInvoicePdfResponseError);
+export declare const getGetShareableAdvanceInvoicePdfUrl: (shareableId: string, params?: GetShareableAdvanceInvoicePdfParams) => string;
+export declare const getShareableAdvanceInvoicePdf: (shareableId: string, params?: GetShareableAdvanceInvoicePdfParams, options?: RequestInit) => Promise<getShareableAdvanceInvoicePdfResponse>;
+/**
+ * Create a new advance invoice with line items. Advance invoices are issued before goods/services are delivered to collect prepayment. When payment is received, the advance can be linked to a final invoice to apply the prepaid amount.
+ * @summary Create a new advance invoice
+ */
+export type createAdvanceInvoiceResponse201 = {
+    data: CreateAdvanceInvoice201;
+    status: 201;
+};
+export type createAdvanceInvoiceResponse400 = {
+    data: Error;
+    status: 400;
+};
+export type createAdvanceInvoiceResponse401 = {
+    data: Error;
+    status: 401;
+};
+export type createAdvanceInvoiceResponse403 = {
+    data: Error;
+    status: 403;
+};
+export type createAdvanceInvoiceResponse404 = {
+    data: Error;
+    status: 404;
+};
+export type createAdvanceInvoiceResponse422 = {
+    data: ValidationError;
+    status: 422;
+};
+export type createAdvanceInvoiceResponse500 = {
+    data: Error;
+    status: 500;
+};
+export type createAdvanceInvoiceResponseSuccess = (createAdvanceInvoiceResponse201) & {
+    headers: Headers;
+};
+export type createAdvanceInvoiceResponseError = (createAdvanceInvoiceResponse400 | createAdvanceInvoiceResponse401 | createAdvanceInvoiceResponse403 | createAdvanceInvoiceResponse404 | createAdvanceInvoiceResponse422 | createAdvanceInvoiceResponse500) & {
+    headers: Headers;
+};
+export type createAdvanceInvoiceResponse = (createAdvanceInvoiceResponseSuccess | createAdvanceInvoiceResponseError);
+export declare const getCreateAdvanceInvoiceUrl: () => string;
+export declare const createAdvanceInvoice: (createAdvanceInvoiceBody: CreateAdvanceInvoiceBody, options?: RequestInit) => Promise<createAdvanceInvoiceResponse>;
+/**
+ * Retrieve a paginated list of advance invoices with optional filtering and sorting. Supports cursor-based pagination, JSON querying with MongoDB-style operators, full-text search, and sorting.
+ * @summary List all advance invoices
+ */
+export type getAdvanceInvoicesResponse200 = {
+    data: GetAdvanceInvoices200;
+    status: 200;
+};
+export type getAdvanceInvoicesResponse400 = {
+    data: Error;
+    status: 400;
+};
+export type getAdvanceInvoicesResponse401 = {
+    data: Error;
+    status: 401;
+};
+export type getAdvanceInvoicesResponse403 = {
+    data: Error;
+    status: 403;
+};
+export type getAdvanceInvoicesResponse404 = {
+    data: Error;
+    status: 404;
+};
+export type getAdvanceInvoicesResponse500 = {
+    data: Error;
+    status: 500;
+};
+export type getAdvanceInvoicesResponseSuccess = (getAdvanceInvoicesResponse200) & {
+    headers: Headers;
+};
+export type getAdvanceInvoicesResponseError = (getAdvanceInvoicesResponse400 | getAdvanceInvoicesResponse401 | getAdvanceInvoicesResponse403 | getAdvanceInvoicesResponse404 | getAdvanceInvoicesResponse500) & {
+    headers: Headers;
+};
+export type getAdvanceInvoicesResponse = (getAdvanceInvoicesResponseSuccess | getAdvanceInvoicesResponseError);
+export declare const getGetAdvanceInvoicesUrl: (params?: GetAdvanceInvoicesParams) => string;
+export declare const getAdvanceInvoices: (params?: GetAdvanceInvoicesParams, options?: RequestInit) => Promise<getAdvanceInvoicesResponse>;
+/**
+ * Retrieve a single advance invoice by its unique identifier. Returns the complete advance invoice details including all line items, customer information, and calculated totals.
+ * @summary Get advance invoice by ID
+ */
+export type getAdvanceInvoiceByIdResponse200 = {
+    data: GetAdvanceInvoiceById200;
+    status: 200;
+};
+export type getAdvanceInvoiceByIdResponse401 = {
+    data: Error;
+    status: 401;
+};
+export type getAdvanceInvoiceByIdResponse403 = {
+    data: Error;
+    status: 403;
+};
+export type getAdvanceInvoiceByIdResponse404 = {
+    data: Error;
+    status: 404;
+};
+export type getAdvanceInvoiceByIdResponse500 = {
+    data: Error;
+    status: 500;
+};
+export type getAdvanceInvoiceByIdResponseSuccess = (getAdvanceInvoiceByIdResponse200) & {
+    headers: Headers;
+};
+export type getAdvanceInvoiceByIdResponseError = (getAdvanceInvoiceByIdResponse401 | getAdvanceInvoiceByIdResponse403 | getAdvanceInvoiceByIdResponse404 | getAdvanceInvoiceByIdResponse500) & {
+    headers: Headers;
+};
+export type getAdvanceInvoiceByIdResponse = (getAdvanceInvoiceByIdResponseSuccess | getAdvanceInvoiceByIdResponseError);
+export declare const getGetAdvanceInvoiceByIdUrl: (id: string, params?: GetAdvanceInvoiceByIdParams) => string;
+export declare const getAdvanceInvoiceById: (id: string, params?: GetAdvanceInvoiceByIdParams, options?: RequestInit) => Promise<getAdvanceInvoiceByIdResponse>;
+/**
+ * Update an existing advance invoice.
+Creates a version snapshot before applying changes.
+Cannot update voided or FURS-fiscalized advance invoices.
+If items are provided, they replace all existing items.
+ * @summary Update an advance invoice
+ */
+export type updateAdvanceInvoiceResponse200 = {
+    data: UpdateAdvanceInvoice200;
+    status: 200;
+};
+export type updateAdvanceInvoiceResponse400 = {
+    data: Error;
+    status: 400;
+};
+export type updateAdvanceInvoiceResponse401 = {
+    data: Error;
+    status: 401;
+};
+export type updateAdvanceInvoiceResponse403 = {
+    data: Error;
+    status: 403;
+};
+export type updateAdvanceInvoiceResponse404 = {
+    data: Error;
+    status: 404;
+};
+export type updateAdvanceInvoiceResponse422 = {
+    data: ValidationError;
+    status: 422;
+};
+export type updateAdvanceInvoiceResponse500 = {
+    data: Error;
+    status: 500;
+};
+export type updateAdvanceInvoiceResponseSuccess = (updateAdvanceInvoiceResponse200) & {
+    headers: Headers;
+};
+export type updateAdvanceInvoiceResponseError = (updateAdvanceInvoiceResponse400 | updateAdvanceInvoiceResponse401 | updateAdvanceInvoiceResponse403 | updateAdvanceInvoiceResponse404 | updateAdvanceInvoiceResponse422 | updateAdvanceInvoiceResponse500) & {
+    headers: Headers;
+};
+export type updateAdvanceInvoiceResponse = (updateAdvanceInvoiceResponseSuccess | updateAdvanceInvoiceResponseError);
+export declare const getUpdateAdvanceInvoiceUrl: (id: string) => string;
+export declare const updateAdvanceInvoice: (id: string, updateAdvanceInvoiceBody: UpdateAdvanceInvoiceBody, options?: RequestInit) => Promise<updateAdvanceInvoiceResponse>;
+/**
+ * Retrieve the version history for an advance invoice. Each version represents the document state before an update was applied.
+ * @summary Get advance invoice version history
+ */
+export type getAdvanceInvoiceVersionsResponse200 = {
+    data: DocumentVersionList;
+    status: 200;
+};
+export type getAdvanceInvoiceVersionsResponse401 = {
+    data: Error;
+    status: 401;
+};
+export type getAdvanceInvoiceVersionsResponse403 = {
+    data: Error;
+    status: 403;
+};
+export type getAdvanceInvoiceVersionsResponse404 = {
+    data: Error;
+    status: 404;
+};
+export type getAdvanceInvoiceVersionsResponse500 = {
+    data: Error;
+    status: 500;
+};
+export type getAdvanceInvoiceVersionsResponseSuccess = (getAdvanceInvoiceVersionsResponse200) & {
+    headers: Headers;
+};
+export type getAdvanceInvoiceVersionsResponseError = (getAdvanceInvoiceVersionsResponse401 | getAdvanceInvoiceVersionsResponse403 | getAdvanceInvoiceVersionsResponse404 | getAdvanceInvoiceVersionsResponse500) & {
+    headers: Headers;
+};
+export type getAdvanceInvoiceVersionsResponse = (getAdvanceInvoiceVersionsResponseSuccess | getAdvanceInvoiceVersionsResponseError);
+export declare const getGetAdvanceInvoiceVersionsUrl: (id: string) => string;
+export declare const getAdvanceInvoiceVersions: (id: string, options?: RequestInit) => Promise<getAdvanceInvoiceVersionsResponse>;
+/**
+ * Retrieve a specific version snapshot of an advance invoice.
+ * @summary Get specific advance invoice version
+ */
+export type getAdvanceInvoiceVersionResponse200 = {
+    data: DocumentVersion;
+    status: 200;
+};
+export type getAdvanceInvoiceVersionResponse401 = {
+    data: Error;
+    status: 401;
+};
+export type getAdvanceInvoiceVersionResponse403 = {
+    data: Error;
+    status: 403;
+};
+export type getAdvanceInvoiceVersionResponse404 = {
+    data: Error;
+    status: 404;
+};
+export type getAdvanceInvoiceVersionResponse500 = {
+    data: Error;
+    status: 500;
+};
+export type getAdvanceInvoiceVersionResponseSuccess = (getAdvanceInvoiceVersionResponse200) & {
+    headers: Headers;
+};
+export type getAdvanceInvoiceVersionResponseError = (getAdvanceInvoiceVersionResponse401 | getAdvanceInvoiceVersionResponse403 | getAdvanceInvoiceVersionResponse404 | getAdvanceInvoiceVersionResponse500) & {
+    headers: Headers;
+};
+export type getAdvanceInvoiceVersionResponse = (getAdvanceInvoiceVersionResponseSuccess | getAdvanceInvoiceVersionResponseError);
+export declare const getGetAdvanceInvoiceVersionUrl: (id: string, version: number) => string;
+export declare const getAdvanceInvoiceVersion: (id: string, version: number, options?: RequestInit) => Promise<getAdvanceInvoiceVersionResponse>;
+/**
+ * Render an HTML preview of an advance invoice without saving to the database. Perfect for displaying live previews in advance invoice creation/edit forms. Supports both partial mode (allows incomplete data for drafts) and complete mode (validates all required fields).
+ * @summary Render advance invoice preview
+ */
+export type renderAdvanceInvoicePreviewResponse200 = {
+    data: string;
+    status: 200;
+};
+export type renderAdvanceInvoicePreviewResponse400 = {
+    data: Error;
+    status: 400;
+};
+export type renderAdvanceInvoicePreviewResponse401 = {
+    data: Error;
+    status: 401;
+};
+export type renderAdvanceInvoicePreviewResponse403 = {
+    data: Error;
+    status: 403;
+};
+export type renderAdvanceInvoicePreviewResponse404 = {
+    data: Error;
+    status: 404;
+};
+export type renderAdvanceInvoicePreviewResponse422 = {
+    data: ValidationError;
+    status: 422;
+};
+export type renderAdvanceInvoicePreviewResponse500 = {
+    data: Error;
+    status: 500;
+};
+export type renderAdvanceInvoicePreviewResponseSuccess = (renderAdvanceInvoicePreviewResponse200) & {
+    headers: Headers;
+};
+export type renderAdvanceInvoicePreviewResponseError = (renderAdvanceInvoicePreviewResponse400 | renderAdvanceInvoicePreviewResponse401 | renderAdvanceInvoicePreviewResponse403 | renderAdvanceInvoicePreviewResponse404 | renderAdvanceInvoicePreviewResponse422 | renderAdvanceInvoicePreviewResponse500) & {
+    headers: Headers;
+};
+export type renderAdvanceInvoicePreviewResponse = (renderAdvanceInvoicePreviewResponseSuccess | renderAdvanceInvoicePreviewResponseError);
+export declare const getRenderAdvanceInvoicePreviewUrl: (params?: RenderAdvanceInvoicePreviewParams) => string;
+export declare const renderAdvanceInvoicePreview: (partialAdvanceInvoicePreviewCompleteAdvanceInvoicePreview: PartialAdvanceInvoicePreview | CompleteAdvanceInvoicePreview, params?: RenderAdvanceInvoicePreviewParams, options?: RequestInit) => Promise<renderAdvanceInvoicePreviewResponse>;
+//# sourceMappingURL=advance-invoices.d.ts.map