@zeitvu97/cms-sdk 0.1.0

package/dist/services/rules/rules.type.d.ts

@@ -0,0 +1,262 @@
+import { SerializationFormat } from '../../common/constants/http.constant';
+import { TriggerTypeValue } from './triggers';
+export type TriggerType = TriggerTypeValue;
+/**
+ * Wire-level `trigger_type` union (schema-validated by
+ * `eaera_cms/core/rules/definitions.py:33-39`).
+ *
+ * Note this is **different** from the `source_type` value the engine matcher
+ * reads (`event_dto | cron | batch | stream | signal`). The canonical
+ * pair for event rules is `trigger_type: "event"` +
+ * `source_type: "event_dto"` — see `packs/registry.py:463-470` and the
+ * SDK `TRIGGER_TYPE` / `TRIGGER_MODE` constants in `triggers.ts`.
+ *
+ * Aliased to `TriggerType` via the `index.ts` barrel for backwards
+ * compatibility with consumers that imported it from this module.
+ */
+/**
+ * One row in `trigger.conditions[]` — the flat AND list the engine evaluates
+ * when `conditionType` is `'trigger_conds'` or omitted. The dashboard's visual
+ * tree builder (`LogicTree.vue`) emits these; backend-authored packs (`*.yaml`)
+ * emit them too. `field` is either a CH catalog key (`account_state.equity`),
+ * a dotted event-payload path (`deal.profit`), or a flat event field
+ * (`profit` — engine fallback).
+ *
+ * `operator` is one of the word forms exposed by the SDK
+ * (`CONDITION_OPERATORS`: `gt`/`gte`/`lt`/`lte`/`eq`/`ne`/`in`/`not_in`/
+ * `contains`/`startswith`/`endswith`/`is_null`/`is_not_null`) plus the
+ * cron-specific `sum_within_days` (carries a numeric `days` window).
+ *
+ * `value` shape depends on the operator — see
+ * `cms-sdk/src/services/rules/conditions.ts:CONDITION_OPERATOR_VALUE_KINDS`:
+ *   - numeric operators → number
+ *   - `in` / `not_in`   → array of primitives
+ *   - string operators  → string (entity is coerced via `str()`)
+ *   - `is_null` / `is_not_null` → ignored (send `null`)
+ *   - `sum_within_days` → number (threshold), `days` is the window
+ */
+export interface TriggerConditionRow {
+    field: string;
+    operator: string;
+    value: unknown;
+    /** Cron-only: window size for `sum_within_days`. */
+    days?: number;
+}
+export interface TriggerDefinition {
+    /**
+     * The backend SQL filter (`trigger_api.py:fire_signal`) and engine matcher
+     * (`engine.py:_match_trigger`) read `trigger.source_type`, NOT
+     * `trigger.trigger_type`. Builders in `triggers.ts` emit BOTH
+     * `sourceType` and `triggerType` (camelCase) so the CMS casing middleware
+     * produces both keys in the stored JSONB.
+     *
+     * IMPORTANT: for event rules the two values DIVERGE — see the canonical
+     * contract documented on `TRIGGER_MODE` / `TRIGGER_TYPE` in
+     * `cms-sdk/src/services/rules/triggers.ts`. `sourceType: 'event_dto'`
+     * (engine matcher), `triggerType: 'event'` (schema validator). Earlier
+     * SDK builds emitted both as `'event_dto'`, which drifted from the
+     * pack-authored contract.
+     */
+    sourceType?: 'event_dto' | 'cron' | 'batch' | 'stream' | 'signal';
+    triggerType: TriggerType;
+    topic?: string;
+    /**
+     * Top-level AND condition list. Backend reads this when
+     * `conditionType` is `'trigger_conds'` (or omitted). Dashboard tree
+     * builder emits here; the Fixed Rules editor's `trigger_conds` path
+     * goes through here too.
+     */
+    conditions?: TriggerConditionRow[];
+    /**
+     * Type-specific trigger config ONLY — e.g. `signalName`, `topic`, `schedule`,
+     * `timezone`, `streamName`, `windowSeconds`, `contentTypes`, `eventTypes`,
+     * `promptName` (LLM rules), `queryTools` (LLM rules).
+     *
+     * There is **no `scope` concept** on a rule. A rule is scoped by `contentType`
+     * + trigger-source matching + the `conditionExpr`; do not write a `scope`
+     * (`groups`/`symbols`/`logins`/`emails`) key here — the backend ignores it.
+     */
+    sourceConfig: Record<string, unknown>;
+}
+/** Value-level constants for ConditionType — single source of truth. */
+export declare const CONDITION_TYPE: {
+    readonly EXPRESSION: "expression";
+    readonly CODE: "code";
+    readonly LLM_AGENT: "llm_agent";
+    readonly TRIGGER_CONDS: "trigger_conds";
+};
+/** Condition type — derived from {@link CONDITION_TYPE}. */
+export type ConditionType = (typeof CONDITION_TYPE)[keyof typeof CONDITION_TYPE];
+/** Value-level constants for ExecutionType — single source of truth. */
+export declare const EXECUTION_TYPE: {
+    readonly ACTION: "action";
+    readonly SET_FIELD: "set_field";
+    readonly NOTIFY: "notify";
+    readonly TRANSITION: "transition";
+    readonly HTTP_CALL: "http_call";
+    readonly CHAIN: "chain";
+};
+/** Execution type — derived from {@link EXECUTION_TYPE}. */
+export type ExecutionType = (typeof EXECUTION_TYPE)[keyof typeof EXECUTION_TYPE];
+/**
+ * One action invocation. The dispatcher reads `actionName` and a **nested**
+ * `params`; e.g. a group move is `{ actionName: 'change_group', params: { newGroup } }`
+ * and a leverage change is `{ actionName: 'change_leverage', params: { newLeverage } }`.
+ */
+export interface ActionExecutionParams {
+    actionName: string;
+    /** Action-specific payload (`{ newGroup }` / `{ newLeverage }`). */
+    params: Record<string, unknown>;
+}
+/**
+ * One step in an ordered action chain. Each step dispatches via its own
+ * `type` (any `ExecutionType` except `chain`); an `action` step uses
+ * {@link ActionExecutionParams} as its `params`.
+ */
+export interface ChainStep {
+    type: Exclude<ExecutionType, typeof EXECUTION_TYPE.CHAIN>;
+    params: Record<string, unknown>;
+}
+/**
+ * Flat execution params stored on `ContentRule.executionParams`. The backend
+ * dispatcher (`dispatch_target`) selects behaviour by `executionType`:
+ *
+ * - `action`    → `{ actionName, params }`
+ * - `set_field` → `{ field, value }`
+ * - `notify`    → `{ data?, notificationType?, recipient? }`
+ * - `transition`→ `{ transitionName, params }`
+ * - `http_call` → `{ url, method?, params?, headers?, timeout? }`
+ * - `chain`     → `{ steps: ChainStep[], stepParams?: Record<string, Record<string, unknown>> }`
+ *
+ * Action parameters are **nested** under `params` — `{ actionName, newGroup }`
+ * (flat) is silently dropped. See {@link ActionExecutionParams}.
+ */
+export interface ExecutionParams {
+    actionName?: string;
+    params?: Record<string, unknown>;
+    field?: string;
+    value?: unknown;
+    data?: Record<string, unknown>;
+    notificationType?: string;
+    recipient?: string;
+    transitionName?: string;
+    url?: string;
+    method?: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+    steps?: ChainStep[];
+    stepParams?: Record<string, Record<string, unknown>>;
+    [key: string]: unknown;
+}
+/** POST /api/v1/rules body (flat — matches `create_trigger()`). */
+export interface RuleCreatePayload {
+    name: string;
+    description?: string;
+    /** `null`/omitted = global rule. Backend reads `contentType`, not `typeName`. */
+    contentType?: string | null;
+    trigger: TriggerDefinition;
+    /** Default `'expression'`. */
+    conditionType?: ConditionType;
+    /** Inline Python expression (conditionType=expression). */
+    conditionExpr?: string | null;
+    /** Full Python code block (conditionType=code). */
+    conditionCode?: string | null;
+    /** Default `'action'`. */
+    executionType?: ExecutionType;
+    executionParams?: ExecutionParams | null;
+    cronSchedule?: string | null;
+    cronTimeZone?: string | null;
+    /** Default `0`. */
+    priority?: number;
+    /** Default `true`. */
+    isActive?: boolean;
+    /** 1-3600, default 30. */
+    timeoutSeconds?: number;
+}
+/** PUT /api/v1/rules/{uuid} body (all optional, same flat keys). */
+export interface RuleUpdatePayload {
+    name?: string;
+    description?: string;
+    contentType?: string | null;
+    trigger?: TriggerDefinition;
+    conditionType?: ConditionType;
+    conditionExpr?: string | null;
+    conditionCode?: string | null;
+    executionType?: ExecutionType;
+    executionParams?: ExecutionParams | null;
+    priority?: number;
+    isActive?: boolean;
+    timeoutSeconds?: number;
+}
+/** GET /api/v1/rules, GET /api/v1/rules/{uuid} (`ContentRuleResponse`). */
+export interface ContentRule {
+    id: number;
+    uuid: string;
+    name: string;
+    description?: string | null;
+    /** Echoes `contentType` on the response. */
+    typeName?: string | null;
+    /** Default `'python'`. */
+    codeType: string;
+    /** AES-256-GCM encrypted. */
+    conditionCode?: string | null;
+    conditionType?: ConditionType;
+    conditionExpr?: string | null;
+    /** Inline trigger JSONB (`{ sourceType, sourceConfig, conditions, settings }`). */
+    trigger: Record<string, unknown>;
+    executionType: ExecutionType;
+    executionParams?: Record<string, unknown> | null;
+    priority: number;
+    isActive: boolean;
+    timeoutSeconds: number;
+    /** Cron: top-level normalized schedule. Dashboard emits via
+     *  `trigger.sourceConfig.schedule`; the backend reads both. */
+    cronSchedule?: string | null;
+    cronTimezone?: string | null;
+    /** ISO 8601. */
+    nextTriggerAt?: string | null;
+    /** ISO 8601 — FEAT-004 sidebar "last triggered". */
+    lastFiredAt?: string | null;
+    packId?: string | null;
+    createdBy?: number | null;
+    updatedBy?: number | null;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+}
+export interface ContentRuleListResponse {
+    items: ContentRule[];
+    /** `=== items.length` — the list endpoint does NOT paginate. */
+    total: number;
+}
+/**
+ * Signal-fire context (`POST /api/v1/rules/signals/fire`). Carries the target
+ * account + any extra payload the engine/condition evaluator reads. A `null`
+ * `contentUuid` means scan-mode (the LLM discovers candidates itself).
+ */
+export interface SignalFireContext {
+    /** Content type of the target (e.g. `'Mt5Account'`). */
+    typeName?: string;
+    /** Target account UUID, or `null` for scan-mode `llm_agent` rules. */
+    contentUuid?: string | null;
+    /** Extra payload (e.g. `{ serverName, login }`). */
+    data?: Record<string, unknown>;
+}
+/** `POST /api/v1/rules/signals/fire` response. */
+export interface SignalFireResponse {
+    /** Number of rules that matched and were dispatched. */
+    triggeredCount: number;
+    /** UUIDs of the matched rules. */
+    matchedRules: string[];
+}
+/** Query params for GET /api/v1/rules (route-level Query() params; no limit/offset). */
+export interface RuleListQuery {
+    sourceType?: string;
+    executionType?: ExecutionType;
+    /** contentType filter. */
+    typeName?: string;
+    isActive?: boolean;
+    /** UUID or slug (FEAT-008 v1.1). */
+    packId?: string;
+    format?: SerializationFormat;
+}
+//# sourceMappingURL=rules.type.d.ts.map

