@d19n/youfibre-odin-sdk 1.0.356 → 1.0.358

package/README.md

@@ -351,7 +351,7 @@ This SDK includes **163** entities across **12** modules.
 
 ## Actions
 
-This SDK includes **538** actions.
+This SDK includes **532** actions.
 
 ### Action Types
 
@@ -724,7 +724,7 @@ This SDK includes **538** actions.
 | `AssignCase` | UPDATE | k1.t-hEOJjsDb.SupportModule.Case.Update.AssignCase |
 | `AssignCaseWithNoteFlow` | MULTI_STEP_FLOW | k1.t-hEOJjsDb.SupportModule.Case.Update.AssignCase |
 | `CaseDefaultStageEscalated` | STAGE_TRANSITION | k1.t-hEOJjsDb.SupportModule.Case.Update.EscalateCaseAction |
-| `CaseDefaultStageSolved` | STAGE_TRANSITION | k1.t-hEOJjsDb.SupportModule.Case.Update.ExceptionInput |
+| `CaseDefaultStageSolved` | STAGE_TRANSITION | k1.t-hEOJjsDb.SupportModule.Case.Transition.CaseDefaultStageSolved |
 | `Casedefaultstageblocked` | STAGE_TRANSITION | k1.t-hEOJjsDb.SupportModule.Case.Update.MoveCaseToBlockedAction |
 | `ChangeCaseChannel` | UPDATE | k1.t-hEOJjsDb.SupportModule.Case.Update.ChangeCaseChannel |
 | `CreateCase` | CREATE | k1.t-hEOJjsDb.SupportModule.Case.Create.CreateCase |
@@ -1056,7 +1056,6 @@ This SDK includes **538** actions.
 |--------|------|-------|
 | `CreateAuddisPgSubmissionAllocation` | CREATE | k1.t-hEOJjsDb.BillingModule.PgFileAllocation.Create.CreateAuddisPgSubmissionAllocation |
 | `CreateBacsPgSubmissionAllocation` | CREATE | k1.t-hEOJjsDb.BillingModule.PgFileAllocation.Create.CreateBacsPgSubmissionAllocation |
-| `UpdatePgAllocationWithAcknowledgementFile` | UPDATE | k1.t-hEOJjsDb.BillingModule.PgFileAllocation.Update.UpdatePgAllocationWithAcknowledgementFile |
 | `UpdatePgAllocationWithAcknowledgementOne` | UPDATE | k1.t-hEOJjsDb.BillingModule.PgFileAllocation.Update.UpdatePgAllocationWithAcknowledgementOne |
 | `UpdatePgAllocationWithAcknowledgementTwo` | UPDATE | k1.t-hEOJjsDb.BillingModule.PgFileAllocation.Update.UpdatePgAllocationWithAcknowledgementTwo |
 | `UpdatePgAllocationWithBacsReport` | UPDATE | k1.t-hEOJjsDb.BillingModule.PgFileAllocation.Update.UpdatePgAllocationWithBacsReport |
@@ -1388,8 +1387,6 @@ This SDK includes **538** actions.
 | `MovePgResponseToProcessed` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgDirectDebitFile.Transition.MovePgResponseToProcessed |
 | `MovePgResponseToSaved` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgDirectDebitFile.Transition.MovePgResponseToSaved |
 | `MovePgSubmissionToClosed` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgDirectDebitFile.Transition.MovePgSubmissionToClosed |
-| `MovePgSubmissionToFailedFormatting` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgDirectDebitFile.Transition.MovePgSubmissionToFailedFormatting |
-| `MovePgSubmissionToFailedSubmission` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgDirectDebitFile.Transition.MovePgSubmissionToFailedSubmission |
 | `MovePgSubmissionToFileAccepted` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgDirectDebitFile.Transition.MovePgSubmissionToFileAccepted |
 | `MovePgSubmissionToFileRejected` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgDirectDebitFile.Transition.MovePgSubmissionToFileRejected |
 | `MovePgSubmissionToProcessed` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgDirectDebitFile.Transition.MovePgSubmissionToProcessed |
