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

package/dist/records-v2/ConversationFeedbackRecord.js

@@ -14,6 +14,8 @@
  * await record.createConversationFeedback({ ... }).execute();
  * ```
  *
+ * Entity Types: DEFAULT
+ *
  * AUTO-GENERATED - DO NOT EDIT DIRECTLY
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
@@ -29,6 +31,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isConversationFeedbackRecord = exports.ConversationFeedbackRecord = 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 CaseRecord_1 = require("./CaseRecord");
+const ConversationRecord_1 = require("./ConversationRecord");
+const ContactRecord_1 = require("./ContactRecord");
+const UserRecord_1 = require("./UserRecord");
 /**
  * Builder for action execution with dryRun support
  *
@@ -140,6 +147,145 @@ class ConversationFeedbackRecord {
     /** Access the underlying OdinRecord (null for new records) */
     get record() { return this._record; }
     // ============================================
+    // TYPE GUARDS (with TypeScript type predicates)
+    // ============================================
+    /**
+     * Type guard: check if this record is of type DEFAULT
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to DEFAULT-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isDefault()) {
+     *   // TypeScript knows record.properties is ConversationFeedbackProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks This is the default record type
+     */
+    isDefault() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.type) === 'DEFAULT'; }
+    /**
+     * Access linked Case records
+     * @remarks Available labels: Conversation_Case
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Case records
+     * const items = await record.cases.list();
+     * const first = await record.cases.first();
+     *
+     * // Filter by label
+     * const specific = await record.cases.first({ label: 'Conversation_Case' });
+     * ```
+     */
+    get cases() {
+        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._cases) {
+            this._cases = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'NotificationModule:ConversationFeedback',
+                targetEntity: 'SupportModule:Case',
+                targetModuleName: 'SupportModule',
+                targetEntityName: 'Case',
+                labels: ['Conversation_Case'],
+            }, CaseRecord_1.CaseRecord);
+        }
+        return this._cases;
+    }
+    /**
+     * Access linked Conversation records
+     * @remarks Available labels: ConversationFeedback_Conversation
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Conversation records
+     * const items = await record.conversations.list();
+     * const first = await record.conversations.first();
+     *
+     * // Filter by label
+     * const specific = await record.conversations.first({ label: 'ConversationFeedback_Conversation' });
+     * ```
+     */
+    get conversations() {
+        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._conversations) {
+            this._conversations = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'NotificationModule:ConversationFeedback',
+                targetEntity: 'NotificationModule:Conversation',
+                targetModuleName: 'NotificationModule',
+                targetEntityName: 'Conversation',
+                labels: ['ConversationFeedback_Conversation'],
+            }, ConversationRecord_1.ConversationRecord);
+        }
+        return this._conversations;
+    }
+    /**
+     * Access linked Contact records
+     * @remarks Available labels: ConversationFeedback_Contact
+     * @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: 'ConversationFeedback_Contact' });
+     * ```
+     */
+    get contacts() {
+        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._contacts) {
+            this._contacts = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'NotificationModule:ConversationFeedback',
+                targetEntity: 'CrmModule:Contact',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Contact',
+                labels: ['ConversationFeedback_Contact'],
+            }, ContactRecord_1.ContactRecord);
+        }
+        return this._contacts;
+    }
+    /**
+     * Access linked User records
+     * @remarks Available labels: ConversationFeedback_User
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked User records
+     * const items = await record.users.list();
+     * const first = await record.users.first();
+     *
+     * // Filter by label
+     * const specific = await record.users.first({ label: 'ConversationFeedback_User' });
+     * ```
+     */
+    get users() {
+        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._users) {
+            this._users = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'NotificationModule:ConversationFeedback',
+                targetEntity: 'IdentityModule:User',
+                targetModuleName: 'IdentityModule',
+                targetEntityName: 'User',
+                labels: ['ConversationFeedback_User'],
+            }, UserRecord_1.UserRecord);
+        }
+        return this._users;
+    }
+    // ============================================
     // LINK MANAGEMENT
     // ============================================
     /**
@@ -215,6 +361,17 @@ class ConversationFeedbackRecord {
     }
 }
 exports.ConversationFeedbackRecord = ConversationFeedbackRecord;
+// ============================================
+// TYPED LINK ACCESSORS
+// ============================================
+/** Valid labels for Case associations */
+ConversationFeedbackRecord.casesLabels = ['Conversation_Case'];
+/** Valid labels for Conversation associations */
+ConversationFeedbackRecord.conversationsLabels = ['ConversationFeedback_Conversation'];
+/** Valid labels for Contact associations */
+ConversationFeedbackRecord.contactsLabels = ['ConversationFeedback_Contact'];
+/** Valid labels for User associations */
+ConversationFeedbackRecord.usersLabels = ['ConversationFeedback_User'];
 /** Type guard to check if an object is a ConversationFeedbackRecord */
 function isConversationFeedbackRecord(obj) {
     return obj instanceof ConversationFeedbackRecord;

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

@@ -13,18 +13,27 @@
  * await record.createConversation({ ... }).execute();
  * ```
  *
+ * Entity Types: DEFAULT
+ *
  * 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 { RecordLinkManager } from '@d19n/odin-sdk-generator/dist/record-link-manager';
 import { ConversationProperties } from '../entities-v2/Conversation';
 import { CloseConversationProperties } from '../actions-v2/CloseConversationDto';
 import { CreateConversationProperties } from '../actions-v2/CreateConversationDto';
 import { ReopenConversationProperties } from '../actions-v2/ReopenConversationDto';
 import { UpdateConversationProperties } from '../actions-v2/UpdateConversationDto';
 import { UpdateConversationSummaryProperties } from '../actions-v2/UpdateConversationSummaryDto';
+import { MessageRecord } from './MessageRecord';
+import { CaseRecord } from './CaseRecord';
+import { ConversationFeedbackRecord } from './ConversationFeedbackRecord';
+import { PushNotificationRecord } from './PushNotificationRecord';
+/** Valid entity types for Conversation */
+export declare type ConversationType = 'DEFAULT';
 /**
  * Builder for action execution with dryRun support
  *
@@ -88,6 +97,10 @@ export declare class ConversationRecord<TProps = ConversationProperties> {
     private _provider;
     private _pendingLinks;
     private _preGeneratedId;
+    private _messages?;
+    private _cases?;
+    private _conversationFeedbacks?;
+    private _pushNotifications?;
     /**
      * Create a record wrapper.
      * @param record - The underlying record, or null for create operations
@@ -100,7 +113,7 @@ export declare class ConversationRecord<TProps = ConversationProperties> {
     /** Record ID - always available (pre-generated for new records) */
     get id(): string;
     get entity(): string;
-    get type(): string | undefined;
+    get type(): ConversationType | undefined;
     /** Record properties - empty object for new (unsaved) records */
     get properties(): TProps;
     get title(): string | undefined;
@@ -113,6 +126,94 @@ export declare class ConversationRecord<TProps = ConversationProperties> {
     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 DEFAULT
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to DEFAULT-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isDefault()) {
+     *   // TypeScript knows record.properties is ConversationProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks This is the default record type
+     */
+    isDefault(): this is ConversationRecord<ConversationProperties>;
+    /** Valid labels for Message associations */
+    static readonly messagesLabels: readonly ["Conversation_Message"];
+    /**
+     * Access linked Message records
+     * @remarks Available labels: Conversation_Message
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Message records
+     * const items = await record.messages.list();
+     * const first = await record.messages.first();
+     *
+     * // Filter by label
+     * const specific = await record.messages.first({ label: 'Conversation_Message' });
+     * ```
+     */
+    get messages(): RecordLinkManager<MessageRecord, typeof ConversationRecord['messagesLabels'][number]>;
+    /** Valid labels for Case associations */
+    static readonly casesLabels: readonly ["Case_Conversation"];
+    /**
+     * Access linked Case records
+     * @remarks Available labels: Case_Conversation
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Case records
+     * const items = await record.cases.list();
+     * const first = await record.cases.first();
+     *
+     * // Filter by label
+     * const specific = await record.cases.first({ label: 'Case_Conversation' });
+     * ```
+     */
+    get cases(): RecordLinkManager<CaseRecord, typeof ConversationRecord['casesLabels'][number]>;
+    /** Valid labels for ConversationFeedback associations */
+    static readonly conversationFeedbacksLabels: readonly ["ConversationFeedback_Conversation"];
+    /**
+     * Access linked ConversationFeedback records
+     * @remarks Available labels: ConversationFeedback_Conversation
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked ConversationFeedback records
+     * const items = await record.conversationFeedbacks.list();
+     * const first = await record.conversationFeedbacks.first();
+     *
+     * // Filter by label
+     * const specific = await record.conversationFeedbacks.first({ label: 'ConversationFeedback_Conversation' });
+     * ```
+     */
+    get conversationFeedbacks(): RecordLinkManager<ConversationFeedbackRecord, typeof ConversationRecord['conversationFeedbacksLabels'][number]>;
+    /** Valid labels for PushNotification associations */
+    static readonly pushNotificationsLabels: readonly ["Conversation__PushNotification"];
+    /**
+     * Access linked PushNotification records
+     * @remarks Available labels: Conversation__PushNotification
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked PushNotification records
+     * const items = await record.pushNotifications.list();
+     * const first = await record.pushNotifications.first();
+     *
+     * // Filter by label
+     * const specific = await record.pushNotifications.first({ label: 'Conversation__PushNotification' });
+     * ```
+     */
+    get pushNotifications(): RecordLinkManager<PushNotificationRecord, typeof ConversationRecord['pushNotificationsLabels'][number]>;
     /**
      * Queue a link to be created with the next action.
      * Works for both create and update actions.

package/dist/records-v2/ConversationRecord.js

@@ -14,6 +14,8 @@
  * await record.createConversation({ ... }).execute();
  * ```
  *
+ * Entity Types: DEFAULT
+ *
  * AUTO-GENERATED - DO NOT EDIT DIRECTLY
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
@@ -29,6 +31,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isConversationRecord = exports.ConversationRecord = 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 MessageRecord_1 = require("./MessageRecord");
+const CaseRecord_1 = require("./CaseRecord");
+const ConversationFeedbackRecord_1 = require("./ConversationFeedbackRecord");
+const PushNotificationRecord_1 = require("./PushNotificationRecord");
 /**
  * Builder for action execution with dryRun support
  *
@@ -140,6 +147,145 @@ class ConversationRecord {
     /** Access the underlying OdinRecord (null for new records) */
     get record() { return this._record; }
     // ============================================
+    // TYPE GUARDS (with TypeScript type predicates)
+    // ============================================
+    /**
+     * Type guard: check if this record is of type DEFAULT
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to DEFAULT-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isDefault()) {
+     *   // TypeScript knows record.properties is ConversationProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks This is the default record type
+     */
+    isDefault() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.type) === 'DEFAULT'; }
+    /**
+     * Access linked Message records
+     * @remarks Available labels: Conversation_Message
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Message records
+     * const items = await record.messages.list();
+     * const first = await record.messages.first();
+     *
+     * // Filter by label
+     * const specific = await record.messages.first({ label: 'Conversation_Message' });
+     * ```
+     */
+    get messages() {
+        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._messages) {
+            this._messages = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'NotificationModule:Conversation',
+                targetEntity: 'NotificationModule:Message',
+                targetModuleName: 'NotificationModule',
+                targetEntityName: 'Message',
+                labels: ['Conversation_Message'],
+            }, MessageRecord_1.MessageRecord);
+        }
+        return this._messages;
+    }
+    /**
+     * Access linked Case records
+     * @remarks Available labels: Case_Conversation
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Case records
+     * const items = await record.cases.list();
+     * const first = await record.cases.first();
+     *
+     * // Filter by label
+     * const specific = await record.cases.first({ label: 'Case_Conversation' });
+     * ```
+     */
+    get cases() {
+        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._cases) {
+            this._cases = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'NotificationModule:Conversation',
+                targetEntity: 'SupportModule:Case',
+                targetModuleName: 'SupportModule',
+                targetEntityName: 'Case',
+                labels: ['Case_Conversation'],
+            }, CaseRecord_1.CaseRecord);
+        }
+        return this._cases;
+    }
+    /**
+     * Access linked ConversationFeedback records
+     * @remarks Available labels: ConversationFeedback_Conversation
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked ConversationFeedback records
+     * const items = await record.conversationFeedbacks.list();
+     * const first = await record.conversationFeedbacks.first();
+     *
+     * // Filter by label
+     * const specific = await record.conversationFeedbacks.first({ label: 'ConversationFeedback_Conversation' });
+     * ```
+     */
+    get conversationFeedbacks() {
+        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._conversationFeedbacks) {
+            this._conversationFeedbacks = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'NotificationModule:Conversation',
+                targetEntity: 'NotificationModule:ConversationFeedback',
+                targetModuleName: 'NotificationModule',
+                targetEntityName: 'ConversationFeedback',
+                labels: ['ConversationFeedback_Conversation'],
+            }, ConversationFeedbackRecord_1.ConversationFeedbackRecord);
+        }
+        return this._conversationFeedbacks;
+    }
+    /**
+     * Access linked PushNotification records
+     * @remarks Available labels: Conversation__PushNotification
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked PushNotification records
+     * const items = await record.pushNotifications.list();
+     * const first = await record.pushNotifications.first();
+     *
+     * // Filter by label
+     * const specific = await record.pushNotifications.first({ label: 'Conversation__PushNotification' });
+     * ```
+     */
+    get pushNotifications() {
+        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._pushNotifications) {
+            this._pushNotifications = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'NotificationModule:Conversation',
+                targetEntity: 'NotificationModule:PushNotification',
+                targetModuleName: 'NotificationModule',
+                targetEntityName: 'PushNotification',
+                labels: ['Conversation__PushNotification'],
+            }, PushNotificationRecord_1.PushNotificationRecord);
+        }
+        return this._pushNotifications;
+    }
+    // ============================================
     // LINK MANAGEMENT
     // ============================================
     /**
@@ -334,6 +480,17 @@ class ConversationRecord {
     }
 }
 exports.ConversationRecord = ConversationRecord;
+// ============================================
+// TYPED LINK ACCESSORS
+// ============================================
+/** Valid labels for Message associations */
+ConversationRecord.messagesLabels = ['Conversation_Message'];
+/** Valid labels for Case associations */
+ConversationRecord.casesLabels = ['Case_Conversation'];
+/** Valid labels for ConversationFeedback associations */
+ConversationRecord.conversationFeedbacksLabels = ['ConversationFeedback_Conversation'];
+/** Valid labels for PushNotification associations */
+ConversationRecord.pushNotificationsLabels = ['Conversation__PushNotification'];
 /** Type guard to check if an object is a ConversationRecord */
 function isConversationRecord(obj) {
     return obj instanceof ConversationRecord;

package/dist/records-v2/CreditNoteRecord.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 { CreditNoteProperties } from '../entities-v2/CreditNote';
 import { CreditNoteCreateProperties } from '../actions-v2/CreditNoteCreateDto';
 import { CreditNoteUpdateProperties } from '../actions-v2/CreditNoteUpdateDto';
+import { TransactionRecord } from './TransactionRecord';
+import { NoteRecord } from './NoteRecord';
+import { InvoiceRecord } from './InvoiceRecord';
+import { FileRecord } from './FileRecord';
 /**
  * Builder for action execution with dryRun support
  *
@@ -85,6 +90,10 @@ export declare class CreditNoteRecord<TProps = CreditNoteProperties> {
     private _provider;
     private _pendingLinks;
     private _preGeneratedId;
+    private _transactions?;
+    private _notes?;
+    private _invoices?;
+    private _files?;
     /**
      * Create a record wrapper.
      * @param record - The underlying record, or null for create operations
@@ -110,6 +119,78 @@ export declare class CreditNoteRecord<TProps = CreditNoteProperties> {
     get groups(): string[];
     /** Access the underlying OdinRecord (null for new records) */
     get record(): OdinRecord<TProps> | null;
+    /** Valid labels for Transaction associations */
+    static readonly transactionsLabels: readonly ["CreditNote__Transaction"];
+    /**
+     * Access linked Transaction records
+     * @remarks Available labels: CreditNote__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: 'CreditNote__Transaction' });
+     * ```
+     */
+    get transactions(): RecordLinkManager<TransactionRecord, typeof CreditNoteRecord['transactionsLabels'][number]>;
+    /** Valid labels for Note associations */
+    static readonly notesLabels: readonly ["CreditNote__Note"];
+    /**
+     * Access linked Note records
+     * @remarks Available labels: CreditNote__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: 'CreditNote__Note' });
+     * ```
+     */
+    get notes(): RecordLinkManager<NoteRecord, typeof CreditNoteRecord['notesLabels'][number]>;
+    /** Valid labels for Invoice associations */
+    static readonly invoicesLabels: readonly ["Invoice__CreditNote"];
+    /**
+     * Access linked Invoice records
+     * @remarks Available labels: Invoice__CreditNote
+     * @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__CreditNote' });
+     * ```
+     */
+    get invoices(): RecordLinkManager<InvoiceRecord, typeof CreditNoteRecord['invoicesLabels'][number]>;
+    /** Valid labels for File associations */
+    static readonly filesLabels: readonly ["CreditNote__File"];
+    /**
+     * Access linked File records
+     * @remarks Available labels: CreditNote__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: 'CreditNote__File' });
+     * ```
+     */
+    get files(): RecordLinkManager<FileRecord, typeof CreditNoteRecord['filesLabels'][number]>;
     /**
      * Queue a link to be created with the next action.
      * Works for both create and update actions.