@mj-biz-apps/common-ng 5.55.0 → 5.56.0

package/dist/lib/components/party-field/party-field.component.js

@@ -0,0 +1,351 @@
+import { ChangeDetectionStrategy, ChangeDetectorRef, Component, EventEmitter, Input, Output, ViewChild, inject, } from '@angular/core';
+import { FormsModule } from '@angular/forms';
+import { LogError, Metadata, RunQuery, RunView } from '@memberjunction/core';
+import { EscapeSQLString } from '@memberjunction/global';
+import { BaseFormsModule } from '@memberjunction/ng-base-forms';
+import { MJComboboxComponent } from '@memberjunction/ng-ui-components';
+import { Subject, debounceTime, from, switchMap } from 'rxjs';
+import { PARTY_LOOKUP_QUERIES, PartyLookupParamsFor } from './party-lookup-term';
+import * as i0 from "@angular/core";
+import * as i1 from "@memberjunction/ng-base-forms";
+import * as i2 from "@angular/forms";
+function PartyFieldComponent_Conditional_0_Conditional_1_Template(rf, ctx) { if (rf & 1) {
+    i0.ɵɵelementStart(0, "label", 4);
+    i0.ɵɵtext(1);
+    i0.ɵɵelementEnd();
+} if (rf & 2) {
+    const ctx_r1 = i0.ɵɵnextContext(2);
+    i0.ɵɵadvance();
+    i0.ɵɵtextInterpolate(ctx_r1.Label);
+} }
+function PartyFieldComponent_Conditional_0_ng_template_3_Conditional_3_Template(rf, ctx) { if (rf & 1) {
+    i0.ɵɵelementStart(0, "span", 8);
+    i0.ɵɵtext(1);
+    i0.ɵɵelementEnd();
+} if (rf & 2) {
+    const item_r3 = i0.ɵɵnextContext().$implicit;
+    i0.ɵɵadvance();
+    i0.ɵɵtextInterpolate(item_r3.Detail);
+} }
+function PartyFieldComponent_Conditional_0_ng_template_3_Template(rf, ctx) { if (rf & 1) {
+    i0.ɵɵelementStart(0, "div", 7)(1, "span");
+    i0.ɵɵtext(2);
+    i0.ɵɵelementEnd();
+    i0.ɵɵconditionalCreate(3, PartyFieldComponent_Conditional_0_ng_template_3_Conditional_3_Template, 2, 1, "span", 8);
+    i0.ɵɵelementEnd();
+} if (rf & 2) {
+    const item_r3 = ctx.$implicit;
+    i0.ɵɵadvance(2);
+    i0.ɵɵtextInterpolate(item_r3.Name);
+    i0.ɵɵadvance();
+    i0.ɵɵconditional(item_r3.Detail ? 3 : -1);
+} }
+function PartyFieldComponent_Conditional_0_Conditional_5_Template(rf, ctx) { if (rf & 1) {
+    i0.ɵɵelementStart(0, "div", 6);
+    i0.ɵɵtext(1, "Search failed. Try again.");
+    i0.ɵɵelementEnd();
+} }
+function PartyFieldComponent_Conditional_0_Template(rf, ctx) { if (rf & 1) {
+    const _r1 = i0.ɵɵgetCurrentView();
+    i0.ɵɵelementStart(0, "div", 3);
+    i0.ɵɵlistener("focusout", function PartyFieldComponent_Conditional_0_Template_div_focusout_0_listener() { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r1.OnFocusOut()); });
+    i0.ɵɵconditionalCreate(1, PartyFieldComponent_Conditional_0_Conditional_1_Template, 2, 1, "label", 4);
+    i0.ɵɵelementStart(2, "mj-combobox", 5);
+    i0.ɵɵlistener("FilterChange", function PartyFieldComponent_Conditional_0_Template_mj_combobox_FilterChange_2_listener($event) { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r1.OnFilterChange($event)); })("ValueChange", function PartyFieldComponent_Conditional_0_Template_mj_combobox_ValueChange_2_listener($event) { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r1.OnSelect($event)); });
+    i0.ɵɵtemplate(3, PartyFieldComponent_Conditional_0_ng_template_3_Template, 4, 2, "ng-template", null, 0, i0.ɵɵtemplateRefExtractor);
+    i0.ɵɵelementEnd();
+    i0.ɵɵconditionalCreate(5, PartyFieldComponent_Conditional_0_Conditional_5_Template, 2, 0, "div", 6);
+    i0.ɵɵelementEnd();
+} if (rf & 2) {
+    const ctx_r1 = i0.ɵɵnextContext();
+    i0.ɵɵadvance();
+    i0.ɵɵconditional(ctx_r1.ShowLabel ? 1 : -1);
+    i0.ɵɵadvance();
+    i0.ɵɵproperty("Data", ctx_r1.Options)("ValuePrimitive", true)("Filterable", false)("ngModel", ctx_r1.CurrentID);
+    i0.ɵɵadvance(3);
+    i0.ɵɵconditional(ctx_r1.SearchFailed ? 5 : -1);
+} }
+function PartyFieldComponent_Conditional_1_Template(rf, ctx) { if (rf & 1) {
+    const _r4 = i0.ɵɵgetCurrentView();
+    i0.ɵɵelementStart(0, "mj-form-field", 9);
+    i0.ɵɵlistener("Navigate", function PartyFieldComponent_Conditional_1_Template_mj_form_field_Navigate_0_listener($event) { i0.ɵɵrestoreView(_r4); const ctx_r1 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r1.Navigate.emit($event)); });
+    i0.ɵɵelementEnd();
+} if (rf & 2) {
+    const ctx_r1 = i0.ɵɵnextContext();
+    i0.ɵɵproperty("Record", ctx_r1.Record)("ShowLabel", ctx_r1.ShowLabel)("FieldName", ctx_r1.FieldName)("EditMode", false)("FormContext", ctx_r1.FormContext);
+} }
+const DEBOUNCE_MS = 250;
+/**
+ * `bizapps-party-field` — a Person or Organization foreign key that searches as you type.
+ *
+ * The stock form field lists rows on focus, matches `LIKE '%q%'` on one view column and counts
+ * every full page, which takes seconds on a party file of a million people. This one lists nothing
+ * until two characters are typed, then runs one parameterized query (prefix match on indexed base
+ * columns, TOP 20, no count). People match last name, display name, email or email domain;
+ * organizations match name, legal name or website domain.
+ *
+ * Read mode is the stock `mj-form-field`, so labels, links and navigation stay the platform's.
+ * An app whose foreign key points at a subtype (Sales Contacts, Sales Accounts) passes its own
+ * `QueryName` with the same result contract (ID, Name, Detail; parameters Term, Domain).
+ */
+export class PartyFieldComponent {
+    cdr = inject(ChangeDetectorRef);
+    Record;
+    FieldName;
+    Kind;
+    /** Overrides the Kind's default query; pair with CategoryPath. */
+    QueryName;
+    CategoryPath;
+    EditMode = false;
+    ShowLabel = true;
+    FormContext;
+    /** The shape mj-form-field emits, so handlers written for it keep working. */
+    ValueChange = new EventEmitter();
+    Navigate = new EventEmitter();
+    /** What the dropdown lists: search results, or just the current value when not searching. */
+    Options = [];
+    SearchFailed = false;
+    /** The current value as a one-item list (empty when unset): what the list goes back to. */
+    current = [];
+    terms = new Subject();
+    subscription;
+    combobox;
+    ngOnInit() {
+        this.seedCurrent();
+        this.subscription = this.terms
+            .pipe(debounceTime(DEBOUNCE_MS), switchMap((term) => from(this.optionsFor(term))))
+            .subscribe((options) => {
+            this.SearchFailed = options === null;
+            this.Options = options ?? [];
+            this.cdr.markForCheck();
+        });
+    }
+    /**
+     * Code can change the value after load (Deal's FillContactsFromAccount, a cancelled edit
+     * reverting the record). Re-seed when the record no longer holds the value this field shows.
+     */
+    ngDoCheck() {
+        const shown = this.current[0]?.ID ?? null;
+        if (this.subscription && this.CurrentID?.toLowerCase() !== shown?.toLowerCase()) {
+            this.seedCurrent();
+            this.RefreshComboboxText();
+        }
+    }
+    ngOnDestroy() {
+        this.subscription?.unsubscribe();
+    }
+    get Label() {
+        return this.fieldInfo()?.DisplayNameOrName ?? this.FieldName;
+    }
+    get CurrentID() {
+        const value = this.Record?.Get(this.FieldName);
+        return value ? String(value) : null;
+    }
+    OnFilterChange(text) {
+        this.terms.next(text);
+    }
+    /** Picked (an ID) or cleared (null). */
+    OnSelect(value) {
+        const oldValue = this.Record.Get(this.FieldName);
+        const newValue = value ? String(value) : null;
+        const picked = this.Options.find((option) => option.ID === newValue);
+        this.Record.Set(this.FieldName, newValue);
+        this.current = picked ? [picked] : [];
+        this.Options = this.current;
+        this.ValueChange.emit({ FieldName: this.FieldName, OldValue: oldValue, NewValue: newValue });
+        this.cdr.markForCheck();
+    }
+    /**
+     * Leaving the field mid-search puts the current value back in the list, so the combobox can
+     * show its name rather than a raw ID, and cancels any search still pending.
+     */
+    OnFocusOut() {
+        this.terms.next('');
+        this.Options = this.current;
+        this.cdr.markForCheck();
+    }
+    /** The RunQuery call. Throws on failure; a test seam. */
+    async runSearch(params) {
+        const query = this.QueryName
+            ? { QueryName: this.QueryName, CategoryPath: this.CategoryPath }
+            : PARTY_LOOKUP_QUERIES[this.Kind];
+        const parameters = { Term: params.Term };
+        if (params.Domain) {
+            parameters['Domain'] = params.Domain;
+        }
+        const result = await new RunQuery().RunQuery({ ...query, Parameters: parameters });
+        if (!result.Success) {
+            throw new Error(`${query.QueryName} failed: ${result.ErrorMessage ?? 'unknown error'}`);
+        }
+        return result.Results.map((row) => ({ ID: row.ID, Name: row.Name, Detail: row.Detail ?? null }));
+    }
+    /**
+     * mj-combobox re-reads its text from Data only while the text is empty, so a name that arrives
+     * after the ID was shown has to be pushed: Data first, then the value. A test seam.
+     */
+    RefreshComboboxText() {
+        if (this.combobox) {
+            this.combobox.Data = this.Options;
+            this.combobox.writeValue(this.CurrentID);
+        }
+        this.cdr.markForCheck();
+    }
+    seedCurrent() {
+        this.current = this.currentOption();
+        this.Options = this.current;
+        if (this.needsNameLookup()) {
+            void this.resolveCurrentName();
+        }
+    }
+    /** The options to list, or null when the search failed (logged). */
+    async optionsFor(term) {
+        const params = PartyLookupParamsFor(this.Kind, term);
+        if (!params) {
+            return term ? [] : this.current;
+        }
+        try {
+            return await this.runSearch(params);
+        }
+        catch (error) {
+            LogError(`bizapps-party-field: ${error instanceof Error ? error.message : String(error)}`);
+            return null;
+        }
+    }
+    /**
+     * The current value as an option, named from the record's related-name view column. That
+     * column is empty, or stale, when code set the foreign key after load (Deal's
+     * FillContactsFromAccount); the ID stands in until resolveCurrentName replaces it.
+     */
+    currentOption() {
+        const id = this.CurrentID;
+        if (!id) {
+            return [];
+        }
+        const name = this.needsNameLookup() ? null : this.recordName();
+        return [{ ID: id, Name: name ?? id, Detail: null }];
+    }
+    recordName() {
+        const nameField = this.fieldInfo()?.RelatedEntityNameFieldMap;
+        const name = nameField ? this.Record.Get(nameField) : null;
+        return name ? String(name) : null;
+    }
+    needsNameLookup() {
+        if (!this.CurrentID) {
+            return false;
+        }
+        return !this.recordName() || this.Record.GetFieldByName(this.FieldName)?.Dirty === true;
+    }
+    /** One read of the related record's name field. A failure is logged and the ID stays as the label. */
+    async resolveCurrentName() {
+        const id = this.CurrentID;
+        const field = this.fieldInfo();
+        const nameField = field ? Metadata.Provider.EntityByName(field.RelatedEntity)?.NameField?.Name : undefined;
+        if (!id || !field || !nameField) {
+            return;
+        }
+        const result = await RunView.FromMetadataProvider(Metadata.Provider).RunView({
+            EntityName: field.RelatedEntity,
+            ExtraFilter: `${field.RelatedEntityFieldName}='${EscapeSQLString(id)}'`,
+            Fields: [field.RelatedEntityFieldName, nameField],
+            ResultType: 'simple',
+            MaxRows: 1,
+        });
+        const name = result.Success ? result.Results[0]?.[nameField] : null;
+        if (!result.Success) {
+            LogError(`bizapps-party-field: could not read the name of ${field.RelatedEntity} ${id}: ${result.ErrorMessage}`);
+        }
+        if (name && this.CurrentID === id) {
+            this.current = [{ ID: id, Name: String(name), Detail: null }];
+            this.Options = this.current;
+            this.RefreshComboboxText();
+        }
+    }
+    fieldInfo() {
+        return this.Record?.EntityInfo?.Fields.find((field) => field.Name === this.FieldName);
+    }
+    static ɵfac = function PartyFieldComponent_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || PartyFieldComponent)(); };
+    static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: PartyFieldComponent, selectors: [["bizapps-party-field"]], viewQuery: function PartyFieldComponent_Query(rf, ctx) { if (rf & 1) {
+            i0.ɵɵviewQuery(MJComboboxComponent, 5);
+        } if (rf & 2) {
+            let _t;
+            i0.ɵɵqueryRefresh(_t = i0.ɵɵloadQuery()) && (ctx.combobox = _t.first);
+        } }, inputs: { Record: "Record", FieldName: "FieldName", Kind: "Kind", QueryName: "QueryName", CategoryPath: "CategoryPath", EditMode: "EditMode", ShowLabel: "ShowLabel", FormContext: "FormContext" }, outputs: { ValueChange: "ValueChange", Navigate: "Navigate" }, decls: 2, vars: 1, consts: [["mjComboboxItem", ""], [1, "bizapps-party-field"], ["Type", "textbox", "LinkType", "Record", 3, "Record", "ShowLabel", "FieldName", "EditMode", "FormContext"], [1, "bizapps-party-field", 3, "focusout"], [1, "bizapps-party-field-label"], ["TextField", "Name", "ValueField", "ID", "Placeholder", "Type 2+ characters to search", 3, "FilterChange", "ValueChange", "Data", "ValuePrimitive", "Filterable", "ngModel"], [1, "bizapps-party-field-hint"], [1, "bizapps-party-option"], [1, "bizapps-party-option-detail"], ["Type", "textbox", "LinkType", "Record", 3, "Navigate", "Record", "ShowLabel", "FieldName", "EditMode", "FormContext"]], template: function PartyFieldComponent_Template(rf, ctx) { if (rf & 1) {
+            i0.ɵɵconditionalCreate(0, PartyFieldComponent_Conditional_0_Template, 6, 6, "div", 1)(1, PartyFieldComponent_Conditional_1_Template, 1, 5, "mj-form-field", 2);
+        } if (rf & 2) {
+            i0.ɵɵconditional(ctx.EditMode ? 0 : 1);
+        } }, dependencies: [BaseFormsModule, i1.MjFormFieldComponent, MJComboboxComponent, FormsModule, i2.NgControlStatus, i2.NgModel], styles: [".bizapps-party-field[_ngcontent-%COMP%] {\n                display: flex;\n                flex-direction: column;\n                gap: var(--mj-space-1);\n            }\n            .bizapps-party-field-label[_ngcontent-%COMP%] {\n                font-size: var(--mj-text-sm);\n                font-weight: var(--mj-font-medium);\n                color: var(--mj-text-secondary);\n            }\n            .bizapps-party-option[_ngcontent-%COMP%] {\n                display: flex;\n                flex-direction: column;\n                min-width: 0;\n            }\n            .bizapps-party-option-detail[_ngcontent-%COMP%] {\n                font-size: var(--mj-text-xs);\n                color: var(--mj-text-muted);\n            }\n            .bizapps-party-field-hint[_ngcontent-%COMP%] {\n                font-size: var(--mj-text-xs);\n                color: var(--mj-status-error);\n            }"], changeDetection: 0 });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(PartyFieldComponent, [{
+        type: Component,
+        args: [{ selector: 'bizapps-party-field', standalone: true, imports: [BaseFormsModule, MJComboboxComponent, FormsModule], changeDetection: ChangeDetectionStrategy.OnPush, template: `
+        @if (EditMode) {
+            <div class="bizapps-party-field" (focusout)="OnFocusOut()">
+                @if (ShowLabel) {
+                    <label class="bizapps-party-field-label">{{ Label }}</label>
+                }
+                <mj-combobox
+                    [Data]="Options"
+                    TextField="Name"
+                    ValueField="ID"
+                    [ValuePrimitive]="true"
+                    [Filterable]="false"
+                    Placeholder="Type 2+ characters to search"
+                    [ngModel]="CurrentID"
+                    (FilterChange)="OnFilterChange($event)"
+                    (ValueChange)="OnSelect($event)"
+                >
+                    <ng-template #mjComboboxItem let-item>
+                        <div class="bizapps-party-option">
+                            <span>{{ item.Name }}</span>
+                            @if (item.Detail) {
+                                <span class="bizapps-party-option-detail">{{ item.Detail }}</span>
+                            }
+                        </div>
+                    </ng-template>
+                </mj-combobox>
+                @if (SearchFailed) {
+                    <div class="bizapps-party-field-hint">Search failed. Try again.</div>
+                }
+            </div>
+        } @else {
+            <mj-form-field
+                [Record]="Record"
+                [ShowLabel]="ShowLabel"
+                [FieldName]="FieldName"
+                Type="textbox"
+                LinkType="Record"
+                [EditMode]="false"
+                [FormContext]="FormContext"
+                (Navigate)="Navigate.emit($event)"
+            ></mj-form-field>
+        }
+    `, styles: ["\n            .bizapps-party-field {\n                display: flex;\n                flex-direction: column;\n                gap: var(--mj-space-1);\n            }\n            .bizapps-party-field-label {\n                font-size: var(--mj-text-sm);\n                font-weight: var(--mj-font-medium);\n                color: var(--mj-text-secondary);\n            }\n            .bizapps-party-option {\n                display: flex;\n                flex-direction: column;\n                min-width: 0;\n            }\n            .bizapps-party-option-detail {\n                font-size: var(--mj-text-xs);\n                color: var(--mj-text-muted);\n            }\n            .bizapps-party-field-hint {\n                font-size: var(--mj-text-xs);\n                color: var(--mj-status-error);\n            }\n        "] }]
+    }], null, { Record: [{
+            type: Input,
+            args: [{ required: true }]
+        }], FieldName: [{
+            type: Input,
+            args: [{ required: true }]
+        }], Kind: [{
+            type: Input,
+            args: [{ required: true }]
+        }], QueryName: [{
+            type: Input
+        }], CategoryPath: [{
+            type: Input
+        }], EditMode: [{
+            type: Input
+        }], ShowLabel: [{
+            type: Input
+        }], FormContext: [{
+            type: Input
+        }], ValueChange: [{
+            type: Output
+        }], Navigate: [{
+            type: Output
+        }], combobox: [{
+            type: ViewChild,
+            args: [MJComboboxComponent]
+        }] }); })();
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(PartyFieldComponent, { className: "PartyFieldComponent", filePath: "lib/components/party-field/party-field.component.ts", lineNumber: 121 }); })();
+//# sourceMappingURL=party-field.component.js.map