@@ -1408,10 +1405,6 @@ This SDK includes **538** actions.
 
 **MovePgSubmissionToClosed Target Stages:** `SubmissionStatusStageClosed`
 
-**MovePgSubmissionToFailedFormatting Target Stages:** `SubmissionStatusStageFailedFormatting`
-
-**MovePgSubmissionToFailedSubmission Target Stages:** `SubmissionStatusStageFailedSubmission`
-
 **MovePgSubmissionToFileAccepted Target Stages:** `SubmissionStatusStageFileAccepted`
 
 **MovePgSubmissionToFileRejected Target Stages:** `SubmissionStatusStageFileRejected`
@@ -1444,8 +1437,6 @@ This SDK includes **538** actions.
 | `MovePgTransactionChargeToAcknowledged` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgTransaction.Transition.MovePgTransactionChargeToAcknowledged |
 | `MovePgTransactionChargeToAllocated` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgTransaction.Transition.MovePgTransactionChargeToAllocated |
 | `MovePgTransactionChargeToFailed` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgTransaction.Transition.MovePgTransactionChargeToFailed |
-| `MovePgTransactionChargeToFailedFormatting` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgTransaction.Transition.MovePgTransactionChargeToFailedFormatting |
-| `MovePgTransactionChargeToFailedSubmission` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgTransaction.Transition.MovePgTransactionChargeToFailedSubmission |
 | `MovePgTransactionChargeToFileRejected` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgTransaction.Transition.MovePgTransactionChargeToFileRejected |
 | `MovePgTransactionChargeToInstructionRejected` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgTransaction.Transition.MovePgTransactionChargeToInstructionRejected |
 | `MovePgTransactionChargeToProcessing` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgTransaction.Transition.MovePgTransactionChargeToProcessing |
@@ -1454,7 +1445,6 @@ This SDK includes **538** actions.
 | `MovePgTransactionChargeToSubmitted` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgTransaction.Transition.MovePgTransactionChargeToSubmitted |
 | `MovePgTransactionChargeToSucceeded` | STAGE_TRANSITION | k1.t-hEOJjsDb.BillingModule.PgTransaction.Transition.MovePgTransactionChargeToSucceeded |
 | `UpdatePgTransactionCharge` | UPDATE | k1.t-hEOJjsDb.BillingModule.PgTransaction.Update.UpdatePgTransactionCharge |
-| `UpdatePgTransactionFailedReason` | UPDATE | k1.t-hEOJjsDb.BillingModule.PgTransaction.Update.UpdatePgTransactionFailedReason |
 | `UpdatePgTransactionMessage` | UPDATE | k1.t-hEOJjsDb.BillingModule.PgTransaction.Update.UpdatePgTransactionMessage |
 
 **MovePgTransactionChargeToAcknowledged Target Stages:** `ChargeStatusStageAcknowledged`
@@ -1463,10 +1453,6 @@ This SDK includes **538** actions.
 
 **MovePgTransactionChargeToFailed Target Stages:** `ChargeStatusStageFailed`
 
-**MovePgTransactionChargeToFailedFormatting Target Stages:** `ChargeStatusStageFailedFormatting`
-
-**MovePgTransactionChargeToFailedSubmission Target Stages:** `ChargeStatusStageFailedSubmission`
-
 **MovePgTransactionChargeToFileRejected Target Stages:** `ChargeStatusStageFileRejected`
 
 **MovePgTransactionChargeToInstructionRejected Target Stages:** `ChargeStatusStageInstructionRejected`

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

@@ -12,110 +12,6 @@
  * AUTO-GENERATED - DO NOT EDIT DIRECTLY
  */
 import { OdinRecord, OdinRecordUpdateDto, OdinRecordUpdatedEvent } from '@d19n/odin-types/dist/core';
