@firela/api-types 0.0.0-canary.610daafc → 0.0.0-canary.6a42fd0e

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firela/api-types",
-  "version": "0.0.0-canary.610daafc",
+  "version": "0.0.0-canary.6a42fd0e",
   "description": "TypeScript types generated from IGN OpenAPI specification",
   "license": "MIT",
   "author": "FireLa Team",

package/src/generated/schemas.gen.ts

@@ -2825,6 +2825,163 @@ export const $UpdateCommodityDto = {
   }
 } as const;
 
+export const $CreateBeanPriceDto = {
+  type: 'object',
+  properties: {
+    currency: {
+      type: 'string',
+      description: 'Currency being priced (e.g., USD, AAPL, BTC)',
+      example: 'USD'
+    },
+    quoteCurrency: {
+      type: 'string',
+      description: 'Quote currency (pricing currency, e.g., CNY, EUR)',
+      example: 'CNY'
+    },
+    amount: {
+      type: 'number',
+      description:
+        'Price amount (MUST be >= 0 per Beancount spec, supports up to 15 decimal places). Zero allowed for conversion entries, negative strictly prohibited.',
+      example: 175.5,
+      minimum: 0
+    },
+    date: {
+      type: 'string',
+      description: 'Price date (ISO 8601 format)',
+      example: '2024-11-05'
+    },
+    metadata: {
+      type: 'object',
+      description:
+        'Metadata (validated by Zod schema, max field lengths enforced)',
+      example: {
+        source: 'MANUAL',
+        note: 'Bank valuation report',
+        confidence: 0.95
+      }
+    }
+  },
+  required: ['currency', 'quoteCurrency', 'amount', 'date']
+} as const;
+
+export const $PriceResponseDto = {
+  type: 'object',
+  properties: {
+    id: {
+      type: 'string',
+      description: 'Unique identifier',
+      example: 'uuid-123-456'
+    },
+    userId: {
+      type: 'string',
+      description: 'User ID (owner of the price)',
+      example: 'user-123'
+    },
+    currency: {
+      type: 'string',
+      description: 'Currency being priced (e.g., USD, AAPL, BTC)',
+      example: 'BTC'
+    },
+    quoteCurrency: {
+      type: 'string',
+      description: 'Quote currency (pricing currency, e.g., USD, CNY)',
+      example: 'USD'
+    },
+    amount: {
+      type: 'number',
+      description:
+        'Price amount (corresponds to Beancount Amount.number). Supports up to 15 decimal places.',
+      example: 50000
+    },
+    date: {
+      type: 'string',
+      description:
+        'Price date (ISO 8601 format). Represents the date this price was valid.',
+      example: '2024-01-01',
+      format: 'date'
+    },
+    meta: {
+      type: 'object',
+      description:
+        'Metadata (corresponds to Beancount meta field). Contains source, confidence, note, etc.',
+      example: {
+        source: 'MANUAL',
+        note: 'User-defined price',
+        confidence: 1
+      }
+    },
+    createdAt: {
+      format: 'date-time',
+      type: 'string',
+      description: 'Creation timestamp',
+      example: '2024-11-03T10:00:00Z'
+    },
+    updatedAt: {
+      format: 'date-time',
+      type: 'string',
+      description: 'Last update timestamp',
+      example: '2024-11-03T10:00:00Z'
+    }
+  },
+  required: [
+    'id',
+    'userId',
+    'currency',
+    'quoteCurrency',
+    'amount',
+    'date',
+    'meta',
+    'createdAt',
+    'updatedAt'
+  ]
+} as const;
+
+export const $PriceListResponseDto = {
+  type: 'object',
+  properties: {
+    items: {
+      description: 'List of prices',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/PriceResponseDto'
+      }
+    },
+    total: {
+      type: 'number',
+      description: 'Total number of prices',
+      example: 42
+    }
+  },
+  required: ['items', 'total']
+} as const;
+
+export const $UpdateBeanPriceDto = {
+  type: 'object',
+  properties: {
+    currency: {
+      type: 'string',
+      description: 'Currency being priced'
+    },
+    quoteCurrency: {
+      type: 'string',
+      description: 'Quote currency (pricing currency)'
+    },
+    amount: {
+      type: 'number',
+      description: 'Price amount (MUST be >= 0 per Beancount spec)',
+      minimum: 0
+    },
+    date: {
+      type: 'string',
+      description: 'Price date (ISO 8601 format)'
+    },
+    metadata: {
+      type: 'object',
+      description: 'Metadata'
+    }
+  }
+} as const;
+
 export const $CreateRecurringRuleDto = {
   type: 'object',
   properties: {
@@ -4530,6 +4687,208 @@ export const $UpdateBeanEventDto = {
   }
 } as const;
 
+export const $ActualBalanceDto = {
+  type: 'object',
+  properties: {
+    amount: {
+      type: 'string',
+      description:
+        'Actual balance amount as a decimal string (preserves precision for tolerance inference).',
+      example: '1234.56'
+    },
+    ccy: {
+      type: 'string',
+      description: 'Currency code (ISO 4217 or commodity ticker).',
+      example: 'CNY'
+    }
+  },
+  required: ['amount', 'ccy']
+} as const;
+
+export const $ComputeReconciliationDto = {
+  type: 'object',
+  properties: {
+    accountId: {
+      type: 'string',
+      description: 'BeanAccount id to reconcile.'
+    },
+    asOfDate: {
+      type: 'string',
+      description: 'Assertion date (ISO 8601, e.g. "2026-07-24").',
+      example: '2026-07-24'
+    },
+    actualBalance: {
+      description: 'Actual balance from the external statement.',
+      allOf: [
+        {
+          $ref: '#/components/schemas/ActualBalanceDto'
+        }
+      ]
+    }
+  },
+  required: ['accountId', 'asOfDate', 'actualBalance']
+} as const;
+
+export const $ReconciliationComputeResultDto = {
+  type: 'object',
+  properties: {
+    accountId: {
+      type: 'string'
+    },
+    asOfDate: {
+      type: 'string'
+    },
+    bookBalance: {
+      type: 'string',
+      description: 'System-computed book balance (decimal string).'
+    },
+    actualBalance: {
+      type: 'string',
+      description: 'User-entered actual balance (decimal string).'
+    },
+    currency: {
+      type: 'string'
+    },
+    diff: {
+      type: 'string',
+      description: 'Diff = book − actual (decimal string).'
+    },
+    tolerance: {
+      type: 'string',
+      description: 'Applied tolerance (decimal string).'
+    },
+    withinTolerance: {
+      type: 'boolean',
+      description: 'true when |diff| ≤ tolerance.'
+    },
+    suggestedAction: {
+      type: 'string',
+      enum: ['assert', 'pad'],
+      description:
+        'Suggested next action: assert when within tolerance, pad otherwise.'
+    }
+  },
+  required: [
+    'accountId',
+    'asOfDate',
+    'bookBalance',
+    'actualBalance',
+    'currency',
+    'diff',
+    'tolerance',
+    'withinTolerance',
+    'suggestedAction'
+  ]
+} as const;
+
+export const $AssertReconciliationDto = {
+  type: 'object',
+  properties: {
+    accountId: {
+      type: 'string',
+      description: 'BeanAccount id to reconcile.'
+    },
+    asOfDate: {
+      type: 'string',
+      description: 'Assertion date (ISO 8601, e.g. "2026-07-24").',
+      example: '2026-07-24'
+    },
+    actualBalance: {
+      description: 'Actual balance from the external statement.',
+      allOf: [
+        {
+          $ref: '#/components/schemas/ActualBalanceDto'
+        }
+      ]
+    },
+    tolerance: {
+      type: 'string',
+      description:
+        'Optional explicit tolerance override. Omit to infer from amount precision (Beancount default).',
+      example: '0.01'
+    }
+  },
+  required: ['accountId', 'asOfDate', 'actualBalance']
+} as const;
+
+export const $ReconciliationRecordDto = {
+  type: 'object',
+  properties: {
+    id: {
+      type: 'string'
+    },
+    accountId: {
+      type: 'string'
+    },
+    date: {
+      type: 'string'
+    },
+    amount: {
+      type: 'string',
+      description: 'Asserted (actual) amount.'
+    },
+    currency: {
+      type: 'string'
+    },
+    tolerance: {
+      type: 'string'
+    },
+    diffAmount: {
+      type: 'string',
+      description: 'book − actual.'
+    },
+    diffCurrency: {
+      type: 'string'
+    },
+    createdAt: {
+      type: 'string'
+    }
+  },
+  required: ['id', 'accountId', 'date', 'amount', 'currency', 'createdAt']
+} as const;
+
+export const $PadReconciliationDto = {
+  type: 'object',
+  properties: {
+    accountId: {
+      type: 'string',
+      description: 'BeanAccount id to reconcile.'
+    },
+    asOfDate: {
+      type: 'string',
+      description: 'Assertion date (ISO 8601, e.g. "2026-07-24").',
+      example: '2026-07-24'
+    },
+    actualBalance: {
+      description: 'Actual balance from the external statement.',
+      allOf: [
+        {
+          $ref: '#/components/schemas/ActualBalanceDto'
+        }
+      ]
+    },
+    sourceAccount: {
+      type: 'string',
+      description:
+        'Pad source account. Defaults to Equity:Opening-Balances (official Beancount convention).',
+      example: 'Equity:Opening-Balances',
+      default: 'Equity:Opening-Balances'
+    }
+  },
+  required: ['accountId', 'asOfDate', 'actualBalance']
+} as const;
+
+export const $PadResultDto = {
+  type: 'object',
+  properties: {
+    transactionId: {
+      type: 'string',
+      description: 'Created pad adjusting transaction id.'
+    }
+  },
+  required: ['transactionId']
+} as const;
+
 export const $FileImportDto = {
   type: 'object',
   properties: {
@@ -7097,163 +7456,6 @@ export const $HoldingPnlResponseDto = {
   required: ['asOfDate', 'baseCurrency', 'method', 'rows', 'warnings']
 } as const;
 
-export const $CreateBeanPriceDto = {
-  type: 'object',
-  properties: {
-    currency: {
-      type: 'string',
-      description: 'Currency being priced (e.g., USD, AAPL, BTC)',
-      example: 'USD'
-    },
-    quoteCurrency: {
-      type: 'string',
-      description: 'Quote currency (pricing currency, e.g., CNY, EUR)',
-      example: 'CNY'
-    },
-    amount: {
-      type: 'number',
-      description:
-        'Price amount (MUST be >= 0 per Beancount spec, supports up to 15 decimal places). Zero allowed for conversion entries, negative strictly prohibited.',
-      example: 175.5,
-      minimum: 0
-    },
-    date: {
-      type: 'string',
-      description: 'Price date (ISO 8601 format)',
-      example: '2024-11-05'
-    },
-    metadata: {
-      type: 'object',
-      description:
-        'Metadata (validated by Zod schema, max field lengths enforced)',
-      example: {
-        source: 'MANUAL',
-        note: 'Bank valuation report',
-        confidence: 0.95
-      }
-    }
-  },
-  required: ['currency', 'quoteCurrency', 'amount', 'date']
-} as const;
-
-export const $PriceResponseDto = {
-  type: 'object',
-  properties: {
-    id: {
-      type: 'string',
-      description: 'Unique identifier',
-      example: 'uuid-123-456'
-    },
-    userId: {
-      type: 'string',
-      description: 'User ID (owner of the price)',
-      example: 'user-123'
-    },
-    currency: {
-      type: 'string',
-      description: 'Currency being priced (e.g., USD, AAPL, BTC)',
-      example: 'BTC'
-    },
-    quoteCurrency: {
-      type: 'string',
-      description: 'Quote currency (pricing currency, e.g., USD, CNY)',
-      example: 'USD'
-    },
-    amount: {
-      type: 'number',
-      description:
-        'Price amount (corresponds to Beancount Amount.number). Supports up to 15 decimal places.',
-      example: 50000
-    },
-    date: {
-      type: 'string',
-      description:
-        'Price date (ISO 8601 format). Represents the date this price was valid.',
-      example: '2024-01-01',
-      format: 'date'
-    },
-    meta: {
-      type: 'object',
-      description:
-        'Metadata (corresponds to Beancount meta field). Contains source, confidence, note, etc.',
-      example: {
-        source: 'MANUAL',
-        note: 'User-defined price',
-        confidence: 1
-      }
-    },
-    createdAt: {
-      format: 'date-time',
-      type: 'string',
-      description: 'Creation timestamp',
-      example: '2024-11-03T10:00:00Z'
-    },
-    updatedAt: {
-      format: 'date-time',
-      type: 'string',
-      description: 'Last update timestamp',
-      example: '2024-11-03T10:00:00Z'
-    }
-  },
-  required: [
-    'id',
-    'userId',
-    'currency',
-    'quoteCurrency',
-    'amount',
-    'date',
-    'meta',
-    'createdAt',
-    'updatedAt'
-  ]
-} as const;
-
-export const $PriceListResponseDto = {
-  type: 'object',
-  properties: {
-    items: {
-      description: 'List of prices',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/PriceResponseDto'
-      }
-    },
-    total: {
-      type: 'number',
-      description: 'Total number of prices',
-      example: 42
-    }
-  },
-  required: ['items', 'total']
-} as const;
-
-export const $UpdateBeanPriceDto = {
-  type: 'object',
-  properties: {
-    currency: {
-      type: 'string',
-      description: 'Currency being priced'
-    },
-    quoteCurrency: {
-      type: 'string',
-      description: 'Quote currency (pricing currency)'
-    },
-    amount: {
-      type: 'number',
-      description: 'Price amount (MUST be >= 0 per Beancount spec)',
-      minimum: 0
-    },
-    date: {
-      type: 'string',
-      description: 'Price date (ISO 8601 format)'
-    },
-    metadata: {
-      type: 'object',
-      description: 'Metadata'
-    }
-  }
-} as const;
-
 export const $CurrencyBalanceDto = {
   type: 'object',
   properties: {