@zeniai/client-epic-state 5.2.8 → 5.2.9

package/lib/esm/entity/vendorExpense/vendorSpendTrendFilterTabType.js

@@ -1,15 +0,0 @@
-import { stringToUnion, stringToUnionStrict, } from '../../commonStateTypes/stringToUnion';
-const VENDOR_SPEND_TREND_FILTER_TABS_TYPES = [
-    'last_30_days',
-    'variance',
-    'last_90_days',
-    'YTD_spend',
-    'last_month',
-    'last_3_months',
-    'last_6_months',
-    'last_12_months',
-    'last_year',
-];
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-const toVendorSpendTrendFilterTabsType = (v) => stringToUnion(v, VENDOR_SPEND_TREND_FILTER_TABS_TYPES);
-export const toVendorSpendTrendFilterTabsTypeStrict = (v) => stringToUnionStrict(v, VENDOR_SPEND_TREND_FILTER_TABS_TYPES);

package/lib/esm/pusherClient.js

@@ -1,114 +0,0 @@
-import { zeniAPI } from './zeniAPIClientState';
-let pusher;
-let isPusherInitialized = false;
-// Caches an in-flight initializePusher() promise so that concurrent callers
-// share a single Pusher instance instead of each constructing their own and
-// leaking WebSocket connections (see Bugbot review on PR #2983). Cleared in
-// the IIFE's `finally` once construction settles.
-let pusherInitPromise;
-/**
- * Call initializePusher before using pusher in web-app
- */
-export async function initializePusher(pusherClientSecret, options, headers, reInitialize = false) {
-    // Pusher subscribes/decrypts only make sense in the browser. `pusher-js/
-    // with-encryption` resolves to a browser-only bundle that references
-    // `window` at module init, so even *importing* it on the server crashes.
-    // Bail out early on SSR/Node so the dynamic import below never executes.
-    if (typeof window === 'undefined') {
-        console.warn(`initializePusher called on server-side; pusher-js/with-encryption is browser-only — skipping.`);
-        return undefined;
-    }
-    if (zeniAPI == null ||
-        Boolean(zeniAPI.userId) === false ||
-        Boolean(zeniAPI.tenantId) === false) {
-        console.warn(`Can't initialize pusher before initializing client...`);
-        return undefined;
-    }
-    if (isPusherInitialized && !reInitialize) {
-        console.warn(`Already initialized pusher`);
-        return pusher;
-    }
-    // De-dupe concurrent in-flight calls so we don't construct multiple Pusher
-    // instances (each one a live WebSocket) and leak the older ones. We don't
-    // de-dupe when reInitialize=true — that's the caller asking for a fresh
-    // instance, which is the existing contract.
-    if (pusherInitPromise && !reInitialize) {
-        return pusherInitPromise;
-    }
-    // The IIFE captures `currentInit` so that, when its `finally` runs, it can
-    // identity-check before clearing the module-level `pusherInitPromise`. This
-    // matters when a reInitialize=true call overwrites `pusherInitPromise`
-    // while we're still in flight: without the identity check, our finally
-    // would clobber the newer call's slot and the next concurrent caller
-    // would bypass the dedup guard. Capture is safe because the first action
-    // inside the try is `await import(...)`, which always yields control —
-    // so the finally runs in a future microtask, after `currentInit` has
-    // already been assigned below. We declare it as `let … | undefined` so
-    // TS's definite-assignment analysis (which doesn't model the await) accepts
-    // the closure read; at runtime it's always the IIFE promise by then.
-    let currentInit = undefined;
-    currentInit = (async () => {
-        try {
-            // Dynamic import so the browser-only bundle is loaded only when this
-            // function actually runs (browser path). Works in both build outputs:
-            //   • ESM (lib/esm): preserved as native `import()` → Vite/Rollup code-split
-            //   • CJS (lib): TypeScript lowers to `Promise.resolve().then(() => require(...))`
-            // The pusher-js UMD wrapper does `module.exports = factory()` for CJS,
-            // so the module result is the Pusher class directly. Some bundlers wrap
-            // CJS in `{ default: ... }` for ESM interop — fall back to the module
-            // itself when `.default` is absent.
-            const pusherModule = (await import('pusher-js/with-encryption'));
-            const PusherConstructor = 'default' in pusherModule ? pusherModule.default : pusherModule;
-            const endpoint = `${zeniAPI.apiEndPoints.tenantMicroServiceBaseUrl}/1.0/notifications/push_notification/auth`;
-            pusher = new PusherConstructor(pusherClientSecret, {
-                ...options,
-                channelAuthorization: {
-                    endpoint,
-                    transport: 'ajax',
-                    customHandler: (params, callback) => customHandler(params, headers, callback),
-                },
-            }).bind('error', function (err) {
-                console.warn('Pusher error', err);
-            });
-            console.info(`initializing with ${JSON.stringify(options)}`);
-            return pusher;
-        }
-        finally {
-            if (pusherInitPromise === currentInit) {
-                pusherInitPromise = undefined;
-            }
-        }
-    })();
-    pusherInitPromise = currentInit;
-    return currentInit;
-}
-const customHandler = async (params, headers, callback) => {
-    const { socketId, channelName } = params;
-    const endpoint = `${zeniAPI.apiEndPoints.tenantMicroServiceBaseUrl}/1.0/notifications/push_notification/auth`;
-    const payload = {
-        socket_id: socketId,
-        channel_name: channelName,
-    };
-    await zeniAPI
-        .postAndGetJSON(endpoint, payload, Object.assign({ 'zeni-user-id': headers.userId }, { 'zeni-tenant-id': headers.tenantId }, { 'zeni-session-id': headers.sessionId }))
-        .toPromise()
-        .then((response) => {
-        if (response.data != null) {
-            callback(null, {
-                auth: response.data.auth,
-                shared_secret: response.data.shared_secret,
-            });
-            isPusherInitialized = true;
-        }
-    })
-        .catch((error) => {
-        callback(error, null);
-    });
-};
-export function disconnectPusher() {
-    if (pusher != null) {
-        pusher.disconnect();
-        isPusherInitialized = false;
-    }
-}
-export { pusher };

