@d19n/youfibre-odin-sdk 2.0.281 → 2.0.282

package/dist/entities-v2/PgFileAllocation.d.ts

@@ -45,7 +45,9 @@ export declare enum PgFileAllocationPropertyKeys {
     /** Submission File Line Number */
     SubmissionFileLineNumber = "SubmissionFileLineNumber",
     /** Error Message */
-    ErrorMessage = "ErrorMessage"
+    ErrorMessage = "ErrorMessage",
+    /** Marks this allocation as not to be trusted — written, but it should not count as a real binding between the transaction and the file line. Defaults to false; every existing allocation keeps its current meaning. */
+    Invalid = "Invalid"
 }
 /**
  * Properties for PgFileAllocation records
@@ -93,6 +95,12 @@ export interface PgFileAllocationProperties {
      * @type {TEXT_LONG}
      */
     ErrorMessage: string;
+    /** Marks this allocation as not to be trusted — written, but it should not count as a real binding between the transaction and the file line. Defaults to false; every existing allocation keeps its current meaning.
+     *
+     * @type {BOOLEAN}
+     * @default false
+     */
+    Invalid: boolean;
 }
 /**
  * Properties for REPORT PgFileAllocation records
@@ -140,6 +148,12 @@ export interface ReportPgFileAllocationProperties {
      * @type {TEXT_LONG}
      */
     ErrorMessage: string;
+    /** Marks this allocation as not to be trusted — written, but it should not count as a real binding between the transaction and the file line. Defaults to false; every existing allocation keeps its current meaning.
+     *
+     * @type {BOOLEAN}
+     * @default false
+     */
+    Invalid: boolean;
 }
 /**
  * Properties for SUBMISSION PgFileAllocation records
@@ -187,6 +201,12 @@ export interface SubmissionPgFileAllocationProperties {
      * @type {TEXT_LONG}
      */
     ErrorMessage: string;
+    /** Marks this allocation as not to be trusted — written, but it should not count as a real binding between the transaction and the file line. Defaults to false; every existing allocation keeps its current meaning.
+     *
+     * @type {BOOLEAN}
+     * @default false
+     */
+    Invalid: boolean;
 }
 /**
  * PgFileAllocation entity from BillingModule

package/dist/entities-v2/PgFileAllocation.js

@@ -48,6 +48,8 @@ var PgFileAllocationPropertyKeys;
     PgFileAllocationPropertyKeys["SubmissionFileLineNumber"] = "SubmissionFileLineNumber";
     /** Error Message */
     PgFileAllocationPropertyKeys["ErrorMessage"] = "ErrorMessage";
