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

package/dist/records-v2/AffiliateCodeRecord.js

@@ -14,6 +14,8 @@
  * await record.createAffiliateCode({ ... }).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.isAffiliateCodeRecord = exports.AffiliateCodeRecord = 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 CampaignRecord_1 = require("./CampaignRecord");
+const ContactRecord_1 = require("./ContactRecord");
+const ReferralRecord_1 = require("./ReferralRecord");
+const RewardRecord_1 = require("./RewardRecord");
 /**
  * Builder for action execution with dryRun support
  *
@@ -140,6 +147,145 @@ class AffiliateCodeRecord {
     /** 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 AffiliateCodeProperties
+     *   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 Campaign records
+     * @remarks Available labels: CampaignAffiliateCodes
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Campaign records
+     * const items = await record.campaigns.list();
+     * const first = await record.campaigns.first();
+     *
+     * // Filter by label
+     * const specific = await record.campaigns.first({ label: 'CampaignAffiliateCodes' });
+     * ```
+     */
+    get campaigns() {
+        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._campaigns) {
+            this._campaigns = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:AffiliateCode',
+                targetEntity: 'CrmModule:Campaign',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Campaign',
+                labels: ['CampaignAffiliateCodes'],
+            }, CampaignRecord_1.CampaignRecord);
+        }
+        return this._campaigns;
+    }
+    /**
+     * Access linked Contact records
+     * @remarks Available labels: ContactAffiliateCodes
+     * @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: 'ContactAffiliateCodes' });
+     * ```
+     */
+    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:AffiliateCode',
+                targetEntity: 'CrmModule:Contact',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Contact',
+                labels: ['ContactAffiliateCodes'],
+            }, ContactRecord_1.ContactRecord);
+        }
+        return this._contacts;
+    }
+    /**
+     * Access linked Referral records
+     * @remarks Available labels: AffiliateCodeReferrals
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Referral records
+     * const items = await record.referrals.list();
+     * const first = await record.referrals.first();
+     *
+     * // Filter by label
+     * const specific = await record.referrals.first({ label: 'AffiliateCodeReferrals' });
+     * ```
+     */
+    get referrals() {
+        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._referrals) {
+            this._referrals = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:AffiliateCode',
+                targetEntity: 'CrmModule:Referral',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Referral',
+                labels: ['AffiliateCodeReferrals'],
+            }, ReferralRecord_1.ReferralRecord);
+        }
+        return this._referrals;
+    }
+    /**
+     * Access linked Reward records
+     * @remarks Available labels: AffiliateCodeRewards
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Reward records
+     * const items = await record.rewards.list();
+     * const first = await record.rewards.first();
+     *
+     * // Filter by label
+     * const specific = await record.rewards.first({ label: 'AffiliateCodeRewards' });
+     * ```
+     */
+    get rewards() {
+        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._rewards) {
+            this._rewards = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:AffiliateCode',
+                targetEntity: 'CrmModule:Reward',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Reward',
+                labels: ['AffiliateCodeRewards'],
+            }, RewardRecord_1.RewardRecord);
+        }
+        return this._rewards;
+    }
+    // ============================================
     // LINK MANAGEMENT
     // ============================================
     /**
@@ -215,6 +361,17 @@ class AffiliateCodeRecord {
     }
 }
 exports.AffiliateCodeRecord = AffiliateCodeRecord;
+// ============================================
+// TYPED LINK ACCESSORS
+// ============================================
+/** Valid labels for Campaign associations */
+AffiliateCodeRecord.campaignsLabels = ['CampaignAffiliateCodes'];
+/** Valid labels for Contact associations */
+AffiliateCodeRecord.contactsLabels = ['ContactAffiliateCodes'];
+/** Valid labels for Referral associations */
+AffiliateCodeRecord.referralsLabels = ['AffiliateCodeReferrals'];
+/** Valid labels for Reward associations */
+AffiliateCodeRecord.rewardsLabels = ['AffiliateCodeRewards'];
 /** Type guard to check if an object is a AffiliateCodeRecord */
 function isAffiliateCodeRecord(obj) {
     return obj instanceof AffiliateCodeRecord;

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

@@ -19,8 +19,16 @@ 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 { AppointmentProperties } from '../entities-v2/Appointment';
 import { CreateAppointmentProperties } from '../actions-v2/CreateAppointmentDto';
+import { FileRecord } from './FileRecord';
+import { AddressRecord } from './AddressRecord';
+import { NoteRecord } from './NoteRecord';
+import { VisitRecord } from './VisitRecord';
+import { ContactRecord } from './ContactRecord';
+import { OrderRecord } from './OrderRecord';
+import { LeadRecord } from './LeadRecord';
 /**
  * Builder for action execution with dryRun support
  *
@@ -84,6 +92,13 @@ export declare class AppointmentRecord<TProps = AppointmentProperties> {
     private _provider;
     private _pendingLinks;
     private _preGeneratedId;
+    private _files?;
+    private _addresses?;
+    private _notes?;
+    private _visits?;
+    private _contacts?;
+    private _orders?;
+    private _leads?;
     /**
      * Create a record wrapper.
      * @param record - The underlying record, or null for create operations
@@ -109,6 +124,132 @@ export declare class AppointmentRecord<TProps = AppointmentProperties> {
     get groups(): string[];
     /** Access the underlying OdinRecord (null for new records) */
     get record(): OdinRecord<TProps> | null;
+    /** Valid labels for File associations */
+    static readonly filesLabels: readonly ["Appointment__File"];
+    /**
+     * Access linked File records
+     * @remarks Available labels: Appointment__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: 'Appointment__File' });
+     * ```
+     */
+    get files(): RecordLinkManager<FileRecord, typeof AppointmentRecord['filesLabels'][number]>;
+    /** Valid labels for Address associations */
+    static readonly addressesLabels: readonly ["Address__Appointment"];
+    /**
+     * Access linked Address records
+     * @remarks Available labels: Address__Appointment
+     * @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: 'Address__Appointment' });
+     * ```
+     */
+    get addresses(): RecordLinkManager<AddressRecord, typeof AppointmentRecord['addressesLabels'][number]>;
+    /** Valid labels for Note associations */
+    static readonly notesLabels: readonly ["Appointment__Note"];
+    /**
+     * Access linked Note records
+     * @remarks Available labels: Appointment__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: 'Appointment__Note' });
+     * ```
+     */
+    get notes(): RecordLinkManager<NoteRecord, typeof AppointmentRecord['notesLabels'][number]>;
+    /** Valid labels for Visit associations */
+    static readonly visitsLabels: readonly ["Visit__Appointment"];
+    /**
+     * Access linked Visit records
+     * @remarks Available labels: Visit__Appointment
+     * @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: 'Visit__Appointment' });
+     * ```
+     */
+    get visits(): RecordLinkManager<VisitRecord, typeof AppointmentRecord['visitsLabels'][number]>;
+    /** Valid labels for Contact associations */
+    static readonly contactsLabels: readonly ["Contact__Appointment"];
+    /**
+     * Access linked Contact records
+     * @remarks Available labels: Contact__Appointment
+     * @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__Appointment' });
+     * ```
+     */
+    get contacts(): RecordLinkManager<ContactRecord, typeof AppointmentRecord['contactsLabels'][number]>;
+    /** Valid labels for Order associations */
+    static readonly ordersLabels: readonly ["Order__Appointment"];
+    /**
+     * Access linked Order records
+     * @remarks Available labels: Order__Appointment
+     * @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__Appointment' });
+     * ```
+     */
+    get orders(): RecordLinkManager<OrderRecord, typeof AppointmentRecord['ordersLabels'][number]>;
+    /** Valid labels for Lead associations */
+    static readonly leadsLabels: readonly ["Lead_Appointment"];
+    /**
+     * Access linked Lead records
+     * @remarks Available labels: Lead_Appointment
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Lead records
+     * const items = await record.leads.list();
+     * const first = await record.leads.first();
+     *
+     * // Filter by label
+     * const specific = await record.leads.first({ label: 'Lead_Appointment' });
+     * ```
+     */
+    get leads(): RecordLinkManager<LeadRecord, typeof AppointmentRecord['leadsLabels'][number]>;
     /**
      * Queue a link to be created with the next action.
      * Works for both create and update actions.

package/dist/records-v2/AppointmentRecord.js

@@ -29,6 +29,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isAppointmentRecord = exports.AppointmentRecord = 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 FileRecord_1 = require("./FileRecord");
+const AddressRecord_1 = require("./AddressRecord");
+const NoteRecord_1 = require("./NoteRecord");
+const VisitRecord_1 = require("./VisitRecord");
+const ContactRecord_1 = require("./ContactRecord");
+const OrderRecord_1 = require("./OrderRecord");
+const LeadRecord_1 = require("./LeadRecord");
 /**
  * Builder for action execution with dryRun support
  *
@@ -139,6 +147,216 @@ class AppointmentRecord {
     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 File records
+     * @remarks Available labels: Appointment__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: 'Appointment__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:Appointment',
+                targetEntity: 'SchemaModule:File',
+                targetModuleName: 'SchemaModule',
+                targetEntityName: 'File',
+                labels: ['Appointment__File'],
+            }, FileRecord_1.FileRecord);
+        }
+        return this._files;
+    }
+    /**
+     * Access linked Address records
+     * @remarks Available labels: Address__Appointment
+     * @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: 'Address__Appointment' });
+     * ```
+     */
+    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:Appointment',
+                targetEntity: 'CrmModule:Address',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Address',
+                labels: ['Address__Appointment'],
+            }, AddressRecord_1.AddressRecord);
+        }
+        return this._addresses;
+    }
+    /**
+     * Access linked Note records
+     * @remarks Available labels: Appointment__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: 'Appointment__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:Appointment',
+                targetEntity: 'SupportModule:Note',
+                targetModuleName: 'SupportModule',
+                targetEntityName: 'Note',
+                labels: ['Appointment__Note'],
+            }, NoteRecord_1.NoteRecord);
+        }
+        return this._notes;
+    }
+    /**
+     * Access linked Visit records
+     * @remarks Available labels: Visit__Appointment
+     * @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: 'Visit__Appointment' });
+     * ```
+     */
+    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:Appointment',
+                targetEntity: 'CrmModule:Visit',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Visit',
+                labels: ['Visit__Appointment'],
+            }, VisitRecord_1.VisitRecord);
+        }
+        return this._visits;
+    }
+    /**
+     * Access linked Contact records
+     * @remarks Available labels: Contact__Appointment
+     * @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__Appointment' });
+     * ```
+     */
+    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:Appointment',
+                targetEntity: 'CrmModule:Contact',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Contact',
+                labels: ['Contact__Appointment'],
+            }, ContactRecord_1.ContactRecord);
+        }
+        return this._contacts;
+    }
+    /**
+     * Access linked Order records
+     * @remarks Available labels: Order__Appointment
+     * @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__Appointment' });
+     * ```
+     */
+    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:Appointment',
+                targetEntity: 'OrderModule:Order',
+                targetModuleName: 'OrderModule',
+                targetEntityName: 'Order',
+                labels: ['Order__Appointment'],
+            }, OrderRecord_1.OrderRecord);
+        }
+        return this._orders;
+    }
+    /**
+     * Access linked Lead records
+     * @remarks Available labels: Lead_Appointment
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Lead records
+     * const items = await record.leads.list();
+     * const first = await record.leads.first();
+     *
+     * // Filter by label
+     * const specific = await record.leads.first({ label: 'Lead_Appointment' });
+     * ```
+     */
+    get leads() {
+        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._leads) {
+            this._leads = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:Appointment',
+                targetEntity: 'CrmModule:Lead',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Lead',
+                labels: ['Lead_Appointment'],
+            }, LeadRecord_1.LeadRecord);
+        }
+        return this._leads;
+    }
     // ============================================
     // LINK MANAGEMENT
     // ============================================
@@ -215,6 +433,23 @@ class AppointmentRecord {
     }
 }
 exports.AppointmentRecord = AppointmentRecord;
+// ============================================
+// TYPED LINK ACCESSORS
+// ============================================
+/** Valid labels for File associations */
+AppointmentRecord.filesLabels = ['Appointment__File'];
+/** Valid labels for Address associations */
+AppointmentRecord.addressesLabels = ['Address__Appointment'];
+/** Valid labels for Note associations */
+AppointmentRecord.notesLabels = ['Appointment__Note'];
+/** Valid labels for Visit associations */
+AppointmentRecord.visitsLabels = ['Visit__Appointment'];
+/** Valid labels for Contact associations */
+AppointmentRecord.contactsLabels = ['Contact__Appointment'];
+/** Valid labels for Order associations */
+AppointmentRecord.ordersLabels = ['Order__Appointment'];
+/** Valid labels for Lead associations */
+AppointmentRecord.leadsLabels = ['Lead_Appointment'];
 /** Type guard to check if an object is a AppointmentRecord */
 function isAppointmentRecord(obj) {
     return obj instanceof AppointmentRecord;