@d19n/youfibre-odin-sdk 2.0.31 → 2.0.33

package/dist/records-v2/ActivityLogRecord.js

@@ -14,6 +14,8 @@
  * await record.createActivityLog({ ... }).execute();
  * ```
  *
+ * Entity Types: DEFAULT
+ *
  * AUTO-GENERATED - DO NOT EDIT DIRECTLY
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
@@ -29,6 +31,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isActivityLogRecord = exports.ActivityLogRecord = 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 OrderRecord_1 = require("./OrderRecord");
+const CaseRecord_1 = require("./CaseRecord");
+const OneTouchSwitchRecord_1 = require("./OneTouchSwitchRecord");
+const CallRecord_1 = require("./CallRecord");
+const WorkOrderRecord_1 = require("./WorkOrderRecord");
 /**
  * Builder for action execution with dryRun support
  *
@@ -140,6 +148,175 @@ class ActivityLogRecord {
     /** 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 ActivityLogProperties
+     *   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 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() {
+        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: 'AuditModule:ActivityLog',
+                targetEntity: 'OrderModule:Order',
+                targetModuleName: 'OrderModule',
+                targetEntityName: 'Order',
+                labels: ['Order__ActivityLog'],
+            }, OrderRecord_1.OrderRecord);
+        }
+        return this._orders;
+    }
+    /**
+     * 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() {
+        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: 'AuditModule:ActivityLog',
+                targetEntity: 'SupportModule:Case',
+                targetModuleName: 'SupportModule',
+                targetEntityName: 'Case',
+                labels: ['Case__ActivityLog'],
+            }, CaseRecord_1.CaseRecord);
+        }
+        return this._cases;
+    }
+    /**
+     * 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() {
+        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: 'AuditModule:ActivityLog',
+                targetEntity: 'OrderModule:OneTouchSwitch',
+                targetModuleName: 'OrderModule',
+                targetEntityName: 'OneTouchSwitch',
+                labels: ['OneTouchSwitch_ActivityLog'],
+            }, OneTouchSwitchRecord_1.OneTouchSwitchRecord);
+        }
+        return this._oneTouchSwitches;
+    }
+    /**
+     * 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() {
+        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: 'AuditModule:ActivityLog',
+                targetEntity: 'NotificationModule:Call',
+                targetModuleName: 'NotificationModule',
+                targetEntityName: 'Call',
+                labels: ['CallActivity'],
+            }, CallRecord_1.CallRecord);
+        }
+        return this._calls;
+    }
+    /**
+     * 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() {
+        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: 'AuditModule:ActivityLog',
+                targetEntity: 'FieldServiceModule:WorkOrder',
+                targetModuleName: 'FieldServiceModule',
+                targetEntityName: 'WorkOrder',
+                labels: ['WorkOrder_ActivityLog'],
+            }, WorkOrderRecord_1.WorkOrderRecord);
+        }
+        return this._workOrders;
+    }
+    // ============================================
     // LINK MANAGEMENT
     // ============================================
     /**
@@ -215,6 +392,19 @@ class ActivityLogRecord {
     }
 }
 exports.ActivityLogRecord = ActivityLogRecord;
+// ============================================
+// TYPED LINK ACCESSORS
+// ============================================
+/** Valid labels for Order associations */
+ActivityLogRecord.ordersLabels = ['Order__ActivityLog'];
+/** Valid labels for Case associations */
+ActivityLogRecord.casesLabels = ['Case__ActivityLog'];
+/** Valid labels for OneTouchSwitch associations */
+ActivityLogRecord.oneTouchSwitchesLabels = ['OneTouchSwitch_ActivityLog'];
+/** Valid labels for Call associations */
+ActivityLogRecord.callsLabels = ['CallActivity'];
+/** Valid labels for WorkOrder associations */
+ActivityLogRecord.workOrdersLabels = ['WorkOrder_ActivityLog'];
 /** Type guard to check if an object is a ActivityLogRecord */
 function isActivityLogRecord(obj) {
     return obj instanceof ActivityLogRecord;

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

@@ -13,15 +13,30 @@
  * await record.createActivity({ ... }).execute();
  * ```
  *
