@d19n/youfibre-odin-sdk 2.0.13-beta.1 → 2.0.13

package/dist/records-v2/BillingAdjustmentRecord.d.ts

@@ -19,9 +19,14 @@ import { OdinRecord, OdinRecordLinkDto } from '@d19n/odin-types/dist/core';
 import { PipelineStageEntity } from '@d19n/odin-types/dist/core';
 import { IDbRecordCreateUpdateRes } from '@d19n/odin-types/dist/core/interfaces/v1.db.interfaces';
 import { IOdinProvider } from '@d19n/odin-sdk-generator/dist/odin-sdk-types';
+import { RecordLinkManager } from '@d19n/odin-sdk-generator/dist/record-link-manager';
 import { BillingAdjustmentProperties } from '../entities-v2/BillingAdjustment';
 import { BillingAdjustmentCreateProperties } from '../actions-v2/BillingAdjustmentCreateDto';
 import { BillingAdjustmentUpdateProperties } from '../actions-v2/BillingAdjustmentUpdateDto';
+import { OrderRecord } from './OrderRecord';
+import { NoteRecord } from './NoteRecord';
+import { FileRecord } from './FileRecord';
+import { InvoiceRecord } from './InvoiceRecord';
 /**
  * Builder for action execution with dryRun support
  *
@@ -85,6 +90,10 @@ export declare class BillingAdjustmentRecord<TProps = BillingAdjustmentPropertie
     private _provider;
     private _pendingLinks;
     private _preGeneratedId;
+    private _orders?;
+    private _notes?;
+    private _files?;
+    private _invoices?;
     /**
      * Create a record wrapper.
      * @param record - The underlying record, or null for create operations
@@ -110,6 +119,78 @@ export declare class BillingAdjustmentRecord<TProps = BillingAdjustmentPropertie
     get groups(): string[];
     /** Access the underlying OdinRecord (null for new records) */
     get record(): OdinRecord<TProps> | null;
+    /** Valid labels for Order associations */
+    static readonly ordersLabels: readonly ["Order__BillingAdjustment"];
+    /**
+     * Access linked Order records
+     * @remarks Available labels: Order__BillingAdjustment
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Order records
+     * const items = await record.orders.list();
+     * const first = await record.orders.first();
+     *
+     * // Filter by label
+     * const specific = await record.orders.first({ label: 'Order__BillingAdjustment' });
+     * ```
+     */
+    get orders(): RecordLinkManager<OrderRecord, typeof BillingAdjustmentRecord['ordersLabels'][number]>;
+    /** Valid labels for Note associations */
+    static readonly notesLabels: readonly ["BillingAdjustment__Note"];
+    /**
+     * Access linked Note records
+     * @remarks Available labels: BillingAdjustment__Note
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Note records
+     * const items = await record.notes.list();
+     * const first = await record.notes.first();
+     *
+     * // Filter by label
+     * const specific = await record.notes.first({ label: 'BillingAdjustment__Note' });
+     * ```
+     */
+    get notes(): RecordLinkManager<NoteRecord, typeof BillingAdjustmentRecord['notesLabels'][number]>;
+    /** Valid labels for File associations */
+    static readonly filesLabels: readonly ["BillingAdjustment__File"];
+    /**
+     * Access linked File records
+     * @remarks Available labels: BillingAdjustment__File
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked File records
+     * const items = await record.files.list();
+     * const first = await record.files.first();
+     *
+     * // Filter by label
+     * const specific = await record.files.first({ label: 'BillingAdjustment__File' });
+     * ```
+     */
+    get files(): RecordLinkManager<FileRecord, typeof BillingAdjustmentRecord['filesLabels'][number]>;
+    /** Valid labels for Invoice associations */
+    static readonly invoicesLabels: readonly ["Invoice__BillingAdjustment"];
+    /**
+     * Access linked Invoice records
+     * @remarks Available labels: Invoice__BillingAdjustment
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Invoice records
+     * const items = await record.invoices.list();
+     * const first = await record.invoices.first();
+     *
+     * // Filter by label
+     * const specific = await record.invoices.first({ label: 'Invoice__BillingAdjustment' });
+     * ```
+     */
+    get invoices(): RecordLinkManager<InvoiceRecord, typeof BillingAdjustmentRecord['invoicesLabels'][number]>;
     /**
      * Queue a link to be created with the next action.
      * Works for both create and update actions.

package/dist/records-v2/BillingAdjustmentRecord.js

@@ -29,6 +29,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isBillingAdjustmentRecord = exports.BillingAdjustmentRecord = void 0;
 const uuid_1 = require("uuid");
 const core_1 = require("@d19n/odin-types/dist/core");
+const record_link_manager_1 = require("@d19n/odin-sdk-generator/dist/record-link-manager");
+const OrderRecord_1 = require("./OrderRecord");
+const NoteRecord_1 = require("./NoteRecord");
+const FileRecord_1 = require("./FileRecord");
+const InvoiceRecord_1 = require("./InvoiceRecord");
 /**
  * Builder for action execution with dryRun support
  *
@@ -139,6 +144,126 @@ class BillingAdjustmentRecord {
     get groups() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.groups) || []; }
     /** Access the underlying OdinRecord (null for new records) */
     get record() { return this._record; }
