@zeniai/client-epic-state 5.1.18-betaDI1 → 5.1.18-betaDI10

package/lib/entity/aiCfo/aiCfoState.d.ts

@@ -0,0 +1,212 @@
+import { ID } from '../../commonStateTypes/common';
+import { ZeniDate } from '../../zeniDayJS';
+export interface AiCfoAnswerParagraph {
+    text: string;
+    orderedList?: Array<{
+        text: string;
+        subText?: string;
+        unorderedList?: string[];
+    }>;
+}
+export declare const ALL_AI_CFO_CHARTS_TYPES: readonly ["bar_chart", "pie_chart", "line_chart"];
+export declare const ALL_AI_CFO_VISUALIZATION_TYPES: readonly ["bar_chart", "pie_chart", "line_chart", "table", "interactive_form"];
+export declare const ALL_INTERACTIVE_FORM_TYPES: readonly ["cards_creation", "card_policy"];
+export declare const toInteractiveFormType: (v: string) => "cards_creation" | "card_policy";
+export declare const toInteractiveFormTypeStrict: (v: string) => "cards_creation" | "card_policy" | undefined;
+export type InteractiveFormType = ReturnType<typeof toInteractiveFormType>;
+export declare const toAiCfoVisualizationType: (v: string) => "bar_chart" | "pie_chart" | "line_chart" | "table" | "interactive_form";
+export declare const toAiCfoVisualizationTypeStrict: (v: string) => "bar_chart" | "pie_chart" | "line_chart" | "table" | "interactive_form" | undefined;
+export type AiCfoVisualizationType = ReturnType<typeof toAiCfoVisualizationType>;
+export declare const toAiCfoChartType: (v: string) => "bar_chart" | "pie_chart" | "line_chart";
+export declare const toAiCfoChartTypeStrict: (v: string) => "bar_chart" | "pie_chart" | "line_chart" | undefined;
+export type AiCfoChartType = ReturnType<typeof toAiCfoChartType>;
+export declare const ALL_AI_CFO_ANSWER_STATE_TYPES: readonly ["complete", "partial"];
+export declare const ALL_AI_CFO_ANSWER_RESPONSE_TYPES: readonly ["analysis", "answer", "reasoning", "thought"];
+export declare const ALL_Y_FORMAT_TYPES: readonly ["currency", "number"];
+export declare const ALL_Y_FORMAT_NON_CURRENCY_UNITS: readonly ["percentage", "unit", "ratio"];
+export declare const ALL_Y_FORMAT_SCALES: readonly ["raw", "K", "M", "B", "T"];
+export declare const toYFormatType: (v: string) => "number" | "currency";
+export declare const toYFormatUnit: (v: string) => string;
+export declare const toYFormatScale: (v: string) => "M" | "raw" | "K" | "B" | "T";
+export declare const toYFormatTypeStrict: (v: string) => "number" | "currency" | undefined;
+export declare const toYFormatUnitStrict: (v: string) => string;
+export declare const toYFormatScaleStrict: (v: string) => "M" | "raw" | "K" | "B" | "T" | undefined;
+export type YFormatType = ReturnType<typeof toYFormatType>;
+export type YFormatUnit = ReturnType<typeof toYFormatUnit>;
+export type YFormatScale = ReturnType<typeof toYFormatScale>;
+export interface YFormat {
+    scale: YFormatScale;
+    type: YFormatType;
+    unit: YFormatUnit;
+    symbol?: string;
+}
+export declare const toAiCfoAnswerStateType: (v: string) => "complete" | "partial";
+export declare const toAiCfoAnswerResponseType: (v: string) => "analysis" | "answer" | "reasoning" | "thought";
+export declare const toAiCfoAnswerStateTypeStrict: (v: string) => "complete" | "partial" | undefined;
+export declare const toAiCfoAnswerResponseTypeStrict: (v: string) => "analysis" | "answer" | "reasoning" | "thought" | undefined;
+export type AiCfoAnswerStateType = ReturnType<typeof toAiCfoAnswerStateType>;
+export type AiCfoAnswerResponseType = ReturnType<typeof toAiCfoAnswerResponseType>;
+export interface TableVisualization {
+    columns: string[];
+    rows: string[][];
+}
+export interface ChartVisualization {
+    values: Array<Record<string, string | number>>;
+    x: string;
+    y: string[];
+    lines?: string[];
+    yFormat?: YFormat;
+}
+export type CardsCardKind = 'vendor' | 'class' | 'category';
+export interface CardNameOption {
+    id: string;
+    kind: CardsCardKind;
+    label: string;
+}
+export interface CardsCreationCommonData {
+    cardNameOptions: CardNameOption[];
+    suggestedOwnerUserIdByTeamId: Record<string, ID | undefined>;
+}
+export type CardsCreationInitialData = (CardsCreationCommonData & {
+    mode: 'review';
+    teamRows: Array<{
+        avgMonthlySpend: string;
+        cardKind: CardsCardKind;
+        id: string;
+        label: string;
+        recommendedLimit: string;
+        recommendedLimitCadence?: string;
+    }>;
+}) | (CardsCreationCommonData & {
+    cardRows: Array<{
+        cardKind: CardsCardKind;
+        id: string;
+        label: string;
+        recommendedLimit?: number;
+        suggestedOwnerUserId?: ID;
+    }>;
+    mode: 'create';
+});
+export interface CardPolicyDraftPolicyEntity {
+    categoryCodes: string[];
+    merchantNames: string[];
+}
+export interface CardPolicySpendLimits {
+    transaction: number;
+}
+export interface CardPolicyDraftPolicy {
+    allowedEntity: CardPolicyDraftPolicyEntity;
+    applyToCards: string[];
+    blockedEntity: CardPolicyDraftPolicyEntity;
+    description: string;
+    id: string;
+    mode: string;
+    name: string;
+    requiredReceiptThreshold: number;
+    spendLimits: CardPolicySpendLimits;
+}
+export interface CardPolicyStep5Review {
+    draftPolicies: CardPolicyDraftPolicy[];
+    groupingSource: string;
+    prompt: string;
+}
+export interface CardPolicyWizardPlan {
+    step5Review: CardPolicyStep5Review;
+}
+export interface CardPolicyUploadSource {
+    confidenceScore: number;
+    fileName: string;
+    lowConfidenceFields: string[];
+}
+export type CardPolicyInitialData = {
+    policyKind: 'auto';
+    wizardPlan: CardPolicyWizardPlan;
+} | {
+    policyKind: 'guided';
+    wizardPlan: CardPolicyWizardPlan;
+} | {
+    policyKind: 'upload';
+    source?: CardPolicyUploadSource;
+    wizardPlan?: CardPolicyWizardPlan;
+};
+export type InteractiveFormVisualization = {
+    formType: 'cards_creation';
+    payload: CardsCreationInitialData;
+} | {
+    formType: 'card_policy';
+    payload: CardPolicyInitialData;
+};
+export interface AiCfoVisualization {
+    data: TableVisualization | ChartVisualization | InteractiveFormVisualization;
+    type: AiCfoVisualizationType;
+}
+export declare const toMessageSender: (v: string) => "user" | "agent";
+export declare const toMessageType: (v: string) => "plain_text" | "json";
+export declare const toMessageSenderStrict: (v: string) => "user" | "agent" | undefined;
+export declare const toMessageTypeStrict: (v: string) => "plain_text" | "json" | undefined;
+export type MessageSender = ReturnType<typeof toMessageSender>;
+export type MessageType = ReturnType<typeof toMessageType>;
+export interface ResponseBlockBase {
+    chatSessionId: ID;
+    createdAt: ZeniDate;
+    messageId: ID;
+    sender: MessageSender;
+    state: AiCfoAnswerStateType;
+    userId: ID;
+}
+export interface AnswerContentBlockBase {
+    assumptions: string;
+    chainOfThoughtActionSteps: string[];
+    followUpQuestions: string[];
+    insights: string;
+    text: string;
+    artifact?: string;
+    artifactHostUrl?: string;
+    artifactTitle?: string;
+    summarizedTitle?: string;
+    table?: AiCfoVisualization;
+    visualization?: AiCfoVisualization;
+}
+export interface FileAttachmentMetadata {
+    file_size: number;
+    filename: string;
+    mime_type: string;
+    file_id?: string;
+}
+export interface QuestionContentBlockBase extends ResponseBlockBase {
+    questionText: string;
+    attachments?: FileAttachmentMetadata[];
+}
+export interface ResponseBlockType extends ResponseBlockBase {
+    content: AnswerContentBlockBase;
+    type: AiCfoAnswerResponseType;
+}
+export interface AiCfoQuestionWithAnswer {
+    question: QuestionContentBlockBase;
+    questionAnswerId: ID;
+    responses: Partial<Record<AiCfoAnswerResponseType, ResponseBlockType>>;
+}
+export interface ChatSession {
+    chatSessionId: ID;
+    createdAt: ZeniDate;
+    userId: ID;
+    chatSessionSummary?: string;
+}
+export interface ChatSessionWithMessages {
+    chatSession: ChatSession;
+    questionAnswers: AiCfoQuestionWithAnswer[];
+}
+export declare const ALL_SYNTHETIC_AI_CFO_ANSWER_KINDS: readonly ["creating_cards", "creating_policy", "created_cards", "created_policy", "errored_cards", "errored_policy"];
+export type SyntheticAiCfoAnswerKind = (typeof ALL_SYNTHETIC_AI_CFO_ANSWER_KINDS)[number];
+export interface SyntheticAiCfoAnswer {
+    createdAt: ZeniDate;
+    entityIds: ID[];
+    id: ID;
+    kind: SyntheticAiCfoAnswerKind;
+    sourceQuestionAnswerId: ID;
+}
+export interface AiCfoState {
+    aiCfoByChatSessionId: Record<ID, ChatSessionWithMessages>;
+    partialQuestionAnswers: Record<ID, AiCfoQuestionWithAnswer | undefined>;
+    syntheticAnswersByChatSessionId: Record<ID, SyntheticAiCfoAnswer[]>;
+}