package/dist/services/rules/rules.type.d.ts.map

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

package/dist/services/rules/triggers.d.ts

@@ -0,0 +1,140 @@
+import { TriggerDefinition, TriggerType } from './rules.type';
+/** Value-level constants for trigger modes (the *builder* view used by the
+ *  dashboard UI). Each entry's string is the *backend* `source_type` value
+ *  read off `ContentRule.trigger` by `engine.py:_match_trigger` and the SQL
+ *  filter at `trigger_api.py:fire_signal`:
+ *
+ *  - `SIGNAL` → `"signal"` (API pod, `POST /api/v1/rules/signals/fire`).
+ *  - `CRON`   → `"cron"`   (cron evaluator pod).
+ *  - `EVENT`  → `"event_dto"` (NOT `"event"` — the engine matcher reads
+ *    `source_type` as `"event_dto"`).
+ *
+ *  Use {@link TRIGGER_TYPE} for the wire-level `trigger_type` value (which
+ *  uses `"event"`, not `"event_dto"`). */
+export declare const TRIGGER_MODE: {
+    readonly SIGNAL: "signal";
+    readonly CRON: "cron";
+    readonly EVENT: "event_dto";
+};
+/** The trigger modes the dashboard builders author — derived from {@link TRIGGER_MODE}. */
+export type TriggerMode = (typeof TRIGGER_MODE)[keyof typeof TRIGGER_MODE];
+/** Value-level constants for the *wire-level* `trigger_type` field (the
+ *  schema-validated field on `TriggerDefinition`,
+ *  `eaera_cms/core/rules/definitions.py:33-39`).
+ *
+ *  For event rules the wire value is `"event"`, NOT `"event_dto"` — the
+ *  latter is the `source_type` value. The two diverge on purpose; the
+ *  pack loader emits `trigger_type: "event"` + `source_type: "event_dto"`
+ *  (`packs/registry.py:463-470`).
+ *
+ *  - `SIGNAL` → `"signal"`
+ *  - `CRON`   → `"cron"`
+ *  - `EVENT`  → `"event"`
+ *  - `STREAM` → `"stream"` (backend-only — no SDK builder). */
+export declare const TRIGGER_TYPE: {
+    readonly SIGNAL: "signal";
+    readonly CRON: "cron";
+    readonly EVENT: "event";
+    readonly STREAM: "stream";
+};
+/** The wire-level `trigger_type` union — derived from {@link TRIGGER_TYPE}. */
+export type TriggerTypeValue = (typeof TRIGGER_TYPE)[keyof typeof TRIGGER_TYPE];
+/** The Kafka `content.events` event types the trigger pod subscribes to.
+ *
+ *  Authoritative list — `eaera-mt5/eaera_mt5/pipeline/event_publisher.py` (the
+ *  four MT5 pipeline publishers) and `eaera-mt5/worker/sync/account_sync.py`
+ *  (`_emit_account_upsert_events`). The CMS schema validator does not whitelist
+ *  the value (any string is accepted), but the engine matcher and the
+ *  `Mt5AccountSyncService` only act on these five. */
+export declare const EVENT_TYPE: {
+    readonly DEAL_CLOSE: "deal_close";
+    readonly STATEMENT: "statement";
+    readonly POSITION: "position";
+    readonly ORDER: "order";
+    /** FEAT-009 identity-provisioning bridge — emitted by the MT5 `account_sync`
+     *  worker whenever an account is upserted. The trigger service ALSO
+     *  auto-upserts an `Mt5Account` content row on `(server_name, login)` via
+     *  `Mt5AccountSyncService` before evaluating rules. Common use: provision
+     *  a CMS user when the account email is present (the live `user_sync` rule
+     *  uses `event: 'mt5_account_upsert'` + `trigger.conditions: [email contains '@']`). */
+    readonly MT5_ACCOUNT_UPSERT: "mt5_account_upsert";
+};
+/** Event type union — derived from {@link EVENT_TYPE}. */
+export type EventType = (typeof EVENT_TYPE)[keyof typeof EVENT_TYPE];
+/** A labelled option for the event-payload picker. */
+export interface EventTypeOption {
+    label: string;
+    value: EventType;
+    /** Short human hint shown in tooltips / Data Set reference. */
+    hint?: string;
+}
+/** Human labels for the {@link EVENT_TYPE} options. */
+export declare const EVENT_TYPE_OPTIONS: readonly EventTypeOption[];
+/** Helper: true iff the given string is a known event type. */
+export declare const isKnownEventType: (raw: unknown) => raw is EventType;
+/** Coerce an arbitrary event-type string (e.g. from a stored `sourceConfig.event`)
+ *  to a known {@link EventType}. Falls back to {@link EVENT_TYPE.DEAL_CLOSE} for
+ *  unknown / missing values so the rule editor always has a valid pick. */
+export declare const coerceEventType: (raw: unknown) => EventType;
+/** A labelled cron preset for the schedule picker. */
+export interface CronPreset {
+    label: string;
+    value: string;
+}
+/** Human cron presets (standard 5-field expressions). */
+export declare const CRON_PRESETS: readonly CronPreset[];
+/** Default cron schedule when none is provided (skills' historical default). */
+export declare const DEFAULT_CRON_SCHEDULE = "*/5 * * * *";
+/** Default Kafka topic for event triggers. Sourced from `CONTENT_TYPE.MT5_ACCOUNT`. */
+export declare const DEFAULT_EVENT_CONTENT_TYPE: "Mt5Account";
+/** Build a signal trigger over the metric stream.
+ *
+ *  Emits the canonical pair:
+ *  - `triggerType: 'signal'` (schema-validated)
+ *  - `sourceType: 'signal'` (engine matcher)
+ *
+ *  Both are the same value for signal rules. */
+export declare const buildSignalTrigger: (signalName: string) => TriggerDefinition;
+/**
+ * Build a cron trigger. `schedule` is a standard 5-field cron expression;
+ * `extra` is merged into `sourceConfig` (e.g. skills pass `promptName` /
+ * `queryTools`).
+ *
+ *  Emits the canonical pair:
+ *  - `triggerType: 'cron'` (schema-validated)
+ *  - `sourceType: 'cron'` (engine matcher)
+ */
+export declare const buildCronTrigger: (schedule: string, extra?: Record<string, unknown>, timezone?: string) => TriggerDefinition;
+/**
+ * Build an event trigger on the Kafka `content.events` topic.
+ *
+ *  Emits the canonical pair — NOT the same value on both fields:
+ *  - `triggerType: 'event'` (schema-validated, `definitions.py:36`)
+ *  - `sourceType: 'event_dto'` (engine matcher, `engine.py:369`)
+ *
+ *  Earlier SDK builds emitted both as `"event_dto"`, which passed engine
+ *  matching but drifted from the canonical pack-authored contract
+ *  (`packs/registry.py:463-470`). This builder now emits the correct pair.
+ *
+ *  The `event` (singular) and `eventTypes`/`contentTypes` (plural) shapes
+ *  are both stored so the engine reads either form.
+ */
+export declare const buildEventTrigger: (event: EventType, contentType?: string, extra?: Record<string, unknown>) => TriggerDefinition;
+/** Derive the builder trigger mode from a stored `ContentRule.trigger`.
+ *
+ *  Accepts BOTH the camelCase fields the SDK writes (`sourceType`,
+ *  `triggerType`) and the snake_case JSONB keys the backend reads
+ *  (`source_type`, `trigger_type`) so rules authored before the trigger
+ *  wire-shape fix still load in the Fixed Rules editor without showing up
+ *  as the wrong mode.
+ *
+ *  Both `source_type === "event_dto"` (engine matcher) and `trigger_type
+ *  === "event"` (schema-validated) map to the builder's `EVENT` mode. */
+export declare const triggerModeOf: (trigger: TriggerDefinition | Record<string, unknown> | null | undefined) => TriggerMode;
+/** Read the cron `schedule` out of a stored `ContentRule.trigger`. */
+export declare const scheduleOf: (trigger: TriggerDefinition | Record<string, unknown> | null | undefined) => string;
+/** Read the signal `signalName` out of a stored `ContentRule.trigger`. */
+export declare const signalNameOf: (trigger: TriggerDefinition | Record<string, unknown> | null | undefined) => string;
+export type { TriggerType };
+export { TRIGGER_TYPE as TRIGGER_TYPE_VALUE };
+//# sourceMappingURL=triggers.d.ts.map

