@memberjunction/core-entities 6.2.0-edge.2 → 6.2.0-edge.4

package/dist/custom/ConversationForkAccess.d.ts

@@ -0,0 +1,15 @@
+import { type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+/** The MJ Authorization that lets a person start a fork of a conversation (Fork from here, Edit or Regenerate as a fork). */
+export declare const CONVERSATIONS_FORK_AUTHORIZATION = "Conversations: Fork";
+/**
+ * True when `user` holds {@link CONVERSATIONS_FORK_AUTHORIZATION} through a role: an Allow grant and
+ * no Deny on any of the user's roles (a grant of a parent authorization counts). False without a user
+ * or a provider, and when the authorization is missing from the provider's metadata or inactive, so a
+ * deployment that has not synced it fails closed.
+ */
+export declare function UserCanFork(user: UserInfo | null | undefined, provider: IMetadataProvider | null | undefined): boolean;
+/** The `MJ: User Settings` key of a person's forking switch; the value `off` turns forking off for them. */
+export declare const CONVERSATIONS_FORKING_SETTING_KEY = "mj.conversations.forking.v1";
+/** True unless the stored forking setting is `off`: no setting, an empty one or `on` mean forking is on. */
+export declare function IsForkingSettingOn(value: string | null | undefined): boolean;
+//# sourceMappingURL=ConversationForkAccess.d.ts.map

package/dist/custom/ConversationForkAccess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationForkAccess.d.ts","sourceRoot":"","sources":["../../src/custom/ConversationForkAccess.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErG,6HAA6H;AAC7H,eAAO,MAAM,gCAAgC,wBAAwB,CAAC;AAEtE;;;;;GAKG;AACH,wBAAgB,WAAW,CACvB,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,EACjC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAC/C,OAAO,CAWT;AAED,4GAA4G;AAC5G,eAAO,MAAM,iCAAiC,gCAAgC,CAAC;AAE/E,4GAA4G;AAC5G,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE5E"}

package/dist/custom/ConversationForkAccess.js

@@ -0,0 +1,28 @@
+import { AuthorizationEvaluator } from '@memberjunction/core';
+/** The MJ Authorization that lets a person start a fork of a conversation (Fork from here, Edit or Regenerate as a fork). */
+export const CONVERSATIONS_FORK_AUTHORIZATION = 'Conversations: Fork';
+/**
+ * True when `user` holds {@link CONVERSATIONS_FORK_AUTHORIZATION} through a role: an Allow grant and
+ * no Deny on any of the user's roles (a grant of a parent authorization counts). False without a user
+ * or a provider, and when the authorization is missing from the provider's metadata or inactive, so a
+ * deployment that has not synced it fails closed.
+ */
+export function UserCanFork(user, provider) {
+    if (!user || !provider) {
+        return false;
+    }
+    const authorizations = provider.Authorizations ?? [];
+    const wanted = CONVERSATIONS_FORK_AUTHORIZATION.toLowerCase();
+    const grant = authorizations.find((a) => a.Name?.trim().toLowerCase() === wanted);
+    if (!grant) {
+        return false;
+    }
+    return new AuthorizationEvaluator().UserCanExecuteWithAncestors(grant, user, authorizations);
+}
+/** The `MJ: User Settings` key of a person's forking switch; the value `off` turns forking off for them. */
+export const CONVERSATIONS_FORKING_SETTING_KEY = 'mj.conversations.forking.v1';
+/** True unless the stored forking setting is `off`: no setting, an empty one or `on` mean forking is on. */
+export function IsForkingSettingOn(value) {
+    return (value ?? '').trim().toLowerCase() !== 'off';
+}
+//# sourceMappingURL=ConversationForkAccess.js.map

package/dist/custom/ConversationForkAccess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationForkAccess.js","sourceRoot":"","sources":["../../src/custom/ConversationForkAccess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAyC,MAAM,sBAAsB,CAAC;AAErG,6HAA6H;AAC7H,MAAM,CAAC,MAAM,gCAAgC,GAAG,qBAAqB,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACvB,IAAiC,EACjC,QAA8C;IAE9C,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,cAAc,GAAG,QAAQ,CAAC,cAAc,IAAI,EAAE,CAAC;IACrD,MAAM,MAAM,GAAG,gCAAgC,CAAC,WAAW,EAAE,CAAC;IAC9D,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC;IAClF,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,sBAAsB,EAAE,CAAC,2BAA2B,CAAC,KAAK,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;AACjG,CAAC;AAED,4GAA4G;AAC5G,MAAM,CAAC,MAAM,iCAAiC,GAAG,6BAA6B,CAAC;AAE/E,4GAA4G;AAC5G,MAAM,UAAU,kBAAkB,CAAC,KAAgC;IAC/D,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC;AACxD,CAAC"}

package/dist/custom/ConversationWriteAccess.d.ts

@@ -0,0 +1,16 @@
+import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+/** Resource type ID for conversations in the resource permission system. */
+export declare const CONVERSATIONS_RESOURCE_TYPE_ID = "81D4BC3D-9FEB-EF11-B01A-286B35C04427";
+export interface ConversationWriteDecision {
+    Allowed: boolean;
+    Reason: string | null;
+    /** True only when the conversation loaded and the user is its owner. */
+    IsOwner: boolean;
+}
+/**
+ * Whether a user may write rows that belong to a conversation: the owner, or a user with
+ * an Edit or Owner grant. Server-side only; a non-database provider trusts the enforcement
+ * that already ran upstream.
+ */
+export declare function UserMayWriteConversation(provider: IMetadataProvider, user: UserInfo | null | undefined, conversationId: string): Promise<ConversationWriteDecision>;
+//# sourceMappingURL=ConversationWriteAccess.d.ts.map

package/dist/custom/ConversationWriteAccess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationWriteAccess.d.ts","sourceRoot":"","sources":["../../src/custom/ConversationWriteAccess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAKnE,4EAA4E;AAC5E,eAAO,MAAM,8BAA8B,yCAAyC,CAAC;AAErF,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC1C,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,EACjC,cAAc,EAAE,MAAM,GACvB,OAAO,CAAC,yBAAyB,CAAC,CAuBpC"}

package/dist/custom/ConversationWriteAccess.js

@@ -0,0 +1,34 @@
+import { UUIDsEqual } from '@memberjunction/global';
+import { ResourcePermissionEngine } from './ResourcePermissions/ResourcePermissionEngine.js';
+/** Resource type ID for conversations in the resource permission system. */
+export const CONVERSATIONS_RESOURCE_TYPE_ID = '81D4BC3D-9FEB-EF11-B01A-286B35C04427';
+/**
+ * Whether a user may write rows that belong to a conversation: the owner, or a user with
+ * an Edit or Owner grant. Server-side only; a non-database provider trusts the enforcement
+ * that already ran upstream.
+ */
+export async function UserMayWriteConversation(provider, user, conversationId) {
+    if (provider?.ProviderType !== 'Database' || !user) {
+        return { Allowed: true, Reason: null, IsOwner: false };
+    }
+    const conversation = await provider.GetEntityObject('MJ: Conversations', user);
+    if (!(await conversation.Load(conversationId))) {
+        return { Allowed: true, Reason: null, IsOwner: false };
+    }
+    if (conversation.UserID && UUIDsEqual(conversation.UserID, user.ID)) {
+        return { Allowed: true, Reason: null, IsOwner: true };
+    }
+    const engine = ResourcePermissionEngine.GetProviderInstance(provider, ResourcePermissionEngine);
+    await engine.Config(false, user);
+    const grant = engine
+        .GetUserAvailableResources(user, CONVERSATIONS_RESOURCE_TYPE_ID)
+        .find((p) => UUIDsEqual(p.ResourceRecordID, conversationId));
+    if (!grant) {
+        return { Allowed: false, Reason: 'You do not have access to this conversation.', IsOwner: false };
+    }
+    if (grant.PermissionLevel === 'Edit' || grant.PermissionLevel === 'Owner') {
+        return { Allowed: true, Reason: null, IsOwner: false };
+    }
+    return { Allowed: false, Reason: 'You have view-only access to this conversation.', IsOwner: false };
+}
+//# sourceMappingURL=ConversationWriteAccess.js.map

package/dist/custom/ConversationWriteAccess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationWriteAccess.js","sourceRoot":"","sources":["../../src/custom/ConversationWriteAccess.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gDAAgD,CAAC;AAE1F,4EAA4E;AAC5E,MAAM,CAAC,MAAM,8BAA8B,GAAG,sCAAsC,CAAC;AASrF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC1C,QAA2B,EAC3B,IAAiC,EACjC,cAAsB;IAEtB,IAAI,QAAQ,EAAE,YAAY,KAAK,UAAU,IAAI,CAAC,IAAI,EAAE,CAAC;QACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC3D,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAuB,mBAAmB,EAAE,IAAI,CAAC,CAAC;IACrG,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;QAC7C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC3D,CAAC;IACD,IAAI,YAAY,CAAC,MAAM,IAAI,UAAU,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAClE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;IACD,MAAM,MAAM,GAAG,wBAAwB,CAAC,mBAAmB,CAA2B,QAAQ,EAAE,wBAAwB,CAA6B,CAAC;IACtJ,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,MAAM;SACf,yBAAyB,CAAC,IAAI,EAAE,8BAA8B,CAAC;SAC/D,IAAI,CAAC,CAAC,CAA6B,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC,CAAC;IAC7F,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,8CAA8C,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACtG,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,KAAK,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,OAAO,EAAE,CAAC;QACxE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,iDAAiD,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACzG,CAAC"}

package/dist/custom/FormScope/FormContributionClaims.d.ts

@@ -0,0 +1,20 @@
+import type { FormContributionSpecColumns } from './FormContributionRow.js';
+/**
+ * The claim rules of `MJ: Entity Form Contributions`, checked in code before anything is written.
+ *
+ * The database enforces the same rules with CHECK constraints, but a refused row save comes after
+ * its component was written. Lives here, beside the spec-to-row mapper, so the server and the
+ * browser can check a row the same way.
+ */
+/** The columns the claim rules read. */
+export type ContributionClaimColumns = Pick<FormContributionSpecColumns, 'Presentation' | 'Inclusion' | 'ChromeGroup' | 'RelatedEntityID' | 'RelatedJoinField' | 'ReplacesSectionKey' | 'ReplacesSectionKeys' | 'ReplacesFieldNames' | 'InSectionKey' | 'SectionPosition'>;
+/**
+ * Why the database would refuse this row's claim, or null when it would not.
+ *
+ * Checks `CK_EntityFormContribution_OneClaim` (a related grid, one section, several sections,
+ * fields of one section, or a place inside a section — at most one), `BareNoChrome`,
+ * `JoinNeedsRelated` and `SectionPositionNeedsSection`. The message names the spec fields, so an
+ * agent can correct its spec.
+ */
+export declare function ContributionClaimRefusal(row: ContributionClaimColumns): string | null;
+//# sourceMappingURL=FormContributionClaims.d.ts.map

package/dist/custom/FormScope/FormContributionClaims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormContributionClaims.d.ts","sourceRoot":"","sources":["../../../src/custom/FormScope/FormContributionClaims.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEzE;;;;;;GAMG;AAEH,wCAAwC;AACxC,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,2BAA2B,EACjE,cAAc,GAAG,WAAW,GAAG,aAAa,GAAG,iBAAiB,GAAG,kBAAkB,GACrF,oBAAoB,GAAG,qBAAqB,GAAG,oBAAoB,GAAG,cAAc,GAAG,iBAAiB,CAAC,CAAC;AAWhH;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,wBAAwB,GAAG,MAAM,GAAG,IAAI,CAerF"}

package/dist/custom/FormScope/FormContributionClaims.js

@@ -0,0 +1,33 @@
+/** Each claim column, with the spec field an author sets to make that claim. */
+const CLAIMS = [
+    { Column: 'RelatedEntityID', SpecField: 'relatedEntity' },
+    { Column: 'ReplacesSectionKey', SpecField: 'replacesSectionKey' },
+    { Column: 'ReplacesSectionKeys', SpecField: 'replacesSectionKeys' },
+    { Column: 'ReplacesFieldNames', SpecField: 'replacesFieldNames' },
+    { Column: 'InSectionKey', SpecField: 'inSectionKey' },
+];
+/**
+ * Why the database would refuse this row's claim, or null when it would not.
+ *
+ * Checks `CK_EntityFormContribution_OneClaim` (a related grid, one section, several sections,
+ * fields of one section, or a place inside a section — at most one), `BareNoChrome`,
+ * `JoinNeedsRelated` and `SectionPositionNeedsSection`. The message names the spec fields, so an
+ * agent can correct its spec.
+ */
+export function ContributionClaimRefusal(row) {
+    const made = CLAIMS.filter((claim) => row[claim.Column] != null).map((claim) => claim.SpecField);
+    if (made.length > 1) {
+        return `A form contribution makes one claim at most, but this one sets ${made.join(' and ')}. Keep one of them.`;
+    }
+    if (row.Presentation === 'bare' && (row.Inclusion != null || row.ChromeGroup != null)) {
+        return 'A bare panel is never a rail item, so it takes no inclusion or chromeGroup.';
+    }
+    if (row.RelatedJoinField != null && row.RelatedEntityID == null) {
+        return 'relatedJoinField qualifies a related-grid claim, so it needs relatedEntity.';
+    }
+    if (row.SectionPosition != null && row.ReplacesFieldNames == null && row.InSectionKey == null) {
+        return 'sectionPosition places a panel inside a section, so it needs inSectionKey or replacesFieldNames.';
+    }
+    return null;
+}
+//# sourceMappingURL=FormContributionClaims.js.map

package/dist/custom/FormScope/FormContributionClaims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormContributionClaims.js","sourceRoot":"","sources":["../../../src/custom/FormScope/FormContributionClaims.ts"],"names":[],"mappings":"AAeA,gFAAgF;AAChF,MAAM,MAAM,GAAiF;IACzF,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,eAAe,EAAE;IACzD,EAAE,MAAM,EAAE,oBAAoB,EAAE,SAAS,EAAE,oBAAoB,EAAE;IACjE,EAAE,MAAM,EAAE,qBAAqB,EAAE,SAAS,EAAE,qBAAqB,EAAE;IACnE,EAAE,MAAM,EAAE,oBAAoB,EAAE,SAAS,EAAE,oBAAoB,EAAE;IACjE,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,cAAc,EAAE;CACxD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAA6B;IAClE,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjG,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,kEAAkE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC;IACrH,CAAC;IACD,IAAI,GAAG,CAAC,YAAY,KAAK,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,IAAI,IAAI,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,EAAE,CAAC;QACpF,OAAO,6EAA6E,CAAC;IACzF,CAAC;IACD,IAAI,GAAG,CAAC,gBAAgB,IAAI,IAAI,IAAI,GAAG,CAAC,eAAe,IAAI,IAAI,EAAE,CAAC;QAC9D,OAAO,6EAA6E,CAAC;IACzF,CAAC;IACD,IAAI,GAAG,CAAC,eAAe,IAAI,IAAI,IAAI,GAAG,CAAC,kBAAkB,IAAI,IAAI,IAAI,GAAG,CAAC,YAAY,IAAI,IAAI,EAAE,CAAC;QAC5F,OAAO,kGAAkG,CAAC;IAC9G,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/custom/FormScope/FormContributionLifecycle.d.ts

@@ -0,0 +1,43 @@
+import type { MJComponentEntity, MJEntityFormContributionEntity } from '../../generated/entities/__mj.js';
+/**
+ * How a form or panel goes live and is retired, as both write paths apply it: the server actions
+ * an agent calls, and the form's Manage drawer a person uses. Lives in a package both depend on,
+ * so the two cannot disagree about which row an activation retires.
+ */
+/** A form or panel's lifecycle, as the row stores it. */
+export type FormLifecycleStatus = MJEntityFormContributionEntity['Status'];
+/** The status of the Component a form or panel renders. */
+export type FormComponentStatus = NonNullable<MJComponentEntity['Status']>;
+/**
+ * The Component status that mirrors a form or panel's lifecycle: a live version is `Published`,
+ * a draft is `Draft`, a retired one is `Deprecated`. So a Component read on its own still says
+ * whether it is live. An unknown status reads as retired.
+ */
+export declare function FormLifecycleComponentStatus(status: FormLifecycleStatus): FormComponentStatus;
+/** The columns that place a form or panel row: its entity, audience, status and key. */
+export interface FormScopedRow {
+    ID: string;
+    EntityID: string;
+    Status: string;
+    Scope: string;
+    UserID: string | null;
+    RoleID: string | null;
+    /** Panels only. A full custom form has no key. */
+    ContributionKey?: string | null;
+}
+/**
+ * Whether two rows are for the same audience: the same scope, the same owner for a `User` row and
+ * the same role for a `Role` row. Every `Global` row is for the same audience.
+ */
+export declare function SameFormAudience(a: Pick<FormScopedRow, 'Scope' | 'UserID' | 'RoleID'>, b: Pick<FormScopedRow, 'Scope' | 'UserID' | 'RoleID'>): boolean;
+/**
+ * The Active panels that activating `target` must retire first: the same entity, the same
+ * audience and the same key, other than the target itself. A panel with no key has none: two
+ * keyless panels are two panels.
+ *
+ * `UQ_EntityFormContribution_Key` allows one Active row per entity, key and audience, so these are
+ * demoted before the target is promoted, in the same transaction. Keys are trimmed and compared
+ * without regard to case, which mirrors the index's case-insensitive collation.
+ */
+export declare function ActiveContributionSiblings<T extends FormScopedRow>(rows: readonly T[], target: FormScopedRow): T[];
+//# sourceMappingURL=FormContributionLifecycle.d.ts.map

package/dist/custom/FormScope/FormContributionLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormContributionLifecycle.d.ts","sourceRoot":"","sources":["../../../src/custom/FormScope/FormContributionLifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAEvG;;;;GAIG;AAEH,yDAAyD;AACzD,MAAM,MAAM,mBAAmB,GAAG,8BAA8B,CAAC,QAAQ,CAAC,CAAC;AAE3E,2DAA2D;AAC3D,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAO7F;AAED,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC5B,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC,EACrD,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC,GACtD,OAAO,CAKT;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,aAAa,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,aAAa,GAAG,CAAC,EAAE,CASlH"}

package/dist/custom/FormScope/FormContributionLifecycle.js

@@ -0,0 +1,47 @@
+import { UUIDsEqual } from '@memberjunction/global';
+/**
+ * The Component status that mirrors a form or panel's lifecycle: a live version is `Published`,
+ * a draft is `Draft`, a retired one is `Deprecated`. So a Component read on its own still says
+ * whether it is live. An unknown status reads as retired.
+ */
+export function FormLifecycleComponentStatus(status) {
+    switch (status) {
+        case 'Active': return 'Published';
+        case 'Pending': return 'Draft';
+        case 'Inactive': return 'Deprecated';
+        default: return 'Deprecated';
+    }
+}
+/**
+ * Whether two rows are for the same audience: the same scope, the same owner for a `User` row and
+ * the same role for a `Role` row. Every `Global` row is for the same audience.
+ */
+export function SameFormAudience(a, b) {
+    if (a.Scope !== b.Scope)
+        return false;
+    if (a.Scope === 'User')
+        return UUIDsEqual(a.UserID ?? '', b.UserID ?? '');
+    if (a.Scope === 'Role')
+        return UUIDsEqual(a.RoleID ?? '', b.RoleID ?? '');
+    return true;
+}
+/**
+ * The Active panels that activating `target` must retire first: the same entity, the same
+ * audience and the same key, other than the target itself. A panel with no key has none: two
+ * keyless panels are two panels.
+ *
+ * `UQ_EntityFormContribution_Key` allows one Active row per entity, key and audience, so these are
+ * demoted before the target is promoted, in the same transaction. Keys are trimmed and compared
+ * without regard to case, which mirrors the index's case-insensitive collation.
+ */
+export function ActiveContributionSiblings(rows, target) {
+    const key = (target.ContributionKey ?? '').trim().toLowerCase();
+    if (!key)
+        return [];
+    return rows.filter((row) => row.Status === 'Active'
+        && !UUIDsEqual(row.ID, target.ID)
+        && UUIDsEqual(row.EntityID, target.EntityID)
+        && (row.ContributionKey ?? '').trim().toLowerCase() === key
+        && SameFormAudience(row, target));
+}
+//# sourceMappingURL=FormContributionLifecycle.js.map

package/dist/custom/FormScope/FormContributionLifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormContributionLifecycle.js","sourceRoot":"","sources":["../../../src/custom/FormScope/FormContributionLifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAepD;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAA2B;IACpE,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,QAAQ,CAAC,CAAC,OAAO,WAAW,CAAC;QAClC,KAAK,SAAS,CAAC,CAAC,OAAO,OAAO,CAAC;QAC/B,KAAK,UAAU,CAAC,CAAC,OAAO,YAAY,CAAC;QACrC,OAAO,CAAC,CAAC,OAAO,YAAY,CAAC;IACjC,CAAC;AACL,CAAC;AAcD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC5B,CAAqD,EACrD,CAAqD;IAErD,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAC1E,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CAA0B,IAAkB,EAAE,MAAqB;IACzG,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChE,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CACvB,GAAG,CAAC,MAAM,KAAK,QAAQ;WACpB,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;WAC9B,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;WACzC,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG;WACxD,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/custom/FormScope/FormContributionRow.d.ts

@@ -0,0 +1,40 @@
+import { type FormContributionSpec } from '@memberjunction/interactive-component-types/forms';
+import type { MJEntityFormContributionEntity } from '../../generated/entities/__mj.js';
+/**
+ * The spec-to-row mapping for `MJ: Entity Form Contributions`.
+ *
+ * The Create and Modify Form Contribution actions, and the Manage drawer's
+ * `FormPanelAdminService.SetPlacement` (`@memberjunction/ng-base-forms`), write rows through
+ * {@link ApplyContributionSpecToRow}, so the same spec produces the same row on every path.
+ * Lives here because both the server and the browser depend on this package.
+ */
+/** What {@link ApplyContributionSpecToRow} needs beyond the spec. */
+export interface ContributionRowOptions {
+    /** The ID of the entity `spec.relatedEntity` names, or null. */
+    relatedEntityID: string | null;
+    /** The registered name of that entity, which the derived key embeds. */
+    relatedEntityName: string | null;
+    /** The component name that seeds the key of a panel with no other key. */
+    componentName: string | null;
+}
+/** The contribution columns a spec's `formContribution` block decides. */
+export type FormContributionSpecColumns = Pick<MJEntityFormContributionEntity, 'Slot' | 'SortKey' | 'Presentation' | 'Title' | 'Icon' | 'Configuration' | 'Inclusion' | 'ChromeGroup' | 'RelatedEntityID' | 'RelatedJoinField' | 'ReplacesSectionKey' | 'ReplacesSectionKeys' | 'ReplacesFieldNames' | 'InSectionKey' | 'SectionPosition' | 'ContributionKey'>;
+/**
+ * Writes every column a contribution spec decides onto a row, and clears each claim column the
+ * spec does not set, so a row that changes its claim keeps nothing of the old one.
+ *
+ * The row it writes satisfies these CHECK constraints: `ReplacesFieldNamesShape` and
+ * `ReplacesSectionKeysShape` (an empty name list is stored as null), `JoinNeedsRelated` (a join
+ * field only with a related entity), `SectionPositionNeedsSection` (a position only for a panel
+ * drawn inside a section) and `BareNoChrome` (no Inclusion or ChromeGroup on a bare panel). It
+ * does not check `OneClaim`: a spec that makes two claims produces a row the database refuses.
+ *
+ * The caller resolves the related entity, because that needs metadata, and writes the columns
+ * that are not in the spec (scope, owner, status, precedence, names).
+ */
+export declare function ApplyContributionSpecToRow(row: FormContributionSpecColumns, spec: FormContributionSpec, opts: ContributionRowOptions): void;
+/** The columns a spec decides, on a new object, for checking a spec before any row is written. */
+export declare function ContributionSpecColumns(spec: FormContributionSpec, opts: ContributionRowOptions): FormContributionSpecColumns;
+/** The names in a `ReplacesFieldNames` or `ReplacesSectionKeys` cell. Empty for a cell that is not a JSON array. */
+export declare function ParseClaimedFieldNames(raw: string | null | undefined): string[];
+//# sourceMappingURL=FormContributionRow.d.ts.map

package/dist/custom/FormScope/FormContributionRow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormContributionRow.d.ts","sourceRoot":"","sources":["../../../src/custom/FormScope/FormContributionRow.ts"],"names":[],"mappings":"AACA,OAAO,EAGH,KAAK,oBAAoB,EAC5B,MAAM,mDAAmD,CAAC;AAC3D,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAEpF;;;;;;;GAOG;AAEH,qEAAqE;AACrE,MAAM,WAAW,sBAAsB;IACnC,gEAAgE;IAChE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,wEAAwE;IACxE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,0EAA0E;IAC1E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,0EAA0E;AAC1E,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAAC,8BAA8B,EACvE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,eAAe,GAAG,WAAW,GAAG,aAAa,GACtG,iBAAiB,GAAG,kBAAkB,GAAG,oBAAoB,GAAG,qBAAqB,GAAG,oBAAoB,GAC5G,cAAc,GAAG,iBAAiB,GAAG,iBAAiB,CAAC,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACtC,GAAG,EAAE,2BAA2B,EAChC,IAAI,EAAE,oBAAoB,EAC1B,IAAI,EAAE,sBAAsB,GAC7B,IAAI,CAKN;AAED,kGAAkG;AAClG,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,sBAAsB,GAAG,2BAA2B,CAS7H;AAED,oHAAoH;AACpH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAI/E"}

package/dist/custom/FormScope/FormContributionRow.js

@@ -0,0 +1,84 @@
+import { SafeJSONParse } from '@memberjunction/global';
+import { DEFAULT_FORM_CONTRIBUTION_SLOT, ResolveContributionWriteKey, } from '@memberjunction/interactive-component-types/forms';
+/**
+ * Writes every column a contribution spec decides onto a row, and clears each claim column the
+ * spec does not set, so a row that changes its claim keeps nothing of the old one.
+ *
+ * The row it writes satisfies these CHECK constraints: `ReplacesFieldNamesShape` and
+ * `ReplacesSectionKeysShape` (an empty name list is stored as null), `JoinNeedsRelated` (a join
+ * field only with a related entity), `SectionPositionNeedsSection` (a position only for a panel
+ * drawn inside a section) and `BareNoChrome` (no Inclusion or ChromeGroup on a bare panel). It
+ * does not check `OneClaim`: a spec that makes two claims produces a row the database refuses.
+ *
+ * The caller resolves the related entity, because that needs metadata, and writes the columns
+ * that are not in the spec (scope, owner, status, precedence, names).
+ */
+export function ApplyContributionSpecToRow(row, spec, opts) {
+    applyPlacement(row, spec);
+    applyChrome(row, spec);
+    applyClaims(row, spec, opts.relatedEntityID);
+    row.ContributionKey = ResolveContributionWriteKey(spec, opts.relatedEntityName, opts.componentName);
+}
+/** The columns a spec decides, on a new object, for checking a spec before any row is written. */
+export function ContributionSpecColumns(spec, opts) {
+    const row = {
+        Slot: DEFAULT_FORM_CONTRIBUTION_SLOT, SortKey: 0, Presentation: 'panel', Title: null, Icon: null,
+        Configuration: null, Inclusion: null, ChromeGroup: null, RelatedEntityID: null, RelatedJoinField: null,
+        ReplacesSectionKey: null, ReplacesSectionKeys: null, ReplacesFieldNames: null, InSectionKey: null,
+        SectionPosition: null, ContributionKey: null,
+    };
+    ApplyContributionSpecToRow(row, spec, opts);
+    return row;
+}
+/** The names in a `ReplacesFieldNames` or `ReplacesSectionKeys` cell. Empty for a cell that is not a JSON array. */
+export function ParseClaimedFieldNames(raw) {
+    if (!raw || raw.trim().length === 0)
+        return [];
+    const parsed = SafeJSONParse(raw, false);
+    return Array.isArray(parsed) ? cleanNames(parsed) : [];
+}
+function applyPlacement(row, spec) {
+    row.Slot = spec.slot ?? DEFAULT_FORM_CONTRIBUTION_SLOT;
+    row.SortKey = spec.sortKey ?? 0;
+    row.Presentation = spec.presentation;
+    row.Title = spec.title;
+    row.Icon = spec.icon ?? null;
+    row.Configuration = spec.configuration && Object.keys(spec.configuration).length > 0
+        ? JSON.stringify(spec.configuration) : null;
+}
+/** A bare panel is never a rail item, so it carries no rail metadata. */
+function applyChrome(row, spec) {
+    const bare = spec.presentation === 'bare';
+    row.Inclusion = bare ? null : spec.inclusion ?? null;
+    row.ChromeGroup = bare ? null : spec.chromeGroup ?? null;
+}
+function applyClaims(row, spec, relatedEntityID) {
+    row.RelatedEntityID = relatedEntityID;
+    row.RelatedJoinField = relatedEntityID ? spec.relatedJoinField?.trim() || null : null;
+    const fieldNames = cleanNames(spec.replacesFieldNames);
+    row.ReplacesFieldNames = jsonArrayOrNull(fieldNames);
+    // One section is stored in the single-key column whichever spec field named it.
+    const sections = cleanNames([
+        ...(spec.replacesSectionKey ? [spec.replacesSectionKey] : []),
+        ...(spec.replacesSectionKeys ?? []),
+    ]);
+    row.ReplacesSectionKey = sections.length === 1 ? sections[0] : null;
+    row.ReplacesSectionKeys = sections.length > 1 ? JSON.stringify(sections) : null;
+    const inSection = spec.inSectionKey?.trim() || null;
+    row.InSectionKey = inSection;
+    row.SectionPosition = inSection || fieldNames.length > 0 ? spec.sectionPosition ?? null : null;
+}
+/** Trimmed, non-empty names without repeats, in their first-seen order. */
+function cleanNames(names) {
+    const out = [];
+    for (const raw of names ?? []) {
+        const name = typeof raw === 'string' ? raw.trim() : '';
+        if (name.length > 0 && !out.includes(name))
+            out.push(name);
+    }
+    return out;
+}
+function jsonArrayOrNull(names) {
+    return names.length > 0 ? JSON.stringify(names) : null;
+}
+//# sourceMappingURL=FormContributionRow.js.map

package/dist/custom/FormScope/FormContributionRow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormContributionRow.js","sourceRoot":"","sources":["../../../src/custom/FormScope/FormContributionRow.ts"],"names":[],"mappings":"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"}

package/dist/custom/FormScope/FormPanelHides.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Where a user's hidden panels are stored.
+ *
+ * A user can hide a panel someone else put on their form and bring it back later. The list is an
+ * `MJ: User Settings` value per entity: a JSON array of panel keys. Lives here so the browser,
+ * which applies the hides, and the server, which reports the form a user sees, read one key.
+ */
+/** `MJ: User Settings` key prefix for the per-entity list of hidden panels. */
+export declare const FORM_PANEL_HIDE_SETTING_PREFIX = "mj.formPanels.hidden.";
+/** The settings key for one entity. Trimmed and lowercased, so case variants share one row. */
+export declare function FormPanelHideSettingKey(entityName: string): string;
+/** The hidden keys in a stored setting, trimmed and without repeats. A missing or malformed value hides nothing. */
+export declare function ParseHiddenFormPanelKeys(raw: string | null | undefined): string[];
+//# sourceMappingURL=FormPanelHides.d.ts.map

package/dist/custom/FormScope/FormPanelHides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormPanelHides.d.ts","sourceRoot":"","sources":["../../../src/custom/FormScope/FormPanelHides.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,8BAA8B,0BAA0B,CAAC;AAEtE,+FAA+F;AAC/F,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,oHAAoH;AACpH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAWjF"}

package/dist/custom/FormScope/FormPanelHides.js

@@ -0,0 +1,32 @@
+import { SafeJSONParse } from '@memberjunction/global';
+/**
+ * Where a user's hidden panels are stored.
+ *
+ * A user can hide a panel someone else put on their form and bring it back later. The list is an
+ * `MJ: User Settings` value per entity: a JSON array of panel keys. Lives here so the browser,
+ * which applies the hides, and the server, which reports the form a user sees, read one key.
+ */
+/** `MJ: User Settings` key prefix for the per-entity list of hidden panels. */
+export const FORM_PANEL_HIDE_SETTING_PREFIX = 'mj.formPanels.hidden.';
+/** The settings key for one entity. Trimmed and lowercased, so case variants share one row. */
+export function FormPanelHideSettingKey(entityName) {
+    return FORM_PANEL_HIDE_SETTING_PREFIX + (entityName ?? '').trim().toLowerCase();
+}
+/** The hidden keys in a stored setting, trimmed and without repeats. A missing or malformed value hides nothing. */
+export function ParseHiddenFormPanelKeys(raw) {
+    if (!raw)
+        return [];
+    const parsed = SafeJSONParse(raw, false);
+    if (!Array.isArray(parsed))
+        return [];
+    const keys = [];
+    for (const item of parsed) {
+        if (typeof item !== 'string')
+            continue;
+        const key = item.trim();
+        if (key && !keys.includes(key))
+            keys.push(key);
+    }
+    return keys;
+}
+//# sourceMappingURL=FormPanelHides.js.map

package/dist/custom/FormScope/FormPanelHides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormPanelHides.js","sourceRoot":"","sources":["../../../src/custom/FormScope/FormPanelHides.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;;;;GAMG;AAEH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,8BAA8B,GAAG,uBAAuB,CAAC;AAEtE,+FAA+F;AAC/F,MAAM,UAAU,uBAAuB,CAAC,UAAkB;IACtD,OAAO,8BAA8B,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACpF,CAAC;AAED,oHAAoH;AACpH,MAAM,UAAU,wBAAwB,CAAC,GAA8B;IACnE,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,aAAa,CAAU,GAAG,EAAE,KAAK,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QACxB,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAS;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}