@d19n/youfibre-odin-sdk 2.0.1 → 2.0.2-beta.1

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

@@ -24,10 +24,13 @@ import { IOdinProvider } from '@d19n/odin-sdk-generator/dist/odin-sdk-types';
 import { RecordLinkManager } from '@d19n/odin-sdk-generator/dist/record-link-manager';
 import { RewardProperties, CashbackRewardProperties } from '../entities-v2/Reward';
 import { CreateCashbackRewardProperties } from '../actions-v2/CreateCashbackRewardDto';
+import { CreateCashbackRewardForOrderReferralProperties } from '../actions-v2/CreateCashbackRewardForOrderReferralDto';
+import { CreateCashbackRewardForOrderReferralBuilder } from '../actions-v2/CreateCashbackRewardForOrderReferralDto';
 import { CampaignRecord } from './CampaignRecord';
 import { ContactRecord } from './ContactRecord';
 import { AffiliateCodeRecord } from './AffiliateCodeRecord';
 import { PaymentMethodRefundRecord } from './PaymentMethodRefundRecord';
+import { ReferralRecord } from './ReferralRecord';
 /** Valid entity types for Reward */
 export declare type RewardType = 'CASHBACK';
 /**
@@ -97,6 +100,7 @@ export declare class RewardRecord<TProps = RewardProperties> {
     private _contacts?;
     private _affiliateCodes?;
     private _paymentMethodRefunds?;
+    private _referrals?;
     /**
      * Create a record wrapper.
      * @param record - The underlying record, or null for create operations
@@ -210,6 +214,24 @@ export declare class RewardRecord<TProps = RewardProperties> {
      * ```
      */
     get paymentMethodRefunds(): RecordLinkManager<PaymentMethodRefundRecord, typeof RewardRecord['paymentMethodRefundsLabels'][number]>;
+    /** Valid labels for Referral associations */
+    static readonly referralsLabels: readonly ["OrderReferralCashbackReward"];
+    /**
+     * Access linked Referral records
+     * @remarks Available labels: OrderReferralCashbackReward
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Referral records
+     * const items = await record.referrals.list();
+     * const first = await record.referrals.first();
+     *
+     * // Filter by label
+     * const specific = await record.referrals.first({ label: 'OrderReferralCashbackReward' });
+     * ```
+     */
+    get referrals(): RecordLinkManager<ReferralRecord, typeof RewardRecord['referralsLabels'][number]>;
     /**
      * Queue a link to be created with the next action.
      * Works for both create and update actions.
@@ -259,6 +281,33 @@ export declare class RewardRecord<TProps = RewardProperties> {
         journeyId?: string;
         stageKey?: string;
     }): ActionBuilder;
+    /**
+     * CreateCashbackRewardForOrderReferral
+     *
+     * Creates a new Reward record with the specified properties.
+     * Returns a builder with fluent .link*() methods for associations.
+     * Call .execute() to create or .dryRun() for debugging.
+     *
+     * @remarks Record type: CASHBACK
+     *
+     * @param properties - The properties for the new record
+     * @param options - Optional settings
+     * @param options.journeyId - Associate with a journey
+     * @param options.stageKey - Set initial pipeline stage
+     * @returns CreateCashbackRewardForOrderReferralBuilder - chain .link*() then .execute()
+     *
+     * @example
+     * ```typescript
+     * const record = odinClient.rewards.new();
+     * await record.createCashbackRewardForOrderReferral({ ... })
+     *   .linkAssociation_xxx(target)
+     *   .execute();
+     * ```
+     */
+    createCashbackRewardForOrderReferral(properties: CreateCashbackRewardForOrderReferralProperties, options?: {
+        journeyId?: string;
+        stageKey?: string;
+    }): CreateCashbackRewardForOrderReferralBuilder;
     /**
      * MoveCashbackRewardToAwarded
      *

package/dist/records-v2/RewardRecord.js

@@ -32,10 +32,12 @@ exports.isRewardRecord = exports.RewardRecord = 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 CreateCashbackRewardForOrderReferralDto_1 = require("../actions-v2/CreateCashbackRewardForOrderReferralDto");
 const CampaignRecord_1 = require("./CampaignRecord");
 const ContactRecord_1 = require("./ContactRecord");
 const AffiliateCodeRecord_1 = require("./AffiliateCodeRecord");
 const PaymentMethodRefundRecord_1 = require("./PaymentMethodRefundRecord");
+const ReferralRecord_1 = require("./ReferralRecord");
 /**
  * Builder for action execution with dryRun support
  *
@@ -285,6 +287,36 @@ class RewardRecord {
         }
         return this._paymentMethodRefunds;
     }
+    /**
+     * Access linked Referral records
+     * @remarks Available labels: OrderReferralCashbackReward
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Referral records
+     * const items = await record.referrals.list();
+     * const first = await record.referrals.first();
+     *
+     * // Filter by label
+     * const specific = await record.referrals.first({ label: 'OrderReferralCashbackReward' });
+     * ```
+     */
+    get referrals() {
+        var _a;
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('Cannot access links on a new (unsaved) record');
+        if (!this._referrals) {
+            this._referrals = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'CrmModule:Reward',
+                targetEntity: 'CrmModule:Referral',
+                targetModuleName: 'CrmModule',
+                targetEntityName: 'Referral',
+                labels: ['OrderReferralCashbackReward'],
+            }, ReferralRecord_1.ReferralRecord);
+        }
+        return this._referrals;
+    }
     // ============================================
     // LINK MANAGEMENT
     // ============================================