package/dist/services/rules/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../../src/services/rules/triggers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEnE;;;;;;;;;;;0CAW0C;AAC1C,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX,2FAA2F;AAC3F,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE3E;;;;;;;;;;;;+DAY+D;AAC/D,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX,+EAA+E;AAC/E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAEhF;;;;;;sDAMsD;AACtD,eAAO,MAAM,UAAU;;;;;IAKrB;;;;;4FAKwF;;CAEhF,CAAC;AAEX,0DAA0D;AAC1D,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAErE,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,EAAE,SAAS,eAAe,EAUxD,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB,GAAI,KAAK,OAAO,KAAG,GAAG,IAAI,SAGtD,CAAC;AAEF;;2EAE2E;AAC3E,eAAO,MAAM,eAAe,GAAI,KAAK,OAAO,KAAG,SACM,CAAC;AAEtD,sDAAsD;AACtD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yDAAyD;AACzD,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAO7C,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAEnD,uFAAuF;AACvF,eAAO,MAAM,0BAA0B,EAAG,YAAqB,CAAC;AAEhE;;;;;;gDAMgD;AAChD,eAAO,MAAM,kBAAkB,GAAI,YAAY,MAAM,KAAG,iBAItD,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,QAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACnC,WAAW,MAAM,KAChB,iBAID,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,SAAS,EAChB,cAAa,MAAmC,EAChD,QAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,KAClC,iBASD,CAAC;AAEH;;;;;;;;;yEASyE;AACzE,eAAO,MAAM,aAAa,GACxB,SAAS,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,KACtE,WAoBF,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,UAAU,GACrB,SAAS,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,KACtE,MAKF,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,YAAY,GACvB,SAAS,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,KACtE,MAKF,CAAC;AAEF,YAAY,EAAE,WAAW,EAAE,CAAC;AAC5B,OAAO,EAAE,YAAY,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/services/settings/index.d.ts

