@mj-biz-apps/common-ng 5.43.0 → 5.45.0

package/dist/lib/components/related-chips/related-links.d.ts

@@ -0,0 +1,151 @@
+import type { RecordNavigationEvent } from '@memberjunction/ng-base-forms';
+/**
+ * One relationship a record header offers to follow.
+ *
+ * Give it either a {@link RecordID} (the ordinary case — this record holds the id) or a
+ * {@link Filter} (the reverse case — the other record holds the id, as with an Order whose Deal
+ * points at it). A link with neither names nothing and is dropped.
+ */
+export interface BizAppsRelatedLink {
+    /** Stable identity, used to track the chip and to correlate it back to the caller's own model. */
+    Key: string;
+    /**
+     * Entity that owns the linked record, as a name — e.g. `'MJ_BizApps_Orders: Order Headers'`.
+     *
+     * An entity that is not in the catalog produces NO chip. That covers both "the app that owns
+     * this record is not installed here" and "this user may not read it", and the two are
+     * deliberately one outcome: the entity catalog is already permission-filtered, and a reader who
+     * cannot open the record is no better served by a chip than one whose host never had the app.
+     * `bizapps-sales`' `OrdersIsInstalled()` draws the same line for the same reason.
+     */
+    EntityName: string;
+    /** Forward link: the linked record's primary key value, as held on the record being displayed. */
+    RecordID?: string | null;
+    /**
+     * Reverse link: a filter that selects the linked record. The first row wins, so pass something
+     * that identifies one record. Composed by the caller, which is the only party that knows the
+     * other entity's column names.
+     */
+    Filter?: string;
+    /** Names the relationship outright. Wins over {@link LabelPrefix}. */
+    Label?: string;
+    /**
+     * Builds the label as `<prefix> <entity's singular name>` — "Source Deal", "Source Order".
+     *
+     * For a polymorphic link, where the caller knows the ROLE the other record plays but not which
+     * entity fills it until the id is resolved. Hardcoding "Deal" is what this avoids.
+     */
+    LabelPrefix?: string;
+    /** Font Awesome class for a small leading icon. Optional. */
+    Icon?: string;
+}
+/** The part of `EntityInfo` a link needs. `EntityInfo` satisfies this. */
+export interface RelatedLinkEntity {
+    Name: string;
+    BaseTableDisplayName: string;
+    NameField: {
+        Name: string;
+    } | null;
+    PrimaryKeys: {
+        Name: string;
+    }[];
+}
+/** The part of `RunViewResult` a link needs. `RunViewResult<Record<string, unknown>>` satisfies this. */
+export interface RelatedLinkReadResult {
+    Success: boolean;
+    Results?: Record<string, unknown>[];
+}
+/** Reads one row for a link. The component supplies a provider-scoped `RunView`. */
+export type RelatedLinkReader = (params: {
+    EntityName: string;
+    Fields: string[];
+    ExtraFilter: string;
+    MaxRows: number;
+}) => Promise<RelatedLinkReadResult>;
+/** A link that resolved to something openable. Anything that did not resolve is absent, not blank. */
+export interface ResolvedRelatedChip {
+    Key: string;
+    /** What the relationship is: "Source Deal", "Order". */
+    Label: string;
+    /** The linked record's name. Empty ONLY when the record exists but could not be read — see below. */
+    Name: string;
+    Icon: string | null;
+    EntityName: string;
+    PrimaryKeyField: string;
+    RecordID: string;
+    /** Accessible name for the chip's button, composed once here so the template stays declarative. */
+    AriaLabel: string;
+}
+/**
+ * The filter that selects the linked record, or `null` when the link names nothing to select.
+ *
+ * A `RecordID` is preferred over a `Filter` when both are given: the caller holding the id is the
+ * more direct statement of the same fact.
+ */
+export declare function FilterForRelatedLink(link: BizAppsRelatedLink, entity: RelatedLinkEntity): string | null;
+/** The entity's primary key column, defaulting to `ID` as every other link in these apps does. */
+export declare function PrimaryKeyFieldFor(entity: RelatedLinkEntity): string;
+/**
+ * The chip's label: what the caller called it, else `<prefix> <entity>`, else the entity's own name.
+ *
+ * `BaseTableDisplayName` rather than `DisplayName` because a chip labels ONE record and the entity
+ * name is plural — it is what turns a Deals link into "Source Deal" without guessing at plurals.
+ */
+export declare function LabelForRelatedLink(link: BizAppsRelatedLink, entity: RelatedLinkEntity): string;
+/**
+ * Resolve one link to a chip, or to `null` for "show nothing".
+ *
+ * ## The two rules this function exists to hold
+ *
+ * **A CHIP NEVER SHOWS A RAW ID.** The whole point of the row is that a reader recognises what they
+ * are about to open. So the name is read from the entity's own name field, and an entity with no
+ * name field produces no chip rather than a GUID wearing a label.
+ *
+ * **A CHIP THAT CANNOT NAVIGATE IS NOT RENDERED.** A link that goes nowhere is worse than an absent
+ * one: it invites a click and spends the reader's trust. Five ways a link produces nothing — the
+ * entity is not in the catalog, the entity has no name field, the link names neither a record nor a
+ * filter, the read succeeded while matching zero rows, and the read was refused.
+ *
+ * ## Why a read that THREW is treated differently from one that FAILED or found nothing
+ *
+ * Three different facts, and the line between them is whether the server answered.
+ *
+ * **Zero rows from a successful read** means the record is not there — `bizapps-contracts` hit
+ * exactly this with CTR-000026, whose hand-typed provenance pair names a row that does not exist,
+ * and whose header rendered an "Open" button that navigated nowhere. No chip.
+ *
+ * **`Success: false`** is the server answering and refusing. In MJ that is the channel for a
+ * permission denial as much as for a bad filter: `GraphQLDataProvider.InternalRunView` throws when
+ * the transport fails and returns `Success: false` with an `ErrorMessage` when the request reached
+ * the server and was turned down. A reader who may not read Orders would otherwise get an
+ * "Order · Open" chip that navigates to a record that will not open — the dead link this component
+ * exists to prevent. So a refusal produces NO chip.
+ *
+ * **A thrown read** means we do not know: the record may well exist and simply be unreachable this
+ * moment. So a throw keeps the chip when we already hold the id to open — labelled, with "Open"
+ * where the name would go — and drops it for a reverse link, where the throw also cost us the id.
+ */
+export declare function ResolveRelatedChip(link: BizAppsRelatedLink, entities: RelatedLinkEntity[], read: RelatedLinkReader): Promise<ResolvedRelatedChip | null>;
+/** The part of a `MouseEvent` that decides where a chip opens. `MouseEvent` satisfies this. */
+export interface RelatedChipClick {
+    ctrlKey: boolean;
+    metaKey: boolean;
+}
+/**
+ * The navigation event a chip click produces.
+ *
+ * Ctrl (Windows/Linux) and Cmd (macOS) both mean "new tab", which is the idiom MJ uses everywhere a
+ * record link is clicked.
+ *
+ * `OpenInNewTab` is OMITTED rather than set to `false` on a plain click, and that is the whole of
+ * what makes shift-click work. `NavigationService.shouldForceNewTab` returns `options.forceNewTab`
+ * whenever it is `!== undefined` and only otherwise consults its global shift-key state, and
+ * Explorer passes `forceNewTab: event.OpenInNewTab` straight through. An explicit `false` therefore
+ * does not mean "no opinion" — it means "same tab", and it suppresses the shift detection outright.
+ *
+ * `CompositeKey.FromKeyValuePair` rather than `FromID`: the latter assumes the target's primary key
+ * is literally called `ID`, which is true of these apps today and is not a thing a shared component
+ * gets to assume.
+ */
+export declare function RelatedChipNavigation(chip: ResolvedRelatedChip, event: RelatedChipClick): RecordNavigationEvent;
+//# sourceMappingURL=related-links.d.ts.map