@@ -359,6 +391,32 @@ class RewardRecord {
         };
         return new ActionBuilder(this._provider, 'CrmModule', 'Reward', payload, () => { this._pendingLinks = []; });
     }
+    /**
+     * CreateCashbackRewardForOrderReferral
+     *
+     * Creates a new Reward record with the specified properties.
+     * Returns a builder with fluent .link*() methods for associations.
+     * Call .execute() to create or .dryRun() for debugging.
+     *
+     * @remarks Record type: CASHBACK
+     *
+     * @param properties - The properties for the new record
+     * @param options - Optional settings
+     * @param options.journeyId - Associate with a journey
+     * @param options.stageKey - Set initial pipeline stage
+     * @returns CreateCashbackRewardForOrderReferralBuilder - chain .link*() then .execute()
+     *
+     * @example
+     * ```typescript
+     * const record = odinClient.rewards.new();
+     * await record.createCashbackRewardForOrderReferral({ ... })
+     *   .linkAssociation_xxx(target)
+     *   .execute();
+     * ```
+     */
+    createCashbackRewardForOrderReferral(properties, options) {
+        return new CreateCashbackRewardForOrderReferralDto_1.CreateCashbackRewardForOrderReferralBuilder(properties || {}, [...this._pendingLinks], options).withProvider(this._provider, 'CrmModule', 'Reward', () => { this._pendingLinks = []; });
+    }
     // ============================================
     // UPDATE ACTIONS (require existing record)
     // ============================================
@@ -433,6 +491,8 @@ RewardRecord.contactsLabels = ['ContactReward'];
 RewardRecord.affiliateCodesLabels = ['AffiliateCodeRewards'];
 /** Valid labels for PaymentMethodRefund associations */
 RewardRecord.paymentMethodRefundsLabels = ['RewardPaymentMethodRefund'];
+/** Valid labels for Referral associations */
+RewardRecord.referralsLabels = ['OrderReferralCashbackReward'];
 /** Type guard to check if an object is a RewardRecord */
 function isRewardRecord(obj) {
     return obj instanceof RewardRecord;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d19n/youfibre-odin-sdk",
-  "version": "2.0.1",
+  "version": "2.0.2-beta.1",
   "description": "",
   "author": "@d19n",
   "license": "UNLICENSED",