package/lib/entity/aiCfo/aiCfoState.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_SYNTHETIC_AI_CFO_ANSWER_KINDS = exports.toMessageTypeStrict = exports.toMessageSenderStrict = exports.toMessageType = exports.toMessageSender = exports.toAiCfoAnswerResponseTypeStrict = exports.toAiCfoAnswerStateTypeStrict = exports.toAiCfoAnswerResponseType = exports.toAiCfoAnswerStateType = exports.toYFormatScaleStrict = exports.toYFormatUnitStrict = exports.toYFormatTypeStrict = exports.toYFormatScale = exports.toYFormatUnit = exports.toYFormatType = exports.ALL_Y_FORMAT_SCALES = exports.ALL_Y_FORMAT_NON_CURRENCY_UNITS = exports.ALL_Y_FORMAT_TYPES = exports.ALL_AI_CFO_ANSWER_RESPONSE_TYPES = exports.ALL_AI_CFO_ANSWER_STATE_TYPES = exports.toAiCfoChartTypeStrict = exports.toAiCfoChartType = exports.toAiCfoVisualizationTypeStrict = exports.toAiCfoVisualizationType = exports.toInteractiveFormTypeStrict = exports.toInteractiveFormType = exports.ALL_INTERACTIVE_FORM_TYPES = exports.ALL_AI_CFO_VISUALIZATION_TYPES = exports.ALL_AI_CFO_CHARTS_TYPES = void 0;
+const stringToUnion_1 = require("../../commonStateTypes/stringToUnion");
+exports.ALL_AI_CFO_CHARTS_TYPES = [
+    'bar_chart',
+    'pie_chart',
+    'line_chart',
+];
+exports.ALL_AI_CFO_VISUALIZATION_TYPES = [
+    ...exports.ALL_AI_CFO_CHARTS_TYPES,
+    'table',
+    'interactive_form',
+];
+exports.ALL_INTERACTIVE_FORM_TYPES = [
+    'cards_creation',
+    'card_policy',
+];
+const toInteractiveFormType = (v) => (0, stringToUnion_1.stringToUnion)(v, exports.ALL_INTERACTIVE_FORM_TYPES);
+exports.toInteractiveFormType = toInteractiveFormType;
+const toInteractiveFormTypeStrict = (v) => (0, stringToUnion_1.stringToUnionStrict)(v, exports.ALL_INTERACTIVE_FORM_TYPES);
+exports.toInteractiveFormTypeStrict = toInteractiveFormTypeStrict;
+const toAiCfoVisualizationType = (v) => (0, stringToUnion_1.stringToUnion)(v, exports.ALL_AI_CFO_VISUALIZATION_TYPES);
+exports.toAiCfoVisualizationType = toAiCfoVisualizationType;
+const toAiCfoVisualizationTypeStrict = (v) => (0, stringToUnion_1.stringToUnionStrict)(v, exports.ALL_AI_CFO_VISUALIZATION_TYPES);
+exports.toAiCfoVisualizationTypeStrict = toAiCfoVisualizationTypeStrict;
+const toAiCfoChartType = (v) => (0, stringToUnion_1.stringToUnion)(v, exports.ALL_AI_CFO_CHARTS_TYPES);
+exports.toAiCfoChartType = toAiCfoChartType;
+const toAiCfoChartTypeStrict = (v) => (0, stringToUnion_1.stringToUnionStrict)(v, exports.ALL_AI_CFO_CHARTS_TYPES);
+exports.toAiCfoChartTypeStrict = toAiCfoChartTypeStrict;
+exports.ALL_AI_CFO_ANSWER_STATE_TYPES = ['complete', 'partial'];
+exports.ALL_AI_CFO_ANSWER_RESPONSE_TYPES = [
+    'analysis',
+    'answer',
+    'reasoning',
+    'thought',
+];
+exports.ALL_Y_FORMAT_TYPES = ['currency', 'number'];
+exports.ALL_Y_FORMAT_NON_CURRENCY_UNITS = [
+    'percentage',
+    'unit',
+    'ratio',
+];
+exports.ALL_Y_FORMAT_SCALES = ['raw', 'K', 'M', 'B', 'T'];
+const toYFormatType = (v) => (0, stringToUnion_1.stringToUnion)(v, exports.ALL_Y_FORMAT_TYPES);
+exports.toYFormatType = toYFormatType;
+const toYFormatUnit = (v) => {
+    // Check if it's one of the non-currency units
+    const nonCurrencyUnit = (0, stringToUnion_1.stringToUnion)(v, exports.ALL_Y_FORMAT_NON_CURRENCY_UNITS);
+    if (nonCurrencyUnit) {
+        return nonCurrencyUnit;
+    }
+    // If not a non-currency unit, assume it's a currency code and return it.
+    return v;
+};
+exports.toYFormatUnit = toYFormatUnit;
+const toYFormatScale = (v) => (0, stringToUnion_1.stringToUnion)(v, exports.ALL_Y_FORMAT_SCALES);
+exports.toYFormatScale = toYFormatScale;
+const toYFormatTypeStrict = (v) => (0, stringToUnion_1.stringToUnionStrict)(v, exports.ALL_Y_FORMAT_TYPES);
+exports.toYFormatTypeStrict = toYFormatTypeStrict;
+const toYFormatUnitStrict = (v) => {
+    // Check if it's one of the non-currency units
+    const nonCurrencyUnit = (0, stringToUnion_1.stringToUnionStrict)(v, exports.ALL_Y_FORMAT_NON_CURRENCY_UNITS);
+    if (nonCurrencyUnit) {
+        return nonCurrencyUnit;
+    }
+    // If not a non-currency unit, assume it's a currency code and return it.
+    return v;
+};
+exports.toYFormatUnitStrict = toYFormatUnitStrict;
+const toYFormatScaleStrict = (v) => (0, stringToUnion_1.stringToUnionStrict)(v, exports.ALL_Y_FORMAT_SCALES);
+exports.toYFormatScaleStrict = toYFormatScaleStrict;
+const toAiCfoAnswerStateType = (v) => (0, stringToUnion_1.stringToUnion)(v, exports.ALL_AI_CFO_ANSWER_STATE_TYPES);
+exports.toAiCfoAnswerStateType = toAiCfoAnswerStateType;
+const toAiCfoAnswerResponseType = (v) => (0, stringToUnion_1.stringToUnion)(v, exports.ALL_AI_CFO_ANSWER_RESPONSE_TYPES);
+exports.toAiCfoAnswerResponseType = toAiCfoAnswerResponseType;
+const toAiCfoAnswerStateTypeStrict = (v) => (0, stringToUnion_1.stringToUnionStrict)(v, exports.ALL_AI_CFO_ANSWER_STATE_TYPES);
+exports.toAiCfoAnswerStateTypeStrict = toAiCfoAnswerStateTypeStrict;
+const toAiCfoAnswerResponseTypeStrict = (v) => (0, stringToUnion_1.stringToUnionStrict)(v, exports.ALL_AI_CFO_ANSWER_RESPONSE_TYPES);
+exports.toAiCfoAnswerResponseTypeStrict = toAiCfoAnswerResponseTypeStrict;
+const ALL_MESSAGE_SENDERS = ['user', 'agent'];
+const ALL_MESSAGE_TYPES = ['plain_text', 'json'];
+const toMessageSender = (v) => (0, stringToUnion_1.stringToUnion)(v, ALL_MESSAGE_SENDERS);
+exports.toMessageSender = toMessageSender;
+const toMessageType = (v) => (0, stringToUnion_1.stringToUnion)(v, ALL_MESSAGE_TYPES);
+exports.toMessageType = toMessageType;
+const toMessageSenderStrict = (v) => (0, stringToUnion_1.stringToUnionStrict)(v, ALL_MESSAGE_SENDERS);
+exports.toMessageSenderStrict = toMessageSenderStrict;
+const toMessageTypeStrict = (v) => (0, stringToUnion_1.stringToUnionStrict)(v, ALL_MESSAGE_TYPES);
+exports.toMessageTypeStrict = toMessageTypeStrict;
+// Client-synthesized AI CFO answer bubbles (Creating…/Created) pushed when the user
+// submits an interactive form; not streamed from the backend.
+exports.ALL_SYNTHETIC_AI_CFO_ANSWER_KINDS = [
+    'creating_cards',
+    'creating_policy',
+    'created_cards',
+    'created_policy',
+    'errored_cards',
+    'errored_policy',
+];

