@eaera-com/cms-sdk 0.1.61

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

@@ -0,0 +1,43 @@
+import { $Fetch } from 'ofetch';
+import { IPortalAccess } from './authz.type';
+export type { IPortalAccess } from './authz.type';
+export interface IAuthzServiceOptions {
+    /** The CMS `$Fetch` instance (one of `sdk.apis`). */
+    api: $Fetch;
+    /**
+     * Optional `$Fetch` pointed at the app-origin `/api/cms` proxy (Nuxt
+     * module). When set, the portal-access check routes through
+     * `/api/cms/portal-access` so the httpOnly token cookie is forwarded
+     * server-side and the raw token never reaches the client. When omitted,
+     * the backend is called directly via `api` (Bearer attached by the
+     * transport's TokenManager).
+     */
+    routeApi?: $Fetch;
+    /** Lazy flag — when true, the service returns fake data. */
+    mock: () => boolean;
+    /** Default portal id (Nuxt module option `cmsSdk.portal`). Per-call override wins. */
+    portal?: () => string | undefined;
+}
+export interface IAuthzService {
+    /**
+     * Resolve the caller's access to a portal
+     * (`GET /api/v1/authz/me/portals/{portal}`).
+     *
+     * Throws on the documented error statuses so callers can branch:
+     *   401 `UNAUTHENTICATED` / `INVALID_TOKEN_AUDIENCE`,
+     *   403 `PORTAL_ACCESS_DENIED` (codes survive in the error payload's
+     *   `data` via the proxy's `authBackendError` / `extractAuthError`).
+     */
+    portalAccess(portal?: string): Promise<IPortalAccess>;
+}
+/**
+ * Authz domain service. Mirrors the engine RBAC surface used by every
+ * portal: "am I allowed into THIS portal, and with which permissions/roles".
+ *
+ * The result is cheap to refetch and MUST be re-resolved on login and on
+ * session restore (page refresh) — caching across sessions is deliberately
+ * left to the consumer (see `useAuthzStore` for the canonical fetch-once
+ * cache with login/logout invalidation).
+ */
+export declare function createAuthzService(opts: IAuthzServiceOptions): IAuthzService;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/authz/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,OAAO,CAAC;IACpB,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B;;;;;;;;OAQG;IACH,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,oBAAoB,GAAG,aAAa,CA6B5E"}

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

