@d19n/youfibre-odin-sdk 2.0.233-beta.6 → 2.0.233-beta.7

package/README.md

@@ -1501,7 +1501,7 @@ This SDK includes **746** actions.
 | `CreateModifyServiceRequest` | CREATE | k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Create.CreateModifyServiceRequest |
 | `MoveMsrToComplete` | STAGE_TRANSITION | k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Update.UpdateModifyServiceRequest |
 | `MoveMsrToFailed` | STAGE_TRANSITION | k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Update.UpdateModifyServiceRequest |
-| `MoveMsrToHeld` | STAGE_TRANSITION | k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Transition.MoveMsrToHeld |
+| `MoveMsrToHeld` | STAGE_TRANSITION | k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Update.UpdateModifyServiceRequest |
 | `MoveMsrToInProgress` | STAGE_TRANSITION | k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Update.UpdateModifyServiceRequest |
 | `UpdateModifyServiceRequest` | UPDATE | k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Update.UpdateModifyServiceRequest |
 

package/dist/actions-v2/MoveMsrToHeldDto.d.ts

@@ -12,7 +12,101 @@
  * AUTO-GENERATED - DO NOT EDIT DIRECTLY
  */
 import { OdinRecord, OdinRecordUpdateDto, OdinRecordUpdatedEvent } from '@d19n/odin-types/dist/core';
-declare type StepClassMap = {};
+/**
+ * Properties for UpdateModifyServiceRequest action
+ *
+ * @property Required fields: 0
+ * @property Optional fields: 7
+ */
+export interface UpdateModifyServiceRequestProperties {
+    /**
+     * Service ID
+     *
+     * The ID of the service being modified
+     * @type {TEXT}
+     */
+    ServiceId?: string | null;
+    /**
+     * SKU Previous
+     *
+     * The previous SKU being modified from (Used for Line Profile mapping)
+     * @type {TEXT}
+     */
+    SkuPrevious?: string | null;
+    /**
+     * SKU Next
+     *
+     * The next SKU being modified to (Used for Line Profile mapping)
+     * @type {TEXT}
+     */
+    SkuNext?: string | null;
+    /**
+     * FNO Modify Status
+     *
+     * FNO Modify Status
+     * @type {ENUM}
+     */
+    FnoModifyStatus?: string | null;
+    /**
+     * FNO Comment
+     *
+     * FNO Comment
+     * @type {TEXT_LONG}
+     */
+    FnoComment?: string | null;
+    /**
+     * ISP Modify Status
+     *
+     * ISP Modify Status
+     * @type {ENUM}
+     */
+    IspModifyStatus?: string | null;
+    /**
+     * ISP Comment
+     *
+     * ISP Comment
+     * @type {TEXT_LONG}
+     */
+    IspComment?: string | null;
+}
+/**
+ * UpdateModifyServiceRequest
+ *
+ * @actionType UPDATE - Updates an existing ModifyServiceRequest record
+ * @module ServiceModule
+ * @entity ModifyServiceRequest
+ * @event k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Update.UpdateModifyServiceRequest
+ * @permission schema.action.updatemodifyservicerequest.trigger
+ * @benchmark This action is tracked for performance benchmarks
+ */
+export declare class UpdateModifyServiceRequestDto extends OdinRecordUpdateDto<UpdateModifyServiceRequestProperties> {
+    /** Used by SDK generators to identify action type */
+    static readonly ACTION_TYPE = "UPDATE";
+    static readonly ACTION_KEY = "UpdateModifyServiceRequest";
+    static readonly MODULE_NAME = "ServiceModule";
+    static readonly ENTITIES: string[];
+    static readonly EVENT_NAME = "k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Update.UpdateModifyServiceRequest";
+    static readonly PERMISSION = "schema.action.updatemodifyservicerequest.trigger";
+    /** Step metadata - entity this action targets */
+    static readonly STEP_ENTITY = "ServiceModule:ModifyServiceRequest";
+    static readonly STEP_SCHEMA_ID = "c33f6215-f398-4d02-a35a-ebcde2ee2669";
+    static readonly STEP_SCHEMA_ACTION_ID = "f4fb3994-062a-46f6-ad1b-badfa0bf3afa";
+    static readonly AUTO_LINK_PARENT = false;
+    readonly actionName: string;
+    readonly schemaActionId: string;
+    readonly entity: string;
+    constructor(record: OdinRecord<any> | {
+        id: string;
+        entity: string;
+        type?: string;
+    }, properties: UpdateModifyServiceRequestProperties, options?: {
+        journeyId?: string;
+        stageKey?: string;
+    });
+}
+declare type StepClassMap = {
+    UpdateModifyServiceRequestDto: UpdateModifyServiceRequestDto;
+};
 /**
  * Link definition for connecting steps in MoveMsrToHeld
  */
