@memberjunction/core-actions 5.37.0 → 5.38.0

package/README.md

@@ -312,6 +312,24 @@ Orchestrate action execution with branching, iteration, parallelism, and retry l
 |---|---|---|
 | `__ExecuteCode` | `ExecuteCodeAction` | Execute sandboxed code snippets |
 
+### Interactive Forms (6 actions)
+
+The lifecycle for runtime-author entity forms (form-role
+`ComponentSpec` + `EntityFormOverride`). See
+[/plans/interactive-forms/phase-2-runtime-loop.md](../../../plans/interactive-forms/phase-2-runtime-loop.md)
+for the full architecture and security model. Mutation actions enforce
+ownership checks (User → caller, Role → membership, Global → admin).
+
+| Registration Name | Class | Description |
+|---|---|---|
+| `__GetEntitySchemaForForm` | `GetEntitySchemaForFormAction` | Read-only: returns the curated form-relevant schema for an entity (FKs resolved, value lists annotated, audit fields stripped). |
+| `__GetDefaultFormScaffoldForEntity` | `GetDefaultFormScaffoldForEntityAction` | Read-only: produces a working form-role `ComponentSpec` mirroring the CodeGen Angular default layout. The agent's baseline. |
+| `__GetActiveFormForEntity` | `GetActiveFormForEntityAction` | Read-only: returns the resolved Active override + full applicable-variants list for the (entity, calling-user) pair. |
+| `__CreateInteractiveForm` | `CreateInteractiveFormAction` | Net-new only. Inserts Component v1.0.0 + Active User-scope Override. Fails `ALREADY_EXISTS` if the user already has an Active override for the entity. |
+| `__ModifyInteractiveForm` | `ModifyInteractiveFormAction` | Branches on the pointed-to Component status: Pending → modify in place; Active → new Pending Component v(N+1) + sibling Pending Override. Always User-scope-clamped. |
+| `__ActivateInteractiveFormVersion` | `ActivateInteractiveFormVersionAction` | Promotes a Pending override to Active; atomically demotes the prior sibling Active. |
+| `__RevertInteractiveForm` | `RevertInteractiveFormAction` | Re-points an Active override at an older Component row in the same Name lineage. Pure UPDATE; no new rows. |
+
 ### Demo (6 actions)
 
 Reference implementations useful for testing and learning.
@@ -522,6 +540,6 @@ sequenceDiagram
 ## Related Packages
 
 - **[@memberjunction/actions-base](../Base/README.md)** -- Base classes, interfaces, and metadata engines
-- **[@memberjunction/actions](../Engine/readme.md)** -- Server-side action execution engine
+- **[@memberjunction/actions](../Engine/README.md)** -- Server-side action execution engine
 - **[Parent Actions README](../README.md)** -- Framework overview, generated actions guide, and best practices
 - **[Parent Actions CLAUDE.md](../CLAUDE.md)** -- Design philosophy and development guidelines

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

