@dx-do/client 5.2.48 → 5.2.50

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

@@ -0,0 +1,24 @@
+import { DxSaasService } from './dx-saas.service';
+import { Logging } from '@dx-do/util';
+import SimpleLog = Logging.SimpleLog;
+import { Blob } from '../model/blob/blob.model';
+/**
+ * Service for blob storage: list schemas, fetch blob by schema/id/version,
+ * and list blobs for a schema.
+ */
+export declare class BlobService {
+    private dxSaaSService;
+    private log;
+    /**
+     * @param dxSaaSService - DX SaaS HTTP client for tenant blob endpoints
+     * @param log - Optional logger (defaults to null log)
+     */
+    constructor(dxSaaSService: DxSaasService, log?: SimpleLog);
+    /** Returns the list of available blob schemas. */
+    listSchemas(): Promise<Blob.SchemaListResponse>;
+    /** Fetches a blob by schema, ID, and optional version; returns the raw data string. */
+    fetchBlob(schema: string, id: string, version?: number): Promise<string>;
+    /** Returns all blobs (without content) registered under a given schema. */
+    listBlobsForSchema(schema: string): Promise<Blob.BlobQueryResponse>;
+}
+//# sourceMappingURL=blob.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blob.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/blob.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAGhD;;;GAGG;AACH,qBAAa,WAAW;IAMpB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,GAAG;IANb;;;OAGG;gBAEO,aAAa,EAAE,aAAa,EAC5B,GAAG,GAAE,SAAuC;IAGtD,kDAAkD;IAC5C,WAAW;IAOjB,uFAAuF;IACjF,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAgB5D,2EAA2E;IACrE,kBAAkB,CAAC,MAAM,EAAE,MAAM;CAexC"}

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

