@d19n/youfibre-odin-sdk 2.0.280 → 2.0.282

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

@@ -0,0 +1,92 @@
+/**
+ * CreateYfAgentLocation Action DTO
+ *
+ * Create (or upsert by NaturalKey) the per-worker-per-day GPS location record
+ *
+ * @module FieldServiceModule
+ * @entity YfAgentLocation
+ * @actionKey CreateYfAgentLocation
+ * @event k1.t-hEOJjsDb.FieldServiceModule.YfAgentLocation.Create.CreateYfAgentLocation
+ *
+ * AUTO-GENERATED - DO NOT EDIT DIRECTLY
+ */
+import { OdinRecordCreateDto, OdinRecordCreatedEvent } from '@d19n/odin-types/dist/core';
+/**
+ * RabbitMQ message payload for CreateYfAgentLocation created events
+ *
+ * @event k1.t-hEOJjsDb.FieldServiceModule.YfAgentLocation.Create.CreateYfAgentLocation
+ */
+export interface CreateYfAgentLocationMessage extends OdinRecordCreatedEvent<CreateYfAgentLocationDto, CreateYfAgentLocationProperties> {
+}
+/**
+ * Properties for CreateYfAgentLocation action
+ *
+ * @property Required fields: 4
+ * @property Optional fields: 0
+ */
+export interface CreateYfAgentLocationProperties {
+    /**
+     * User Id
+     *
+     * 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}
+     * @required
+     */
+    UserId: string;
+    /**
+     * User Name
+     *
+     * 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}
+     * @required
+     */
+    UserName: string;
+    /**
+     * Date
+     *
+     * The UK day this record covers — matches reading_date on the ClickHouse rows (both roll over at UK midnight, BST included).
+     * @type {DATE}
+     * @required
+     */
+    Date: string;
+    /**
+     * Natural Key
+     *
+     * "<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}
+     * @required
+     */
+    NaturalKey: string;
+}
+/**
+ * Create Agent Location
+ *
+ * Create (or upsert by NaturalKey) the per-worker-per-day GPS location record
+ *
+ * @actionType CREATE - Creates a new YfAgentLocation record
+ * @module FieldServiceModule
+ * @entity YfAgentLocation
+ * @event k1.t-hEOJjsDb.FieldServiceModule.YfAgentLocation.Create.CreateYfAgentLocation
+ * @permission schema.action.createyfagentlocation.trigger
+ * @benchmark This action is tracked for performance benchmarks
+ */
+export declare class CreateYfAgentLocationDto extends OdinRecordCreateDto<CreateYfAgentLocationProperties> {
+    /** Used by SDK generators to identify action type */
+    static readonly ACTION_TYPE = "CREATE";
+    static readonly ACTION_KEY = "CreateYfAgentLocation";
+    static readonly MODULE_NAME = "FieldServiceModule";
+    static readonly ENTITIES: string[];
+    static readonly EVENT_NAME = "k1.t-hEOJjsDb.FieldServiceModule.YfAgentLocation.Create.CreateYfAgentLocation";
+    static readonly PERMISSION = "schema.action.createyfagentlocation.trigger";
+    /** Step metadata - entity this action targets */
+    static readonly STEP_ENTITY = "FieldServiceModule:YfAgentLocation";
+    static readonly STEP_SCHEMA_ID = "ec118dd7-2e8c-4fc3-90b6-10ef79d51d7c";
+    static readonly STEP_SCHEMA_ACTION_ID = "bdf16338-cba0-40d4-af89-7ab3bdbd76c0";
+    static readonly AUTO_LINK_PARENT = true;
+    readonly actionName: string;
+    readonly schemaActionId: string;
+    readonly entity: string;
+    constructor(properties: CreateYfAgentLocationProperties, options?: {
+        journeyId?: string;
+    });
+}