+    /**
+     * Access linked Order records
+     * @remarks Available labels: Order__BillingAdjustment
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Order records
+     * const items = await record.orders.list();
+     * const first = await record.orders.first();
+     *
+     * // Filter by label
+     * const specific = await record.orders.first({ label: 'Order__BillingAdjustment' });
+     * ```
+     */
+    get orders() {
+        var _a;
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('Cannot access links on a new (unsaved) record');
+        if (!this._orders) {
+            this._orders = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'OrderModule:BillingAdjustment',
+                targetEntity: 'OrderModule:Order',
+                targetModuleName: 'OrderModule',
+                targetEntityName: 'Order',
+                labels: ['Order__BillingAdjustment'],
+            }, OrderRecord_1.OrderRecord);
+        }
+        return this._orders;
+    }
+    /**
+     * Access linked Note records
+     * @remarks Available labels: BillingAdjustment__Note
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Note records
+     * const items = await record.notes.list();
+     * const first = await record.notes.first();
+     *
+     * // Filter by label
+     * const specific = await record.notes.first({ label: 'BillingAdjustment__Note' });
+     * ```
+     */
+    get notes() {
+        var _a;
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('Cannot access links on a new (unsaved) record');
+        if (!this._notes) {
+            this._notes = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'OrderModule:BillingAdjustment',
+                targetEntity: 'SupportModule:Note',
+                targetModuleName: 'SupportModule',
+                targetEntityName: 'Note',
+                labels: ['BillingAdjustment__Note'],
+            }, NoteRecord_1.NoteRecord);
+        }
+        return this._notes;
+    }
+    /**
+     * Access linked File records
+     * @remarks Available labels: BillingAdjustment__File
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked File records
+     * const items = await record.files.list();
+     * const first = await record.files.first();
+     *
+     * // Filter by label
+     * const specific = await record.files.first({ label: 'BillingAdjustment__File' });
+     * ```
+     */
+    get files() {
+        var _a;
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('Cannot access links on a new (unsaved) record');
+        if (!this._files) {
+            this._files = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'OrderModule:BillingAdjustment',
+                targetEntity: 'SchemaModule:File',
+                targetModuleName: 'SchemaModule',
+                targetEntityName: 'File',
+                labels: ['BillingAdjustment__File'],
+            }, FileRecord_1.FileRecord);
+        }
+        return this._files;
+    }
+    /**
+     * Access linked Invoice records
+     * @remarks Available labels: Invoice__BillingAdjustment
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Invoice records
+     * const items = await record.invoices.list();
+     * const first = await record.invoices.first();
+     *
+     * // Filter by label
+     * const specific = await record.invoices.first({ label: 'Invoice__BillingAdjustment' });
+     * ```
+     */
+    get invoices() {
+        var _a;
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('Cannot access links on a new (unsaved) record');
+        if (!this._invoices) {
+            this._invoices = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'OrderModule:BillingAdjustment',
+                targetEntity: 'BillingModule:Invoice',
+                targetModuleName: 'BillingModule',
+                targetEntityName: 'Invoice',
+                labels: ['Invoice__BillingAdjustment'],
+            }, InvoiceRecord_1.InvoiceRecord);
+        }
+        return this._invoices;
+    }
     // ============================================
     // LINK MANAGEMENT
     // ============================================
@@ -255,6 +380,17 @@ class BillingAdjustmentRecord {
     }
 }
 exports.BillingAdjustmentRecord = BillingAdjustmentRecord;