+    /** Marks this allocation as not to be trusted — written, but it should not count as a real binding between the transaction and the file line. Defaults to false; every existing allocation keeps its current meaning. */
+    PgFileAllocationPropertyKeys["Invalid"] = "Invalid";
 })(PgFileAllocationPropertyKeys = exports.PgFileAllocationPropertyKeys || (exports.PgFileAllocationPropertyKeys = {}));
 /**
  * PgFileAllocation entity from BillingModule

package/dist/entities-v2/WorkOrder.d.ts

@@ -1304,6 +1304,7 @@ export declare enum WorkOrderReTriggerReason {
  * @remarks Available options:
  * - `VC_CD` - At Risk Customer - Critical Dispatch
  * - `CR_LS` - Chargeable replacement (Lost / stolen CPE)
+ * - `PRE_INS` - CPE ahead of Installation
  * - `CC_RC` - Customer Complaint - Retention Critical
  * - `DD_MD` - Defective/Damaged Mesh - Troubleshoot Completed
  * - `DD_PS` - Defective/Damaged Power Supply
@@ -1316,12 +1317,12 @@ export declare enum WorkOrderReTriggerReason {
  * - `NR_INS` - Non-Received Device at Install
  * - `OO_ND` - Original Order - Non Dispatched (3PL)
  * - `CP_AV` - Pre installed property - CPE required for activation
- * - `UR_CM` - Upgrade/Renewal - CM request for new router
- * - ... and 1 more
+ * - ... and 2 more
  */
 export declare enum WorkOrderDispatchReason {
     AT_RISK_CUSTOMER_CRITICAL_DISPATCH = "VC_CD",
     CHARGEABLE_REPLACEMENT_LOST_STOLEN_CPE = "CR_LS",
+    CPE_AHEAD_OF_INSTALLATION = "PRE_INS",
     CUSTOMER_COMPLAINT_RETENTION_CRITICAL = "CC_RC",
     DEFECTIVE_DAMAGED_MESH_TROUBLESHOOT_COMPLETED = "DD_MD",
     DEFECTIVE_DAMAGED_POWER_SUPPLY = "DD_PS",

package/dist/entities-v2/WorkOrder.js

@@ -1304,6 +1304,7 @@ var WorkOrderReTriggerReason;
  * @remarks Available options:
  * - `VC_CD` - At Risk Customer - Critical Dispatch
  * - `CR_LS` - Chargeable replacement (Lost / stolen CPE)
+ * - `PRE_INS` - CPE ahead of Installation
  * - `CC_RC` - Customer Complaint - Retention Critical
  * - `DD_MD` - Defective/Damaged Mesh - Troubleshoot Completed
  * - `DD_PS` - Defective/Damaged Power Supply
@@ -1316,13 +1317,13 @@ var WorkOrderReTriggerReason;
  * - `NR_INS` - Non-Received Device at Install
  * - `OO_ND` - Original Order - Non Dispatched (3PL)
  * - `CP_AV` - Pre installed property - CPE required for activation
- * - `UR_CM` - Upgrade/Renewal - CM request for new router
- * - ... and 1 more
+ * - ... and 2 more
  */
 var WorkOrderDispatchReason;
 (function (WorkOrderDispatchReason) {
     WorkOrderDispatchReason["AT_RISK_CUSTOMER_CRITICAL_DISPATCH"] = "VC_CD";
     WorkOrderDispatchReason["CHARGEABLE_REPLACEMENT_LOST_STOLEN_CPE"] = "CR_LS";
+    WorkOrderDispatchReason["CPE_AHEAD_OF_INSTALLATION"] = "PRE_INS";
     WorkOrderDispatchReason["CUSTOMER_COMPLAINT_RETENTION_CRITICAL"] = "CC_RC";
     WorkOrderDispatchReason["DEFECTIVE_DAMAGED_MESH_TROUBLESHOOT_COMPLETED"] = "DD_MD";
     WorkOrderDispatchReason["DEFECTIVE_DAMAGED_POWER_SUPPLY"] = "DD_PS";

package/dist/entities-v2/YfAgentLocation.d.ts

@@ -0,0 +1,98 @@
+/**
+ * YfAgentLocation Entity Definition
+ *
+ * One record per field worker per UK day; the doorway to that day's GPS trail in ClickHouse. Created lazily on the first reading of a day; upserts on NaturalKey. Carries identity scalars only — never coordinates.
+ *
+ * @module FieldServiceModule
+ * @entity YfAgentLocation
+ * @schemaId ec118dd7-2e8c-4fc3-90b6-10ef79d51d7c
+ *
+ * AUTO-GENERATED - DO NOT EDIT DIRECTLY
+ * Generated from Odin schema definition
+ */
+import { OdinRecord } from '@d19n/odin-types/dist/core';
+/**
+ * Available types for YfAgentLocation records
+ */
+export declare enum YfAgentLocationEntityTypes {
+    /** This is the default record type */
+    DEFAULT = "DEFAULT"
+}
+/**
+ * Property keys for YfAgentLocation
+ * Use these constants instead of string literals for type safety
+ */
+export declare enum YfAgentLocationPropertyKeys {
+    /** The worker's OrganizationUser uuid — the same key the app and the ClickHouse reading rows use. Not unique here: one record per day per user. */
+    UserId = "UserId",
+    /** The UK day this record covers — matches reading_date on the ClickHouse rows (both roll over at UK midnight, BST included). */
+    Date = "Date",
+    /** Display name at the time the record was written. Denormalised on purpose — the record is a snapshot of the day, not a live join to the user. */
+    UserName = "UserName",
+    /** "<UserId>:<YYYY-MM-DD>". UNIQUE, so with upsertOnCreate a repeated create for the same worker-day updates the existing record instead of duplicating it. Mechanism, not information — hidden from tables. */
+    NaturalKey = "NaturalKey"
+}
+/**
+ * Properties for YfAgentLocation records
+ *
+ * @see FieldServiceModule:YfAgentLocation
+ */
+export interface YfAgentLocationProperties {
+    /** The worker's OrganizationUser uuid — the same key the app and the ClickHouse reading rows use. Not unique here: one record per day per user.
+     *
+     * @type {TEXT}
+     * @default
+     */
+    UserId: string;
+    /** The UK day this record covers — matches reading_date on the ClickHouse rows (both roll over at UK midnight, BST included).
+     *
+     * @type {DATE}
+     * @default
+     */
+    Date: string;
+    /** Display name at the time the record was written. Denormalised on purpose — the record is a snapshot of the day, not a live join to the user.
+     *
+     * @type {TEXT}
+     * @default
+     */
+    UserName: string;
+    /** "<UserId>:<YYYY-MM-DD>". UNIQUE, so with upsertOnCreate a repeated create for the same worker-day updates the existing record instead of duplicating it. Mechanism, not information — hidden from tables.
+     *
+     * @type {TEXT}
+     * @default
+     */
+    NaturalKey: string;
+}
+/**
+ * YfAgentLocation entity from FieldServiceModule
+ *
+ * One record per field worker per UK day; the doorway to that day's GPS trail in ClickHouse. Created lazily on the first reading of a day; upserts on NaturalKey. Carries identity scalars only — never coordinates.
+ *
+ * @module FieldServiceModule
+ * @entity YfAgentLocation
+ * @schemaId ec118dd7-2e8c-4fc3-90b6-10ef79d51d7c
+ * @recordPrefix AGL
+ * @capabilities searchable, updateable, undeletable, triggerable
+ */
+export declare class YfAgentLocation extends OdinRecord<YfAgentLocationProperties> {
+    entity: 'FieldServiceModule:YfAgentLocation';
+    type: YfAgentLocationEntityTypes;
+    schemaId: 'ec118dd7-2e8c-4fc3-90b6-10ef79d51d7c';
+    properties: YfAgentLocationProperties;
+}
+/**
+ * RabbitMQ routing keys for YfAgentLocation events
+ */
+export declare const ROUTING_KEY_YF_AGENT_LOCATION_CREATED = "FieldServiceModule.YfAgentLocation.SubDbRecordCreated";
+export declare const ROUTING_KEY_YF_AGENT_LOCATION_UPDATED = "FieldServiceModule.YfAgentLocation.SubDbRecordUpdated";
+export declare const ROUTING_KEY_YF_AGENT_LOCATION_DELETED = "FieldServiceModule.YfAgentLocation.SubDbRecordDeleted";
+/**
+ * Type-specific routing keys for YfAgentLocation events
+ * Subscribe to these for events on specific entity types only
+ */
+/** This is the default record type created */
+export declare const ROUTING_KEY_YF_AGENT_LOCATION_DEFAULT_CREATED = "FieldServiceModule.YfAgentLocation.DEFAULT.SubDbRecordCreated";
+/** This is the default record type updated */
+export declare const ROUTING_KEY_YF_AGENT_LOCATION_DEFAULT_UPDATED = "FieldServiceModule.YfAgentLocation.DEFAULT.SubDbRecordUpdated";
+/** This is the default record type deleted */
+export declare const ROUTING_KEY_YF_AGENT_LOCATION_DEFAULT_DELETED = "FieldServiceModule.YfAgentLocation.DEFAULT.SubDbRecordDeleted";

package/dist/entities-v2/YfAgentLocation.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * YfAgentLocation Entity Definition
+ *
+ * One record per field worker per UK day; the doorway to that day's GPS trail in ClickHouse. Created lazily on the first reading of a day; upserts on NaturalKey. Carries identity scalars only — never coordinates.
+ *
+ * @module FieldServiceModule
+ * @entity YfAgentLocation
+ * @schemaId ec118dd7-2e8c-4fc3-90b6-10ef79d51d7c
+ *
+ * AUTO-GENERATED - DO NOT EDIT DIRECTLY
+ * Generated from Odin schema definition
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROUTING_KEY_YF_AGENT_LOCATION_DEFAULT_DELETED = exports.ROUTING_KEY_YF_AGENT_LOCATION_DEFAULT_UPDATED = exports.ROUTING_KEY_YF_AGENT_LOCATION_DEFAULT_CREATED = exports.ROUTING_KEY_YF_AGENT_LOCATION_DELETED = exports.ROUTING_KEY_YF_AGENT_LOCATION_UPDATED = exports.ROUTING_KEY_YF_AGENT_LOCATION_CREATED = exports.YfAgentLocation = exports.YfAgentLocationPropertyKeys = exports.YfAgentLocationEntityTypes = void 0;
+const core_1 = require("@d19n/odin-types/dist/core");
+/**
+ * Available types for YfAgentLocation records
+ */
+var YfAgentLocationEntityTypes;
+(function (YfAgentLocationEntityTypes) {
+    /** This is the default record type */
+    YfAgentLocationEntityTypes["DEFAULT"] = "DEFAULT";
+})(YfAgentLocationEntityTypes = exports.YfAgentLocationEntityTypes || (exports.YfAgentLocationEntityTypes = {}));
+/**
+ * Property keys for YfAgentLocation
+ * Use these constants instead of string literals for type safety
+ */
+var YfAgentLocationPropertyKeys;
+(function (YfAgentLocationPropertyKeys) {
+    /** The worker's OrganizationUser uuid — the same key the app and the ClickHouse reading rows use. Not unique here: one record per day per user. */
+    YfAgentLocationPropertyKeys["UserId"] = "UserId";
+    /** The UK day this record covers — matches reading_date on the ClickHouse rows (both roll over at UK midnight, BST included). */
+    YfAgentLocationPropertyKeys["Date"] = "Date";
+    /** Display name at the time the record was written. Denormalised on purpose — the record is a snapshot of the day, not a live join to the user. */
+    YfAgentLocationPropertyKeys["UserName"] = "UserName";
+    /** "<UserId>:<YYYY-MM-DD>". UNIQUE, so with upsertOnCreate a repeated create for the same worker-day updates the existing record instead of duplicating it. Mechanism, not information — hidden from tables. */
+    YfAgentLocationPropertyKeys["NaturalKey"] = "NaturalKey";
+})(YfAgentLocationPropertyKeys = exports.YfAgentLocationPropertyKeys || (exports.YfAgentLocationPropertyKeys = {}));
+/**
+ * YfAgentLocation entity from FieldServiceModule
+ *
+ * One record per field worker per UK day; the doorway to that day's GPS trail in ClickHouse. Created lazily on the first reading of a day; upserts on NaturalKey. Carries identity scalars only — never coordinates.
+ *
+ * @module FieldServiceModule
+ * @entity YfAgentLocation
+ * @schemaId ec118dd7-2e8c-4fc3-90b6-10ef79d51d7c
+ * @recordPrefix AGL
+ * @capabilities searchable, updateable, undeletable, triggerable
+ */
+class YfAgentLocation extends core_1.OdinRecord {
+}
+exports.YfAgentLocation = YfAgentLocation;
+// ============================================
+// RABBITMQ EVENT ROUTING KEYS
+// ============================================
+/**
+ * RabbitMQ routing keys for YfAgentLocation events
+ */
+exports.ROUTING_KEY_YF_AGENT_LOCATION_CREATED = 'FieldServiceModule.YfAgentLocation.SubDbRecordCreated';
+exports.ROUTING_KEY_YF_AGENT_LOCATION_UPDATED = 'FieldServiceModule.YfAgentLocation.SubDbRecordUpdated';
+exports.ROUTING_KEY_YF_AGENT_LOCATION_DELETED = 'FieldServiceModule.YfAgentLocation.SubDbRecordDeleted';
+/**
+ * Type-specific routing keys for YfAgentLocation events
+ * Subscribe to these for events on specific entity types only
+ */
+/** This is the default record type created */
+exports.ROUTING_KEY_YF_AGENT_LOCATION_DEFAULT_CREATED = 'FieldServiceModule.YfAgentLocation.DEFAULT.SubDbRecordCreated';
+/** This is the default record type updated */
+exports.ROUTING_KEY_YF_AGENT_LOCATION_DEFAULT_UPDATED = 'FieldServiceModule.YfAgentLocation.DEFAULT.SubDbRecordUpdated';
+/** This is the default record type deleted */
+exports.ROUTING_KEY_YF_AGENT_LOCATION_DEFAULT_DELETED = 'FieldServiceModule.YfAgentLocation.DEFAULT.SubDbRecordDeleted';

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

@@ -32,6 +32,7 @@ import { UpdatePgAllocationWithAcknowledgementOneProperties } from '../actions-v
 import { UpdatePgAllocationWithAcknowledgementTwoProperties } from '../actions-v2/UpdatePgAllocationWithAcknowledgementTwoDto';
 import { UpdatePgAllocationWithBacsReportProperties } from '../actions-v2/UpdatePgAllocationWithBacsReportDto';
 import { UpdatePgFileAllocationProperties } from '../actions-v2/UpdatePgFileAllocationDto';
+import { UpdatePgFileAllocationInvalidProperties } from '../actions-v2/UpdatePgFileAllocationInvalidDto';
 import { PgTransactionRecord } from './PgTransactionRecord';
 import { PgDirectDebitFileRecord } from './PgDirectDebitFileRecord';
 import { PgPaymentMethodRecord } from './PgPaymentMethodRecord';
@@ -494,6 +495,33 @@ export declare class PgFileAllocationRecord<TProps = PgFileAllocationProperties>
         journeyId?: string;
         stageKey?: string;
     }): ActionBuilder;
+    /**
+     * UpdatePgFileAllocationInvalid
+     *
+     * Updates this PgFileAllocation record.
+     * Returns an ActionBuilder - call .execute() to update or .dryRun() for debugging.
+     *
+     * @param propertiesOrOptions - Properties to update, or options object
+     * @param options - Optional settings (journeyId, stageKey)
+     * @returns ActionBuilder - call .execute() to update or .dryRun() for payload
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * const record = await odinClient.pgFileAllocations.get(id);
+     * await record.updatePgFileAllocationInvalid({ ... }).execute();
+     *
+     * // Dry run (for debugging)
+     * const payload = record.updatePgFileAllocationInvalid({ ... }).dryRun();
+     * ```
+     */
+    updatePgFileAllocationInvalid(propertiesOrOptions?: UpdatePgFileAllocationInvalidProperties | {
+        journeyId?: string;
+        stageKey?: string;
+    }, options?: {
+        journeyId?: string;
+        stageKey?: string;
+    }): ActionBuilder;
 }
 /** Type guard to check if an object is a PgFileAllocationRecord */
 export declare function isPgFileAllocationRecord(obj: any): obj is PgFileAllocationRecord;