package/lib/entity/approvalRule/approvalRulePayload.d.ts

@@ -0,0 +1,67 @@
+import { ApprovalRule } from './approvalRuleState';
+/**
+ * Condition Payload — one entry inside criteria.conditions[].
+ *
+ * field examples: 'amount' | 'vendor_id' | 'accounting_class_id'
+ * type examples:  'gte' | 'lte' | 'eq' | 'in' | 'not_in'
+ * value: number for amount comparisons; string[] for in / not_in lookups.
+ */
+export interface ConditionPayload {
+    field: string;
+    type: string;
+    value: number | string[];
+}
+/**
+ * Criteria Payload — list of conditions joined by `criteria_operator`.
+ *
+ * `currency_code` / `currency_symbol` apply to amount conditions inside
+ * `conditions[]`. Kept here pending confirmation that they should remain.
+ */
+export interface CriteriaPayload {
+    conditions: ConditionPayload[];
+    criteria_operator: string;
+    currency_code: string;
+    currency_symbol: string;
+}
+export interface ActorPayload {
+    type: string;
+    id?: string | null;
+    id_type?: string | null;
+    is_implicit_actor?: boolean;
+    sub_type?: string | null;
+}
+export interface StepPayload {
+    action: string;
+    actors: ActorPayload[];
+    operator: string;
+}
+/**
+ * Approval Rule Payload
+ */
+export interface ApprovalRulePayload {
+    approval_rule_id: string;
+    create_time: string;
+    criteria: CriteriaPayload;
+    entity_type: string;
+    name: string | null;
+    steps: StepPayload[];
+    update_time: string;
+    are_approvals_serialized?: boolean;
+    description?: string | null;
+    is_fallback?: boolean;
+    /**
+     * Approval Rules 3.0 — when `true`, the rule enforces separation of
+     * duties (a user can't approve their own request even if they are
+     * also an approver). The list-page rule card surfaces this as a
+     * green "Separation of duties" capsule.
+     */
+    is_separation_of_duty_enabled?: boolean;
+    pending_approvals_count?: number;
+    pending_entity_approval_update_status?: string;
+    priority?: number;
+    version?: number | string;
+}
+/**
+ * Helpers
+ */
+export declare const toApprovalRule: (payload: ApprovalRulePayload) => ApprovalRule;

