@d19n/youfibre-odin-sdk 2.0.270 → 2.0.271

package/dist/actions-v2/CreateCustomerDeviceBatteryDto.js

@@ -12,9 +12,124 @@
  *
  * 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.CreateCustomerDeviceBatteryDto = void 0;
+exports.CreateCustomerDeviceBatteryDto = exports.CreateCustomerDeviceBatteryBuilder = void 0;
 const core_1 = require("@d19n/odin-types/dist/core");
+/**
+ * Builder for CreateCustomerDeviceBattery action
+ *
+ * Provides fluent API for adding associations before executing the action.
+ * Use .link*() methods to add associations, then call .execute() to run.
+ *
+ * @example
+ * ```typescript
+ * await record.createCustomerDeviceBattery({ ...properties })
+ *   .linkAssociation_1786439410918({ id: '...', entity: '...' })
+ *   .execute();
+ * ```
+ */
+class CreateCustomerDeviceBatteryBuilder {
+    constructor(properties, pendingLinks, options) {
+        this._associations = [];
+        this._properties = properties;
+        this._pendingLinks = pendingLinks;
+        this._options = options;
+    }
+    /**
+     * Link CustomerDevice__OrderItem
+     * @schemaAssociationId 29737305-924f-4e32-9dbc-8aab3de2e777
+     * @param target - The record to link
+     * @returns this (for method chaining)
+     */
+    linkAssociation_1786439410918(target) {
+        this._associations.push(new core_1.OdinRecordLinkDto({
+            id: target.id,
+            entity: 'entity' in target ? target.entity : target.entity,
+        }));
+        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
+     */
+    getData() {
+        var _a, _b;
+        const allAssociations = [...this._associations, ...this._pendingLinks];
+        return Object.assign(Object.assign({ entity: 'ServiceModule:CustomerDevice', type: 'BATTERY', actionName: 'CreateCustomerDeviceBattery', 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.CreateCustomerDeviceBatteryBuilder = CreateCustomerDeviceBatteryBuilder;
 /**
  * CreateCustomerDeviceBattery
  *
@@ -55,3 +170,7 @@ CreateCustomerDeviceBatteryDto.STEP_SCHEMA_ACTION_ID = 'b339f484-877f-4db5-ac17-
 CreateCustomerDeviceBatteryDto.STEP_SCHEMA_TYPE_ID = 'bddbd043-c985-4eaf-9202-eb9dbe18c5e3';
 CreateCustomerDeviceBatteryDto.STEP_TYPE = 'BATTERY';
 CreateCustomerDeviceBatteryDto.AUTO_LINK_PARENT = true;
+CreateCustomerDeviceBatteryDto.HAS_ASSOCIATIONS = true;
+CreateCustomerDeviceBatteryDto.HAS_REQUIRED_ASSOCIATIONS = false;
+CreateCustomerDeviceBatteryDto.BUILDER_CLASS = 'CreateCustomerDeviceBatteryBuilder';
+CreateCustomerDeviceBatteryDto.ASSOCIATION_FIELDS = [{ "name": "Association_1786439410918", "methodName": "linkAssociation_1786439410918", "required": false, "schemaAssociationId": "29737305-924f-4e32-9dbc-8aab3de2e777" }];

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

@@ -0,0 +1,118 @@
+/**
+ * CreateYfWifiSurvey Action DTO
+ *
+ * Create (or upsert by WorkOrderId) the WiFi survey for a work order
+ *
+ * @module FieldServiceModule
+ * @entity YfWifiSurvey
+ * @actionKey CreateYfWifiSurvey
+ * @event k1.t-hEOJjsDb.FieldServiceModule.YfWifiSurvey.Create.CreateYfWifiSurvey
+ *
+ * AUTO-GENERATED - DO NOT EDIT DIRECTLY
+ */
+import { OdinRecordCreateDto, OdinRecordCreatedEvent } from '@d19n/odin-types/dist/core';
+/**
+ * RabbitMQ message payload for CreateYfWifiSurvey created events
+ *
+ * @event k1.t-hEOJjsDb.FieldServiceModule.YfWifiSurvey.Create.CreateYfWifiSurvey
+ */
+export interface CreateYfWifiSurveyMessage extends OdinRecordCreatedEvent<CreateYfWifiSurveyDto, CreateYfWifiSurveyProperties> {
+}
+/**
+ * Properties for CreateYfWifiSurvey action
+ *
+ * @property Required fields: 2
+ * @property Optional fields: 6
+ */
+export interface CreateYfWifiSurveyProperties {
+    /**
+     * Work Order Id
+     *
+     * The work order uuid. UNIQUE, so with upsertOnCreate a resubmit for the same work order updates the existing survey instead of creating a duplicate.
+     * @type {TEXT}
+     * @required
+     */
+    WorkOrderId: string;
+    /**
+     * Measurement Source
+     *
+     * How the readings were measured: DEVICE (Android RSSI), GATEWAY (iOS router probe) or NONE (survey refused).
+     * @type {ENUM}
+     * @required
+     */
+    Source: string;
+    /**
+     * Customer Consent
+     *
+     * False means the customer refused the survey — the record still exists so the refusal is auditable on the work order, with Source=NONE, LocationCount=0 and no Readings.
+     * @type {BOOLEAN}
+     */
+    CustomerConsentGiven?: boolean | null;
+    /**
+     * SSID
+     *
+     * Network name the readings were taken on. Nullable: Android redacts it before the location permission grant, and a refused survey has none.
+     * @type {TEXT}
+     */
+    Ssid?: string | null;
+    /**
+     * Tested At
+     *
+     * When the survey finished (or the refusal was recorded). Refreshed on resubmit.
+     * @type {DATE_TIME}
+     */
+    TestedAt?: string | null;
+    /**
+     * Location Count
+     *
+     * Number of locations recorded in Readings. 0 on a refused survey.
+     * @type {NUMBER}
+     */
+    LocationCount?: number | null;
+    /**
+     * Payload Schema Version
+     *
+     * Queryable mirror of Readings.schemaVersion, so consumers can filter by contract version without parsing JSON.
+     * @type {NUMBER}
+     */
+    PayloadSchemaVersion?: number | null;
+    /**
+     * Readings JSON
+     *
+     * Full survey payload: floors, locations, positions and per-location measurements with raw sample series. Contract v1 lives in spec 2026-08-07-wifi-survey-fields.ts. Null on a refused survey.
+     * @type {JSON}
+     */
+    Readings?: string | null;
+}
+/**
+ * Create WiFi Survey
+ *
+ * Create (or upsert by WorkOrderId) the WiFi survey for a work order
+ *
+ * @actionType CREATE - Creates a new YfWifiSurvey record
+ * @module FieldServiceModule
+ * @entity YfWifiSurvey
+ * @event k1.t-hEOJjsDb.FieldServiceModule.YfWifiSurvey.Create.CreateYfWifiSurvey
+ * @permission schema.action.createyfwifisurvey.trigger
+ * @benchmark This action is tracked for performance benchmarks
+ */
+export declare class CreateYfWifiSurveyDto extends OdinRecordCreateDto<CreateYfWifiSurveyProperties> {
+    /** Used by SDK generators to identify action type */
+    static readonly ACTION_TYPE = "CREATE";
+    static readonly ACTION_KEY = "CreateYfWifiSurvey";
+    static readonly MODULE_NAME = "FieldServiceModule";
+    static readonly ENTITIES: string[];
+    static readonly EVENT_NAME = "k1.t-hEOJjsDb.FieldServiceModule.YfWifiSurvey.Create.CreateYfWifiSurvey";
+    static readonly PERMISSION = "schema.action.createyfwifisurvey.trigger";
+    /** Step metadata - entity this action targets */
+    static readonly STEP_ENTITY = "FieldServiceModule:YfWifiSurvey";
+    static readonly STEP_SCHEMA_ID = "b50b088f-a1d2-4f66-83b5-7e2a7638dc9d";
+    static readonly STEP_SCHEMA_ACTION_ID = "cdcab202-5fa3-4219-b162-f8232e064a6b";
+    static readonly AUTO_LINK_PARENT = true;
+    readonly actionName: string;
+    readonly schemaActionId: string;
+    readonly entity: string;
+    constructor(properties: CreateYfWifiSurveyProperties, options?: {
+        journeyId?: string;
+    });
+}

package/dist/actions-v2/CreateYfWifiSurveyDto.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * CreateYfWifiSurvey Action DTO
+ *
+ * Create (or upsert by WorkOrderId) the WiFi survey for a work order
+ *
+ * @module FieldServiceModule
+ * @entity YfWifiSurvey
+ * @actionKey CreateYfWifiSurvey
+ * @event k1.t-hEOJjsDb.FieldServiceModule.YfWifiSurvey.Create.CreateYfWifiSurvey
+ *
+ * AUTO-GENERATED - DO NOT EDIT DIRECTLY
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateYfWifiSurveyDto = void 0;
+const core_1 = require("@d19n/odin-types/dist/core");
+/**
+ * Create WiFi Survey
+ *
+ * Create (or upsert by WorkOrderId) the WiFi survey for a work order
+ *
+ * @actionType CREATE - Creates a new YfWifiSurvey record
+ * @module FieldServiceModule
+ * @entity YfWifiSurvey
+ * @event k1.t-hEOJjsDb.FieldServiceModule.YfWifiSurvey.Create.CreateYfWifiSurvey
+ * @permission schema.action.createyfwifisurvey.trigger
+ * @benchmark This action is tracked for performance benchmarks
+ */
+class CreateYfWifiSurveyDto extends core_1.OdinRecordCreateDto {
+    constructor(properties, options) {
+        super({
+            entity: 'FieldServiceModule:YfWifiSurvey',
+            type: undefined,
+            properties,
+            journeyId: options === null || options === void 0 ? void 0 : options.journeyId,
+        });
+        this.actionName = 'CreateYfWifiSurvey';
+        this.schemaActionId = 'cdcab202-5fa3-4219-b162-f8232e064a6b';
+        this.entity = 'FieldServiceModule:YfWifiSurvey';
+    }
+}
+exports.CreateYfWifiSurveyDto = CreateYfWifiSurveyDto;
+/** Used by SDK generators to identify action type */
+CreateYfWifiSurveyDto.ACTION_TYPE = 'CREATE';
+CreateYfWifiSurveyDto.ACTION_KEY = 'CreateYfWifiSurvey';
+CreateYfWifiSurveyDto.MODULE_NAME = 'FieldServiceModule';
+CreateYfWifiSurveyDto.ENTITIES = ['YfWifiSurvey'];
+CreateYfWifiSurveyDto.EVENT_NAME = 'k1.t-hEOJjsDb.FieldServiceModule.YfWifiSurvey.Create.CreateYfWifiSurvey';
+CreateYfWifiSurveyDto.PERMISSION = 'schema.action.createyfwifisurvey.trigger';
+/** Step metadata - entity this action targets */
+CreateYfWifiSurveyDto.STEP_ENTITY = 'FieldServiceModule:YfWifiSurvey';
+CreateYfWifiSurveyDto.STEP_SCHEMA_ID = 'b50b088f-a1d2-4f66-83b5-7e2a7638dc9d';
+CreateYfWifiSurveyDto.STEP_SCHEMA_ACTION_ID = 'cdcab202-5fa3-4219-b162-f8232e064a6b';
+CreateYfWifiSurveyDto.AUTO_LINK_PARENT = true;

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

@@ -0,0 +1,183 @@
+/**
+ * UpdateCustomerDeviceBattery Action DTO
+ *
+ * UpdateCustomerDeviceBattery
+ *
+ * @module ServiceModule
+ * @entity CustomerDevice
+ * @entityType BATTERY
+ * @actionKey UpdateCustomerDeviceBattery
+ * @event k1.t-hEOJjsDb.ServiceModule.CustomerDevice.Update.UpdateCustomerDeviceBattery
+ *
+ * AUTO-GENERATED - DO NOT EDIT DIRECTLY
+ */
+import { OdinRecord, OdinRecordUpdateDto, OdinRecordUpdatedEvent, OdinRecordLinkDto } from '@d19n/odin-types/dist/core';
+/**
+ * RabbitMQ message payload for UpdateCustomerDeviceBattery updated events
+ *
+ * @event k1.t-hEOJjsDb.ServiceModule.CustomerDevice.Update.UpdateCustomerDeviceBattery
+ */
+export interface UpdateCustomerDeviceBatteryMessage extends OdinRecordUpdatedEvent<UpdateCustomerDeviceBatteryDto, UpdateCustomerDeviceBatteryProperties> {
+}
+/**
+ * Properties for UpdateCustomerDeviceBattery action
+ *
+ * @property Required fields: 0
+ * @property Optional fields: 1
+ */
+export interface UpdateCustomerDeviceBatteryProperties {
+    /**
+     * Serial Number
+     *
+     * Serial Number
+     * @type {TEXT}
+     */
+    SerialNumber?: string | null;
+}
+/**
+ * Builder for UpdateCustomerDeviceBattery action
+ *
+ * Provides fluent API for adding associations before executing the action.
+ * Use .link*() methods to add associations, then call .execute() to run.
+ *
+ * @example
+ * ```typescript
+ * await record.updateCustomerDeviceBattery({ ...properties })
+ *   .linkAssociation_1786439643569({ id: '...', entity: '...' })
+ *   .execute();
+ * ```
+ */
+export declare class UpdateCustomerDeviceBatteryBuilder {
+    private _associations;
+    private _properties;
+    private _pendingLinks;
+    private _options?;
+    private _record;
+    private _provider?;
+    private _moduleName?;
+    private _entityName?;
+    private _clearPendingLinks?;
+    private _externalId?;
+    private _externalAppId?;
+    private _groups?;
+    constructor(record: {
+        id: string;
+        entity: string;
+        type?: string;
+    }, properties: UpdateCustomerDeviceBatteryProperties, pendingLinks: OdinRecordLinkDto[], options?: {
+        journeyId?: string;
+        stageKey?: string;
+    });
+    /**
+     * Link CustomerDevice__OrderItem
+     * @schemaAssociationId 29737305-924f-4e32-9dbc-8aab3de2e777
+     * @param target - The record to link
+     * @returns this (for method chaining)
+     */
+    linkAssociation_1786439643569(target: OdinRecord<any> | {
+        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
+     */
+    getData(): {
+        id: string;
+        entity: string;
+        type?: string;
+        actionName: string;
+        properties: UpdateCustomerDeviceBatteryProperties;
+        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;
+}
+/**
+ * UpdateCustomerDeviceBattery
+ *
+ * @actionType UPDATE - Updates an existing CustomerDevice record
+ * @module ServiceModule
+ * @entity CustomerDevice
+ * @entityType BATTERY (Battery Backup)
+ * @event k1.t-hEOJjsDb.ServiceModule.CustomerDevice.Update.UpdateCustomerDeviceBattery
+ * @permission schema.action.updatecustomerdevicebattery.trigger
+ * @benchmark This action is tracked for performance benchmarks
+ */
+export declare class UpdateCustomerDeviceBatteryDto extends OdinRecordUpdateDto<UpdateCustomerDeviceBatteryProperties> {
+    /** Used by SDK generators to identify action type */
+    static readonly ACTION_TYPE = "UPDATE";
+    static readonly ACTION_KEY = "UpdateCustomerDeviceBattery";
+    static readonly MODULE_NAME = "ServiceModule";
+    static readonly ENTITIES: string[];
+    static readonly ENTITY_TYPE = "BATTERY";
+    static readonly EVENT_NAME = "k1.t-hEOJjsDb.ServiceModule.CustomerDevice.Update.UpdateCustomerDeviceBattery";
+    static readonly PERMISSION = "schema.action.updatecustomerdevicebattery.trigger";
+    /** Step metadata - entity this action targets */
+    static readonly STEP_ENTITY = "ServiceModule:CustomerDevice";
+    static readonly STEP_SCHEMA_ID = "a72ffce5-0294-4038-8fb1-45fad5e4e473";
+    static readonly STEP_SCHEMA_ACTION_ID = "558ed6c2-7162-4131-9508-fdd7932f2b63";
+    static readonly STEP_SCHEMA_TYPE_ID = "bddbd043-c985-4eaf-9202-eb9dbe18c5e3";
+    static readonly STEP_TYPE = "BATTERY";
+    static readonly AUTO_LINK_PARENT = false;
+    static readonly HAS_ASSOCIATIONS = true;
+    static readonly HAS_REQUIRED_ASSOCIATIONS = false;
+    static readonly BUILDER_CLASS = "UpdateCustomerDeviceBatteryBuilder";
+    static readonly ASSOCIATION_FIELDS: readonly [{
+        readonly name: "Association_1786439643569";
+        readonly methodName: "linkAssociation_1786439643569";
+        readonly required: false;
+        readonly schemaAssociationId: "29737305-924f-4e32-9dbc-8aab3de2e777";
+    }];
+    readonly actionName: string;
+    readonly schemaActionId: string;
+    readonly entity: string;
+    constructor(record: OdinRecord<any> | {
+        id: string;
+        entity: string;
+        type?: string;
+    }, properties: UpdateCustomerDeviceBatteryProperties, options?: {
+        journeyId?: string;
+        stageKey?: string;
+    });
+}

package/dist/actions-v2/UpdateCustomerDeviceBatteryDto.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * UpdateCustomerDeviceBattery Action DTO
+ *
+ * UpdateCustomerDeviceBattery
+ *
+ * @module ServiceModule
+ * @entity CustomerDevice
+ * @entityType BATTERY
+ * @actionKey UpdateCustomerDeviceBattery
+ * @event k1.t-hEOJjsDb.ServiceModule.CustomerDevice.Update.UpdateCustomerDeviceBattery
+ *
+ * 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.UpdateCustomerDeviceBatteryDto = exports.UpdateCustomerDeviceBatteryBuilder = void 0;
+const core_1 = require("@d19n/odin-types/dist/core");
+/**
+ * Builder for UpdateCustomerDeviceBattery action
+ *
+ * Provides fluent API for adding associations before executing the action.
+ * Use .link*() methods to add associations, then call .execute() to run.
+ *
+ * @example
+ * ```typescript
+ * await record.updateCustomerDeviceBattery({ ...properties })
+ *   .linkAssociation_1786439643569({ id: '...', entity: '...' })
+ *   .execute();
+ * ```
+ */
+class UpdateCustomerDeviceBatteryBuilder {
+    constructor(record, properties, pendingLinks, options) {
+        this._associations = [];
+        this._record = record;
+        this._properties = properties;
+        this._pendingLinks = pendingLinks;
+        this._options = options;
+    }
+    /**
+     * Link CustomerDevice__OrderItem
+     * @schemaAssociationId 29737305-924f-4e32-9dbc-8aab3de2e777
+     * @param target - The record to link
+     * @returns this (for method chaining)
+     */
+    linkAssociation_1786439643569(target) {
+        this._associations.push(new core_1.OdinRecordLinkDto({
+            id: target.id,
+            entity: 'entity' in target ? target.entity : target.entity,
+        }));
+        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
+     */
+    getData() {
+        var _a, _b;
+        const allAssociations = [...this._associations, ...this._pendingLinks];
+        return Object.assign(Object.assign({ id: this._record.id, entity: this._record.entity, type: this._record.type, actionName: 'UpdateCustomerDeviceBattery', 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.UpdateCustomerDeviceBatteryBuilder = UpdateCustomerDeviceBatteryBuilder;
+/**
+ * UpdateCustomerDeviceBattery
+ *
+ * @actionType UPDATE - Updates an existing CustomerDevice record
+ * @module ServiceModule
+ * @entity CustomerDevice
+ * @entityType BATTERY (Battery Backup)
+ * @event k1.t-hEOJjsDb.ServiceModule.CustomerDevice.Update.UpdateCustomerDeviceBattery
+ * @permission schema.action.updatecustomerdevicebattery.trigger
+ * @benchmark This action is tracked for performance benchmarks
+ */
+class UpdateCustomerDeviceBatteryDto 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 = 'UpdateCustomerDeviceBattery';
+        this.schemaActionId = '558ed6c2-7162-4131-9508-fdd7932f2b63';
+        this.entity = 'ServiceModule:CustomerDevice';
+    }
+}
+exports.UpdateCustomerDeviceBatteryDto = UpdateCustomerDeviceBatteryDto;
+/** Used by SDK generators to identify action type */
+UpdateCustomerDeviceBatteryDto.ACTION_TYPE = 'UPDATE';
+UpdateCustomerDeviceBatteryDto.ACTION_KEY = 'UpdateCustomerDeviceBattery';
+UpdateCustomerDeviceBatteryDto.MODULE_NAME = 'ServiceModule';
+UpdateCustomerDeviceBatteryDto.ENTITIES = ['CustomerDevice'];
+UpdateCustomerDeviceBatteryDto.ENTITY_TYPE = 'BATTERY';
+UpdateCustomerDeviceBatteryDto.EVENT_NAME = 'k1.t-hEOJjsDb.ServiceModule.CustomerDevice.Update.UpdateCustomerDeviceBattery';
+UpdateCustomerDeviceBatteryDto.PERMISSION = 'schema.action.updatecustomerdevicebattery.trigger';
+/** Step metadata - entity this action targets */
+UpdateCustomerDeviceBatteryDto.STEP_ENTITY = 'ServiceModule:CustomerDevice';
+UpdateCustomerDeviceBatteryDto.STEP_SCHEMA_ID = 'a72ffce5-0294-4038-8fb1-45fad5e4e473';
+UpdateCustomerDeviceBatteryDto.STEP_SCHEMA_ACTION_ID = '558ed6c2-7162-4131-9508-fdd7932f2b63';
+UpdateCustomerDeviceBatteryDto.STEP_SCHEMA_TYPE_ID = 'bddbd043-c985-4eaf-9202-eb9dbe18c5e3';
+UpdateCustomerDeviceBatteryDto.STEP_TYPE = 'BATTERY';
+UpdateCustomerDeviceBatteryDto.AUTO_LINK_PARENT = false;
+UpdateCustomerDeviceBatteryDto.HAS_ASSOCIATIONS = true;
+UpdateCustomerDeviceBatteryDto.HAS_REQUIRED_ASSOCIATIONS = false;
+UpdateCustomerDeviceBatteryDto.BUILDER_CLASS = 'UpdateCustomerDeviceBatteryBuilder';
+UpdateCustomerDeviceBatteryDto.ASSOCIATION_FIELDS = [{ "name": "Association_1786439643569", "methodName": "linkAssociation_1786439643569", "required": false, "schemaAssociationId": "29737305-924f-4e32-9dbc-8aab3de2e777" }];