-/**
- * Properties for ExceptionInput action
- *
- * @property Required fields: 0
- * @property Optional fields: 6
- */
-export interface ExceptionInputProperties {
-    /**
-     * Formal Complaint
-     *
-     * Formal Complaint - Boolean
-     * @type {ENUM}
-     */
-    FormalComplaint?: string | null;
-    /**
-     * Complaint
-     *
-     * Complaint
-     * @type {ENUM}
-     */
-    Complaint?: string | null;
-    /**
-     * Timestamp
-     *
-     * Timestamp
-     * @type {DATE_TIME}
-     * @default Dynamic: {datetime_now}
-     */
-    Timestamp?: string | null;
-}
-/**
- * ExceptionInput
- *
- * @actionType UPDATE - Updates an existing Case record
- * @module SupportModule
- * @entity Case
- * @event k1.t-hEOJjsDb.SupportModule.Case.Update.ExceptionInput
- * @permission schema.action.exceptioninput.trigger
- * @benchmark This action is tracked for performance benchmarks
- */
-export declare class ExceptionInputDto extends OdinRecordUpdateDto<ExceptionInputProperties> {
-    /** Used by SDK generators to identify action type */
-    static readonly ACTION_TYPE = "UPDATE";
-    static readonly ACTION_KEY = "ExceptionInput";
-    static readonly MODULE_NAME = "SupportModule";
-    static readonly ENTITIES: string[];
-    static readonly EVENT_NAME = "k1.t-hEOJjsDb.SupportModule.Case.Update.ExceptionInput";
-    static readonly PERMISSION = "schema.action.exceptioninput.trigger";
-    /** Step metadata - entity this action targets */
-    static readonly STEP_ENTITY = "SupportModule:Case";
-    static readonly STEP_SCHEMA_ID = "be8173eb-269b-4a67-be0c-11ce6af5d561";
-    static readonly STEP_SCHEMA_ACTION_ID = "45b6bffd-7641-4f70-89b3-f335e0ae8989";
-    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: ExceptionInputProperties, options?: {
-        journeyId?: string;
-        stageKey?: string;
-    });
-}
-declare type StepClassMap = {
-    ExceptionInputDto: ExceptionInputDto;
-};
-/**
- * Link definition for connecting steps in CaseDefaultStageSolved
- */
-export interface CaseDefaultStageSolvedStepLink {
-    /**
-     * 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 CaseDefaultStageSolved
- */
-export interface CaseDefaultStageSolvedStepDefinition {
-    /** 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: CaseDefaultStageSolvedStepLink[] | null;
-}
-/**
- * Type-safe step keys for CaseDefaultStageSolved
- */
-export declare const CaseDefaultStageSolvedSteps: {
-    readonly step_1: "step_1";
-};
-export declare type CaseDefaultStageSolvedStepKey = typeof CaseDefaultStageSolvedSteps[keyof typeof CaseDefaultStageSolvedSteps];
 /**
  * RabbitMQ message payload for CaseDefaultStageSolved step flow events
  *
@@ -130,7 +26,7 @@ export interface CaseDefaultStageSolvedMessage extends OdinRecordUpdatedEvent<Ca
 export interface CaseDefaultStageSolvedProperties {
 }
 /**
- * Solve and Close
+ * CaseDefaultStageSolved
  *
  * Solve case
  *
@@ -159,15 +55,6 @@ export declare class CaseDefaultStageSolvedDto extends OdinRecordUpdateDto<Recor
     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: CaseDefaultStageSolvedStepDefinition[];
-    /** Type-safe step key accessor */
-    static readonly Steps: {
-        readonly step_1: "step_1";
-    };
     readonly actionName: string;
     readonly schemaActionId: string;
     readonly entity: string;
@@ -180,7 +67,6 @@ export declare class CaseDefaultStageSolvedDto extends OdinRecordUpdateDto<Recor
         journeyId?: string;
     });
     /** Step classes that can be used with this action */
-    static readonly stepClasses: readonly ["ExceptionInputDto"];
-    steps: StepClassMap[(typeof CaseDefaultStageSolvedDto.stepClasses)[number]][];
+    static readonly stepClasses: readonly [];
+    steps: [];
 }
-export {};

package/dist/actions-v2/CaseDefaultStageSolvedDto.js

