@dx-do/client 5.2.49 → 6.0.1

package/dist/src/lib/services/datastore/datastore-states.service.d.ts

@@ -0,0 +1,63 @@
+import { DxSaasService } from '../dx-saas.service';
+import type { VertexStateFetchRequest, VertexStateFetchResponse, VertexStateRangeRequest, VertexStateRangeResponse, VertexStateRepublishRequest, VertexStateStoreRequest, VertexStateStoreResponse } from '../../model/datastore/states';
+import { Logging } from '@dx-do/util';
+import SimpleLog = Logging.SimpleLog;
+/**
+ * Service for the DX SaaS DataStore States store
+ * (`/states/state/...`).
+ *
+ * The states store manages alert/metric states for vertices in the
+ * Topological Attribute Store (TAS). Each state is keyed by
+ * `(vertexId, alertId, metricId)`.
+ *
+ * Requests are validated against their respective schemas; responses are
+ * validated against their response schemas. Validation failures on the
+ * response side are logged as warnings, not thrown.
+ *
+ * @example
+ * ```ts
+ * const service = new DataStoreStatesService(dxSaasService, log);
+ * const page = await service.fetchStates({ filter: { op: 'ALL' } });
+ * // page.states — matching vertex states
+ * // page.version — change-log version, can be passed back for incremental queries
+ * ```
+ */
+export declare class DataStoreStatesService {
+    private readonly dxSaasService;
+    private readonly log;
+    /**
+     * @param dxSaasService - An authenticated {@link DxSaasService} instance
+     *   configured for the target tenant.
+     * @param log - Logger conforming to {@link SimpleLog} from `@dx-do/util`.
+     */
+    constructor(dxSaasService: DxSaasService, log: SimpleLog);
+    /**
+     * POSTs to `/states/state/store` to upsert a batch of vertex states.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    storeStates(request: VertexStateStoreRequest): Promise<VertexStateStoreResponse>;
+    /**
+     * POSTs to `/states/state/fetch` to query vertex states with an optional
+     * filter, projection and incremental change-log version.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    fetchStates(request?: VertexStateFetchRequest): Promise<VertexStateFetchResponse>;
+    /**
+     * POSTs to `/states/state/range` to query vertex states across a time range
+     * with optional clamping/bucketing for viewport rendering.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    fetchStatesRange(request?: VertexStateRangeRequest): Promise<VertexStateRangeResponse>;
+    /**
+     * POSTs to `/states/state/republish` to re-publish vertex state events into
+     * Kafka (`vertex-state-changes` topic) for the matching states. Useful for
+     * recalculating downstream metrics after a Kafka outage.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    republishStates(request?: VertexStateRepublishRequest): Promise<unknown>;
+}
+//# sourceMappingURL=datastore-states.service.d.ts.map

package/dist/src/lib/services/datastore/datastore-states.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datastore-states.service.d.ts","sourceRoot":"","sources":["../../../../../src/lib/services/datastore/datastore-states.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAYnD,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAErC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,sBAAsB;IAO/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPtB;;;;OAIG;gBAEgB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,SAAS;IAGjC;;;;OAIG;IACG,WAAW,CACf,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC;IAgBpC;;;;;OAKG;IACG,WAAW,CACf,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,wBAAwB,CAAC;IAgBpC;;;;;OAKG;IACG,gBAAgB,CACpB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,wBAAwB,CAAC;IAgBpC;;;;;;OAMG;IACG,eAAe,CACnB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,OAAO,CAAC;CAOpB"}

package/dist/src/lib/services/datastore/datastore-tas.service.d.ts

@@ -0,0 +1,112 @@
+import { DxSaasService } from '../dx-saas.service';
+import type { TasQuery, TasGraph } from '../../model/datastore/tas';
+import { Logging } from '@dx-do/util';
+import SimpleLog = Logging.SimpleLog;
+/**
+ * Service for issuing Topological Attribute Store (TAS) graph queries
+ * against the DX SaaS DataStore API (`/tas/graph/query`).
+ *
+ * Requests are validated against {@link TasQuerySchema}; responses are
+ * validated against {@link TasGraphSchema}. Validation failures on the
+ * response side are logged as warnings, not thrown.
+ *
+ * @example
+ * ```ts
+ * const service = new DataStoreTASService(dxSaasService, log);
+ * const graph = await service.executeQuery({
+ *   filter: { op: 'ALL' },
+ *   projection: 'BRIEF',
+ *   limit: 100,
+ * });
+ * // graph.vertices — topology vertices matching the filter
+ * // graph.edges — relationships between vertices
+ * ```
+ */
+export declare class DataStoreTASService {
+    private readonly dxSaasService;
+    private readonly log;
+    /**
+     * @param dxSaasService - An authenticated {@link DxSaasService} instance
+     *   configured for the target tenant (provides gateway host and credentials).
+     * @param log - Logger conforming to {@link SimpleLog} from `@dx-do/util`.
+     *   Must implement `info`, `warn`, `error`, and `debug` methods.
+     */
+    constructor(dxSaasService: DxSaasService, log: SimpleLog);
+    /**
+     * POSTs a TAS graph query to `/tas/graph/query` and returns the resulting
+     * graph (vertices, edges, states).
+     *
+     * @remarks The response is **not** guaranteed to match the schema exactly.
+     *   If response validation fails, a warning is logged but the raw API
+     *   response is still returned (cast to `TasGraph`). Callers should handle
+     *   potentially incomplete or unexpected fields defensively.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    executeQuery(query: TasQuery): Promise<TasGraph>;
+    /**
+     * Returns the distinct set of layer names present in the topology.
+     *
+     * Layer names are derived from the first colon-delimited segment of each
+     * vertex's `externalId` (e.g. `"ATC:BUSINESSTRANSACTION:foo"` → `"ATC"`).
+     * Vertices with a missing or unparseable `externalId` are collected under
+     * the sentinel value `"(unknown)"`.
+     *
+     * Two passes are made to guarantee completeness:
+     * - Pass 1: fetch all vertices and tally prefix-derived layer names.
+     * - Pass 2: `NOT(LAYER(values: <discovered>))` to catch any vertices whose
+     *   server-side layer field doesn't match the prefix parsed in pass 1.
+     *
+     * @returns Sorted array of distinct layer name strings.
+     */
+    getLayers(): Promise<string[]>;
+    /**
+     * Returns a map of layer name → vertex count for every layer present in
+     * the topology.
+     *
+     * Uses the same two-pass strategy as {@link getLayers} to guarantee that
+     * all vertices are accounted for regardless of `externalId` format.
+     *
+     * @returns Record mapping each layer name to its vertex count, sorted by
+     *   layer name.
+     */
+    getLayerCounts(): Promise<Record<string, number>>;
+    /**
+     * Returns the total vertex count in the bound tenant's topology.
+     *
+     * Uses the canonical pre-load shortcut:
+     *
+     * ```json
+     * { "filter": { "op": "EMPTY", "input": {
+     *     "op": "COLLECT_COUNTS", "id": "EVERYTHING",
+     *     "input": { "op": "ALL" } } },
+     *   "limit": 1 }
+     * ```
+     *
+     * `COLLECT_COUNTS` emits an analytic carrying `vertexCount`; the
+     * outer `EMPTY` discards the (huge) vertex set so only the
+     * analytic crosses the wire. Single small round trip — fits the
+     * "is this tenant small enough to load whole?" check before
+     * committing to a full topology fetch.
+     */
+    getEntityCount(): Promise<number>;
+    /**
+     * Returns vertex counts for a set of service names — direct
+     * members only (`excludeSubServices: true`), one count per
+     * service name.
+     *
+     * Strategy: compose every requested service's
+     * `COLLECT_COUNTS(SERVICE([name]))` under a single `OR` so TAS
+     * runs them as one query and emits one analytic per branch. The
+     * outer `EMPTY` drops the unioned vertex set; we only care about
+     * the per-branch analytics. Single round trip even for hundreds
+     * of services. Service-id mapping uses `svc:<index>` so the
+     * analytics map back unambiguously.
+     *
+     * @returns Map keyed by service name (case preserved as passed
+     *   in). Services that produce no analytic (e.g. unknown name on
+     *   this tenant) get `0`.
+     */
+    getServiceEntityCounts(serviceNames: ReadonlyArray<string>): Promise<Map<string, number>>;
+}
+//# sourceMappingURL=datastore-tas.service.d.ts.map

package/dist/src/lib/services/datastore/datastore-tas.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datastore-tas.service.d.ts","sourceRoot":"","sources":["../../../../../src/lib/services/datastore/datastore-tas.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAErC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,mBAAmB;IAQ5B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG;IARtB;;;;;OAKG;gBAEgB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,SAAS;IAGjC;;;;;;;;;;OAUG;IACG,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAgBtD;;;;;;;;;;;;;;OAcG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKpC;;;;;;;;;OASG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAqCvD;;;;;;;;;;;;;;;;;OAiBG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAkBvC;;;;;;;;;;;;;;;;OAgBG;IACG,sBAAsB,CAC1B,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,GAClC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAoChC"}

package/dist/src/lib/services/datastore/datastore-tokens.service.d.ts

@@ -0,0 +1,98 @@
+import { DxSaasService } from '../dx-saas.service';
+import type { CancelRevokeRequest, CreateAgentTokenRequest, CreateInternalTokenRequest, CreateTenantTokenRequest, CreateUserTokenRequest, DeleteTokenRequest, DeleteTokensResponse, ImportTokenRequest, PublicKeyJsonResponse, RevokeTokenRequest, RevokeTokensResponse, SessionValidateRequest, SessionValidateResponse, TokenCreateResponse, TokenDetails, TokenGetAndVerifyRequest, TokenQueryRequest, TokenQueryResponse, TokenVerifyRequest, UpdateAgentTokenRequest, UpdateTenantTokenRequest, UpdateUserTokenRequest } from '../../model/datastore/tokens';
+import { Logging } from '@dx-do/util';
+import SimpleLog = Logging.SimpleLog;
+/**
+ * Service for the DX SaaS DataStore session/token APIs
+ * (`/session/validate` and `/tenants/token/...`).
+ *
+ * Operations are gated by role on the server (MA, GA, TA, PU, UZ, AGENT) —
+ * see `tokens-rest.adoc` for the full permission matrix. The methods here
+ * are thin client wrappers; they do not enforce the role checks themselves.
+ *
+ * @example
+ * ```ts
+ * const service = new DataStoreTokensService(dxSaasService, log);
+ * const session = await service.validateSession();
+ * const newToken = await service.createUserToken({ ttl: 7_200_000 });
+ * ```
+ */
+export declare class DataStoreTokensService {
+    private readonly dxSaasService;
+    private readonly log;
+    /**
+     * @param dxSaasService - An authenticated {@link DxSaasService} instance
+     *   configured for the target tenant.
+     * @param log - Logger conforming to {@link SimpleLog} from `@dx-do/util`.
+     */
+    constructor(dxSaasService: DxSaasService, log: SimpleLog);
+    /**
+     * POSTs to `/session/validate` to validate the bearer token (or session
+     * cookie) attached to the request and return the resulting session info.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    validateSession(request?: SessionValidateRequest): Promise<SessionValidateResponse>;
+    /**
+     * POSTs to `/tenants/token/verify` to validate the Authorization-header
+     * token. Returns void on success (HTTP 204); throws on invalid tokens.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    verifyToken(request?: TokenVerifyRequest): Promise<unknown>;
+    /**
+     * POSTs to `/tenants/token/getAndVerify` to look up and validate a token
+     * by its `tokenId` (`jti`).
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    getAndVerifyToken(request: TokenGetAndVerifyRequest): Promise<TokenDetails>;
+    /**
+     * POSTs to `/tenants/token/query` to list/page tokens.
+     *
+     * @remarks `query` (string grammar) and `filter` (JSON) are mutually
+     *   exclusive; the schema enforces this at validation time.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    queryTokens(request?: TokenQueryRequest): Promise<TokenQueryResponse>;
+    /**
+     * GETs `/tenants/token/publicKey` and returns the public key in JSON form.
+     *
+     * @remarks This endpoint does not require authorization; it is still
+     *   routed via the SaaS client so the gateway base URL is reused.
+     */
+    getPublicKey(): Promise<PublicKeyJsonResponse>;
+    /** GETs `/tenants/token/publicKey` with `Accept: text/plain` and returns the PEM string. */
+    getPublicKeyText(): Promise<string>;
+    /** POSTs to `/tenants/token/createUserToken`. */
+    createUserToken(request?: CreateUserTokenRequest): Promise<TokenCreateResponse>;
+    /** POSTs to `/tenants/token/updateUserToken`. */
+    updateUserToken(request: UpdateUserTokenRequest): Promise<TokenDetails>;
+    /** POSTs to `/tenants/token/createAgentToken`. */
+    createAgentToken(request?: CreateAgentTokenRequest): Promise<TokenCreateResponse>;
+    /** POSTs to `/tenants/token/updateAgentToken`. */
+    updateAgentToken(request: UpdateAgentTokenRequest): Promise<TokenDetails>;
+    /**
+     * POSTs to `/tenants/token/createTenantToken`.
+     *
+     * @param request - Token request body. `tenantId` is required for MA/GA
+     *   callers and resolved from the session for TA callers.
+     * @param impersonate - Optional `Auth-Impersonate` header value to act as
+     *   a different tenant scope (only valid with internal tokens).
+     */
+    createTenantToken(request?: CreateTenantTokenRequest, impersonate?: string): Promise<TokenCreateResponse>;
+    /** POSTs to `/tenants/token/updateTenantToken`. */
+    updateTenantToken(request: UpdateTenantTokenRequest): Promise<TokenDetails>;
+    /** POSTs to `/tenants/token/createInternalToken`. Master-token only. */
+    createInternalToken(request: CreateInternalTokenRequest): Promise<TokenCreateResponse>;
+    /** POSTs to `/tenants/token/revoke`. */
+    revokeToken(request: RevokeTokenRequest): Promise<RevokeTokensResponse>;
+    /** POSTs to `/tenants/token/cancelRevoke`. */
+    cancelRevoke(request: CancelRevokeRequest): Promise<RevokeTokensResponse>;
+    /** POSTs to `/tenants/token/delete`. */
+    deleteToken(request: DeleteTokenRequest): Promise<DeleteTokensResponse>;
+    /** POSTs to `/tenants/token/import`. Master-token only. */
+    importToken(request: ImportTokenRequest): Promise<unknown>;
+}
+//# sourceMappingURL=datastore-tokens.service.d.ts.map

package/dist/src/lib/services/datastore/datastore-tokens.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datastore-tokens.service.d.ts","sourceRoot":"","sources":["../../../../../src/lib/services/datastore/datastore-tokens.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AA2BnD,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAErC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,sBAAsB;IAO/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPtB;;;;OAIG;gBAEgB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,SAAS;IAGjC;;;;;OAKG;IACG,eAAe,CACnB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,uBAAuB,CAAC;IAgBnC;;;;;OAKG;IACG,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC;IAQrE;;;;;OAKG;IACG,iBAAiB,CACrB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,YAAY,CAAC;IAgBxB;;;;;;;OAOG;IACG,WAAW,CACf,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,kBAAkB,CAAC;IAgB9B;;;;;OAKG;IACG,YAAY,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAcpD,4FAA4F;IACtF,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IASzC,iDAAiD;IAC3C,eAAe,CACnB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,mBAAmB,CAAC;IAgB/B,iDAAiD;IAC3C,eAAe,CACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,YAAY,CAAC;IAgBxB,kDAAkD;IAC5C,gBAAgB,CACpB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,mBAAmB,CAAC;IAgB/B,kDAAkD;IAC5C,gBAAgB,CACpB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,YAAY,CAAC;IAgBxB;;;;;;;OAOG;IACG,iBAAiB,CACrB,OAAO,GAAE,wBAA6B,EACtC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC;IAqB/B,mDAAmD;IAC7C,iBAAiB,CACrB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,YAAY,CAAC;IAgBxB,wEAAwE;IAClE,mBAAmB,CACvB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,mBAAmB,CAAC;IAgB/B,wCAAwC;IAClC,WAAW,CACf,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,oBAAoB,CAAC;IAgBhC,8CAA8C;IACxC,YAAY,CAChB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,oBAAoB,CAAC;IAgBhC,wCAAwC;IAClC,WAAW,CACf,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,oBAAoB,CAAC;IAgBhC,2DAA2D;IACrD,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;CAOjE"}

package/dist/src/lib/services/dx-saas.service.d.ts

@@ -0,0 +1,243 @@
+import { DXDoConfiguration } from '../model/config/DXDoConfiguration';
+import { AxiosRequestConfig, AxiosResponse, Method } from 'axios';
+import { SaaSRequestConfig } from '../model/request/SaaSRequestConfig';
+import * as http from 'http';
+import { MeResponse } from '../model/security/MeResponse';
+import * as Stream from 'stream';
+import { Logging } from '@dx-do/util';
+import { ConnectorConfig } from '../model/config/ConnectorConfig';
+import { DXSaaSConfiguration3 } from '../model/config/DXSaaSConfiguration';
+import SimpleLog = Logging.SimpleLog;
+export type DXRequestHeaders = {
+    [key: string]: string;
+};
+export interface DXAPMSaaSService {
+    tenantPost<T>(path: string, body?: unknown, params?: unknown, headers?: Record<string, string>): Promise<T>;
+    tenantPut<T>(path: string, body?: unknown, params?: unknown): Promise<T>;
+    tenantGet<T>(path: string, params?: unknown, extraHeaders?: {
+        [key: string]: string;
+    }, addCookie?: boolean): Promise<T>;
+    tenantPostForStream(path: string, body?: unknown, params?: unknown, addCookie?: boolean): Promise<http.IncomingMessage | void>;
+    tenantDelete<T>(path: string, params?: unknown, extraHeaders?: {
+        [key: string]: string;
+    }, addCookie?: boolean): Promise<T>;
+}
+export interface DxRxLogEntry {
+    at: number;
+    command: string;
+    requestConfig: Partial<AxiosRequestConfig>;
+}
+/**
+ * Core HTTP client for DX SaaS: tenant/APM, AXA, OI, ACC, and dashboard APIs.
+ * Handles auth, proxy, request logging, and error handling.
+ */
+export declare class DxSaasService implements DXAPMSaaSService {
+    dxdoConfiguration: DXDoConfiguration;
+    private log;
+    private postmanMeta;
+    _httpClient: import("axios").AxiosInstance;
+    static requestLog: DxRxLogEntry[];
+    static staticLog: Logging.NullSimpleLog;
+    static outputPostmanLog(postmanMeta: string): void;
+    simplifiedCohortId: string;
+    /**
+     * @param dxdoConfiguration - DX-DO config (gateway, token, cohort, proxy)
+     * @param log - Logger for request/error output
+     * @param postmanMeta - Optional label for Postman export when request logging is enabled
+     */
+    constructor(dxdoConfiguration: DXDoConfiguration, log: SimpleLog, postmanMeta?: string);
+    initializeProxyIfNecessary(): void;
+    getTokenUser(): string;
+    /** Verify connectivity by fetching the ATC view list. */
+    ping(): Promise<never>;
+    /** Authenticate and return the current user's profile from the AXA security endpoint. */
+    auth(): Promise<MeResponse.MeResponseBody>;
+    tenantCN: string | undefined;
+    loadTenantCN(): Promise<string>;
+    getTenantCN(): Promise<string>;
+    getTenantID(): number;
+    getCohortIDForURL(): string;
+    getAXASessionHost(): string;
+    /**
+     * Fetch AXA session events (APM Synthetic / AXA user sessions) from the Elasticsearch exporter.
+     * @param startTimestamp - Start of the time window (epoch ms).
+     * @param endTimestamp - End of the time window (epoch ms).
+     * @param maxSessions - Maximum number of session records to return.
+     * @param appId - AXA application ID to filter by.
+     * @param query - Optional Lucene query string override. Defaults to `app.id:"<appId>"`.
+     */
+    axaSessionRequest<T>(startTimestamp: number, endTimestamp: number, maxSessions: number, appId: string, query?: string): Promise<T>;
+    getConnectorConfig(): Promise<ConnectorConfig>;
+    /**
+     * Issue an arbitrary HTTP request to the AXA sub-domain (Elasticsearch exporter or UDS config).
+     * @param method - HTTP method.
+     * @param path - Path relative to the AXA host, optionally suffixed with tenant CN.
+     * @param appendTenantToPath - When `true`, the tenant common name is appended to `path`.
+     * @param appendOrgIdToParams - When `true`, `orgid` query param is added automatically.
+     * @param body - Request body (non-GET only).
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
+    axaRequest<T>(method: Method, path: string, appendTenantToPath: boolean, appendOrgIdToParams: boolean, body?: unknown, params?: Record<string, string | number>, extraHeaders?: DXRequestHeaders): Promise<T>;
+    /**
+     * Issue an HTTP PATCH to a tenant-scoped path under the DX gateway.
+     * @param path - Relative path after the cohort segment.
+     * @param body - Partial update payload.
+     */
+    tenantPatch<T>(path: string, body: unknown): Promise<T | void>;
+    /**
+     * Issue an HTTP POST to a tenant-scoped path under the DX gateway.
+     * @param path - Relative path after the cohort segment (e.g. `"atc/views/view"`).
+     * @param body - Request body (JSON-serializable). Defaults to `{}`.
+     * @param params - Query-string parameters.
+     * @param headers - Additional request headers merged over the auth header.
+     */
+    tenantPost<T>(path: string, body?: unknown, params?: unknown, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Issue an HTTP PUT to a tenant-scoped path under the DX gateway.
+     * @param path - Relative path after the cohort segment.
+     * @param body - Request body.
+     * @param params - Query-string parameters.
+     */
+    tenantPut<T>(path: string, body?: unknown, params?: unknown): Promise<T>;
+    /**
+     * Issue an HTTP POST to a tenant path and return the response as a Node.js stream.
+     * Useful for large binary downloads (e.g. metric data exports).
+     */
+    tenantPostForStream(path: string, body?: unknown, params?: unknown): Promise<http.IncomingMessage>;
+    /**
+     * Issue an arbitrary HTTP method to a tenant-scoped path.
+     * Prefer the typed helpers (`tenantGet`, `tenantPost`, etc.) when the method is known.
+     * @param method - HTTP method (GET, POST, PUT, DELETE, …).
+     * @param path - Relative path after the cohort segment.
+     * @param body - Request body (non-GET methods only).
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
+    tenantRequest<T>(method: Method, path: string, body?: unknown, params?: Record<string, string | number>, extraHeaders?: DXRequestHeaders): Promise<T>;
+    /**
+     * Issue an HTTP GET to a tenant-scoped path under the DX gateway.
+     * @param path - Relative path after the cohort segment.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
+    tenantGet<T>(path: string, params?: unknown, extraHeaders?: DXRequestHeaders): Promise<T>;
+    /**
+     * Issue an HTTP DELETE to a tenant-scoped path under the DX gateway.
+     * @param path - Relative path after the cohort segment.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
+    tenantDelete<T>(path: string, params?: unknown, extraHeaders?: DXRequestHeaders): Promise<T>;
+    createSimpleUserAuthorizedRequestConfig<T>(params: T): SaaSRequestConfig<T>;
+    createUserAuthorizedRequestConfig<T>(params: T): SaaSRequestConfig<T>;
+    /**
+     * POST to an OI (Operational Intelligence) path with `x-authorizationview: VIEWALL` header.
+     * @param path - Relative path after the cohort segment.
+     * @param body - Request body.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
+    oiPost<T>(path: string, body?: unknown, params?: unknown, extraHeaders?: DXRequestHeaders): Promise<T>;
+    /**
+     * GET from an OI (Operational Intelligence) path with `x-authorizationview: VIEWALL` header.
+     * @param path - Relative path after the cohort segment.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
+    oiGet<T>(path: string, params?: unknown, extraHeaders?: DXRequestHeaders): Promise<T>;
+    /**
+     * GET from an ACC path, returning the response as a Node.js readable stream.
+     * @param path - Path segment appended after `.../acc/`.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
+    accStream(path: string, params?: unknown, extraHeaders?: DXRequestHeaders): Promise<AxiosResponse<Stream, any, {}>>;
+    /**
+     * GET from an ACC path.
+     * @param path - Path segment appended after `.../acc/`.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
+    accGet<T>(path: string, params?: unknown, extraHeaders?: DXRequestHeaders): Promise<T>;
+    /**
+     * PATCH to an ACC path.
+     * @param path - Path segment appended after `.../acc/`.
+     * @param body - Partial update payload.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
+    accPatch<T>(path: string, body?: unknown, params?: unknown, extraHeaders?: DXRequestHeaders): Promise<T>;
+    /**
+     * DELETE an ACC resource.
+     * @param path - Path segment appended after `.../acc/`.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
+    accDelete<T>(path: string, params?: unknown, extraHeaders?: DXRequestHeaders): Promise<T>;
+    /**
+     * Streams an HTTP GET against an arbitrary fully-qualified URL with no
+     * auth headers attached. Used for following pre-signed download URLs
+     * (e.g. ACC `_links.download.href`) that reject the user-auth bearer.
+     * @param url - Fully-qualified URL to GET.
+     */
+    streamFromURL(url: string): Promise<AxiosResponse<Stream, any, {}>>;
+    /**
+     * POST a file to an ACC path using `multipart/form-data`.
+     * @param urlpath - Path segment appended after `.../acc/`.
+     * @param filepath - Absolute path on disk to the file to upload.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
+    accPostFile<T>(urlpath: string, filepath: string, params?: unknown, extraHeaders?: DXRequestHeaders): Promise<unknown>;
+    /**
+     * POST to an ACC path.
+     * @param path - Path segment appended after `.../acc/`.
+     * @param body - Request body.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
+    accPost<T>(path: string, body?: unknown, params?: unknown, extraHeaders?: DXRequestHeaders): Promise<T>;
+    createDashboardAuthorizedRequestHeaders(): Record<string, string>;
+    /**
+     * GET from a Dashboard (Grafana) path under `.../dxd/`.
+     * @param path - Path segment appended after `.../dxd/`.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
+    dashboardGet<T>(path: string, params?: unknown, extraHeaders?: DXRequestHeaders): Promise<T>;
+    /**
+     * DELETE from a Dashboard (Grafana) path under `.../dxd/`.
+     * @param path - Path segment appended after `.../dxd/`.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
+    dashboardDelete<T>(path: string, params?: unknown, extraHeaders?: DXRequestHeaders): Promise<T>;
+    /**
+     * POST to a Dashboard path using cookie-based (anonymous) auth instead of the bearer token.
+     * Used for Grafana endpoints that authenticate via session cookies.
+     */
+    dashboardCookiePost<T>(path: string, body?: unknown, params?: unknown, extraHeaders?: DXRequestHeaders): Promise<T>;
+    /**
+     * POST to a Dashboard (Grafana) path under `.../dxd/`.
+     * @param path - Path segment appended after `.../dxd/`.
+     * @param body - Request body.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
+    dashboardPost<T>(path: string, body?: unknown, params?: unknown, extraHeaders?: DXRequestHeaders): Promise<T>;
+    /**
+     * PUT to a Dashboard (Grafana) path under `.../dxd/`.
+     * @param path - Path segment appended after `.../dxd/`.
+     * @param body - Request body.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
+    dashboardPut<T>(path: string, body?: unknown, params?: unknown, extraHeaders?: DXRequestHeaders): Promise<T>;
+    private static handleAxiosError;
+    static legacyAuth(v3Configuration: Partial<DXSaaSConfiguration3>): Promise<MeResponse.MeResponseBody>;
+    static legacyCreateSimpleUserAuthorizedRequestConfig(configuration: Partial<DXSaaSConfiguration3>, params?: {}): SaaSRequestConfig<unknown>;
+    static legacyAxaRequest<T>(configuration: Partial<DXSaaSConfiguration3>, method: Method, path: string, appendTenantToPath: boolean, appendOrgIdToParams: boolean, body?: unknown, params?: Record<string, string | number>, extraHeaders?: DXRequestHeaders): Promise<T>;
+    static getCohortFromLegacyEndpoint(v3Configuration: DXSaaSConfiguration3): Promise<string>;
+}
+//# sourceMappingURL=dx-saas.service.d.ts.map

package/dist/src/lib/services/dx-saas.service.d.ts.map

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

package/dist/src/lib/services/dxoi.service.d.ts

@@ -0,0 +1,27 @@
+import { DxSaasService } from './dx-saas.service';
+import { OIService } from '../model/oi/services';
+import { OIAlarm } from '../model/oi/alarms';
+import { DateTime } from 'luxon';
+import { OIEntity } from '../model/oi/entity';
+/**
+ * Service for OI (Operations Intelligence) read operations: services, situations,
+ * entity attributes, alarms, and alarm lifecycle.
+ */
+export declare class DxoiService {
+    private dxSaaSService;
+    /** @param dxSaaSService - DX SaaS HTTP client for OI endpoints */
+    constructor(dxSaaSService: DxSaasService);
+    /** Returns top-level OI services using the default service request body. */
+    getServices(): Promise<OIService.ServicesResponse>;
+    /** Returns cluster alarms (situations) within the given time range. */
+    getSituations(startTime: DateTime, endTime: DateTime): Promise<OIAlarm.SituationsResponseBody>;
+    /** Returns the entity-detail attributes for a given entity external ID. */
+    getEntityAttributes(entityExternalId: string): Promise<OIEntity.EntityDetails>;
+    /** Returns a single alarm by its ID. */
+    getAlarm(alarmId: string): Promise<OIAlarm.Alarm>;
+    /** Returns the lifecycle event history for a given alarm ID. */
+    getAlarmLifeCycle(alarmId: string): Promise<OIAlarm.AlarmLifecycleResponseBody>;
+    /** Returns all alarms in a time range, paginating until the full count is fetched. */
+    getAlarms(startTime: DateTime, endTime: DateTime): Promise<Map<string, OIAlarm.Alarm>>;
+}
+//# sourceMappingURL=dxoi.service.d.ts.map

package/dist/src/lib/services/dxoi.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dxoi.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/dxoi.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAM9C;;;GAGG;AACH,qBAAa,WAAW;IAEV,OAAO,CAAC,aAAa;IADjC,kEAAkE;gBAC9C,aAAa,EAAE,aAAa;IAEhD,4EAA4E;IAC5E,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC;IASlD,uEAAuE;IACjE,aAAa,CACjB,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC;IAW1C,2EAA2E;IACrE,mBAAmB,CAAC,gBAAgB,EAAE,MAAM;IASlD,wCAAwC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;IAMvD,gEAAgE;IAC1D,iBAAiB,CACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,0BAA0B,CAAC;IAoB9C,sFAAsF;IAChF,SAAS,CACb,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CAuCvC"}

package/dist/src/lib/services/event.service.d.ts

@@ -0,0 +1,27 @@
+import { DxSaasService } from './dx-saas.service';
+import { Logging } from '@dx-do/util';
+import { ChangeEventIngestionDocument, ChangeEventResponseDocument, IngestionResponse, EventQueryResponse, AlarmIngestionDocument, EventIngestionDocument } from '../model/event/event.model';
+import { DateTime } from 'luxon';
+/**
+ * Service for ingesting and querying events: alarms, change events, and custom
+ * events via the OI/Jarvis ingestion and search APIs.
+ */
+export declare class EventService {
+    private dxSaaSService;
+    private log;
+    static ISO_FORMAT: string;
+    /**
+     * @param dxSaaSService - DX SaaS HTTP client for OI/tenant requests
+     * @param log - Optional logger (defaults to null log)
+     */
+    constructor(dxSaaSService: DxSaasService, log?: Logging.SimpleLog);
+    /** Ingests a custom alarm event via the Jarvis ingestion API. */
+    createAlarm(alarmEvent: AlarmIngestionDocument): Promise<IngestionResponse>;
+    /** Ingests a custom event (non-change) via the Jarvis ingestion API. */
+    createEvent(changeEvent: EventIngestionDocument): Promise<IngestionResponse>;
+    /** Ingests a custom change event via the Jarvis ingestion API. */
+    createChangeEvent(changeEvent: ChangeEventIngestionDocument): Promise<IngestionResponse>;
+    /** Queries change events using a Lucene query string within a time range. */
+    queryChangeEvents(luceneQuery: string, startTime: DateTime, endTime: DateTime, from?: number, size?: number): Promise<EventQueryResponse<ChangeEventResponseDocument>>;
+}
+//# sourceMappingURL=event.service.d.ts.map

package/dist/src/lib/services/event.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/event.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAG3B,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EAEtB,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjC;;;GAGG;AACH,qBAAa,YAAY;IAQrB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,GAAG;IARb,MAAM,CAAC,UAAU,SAA8B;IAE/C;;;OAGG;gBAEO,aAAa,EAAE,aAAa,EAC5B,GAAG,GAAE,OAAO,CAAC,SAAuC;IAG9D,iEAAiE;IACjE,WAAW,CAAC,UAAU,EAAE,sBAAsB;IAgC9C,wEAAwE;IACxE,WAAW,CAAC,WAAW,EAAE,sBAAsB;IA+B/C,kEAAkE;IAClE,iBAAiB,CAAC,WAAW,EAAE,4BAA4B;IAgC3D,6EAA6E;IAC7E,iBAAiB,CACf,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,QAAQ,EACjB,IAAI,SAAI,EACR,IAAI,SAAM;CAYb"}