@firela/api-types 0.0.0-canary.8a8b3972 → 0.0.0-canary.8c68ebbe

package/src/generated/services.gen.ts

@@ -171,6 +171,16 @@ import type {
   PropertyControllerUpdateResponse,
   PropertyControllerDeleteData,
   PropertyControllerDeleteResponse,
+  EventControllerCreateData,
+  EventControllerCreateResponse,
+  EventControllerFindAllData,
+  EventControllerFindAllResponse,
+  EventControllerFindOneData,
+  EventControllerFindOneResponse,
+  EventControllerUpdateData,
+  EventControllerUpdateResponse,
+  EventControllerDeleteData,
+  EventControllerDeleteResponse,
   ExportControllerExportBeancountResponse,
   FileImportControllerImportFileData,
   FileImportControllerImportFileResponse,
@@ -2460,6 +2470,149 @@ export class PropertiesService {
   }
 }
 
+export class LifeEventsService {
+  /**
+   * Create a new life event
+   * Creates a new life event entry for the authenticated user. Returns ETag header carrying the row updatedAt.
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context (decorative for life events)
+   * @param data.requestBody
+   * @returns EventResponseDto Life event created successfully
+   * @throws ApiError
+   */
+  public static eventControllerCreate(
+    data: EventControllerCreateData
+  ): CancelablePromise<EventControllerCreateResponse> {
+    return __request(OpenAPI, {
+      method: 'POST',
+      url: '/api/v1/{region}/bean/events',
+      path: {
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: 'application/json',
+      errors: {
+        409: 'Life event already exists for this (userId, type, date) combination'
+      }
+    });
+  }
+
+  /**
+   * List user life events
+   * Returns life events for the authenticated user with optional filtering by type, description search, and date range.
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context (decorative for life events)
+   * @param data.type Filter by life event type (exact match)
+   * @param data.q Search term for description (case-insensitive partial match)
+   * @param data.from Filter life events from this date (ISO 8601 format)
+   * @param data.to Filter life events to this date (ISO 8601 format)
+   * @param data.page Page number for pagination (default: 1)
+   * @param data.limit Number of items per page (default: 20, max: 100)
+   * @returns EventListResponseDto Life events retrieved successfully
+   * @throws ApiError
+   */
+  public static eventControllerFindAll(
+    data: EventControllerFindAllData
+  ): CancelablePromise<EventControllerFindAllResponse> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/{region}/bean/events',
+      path: {
+        region: data.region
+      },
+      query: {
+        type: data.type,
+        q: data.q,
+        from: data.from,
+        to: data.to,
+        page: data.page,
+        limit: data.limit
+      }
+    });
+  }
+
+  /**
+   * Get life event by ID
+   * Returns a single life event by its ID. Returns ETag header.
+   * @param data The data for the request.
+   * @param data.id Life event ID
+   * @param data.region Region code for tenant context (decorative for life events)
+   * @returns EventResponseDto Life event retrieved successfully
+   * @throws ApiError
+   */
+  public static eventControllerFindOne(
+    data: EventControllerFindOneData
+  ): CancelablePromise<EventControllerFindOneResponse> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/{region}/bean/events/{id}',
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      errors: {
+        404: 'Life event not found'
+      }
+    });
+  }
+
+  /**
+   * Update a life event
+   * Updates an existing life event. If If-Match header is provided, performs optimistic concurrency check; mismatched updatedAt returns 412.
+   * @param data The data for the request.
+   * @param data.id Life event ID
+   * @param data.region Region code for tenant context (decorative for life events)
+   * @param data.requestBody
+   * @returns EventResponseDto Life event updated successfully
+   * @throws ApiError
+   */
+  public static eventControllerUpdate(
+    data: EventControllerUpdateData
+  ): CancelablePromise<EventControllerUpdateResponse> {
+    return __request(OpenAPI, {
+      method: 'PUT',
+      url: '/api/v1/{region}/bean/events/{id}',
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: 'application/json',
+      errors: {
+        400: 'If-Match header is not a valid ISO 8601 date',
+        404: 'Life event not found',
+        409: 'Updated event conflicts with an existing (userId, type, date) combination',
+        412: 'If-Match precondition failed (updatedAt mismatch)'
+      }
+    });
+  }
+
+  /**
+   * Delete a life event
+   * Deletes a life event entry (hard delete). Returns 204.
+   * @param data The data for the request.
+   * @param data.id Life event ID
+   * @param data.region Region code for tenant context (decorative for life events)
+   * @returns void Life event deleted successfully
+   * @throws ApiError
+   */
+  public static eventControllerDelete(
+    data: EventControllerDeleteData
+  ): CancelablePromise<EventControllerDeleteResponse> {
+    return __request(OpenAPI, {
+      method: 'DELETE',
+      url: '/api/v1/{region}/bean/events/{id}',
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      errors: {
+        404: 'Life event not found'
+      }
+    });
+  }
+}
+
 export class BeanExportService {
   /**
    * Export Beancount ledger as ZIP

package/src/generated/types.gen.ts

@@ -442,6 +442,25 @@ export type CreateTransactionDto = {
  */
 export type flag = '*' | '!';
 
+export type CostDetailDto = {
+  /**
+   * Per-unit cost basis (mirrors engine Cost.number)
+   */
+  number?: string;
+  /**
+   * Cost currency
+   */
+  currency?: string;
+  /**
+   * Lot acquisition date (ISO yyyy-mm-dd)
+   */
+  date?: string;
+  /**
+   * Lot label
+   */
+  label?: string;
+};
+
 export type PostingResponseDto = {
   /**
    * Account name
@@ -455,6 +474,10 @@ export type PostingResponseDto = {
    * Currency
    */
   currency?: string;
+  /**
+   * Booking-resolved cost (mirrors engine Cost). Undefined when the posting has no cost basis.
+   */
+  cost?: CostDetailDto;
 };
 
 export type RecurringSuggestionDto = {
@@ -698,6 +721,10 @@ export type PostingDetailDto = {
    * Cost date
    */
   costDate?: string;
+  /**
+   * Booking-resolved cost (mirrors engine Cost). Undefined when the posting has no cost basis.
+   */
+  cost?: CostDetailDto;
   /**
    * Price amount
    */
@@ -1297,17 +1324,17 @@ export type ResolveResultDto = {
     [key: string]: string;
   };
   /**
-   * Resolution ID for undo
+   * Resolution ID for undo. Absent when the resolver rejected the decision (review stayed PENDING).
    */
-  resolutionId: string;
+  resolutionId?: string;
   /**
    * Whether this decision can be undone
    */
-  canUndo: boolean;
+  canUndo?: boolean;
   /**
    * Deadline for undo (24h from resolution)
    */
-  undoDeadline: string;
+  undoDeadline?: string;
   /**
    * Rule ID if learning was triggered (ACCEPT_AND_LEARN actions). Use this to deep-link to the rule management page.
    */
@@ -3002,6 +3029,96 @@ export type UpdatePropertyDto = {
   value: string;
 };
 
+export type CreateBeanEventDto = {
+  /**
+   * Life event date (ISO 8601)
+   */
+  date: string;
+  /**
+   * Life event type (e.g., "employer", "location", "marital-status") — user-defined, no enum constraint at engine layer
+   */
+  type: string;
+  /**
+   * Life event description. Empty string is a VALID value (distinct from absence).
+   */
+  description: string;
+  /**
+   * Product-side metadata (lives in BeanEvent.meta JSON, never in engine Event fields)
+   */
+  meta?: {
+    [key: string]: unknown;
+  };
+};
+
+export type EventResponseDto = {
+  /**
+   * Unique identifier
+   */
+  id: string;
+  /**
+   * User ID (owner of the life event)
+   */
+  userId: string;
+  /**
+   * Life event date (ISO 8601 format)
+   */
+  date: string;
+  /**
+   * Life event type (user-defined, e.g., "employer", "location")
+   */
+  type: string;
+  /**
+   * Life event description. May be an empty string (a valid value distinct from absence).
+   */
+  description: string;
+  /**
+   * Product-side metadata (free-form JSON)
+   */
+  meta: {
+    [key: string]: unknown;
+  };
+  /**
+   * Creation timestamp
+   */
+  createdAt: string;
+  /**
+   * Last update timestamp. Also emitted as the ETag response header for If-Match optimistic concurrency.
+   */
+  updatedAt: string;
+};
+
+export type EventListResponseDto = {
+  /**
+   * List of life events
+   */
+  items: Array<EventResponseDto>;
+  /**
+   * Total number of life events matching the query
+   */
+  total: number;
+};
+
+export type UpdateBeanEventDto = {
+  /**
+   * Life event date (ISO 8601)
+   */
+  date?: string;
+  /**
+   * Life event type (user-defined)
+   */
+  type?: string;
+  /**
+   * Life event description. Empty string is a VALID value (distinct from absence).
+   */
+  description?: string;
+  /**
+   * Product-side metadata (free-form JSON)
+   */
+  meta?: {
+    [key: string]: unknown;
+  };
+};
+
 export type FileImportDto = {
   /**
    * Bill file to import (CSV, PDF, OFX, etc.)
@@ -6069,6 +6186,89 @@ export type PropertyControllerDeleteData = {
 
 export type PropertyControllerDeleteResponse = void;
 
+export type EventControllerCreateData = {
+  /**
+   * Region code for tenant context (decorative for life events)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: CreateBeanEventDto;
+};
+
+export type EventControllerCreateResponse = EventResponseDto;
+
+export type EventControllerFindAllData = {
+  /**
+   * Filter life events from this date (ISO 8601 format)
+   */
+  from?: string;
+  /**
+   * Number of items per page (default: 20, max: 100)
+   */
+  limit?: number;
+  /**
+   * Page number for pagination (default: 1)
+   */
+  page?: number;
+  /**
+   * Search term for description (case-insensitive partial match)
+   */
+  q?: string;
+  /**
+   * Region code for tenant context (decorative for life events)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  /**
+   * Filter life events to this date (ISO 8601 format)
+   */
+  to?: string;
+  /**
+   * Filter by life event type (exact match)
+   */
+  type?: string;
+};
+
+export type EventControllerFindAllResponse = EventListResponseDto;
+
+export type EventControllerFindOneData = {
+  /**
+   * Life event ID
+   */
+  id: string;
+  /**
+   * Region code for tenant context (decorative for life events)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type EventControllerFindOneResponse = EventResponseDto;
+
+export type EventControllerUpdateData = {
+  /**
+   * Life event ID
+   */
+  id: string;
+  /**
+   * Region code for tenant context (decorative for life events)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: UpdateBeanEventDto;
+};
+
+export type EventControllerUpdateResponse = EventResponseDto;
+
+export type EventControllerDeleteData = {
+  /**
+   * Life event ID
+   */
+  id: string;
+  /**
+   * Region code for tenant context (decorative for life events)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type EventControllerDeleteResponse = void;
+
 export type ExportControllerExportBeancountResponse = unknown;
 
 export type FileImportControllerImportFileData = {
@@ -7941,6 +8141,83 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/{region}/bean/events': {
+    post: {
+      req: EventControllerCreateData;
+      res: {
+        /**
+         * Life event created successfully
+         */
+        201: EventResponseDto;
+        /**
+         * Life event already exists for this (userId, type, date) combination
+         */
+        409: unknown;
+      };
+    };
+    get: {
+      req: EventControllerFindAllData;
+      res: {
+        /**
+         * Life events retrieved successfully
+         */
+        200: EventListResponseDto;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/events/{id}': {
+    get: {
+      req: EventControllerFindOneData;
+      res: {
+        /**
+         * Life event retrieved successfully
+         */
+        200: EventResponseDto;
+        /**
+         * Life event not found
+         */
+        404: unknown;
+      };
+    };
+    put: {
+      req: EventControllerUpdateData;
+      res: {
+        /**
+         * Life event updated successfully
+         */
+        200: EventResponseDto;
+        /**
+         * If-Match header is not a valid ISO 8601 date
+         */
+        400: unknown;
+        /**
+         * Life event not found
+         */
+        404: unknown;
+        /**
+         * Updated event conflicts with an existing (userId, type, date) combination
+         */
+        409: unknown;
+        /**
+         * If-Match precondition failed (updatedAt mismatch)
+         */
+        412: unknown;
+      };
+    };
+    delete: {
+      req: EventControllerDeleteData;
+      res: {
+        /**
+         * Life event deleted successfully
+         */
+        204: void;
+        /**
+         * Life event not found
+         */
+        404: unknown;
+      };
+    };
+  };
   '/api/v1/{region}/bean/export/beancount': {
     get: {
       res: {