@memberjunction/core 6.1.0-edge.2 → 6.1.0-edge.3

package/LICENSE

@@ -1,7 +1,183 @@
-ISC License
+Business Source License 1.1
 
-Copyright (c) 2023 MemberJunction
+License text copyright (c) 2024 MariaDB plc, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB plc.
 
-Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+-----------------------------------------------------------------------------
 
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+Parameters
+
+Licensor:             Blue Cypress, Inc.
+
+Licensed Work:        MemberJunction.
+                      The Licensed Work is (c) 2023-2026 Blue Cypress, Inc.
+
+Additional Use Grant: Subject to the terms of this License, Licensor grants
+                      you the following additional rights to make Production
+                      Use of the Licensed Work.
+
+                      1. Internal Use
+
+                      You may make production use of the Licensed Work for
+                      your own internal business or organizational operations.
+
+                      2. Nonprofit Use
+
+                      If you are a Nonprofit, you may make production use of
+                      the Licensed Work for the operations and activities of
+                      your Organizational Family.
+
+                      3. MemberJunction Certified Program Use
+
+                      If you are authorized by Licensor under the
+                      MemberJunction Certified Program to provide professional
+                      services using the Licensed Work, you may make
+                      production use of the Licensed Work in providing such
+                      professional services to a client, provided that:
+
+                      (a) the Licensed Work is deployed in, and the applicable
+                      production use occurs within, an environment owned,
+                      leased, licensed, subscribed to, or otherwise controlled
+                      by that client; and
+
+                      (b) the production use is for that client's own internal
+                      business or organizational operations or is otherwise
+                      independently permitted to that client under this
+                      Additional Use Grant.
+
+                      4. Definitions Applicable to the Additional Use Grant
+
+                      "Affiliate" means, with respect to a specified Person,
+                      any other Person that directly or indirectly Controls,
+                      is Controlled by, or is under common Control with such
+                      specified Person.
+
+                      "Control" (including the terms "Controls," "Controlled
+                      by," and "under common Control with") means the direct
+                      or indirect possession of the power to direct or cause
+                      the direction of the management and policies of a
+                      Person, whether through ownership of voting interests,
+                      by contract, or otherwise.
+
+                      "Organizational Family" means, with respect to a Person,
+                      (a) such Person and its Affiliates, and (b) any
+                      nonprofit organization, governmental entity, chapter,
+                      division, local affiliate, regional affiliate, state
+                      affiliate, national affiliate, or other entity that is
+                      formally affiliated with such Person through governing
+                      documents, a charter, bylaws, a membership agreement, or
+                      another written organizational instrument, and is
+                      recognized under such documents as part of the same
+                      organizational structure.
+
+                      "Nonprofit" means a Person recognized by the Internal
+                      Revenue Service as exempt from federal income taxation
+                      under Section 501(c)(3), 501(c)(4), 501(c)(5), or
+                      501(c)(6) of the Internal Revenue Code, or a foreign
+                      organization recognized under substantially equivalent
+                      laws.
+
+                      A Person claiming eligibility as a Nonprofit shall, upon
+                      Licensor's reasonable request, provide documentation
+                      reasonably sufficient to demonstrate that it qualifies
+                      as a Nonprofit. If such Person materially misrepresents,
+                      or is unable to demonstrate, its qualification as a
+                      Nonprofit, the rights granted to such Person under
+                      Section 2 of this Additional Use Grant shall terminate.
+
+                      "MemberJunction Certified Program" means Licensor's
+                      then-current program for certifying and authorizing a
+                      Person to provide professional services using the
+                      Licensed Work.
+
+                      "Person" means any individual, corporation, limited
+                      liability company, partnership, association, nonprofit
+                      organization, governmental entity, or other legal or
+                      organizational entity.
+
+Change Date:          Four (4) years from the date the Licensed Work is first
+                      made available.
+
+Change License:       MIT License.
+
+For information about alternative licensing arrangements for the Licensed
+Work, please contact Blue Cypress, Inc.
+
+-----------------------------------------------------------------------------
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License's text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+-----------------------------------------------------------------------------
+
+Covenants of Licensor
+
+In consideration of the right to use this License's text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where "compatible" means that software provided under the Change License
+   can be included in a program with software provided under GPL Version 2.0
+   or a later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.
+
+-----------------------------------------------------------------------------
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.

package/dist/generic/JSONType-interfaces/IEntityConfiguration.d.ts

@@ -0,0 +1,120 @@
+/**
+ * AUTO-COPIED FROM metadata/entities/JSONType-interfaces/IEntityConfiguration.ts
+ * DO NOT EDIT DIRECTLY. Run `pnpm run build` in MJCore to refresh.
+ */
+/**
+ * Optional per-entity configuration bag.
+ *
+ * Stored as JSON in `MJ: Entities.Configuration`. CodeGen emits a typed
+ * `ConfigurationObject` accessor on `MJEntityEntity` that returns
+ * `IEntityConfiguration | null`.
+ *
+ * **NULL / `{}` / omitted keys** use the defaults on
+ * {@link IEntityFormConfiguration} (`Layout: auto`, `RelatedRolePolicy: smart`).
+ * Membership itself is L1 inclusion + L2 ranker + L3 `MJ: Form Chrome Rules`
+ * + L4 user order. `BaseFormPolicy.DecorateChrome` is cosmetics only.
+ *
+ * Expand by adding a property here — no schema migration. Anything the engine
+ * filters, sorts, or joins on stays a **column** on `Entity`. Anything the UI
+ * consumes at render time belongs in this bag.
+ *
+ * @see guides/FORMS_ARCHITECTURE_GUIDE.md §7d
+ */
+export interface IEntityConfiguration {
+    /**
+     * Presentation / chrome. Null = host defaults (`Layout: auto`,
+     * `RelatedRolePolicy: smart`).
+     */
+    UI?: IEntityUIConfiguration;
+    /**
+     * Optional file attachment configuration for this entity.
+     * Controls whether attachments are permitted and sets entity-level upload policies.
+     */
+    Attachments?: IEntityAttachmentsConfiguration;
+}
+/**
+ * Configuration for entity-level file attachments.
+ */
+export interface IEntityAttachmentsConfiguration {
+    /**
+     * Whether file attachments/linking are enabled for this entity.
+     * Default: true when storage providers are active. Set to false to explicitly disallow attachments.
+     */
+    Enabled?: boolean;
+    /**
+     * Maximum allowed size per attachment in bytes (e.g. 52428800 for 50MB).
+     * When omitted, uses global storage provider default.
+     */
+    MaxFileSizeBytes?: number;
+    /**
+     * Allowed MIME types or file extensions (e.g. ['image/*', 'application/pdf', '.docx']).
+     * When omitted, all file types supported by the storage provider are allowed.
+     */
+    AllowedContentTypes?: string[];
+    /**
+     * Optional default Storage Account ID to route uploads for this entity.
+     */
+    DefaultStorageAccountID?: string;
+    /**
+     * Optional default File Category ID for attachments on this entity.
+     */
+    DefaultCategoryID?: string;
+}
+/**
+ * Entity-level presentation configuration.
+ *
+ * Nested under {@link IEntityConfiguration.UI} so later UI concerns (list
+ * cards, search chrome, map defaults) can sit beside `Form` without a
+ * migration.
+ */
+export interface IEntityUIConfiguration {
+    /**
+     * How the generated record form arranges its sections.
+     * Null = inherit {@link IEntityFormConfiguration} defaults.
+     */
+    Form?: IEntityFormConfiguration;
+}
+/**
+ * Generated-form chrome for this entity (L2 defaults).
+ *
+ * Consumed by `<mj-record-form-container>`. L1 `inclusion` and L3
+ * `MJ: Form Chrome Rules` decide membership; this bag only ranks Auto
+ * leftovers and chooses accordion vs left-nav.
+ */
+export interface IEntityFormConfiguration {
+    /**
+     * Layout chrome for the generated form.
+     *
+     * - `'accordion'` — every first-class section is a collapsible panel.
+     * - `'left-nav'` — a left rail of section groups; the body shows one group.
+     * - `'auto'` — accordion until the first-class section count reaches
+     *   {@link AutoLeftNavAt}, then left-nav.
+     *
+     * Omit to treat as `'auto'`.
+     */
+    Layout?: 'accordion' | 'left-nav' | 'auto';
+    /**
+     * Section-count threshold used when {@link Layout} is `'auto'` (or omitted).
+     * Defaults to 8. Ignored for an explicit `'accordion'` or `'left-nav'`.
+     */
+    AutoLeftNavAt?: number;
+    /**
+     * How Auto (omitted inclusion) relationships are resolved.
+     *
+     * - `'keep-all-primary'` — every remaining Auto related stays first-class.
+     * - `'smart'` — budgeted ranker: same-schema 1:N / collections / custom
+     *   display components stay top-level; cross-schema hang-ons and platform
+     *   plumbing fold into More once the Auto pool exceeds
+     *   {@link PrimaryRelatedBudget}.
+     *
+     * Omit to treat as `'smart'`.
+     */
+    RelatedRolePolicy?: 'keep-all-primary' | 'smart';
+    /**
+     * Max Auto related grids that stay first-class when
+     * {@link RelatedRolePolicy} is `'smart'`. Default 6. Explicit
+     * `inclusion: 'Primary'` is never capped by this number.
+     */
+    PrimaryRelatedBudget?: number;
+}
+//# sourceMappingURL=IEntityConfiguration.d.ts.map

package/dist/generic/JSONType-interfaces/IEntityConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEntityConfiguration.d.ts","sourceRoot":"","sources":["../../../src/generic/JSONType-interfaces/IEntityConfiguration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;OAGG;IACH,EAAE,CAAC,EAAE,sBAAsB,CAAC;IAE5B;;;OAGG;IACH,WAAW,CAAC,EAAE,+BAA+B,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC5C;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE/B;;OAEG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACnC;;;OAGG;IACH,IAAI,CAAC,EAAE,wBAAwB,CAAC;CACnC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACrC;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;IAE3C;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC;IAEjD;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACjC"}

package/dist/generic/JSONType-interfaces/IEntityConfiguration.js

@@ -0,0 +1,6 @@
+/**
+ * AUTO-COPIED FROM metadata/entities/JSONType-interfaces/IEntityConfiguration.ts
+ * DO NOT EDIT DIRECTLY. Run `pnpm run build` in MJCore to refresh.
+ */
+export {};
+//# sourceMappingURL=IEntityConfiguration.js.map

package/dist/generic/JSONType-interfaces/IEntityConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEntityConfiguration.js","sourceRoot":"","sources":["../../../src/generic/JSONType-interfaces/IEntityConfiguration.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/generic/JSONType-interfaces/IEntityFieldConfiguration.d.ts

@@ -0,0 +1,31 @@
+/**
+ * AUTO-COPIED FROM metadata/entities/JSONType-interfaces/IEntityFieldConfiguration.ts
+ * DO NOT EDIT DIRECTLY. Run `pnpm run build` in MJCore to refresh.
+ */
+/**
+ * Optional per-field configuration bag.
+ *
+ * Stored as JSON in `MJ: Entity Fields.Configuration`. CodeGen emits a
+ * typed `ConfigurationObject` accessor on `MJEntityFieldEntity` that
+ * returns `IEntityFieldConfiguration | null`.
+ */
+export interface IEntityFieldConfiguration {
+    /**
+     * Hierarchy and tree structure configuration for self-referencing foreign keys.
+     */
+    Hierarchy?: IEntityFieldHierarchyConfig;
+}
+/**
+ * Hierarchy options to explicitly declare recursive tree hierarchies.
+ */
+export interface IEntityFieldHierarchyConfig {
+    /**
+     * When true, declares this self-referencing foreign key as an intentional tree hierarchy.
+     */
+    IsHierarchy?: boolean;
+    /**
+     * Optional custom maximum recursion depth guard (defaults to 100).
+     */
+    MaxDepth?: number;
+}
+//# sourceMappingURL=IEntityFieldConfiguration.d.ts.map

package/dist/generic/JSONType-interfaces/IEntityFieldConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEntityFieldConfiguration.d.ts","sourceRoot":"","sources":["../../../src/generic/JSONType-interfaces/IEntityFieldConfiguration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACtC;;OAEG;IACH,SAAS,CAAC,EAAE,2BAA2B,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IACxC;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/generic/JSONType-interfaces/IEntityFieldConfiguration.js

@@ -0,0 +1,6 @@
+/**
+ * AUTO-COPIED FROM metadata/entities/JSONType-interfaces/IEntityFieldConfiguration.ts
+ * DO NOT EDIT DIRECTLY. Run `pnpm run build` in MJCore to refresh.
+ */
+export {};
+//# sourceMappingURL=IEntityFieldConfiguration.js.map

package/dist/generic/JSONType-interfaces/IEntityFieldConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEntityFieldConfiguration.js","sourceRoot":"","sources":["../../../src/generic/JSONType-interfaces/IEntityFieldConfiguration.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/generic/JSONType-interfaces/IEntityRelationshipConfiguration.d.ts

@@ -0,0 +1,75 @@
+/**
+ * AUTO-COPIED FROM metadata/entities/JSONType-interfaces/IEntityRelationshipConfiguration.ts
+ * DO NOT EDIT DIRECTLY. Run `pnpm run build` in MJCore to refresh.
+ */
+/**
+ * Optional per-relationship configuration bag.
+ *
+ * Stored as JSON in `MJ: Entity Relationships.Configuration`. CodeGen emits a
+ * typed `ConfigurationObject` accessor on `MJEntityRelationshipEntity` that
+ * returns `IEntityRelationshipConfiguration | null`.
+ *
+ * Distinct from the other JSON columns on the same row, which CodeGen already
+ * owns for other jobs:
+ *
+ * - `RelatedRecordCollection` — `IRelatedRecordCollectionConfig` (composite graphs)
+ * - `DisplayComponentConfiguration` — knobs for the selected display component
+ * - `AdditionalFieldsToInclude` — join-field name list
+ *
+ * **NULL / `{}` / omitted keys = Auto.** The parent entity's
+ * `RelatedRolePolicy` ranker decides Primary vs More. Explicit
+ * `inclusion` (or the `FormRole` alias) always wins.
+ * `inclusion: 'None'` removes the relationship from the parent form
+ * entirely — it is not a More item and the ranker never sees it.
+ *
+ * Expand by adding a property here — no schema migration.
+ *
+ * @see guides/FORMS_ARCHITECTURE_GUIDE.md §7d
+ */
+export interface IEntityRelationshipConfiguration {
+    /**
+     * Presentation / chrome for this relationship on the parent form.
+     * Null = the parent entity's related-role ranker decides.
+     */
+    UI?: IEntityRelationshipUIConfiguration;
+}
+/**
+ * How this relationship appears on the parent entity's generated form.
+ *
+ * Nested under {@link IEntityRelationshipConfiguration.UI} so later UI
+ * concerns (group, default-expanded, badge) can sit beside `inclusion`
+ * without a migration.
+ */
+export interface IEntityRelationshipUIConfiguration {
+    /**
+     * L1 inclusion on the parent form. Keyed conceptually by
+     * (parent, related entity), not by a single FK.
+     *
+     * - `'Primary'` — first-class rail.
+     * - `'More'` — candidate, parked in More.
+     * - `'None'` — not a candidate. Not in More. Ranker never sees it.
+     *
+     * Omit = Auto (L2 ranker). See [Forms Architecture §7d](../../../../guides/FORMS_ARCHITECTURE_GUIDE.md).
+     */
+    inclusion?: 'Primary' | 'More' | 'None';
+    /**
+     * Alias of {@link inclusion}. `'Primary'` maps to Primary,
+     * `'Detail'` maps to More.
+     */
+    FormRole?: 'Primary' | 'Detail';
+    /**
+     * Same-table OR of FKs for one parent-form section
+     * (Bill-To OR Ship-To Orders). Sibling ERs to the same related entity
+     * should be `inclusion: 'None'` so they do not sprout extra rail items.
+     */
+    join?: {
+        mode: 'any';
+        fields: string[];
+    };
+    /**
+     * Higher = earlier among first-class related rail items (after Details,
+     * after lead contributions such as Overview). Omit = 0.
+     */
+    sortKey?: number;
+}
+//# sourceMappingURL=IEntityRelationshipConfiguration.d.ts.map

package/dist/generic/JSONType-interfaces/IEntityRelationshipConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEntityRelationshipConfiguration.d.ts","sourceRoot":"","sources":["../../../src/generic/JSONType-interfaces/IEntityRelationshipConfiguration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,gCAAgC;IAC7C;;;OAGG;IACH,EAAE,CAAC,EAAE,kCAAkC,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kCAAkC;IAC/C;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAExC;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAEhC;;;;OAIG;IACH,IAAI,CAAC,EAAE;QACH,IAAI,EAAE,KAAK,CAAC;QACZ,MAAM,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IAEF;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/generic/JSONType-interfaces/IEntityRelationshipConfiguration.js

@@ -0,0 +1,6 @@
+/**
+ * AUTO-COPIED FROM metadata/entities/JSONType-interfaces/IEntityRelationshipConfiguration.ts
+ * DO NOT EDIT DIRECTLY. Run `pnpm run build` in MJCore to refresh.
+ */
+export {};
+//# sourceMappingURL=IEntityRelationshipConfiguration.js.map

package/dist/generic/JSONType-interfaces/IEntityRelationshipConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEntityRelationshipConfiguration.js","sourceRoot":"","sources":["../../../src/generic/JSONType-interfaces/IEntityRelationshipConfiguration.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/generic/JSONType-interfaces/IFileStorageProviderConfiguration.d.ts

@@ -0,0 +1,19 @@
+/**
+ * AUTO-COPIED FROM metadata/entities/JSONType-interfaces/IFileStorageProviderConfiguration.ts
+ * DO NOT EDIT DIRECTLY. Run `pnpm run build` in MJCore to refresh.
+ */
+/**
+ * Optional per-storage-provider configuration bag.
+ * Stored as JSON in `MJ: File Storage Providers.Configuration`.
+ */
+export interface IFileStorageProviderConfiguration {
+    /**
+     * FontAwesome icon class for displaying the storage provider in UI components (e.g. 'fa-solid fa-box', 'fa-brands fa-aws').
+     */
+    IconClass?: string;
+    /**
+     * Optional brand color for badges and accents (e.g. '#0061D5').
+     */
+    BrandColor?: string;
+}
+//# sourceMappingURL=IFileStorageProviderConfiguration.d.ts.map

package/dist/generic/JSONType-interfaces/IFileStorageProviderConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFileStorageProviderConfiguration.d.ts","sourceRoot":"","sources":["../../../src/generic/JSONType-interfaces/IFileStorageProviderConfiguration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,iCAAiC;IAC9C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/generic/JSONType-interfaces/IFileStorageProviderConfiguration.js

@@ -0,0 +1,6 @@
+/**
+ * AUTO-COPIED FROM metadata/entities/JSONType-interfaces/IFileStorageProviderConfiguration.ts
+ * DO NOT EDIT DIRECTLY. Run `pnpm run build` in MJCore to refresh.
+ */
+export {};
+//# sourceMappingURL=IFileStorageProviderConfiguration.js.map

package/dist/generic/JSONType-interfaces/IFileStorageProviderConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFileStorageProviderConfiguration.js","sourceRoot":"","sources":["../../../src/generic/JSONType-interfaces/IFileStorageProviderConfiguration.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/generic/authTypes.d.ts

@@ -76,6 +76,75 @@ export interface AuthProviderConfig {
      */
     [key: string]: any;
 }
+/**
+ * Flat key/value configuration handed to a BROWSER auth driver.
+ *
+ * Deliberately flat and primitive-valued: every value here is published in the
+ * unauthenticated pre-auth provider catalog, so the shape doubles as a reminder
+ * that nothing structured or sensitive belongs in it. Nested objects would make
+ * it easy to smuggle a credential blob into a "config" field.
+ */
+export type PublicAuthProviderClientConfig = Record<string, string | number | boolean | null>;
+/**
+ * The PUBLIC description of one authentication provider, as published by the
+ * server's unauthenticated catalog endpoint (`GET /auth/providers`) and consumed
+ * by the browser before any user is signed in.
+ *
+ * This type is the trust boundary made explicit. It contains ONLY fields that are
+ * safe for an anonymous caller to read — the same values a single-provider SPA
+ * already had compiled into its `environment.ts`. It intentionally has no `ID`,
+ * no `credentialID`, and no server-side configuration, so a provider row cannot
+ * leak secret material by being published.
+ *
+ * @see AuthProviderConfig for the richer SERVER-side config used to validate tokens.
+ */
+export interface PublicAuthProviderInfo {
+    /**
+     * Unique provider name — matches the name the server registered with
+     * `AuthProviderFactory`, and is what the browser persists when a user picks
+     * a provider from the login picker.
+     */
+    name: string;
+    /**
+     * ClassFactory resolution key. The browser resolves its `MJAuthBase` subclass
+     * from this key exactly as the server resolves its `BaseAuthProvider` subclass,
+     * so a driver ships as a server/browser pair under one name.
+     */
+    driverClass: string;
+    /**
+     * Label for the login button (rendered as "Continue with {displayName}").
+     * The server falls back to `name` when the row has no DisplayName.
+     */
+    displayName: string;
+    /** Font Awesome class or known brand-logo key for the button's icon chip. */
+    icon?: string;
+    /** Ascending sort order within the picker. */
+    sequence: number;
+    /** True when this provider is pre-highlighted, and used directly when it is the only one. */
+    isDefault: boolean;
+    /** Public OAuth client ID. */
+    clientId?: string;
+    /** Expected token issuer. */
+    issuer?: string;
+    /** Provider domain (e.g. an Auth0/Okta tenant domain). */
+    domain?: string;
+    /**
+     * OAuth scopes to request, already parsed. The server splits the row's delimited `Scopes`
+     * column once at the trust boundary, so every consumer — the browser drivers hand this
+     * straight to SDK config typed `string[]` — receives ready-to-use values instead of
+     * re-deriving the delimiter convention.
+     */
+    scopes?: string[];
+    /** Driver-specific browser settings (redirect URI, API hostname, region, ...). */
+    clientConfiguration?: PublicAuthProviderClientConfig;
+}
+/**
+ * Response body of the unauthenticated `GET /auth/providers` catalog endpoint.
+ */
+export interface PublicAuthProviderCatalog {
+    /** Active, client-visible providers, already sorted by `sequence` then `displayName`. */
+    providers: PublicAuthProviderInfo[];
+}
 /**
  * User information extracted from authentication tokens or user profiles
  */

package/dist/generic/authTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authTypes.d.ts","sourceRoot":"","sources":["../../src/generic/authTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;CAQtB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,mBAAmB,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAE5F;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}
+{"version":3,"file":"authTypes.d.ts","sourceRoot":"","sources":["../../src/generic/authTypes.ts"],"names":[],"mappings":"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"}

package/dist/generic/baseEngine.d.ts

@@ -839,6 +839,20 @@ export declare abstract class BaseEngine<T> extends BaseSingleton<T> implements
      * @param event - The cache change event from the other server
      */
     protected OnExternalCacheChange(config: BaseEnginePropertyConfig, event: CacheChangedEvent): Promise<void>;
+    /**
+     * Converts rows from a cache-change payload into the shape this config's property expects.
+     *
+     * Cache payloads are JSON, so their rows are plain objects with string dates. A config loaded
+     * as `entity_object` must not receive them directly — the property's declared element type
+     * would be violated and BaseEntity's coercing accessors bypassed, which is what turns a typed
+     * `__mj_CreatedAt` into a raw string at runtime. Mirrors the conversion the RunView cache-hit
+     * path performs, and enforces in this direction the same type-homogeneity invariant
+     * {@link canUseImmediateMutation} enforces for the sibling mutation path.
+     *
+     * @returns the rows to assign, or null when they cannot be safely materialized (caller should
+     *          fall back to a full reload).
+     */
+    private materializeCacheEventRows;
     /**
      * Sets an expiration timer for a metadata property.
      * @param propertyName - The name of the property