package/dist/actions-v2/CreateYfAgentLocationDto.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * CreateYfAgentLocation Action DTO
+ *
+ * Create (or upsert by NaturalKey) the per-worker-per-day GPS location record
+ *
+ * @module FieldServiceModule
+ * @entity YfAgentLocation
+ * @actionKey CreateYfAgentLocation
+ * @event k1.t-hEOJjsDb.FieldServiceModule.YfAgentLocation.Create.CreateYfAgentLocation
+ *
+ * AUTO-GENERATED - DO NOT EDIT DIRECTLY
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateYfAgentLocationDto = void 0;
+const core_1 = require("@d19n/odin-types/dist/core");
+/**
+ * Create Agent Location
+ *
+ * Create (or upsert by NaturalKey) the per-worker-per-day GPS location record
+ *
+ * @actionType CREATE - Creates a new YfAgentLocation record
+ * @module FieldServiceModule
+ * @entity YfAgentLocation
+ * @event k1.t-hEOJjsDb.FieldServiceModule.YfAgentLocation.Create.CreateYfAgentLocation
+ * @permission schema.action.createyfagentlocation.trigger
+ * @benchmark This action is tracked for performance benchmarks
+ */
+class CreateYfAgentLocationDto extends core_1.OdinRecordCreateDto {
+    constructor(properties, options) {
+        super({
+            entity: 'FieldServiceModule:YfAgentLocation',
+            type: undefined,
+            properties,
+            journeyId: options === null || options === void 0 ? void 0 : options.journeyId,
+        });
+        this.actionName = 'CreateYfAgentLocation';
+        this.schemaActionId = 'bdf16338-cba0-40d4-af89-7ab3bdbd76c0';
+        this.entity = 'FieldServiceModule:YfAgentLocation';
+    }
+}
+exports.CreateYfAgentLocationDto = CreateYfAgentLocationDto;
+/** Used by SDK generators to identify action type */
+CreateYfAgentLocationDto.ACTION_TYPE = 'CREATE';
+CreateYfAgentLocationDto.ACTION_KEY = 'CreateYfAgentLocation';
+CreateYfAgentLocationDto.MODULE_NAME = 'FieldServiceModule';
+CreateYfAgentLocationDto.ENTITIES = ['YfAgentLocation'];
+CreateYfAgentLocationDto.EVENT_NAME = 'k1.t-hEOJjsDb.FieldServiceModule.YfAgentLocation.Create.CreateYfAgentLocation';
+CreateYfAgentLocationDto.PERMISSION = 'schema.action.createyfagentlocation.trigger';
+/** Step metadata - entity this action targets */
+CreateYfAgentLocationDto.STEP_ENTITY = 'FieldServiceModule:YfAgentLocation';
+CreateYfAgentLocationDto.STEP_SCHEMA_ID = 'ec118dd7-2e8c-4fc3-90b6-10ef79d51d7c';
+CreateYfAgentLocationDto.STEP_SCHEMA_ACTION_ID = 'bdf16338-cba0-40d4-af89-7ab3bdbd76c0';
+CreateYfAgentLocationDto.AUTO_LINK_PARENT = true;

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

@@ -22,7 +22,7 @@ export interface UpdateOrderMessage extends OdinRecordUpdatedEvent<UpdateOrderDt
  * Properties for UpdateOrder action
  *
  * @property Required fields: 0