package/dist/records-v2/PgFileAllocationRecord.js

@@ -624,6 +624,43 @@ class PgFileAllocationRecord {
         const payload = Object.assign({ id: this._record.id, entity: this._record.entity, type: this._record.type, actionName: 'UpdatePgFileAllocation', properties, associations: this._pendingLinks.length > 0 ? this._pendingLinks : undefined }, opts);
         return new ActionBuilder(this._provider, 'BillingModule', 'PgFileAllocation', payload, () => { this._pendingLinks = []; });
     }
+    /**
+     * UpdatePgFileAllocationInvalid
+     *
+     * Updates this PgFileAllocation record.
+     * Returns an ActionBuilder - call .execute() to update or .dryRun() for debugging.
+     *
+     * @param propertiesOrOptions - Properties to update, or options object
+     * @param options - Optional settings (journeyId, stageKey)
+     * @returns ActionBuilder - call .execute() to update or .dryRun() for payload
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * const record = await odinClient.pgFileAllocations.get(id);
+     * await record.updatePgFileAllocationInvalid({ ... }).execute();
+     *
+     * // Dry run (for debugging)
+     * const payload = record.updatePgFileAllocationInvalid({ ... }).dryRun();
+     * ```
+     */
+    updatePgFileAllocationInvalid(propertiesOrOptions, options) {
+        var _a;
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('updatePgFileAllocationInvalid requires an existing record. Use accessor.get() first.');
+        let properties = {};
+        let opts = options;
+        if (propertiesOrOptions) {
+            if ('journeyId' in propertiesOrOptions || 'stageKey' in propertiesOrOptions) {
+                opts = propertiesOrOptions;
+            }
+            else {
+                properties = propertiesOrOptions;
+            }
+        }
+        const payload = Object.assign({ id: this._record.id, entity: this._record.entity, type: this._record.type, actionName: 'UpdatePgFileAllocationInvalid', properties, associations: this._pendingLinks.length > 0 ? this._pendingLinks : undefined }, opts);
+        return new ActionBuilder(this._provider, 'BillingModule', 'PgFileAllocation', payload, () => { this._pendingLinks = []; });
+    }
 }
 exports.PgFileAllocationRecord = PgFileAllocationRecord;
 // ============================================

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