@@ -0,0 +1,144 @@
+/**
+ * Shared helpers for the Interactive Forms action family. These all touch
+ * the same two entities (`MJ: Components`, `MJ: Entity Form Overrides`),
+ * lint the same spec shape, and need the same parameter conventions —
+ * extracting here keeps each action thin.
+ */
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { IMetadataProvider, UserInfo } from "@memberjunction/core";
+import { MJComponentEntity, MJEntityFormOverrideEntity } from "@memberjunction/core-entities";
+import type { ComponentSpec } from "@memberjunction/interactive-component-types";
+export declare function getParam(params: RunActionParams, name: string): unknown;
+export declare function getStringParam(params: RunActionParams, name: string): string | null;
+export declare function getNumberParam(params: RunActionParams, name: string): number | null;
+export declare function addOutput(params: RunActionParams, name: string, value: unknown): void;
+export declare function failure(resultCode: string, message: string): ActionResultSimple;
+export declare function success(message: string): ActionResultSimple;
+/** Parse a Spec param that may arrive as object or stringified JSON. */
+export declare function parseSpecParam(raw: unknown): ComponentSpec | {
+    error: string;
+};
+/**
+ * Lint a form-role ComponentSpec. Returns null on success, a fail-fast
+ * ActionResultSimple on failure. Two rules are suppressed for form-role
+ * specs (component-props-validation, callback-event-validation) — see
+ * lint comments in the original create-interactive-form action for the
+ * rationale.
+ */
+export declare function lintFormSpec(spec: ComponentSpec, contextUser: UserInfo): Promise<ActionResultSimple | null>;
+/** Load a Component entity object by primary key. */
+export declare function loadComponent(provider: IMetadataProvider, user: UserInfo, componentID: string): Promise<MJComponentEntity | null>;
+/** Load an Override entity object by primary key. */
+export declare function loadOverride(provider: IMetadataProvider, user: UserInfo, overrideID: string): Promise<MJEntityFormOverrideEntity | null>;
+/**
+ * Defense-in-depth ownership check for the override-mutation actions
+ * (Modify / Activate / Revert).
+ *
+ * `Create` is naturally self-scoped — it always emits a fresh User-scope
+ * row owned by the caller. The mutation actions, however, take an
+ * `OverrideID` from the caller and operate on it; without this guard a
+ * user could mutate another user's User-scope override by guessing the ID.
+ * Row-level security may catch some of this, but we don't rely on it.
+ *
+ * Rules:
+ *   - `Scope='User'`   → caller must be the owning user.
+ *   - `Scope='Role'`   → caller must be a member of the override's role.
+ *   - `Scope='Global'` → caller must be a system admin (`UserInfo.Type==='Owner'`).
+ *
+ * Returns `null` on success; a `FORBIDDEN` failure result on rejection.
+ */
+export declare function checkOverrideOwnership(override: Pick<MJEntityFormOverrideEntity, 'ID' | 'Scope' | 'UserID' | 'RoleID'>, user: UserInfo): ActionResultSimple | null;
+/**
+ * Lifecycle mapping. EntityFormOverride.Status uses
+ * 'Active' / 'Pending' / 'Inactive' (it's the resolver-facing union). The
+ * underlying Component table's Status column is the existing MJ Component
+ * lifecycle: 'Draft' / 'Published' / 'Deprecated'. We mirror Override.Status
+ * onto Component.Status using this map so a Component read in isolation still
+ * tells you whether it's the active form (Published), a pending refinement
+ * (Draft), or an archived version (Deprecated).
+ */
+export type FormLifecycle = 'Active' | 'Pending' | 'Inactive';
+export declare function mapToComponentStatus(lifecycle: FormLifecycle): 'Published' | 'Draft' | 'Deprecated';
+export declare function mapFromComponentStatus(status: string | null | undefined): FormLifecycle;
+/**
+ * Insert a new Component row carrying the supplied spec. Used by both
+ * Create (v1.0.0) and Modify (v(N+1).0) paths.
+ *
+ * - `version` / `versionSequence` are supplied by the caller — different
+ *    actions have different bumping logic (Create starts at 1.0.0, Modify
+ *    increments minor).
+ * - `componentStatus` mirrors the override status the caller is targeting
+ *    ('Active' or 'Pending') — translated to the Component table's union via
+ *    {@link mapToComponentStatus}.
+ */
+export declare function insertComponent(opts: {
+    provider: IMetadataProvider;
+    user: UserInfo;
+    spec: ComponentSpec;
+    fallbackName: string;
+    description: string | null;
+    version: string;
+    versionSequence: number;
+    componentStatus: FormLifecycle;
+}): Promise<{
+    id: string;
+} | {
+    error: ActionResultSimple;
+}>;
+/**
+ * Insert a new EntityFormOverride row. Always User-scoped (security clamp)
+ * unless `allowGlobalOrRole` is explicitly true — which is reserved for the
+ * future "promote variant" UI path, not the agent.
+ */
+export declare function insertOverride(opts: {
+    provider: IMetadataProvider;
+    user: UserInfo;
+    entityID: string;
+    componentID: string;
+    name: string;
+    description: string | null;
+    notes?: string | null;
+    status: 'Active' | 'Pending';
+    priority?: number;
+}): Promise<{
+    id: string;
+} | {
+    error: ActionResultSimple;
+}>;
+/**
+ * Discrete intent for how the next version should be derived. Callers
+ * (Modify Interactive Form) accept this as an explicit input parameter so
+ * the agent can express defect-vs-feature-vs-rewrite intent rather than
+ * inferring it from the source row's status.
+ */
+export type VersionBumpKind = 'in-place' | 'patch' | 'minor' | 'major';
+/**
+ * "1.0.0" → "1.0.1", "1.7.3" → "1.7.4". Used for small/defect-style edits
+ * that deserve a rollback checkpoint but aren't a meaningful UX change.
+ */
+export declare function bumpPatchVersion(current: string | null | undefined): string;
+/**
+ * Compute the next semver-minor bump for an existing version string.
+ * "1.0.0" → "1.1.0", "1.7.3" → "1.8.0". Used for feature additions —
+ * new fields, sections, charts, tabs.
+ */
+export declare function bumpMinorVersion(current: string | null | undefined): string;
+/**
+ * "1.7.3" → "2.0.0", "3.4.5" → "4.0.0". Used for radical redesigns or
+ * when the user explicitly asks for a new major version.
+ */
+export declare function bumpMajorVersion(current: string | null | undefined): string;
+/**
+ * Dispatch a version bump based on the caller's stated intent.
+ * `'in-place'` returns the same version unchanged — caller should branch
+ * separately (no new Component row is written).
+ */
+export declare function bumpVersion(current: string | null | undefined, kind: VersionBumpKind): string;
+/**
+ * Parse and normalize a VersionBumpKind value from a string. Accepts the
+ * canonical lowercase forms plus a few common phrasings. Returns null if
+ * the input doesn't map to a known kind, so callers can decide whether
+ * to default or reject.
+ */
+export declare function parseVersionBumpKind(raw: unknown): VersionBumpKind | null;
+//# sourceMappingURL=_shared.d.ts.map

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

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

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