@@ -0,0 +1,78 @@
+import { MT5_INTERVAL, MT5Interval } from '../../common/constants/mt5.constant';
+/** Single source-interval value (always M1; doc §5.5.2). */
+type M1Only = typeof MT5_INTERVAL.M1;
+/**
+ * Chart-bars query — mirrors BE `GET /api/v1/chart/bars` (doc §5.5.1).
+ * All fields use camelCase; the service forwards them verbatim to the backend.
+ */
+export interface BarsQuery {
+    symbol: string;
+    /**
+     * Accepts FE-style ('1m','5m','15m','30m','1h','4h','1d','1w','1M')
+     * OR MT5-style ('M1'…'MN1'). Passed through verbatim; the backend maps
+     * both to the same bucket width.
+     */
+    interval: MT5Interval | ChartIntervalFe | (string & {});
+    /** ISO-8601, inclusive lower bound. */
+    fromTime: string;
+    /** ISO-8601, exclusive upper bound, strictly > fromTime. */
+    toTime: string;
+    /** MT5 server filter. Defaults to MT5_SERVER_NAME when omitted. */
+    serverName?: string;
+    /** 1..5000, applied AFTER aggregation. Default 1000. */
+    limit?: number;
+    /** 'asc' (oldest first, default) | 'desc' (newest first). */
+    sortDirection?: BarsSortDirection;
+}
+export type BarsSortDirection = 'asc' | 'desc';
+/** Aggregation-source label for a derived bar (doc §5.5.2). Distinct from
+ *  MT5ChartBarSource (raw Mt5ChartBar.data.source, doc §4.6). */
+export type BarsItemSource = 'aggregated' | 'live' | 'backfill';
+export interface BarItem {
+    symbol: string;
+    /** Canonical MT5-style bucket width. */
+    interval: MT5Interval;
+    /** ISO-8601 UTC; bucket-start for aggregated bars. */
+    mt5Ts: string;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    tickVolume: number | null;
+    volume: number | null;
+    spread: number | null;
+    source: BarsItemSource | null;
+}
+export interface BarsResponse {
+    items: BarItem[];
+    symbol: string;
+    /** Canonical label returned by the backend. */
+    interval: MT5Interval;
+    /** ISO-8601 UTC (= parsed fromTime). */
+    fromTime: string;
+    /** ISO-8601 UTC (= parsed toTime). */
+    toTime: string;
+    /** Always 'M1' — the only persisted interval. */
+    sourceInterval: M1Only;
+    /** items.length. */
+    count: number;
+    /** true iff interval !== 'M1' and bucketing occurred. */
+    aggregated: boolean;
+}
+/** FE-style timeframe labels accepted by GET /api/v1/chart/bars (doc §5.5.1). */
+export declare const CHART_INTERVAL: {
+    readonly M1: "1m";
+    readonly M5: "5m";
+    readonly M15: "15m";
+    readonly M30: "30m";
+    readonly H1: "1h";
+    readonly H4: "4h";
+    readonly D1: "1d";
+    readonly W1: "1w";
+    readonly MN1: "1M";
+};
+export type ChartIntervalFe = (typeof CHART_INTERVAL)[keyof typeof CHART_INTERVAL];
+/** Map either dialect to the canonical MT5 label. */
+export declare function normalizeChartInterval(input: MT5Interval | ChartIntervalFe | string): MT5Interval;
+export {};
+//# sourceMappingURL=bars.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bars.type.d.ts","sourceRoot":"","sources":["../../../src/services/bars/bars.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAErF,4DAA4D;AAC5D,KAAK,MAAM,GAAG,OAAO,YAAY,CAAC,EAAE,CAAC;AAErC;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,QAAQ,EAAE,WAAW,GAAG,eAAe,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACxD,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,aAAa,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,MAAM,CAAC;AAE/C;iEACiE;AACjE,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC;AAEhE,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,QAAQ,EAAE,WAAW,CAAC;IACtB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,QAAQ,EAAE,WAAW,CAAC;IACtB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,iFAAiF;AACjF,eAAO,MAAM,cAAc;;;;;;;;;;CAUjB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAenF,qDAAqD;AACrD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe,GAAG,MAAM,GAAG,WAAW,CAGjG"}

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

@@ -0,0 +1,24 @@
+import { $Fetch } from 'ofetch';
+import { BarsQuery, BarsResponse } from './bars.type';
+export interface IBarsServiceOptions {
+    /** The CMS `$Fetch` instance (one of `sdk.apis`). */
+    api: $Fetch;
+    /** Lazy flag — when true, the service returns fake data. */
+    mock: () => boolean;
+}
+export interface IBarsService {
+    getBars(query: BarsQuery): Promise<BarsResponse>;
+}
+/**
+ * Chart-bars service (read-only). Wraps `GET /api/v1/chart/bars` — the
+ * canonical OHLC read path for chart rendering of any timeframe. Storage
+ * is always M1; larger timeframes are derived on demand via bucket-and-reduce.
+ *
+ * Endpoint contract (`eaera_cms/chart/routes.py`, doc §5.5):
+ *   GET /api/v1/chart/bars → BarsResponse
+ *
+ * While `mock()` returns true, all methods resolve against the local fake
+ * dataset and never touch `api`.
+ */
+export declare function createBarsService(opts: IBarsServiceOptions): IBarsService;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/bars/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIrC,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,IAAI,EAAE,MAAM,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAClD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,GAAG,YAAY,CAmCzE"}

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

@@ -0,0 +1,23 @@
+import { BarItem, BarsResponse } from './bars.type';
+/**
+ * Fake OHLC bars for EURUSD spanning both M1 and H1 buckets.
+ * Includes rows with null fields to exercise nullability.
+ */
+export declare const MOCK_BARS: BarItem[];
+interface MockBarsParams {
+    symbol: string;
+    interval: string;
+    fromTime?: string;
+    toTime?: string;
+    serverName?: string;
+    limit?: number;
+    sortDirection?: 'asc' | 'desc';
+}
+/**
+ * Build a fake BarsResponse matching the requested interval.
+ * Filters MOCK_BARS by interval, echoes symbol/interval, sets
+ * sourceInterval='M1', aggregated=(interval!=='M1'), count=items.length.
+ */
+export declare function mockBars(params: MockBarsParams): BarsResponse;
+export {};
+//# sourceMappingURL=mock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/services/bars/mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIzD;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,OAAO,EAqD9B,CAAC;AAEF,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAiB7D"}