@@ -13,54 +13,10 @@
  * AUTO-GENERATED - DO NOT EDIT DIRECTLY
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CaseDefaultStageSolvedDto = exports.CaseDefaultStageSolvedSteps = exports.ExceptionInputDto = void 0;
+exports.CaseDefaultStageSolvedDto = void 0;
 const core_1 = require("@d19n/odin-types/dist/core");
 /**
- * ExceptionInput
- *
- * @actionType UPDATE - Updates an existing Case record
- * @module SupportModule
- * @entity Case
- * @event k1.t-hEOJjsDb.SupportModule.Case.Update.ExceptionInput
- * @permission schema.action.exceptioninput.trigger
- * @benchmark This action is tracked for performance benchmarks
- */
-class ExceptionInputDto 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 = 'ExceptionInput';
-        this.schemaActionId = '45b6bffd-7641-4f70-89b3-f335e0ae8989';
-        this.entity = 'SupportModule:Case';
-    }
-}
-exports.ExceptionInputDto = ExceptionInputDto;
-/** Used by SDK generators to identify action type */
-ExceptionInputDto.ACTION_TYPE = 'UPDATE';
-ExceptionInputDto.ACTION_KEY = 'ExceptionInput';
-ExceptionInputDto.MODULE_NAME = 'SupportModule';
-ExceptionInputDto.ENTITIES = ['Case'];
-ExceptionInputDto.EVENT_NAME = 'k1.t-hEOJjsDb.SupportModule.Case.Update.ExceptionInput';
-ExceptionInputDto.PERMISSION = 'schema.action.exceptioninput.trigger';
-/** Step metadata - entity this action targets */
-ExceptionInputDto.STEP_ENTITY = 'SupportModule:Case';
-ExceptionInputDto.STEP_SCHEMA_ID = 'be8173eb-269b-4a67-be0c-11ce6af5d561';
-ExceptionInputDto.STEP_SCHEMA_ACTION_ID = '45b6bffd-7641-4f70-89b3-f335e0ae8989';
-ExceptionInputDto.AUTO_LINK_PARENT = false;
-/**
- * Type-safe step keys for CaseDefaultStageSolved
- */
-exports.CaseDefaultStageSolvedSteps = {
-    step_1: 'step_1',
-};
-/**
- * Solve and Close
+ * CaseDefaultStageSolved
  *
  * Solve case
  *
@@ -104,19 +60,5 @@ CaseDefaultStageSolvedDto.TARGET_STAGES = ['CaseDefaultStageSolved'];
 CaseDefaultStageSolvedDto.IS_STAGE_TRANSITION = true;
 CaseDefaultStageSolvedDto.IS_MULTI_STEP_FLOW = false;
 CaseDefaultStageSolvedDto.HAS_STEP_LINKS = false;
-/**
- * Step definitions with linking metadata
- * Used by SDK and backend for auto-linking after step execution
- */
-CaseDefaultStageSolvedDto.stepDefinitions = [
-    {
-        stepKey: 'step_1',
-        dtoClass: 'ExceptionInputDto',
-        entity: 'SupportModule:Case',
-        linksTo: null
-    }
-];
-/** Type-safe step key accessor */
-CaseDefaultStageSolvedDto.Steps = exports.CaseDefaultStageSolvedSteps;
 /** Step classes that can be used with this action */
-CaseDefaultStageSolvedDto.stepClasses = ['ExceptionInputDto'];
+CaseDefaultStageSolvedDto.stepClasses = [];

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