@@ -0,0 +1,36 @@
+import { $Fetch } from 'ofetch';
+import { IPublicMarketsData } from './settings.type';
+export interface ISettingsServiceOptions {
+    /** The CMS `$Fetch` instance (one of `sdk.apis`). */
+    api: $Fetch;
+    /** Lazy flag — when true, the service returns fake data. */
+    mock: () => boolean;
+}
+export interface ISettingsService {
+    getMonitoredGroups(): Promise<string[]>;
+    setMonitoredGroups(groups: string[]): Promise<string[]>;
+    /**
+     * Anonymous UI defaults from `setting.public.markets` (api-inventory §5.7.5):
+     * the default MT5 server id + the curated common-symbol list (order is
+     * significant). Readable without a JWT — the backend returns the schema
+     * defaults when no record has been written yet.
+     */
+    getPublicMarkets(): Promise<IPublicMarketsData>;
+}
+/**
+ * Settings service. The CMS is the source of truth for monitored groups;
+ * the service reads/writes the generic setting
+ * `setting.dashboard.monitored_groups`.
+ *
+ * Endpoint contract (`eaera_cms/settings/routes.py`):
+ *   GET /api/v1/settings/{typeName} → { typeName, displayName, data, exists }
+ *   PUT /api/v1/settings/{typeName} → { ..., data }  (body = key/value pairs)
+ *
+ * NOTE: the CT `setting.dashboard.monitored_groups` (schema `{ groups: string[] }`)
+ * must be registered in the CMS settings catalog for these calls to succeed.
+ *
+ * While `mock()` returns true, all methods resolve against the local fake
+ * dataset and never touch `api`.
+ */
+export declare function createSettingsService(opts: ISettingsServiceOptions): ISettingsService;
+//# sourceMappingURL=index.d.ts.map