package/lib/esm/rootStateTypes.js

@@ -1 +0,0 @@
-export {};

package/lib/esm/view/aiCfoView/epics/deleteSkillEpic.js

@@ -1,23 +0,0 @@
-import { of } from 'rxjs';
-import { catchError, filter, mergeMap } from 'rxjs/operators';
-import { createZeniAPIStatus, isSuccessStatus } from '../../../responsePayload';
-import { deleteSkill, deleteSkillFailure, deleteSkillSuccess, } from '../aiCfoViewReducer';
-/** DELETE /1.0/skills/{macroId} — soft-deletes every version, frees the name. */
-export const deleteSkillEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(deleteSkill.match), 
-// mergeMap for the same reason as the save: cancelling a delete does not un-delete
-// it, and two deletes are for different skills anyway.
-mergeMap((action) => {
-    const { macroId } = action.payload;
-    const url = `${zeniAPI.apiEndPoints.aiCfoMicroServiceBaseUrl}/1.0/skills/${encodeURIComponent(macroId)}`;
-    return zeniAPI.deleteAndGetJSON(url).pipe(mergeMap((response) => {
-        // isSuccessStatus, NOT isSuccessResponse: the latter also requires a non-null
-        // `data`, and a successful DELETE here is a 204 with no body. Using it reported
-        // every completed delete as a failure — the row stayed on screen and a retry
-        // 404'd on a skill that was already gone. deleteChatSessionEpic uses the status
-        // check for the same reason.
-        if (isSuccessStatus(response)) {
-            return of(deleteSkillSuccess({ macroId }));
-        }
-        return of(deleteSkillFailure(response.status));
-    }), catchError((error) => of(deleteSkillFailure(createZeniAPIStatus('Unexpected Error', 'Delete skill REST API call failed', error instanceof Error ? { message: error.message } : undefined)))));
-}));

package/lib/esm/view/aiCfoView/epics/fetchSkillDetailEpic.js