@@ -109,7 +203,7 @@ export declare class MoveMsrToHeldDto extends OdinRecordUpdateDto<Record<string,
         journeyId?: string;
     });
     /** Step classes that can be used with this action */
-    static readonly stepClasses: readonly [];
+    static readonly stepClasses: readonly ["UpdateModifyServiceRequestDto"];
     steps: StepClassMap[(typeof MoveMsrToHeldDto.stepClasses)[number]][];
 }
 export {};

package/dist/actions-v2/MoveMsrToHeldDto.js

@@ -13,8 +13,46 @@
  * AUTO-GENERATED - DO NOT EDIT DIRECTLY
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MoveMsrToHeldDto = exports.MoveMsrToHeldSteps = void 0;
+exports.MoveMsrToHeldDto = exports.MoveMsrToHeldSteps = exports.UpdateModifyServiceRequestDto = void 0;
 const core_1 = require("@d19n/odin-types/dist/core");
+/**
+ * UpdateModifyServiceRequest
+ *
+ * @actionType UPDATE - Updates an existing ModifyServiceRequest record
+ * @module ServiceModule
+ * @entity ModifyServiceRequest
+ * @event k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Update.UpdateModifyServiceRequest
+ * @permission schema.action.updatemodifyservicerequest.trigger
+ * @benchmark This action is tracked for performance benchmarks
+ */
+class UpdateModifyServiceRequestDto extends core_1.OdinRecordUpdateDto {
+    constructor(record, properties, options) {
+        super({
+            id: record.id,
+            entity: record.entity,
+            type: record.type,
+            properties,
+            journeyId: options === null || options === void 0 ? void 0 : options.journeyId,
+            stageKey: options === null || options === void 0 ? void 0 : options.stageKey,
+        });
+        this.actionName = 'UpdateModifyServiceRequest';
+        this.schemaActionId = 'f4fb3994-062a-46f6-ad1b-badfa0bf3afa';
+        this.entity = 'ServiceModule:ModifyServiceRequest';
+    }
+}
+exports.UpdateModifyServiceRequestDto = UpdateModifyServiceRequestDto;
+/** Used by SDK generators to identify action type */
+UpdateModifyServiceRequestDto.ACTION_TYPE = 'UPDATE';
+UpdateModifyServiceRequestDto.ACTION_KEY = 'UpdateModifyServiceRequest';
+UpdateModifyServiceRequestDto.MODULE_NAME = 'ServiceModule';
+UpdateModifyServiceRequestDto.ENTITIES = ['ModifyServiceRequest'];
+UpdateModifyServiceRequestDto.EVENT_NAME = 'k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Update.UpdateModifyServiceRequest';
+UpdateModifyServiceRequestDto.PERMISSION = 'schema.action.updatemodifyservicerequest.trigger';
+/** Step metadata - entity this action targets */
+UpdateModifyServiceRequestDto.STEP_ENTITY = 'ServiceModule:ModifyServiceRequest';
+UpdateModifyServiceRequestDto.STEP_SCHEMA_ID = 'c33f6215-f398-4d02-a35a-ebcde2ee2669';
+UpdateModifyServiceRequestDto.STEP_SCHEMA_ACTION_ID = 'f4fb3994-062a-46f6-ad1b-badfa0bf3afa';
+UpdateModifyServiceRequestDto.AUTO_LINK_PARENT = false;
 /**
  * Type-safe step keys for MoveMsrToHeld
  */