package/dist/lib/components/related-chips/related-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"related-links.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/related-chips/related-links.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IAC/B,kGAAkG;IAClG,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;;OAQG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnC;AAED,yGAAyG;AACzG,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACvC;AAED,oFAAoF;AACpF,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACnB,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAErC,sGAAsG;AACtG,MAAM,WAAW,mBAAmB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,qGAAqG;IACrG,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,mGAAmG;IACnG,SAAS,EAAE,MAAM,CAAC;CACrB;AAYD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAKvG;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAQ/F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,kBAAkB,CACpC,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,IAAI,EAAE,iBAAiB,GACxB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA4CrC;AAmCD,+FAA+F;AAC/F,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,gBAAgB,GAAG,qBAAqB,CAU/G"}

package/dist/lib/components/related-chips/related-links.js

@@ -0,0 +1,178 @@
+/**
+ * @fileoverview The resolve-and-hide rules behind `bizapps-related-chips`, kept out of the component.
+ *
+ * WHY THIS IS NOT IN THE COMPONENT. Everything here is a decision about whether a chip may be shown
+ * at all — "is the app installed", "does the record still exist", "did the read fail or did it
+ * succeed and find nothing" — and those are exactly the things that must be pinned by tests. A rule
+ * declared inside an Angular component cannot be exercised without standing up DI, which this
+ * package's node-environment vitest setup deliberately does not do. Same split as
+ * `bizapps-contracts`' `source-record-candidates.ts`.
+ *
+ * The dependencies below are narrowed to the shape each function actually reads rather than taking
+ * `IMetadataProvider` / `RunView`. `EntityInfo[]` and `RunViewResult` satisfy them structurally, so
+ * the component passes the real objects while a test passes a literal.
+ *
+ * @module @mj-biz-apps/common-ng
+ */
+import { CompositeKey } from '@memberjunction/core';
+/** Single-quote escaping for a value going into an `ExtraFilter`. */
+function quote(value) {
+    return value.replace(/'/g, "''");
+}
+/** `true` for a value that actually names a record — not null, not undefined, not blank. */
+function isPresent(value) {
+    return value !== null && value !== undefined && String(value).trim().length > 0;
+}
+/**
+ * The filter that selects the linked record, or `null` when the link names nothing to select.
+ *
+ * A `RecordID` is preferred over a `Filter` when both are given: the caller holding the id is the
+ * more direct statement of the same fact.
+ */
+export function FilterForRelatedLink(link, entity) {
+    if (isPresent(link.RecordID)) {
+        return `${PrimaryKeyFieldFor(entity)} = '${quote(String(link.RecordID).trim())}'`;
+    }
+    return isPresent(link.Filter) ? link.Filter.trim() : null;
+}
+/** The entity's primary key column, defaulting to `ID` as every other link in these apps does. */
+export function PrimaryKeyFieldFor(entity) {
+    return entity.PrimaryKeys?.[0]?.Name ?? 'ID';
+}
+/**
+ * The chip's label: what the caller called it, else `<prefix> <entity>`, else the entity's own name.
+ *
+ * `BaseTableDisplayName` rather than `DisplayName` because a chip labels ONE record and the entity
+ * name is plural — it is what turns a Deals link into "Source Deal" without guessing at plurals.
+ */
+export function LabelForRelatedLink(link, entity) {
+    if (isPresent(link.Label)) {
+        return link.Label.trim();
+    }
+    if (isPresent(link.LabelPrefix)) {
+        return `${link.LabelPrefix.trim()} ${entity.BaseTableDisplayName}`;
+    }
+    return entity.BaseTableDisplayName;
+}
+/**
+ * Resolve one link to a chip, or to `null` for "show nothing".
+ *
+ * ## The two rules this function exists to hold
+ *
+ * **A CHIP NEVER SHOWS A RAW ID.** The whole point of the row is that a reader recognises what they
+ * are about to open. So the name is read from the entity's own name field, and an entity with no
+ * name field produces no chip rather than a GUID wearing a label.
+ *
+ * **A CHIP THAT CANNOT NAVIGATE IS NOT RENDERED.** A link that goes nowhere is worse than an absent
+ * one: it invites a click and spends the reader's trust. Five ways a link produces nothing — the
+ * entity is not in the catalog, the entity has no name field, the link names neither a record nor a
+ * filter, the read succeeded while matching zero rows, and the read was refused.
+ *
+ * ## Why a read that THREW is treated differently from one that FAILED or found nothing
+ *
+ * Three different facts, and the line between them is whether the server answered.
+ *
+ * **Zero rows from a successful read** means the record is not there — `bizapps-contracts` hit
+ * exactly this with CTR-000026, whose hand-typed provenance pair names a row that does not exist,
+ * and whose header rendered an "Open" button that navigated nowhere. No chip.
+ *
+ * **`Success: false`** is the server answering and refusing. In MJ that is the channel for a
+ * permission denial as much as for a bad filter: `GraphQLDataProvider.InternalRunView` throws when
+ * the transport fails and returns `Success: false` with an `ErrorMessage` when the request reached
+ * the server and was turned down. A reader who may not read Orders would otherwise get an
+ * "Order · Open" chip that navigates to a record that will not open — the dead link this component
+ * exists to prevent. So a refusal produces NO chip.
+ *
+ * **A thrown read** means we do not know: the record may well exist and simply be unreachable this
+ * moment. So a throw keeps the chip when we already hold the id to open — labelled, with "Open"
+ * where the name would go — and drops it for a reverse link, where the throw also cost us the id.
+ */
+export async function ResolveRelatedChip(link, entities, read) {
+    const entity = entities?.find((e) => e.Name === link.EntityName) ?? null;
+    if (!entity) {
+        return null;
+    }
+    const nameField = entity.NameField?.Name;
+    if (!isPresent(nameField)) {
+        return null;
+    }
+    const filter = FilterForRelatedLink(link, entity);
+    if (!filter) {
+        return null;
+    }
+    const pkField = PrimaryKeyFieldFor(entity);
+    const label = LabelForRelatedLink(link, entity);
+    try {
+        const result = await read({
+            EntityName: entity.Name,
+            Fields: [pkField, nameField],
+            ExtraFilter: filter,
+            MaxRows: 1,
+        });
+        if (result?.Success === false) {
+            return null;
+        }
+        const row = result?.Success ? result.Results?.[0] : undefined;
+        if (result?.Success && !row) {
+            return null;
+        }
+        if (!row) {
+            return unreadableChip(link, entity, label, pkField);
+        }
+        const recordID = String(row[pkField] ?? link.RecordID ?? '');
+        if (!isPresent(recordID)) {
+            return null;
+        }
+        return chip(link, entity, label, pkField, recordID, String(row[nameField] ?? ''));
+    }
+    catch {
+        return unreadableChip(link, entity, label, pkField);
+    }
+}
+/**
+ * The chip for a record we could not read but can still open — only possible when the link carried
+ * the id itself. A reverse link has nothing left to open, so it renders nothing.
+ */
+function unreadableChip(link, entity, label, pkField) {
+    return isPresent(link.RecordID) ? chip(link, entity, label, pkField, String(link.RecordID).trim(), '') : null;
+}
+function chip(link, entity, label, pkField, recordID, name) {
+    return {
+        Key: link.Key,
+        Label: label,
+        Name: name,
+        Icon: link.Icon ?? null,
+        EntityName: entity.Name,
+        PrimaryKeyField: pkField,
+        RecordID: recordID,
+        AriaLabel: name ? `Open ${label} ${name}` : `Open ${label}`,
+    };
+}
+/**
+ * The navigation event a chip click produces.
+ *
+ * Ctrl (Windows/Linux) and Cmd (macOS) both mean "new tab", which is the idiom MJ uses everywhere a
+ * record link is clicked.
+ *
+ * `OpenInNewTab` is OMITTED rather than set to `false` on a plain click, and that is the whole of
+ * what makes shift-click work. `NavigationService.shouldForceNewTab` returns `options.forceNewTab`
+ * whenever it is `!== undefined` and only otherwise consults its global shift-key state, and
+ * Explorer passes `forceNewTab: event.OpenInNewTab` straight through. An explicit `false` therefore
+ * does not mean "no opinion" — it means "same tab", and it suppresses the shift detection outright.
+ *
+ * `CompositeKey.FromKeyValuePair` rather than `FromID`: the latter assumes the target's primary key
+ * is literally called `ID`, which is true of these apps today and is not a thing a shared component
+ * gets to assume.
+ */
+export function RelatedChipNavigation(chip, event) {
+    const navigation = {
+        Kind: 'record',
+        EntityName: chip.EntityName,
+        PrimaryKey: CompositeKey.FromKeyValuePair(chip.PrimaryKeyField, chip.RecordID),
+    };
+    if (event.ctrlKey || event.metaKey) {
+        navigation.OpenInNewTab = true;
+    }
+    return navigation;
+}
+//# sourceMappingURL=related-links.js.map

package/dist/lib/components/related-chips/related-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"related-links.js","sourceRoot":"","sources":["../../../../src/lib/components/related-chips/related-links.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAiFpD,qEAAqE;AACrE,SAAS,KAAK,CAAC,KAAa;IACxB,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,4FAA4F;AAC5F,SAAS,SAAS,CAAC,KAAgC;IAC/C,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AACpF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAwB,EAAE,MAAyB;IACpF,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC;IACtF,CAAC;IACD,OAAO,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,kBAAkB,CAAC,MAAyB;IACxD,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAwB,EAAE,MAAyB;IACnF,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9B,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;IACvE,CAAC;IACD,OAAO,MAAM,CAAC,oBAAoB,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACpC,IAAwB,EACxB,QAA6B,EAC7B,IAAuB;IAEvB,MAAM,MAAM,GAAG,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IACzE,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC;IACzC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEhD,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC;YACtB,UAAU,EAAE,MAAM,CAAC,IAAI;YACvB,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;YAC5B,WAAW,EAAE,MAAM;YACnB,OAAO,EAAE,CAAC;SACb,CAAC,CAAC;QACH,IAAI,MAAM,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,IAAI,MAAM,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,OAAO,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACtF,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CACnB,IAAwB,EACxB,MAAyB,EACzB,KAAa,EACb,OAAe;IAEf,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClH,CAAC;AAED,SAAS,IAAI,CACT,IAAwB,EACxB,MAAyB,EACzB,KAAa,EACb,OAAe,EACf,QAAgB,EAChB,IAAY;IAEZ,OAAO;QACH,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;QACvB,UAAU,EAAE,MAAM,CAAC,IAAI;QACvB,eAAe,EAAE,OAAO;QACxB,QAAQ,EAAE,QAAQ;QAClB,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,EAAE;KAC9D,CAAC;AACN,CAAC;AAQD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAyB,EAAE,KAAuB;IACpF,MAAM,UAAU,GAA0B;QACtC,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,YAAY,CAAC,gBAAgB,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC;KACjF,CAAC;IACF,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACjC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC;IACnC,CAAC;IACD,OAAO,UAAU,CAAC;AACtB,CAAC"}

package/dist/lib/components/selling-company-field/__tests__/selling-company-confirm.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=selling-company-confirm.test.d.ts.map

package/dist/lib/components/selling-company-field/__tests__/selling-company-confirm.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selling-company-confirm.test.d.ts","sourceRoot":"","sources":["../../../../../src/lib/components/selling-company-field/__tests__/selling-company-confirm.test.ts"],"names":[],"mappings":""}

package/dist/lib/components/selling-company-field/__tests__/selling-company-confirm.test.js

@@ -0,0 +1,53 @@
+import { describe, expect, it } from 'vitest';
+import { SellingCompanyConfirm } from '../selling-company-confirm';
+describe('SellingCompanyConfirm', () => {
+    it('writes the default without asking', () => {
+        const confirm = new SellingCompanyConfirm('default-id');
+        expect(confirm.Propose('default-id')).toEqual({ Write: 'default-id', Ask: null });
+        expect(confirm.Pending).toBeNull();
+    });
+    it('treats the default as the same company whatever case the ID arrives in', () => {
+        const confirm = new SellingCompanyConfirm('AbC-123');
+        expect(confirm.Propose('abc-123')).toEqual({ Write: 'abc-123', Ask: null });
+    });
+    it('holds any other company for confirmation instead of writing it', () => {
+        const confirm = new SellingCompanyConfirm('default-id');
+        expect(confirm.Propose('other-id')).toEqual({ Write: null, Ask: 'other-id' });
+        expect(confirm.Pending).toBe('other-id');
+    });
+    it('writes the held value on confirm and clears the pending state', () => {
+        const confirm = new SellingCompanyConfirm('default-id');
+        confirm.Propose('other-id');
+        expect(confirm.Confirm()).toBe('other-id');
+        expect(confirm.Pending).toBeNull();
+    });
+    it('restores the caller-supplied previous value on revert', () => {
+        const confirm = new SellingCompanyConfirm('default-id');
+        confirm.Propose('other-id');
+        expect(confirm.Revert('previous-id')).toBe('previous-id');
+        expect(confirm.Pending).toBeNull();
+    });
+    it('replaces an unanswered question rather than stacking two', () => {
+        const confirm = new SellingCompanyConfirm('default-id');
+        confirm.Propose('first-id');
+        expect(confirm.Propose('second-id').Ask).toBe('second-id');
+        expect(confirm.Confirm()).toBe('second-id');
+    });
+    it('clears a pending question when the user goes back to the default', () => {
+        const confirm = new SellingCompanyConfirm('default-id');
+        confirm.Propose('other-id');
+        expect(confirm.Propose('default-id')).toEqual({ Write: 'default-id', Ask: null });
+        expect(confirm.Pending).toBeNull();
+    });
+    it('always allows clearing the field, since an empty value books nothing', () => {
+        const confirm = new SellingCompanyConfirm('default-id');
+        expect(confirm.Propose(null)).toEqual({ Write: null, Ask: null });
+        expect(confirm.Propose('')).toEqual({ Write: '', Ask: null });
+    });
+    it('never asks when the instance has no default configured', () => {
+        const confirm = new SellingCompanyConfirm(null);
+        expect(confirm.Propose('anything')).toEqual({ Write: 'anything', Ask: null });
+        expect(confirm.Pending).toBeNull();
+    });
+});
+//# sourceMappingURL=selling-company-confirm.test.js.map

package/dist/lib/components/selling-company-field/__tests__/selling-company-confirm.test.js.map

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

package/dist/lib/components/selling-company-field/__tests__/selling-company-field.component.test.d.ts

@@ -0,0 +1,2 @@
+import '@angular/compiler';
+//# sourceMappingURL=selling-company-field.component.test.d.ts.map

package/dist/lib/components/selling-company-field/__tests__/selling-company-field.component.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selling-company-field.component.test.d.ts","sourceRoot":"","sources":["../../../../../src/lib/components/selling-company-field/__tests__/selling-company-field.component.test.ts"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,CAAC"}