@@ -1,35 +0,0 @@
-import { of } from 'rxjs';
-import { catchError, filter, mergeMap, switchMap } from 'rxjs/operators';
-import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
-import { fetchSkillDetail, fetchSkillDetailFailure, fetchSkillDetailSuccess, } from '../aiCfoViewReducer';
-import { isSkillDetailPayload, toSkillDetail } from './toSkillDetail';
-// Deliberately minimal: the browser already holds the full Skill from the list, and
-// this response's `skill` block exists so a deep link can open a detail view without
-// the list ever having been fetched.
-/** GET {aiCfoMicroServiceBaseUrl}/1.0/skills/{macroId} — one skill's prompt + card. */
-export const fetchSkillDetailEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(fetchSkillDetail.match), 
-// switchMap: clicking through the list fires one of these per skill, and only the
-// one the user is currently looking at matters. The reducer also drops responses
-// whose macroId no longer matches, so a cancelled-but-in-flight request cannot
-// render the wrong prompt under the right title.
-switchMap((action) => {
-    const { macroId } = action.payload;
-    const url = `${zeniAPI.apiEndPoints.aiCfoMicroServiceBaseUrl}/1.0/skills/${encodeURIComponent(macroId)}`;
-    return zeniAPI.getJSON(url).pipe(mergeMap((response) => {
-        // Shared mapper and shared guard. This epic used to keep its own `toSkill`
-        // and default a missing prompt to '', so the same malformed body showed an
-        // empty prompt here and failed the read elsewhere — and `isMine` was nearly
-        // added to only two of the three copies.
-        if (isSuccessResponse(response) &&
-            isSkillDetailPayload(response.data)) {
-            return of(fetchSkillDetailSuccess({
-                detail: toSkillDetail(response.data),
-                macroId,
-            }));
-        }
-        return of(fetchSkillDetailFailure({ error: response.status, macroId }));
-    }), catchError((error) => of(fetchSkillDetailFailure({
-        error: createZeniAPIStatus('Unexpected Error', 'Fetch skill detail REST API call failed', error instanceof Error ? { message: error.message } : undefined),
-        macroId,
-    }))));
-}));

package/lib/esm/view/aiCfoView/epics/fetchSkillVersionBodyEpic.js

@@ -1,45 +0,0 @@
-import { of } from 'rxjs';
-import { catchError, filter, mergeMap, switchMap } from 'rxjs/operators';
-import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
-import { fetchSkillVersionBody, fetchSkillVersionBodyFailure, fetchSkillVersionBodySuccess, } from '../aiCfoViewReducer';
-import { hasPromptBody } from './toSkillDetail';
-/**
- * GET /1.0/skills/{macroId}?version=N — one historical version's prompt.
- *
- * Only used to seed a restore. The history list carries metadata only, deliberately: a
- * 20-version history would otherwise be a 240kB response for a panel that shows dates.
- */
-export const fetchSkillVersionBodyEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(fetchSkillVersionBody.match), 
-// switchMap: a read, and only the version the user last clicked matters. The reducer
-// also drops a response whose (macroId, version) no longer matches, so a
-// cancelled-but-in-flight request cannot seed the form with the wrong body.
-switchMap((action) => {
-    const { macroId, version } = action.payload;
-    const url = `${zeniAPI.apiEndPoints.aiCfoMicroServiceBaseUrl}/1.0/skills/${encodeURIComponent(macroId)}?version=${encodeURIComponent(String(version))}`;
-    return zeniAPI.getJSON(url).pipe(mergeMap((response) => {
-        // `instructions` checked, not just `data`: the payload TYPE says the field is
-        // required, and the network is under no obligation to agree. Without this the
-        // epic reported success with `instructions: undefined`, and the browser — which
-        // holds the editor closed until a body arrives — showed "Loading this version…"
-        // for ever, with no error and no way forward.
-        if (isSuccessResponse(response) && hasPromptBody(response.data)) {
-            return of(fetchSkillVersionBodySuccess({
-                macroId,
-                version,
-                instructions: response.data.instructions,
-            }));
-        }
-        // A malformed 2xx is a failure. An empty STRING is not malformed and is allowed
-        // through: the editor's own minimum-length rule refuses to save it, so the user
-        // sees a validation message on a form they can fix rather than a dead end.
-        return of(fetchSkillVersionBodyFailure({
-            macroId,
-            version,
-            error: response.status,
-        }));
-    }), catchError((error) => of(fetchSkillVersionBodyFailure({
-        macroId,
-        version,
-        error: createZeniAPIStatus('Unexpected Error', 'Fetch skill version body REST API call failed', error instanceof Error ? { message: error.message } : undefined),
-    }))));
-}));