+ * Entity Types: EVENT, NOTIFICATION, TASK
+ *
  * 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 { ActivityProperties } from '../entities-v2/Activity';
+import { RecordLinkManager } from '@d19n/odin-sdk-generator/dist/record-link-manager';
+import { ActivityProperties, EventActivityProperties, NotificationActivityProperties, TaskActivityProperties } from '../entities-v2/Activity';
 import { CreateFinalNoticeActivityProperties } from '../actions-v2/CreateFinalNoticeActivityDto';
 import { UpdateActivityDateProperties } from '../actions-v2/UpdateActivityDateDto';
+import { ContactRecord } from './ContactRecord';
+import { NoteRecord } from './NoteRecord';
+import { OneTouchSwitchRecord } from './OneTouchSwitchRecord';
+import { BillingRequestRecord } from './BillingRequestRecord';
+import { OrderItemRecord } from './OrderItemRecord';
+import { FileRecord } from './FileRecord';
+import { CustomerDeviceOntRecord } from './CustomerDeviceOntRecord';
+import { PaymentMethodRefundRecord } from './PaymentMethodRefundRecord';
+import { WorkOrderRecord } from './WorkOrderRecord';
+import { OrderRecord } from './OrderRecord';
+/** Valid entity types for Activity */
+export declare type ActivityType = 'EVENT' | 'NOTIFICATION' | 'TASK';
 /**
  * Builder for action execution with dryRun support
  *
@@ -85,6 +100,16 @@ export declare class ActivityRecord<TProps = ActivityProperties> {
     private _provider;
     private _pendingLinks;
     private _preGeneratedId;
+    private _contacts?;
+    private _notes?;
+    private _oneTouchSwitches?;
+    private _billingRequests?;
+    private _orderItems?;
+    private _files?;
+    private _customerDeviceOnts?;
+    private _paymentMethodRefunds?;
+    private _workOrders?;
+    private _orders?;
     /**
      * Create a record wrapper.
      * @param record - The underlying record, or null for create operations
@@ -97,7 +122,7 @@ export declare class ActivityRecord<TProps = ActivityProperties> {
     /** Record ID - always available (pre-generated for new records) */
     get id(): string;
     get entity(): string;
-    get type(): string | undefined;
+    get type(): ActivityType | undefined;
     /** Record properties - empty object for new (unsaved) records */
     get properties(): TProps;
     get title(): string | undefined;