+// ============================================
+// TYPED LINK ACCESSORS
+// ============================================
+/** Valid labels for Order associations */
+BillingAdjustmentRecord.ordersLabels = ['Order__BillingAdjustment'];
+/** Valid labels for Note associations */
+BillingAdjustmentRecord.notesLabels = ['BillingAdjustment__Note'];
+/** Valid labels for File associations */
+BillingAdjustmentRecord.filesLabels = ['BillingAdjustment__File'];
+/** Valid labels for Invoice associations */
+BillingAdjustmentRecord.invoicesLabels = ['Invoice__BillingAdjustment'];
 /** Type guard to check if an object is a BillingAdjustmentRecord */
 function isBillingAdjustmentRecord(obj) {
     return obj instanceof BillingAdjustmentRecord;

package/dist/records-v2/BillingRequestRecord.d.ts

@@ -13,13 +13,16 @@
  * await record.createBillingRequest({ ... }).execute();
  * ```
  *
+ * Entity Types: MANDATE, PAYMENT
+ *
  * AUTO-GENERATED - DO NOT EDIT DIRECTLY
  */
 import { OdinRecord, OdinRecordLinkDto } from '@d19n/odin-types/dist/core';
 import { PipelineStageEntity } from '@d19n/odin-types/dist/core';
 import { IDbRecordCreateUpdateRes } from '@d19n/odin-types/dist/core/interfaces/v1.db.interfaces';
 import { IOdinProvider } from '@d19n/odin-sdk-generator/dist/odin-sdk-types';
-import { BillingRequestProperties } from '../entities-v2/BillingRequest';
+import { RecordLinkManager } from '@d19n/odin-sdk-generator/dist/record-link-manager';
+import { BillingRequestProperties, MandateBillingRequestProperties, PaymentBillingRequestProperties } from '../entities-v2/BillingRequest';
 import { BillingRequestMandateUpdateProperties } from '../actions-v2/BillingRequestMandateUpdateDto';
 import { BillingRequestPaymentCreateProperties } from '../actions-v2/BillingRequestPaymentCreateDto';
 import { BillingRequestPaymentUpdateProperties } from '../actions-v2/BillingRequestPaymentUpdateDto';
@@ -27,6 +30,14 @@ import { CancelBillingRequestProperties } from '../actions-v2/CancelBillingReque
 import { CancelBillingRequestFromPaymentProperties } from '../actions-v2/CancelBillingRequestFromPaymentDto';
 import { CreateBillingRequestForInvoicesProperties } from '../actions-v2/CreateBillingRequestForInvoicesDto';
 import { StartBillingRequestFlowProperties } from '../actions-v2/StartBillingRequestFlowDto';
+import { InvoiceRecord } from './InvoiceRecord';
+import { TransactionRecord } from './TransactionRecord';
+import { NoteRecord } from './NoteRecord';
+import { ActivityRecord } from './ActivityRecord';
+import { ContactRecord } from './ContactRecord';
+import { FileRecord } from './FileRecord';
+/** Valid entity types for BillingRequest */
+export declare type BillingRequestType = 'MANDATE' | 'PAYMENT';
 /**
  * Builder for action execution with dryRun support
  *
@@ -90,6 +101,13 @@ export declare class BillingRequestRecord<TProps = BillingRequestProperties> {
     private _provider;
     private _pendingLinks;
     private _preGeneratedId;
+    private _invoices?;
+    private _transactions?;
+    private _notes?;
+    private _activities?;
+    private _contacts?;
+    private _files?;
+    private _billingRequests?;
     /**
      * Create a record wrapper.
      * @param record - The underlying record, or null for create operations
@@ -102,7 +120,7 @@ export declare class BillingRequestRecord<TProps = BillingRequestProperties> {
     /** Record ID - always available (pre-generated for new records) */
     get id(): string;
     get entity(): string;
-    get type(): string | undefined;
+    get type(): BillingRequestType | undefined;
     /** Record properties - empty object for new (unsaved) records */
     get properties(): TProps;
     get title(): string | undefined;
@@ -115,6 +133,164 @@ export declare class BillingRequestRecord<TProps = BillingRequestProperties> {
     get groups(): string[];
     /** Access the underlying OdinRecord (null for new records) */
     get record(): OdinRecord<TProps> | null;
+    /**
+     * Type guard: check if this record is of type MANDATE
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to MANDATE-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isMandate()) {
+     *   // TypeScript knows record.properties is MandateBillingRequestProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks mandate
+     */
+    isMandate(): this is BillingRequestRecord<MandateBillingRequestProperties>;
+    /**
+     * Type guard: check if this record is of type PAYMENT
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to PAYMENT-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isPayment()) {
+     *   // TypeScript knows record.properties is PaymentBillingRequestProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks payment
+     */
+    isPayment(): this is BillingRequestRecord<PaymentBillingRequestProperties>;
+    /** Valid labels for Invoice associations */
+    static readonly invoicesLabels: readonly ["BillingRequest__Invoice"];
+    /**
+     * Access linked Invoice records
+     * @remarks Available labels: BillingRequest__Invoice
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Invoice records
+     * const items = await record.invoices.list();
+     * const first = await record.invoices.first();
+     *
+     * // Filter by label
+     * const specific = await record.invoices.first({ label: 'BillingRequest__Invoice' });
+     * ```
+     */
+    get invoices(): RecordLinkManager<InvoiceRecord, typeof BillingRequestRecord['invoicesLabels'][number]>;
+    /** Valid labels for Transaction associations */
+    static readonly transactionsLabels: readonly ["BillingRequest__Transaction"];
+    /**
+     * Access linked Transaction records
+     * @remarks Available labels: BillingRequest__Transaction
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Transaction records
+     * const items = await record.transactions.list();
+     * const first = await record.transactions.first();
+     *
+     * // Filter by label
+     * const specific = await record.transactions.first({ label: 'BillingRequest__Transaction' });
+     * ```
+     */
+    get transactions(): RecordLinkManager<TransactionRecord, typeof BillingRequestRecord['transactionsLabels'][number]>;
+    /** Valid labels for Note associations */
+    static readonly notesLabels: readonly ["BillingRequest__Note"];
+    /**
+     * Access linked Note records
+     * @remarks Available labels: BillingRequest__Note
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Note records
+     * const items = await record.notes.list();
+     * const first = await record.notes.first();
+     *
+     * // Filter by label
+     * const specific = await record.notes.first({ label: 'BillingRequest__Note' });
+     * ```
+     */
+    get notes(): RecordLinkManager<NoteRecord, typeof BillingRequestRecord['notesLabels'][number]>;
+    /** Valid labels for Activity associations */
+    static readonly activitiesLabels: readonly ["BillingRequest__Activity"];
+    /**
+     * Access linked Activity records
+     * @remarks Available labels: BillingRequest__Activity
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Activity records
+     * const items = await record.activities.list();
+     * const first = await record.activities.first();
+     *
+     * // Filter by label
+     * const specific = await record.activities.first({ label: 'BillingRequest__Activity' });
+     * ```
+     */
+    get activities(): RecordLinkManager<ActivityRecord, typeof BillingRequestRecord['activitiesLabels'][number]>;
+    /** Valid labels for Contact associations */
+    static readonly contactsLabels: readonly ["Contact__BillingRequest"];
+    /**
+     * Access linked Contact records
+     * @remarks Available labels: Contact__BillingRequest
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Contact records
+     * const items = await record.contacts.list();
+     * const first = await record.contacts.first();
+     *
+     * // Filter by label
+     * const specific = await record.contacts.first({ label: 'Contact__BillingRequest' });
+     * ```
+     */
+    get contacts(): RecordLinkManager<ContactRecord, typeof BillingRequestRecord['contactsLabels'][number]>;
+    /** Valid labels for File associations */
+    static readonly filesLabels: readonly ["BillingRequest__File"];
+    /**
+     * Access linked File records
+     * @remarks Available labels: BillingRequest__File
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked File records
+     * const items = await record.files.list();
+     * const first = await record.files.first();
+     *
+     * // Filter by label
+     * const specific = await record.files.first({ label: 'BillingRequest__File' });
+     * ```
+     */
+    get files(): RecordLinkManager<FileRecord, typeof BillingRequestRecord['filesLabels'][number]>;
+    /** Valid labels for BillingRequest associations */
+    static readonly billingRequestsLabels: readonly ["BillingRequest__BillingRequest"];
+    /**
+     * Access linked BillingRequest records
+     * @remarks Available labels: BillingRequest__BillingRequest
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked BillingRequest records
+     * const items = await record.billingRequests.list();
+     * const first = await record.billingRequests.first();
+     *
+     * // Filter by label
+     * const specific = await record.billingRequests.first({ label: 'BillingRequest__BillingRequest' });
+     * ```
+     */
+    get billingRequests(): RecordLinkManager<BillingRequestRecord, typeof BillingRequestRecord['billingRequestsLabels'][number]>;
     /**
      * Queue a link to be created with the next action.
      * Works for both create and update actions.