@d19n/youfibre-odin-sdk 2.0.31 → 2.0.33

package/dist/records-v2/AccountRecord.js

@@ -14,6 +14,8 @@
  * await record.createAccount({ ... }).execute();
  * ```
  *
+ * Entity Types: BUSINESS, MULTIPLE, PRIMARY, RESELLER, SERVICE
+ *
  * AUTO-GENERATED - DO NOT EDIT DIRECTLY
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
@@ -29,6 +31,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isAccountRecord = exports.AccountRecord = 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 WorkOrderRecord_1 = require("./WorkOrderRecord");
+const NoteRecord_1 = require("./NoteRecord");
+const OneTouchSwitchRecord_1 = require("./OneTouchSwitchRecord");
+const OrderRecord_1 = require("./OrderRecord");
+const InvoiceRecord_1 = require("./InvoiceRecord");
+const AddressRecord_1 = require("./AddressRecord");
+const CaseRecord_1 = require("./CaseRecord");
+const PaymentRecord_1 = require("./PaymentRecord");
+const ContactRecord_1 = require("./ContactRecord");
+const FileRecord_1 = require("./FileRecord");
 /**
  * Builder for action execution with dryRun support
  *
@@ -140,6 +153,419 @@ class AccountRecord {
     /** 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 BUSINESS
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to BUSINESS-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isBusiness()) {
+     *   // TypeScript knows record.properties is BusinessAccountProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks Business accounts
+     */
+    isBusiness() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.type) === 'BUSINESS'; }
+    /**
+     * Type guard: check if this record is of type MULTIPLE
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to MULTIPLE-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isMultiple()) {
+     *   // TypeScript knows record.properties is MultipleAccountProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks Multiple accounts are for customers who want to purchase multiple services at many addresses
+     */
+    isMultiple() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.type) === 'MULTIPLE'; }
+    /**
+     * Type guard: check if this record is of type PRIMARY
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to PRIMARY-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isPrimary()) {
+     *   // TypeScript knows record.properties is PrimaryAccountProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks Primary account
+     */
+    isPrimary() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.type) === 'PRIMARY'; }
+    /**
+     * Type guard: check if this record is of type RESELLER
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to RESELLER-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isReseller()) {
+     *   // TypeScript knows record.properties is ResellerAccountProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks Reseller
+     */
+    isReseller() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.type) === 'RESELLER'; }
+    /**
+     * Type guard: check if this record is of type SERVICE
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to SERVICE-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isService()) {
+     *   // TypeScript knows record.properties is ServiceAccountProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks This is the account where service is being delivered
+     */
+    isService() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.type) === 'SERVICE'; }
+    /**
+     * Access linked WorkOrder records
+     * @remarks Available labels: Account__WorkOrder
+     * @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: 'Account__WorkOrder' });
+     * ```
+     */
+    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:Account',
+                targetEntity: 'FieldServiceModule:WorkOrder',
+                targetModuleName: 'FieldServiceModule',
+                targetEntityName: 'WorkOrder',
+                labels: ['Account__WorkOrder'],
+            }, WorkOrderRecord_1.WorkOrderRecord);
+        }
+        return this._workOrders;
+    }
+    /**
+     * Access linked Note records
+     * @remarks Available labels: Account__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: 'Account__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:Account',
+                targetEntity: 'SupportModule:Note',
+                targetModuleName: 'SupportModule',
+                targetEntityName: 'Note',
+                labels: ['Account__Note'],
+            }, NoteRecord_1.NoteRecord);
+        }
+        return this._notes;
+    }
+    /**
+     * Access linked OneTouchSwitch records
+     * @remarks Available labels: Account__OneTouchSwitch
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked OneTouchSwitch records
+     * const items = await record.oneTouchSwitches.list();
+     * const first = await record.oneTouchSwitches.first();
+     *
+     * // Filter by label
+     * const specific = await record.oneTouchSwitches.first({ label: 'Account__OneTouchSwitch' });
+     * ```
+     */
+    get oneTouchSwitches() {
+        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._oneTouchSwitches) {
+            this._oneTouchSwitches = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:Account',
+                targetEntity: 'OrderModule:OneTouchSwitch',
+                targetModuleName: 'OrderModule',
+                targetEntityName: 'OneTouchSwitch',
+                labels: ['Account__OneTouchSwitch'],
+            }, OneTouchSwitchRecord_1.OneTouchSwitchRecord);
+        }
+        return this._oneTouchSwitches;
+    }
+    /**
+     * Access linked Order records
+     * @remarks Available labels: Account__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: 'Account__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:Account',
+                targetEntity: 'OrderModule:Order',
+                targetModuleName: 'OrderModule',
+                targetEntityName: 'Order',
+                labels: ['Account__Order'],
+            }, OrderRecord_1.OrderRecord);
+        }
+        return this._orders;
+    }
+    /**
+     * Access linked Invoice records
+     * @remarks Available labels: Account__Invoice
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Invoice records
+     * const items = await record.invoices.list();
+     * const first = await record.invoices.first();
+     *
+     * // Filter by label
+     * const specific = await record.invoices.first({ label: 'Account__Invoice' });
+     * ```
+     */
+    get invoices() {
+        var _a;
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('Cannot access links on a new (unsaved) record');
+        if (!this._invoices) {
+            this._invoices = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:Account',
+                targetEntity: 'BillingModule:Invoice',
+                targetModuleName: 'BillingModule',
+                targetEntityName: 'Invoice',
+                labels: ['Account__Invoice'],
+            }, InvoiceRecord_1.InvoiceRecord);
+        }
+        return this._invoices;
+    }
+    /**
+     * Access linked Account records
+     * @remarks Available labels: Account_Account
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Account records
+     * const items = await record.accounts.list();
+     * const first = await record.accounts.first();
+     *
+     * // Filter by label
+     * const specific = await record.accounts.first({ label: 'Account_Account' });
+     * ```
+     */
+    get accounts() {
+        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._accounts) {
+            this._accounts = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:Account',
+                targetEntity: 'CrmModule:Account',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Account',
+                labels: ['Account_Account'],
+            }, AccountRecord);
+        }
+        return this._accounts;
+    }
+    /**
+     * Access linked Address records
+     * @remarks Available labels: BillingAddress
+     * @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: 'BillingAddress' });
+     * ```
+     */
+    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:Account',
+                targetEntity: 'CrmModule:Address',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Address',
+                labels: ['BillingAddress'],
+            }, AddressRecord_1.AddressRecord);
+        }
+        return this._addresses;
+    }
+    /**
+     * Access linked Case records
+     * @remarks Available labels: Account__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: 'Account__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: 'CrmModule:Account',
+                targetEntity: 'SupportModule:Case',
+                targetModuleName: 'SupportModule',
+                targetEntityName: 'Case',
+                labels: ['Account__Case'],
+            }, CaseRecord_1.CaseRecord);
+        }
+        return this._cases;
+    }
+    /**
+     * Access linked Payment records
+     * @remarks Available labels: Account_Payment
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Payment records
+     * const items = await record.payments.list();
+     * const first = await record.payments.first();
+     *
+     * // Filter by label
+     * const specific = await record.payments.first({ label: 'Account_Payment' });
+     * ```
+     */
+    get payments() {
+        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._payments) {
+            this._payments = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:Account',
+                targetEntity: 'BillingModule:Payment',
+                targetModuleName: 'BillingModule',
+                targetEntityName: 'Payment',
+                labels: ['Account_Payment'],
+            }, PaymentRecord_1.PaymentRecord);
+        }
+        return this._payments;
+    }
+    /**
+     * Access linked Contact records
+     * @remarks Available labels: BillingContact
+     * @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: 'BillingContact' });
+     * ```
+     */
+    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:Account',
+                targetEntity: 'CrmModule:Contact',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Contact',
+                labels: ['BillingContact'],
+            }, ContactRecord_1.ContactRecord);
+        }
+        return this._contacts;
+    }
+    /**
+     * Access linked File records
+     * @remarks Available labels: Account__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: 'Account__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:Account',
+                targetEntity: 'SchemaModule:File',
+                targetModuleName: 'SchemaModule',
+                targetEntityName: 'File',
+                labels: ['Account__File'],
+            }, FileRecord_1.FileRecord);
+        }
+        return this._files;
+    }
+    // ============================================
     // LINK MANAGEMENT
     // ============================================
     /**
@@ -466,6 +892,31 @@ class AccountRecord {
     }
 }
 exports.AccountRecord = AccountRecord;
+// ============================================
+// TYPED LINK ACCESSORS
+// ============================================
+/** Valid labels for WorkOrder associations */
+AccountRecord.workOrdersLabels = ['Account__WorkOrder'];
+/** Valid labels for Note associations */
+AccountRecord.notesLabels = ['Account__Note'];
+/** Valid labels for OneTouchSwitch associations */
+AccountRecord.oneTouchSwitchesLabels = ['Account__OneTouchSwitch'];
+/** Valid labels for Order associations */
+AccountRecord.ordersLabels = ['Account__Order'];
+/** Valid labels for Invoice associations */
+AccountRecord.invoicesLabels = ['Account__Invoice'];
+/** Valid labels for Account associations */
+AccountRecord.accountsLabels = ['Account_Account'];
+/** Valid labels for Address associations */
+AccountRecord.addressesLabels = ['BillingAddress'];
+/** Valid labels for Case associations */
+AccountRecord.casesLabels = ['Account__Case'];
+/** Valid labels for Payment associations */
+AccountRecord.paymentsLabels = ['Account_Payment'];
+/** Valid labels for Contact associations */
+AccountRecord.contactsLabels = ['BillingContact'];
+/** Valid labels for File associations */
+AccountRecord.filesLabels = ['Account__File'];
 /** Type guard to check if an object is a AccountRecord */
 function isAccountRecord(obj) {
     return obj instanceof AccountRecord;

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

@@ -13,14 +13,24 @@
  * await record.createActivityLog({ ... }).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 { ActivityLogProperties } from '../entities-v2/ActivityLog';
 import { CreateActivityLogEntryProperties } from '../actions-v2/CreateActivityLogEntryDto';
+import { OrderRecord } from './OrderRecord';
+import { CaseRecord } from './CaseRecord';
+import { OneTouchSwitchRecord } from './OneTouchSwitchRecord';
+import { CallRecord } from './CallRecord';
+import { WorkOrderRecord } from './WorkOrderRecord';
+/** Valid entity types for ActivityLog */
+export declare type ActivityLogType = 'DEFAULT';
 /**
  * Builder for action execution with dryRun support
  *
@@ -84,6 +94,11 @@ export declare class ActivityLogRecord<TProps = ActivityLogProperties> {
     private _provider;
     private _pendingLinks;
     private _preGeneratedId;
+    private _orders?;
+    private _cases?;
+    private _oneTouchSwitches?;
+    private _calls?;
+    private _workOrders?;
     /**
      * Create a record wrapper.
      * @param record - The underlying record, or null for create operations
@@ -96,7 +111,7 @@ export declare class ActivityLogRecord<TProps = ActivityLogProperties> {
     /** Record ID - always available (pre-generated for new records) */
     get id(): string;
     get entity(): string;
-    get type(): string | undefined;
+    get type(): ActivityLogType | undefined;
     /** Record properties - empty object for new (unsaved) records */
     get properties(): TProps;
     get title(): string | undefined;
@@ -109,6 +124,112 @@ export declare class ActivityLogRecord<TProps = ActivityLogProperties> {
     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 ActivityLogProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks This is the default record type
+     */
+    isDefault(): this is ActivityLogRecord<ActivityLogProperties>;
+    /** Valid labels for Order associations */
+    static readonly ordersLabels: readonly ["Order__ActivityLog"];
+    /**
+     * Access linked Order records
+     * @remarks Available labels: Order__ActivityLog
+     * @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__ActivityLog' });
+     * ```
+     */
+    get orders(): RecordLinkManager<OrderRecord, typeof ActivityLogRecord['ordersLabels'][number]>;
+    /** Valid labels for Case associations */
+    static readonly casesLabels: readonly ["Case__ActivityLog"];
+    /**
+     * Access linked Case records
+     * @remarks Available labels: Case__ActivityLog
+     * @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__ActivityLog' });
+     * ```
+     */
+    get cases(): RecordLinkManager<CaseRecord, typeof ActivityLogRecord['casesLabels'][number]>;
+    /** Valid labels for OneTouchSwitch associations */
+    static readonly oneTouchSwitchesLabels: readonly ["OneTouchSwitch_ActivityLog"];
+    /**
+     * Access linked OneTouchSwitch records
+     * @remarks Available labels: OneTouchSwitch_ActivityLog
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked OneTouchSwitch records
+     * const items = await record.oneTouchSwitches.list();
+     * const first = await record.oneTouchSwitches.first();
+     *
+     * // Filter by label
+     * const specific = await record.oneTouchSwitches.first({ label: 'OneTouchSwitch_ActivityLog' });
+     * ```
+     */
+    get oneTouchSwitches(): RecordLinkManager<OneTouchSwitchRecord, typeof ActivityLogRecord['oneTouchSwitchesLabels'][number]>;
+    /** Valid labels for Call associations */
+    static readonly callsLabels: readonly ["CallActivity"];
+    /**
+     * Access linked Call records
+     * @remarks Available labels: CallActivity
+     * @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: 'CallActivity' });
+     * ```
+     */
+    get calls(): RecordLinkManager<CallRecord, typeof ActivityLogRecord['callsLabels'][number]>;
+    /** Valid labels for WorkOrder associations */
+    static readonly workOrdersLabels: readonly ["WorkOrder_ActivityLog"];
+    /**
+     * Access linked WorkOrder records
+     * @remarks Available labels: WorkOrder_ActivityLog
+     * @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_ActivityLog' });
+     * ```
+     */
+    get workOrders(): RecordLinkManager<WorkOrderRecord, typeof ActivityLogRecord['workOrdersLabels'][number]>;
     /**
      * Queue a link to be created with the next action.
      * Works for both create and update actions.