package/lib/entity/approvalRule/approvalRulePayload.js

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toApprovalRule = void 0;
+const amount_1 = require("../../commonStateTypes/amount");
+const zeniDayJS_1 = require("../../zeniDayJS");
+const entityApprovalStatusState_1 = require("../entityApprovalStatus/entityApprovalStatusState");
+const approvalRuleState_1 = require("./approvalRuleState");
+/**
+ * Helpers
+ */
+const toApprovalRule = (payload) => ({
+    approvalRuleId: payload.approval_rule_id,
+    entityType: (0, entityApprovalStatusState_1.toEntityType)(payload.entity_type === 'bill' ? 'bill_pay' : payload.entity_type),
+    name: payload.name ?? undefined,
+    createTime: (0, zeniDayJS_1.dateLocal)(payload.create_time),
+    updateTime: (0, zeniDayJS_1.dateLocal)(payload.update_time),
+    version: payload.version,
+    criteria: toApprovalCriteria(payload.criteria),
+    steps: toApprovalSteps(payload.steps),
+    description: payload.description ?? undefined,
+    priority: payload.priority,
+    isFallback: payload.is_fallback ?? false,
+    separationOfDuties: payload.is_separation_of_duty_enabled ?? false,
+    areApprovalsSerialized: payload.are_approvals_serialized,
+    pendingApprovalsCount: payload.pending_approvals_count,
+    pendingEntityApprovalUpdateStatus: payload.pending_entity_approval_update_status,
+});
+exports.toApprovalRule = toApprovalRule;
+/**
+ * Maps the wire-level criteria block into the state-side discriminated
+ * `Criteria[]` union.
+ *
+ * The wire keeps each condition as a flat row inside `conditions[]`.
+ * Amount comparisons can show up as a `gte` only, a `lte` only, or a
+ * `gte` + `lte` pair — those collapse into a single AmountCriteria whose
+ * `comparator` is `greater_than`, `less_than`, or `range` respectively.
+ *
+ * Vendor and department conditions map one-to-one: `in` becomes `is`,
+ * `not_in` becomes `is_not`.
+ *
+ * Resilient to two forms of upstream drift:
+ *  - Missing / null criteria → returns [].
+ *  - Legacy criteria shape (array of amount-range objects, the pre-3.0
+ *    wire) → converted to an AmountCriteria so existing rules in production
+ *    still render while the backend rolls out.
+ */
+const toApprovalCriteria = (payload) => {
+    if (payload == null) {
+        return [];
+    }
+    if (Array.isArray(payload)) {
+        // Legacy pre-3.0 wire: an array of amount-range entries.
+        return legacyAmountRangeToCriteria(payload);
+    }
+    if (!Array.isArray(payload.conditions)) {
+        return [];
+    }
+    const results = [];
+    const amountCriteria = toAmountCriteria(payload);
+    if (amountCriteria != null) {
+        results.push(amountCriteria);
+    }
+    payload.conditions
+        .filter((condition) => condition.field === 'vendor_id')
+        .forEach((condition) => {
+        const vendor = toVendorCriteria(condition);
+        if (vendor != null) {
+            results.push(vendor);
+        }
+    });
+    payload.conditions
+        // Backend wire name is 'accounting_class_id' — kept in sync with
+        // the write-side mapper in 'commonPayload.ts'. State-side and
+        // form-side keep 'department' / 'departmentIds' to match product
+        // copy.
+        .filter((condition) => condition.field === 'accounting_class_id')
+        .forEach((condition) => {
+        const department = toDepartmentCriteria(condition);
+        if (department != null) {
+            results.push(department);
+        }
+    });
+    return results;
+};
+const legacyAmountRangeToCriteria = (legacy) => {
+    if (legacy.length === 0) {
+        return [];
+    }
+    // The state-side 'Criteria[]' model allows at most one
+    // 'AmountCriteria' per rule (see 'approvalRuleState.ts'). The legacy
+    // wire was an array, so a multi-entry payload can't be represented
+    // here without losing data. Read the first entry and log a warning
+    // if production rules ever ship more — that would signal a backend
+    // regression we want to catch early rather than silently truncating.
+    if (legacy.length > 1) {
+        console.warn('[approvalRulePayload] legacyAmountRangeToCriteria: received ' +
+            legacy.length +
+            ' entries but the state model only supports one; using the ' +
+            'first entry and dropping the rest.');
+    }
+    const first = legacy[0] ?? {};
+    const currency = first.currency_code ?? 'USD';
+    const symbol = first.currency_symbol ?? '$';
+    const min = typeof first.min === 'number'
+        ? (0, amount_1.toAmount)(first.min, currency, symbol)
+        : undefined;
+    const max = typeof first.max === 'number'
+        ? (0, amount_1.toAmount)(first.max, currency, symbol)
+        : undefined;
+    if (min == null && max == null) {
+        return [];
+    }
+    const comparator = min != null && max != null
+        ? 'range'
+        : min != null
+            ? 'greater_than'
+            : 'less_than';
+    return [{ type: 'amount', comparator, min, max }];
+};
+const toAmountCriteria = (payload) => {
+    if (!Array.isArray(payload.conditions)) {
+        return undefined;
+    }
+    const amountConditions = payload.conditions.filter((condition) => condition.field === 'amount');
+    // Approval Rules 3.0 — an 'eq' condition represents min === max. Fold
+    // it into both finders so it decodes as comparator: 'range' (closed
+    // single-point) rather than 'greater_than' (open upper).
+    const gteCondition = amountConditions.find((condition) => condition.type === 'gte' || condition.type === 'eq');
+    const lteCondition = amountConditions.find((condition) => condition.type === 'lte' || condition.type === 'eq');
+    if (gteCondition == null && lteCondition == null) {
+        return undefined;
+    }
+    const currencyCode = payload.currency_code ?? 'USD';
+    const currencySymbol = payload.currency_symbol ?? '$';
+    const min = typeof gteCondition?.value === 'number'
+        ? (0, amount_1.toAmount)(gteCondition.value, currencyCode, currencySymbol)
+        : undefined;
+    const max = typeof lteCondition?.value === 'number'
+        ? (0, amount_1.toAmount)(lteCondition.value, currencyCode, currencySymbol)
+        : undefined;
+    let comparator;
+    if (min != null && max != null) {
+        comparator = 'range';
+    }
+    else if (min != null) {
+        comparator = 'greater_than';
+    }
+    else {
+        comparator = 'less_than';
+    }
+    return { type: 'amount', comparator, min, max };
+};
+const toVendorCriteria = (condition) => {
+    if (!Array.isArray(condition.value)) {
+        return undefined;
+    }
+    return {
+        type: 'vendor',
+        operator: condition.type === 'not_in' ? 'is_not' : 'is',
+        vendorIds: condition.value,
+    };
+};
+const toDepartmentCriteria = (condition) => {
+    if (!Array.isArray(condition.value)) {
+        return undefined;
+    }
+    return {
+        type: 'department',
+        operator: condition.type === 'not_in' ? 'is_not' : 'is',
+        departmentIds: condition.value,
+    };
+};
+const toApprovalSteps = (payload) => {
+    return payload.map((step) => ({
+        action: (0, approvalRuleState_1.toApprovalActionType)(step.action),
+        operator: (0, approvalRuleState_1.toStepOperatorType)(step.operator),
+        actors: step.actors.map((actor) => ({
+            type: (0, approvalRuleState_1.toActorType)(actor.type),
+            subType: (0, approvalRuleState_1.toAttributeOrRoleTypeStrict)(actor.sub_type ?? null),
+            userId: actor.id ?? undefined,
+            idType: actor.id_type ?? undefined,
+            isImplicitActor: actor.is_implicit_actor ?? false,
+        })),
+    }));
+};