@@ -0,0 +1,43 @@
+import { DxSaasService } from './dx-saas.service';
+import { ChannelResponse } from '../model/channel/ChannelResponse';
+import { TemplatesResponse } from '../model/channel/TemplatesResponse';
+import Channel = ChannelResponse.Channel;
+import Template = TemplatesResponse.Template;
+import { PolicyResponse } from '../model/channel/PolicyResponse';
+import Policy = PolicyResponse.Policy;
+import { DXChannel } from '../model/dxchannel/DXChannel';
+import DXChannelConfiguration = DXChannel.DXChannelConfiguration;
+/**
+ * Service for notification channels, templates, and policies via AXA notify API:
+ * list, create, update channels/templates/policies.
+ */
+export declare class ChannelService {
+    private dxSaaSService;
+    /** @param dxSaaSService - DX SaaS HTTP client for AXA requests */
+    constructor(dxSaaSService: DxSaasService);
+    /** Returns all notification channels using the new DXChannelConfiguration model. */
+    retrieveAllChannelsNew(): Promise<DXChannelConfiguration[]>;
+    /** Returns all notification channels using the legacy Channel model. */
+    retrieveAllChannels(): Promise<Channel[]>;
+    /** Creates a new notification channel using the new DXChannelConfiguration model. */
+    createChannelNew(channelToCreate: DXChannelConfiguration): Promise<unknown>;
+    /** Creates a new notification channel using the legacy Channel model. */
+    createChannel(channelToCreate: Channel): Promise<any>;
+    /** Updates an existing channel by ID using the new DXChannelConfiguration model. */
+    updateChannelNew(existingChannelId: number, channelUpdate: DXChannelConfiguration): Promise<unknown>;
+    /** Updates an existing channel by ID using the legacy Channel model. */
+    updateChannel(existingChannelId: number, channelUpdate: Channel): Promise<any>;
+    /** Returns all notification templates. */
+    retrieveAllTemplates(): Promise<Template[]>;
+    /** Returns all notification filter policies. */
+    retrieveAllPolicies(): Promise<Policy[]>;
+    /** Updates an existing notification filter policy. */
+    updatePolicy(policy: PolicyResponse.Policy): Promise<unknown>;
+    /** Creates a new notification filter policy. */
+    createPolicy(policy: PolicyResponse.Policy): Promise<unknown>;
+    /** Creates a new notification template with text (base64-encoded) and optional metadata. */
+    createTemplate(templateName: string, templateSubject: string, templateText: string, senderNameTemplate?: string, locale?: string, makeDefault?: boolean, author?: string): Promise<any>;
+    /** Updates fields on an existing template; any omitted fields keep their current values. */
+    updateTemplate(currentTemplate: Template, newTemplateName?: string, newTemplateSubject?: string, newTemplateText?: string, senderNameTemplate?: string, locale?: string, makeDefault?: boolean, author?: string): Promise<any>;
+}
+//# sourceMappingURL=channel.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/channel.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC;AACzC,OAAO,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,sBAAsB,GAAG,SAAS,CAAC,sBAAsB,CAAC;AAGjE;;;GAGG;AACH,qBAAa,cAAc;IAEb,OAAO,CAAC,aAAa;IADjC,kEAAkE;gBAC9C,aAAa,EAAE,aAAa;IAEhD,oFAAoF;IAC7E,sBAAsB,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAalE,wEAAwE;IACjE,mBAAmB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAahD,qFAAqF;IACxE,gBAAgB,CAC3B,eAAe,EAAE,sBAAsB,GACtC,OAAO,CAAC,OAAO,CAAC;IAcnB,yEAAyE;IAC5D,aAAa,CAAC,eAAe,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAclE,oFAAoF;IACvE,gBAAgB,CAC3B,iBAAiB,EAAE,MAAM,EACzB,aAAa,EAAE,sBAAsB,GACpC,OAAO,CAAC,OAAO,CAAC;IAanB,wEAAwE;IAC3D,aAAa,CACxB,iBAAiB,EAAE,MAAM,EACzB,aAAa,EAAE,OAAO,GACrB,OAAO,CAAC,GAAG,CAAC;IAaf,0CAA0C;IACnC,oBAAoB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAalD,gDAAgD;IACzC,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAa/C,sDAAsD;IACtD,YAAY,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM;IAU1C,gDAAgD;IAChD,YAAY,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM;IAU1C,4FAA4F;IACrF,cAAc,CACnB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,OAAO,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,GAAG,CAAC;IAyBf,4FAA4F;IACrF,cAAc,CACnB,eAAe,EAAE,QAAQ,EACzB,eAAe,CAAC,EAAE,MAAM,EACxB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,eAAe,CAAC,EAAE,MAAM,EACxB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,OAAO,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,GAAG,CAAC;CAiBhB"}

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

