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

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

@@ -19,9 +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 { VisitProperties } from '../entities-v2/Visit';
 import { VisitCreateProperties } from '../actions-v2/VisitCreateDto';
 import { VisitUpdateProperties } from '../actions-v2/VisitUpdateDto';
+import { AddressRecord } from './AddressRecord';
+import { NoteRecord } from './NoteRecord';
+import { LeadRecord } from './LeadRecord';
+import { FileRecord } from './FileRecord';
+import { OrderRecord } from './OrderRecord';
+import { AppointmentRecord } from './AppointmentRecord';
 /**
  * Builder for action execution with dryRun support
  *
@@ -85,6 +92,12 @@ export declare class VisitRecord<TProps = VisitProperties> {
     private _provider;
     private _pendingLinks;
     private _preGeneratedId;
+    private _addresses?;
+    private _notes?;
+    private _leads?;
+    private _files?;
+    private _orders?;
+    private _appointments?;
     /**
      * Create a record wrapper.
      * @param record - The underlying record, or null for create operations
@@ -110,6 +123,114 @@ export declare class VisitRecord<TProps = VisitProperties> {
     get groups(): string[];
     /** Access the underlying OdinRecord (null for new records) */
     get record(): OdinRecord<TProps> | null;
+    /** Valid labels for Address associations */
+    static readonly addressesLabels: readonly ["Address__Visit"];
+    /**
+     * Access linked Address records
+     * @remarks Available labels: Address__Visit
+     * @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__Visit' });
+     * ```
+     */
+    get addresses(): RecordLinkManager<AddressRecord, typeof VisitRecord['addressesLabels'][number]>;
+    /** Valid labels for Note associations */
+    static readonly notesLabels: readonly ["Visit__Note"];
+    /**
+     * Access linked Note records
+     * @remarks Available labels: Visit__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: 'Visit__Note' });
+     * ```
+     */
+    get notes(): RecordLinkManager<NoteRecord, typeof VisitRecord['notesLabels'][number]>;
+    /** Valid labels for Lead associations */
+    static readonly leadsLabels: readonly ["Lead__Visit"];
+    /**
+     * Access linked Lead records
+     * @remarks Available labels: Lead__Visit
+     * @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__Visit' });
+     * ```
+     */
+    get leads(): RecordLinkManager<LeadRecord, typeof VisitRecord['leadsLabels'][number]>;
+    /** Valid labels for File associations */
+    static readonly filesLabels: readonly ["Visit__File"];
+    /**
+     * Access linked File records
+     * @remarks Available labels: Visit__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: 'Visit__File' });
+     * ```
+     */
+    get files(): RecordLinkManager<FileRecord, typeof VisitRecord['filesLabels'][number]>;
+    /** Valid labels for Order associations */
+    static readonly ordersLabels: readonly ["Order__Visit"];
+    /**
+     * Access linked Order records
+     * @remarks Available labels: Order__Visit
+     * @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__Visit' });
+     * ```
+     */
+    get orders(): RecordLinkManager<OrderRecord, typeof VisitRecord['ordersLabels'][number]>;
+    /** Valid labels for Appointment associations */
+    static readonly appointmentsLabels: readonly ["Visit__Appointment"];
+    /**
+     * Access linked Appointment records
+     * @remarks Available labels: Visit__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: 'Visit__Appointment' });
+     * ```
+     */
+    get appointments(): RecordLinkManager<AppointmentRecord, typeof VisitRecord['appointmentsLabels'][number]>;
     /**
      * Queue a link to be created with the next action.
      * Works for both create and update actions.

package/dist/records-v2/VisitRecord.js

@@ -29,6 +29,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isVisitRecord = exports.VisitRecord = 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 AddressRecord_1 = require("./AddressRecord");
+const NoteRecord_1 = require("./NoteRecord");
+const LeadRecord_1 = require("./LeadRecord");
+const FileRecord_1 = require("./FileRecord");
+const OrderRecord_1 = require("./OrderRecord");
+const AppointmentRecord_1 = require("./AppointmentRecord");
 /**
  * Builder for action execution with dryRun support
  *
@@ -139,6 +146,186 @@ class VisitRecord {
     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 Address records
+     * @remarks Available labels: Address__Visit
+     * @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__Visit' });
+     * ```
+     */
+    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:Visit',
+                targetEntity: 'CrmModule:Address',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Address',
+                labels: ['Address__Visit'],
+            }, AddressRecord_1.AddressRecord);
+        }
+        return this._addresses;
+    }
+    /**
+     * Access linked Note records
+     * @remarks Available labels: Visit__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: 'Visit__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:Visit',
+                targetEntity: 'SupportModule:Note',
+                targetModuleName: 'SupportModule',
+                targetEntityName: 'Note',
+                labels: ['Visit__Note'],
+            }, NoteRecord_1.NoteRecord);
+        }
+        return this._notes;
+    }
+    /**
+     * Access linked Lead records
+     * @remarks Available labels: Lead__Visit
+     * @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__Visit' });
+     * ```
+     */
+    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:Visit',
+                targetEntity: 'CrmModule:Lead',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Lead',
+                labels: ['Lead__Visit'],
+            }, LeadRecord_1.LeadRecord);
+        }
+        return this._leads;
+    }
+    /**
+     * Access linked File records
+     * @remarks Available labels: Visit__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: 'Visit__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:Visit',
+                targetEntity: 'SchemaModule:File',
+                targetModuleName: 'SchemaModule',
+                targetEntityName: 'File',
+                labels: ['Visit__File'],
+            }, FileRecord_1.FileRecord);
+        }
+        return this._files;
+    }
+    /**
+     * Access linked Order records
+     * @remarks Available labels: Order__Visit
+     * @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__Visit' });
+     * ```
+     */
+    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:Visit',
+                targetEntity: 'OrderModule:Order',
+                targetModuleName: 'OrderModule',
+                targetEntityName: 'Order',
+                labels: ['Order__Visit'],
+            }, OrderRecord_1.OrderRecord);
+        }
+        return this._orders;
+    }
+    /**
+     * Access linked Appointment records
+     * @remarks Available labels: Visit__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: 'Visit__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:Visit',
+                targetEntity: 'CrmModule:Appointment',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Appointment',
+                labels: ['Visit__Appointment'],
+            }, AppointmentRecord_1.AppointmentRecord);
+        }
+        return this._appointments;
+    }
     // ============================================
     // LINK MANAGEMENT
     // ============================================
@@ -247,6 +434,21 @@ class VisitRecord {
     }
 }
 exports.VisitRecord = VisitRecord;
+// ============================================
+// TYPED LINK ACCESSORS
+// ============================================
+/** Valid labels for Address associations */
+VisitRecord.addressesLabels = ['Address__Visit'];
+/** Valid labels for Note associations */
+VisitRecord.notesLabels = ['Visit__Note'];
+/** Valid labels for Lead associations */
+VisitRecord.leadsLabels = ['Lead__Visit'];
+/** Valid labels for File associations */
+VisitRecord.filesLabels = ['Visit__File'];
+/** Valid labels for Order associations */
+VisitRecord.ordersLabels = ['Order__Visit'];
+/** Valid labels for Appointment associations */
+VisitRecord.appointmentsLabels = ['Visit__Appointment'];
 /** Type guard to check if an object is a VisitRecord */
 function isVisitRecord(obj) {
     return obj instanceof VisitRecord;

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

@@ -19,10 +19,12 @@ 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 { VoiceConfigurationProperties } from '../entities-v2/VoiceConfiguration';
 import { CreateRecontractVoiceConfigurationProperties } from '../actions-v2/CreateRecontractVoiceConfigurationDto';
 import { CreateVoiceConfigurationProperties } from '../actions-v2/CreateVoiceConfigurationDto';
 import { UpdateVoiceConfigurationProperties } from '../actions-v2/UpdateVoiceConfigurationDto';
+import { OrderItemRecord } from './OrderItemRecord';
 /**
  * Builder for action execution with dryRun support
  *
@@ -86,6 +88,7 @@ export declare class VoiceConfigurationRecord<TProps = VoiceConfigurationPropert
     private _provider;
     private _pendingLinks;
     private _preGeneratedId;
+    private _orderItems?;
     /**
      * Create a record wrapper.
      * @param record - The underlying record, or null for create operations
@@ -111,6 +114,24 @@ export declare class VoiceConfigurationRecord<TProps = VoiceConfigurationPropert
     get groups(): string[];
     /** Access the underlying OdinRecord (null for new records) */
     get record(): OdinRecord<TProps> | null;
+    /** Valid labels for OrderItem associations */
+    static readonly orderItemsLabels: readonly ["OrderItem__VoiceConfiguration"];
+    /**
+     * Access linked OrderItem records
+     * @remarks Available labels: OrderItem__VoiceConfiguration
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked OrderItem records
+     * const items = await record.orderItems.list();
+     * const first = await record.orderItems.first();
+     *
+     * // Filter by label
+     * const specific = await record.orderItems.first({ label: 'OrderItem__VoiceConfiguration' });
+     * ```
+     */
+    get orderItems(): RecordLinkManager<OrderItemRecord, typeof VoiceConfigurationRecord['orderItemsLabels'][number]>;
     /**
      * Queue a link to be created with the next action.
      * Works for both create and update actions.

package/dist/records-v2/VoiceConfigurationRecord.js

@@ -29,6 +29,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isVoiceConfigurationRecord = exports.VoiceConfigurationRecord = 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 OrderItemRecord_1 = require("./OrderItemRecord");
 /**
  * Builder for action execution with dryRun support
  *
@@ -139,6 +141,36 @@ class VoiceConfigurationRecord {
     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 OrderItem records
+     * @remarks Available labels: OrderItem__VoiceConfiguration
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked OrderItem records
+     * const items = await record.orderItems.list();
+     * const first = await record.orderItems.first();
+     *
+     * // Filter by label
+     * const specific = await record.orderItems.first({ label: 'OrderItem__VoiceConfiguration' });
+     * ```
+     */
+    get orderItems() {
+        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._orderItems) {
+            this._orderItems = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'ServiceModule:VoiceConfiguration',
+                targetEntity: 'OrderModule:OrderItem',
+                targetModuleName: 'OrderModule',
+                targetEntityName: 'OrderItem',
+                labels: ['OrderItem__VoiceConfiguration'],
+            }, OrderItemRecord_1.OrderItemRecord);
+        }
+        return this._orderItems;
+    }
     // ============================================
     // LINK MANAGEMENT
     // ============================================