package/dist/lib/components/selling-company-field/__tests__/selling-company-field.component.test.js

@@ -0,0 +1,166 @@
+import '@angular/compiler';
+import { ChangeDetectorRef, Injector, runInInjectionContext } from '@angular/core';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const H = vi.hoisted(() => ({
+    settingValue: 'default-co',
+    employeeID: null,
+    companies: [
+        { ID: 'default-co', Name: 'Default Selling Co' },
+        { ID: 'other-co', Name: 'Other Co' },
+        { ID: 'employee-co', Name: 'Employee Co' },
+    ],
+    employeeRows: [],
+    runView: vi.fn(),
+}));
+vi.mock('@memberjunction/core', async (importOriginal) => {
+    const actual = await importOriginal();
+    class MockMetadata {
+        static Provider = {};
+        get CurrentUser() {
+            return { ID: 'u1', EmployeeID: H.employeeID };
+        }
+        get Applications() {
+            return [{ ID: 'app-common', Name: 'Common' }];
+        }
+    }
+    return {
+        ...actual,
+        Metadata: MockMetadata,
+        RunView: { FromMetadataProvider: () => ({ RunView: H.runView }) },
+    };
+});
+vi.mock('@memberjunction/core-entities', async (importOriginal) => ({
+    ...(await importOriginal()),
+    ApplicationSettingEngine: {
+        Instance: {
+            Config: async () => undefined,
+            GetSetting: (name) => (name === 'DefaultSellingCompanyID' ? H.settingValue : undefined),
+        },
+    },
+}));
+vi.mock('@memberjunction/ng-base-forms', () => ({ BaseFormsModule: class {
+    } }));
+import { SellingCompanyFieldComponent } from '../selling-company-field.component';
+function record(isSaved, companyID = null) {
+    const values = { CompanyID: companyID };
+    return {
+        IsSaved: isSaved,
+        values,
+        Get: (field) => values[field],
+        Set: (field, value) => {
+            values[field] = value;
+        },
+    };
+}
+/**
+ * The component resolves ChangeDetectorRef with `inject()`, which needs an injection context.
+ * A one-provider injector gives it one without standing up TestBed — these are unit tests of the
+ * default-and-confirm behaviour, not of rendering.
+ */
+async function build(rec) {
+    const injector = Injector.create({
+        providers: [{ provide: ChangeDetectorRef, useValue: { markForCheck: () => undefined } }],
+    });
+    const component = runInInjectionContext(injector, () => new SellingCompanyFieldComponent());
+    component.Record = rec;
+    await component.ngOnInit();
+    return component;
+}
+describe('SellingCompanyFieldComponent', () => {
+    beforeEach(() => {
+        H.settingValue = 'default-co';
+        H.employeeID = null;
+        H.employeeRows = [];
+        H.runView.mockImplementation(async (params) => params.EntityName === 'MJ: Employees'
+            ? { Success: true, Results: H.employeeRows }
+            : { Success: true, Results: H.companies });
+    });
+    it('defaults a new record to the configured company', async () => {
+        const rec = record(false);
+        await build(rec);
+        expect(rec.values['CompanyID']).toBe('default-co');
+    });
+    it('prefers the user own company over the configured setting', async () => {
+        H.employeeID = 'emp-1';
+        H.employeeRows = [{ CompanyID: 'employee-co' }];
+        const rec = record(false);
+        const component = await build(rec);
+        expect(rec.values['CompanyID']).toBe('employee-co');
+        expect(component.DefaultName).toBe('Employee Co');
+    });
+    it('ignores an employee company this instance does not know', async () => {
+        H.employeeID = 'emp-1';
+        H.employeeRows = [{ CompanyID: 'some-unknown-co' }];
+        const rec = record(false);
+        await build(rec);
+        expect(rec.values['CompanyID']).toBe('default-co');
+    });
+    it('never overwrites a company already on the record', async () => {
+        const rec = record(false, 'other-co');
+        await build(rec);
+        expect(rec.values['CompanyID']).toBe('other-co');
+    });
+    it('leaves a saved record alone', async () => {
+        const rec = record(true);
+        await build(rec);
+        expect(rec.values['CompanyID']).toBeNull();
+    });
+    it('writes nothing and asks nothing when the instance configured no default', async () => {
+        H.settingValue = null;
+        const rec = record(false);
+        const component = await build(rec);
+        expect(rec.values['CompanyID']).toBeNull();
+        rec.Set('CompanyID', 'other-co');
+        component.OnValueChange('other-co');
+        expect(component.AskName).toBeNull();
+        expect(rec.values['CompanyID']).toBe('other-co');
+    });
+    it('holds another company, restoring the previous value while the question is open', async () => {
+        const rec = record(false);
+        const component = await build(rec);
+        rec.Set('CompanyID', 'other-co'); // mj-form-field writes before it emits
+        component.OnValueChange('other-co');
+        expect(component.AskName).toBe('Other Co');
+        expect(component.DefaultName).toBe('Default Selling Co');
+        expect(rec.values['CompanyID']).toBe('default-co');
+    });
+    it('writes the held company on confirm', async () => {
+        const rec = record(false);
+        const component = await build(rec);
+        rec.Set('CompanyID', 'other-co');
+        component.OnValueChange('other-co');
+        component.OnConfirm();
+        expect(rec.values['CompanyID']).toBe('other-co');
+        expect(component.AskName).toBeNull();
+    });
+    it('keeps the previous company on revert', async () => {
+        const rec = record(false);
+        const component = await build(rec);
+        rec.Set('CompanyID', 'other-co');
+        component.OnValueChange('other-co');
+        component.OnRevert();
+        expect(rec.values['CompanyID']).toBe('default-co');
+        expect(component.AskName).toBeNull();
+    });
+    it('asks again after a confirmed choice, using the confirmed value as what to revert to', async () => {
+        const rec = record(false);
+        const component = await build(rec);
+        rec.Set('CompanyID', 'other-co');
+        component.OnValueChange('other-co');
+        component.OnConfirm();
+        rec.Set('CompanyID', 'employee-co');
+        component.OnValueChange('employee-co');
+        expect(component.AskName).toBe('Employee Co');
+        component.OnRevert();
+        expect(rec.values['CompanyID']).toBe('other-co');
+    });
+    it('names a company by ID rather than hiding the question when the company list cannot be read', async () => {
+        H.runView.mockImplementation(async () => ({ Success: false, ErrorMessage: 'denied', Results: [] }));
+        const rec = record(false);
+        const component = await build(rec);
+        rec.Set('CompanyID', 'other-co');
+        component.OnValueChange('other-co');
+        expect(component.AskName).toBe('other-co');
+    });
+});
+//# sourceMappingURL=selling-company-field.component.test.js.map

