@memberjunction/core-actions 5.36.0 → 5.38.0

package/dist/custom/interactive-forms/get-active-form-for-entity.action.js

@@ -0,0 +1,179 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseAction } from "@memberjunction/actions";
+import { Metadata, LogError, RunView } from "@memberjunction/core";
+import { RegisterClass } from "@memberjunction/global";
+/**
+ * Read-only action that returns the currently-resolved interactive-form
+ * override (if any) for the (entity, user) pair plus the full list of
+ * applicable variants. Used by the Form Builder agent to decide between
+ * Create (no override exists) and Modify (an override already exists).
+ *
+ * Resolution mirrors {@link FormResolverService} on the client:
+ *   - Scope precedence: User > Role > Global.
+ *   - Within a tier: Priority DESC, then __mj_CreatedAt DESC.
+ *   - Only Status='Active' rows are considered for the "active" pick. The
+ *     full variants list includes 'Pending' rows so the agent can recognize
+ *     an in-flight refinement loop and reuse the Pending row instead of
+ *     spawning a new one.
+ *
+ * Output shape (JSON in `Message`, also surfaced as a `Result` output param):
+ * ```
+ * {
+ *   "EntityName": "MJ: Applications",
+ *   "Active": {
+ *     "OverrideID": "...",
+ *     "ComponentID": "...",
+ *     "Scope": "User" | "Role" | "Global",
+ *     "Priority": 0,
+ *     "Status": "Active",
+ *     "Spec": <ComponentSpec>,
+ *     "ComponentName": "...",
+ *     "ComponentVersion": "1.0.0",
+ *     "VersionSequence": 1
+ *   } | null,
+ *   "Variants": [{ ...same shape... }, ...]   // all applicable, all statuses
+ * }
+ * ```
+ *
+ * If no overrides exist, `Active` is null and `Variants` is empty —
+ * the calling agent should then call `Get Default Form Scaffold For Entity`
+ * and `Create Interactive Form`.
+ */
+let GetActiveFormForEntityAction = class GetActiveFormForEntityAction extends BaseAction {
+    async InternalRunAction(params) {
+        try {
+            const entityName = this.getStringParam(params, "EntityName");
+            if (!entityName) {
+                return failure("MISSING_PARAMETER", "Parameter 'EntityName' is required.");
+            }
+            const provider = params.Provider ?? Metadata.Provider;
+            if (!provider) {
+                return failure("NO_PROVIDER", "No metadata provider available.");
+            }
+            const user = params.ContextUser;
+            if (!user) {
+                return failure("NO_USER", "Action requires a ContextUser for scope resolution.");
+            }
+            const entity = provider.EntityByName(entityName);
+            if (!entity) {
+                return failure("ENTITY_NOT_FOUND", `Entity '${entityName}' is not registered with the active metadata provider.`);
+            }
+            // Pull all overrides applicable to this user — User-scoped to this user,
+            // Role-scoped if user has any of the listed roles, or Global. We let the
+            // database filter and we sort + select winner in code below.
+            const rv = RunView.FromMetadataProvider(provider);
+            const userRoles = Array.isArray(user.UserRoles)
+                ? (user.UserRoles ?? []).map(r => r.RoleID).filter((x) => !!x)
+                : [];
+            const filterClauses = [
+                `EntityID='${entity.ID}'`,
+                `(Scope='Global' OR (Scope='User' AND UserID='${user.ID}')${userRoles.length ? ` OR (Scope='Role' AND RoleID IN (${userRoles.map(r => `'${r}'`).join(",")}))` : ''})`,
+            ];
+            const overrideResult = await rv.RunView({
+                EntityName: "MJ: Entity Form Overrides",
+                ExtraFilter: filterClauses.join(' AND '),
+                Fields: ['ID', 'EntityID', 'ComponentID', 'Name', 'Description', 'Scope', 'UserID', 'RoleID', 'Priority', 'Status'],
+                ResultType: 'simple',
+            }, user);
+            if (!overrideResult.Success) {
+                return failure("QUERY_FAILED", `Override lookup failed: ${overrideResult.ErrorMessage ?? 'unknown error'}`);
+            }
+            const overrides = overrideResult.Results ?? [];
+            if (overrides.length === 0) {
+                const payload = { EntityName: entityName, Active: null, Variants: [] };
+                params.Params.push({ Name: "Result", Type: "Output", Value: payload });
+                return {
+                    Success: true,
+                    ResultCode: "SUCCESS",
+                    Message: JSON.stringify(payload),
+                };
+            }
+            // Hydrate the referenced Components in one batch.
+            const componentIDs = Array.from(new Set(overrides.map(o => o.ComponentID))).filter(Boolean);
+            const componentsResult = await rv.RunView({
+                EntityName: "MJ: Components",
+                ExtraFilter: `ID IN (${componentIDs.map(id => `'${id}'`).join(",")})`,
+                Fields: ['ID', 'Name', 'Version', 'VersionSequence', 'Status', 'Specification'],
+                ResultType: 'simple',
+            }, user);
+            const componentByID = new Map((componentsResult.Results ?? []).map(c => [c.ID, c]));
+            const variants = overrides.map(o => {
+                const component = componentByID.get(o.ComponentID);
+                let spec = null;
+                if (component?.Specification) {
+                    try {
+                        spec = JSON.parse(component.Specification);
+                    }
+                    catch {
+                        // Bad spec JSON — we don't fail the whole action; we surface
+                        // the variant without a parsed spec and let the caller decide.
+                        spec = null;
+                    }
+                }
+                return {
+                    OverrideID: o.ID,
+                    ComponentID: o.ComponentID,
+                    Scope: o.Scope,
+                    Priority: o.Priority ?? 0,
+                    Status: o.Status,
+                    Name: o.Name,
+                    Description: o.Description,
+                    Spec: spec,
+                    ComponentName: component?.Name ?? null,
+                    ComponentVersion: component?.Version ?? null,
+                    VersionSequence: component?.VersionSequence ?? null,
+                };
+            });
+            // Sort by scope tier (User=1, Role=2, Global=3), then Priority DESC.
+            // We don't have CreatedAt in the lightweight query — ties at this
+            // point default to the order the DB returned, which is usually
+            // creation order. The resolver service does the same.
+            variants.sort((a, b) => {
+                const tierA = a.Scope === 'User' ? 1 : a.Scope === 'Role' ? 2 : 3;
+                const tierB = b.Scope === 'User' ? 1 : b.Scope === 'Role' ? 2 : 3;
+                if (tierA !== tierB)
+                    return tierA - tierB;
+                return (b.Priority ?? 0) - (a.Priority ?? 0);
+            });
+            const active = variants.find(v => v.Status === 'Active') ?? null;
+            const payload = { EntityName: entityName, Active: active, Variants: variants };
+            params.Params.push({ Name: "Result", Type: "Output", Value: payload });
+            return {
+                Success: true,
+                ResultCode: "SUCCESS",
+                Message: JSON.stringify(payload),
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            LogError(`GetActiveFormForEntityAction: ${message}`);
+            return failure("UNEXPECTED_ERROR", message);
+        }
+    }
+    getStringParam(params, name) {
+        const p = params.Params.find(x => x.Name?.trim().toLowerCase() === name.toLowerCase());
+        if (!p || p.Value == null)
+            return null;
+        const v = String(p.Value).trim();
+        return v.length > 0 ? v : null;
+    }
+};
+GetActiveFormForEntityAction = __decorate([
+    RegisterClass(BaseAction, "__GetActiveFormForEntity")
+], GetActiveFormForEntityAction);
+export { GetActiveFormForEntityAction };
+function failure(resultCode, message) {
+    return { Success: false, ResultCode: resultCode, Message: message };
+}
+/** Tree-shaking guard — called from src/index.ts. */
+export function LoadGetActiveFormForEntityAction() {
+    if (false) {
+        const _ = GetActiveFormForEntityAction;
+    }
+}
+//# sourceMappingURL=get-active-form-for-entity.action.js.map

package/dist/custom/interactive-forms/get-active-form-for-entity.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-active-form-for-entity.action.js","sourceRoot":"","sources":["../../../src/custom/interactive-forms/get-active-form-for-entity.action.ts"],"names":[],"mappings":"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"}

package/dist/custom/interactive-forms/get-default-form-scaffold.action.d.ts

@@ -0,0 +1,32 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Read-only action that produces a working form-role `ComponentSpec`
+ * scaffolded from the entity's CodeGen metadata (Category /
+ * GeneratedFormSectionType / Sequence / FK relationships / value lists).
+ *
+ * **Why this exists.** Today the Form Builder agent writes JSX from
+ * scratch every time, producing inconsistent quality. Calling this action
+ * first gives the agent a known-good baseline (mirrors the default Angular
+ * form) that it can modify per user requirements instead of inventing a
+ * layout. Far fewer lint failures, dramatically better starting point.
+ *
+ * **Pure read.** No persistence. The returned spec is intended to be
+ * modified and then passed to {@link CreateInteractiveFormAction} or
+ * {@link ModifyInteractiveFormAction}.
+ */
+export declare class GetDefaultFormScaffoldForEntityAction extends BaseAction {
+    /**
+     * Required input:
+     *   - `EntityName` (string) — fully-qualified entity name, e.g. "MJ: Applications".
+     *
+     * Output:
+     *   - `Spec` parameter — the scaffolded `ComponentSpec` object (componentRole='form', location='embedded').
+     *   - `Message` — the same object, stringified.
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    private getStringParam;
+}
+/** Tree-shaking guard — called from src/index.ts. */
+export declare function LoadGetDefaultFormScaffoldForEntityAction(): void;
+//# sourceMappingURL=get-default-form-scaffold.action.d.ts.map

package/dist/custom/interactive-forms/get-default-form-scaffold.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-default-form-scaffold.action.d.ts","sourceRoot":"","sources":["../../../src/custom/interactive-forms/get-default-form-scaffold.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAKrD;;;;;;;;;;;;;;GAcG;AACH,qBACa,qCAAsC,SAAQ,UAAU;IAEjE;;;;;;;OAOG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsCvF,OAAO,CAAC,cAAc;CAOzB;AAMD,qDAAqD;AACrD,wBAAgB,yCAAyC,IAAI,IAAI,CAIhE"}

package/dist/custom/interactive-forms/get-default-form-scaffold.action.js

@@ -0,0 +1,87 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseAction } from "@memberjunction/actions";
+import { Metadata, LogError } from "@memberjunction/core";
+import { RegisterClass } from "@memberjunction/global";
+import { buildDefaultFormScaffold } from "@memberjunction/interactive-component-types/forms";
+/**
+ * Read-only action that produces a working form-role `ComponentSpec`
+ * scaffolded from the entity's CodeGen metadata (Category /
+ * GeneratedFormSectionType / Sequence / FK relationships / value lists).
+ *
+ * **Why this exists.** Today the Form Builder agent writes JSX from
+ * scratch every time, producing inconsistent quality. Calling this action
+ * first gives the agent a known-good baseline (mirrors the default Angular
+ * form) that it can modify per user requirements instead of inventing a
+ * layout. Far fewer lint failures, dramatically better starting point.
+ *
+ * **Pure read.** No persistence. The returned spec is intended to be
+ * modified and then passed to {@link CreateInteractiveFormAction} or
+ * {@link ModifyInteractiveFormAction}.
+ */
+let GetDefaultFormScaffoldForEntityAction = class GetDefaultFormScaffoldForEntityAction extends BaseAction {
+    /**
+     * Required input:
+     *   - `EntityName` (string) — fully-qualified entity name, e.g. "MJ: Applications".
+     *
+     * Output:
+     *   - `Spec` parameter — the scaffolded `ComponentSpec` object (componentRole='form', location='embedded').
+     *   - `Message` — the same object, stringified.
+     */
+    async InternalRunAction(params) {
+        try {
+            const entityName = this.getStringParam(params, "EntityName");
+            if (!entityName) {
+                return failure("MISSING_PARAMETER", "Parameter 'EntityName' is required.");
+            }
+            const provider = params.Provider ?? Metadata.Provider;
+            if (!provider) {
+                return failure("NO_PROVIDER", "No metadata provider available.");
+            }
+            const spec = buildDefaultFormScaffold(entityName, provider);
+            if (!spec) {
+                return failure("ENTITY_NOT_FOUND", `Entity '${entityName}' is not registered with the active metadata provider.`);
+            }
+            params.Params.push({
+                Name: "Spec",
+                Type: "Output",
+                Value: spec,
+            });
+            return {
+                Success: true,
+                ResultCode: "SUCCESS",
+                Message: JSON.stringify(spec),
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            LogError(`GetDefaultFormScaffoldForEntityAction: ${message}`);
+            return failure("UNEXPECTED_ERROR", message);
+        }
+    }
+    getStringParam(params, name) {
+        const p = params.Params.find(x => x.Name?.trim().toLowerCase() === name.toLowerCase());
+        if (!p || p.Value == null)
+            return null;
+        const v = String(p.Value).trim();
+        return v.length > 0 ? v : null;
+    }
+};
+GetDefaultFormScaffoldForEntityAction = __decorate([
+    RegisterClass(BaseAction, "__GetDefaultFormScaffoldForEntity")
+], GetDefaultFormScaffoldForEntityAction);
+export { GetDefaultFormScaffoldForEntityAction };
+function failure(resultCode, message) {
+    return { Success: false, ResultCode: resultCode, Message: message };
+}
+/** Tree-shaking guard — called from src/index.ts. */
+export function LoadGetDefaultFormScaffoldForEntityAction() {
+    if (false) {
+        const _ = GetDefaultFormScaffoldForEntityAction;
+    }
+}
+//# sourceMappingURL=get-default-form-scaffold.action.js.map

package/dist/custom/interactive-forms/get-default-form-scaffold.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-default-form-scaffold.action.js","sourceRoot":"","sources":["../../../src/custom/interactive-forms/get-default-form-scaffold.action.ts"],"names":[],"mappings":"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"}

package/dist/custom/interactive-forms/get-entity-schema-for-form.action.d.ts

@@ -0,0 +1,34 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Read-only action consumed by the Form Builder agent to inspect an entity's
+ * curated form-relevant schema before generating a form Component.
+ *
+ * Returns the `CuratedFormSchema` shape: FK references resolved to
+ * `{entity, displayField}`, value-list fields annotated with `allowedValues`,
+ * and audit / virtual / computed fields stripped. See
+ * `@memberjunction/interactive-component-types/forms` for the type.
+ *
+ * Output is stringified JSON in `Message` (Action framework convention) and
+ * also surfaced as a `Schema` output parameter for callers that prefer
+ * structured access.
+ */
+export declare class GetEntitySchemaForFormAction extends BaseAction {
+    /**
+     * Required input:
+     *   - `EntityName` (string) — fully-qualified entity name, e.g. "MJ: Applications".
+     *
+     * Output:
+     *   - `Schema` parameter — the `CuratedFormSchema` object.
+     *   - `Message` — the same object, stringified.
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /** Case-insensitive trim-tolerant fetch for the EntityName param. */
+    private getEntityNameParam;
+}
+/**
+ * Tree-shaking guard. Imported and called from src/index.ts so bundlers
+ * don't drop the action when no consumer references it by name.
+ */
+export declare function LoadGetEntitySchemaForFormAction(): void;
+//# sourceMappingURL=get-entity-schema-for-form.action.d.ts.map

package/dist/custom/interactive-forms/get-entity-schema-for-form.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity-schema-for-form.action.d.ts","sourceRoot":"","sources":["../../../src/custom/interactive-forms/get-entity-schema-for-form.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAKrD;;;;;;;;;;;;GAYG;AACH,qBACa,4BAA6B,SAAQ,UAAU;IAExD;;;;;;;OAOG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmDvF,qEAAqE;IACrE,OAAO,CAAC,kBAAkB;CAS7B;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,IAAI,IAAI,CAIvD"}

package/dist/custom/interactive-forms/get-entity-schema-for-form.action.js

@@ -0,0 +1,103 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseAction } from "@memberjunction/actions";
+import { Metadata, LogError } from "@memberjunction/core";
+import { RegisterClass } from "@memberjunction/global";
+import { buildCuratedFormSchema } from "@memberjunction/interactive-component-types/forms";
+/**
+ * Read-only action consumed by the Form Builder agent to inspect an entity's
+ * curated form-relevant schema before generating a form Component.
+ *
+ * Returns the `CuratedFormSchema` shape: FK references resolved to
+ * `{entity, displayField}`, value-list fields annotated with `allowedValues`,
+ * and audit / virtual / computed fields stripped. See
+ * `@memberjunction/interactive-component-types/forms` for the type.
+ *
+ * Output is stringified JSON in `Message` (Action framework convention) and
+ * also surfaced as a `Schema` output parameter for callers that prefer
+ * structured access.
+ */
+let GetEntitySchemaForFormAction = class GetEntitySchemaForFormAction extends BaseAction {
+    /**
+     * Required input:
+     *   - `EntityName` (string) — fully-qualified entity name, e.g. "MJ: Applications".
+     *
+     * Output:
+     *   - `Schema` parameter — the `CuratedFormSchema` object.
+     *   - `Message` — the same object, stringified.
+     */
+    async InternalRunAction(params) {
+        try {
+            const entityName = this.getEntityNameParam(params);
+            if (!entityName) {
+                return {
+                    Success: false,
+                    ResultCode: "MISSING_PARAMETER",
+                    Message: "Parameter 'EntityName' is required.",
+                };
+            }
+            const provider = params.Provider ?? Metadata.Provider;
+            if (!provider) {
+                return {
+                    Success: false,
+                    ResultCode: "NO_PROVIDER",
+                    Message: "No metadata provider available. Action requires a configured provider on the run params or globally.",
+                };
+            }
+            const schema = buildCuratedFormSchema(entityName, provider);
+            if (!schema) {
+                return {
+                    Success: false,
+                    ResultCode: "ENTITY_NOT_FOUND",
+                    Message: `Entity '${entityName}' is not registered with the active metadata provider.`,
+                };
+            }
+            params.Params.push({
+                Name: "Schema",
+                Type: "Output",
+                Value: schema,
+            });
+            return {
+                Success: true,
+                ResultCode: "SUCCESS",
+                Message: JSON.stringify(schema),
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            LogError(`GetEntitySchemaForFormAction: ${message}`);
+            return {
+                Success: false,
+                ResultCode: "UNEXPECTED_ERROR",
+                Message: message,
+            };
+        }
+    }
+    /** Case-insensitive trim-tolerant fetch for the EntityName param. */
+    getEntityNameParam(params) {
+        const param = params.Params.find(p => p.Name?.trim().toLowerCase() === "entityname");
+        if (!param || param.Value == null) {
+            return null;
+        }
+        const value = String(param.Value).trim();
+        return value.length > 0 ? value : null;
+    }
+};
+GetEntitySchemaForFormAction = __decorate([
+    RegisterClass(BaseAction, "__GetEntitySchemaForForm")
+], GetEntitySchemaForFormAction);
+export { GetEntitySchemaForFormAction };
+/**
+ * Tree-shaking guard. Imported and called from src/index.ts so bundlers
+ * don't drop the action when no consumer references it by name.
+ */
+export function LoadGetEntitySchemaForFormAction() {
+    if (false) {
+        const _ = GetEntitySchemaForFormAction;
+    }
+}
+//# sourceMappingURL=get-entity-schema-for-form.action.js.map

package/dist/custom/interactive-forms/get-entity-schema-for-form.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity-schema-for-form.action.js","sourceRoot":"","sources":["../../../src/custom/interactive-forms/get-entity-schema-for-form.action.ts"],"names":[],"mappings":"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"}

package/dist/custom/interactive-forms/index.d.ts

@@ -0,0 +1,8 @@
+export * from './get-entity-schema-for-form.action.js';
+export * from './get-default-form-scaffold.action.js';
+export * from './get-active-form-for-entity.action.js';
+export * from './create-interactive-form.action.js';
+export * from './modify-interactive-form.action.js';
+export * from './activate-interactive-form-version.action.js';
+export * from './revert-interactive-form.action.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/custom/interactive-forms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom/interactive-forms/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,kCAAkC,CAAC"}

package/dist/custom/interactive-forms/index.js

@@ -0,0 +1,8 @@
+export * from './get-entity-schema-for-form.action.js';
+export * from './get-default-form-scaffold.action.js';
+export * from './get-active-form-for-entity.action.js';
+export * from './create-interactive-form.action.js';
+export * from './modify-interactive-form.action.js';
+export * from './activate-interactive-form-version.action.js';
+export * from './revert-interactive-form.action.js';
+//# sourceMappingURL=index.js.map

package/dist/custom/interactive-forms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/custom/interactive-forms/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,kCAAkC,CAAC"}

package/dist/custom/interactive-forms/modify-interactive-form.action.d.ts

@@ -0,0 +1,54 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Modify an existing interactive-form override.
+ *
+ * Behavior is driven by the **`VersionBumpKind` input** and the **source
+ * Override's status** (Override is the canonical "is this live" signal —
+ * Component.Status can drift independently):
+ *
+ * | Source Status | VersionBumpKind        | Behavior                                                                                                                                            |
+ * |---------------|------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
+ * | Pending       | `in-place` (default)   | Overwrite the existing Pending Component row in place. No new version. Iteration-loop behavior.                                                     |
+ * | Pending       | `patch` / `minor` / `major` | **Demote** the existing Pending → Inactive, then insert a new Pending Component v(bumped) + new Pending Override pointing at it. Creates rollback. |
+ * | Active        | `in-place`             | **Rejected** — would corrupt the live Active row. Returns `INVALID_BUMP_FOR_STATUS`.                                                                |
+ * | Active        | `patch` / `minor` (default) / `major` | Insert new Pending Component v(bumped) + new Pending Override. Active is untouched — user explicitly Activates later.                  |
+ * | Inactive      | `in-place`             | **Rejected** — overwriting a dead row achieves nothing. Use 'Revert Interactive Form' to re-activate first, or supply a bump kind.                  |
+ * | Inactive      | `patch` (default) / `minor` / `major` | Branch-from-historical. Insert new Pending Component v(bumped) sourced from this Inactive spec. The Inactive source is left alone (already historical). |
+ *
+ * **Defaults** preserve historical behavior: omit `VersionBumpKind` and
+ * Pending sources stay in-place, Active sources bump minor, Inactive
+ * sources bump patch (the conservative branch-from-historical case).
+ *
+ * **Security clamp.** Modify *always* writes a User-scope Pending Override,
+ * regardless of the original override's scope. Even if the caller is
+ * modifying a Role-scope or Global override (which they have permission to
+ * read because they pass the ownership check), the new Pending sibling
+ * is always User-scoped to the calling user. Scope promotion (User → Role
+ * → Global) is a separate, deliberate human action with its own permission
+ * gate in Component Studio / Form Builder. The agent cannot widen scope
+ * through Modify any more than through Create.
+ *
+ * **Ownership check.** The caller must own (or have role membership for, or
+ * be admin over) the existing override they're modifying. See
+ * `checkOverrideOwnership` in `_shared.ts`. Returns FORBIDDEN if rejected.
+ *
+ * Inputs:
+ *   - `OverrideID` (required, string) — the override to modify
+ *   - `Spec` (required, ComponentSpec | string) — the new form spec
+ *   - `Notes` (optional, string) — appended to the override's Notes column
+ *   - `VersionBumpKind` (optional, 'in-place' | 'patch' | 'minor' | 'major') — see table above
+ *
+ * Outputs:
+ *   - `ComponentID` — the Component row that now holds the spec (new for snapshots, same for in-place)
+ *   - `OverrideID` — the Override row that points at it
+ *   - `Mode` — 'in-place' or 'new-version'
+ *   - `Version` — the Component's resulting Version string
+ */
+export declare class ModifyInteractiveFormAction extends BaseAction {
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    private findParam;
+}
+/** Tree-shaking guard. */
+export declare function LoadModifyInteractiveFormAction(): void;
+//# sourceMappingURL=modify-interactive-form.action.d.ts.map

package/dist/custom/interactive-forms/modify-interactive-form.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modify-interactive-form.action.d.ts","sourceRoot":"","sources":["../../../src/custom/interactive-forms/modify-interactive-form.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAWrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,qBACa,2BAA4B,SAAQ,UAAU;cAEvC,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuOvF,OAAO,CAAC,SAAS;CAKpB;AAED,0BAA0B;AAC1B,wBAAgB,+BAA+B,IAAI,IAAI,CAItD"}