@d19n/youfibre-odin-sdk 2.0.247 → 2.0.249

package/dist/records-v2/OutboundDialCampaignRecord.js

@@ -0,0 +1,525 @@
+"use strict";
+/**
+ * OutboundDialCampaign 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.outboundDialCampaigns.new();
+ * await record.createOutboundDialCampaign({ ... }).execute();
+ * ```
+ *
+ * Entity Types: DEFAULT
+ *
+ * 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.isOutboundDialCampaignRecord = exports.OutboundDialCampaignRecord = 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 TeamRecord_1 = require("./TeamRecord");
+const OutboundDialCampaignCaseRecord_1 = require("./OutboundDialCampaignCaseRecord");
+const OutboundDialSessionRecord_1 = require("./OutboundDialSessionRecord");
+const UserRecord_1 = require("./UserRecord");
+const CallRecord_1 = require("./CallRecord");
+/**
+ * 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 OutboundDialCampaignRecord {
+    /**
+     * 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 : 'SupportModule:OutboundDialCampaign'; }
+    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) || []; }
+    /** 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 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 OutboundDialCampaignProperties
+     *   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'; }
+    /**
+     * Access linked Team records
+     * @remarks Available labels: OutboundDialCampaign_Team
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Team records
+     * const items = await record.teams.list();
+     * const first = await record.teams.first();
+     *
+     * // Filter by label
+     * const specific = await record.teams.first({ label: 'OutboundDialCampaign_Team' });
+     * ```
+     */
+    get teams() {
+        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._teams) {
+            this._teams = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'SupportModule:OutboundDialCampaign',
+                targetEntity: 'IdentityModule:Team',
+                targetModuleName: 'IdentityModule',
+                targetEntityName: 'Team',
+                labels: ['OutboundDialCampaign_Team'],
+            }, TeamRecord_1.TeamRecord);
+        }
+        return this._teams;
+    }
+    /**
+     * Access linked OutboundDialCampaignCase records
+     * @remarks Available labels: OutboundDialCampaign__OutboundDialCampaignCase, OutboundDialCampaignCase__OutboundDialCampaign
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked OutboundDialCampaignCase records
+     * const items = await record.outboundDialCampaignCases.list();
+     * const first = await record.outboundDialCampaignCases.first();
+     *
+     * // Filter by label
+     * const specific = await record.outboundDialCampaignCases.first({ label: 'OutboundDialCampaign__OutboundDialCampaignCase' });
+     * ```
+     */
+    get outboundDialCampaignCases() {
+        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._outboundDialCampaignCases) {
+            this._outboundDialCampaignCases = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'SupportModule:OutboundDialCampaign',
+                targetEntity: 'SupportModule:OutboundDialCampaignCase',
+                targetModuleName: 'SupportModule',
+                targetEntityName: 'OutboundDialCampaignCase',
+                labels: ['OutboundDialCampaign__OutboundDialCampaignCase', 'OutboundDialCampaignCase__OutboundDialCampaign'],
+            }, OutboundDialCampaignCaseRecord_1.OutboundDialCampaignCaseRecord);
+        }
+        return this._outboundDialCampaignCases;
+    }
+    /**
+     * Access linked OutboundDialSession records
+     * @remarks Available labels: OutboundDialCampaign__OutboundDialSession, OutboundDialSession__OutboundDialCampaign
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked OutboundDialSession records
+     * const items = await record.outboundDialSessions.list();
+     * const first = await record.outboundDialSessions.first();
+     *
+     * // Filter by label
+     * const specific = await record.outboundDialSessions.first({ label: 'OutboundDialCampaign__OutboundDialSession' });
+     * ```
+     */
+    get outboundDialSessions() {
+        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._outboundDialSessions) {
+            this._outboundDialSessions = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'SupportModule:OutboundDialCampaign',
+                targetEntity: 'SupportModule:OutboundDialSession',
+                targetModuleName: 'SupportModule',
+                targetEntityName: 'OutboundDialSession',
+                labels: ['OutboundDialCampaign__OutboundDialSession', 'OutboundDialSession__OutboundDialCampaign'],
+            }, OutboundDialSessionRecord_1.OutboundDialSessionRecord);
+        }
+        return this._outboundDialSessions;
+    }
+    /**
+     * Access linked User records
+     * @remarks Available labels: OutboundDialCampaign__User
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked User records
+     * const items = await record.users.list();
+     * const first = await record.users.first();
+     *
+     * // Filter by label
+     * const specific = await record.users.first({ label: 'OutboundDialCampaign__User' });
+     * ```
+     */
+    get users() {
+        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._users) {
+            this._users = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'SupportModule:OutboundDialCampaign',
+                targetEntity: 'IdentityModule:User',
+                targetModuleName: 'IdentityModule',
+                targetEntityName: 'User',
+                labels: ['OutboundDialCampaign__User'],
+            }, UserRecord_1.UserRecord);
+        }
+        return this._users;
+    }
+    /**
+     * Access linked Call records
+     * @remarks Available labels: Call__OutboundDialCampaign
+     * @throws Error if called on a new (unsaved) record
+     *
+     * @example
+     * ```typescript
+     * // Get all linked Call records
+     * const items = await record.calls.list();
+     * const first = await record.calls.first();
+     *
+     * // Filter by label
+     * const specific = await record.calls.first({ label: 'Call__OutboundDialCampaign' });
+     * ```
+     */
+    get calls() {
+        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._calls) {
+            this._calls = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
+                sourceEntity: 'SupportModule:OutboundDialCampaign',
+                targetEntity: 'NotificationModule:Call',
+                targetModuleName: 'NotificationModule',
+                targetEntityName: 'Call',
+                labels: ['Call__OutboundDialCampaign'],
+            }, CallRecord_1.CallRecord);
+        }
+        return this._calls;
+    }
+    // ============================================
+    // 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('SupportModule', 'OutboundDialCampaign', this._record.id, targetId);
+        });
+    }
+    // ============================================
+    // CREATE ACTIONS (no existing record required)
+    // ============================================
+    /**
+     * CreateOutboundDialCampaign
+     *
+     * Creates a new OutboundDialCampaign 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.outboundDialCampaigns.new();
+     * await record.createOutboundDialCampaign({ ... }).execute();
+     *
+     * // Dry run (for debugging)
+     * const payload = record.createOutboundDialCampaign({ ... }).dryRun();
+     * ```
+     */
+    createOutboundDialCampaign(properties, options) {
+        const payload = {
+            entity: 'SupportModule:OutboundDialCampaign',
+            type: 'DEFAULT',
+            actionName: 'CreateOutboundDialCampaign',
+            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, 'SupportModule', 'OutboundDialCampaign', payload, () => { this._pendingLinks = []; });
+    }
+    /**
+     * DefaultCreateOutboundDialCampaign
+     *
+     * Creates a new OutboundDialCampaign 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.outboundDialCampaigns.new();
+     * await record.defaultCreateOutboundDialCampaign({ ... }).execute();
+     *
+     * // Dry run (for debugging)
+     * const payload = record.defaultCreateOutboundDialCampaign({ ... }).dryRun();
+     * ```
+     */
+    defaultCreateOutboundDialCampaign(properties, options) {
+        const payload = {
+            entity: 'SupportModule:OutboundDialCampaign',
+            type: 'DEFAULT',
+            actionName: 'DefaultCreateOutboundDialCampaign',
+            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, 'SupportModule', 'OutboundDialCampaign', payload, () => { this._pendingLinks = []; });
+    }
+    // ============================================
+    // UPDATE ACTIONS (require existing record)
+    // ============================================
+    /**
+     * DefaultUpdateOutboundDialCampaign
+     *
+     * Updates this OutboundDialCampaign 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.outboundDialCampaigns.get(id);
+     * await record.defaultUpdateOutboundDialCampaign({ ... }).execute();
+     *
+     * // Dry run (for debugging)
+     * const payload = record.defaultUpdateOutboundDialCampaign({ ... }).dryRun();
+     * ```
+     */
+    defaultUpdateOutboundDialCampaign(propertiesOrOptions, options) {
+        var _a;
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('defaultUpdateOutboundDialCampaign 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: 'DefaultUpdateOutboundDialCampaign', properties, associations: this._pendingLinks.length > 0 ? this._pendingLinks : undefined }, opts);
+        return new ActionBuilder(this._provider, 'SupportModule', 'OutboundDialCampaign', payload, () => { this._pendingLinks = []; });
+    }
+    /**
+     * Updateoutbounddialcampaign
+     *
+     * Updates this OutboundDialCampaign 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.outboundDialCampaigns.get(id);
+     * await record.updateoutbounddialcampaign({ ... }).execute();
+     *
+     * // Dry run (for debugging)
+     * const payload = record.updateoutbounddialcampaign({ ... }).dryRun();
+     * ```
+     */
+    updateoutbounddialcampaign(propertiesOrOptions, options) {
+        var _a;
+        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
+            throw new Error('updateoutbounddialcampaign 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: 'Updateoutbounddialcampaign', properties, associations: this._pendingLinks.length > 0 ? this._pendingLinks : undefined }, opts);
+        return new ActionBuilder(this._provider, 'SupportModule', 'OutboundDialCampaign', payload, () => { this._pendingLinks = []; });
+    }
+}
+exports.OutboundDialCampaignRecord = OutboundDialCampaignRecord;
+// ============================================
+// TYPED LINK ACCESSORS
+// ============================================
+/** Valid labels for Team associations */
+OutboundDialCampaignRecord.teamsLabels = ['OutboundDialCampaign_Team'];
+/** Valid labels for OutboundDialCampaignCase associations */
+OutboundDialCampaignRecord.outboundDialCampaignCasesLabels = ['OutboundDialCampaign__OutboundDialCampaignCase', 'OutboundDialCampaignCase__OutboundDialCampaign'];
+/** Valid labels for OutboundDialSession associations */
+OutboundDialCampaignRecord.outboundDialSessionsLabels = ['OutboundDialCampaign__OutboundDialSession', 'OutboundDialSession__OutboundDialCampaign'];
+/** Valid labels for User associations */
+OutboundDialCampaignRecord.usersLabels = ['OutboundDialCampaign__User'];
+/** Valid labels for Call associations */
+OutboundDialCampaignRecord.callsLabels = ['Call__OutboundDialCampaign'];
+/** Type guard to check if an object is a OutboundDialCampaignRecord */
+function isOutboundDialCampaignRecord(obj) {
+    return obj instanceof OutboundDialCampaignRecord;
+}
+exports.isOutboundDialCampaignRecord = isOutboundDialCampaignRecord;