- * @property Optional fields: 9
+ * @property Optional fields: 10
  */
 export interface UpdateOrderProperties {
     /**
@@ -91,6 +91,14 @@ export interface UpdateOrderProperties {
      * @type {ENUM}
      */
     SupplierOrderType?: string | null;
+    /**
+     * contract end date
+     *
+     * the date the contract will end (Sales - Order)
+     * @type {DATE}
+     * @format DD/MM/YYYY
+     */
+    ContractEndDate?: string | null;
 }
 /**
  * UpdateOrder

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

@@ -0,0 +1,77 @@
+/**
+ * UpdatePgFileAllocationInvalid Action DTO
+ *
+ * Sets or clears the Invalid flag on a file allocation. Its only job — the flag is never a side effect of a line-number or report write.
+ *
+ * @module BillingModule
+ * @entity PgFileAllocation
+ * @entityType DEFAULT
+ * @actionKey UpdatePgFileAllocationInvalid
+ * @event k1.t-hEOJjsDb.BillingModule.PgFileAllocation.Update.UpdatePgFileAllocationInvalid
+ *
+ * AUTO-GENERATED - DO NOT EDIT DIRECTLY
+ */
+import { OdinRecord, OdinRecordUpdateDto, OdinRecordUpdatedEvent } from '@d19n/odin-types/dist/core';
+/**
+ * RabbitMQ message payload for UpdatePgFileAllocationInvalid updated events
+ *
+ * @event k1.t-hEOJjsDb.BillingModule.PgFileAllocation.Update.UpdatePgFileAllocationInvalid
+ */
+export interface UpdatePgFileAllocationInvalidMessage extends OdinRecordUpdatedEvent<UpdatePgFileAllocationInvalidDto, UpdatePgFileAllocationInvalidProperties> {
+}
+/**
+ * Properties for UpdatePgFileAllocationInvalid action
+ *
+ * @property Required fields: 0
+ * @property Optional fields: 1
+ */
+export interface UpdatePgFileAllocationInvalidProperties {
+    /**
+     * Invalid
+     *
+     * 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}
+     */
+    Invalid?: boolean | null;
+}
+/**
+ * Is this allocation invalid?
+ *
+ * Sets or clears the Invalid flag on a file allocation. Its only job — the flag is never a side effect of a line-number or report write.
+ *
+ * @actionType UPDATE - Updates an existing PgFileAllocation record
+ * @module BillingModule
+ * @entity PgFileAllocation
+ * @entityType DEFAULT (Default)
+ * @event k1.t-hEOJjsDb.BillingModule.PgFileAllocation.Update.UpdatePgFileAllocationInvalid
+ * @permission schema.action.updatepgfileallocationinvalid.trigger
+ * @benchmark This action is tracked for performance benchmarks
+ */
+export declare class UpdatePgFileAllocationInvalidDto extends OdinRecordUpdateDto<UpdatePgFileAllocationInvalidProperties> {
+    /** Used by SDK generators to identify action type */
+    static readonly ACTION_TYPE = "UPDATE";
+    static readonly ACTION_KEY = "UpdatePgFileAllocationInvalid";
+    static readonly MODULE_NAME = "BillingModule";
+    static readonly ENTITIES: string[];
+    static readonly ENTITY_TYPE = "DEFAULT";
+    static readonly EVENT_NAME = "k1.t-hEOJjsDb.BillingModule.PgFileAllocation.Update.UpdatePgFileAllocationInvalid";
+    static readonly PERMISSION = "schema.action.updatepgfileallocationinvalid.trigger";
+    /** Step metadata - entity this action targets */
+    static readonly STEP_ENTITY = "BillingModule:PgFileAllocation";
+    static readonly STEP_SCHEMA_ID = "0747b695-c0c0-4d18-b445-40e80ad531b4";
+    static readonly STEP_SCHEMA_ACTION_ID = "6497875c-9cae-469b-b2fa-e09488e00d77";
+    static readonly STEP_SCHEMA_TYPE_ID = "aebd372f-1c03-4160-a44a-8930181c21f6";
+    static readonly STEP_TYPE = "DEFAULT";
+    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: UpdatePgFileAllocationInvalidProperties, options?: {
+        journeyId?: string;
+        stageKey?: string;
+    });
+}