package/dist/services/settings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/settings/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAOrC,OAAO,KAAK,EAGV,kBAAkB,EAEnB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,IAAI,EAAE,MAAM,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD;;;;;OAKG;IACH,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACjD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,uBAAuB,GAAG,gBAAgB,CA+BrF"}

package/dist/services/settings/mock.d.ts

@@ -0,0 +1,14 @@
+/** Fake monitored-groups set used while the settings endpoint is under development. */
+export declare const MOCK_MONITORED_GROUPS: string[];
+export declare function mockGetMonitoredGroups(): string[];
+export declare function mockSetMonitoredGroups(groups: string[]): string[];
+/** Fake public-markets payload (mirrors the schema defaults in api-inventory §5.7.5). */
+export declare const MOCK_PUBLIC_MARKETS: {
+    readonly defaultServer: "live";
+    readonly commonSymbols: readonly ["EURUSD", "GBPUSD", "USDJPY", "XAUUSD", "XAGUSD", "BTCUSD", "ETHUSD"];
+};
+export declare function mockGetPublicMarkets(): {
+    defaultServer: string;
+    commonSymbols: string[];
+};
+//# sourceMappingURL=mock.d.ts.map

package/dist/services/settings/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/services/settings/mock.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,eAAO,MAAM,qBAAqB,EAAE,MAAM,EAIzC,CAAC;AAKF,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAEjD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAGjE;AAED,yFAAyF;AACzF,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAEX,wBAAgB,oBAAoB,IAAI;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAKA"}

