@d19n/youfibre-odin-sdk 2.0.342 → 2.0.344

package/dist/records-v2/DocumentRecord.js

@@ -0,0 +1,468 @@
+"use strict";
+/**
+ * Document 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.documents.new();
+ * await record.createDocument({ ... }).execute();
+ * ```
+ *
+ * Entity Types: CONTRACT_BUYOUT, DEFAULT, EMAIL_ATTACHMENT, INVOICE, OTHER, OUTCOME_FORM
+ *
+ * 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.isDocumentRecord = exports.DocumentRecord = void 0;
+const uuid_1 = require("uuid");
+const core_1 = require("@d19n/odin-types/dist/core");
+const record_link_manager_1 = require("@d19n/odin-sdk-generator/dist/record-link-manager");
+const FileRecord_1 = require("./FileRecord");
+const DocumentProcessingRecord_1 = require("./DocumentProcessingRecord");
+const ContractBuyOutRecord_1 = require("./ContractBuyOutRecord");
+/**
+ * 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)
+ */
+class ActionBuilder {
+    constructor(provider, moduleName, entityName, payload, clearPendingLinks) {
+        this._provider = provider;
+        this._moduleName = moduleName;
+        this._entityName = entityName;
+        this._payload = payload;
+        this._clearPendingLinks = clearPendingLinks;
+    }
+    /**
+     * 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, externalAppId) {
+        this._payload.externalId = externalId;
+        this._payload.externalAppId = externalAppId;
+        return 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) {
+        this._payload.groups = groups;
+        return this;
+    }
+    /**
+     * Execute the action
+     * @returns The result from the API
+     */
+    execute() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this._provider._applyAction(this._moduleName, this._entityName, this._payload);
+            this._clearPendingLinks();
+            return result;
+        });
+    }
+    /**
+     * Returns the request payload without executing (for debugging)
+     * @returns The request payload that would be sent to the API
+     */
+    dryRun() {
+        return this._payload;
+    }
+    /**
+     * Prevents accidental `await actionBuilder` without .execute()
+     * Forces developers to explicitly call .execute()
+     * @throws Error always - use .execute() or .dryRun() instead
+     */
+    then() {
+        throw new Error('ActionBuilder cannot be awaited directly. Call .execute() to run the action or .dryRun() to get the payload.');
+    }
+}
+class DocumentRecord {
+    /**
+     * 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, provider, preGeneratedId) {
+        this._pendingLinks = [];
+        this._record = record;
+        this._provider = provider;
+        this._preGeneratedId = preGeneratedId !== null && preGeneratedId !== void 0 ? preGeneratedId : (0, uuid_1.v4)();
+    }
+    // ============================================
+    // CORE PROPERTIES
+    // ============================================
+    /** Returns true if this is a new (unsaved) record */
+    get isNew() { var _a; return !((_a = this._record) === null || _a === void 0 ? void 0 : _a.id); }
+    /** Record ID - always available (pre-generated for new records) */
+    get id() { var _a, _b; return (_b = (_a = this._record) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : this._preGeneratedId; }
+    get entity() { var _a, _b; return (_b = (_a = this._record) === null || _a === void 0 ? void 0 : _a.entity) !== null && _b !== void 0 ? _b : 'AiModule:Document'; }
+    get type() { var _a; return (_a = this._record) === null || _a === void 0 ? void 0 : _a.type; }
+    /** Record properties - empty object for new (unsaved) records */
+    get properties() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.properties) || {}; }
+    get title() { var _a; return (_a = this._record) === null || _a === void 0 ? void 0 : _a.title; }
+    get recordNumber() { var _a; return (_a = this._record) === null || _a === void 0 ? void 0 : _a.recordNumber; }
+    get stage() { var _a; return (_a = this._record) === null || _a === void 0 ? void 0 : _a.stage; }
+    get createdAt() { var _a; return (_a = this._record) === null || _a === void 0 ? void 0 : _a.createdAt; }
+    get updatedAt() { var _a; return (_a = this._record) === null || _a === void 0 ? void 0 : _a.updatedAt; }
+    get externalId() { var _a; return (_a = this._record) === null || _a === void 0 ? void 0 : _a.externalId; }
+    get externalAppId() { var _a; return (_a = this._record) === null || _a === void 0 ? void 0 : _a.externalAppId; }
+    get groups() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.groups) || []; }
+    /** Link metadata - populated only when the read passed withLinks (empty otherwise) */
+    get links() { var _a, _b; return (_b = (_a = this._record) === null || _a === void 0 ? void 0 : _a.links) !== null && _b !== void 0 ? _b : []; }
+    /** Access the underlying OdinRecord (null for new records) */
+    get record() { return this._record; }
+    // ============================================
+    // TYPE GUARDS (with TypeScript type predicates)
+    // ============================================
+    /**
+     * Type guard: check if this record is of type CONTRACT_BUYOUT
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to CONTRACT_BUYOUT-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isContractBuyout()) {
+     *   // TypeScript knows record.properties is ContractBuyoutDocumentProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks A customer's previous-provider final bill sent for a contract buyout (YouFibre orders).
+     */
+    isContractBuyout() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.type) === 'CONTRACT_BUYOUT'; }
+    /**
+     * 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 DocumentProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks This is the default record type
+     */
+    isDefault() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.type) === 'DEFAULT'; }
+    /**
+     * Type guard: check if this record is of type EMAIL_ATTACHMENT
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to EMAIL_ATTACHMENT-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isEmailAttachment()) {
+     *   // TypeScript knows record.properties is EmailAttachmentDocumentProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks A file attached to an inbound or outbound email.
+     */
+    isEmailAttachment() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.type) === 'EMAIL_ATTACHMENT'; }
+    /**
+     * Type guard: check if this record is of type INVOICE
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to INVOICE-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isInvoice()) {
+     *   // TypeScript knows record.properties is InvoiceDocumentProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks An invoice document produced by billing.
+     */
+    isInvoice() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.type) === 'INVOICE'; }
+    /**
+     * Type guard: check if this record is of type OTHER
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to OTHER-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isOther()) {
+     *   // TypeScript knows record.properties is OtherDocumentProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks Any document class not listed yet. Prefer adding a kind.
+     */
+    isOther() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.type) === 'OTHER'; }
+    /**
+     * Type guard: check if this record is of type OUTCOME_FORM
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to OUTCOME_FORM-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isOutcomeForm()) {
+     *   // TypeScript knows record.properties is OutcomeFormDocumentProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks An engineer outcome form with its photos and signatures (Netomnia field service).
+     */
+    isOutcomeForm() { var _a; return ((_a = this._record) === null || _a === void 0 ? void 0 : _a.type) === 'OUTCOME_FORM'; }
+    /**
+     * Access linked File records
+     * @remarks Available labels: Document__File
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked File records
+     * const items = await record.files.list();
+     * const first = await record.files.first();
+     *
+     * // Filter by label
+     * const specific = await record.files.first({ label: 'Document__File' });
+     * ```
+     */
+    get files() {
+        var _a;
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('Cannot access links on a new (unsaved) record');
+        if (!this._files) {
+            this._files = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'AiModule:Document',
+                targetEntity: 'SchemaModule:File',
+                targetModuleName: 'SchemaModule',
+                targetEntityName: 'File',
+                labels: ['Document__File'],
+            }, FileRecord_1.FileRecord);
+        }
+        return this._files;
+    }
+    /**
+     * Access linked DocumentProcessing records
+     * @remarks Available labels: Document__DocumentProcessing
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked DocumentProcessing records
+     * const items = await record.documentProcessings.list();
+     * const first = await record.documentProcessings.first();
+     *
+     * // Filter by label
+     * const specific = await record.documentProcessings.first({ label: 'Document__DocumentProcessing' });
+     * ```
+     */
+    get documentProcessings() {
+        var _a;
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('Cannot access links on a new (unsaved) record');
+        if (!this._documentProcessings) {
+            this._documentProcessings = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'AiModule:Document',
+                targetEntity: 'AiModule:DocumentProcessing',
+                targetModuleName: 'AiModule',
+                targetEntityName: 'DocumentProcessing',
+                labels: ['Document__DocumentProcessing'],
+            }, DocumentProcessingRecord_1.DocumentProcessingRecord);
+        }
+        return this._documentProcessings;
+    }
+    /**
+     * Access linked ContractBuyOut records
+     * @remarks Available labels: ContractBuyOut__Document
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked ContractBuyOut records
+     * const items = await record.contractBuyOuts.list();
+     * const first = await record.contractBuyOuts.first();
+     *
+     * // Filter by label
+     * const specific = await record.contractBuyOuts.first({ label: 'ContractBuyOut__Document' });
+     * ```
+     */
+    get contractBuyOuts() {
+        var _a;
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('Cannot access links on a new (unsaved) record');
+        if (!this._contractBuyOuts) {
+            this._contractBuyOuts = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'AiModule:Document',
+                targetEntity: 'OrderModule:ContractBuyOut',
+                targetModuleName: 'OrderModule',
+                targetEntityName: 'ContractBuyOut',
+                labels: ['ContractBuyOut__Document'],
+            }, ContractBuyOutRecord_1.ContractBuyOutRecord);
+        }
+        return this._contractBuyOuts;
+    }
+    // ============================================
+    // LINK MANAGEMENT
+    // ============================================
+    /**
+     * Queue a link to be created with the next action.
+     * Works for both create and update actions.
+     * @returns this (for chaining)
+     */
+    link(target) {
+        this._pendingLinks.push(new core_1.OdinRecordLinkDto({ id: target.id, entity: target.entity }));
+        return this;
+    }
+    /** Get the currently queued links */
+    get pendingLinks() {
+        return [...this._pendingLinks];
+    }
+    /** Clear pending links without executing an action */
+    clearPendingLinks() {
+        this._pendingLinks = [];
+        return this;
+    }
+    /**
+     * Immediately unlink a record (API call).
+     * Unlike link(), this executes immediately.
+     * @throws Error if called on a new (unsaved) record
+     */
+    unlink(target) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+                throw new Error('Cannot unlink from a new (unsaved) record');
+            const targetId = typeof target === 'string' ? target : target.id;
+            yield this._provider._deleteLinks('AiModule', 'Document', this._record.id, targetId);
+        });
+    }
+    // ============================================
+    // CREATE ACTIONS (no existing record required)
+    // ============================================
+    /**
+     * CreateDocument
+     *
+     * Creates a new Document record with the specified properties.
+     * Returns an ActionBuilder - call .execute() to create or .dryRun() for debugging.
+     *
+     * @remarks Record type: DEFAULT
+     *
+     * @param properties - The properties for the new record
+     * @param options - Optional settings
+     * @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.documents.new();
+     * await record.createDocument({ ... }).execute();
+     *
+     * // Dry run (for debugging)
+     * const payload = record.createDocument({ ... }).dryRun();
+     * ```
+     */
+    createDocument(properties, options) {
+        const payload = {
+            entity: 'AiModule:Document',
+            type: 'DEFAULT',
+            actionName: 'CreateDocument',
+            properties: properties || {},
+            associations: this._pendingLinks.length > 0 ? this._pendingLinks : undefined,
+            journeyId: options === null || options === void 0 ? void 0 : options.journeyId,
+            stageKey: options === null || options === void 0 ? void 0 : options.stageKey,
+        };
+        return new ActionBuilder(this._provider, 'AiModule', 'Document', payload, () => { this._pendingLinks = []; });
+    }
+    // ============================================
+    // UPDATE ACTIONS (require existing record)
+    // ============================================
+    /**
+     * UpdateDocument
+     *
+     * Updates this Document 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.documents.get(id);
+     * await record.updateDocument({ ... }).execute();
+     *
+     * // Dry run (for debugging)
+     * const payload = record.updateDocument({ ... }).dryRun();
+     * ```
+     */
+    updateDocument(propertiesOrOptions, options) {
+        var _a;
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('updateDocument 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: 'UpdateDocument', properties, associations: this._pendingLinks.length > 0 ? this._pendingLinks : undefined }, opts);
+        return new ActionBuilder(this._provider, 'AiModule', 'Document', payload, () => { this._pendingLinks = []; });
+    }
+}
+exports.DocumentRecord = DocumentRecord;
+// ============================================
+// TYPED LINK ACCESSORS
+// ============================================
+/** Valid labels for File associations */
+DocumentRecord.filesLabels = ['Document__File'];
+/** Valid labels for DocumentProcessing associations */
+DocumentRecord.documentProcessingsLabels = ['Document__DocumentProcessing'];
+/** Valid labels for ContractBuyOut associations */
+DocumentRecord.contractBuyOutsLabels = ['ContractBuyOut__Document'];
+/** Type guard to check if an object is a DocumentRecord */
+function isDocumentRecord(obj) {
+    return obj instanceof DocumentRecord;
+}
+exports.isDocumentRecord = isDocumentRecord;

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