package/dist/lib/components/selling-company-field/__tests__/selling-company-field.component.test.js.map

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

package/dist/lib/components/selling-company-field/selling-company-confirm.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Which selling-company choices go straight through and which pause for a confirmation.
+ *
+ * The selling company decides which legal entity books the revenue on an order or a contract, and
+ * the picker can offer dozens of companies whose names differ by a word. Getting it wrong is silent
+ * — the record looks correct afterwards. So the default is written without ceremony and anything
+ * else is held until the user says yes.
+ *
+ * Pure and synchronous on purpose: the rule is the part worth testing, and it is testable here
+ * without a record, a provider or a rendered field.
+ */
+export declare class SellingCompanyConfirm {
+    private readonly defaultID;
+    private pending;
+    /**
+     * @param defaultID the resolved default company, or null when this instance has none
+     *                  configured — in which case nothing is ever held back, because there is no
+     *                  expectation to depart from.
+     */
+    constructor(defaultID: string | null);
+    /** The choice currently awaiting an answer, or null when nothing is pending. */
+    get Pending(): string | null;
+    /**
+     * Offer a choice. Returns what to write now (`Write`) and what to ask about (`Ask`); exactly
+     * one of them is non-null. Clearing the field is always allowed — an empty value books nothing.
+     */
+    Propose(id: string | null): {
+        Write: string | null;
+        Ask: string | null;
+    };
+    /** The user said yes. Returns the value to write. */
+    Confirm(): string | null;
+    /** The user said no, or moved on without answering. Returns the value to restore. */
+    Revert(previous: string | null): string | null;
+}
+//# sourceMappingURL=selling-company-confirm.d.ts.map

package/dist/lib/components/selling-company-field/selling-company-confirm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selling-company-confirm.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/selling-company-field/selling-company-confirm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,qBAAa,qBAAqB;IAQlB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAPtC,OAAO,CAAC,OAAO,CAAuB;IAEtC;;;;OAIG;gBAC0B,SAAS,EAAE,MAAM,GAAG,IAAI;IAErD,gFAAgF;IAChF,IAAW,OAAO,IAAI,MAAM,GAAG,IAAI,CAElC;IAED;;;OAGG;IACI,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAS/E,qDAAqD;IAC9C,OAAO,IAAI,MAAM,GAAG,IAAI;IAM/B,qFAAqF;IAC9E,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI;CAIxD"}