@@ -110,6 +135,234 @@ export declare class ActivityRecord<TProps = ActivityProperties> {
     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 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 EventActivityProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks General Events
+     */
+    isEvent(): this is ActivityRecord<EventActivityProperties>;
+    /**
+     * Type guard: check if this record is of type NOTIFICATION
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to NOTIFICATION-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isNotification()) {
+     *   // TypeScript knows record.properties is NotificationActivityProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks track notification activities
+     */
+    isNotification(): this is ActivityRecord<NotificationActivityProperties>;
+    /**
+     * Type guard: check if this record is of type TASK
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to TASK-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isTask()) {
+     *   // TypeScript knows record.properties is TaskActivityProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks task activity tracks if an activity is resolved
+     */
+    isTask(): this is ActivityRecord<TaskActivityProperties>;
+    /** Valid labels for Contact associations */
+    static readonly contactsLabels: readonly ["Contact__Activity"];
+    /**
+     * Access linked Contact records
+     * @remarks Available labels: Contact__Activity
+     * @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__Activity' });
+     * ```
+     */
+    get contacts(): RecordLinkManager<ContactRecord, typeof ActivityRecord['contactsLabels'][number]>;
+    /** Valid labels for Note associations */
+    static readonly notesLabels: readonly ["Activity__Note"];
+    /**
+     * Access linked Note records
+     * @remarks Available labels: Activity__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: 'Activity__Note' });
+     * ```
+     */
+    get notes(): RecordLinkManager<NoteRecord, typeof ActivityRecord['notesLabels'][number]>;
+    /** Valid labels for OneTouchSwitch associations */
+    static readonly oneTouchSwitchesLabels: readonly ["OneTouchSwitch__Activity"];
+    /**
+     * Access linked OneTouchSwitch records
+     * @remarks Available labels: OneTouchSwitch__Activity
+     * @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__Activity' });
+     * ```
+     */
+    get oneTouchSwitches(): RecordLinkManager<OneTouchSwitchRecord, typeof ActivityRecord['oneTouchSwitchesLabels'][number]>;
+    /** Valid labels for BillingRequest associations */
+    static readonly billingRequestsLabels: readonly ["BillingRequest__Activity"];
+    /**
+     * Access linked BillingRequest records
+     * @remarks Available labels: BillingRequest__Activity
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked BillingRequest records
+     * const items = await record.billingRequests.list();
+     * const first = await record.billingRequests.first();
+     *
+     * // Filter by label
+     * const specific = await record.billingRequests.first({ label: 'BillingRequest__Activity' });
+     * ```
+     */
+    get billingRequests(): RecordLinkManager<BillingRequestRecord, typeof ActivityRecord['billingRequestsLabels'][number]>;
+    /** Valid labels for OrderItem associations */
+    static readonly orderItemsLabels: readonly ["OrderItem__Activity"];
+    /**
+     * Access linked OrderItem records
+     * @remarks Available labels: OrderItem__Activity
+     * @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__Activity' });
+     * ```
+     */
+    get orderItems(): RecordLinkManager<OrderItemRecord, typeof ActivityRecord['orderItemsLabels'][number]>;
+    /** Valid labels for File associations */
+    static readonly filesLabels: readonly ["Activity__File"];
+    /**
+     * Access linked File records
+     * @remarks Available labels: Activity__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: 'Activity__File' });
+     * ```
+     */
+    get files(): RecordLinkManager<FileRecord, typeof ActivityRecord['filesLabels'][number]>;
+    /** Valid labels for CustomerDeviceOnt associations */
+    static readonly customerDeviceOntsLabels: readonly ["CustomerDeviceOnt__Activity"];
+    /**
+     * Access linked CustomerDeviceOnt records
+     * @remarks Available labels: CustomerDeviceOnt__Activity
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked CustomerDeviceOnt records
+     * const items = await record.customerDeviceOnts.list();
+     * const first = await record.customerDeviceOnts.first();
+     *
+     * // Filter by label
+     * const specific = await record.customerDeviceOnts.first({ label: 'CustomerDeviceOnt__Activity' });
+     * ```
+     */
+    get customerDeviceOnts(): RecordLinkManager<CustomerDeviceOntRecord, typeof ActivityRecord['customerDeviceOntsLabels'][number]>;
+    /** Valid labels for PaymentMethodRefund associations */
+    static readonly paymentMethodRefundsLabels: readonly ["PaymentMethodRefund__Activity"];
+    /**
+     * Access linked PaymentMethodRefund records
+     * @remarks Available labels: PaymentMethodRefund__Activity
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked PaymentMethodRefund records
+     * const items = await record.paymentMethodRefunds.list();
+     * const first = await record.paymentMethodRefunds.first();
+     *
+     * // Filter by label
+     * const specific = await record.paymentMethodRefunds.first({ label: 'PaymentMethodRefund__Activity' });
+     * ```
+     */
+    get paymentMethodRefunds(): RecordLinkManager<PaymentMethodRefundRecord, typeof ActivityRecord['paymentMethodRefundsLabels'][number]>;
+    /** Valid labels for WorkOrder associations */
+    static readonly workOrdersLabels: readonly ["WorkOrder__Activity"];
+    /**
+     * Access linked WorkOrder records
+     * @remarks Available labels: WorkOrder__Activity
+     * @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__Activity' });
+     * ```
+     */
+    get workOrders(): RecordLinkManager<WorkOrderRecord, typeof ActivityRecord['workOrdersLabels'][number]>;
+    /** Valid labels for Order associations */
+    static readonly ordersLabels: readonly ["Order__Activity"];
+    /**
+     * Access linked Order records
+     * @remarks Available labels: Order__Activity
+     * @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__Activity' });
+     * ```
+     */
+    get orders(): RecordLinkManager<OrderRecord, typeof ActivityRecord['ordersLabels'][number]>;
     /**
      * Queue a link to be created with the next action.
      * Works for both create and update actions.