@spaceinvoices/react-ui 0.4.0 → 0.4.2

package/src/generated/schemas/renderinvoicepreview_body.ts

@@ -9,177 +9,86 @@ 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 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: z
-    .object({
-      name: z.union([z.string(), z.null()]),
-      email: z.union([z.string(), z.null()]),
-      address: z.union([z.string(), z.null()]),
-      address_2: z.union([z.string(), z.null()]),
-      post_code: z.union([z.string(), z.null()]),
-      city: z.union([z.string(), z.null()]),
-      state: z.union([z.string(), z.null()]),
-      country: z.union([z.string(), z.null()]),
-      country_code: z.union([z.string(), z.null()]),
-      tax_number: z.union([z.string(), z.null()]),
-      tax_number_2: z.union([z.string(), z.null()]),
-      company_number: z.union([z.string(), z.null()]),
-      bank_account: z.union([
-        z
-          .object({
-            type: z
-              .enum(["iban", "us_domestic", "uk_domestic", "other"])
-              .default("iban"),
-            name: z.string(),
-            bank_name: z.string(),
-            iban: z.string(),
-            account_number: z.string(),
-            bic: z.string(),
-            routing_number: z.string(),
-            sort_code: z.string(),
-          })
-          .partial()
-          .passthrough(),
-        z.null(),
-      ]),
-    })
-    .partial()
-    .passthrough()
-    .optional(),
-  customer_id: z.union([z.string(), z.null()]).optional(),
-  customer: z
-    .union([
+const DocumentEntity = z
+  .object({
+    name: z.union([z.string(), z.null()]),
+    email: z.union([z.string(), z.null()]),
+    address: z.union([z.string(), z.null()]),
+    address_2: z.union([z.string(), z.null()]),
+    post_code: z.union([z.string(), z.null()]),
+    city: z.union([z.string(), z.null()]),
+    state: z.union([z.string(), z.null()]),
+    country: z.union([z.string(), z.null()]),
+    country_code: z.union([z.string(), z.null()]),
+    tax_number: z.union([z.string(), z.null()]),
+    tax_number_2: z.union([z.string(), z.null()]),
+    company_number: z.union([z.string(), z.null()]),
+    bank_account: z.union([
       z
         .object({
-          name: z.union([z.string(), z.null()]),
-          email: z.union([z.string(), z.null()]),
-          address: z.union([z.string(), z.null()]),
-          address_2: z.union([z.string(), z.null()]),
-          post_code: z.union([z.string(), z.null()]),
-          city: z.union([z.string(), z.null()]),
-          state: z.union([z.string(), z.null()]),
-          country: z.union([z.string(), z.null()]),
-          country_code: z.union([z.string(), z.null()]),
-          tax_number: z.union([z.string(), z.null()]),
-          tax_number_2: z.union([z.string(), z.null()]),
-          company_number: z.union([z.string(), z.null()]),
-          bank_account: z.union([
-            z
-              .object({
-                type: z
-                  .enum(["iban", "us_domestic", "uk_domestic", "other"])
-                  .default("iban"),
-                name: z.string(),
-                bank_name: z.string(),
-                iban: z.string(),
-                account_number: z.string(),
-                bic: z.string(),
-                routing_number: z.string(),
-                sort_code: z.string(),
-              })
-              .partial()
-              .passthrough(),
-            z.null(),
-          ]),
-          save_customer: z.boolean().default(true),
+          type: z
+            .enum(["iban", "us_domestic", "uk_domestic", "other"])
+            .default("iban"),
+          name: z.string(),
+          bank_name: z.string(),
+          iban: z.string(),
+          account_number: z.string(),
+          bic: z.string(),
+          routing_number: z.string(),
+          sort_code: z.string(),
         })
         .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(
-            z
-              .object({
-                rate: z.number(),
-                tax_id: z.string(),
-                classification: z.string(),
-                reverse_charge: z.boolean(),
-                amount: z.number(),
-              })
-              .partial()
-          )
-          .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(),
-});
+    ]),
+  })
+  .partial()
+  .passthrough();
+
+
+// Dependency schema for renderinvoicepreview_body
+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
@@ -189,84 +98,9 @@ const PartialInvoicePreview = z.object({
     .string()
     .regex(/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d{3})?Z?)?$/)
     .optional(),
