@d19n/youfibre-odin-sdk 2.0.39 → 2.0.41

package/dist/records-v2/PhoneNumberRecord.js

@@ -1,292 +0,0 @@
-"use strict";
-/**
- * PhoneNumber 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.phoneNumbers.new();
- * await record.createPhoneNumber({ ... }).execute();
- * ```
- *
- * 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.isPhoneNumberRecord = exports.PhoneNumberRecord = 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 OrderRecord_1 = require("./OrderRecord");
-const ContactRecord_1 = require("./ContactRecord");
-/**
- * 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 PhoneNumberRecord {
-    /**
-     * 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 : 'CrmModule:PhoneNumber'; }
-    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; }
-    /**
-     * Access linked Order records
-     * @remarks Available labels: Order__PhoneNumber
-     * @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__PhoneNumber' });
-     * ```
-     */
-    get orders() {
-        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._orders) {
-            this._orders = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
-                sourceEntity: 'CrmModule:PhoneNumber',
-                targetEntity: 'OrderModule:Order',
-                targetModuleName: 'OrderModule',
-                targetEntityName: 'Order',
-                labels: ['Order__PhoneNumber'],
-            }, OrderRecord_1.OrderRecord);
-        }
-        return this._orders;
-    }
-    /**
-     * Access linked Contact records
-     * @remarks Available labels: Contact__PhoneNumber
-     * @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__PhoneNumber' });
-     * ```
-     */
-    get contacts() {
-        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._contacts) {
-            this._contacts = new record_link_manager_1.RecordLinkManager(this._provider, this._record, {
-                sourceEntity: 'CrmModule:PhoneNumber',
-                targetEntity: 'CrmModule:Contact',
-                targetModuleName: 'CrmModule',
-                targetEntityName: 'Contact',
-                labels: ['Contact__PhoneNumber'],
-            }, ContactRecord_1.ContactRecord);
-        }
-        return this._contacts;
-    }
-    // ============================================
-    // 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('CrmModule', 'PhoneNumber', this._record.id, targetId);
-        });
-    }
-    // ============================================
-    // CREATE ACTIONS (no existing record required)
-    // ============================================
-    /**
-     * CreatePhoneNumberFromBrsk
-     *
-     * Creates a new PhoneNumber 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.phoneNumbers.new();
-     * await record.createPhoneNumberFromBrsk({ ... }).execute();
-     *
-     * // Dry run (for debugging)
-     * const payload = record.createPhoneNumberFromBrsk({ ... }).dryRun();
-     * ```
-     */
-    createPhoneNumberFromBrsk(properties, options) {
-        var _a, _b;
-        const payload = {
-            entity: 'CrmModule:PhoneNumber',
-            type: (_a = options === null || options === void 0 ? void 0 : options.type) !== null && _a !== void 0 ? _a : (_b = this._record) === null || _b === void 0 ? void 0 : _b.type,
-            actionName: 'CreatePhoneNumberFromBrsk',
-            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, 'CrmModule', 'PhoneNumber', payload, () => { this._pendingLinks = []; });
-    }
-}
-exports.PhoneNumberRecord = PhoneNumberRecord;
-// ============================================
-// TYPED LINK ACCESSORS
-// ============================================
-/** Valid labels for Order associations */
-PhoneNumberRecord.ordersLabels = ['Order__PhoneNumber'];
-/** Valid labels for Contact associations */
-PhoneNumberRecord.contactsLabels = ['Contact__PhoneNumber'];
-/** Type guard to check if an object is a PhoneNumberRecord */
-function isPhoneNumberRecord(obj) {
-    return obj instanceof PhoneNumberRecord;
-}
-exports.isPhoneNumberRecord = isPhoneNumberRecord;