@spaceinvoices/react-ui 0.4.1 → 0.4.2

package/src/generated/schemas/renderestimatepreview_body.ts

@@ -8,25 +8,6 @@ import { z } from 'zod';
 
 // Schemas for renderestimatepreview_body endpoints
 
-// Dependency schema for renderestimatepreview_body
-const LineDiscount = z.object({
-  value: z.number().gte(0),
-  type: z.enum(["percent", "amount"]).optional().default("percent"),
-});
-
-
-// Dependency schema for renderestimatepreview_body
-const DocumentItemTax = z
-  .object({
-    rate: z.number(),
-    tax_id: z.string(),
-    classification: z.string(),
-    reverse_charge: z.boolean(),
-    amount: z.number(),
-  })
-  .partial();
-
-
 // Dependency schema for renderestimatepreview_body
 const DocumentEntity = z
   .object({
@@ -66,7 +47,19 @@ const DocumentEntity = z
 
 
 // Dependency schema for renderestimatepreview_body
-const CompleteEstimatePreview = z.object({
+const CreateDocumentCustomer = DocumentEntity.and(
+  z.union([
+    z
+      .object({ save_customer: z.boolean().default(true) })
+      .partial()
+      .passthrough(),
+    z.null(),
+  ])
+);
+
+
+// Dependency schema for renderestimatepreview_body
+const PartialEstimatePreview = z.object({
   is_draft: z.boolean().optional(),
   date: z
     .string()
@@ -74,15 +67,7 @@ const CompleteEstimatePreview = z.object({
     .optional(),
   issuer: DocumentEntity.optional(),
   customer_id: z.union([z.string(), z.null()]).optional(),
-  customer: DocumentEntity.and(
-    z.union([
-      z
-        .object({ save_customer: z.boolean().default(true) })
-        .partial()
-        .passthrough(),
-      z.null(),
-    ])
-  ).optional(),
+  customer: CreateDocumentCustomer.optional(),
   note: z.union([z.string(), z.null()]).optional(),
   payment_terms: z.union([z.string(), z.null()]).optional(),
   tax_clause: z.union([z.string(), z.null()]).optional(),
@@ -95,28 +80,23 @@ const CompleteEstimatePreview = z.object({
   date_service_to: z.union([z.string(), z.null()]).optional(),
   items: z
     .array(
-      z.object({
-        name: z.string().min(1).optional(),
-        description: z.union([z.string(), z.null()]).optional(),
-        price: z.number().optional(),
-        gross_price: z.number().optional(),
-        quantity: z.number().gte(-140737488355328).lte(140737488355327),
-        unit: z.union([z.string(), z.null()]).optional(),
-        taxes: z.array(DocumentItemTax).optional(),
-        discounts: z.array(LineDiscount).max(5).optional(),
-        metadata: z
-          .union([
-            z.string(),
-            z.number(),
-            z.boolean(),
-            z.null(),
-            z.object({}).partial().passthrough(),
-            z.array(z.unknown()),
-            z.null(),
-          ])
-          .optional(),
-        item_id: z.string().optional(),
-      })
+      z
+        .object({
+          name: z.string(),
+          quantity: z.number(),
+          price: z.number(),
+          gross_price: z.number(),
+          description: z.string(),
+          taxes: z.array(
+            z
+              .object({ rate: z.number(), tax_id: z.string() })
+              .partial()
+              .passthrough()
+          ),
+          metadata: z.record(z.string(), z.any()),
+        })
+        .partial()
+        .passthrough()
     )
     .min(1),
   expected_total_with_tax: z.number().gt(0).optional(),
@@ -124,7 +104,51 @@ const CompleteEstimatePreview = z.object({
 
 
 // Dependency schema for renderestimatepreview_body
-const PartialEstimatePreview = z.object({
+const DocumentItemTax = z
+  .object({
+    rate: z.number(),
+    tax_id: z.string(),
+    classification: z.string(),
+    reverse_charge: z.boolean(),
+    amount: z.number(),
+  })
+  .partial();
+
+
+// Dependency schema for renderestimatepreview_body
+const LineDiscount = z.object({
+  value: z.number().gte(0),
+  type: z.enum(["percent", "amount"]).optional().default("percent"),
+});
+
+
+// Dependency schema for renderestimatepreview_body
+const CreateDocumentItem = z.object({
+  name: z.string().min(1).optional(),
+  description: z.union([z.string(), z.null()]).optional(),
+  price: z.number().optional(),
+  gross_price: z.number().optional(),
+  quantity: z.number().gte(-140737488355328).lte(140737488355327),
+  unit: z.union([z.string(), z.null()]).optional(),
+  taxes: z.array(DocumentItemTax).optional(),
+  discounts: z.array(LineDiscount).max(5).optional(),
+  metadata: z
+    .union([
+      z.string(),
+      z.number(),
+      z.boolean(),
+      z.null(),
+      z.object({}).partial().passthrough(),
+      z.array(z.unknown()),
+      z.null(),
+    ])
+    .optional(),
+  item_id: z.string().optional(),
+});
+
+
+// Dependency schema for renderestimatepreview_body
+const CompleteEstimatePreview = z.object({
   is_draft: z.boolean().optional(),
   date: z
     .string()
@@ -132,15 +156,7 @@ const PartialEstimatePreview = z.object({
     .optional(),
   issuer: DocumentEntity.optional(),
   customer_id: z.union([z.string(), z.null()]).optional(),
-  customer: DocumentEntity.and(
-    z.union([
-      z
-        .object({ save_customer: z.boolean().default(true) })
-        .partial()
-        .passthrough(),
-      z.null(),
-    ])
-  ).optional(),
+  customer: CreateDocumentCustomer.optional(),
   note: z.union([z.string(), z.null()]).optional(),
   payment_terms: z.union([z.string(), z.null()]).optional(),
   tax_clause: z.union([z.string(), z.null()]).optional(),
@@ -151,27 +167,7 @@ const PartialEstimatePreview = z.object({
   date_due: z.union([z.string(), z.null()]).optional(),
   date_service: z.union([z.string(), z.null()]).optional(),
   date_service_to: z.union([z.string(), z.null()]).optional(),
-  items: z
-    .array(
-      z
-        .object({
-          name: z.string(),
-          quantity: z.number(),
-          price: z.number(),
-          gross_price: z.number(),
-          description: z.string(),
-          taxes: z.array(
-            z
-              .object({ rate: z.number(), tax_id: z.string() })
-              .partial()
-              .passthrough()
-          ),
-          metadata: z.record(z.string(), z.any()),
-        })
-        .partial()
-        .passthrough()
-    )
-    .min(1),
+  items: z.array(CreateDocumentItem).min(1),
   expected_total_with_tax: z.number().gt(0).optional(),
 });
 

package/src/generated/schemas/renderinvoicepreview_body.ts

@@ -8,25 +8,6 @@ import { z } from 'zod';
 
 // Schemas for renderinvoicepreview_body endpoints
 
-// Dependency schema for renderinvoicepreview_body
-const LineDiscount = z.object({
-  value: z.number().gte(0),
-  type: z.enum(["percent", "amount"]).optional().default("percent"),
-});
-
-
-// Dependency schema for renderinvoicepreview_body
-const DocumentItemTax = z
-  .object({
-    rate: z.number(),
-    tax_id: z.string(),
-    classification: z.string(),
-    reverse_charge: z.boolean(),
-    amount: z.number(),
-  })
-  .partial();
-
-
 // Dependency schema for renderinvoicepreview_body
 const DocumentEntity = z
   .object({
@@ -66,91 +47,48 @@ const DocumentEntity = z
 
 
 // Dependency schema for renderinvoicepreview_body
-const CompleteInvoicePreview = z.object({
-  is_draft: z.boolean().optional(),
-  date: z
-    .string()
-    .regex(/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d{3})?Z?)?$/)
-    .optional(),
-  issuer: DocumentEntity.optional(),
-  customer_id: z.union([z.string(), z.null()]).optional(),
-  customer: DocumentEntity.and(
-    z.union([
-      z
-        .object({ save_customer: z.boolean().default(true) })
-        .partial()
-        .passthrough(),
-      z.null(),
-    ])
-  ).optional(),
-  note: z.union([z.string(), z.null()]).optional(),
-  payment_terms: z.union([z.string(), z.null()]).optional(),
-  tax_clause: z.union([z.string(), z.null()]).optional(),
-  currency_code: z.string().max(3).optional(),
-  metadata: z.union([z.record(z.string(), z.any()), z.null()]).optional(),
-  date_due: z.union([z.string(), z.null()]).optional(),
-  date_service: z.union([z.string(), z.null()]).optional(),
-  date_service_to: z.union([z.string(), z.null()]).optional(),
-  items: z
-    .array(
-      z.object({
-        name: z.string().min(1).optional(),
-        description: z.union([z.string(), z.null()]).optional(),
-        price: z.number().optional(),
-        gross_price: z.number().optional(),
-        quantity: z.number().gte(-140737488355328).lte(140737488355327),
-        unit: z.union([z.string(), z.null()]).optional(),
-        taxes: z.array(DocumentItemTax).optional(),
-        discounts: z.array(LineDiscount).max(5).optional(),
-        metadata: z
-          .union([
-            z.string(),
-            z.number(),
-            z.boolean(),
-            z.null(),
-            z.object({}).partial().passthrough(),
-            z.array(z.unknown()),
-            z.null(),
-          ])
-          .optional(),
-        item_id: z.string().optional(),
-      })
-    )
-    .min(1),
-  fina: z
-    .union([
-      z
-        .object({
-          premise_id: z
-            .string()
-            .min(1)
-            .max(20)
-            .regex(/^[0-9a-zA-Z]{1,20}$/),
-          device_id: z
-            .string()
-            .min(1)
-            .max(20)
-            .regex(/^\d{1,20}$/),
-          operator_oib: z.string().min(11).max(11),
-          is_end_consumer: z.boolean(),
-          payment_type: z.enum([
-            "cash",
-            "card",
-            "online",
-            "bank_transfer",
-            "paypal",
-            "crypto",
-            "coupon",
-            "other",
-          ]),
-          subsequent_submit: z.boolean(),
-        })
-        .partial(),
-      z.null(),
-    ])
-    .optional(),
-  expected_total_with_tax: z.number().gt(0).optional(),
-});
+const CreateDocumentCustomer = DocumentEntity.and(
+  z.union([
+    z
+      .object({ save_customer: z.boolean().default(true) })
+      .partial()
+      .passthrough(),
+    z.null(),
+  ])
+);
+
+
+// Dependency schema for renderinvoicepreview_body
+const CreateFinaInvoiceData = z.union([
+  z
+    .object({
+      premise_id: z
+        .string()
+        .min(1)
+        .max(20)
+        .regex(/^[0-9a-zA-Z]{1,20}$/),
+      device_id: z
+        .string()
+        .min(1)
+        .max(20)
+        .regex(/^\d{1,20}$/),
+      operator_oib: z.string().min(11).max(11),
+      is_end_consumer: z.boolean(),
+      payment_type: z.enum([
+        "cash",
+        "card",
+        "online",
+        "bank_transfer",
+        "paypal",
+        "crypto",
+        "coupon",
+        "other",
+      ]),
+      subsequent_submit: z.boolean(),
+    })
+    .partial(),
+  z.null(),
+]);
 
 
 // Dependency schema for renderinvoicepreview_body
@@ -162,15 +100,7 @@ const PartialInvoicePreview = z.object({
     .optional(),
   issuer: DocumentEntity.optional(),
   customer_id: z.union([z.string(), z.null()]).optional(),
-  customer: DocumentEntity.and(
-    z.union([
-      z
-        .object({ save_customer: z.boolean().default(true) })
-        .partial()
-        .passthrough(),
-      z.null(),
-    ])
-  ).optional(),
+  customer: CreateDocumentCustomer.optional(),
   note: z.union([z.string(), z.null()]).optional(),
   payment_terms: z.union([z.string(), z.null()]).optional(),
   tax_clause: z.union([z.string(), z.null()]).optional(),
@@ -200,38 +130,75 @@ const PartialInvoicePreview = z.object({
         .passthrough()
     )
     .min(1),
-  fina: z
+  fina: CreateFinaInvoiceData.optional(),
+  expected_total_with_tax: z.number().gt(0).optional(),
+});
+
+
+// Dependency schema for renderinvoicepreview_body
+const DocumentItemTax = z
+  .object({
+    rate: z.number(),
+    tax_id: z.string(),
+    classification: z.string(),
+    reverse_charge: z.boolean(),
+    amount: z.number(),
+  })
+  .partial();
+
+
+// Dependency schema for renderinvoicepreview_body
+const LineDiscount = z.object({
+  value: z.number().gte(0),
+  type: z.enum(["percent", "amount"]).optional().default("percent"),
+});
+
+
+// Dependency schema for renderinvoicepreview_body
+const CreateDocumentItem = z.object({
+  name: z.string().min(1).optional(),
+  description: z.union([z.string(), z.null()]).optional(),
+  price: z.number().optional(),
+  gross_price: z.number().optional(),
+  quantity: z.number().gte(-140737488355328).lte(140737488355327),
+  unit: z.union([z.string(), z.null()]).optional(),
+  taxes: z.array(DocumentItemTax).optional(),
+  discounts: z.array(LineDiscount).max(5).optional(),
+  metadata: z
     .union([
-      z
-        .object({
-          premise_id: z
-            .string()
-            .min(1)
-            .max(20)
-            .regex(/^[0-9a-zA-Z]{1,20}$/),
-          device_id: z
-            .string()
-            .min(1)
-            .max(20)
-            .regex(/^\d{1,20}$/),
-          operator_oib: z.string().min(11).max(11),
-          is_end_consumer: z.boolean(),
-          payment_type: z.enum([
-            "cash",
-            "card",
-            "online",
-            "bank_transfer",
-            "paypal",
-            "crypto",
-            "coupon",
-            "other",
-          ]),
-          subsequent_submit: z.boolean(),
-        })
-        .partial(),
+      z.string(),
+      z.number(),
+      z.boolean(),
+      z.null(),
+      z.object({}).partial().passthrough(),
+      z.array(z.unknown()),
       z.null(),
     ])
     .optional(),
+  item_id: z.string().optional(),
+});
+
+
+// Dependency schema for renderinvoicepreview_body
+const CompleteInvoicePreview = z.object({
+  is_draft: z.boolean().optional(),
+  date: z
+    .string()
+    .regex(/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d{3})?Z?)?$/)
+    .optional(),
+  issuer: DocumentEntity.optional(),
+  customer_id: z.union([z.string(), z.null()]).optional(),
+  customer: CreateDocumentCustomer.optional(),
+  note: z.union([z.string(), z.null()]).optional(),
+  payment_terms: z.union([z.string(), z.null()]).optional(),
+  tax_clause: z.union([z.string(), z.null()]).optional(),
+  currency_code: z.string().max(3).optional(),
+  metadata: z.union([z.record(z.string(), z.any()), z.null()]).optional(),
+  date_due: z.union([z.string(), z.null()]).optional(),
+  date_service: z.union([z.string(), z.null()]).optional(),
+  date_service_to: z.union([z.string(), z.null()]).optional(),
+  items: z.array(CreateDocumentItem).min(1),
+  fina: CreateFinaInvoiceData.optional(),
   expected_total_with_tax: z.number().gt(0).optional(),
 });
 

package/src/generated/schemas/webhook.ts

@@ -59,9 +59,30 @@ const createWebhookSchemaDefinition = z.object({
         "tax.deleted",
         "tax.restored",
         "tax.permanently_deleted",
+        "recurring_invoice.created",
+        "recurring_invoice.updated",
+        "recurring_invoice.deleted",
+        "recurring_invoice.restored",
+        "recurring_invoice.permanently_deleted",
+        "recurring_invoice.paused",
+        "recurring_invoice.resumed",
+        "recurring_invoice.invoice_generated",
+        "recurring_invoice.generation_failed",
+        "recurring_invoice.completed",
         "stripe_app.connected",
         "stripe_app.disconnected",
         "stripe_app.settings_updated",
+        "order.created",
+        "order.updated",
+        "order.deleted",
+        "order.restored",
+        "order.permanently_deleted",
+        "order.processed",
+        "order.cancelled",
+        "order.failed",
+        "order_integration.created",
+        "order_integration.updated",
+        "order_integration.deleted",
       ])
     )
     .min(1),
@@ -125,9 +146,30 @@ const updateWebhookSchemaDefinition = z
           "tax.deleted",
           "tax.restored",
           "tax.permanently_deleted",
+          "recurring_invoice.created",
+          "recurring_invoice.updated",
+          "recurring_invoice.deleted",
+          "recurring_invoice.restored",
+          "recurring_invoice.permanently_deleted",
+          "recurring_invoice.paused",
+          "recurring_invoice.resumed",
+          "recurring_invoice.invoice_generated",
+          "recurring_invoice.generation_failed",
+          "recurring_invoice.completed",
           "stripe_app.connected",
           "stripe_app.disconnected",
           "stripe_app.settings_updated",
+          "order.created",
+          "order.updated",
+          "order.deleted",
+          "order.restored",
+          "order.permanently_deleted",
+          "order.processed",
+          "order.cancelled",
+          "order.failed",
+          "order_integration.created",
+          "order_integration.updated",
+          "order_integration.deleted",
         ])
       )
       .min(1),

package/src/lib/furs-error-utils.ts

@@ -0,0 +1,36 @@
+/**
+ * Detect if an error is a FURS operator settings validation error (422).
+ * The API returns a ZodError with paths like ["furs", "operator_tax_number"]
+ * when operator settings are missing during document creation.
+ */
+export function isFursOperatorError(error: unknown): boolean {
+  const data = (error as any)?.data;
+  if (!data?.cause?.issues) return false;
+  return data.cause.issues.some(
+    (issue: any) =>
+      issue.path?.[0] === "furs" && (issue.path?.[1] === "operator_tax_number" || issue.path?.[1] === "operator_label"),
+  );
+}
+
+/**
+ * Detect if an error is a FINA operator settings error.
+ * CIS requires OibOper (minOccurs="1" in FiskalizacijaSchema.xsd).
+ * Checks for Zod validation errors with paths like ["fina", "operator_oib"]
+ * or CIS XML validation errors mentioning OibOper.
+ */
+export function isFinaOperatorError(error: unknown): boolean {
+  const data = (error as any)?.data;
+  // Check for Zod-style validation error
+  if (data?.cause?.issues) {
+    return data.cause.issues.some(
+      (issue: any) =>
+        issue.path?.[0] === "fina" && (issue.path?.[1] === "operator_oib" || issue.path?.[1] === "operator_label"),
+    );
+  }
+  // Check for CIS error message mentioning OibOper
+  const message = data?.message || (error as any)?.message || "";
+  if (typeof message === "string" && message.includes("OibOper")) {
+    return true;
+  }
+  return false;
+}

package/src/lib/schemas/advance-invoice.ts

@@ -3,7 +3,7 @@
  *
  * Requires: ./shared.ts
  */
-import type { CreateAdvanceInvoiceBody } from "@spaceinvoices/js-sdk";
+import type { CreateAdvanceInvoice } from "@spaceinvoices/js-sdk";
 import { z } from "zod";
 import { customerSchema, lineItemSchema, transformItemsForApi } from "./shared";
 
@@ -35,9 +35,9 @@ export const advanceInvoiceFormSchema = z.object({
 export type AdvanceInvoiceFormValues = z.infer<typeof advanceInvoiceFormSchema>;
 
 /** Convert form values to API request */
-export function toCreateAdvanceInvoiceRequest(values: AdvanceInvoiceFormValues): CreateAdvanceInvoiceBody {
+export function toCreateAdvanceInvoiceRequest(values: AdvanceInvoiceFormValues): CreateAdvanceInvoice {
   return {
     ...values,
     items: transformItemsForApi(values.items ?? []),
-  } as CreateAdvanceInvoiceBody;
+  } as CreateAdvanceInvoice;
 }

package/src/lib/schemas/credit-note.ts

@@ -3,7 +3,7 @@
  *
  * Requires: ./shared.ts
  */
-import type { CreateCreditNoteBody } from "@spaceinvoices/js-sdk";
+import type { CreateCreditNote } from "@spaceinvoices/js-sdk";
 import { z } from "zod";
 import { customerSchema, lineItemSchema, transformItemsForApi } from "./shared";
 
@@ -24,9 +24,9 @@ export const creditNoteFormSchema = z.object({
 export type CreditNoteFormValues = z.infer<typeof creditNoteFormSchema>;
 
 /** Convert form values to API request */
-export function toCreateCreditNoteRequest(values: CreditNoteFormValues): CreateCreditNoteBody {
+export function toCreateCreditNoteRequest(values: CreditNoteFormValues): CreateCreditNote {
   return {
     ...values,
     items: transformItemsForApi(values.items ?? []),
-  } as CreateCreditNoteBody;
+  } as CreateCreditNote;
 }

package/src/lib/schemas/estimate.ts

@@ -3,7 +3,7 @@
  *
  * Requires: ./shared.ts
  */
-import type { CreateEstimateBody } from "@spaceinvoices/js-sdk";
+import type { CreateEstimate } from "@spaceinvoices/js-sdk";
 import { z } from "zod";
 import { customerSchema, lineItemSchema, transformItemsForApi } from "./shared";
 
@@ -23,9 +23,9 @@ export const estimateFormSchema = z.object({
 export type EstimateFormValues = z.infer<typeof estimateFormSchema>;
 
 /** Convert form values to API request */
-export function toCreateEstimateRequest(values: EstimateFormValues): CreateEstimateBody {
+export function toCreateEstimateRequest(values: EstimateFormValues): CreateEstimate {
   return {
     ...values,
     items: transformItemsForApi(values.items ?? []),
-  } as CreateEstimateBody;
+  } as CreateEstimate;
 }

package/src/lib/schemas/invoice.ts

@@ -3,7 +3,7 @@
  *
  * Requires: ./shared.ts
  */
-import type { CreateInvoiceBody } from "@spaceinvoices/js-sdk";
+import type { CreateInvoice } from "@spaceinvoices/js-sdk";
 import { z } from "zod";
 import { customerSchema, lineItemSchema, transformItemsForApi } from "./shared";
 
@@ -35,9 +35,9 @@ export const invoiceFormSchema = z.object({
 export type InvoiceFormValues = z.infer<typeof invoiceFormSchema>;
 
 /** Convert form values to API request */
-export function toCreateInvoiceRequest(values: InvoiceFormValues): CreateInvoiceBody {
+export function toCreateInvoiceRequest(values: InvoiceFormValues): CreateInvoice {
   return {
     ...values,
     items: transformItemsForApi(values.items ?? []),
-  } as CreateInvoiceBody;
+  } as CreateInvoice;
 }