@@ -69,12 +107,12 @@ MoveMsrToHeldDto.HAS_STEP_LINKS = false;
 MoveMsrToHeldDto.stepDefinitions = [
     {
         stepKey: 'step_1',
-        dtoClass: 'unknown',
-        entity: 'unknown',
+        dtoClass: 'UpdateModifyServiceRequestDto',
+        entity: 'ServiceModule:ModifyServiceRequest',
         linksTo: null
     }
 ];
 /** Type-safe step key accessor */
 MoveMsrToHeldDto.Steps = exports.MoveMsrToHeldSteps;
 /** Step classes that can be used with this action */
-MoveMsrToHeldDto.stepClasses = [];
+MoveMsrToHeldDto.stepClasses = ['UpdateModifyServiceRequestDto'];

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

@@ -212,6 +212,68 @@ export declare class MoveMsrToFailedFlowBuilder {
     private _buildRequestPayload;
 }
 /** Options for a flow step */
+export interface MoveMsrToHeldFlowBuilderStepOptions {
+    /** Associations to create with this step */
+    associations?: Array<{
+        recordId?: string;
+        entity?: string;
+    }>;
+    /** Groups for this step */
+    groups?: string[];
+}
+/**
+ * FlowBuilder for MoveMsrToHeld multi-step action
+ *
+ * Use method chaining to add steps, then call execute() to run the flow.
+ * Transitions to stage: ModifyServiceRequestStateStageHeld
+ */
+export declare class MoveMsrToHeldFlowBuilder {
+    private _record;
+    private _provider;
+    private _pendingLinks;
+    private _options?;
+    private _groups;
+    private _steps;
+    constructor(record: ModifyServiceRequestRecord<any>, provider: IOdinProvider, pendingLinks: OdinRecordLinkDto[], options?: {
+        journeyId?: string;
+    });
+    /**
+     * Add a group to the main action
+     * @param group - Group name to add
+     * @returns this (for method chaining)
+     */
+    addGroup(group: string): this;
+    /**
+     * Add UpdateModifyServiceRequest step to the flow
+     * @param id - ID of the record to update
+     * @param properties - Properties for this step
+     * @param options - Optional step settings
+     * @returns this (for method chaining)
+     */
+    updateModifyServiceRequest(id: string, properties: UpdateModifyServiceRequestProperties, options?: MoveMsrToHeldFlowBuilderStepOptions): this;
+    /**
+     * Execute the flow
+     * @returns The result from the API
+     */
+    execute(): Promise<IDbRecordCreateUpdateRes[]>;
+    /**
+     * Returns the request payload without executing (for debugging)
+     * @returns The request payload that would be sent to the API
+     */
+    dryRun(): Record<string, any>;
+    /**
+     * Prevents accidental `await flowBuilder` without .execute()
+     * Forces developers to explicitly call .execute()
+     * @throws Error always - use .execute() or .dryRun() instead
+     */
+    then(): never;
+    /**
+     * Build the request payload for the action
+     * @private
+     */
+    private _buildRequestPayload;
+}
+/** Options for a flow step */
 export interface MoveMsrToInProgressFlowBuilderStepOptions {
     /** Associations to create with this step */
     associations?: Array<{
@@ -484,28 +546,27 @@ export declare class ModifyServiceRequestRecord<TProps = ModifyServiceRequestPro
     /**
      * MoveMsrToHeld
      *
-     * Transitions this ModifyServiceRequest record to a new pipeline stage.
-     * Returns an ActionBuilder - call .execute() to transition or .dryRun() for debugging.
+     * Starts a stage transition flow on this ModifyServiceRequest record.
+     * Chain step methods and call .execute() to run the flow.
      *
      * @remarks Transitions to stage: ModifyServiceRequestStateStageHeld
      *
      * @param options - Optional settings
      * @param options.journeyId - Associate with a journey
-     * @returns ActionBuilder - call .execute() to transition or .dryRun() for payload
+     * @returns FlowBuilder for chaining step methods
      * @throws Error if called on a new (unsaved) record
      *
      * @example
      * ```typescript
      * const record = await odinClient.modifyServiceRequests.get(id);
-     * await record.moveMsrToHeld().execute();
-     *
-     * // Dry run (for debugging)
-     * const payload = record.moveMsrToHeld().dryRun();
+     * await record.moveMsrToHeld()
+     *   .updateModifyServiceRequest(recordId, { ... })
+     *   .execute();
      * ```
      */
     moveMsrToHeld(options?: {
         journeyId?: string;
-    }): ActionBuilder;
+    }): MoveMsrToHeldFlowBuilder;
     /**
      * MoveMsrToInProgress
      *

package/dist/records-v2/ModifyServiceRequestRecord.js

@@ -28,7 +28,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isModifyServiceRequestRecord = exports.ModifyServiceRequestRecord = exports.MoveMsrToInProgressFlowBuilder = exports.MoveMsrToFailedFlowBuilder = exports.MoveMsrToCompleteFlowBuilder = void 0;
+exports.isModifyServiceRequestRecord = exports.ModifyServiceRequestRecord = exports.MoveMsrToInProgressFlowBuilder = exports.MoveMsrToHeldFlowBuilder = exports.MoveMsrToFailedFlowBuilder = exports.MoveMsrToCompleteFlowBuilder = 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");
@@ -324,6 +324,113 @@ class MoveMsrToFailedFlowBuilder {
     }
 }
 exports.MoveMsrToFailedFlowBuilder = MoveMsrToFailedFlowBuilder;
+/**
+ * FlowBuilder for MoveMsrToHeld multi-step action
+ *
+ * Use method chaining to add steps, then call execute() to run the flow.
+ * Transitions to stage: ModifyServiceRequestStateStageHeld
+ */
+class MoveMsrToHeldFlowBuilder {
+    constructor(record, provider, pendingLinks, options) {
+        this._groups = [];
+        this._steps = [];
+        this._record = record;
+        this._provider = provider;
+        this._pendingLinks = pendingLinks;
+        this._options = options;
+    }
+    /**
+     * Add a group to the main action
+     * @param group - Group name to add
+     * @returns this (for method chaining)
+     */
+    addGroup(group) {
+        this._groups.push(group);
+        return this;
+    }
+    /**
+     * Add UpdateModifyServiceRequest step to the flow
+     * @param id - ID of the record to update
+     * @param properties - Properties for this step
+     * @param options - Optional step settings
+     * @returns this (for method chaining)
+     */
+    updateModifyServiceRequest(id, properties, options) {
+        var _a;
+        this._steps.push({
+            actionName: 'UpdateModifyServiceRequest',
+            properties,
+            id,
+            entity: 'ServiceModule:ModifyServiceRequest',
+            autoLinkParent: false,
+            associations: (_a = options === null || options === void 0 ? void 0 : options.associations) === null || _a === void 0 ? void 0 : _a.map(a => (Object.assign(Object.assign({}, a), { linkType: null, relationType: undefined }))),
+            groups: options === null || options === void 0 ? void 0 : options.groups,
+        });
+        return this;
+    }
+    /**
+     * Execute the flow
+     * @returns The result from the API
+     */
+    execute() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const payload = this._buildRequestPayload();
+            const result = yield this._provider._applyAction('ServiceModule', 'ModifyServiceRequest', payload);
+            // Clear pending links on the record after execution
+            this._record.clearPendingLinks();
+            return result;
+        });
+    }
+    /**
+     * Returns the request payload without executing (for debugging)
+     * @returns The request payload that would be sent to the API
+     */
+    dryRun() {
+        return this._buildRequestPayload();
+    }
+    /**
+     * Prevents accidental `await flowBuilder` without .execute()
+     * Forces developers to explicitly call .execute()
+     * @throws Error always - use .execute() or .dryRun() instead
+     */
+    then() {
+        throw new Error('FlowBuilder cannot be awaited directly. Call .execute() to run the flow or .dryRun() to get the payload.');
+    }
+    /**
+     * Build the request payload for the action
+     * @private
+     */
+    _buildRequestPayload() {
+        const record = this._record.record;
+        if (!(record === null || record === void 0 ? void 0 : record.id))
+            throw new Error('Cannot execute flow on unsaved record');
+        // Build steps with parent associations
+        const stepsWithAssociations = this._steps.map(step => {
+            const stepAssociations = [...(step.associations || [])];
+            // Auto-add parent association if step requires it
+            if (step.autoLinkParent) {
+                stepAssociations.push({
+                    entity: record.entity,
+                    recordId: record.id,
+                    linkType: null,
+                    relationType: 'PARENT',
+                });
+            }
+            return {
+                entity: step.entity,
+                type: step.type,
+                actionName: step.actionName,
+                properties: step.properties,
+                title: step.title,
+                id: step.id,
+                associations: stepAssociations.length > 0 ? stepAssociations : undefined,
+                groups: step.groups,
+            };
+        });
+        return Object.assign({ id: record.id, entity: record.entity, type: record.type, actionName: 'MoveMsrToHeld', steps: stepsWithAssociations, associations: this._pendingLinks.length > 0 ? this._pendingLinks : undefined, groups: this._groups.length > 0 ? this._groups : undefined, stageKey: 'ModifyServiceRequestStateStageHeld' }, this._options);
+    }
+}
+exports.MoveMsrToHeldFlowBuilder = MoveMsrToHeldFlowBuilder;
 /**
  * FlowBuilder for MoveMsrToInProgress multi-step action
  *
@@ -715,31 +822,29 @@ class ModifyServiceRequestRecord {
     /**
      * MoveMsrToHeld
      *
-     * Transitions this ModifyServiceRequest record to a new pipeline stage.
-     * Returns an ActionBuilder - call .execute() to transition or .dryRun() for debugging.
+     * Starts a stage transition flow on this ModifyServiceRequest record.
+     * Chain step methods and call .execute() to run the flow.
      *
      * @remarks Transitions to stage: ModifyServiceRequestStateStageHeld
      *
      * @param options - Optional settings
      * @param options.journeyId - Associate with a journey
-     * @returns ActionBuilder - call .execute() to transition or .dryRun() for payload
+     * @returns FlowBuilder for chaining step methods
      * @throws Error if called on a new (unsaved) record
      *
      * @example
      * ```typescript
      * const record = await odinClient.modifyServiceRequests.get(id);
-     * await record.moveMsrToHeld().execute();
-     *
-     * // Dry run (for debugging)
-     * const payload = record.moveMsrToHeld().dryRun();
+     * await record.moveMsrToHeld()
+     *   .updateModifyServiceRequest(recordId, { ... })
+     *   .execute();
      * ```
      */
     moveMsrToHeld(options) {
         var _a;
         if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
             throw new Error('moveMsrToHeld requires an existing record. Use accessor.get() first.');
-        const payload = Object.assign({ id: this._record.id, entity: this._record.entity, type: this._record.type, actionName: 'MoveMsrToHeld', associations: this._pendingLinks.length > 0 ? this._pendingLinks : undefined, stageKey: 'ModifyServiceRequestStateStageHeld' }, options);
-        return new ActionBuilder(this._provider, 'ServiceModule', 'ModifyServiceRequest', payload, () => { this._pendingLinks = []; });
+        return new MoveMsrToHeldFlowBuilder(this, this._provider, this._pendingLinks, options);
     }
     /**
      * MoveMsrToInProgress

package/package.json

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