-  issuer: z
-    .object({
-      name: z.union([z.string(), z.null()]),
-      email: z.union([z.string(), z.null()]),
-      address: z.union([z.string(), z.null()]),
-      address_2: z.union([z.string(), z.null()]),
-      post_code: z.union([z.string(), z.null()]),
-      city: z.union([z.string(), z.null()]),
-      state: z.union([z.string(), z.null()]),
-      country: z.union([z.string(), z.null()]),
-      country_code: z.union([z.string(), z.null()]),
-      tax_number: z.union([z.string(), z.null()]),
-      tax_number_2: z.union([z.string(), z.null()]),
-      company_number: z.union([z.string(), z.null()]),
-      bank_account: z.union([
-        z
-          .object({
-            type: z
-              .enum(["iban", "us_domestic", "uk_domestic", "other"])
-              .default("iban"),
-            name: z.string(),
-            bank_name: z.string(),
-            iban: z.string(),
-            account_number: z.string(),
-            bic: z.string(),
-            routing_number: z.string(),
-            sort_code: z.string(),
-          })
-          .partial()
-          .passthrough(),
-        z.null(),
-      ]),
-    })
-    .partial()
-    .passthrough()
-    .optional(),
+  issuer: DocumentEntity.optional(),
   customer_id: z.union([z.string(), z.null()]).optional(),
-  customer: z
-    .union([
-      z
-        .object({
-          name: z.union([z.string(), z.null()]),
-          email: z.union([z.string(), z.null()]),
-          address: z.union([z.string(), z.null()]),
-          address_2: z.union([z.string(), z.null()]),
-          post_code: z.union([z.string(), z.null()]),
-          city: z.union([z.string(), z.null()]),
-          state: z.union([z.string(), z.null()]),
-          country: z.union([z.string(), z.null()]),
-          country_code: z.union([z.string(), z.null()]),
-          tax_number: z.union([z.string(), z.null()]),
-          tax_number_2: z.union([z.string(), z.null()]),
-          company_number: z.union([z.string(), z.null()]),
-          bank_account: z.union([
-            z
-              .object({
-                type: z
-                  .enum(["iban", "us_domestic", "uk_domestic", "other"])
-                  .default("iban"),
-                name: z.string(),
-                bank_name: z.string(),
-                iban: z.string(),
-                account_number: z.string(),
-                bic: z.string(),
-                routing_number: z.string(),
-                sort_code: z.string(),
-              })
-              .partial()
-              .passthrough(),
-            z.null(),
-          ]),
-          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(),
@@ -296,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;
 }

package/src/providers/white-label-provider.tsx

@@ -5,6 +5,7 @@ export type WhiteLabelConfig = {
   slug: string;
   name: string;
   hiddenFeatures: string[]; // Features hidden from UI (still available via API)
+  halAppId: string | null; // Hal app ID for chat widget (null = no Hal integration)
 };
 
 // Default config until API responds (Space Invoices = all features visible)
@@ -12,6 +13,7 @@ const DEFAULT_CONFIG: WhiteLabelConfig = {
   slug: "space-invoices",
   name: "Space Invoices",
   hiddenFeatures: [],
+  halAppId: null,
 };
 
 type WhiteLabelContextType = WhiteLabelConfig & {
@@ -50,6 +52,7 @@ export function WhiteLabelProvider({ children, apiBaseUrl = "" }: WhiteLabelProv
             slug: data.slug,
             name: data.name,
             hiddenFeatures: data.hidden_features,
+            halAppId: data.hal_app_id ?? null,
           });
         }
       } catch {