@@ -0,0 +1,300 @@
+import { UUIDsEqual } from "@memberjunction/global";
+import { isFormRole } from "@memberjunction/interactive-component-types/forms";
+import { ComponentLinter } from "@memberjunction/react-linter";
+// ── parameter helpers ────────────────────────────────────────────────────
+export function getParam(params, name) {
+    const p = params.Params.find(x => x.Name?.trim().toLowerCase() === name.toLowerCase());
+    return p?.Value;
+}
+export function getStringParam(params, name) {
+    const v = getParam(params, name);
+    if (v == null)
+        return null;
+    const s = String(v).trim();
+    return s.length > 0 ? s : null;
+}
+export function getNumberParam(params, name) {
+    const v = getParam(params, name);
+    if (v == null)
+        return null;
+    const n = typeof v === 'number' ? v : Number(String(v));
+    return Number.isFinite(n) ? n : null;
+}
+export function addOutput(params, name, value) {
+    params.Params.push({ Name: name, Type: "Output", Value: value });
+}
+// ── result helpers ───────────────────────────────────────────────────────
+export function failure(resultCode, message) {
+    return { Success: false, ResultCode: resultCode, Message: message };
+}
+export function success(message) {
+    return { Success: true, ResultCode: "SUCCESS", Message: message };
+}
+// ── spec parsing + linting ───────────────────────────────────────────────
+/** Parse a Spec param that may arrive as object or stringified JSON. */
+export function parseSpecParam(raw) {
+    try {
+        if (typeof raw === "string") {
+            return JSON.parse(raw);
+        }
+        return raw;
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+/**
+ * Lint a form-role ComponentSpec. Returns null on success, a fail-fast
+ * ActionResultSimple on failure. Two rules are suppressed for form-role
+ * specs (component-props-validation, callback-event-validation) — see
+ * lint comments in the original create-interactive-form action for the
+ * rationale.
+ */
+export async function lintFormSpec(spec, contextUser) {
+    if (!isFormRole(spec)) {
+        return failure("LINT_FAILED", `Spec must declare componentRole='form'. Got '${spec.componentRole ?? "(unset)"}'. The InteractiveForm runtime refuses to mount any other role.`);
+    }
+    if (!spec.name || spec.name.trim().length === 0) {
+        return failure("LINT_FAILED", "Spec.name is required.");
+    }
+    if (typeof spec.code !== "string" || spec.code.trim().length === 0) {
+        return failure("LINT_FAILED", "Spec.code must be a non-empty JSX string.");
+    }
+    if (!spec.location) {
+        return failure("LINT_FAILED", "Spec.location is required (use 'embedded' for inline JSX or 'registry' to reference a published component).");
+    }
+    const FORM_ROLE_SUPPRESSED_RULES = new Set([
+        "component-props-validation",
+        "callback-event-validation",
+    ]);
+    try {
+        const result = await ComponentLinter.lintComponent(spec.code, spec.name, spec, true, contextUser);
+        const blocking = (result.violations ?? []).filter(v => {
+            const isBlocking = v.severity === "critical" || v.severity === "high";
+            if (!isBlocking)
+                return false;
+            if (v.rule && FORM_ROLE_SUPPRESSED_RULES.has(v.rule))
+                return false;
+            return true;
+        });
+        if (blocking.length > 0) {
+            const messages = blocking
+                .slice(0, 5)
+                .map(v => `  [${v.severity}] ${v.rule ?? "lint"}: ${v.message}${v.line ? ` (line ${v.line})` : ""}`)
+                .join("\n");
+            return failure("LINT_FAILED", `Spec code failed linting:\n${messages}${blocking.length > 5 ? `\n  (+${blocking.length - 5} more)` : ""}`);
+        }
+    }
+    catch (err) {
+        return failure("LINT_FAILED", `Linter could not parse spec code: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return null;
+}
+// ── component / override fetch + write helpers ───────────────────────────
+/** Load a Component entity object by primary key. */
+export async function loadComponent(provider, user, componentID) {
+    const c = await provider.GetEntityObject("MJ: Components", user);
+    const loaded = await c.Load(componentID);
+    return loaded ? c : null;
+}
+/** Load an Override entity object by primary key. */
+export async function loadOverride(provider, user, overrideID) {
+    const o = await provider.GetEntityObject("MJ: Entity Form Overrides", user);
+    const loaded = await o.Load(overrideID);
+    return loaded ? o : null;
+}
+/**
+ * Defense-in-depth ownership check for the override-mutation actions
+ * (Modify / Activate / Revert).
+ *
+ * `Create` is naturally self-scoped — it always emits a fresh User-scope
+ * row owned by the caller. The mutation actions, however, take an
+ * `OverrideID` from the caller and operate on it; without this guard a
+ * user could mutate another user's User-scope override by guessing the ID.
+ * Row-level security may catch some of this, but we don't rely on it.
+ *
+ * Rules:
+ *   - `Scope='User'`   → caller must be the owning user.
+ *   - `Scope='Role'`   → caller must be a member of the override's role.
+ *   - `Scope='Global'` → caller must be a system admin (`UserInfo.Type==='Owner'`).
+ *
+ * Returns `null` on success; a `FORBIDDEN` failure result on rejection.
+ */
+export function checkOverrideOwnership(override, user) {
+    const ID = override.ID;
+    switch (override.Scope) {
+        case 'User': {
+            if (!UUIDsEqual(override.UserID, user.ID)) {
+                return failure("FORBIDDEN", `Override ${ID} is User-scoped to a different user. Only the owning user can mutate it.`);
+            }
+            return null;
+        }
+        case 'Role': {
+            const userRoleIds = (user.UserRoles ?? [])
+                .map(r => r.RoleID).filter((x) => !!x);
+            if (!override.RoleID || !userRoleIds.includes(override.RoleID)) {
+                return failure("FORBIDDEN", `Override ${ID} is Role-scoped (${override.RoleID}). Only members of that role can mutate it.`);
+            }
+            return null;
+        }
+        case 'Global': {
+            // `UserInfo.Type === 'Owner'` is MJ's canonical admin marker —
+            // see packages/MJCore/src/userInfo.ts (Type is a Pick from the
+            // generated entity field). Owners can manage Global overrides;
+            // everyone else is rejected.
+            const isOwner = (user.Type ?? '').toLowerCase() === 'owner';
+            if (!isOwner) {
+                return failure("FORBIDDEN", `Override ${ID} is Global. Only Owner-type users can mutate Global overrides; promote / demote them via Component Studio with appropriate privileges.`);
+            }
+            return null;
+        }
+        default:
+            return failure("FORBIDDEN", `Override ${ID} has an unrecognized Scope ('${override.Scope}').`);
+    }
+}
+export function mapToComponentStatus(lifecycle) {
+    switch (lifecycle) {
+        case 'Active': return 'Published';
+        case 'Pending': return 'Draft';
+        case 'Inactive': return 'Deprecated';
+    }
+}
+export function mapFromComponentStatus(status) {
+    switch ((status ?? '').toLowerCase()) {
+        case 'published': return 'Active';
+        case 'draft': return 'Pending';
+        case 'deprecated': return 'Inactive';
+        default: return 'Inactive'; // unknown values treated as terminal
+    }
+}
+/**
+ * Insert a new Component row carrying the supplied spec. Used by both
+ * Create (v1.0.0) and Modify (v(N+1).0) paths.
+ *
+ * - `version` / `versionSequence` are supplied by the caller — different
+ *    actions have different bumping logic (Create starts at 1.0.0, Modify
+ *    increments minor).
+ * - `componentStatus` mirrors the override status the caller is targeting
+ *    ('Active' or 'Pending') — translated to the Component table's union via
+ *    {@link mapToComponentStatus}.
+ */
+export async function insertComponent(opts) {
+    const { provider, user, spec, fallbackName, description, version, versionSequence, componentStatus } = opts;
+    const component = await provider.GetEntityObject("MJ: Components", user);
+    component.NewRecord();
+    component.Name = spec.name ?? fallbackName;
+    component.Title = spec.title ?? fallbackName;
+    component.Description = description ?? spec.description ?? null;
+    component.Type = "Form";
+    component.Status = mapToComponentStatus(componentStatus);
+    component.Version = version;
+    component.VersionSequence = versionSequence;
+    component.Specification = JSON.stringify(spec);
+    component.DeveloperName = user.Name ?? null;
+    const saved = await component.Save();
+    if (!saved) {
+        return { error: failure("PERSIST_FAILED", `Component insert failed: ${component.LatestResult?.CompleteMessage ?? "unknown error"}`) };
+    }
+    return { id: component.ID };
+}
+/**
+ * Insert a new EntityFormOverride row. Always User-scoped (security clamp)
+ * unless `allowGlobalOrRole` is explicitly true — which is reserved for the
+ * future "promote variant" UI path, not the agent.
+ */
+export async function insertOverride(opts) {
+    const { provider, user, entityID, componentID, name, description, notes, status, priority } = opts;
+    const override = await provider.GetEntityObject("MJ: Entity Form Overrides", user);
+    override.NewRecord();
+    override.EntityID = entityID;
+    override.ComponentID = componentID;
+    override.Name = name;
+    override.Description = description;
+    // Notes is the column added in V202605221100 (Notes-column fold-in).
+    // Cast — the generated type may or may not yet expose it depending on
+    // codegen freshness; the field exists in the DB regardless.
+    override.Notes = notes ?? null;
+    override.Scope = "User";
+    override.UserID = user.ID;
+    override.RoleID = null;
+    override.Priority = priority ?? 0;
+    override.Status = status;
+    const saved = await override.Save();
+    if (!saved) {
+        return { error: failure("PERSIST_FAILED", `Override insert failed: ${override.LatestResult?.CompleteMessage ?? "unknown error"}`) };
+    }
+    return { id: override.ID };
+}
+function parseSemver(current) {
+    if (!current)
+        return { major: 1, minor: 0, patch: 0 };
+    const m = /^(\d+)\.(\d+)(?:\.(\d+))?/.exec(current.trim());
+    if (!m)
+        return { major: 1, minor: 0, patch: 0 };
+    return {
+        major: Number(m[1]),
+        minor: Number(m[2]),
+        patch: m[3] ? Number(m[3]) : 0,
+    };
+}
+/**
+ * "1.0.0" → "1.0.1", "1.7.3" → "1.7.4". Used for small/defect-style edits
+ * that deserve a rollback checkpoint but aren't a meaningful UX change.
+ */
+export function bumpPatchVersion(current) {
+    const v = parseSemver(current);
+    return `${v.major}.${v.minor}.${v.patch + 1}`;
+}
+/**
+ * Compute the next semver-minor bump for an existing version string.
+ * "1.0.0" → "1.1.0", "1.7.3" → "1.8.0". Used for feature additions —
+ * new fields, sections, charts, tabs.
+ */
+export function bumpMinorVersion(current) {
+    const v = parseSemver(current);
+    return `${v.major}.${v.minor + 1}.0`;
+}
+/**
+ * "1.7.3" → "2.0.0", "3.4.5" → "4.0.0". Used for radical redesigns or
+ * when the user explicitly asks for a new major version.
+ */
+export function bumpMajorVersion(current) {
+    const v = parseSemver(current);
+    return `${v.major + 1}.0.0`;
+}
+/**
+ * Dispatch a version bump based on the caller's stated intent.
+ * `'in-place'` returns the same version unchanged — caller should branch
+ * separately (no new Component row is written).
+ */
+export function bumpVersion(current, kind) {
+    switch (kind) {
+        case 'patch': return bumpPatchVersion(current);
+        case 'minor': return bumpMinorVersion(current);
+        case 'major': return bumpMajorVersion(current);
+        case 'in-place': return current ?? '1.0.0';
+    }
+}
+/**
+ * Parse and normalize a VersionBumpKind value from a string. Accepts the
+ * canonical lowercase forms plus a few common phrasings. Returns null if
+ * the input doesn't map to a known kind, so callers can decide whether
+ * to default or reject.
+ */
+export function parseVersionBumpKind(raw) {
+    if (raw == null)
+        return null;
+    const s = String(raw).trim().toLowerCase();
+    if (!s)
+        return null;
+    if (s === 'in-place' || s === 'inplace' || s === 'in_place')
+        return 'in-place';
+    if (s === 'patch')
+        return 'patch';
+    if (s === 'minor')
+        return 'minor';
+    if (s === 'major')
+        return 'major';
+    return null;
+}
+//# sourceMappingURL=_shared.js.map

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

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

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

@@ -0,0 +1,31 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Promote a Pending override to Active. Flips:
+ *   - target Override:                   Status='Active'
+ *   - target Override's Component:       Status='Active'
+ *   - prior Active sibling Override:     Status='Inactive'
+ *   - prior Active sibling Component:    Status='Inactive'
+ *
+ * "Sibling" = same EntityID + (Scope, UserID, RoleID) tuple as the target
+ * Override. The target is the row identified by the input `OverrideID`; the
+ * priors are any rows currently Status='Active' at the same scope target.
+ *
+ * Idempotency. If the target Override is already Active, returns SUCCESS
+ * with a no-op message. If it's Inactive, that's a misuse — we surface
+ * NOT_PENDING so the agent / UI can ask the user what they really want.
+ *
+ * Inputs:
+ *   - `OverrideID` (required, string) — the Pending override to activate
+ *
+ * Outputs:
+ *   - `ComponentID` — the Component now Active
+ *   - `OverrideID` — echoed for convenience
+ *   - `PreviousActiveOverrideID` — the override that was demoted (or null)
+ */
+export declare class ActivateInteractiveFormVersionAction extends BaseAction {
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+}
+/** Tree-shaking guard. */
+export declare function LoadActivateInteractiveFormVersionAction(): void;
+//# sourceMappingURL=activate-interactive-form-version.action.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activate-interactive-form-version.action.d.ts","sourceRoot":"","sources":["../../../src/custom/interactive-forms/activate-interactive-form-version.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAOrD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBACa,oCAAqC,SAAQ,UAAU;cAEhD,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAkG1F;AAED,0BAA0B;AAC1B,wBAAgB,wCAAwC,IAAI,IAAI,CAI/D"}