package/dist/actions-v2/UpdatePgFileAllocationInvalidDto.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * UpdatePgFileAllocationInvalid Action DTO
+ *
+ * Sets or clears the Invalid flag on a file allocation. Its only job — the flag is never a side effect of a line-number or report write.
+ *
+ * @module BillingModule
+ * @entity PgFileAllocation
+ * @entityType DEFAULT
+ * @actionKey UpdatePgFileAllocationInvalid
+ * @event k1.t-hEOJjsDb.BillingModule.PgFileAllocation.Update.UpdatePgFileAllocationInvalid
+ *
+ * AUTO-GENERATED - DO NOT EDIT DIRECTLY
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdatePgFileAllocationInvalidDto = void 0;
+const core_1 = require("@d19n/odin-types/dist/core");
+/**
+ * Is this allocation invalid?
+ *
+ * Sets or clears the Invalid flag on a file allocation. Its only job — the flag is never a side effect of a line-number or report write.
+ *
+ * @actionType UPDATE - Updates an existing PgFileAllocation record
+ * @module BillingModule
+ * @entity PgFileAllocation
+ * @entityType DEFAULT (Default)
+ * @event k1.t-hEOJjsDb.BillingModule.PgFileAllocation.Update.UpdatePgFileAllocationInvalid
+ * @permission schema.action.updatepgfileallocationinvalid.trigger
+ * @benchmark This action is tracked for performance benchmarks
+ */
+class UpdatePgFileAllocationInvalidDto 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 = 'UpdatePgFileAllocationInvalid';
+        this.schemaActionId = '6497875c-9cae-469b-b2fa-e09488e00d77';
+        this.entity = 'BillingModule:PgFileAllocation';
+    }
+}
+exports.UpdatePgFileAllocationInvalidDto = UpdatePgFileAllocationInvalidDto;
+/** Used by SDK generators to identify action type */
+UpdatePgFileAllocationInvalidDto.ACTION_TYPE = 'UPDATE';
+UpdatePgFileAllocationInvalidDto.ACTION_KEY = 'UpdatePgFileAllocationInvalid';
+UpdatePgFileAllocationInvalidDto.MODULE_NAME = 'BillingModule';
+UpdatePgFileAllocationInvalidDto.ENTITIES = ['PgFileAllocation'];
+UpdatePgFileAllocationInvalidDto.ENTITY_TYPE = 'DEFAULT';
+UpdatePgFileAllocationInvalidDto.EVENT_NAME = 'k1.t-hEOJjsDb.BillingModule.PgFileAllocation.Update.UpdatePgFileAllocationInvalid';
+UpdatePgFileAllocationInvalidDto.PERMISSION = 'schema.action.updatepgfileallocationinvalid.trigger';
+/** Step metadata - entity this action targets */
+UpdatePgFileAllocationInvalidDto.STEP_ENTITY = 'BillingModule:PgFileAllocation';
+UpdatePgFileAllocationInvalidDto.STEP_SCHEMA_ID = '0747b695-c0c0-4d18-b445-40e80ad531b4';
+UpdatePgFileAllocationInvalidDto.STEP_SCHEMA_ACTION_ID = '6497875c-9cae-469b-b2fa-e09488e00d77';
+UpdatePgFileAllocationInvalidDto.STEP_SCHEMA_TYPE_ID = 'aebd372f-1c03-4160-a44a-8930181c21f6';
+UpdatePgFileAllocationInvalidDto.STEP_TYPE = 'DEFAULT';
+UpdatePgFileAllocationInvalidDto.AUTO_LINK_PARENT = false;

package/dist/api-sdk-v2/YfAgentLocationApi.d.ts

@@ -0,0 +1,45 @@
+import { OauthParams } from '@d19n/odin-sdk-generator/dist/odin-sdk-types';
+import { ApiProvider } from '@d19n/odin-sdk-generator/dist/api.provider';
+import { OdinSearchV2, OdinRecordCreateDto, OdinRecordUpdateDto } from '@d19n/odin-types/dist/core';
+import { YfAgentLocationProperties } from '../entities-v2/YfAgentLocation';
+/**
+ * @deprecated Use OdinApiClient.
+ *
+ * Migration:
+ * - Old: new YfAgentLocationApi(authParams).get(id)
+ * - New: new odin.yfagentlocation.get(id)
+ *
+ * The new OdinApiClient returns typed record wrappers with action methods.
+ */
+export declare class YfAgentLocationApi extends ApiProvider {
+    protected readonly authToken?: string;
+    private readonly moduleName;
+    private readonly entityName;
+    private sourceRecord;
+    constructor(authParams?: OauthParams, authToken?: string);
+    setRecord(sourceRecord: any): void;
+    schema(): Promise<import("@d19n/odin-types/dist/core").OdinSchema>;
+    search(params: Partial<OdinSearchV2>): Promise<import("@d19n/odin-sdk-generator/dist/odin-sdk-types").OdinSearchResponse<import("@d19n/odin-types/dist/core").OdinRecord<YfAgentLocationProperties>>>;
+    searchAndPaginate(params: Partial<OdinSearchV2>): Promise<import("@d19n/odin-sdk-generator/dist/odin-sdk-types").OdinSearchResponse<import("@d19n/odin-types/dist/core").OdinRecord<YfAgentLocationProperties>>>;
+    reIndex(body: {
+        id: string;
+        schemaId: string;
+    }[]): Promise<any>;
+    get(yfAgentLocationId: string): Promise<import("@d19n/odin-types/dist/core").OdinRecord<YfAgentLocationProperties>>;
+    getMany(yfAgentLocationIds: string[]): Promise<import("@d19n/odin-types/dist/core").OdinRecord<YfAgentLocationProperties>[]>;
+    upsert(upsertDto: OdinRecordCreateDto): Promise<import("@d19n/odin-sdk-generator/dist/odin-sdk-types").IDbRecordCreateUpdateRes>;
+    upsertMany(upsertDtos: OdinRecordCreateDto[]): Promise<import("@d19n/odin-sdk-generator/dist/odin-sdk-types").IDbRecordCreateUpdateRes[]>;
+    update(updateDto: OdinRecordUpdateDto): Promise<import("@d19n/odin-sdk-generator/dist/odin-sdk-types").IDbRecordCreateUpdateRes>;
+    updateMany(updateDtos: OdinRecordUpdateDto[]): Promise<import("@d19n/odin-sdk-generator/dist/odin-sdk-types").IDbRecordCreateUpdateRes[]>;
+    delete(yfAgentLocationId: string): Promise<import("@d19n/odin-sdk-generator/dist/odin-sdk-types").OdinDeleteResponse[]>;
+    deleteMany(yfAgentLocationIds: string[]): Promise<import("@d19n/odin-sdk-generator/dist/odin-sdk-types").OdinDeleteResponse[]>;
+    restore(yfAgentLocationIds: string[]): Promise<import("@d19n/odin-sdk-generator/dist/odin-sdk-types").OdinRestoreResponse[]>;
+    applyAction(dto: any): Promise<any[]>;
+    bulkApplyActions(dtos: any[]): Promise<any[]>;
+    getVersions(): Promise<{
+        [key: string]: Record<string, any>;
+    }>;
+    getRevisionTimeline(): Promise<{
+        [key: string]: Record<string, any>[];
+    }>;
+}