@@ -291,6 +323,11 @@ class VoiceConfigurationRecord {
     }
 }
 exports.VoiceConfigurationRecord = VoiceConfigurationRecord;
+// ============================================
+// TYPED LINK ACCESSORS
+// ============================================
+/** Valid labels for OrderItem associations */
+VoiceConfigurationRecord.orderItemsLabels = ['OrderItem__VoiceConfiguration'];
 /** Type guard to check if an object is a VoiceConfigurationRecord */
 function isVoiceConfigurationRecord(obj) {
     return obj instanceof VoiceConfigurationRecord;

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

@@ -13,14 +13,22 @@
  * await record.createWayleaveAudit({ ... }).execute();
  * ```
  *
+ * Entity Types: OUTCOME_FORM
+ *
  * 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 { WayleaveAuditProperties } from '../entities-v2/WayleaveAudit';
+import { RecordLinkManager } from '@d19n/odin-sdk-generator/dist/record-link-manager';
+import { WayleaveAuditProperties, OutcomeFormWayleaveAuditProperties } from '../entities-v2/WayleaveAudit';
 import { WayleaveAuditCreateProperties } from '../actions-v2/CreateWayleaveWorkOrderFlowDto';
+import { NoteRecord } from './NoteRecord';
+import { FileRecord } from './FileRecord';
+import { WorkOrderRecord } from './WorkOrderRecord';
+/** Valid entity types for WayleaveAudit */
+export declare type WayleaveAuditType = 'OUTCOME_FORM';
 /**
  * Builder for action execution with dryRun support
  *
@@ -84,6 +92,9 @@ export declare class WayleaveAuditRecord<TProps = WayleaveAuditProperties> {
     private _provider;
     private _pendingLinks;
     private _preGeneratedId;
+    private _notes?;
+    private _files?;
+    private _workOrders?;
     /**
      * Create a record wrapper.
      * @param record - The underlying record, or null for create operations
@@ -96,7 +107,7 @@ export declare class WayleaveAuditRecord<TProps = WayleaveAuditProperties> {
     /** Record ID - always available (pre-generated for new records) */
     get id(): string;
     get entity(): string;
-    get type(): string | undefined;
+    get type(): WayleaveAuditType | undefined;
     /** Record properties - empty object for new (unsaved) records */
     get properties(): TProps;
     get title(): string | undefined;
@@ -109,6 +120,76 @@ export declare class WayleaveAuditRecord<TProps = WayleaveAuditProperties> {
     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 OUTCOME_FORM
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to OUTCOME_FORM-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isOutcomeForm()) {
+     *   // TypeScript knows record.properties is OutcomeFormWayleaveAuditProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks outcome form
+     */
+    isOutcomeForm(): this is WayleaveAuditRecord<OutcomeFormWayleaveAuditProperties>;
+    /** Valid labels for Note associations */
+    static readonly notesLabels: readonly ["WayleaveAudit_Note"];
+    /**
+     * Access linked Note records
+     * @remarks Available labels: WayleaveAudit_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: 'WayleaveAudit_Note' });
+     * ```
+     */
+    get notes(): RecordLinkManager<NoteRecord, typeof WayleaveAuditRecord['notesLabels'][number]>;
+    /** Valid labels for File associations */
+    static readonly filesLabels: readonly ["WayleaveAudit_File"];
+    /**
+     * Access linked File records
+     * @remarks Available labels: WayleaveAudit_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: 'WayleaveAudit_File' });
+     * ```
+     */
+    get files(): RecordLinkManager<FileRecord, typeof WayleaveAuditRecord['filesLabels'][number]>;
+    /** Valid labels for WorkOrder associations */
+    static readonly workOrdersLabels: readonly ["WorkOrder_WayleaveAudit"];
+    /**
+     * Access linked WorkOrder records
+     * @remarks Available labels: WorkOrder_WayleaveAudit
+     * @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_WayleaveAudit' });
+     * ```
+     */
+    get workOrders(): RecordLinkManager<WorkOrderRecord, typeof WayleaveAuditRecord['workOrdersLabels'][number]>;
     /**
      * Queue a link to be created with the next action.
      * Works for both create and update actions.