@@ -13,7 +13,7 @@
  * await record.createFile({ ... }).execute();
  * ```
  *
- * Entity Types: AFP_INVOICE, CBO_FINAL_BILL, CSV, DEFAULT, EMAIL, INVOICE, NA_PROBLEM_EVIDENCE, NA_SOLUTION_EVIDENCE, OPENREACH_A55, OTDR
+ * Entity Types: AFP_INVOICE, CBO_FINAL_BILL, CSV, DEFAULT, EMAIL, INVOICE, NA_PROBLEM_EVIDENCE, NA_SOLUTION_EVIDENCE, OPENREACH_A55, OTDR, PROCESSING_OUTPUT
  *
  * AUTO-GENERATED - DO NOT EDIT DIRECTLY
  */
@@ -22,7 +22,7 @@ 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 { RecordLinkManager } from '@d19n/odin-sdk-generator/dist/record-link-manager';
-import { FileProperties, AfpInvoiceFileProperties, CboFinalBillFileProperties, CsvFileProperties, EmailFileProperties, InvoiceFileProperties, NaProblemEvidenceFileProperties, NaSolutionEvidenceFileProperties, OpenreachA55FileProperties, OtdrFileProperties } from '../entities-v2/File';
+import { FileProperties, AfpInvoiceFileProperties, CboFinalBillFileProperties, CsvFileProperties, EmailFileProperties, InvoiceFileProperties, NaProblemEvidenceFileProperties, NaSolutionEvidenceFileProperties, OpenreachA55FileProperties, OtdrFileProperties, ProcessingOutputFileProperties } from '../entities-v2/File';
 import { CreateFileProperties } from '../actions-v2/CreateFileDto';
 import { OverlayRealA55Record } from './OverlayRealA55Record';
 import { AppointmentRecord } from './AppointmentRecord';
@@ -64,8 +64,10 @@ import { EmailRecord } from './EmailRecord';
 import { PgDirectDebitFileRecord } from './PgDirectDebitFileRecord';
 import { YfWifiSurveyRecord } from './YfWifiSurveyRecord';
 import { YfFieldVisitOutcomeFormRecord } from './YfFieldVisitOutcomeFormRecord';
+import { DocumentRecord } from './DocumentRecord';
+import { DocumentProcessingRecord } from './DocumentProcessingRecord';
 /** Valid entity types for File */
-export declare type FileType = 'AFP_INVOICE' | 'CBO_FINAL_BILL' | 'CSV' | 'DEFAULT' | 'EMAIL' | 'INVOICE' | 'NA_PROBLEM_EVIDENCE' | 'NA_SOLUTION_EVIDENCE' | 'OPENREACH_A55' | 'OTDR';
+export declare type FileType = 'AFP_INVOICE' | 'CBO_FINAL_BILL' | 'CSV' | 'DEFAULT' | 'EMAIL' | 'INVOICE' | 'NA_PROBLEM_EVIDENCE' | 'NA_SOLUTION_EVIDENCE' | 'OPENREACH_A55' | 'OTDR' | 'PROCESSING_OUTPUT';
 /**
  * Builder for action execution with dryRun support
  *
@@ -169,6 +171,8 @@ export declare class FileRecord<TProps = FileProperties> {
     private _pgDirectDebitFiles?;
     private _yfWifiSurveys?;
     private _yfFieldVisitOutcomeForms?;
+    private _documents?;
+    private _documentProcessings?;
     /**
      * Create a record wrapper.
      * @param record - The underlying record, or null for create operations
@@ -356,6 +360,22 @@ export declare class FileRecord<TProps = FileProperties> {
      * @remarks OTDR evidence for L1 and L2 closures
      */
     isOtdr(): this is FileRecord<OtdrFileProperties>;
+    /**
+     * Type guard: check if this record is of type PROCESSING_OUTPUT
+     *
+     * When this returns true, TypeScript automatically narrows the type,
+     * giving you access to PROCESSING_OUTPUT-specific properties.
+     *
+     * @example
+     * ```typescript
+     * if (record.isProcessingOutput()) {
+     *   // TypeScript knows record.properties is ProcessingOutputFileProperties
+     *   console.log(record.properties.SomeTypeSpecificField);
+     * }
+     * ```
+     * @remarks JSON detail of a document pipeline run, linked to its AiModule:DocumentProcessing row (e.g. per-question verdicts and reasons).
+     */
+    isProcessingOutput(): this is FileRecord<ProcessingOutputFileProperties>;
     /** Valid labels for OverlayRealA55 associations */
     static readonly overlayRealA55sLabels: readonly ["OverlayRealA55_File"];
     /**
@@ -1076,6 +1096,42 @@ export declare class FileRecord<TProps = FileProperties> {
      * ```
      */
     get yfFieldVisitOutcomeForms(): RecordLinkManager<YfFieldVisitOutcomeFormRecord, typeof FileRecord['yfFieldVisitOutcomeFormsLabels'][number]>;
+    /** Valid labels for Document associations */
+    static readonly documentsLabels: readonly ["Document__File"];
+    /**
+     * Access linked Document records
+     * @remarks Available labels: Document__File
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Document records
+     * const items = await record.documents.list();
+     * const first = await record.documents.first();
+     *
+     * // Filter by label
+     * const specific = await record.documents.first({ label: 'Document__File' });
+     * ```
+     */
+    get documents(): RecordLinkManager<DocumentRecord, typeof FileRecord['documentsLabels'][number]>;
+    /** Valid labels for DocumentProcessing associations */
+    static readonly documentProcessingsLabels: readonly ["DocumentProcessing__File"];
+    /**
+     * Access linked DocumentProcessing records
+     * @remarks Available labels: DocumentProcessing__File
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked DocumentProcessing records
+     * const items = await record.documentProcessings.list();
+     * const first = await record.documentProcessings.first();
+     *
+     * // Filter by label
+     * const specific = await record.documentProcessings.first({ label: 'DocumentProcessing__File' });
+     * ```
+     */
+    get documentProcessings(): RecordLinkManager<DocumentProcessingRecord, typeof FileRecord['documentProcessingsLabels'][number]>;
     /**
      * Queue a link to be created with the next action.
      * Works for both create and update actions.