@d19n/youfibre-odin-sdk 1.0.241 → 1.0.242

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

@@ -20,7 +20,8 @@ import { RecordLinkManager } from '@d19n/odin-sdk-generator/dist/record-link-man
 import { AddressProperties } from '../entities-v2/Address';
 import { AddressCreateProperties } from '../actions-v2/AddressCreateDto';
 import { AddressUpdateProperties } from '../actions-v2/AddressUpdateDto';
-import { CreateLeadFromAddressProperties } from '../actions-v2/CreateLeadFromAddressDto';
+import { CreateLeadProperties } from '../actions-v2/CreateLeadFromAddressDto';
+import { CreateContactProperties } from '../actions-v2/CreateLeadFromAddressDto';
 import { OrderRecord } from './OrderRecord';
 import { ContactRecord } from './ContactRecord';
 import { CustomerDeviceOntRecord } from './CustomerDeviceOntRecord';
@@ -35,6 +36,38 @@ import { CrmDatasetRecord } from './CrmDatasetRecord';
 import { CaseRecord } from './CaseRecord';
 import { LeadRecord } from './LeadRecord';
 import { AccountRecord } from './AccountRecord';
+/**
+ * FlowBuilder for CreateLeadFromAddress multi-step action
+ *
+ * Use method chaining to add steps, then call execute() to run the flow.
+ */
+declare class CreateLeadFromAddressFlowBuilder {
+    private _record;
+    private _provider;
+    private _pendingLinks;
+    private _options?;
+    private _steps;
+    constructor(record: AddressRecord, provider: IOdinProvider, pendingLinks: OdinRecordLinkDto[], options?: {
+        journeyId?: string;
+    });
+    /**
+     * Add CreateLead step to the flow
+     * @param properties - Properties for this step
+     * @returns this (for method chaining)
+     */
+    createLead(properties: CreateLeadProperties): this;
+    /**
+     * Add CreateContact step to the flow
+     * @param properties - Properties for this step
+     * @returns this (for method chaining)
+     */
+    createContact(properties: CreateContactProperties): this;
+    /**
+     * Execute the flow with all collected steps
+     * @returns The action result
+     */
+    execute(): Promise<IDbRecordCreateUpdateRes[]>;
+}
 export declare class AddressRecord {
     private _record;
     private _provider;
@@ -330,26 +363,27 @@ export declare class AddressRecord {
     /**
      * CreateLeadFromAddress
      *
-     * Updates this Address record.
+     * Starts a multi-step flow action on this Address record.
+     * Chain step methods and call .execute() to run the flow.
      *
-     * @param propertiesOrOptions - Properties to update, or options object
-     * @param options - Optional settings (journeyId, stageKey)
-     * @returns The updated record(s)
+     * @param options - Optional settings
+     * @param options.journeyId - Associate with a journey
+     * @returns FlowBuilder for chaining step methods
      * @throws Error if called on a new (unsaved) record
      *
      * @example
      * ```typescript
      * const record = await odinClient.addresss.get(id);
-     * await record.createLeadFromAddress({ ... });
+     * await record.createLeadFromAddress()
+     *   .createLead({ ... })
+     *   .createContact({ ... })
+     *   .execute();
      * ```
      */
-    createLeadFromAddress(propertiesOrOptions?: CreateLeadFromAddressProperties | {
-        journeyId?: string;
-        stageKey?: string;
-    }, options?: {
+    createLeadFromAddress(options?: {
         journeyId?: string;
-        stageKey?: string;
-    }): Promise<IDbRecordCreateUpdateRes[]>;
+    }): CreateLeadFromAddressFlowBuilder;
 }
 /** Type guard to check if an object is a AddressRecord */
 export declare function isAddressRecord(obj: any): obj is AddressRecord;
+export {};

package/dist/records-v2/AddressRecord.js

@@ -40,6 +40,53 @@ const CrmDatasetRecord_1 = require("./CrmDatasetRecord");
 const CaseRecord_1 = require("./CaseRecord");
 const LeadRecord_1 = require("./LeadRecord");
 const AccountRecord_1 = require("./AccountRecord");
+/**
+ * FlowBuilder for CreateLeadFromAddress multi-step action
+ *
+ * Use method chaining to add steps, then call execute() to run the flow.
+ */
+class CreateLeadFromAddressFlowBuilder {
+    constructor(record, provider, pendingLinks, options) {
+        this._steps = [];
+        this._record = record;
+        this._provider = provider;
+        this._pendingLinks = pendingLinks;
+        this._options = options;
+    }
+    /**
+     * Add CreateLead step to the flow
+     * @param properties - Properties for this step
+     * @returns this (for method chaining)
+     */
+    createLead(properties) {
+        this._steps.push({ actionKey: 'CreateLead', properties });
+        return this;
+    }
+    /**
+     * Add CreateContact step to the flow
+     * @param properties - Properties for this step
+     * @returns this (for method chaining)
+     */
+    createContact(properties) {
+        this._steps.push({ actionKey: 'CreateContact', properties });
+        return this;
+    }
+    /**
+     * Execute the flow with all collected steps
+     * @returns The action result
+     */
+    execute() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const rawRecord = this._record.raw;
+            if (!(rawRecord === null || rawRecord === void 0 ? void 0 : rawRecord.id))
+                throw new Error('Cannot execute flow on unsaved record');
+            const result = yield this._provider._applyAction('CrmModule', 'Address', Object.assign({ id: rawRecord.id, entity: rawRecord.entity, type: rawRecord.type, actionName: 'CreateLeadFromAddress', steps: this._steps, associations: this._pendingLinks.length > 0 ? this._pendingLinks : undefined }, this._options));
+            // Clear pending links on the record after execution
+            this._record.clearPendingLinks();
+            return result;
+        });
+    }
+}
 class AddressRecord {
     /**
      * Create a record wrapper.
@@ -581,38 +628,28 @@ class AddressRecord {
     /**
      * CreateLeadFromAddress
      *
-     * Updates this Address record.
+     * Starts a multi-step flow action on this Address record.
+     * Chain step methods and call .execute() to run the flow.
      *
-     * @param propertiesOrOptions - Properties to update, or options object
-     * @param options - Optional settings (journeyId, stageKey)
-     * @returns The updated record(s)
+     * @param options - Optional settings
+     * @param options.journeyId - Associate with a journey
+     * @returns FlowBuilder for chaining step methods
      * @throws Error if called on a new (unsaved) record
      *
      * @example
      * ```typescript
      * const record = await odinClient.addresss.get(id);
-     * await record.createLeadFromAddress({ ... });
+     * await record.createLeadFromAddress()
+     *   .createLead({ ... })
+     *   .createContact({ ... })
+     *   .execute();
      * ```
      */
-    createLeadFromAddress(propertiesOrOptions, options) {
+    createLeadFromAddress(options) {
         var _a;
-        return __awaiter(this, void 0, void 0, function* () {
-            if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
-                throw new Error('createLeadFromAddress requires an existing record. Use accessor.get() first.');
-            let properties = {};
-            let opts = options;
-            if (propertiesOrOptions) {
-                if ('journeyId' in propertiesOrOptions || 'stageKey' in propertiesOrOptions) {
-                    opts = propertiesOrOptions;
-                }
-                else {
-                    properties = propertiesOrOptions;
-                }
-            }
-            const result = yield this._provider._applyAction('CrmModule', 'Address', Object.assign({ id: this._record.id, entity: this._record.entity, type: this._record.type, actionName: 'CreateLeadFromAddress', properties, associations: this._pendingLinks.length > 0 ? this._pendingLinks : undefined }, opts));
-            this._pendingLinks = [];
-            return result;
-        });
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('createLeadFromAddress requires an existing record. Use accessor.get() first.');
+        return new CreateLeadFromAddressFlowBuilder(this, this._provider, this._pendingLinks, options);
     }
 }
 exports.AddressRecord = AddressRecord;