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

package/dist/records-v2/LeadRecord.js

@@ -29,6 +29,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isLeadRecord = exports.LeadRecord = 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 NoteRecord_1 = require("./NoteRecord");
+const CallRecord_1 = require("./CallRecord");
+const OfferRecord_1 = require("./OfferRecord");
+const DiscountRecord_1 = require("./DiscountRecord");
+const ProductRecord_1 = require("./ProductRecord");
+const ContactRecord_1 = require("./ContactRecord");
+const OrderRecord_1 = require("./OrderRecord");
+const FileRecord_1 = require("./FileRecord");
+const WorkOrderRecord_1 = require("./WorkOrderRecord");
+const CrmDatasetRecord_1 = require("./CrmDatasetRecord");
+const VisitRecord_1 = require("./VisitRecord");
+const AddressRecord_1 = require("./AddressRecord");
+const AppointmentRecord_1 = require("./AppointmentRecord");
 /**
  * Builder for action execution with dryRun support
  *
@@ -139,6 +153,396 @@ class LeadRecord {
     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 Note records
+     * @remarks Available labels: Lead__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: 'Lead__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: 'CrmModule:Lead',
+                targetEntity: 'SupportModule:Note',
+                targetModuleName: 'SupportModule',
+                targetEntityName: 'Note',
+                labels: ['Lead__Note'],
+            }, NoteRecord_1.NoteRecord);
+        }
+        return this._notes;
+    }
+    /**
+     * Access linked Call records
+     * @remarks Available labels: Call__Lead
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Call records
+     * const items = await record.calls.list();
+     * const first = await record.calls.first();
+     *
+     * // Filter by label
+     * const specific = await record.calls.first({ label: 'Call__Lead' });
+     * ```
+     */
+    get calls() {
+        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._calls) {
+            this._calls = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:Lead',
+                targetEntity: 'NotificationModule:Call',
+                targetModuleName: 'NotificationModule',
+                targetEntityName: 'Call',
+                labels: ['Call__Lead'],
+            }, CallRecord_1.CallRecord);
+        }
+        return this._calls;
+    }
+    /**
+     * Access linked Offer records
+     * @remarks Available labels: Lead__Offer
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Offer records
+     * const items = await record.offers.list();
+     * const first = await record.offers.first();
+     *
+     * // Filter by label
+     * const specific = await record.offers.first({ label: 'Lead__Offer' });
+     * ```
+     */
+    get offers() {
+        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._offers) {
+            this._offers = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:Lead',
+                targetEntity: 'ProductModule:Offer',
+                targetModuleName: 'ProductModule',
+                targetEntityName: 'Offer',
+                labels: ['Lead__Offer'],
+            }, OfferRecord_1.OfferRecord);
+        }
+        return this._offers;
+    }
+    /**
+     * Access linked Discount records
+     * @remarks Available labels: Lead__Discount
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Discount records
+     * const items = await record.discounts.list();
+     * const first = await record.discounts.first();
+     *
+     * // Filter by label
+     * const specific = await record.discounts.first({ label: 'Lead__Discount' });
+     * ```
+     */
+    get discounts() {
+        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._discounts) {
+            this._discounts = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:Lead',
+                targetEntity: 'ProductModule:Discount',
+                targetModuleName: 'ProductModule',
+                targetEntityName: 'Discount',
+                labels: ['Lead__Discount'],
+            }, DiscountRecord_1.DiscountRecord);
+        }
+        return this._discounts;
+    }
+    /**
+     * Access linked Product records
+     * @remarks Available labels: Lead__Product
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Product records
+     * const items = await record.products.list();
+     * const first = await record.products.first();
+     *
+     * // Filter by label
+     * const specific = await record.products.first({ label: 'Lead__Product' });
+     * ```
+     */
+    get products() {
+        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._products) {
+            this._products = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:Lead',
+                targetEntity: 'ProductModule:Product',
+                targetModuleName: 'ProductModule',
+                targetEntityName: 'Product',
+                labels: ['Lead__Product'],
+            }, ProductRecord_1.ProductRecord);
+        }
+        return this._products;
+    }
+    /**
+     * Access linked Contact records
+     * @remarks Available labels: Lead__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: 'Lead__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: 'CrmModule:Lead',
+                targetEntity: 'CrmModule:Contact',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Contact',
+                labels: ['Lead__Contact'],
+            }, ContactRecord_1.ContactRecord);
+        }
+        return this._contacts;
+    }
+    /**
+     * Access linked Order records
+     * @remarks Available labels: Lead_Order
+     * @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: 'Lead_Order' });
+     * ```
+     */
+    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: 'CrmModule:Lead',
+                targetEntity: 'OrderModule:Order',
+                targetModuleName: 'OrderModule',
+                targetEntityName: 'Order',
+                labels: ['Lead_Order'],
+            }, OrderRecord_1.OrderRecord);
+        }
+        return this._orders;
+    }
+    /**
+     * Access linked File records
+     * @remarks Available labels: Lead__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: 'Lead__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: 'CrmModule:Lead',
+                targetEntity: 'SchemaModule:File',
+                targetModuleName: 'SchemaModule',
+                targetEntityName: 'File',
+                labels: ['Lead__File'],
+            }, FileRecord_1.FileRecord);
+        }
+        return this._files;
+    }
+    /**
+     * Access linked WorkOrder records
+     * @remarks Available labels: WorkOrder__Lead
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked WorkOrder records
+     * const items = await record.workOrders.list();
+     * const first = await record.workOrders.first();
+     *
+     * // Filter by label
+     * const specific = await record.workOrders.first({ label: 'WorkOrder__Lead' });
+     * ```
+     */
+    get workOrders() {
+        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._workOrders) {
+            this._workOrders = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:Lead',
+                targetEntity: 'FieldServiceModule:WorkOrder',
+                targetModuleName: 'FieldServiceModule',
+                targetEntityName: 'WorkOrder',
+                labels: ['WorkOrder__Lead'],
+            }, WorkOrderRecord_1.WorkOrderRecord);
+        }
+        return this._workOrders;
+    }
+    /**
+     * Access linked CrmDataset records
+     * @remarks Available labels: CrmDataset__Lead
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked CrmDataset records
+     * const items = await record.crmDatasets.list();
+     * const first = await record.crmDatasets.first();
+     *
+     * // Filter by label
+     * const specific = await record.crmDatasets.first({ label: 'CrmDataset__Lead' });
+     * ```
+     */
+    get crmDatasets() {
+        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._crmDatasets) {
+            this._crmDatasets = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:Lead',
+                targetEntity: 'CrmModule:CrmDataset',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'CrmDataset',
+                labels: ['CrmDataset__Lead'],
+            }, CrmDatasetRecord_1.CrmDatasetRecord);
+        }
+        return this._crmDatasets;
+    }
+    /**
+     * Access linked Visit records
+     * @remarks Available labels: Lead__Visit
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Visit records
+     * const items = await record.visits.list();
+     * const first = await record.visits.first();
+     *
+     * // Filter by label
+     * const specific = await record.visits.first({ label: 'Lead__Visit' });
+     * ```
+     */
+    get visits() {
+        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._visits) {
+            this._visits = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:Lead',
+                targetEntity: 'CrmModule:Visit',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Visit',
+                labels: ['Lead__Visit'],
+            }, VisitRecord_1.VisitRecord);
+        }
+        return this._visits;
+    }
+    /**
+     * Access linked Address records
+     * @remarks Available labels: Lead_Address
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Address records
+     * const items = await record.addresses.list();
+     * const first = await record.addresses.first();
+     *
+     * // Filter by label
+     * const specific = await record.addresses.first({ label: 'Lead_Address' });
+     * ```
+     */
+    get addresses() {
+        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._addresses) {
+            this._addresses = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:Lead',
+                targetEntity: 'CrmModule:Address',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Address',
+                labels: ['Lead_Address'],
+            }, AddressRecord_1.AddressRecord);
+        }
+        return this._addresses;
+    }
+    /**
+     * Access linked Appointment records
+     * @remarks Available labels: Lead_Appointment
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Appointment records
+     * const items = await record.appointments.list();
+     * const first = await record.appointments.first();
+     *
+     * // Filter by label
+     * const specific = await record.appointments.first({ label: 'Lead_Appointment' });
+     * ```
+     */
+    get appointments() {
+        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._appointments) {
+            this._appointments = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:Lead',
+                targetEntity: 'CrmModule:Appointment',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Appointment',
+                labels: ['Lead_Appointment'],
+            }, AppointmentRecord_1.AppointmentRecord);
+        }
+        return this._appointments;
+    }
     // ============================================
     // LINK MANAGEMENT
     // ============================================