@@ -0,0 +1,75 @@
+import { DxSaasService } from './dx-saas.service';
+import { DashboardListKeysResponse } from '../model/dashboard/DashboardListKeysResponse';
+import { DashboardSearch } from '../model/dashboard/DashboardSearch';
+import { DashboardSearchResponse } from '../model/dashboard/DashboardSearchResponse';
+import { DashboardFolderListResponse } from '../model/dashboard/DashboardFolderListResponse';
+import { DashboardCreateFolderResponse } from '../model/dashboard/DashboardCreateFolderResponse';
+import { DashboardPermissionsGetResponse } from '../model/dashboard/DashboardPermissionsGetResponse';
+import { DashboardPermissionsUpdateRequest } from '../model/dashboard/DashboardPermissionsUpdateRequest';
+import { DashboardUserSearchResponse } from '../model/dashboard/DashboardUserSearchResponse';
+import { DashboardDashboardResponse } from '../model/dashboard/DashboardResponse';
+import { FolderResponse } from '../model/dashboard/FolderResponse';
+import { THEME_TYPE } from '../model/dashboard/DashboardPreferenceResponse';
+import { DashboardAllTagsResponse } from '../model/dashboard/DashboardTags';
+import { DashboardUpdateResponseBody } from '../model/dashboard/DashboardUpdate';
+import { MServe } from '../model/dashboard/DashboardMServeResponse';
+import DashboardListKeysResponseBody = DashboardListKeysResponse.DashboardListKeysResponseBody;
+import DashboardFolderListItem = DashboardFolderListResponse.DashboardFolderListItem;
+import DashboardUpdatePermissionItem = DashboardPermissionsUpdateRequest.DashboardUpdatePermissionItem;
+import PermissionType = DashboardPermissionsUpdateRequest.PermissionType;
+/**
+ * Service for Grafana-style dashboard API: themes, API keys, dashboards,
+ * folders, permissions, tags, and user lookup.
+ */
+export declare class DashboardService {
+    private dxSaaSService;
+    /** @param dxSaaSService - DX SaaS HTTP client for dashboard (dxd) endpoints */
+    constructor(dxSaaSService: DxSaasService);
+    /** Returns the current org theme setting (e.g. "light" or "dark"). */
+    getTheme(): Promise<string>;
+    /** Sets the org theme preference. */
+    setTheme(themeString: THEME_TYPE): Promise<void>;
+    /** Lists all API keys for the org. */
+    listApiKeys(): Promise<DashboardListKeysResponseBody>;
+    /** Creates a new dashboard in the specified folder (clears the ID before sending). */
+    createDashboard(folderId: number, dashboard: DashboardDashboardResponse.Dashboard, updateCommitMessage: string): Promise<unknown>;
+    /** Updates an existing dashboard by ID, optionally overwriting the current version. */
+    updateDashboard(id: number, folderId: number, dashboard: DashboardDashboardResponse.Dashboard, updateCommitMessage: string, overwrite?: boolean): Promise<DashboardUpdateResponseBody>;
+    /** Returns all dashboard tags used across the org. */
+    getAllDashboardTags(): Promise<DashboardAllTagsResponse>;
+    /** Appends new tags to a dashboard (skips tags already present). */
+    addDashboardTags(uid: string, tags: string[]): Promise<DashboardUpdateResponseBody>;
+    /** Replaces all existing tags on a dashboard with the provided set. */
+    replaceDashboardTags(uid: string, newTags: string[]): Promise<DashboardUpdateResponseBody>;
+    /** Returns the full dashboard (model + meta) for a given UID. */
+    getDashboard(uid: string): Promise<DashboardDashboardResponse.DashboardResponseBody>;
+    /** Returns all dashboards within a specific folder. */
+    getDashboardsInFolder(folderId: string): Promise<DashboardSearchResponse.DashboardSearchResponseBody>;
+    /** Searches dashboards or folders by type and query string. */
+    search(searchType: DashboardSearch.SearchType, query: string): Promise<DashboardSearchResponse.DashboardSearchResponseBody>;
+    /** Returns folder metadata by numeric folder ID. */
+    getFolderById(folderId: number): Promise<FolderResponse.FolderResponseBody>;
+    /** Returns folder metadata by UID string. */
+    getFolderByUid(folderUid: string): Promise<FolderResponse.FolderResponseBody>;
+    /** Returns the UID for a folder with the given title, or `undefined` if not found. */
+    getFolderUid(folderTitle: string): Promise<string | undefined>;
+    /** Returns a map of folder title → folder item for all folders. */
+    getFoldersMapByTitle(): Promise<Map<string, DashboardFolderListItem>>;
+    /** Returns all folders for the org. */
+    getFolders(): Promise<DashboardFolderListResponse.DashboardFolderListResponseBody>;
+    /** Creates a new folder with the given title and optional UID. */
+    createFolder(folderTitle: string, folderUid?: string): Promise<DashboardCreateFolderResponse.DashboardCreateFolderResponseBody>;
+    /** Returns the permission list for a folder by UID. */
+    getFolderPermissions(folderUid: string): Promise<DashboardPermissionsGetResponse.DashboardPermissionResponseBody>;
+    /** Adds a permission entry for a user to a folder, preserving existing permissions. */
+    addFolderPermission(folderUid: string, userId: number, permissionType: PermissionType): Promise<any>;
+    /** Issues a multi-search against the audit log datasource using a session cookie. */
+    mSearch(validSessionCookie: string, startTime: number, endTime: number): Promise<MServe.MServeQueryResponse>;
+    /** Replaces all permissions on a folder with the provided list. */
+    setFolderPermissions(folderUid: string, permissions: DashboardUpdatePermissionItem[]): Promise<any>;
+    /** Searches org users by a query term (useful for permission assignment). */
+    searchUsers(searchTerm: string): Promise<DashboardUserSearchResponse.DashboardUserSearchReponseBody>;
+    /** Looks up a single org user by email or login name. */
+    lookupUser(userEmail: string): Promise<unknown>;
+}
+//# sourceMappingURL=dashboard.service.d.ts.map

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

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

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