package/dist/api-sdk-v2/YfAgentLocationApi.js

@@ -0,0 +1,151 @@
+"use strict";
+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.YfAgentLocationApi = void 0;
+const api_provider_1 = require("@d19n/odin-sdk-generator/dist/api.provider");
+/**
+ * @deprecated Use OdinApiClient.
+ *
+ * Migration:
+ * - Old: new YfAgentLocationApi(authParams).get(id)
+ * - New: new odin.yfagentlocation.get(id)
+ *
+ * The new OdinApiClient returns typed record wrappers with action methods.
+ */
+class YfAgentLocationApi extends api_provider_1.ApiProvider {
+    // ============================================
+    // PRIVATE BACKING FIELDS (Lazy Loading)
+    // ============================================
+    constructor(authParams, authToken) {
+        super(authParams, authToken);
+        this.authToken = authToken;
+        this.moduleName = 'FieldServiceModule';
+        this.entityName = 'YfAgentLocation';
+        // Link managers are lazy-loaded on first access
+    }
+    // ============================================
+    // LAZY-LOADED LINK MANAGERS (Public Getters)
+    // ============================================
+    // Usage remains identical: api.address.list(recordId)
+    // ============================================
+    // STANDARD METHODS (Unchanged API)
+    // ============================================
+    setRecord(sourceRecord) {
+        this.sourceRecord = sourceRecord;
+    }
+    schema() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.getSchema(this.moduleName, this.entityName);
+        });
+    }
+    // Use this function when you want to search and handle all pagination on your own
+    search(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._searchRecords(this.moduleName, this.entityName, params);
+        });
+    }
+    // Use this function when you want paginating through the results to be handled
+    searchAndPaginate(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._searchAllRecordsAndPaginate(this.moduleName, this.entityName, params);
+        });
+    }
+    // Use this function to re-index records in elastic search
+    reIndex(body) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._reIndexRecords(body);
+        });
+    }
+    // Use this function when you want to return a single record
+    get(yfAgentLocationId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const res = yield this._getByPrimaryKey(this.moduleName, this.entityName, yfAgentLocationId);
+            if (res)
+                this.setRecord(res);
+            return res;
+        });
+    }
+    // Use this function when you want to return many records by primaryKeys
+    getMany(yfAgentLocationIds) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._getManyByPrimaryKey(this.moduleName, this.entityName, yfAgentLocationIds);
+        });
+    }
+    // Use this function when you want to upsert one record
+    upsert(upsertDto) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const res = yield this._upsert(this.moduleName, this.entityName, [upsertDto]);
+            return res[0];
+        });
+    }
+    // Use this function when you want to upsert many records
+    upsertMany(upsertDtos) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._upsert(this.moduleName, this.entityName, upsertDtos);
+        });
+    }
+    // Use this function when you want to update one record
+    update(updateDto) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const res = yield this._update(this.moduleName, this.entityName, [updateDto]);
+            return res[0];
+        });
+    }
+    // Use this function when you want to update many records
+    updateMany(updateDtos) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._update(this.moduleName, this.entityName, updateDtos);
+        });
+    }
+    // Use this function when you want to delete one record
+    delete(yfAgentLocationId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._delete(this.moduleName, this.entityName, [yfAgentLocationId]);
+        });
+    }
+    // Use this function when you want to delete many records
+    deleteMany(yfAgentLocationIds) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._delete(this.moduleName, this.entityName, yfAgentLocationIds);
+        });
+    }
+    // Use this function when you want to restore one or many records
+    restore(yfAgentLocationIds) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._restore(this.moduleName, this.entityName, yfAgentLocationIds);
+        });
+    }
+    // Use this function when you want to apply a single action
+    applyAction(dto) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._applyAction(this.moduleName, this.entityName, dto);
+        });
+    }
+    // Use this function when you want to bulk apply actions 
+    bulkApplyActions(dtos) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._bulkApplyActions(this.moduleName, this.entityName, dtos);
+        });
+    }
+    // Use this function when you want to return the versions for a single record
+    getVersions() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._getVersions(this.moduleName, this.entityName, this.sourceRecord.id);
+        });
+    }
+    // Use this function when you want to return the change history for a single record
+    getRevisionTimeline() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._getRevisionTimeline(this.moduleName, this.entityName, this.sourceRecord.id);
+        });
+    }
+}
+exports.YfAgentLocationApi = YfAgentLocationApi;