@@ -140,6 +140,13 @@ export declare class CreateCollectionAmcoReplacementWorkOrderBuilder {
     private _properties;
     private _pendingLinks;
     private _options?;
+    private _provider?;
+    private _moduleName?;
+    private _entityName?;
+    private _clearPendingLinks?;
+    private _externalId?;
+    private _externalAppId?;
+    private _groups?;
     constructor(properties: CreateCollectionAmcoReplacementWorkOrderProperties, pendingLinks: OdinRecordLinkDto[], options?: {
         journeyId?: string;
         stageKey?: string;
@@ -154,6 +161,20 @@ export declare class CreateCollectionAmcoReplacementWorkOrderBuilder {
         id: string;
         entity: string;
     }): this;
+    /**
+     * Set an external system identifier for this record.
+     * Links the record to a corresponding entry in an external application.
+     * @param externalId - The ID in the external system
+     * @param externalAppId - The external application identifier
+     * @returns this (for chaining)
+     */
+    withExternalId(externalId: string, externalAppId: string): this;
+    /**
+     * Set security/access groups for this record.
+     * @param groups - Array of group names
+     * @returns this (for chaining)
+     */
+    withGroups(groups: string[]): this;
     /**
      * Get the action payload without executing
      * @returns The action data that would be sent
@@ -166,7 +187,33 @@ export declare class CreateCollectionAmcoReplacementWorkOrderBuilder {
         associations?: OdinRecordLinkDto[];
         journeyId?: string;
         stageKey?: string;
+        externalId?: string;
+        externalAppId?: string;
+        groups?: string[];
     };
+    /**
+     * Inject execution context (called by record wrapper)
+     * @internal
+     */
+    withProvider(provider: {
+        _applyAction(moduleName: string, entityName: string, payload: any): Promise<any>;
+    }, moduleName: string, entityName: string, clearPendingLinks: () => void): this;
+    /**
+     * Execute the action
+     * @returns The result from the API
+     * @throws Error if withProvider() has not been called
+     */
+    execute(): Promise<any>;
+    /**
+     * 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 builder` without .execute()
+     * @throws Error always - use .execute() or .dryRun() instead
+     */
+    then(): never;
 }
 /**
  * Create 3PL Replacement Collection

package/dist/actions-v2/CreateCollectionAmcoReplacementWorkOrderDto.js

@@ -12,6 +12,15 @@
  *
  * AUTO-GENERATED - DO NOT EDIT DIRECTLY
  */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateCollectionAmcoReplacementWorkOrderDto = exports.CreateCollectionAmcoReplacementWorkOrderBuilder = void 0;
 const core_1 = require("@d19n/odin-types/dist/core");
@@ -48,6 +57,27 @@ class CreateCollectionAmcoReplacementWorkOrderBuilder {
         }));
         return this;
     }
+    /**
+     * Set an external system identifier for this record.
+     * Links the record to a corresponding entry in an external application.
+     * @param externalId - The ID in the external system
+     * @param externalAppId - The external application identifier
+     * @returns this (for chaining)
+     */
+    withExternalId(externalId, externalAppId) {
+        this._externalId = externalId;
+        this._externalAppId = externalAppId;
+        return this;
+    }
+    /**
+     * Set security/access groups for this record.
+     * @param groups - Array of group names
+     * @returns this (for chaining)
+     */
+    withGroups(groups) {
+        this._groups = groups;
+        return this;
+    }
     /**
      * Get the action payload without executing
      * @returns The action data that would be sent
@@ -55,15 +85,48 @@ class CreateCollectionAmcoReplacementWorkOrderBuilder {
     getData() {
         var _a, _b;
         const allAssociations = [...this._associations, ...this._pendingLinks];
-        return {
-            entity: 'FieldServiceModule:WorkOrder',
-            type: 'COLLECTION_AMCO',
-            actionName: 'CreateCollectionAmcoReplacementWorkOrder',
-            properties: this._properties,
-            associations: allAssociations.length > 0 ? allAssociations : undefined,
-            journeyId: (_a = this._options) === null || _a === void 0 ? void 0 : _a.journeyId,
-            stageKey: (_b = this._options) === null || _b === void 0 ? void 0 : _b.stageKey,
-        };
+        return Object.assign(Object.assign({ entity: 'FieldServiceModule:WorkOrder', type: 'COLLECTION_AMCO', actionName: 'CreateCollectionAmcoReplacementWorkOrder', properties: this._properties, associations: allAssociations.length > 0 ? allAssociations : undefined, journeyId: (_a = this._options) === null || _a === void 0 ? void 0 : _a.journeyId, stageKey: (_b = this._options) === null || _b === void 0 ? void 0 : _b.stageKey }, (this._externalId && { externalId: this._externalId, externalAppId: this._externalAppId })), (this._groups && { groups: this._groups }));
+    }
+    /**
+     * Inject execution context (called by record wrapper)
+     * @internal
+     */
+    withProvider(provider, moduleName, entityName, clearPendingLinks) {
+        this._provider = provider;
+        this._moduleName = moduleName;
+        this._entityName = entityName;
+        this._clearPendingLinks = clearPendingLinks;
+        return this;
+    }
+    /**
+     * Execute the action
+     * @returns The result from the API
+     * @throws Error if withProvider() has not been called
+     */
+    execute() {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this._provider || !this._moduleName || !this._entityName) {
+                throw new Error('Builder not connected to provider. Use the record wrapper API to get an executable builder.');
+            }
+            const result = yield this._provider._applyAction(this._moduleName, this._entityName, this.getData());
+            (_a = this._clearPendingLinks) === null || _a === void 0 ? void 0 : _a.call(this);
+            return result;
+        });
+    }
+    /**
+     * Returns the request payload without executing (for debugging)
+     * @returns The request payload that would be sent to the API
+     */
+    dryRun() {
+        return this.getData();
+    }
+    /**
+     * Prevents accidental `await builder` without .execute()
+     * @throws Error always - use .execute() or .dryRun() instead
+     */
+    then() {
+        throw new Error('Builder cannot be awaited directly. Call .execute() to run the action or .dryRun() to get the payload.');
     }
 }
 exports.CreateCollectionAmcoReplacementWorkOrderBuilder = CreateCollectionAmcoReplacementWorkOrderBuilder;

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