package/lib/esm/view/aiCfoView/epics/fetchSkillVersionsEpic.js

@@ -1,37 +0,0 @@
-import { of } from 'rxjs';
-import { catchError, filter, mergeMap, switchMap } from 'rxjs/operators';
-import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
-import { fetchSkillVersions, fetchSkillVersionsFailure, fetchSkillVersionsSuccess, } from '../aiCfoViewReducer';
-const toVersion = (payload) => ({
-    version: payload.version,
-    semver: payload.semver ?? null,
-    displayName: payload.display_name ?? null,
-    updatedAt: payload.updated_at ?? null,
-    // Defaulted defensively: these are booleans the server always sends, but a malformed
-    // 2xx should render a row as inactive-and-not-latest rather than as the live one.
-    isActive: payload.is_active === true,
-    isLatest: payload.is_latest === true,
-    instructionsCharCount: payload.instructions_char_count ?? 0,
-});
-/** GET /1.0/skills/{macroId}/versions — the history panel. */
-export const fetchSkillVersionsEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(fetchSkillVersions.match), 
-// switchMap: a read, and only the skill currently open matters. The reducer also
-// drops responses whose macroId no longer matches, so a cancelled-but-in-flight
-// request cannot render one skill's history under another's title.
-switchMap((action) => {
-    const { macroId } = action.payload;
-    const url = `${zeniAPI.apiEndPoints.aiCfoMicroServiceBaseUrl}/1.0/skills/${encodeURIComponent(macroId)}/versions`;
-    return zeniAPI.getJSON(url).pipe(mergeMap((response) => {
-        if (isSuccessResponse(response) && response.data != null) {
-            return of(fetchSkillVersionsSuccess({
-                macroId,
-                // Guard the array: a malformed 2xx without `versions` must not crash .map.
-                versions: (response.data.versions ?? []).map(toVersion),
-            }));
-        }
-        return of(fetchSkillVersionsFailure({ macroId, error: response.status }));
-    }), catchError((error) => of(fetchSkillVersionsFailure({
-        macroId,
-        error: createZeniAPIStatus('Unexpected Error', 'Fetch skill versions REST API call failed', error instanceof Error ? { message: error.message } : undefined),
-    }))));
-}));

package/lib/esm/view/aiCfoView/epics/saveSkillEpic.js

