@opencxh/domain 1.278.0 → 1.279.0

package/dist/entities/catalog/types.d.ts

@@ -39,6 +39,11 @@ export interface Product {
     ledgerCategoryKey?: string;
     /** References to this product elsewhere (`moneybird:412`). A reference, never a copy. */
     externalIds?: string[];
+    /**
+     * Hours booked on this `WorkType.key` are invoiced as this product. Here and not on the work
+     * type: time must not know sales, and several products may share one type (junior/senior).
+     */
+    workTypeKey?: string;
     /** See {@link FIXED_UNITS}. Drives the form and the word after the quantity. */
     unitKey: string;
     /** Key into the organisation's VAT table, never the percentage itself. */

package/dist/entities/company/types.d.ts

@@ -1,4 +1,5 @@
 import { PostalAddress } from '../organization/types';
+import { LifecycleStage } from '../contact/lifecycle';
 import { OwnerScope } from '../scope/types';
 /** Same meaning as {@link ContactOrigin}: `shadow` is a lazily cached hit, a landed row is `own`. */
 export type CompanyOrigin = "own" | "shadow";
@@ -43,6 +44,8 @@ export interface Company {
     ownerScope: OwnerScope;
     source: CompanySource;
     origin?: CompanyOrigin;
+    /** Where the organisation stands with us; independent of its contacts' own stages. */
+    lifecycleStage?: LifecycleStage;
     /** The group this company belongs to. One level up per row; a cycle is refused on write. */
     parentCompanyId?: string;
     /**

package/dist/entities/time-entry/billing.d.ts

@@ -0,0 +1,20 @@
+import { TimeEntry } from './types';
+/** Booked hours that become one invoice line: one work type on one subject. */
+export interface BillableTimeGroup {
+    /** `WorkType.key`; absent = booked without a type, which no product can carry. */
+    workType?: string;
+    scopeKey?: string;
+    scopeLabel?: string;
+    seconds: number;
+    /** Hours, two decimals — what goes on the line as `quantity`. */
+    hours: number;
+    entryIds: string[];
+    /** Epoch ms of the first and last entry, for the line's description. */
+    from: number;
+    to: number;
+}
+/**
+ * Group billable entries per work type × subject, in the order they were first booked.
+ * `durationSeconds` is the booked duration, so rounding has already been applied per entry.
+ */
+export declare function billableTimeGroups(entries: readonly TimeEntry[]): BillableTimeGroup[];

package/dist/entities/time-entry/billing.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/entities/time-entry/index.d.ts

@@ -1,3 +1,4 @@
+export * from './billing';
 export * from './duration';
 export * from './types';
 export * from './work-type';

package/dist/entities/time-entry/types.d.ts

@@ -69,6 +69,11 @@ export interface TimeEntry {
     workType?: string;
     note?: string;
     source: TimeEntrySource;
+    /**
+     * The invoice (a sales transaction id) this entry is on, draft included. Set by sales only;
+     * while set, the entry cannot be edited or deleted — that is what stops billing it twice.
+     */
+    invoicedTransactionId?: string;
     createdAt?: number;
     updatedAt?: number;
 }

package/dist/entities/transaction/types.d.ts

@@ -177,6 +177,11 @@ export interface TransactionLine {
      * booked against, not what the customer reads.
      */
     dealItemId?: string;
+    /**
+     * The time entries this line bills. Sales stamps exactly this set onto them on every save, so
+     * the line — not the entry — is the source of truth. Never copied to a new document.
+     */
+    timeEntryIds?: string[];
     /**
      * An option: priced and shown, but **not** in the total.
      *