package/dist/lib/components/party-field/party-field.component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"party-field.component.js","sourceRoot":"","sources":["../../../../src/lib/components/party-field/party-field.component.ts"],"names":[],"mappings":"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"}

package/dist/lib/components/party-field/party-lookup-term.d.ts

@@ -0,0 +1,21 @@
+export type PartyKind = 'Person' | 'Organization';
+/** Template parameters of every party lookup query. `Domain` is omitted from the call when null. */
+export interface PartyLookupParams {
+    Term: string;
+    Domain: string | null;
+}
+/**
+ * The query each kind searches by default. An app that stores a subtype ID (Sales Contacts,
+ * Sales Accounts) passes its own query honouring the same contract: columns ID, Name, Detail;
+ * parameters Term and Domain.
+ */
+export declare const PARTY_LOOKUP_QUERIES: Record<PartyKind, {
+    QueryName: string;
+    CategoryPath: string;
+}>;
+/**
+ * What to search for, or null under two non-blank characters (the picker then shows nothing and
+ * sends nothing). No escaping here: the query's `sqlLikeBegins` filter escapes.
+ */
+export declare function PartyLookupParamsFor(kind: PartyKind, raw: string): PartyLookupParams | null;
+//# sourceMappingURL=party-lookup-term.d.ts.map