@@ -1,72 +0,0 @@
-import { of } from 'rxjs';
-import { catchError, filter, mergeMap } from 'rxjs/operators';
-import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
-import { fetchSkillVersions, fetchSkills, saveSkill, saveSkillFailure, saveSkillSuccess, } from '../aiCfoViewReducer';
-import { getSkillDetail } from '../aiCfoViewSelector';
-import { isSkillDetailPayload, toSkillDetail } from './toSkillDetail';
-/**
- * POST /1.0/skills (create) or PUT /1.0/skills/{macroId} (new version).
- *
- * One epic for both because they are the same action to a user — "save what I wrote" —
- * and the server answers both with the detail payload. Splitting them would duplicate
- * the payload mapping and the error handling for a difference the form does not have.
- */
-export const saveSkillEpic = (actions$, state$, zeniAPI) => actions$.pipe(filter(saveSkill.match), 
-// mergeMap, NOT switchMap: a save is a write. Cancelling an in-flight one because
-// another started does not un-send it, it just hides the outcome — and for a
-// create that means a skill exists that the user was never told about.
-mergeMap((action) => {
-    const { draft, macroId } = action.payload;
-    const base = `${zeniAPI.apiEndPoints.aiCfoMicroServiceBaseUrl}/1.0/skills`;
-    const body = {
-        name: draft.name,
-        instructions: draft.instructions,
-        description: draft.description,
-        // Sent as the menu name too. The server derives the unique `/` slug from it, so
-        // letting the two drift would make the command stop matching the row's title.
-        display_name: draft.name,
-        // Spread, not `visibility: draft.visibility`: the server distinguishes an ABSENT
-        // visibility ("leave it alone") from an explicit null or 'private' ("make it
-        // private"). Sending the key with a null value would unpublish a tenant-wide
-        // skill on any edit by someone who cannot publish.
-        //
-        // `!= null`, not `!== null`: the type says this is always present, but the value
-        // arrives from a component, and an untyped caller omitting it would spread
-        // `{visibility: undefined}` — a key present with no value, which is the one shape
-        // the rule above is about. The looser check costs nothing and closes it.
-        ...(draft.visibility != null && { visibility: draft.visibility }),
-    };
-    const request$ = macroId != null && macroId !== ''
-        ? zeniAPI.putAndGetJSON(`${base}/${encodeURIComponent(macroId)}`, body)
-        : zeniAPI.postAndGetJSON(base, body);
-    return request$.pipe(mergeMap((response) => {
-        if (isSuccessResponse(response) &&
-            isSkillDetailPayload(response.data)) {
-            const saved = response.data;
-            const savedMacroId = saved.skill.macro_id;
-            const emitted = [
-                saveSkillSuccess({
-                    macroId: savedMacroId,
-                    // The response is a full detail read — carried through so an editor left
-                    // on this skill shows what it just saved rather than the previous prompt.
-                    detail: toSkillDetail(saved),
-                }),
-                // Refetch rather than splice the response in: a create changes the list's
-                // ordering and an update can change the name it is sorted by, so a local
-                // insert would put the row somewhere the next load moves it away from.
-                fetchSkills(),
-            ];
-            // A save adds a version, so the history panel is one behind — but only
-            // refetch when this skill is still the one on screen. `fetchSkillVersions`
-            // takes ownership of the versions slice, so firing it for a skill the user
-            // has already left would cancel the history of whatever they opened next.
-            if (getSkillDetail(state$.value).macroId === savedMacroId) {
-                emitted.push(fetchSkillVersions({ macroId: savedMacroId }));
-            }
-            return of(...emitted);
-        }
-        // A malformed 2xx is a failure, not a silent success: reporting "saved" when
-        // no skill came back leaves the user believing work was persisted.
-        return of(saveSkillFailure(response.status));
-    }), catchError((error) => of(saveSkillFailure(createZeniAPIStatus('Unexpected Error', 'Save skill REST API call failed', error instanceof Error ? { message: error.message } : undefined)))));
-}));

package/lib/esm/view/aiCfoView/epics/setSkillVisibilityEpic.js

@@ -1,32 +0,0 @@
-import { of } from 'rxjs';
-import { catchError, filter, mergeMap } from 'rxjs/operators';
-import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
-import { fetchSkills, setSkillVisibility, setSkillVisibilityFailure, setSkillVisibilitySuccess, } from '../aiCfoViewReducer';
-import { isSkillDetailPayload, toSkillDetail } from './toSkillDetail';
-/**
- * PUT /1.0/skills/{macroId}/visibility — publish or unpublish, without a new version.
- *
- * Its own route rather than the prompt PUT: that one requires name and instructions, so a
- * visibility-only change cannot be expressed through it, and sending the whole prompt back
- * to flip one field would create a version whose prompt is identical to its parent's.
- */
-export const setSkillVisibilityEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(setSkillVisibility.match), 
-// mergeMap, like the other writes: cancelling a write in flight does not un-send it,
-// it only hides the outcome — and for a publish that means a skill sitting in every
-// colleague's menu with nobody told it got there.
-mergeMap((action) => {
-    const { macroId, visibility } = action.payload;
-    const url = `${zeniAPI.apiEndPoints.aiCfoMicroServiceBaseUrl}/1.0/skills/${encodeURIComponent(macroId)}/visibility`;
-    return zeniAPI.putAndGetJSON(url, { visibility }).pipe(mergeMap((response) => {
-        if (isSuccessResponse(response) &&
-            isSkillDetailPayload(response.data)) {
-            return of(setSkillVisibilitySuccess({
-                macroId,
-                detail: toSkillDetail(response.data),
-            }), 
-            // The list carries the badge that shows the audience, so it is now stale.
-            fetchSkills());
-        }
-        return of(setSkillVisibilityFailure(response.status));
-    }), catchError((error) => of(setSkillVisibilityFailure(createZeniAPIStatus('Unexpected Error', 'Set skill visibility REST API call failed', error instanceof Error ? { message: error.message } : undefined)))));
-}));

package/lib/esm/view/aiCfoView/epics/toSkillDetail.js

