@spaceinvoices/react-ui 0.4.2 → 0.4.4

package/src/components/documents/view/document-sidebar.tsx

@@ -0,0 +1,151 @@
+import type {
+  AdvanceInvoice,
+  CreditNote,
+  DeliveryNote,
+  DocumentRelation,
+  Estimate,
+  Invoice,
+  Payment,
+} from "@spaceinvoices/js-sdk";
+import { Card, CardContent } from "@/ui/components/ui/card";
+import { Separator } from "@/ui/components/ui/separator";
+import type { ComponentTranslationProps } from "@/ui/lib/translation";
+import { FiscalizationStatusCard } from "../../invoices/view/fiscalization-status-card";
+import { DocumentActivitiesList } from "./document-activities-list";
+import { DocumentDetailsCard } from "./document-details-card";
+import { DocumentPaymentsList } from "./document-payments-list";
+import { DocumentRelationsList } from "./document-relations-list";
+
+type Document = Invoice | Estimate | CreditNote | AdvanceInvoice | DeliveryNote;
+type DocumentType = "invoice" | "estimate" | "credit_note" | "advance_invoice" | "delivery_note";
+
+interface DocumentSidebarProps extends ComponentTranslationProps {
+  document: Document;
+  documentType: DocumentType;
+  entityId: string;
+  locale?: string;
+  currentUserId?: string;
+  /** Show payments section */
+  showPayments?: boolean;
+  onAddPayment?: () => void;
+  onEditPayment?: (payment: Payment) => void;
+  onPaymentDeleteSuccess?: () => void;
+  onPaymentDeleteError?: (error: string) => void;
+  /** Navigate to a related document */
+  onNavigateRelation?: (documentId: string) => void;
+  /** FURS fiscalization */
+  showFurs?: boolean;
+  fursFiscalizationData?: any;
+  /** FINA fiscalization */
+  showFina?: boolean;
+  finaFiscalizationData?: any;
+  onRetryFiscalization?: () => void;
+  isRetryingFiscalization?: boolean;
+}
+
+export function DocumentSidebar({
+  document,
+  documentType,
+  entityId,
+  locale = "en",
+  currentUserId,
+  showPayments,
+  onAddPayment,
+  onEditPayment,
+  onPaymentDeleteSuccess,
+  onPaymentDeleteError,
+  onNavigateRelation,
+  showFurs,
+  fursFiscalizationData,
+  showFina,
+  finaFiscalizationData,
+  onRetryFiscalization,
+  isRetryingFiscalization,
+  ...i18nProps
+}: DocumentSidebarProps) {
+  const documentRelations = (document as unknown as { document_relations?: DocumentRelation[] }).document_relations;
+  const hasRelations = documentRelations && documentRelations.length > 0;
+
+  return (
+    <Card size="sm">
+      <CardContent className="space-y-5">
+        <DocumentDetailsCard
+          variant="inline"
+          document={document}
+          documentType={documentType}
+          locale={locale}
+          {...i18nProps}
+        />
+
+        {showPayments && (
+          <>
+            <Separator />
+            <DocumentPaymentsList
+              variant="inline"
+              documentId={document.id}
+              documentType={documentType as "invoice" | "credit_note" | "advance_invoice"}
+              entityId={entityId}
+              currencyCode={document.currency_code}
+              locale={locale}
+              onAddPayment={onAddPayment}
+              onEditPayment={onEditPayment}
+              onDeleteSuccess={onPaymentDeleteSuccess}
+              onDeleteError={onPaymentDeleteError}
+              {...i18nProps}
+            />
+          </>
+        )}
+
+        {hasRelations && (
+          <>
+            <Separator />
+            <DocumentRelationsList
+              variant="inline"
+              documentId={document.id}
+              documentRelations={documentRelations}
+              locale={locale}
+              onNavigate={onNavigateRelation}
+              {...i18nProps}
+            />
+          </>
+        )}
+
+        <Separator />
+        <DocumentActivitiesList
+          variant="inline"
+          documentId={document.id}
+          entityId={entityId}
+          currentUserId={currentUserId}
+          locale={locale}
+          {...i18nProps}
+        />
+
+        {(showFurs || showFina) && (
+          <>
+            <Separator />
+            {showFurs && (
+              <FiscalizationStatusCard
+                variant="inline"
+                fiscalizationType="furs"
+                fiscalizationData={fursFiscalizationData}
+                onRetry={onRetryFiscalization}
+                isRetrying={isRetryingFiscalization}
+                locale={locale}
+              />
+            )}
+            {showFina && (
+              <FiscalizationStatusCard
+                variant="inline"
+                fiscalizationType="fina"
+                fiscalizationData={finaFiscalizationData}
+                onRetry={onRetryFiscalization}
+                isRetrying={isRetryingFiscalization}
+                locale={locale}
+              />
+            )}
+          </>
+        )}
+      </CardContent>
+    </Card>
+  );
+}