package/dist/lib/components/party-field/party-lookup-term.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"party-lookup-term.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/party-field/party-lookup-term.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,cAAc,CAAC;AAElD,oGAAoG;AACpG,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,SAAS,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAG/F,CAAC;AAIF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAO3F"}

package/dist/lib/components/party-field/party-lookup-term.js

@@ -0,0 +1,42 @@
+/**
+ * The query each kind searches by default. An app that stores a subtype ID (Sales Contacts,
+ * Sales Accounts) passes its own query honouring the same contract: columns ID, Name, Detail;
+ * parameters Term and Domain.
+ */
+export const PARTY_LOOKUP_QUERIES = {
+    Person: { QueryName: 'Common: Party Lookup People', CategoryPath: 'Common' },
+    Organization: { QueryName: 'Common: Party Lookup Organizations', CategoryPath: 'Common' },
+};
+const MIN_TERM_LENGTH = 2;
+/**
+ * What to search for, or null under two non-blank characters (the picker then shows nothing and
+ * sends nothing). No escaping here: the query's `sqlLikeBegins` filter escapes.
+ */
+export function PartyLookupParamsFor(kind, raw) {
+    const term = raw.trim();
+    if (!longEnough(term)) {
+        return null;
+    }
+    const domain = kind === 'Person' ? emailDomainOf(term) : websiteDomainOf(term);
+    return { Term: term, Domain: domain && longEnough(domain) ? domain : null };
+}
+/** `%` does not count: sqlLikeBegins strips boundary wildcards, so "%%" would match every row. */
+function longEnough(text) {
+    return text.replace(/%/g, '').length >= MIN_TERM_LENGTH;
+}
+/** `@aqha.com` → `aqha.com`. Only a term that looks like part of an address gets a domain. */
+function emailDomainOf(term) {
+    if (!term.includes('@') && !term.includes('.')) {
+        return null;
+    }
+    return term.replace(/^@/, '').toLowerCase();
+}
+/** Same steps as the Organization.WebsiteDomain column: lower-case, drop scheme and `www.`, cut at `/`. */
+function websiteDomainOf(term) {
+    if (!term.includes('.')) {
+        return null;
+    }
+    const host = term.toLowerCase().replace(/^https?:\/\//, '').replace(/^www\./, '');
+    return host.split('/')[0];
+}
+//# sourceMappingURL=party-lookup-term.js.map

package/dist/lib/components/party-field/party-lookup-term.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"party-lookup-term.js","sourceRoot":"","sources":["../../../../src/lib/components/party-field/party-lookup-term.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAmE;IAChG,MAAM,EAAE,EAAE,SAAS,EAAE,6BAA6B,EAAE,YAAY,EAAE,QAAQ,EAAE;IAC5E,YAAY,EAAE,EAAE,SAAS,EAAE,oCAAoC,EAAE,YAAY,EAAE,QAAQ,EAAE;CAC5F,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAe,EAAE,GAAW;IAC7D,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACxB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC/E,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAChF,CAAC;AAED,kGAAkG;AAClG,SAAS,UAAU,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,eAAe,CAAC;AAC5D,CAAC;AAED,8FAA8F;AAC9F,SAAS,aAAa,CAAC,IAAY;IAC/B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAChD,CAAC;AAED,2GAA2G;AAC3G,SAAS,eAAe,CAAC,IAAY;IACjC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAClF,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9B,CAAC"}