@bisondesk/documents-sdk 1.0.602 → 1.0.603

package/lib/types/recurring-invoices.d.ts

@@ -24,24 +24,32 @@ export type RecurringInvoice = RecurringInvoiceUpdate & {
     modifiedAt: string;
     modifiedBy: string;
 };
-export declare enum RecurringRunState {
+export declare enum RecurrenceSummaryState {
+    scheduled = "scheduled",
     executed = "executed",
-    missed = "missed"
+    failed = "failed",
+    ended = "ended",
+    starting = "starting"
 }
+export type RecurrenceSummaryQuery = {
+    from: string;
+    to: string;
+    summaryState?: RecurrenceSummaryState;
+};
 export type RecurringInvoiceFilterOptions = {
     contractId?: string;
     onlyActive?: boolean;
     onlyFixedPeriod?: boolean;
-    scheduledFrom?: string;
-    scheduledTo?: string;
-    runState?: RecurringRunState;
+    summary?: RecurrenceSummaryQuery;
     limit?: number;
     offset?: number;
 };
 export type RecurringInvoiceSummary = {
-    activeContractsWithRecurrences: number;
-    ranInWindow: number;
-    missedInWindow: number;
+    scheduled: number;
+    executed: number;
+    failed: number;
+    ended: number;
+    starting: number;
 };
 export type ContractRecurrenceState = {
     hasActiveRecurrence: boolean;

package/lib/types/recurring-invoices.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recurring-invoices.d.ts","sourceRoot":"/","sources":["types/recurring-invoices.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEjE,MAAM,MAAM,mBAAmB,GAAG;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,GAAG;IACzD,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GAAG;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IAGxB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IAEvB,mBAAmB,EAAE,IAAI,CACvB,iBAAiB,EACjB,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,cAAc,CAChF,CAAC;IACF,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAIF,oBAAY,iBAAiB;IAC3B,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,MAAM,MAAM,uBAAuB,GAAG;IACpC,8BAA8B,EAAE,MAAM,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAKF,MAAM,MAAM,uBAAuB,GAAG;IACpC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAIF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;CACvD,CAAC;AAIF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QACJ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CAAC;AAEF,oBAAY,wBAAwB;IAClC,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,IAAI,SAAS;CACd;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,wBAAwB,CAAC;CAClC,CAAC"}
+{"version":3,"file":"recurring-invoices.d.ts","sourceRoot":"/","sources":["types/recurring-invoices.ts"],"names":[],"mappings":"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"}

package/lib/types/recurring-invoices.js

@@ -1,8 +1,11 @@
-export var RecurringRunState;
-(function (RecurringRunState) {
-    RecurringRunState["executed"] = "executed";
-    RecurringRunState["missed"] = "missed";
-})(RecurringRunState || (RecurringRunState = {}));
+export var RecurrenceSummaryState;
+(function (RecurrenceSummaryState) {
+    RecurrenceSummaryState["scheduled"] = "scheduled";
+    RecurrenceSummaryState["executed"] = "executed";
+    RecurrenceSummaryState["failed"] = "failed";
+    RecurrenceSummaryState["ended"] = "ended";
+    RecurrenceSummaryState["starting"] = "starting";
+})(RecurrenceSummaryState || (RecurrenceSummaryState = {}));
 export var RecurringExecutionStatus;
 (function (RecurringExecutionStatus) {
     RecurringExecutionStatus["scheduled"] = "scheduled";

package/lib/types/recurring-invoices.js.map

@@ -1 +1 @@
-{"version":3,"file":"recurring-invoices.js","sourceRoot":"/","sources":["types/recurring-invoices.ts"],"names":[],"mappings":"AAuCA,MAAM,CAAN,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IAC3B,0CAAqB,CAAA;IACrB,sCAAiB,CAAA;AACnB,CAAC,EAHW,iBAAiB,KAAjB,iBAAiB,QAG5B;AAwDD,MAAM,CAAN,IAAY,wBAKX;AALD,WAAY,wBAAwB;IAClC,mDAAuB,CAAA;IACvB,6CAAiB,CAAA;IACjB,mDAAuB,CAAA;IACvB,yCAAa,CAAA;AACf,CAAC,EALW,wBAAwB,KAAxB,wBAAwB,QAKnC","sourcesContent":["import { LeasingContractStatus } from '@bisondesk/core-sdk/types/leasing';\nimport { DocumentType, FinanceDocumentV2 } from './documents.js';\n\nexport type NewRecurringInvoice = {\n  originalInvoiceId: string;\n  leasingContractId?: string;\n  startPeriod: number;\n  totalExecutions?: number; // can be undefined if the recurring invoice is infinite\n};\n\nexport type RecurringInvoiceUpdate = NewRecurringInvoice & {\n  active: boolean;\n};\n\nexport type RecurringInvoice = RecurringInvoiceUpdate & {\n  id: string;\n  country: string;\n  executions: number;\n  automationStart: string;\n\n  // stored invoice data for display\n  amountExcl: string;\n  organizationId: string;\n\n  originalInvoiceData: Pick<\n    FinanceDocumentV2,\n    'category' | 'branchId' | 'tags' | 'total' | 'notes' | 'lines' | 'bankAccounts'\n  >;\n  lastGeneratedDocumentId?: string;\n  lastExecutedAt?: string;\n\n  createdAt: string;\n  createdBy: string;\n  modifiedAt: string;\n  modifiedBy: string;\n};\n\n// Run state of a recurring invoice's scheduled execution within the queried window.\n// `executed` = the in-window execution completed; `missed` = it was due but never completed.\nexport enum RecurringRunState {\n  executed = 'executed',\n  missed = 'missed',\n}\n\nexport type RecurringInvoiceFilterOptions = {\n  contractId?: string;\n  onlyActive?: boolean;\n  onlyFixedPeriod?: boolean;\n  // ISO window matching recurring invoices that have an execution scheduled within [from, to]\n  scheduledFrom?: string;\n  scheduledTo?: string;\n  // Narrows the windowed listing to invoices whose in-window execution ran or was missed.\n  // Only meaningful together with scheduledFrom/scheduledTo.\n  runState?: RecurringRunState;\n  limit?: number;\n  offset?: number;\n};\n\n// Aggregate counters for the scheduled-recurrences overview. The contracts count reflects\n// current state; ran/missed are scoped to the queried [scheduledFrom, scheduledTo] window.\nexport type RecurringInvoiceSummary = {\n  activeContractsWithRecurrences: number;\n  ranInWindow: number;\n  missedInWindow: number;\n};\n\n// Recurrence state for a single leasing contract, used to enrich the leasing-contracts search\n// index: whether the contract currently has an active recurrence and the most recent run time\n// across all of its recurrences.\nexport type ContractRecurrenceState = {\n  hasActiveRecurrence: boolean;\n  lastRecurrenceRunAt?: string;\n};\n\n// Meta attached to a scheduled-window listing: the single in-window execution keyed by\n// recurring invoice id (a recurring invoice has at most one execution scheduled per window)\nexport type RecurringInvoiceExecutionsMeta = {\n  executions: Record<string, RecurringInvoiceExecution>;\n};\n\n// Current leasing-contract status keyed by leasing contract id. Lets a listing explain why a\n// scheduled run was missed (e.g. the contract is no longer billable vs. an execution error).\nexport type RecurringInvoiceContractsMeta = {\n  contractStatuses: Record<string, LeasingContractStatus>;\n};\n\nexport type RecurringDocShareData = {\n  type: DocumentType.Finance;\n  recipient?: string;\n  tenant: string;\n  message: string;\n  meta: {\n    amount?: string;\n    issueDate: string;\n    reference: string;\n  };\n};\n\nexport enum RecurringExecutionStatus {\n  scheduled = 'scheduled',\n  queued = 'queued',\n  executing = 'executing',\n  done = 'done',\n}\n\nexport type RecurringInvoiceExecution = {\n  recurrenceId: string;\n  execution: number;\n  executionDate: string;\n  status: RecurringExecutionStatus;\n};\n"]}
+{"version":3,"file":"recurring-invoices.js","sourceRoot":"/","sources":["types/recurring-invoices.ts"],"names":[],"mappings":"AA6CA,MAAM,CAAN,IAAY,sBAMX;AAND,WAAY,sBAAsB;IAChC,iDAAuB,CAAA;IACvB,+CAAqB,CAAA;IACrB,2CAAiB,CAAA;IACjB,yCAAe,CAAA;IACf,+CAAqB,CAAA;AACvB,CAAC,EANW,sBAAsB,KAAtB,sBAAsB,QAMjC;AA6DD,MAAM,CAAN,IAAY,wBAKX;AALD,WAAY,wBAAwB;IAClC,mDAAuB,CAAA;IACvB,6CAAiB,CAAA;IACjB,mDAAuB,CAAA;IACvB,yCAAa,CAAA;AACf,CAAC,EALW,wBAAwB,KAAxB,wBAAwB,QAKnC","sourcesContent":["import { LeasingContractStatus } from '@bisondesk/core-sdk/types/leasing';\nimport { DocumentType, FinanceDocumentV2 } from './documents.js';\n\nexport type NewRecurringInvoice = {\n  originalInvoiceId: string;\n  leasingContractId?: string;\n  startPeriod: number;\n  totalExecutions?: number; // can be undefined if the recurring invoice is infinite\n};\n\nexport type RecurringInvoiceUpdate = NewRecurringInvoice & {\n  active: boolean;\n};\n\nexport type RecurringInvoice = RecurringInvoiceUpdate & {\n  id: string;\n  country: string;\n  executions: number;\n  automationStart: string;\n\n  // stored invoice data for display\n  amountExcl: string;\n  organizationId: string;\n\n  originalInvoiceData: Pick<\n    FinanceDocumentV2,\n    'category' | 'branchId' | 'tags' | 'total' | 'notes' | 'lines' | 'bankAccounts'\n  >;\n  lastGeneratedDocumentId?: string;\n  lastExecutedAt?: string;\n\n  createdAt: string;\n  createdBy: string;\n  modifiedAt: string;\n  modifiedBy: string;\n};\n\n// State of a recurring invoice used to drive the scheduled-recurrences overview tiles and the\n// matching windowed listing. The execution-based states (scheduled/executed/failed) are evaluated\n// against the queried [from, to] window; ended/starting are lifecycle states of the invoice itself.\n// - scheduled: has an upcoming execution due in the window\n// - executed:  has an in-window execution that completed\n// - failed:    has an in-window execution that was due but never completed\n// - ended:     completed all of its executions (inactive, executions >= totalExecutions)\n// - starting:  active but has not run yet (executions = 0)\nexport enum RecurrenceSummaryState {\n  scheduled = 'scheduled',\n  executed = 'executed',\n  failed = 'failed',\n  ended = 'ended',\n  starting = 'starting',\n}\n\n// Window + optional state, always passed together. `from`/`to` bound the execution-based states;\n// `summaryState` narrows a listing to a single tile (omit it to list everything in the window).\nexport type RecurrenceSummaryQuery = {\n  from: string;\n  to: string;\n  summaryState?: RecurrenceSummaryState;\n};\n\nexport type RecurringInvoiceFilterOptions = {\n  contractId?: string;\n  onlyActive?: boolean;\n  onlyFixedPeriod?: boolean;\n  // Grouped window + state for the scheduled-recurrences overview and its windowed listing.\n  summary?: RecurrenceSummaryQuery;\n  limit?: number;\n  offset?: number;\n};\n\n// Aggregate counters for the scheduled-recurrences overview\nexport type RecurringInvoiceSummary = {\n  scheduled: number;\n  executed: number;\n  failed: number;\n  ended: number;\n  starting: number;\n};\n\n// Recurrence state for a single leasing contract, used to enrich the leasing-contracts search\n// index: whether the contract currently has an active recurrence and the most recent run time\n// across all of its recurrences.\nexport type ContractRecurrenceState = {\n  hasActiveRecurrence: boolean;\n  lastRecurrenceRunAt?: string;\n};\n\n// Meta attached to a scheduled-window listing: the single in-window execution keyed by\n// recurring invoice id (a recurring invoice has at most one execution scheduled per window)\nexport type RecurringInvoiceExecutionsMeta = {\n  executions: Record<string, RecurringInvoiceExecution>;\n};\n\n// Current leasing-contract status keyed by leasing contract id. Lets a listing explain why a\n// scheduled run was missed (e.g. the contract is no longer billable vs. an execution error).\nexport type RecurringInvoiceContractsMeta = {\n  contractStatuses: Record<string, LeasingContractStatus>;\n};\n\nexport type RecurringDocShareData = {\n  type: DocumentType.Finance;\n  recipient?: string;\n  tenant: string;\n  message: string;\n  meta: {\n    amount?: string;\n    issueDate: string;\n    reference: string;\n  };\n};\n\nexport enum RecurringExecutionStatus {\n  scheduled = 'scheduled',\n  queued = 'queued',\n  executing = 'executing',\n  done = 'done',\n}\n\nexport type RecurringInvoiceExecution = {\n  recurrenceId: string;\n  execution: number;\n  executionDate: string;\n  status: RecurringExecutionStatus;\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bisondesk/documents-sdk",
-  "version": "1.0.602",
+  "version": "1.0.603",
   "description": "",
   "type": "module",
   "author": "TheTruckCompany",

package/src/types/recurring-invoices.ts

@@ -35,33 +35,47 @@ export type RecurringInvoice = RecurringInvoiceUpdate & {
   modifiedBy: string;
 };
 
-// Run state of a recurring invoice's scheduled execution within the queried window.
-// `executed` = the in-window execution completed; `missed` = it was due but never completed.
-export enum RecurringRunState {
+// State of a recurring invoice used to drive the scheduled-recurrences overview tiles and the
+// matching windowed listing. The execution-based states (scheduled/executed/failed) are evaluated
+// against the queried [from, to] window; ended/starting are lifecycle states of the invoice itself.
+// - scheduled: has an upcoming execution due in the window
+// - executed:  has an in-window execution that completed
+// - failed:    has an in-window execution that was due but never completed
+// - ended:     completed all of its executions (inactive, executions >= totalExecutions)
+// - starting:  active but has not run yet (executions = 0)
+export enum RecurrenceSummaryState {
+  scheduled = 'scheduled',
   executed = 'executed',
-  missed = 'missed',
+  failed = 'failed',
+  ended = 'ended',
+  starting = 'starting',
 }
 
+// Window + optional state, always passed together. `from`/`to` bound the execution-based states;
+// `summaryState` narrows a listing to a single tile (omit it to list everything in the window).
+export type RecurrenceSummaryQuery = {
+  from: string;
+  to: string;
+  summaryState?: RecurrenceSummaryState;
+};
+
 export type RecurringInvoiceFilterOptions = {
   contractId?: string;
   onlyActive?: boolean;
   onlyFixedPeriod?: boolean;
-  // ISO window matching recurring invoices that have an execution scheduled within [from, to]
-  scheduledFrom?: string;
-  scheduledTo?: string;
-  // Narrows the windowed listing to invoices whose in-window execution ran or was missed.
-  // Only meaningful together with scheduledFrom/scheduledTo.
-  runState?: RecurringRunState;
+  // Grouped window + state for the scheduled-recurrences overview and its windowed listing.
+  summary?: RecurrenceSummaryQuery;
   limit?: number;
   offset?: number;
 };
 
-// Aggregate counters for the scheduled-recurrences overview. The contracts count reflects
-// current state; ran/missed are scoped to the queried [scheduledFrom, scheduledTo] window.
+// Aggregate counters for the scheduled-recurrences overview
 export type RecurringInvoiceSummary = {
-  activeContractsWithRecurrences: number;
-  ranInWindow: number;
-  missedInWindow: number;
+  scheduled: number;
+  executed: number;
+  failed: number;
+  ended: number;
+  starting: number;
 };
 
 // Recurrence state for a single leasing contract, used to enrich the leasing-contracts search