@d19n/youfibre-odin-sdk 2.0.84 → 2.0.85

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

@@ -768,6 +768,8 @@ export declare class File extends OdinRecord<FileProperties> {
     type: FileEntityTypes;
     schemaId: 'e553681c-76a3-4637-bace-9aae7d9ab7bd';
     properties: FileProperties;
+    /** Linked File records (Appointment__File) */
+    File: OdinLink<LinkedOdinRecord<FileProperties>>;
     /** Linked Appointment records (Appointment__File) */
     Appointment: OdinLink<LinkedOdinRecord<AppointmentProperties>>;
     /** Linked UgExternalAudit records (UgExternalAudit_File) */
@@ -955,6 +957,10 @@ export declare const ROUTING_KEY_FILE_OTDR_CREATED = "SchemaModule.File.OTDR.Sub
 export declare const ROUTING_KEY_FILE_OTDR_UPDATED = "SchemaModule.File.OTDR.SubDbRecordUpdated";
 /** OTDR evidence for L1 and L2 closures deleted */
 export declare const ROUTING_KEY_FILE_OTDR_DELETED = "SchemaModule.File.OTDR.SubDbRecordDeleted";
+/** Event: Appointment__File link created */
+export declare const ROUTING_KEY_LINK_APPOINTMENT_FILE_CREATED = "SchemaModule.File.File.SubDbRecordAssociationCreated";
+/** Event: Appointment__File link deleted */
+export declare const ROUTING_KEY_LINK_APPOINTMENT_FILE_DELETED = "SchemaModule.File.File.SubDbRecordAssociationDeleted";
 /** Event: File__Note link created */
 export declare const ROUTING_KEY_LINK_FILE_NOTE_CREATED = "SchemaModule.File.Note.SubDbRecordAssociationCreated";
 /** Event: File__Note link deleted */

package/dist/entities-v2/File.js

@@ -12,7 +12,7 @@
  * Generated from Odin schema definition
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ROUTING_KEY_LINK_FILE_NOTE_DELETED = exports.ROUTING_KEY_LINK_FILE_NOTE_CREATED = exports.ROUTING_KEY_FILE_OTDR_DELETED = exports.ROUTING_KEY_FILE_OTDR_UPDATED = exports.ROUTING_KEY_FILE_OTDR_CREATED = exports.ROUTING_KEY_FILE_OPENREACH_A55_DELETED = exports.ROUTING_KEY_FILE_OPENREACH_A55_UPDATED = exports.ROUTING_KEY_FILE_OPENREACH_A55_CREATED = exports.ROUTING_KEY_FILE_NA_SOLUTION_EVIDENCE_DELETED = exports.ROUTING_KEY_FILE_NA_SOLUTION_EVIDENCE_UPDATED = exports.ROUTING_KEY_FILE_NA_SOLUTION_EVIDENCE_CREATED = exports.ROUTING_KEY_FILE_NA_PROBLEM_EVIDENCE_DELETED = exports.ROUTING_KEY_FILE_NA_PROBLEM_EVIDENCE_UPDATED = exports.ROUTING_KEY_FILE_NA_PROBLEM_EVIDENCE_CREATED = exports.ROUTING_KEY_FILE_INVOICE_DELETED = exports.ROUTING_KEY_FILE_INVOICE_UPDATED = exports.ROUTING_KEY_FILE_INVOICE_CREATED = exports.ROUTING_KEY_FILE_EMAIL_DELETED = exports.ROUTING_KEY_FILE_EMAIL_UPDATED = exports.ROUTING_KEY_FILE_EMAIL_CREATED = exports.ROUTING_KEY_FILE_DEFAULT_DELETED = exports.ROUTING_KEY_FILE_DEFAULT_UPDATED = exports.ROUTING_KEY_FILE_DEFAULT_CREATED = exports.ROUTING_KEY_FILE_CSV_DELETED = exports.ROUTING_KEY_FILE_CSV_UPDATED = exports.ROUTING_KEY_FILE_CSV_CREATED = exports.ROUTING_KEY_FILE_AFP_INVOICE_DELETED = exports.ROUTING_KEY_FILE_AFP_INVOICE_UPDATED = exports.ROUTING_KEY_FILE_AFP_INVOICE_CREATED = exports.ROUTING_KEY_FILE_DELETED = exports.ROUTING_KEY_FILE_UPDATED = exports.ROUTING_KEY_FILE_CREATED = exports.File = exports.FilePropertyKeys = exports.FileCategory = exports.FileDevice = exports.FileDataStore = exports.FileEntityTypes = void 0;
+exports.ROUTING_KEY_LINK_FILE_NOTE_DELETED = exports.ROUTING_KEY_LINK_FILE_NOTE_CREATED = exports.ROUTING_KEY_LINK_APPOINTMENT_FILE_DELETED = exports.ROUTING_KEY_LINK_APPOINTMENT_FILE_CREATED = exports.ROUTING_KEY_FILE_OTDR_DELETED = exports.ROUTING_KEY_FILE_OTDR_UPDATED = exports.ROUTING_KEY_FILE_OTDR_CREATED = exports.ROUTING_KEY_FILE_OPENREACH_A55_DELETED = exports.ROUTING_KEY_FILE_OPENREACH_A55_UPDATED = exports.ROUTING_KEY_FILE_OPENREACH_A55_CREATED = exports.ROUTING_KEY_FILE_NA_SOLUTION_EVIDENCE_DELETED = exports.ROUTING_KEY_FILE_NA_SOLUTION_EVIDENCE_UPDATED = exports.ROUTING_KEY_FILE_NA_SOLUTION_EVIDENCE_CREATED = exports.ROUTING_KEY_FILE_NA_PROBLEM_EVIDENCE_DELETED = exports.ROUTING_KEY_FILE_NA_PROBLEM_EVIDENCE_UPDATED = exports.ROUTING_KEY_FILE_NA_PROBLEM_EVIDENCE_CREATED = exports.ROUTING_KEY_FILE_INVOICE_DELETED = exports.ROUTING_KEY_FILE_INVOICE_UPDATED = exports.ROUTING_KEY_FILE_INVOICE_CREATED = exports.ROUTING_KEY_FILE_EMAIL_DELETED = exports.ROUTING_KEY_FILE_EMAIL_UPDATED = exports.ROUTING_KEY_FILE_EMAIL_CREATED = exports.ROUTING_KEY_FILE_DEFAULT_DELETED = exports.ROUTING_KEY_FILE_DEFAULT_UPDATED = exports.ROUTING_KEY_FILE_DEFAULT_CREATED = exports.ROUTING_KEY_FILE_CSV_DELETED = exports.ROUTING_KEY_FILE_CSV_UPDATED = exports.ROUTING_KEY_FILE_CSV_CREATED = exports.ROUTING_KEY_FILE_AFP_INVOICE_DELETED = exports.ROUTING_KEY_FILE_AFP_INVOICE_UPDATED = exports.ROUTING_KEY_FILE_AFP_INVOICE_CREATED = exports.ROUTING_KEY_FILE_DELETED = exports.ROUTING_KEY_FILE_UPDATED = exports.ROUTING_KEY_FILE_CREATED = exports.File = exports.FilePropertyKeys = exports.FileCategory = exports.FileDevice = exports.FileDataStore = exports.FileEntityTypes = void 0;
 const core_1 = require("@d19n/odin-types/dist/core");
 /**
  * Available types for File records
@@ -186,6 +186,10 @@ exports.ROUTING_KEY_FILE_OTDR_CREATED = 'SchemaModule.File.OTDR.SubDbRecordCreat
 exports.ROUTING_KEY_FILE_OTDR_UPDATED = 'SchemaModule.File.OTDR.SubDbRecordUpdated';
 /** OTDR evidence for L1 and L2 closures deleted */
 exports.ROUTING_KEY_FILE_OTDR_DELETED = 'SchemaModule.File.OTDR.SubDbRecordDeleted';
+/** Event: Appointment__File link created */
+exports.ROUTING_KEY_LINK_APPOINTMENT_FILE_CREATED = 'SchemaModule.File.File.SubDbRecordAssociationCreated';
+/** Event: Appointment__File link deleted */
+exports.ROUTING_KEY_LINK_APPOINTMENT_FILE_DELETED = 'SchemaModule.File.File.SubDbRecordAssociationDeleted';
 /** Event: File__Note link created */
 exports.ROUTING_KEY_LINK_FILE_NOTE_CREATED = 'SchemaModule.File.Note.SubDbRecordAssociationCreated';
 /** Event: File__Note link deleted */

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

@@ -74,7 +74,9 @@ export declare enum SubmissionPgDirectDebitFileStageNames {
     /** Submission Failed (fail) */
     SubmissionFailed = "Submission Failed",
     /** File Rejected (fail) */
-    FileRejected = "File Rejected"
+    FileRejected = "File Rejected",
+    /** Failed (fail) */
+    Failed = "Failed"
 }
 /**
  * Pipeline stage keys for SUBMISSION PgDirectDebitFile
@@ -96,7 +98,9 @@ export declare enum SubmissionPgDirectDebitFileStageKeys {
     /** Submission Failed */
     SubmissionStatusStageSubmissionFailed = "SubmissionStatusStageSubmissionFailed",
     /** File Rejected */
-    SubmissionStatusStageFileRejected = "SubmissionStatusStageFileRejected"
+    SubmissionStatusStageFileRejected = "SubmissionStatusStageFileRejected",
+    /** Failed */
+    SubmissionStatusStageFailed = "SubmissionStatusStageFailed"
 }
 /**
  * Valid values for PgDirectDebitFile.Company

package/dist/entities-v2/PgDirectDebitFile.js

@@ -80,6 +80,8 @@ var SubmissionPgDirectDebitFileStageNames;
     SubmissionPgDirectDebitFileStageNames["SubmissionFailed"] = "Submission Failed";
     /** File Rejected (fail) */
     SubmissionPgDirectDebitFileStageNames["FileRejected"] = "File Rejected";