package/dist/services/settings/settings.type.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Dashboard settings types. v1 covers only monitored groups (FEAT-006),
+ * persisted as a generic CMS setting of type `setting.dashboard.monitored_groups`.
+ *
+ * All field names use camelCase to match the backend API response.
+ */
+/** Generic setting response envelope (`GET/PUT /api/v1/settings/{typeName}`). */
+export interface ISettingResponse<T = Record<string, unknown>> {
+    typeName: string;
+    displayName?: string;
+    data: T;
+    /** `false` when the CT exists but no record has been written yet. */
+    exists: boolean;
+}
+/** Monitored-groups setting data. */
+export interface IMonitoredGroupsData {
+    groups: string[];
+}
+/** Convenience alias for the monitored-groups setting envelope. */
+export type IMonitoredGroupsResponse = ISettingResponse<IMonitoredGroupsData>;
+/** Payload for PUT /api/v1/settings/{typeName} (key/value pairs). */
+export interface IMonitoredGroupsPayload {
+    groups: string[];
+}
+/**
+ * Public-markets setting data (api-inventory §5.7.5) — anonymous UI defaults.
+ */
+export interface IPublicMarketsData {
+    /** MT5 server id for anonymous symbol / chart / WS requests (e.g. `'live'`). */
+    defaultServer: string;
+    /**
+     * Curated symbol names for the anonymous markets strip. Order is
+     * significant (display order = array order).
+     */
+    commonSymbols: string[];
+}
+/** Convenience alias for the public-markets setting envelope. */
+export type IPublicMarketsResponse = ISettingResponse<IPublicMarketsData>;
+//# sourceMappingURL=settings.type.d.ts.map

package/dist/services/settings/settings.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.type.d.ts","sourceRoot":"","sources":["../../../src/services/settings/settings.type.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iFAAiF;AACjF,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC;IACR,qEAAqE;IACrE,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,qCAAqC;AACrC,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,mEAAmE;AACnE,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,CAAC,oBAAoB,CAAC,CAAC;AAE9E,qEAAqE;AACrE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,iEAAiE;AACjE,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,CAAC"}