@spaceinvoices/react-ui 0.4.5 → 0.4.6

package/src/components/invoices/invoices.hooks.ts

@@ -116,8 +116,8 @@ export function setLastUsedFursCombo(entityId: string, combo: FursCombo): void {
 const FINA_LAST_USED_KEY = "hr:fina:last-used";
 
 export type FinaCombo = {
-  premise_id: string;
-  device_id: string;
+  business_premise_name: string;
+  electronic_device_name: string;
 };
 
 export function getLastUsedFinaCombo(entityId: string): FinaCombo | null {

package/src/components/table/table-pagination.tsx

@@ -16,7 +16,7 @@ export function Pagination({ prevCursor, nextCursor, onPageChange }: PaginationP
   const hasNext = Boolean(nextCursor);
 
   return (
-    <div className="flex items-center justify-end space-x-2">
+    <div className="flex items-center justify-start space-x-2">
       <Button
         variant="outline"
         size="sm"

package/src/generated/schemas/advanceinvoice.ts

@@ -96,6 +96,7 @@ const createAdvanceInvoiceSchemaDefinition = z.object({
   ).optional(),
   note: z.union([z.string(), z.null()]).optional(),
   tax_clause: z.union([z.string(), z.null()]).optional(),
+  footer: 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(),
@@ -228,6 +229,7 @@ const updateAdvanceInvoiceSchemaDefinition = z
       )
       .min(1),
     note: z.union([z.string(), z.null()]),
+    footer: z.union([z.string(), z.null()]),
     currency_code: z.string(),
     metadata: z.union([z.object({}).partial().passthrough(), z.null()]),
     change_reason: z.string().max(500),

package/src/generated/schemas/creditnote.ts

@@ -110,6 +110,7 @@ const updateCreditNoteSchemaDefinition = z
       )
       .min(1),
     note: z.union([z.string(), z.null()]),
+    footer: z.union([z.string(), z.null()]),
     payment_terms: z.union([z.string(), z.null()]),
     currency_code: z.string(),
     metadata: z.union([z.object({}).partial().passthrough(), z.null()]),

package/src/generated/schemas/deliverynote.ts

@@ -84,6 +84,7 @@ const createDeliveryNoteSchemaDefinition = z.object({
   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(),
+  footer: 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(),
   hide_prices: z.boolean().optional(),

package/src/generated/schemas/entity.ts

@@ -30,7 +30,7 @@ const createEntitySchemaDefinition = z.object({
   settings: z
     .object({
       pdf_template: z.union([
-        z.enum(["modern", "classic", "minimal", "fashion"]),
+        z.enum(["modern", "classic", "condensed", "minimal", "fashion"]),
         z.null(),
       ]),
       number_formats: z.union([
@@ -90,7 +90,7 @@ const createEntitySchemaDefinition = z.object({
             operator_oib: z.string().min(11).max(11),
             operator_label: z.string(),
             u_sust_pdv: z.boolean().default(true),
-            numbering_sequence: z.enum(["N", "P"]).default("N"),
+            numbering_sequence: z.enum(["N", "P"]).default("P"),
             certificate_expiry: z.string(),
           })
           .partial()
@@ -181,7 +181,7 @@ const patchEntitySchemaDefinition = z
     settings: z
       .object({
         pdf_template: z.union([
-          z.enum(["modern", "classic", "minimal", "fashion"]),
+          z.enum(["modern", "classic", "condensed", "minimal", "fashion"]),
           z.null(),
         ]),
         number_formats: z.union([
@@ -241,7 +241,7 @@ const patchEntitySchemaDefinition = z
               operator_oib: z.string().min(11).max(11),
               operator_label: z.string(),
               u_sust_pdv: z.boolean().default(true),
-              numbering_sequence: z.enum(["N", "P"]).default("N"),
+              numbering_sequence: z.enum(["N", "P"]).default("P"),
               certificate_expiry: z.string(),
             })
             .partial()

package/src/generated/schemas/entityapikey.ts

@@ -0,0 +1,19 @@
+/**
+ * This file was automatically generated using 'bun generate-schemas'.
+ * Do not edit this file manually. To update, run the generator again.
+ * @generated
+ */
+
+import { z } from 'zod';
+
+// Schemas for entityapikey endpoints
+
+// Schema for create entityapikey operation
+const createEntityApiKeySchemaDefinition = z
+  .object({ name: z.string().max(255), ttl: z.number().int().gte(60) })
+  .partial();
+
+// Type for create entityapikey operation
+export type CreateEntityApiKeySchema = z.infer<typeof createEntityApiKeySchemaDefinition>;
+
+export const createEntityApiKeySchema = createEntityApiKeySchemaDefinition;

package/src/generated/schemas/estimate.ts

@@ -86,6 +86,7 @@ const createEstimateSchemaDefinition = z.object({
   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(),
+  footer: 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_valid_till: z.union([z.string(), z.null()]).optional(),
@@ -181,6 +182,7 @@ const updateEstimateSchemaDefinition = z
       )
       .min(1),
     note: z.union([z.string(), z.null()]),
+    footer: z.union([z.string(), z.null()]),
     payment_terms: z.union([z.string(), z.null()]),
     currency_code: z.string(),
     metadata: z.union([z.object({}).partial().passthrough(), z.null()]),

package/src/generated/schemas/index.ts

@@ -16,6 +16,7 @@ export * from './customestimate';
 export * from './custominvoice';
 export * from './deliverynote';
 export * from './entity';
+export * from './entityapikey';
 export * from './entityuserrole';
 export * from './estimate';
 export * from './finasettings';

package/src/generated/schemas/invoice.ts

@@ -97,6 +97,7 @@ const createInvoiceSchemaDefinition = z.object({
   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(),
+  footer: 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(),
@@ -237,6 +238,7 @@ const updateInvoiceSchemaDefinition = z
       )
       .min(1),
     note: z.union([z.string(), z.null()]),
+    footer: z.union([z.string(), z.null()]),
     payment_terms: z.union([z.string(), z.null()]),
     currency_code: z.string(),
     metadata: z.union([z.object({}).partial().passthrough(), z.null()]),

package/src/generated/schemas/renderadvanceinvoicepreview_body.ts

@@ -162,7 +162,7 @@ const CreateDocumentItem = z
     description: z.union([z.string(), z.null()]),
     price: z.number(),
     gross_price: z.number(),
-    quantity: z.union([z.number(), z.null()]),
+    quantity: z.number().gte(-140737488355328).lte(140737488355327),
     unit: z.union([z.string(), z.null()]),
     taxes: z.array(DocumentItemTax),
     discounts: z.array(LineDiscount).max(5),

package/src/generated/schemas/rendercreditnotepreview_body.ts

@@ -163,7 +163,7 @@ const CreateDocumentItem = z
     description: z.union([z.string(), z.null()]),
     price: z.number(),
     gross_price: z.number(),
-    quantity: z.union([z.number(), z.null()]),
+    quantity: z.number().gte(-140737488355328).lte(140737488355327),
     unit: z.union([z.string(), z.null()]),
     taxes: z.array(DocumentItemTax),
     discounts: z.array(LineDiscount).max(5),

package/src/generated/schemas/renderdeliverynotepreview_body.ts

@@ -131,7 +131,7 @@ const CreateDocumentItem = z
     description: z.union([z.string(), z.null()]),
     price: z.number(),
     gross_price: z.number(),
-    quantity: z.union([z.number(), z.null()]),
+    quantity: z.number().gte(-140737488355328).lte(140737488355327),
     unit: z.union([z.string(), z.null()]),
     taxes: z.array(DocumentItemTax),
     discounts: z.array(LineDiscount).max(5),

package/src/generated/schemas/renderestimatepreview_body.ts

@@ -131,7 +131,7 @@ const CreateDocumentItem = z
     description: z.union([z.string(), z.null()]),
     price: z.number(),
     gross_price: z.number(),
-    quantity: z.union([z.number(), z.null()]),
+    quantity: z.number().gte(-140737488355328).lte(140737488355327),
     unit: z.union([z.string(), z.null()]),
     taxes: z.array(DocumentItemTax),
     discounts: z.array(LineDiscount).max(5),

package/src/generated/schemas/renderinvoicepreview_body.ts

@@ -164,7 +164,7 @@ const CreateDocumentItem = z
     description: z.union([z.string(), z.null()]),
     price: z.number(),
     gross_price: z.number(),
-    quantity: z.union([z.number(), z.null()]),
+    quantity: z.number().gte(-140737488355328).lte(140737488355327),
     unit: z.union([z.string(), z.null()]),
     taxes: z.array(DocumentItemTax),
     discounts: z.array(LineDiscount).max(5),

package/src/generated/schemas/startpdfexport_body.ts

@@ -11,7 +11,13 @@ import { z } from 'zod';
 // Dependency schema for startpdfexport_body
 const PdfExportByDocumentIds = z
   .object({
-    type: z.enum(["invoice", "estimate", "credit_note", "advance_invoice"]),
+    type: z.enum([
+      "invoice",
+      "estimate",
+      "credit_note",
+      "advance_invoice",
+      "delivery_note",
+    ]),
     document_ids: z.array(z.string()).min(1),
   })
   .passthrough();
@@ -20,7 +26,13 @@ const PdfExportByDocumentIds = z
 // Dependency schema for startpdfexport_body
 const PdfExportByDateRange = z
   .object({
-    type: z.enum(["invoice", "estimate", "credit_note", "advance_invoice"]),
+    type: z.enum([
+      "invoice",
+      "estimate",
+      "credit_note",
+      "advance_invoice",
+      "delivery_note",
+    ]),
     date_from: z.string().optional(),
     date_to: z.string().optional(),
   })

package/src/generated/schemas/webhook.ts

@@ -49,6 +49,7 @@ const createWebhookSchemaDefinition = z.object({
         "advance_invoice.created",
         "advance_invoice.paid",
         "advance_invoice.applied",
+        "advance_invoice.voided",
         "advance_invoice.deleted",
         "advance_invoice.restored",
         "item.created",
@@ -87,6 +88,7 @@ const createWebhookSchemaDefinition = z.object({
         "delivery_note.created",
         "delivery_note.sent",
         "delivery_note.cancelled",
+        "delivery_note.voided",
         "delivery_note.deleted",
         "delivery_note.restored",
       ])
@@ -142,6 +144,7 @@ const updateWebhookSchemaDefinition = z
           "advance_invoice.created",
           "advance_invoice.paid",
           "advance_invoice.applied",
+          "advance_invoice.voided",
           "advance_invoice.deleted",
           "advance_invoice.restored",
           "item.created",
@@ -180,6 +183,7 @@ const updateWebhookSchemaDefinition = z
           "delivery_note.created",
           "delivery_note.sent",
           "delivery_note.cancelled",
+          "delivery_note.voided",
           "delivery_note.deleted",
           "delivery_note.restored",
         ])

package/src/lib/template-variables.tsx

@@ -0,0 +1,167 @@
+import type { Entity, Estimate, Invoice } from "@spaceinvoices/js-sdk";
+import { cn } from "@/ui/lib/utils";
+
+/**
+ * Convert snake_case variable name to Title Case for display
+ * e.g., "document_number" -> "Document Number", "bank_account.iban" -> "Bank Account Iban"
+ */
+export function formatVariableName(varName: string): string {
+  return varName
+    .replace(/\./g, "_")
+    .split("_")
+    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+    .join(" ");
+}
+
+/**
+ * Resolve a template variable to its actual value from entity/document data.
+ * Returns null if the variable can't be resolved (shown as a placeholder in preview).
+ */
+export function getVariableValue(
+  varName: string,
+  entity?: Entity | null,
+  document?: Partial<Invoice | Estimate> | null,
+): string | null {
+  if (!entity) return null;
+
+  // Entity-related variables
+  if (varName === "entity_name") return entity.name || null;
+  if (varName === "entity_email") return (entity.settings as any)?.email || null;
+  if (varName === "entity_address") return entity.address || null;
+  if (varName === "entity_post_code") return entity.post_code || null;
+  if (varName === "entity_city") return entity.city || null;
+  if (varName === "entity_country") return entity.country || null;
+  if (varName === "entity_tax_number") return entity.tax_number || null;
+  if (varName === "entity_company_number") return entity.company_number || null;
+
+  // Date variables
+  if (varName === "current_date") {
+    return new Date().toLocaleDateString("en-US", { month: "long", day: "numeric", year: "numeric" });
+  }
+  if (varName === "current_year") return new Date().getFullYear().toString();
+
+  // Document-specific variables
+  if (document) {
+    if (varName === "document_number") return (document as any).number || null;
+    if (varName === "document_date" && (document as any).date) {
+      return new Date((document as any).date).toLocaleDateString("en-US", {
+        month: "long",
+        day: "numeric",
+        year: "numeric",
+      });
+    }
+    if (varName === "document_total" && (document as any).total_with_tax) {
+      return new Intl.NumberFormat("en-US", {
+        style: "currency",
+        currency: (document as any).currency_code || "USD",
+      }).format(Number((document as any).total_with_tax));
+    }
+    if (varName === "document_currency") return (document as any).currency_code || null;
+
+    // Invoice due date
+    if ("date_due" in document && varName === "document_due_date") {
+      return document.date_due
+        ? new Date(document.date_due).toLocaleDateString("en-US", {
+            month: "long",
+            day: "numeric",
+            year: "numeric",
+          })
+        : null;
+    }
+
+    // Estimate valid until
+    if ("date_valid_till" in document && varName === "document_valid_until") {
+      return document.date_valid_till
+        ? new Date(document.date_valid_till).toLocaleDateString("en-US", {
+            month: "long",
+            day: "numeric",
+            year: "numeric",
+          })
+        : null;
+    }
+
+    // Customer variables
+    if ((document as any).customer) {
+      if (varName === "customer_name") return (document as any).customer.name || null;
+      if (varName === "customer_email") return (document as any).customer.email || null;
+    }
+  }
+
+  // Bank account variables (from entity settings)
+  const bankAccounts = (entity.settings as any)?.bank_accounts as
+    | Array<{
+        iban?: string;
+        bank_name?: string;
+        bic?: string;
+        account_number?: string;
+        routing_number?: string;
+        sort_code?: string;
+        is_default?: boolean;
+      }>
+    | undefined;
+  const bankAccount = bankAccounts?.find((acc) => acc.is_default) ?? bankAccounts?.[0];
+
+  if (varName === "bank_account" && bankAccount) {
+    const lines: string[] = [];
+    if (bankAccount.bank_name) lines.push(bankAccount.bank_name);
+    if (bankAccount.iban) lines.push(`IBAN: ${bankAccount.iban}`);
+    else if (bankAccount.account_number) lines.push(`Account: ${bankAccount.account_number}`);
+    if (bankAccount.bic) lines.push(`BIC: ${bankAccount.bic}`);
+    return lines.join(", ") || null;
+  }
+  if (varName === "bank_account.iban") return bankAccount?.iban || null;
+  if (varName === "bank_account.bank_name") return bankAccount?.bank_name || null;
+  if (varName === "bank_account.bic") return bankAccount?.bic || null;
+  if (varName === "bank_account.account_number") return bankAccount?.account_number || null;
+
+  return null;
+}
+
+/**
+ * Replace template variables in a string with styled React nodes for preview.
+ * Resolved values get a secondary bg, unresolved show as primary-colored placeholders.
+ */
+export function replaceTemplateVariablesForPreview(
+  template: string,
+  entity?: Entity | null,
+  document?: Partial<Invoice | Estimate> | null,
+): React.ReactNode[] {
+  if (!template) return [];
+
+  const parts: React.ReactNode[] = [];
+  const regex = /\{([^}]+)\}/g;
+  let lastIndex = 0;
+  let match: RegExpExecArray | null = null;
+
+  match = regex.exec(template);
+  while (match !== null) {
+    if (match.index > lastIndex) {
+      parts.push(template.slice(lastIndex, match.index));
+    }
+
+    const varName = match[1];
+    const actualValue = getVariableValue(varName, entity, document);
+    const displayValue = actualValue || formatVariableName(varName);
+
+    parts.push(
+      <span
+        key={match.index}
+        className={cn(
+          "rounded px-1.5 py-0.5 font-medium text-xs",
+          actualValue ? "bg-secondary text-secondary-foreground" : "bg-primary/10 text-primary",
+        )}
+      >
+        {displayValue}
+      </span>,
+    );
+
+    lastIndex = regex.lastIndex;
+    match = regex.exec(template);
+  }
+
+  if (lastIndex < template.length) {
+    parts.push(template.slice(lastIndex));
+  }
+
+  return parts;
+}

package/src/providers/entities-context.tsx

@@ -1,9 +1,9 @@
-import type { GetEntities200DataItem } from "@spaceinvoices/js-sdk";
+import type { Entity as SDKEntity } from "@spaceinvoices/js-sdk";
 
 import { createContext, useContext } from "react";
 
 /** Entity type with country_rules included (from getEntities response) */
-export type Entity = GetEntities200DataItem;
+export type Entity = SDKEntity;
 
 export type EntityEnvironment = "live" | "sandbox";