@@ -399,6 +803,35 @@ class LeadRecord {
     }
 }
 exports.LeadRecord = LeadRecord;
+// ============================================
+// TYPED LINK ACCESSORS
+// ============================================
+/** Valid labels for Note associations */
+LeadRecord.notesLabels = ['Lead__Note'];
+/** Valid labels for Call associations */
+LeadRecord.callsLabels = ['Call__Lead'];
+/** Valid labels for Offer associations */
+LeadRecord.offersLabels = ['Lead__Offer'];
+/** Valid labels for Discount associations */
+LeadRecord.discountsLabels = ['Lead__Discount'];
+/** Valid labels for Product associations */
+LeadRecord.productsLabels = ['Lead__Product'];
+/** Valid labels for Contact associations */
+LeadRecord.contactsLabels = ['Lead__Contact'];
+/** Valid labels for Order associations */
+LeadRecord.ordersLabels = ['Lead_Order'];
+/** Valid labels for File associations */
+LeadRecord.filesLabels = ['Lead__File'];
+/** Valid labels for WorkOrder associations */
+LeadRecord.workOrdersLabels = ['WorkOrder__Lead'];
+/** Valid labels for CrmDataset associations */
+LeadRecord.crmDatasetsLabels = ['CrmDataset__Lead'];
+/** Valid labels for Visit associations */
+LeadRecord.visitsLabels = ['Lead__Visit'];
+/** Valid labels for Address associations */
+LeadRecord.addressesLabels = ['Lead_Address'];
+/** Valid labels for Appointment associations */
+LeadRecord.appointmentsLabels = ['Lead_Appointment'];
 /** Type guard to check if an object is a LeadRecord */
 function isLeadRecord(obj) {
     return obj instanceof LeadRecord;

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

@@ -13,14 +13,22 @@
  * await record.createMessage({ ... }).execute();
  * ```
  *
+ * Entity Types: DEFAULT, EVENT
+ *
  * 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 { MessageProperties } from '../entities-v2/Message';
+import { RecordLinkManager } from '@d19n/odin-sdk-generator/dist/record-link-manager';
+import { MessageProperties, EventMessageProperties } from '../entities-v2/Message';
 import { CreateMessageProperties } from '../actions-v2/CreateMessageDto';
+import { ConversationRecord } from './ConversationRecord';
+import { FileRecord } from './FileRecord';
+import { PushNotificationRecord } from './PushNotificationRecord';
+/** Valid entity types for Message */
+export declare type MessageType = 'DEFAULT' | 'EVENT';
 /**
  * Builder for action execution with dryRun support
  *
@@ -84,6 +92,9 @@ export declare class MessageRecord<TProps = MessageProperties> {
     private _provider;
     private _pendingLinks;
     private _preGeneratedId;
+    private _conversations?;
+    private _files?;
+    private _pushNotifications?;
     /**
      * Create a record wrapper.
      * @param record - The underlying record, or null for create operations
@@ -96,7 +107,7 @@ export declare class MessageRecord<TProps = MessageProperties> {
     /** Record ID - always available (pre-generated for new records) */
     get id(): string;
     get entity(): string;
-    get type(): string | undefined;
+    get type(): MessageType | undefined;
     /** Record properties - empty object for new (unsaved) records */
     get properties(): TProps;
     get title(): string | undefined;
@@ -109,6 +120,92 @@ export declare class MessageRecord<TProps = MessageProperties> {
     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 MessageProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks This is the default record type
+     */
+    isDefault(): this is MessageRecord<MessageProperties>;
+    /**
+     * Type guard: check if this record is of type EVENT
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to EVENT-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isEvent()) {
+     *   // TypeScript knows record.properties is EventMessageProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks event
+     */
+    isEvent(): this is MessageRecord<EventMessageProperties>;
+    /** Valid labels for Conversation associations */
+    static readonly conversationsLabels: readonly ["Conversation_Message"];
+    /**
+     * Access linked Conversation records
+     * @remarks Available labels: Conversation_Message
+     * @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: 'Conversation_Message' });
+     * ```
+     */
+    get conversations(): RecordLinkManager<ConversationRecord, typeof MessageRecord['conversationsLabels'][number]>;
+    /** Valid labels for File associations */
+    static readonly filesLabels: readonly ["Message_File"];
+    /**
+     * Access linked File records
+     * @remarks Available labels: Message_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: 'Message_File' });
+     * ```
+     */
+    get files(): RecordLinkManager<FileRecord, typeof MessageRecord['filesLabels'][number]>;
+    /** Valid labels for PushNotification associations */
+    static readonly pushNotificationsLabels: readonly ["Message__PushNotification"];
+    /**
+     * Access linked PushNotification records
+     * @remarks Available labels: Message__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: 'Message__PushNotification' });
+     * ```
+     */
+    get pushNotifications(): RecordLinkManager<PushNotificationRecord, typeof MessageRecord['pushNotificationsLabels'][number]>;
     /**
      * Queue a link to be created with the next action.
      * Works for both create and update actions.