@@ -0,0 +1,47 @@
+import { DxSaasService } from '../dx-saas.service';
+import type { AuditQueryRequest, AuditQueryResponse, AuditRecord, AuditStoreResponse } from '../../model/datastore/audit';
+import { Logging } from '@dx-do/util';
+import SimpleLog = Logging.SimpleLog;
+/**
+ * Service for the DX SaaS DataStore audit API (`/audit/...`).
+ *
+ * @example
+ * ```ts
+ * const service = new DataStoreAuditService(dxSaasService, log);
+ * await service.storeAudit({
+ *   eventTime: new Date().toISOString(),
+ *   serviceId: 'gatekeeper',
+ *   resource: 'user',
+ *   action: 'login',
+ *   result: 'ok',
+ * });
+ *
+ * const records = await service.queryAudit({
+ *   fromEventTime: DateTime.now().minus({ hours: 24 }),
+ *   toEventTime: DateTime.now(),
+ *   action: 'login',
+ * });
+ * ```
+ */
+export declare class DataStoreAuditService {
+    private readonly dxSaasService;
+    private readonly log;
+    constructor(dxSaasService: DxSaasService, log: SimpleLog);
+    /**
+     * POSTs to `/audit/store` to record an audit event.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    storeAudit(record: AuditRecord): Promise<AuditStoreResponse>;
+    /**
+     * GETs `/audit/query` to retrieve audit records for the current tenant.
+     * Requires TA-role authorization on the server side.
+     *
+     * `fromEventTime` and `toEventTime` are luxon `DateTime` instances;
+     * they are serialised to epoch milliseconds for the query string.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    queryAudit(request: AuditQueryRequest): Promise<AuditQueryResponse>;
+}
+//# sourceMappingURL=datastore-audit.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datastore-audit.service.d.ts","sourceRoot":"","sources":["../../../../../src/lib/services/datastore/datastore-audit.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOnD,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,SAAS;IAGjC;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgBlE;;;;;;;;OAQG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAwB1E"}

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

@@ -0,0 +1,72 @@
+import { DxSaasService } from '../dx-saas.service';
+import type { DefaultViewsResponse, SetDefaultViewRequest, ViewBody, ViewListResponse, ViewQueryRequest, ViewQueryResponse, ViewResponse, ViewSearchRequest } from '../../model/datastore/views';
+import { Logging } from '@dx-do/util';
+import SimpleLog = Logging.SimpleLog;
+/**
+ * Service for the DX SaaS DataStore authorization views API
+ * (`/views/...`).
+ *
+ * Authorization views combine an access policy (`access.users`/`access.groups`)
+ * with optional TAS / NASS filter scopes (`views.tas`, `views.nass`) under a
+ * named label. Creating a view typically requires admin privileges.
+ *
+ * Note: this is the data-store-level views API and is distinct from the higher
+ * level APM Universe API (`/atc/views/view`) wrapped by `ApmUniverseService`.
+ *
+ * @example
+ * ```ts
+ * const service = new DataStoreAuthViewsService(dxSaasService, log);
+ * const all = await service.queryViews({ filter: { op: 'ALL' } });
+ * ```
+ */
+export declare class DataStoreAuthViewsService {
+    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 `/views/view` to create a new authorization view. Admin only.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    createView(view: ViewBody): Promise<ViewResponse>;
+    /**
+     * PUTs to `/views/view/{viewId}` to update an existing authorization view.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    updateView(viewId: string, view: ViewBody): Promise<ViewResponse>;
+    /** DELETEs `/views/view/{viewId}` and returns the deleted view. */
+    deleteView(viewId: string): Promise<ViewResponse>;
+    /** GETs `/views/view/{viewId}` for a single authorization view. */
+    getView(viewId: string): Promise<ViewResponse>;
+    /** GETs `/views/view` and returns all authorization views the user can access. */
+    listViews(): Promise<ViewListResponse>;
+    /**
+     * PUTs to `/views/default` to assign one or more default views to a user.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    setDefaultView(request: SetDefaultViewRequest): Promise<unknown>;
+    /** GETs `/views/default/{userName}` for the user's default views. */
+    getDefaultViews(userName: string): Promise<DefaultViewsResponse>;
+    /**
+     * POSTs to `/views/query` to find a single view matching a user/group/rule
+     * predicate.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    searchView(request: ViewSearchRequest): Promise<ViewResponse>;
+    /**
+     * POSTs to `/views/queryView` to find views matching a structured filter
+     * (`ALL | ID | ACTIVE | ATTRIBUTE | AND | OR`).
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    queryViews(request?: ViewQueryRequest): Promise<ViewQueryResponse>;
+}
+//# sourceMappingURL=datastore-auth-views.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datastore-auth-views.service.d.ts","sourceRoot":"","sources":["../../../../../src/lib/services/datastore/datastore-auth-views.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAanD,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAErC;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,yBAAyB;IAOlC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPtB;;;;OAIG;gBAEgB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,SAAS;IAGjC;;;;OAIG;IACG,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC;IAUvD;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC;IAavE,mEAAmE;IAC7D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAWvD,mEAAmE;IAC7D,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAWpD,kFAAkF;IAC5E,SAAS,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAY5C;;;;OAIG;IACG,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtE,qEAAqE;IAC/D,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IActE;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAanE;;;;;OAKG;IACG,UAAU,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAe7E"}

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

@@ -0,0 +1,100 @@
+import { DxSaasService } from '../dx-saas.service';
+import type { BlobAsyncResultRequest, BlobAsyncResultResponse, BlobAttributes, BlobBulkDeleteRequest, BlobBulkDeleteResponse, BlobBulkStoreRequest, BlobBulkStoreResponse, BlobDeleteResponse, BlobExecuteAsyncRequest, BlobExecuteAsyncResponse, BlobQueryRequest, BlobQueryResponse, BlobSchemaListResponse, BlobStoreResponse } from '../../model/datastore/blobstorage';
+import { Logging } from '@dx-do/util';
+import SimpleLog = Logging.SimpleLog;
+/**
+ * Service for the DX SaaS DataStore blob storage API
+ * (`/blobstorage/...`).
+ *
+ * Blob storage is a tenant-scoped key/value store organized into named
+ * schemas, with optional attributes (queryable) and TTL. This service covers
+ * the full REST surface: store, bulk store, fetch, query, delete, bulk
+ * delete, list schemas, plus async commands like `DELETE_SCHEMA`.
+ *
+ * @example
+ * ```ts
+ * const service = new DataStoreBlobStorageService(dxSaasService, log);
+ * await service.storeBlob(
+ *   { schema: 'schema1', id: 'file1', ttl: '2099-01-01T00:00:00Z' },
+ *   'hello world',
+ *   { size: 'medium', isActive: 'true' }
+ * );
+ * ```
+ */
+export declare class DataStoreBlobStorageService {
+    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 `/blobstorage/blob` to store a new blob (or new version of an
+     * existing one).
+     *
+     * @param params - Required `schema`, `id`, `ttl` query parameters.
+     * @param body - Raw blob content; sent as the request body.
+     * @param attributes - Free-form attributes serialized as additional query
+     *   parameters (per the REST contract in `blobstorage-rest.adoc`).
+     */
+    storeBlob(params: {
+        schema: string;
+        id: string;
+        ttl: string | number;
+    }, body: unknown, attributes?: BlobAttributes): Promise<BlobStoreResponse>;
+    /**
+     * POSTs to `/blobstorage/blob/bulk` to store multiple blobs in one request.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    bulkStoreBlobs(request: BlobBulkStoreRequest): Promise<BlobBulkStoreResponse>;
+    /**
+     * POSTs to `/blobstorage/blob/fetch` to retrieve the content of a single
+     * blob (latest version by default).
+     *
+     * @param schema - Schema where the blob is stored.
+     * @param id - Blob id.
+     * @param version - Optional explicit version.
+     * @returns The raw blob content as returned by the server. Callers can cast
+     *   to `string` for textual blobs.
+     */
+    fetchBlob(schema: string, id: string, version?: number): Promise<unknown>;
+    /**
+     * POSTs to `/blobstorage/blob/query` to retrieve metadata (and optionally
+     * content) about blobs in a schema.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    queryBlobs(request: BlobQueryRequest): Promise<BlobQueryResponse>;
+    /**
+     * DELETEs `/blobstorage/blob?schema=<schema>&id=<id>` removing all
+     * versions of a blob.
+     */
+    deleteBlob(schema: string, id: string): Promise<BlobDeleteResponse>;
+    /**
+     * POSTs to `/blobstorage/blob/bulkDelete` (note: REST uses POST despite
+     * the verb in the name) to delete multiple blobs.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    bulkDeleteBlobs(request: BlobBulkDeleteRequest): Promise<BlobBulkDeleteResponse>;
+    /** POSTs to `/blobstorage/schema/list` to list defined schemas. */
+    listSchemas(): Promise<BlobSchemaListResponse>;
+    /**
+     * POSTs to `/blobstorage/executeAsync` to start an asynchronous command
+     * (e.g. `DELETE_SCHEMA`). Returns a `correlationKey` for polling.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    executeAsync(request: BlobExecuteAsyncRequest): Promise<BlobExecuteAsyncResponse>;
+    /**
+     * POSTs to `/blobstorage/asyncResult` to fetch progress and result for a
+     * previously initiated async command.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    asyncResult(request: BlobAsyncResultRequest): Promise<BlobAsyncResultResponse>;
+}
+//# sourceMappingURL=datastore-blobstorage.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datastore-blobstorage.service.d.ts","sourceRoot":"","sources":["../../../../../src/lib/services/datastore/datastore-blobstorage.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAkBnD,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAErC;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,2BAA2B;IAOpC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPtB;;;;OAIG;gBAEgB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,SAAS;IAGjC;;;;;;;;OAQG;IACG,SAAS,CACb,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EAC5D,IAAI,EAAE,OAAO,EACb,UAAU,GAAE,cAAmB,GAC9B,OAAO,CAAC,iBAAiB,CAAC;IAoB7B;;;;OAIG;IACG,cAAc,CAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAgBjC;;;;;;;;;OASG;IACG,SAAS,CACb,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC;IAQnB;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgBvE;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAezE;;;;;OAKG;IACG,eAAe,CACnB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,sBAAsB,CAAC;IAgBlC,mEAAmE;IAC7D,WAAW,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAepD;;;;;OAKG;IACG,YAAY,CAChB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC;IAgBpC;;;;;OAKG;IACG,WAAW,CACf,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,uBAAuB,CAAC;CAepC"}

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

@@ -0,0 +1,66 @@
+import { DxSaasService } from '../dx-saas.service';
+import type { FeatureDeleteRequest, FeatureListResponse, FeatureQueryRequest, FeatureStoreRequest, FeatureStoreResponse, FeatureToggleList, FeatureToggleListResponse } from '../../model/datastore/features';
+import { Logging } from '@dx-do/util';
+import SimpleLog = Logging.SimpleLog;
+/**
+ * Service for the DX SaaS DataStore features API (`/features/...`).
+ *
+ * Features are a hierarchical authorization tree. Nodes carry an `id`,
+ * optional `apis` regex list, child nodes, and `datascopes` (filter
+ * templates of types `TAS|NASS|ES|REST`). MA/GA roles can toggle
+ * features globally; TA can toggle per-tenant but not override global
+ * toggles set by GA/MA.
+ *
+ * @example
+ * ```ts
+ * const service = new DataStoreFeaturesService(dxSaasService, log);
+ * await service.toggleFeatures(['doi.service_analytics']);
+ * ```
+ */
+export declare class DataStoreFeaturesService {
+    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 `/features/store` to create or update a feature hierarchy.
+     * MA/GA only.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    storeFeatures(request: FeatureStoreRequest): Promise<FeatureStoreResponse>;
+    /**
+     * POSTs to `/features/delete` to delete features (and their subtrees) by id.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    deleteFeatures(request: FeatureDeleteRequest): Promise<FeatureListResponse>;
+    /**
+     * POSTs to `/features/query` to fetch features (and their children)
+     * matching a filter.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    queryFeatures(request?: FeatureQueryRequest): Promise<FeatureListResponse>;
+    /**
+     * POSTs to `/features/toggles` with a list of feature ids to toggle.
+     * Returns the toggled features.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    toggleFeatures(ids: FeatureToggleList): Promise<FeatureListResponse>;
+    /** POSTs to `/features/queryToggles` to fetch the list of toggled feature ids. */
+    queryToggles(): Promise<FeatureToggleListResponse>;
+    /**
+     * POSTs to `/features/deleteToggles` to reset the toggle state for the
+     * given feature ids (empty list resets all).
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    deleteToggles(ids?: FeatureToggleList): Promise<FeatureListResponse>;
+}
+//# sourceMappingURL=datastore-features.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datastore-features.service.d.ts","sourceRoot":"","sources":["../../../../../src/lib/services/datastore/datastore-features.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAYnD,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAErC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,wBAAwB;IAOjC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPtB;;;;OAIG;gBAEgB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,SAAS;IAGjC;;;;;OAKG;IACG,aAAa,CACjB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,oBAAoB,CAAC;IAgBhC;;;;OAIG;IACG,cAAc,CAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAgB/B;;;;;OAKG;IACG,aAAa,CACjB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,mBAAmB,CAAC;IAgB/B;;;;;OAKG;IACG,cAAc,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAgB1E,kFAAkF;IAC5E,YAAY,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAexD;;;;;OAKG;IACG,aAAa,CACjB,GAAG,GAAE,iBAAsB,GAC1B,OAAO,CAAC,mBAAmB,CAAC;CAehC"}

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

@@ -0,0 +1,52 @@
+import { DxSaasService } from '../dx-saas.service';
+import type { MetadataMetricQuery, MetadataMetricQueryResponseV2 } from '../../model/datastore/metrics-metadata';
+import { Logging } from '@dx-do/util';
+import SimpleLog = Logging.SimpleLog;
+/**
+ * Service for issuing metric metadata queries against the DX SaaS DataStore
+ * API (`/metadata/queryMetric`).
+ *
+ * Requests are validated against {@link MetadataMetricQuerySchema}; responses
+ * are validated against {@link MetadataMetricQueryResponseV2Schema}.
+ * Validation failures on the response side are logged as warnings, not thrown.
+ *
+ * @example
+ * ```ts
+ * const service = new DataStoreMetricsMetadataService(dxSaasService, log);
+ * const response = await service.queryMetric({
+ *   specifier: { op: 'ALL' },
+ *   clamp: 500,
+ *   time: Date.now(),
+ *   range: 480000,
+ *   includeLive: true,
+ *   includeProfile: false,
+ * });
+ * // response.metrics — matching metric descriptors
+ * // response.folders — matching folder descriptors
+ * ```
+ */
+export declare class DataStoreMetricsMetadataService {
+    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 metadata query to `/metadata/queryMetric` and returns the matching
+     * metric / folder records.
+     *
+     * @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 `MetadataMetricQueryResponseV2`).
+     *   Callers should handle potentially incomplete or unexpected fields
+     *   defensively.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    queryMetric(query: MetadataMetricQuery): Promise<MetadataMetricQueryResponseV2>;
+}
+//# sourceMappingURL=datastore-metrics-metadata.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datastore-metrics-metadata.service.d.ts","sourceRoot":"","sources":["../../../../../src/lib/services/datastore/datastore-metrics-metadata.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAC9B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,+BAA+B;IAQxC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG;IARtB;;;;;OAKG;gBAEgB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,SAAS;IAGjC;;;;;;;;;;;OAWG;IACG,WAAW,CACf,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,6BAA6B,CAAC;CAe1C"}

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

@@ -0,0 +1,86 @@
+import { DxSaasService } from '../dx-saas.service';
+import type { QueryRequest, QueryResult } from '../../model/datastore/nassql';
+import { Logging } from '@dx-do/util';
+import SimpleLog = Logging.SimpleLog;
+/**
+ * Service for issuing NASSQL queries against the DX SaaS DataStore API
+ * (`/metrics/nassQuery`).
+ *
+ * NASSQL is a pipeline query language that composes operations across
+ * topology, metric metadata, and metric data sources. The response is a
+ * tabular array where the first row is the column header and subsequent
+ * rows are data; use {@link splitResult} or {@link resultAsRecords} to
+ * work with the data conveniently.
+ *
+ * Requests are validated against {@link QueryRequestSchema}; responses are
+ * validated against {@link QueryResultSchema}. Validation failures on the
+ * response side are logged as warnings, not thrown.
+ *
+ * @example
+ * ```ts
+ * const service = new DataStoreNASSQLService(dxSaasService, log);
+ * const raw = await service.query({
+ *   query: [
+ *     {
+ *       op: 'FROM',
+ *       querySpecifier: { op: 'ALL' },
+ *       queryRange: { endTime: Date.now(), rangeSize: 480000, frequency: 15000 },
+ *     },
+ *   ],
+ * });
+ * const records = service.resultAsRecords(raw);
+ * // records: [{ source: 'host1', metric: 'cpu', value: 42 }, ...]
+ * ```
+ */
+export declare class DataStoreNASSQLService {
+    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 NASSQL query to `/metrics/nassQuery` and returns the raw tabular
+     * result (header row followed by data rows).
+     *
+     * @returns A tabular result where `result[0]` is the column header
+     *   (`string[]`) and `result[1..]` are data rows (`unknown[][]`). Use
+     *   {@link splitResult} or {@link resultAsRecords} to work with it
+     *   conveniently.
+     *
+     * @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 `QueryResult`). Callers should
+     *   handle potentially incomplete or unexpected fields defensively.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    query(request: QueryRequest): Promise<QueryResult>;
+    /**
+     * Splits a NASSQL query result into its header row and data rows.
+     * Assumes the first row is always the header.
+     *
+     * This is a stateless utility — it does not use any instance state.
+     *
+     * @returns `{ header, data }` where `header` is the column names and `data`
+     *   is the remaining rows. Returns empty arrays for empty input.
+     */
+    splitResult(result: QueryResult): {
+        header: string[];
+        data: unknown[][];
+    };
+    /**
+     * Converts a NASSQL query result into an array of objects (Records),
+     * where each object's keys are the column names from the header row.
+     *
+     * This is a stateless utility — it does not use any instance state.
+     *
+     * @returns An array of records keyed by column name. Returns `[]` for
+     *   empty input or header-only input.
+     */
+    resultAsRecords(result: QueryResult): Record<string, unknown>[];
+}
+//# sourceMappingURL=datastore-nassql.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datastore-nassql.service.d.ts","sourceRoot":"","sources":["../../../../../src/lib/services/datastore/datastore-nassql.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,sBAAsB;IAQ/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG;IARtB;;;;;OAKG;gBAEgB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,SAAS;IAGjC;;;;;;;;;;;;;;;OAeG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAaxD;;;;;;;;OAQG;IACH,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAA;KAAE;IASzE;;;;;;;;OAQG;IACH,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;CAUhE"}