@d19n/youfibre-odin-sdk 2.0.246 → 2.0.248

package/README.md

@@ -356,7 +356,7 @@ This SDK includes **168** entities across **12** modules.
 
 ## Actions
 
-This SDK includes **736** actions.
+This SDK includes **737** actions.
 
 ### Action Types
 
@@ -1500,12 +1500,15 @@ This SDK includes **736** actions.
 | Action | Type | Event |
 |--------|------|-------|
 | `CreateModifyServiceRequest` | CREATE | k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Create.CreateModifyServiceRequest |
+| `MoveMsrToCancelled` | STAGE_TRANSITION | k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Update.UpdateModifyServiceRequest |
 | `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.Update.UpdateModifyServiceRequest |
 | `MoveMsrToInProgress` | STAGE_TRANSITION | k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Update.UpdateModifyServiceRequest |
 | `UpdateModifyServiceRequest` | UPDATE | k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Update.UpdateModifyServiceRequest |
 
+**MoveMsrToCancelled Target Stages:** `ModifyServiceRequestStateStageCancelled`
+
 **MoveMsrToComplete Target Stages:** `ModifyServiceRequestStateStageCompleted`
 
 **MoveMsrToFailed Target Stages:** `ModifyServiceRequestStateStageFailed`

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

@@ -0,0 +1,209 @@
+/**
+ * MoveMsrToCancelled Action DTO
+ *
+ * MoveMsrToCancelled
+ *
+ * @module ServiceModule
+ * @entity ModifyServiceRequest
+ * @entityType DEFAULT
+ * @actionKey MoveMsrToCancelled
+ * @event k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Transition.MoveMsrToCancelled
+ *
+ * AUTO-GENERATED - DO NOT EDIT DIRECTLY
+ */
+import { OdinRecord, OdinRecordUpdateDto, OdinRecordUpdatedEvent } from '@d19n/odin-types/dist/core';
+/**
+ * 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 = "e3ee21c4-f2bf-4931-867d-e02e70699221";
+    static readonly STEP_SCHEMA_ACTION_ID = "1065703e-e4d3-4010-bab0-4b0c08534c1d";
+    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 MoveMsrToCancelled
+ */
+export interface MoveMsrToCancelledStepLink {
+    /**
+     * The stepKey of the target step to link TO
+     * Must reference another step's stepKey in the same flow
+     */
+    stepKey: string;
+    /**
+     * The schema association ID (UUID) defining the relationship
+     * Use the association.id from the schema association definition
+     * @example "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
+     */
+    schemaAssociationId: string;
+}
+/**
+ * Step definition with linking metadata for MoveMsrToCancelled
+ */
+export interface MoveMsrToCancelledStepDefinition {
+    /** Unique identifier for this step */
+    stepKey: string;
+    /** The DTO class name for this step */
+    dtoClass: string;
+    /** The entity this step creates (Module:Entity format) */
+    entity: string;
+    /** Links to create after this step executes */
+    linksTo: MoveMsrToCancelledStepLink[] | null;
+}
+/**
+ * Type-safe step keys for MoveMsrToCancelled
+ */
+export declare const MoveMsrToCancelledSteps: {
+    readonly step_1: "step_1";
+};
+export declare type MoveMsrToCancelledStepKey = typeof MoveMsrToCancelledSteps[keyof typeof MoveMsrToCancelledSteps];
+/**
+ * RabbitMQ message payload for MoveMsrToCancelled step flow events
+ *
+ * @event k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Transition.MoveMsrToCancelled
+ */
+export interface MoveMsrToCancelledMessage extends OdinRecordUpdatedEvent<MoveMsrToCancelledDto, {}> {
+}
+/**
+ * Properties for MoveMsrToCancelled action
+ *
+ */
+export interface MoveMsrToCancelledProperties {
+}
+/**
+ * MoveMsrToCancelled
+ *
+ * @actionType STAGE_TRANSITION - Transitions record to new pipeline stage
+ * @module ServiceModule
+ * @entity ModifyServiceRequest
+ * @entityType DEFAULT (Default)
+ * @targetStages ModifyServiceRequestStateStageCancelled
+ * @event k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Transition.MoveMsrToCancelled
+ * @permission schema.action.movemsrtocancelled.trigger
+ * @benchmark This action is tracked for performance benchmarks
+ */
+export declare class MoveMsrToCancelledDto extends OdinRecordUpdateDto<Record<string, any>> {
+    /** Used by SDK generators to identify action type */
+    static readonly ACTION_TYPE = "UPDATE";
+    static readonly ACTION_KEY = "MoveMsrToCancelled";
+    static readonly MODULE_NAME = "ServiceModule";
+    static readonly ENTITIES: string[];
+    static readonly ENTITY_TYPE = "DEFAULT";
+    static readonly EVENT_NAME = "k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Transition.MoveMsrToCancelled";
+    static readonly SCHEMA_ACTION_ID = "7d70b973-7823-4625-bb7d-9c65aa9e0cfb";
+    static readonly PERMISSION = "schema.action.movemsrtocancelled.trigger";
+    static readonly TARGET_STAGES: readonly ["ModifyServiceRequestStateStageCancelled"];
+    static readonly IS_STAGE_TRANSITION = true;
+    static readonly IS_MULTI_STEP_FLOW = false;
+    static readonly HAS_STEP_LINKS = false;
+    /**
+     * Step definitions with linking metadata
+     * Used by SDK and backend for auto-linking after step execution
+     */
+    static readonly stepDefinitions: MoveMsrToCancelledStepDefinition[];
+    /** Type-safe step key accessor */
+    static readonly Steps: {
+        readonly step_1: "step_1";
+    };
+    readonly actionName: string;
+    readonly schemaActionId: string;
+    readonly entity: string;
+    readonly stageKey: string;
+    constructor(record: OdinRecord<any> | {
+        id: string;
+        entity: string;
+        type?: string;
+    }, options?: {
+        journeyId?: string;
+    });
+    /** Step classes that can be used with this action */
+    static readonly stepClasses: readonly ["UpdateModifyServiceRequestDto"];
+    steps: StepClassMap[(typeof MoveMsrToCancelledDto.stepClasses)[number]][];
+}
+export {};

package/dist/actions-v2/MoveMsrToCancelledDto.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * MoveMsrToCancelled Action DTO
+ *
+ * MoveMsrToCancelled
+ *
+ * @module ServiceModule
+ * @entity ModifyServiceRequest
+ * @entityType DEFAULT
+ * @actionKey MoveMsrToCancelled
+ * @event k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Transition.MoveMsrToCancelled
+ *
+ * AUTO-GENERATED - DO NOT EDIT DIRECTLY
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MoveMsrToCancelledDto = exports.MoveMsrToCancelledSteps = 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 = '1065703e-e4d3-4010-bab0-4b0c08534c1d';
+        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 = 'e3ee21c4-f2bf-4931-867d-e02e70699221';
+UpdateModifyServiceRequestDto.STEP_SCHEMA_ACTION_ID = '1065703e-e4d3-4010-bab0-4b0c08534c1d';
+UpdateModifyServiceRequestDto.AUTO_LINK_PARENT = false;
+/**
+ * Type-safe step keys for MoveMsrToCancelled
+ */
+exports.MoveMsrToCancelledSteps = {
+    step_1: 'step_1',
+};
+/**
+ * MoveMsrToCancelled
+ *
+ * @actionType STAGE_TRANSITION - Transitions record to new pipeline stage
+ * @module ServiceModule
+ * @entity ModifyServiceRequest
+ * @entityType DEFAULT (Default)
+ * @targetStages ModifyServiceRequestStateStageCancelled
+ * @event k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Transition.MoveMsrToCancelled
+ * @permission schema.action.movemsrtocancelled.trigger
+ * @benchmark This action is tracked for performance benchmarks
+ */
+class MoveMsrToCancelledDto extends core_1.OdinRecordUpdateDto {
+    constructor(record, options) {
+        super({
+            id: record.id,
+            entity: record.entity,
+            type: record.type,
+            properties: {},
+            journeyId: options === null || options === void 0 ? void 0 : options.journeyId,
+        });
+        this.actionName = 'MoveMsrToCancelled';
+        this.schemaActionId = '7d70b973-7823-4625-bb7d-9c65aa9e0cfb';
+        this.entity = 'ServiceModule:ModifyServiceRequest';
+        this.stageKey = 'ModifyServiceRequestStateStageCancelled';
+    }
+}
+exports.MoveMsrToCancelledDto = MoveMsrToCancelledDto;
+/** Used by SDK generators to identify action type */
+MoveMsrToCancelledDto.ACTION_TYPE = 'UPDATE';
+MoveMsrToCancelledDto.ACTION_KEY = 'MoveMsrToCancelled';
+MoveMsrToCancelledDto.MODULE_NAME = 'ServiceModule';
+MoveMsrToCancelledDto.ENTITIES = ['ModifyServiceRequest'];
+MoveMsrToCancelledDto.ENTITY_TYPE = 'DEFAULT';
+MoveMsrToCancelledDto.EVENT_NAME = 'k1.t-hEOJjsDb.ServiceModule.ModifyServiceRequest.Transition.MoveMsrToCancelled';
+MoveMsrToCancelledDto.SCHEMA_ACTION_ID = '7d70b973-7823-4625-bb7d-9c65aa9e0cfb';
+MoveMsrToCancelledDto.PERMISSION = 'schema.action.movemsrtocancelled.trigger';
+MoveMsrToCancelledDto.TARGET_STAGES = ['ModifyServiceRequestStateStageCancelled'];
+MoveMsrToCancelledDto.IS_STAGE_TRANSITION = true;
+MoveMsrToCancelledDto.IS_MULTI_STEP_FLOW = false;
+MoveMsrToCancelledDto.HAS_STEP_LINKS = false;
+/**
+ * Step definitions with linking metadata
+ * Used by SDK and backend for auto-linking after step execution
+ */
+MoveMsrToCancelledDto.stepDefinitions = [
+    {
+        stepKey: 'step_1',
+        dtoClass: 'UpdateModifyServiceRequestDto',
+        entity: 'ServiceModule:ModifyServiceRequest',
+        linksTo: null
+    }
+];
+/** Type-safe step key accessor */
+MoveMsrToCancelledDto.Steps = exports.MoveMsrToCancelledSteps;
+/** Step classes that can be used with this action */
+MoveMsrToCancelledDto.stepClasses = ['UpdateModifyServiceRequestDto'];

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

@@ -24,7 +24,7 @@ import { IOdinProvider } from '@d19n/odin-sdk-generator/dist/odin-sdk-types';
 import { RecordLinkManager } from '@d19n/odin-sdk-generator/dist/record-link-manager';
 import { ModifyServiceRequestProperties } from '../entities-v2/ModifyServiceRequest';
 import { CreateModifyServiceRequestProperties } from '../actions-v2/CreateModifyServiceRequestDto';
-import { UpdateModifyServiceRequestProperties } from '../actions-v2/MoveMsrToCompleteDto';
+import { UpdateModifyServiceRequestProperties } from '../actions-v2/MoveMsrToCancelledDto';
 import { OrderRecord } from './OrderRecord';
 import { OrderKciRecord } from './OrderKciRecord';
 /** Valid entity types for ModifyServiceRequest */
@@ -88,6 +88,68 @@ declare class ActionBuilder<T = IDbRecordCreateUpdateRes[]> {
     then(): never;
 }
 /** Options for a flow step */
+export interface MoveMsrToCancelledFlowBuilderStepOptions {
+    /** Associations to create with this step */
+    associations?: Array<{
+        recordId?: string;
+        entity?: string;
+    }>;
+    /** Groups for this step */
+    groups?: string[];
+}
+/**
+ * FlowBuilder for MoveMsrToCancelled multi-step action
+ *
+ * Use method chaining to add steps, then call execute() to run the flow.
+ * Transitions to stage: ModifyServiceRequestStateStageCancelled
+ */
+export declare class MoveMsrToCancelledFlowBuilder {
+    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?: MoveMsrToCancelledFlowBuilderStepOptions): 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 MoveMsrToCompleteFlowBuilderStepOptions {
     /** Associations to create with this step */
     associations?: Array<{
@@ -495,6 +557,30 @@ export declare class ModifyServiceRequestRecord<TProps = ModifyServiceRequestPro
         journeyId?: string;
         stageKey?: string;
     }): ActionBuilder;
+    /**
+     * MoveMsrToCancelled
+     *
+     * Starts a stage transition flow on this ModifyServiceRequest record.
+     * Chain step methods and call .execute() to run the flow.
+     *
+     * @remarks Transitions to stage: ModifyServiceRequestStateStageCancelled
+     *
+     * @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.modifyServiceRequests.get(id);
+     * await record.moveMsrToCancelled()
+     *   .updateModifyServiceRequest(recordId, { ... })
+     *   .execute();
+     * ```
+     */
+    moveMsrToCancelled(options?: {
+        journeyId?: string;
+    }): MoveMsrToCancelledFlowBuilder;
     /**
      * MoveMsrToComplete
      *

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.MoveMsrToHeldFlowBuilder = exports.MoveMsrToFailedFlowBuilder = exports.MoveMsrToCompleteFlowBuilder = void 0;
+exports.isModifyServiceRequestRecord = exports.ModifyServiceRequestRecord = exports.MoveMsrToInProgressFlowBuilder = exports.MoveMsrToHeldFlowBuilder = exports.MoveMsrToFailedFlowBuilder = exports.MoveMsrToCompleteFlowBuilder = exports.MoveMsrToCancelledFlowBuilder = 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");
@@ -110,6 +110,113 @@ class ActionBuilder {
         throw new Error('ActionBuilder cannot be awaited directly. Call .execute() to run the action or .dryRun() to get the payload.');
     }
 }
+/**
+ * FlowBuilder for MoveMsrToCancelled multi-step action
+ *
+ * Use method chaining to add steps, then call execute() to run the flow.
+ * Transitions to stage: ModifyServiceRequestStateStageCancelled
+ */
+class MoveMsrToCancelledFlowBuilder {
+    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: 'MoveMsrToCancelled', steps: stepsWithAssociations, associations: this._pendingLinks.length > 0 ? this._pendingLinks : undefined, groups: this._groups.length > 0 ? this._groups : undefined, stageKey: 'ModifyServiceRequestStateStageCancelled' }, this._options);
+    }
+}
+exports.MoveMsrToCancelledFlowBuilder = MoveMsrToCancelledFlowBuilder;
 /**
  * FlowBuilder for MoveMsrToComplete multi-step action
  *
@@ -765,6 +872,33 @@ class ModifyServiceRequestRecord {
         const payload = Object.assign({ id: this._record.id, entity: this._record.entity, type: this._record.type, actionName: 'UpdateModifyServiceRequest', properties, associations: this._pendingLinks.length > 0 ? this._pendingLinks : undefined }, opts);
         return new ActionBuilder(this._provider, 'ServiceModule', 'ModifyServiceRequest', payload, () => { this._pendingLinks = []; });
     }
+    /**
+     * MoveMsrToCancelled
+     *
+     * Starts a stage transition flow on this ModifyServiceRequest record.
+     * Chain step methods and call .execute() to run the flow.
+     *
+     * @remarks Transitions to stage: ModifyServiceRequestStateStageCancelled
+     *
+     * @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.modifyServiceRequests.get(id);
+     * await record.moveMsrToCancelled()
+     *   .updateModifyServiceRequest(recordId, { ... })
+     *   .execute();
+     * ```
+     */
+    moveMsrToCancelled(options) {
+        var _a;
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('moveMsrToCancelled requires an existing record. Use accessor.get() first.');
+        return new MoveMsrToCancelledFlowBuilder(this, this._provider, this._pendingLinks, options);
+    }
     /**
      * MoveMsrToComplete
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d19n/youfibre-odin-sdk",
-  "version": "2.0.246",
+  "version": "2.0.248",
   "description": "",
   "author": "@d19n",
   "license": "UNLICENSED",