package/lib/entity/approvalRule/approvalRuleReducer.d.ts

@@ -0,0 +1,6 @@
+import { ApprovalRulePayload } from './approvalRulePayload';
+import { ApprovalRuleState } from './approvalRuleState';
+export declare const initialState: ApprovalRuleState;
+export declare const updateApprovalRules: import("@reduxjs/toolkit").ActionCreatorWithPayload<ApprovalRulePayload[], "approvalRule/updateApprovalRules">, removeApprovalRule: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "approvalRule/removeApprovalRule">, clearAllApprovalRules: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"approvalRule/clearAllApprovalRules">;
+declare const _default: import("redux").Reducer<ApprovalRuleState>;
+export default _default;

package/lib/entity/approvalRule/approvalRuleReducer.js

@@ -0,0 +1,28 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearAllApprovalRules = exports.removeApprovalRule = exports.updateApprovalRules = exports.initialState = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+const approvalRulePayload_1 = require("./approvalRulePayload");
+exports.initialState = {
+    approvalRuleById: {},
+};
+const approvalRule = (0, toolkit_1.createSlice)({
+    name: 'approvalRule',
+    initialState: exports.initialState,
+    reducers: {
+        updateApprovalRules(draft, action) {
+            const approvalRulePayload = action.payload;
+            approvalRulePayload.forEach((approvalRule) => (draft.approvalRuleById[approvalRule.approval_rule_id] =
+                (0, approvalRulePayload_1.toApprovalRule)(approvalRule)));
+        },
+        removeApprovalRule(draft, action) {
+            delete draft.approvalRuleById[action.payload];
+        },
+        clearAllApprovalRules(draft) {
+            draft.approvalRuleById = {};
+        },
+    },
+});
+_a = approvalRule.actions, exports.updateApprovalRules = _a.updateApprovalRules, exports.removeApprovalRule = _a.removeApprovalRule, exports.clearAllApprovalRules = _a.clearAllApprovalRules;
+exports.default = approvalRule.reducer;