@@ -0,0 +1,184 @@
+/**
+ * YfAgentLocation Record Wrapper
+ *
+ * Provides typed action methods and link management.
+ * Works with both ApiProvider and DbProvider.
+ *
+ * All action methods return an ActionBuilder or FlowBuilder.
+ * Call .execute() to run or .dryRun() to get the payload for debugging.
+ *
+ * Can be instantiated with null record for create operations:
+ * ```typescript
+ * const record = odinClient.yfAgentLocations.new();
+ * await record.createYfAgentLocation({ ... }).execute();
+ * ```
+ *
+ * Entity Types: DEFAULT
+ *
+ * AUTO-GENERATED - DO NOT EDIT DIRECTLY
+ */
+import { OdinRecord, OdinRecordLinkDto } from '@d19n/odin-types/dist/core';
+import { PipelineStageEntity } from '@d19n/odin-types/dist/core';
+import { IDbRecordCreateUpdateRes } from '@d19n/odin-types/dist/core/interfaces/v1.db.interfaces';
+import { IOdinProvider } from '@d19n/odin-sdk-generator/dist/odin-sdk-types';
+import { YfAgentLocationProperties } from '../entities-v2/YfAgentLocation';
+import { CreateYfAgentLocationProperties } from '../actions-v2/CreateYfAgentLocationDto';
+/** Valid entity types for YfAgentLocation */
+export declare type YfAgentLocationType = 'DEFAULT';
+/**
+ * Builder for action execution with dryRun support
+ *
+ * Provides a consistent API across all action types:
+ * - `.execute()` - Execute the action and return results
+ * - `.dryRun()` - Return the payload without executing (for debugging)
+ */
+declare class ActionBuilder<T = IDbRecordCreateUpdateRes[]> {
+    private _provider;
+    private _moduleName;
+    private _entityName;
+    private _payload;
+    private _clearPendingLinks;
+    constructor(provider: IOdinProvider, moduleName: string, entityName: string, payload: Record<string, any>, clearPendingLinks: () => void);
+    /**
+     * 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)
+     *
+     * @example
+     * ```typescript
+     * await record.createOrder({ ... }).withExternalId('SF-123', 'salesforce').execute();
+     * ```
+     */
+    withExternalId(externalId: string, externalAppId: string): this;
+    /**
+     * Set security/access groups for this record.
+     * Controls which user groups can access the record.
+     *
+     * @param groups - Array of group names
+     * @returns this (for chaining)
+     *
+     * @example
+     * ```typescript
+     * await record.createOrder({ ... }).withGroups(['TenantA', 'BillingTeam']).execute();
+     * ```
+     */
+    withGroups(groups: string[]): this;
+    /**
+     * Execute the action
+     * @returns The result from the API
+     */
+    execute(): Promise<T>;
+    /**
+     * 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 actionBuilder` without .execute()
+     * Forces developers to explicitly call .execute()
+     * @throws Error always - use .execute() or .dryRun() instead
+     */
+    then(): never;
+}
+export declare class YfAgentLocationRecord<TProps = YfAgentLocationProperties> {
+    private _record;
+    private _provider;
+    private _pendingLinks;
+    private _preGeneratedId;
+    /**
+     * Create a record wrapper.
+     * @param record - The underlying record, or null for create operations
+     * @param provider - The API or DB provider
+     * @param preGeneratedId - Optional pre-generated ID for new records (auto-generated if not provided)
+     */
+    constructor(record: OdinRecord<TProps> | null, provider: IOdinProvider, preGeneratedId?: string);
+    /** Returns true if this is a new (unsaved) record */
+    get isNew(): boolean;
+    /** Record ID - always available (pre-generated for new records) */
+    get id(): string;
+    get entity(): string;
+    get type(): YfAgentLocationType | undefined;
+    /** Record properties - empty object for new (unsaved) records */
+    get properties(): TProps;
+    get title(): string | undefined;
+    get recordNumber(): string | undefined;
+    get stage(): PipelineStageEntity | undefined;
+    get createdAt(): string | undefined;
+    get updatedAt(): string | undefined;
+    get externalId(): string | undefined;
+    get externalAppId(): string | undefined;
+    get groups(): string[];
+    /** Access the underlying OdinRecord (null for new records) */
+    get record(): OdinRecord<TProps> | null;
+    /**
+     * Type guard: check if this record is of type DEFAULT
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to DEFAULT-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isDefault()) {
+     *   // TypeScript knows record.properties is YfAgentLocationProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks This is the default record type
+     */
+    isDefault(): this is YfAgentLocationRecord<YfAgentLocationProperties>;
+    /**
+     * Queue a link to be created with the next action.
+     * Works for both create and update actions.
+     * @returns this (for chaining)
+     */
+    link(target: OdinRecord<any> | {
+        id: string;
+        entity: string;
+    }): this;
+    /** Get the currently queued links */
+    get pendingLinks(): OdinRecordLinkDto[];
+    /** Clear pending links without executing an action */
+    clearPendingLinks(): this;
+    /**
+     * Immediately unlink a record (API call).
+     * Unlike link(), this executes immediately.
+     * @throws Error if called on a new (unsaved) record
+     */
+    unlink(target: OdinRecord<any> | {
+        id: string;
+    } | string): Promise<void>;
+    /**
+     * CreateYfAgentLocation
+     *
+     * Creates a new YfAgentLocation record with the specified properties.
+     * Returns an ActionBuilder - call .execute() to create or .dryRun() for debugging.
+     *
+     * @param properties - The properties for the new record
+     * @param options - Optional settings
+     * @param options.type - Override the record type
+     * @param options.journeyId - Associate with a journey
+     * @param options.stageKey - Set initial pipeline stage
+     * @returns ActionBuilder - call .execute() to create or .dryRun() for payload
+     *
+     * @example
+     * ```typescript
+     * // Create with properties
+     * const record = odinClient.yfAgentLocations.new();
+     * await record.createYfAgentLocation({ ... }).execute();
+     *
+     * // Dry run (for debugging)
+     * const payload = record.createYfAgentLocation({ ... }).dryRun();
+     * ```
+     */
+    createYfAgentLocation(properties: CreateYfAgentLocationProperties, options?: {
+        type?: string;
+        journeyId?: string;
+        stageKey?: string;
+    }): ActionBuilder;
+}
+/** Type guard to check if an object is a YfAgentLocationRecord */
+export declare function isYfAgentLocationRecord(obj: any): obj is YfAgentLocationRecord;
+export {};