@@ -1,102 +0,0 @@
-/**
- * Every value `SkillVisibility` admits, as data so the converter below cannot drift from
- * the type. Adding a tier to the union without adding it here is a compile error.
- */
-const SKILL_VISIBILITIES = ['private', 'tenant'];
-/**
- * A wire string narrowed to {@link SkillVisibility}, or null.
- *
- * A converter rather than passing the raw string through, because `Skill.visibility` is a
- * union on the state type and this is the boundary where an unvalidated payload becomes
- * it — the repo's rule about explicit converters at scalar boundaries instead of a bare
- * cast.
- *
- * Unrecognised maps to NULL, not to `'private'`. Null already means "does not apply" for a
- * Zeni default, and consumers show no audience badge for it — so an unknown tier renders
- * as no badge. Defaulting to `'private'` would instead label a skill the whole tenant can
- * run as author-only, which is a confident lie rather than a visible gap.
- */
-export const toSkillVisibility = (raw) => SKILL_VISIBILITIES.find((known) => known === raw) ?? null;
-/**
- * Everything about a skill summary EXCEPT `exampleHints`, which no shared mapper can
- * honestly supply.
- *
- * Only the LIST route returns `parameter_hints`; the detail and write routes do not. A
- * shared mapper hardcoding `exampleHints: []` would put a "try: …" line under a skill
- * that has hints, or drop them from the menu — so the field is `Omit`ted and each caller
- * spreads in what its own route actually knows.
- *
- * Returning `Omit<Skill, 'exampleHints'>` rather than duplicating the mapper is what
- * makes a new `Skill` field land in one place: this function stops compiling until the
- * field is mapped, and both callers inherit it. The previous shape — two full copies —
- * is how `isMine` was nearly added to only one of them, which would have silently
- * withheld the edit and delete controls on whichever surface was missed.
- */
-export const toBaseSkill = (payload) => ({
-    macroId: payload.macro_id,
-    name: payload.name,
-    displayName: payload.display_name,
-    description: payload.description,
-    semver: payload.semver,
-    hasScripts: payload.has_scripts === true,
-    // === true, so an absent field withholds the write controls rather than offering ones
-    // the API refuses.
-    isMine: payload.is_mine === true,
-    isOwnedByTenant: payload.is_owned_by_tenant === true,
-    updatedAt: payload.updated_at ?? null,
-    visibility: toSkillVisibility(payload.visibility),
-});
-/**
- * Whether a 2xx body carries a prompt.
- *
- * Narrows to {@link PromptBody} and NOT to the whole payload, because the only consumer —
- * the version-body read — dereferences `instructions` and nothing else. Asserting the
- * whole shape here would claim `skill` was checked when it was not, and tying the read to
- * it would fail a response whose prompt was fine and whose `skill` block was malformed,
- * which is exactly what happened when this was one predicate instead of two.
- *
- * Takes `unknown`: the input is an unvalidated network body, and typing the parameter as
- * the payload interface would assume the very thing being checked.
- */
-export const hasPromptBody = (data) => typeof data?.instructions ===
-    'string';
-/**
- * Whether a 2xx body can build a whole {@link SkillDetail}.
- *
- * Narrows to the payload type itself, which is now truthful: the two fields this checks
- * are the two the interface still declares required, and the other three are optional
- * there. Stricter than {@link hasPromptBody} by exactly one field. Four epics read this shape
- * and each used to guard it differently — `data != null`, `data?.skill != null`, and a
- * real `instructions` check — so one malformed response became a failure in one place, an
- * empty prompt in another, and `undefined` in a third.
- */
-export const isSkillDetailPayload = (data) => hasPromptBody(data) && data.skill != null;
-/**
- * The detail payload every write route answers with.
- *
- * Shared because three epics need it — save, visibility, and the detail read — and a
- * fourth copy is how one of them quietly stops carrying a field the others do.
- *
- * The coercions are not defensive habit; the payload type makes them mandatory — the
- * three optional fields cannot be assigned to a non-optional `SkillDetail` without one.
- * Which fields get coerced and which do not is the deliberate part:
- *
- * - `instructions` is load-bearing and already proven, so it passes through. Defaulting a
- *   missing prompt to `''` is the one thing this module exists to prevent: the user
- *   cannot tell an empty prompt from a skill that has one, and may save over the real
- *   thing.
- * - `instructionsCharCount` falls back to the prompt's own length, NOT to 0. A 12,000
- *   character prompt displayed as "0 characters" is a lie the user can see, and the
- *   prompt is right here to measure. Approximate only for astral-plane characters, where
- *   UTF-16 units and the server's count differ — a rounding error, against a guaranteed
- *   wrong answer.
- * - `artifact` and `artifactTitle` degrade to empty. They render a preview card, so
- *   losing them costs a card; failing the whole read would cost the user the skill.
- */
-export const toSkillDetail = (payload) => ({
-    skill: { ...toBaseSkill(payload.skill), exampleHints: [] },
-    instructions: payload.instructions,
-    instructionsCharCount: payload.instructions_char_count ?? payload.instructions.length,
-    artifact: payload.artifact ?? '',
-    artifactTitle: payload.artifact_title ?? '',
-});

