@tuturuuu/ui 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.11.0](https://github.com/tutur3u/platform/compare/ui-v0.10.0...ui-v0.11.0) (2026-06-29)
+
+
+### Features
+
+* **finance:** support prepaid subscription invoice ranges ([fa0f338](https://github.com/tutur3u/platform/commit/fa0f3388dfb3d3ea539a8d8bdc3f100f268542c6))
+* **tasks:** add board header loading skeleton ([73f1242](https://github.com/tutur3u/platform/commit/73f12421a9cd50c035a1c9940e152354b1974f26))
+* **tasks:** add task templates ([8d0700a](https://github.com/tutur3u/platform/commit/8d0700ad255c7b5874bfa065575df6b1cde34063))
+
+
+### Bug Fixes
+
+* **tasks:** pad board header skeleton ([b0c5c0f](https://github.com/tutur3u/platform/commit/b0c5c0fea8871cac2603da6239b980c752b1c9f6))
+* **tasks:** prevent description wipes during yjs hydration ([947f38c](https://github.com/tutur3u/platform/commit/947f38c6474d07b1fac1c44e166638bfc87260c0))
+* **tasks:** restore tracked task descriptions ([f892ae2](https://github.com/tutur3u/platform/commit/f892ae23dfec41c2d25649b97a628d8cdcd1fa5d))
+
 ## [0.10.0](https://github.com/tutur3u/platform/compare/ui-v0.9.0...ui-v0.10.0) (2026-06-26)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuturuuu/ui",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -88,9 +88,9 @@
     "@tuturuuu/apis": "0.7.0",
     "@tuturuuu/hooks": "0.0.2",
     "@tuturuuu/icons": "0.0.6",
-    "@tuturuuu/internal-api": "0.11.0",
+    "@tuturuuu/internal-api": "0.12.0",
     "@tuturuuu/supabase": "0.4.0",
-    "@tuturuuu/utils": "0.10.0",
+    "@tuturuuu/utils": "0.11.0",
     "@types/debug": "^4.1.13",
     "browser-image-compression": "^2.0.2",
     "class-variance-authority": "^0.7.1",
@@ -149,7 +149,7 @@
     "@tanstack/react-table": "^8.21.3",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
-    "@tuturuuu/types": "0.12.0",
+    "@tuturuuu/types": "0.13.0",
     "@tuturuuu/typescript-config": "0.1.1",
     "@types/html2canvas": "^1.0.0",
     "@types/lodash": "^4.17.24",

package/src/components/ui/finance/invoices/components/subscription-attendance-summary.tsx

@@ -54,6 +54,8 @@ interface SubscriptionAttendanceSummaryProps {
   };
   totalSessions: number;
   attendanceRate: number;
+  coverageRangeLabel: string;
+  prepaidMonthCount: number;
 }
 
 export function SubscriptionAttendanceSummary({
@@ -73,6 +75,8 @@ export function SubscriptionAttendanceSummary({
   attendanceStats,
   totalSessions,
   attendanceRate,
+  coverageRangeLabel,
+  prepaidMonthCount,
 }: SubscriptionAttendanceSummaryProps): React.ReactElement {
   const t = useTranslations();
 
@@ -82,6 +86,8 @@ export function SubscriptionAttendanceSummary({
     ? selectedMonth
     : (availableMonths[0]?.value ?? selectedMonth);
   const monthLabel = formatMonthLabel(resolvedSelectedMonth, locale);
+  const displayedRangeLabel =
+    prepaidMonthCount > 1 ? coverageRangeLabel : monthLabel;
 
   return (
     <Card>
@@ -98,17 +104,25 @@ export function SubscriptionAttendanceSummary({
           <CardDescription className="flex flex-col gap-1">
             {selectedGroupIds.length === 1
               ? t('ws-invoices.attendance_for_month', {
-                  month: monthLabel,
+                  month: displayedRangeLabel,
                 })
               : t('ws-invoices.combined_attendance_for_month', {
                   count: selectedGroupIds.length,
-                  month: monthLabel,
-                  default: `Combined attendance from ${selectedGroupIds.length} groups for ${monthLabel}`,
+                  month: displayedRangeLabel,
+                  default: `Combined attendance from ${selectedGroupIds.length} groups for ${displayedRangeLabel}`,
                 })}
             <span className="text-muted-foreground text-xs">
               {isSelectedMonthPaid
-                ? t('ws-invoices.all_groups_paid_for_month')
-                : t('ws-invoices.some_groups_unpaid_for_month')}
+                ? t(
+                    prepaidMonthCount > 1
+                      ? 'ws-invoices.all_groups_paid_for_range'
+                      : 'ws-invoices.all_groups_paid_for_month'
+                  )
+                : t(
+                    prepaidMonthCount > 1
+                      ? 'ws-invoices.some_groups_unpaid_for_range'
+                      : 'ws-invoices.some_groups_unpaid_for_month'
+                  )}
             </span>
           </CardDescription>
         </div>

package/src/components/ui/finance/invoices/components/subscription-prepaid-controls.test.tsx

@@ -0,0 +1,41 @@
+import { render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+import { SubscriptionPrepaidControls } from './subscription-prepaid-controls';
+
+vi.mock('next-intl', () => ({
+  useTranslations: () => (key: string, values?: Record<string, unknown>) => {
+    const messages: Record<string, string> = {
+      'ws-invoices.coverage_range': 'Coverage',
+      'ws-invoices.prepaid_month_count': 'Months to cover',
+      'ws-invoices.prepaid_month_count_many': '{count} months',
+      'ws-invoices.prepaid_month_count_one': '1 month',
+      'ws-invoices.prepaid_months': 'Prepaid months',
+      'ws-invoices.prepaid_months_description':
+        'Choose how many months this subscription invoice should cover.',
+      'ws-invoices.valid_until': 'Valid until',
+    };
+
+    return (messages[key] ?? key).replace(
+      '{count}',
+      String(values?.count ?? '')
+    );
+  },
+}));
+
+describe('SubscriptionPrepaidControls', () => {
+  it('renders the prepaid count selector and coverage summary', () => {
+    render(
+      <SubscriptionPrepaidControls
+        coverageRangeLabel="June 2026 - August 2026"
+        prepaidMonthCount={3}
+        validUntilLabel="September 2026"
+        onPrepaidMonthCountChange={vi.fn()}
+      />
+    );
+
+    expect(screen.getByText('Prepaid months')).toBeInTheDocument();
+    expect(screen.getByText('Months to cover')).toBeInTheDocument();
+    expect(screen.getByText('June 2026 - August 2026')).toBeInTheDocument();
+    expect(screen.getByText('September 2026')).toBeInTheDocument();
+  });
+});

package/src/components/ui/finance/invoices/components/subscription-prepaid-controls.tsx

@@ -0,0 +1,93 @@
+'use client';
+
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from '@tuturuuu/ui/card';
+import { Label } from '@tuturuuu/ui/label';
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from '@tuturuuu/ui/select';
+import { useTranslations } from 'next-intl';
+import type React from 'react';
+import { MAX_PREPAID_MONTH_COUNT } from '../utils';
+
+interface SubscriptionPrepaidControlsProps {
+  coverageRangeLabel: string;
+  onPrepaidMonthCountChange: (monthCount: number) => void;
+  prepaidMonthCount: number;
+  validUntilLabel: string;
+}
+
+const PREPAID_MONTH_OPTIONS = Array.from(
+  { length: MAX_PREPAID_MONTH_COUNT },
+  (_, index) => index + 1
+);
+
+export function SubscriptionPrepaidControls({
+  coverageRangeLabel,
+  onPrepaidMonthCountChange,
+  prepaidMonthCount,
+  validUntilLabel,
+}: SubscriptionPrepaidControlsProps): React.ReactElement {
+  const t = useTranslations();
+
+  return (
+    <Card>
+      <CardHeader>
+        <CardTitle>{t('ws-invoices.prepaid_months')}</CardTitle>
+        <CardDescription>
+          {t('ws-invoices.prepaid_months_description')}
+        </CardDescription>
+      </CardHeader>
+      <CardContent className="space-y-4">
+        <div className="space-y-2">
+          <Label htmlFor="prepaid-month-count">
+            {t('ws-invoices.prepaid_month_count')}
+          </Label>
+          <Select
+            value={String(prepaidMonthCount)}
+            onValueChange={(value) => onPrepaidMonthCountChange(Number(value))}
+          >
+            <SelectTrigger id="prepaid-month-count">
+              <SelectValue />
+            </SelectTrigger>
+            <SelectContent>
+              {PREPAID_MONTH_OPTIONS.map((monthCount) => (
+                <SelectItem key={monthCount} value={String(monthCount)}>
+                  {monthCount === 1
+                    ? t('ws-invoices.prepaid_month_count_one')
+                    : t('ws-invoices.prepaid_month_count_many', {
+                        count: monthCount,
+                      })}
+                </SelectItem>
+              ))}
+            </SelectContent>
+          </Select>
+        </div>
+
+        <div className="grid gap-3 rounded-lg border bg-muted/30 p-3 text-sm">
+          <div className="flex items-center justify-between gap-3">
+            <span className="text-muted-foreground">
+              {t('ws-invoices.coverage_range')}
+            </span>
+            <span className="text-right font-medium">{coverageRangeLabel}</span>
+          </div>
+          <div className="flex items-center justify-between gap-3">
+            <span className="text-muted-foreground">
+              {t('ws-invoices.valid_until')}
+            </span>
+            <span className="text-right font-medium">{validUntilLabel}</span>
+          </div>
+        </div>
+      </CardContent>
+    </Card>
+  );
+}

package/src/components/ui/finance/invoices/hooks/use-subscription-auto-selection.ts

@@ -16,14 +16,9 @@ import type {
 } from '../types';
 import type { UserGroup } from '../utils';
 import {
-  getEffectiveAttendanceDays,
+  getBillableQuantityMapForGroupsRange,
   getEffectiveDays,
-  getSessionsForMonth,
-  getSessionsUntilMonth,
-  getSubscriptionCoverageInvoiceForGroup,
   getTotalSessionsForGroups,
-  isSubscriptionMonthPaidForGroup,
-  parseLocalCalendarDate,
 } from '../utils';
 
 interface UseSubscriptionAutoSelectionProps {
@@ -42,6 +37,7 @@ interface UseSubscriptionAutoSelectionProps {
     created_at?: string | null;
   }[];
   onSelectedProductsChange: Dispatch<SetStateAction<SelectedProductItem[]>>;
+  prepaidMonthCount?: number;
 }
 
 export type UseSubscriptionAutoSelectionResult = undefined;
@@ -165,54 +161,59 @@ const computeGroupAttendanceDaysMap = (
   }[],
   selectedMonth: string,
   userAttendance: { status: string; date: string; group_id?: string }[],
-  useAttendanceBased: boolean
+  useAttendanceBased: boolean,
+  prepaidMonthCount = 1
 ) => {
-  const groupAttendanceDaysMap: Record<string, number> = {};
-
-  for (const groupId of selectedGroupIds) {
-    const group = userGroups.find(
-      (g) => g.workspace_user_groups?.id === groupId
-    );
-    if (!group) continue;
-
-    const latestInvoice = getSubscriptionCoverageInvoiceForGroup(
-      latestSubscriptionInvoices,
-      groupId
-    );
-    const validUntil = latestInvoice?.valid_until
-      ? parseLocalCalendarDate(latestInvoice.valid_until)
-      : null;
+  return getBillableQuantityMapForGroupsRange({
+    groupIds: selectedGroupIds,
+    latestInvoices: latestSubscriptionInvoices,
+    prepaidMonthCount,
+    selectedMonth,
+    useAttendanceBased,
+    userAttendance,
+    userGroups,
+  });
+};
 
-    const isGroupPaid = isSubscriptionMonthPaidForGroup(
-      groupId,
-      selectedMonth,
-      latestSubscriptionInvoices
-    );
+const sumQuantityMap = (quantityMap: Record<string, number>) =>
+  Object.values(quantityMap).reduce((total, value) => total + value, 0);
 
-    const sessionsArray = group.workspace_user_groups?.sessions || [];
-    const groupSessions = isGroupPaid
-      ? 0
-      : validUntil
-        ? getSessionsUntilMonth(sessionsArray, selectedMonth, validUntil)
-        : getSessionsForMonth(sessionsArray, selectedMonth);
-
-    if (useAttendanceBased) {
-      const groupAttendance = isGroupPaid
-        ? []
-        : userAttendance.filter((a) => {
-            if (a.group_id !== groupId) return false;
-            if (!validUntil) return true;
-            const attendanceDate = parseLocalCalendarDate(a.date);
-            return attendanceDate >= validUntil;
-          });
-      groupAttendanceDaysMap[groupId] =
-        getEffectiveAttendanceDays(groupAttendance);
-    } else {
-      groupAttendanceDaysMap[groupId] = groupSessions;
-    }
+const computeFallbackAttendanceDays = ({
+  groupAttendanceDaysMap,
+  latestSubscriptionInvoices,
+  prepaidMonthCount,
+  selectedGroupIds,
+  selectedMonth,
+  useAttendanceBased,
+  userAttendance,
+  userGroups,
+}: {
+  groupAttendanceDaysMap: Record<string, number>;
+  latestSubscriptionInvoices: {
+    group_id?: string;
+    valid_until?: string | null;
+    created_at?: string | null;
+  }[];
+  prepaidMonthCount: number;
+  selectedGroupIds: string[];
+  selectedMonth: string;
+  useAttendanceBased: boolean;
+  userAttendance: { status: string; date: string; group_id?: string }[];
+  userGroups: UserGroup[];
+}): number => {
+  const mappedQuantity = sumQuantityMap(groupAttendanceDaysMap);
+  if (mappedQuantity > 0 || prepaidMonthCount > 1) {
+    return mappedQuantity;
   }
 
-  return groupAttendanceDaysMap;
+  const totalSessions = getTotalSessionsForGroups(
+    userGroups,
+    selectedGroupIds,
+    selectedMonth,
+    latestSubscriptionInvoices
+  );
+
+  return getEffectiveDays(userAttendance, totalSessions, useAttendanceBased);
 };
 
 export function useSubscriptionAutoSelection({
@@ -227,6 +228,7 @@ export function useSubscriptionAutoSelection({
   userAttendance,
   latestSubscriptionInvoices,
   onSelectedProductsChange,
+  prepaidMonthCount = 1,
 }: UseSubscriptionAutoSelectionProps): UseSubscriptionAutoSelectionResult {
   const t = useTranslations();
   const previousGroupIdRef = useRef<string>('');
@@ -248,7 +250,8 @@ export function useSubscriptionAutoSelection({
         latestSubscriptionInvoices,
         selectedMonth,
         userAttendance,
-        useAttendanceBased
+        useAttendanceBased,
+        prepaidMonthCount
       ),
     [
       sortedSelectedGroupIds,
@@ -257,6 +260,7 @@ export function useSubscriptionAutoSelection({
       selectedMonth,
       userAttendance,
       useAttendanceBased,
+      prepaidMonthCount,
     ]
   );
 
@@ -307,18 +311,22 @@ export function useSubscriptionAutoSelection({
 
     fallbackToastShownRef.current = false;
 
-    const totalSessions = getTotalSessionsForGroups(
-      userGroups,
-      sortedSelectedGroupIds,
-      selectedMonth,
-      latestSubscriptionInvoices
-    );
-
     const shouldUsePrefill =
-      prefillAmount != null && !initialPrefillUsedRef.current;
+      prepaidMonthCount === 1 &&
+      prefillAmount != null &&
+      !initialPrefillUsedRef.current;
     const attendanceDays = shouldUsePrefill
       ? prefillAmount
-      : getEffectiveDays(userAttendance, totalSessions, useAttendanceBased);
+      : computeFallbackAttendanceDays({
+          groupAttendanceDaysMap,
+          latestSubscriptionInvoices,
+          prepaidMonthCount,
+          selectedGroupIds: sortedSelectedGroupIds,
+          selectedMonth,
+          useAttendanceBased,
+          userAttendance,
+          userGroups,
+        });
 
     updateSelectedProducts(
       attendanceDays,
@@ -340,6 +348,7 @@ export function useSubscriptionAutoSelection({
     latestSubscriptionInvoices,
     updateSelectedProducts,
     groupAttendanceDaysMap,
+    prepaidMonthCount,
   ]);
 
   // Auto-add group products based on attendance when group is selected
@@ -352,22 +361,24 @@ export function useSubscriptionAutoSelection({
       return;
     }
 
-    if (prefillAmount != null && !initialPrefillUsedRef.current) {
+    if (
+      prepaidMonthCount === 1 &&
+      prefillAmount != null &&
+      !initialPrefillUsedRef.current
+    ) {
       return;
     }
 
-    const totalSessions = getTotalSessionsForGroups(
-      userGroups,
-      sortedSelectedGroupIds,
+    const attendanceDays = computeFallbackAttendanceDays({
+      groupAttendanceDaysMap,
+      latestSubscriptionInvoices,
+      prepaidMonthCount,
+      selectedGroupIds: sortedSelectedGroupIds,
       selectedMonth,
-      latestSubscriptionInvoices
-    );
-
-    const attendanceDays = getEffectiveDays(
+      useAttendanceBased,
       userAttendance,
-      totalSessions,
-      useAttendanceBased
-    );
+      userGroups,
+    });
 
     if (attendanceDays === 0) return;
 
@@ -409,5 +420,6 @@ export function useSubscriptionAutoSelection({
     onSelectedProductsChange,
     products,
     groupAttendanceDaysMap,
+    prepaidMonthCount,
   ]);
 }

package/src/components/ui/finance/invoices/hooks/use-subscription-invoice-content.ts

@@ -3,11 +3,15 @@ import { useEffect, useRef } from 'react';
 import type { SelectedProductItem, UserGroupProducts } from '../types';
 import type { UserGroup } from '../utils';
 import {
+  formatCoverageRangeLabel,
   formatMonthLabel,
   getAttendanceStats,
+  getBillableAttendanceRecordsInRange,
+  getBillableSessionsForGroupsInRange,
+  getCoverageEndMonthValue,
+  getCoverageMonths,
   getSubscriptionCoverageInvoiceForGroup,
-  getTotalSessionsForGroups,
-  parseLocalCalendarDate,
+  isSubscriptionMonthPaidForGroup,
 } from '../utils';
 
 interface UseSubscriptionInvoiceContentProps {
@@ -26,6 +30,7 @@ interface UseSubscriptionInvoiceContentProps {
   locale: string;
   onContentChange: (content: string) => void;
   onNotesChange: (notes: string) => void;
+  prepaidMonthCount?: number;
 }
 
 export function useSubscriptionInvoiceContent({
@@ -41,6 +46,7 @@ export function useSubscriptionInvoiceContent({
   locale,
   onContentChange,
   onNotesChange,
+  prepaidMonthCount = 1,
 }: UseSubscriptionInvoiceContentProps): void {
   const t = useTranslations();
   const contentCallbackRef = useRef(onContentChange);
@@ -63,7 +69,18 @@ export function useSubscriptionInvoiceContent({
     const formatMonth = (monthStr: string) =>
       formatMonthLabel(monthStr, locale);
 
-    // Group by month ranges
+    const coverageMonths = getCoverageMonths(selectedMonth, prepaidMonthCount);
+    const coverageEndMonth = getCoverageEndMonthValue(
+      selectedMonth,
+      prepaidMonthCount
+    );
+    const fallbackRangeLabel = formatCoverageRangeLabel({
+      locale,
+      prepaidMonthCount,
+      selectedMonth,
+    });
+
+    // Group by unpaid month ranges.
     const rangeToGroups = new Map<string, string[]>();
 
     selectedGroupIds.forEach((groupId) => {
@@ -77,12 +94,21 @@ export function useSubscriptionInvoiceContent({
         latestSubscriptionInvoices,
         groupId
       );
+      const unpaidMonths = coverageMonths.filter(
+        (month) =>
+          !isSubscriptionMonthPaidForGroup(
+            groupId,
+            month,
+            latestSubscriptionInvoices
+          )
+      );
 
-      const startMonth = latestInvoice?.valid_until
-        ? latestInvoice.valid_until.slice(0, 7)
-        : null;
-
-      const endMonth = selectedMonth;
+      const startMonth =
+        unpaidMonths[0] ??
+        latestInvoice?.valid_until?.slice(0, 7) ??
+        selectedMonth;
+      const endMonth =
+        unpaidMonths[unpaidMonths.length - 1] ?? coverageEndMonth;
 
       let rangeLabel = '';
       if (startMonth && startMonth < endMonth) {
@@ -90,7 +116,10 @@ export function useSubscriptionInvoiceContent({
         rangeLabel = `${formatMonth(startMonth)} - ${formatMonth(endMonth)}`;
       } else {
         // Single month
-        rangeLabel = formatMonth(endMonth);
+        rangeLabel =
+          unpaidMonths.length === 0
+            ? fallbackRangeLabel
+            : formatMonth(endMonth);
       }
 
       if (!rangeToGroups.has(rangeLabel)) {
@@ -126,28 +155,23 @@ export function useSubscriptionInvoiceContent({
     }
 
     let autoNotes: string | null = null;
-    if (selectedGroupIds.length > 0 && userAttendance.length > 0) {
-      const filteredAttendance = userAttendance.filter((a) => {
-        const latestInvoice = a.group_id
-          ? getSubscriptionCoverageInvoiceForGroup(
-              latestSubscriptionInvoices,
-              a.group_id
-            )
-          : undefined;
-        if (!latestInvoice?.valid_until) return true;
-        const validUntil = parseLocalCalendarDate(latestInvoice.valid_until);
-        const attendanceDate = parseLocalCalendarDate(a.date);
-        return attendanceDate >= validUntil;
-      });
-
+    if (selectedGroupIds.length > 0) {
+      const filteredAttendance = getBillableAttendanceRecordsInRange(
+        userAttendance,
+        selectedGroupIds,
+        selectedMonth,
+        prepaidMonthCount,
+        latestSubscriptionInvoices
+      );
       const attendanceStats = getAttendanceStats(filteredAttendance);
       const attendanceDays = attendanceStats.present + attendanceStats.late;
-      const totalSessions = getTotalSessionsForGroups(
+      const totalSessions = getBillableSessionsForGroupsInRange(
         userGroups,
         selectedGroupIds,
         selectedMonth,
+        prepaidMonthCount,
         latestSubscriptionInvoices
-      );
+      ).length;
       autoNotes = t('ws-invoices.attendance_summary_note', {
         attended: attendanceDays,
         total: totalSessions,
@@ -192,5 +216,6 @@ export function useSubscriptionInvoiceContent({
     locale,
     t,
     latestSubscriptionInvoices,
+    prepaidMonthCount,
   ]);
 }

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

@@ -501,10 +501,18 @@ export const useSubscriptionInvoiceContext = (
   wsId: string,
   userId: string,
   groupIds: string[],
-  month: string
+  month: string,
+  monthCount = 1
 ) => {
   return useQuery({
-    queryKey: ['subscription-invoice-context', wsId, userId, groupIds, month],
+    queryKey: [
+      'subscription-invoice-context',
+      wsId,
+      userId,
+      groupIds,
+      month,
+      monthCount,
+    ],
     queryFn: async () => {
       if (!wsId || !userId || groupIds.length === 0 || !month) {
         return {
@@ -524,6 +532,7 @@ export const useSubscriptionInvoiceContext = (
       return getSubscriptionInvoiceContext(wsId, {
         groupIds,
         month,
+        monthCount,
         userId,
       });
     },

package/src/components/ui/finance/invoices/internal-api.ts

@@ -61,6 +61,7 @@ export interface CreateInvoicePayload {
 export interface CreateSubscriptionInvoicePayload extends CreateInvoicePayload {
   customer_id: string;
   group_ids: string[];
+  prepaid_month_count?: number;
   selected_month: string;
 }
 
@@ -72,11 +73,15 @@ export interface InvoiceMutationResponse {
       subtotal: number;
       total: number;
     };
+    coverage_end_month?: string;
+    coverage_start_month?: string;
     frontend_values?: {
       discount_amount?: number;
       subtotal?: number;
       total?: number;
     };
+    prepaid_month_count?: number;
+    valid_until?: string;
     values_recalculated?: boolean;
   };
   invoice_id: string;