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

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

@@ -13,15 +13,24 @@
  * await record.createOffer({ ... }).execute();
  * ```
  *
+ * Entity Types: DEFAULT, RECONTRACT, STANDARD
+ *
  * 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 { OfferProperties } from '../entities-v2/Offer';
+import { RecordLinkManager } from '@d19n/odin-sdk-generator/dist/record-link-manager';
+import { OfferProperties, RecontractOfferProperties, StandardOfferProperties } from '../entities-v2/Offer';
 import { OfferCreateProperties } from '../actions-v2/OfferCreateDto';
 import { OfferUpdateProperties } from '../actions-v2/OfferUpdateDto';
+import { LeadRecord } from './LeadRecord';
+import { DiscountRecord } from './DiscountRecord';
+import { ProductRecord } from './ProductRecord';
+import { OrderItemRecord } from './OrderItemRecord';
+/** Valid entity types for Offer */
+export declare type OfferType = 'DEFAULT' | 'RECONTRACT' | 'STANDARD';
 /**
  * Builder for action execution with dryRun support
  *
@@ -85,6 +94,11 @@ export declare class OfferRecord<TProps = OfferProperties> {
     private _provider;
     private _pendingLinks;
     private _preGeneratedId;
+    private _leads?;
+    private _discounts?;
+    private _products?;
+    private _offers?;
+    private _orderItems?;
     /**
      * Create a record wrapper.
      * @param record - The underlying record, or null for create operations
@@ -97,7 +111,7 @@ export declare class OfferRecord<TProps = OfferProperties> {
     /** Record ID - always available (pre-generated for new records) */
     get id(): string;
     get entity(): string;
-    get type(): string | undefined;
+    get type(): OfferType | undefined;
     /** Record properties - empty object for new (unsaved) records */
     get properties(): TProps;
     get title(): string | undefined;
@@ -110,6 +124,144 @@ export declare class OfferRecord<TProps = OfferProperties> {
     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 OfferProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks This is the default record type
+     */
+    isDefault(): this is OfferRecord<OfferProperties>;
+    /**
+     * Type guard: check if this record is of type RECONTRACT
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to RECONTRACT-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isRecontract()) {
+     *   // TypeScript knows record.properties is RecontractOfferProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks RECONTRACT
+     */
+    isRecontract(): this is OfferRecord<RecontractOfferProperties>;
+    /**
+     * Type guard: check if this record is of type STANDARD
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to STANDARD-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isStandard()) {
+     *   // TypeScript knows record.properties is StandardOfferProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks STANDARD
+     */
+    isStandard(): this is OfferRecord<StandardOfferProperties>;
+    /** Valid labels for Lead associations */
+    static readonly leadsLabels: readonly ["Lead__Offer"];
+    /**
+     * Access linked Lead records
+     * @remarks Available labels: Lead__Offer
+     * @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__Offer' });
+     * ```
+     */
+    get leads(): RecordLinkManager<LeadRecord, typeof OfferRecord['leadsLabels'][number]>;
+    /** Valid labels for Discount associations */
+    static readonly discountsLabels: readonly ["Offer__Discount"];
+    /**
+     * Access linked Discount records
+     * @remarks Available labels: Offer__Discount
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Discount records
+     * const items = await record.discounts.list();
+     * const first = await record.discounts.first();
+     *
+     * // Filter by label
+     * const specific = await record.discounts.first({ label: 'Offer__Discount' });
+     * ```
+     */
+    get discounts(): RecordLinkManager<DiscountRecord, typeof OfferRecord['discountsLabels'][number]>;
+    /** Valid labels for Product associations */
+    static readonly productsLabels: readonly ["Offer__Product"];
+    /**
+     * Access linked Product records
+     * @remarks Available labels: Offer__Product
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Product records
+     * const items = await record.products.list();
+     * const first = await record.products.first();
+     *
+     * // Filter by label
+     * const specific = await record.products.first({ label: 'Offer__Product' });
+     * ```
+     */
+    get products(): RecordLinkManager<ProductRecord, typeof OfferRecord['productsLabels'][number]>;
+    /** Valid labels for Offer associations */
+    static readonly offersLabels: readonly ["Offer__Offer"];
+    /**
+     * Access linked Offer records
+     * @remarks Available labels: Offer__Offer
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Offer records
+     * const items = await record.offers.list();
+     * const first = await record.offers.first();
+     *
+     * // Filter by label
+     * const specific = await record.offers.first({ label: 'Offer__Offer' });
+     * ```
+     */
+    get offers(): RecordLinkManager<OfferRecord, typeof OfferRecord['offersLabels'][number]>;
+    /** Valid labels for OrderItem associations */
+    static readonly orderItemsLabels: readonly ["OrderItem__Offer"];
+    /**
+     * Access linked OrderItem records
+     * @remarks Available labels: OrderItem__Offer
+     * @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__Offer' });
+     * ```
+     */
+    get orderItems(): RecordLinkManager<OrderItemRecord, typeof OfferRecord['orderItemsLabels'][number]>;
     /**
      * Queue a link to be created with the next action.
      * Works for both create and update actions.

package/dist/records-v2/OfferRecord.js

@@ -14,6 +14,8 @@
  * await record.createOffer({ ... }).execute();
  * ```
  *
+ * Entity Types: DEFAULT, RECONTRACT, STANDARD
+ *
  * 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.isOfferRecord = exports.OfferRecord = 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 LeadRecord_1 = require("./LeadRecord");
+const DiscountRecord_1 = require("./DiscountRecord");
+const ProductRecord_1 = require("./ProductRecord");
+const OrderItemRecord_1 = require("./OrderItemRecord");
 /**
  * Builder for action execution with dryRun support
  *
@@ -140,6 +147,207 @@ class OfferRecord {
     /** 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 OfferProperties
+     *   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'; }
+    /**
+     * Type guard: check if this record is of type RECONTRACT
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to RECONTRACT-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isRecontract()) {
+     *   // TypeScript knows record.properties is RecontractOfferProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks RECONTRACT
+     */
+    isRecontract() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.type) === 'RECONTRACT'; }
+    /**
+     * Type guard: check if this record is of type STANDARD
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to STANDARD-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isStandard()) {
+     *   // TypeScript knows record.properties is StandardOfferProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks STANDARD
+     */
+    isStandard() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.type) === 'STANDARD'; }
+    /**
+     * Access linked Lead records
+     * @remarks Available labels: Lead__Offer
+     * @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__Offer' });
+     * ```
+     */
+    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: 'ProductModule:Offer',
+                targetEntity: 'CrmModule:Lead',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Lead',
+                labels: ['Lead__Offer'],
+            }, LeadRecord_1.LeadRecord);
+        }
+        return this._leads;
+    }
+    /**
+     * Access linked Discount records
+     * @remarks Available labels: Offer__Discount
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Discount records
+     * const items = await record.discounts.list();
+     * const first = await record.discounts.first();
+     *
+     * // Filter by label
+     * const specific = await record.discounts.first({ label: 'Offer__Discount' });
+     * ```
+     */
+    get discounts() {
+        var _a;
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('Cannot access links on a new (unsaved) record');
+        if (!this._discounts) {
+            this._discounts = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'ProductModule:Offer',
+                targetEntity: 'ProductModule:Discount',
+                targetModuleName: 'ProductModule',
+                targetEntityName: 'Discount',
+                labels: ['Offer__Discount'],
+            }, DiscountRecord_1.DiscountRecord);
+        }
+        return this._discounts;
+    }
+    /**
+     * Access linked Product records
+     * @remarks Available labels: Offer__Product
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Product records
+     * const items = await record.products.list();
+     * const first = await record.products.first();
+     *
+     * // Filter by label
+     * const specific = await record.products.first({ label: 'Offer__Product' });
+     * ```
+     */
+    get products() {
+        var _a;
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('Cannot access links on a new (unsaved) record');
+        if (!this._products) {
+            this._products = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'ProductModule:Offer',
+                targetEntity: 'ProductModule:Product',
+                targetModuleName: 'ProductModule',
+                targetEntityName: 'Product',
+                labels: ['Offer__Product'],
+            }, ProductRecord_1.ProductRecord);
+        }
+        return this._products;
+    }
+    /**
+     * Access linked Offer records
+     * @remarks Available labels: Offer__Offer
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Offer records
+     * const items = await record.offers.list();
+     * const first = await record.offers.first();
+     *
+     * // Filter by label
+     * const specific = await record.offers.first({ label: 'Offer__Offer' });
+     * ```
+     */
+    get offers() {
+        var _a;
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('Cannot access links on a new (unsaved) record');
+        if (!this._offers) {
+            this._offers = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'ProductModule:Offer',
+                targetEntity: 'ProductModule:Offer',
+                targetModuleName: 'ProductModule',
+                targetEntityName: 'Offer',
+                labels: ['Offer__Offer'],
+            }, OfferRecord);
+        }
+        return this._offers;
+    }
+    /**
+     * Access linked OrderItem records
+     * @remarks Available labels: OrderItem__Offer
+     * @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__Offer' });
+     * ```
+     */
+    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: 'ProductModule:Offer',
+                targetEntity: 'OrderModule:OrderItem',
+                targetModuleName: 'OrderModule',
+                targetEntityName: 'OrderItem',
+                labels: ['OrderItem__Offer'],
+            }, OrderItemRecord_1.OrderItemRecord);
+        }
+        return this._orderItems;
+    }
+    // ============================================
     // LINK MANAGEMENT
     // ============================================
     /**
@@ -247,6 +455,19 @@ class OfferRecord {
     }
 }
 exports.OfferRecord = OfferRecord;
+// ============================================
+// TYPED LINK ACCESSORS
+// ============================================
+/** Valid labels for Lead associations */
+OfferRecord.leadsLabels = ['Lead__Offer'];
+/** Valid labels for Discount associations */
+OfferRecord.discountsLabels = ['Offer__Discount'];
+/** Valid labels for Product associations */
+OfferRecord.productsLabels = ['Offer__Product'];
+/** Valid labels for Offer associations */
+OfferRecord.offersLabels = ['Offer__Offer'];
+/** Valid labels for OrderItem associations */
+OfferRecord.orderItemsLabels = ['OrderItem__Offer'];
 /** Type guard to check if an object is a OfferRecord */
 function isOfferRecord(obj) {
     return obj instanceof OfferRecord;

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

@@ -13,14 +13,22 @@
  * await record.createOhAuditOfInstallation({ ... }).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 { OhAuditOfInstallationProperties } from '../entities-v2/OhAuditOfInstallation';
+import { RecordLinkManager } from '@d19n/odin-sdk-generator/dist/record-link-manager';
+import { OhAuditOfInstallationProperties, OutcomeFormOhAuditOfInstallationProperties } from '../entities-v2/OhAuditOfInstallation';
 import { OhAuditOfInstallationCreateProperties } from '../actions-v2/CompleteInstallWorkOrderFlowDto';
+import { NoteRecord } from './NoteRecord';
+import { WorkOrderRecord } from './WorkOrderRecord';
+import { FileRecord } from './FileRecord';
+/** Valid entity types for OhAuditOfInstallation */
+export declare type OhAuditOfInstallationType = 'OUTCOME_FORM';
 /**
  * Builder for action execution with dryRun support
  *
@@ -84,6 +92,9 @@ export declare class OhAuditOfInstallationRecord<TProps = OhAuditOfInstallationP
     private _provider;
     private _pendingLinks;
     private _preGeneratedId;
+    private _notes?;
+    private _workOrders?;
+    private _files?;
     /**
      * Create a record wrapper.
      * @param record - The underlying record, or null for create operations
@@ -96,7 +107,7 @@ export declare class OhAuditOfInstallationRecord<TProps = OhAuditOfInstallationP
     /** Record ID - always available (pre-generated for new records) */
     get id(): string;
     get entity(): string;
-    get type(): string | undefined;
+    get type(): OhAuditOfInstallationType | undefined;
     /** Record properties - empty object for new (unsaved) records */
     get properties(): TProps;
     get title(): string | undefined;
@@ -109,6 +120,76 @@ export declare class OhAuditOfInstallationRecord<TProps = OhAuditOfInstallationP
     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 OutcomeFormOhAuditOfInstallationProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks outcome form
+     */
+    isOutcomeForm(): this is OhAuditOfInstallationRecord<OutcomeFormOhAuditOfInstallationProperties>;
+    /** Valid labels for Note associations */
+    static readonly notesLabels: readonly ["OhAuditOfInstallation__Note"];
+    /**
+     * Access linked Note records
+     * @remarks Available labels: OhAuditOfInstallation__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: 'OhAuditOfInstallation__Note' });
+     * ```
+     */
+    get notes(): RecordLinkManager<NoteRecord, typeof OhAuditOfInstallationRecord['notesLabels'][number]>;
+    /** Valid labels for WorkOrder associations */
+    static readonly workOrdersLabels: readonly ["WorkOrder_OhAuditOfInstallation"];
+    /**
+     * Access linked WorkOrder records
+     * @remarks Available labels: WorkOrder_OhAuditOfInstallation
+     * @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_OhAuditOfInstallation' });
+     * ```
+     */
+    get workOrders(): RecordLinkManager<WorkOrderRecord, typeof OhAuditOfInstallationRecord['workOrdersLabels'][number]>;
+    /** Valid labels for File associations */
+    static readonly filesLabels: readonly ["OhAuditOfInstallation__File"];
+    /**
+     * Access linked File records
+     * @remarks Available labels: OhAuditOfInstallation__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: 'OhAuditOfInstallation__File' });
+     * ```
+     */
+    get files(): RecordLinkManager<FileRecord, typeof OhAuditOfInstallationRecord['filesLabels'][number]>;
     /**
      * Queue a link to be created with the next action.
      * Works for both create and update actions.