package/dist/db-accessors-v2/YfAgentLocationDbAccessor.d.ts

@@ -0,0 +1,149 @@
+/**
+ * YfAgentLocation DB Accessor
+ *
+ * Provides typed access to YfAgentLocation records via direct database access.
+ * For use in backend services with principal + dbService.
+ * Returns wrapped records with typed action methods.
+ *
+ * @example
+ * ```typescript
+ * // Simple get
+ * const record = await accessor.get(id);
+ *
+ * // With related entities
+ * const record = await accessor.get(id, { entities: ["Contact", "Address"] });
+ *
+ * // With permissions bypass (separate options)
+ * const record = await accessor.get(id, {}, { omitPermissionsCheck: true });
+ *
+ * // Silent write (no RabbitMQ events)
+ * const result = await accessor.upsert([dto], { omitWriteEvents: true });
+ *
+ * // Constructor-level default (applies to all calls)
+ * const accessor = new YfAgentLocationDbAccessor(principal, dbService, { omitPermissionsCheck: true });
+ * ```
+ *
+ * AUTO-GENERATED - DO NOT EDIT DIRECTLY
+ */
+import { OdinSearchV2 } from '@d19n/odin-types/dist/core';
+import { DbProvider, DbProviderOptions, DbGetQueryOptions } from '@d19n/odin-sdk-generator/dist/db.provider';
+import { QueryBuilder } from '@d19n/odin-sdk-generator/dist/query-builder';
+import { YfAgentLocationProperties } from '../entities-v2/YfAgentLocation';
+import { YfAgentLocationRecord } from '../records-v2/YfAgentLocationRecord';
+/** Search response with wrapped records */
+export interface YfAgentLocationDbSearchResponse {
+    records: YfAgentLocationRecord[];
+    totalRecords: number;
+    hasMore: boolean;
+}
+export declare class YfAgentLocationDbAccessor {
+    private readonly _provider;
+    private readonly _moduleName;
+    private readonly _entityName;
+    private readonly _defaultOptions?;
+    /**
+     * Create a new YfAgentLocationDbAccessor
+     * @param principal - The authenticated principal
+     * @param dbService - The database service instance
+     * @param defaultOptions - Default provider options applied to all operations
+     */
+    constructor(principal: any, dbService: any, defaultOptions?: DbProviderOptions);
+    get moduleName(): string;
+    get entityName(): string;
+    /**
+     * Create a new empty YfAgentLocation record instance for create operations.
+     * Pre-generates an ID that can be referenced before the record is saved.
+     *
+     * @param id - Optional ID to use (auto-generated UUID if not provided)
+     * @returns A new record wrapper with pre-generated ID
+     *
+     * @example
+     * ```typescript
+     * // Auto-generated ID
+     * const note = odinDb.notes.new();
+     * console.log(note.id); // UUID available immediately
+     *
+     * // Custom ID
+     * const order = odinDb.orders.new("custom-id-123");
+     *
+     * // Reference ID before save
+     * const account = odinDb.accounts.new();
+     * const contact = odinDb.contacts.new();
+     * await contact
+     *   .link({ id: account.id, entity: "CrmModule:Account" })
+     *   .createContact({ FirstName: "John" });
+     * ```
+     */
+    new(id?: string): YfAgentLocationRecord;
+    /**
+     * Get a single YfAgentLocation record by ID
+     *
+     * @param id - The record ID
+     * @param queryOptions - Query options (WHAT to fetch: entities to include)
+     * @param providerOptions - Provider options (HOW to fetch: omitPermissionsCheck)
+     *
+     * @example
+     * ```typescript
+     * // Simple get
+     * const record = await accessor.get(id);
+     *
+     * // With related entities
+     * const record = await accessor.get(id, { entities: ["Contact", "Address"] });
+     *
+     * // With permissions bypass
+     * const record = await accessor.get(id, {}, { omitPermissionsCheck: true });
+     *
+     * // Both options
+     * const record = await accessor.get(id, { entities: ["Invoice"] }, { omitPermissionsCheck: true });
+     * ```
+     */
+    get(id: string, queryOptions?: DbGetQueryOptions, providerOptions?: DbProviderOptions): Promise<YfAgentLocationRecord>;
+    /**
+     * Get multiple YfAgentLocation records by IDs
+     *
+     * @param ids - Array of record IDs
+     * @param queryOptions - Query options (WHAT to fetch: entities to include)
+     * @param providerOptions - Provider options (HOW to fetch: omitPermissionsCheck)
+     */
+    getMany(ids: string[], queryOptions?: DbGetQueryOptions, providerOptions?: DbProviderOptions): Promise<YfAgentLocationRecord[]>;
+    /**
+     * Search YfAgentLocation records
+     *
+     * @param params - Search parameters
+     * @param providerOptions - Provider options (HOW to fetch: omitPermissionsCheck)
+     */
+    search(params: Partial<OdinSearchV2>, providerOptions?: DbProviderOptions): Promise<YfAgentLocationDbSearchResponse>;
+    /**
+     * Search all YfAgentLocation records with automatic pagination
+     *
+     * @param params - Search parameters
+     * @param providerOptions - Provider options (HOW to fetch: omitPermissionsCheck)
+     */
+    searchAll(params: Partial<OdinSearchV2>, providerOptions?: DbProviderOptions): Promise<YfAgentLocationRecord[]>;
+    /**
+     * Async generator for paginating through all matching records.
+     * Yields batches of wrapped records.
+     *
+     * @param params - Search parameters
+     * @param providerOptions - Provider options (HOW to fetch: omitPermissionsCheck)
+     */
+    paginate(params: Partial<OdinSearchV2>, providerOptions?: DbProviderOptions): AsyncGenerator<YfAgentLocationRecord[]>;
+    /**
+     * Create a fluent query builder for YfAgentLocation records
+     *
+     * @example
+     * ```typescript
+     * const results = await accessor
+     *   .query()
+     *   .where('Status', 'in', ['Active', 'Pending'])
+     *   .where('CreatedAt', 'gte', '2025-01-01')
+     *   .select('id', 'title', 'properties.*')
+     *   .sortBy('createdAt', 'desc')
+     *   .limit(100)
+     *   .execute();
+     * ```
+     */
+    query(): QueryBuilder<YfAgentLocationProperties, YfAgentLocationRecord>;
+    /** Access the underlying DbProvider */
+    get provider(): DbProvider;
+}