package/lib/esm/view/balanceSheetClassesView/balanceSheetClassesViewEpic.js

@@ -1,30 +0,0 @@
-import { from } from 'rxjs';
-import { filter, switchMap } from 'rxjs/operators';
-import { fetchBalanceSheetClassesView, fetchBalanceSheetForTimeframeClassesView, } from './balanceSheetClassesViewReducer';
-export const fetchBalanceSheetClassesViewEpic = (actions$, state) => actions$.pipe(filter(fetchBalanceSheetClassesView.match), switchMap((action) => {
-    const { cacheOverride } = action.payload;
-    if (cacheOverride === true) {
-        return from([
-            fetchBalanceSheetForTimeframeClassesView('month', true),
-            fetchBalanceSheetForTimeframeClassesView('quarter', true),
-            fetchBalanceSheetForTimeframeClassesView('year', true),
-        ]);
-    }
-    else {
-        const fetchActions = [];
-        const classFetchState = state.value.balanceSheetClassesViewState.fetchState;
-        if (classFetchState['month'].fetchState !== 'In-Progress' &&
-            classFetchState['month'].fetchState !== 'Completed') {
-            fetchActions.push(fetchBalanceSheetForTimeframeClassesView('month'));
-        }
-        if (classFetchState['quarter'].fetchState !== 'In-Progress' &&
-            classFetchState['quarter'].fetchState !== 'Completed') {
-            fetchActions.push(fetchBalanceSheetForTimeframeClassesView('quarter'));
-        }
-        if (classFetchState['year'].fetchState !== 'In-Progress' &&
-            classFetchState['year'].fetchState !== 'Completed') {
-            fetchActions.push(fetchBalanceSheetForTimeframeClassesView('year'));
-        }
-        return from(fetchActions);
-    }
-}));

package/lib/esm/view/balanceSheetClassesView/balanceSheetClassesViewPayload.js

@@ -1 +0,0 @@
-export {};

package/lib/esm/view/balanceSheetClassesView/balanceSheetClassesViewReducer.js