@@ -133,6 +133,13 @@ export declare class CreateCollectionAmcoReplacementWorkOrderBuilder {
     private _properties;
     private _pendingLinks;
     private _options?;
+    private _provider?;
+    private _moduleName?;
+    private _entityName?;
+    private _clearPendingLinks?;
+    private _externalId?;
+    private _externalAppId?;
+    private _groups?;
     constructor(properties: CreateCollectionAmcoReplacementWorkOrderProperties, pendingLinks: OdinRecordLinkDto[], options?: {
         journeyId?: string;
         stageKey?: string;
@@ -147,6 +154,20 @@ export declare class CreateCollectionAmcoReplacementWorkOrderBuilder {
         id: string;
         entity: string;
     }): this;
+    /**
+     * Set an external system identifier for this record.
+     * Links the record to a corresponding entry in an external application.
+     * @param externalId - The ID in the external system
+     * @param externalAppId - The external application identifier
+     * @returns this (for chaining)
+     */
+    withExternalId(externalId: string, externalAppId: string): this;
+    /**
+     * Set security/access groups for this record.
+     * @param groups - Array of group names
+     * @returns this (for chaining)
+     */
+    withGroups(groups: string[]): this;
     /**
      * Get the action payload without executing
      * @returns The action data that would be sent
@@ -159,7 +180,33 @@ export declare class CreateCollectionAmcoReplacementWorkOrderBuilder {
         associations?: OdinRecordLinkDto[];
         journeyId?: string;
         stageKey?: string;
+        externalId?: string;
+        externalAppId?: string;
+        groups?: string[];
     };
+    /**
+     * Inject execution context (called by record wrapper)
+     * @internal
+     */
+    withProvider(provider: {
+        _applyAction(moduleName: string, entityName: string, payload: any): Promise<any>;
+    }, moduleName: string, entityName: string, clearPendingLinks: () => void): this;
+    /**
+     * Execute the action
+     * @returns The result from the API
+     * @throws Error if withProvider() has not been called
+     */
+    execute(): Promise<any>;
+    /**
+     * 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 builder` without .execute()
+     * @throws Error always - use .execute() or .dryRun() instead
+     */
+    then(): never;
 }
 /**
  * Create 3PL Replacement Collection

package/dist/actions-v2/CreateCollectionAmcoReplacementWorkOrderFromWorkOrderDto.js

@@ -12,6 +12,15 @@
  *
  * AUTO-GENERATED - DO NOT EDIT DIRECTLY
  */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateCollectionAmcoReplacementWorkOrderFromWorkOrderDto = exports.CreateCollectionAmcoReplacementWorkOrderFromWorkOrderSteps = exports.CreateCollectionAmcoReplacementWorkOrderDto = exports.CreateCollectionAmcoReplacementWorkOrderBuilder = void 0;
 const core_1 = require("@d19n/odin-types/dist/core");
@@ -48,6 +57,27 @@ class CreateCollectionAmcoReplacementWorkOrderBuilder {
         }));
         return this;
     }