package/src/components/documents/view/index.ts

@@ -2,4 +2,6 @@ export { DocumentActionsBar } from "./document-actions-bar";
 export { DocumentActivitiesList } from "./document-activities-list";
 export { DocumentDetailsCard } from "./document-details-card";
 export { DocumentPaymentsList } from "./document-payments-list";
+export { DocumentRelationsList } from "./document-relations-list";
+export { DocumentSidebar } from "./document-sidebar";
 export { useDocumentDownload } from "./use-document-download";

package/src/components/documents/view/locales/de.ts

@@ -20,10 +20,12 @@ export default {
   "Duplicate estimate": "Angebot duplizieren",
   "Duplicate credit_note": "Gutschrift duplizieren",
   "Duplicate advance_invoice": "Anzahlungsrechnung duplizieren",
+  "Duplicate delivery_note": "Lieferschein duplizieren",
   "Create invoice": "Rechnung erstellen",
   "Create estimate": "Angebot erstellen",
   "Create credit_note": "Gutschrift erstellen",
   "Create advance_invoice": "Anzahlungsrechnung erstellen",
+  "Create delivery_note": "Lieferschein erstellen",
 
   // Details card
   Details: "Details",
@@ -119,4 +121,25 @@ export default {
   Dutch: "Niederländisch",
   Polish: "Polnisch",
   Croatian: "Kroatisch",
+
+  // Linked documents
+  "Linked documents": "Verknüpfte Dokumente",
+  "No linked documents": "Keine verknüpften Dokumente",
+  Invoice: "Rechnung",
+  Estimate: "Angebot",
+  "Credit note": "Gutschrift",
+  "Advance invoice": "Anzahlungsrechnung",
+  "Delivery note": "Lieferschein",
+  "Credit for": "Gutschrift für",
+  "Converted from": "Konvertiert von",
+  "Converted to": "Konvertiert zu",
+  "Has credit": "Hat Gutschrift",
+  "Advance applied": "Anzahlung angewendet",
+  "Applied to": "Angewendet auf",
+  "Delivered for": "Geliefert für",
+  "Has delivery": "Hat Lieferschein",
+  Fulfills: "Erfüllt",
+  "Fulfilled by": "Erfüllt durch",
+  References: "Verweist auf",
+  View: "Ansehen",
 } as const;

package/src/components/documents/view/locales/es.ts

@@ -19,10 +19,12 @@ export default {
   "Duplicate estimate": "Duplicar presupuesto",
   "Duplicate credit_note": "Duplicar nota de crédito",
   "Duplicate advance_invoice": "Duplicar factura anticipada",
+  "Duplicate delivery_note": "Duplicar albarán",
   "Create invoice": "Crear factura",
   "Create estimate": "Crear presupuesto",
   "Create credit_note": "Crear nota de crédito",
   "Create advance_invoice": "Crear factura anticipada",
+  "Create delivery_note": "Crear albarán",
 
   // Details card
   Details: "Detalles",
@@ -117,4 +119,25 @@ export default {
   Dutch: "Neerlandés",
   Polish: "Polaco",
   Croatian: "Croata",
+
+  // Linked documents
+  "Linked documents": "Documentos vinculados",
+  "No linked documents": "Sin documentos vinculados",
+  Invoice: "Factura",
+  Estimate: "Presupuesto",
+  "Credit note": "Nota de crédito",
+  "Advance invoice": "Factura anticipada",
+  "Delivery note": "Albarán",
+  "Credit for": "Crédito para",
+  "Converted from": "Convertido desde",
+  "Converted to": "Convertido a",
+  "Has credit": "Tiene crédito",
+  "Advance applied": "Anticipo aplicado",
+  "Applied to": "Aplicado a",
+  "Delivered for": "Entregado para",
+  "Has delivery": "Tiene albarán",
+  Fulfills: "Cumple",
+  "Fulfilled by": "Cumplido por",
+  References: "Referencia",
+  View: "Ver",
 } as const;

package/src/components/documents/view/locales/fr.ts

@@ -19,10 +19,12 @@ export default {
   "Duplicate estimate": "Dupliquer le devis",
   "Duplicate credit_note": "Dupliquer l'avoir",
   "Duplicate advance_invoice": "Dupliquer la facture d'acompte",
+  "Duplicate delivery_note": "Dupliquer le bon de livraison",
   "Create invoice": "Créer une facture",
   "Create estimate": "Créer un devis",
   "Create credit_note": "Créer un avoir",
   "Create advance_invoice": "Créer une facture d'acompte",
+  "Create delivery_note": "Créer un bon de livraison",
 
   // Details card
   Details: "Détails",
@@ -117,4 +119,25 @@ export default {
   Dutch: "Néerlandais",
   Polish: "Polonais",
   Croatian: "Croate",
+
+  // Linked documents
+  "Linked documents": "Documents liés",
+  "No linked documents": "Aucun document lié",
+  Invoice: "Facture",
+  Estimate: "Devis",
+  "Credit note": "Avoir",
+  "Advance invoice": "Facture d'acompte",
+  "Delivery note": "Bon de livraison",
+  "Credit for": "Avoir pour",
+  "Converted from": "Converti depuis",
+  "Converted to": "Converti en",
+  "Has credit": "A un avoir",
+  "Advance applied": "Acompte appliqué",
+  "Applied to": "Appliqué à",
+  "Delivered for": "Livré pour",
+  "Has delivery": "A un bon de livraison",
+  Fulfills: "Remplit",
+  "Fulfilled by": "Rempli par",
+  References: "Référence",
+  View: "Voir",
 } as const;

package/src/components/documents/view/locales/hr.ts

@@ -19,10 +19,12 @@ export default {
   "Duplicate estimate": "Dupliciraj ponudu",
   "Duplicate credit_note": "Dupliciraj knjižno odobrenje",
   "Duplicate advance_invoice": "Dupliciraj avansni račun",
+  "Duplicate delivery_note": "Dupliciraj otpremnicu",
   "Create invoice": "Stvori račun",
   "Create estimate": "Stvori ponudu",
   "Create credit_note": "Stvori knjižno odobrenje",
   "Create advance_invoice": "Stvori avansni račun",
+  "Create delivery_note": "Stvori otpremnicu",
 
   // Details card
   Details: "Pojedinosti",
@@ -117,4 +119,25 @@ export default {
   Dutch: "Nizozemski",
   Polish: "Poljski",
   Croatian: "Hrvatski",
+
+  // Linked documents
+  "Linked documents": "Povezani dokumenti",
+  "No linked documents": "Nema povezanih dokumenata",
+  Invoice: "Račun",
+  Estimate: "Ponuda",
+  "Credit note": "Knjižno odobrenje",
+  "Advance invoice": "Avansni račun",
+  "Delivery note": "Otpremnica",
+  "Credit for": "Odobrenje za",
+  "Converted from": "Pretvoreno iz",
+  "Converted to": "Pretvoreno u",
+  "Has credit": "Ima odobrenje",
+  "Advance applied": "Avans primijenjen",
+  "Applied to": "Primijenjeno na",
+  "Delivered for": "Dostavljeno za",
+  "Has delivery": "Ima otpremnicu",
+  Fulfills: "Ispunjava",
+  "Fulfilled by": "Ispunjeno od",
+  References: "Upućuje na",
+  View: "Pogledaj",
 } as const;

package/src/components/documents/view/locales/it.ts

@@ -19,10 +19,12 @@ export default {
   "Duplicate estimate": "Duplica preventivo",
   "Duplicate credit_note": "Duplica nota di credito",
   "Duplicate advance_invoice": "Duplica fattura di acconto",
+  "Duplicate delivery_note": "Duplica bolla di consegna",
   "Create invoice": "Crea fattura",
   "Create estimate": "Crea preventivo",
   "Create credit_note": "Crea nota di credito",
   "Create advance_invoice": "Crea fattura di acconto",
+  "Create delivery_note": "Crea bolla di consegna",
 
   // Details card
   Details: "Dettagli",
@@ -117,4 +119,25 @@ export default {
   Dutch: "Olandese",
   Polish: "Polacco",
   Croatian: "Croato",
+
+  // Linked documents
+  "Linked documents": "Documenti collegati",
+  "No linked documents": "Nessun documento collegato",
+  Invoice: "Fattura",
+  Estimate: "Preventivo",
+  "Credit note": "Nota di credito",
+  "Advance invoice": "Fattura di acconto",
+  "Delivery note": "Bolla di consegna",
+  "Credit for": "Credito per",
+  "Converted from": "Convertito da",
+  "Converted to": "Convertito in",
+  "Has credit": "Ha credito",
+  "Advance applied": "Acconto applicato",
+  "Applied to": "Applicato a",
+  "Delivered for": "Consegnato per",
+  "Has delivery": "Ha bolla di consegna",
+  Fulfills: "Adempie",
+  "Fulfilled by": "Adempiuto da",
+  References: "Riferisce a",
+  View: "Visualizza",
 } as const;

package/src/components/documents/view/locales/nl.ts

@@ -19,10 +19,12 @@ export default {
   "Duplicate estimate": "Offerte dupliceren",
   "Duplicate credit_note": "Creditnota dupliceren",
   "Duplicate advance_invoice": "Voorschotfactuur dupliceren",
+  "Duplicate delivery_note": "Afleverbon dupliceren",
   "Create invoice": "Factuur aanmaken",
   "Create estimate": "Offerte aanmaken",
   "Create credit_note": "Creditnota aanmaken",
   "Create advance_invoice": "Voorschotfactuur aanmaken",
+  "Create delivery_note": "Afleverbon aanmaken",
 
   // Details card
   Details: "Details",
@@ -118,4 +120,25 @@ export default {
   Dutch: "Nederlands",
   Polish: "Pools",
   Croatian: "Kroatisch",
+
+  // Linked documents
+  "Linked documents": "Gekoppelde documenten",
+  "No linked documents": "Geen gekoppelde documenten",
+  Invoice: "Factuur",
+  Estimate: "Offerte",
+  "Credit note": "Creditnota",
+  "Advance invoice": "Voorschotfactuur",
+  "Delivery note": "Afleverbon",
+  "Credit for": "Creditering voor",
+  "Converted from": "Geconverteerd van",
+  "Converted to": "Geconverteerd naar",
+  "Has credit": "Heeft creditering",
+  "Advance applied": "Voorschot toegepast",
+  "Applied to": "Toegepast op",
+  "Delivered for": "Geleverd voor",
+  "Has delivery": "Heeft afleverbon",
+  Fulfills: "Vervult",
+  "Fulfilled by": "Vervuld door",
+  References: "Verwijst naar",
+  View: "Bekijken",
 } as const;

package/src/components/documents/view/locales/pl.ts

@@ -19,10 +19,12 @@ export default {
   "Duplicate estimate": "Duplikuj kosztorys",
   "Duplicate credit_note": "Duplikuj notę kredytową",
   "Duplicate advance_invoice": "Duplikuj fakturę zaliczkową",
+  "Duplicate delivery_note": "Duplikuj dowód dostawy",
   "Create invoice": "Utwórz fakturę",
   "Create estimate": "Utwórz kosztorys",
   "Create credit_note": "Utwórz notę kredytową",
   "Create advance_invoice": "Utwórz fakturę zaliczkową",
+  "Create delivery_note": "Utwórz dowód dostawy",
 
   // Details card
   Details: "Szczegóły",
@@ -117,4 +119,25 @@ export default {
   Dutch: "Niderlandzki",
   Polish: "Polski",
   Croatian: "Chorwacki",
+
+  // Linked documents
+  "Linked documents": "Powiązane dokumenty",
+  "No linked documents": "Brak powiązanych dokumentów",
+  Invoice: "Faktura",
+  Estimate: "Kosztorys",
+  "Credit note": "Nota kredytowa",
+  "Advance invoice": "Faktura zaliczkowa",
+  "Delivery note": "Dowód dostawy",
+  "Credit for": "Kredyt dla",
+  "Converted from": "Przekonwertowano z",
+  "Converted to": "Przekonwertowano na",
+  "Has credit": "Ma kredyt",
+  "Advance applied": "Zaliczka zastosowana",
+  "Applied to": "Zastosowano do",
+  "Delivered for": "Dostarczone dla",
+  "Has delivery": "Ma dowód dostawy",
+  Fulfills: "Realizuje",
+  "Fulfilled by": "Zrealizowano przez",
+  References: "Odnosi się do",
+  View: "Zobacz",
 } as const;

package/src/components/documents/view/locales/pt.ts

@@ -19,10 +19,12 @@ export default {
   "Duplicate estimate": "Duplicar orçamento",
   "Duplicate credit_note": "Duplicar nota de crédito",
   "Duplicate advance_invoice": "Duplicar fatura antecipada",
+  "Duplicate delivery_note": "Duplicar guia de remessa",
   "Create invoice": "Criar fatura",
   "Create estimate": "Criar orçamento",
   "Create credit_note": "Criar nota de crédito",
   "Create advance_invoice": "Criar fatura antecipada",
+  "Create delivery_note": "Criar guia de remessa",
 
   // Details card
   Details: "Detalhes",
@@ -117,4 +119,25 @@ export default {
   Dutch: "Neerlandês",
   Polish: "Polaco",
   Croatian: "Croata",
+
+  // Linked documents
+  "Linked documents": "Documentos vinculados",
+  "No linked documents": "Sem documentos vinculados",
+  Invoice: "Fatura",
+  Estimate: "Orçamento",
+  "Credit note": "Nota de crédito",
+  "Advance invoice": "Fatura antecipada",
+  "Delivery note": "Guia de remessa",
+  "Credit for": "Crédito para",
+  "Converted from": "Convertido de",
+  "Converted to": "Convertido para",
+  "Has credit": "Tem crédito",
+  "Advance applied": "Adiantamento aplicado",
+  "Applied to": "Aplicado a",
+  "Delivered for": "Entregue para",
+  "Has delivery": "Tem guia de remessa",
+  Fulfills: "Cumpre",
+  "Fulfilled by": "Cumprido por",
+  References: "Referência",
+  View: "Ver",
 } as const;

package/src/components/documents/view/locales/sl.ts

@@ -19,10 +19,12 @@ export default {
   "Duplicate estimate": "Podvoji predračun",
   "Duplicate credit_note": "Podvoji dobropis",
   "Duplicate advance_invoice": "Podvoji avansni račun",
+  "Duplicate delivery_note": "Podvoji dobavnico",
   "Create invoice": "Ustvari račun",
   "Create estimate": "Ustvari predračun",
   "Create credit_note": "Ustvari dobropis",
   "Create advance_invoice": "Ustvari avansni račun",
+  "Create delivery_note": "Ustvari dobavnico",
 
   // Details card
   Details: "Podrobnosti",
@@ -118,4 +120,25 @@ export default {
   Dutch: "Nizozemščina",
   Polish: "Poljščina",
   Croatian: "Hrvaščina",
+
+  // Linked documents
+  "Linked documents": "Povezani dokumenti",
+  "No linked documents": "Ni povezanih dokumentov",
+  Invoice: "Račun",
+  Estimate: "Predračun",
+  "Credit note": "Dobropis",
+  "Advance invoice": "Avansni račun",
+  "Delivery note": "Dobavnica",
+  "Credit for": "Dobropis za",
+  "Converted from": "Pretvorjeno iz",
+  "Converted to": "Pretvorjeno v",
+  "Has credit": "Ima dobropis",
+  "Advance applied": "Avans uporabljen",
+  "Applied to": "Uporabljen za",
+  "Delivered for": "Dostavljeno za",
+  "Has delivery": "Ima dobavnico",
+  Fulfills: "Izpolnjuje",
+  "Fulfilled by": "Izpolnjeno z",
+  References: "Sklicuje se na",
+  View: "Poglej",
 } as const;

package/src/components/documents/view/use-document-download.ts

@@ -1,10 +1,10 @@
-import type { AdvanceInvoice, CreditNote, Estimate, Invoice } from "@spaceinvoices/js-sdk";
+import type { AdvanceInvoice, CreditNote, DeliveryNote, Estimate, Invoice } from "@spaceinvoices/js-sdk";
 import { useState } from "react";
 import { useEntities } from "@/ui/providers/entities-context";
 import { useSDK } from "@/ui/providers/sdk-provider";
 
-type Document = Invoice | Estimate | CreditNote | AdvanceInvoice;
-type DocumentType = "invoice" | "estimate" | "credit_note" | "advance_invoice";
+type Document = Invoice | Estimate | CreditNote | AdvanceInvoice | DeliveryNote;
+type DocumentType = "invoice" | "estimate" | "credit_note" | "advance_invoice" | "delivery_note";
 
 // Document type labels for PDF filename
 const TYPE_LABELS: Record<string, string> = {
@@ -12,6 +12,7 @@ const TYPE_LABELS: Record<string, string> = {
   estimate: "Estimate",
   credit_note: "Credit Note",
   advance_invoice: "Advance Invoice",
+  delivery_note: "Delivery Note",
 };
 
 interface UseDocumentDownloadOptions {
@@ -37,7 +38,7 @@ export function useDocumentDownload({
   /**
    * Download PDF in specified locale
    */
-  const downloadPdf = async (document: Document, documentType: DocumentType, _locale: string) => {
+  const downloadPdf = async (document: Document, documentType: DocumentType, locale: string) => {
     if (!sdk || !activeEntity?.id) {
       onDownloadError?.("Download failed");
       return;
@@ -50,7 +51,8 @@ export function useDocumentDownload({
       // SDK signature: renderPdf(id, params?, SDKMethodOptions?)
       // entity_id goes in SDKMethodOptions (last arg), not params
       // Note: renderPdf is on invoices module but works with any document ID via /documents/{id}/pdf
-      const blob = await sdk.invoices.renderPdf(document.id, {}, { entity_id: activeEntity.id });
+      const params = locale ? { locale } : {};
+      const blob = await sdk.invoices.renderPdf(document.id, params, { entity_id: activeEntity.id });
       const downloadUrl = window.URL.createObjectURL(blob);
       const link = window.document.createElement("a");
       link.href = downloadUrl;
@@ -90,6 +92,7 @@ export function useDocumentDownload({
         advance_invoice: "advance_invoice",
         credit_note: "credit_note",
         estimate: "estimate",
+        delivery_note: "delivery_note",
       };
 
       // e-SLOG download - cast to any since the SDK structure may vary