+    /** Failed (fail) */
+    SubmissionPgDirectDebitFileStageNames["Failed"] = "Failed";
 })(SubmissionPgDirectDebitFileStageNames = exports.SubmissionPgDirectDebitFileStageNames || (exports.SubmissionPgDirectDebitFileStageNames = {}));
 /**
  * Pipeline stage keys for SUBMISSION PgDirectDebitFile
@@ -103,6 +105,8 @@ var SubmissionPgDirectDebitFileStageKeys;
     SubmissionPgDirectDebitFileStageKeys["SubmissionStatusStageSubmissionFailed"] = "SubmissionStatusStageSubmissionFailed";
     /** File Rejected */
     SubmissionPgDirectDebitFileStageKeys["SubmissionStatusStageFileRejected"] = "SubmissionStatusStageFileRejected";
+    /** Failed */
+    SubmissionPgDirectDebitFileStageKeys["SubmissionStatusStageFailed"] = "SubmissionStatusStageFailed";
 })(SubmissionPgDirectDebitFileStageKeys = exports.SubmissionPgDirectDebitFileStageKeys || (exports.SubmissionPgDirectDebitFileStageKeys = {}));
 /**
  * Valid values for PgDirectDebitFile.Company

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

@@ -0,0 +1,244 @@
+/**
+ * ContactIdentity 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.contactIdentitys.new();
+ * await record.createContactIdentity({ ... }).execute();
+ * ```
+ *
+ * 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 { RecordLinkManager } from '@d19n/odin-sdk-generator/dist/record-link-manager';
+import { ContactIdentityProperties } from '../entities-v2/ContactIdentity';
+import { CreateContactIdentityProperties } from '../actions-v2/CreateContactIdentityDto';
+import { PaymentMethodRecord } from './PaymentMethodRecord';
+import { ContactRecord } from './ContactRecord';
+import { OrderRecord } from './OrderRecord';
+/**
+ * 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 ContactIdentityRecord<TProps = ContactIdentityProperties> {
+    private _record;
+    private _provider;
+    private _pendingLinks;
+    private _preGeneratedId;
+    private _paymentMethods?;
+    private _contactIdentities?;
+    private _contacts?;
+    private _orders?;
+    /**
+     * 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(): string | 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;
+    /** Valid labels for PaymentMethod associations */
+    static readonly paymentMethodsLabels: readonly ["ContactIdentity__PaymentMethod"];
+    /**
+     * Access linked PaymentMethod records
+     * @remarks Available labels: ContactIdentity__PaymentMethod
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked PaymentMethod records
+     * const items = await record.paymentMethods.list();
+     * const first = await record.paymentMethods.first();
+     *
+     * // Filter by label
+     * const specific = await record.paymentMethods.first({ label: 'ContactIdentity__PaymentMethod' });
+     * ```
+     */
+    get paymentMethods(): RecordLinkManager<PaymentMethodRecord, typeof ContactIdentityRecord['paymentMethodsLabels'][number]>;
+    /** Valid labels for ContactIdentity associations */
+    static readonly contactIdentitiesLabels: readonly ["ContactIdentity__ContactIdentity"];
+    /**
+     * Access linked ContactIdentity records
+     * @remarks Available labels: ContactIdentity__ContactIdentity
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked ContactIdentity records
+     * const items = await record.contactIdentities.list();
+     * const first = await record.contactIdentities.first();
+     *
+     * // Filter by label
+     * const specific = await record.contactIdentities.first({ label: 'ContactIdentity__ContactIdentity' });
+     * ```
+     */
+    get contactIdentities(): RecordLinkManager<ContactIdentityRecord, typeof ContactIdentityRecord['contactIdentitiesLabels'][number]>;
+    /** Valid labels for Contact associations */
+    static readonly contactsLabels: readonly ["Contact__ContactIdentity"];
+    /**
+     * Access linked Contact records
+     * @remarks Available labels: Contact__ContactIdentity
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Contact records
+     * const items = await record.contacts.list();
+     * const first = await record.contacts.first();
+     *
+     * // Filter by label
+     * const specific = await record.contacts.first({ label: 'Contact__ContactIdentity' });
+     * ```
+     */
+    get contacts(): RecordLinkManager<ContactRecord, typeof ContactIdentityRecord['contactsLabels'][number]>;
+    /** Valid labels for Order associations */
+    static readonly ordersLabels: readonly ["Order__ContactIdentity"];
+    /**
+     * Access linked Order records
+     * @remarks Available labels: Order__ContactIdentity
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Order records
+     * const items = await record.orders.list();
+     * const first = await record.orders.first();
+     *
+     * // Filter by label
+     * const specific = await record.orders.first({ label: 'Order__ContactIdentity' });
+     * ```
+     */
+    get orders(): RecordLinkManager<OrderRecord, typeof ContactIdentityRecord['ordersLabels'][number]>;
+    /**
+     * 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>;
+    /**
+     * createContactIdentity
+     *
+     * Creates a new ContactIdentity 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.contactIdentitys.new();
+     * await record.createContactIdentity({ ... }).execute();
+     *
+     * // Dry run (for debugging)
+     * const payload = record.createContactIdentity({ ... }).dryRun();
+     * ```
+     */
+    createContactIdentity(properties?: CreateContactIdentityProperties, options?: {
+        type?: string;
+        journeyId?: string;
+        stageKey?: string;
+    }): ActionBuilder;
+}
+/** Type guard to check if an object is a ContactIdentityRecord */
+export declare function isContactIdentityRecord(obj: any): obj is ContactIdentityRecord;
+export {};