+    /**
+     * Set an external system identifier for this record.
+     * Links the record to a corresponding entry in an external application.
+     * @param externalId - The ID in the external system
+     * @param externalAppId - The external application identifier
+     * @returns this (for chaining)
+     */
+    withExternalId(externalId, externalAppId) {
+        this._externalId = externalId;
+        this._externalAppId = externalAppId;
+        return this;
+    }
+    /**
+     * Set security/access groups for this record.
+     * @param groups - Array of group names
+     * @returns this (for chaining)
+     */
+    withGroups(groups) {
+        this._groups = groups;
+        return this;
+    }
     /**
      * Get the action payload without executing
      * @returns The action data that would be sent
@@ -55,15 +85,48 @@ class CreateCollectionAmcoReplacementWorkOrderBuilder {
     getData() {
         var _a, _b;
         const allAssociations = [...this._associations, ...this._pendingLinks];
-        return {
-            entity: 'FieldServiceModule:WorkOrder',
-            type: 'COLLECTION_AMCO',
-            actionName: 'CreateCollectionAmcoReplacementWorkOrder',
-            properties: this._properties,
-            associations: allAssociations.length > 0 ? allAssociations : undefined,
-            journeyId: (_a = this._options) === null || _a === void 0 ? void 0 : _a.journeyId,
-            stageKey: (_b = this._options) === null || _b === void 0 ? void 0 : _b.stageKey,
-        };
+        return Object.assign(Object.assign({ entity: 'FieldServiceModule:WorkOrder', type: 'COLLECTION_AMCO', actionName: 'CreateCollectionAmcoReplacementWorkOrder', properties: this._properties, associations: allAssociations.length > 0 ? allAssociations : undefined, journeyId: (_a = this._options) === null || _a === void 0 ? void 0 : _a.journeyId, stageKey: (_b = this._options) === null || _b === void 0 ? void 0 : _b.stageKey }, (this._externalId && { externalId: this._externalId, externalAppId: this._externalAppId })), (this._groups && { groups: this._groups }));
+    }
+    /**
+     * Inject execution context (called by record wrapper)
+     * @internal
+     */
+    withProvider(provider, moduleName, entityName, clearPendingLinks) {
+        this._provider = provider;
+        this._moduleName = moduleName;
+        this._entityName = entityName;
+        this._clearPendingLinks = clearPendingLinks;
+        return this;
+    }
+    /**
+     * Execute the action
+     * @returns The result from the API
+     * @throws Error if withProvider() has not been called
+     */
+    execute() {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this._provider || !this._moduleName || !this._entityName) {
+                throw new Error('Builder not connected to provider. Use the record wrapper API to get an executable builder.');
+            }
+            const result = yield this._provider._applyAction(this._moduleName, this._entityName, this.getData());
+            (_a = this._clearPendingLinks) === null || _a === void 0 ? void 0 : _a.call(this);
+            return result;
+        });
+    }
+    /**
+     * Returns the request payload without executing (for debugging)
+     * @returns The request payload that would be sent to the API
+     */
+    dryRun() {
+        return this.getData();
+    }
+    /**
+     * Prevents accidental `await builder` without .execute()
+     * @throws Error always - use .execute() or .dryRun() instead
+     */
+    then() {
+        throw new Error('Builder cannot be awaited directly. Call .execute() to run the action or .dryRun() to get the payload.');
     }
 }
 exports.CreateCollectionAmcoReplacementWorkOrderBuilder = CreateCollectionAmcoReplacementWorkOrderBuilder;