@@ -1,129 +0,0 @@
-import { createSlice } from '@reduxjs/toolkit';
-import { mapReportPayloadV2ToReportV2 } from '../../commonPayloadTypes/v2/viewAndReportPayloadv2';
-import { geNestedClassIDHierarchyForReport } from '../../commonStateTypes/classesView/getNestedClassIDHierarchyForReport';
-import { toClassMetadata } from '../../entity/class/classPayload';
-import { clearAll } from '../../rootActions';
-export const initialState = {
-    classHierarchy: [],
-    bookCloseDate: undefined,
-    fetchState: {
-        month: {
-            fetchState: 'Not-Started',
-            error: undefined,
-        },
-        quarter: {
-            fetchState: 'Not-Started',
-            error: undefined,
-        },
-        year: {
-            fetchState: 'Not-Started',
-            error: undefined,
-        },
-    },
-    uiState: {
-        nodeCollapseState: {},
-        scrollPosition: undefined,
-        accountViewMode: 'account_group',
-        classesToFilterOut: [],
-    },
-    firstMonthOfFY: 1,
-    reportId: 'balance_sheet_by_classes',
-    reportTitle: 'balance_sheet_by_classes',
-};
-const balanceSheetClassesView = createSlice({
-    name: 'balanceSheetClassesView',
-    initialState,
-    reducers: {
-        fetchBalanceSheetClassesView: {
-            prepare(cacheOverride = false) {
-                return { payload: { cacheOverride } };
-            },
-            reducer(
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            _draft, 
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            _action) {
-                // nothing to do here
-            },
-        },
-        fetchBalanceSheetForTimeframeClassesView: {
-            prepare(timeframe, cacheOverride = false) {
-                return { payload: { timeframe, cacheOverride } };
-            },
-            reducer(draft, action) {
-                const timeframe = action.payload.timeframe;
-                draft.fetchState[timeframe].fetchState = 'In-Progress';
-                draft.fetchState[timeframe].error = undefined;
-            },
-        },
-        updateBalanceSheetForTimeframeClassesView(draft, action) {
-            doUpdateBalanceSheetClassesView(draft, action.payload.timeframe, action.payload.report);
-        },
-        updateBalanceSheetForTimeframeClassesViewFailure: {
-            prepare(error, timeframe) {
-                return {
-                    payload: {
-                        error,
-                        timeframe,
-                    },
-                };
-            },
-            reducer(draft, action) {
-                draft.fetchState[action.payload.timeframe] = {
-                    fetchState: 'Error',
-                    error: action.payload.error,
-                };
-            },
-        },
-        updateBalanceSheetClassesToFilterOut(draft, action) {
-            draft.uiState.classesToFilterOut = action.payload.classesToFilterOut;
-        },
-        updateBalanceSheetClassesViewUIState(draft, action) {
-            const { nodeCollapseState, scrollPosition, resetLeftScroll } = action.payload;
-            if (nodeCollapseState != null) {
-                draft.uiState.nodeCollapseState = Object.assign({}, draft.uiState.nodeCollapseState, {
-                    [nodeCollapseState.nodeId]: nodeCollapseState.isCollapsed,
-                });
-            }
-            // Mutually exclusive: resetLeftScroll clears only scrollLeft from the
-            // recorded position, scrollPosition replaces the whole record.
-            if (resetLeftScroll === true && draft.uiState.scrollPosition != null) {
-                draft.uiState.scrollPosition.scrollLeft = undefined;
-            }
-            else if (scrollPosition != null) {
-                draft.uiState.scrollPosition = scrollPosition;
-            }
-        },
-        updateBalanceSheetClassesViewAccountViewMode(draft, action) {
-            draft.uiState.accountViewMode = action.payload.viewMode;
-        },
-        resetBalanceSheetClassesNodeCollapseState(draft) {
-            draft.uiState.nodeCollapseState = {};
-        },
-    },
-    extraReducers: (builder) => {
-        builder.addCase(clearAll, (draft) => {
-            Object.assign(draft, initialState);
-        });
-    },
-});
-export const { fetchBalanceSheetClassesView, fetchBalanceSheetForTimeframeClassesView, updateBalanceSheetForTimeframeClassesView, updateBalanceSheetForTimeframeClassesViewFailure, updateBalanceSheetClassesToFilterOut, updateBalanceSheetClassesViewUIState, updateBalanceSheetClassesViewAccountViewMode, resetBalanceSheetClassesNodeCollapseState, } = balanceSheetClassesView.actions;
-export default balanceSheetClassesView.reducer;
-const doUpdateBalanceSheetClassesView = (draft, timeframe, balanceSheetReport) => {
-    const report = mapReportPayloadV2ToReportV2(balanceSheetReport.report);
-    draft.currency = report.currency;
-    draft.dataAvailable = report.dataAvailable;
-    draft.firstMonthOfFY = report.firstMonthOfFY;
-    draft.bookCloseDate = report.bookCloseDate;
-    draft.status = report.status;
-    draft.fetchState[timeframe].fetchState = 'Completed';
-    draft.fetchState[timeframe].error = undefined;
-    const classMetadata = balanceSheetReport.report.classes.map((eachClass) => toClassMetadata(eachClass));
-    // Populated once and then left alone, so a per-timeframe response cannot
-    // clobber a hierarchy built from a full one. A class added mid-session is
-    // therefore not picked up until the store is cleared, even by a hard refresh —
-    // the same trade-off profitAndLossClassesViewReducer makes.
-    if (draft.classHierarchy.length <= 0) {
-        draft.classHierarchy = geNestedClassIDHierarchyForReport(classMetadata);
-    }
-};