@dx-do/client 6.1.1 → 6.2.1

package/dist/src/lib/model/datastore/views/filters.d.ts

@@ -1,11 +1,14 @@
 import { z } from 'zod/v4';
+/** Matches every view. */
 export declare const ViewAllFilterSchema: z.ZodObject<{
     op: z.ZodLiteral<"ALL">;
 }, z.core.$loose>;
+/** Matches views by ID. */
 export declare const ViewIdFilterSchema: z.ZodObject<{
     op: z.ZodLiteral<"ID">;
     ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$loose>;
+/** Matches only active views. */
 export declare const ViewActiveFilterSchema: z.ZodObject<{
     op: z.ZodLiteral<"ACTIVE">;
 }, z.core.$loose>;
@@ -14,6 +17,7 @@ export declare const ViewAttributeExpressionSchema: z.ZodObject<{
     values: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$loose>;
 export type ViewAttributeExpression = z.infer<typeof ViewAttributeExpressionSchema>;
+/** Matches views whose attributes satisfy the given expressions (AND-ed). */
 export declare const ViewAttributeFilterSchema: z.ZodObject<{
     op: z.ZodLiteral<"ATTRIBUTE">;
     expressions: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -21,14 +25,17 @@ export declare const ViewAttributeFilterSchema: z.ZodObject<{
         values: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$loose>>>;
 }, z.core.$loose>;
+/** Logical AND of nested view filters. */
 export declare const ViewAndFilterSchema: z.ZodObject<{
     op: z.ZodLiteral<"AND">;
     input: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodType<ViewFilter, unknown, z.core.$ZodTypeInternals<ViewFilter, unknown>>>>>;
 }, z.core.$loose>;
+/** Logical OR of nested view filters. */
 export declare const ViewOrFilterSchema: z.ZodObject<{
     op: z.ZodLiteral<"OR">;
     input: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodType<ViewFilter, unknown, z.core.$ZodTypeInternals<ViewFilter, unknown>>>>>;
 }, z.core.$loose>;
+/** Discriminated union of all view filter operators, keyed by `op`. */
 export declare const ViewFilterSchema: z.ZodType<ViewFilter>;
 export interface ViewFilter {
     op: string;

package/dist/src/lib/model/datastore/views/filters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/model/datastore/views/filters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAI3B,eAAO,MAAM,mBAAmB;;iBAE9B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;iBAEjC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;iBAGxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;iBAGpC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAOjD,CAAC;AAEH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/model/datastore/views/filters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAI3B,0BAA0B;AAC1B,eAAO,MAAM,mBAAmB;;iBAE9B,CAAC;AAEH,2BAA2B;AAC3B,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH,iCAAiC;AACjC,eAAO,MAAM,sBAAsB;;iBAEjC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;iBAGxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,yBAAyB;;;;;;iBAMpC,CAAC;AAEH,0CAA0C;AAC1C,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AAEH,yCAAyC;AACzC,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAOjD,CAAC;AAEH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/src/lib/model/datastore/views/query.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod/v4';
+/** Access role granted to a user or group on a view. */
 export declare const ViewAccessRoleSchema: z.ZodEnum<{
     "read-only": "read-only";
     "read-write": "read-write";
@@ -46,6 +47,7 @@ export declare const ViewSpecsSchema: z.ZodObject<{
     }, z.core.$loose>>;
 }, z.core.$loose>;
 export type ViewSpecs = z.infer<typeof ViewSpecsSchema>;
+/** Product that owns the view. */
 export declare const ViewOwnerSchema: z.ZodEnum<{
     OI: "OI";
     APM: "APM";

package/dist/src/lib/model/datastore/views/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/model/datastore/views/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAK3B,eAAO,MAAM,oBAAoB;;;EAAsC,CAAC;AAExE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,qBAAqB;;;;;;iBAGhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;iBAG3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,iBAAiB;;iBAE5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,kBAAkB;;iBAE7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,eAAe;;;;;;;iBAG1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,eAAe;;;;EAA8B,CAAC;AAE3D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,oBAAoB;;;;;;;;iBAI/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,2BAA2B;;;iBAGtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,uBAAuB;;;;;iBAKlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,sBAAsB;;iBAEjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/model/datastore/views/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAK3B,wDAAwD;AACxD,eAAO,MAAM,oBAAoB;;;EAEY,CAAC;AAE9C,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,qBAAqB;;;;;;iBAGhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;iBAG3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,iBAAiB;;iBAE5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,kBAAkB;;iBAE7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,eAAe;;;;;;;iBAG1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,kCAAkC;AAClC,eAAO,MAAM,eAAe;;;;EAEe,CAAC;AAE5C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,oBAAoB;;;;;;;;iBAI/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,2BAA2B;;;iBAMtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,uBAAuB;;;;;iBAKlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,sBAAsB;;iBAEjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/src/lib/model/datastore/views/response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/model/datastore/views/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAQ3B,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA8B,CAAC;AAElE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAElC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,0BAA0B;;;iBAKrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/model/datastore/views/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAQ3B,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAEa,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAElC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,0BAA0B;;;iBAMrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/src/lib/model/log/ingest.d.ts

@@ -1,26 +1,18 @@
+import { z } from 'zod/v4';
 export declare namespace LogIngest {
-    interface LogIngestOptions {
-        /** Log type — matched against the tenant's configured log types (default: `"generic"`). */
-        logtype?: string;
-        /** Host name (default: auto-detected via `os.hostname()`). */
-        host?: string;
-        /** Log message text. */
-        message: string;
-        /** ISO 8601 timestamp (default: now). */
-        timestamp?: string;
-        /** Agent name sent as `__agent_name` (default: `"Logs Collector"`). */
-        agentName?: string;
-        /** Agent instance identifier sent as `__agent_instance` (default: `"dx-do"`). */
-        agentInstance?: string;
-        /** Container ID for the log entry (default: same as host). */
-        containerId?: string;
-        /** Container name for the log entry (default: same as agentInstance). */
-        containerName?: string;
-        /** Source file label (default: `"dx-do.cli"`). */
-        file?: string;
-        /** Source IP address (default: first non-loopback IPv4, falls back to `"127.0.0.1"`). */
-        ip?: string;
-    }
+    const LogIngestOptionsSchema: z.ZodObject<{
+        logtype: z.ZodOptional<z.ZodString>;
+        host: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        timestamp: z.ZodOptional<z.ZodString>;
+        agentName: z.ZodOptional<z.ZodString>;
+        agentInstance: z.ZodOptional<z.ZodString>;
+        containerId: z.ZodOptional<z.ZodString>;
+        containerName: z.ZodOptional<z.ZodString>;
+        file: z.ZodOptional<z.ZodString>;
+        ip: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    type LogIngestOptions = z.infer<typeof LogIngestOptionsSchema>;
     /** @deprecated Use {@link LogIngestOptions} with a separate `additionalFields` argument. */
     interface LogEntry {
         logtype: string;

package/dist/src/lib/model/log/ingest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../../../../src/lib/model/log/ingest.ts"],"names":[],"mappings":"AAAA,yBAAiB,SAAS,CAAC;IACzB,UAAiB,gBAAgB;QAC/B,2FAA2F;QAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,8DAA8D;QAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,wBAAwB;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,yCAAyC;QACzC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,uEAAuE;QACvE,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,iFAAiF;QACjF,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,8DAA8D;QAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,yEAAyE;QACzE,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,kDAAkD;QAClD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,yFAAyF;QACzF,EAAE,CAAC,EAAE,MAAM,CAAC;KACb;IAED,4FAA4F;IAC5F,UAAiB,QAAQ;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB;CACF"}
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../../../../src/lib/model/log/ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,yBAAiB,SAAS,CAAC;IAClB,MAAM,sBAAsB;;;;;;;;;;;qBA0CjC,CAAC;IAEH,KAAY,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;IAEtE,4FAA4F;IAC5F,UAAiB,QAAQ;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB;CACF"}

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

@@ -36,6 +36,12 @@ export declare class DataStoreNASSService {
      * @param values - Array of {@link NassDatapoint} tuples. Each tuple must
      *   begin with a registered metric ID obtained from
      *   {@link DataStoreMetricsMetadataService.registerMetric}.
+     *
+     * @remarks The request is validated against {@link NassStoreRequestSchema}.
+     *   If the response fails schema validation, a warning is logged but the raw
+     *   API response is still returned.
+     *
+     * @throws ZodError if any datapoint fails schema validation.
      */
     storeMetricValues(values: NassDatapoint[]): Promise<NassStoreResponse>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"datastore-nass.service.d.ts","sourceRoot":"","sources":["../../../../../src/lib/services/datastore/datastore-nass.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EACV,aAAa,EAEb,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,SAAS;IAGjC;;;;;;OAMG;IACG,iBAAiB,CACrB,MAAM,EAAE,aAAa,EAAE,GACtB,OAAO,CAAC,iBAAiB,CAAC;CAO9B"}
+{"version":3,"file":"datastore-nass.service.d.ts","sourceRoot":"","sources":["../../../../../src/lib/services/datastore/datastore-nass.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKnD,OAAO,KAAK,EACV,aAAa,EAEb,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,SAAS;IAGjC;;;;;;;;;;;;OAYG;IACG,iBAAiB,CACrB,MAAM,EAAE,aAAa,EAAE,GACtB,OAAO,CAAC,iBAAiB,CAAC;CAgB9B"}

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

@@ -13,14 +13,29 @@ export declare class LogsService {
     /**
      * Builds the enriched payload object for a single log entry.
      *
-     * @param options - Known log entry fields (all optional with sensible defaults).
+     * @remarks `options` is validated against
+     *   {@link LogIngest.LogIngestOptionsSchema} before the payload is assembled.
+     * @param options - Known log entry fields (`message` required; the rest
+     *   optional with sensible defaults).
      * @param additionalFields - Arbitrary extra fields to include in the indexed document.
      * @returns The payload object ready to POST to the uim_logs ingestion endpoint.
+     * @throws ZodError if `options` fails schema validation.
      */
     buildLogPayload(options: LogIngest.LogIngestOptions, additionalFields?: Record<string, unknown>): unknown;
-    /** Ingests a single log entry into the log gateway. */
+    /**
+     * Ingests a single log entry into the log gateway.
+     *
+     * @remarks The gateway returns an opaque ingestion acknowledgement with no
+     *   stable schema, so the response is intentionally typed `unknown` and not
+     *   validated. `options` is validated by {@link buildLogPayload}.
+     */
     ingestLog(options: LogIngest.LogIngestOptions, additionalFields?: Record<string, unknown>): Promise<unknown>;
-    /** Ingests a batch of log entries into the log gateway. */
+    /**
+     * Ingests a batch of log entries into the log gateway.
+     *
+     * @remarks Each entry's `options` is validated by {@link buildLogPayload}.
+     *   The gateway response is an opaque ack (typed `unknown`, not validated).
+     */
     ingestLogs(entries: Array<{
         options: LogIngest.LogIngestOptions;
         additionalFields?: Record<string, unknown>;

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

@@ -1 +1 @@
-{"version":3,"file":"logs.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/logs.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAehD;;GAEG;AACH,qBAAa,WAAW;IAEV,OAAO,CAAC,QAAQ,CAAC,aAAa;IAD1C,iDAAiD;gBACpB,aAAa,EAAE,aAAa;IAEzD,oEAAoE;IAC7D,SAAS,CAAC,YAAY,EAAE,QAAQ,CAAC,mBAAmB;IAO3D;;;;;;OAMG;IACI,eAAe,CACpB,OAAO,EAAE,SAAS,CAAC,gBAAgB,EACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,OAAO;IAuCV,uDAAuD;IAChD,SAAS,CACd,OAAO,EAAE,SAAS,CAAC,gBAAgB,EACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,OAAO,CAAC,OAAO,CAAC;IAOnB,2DAA2D;IACpD,UAAU,CACf,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,SAAS,CAAC,gBAAgB,CAAC;QACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC5C,CAAC,GACD,OAAO,CAAC,OAAO,CAAC;CAMpB"}
+{"version":3,"file":"logs.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/logs.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAehD;;GAEG;AACH,qBAAa,WAAW;IAEV,OAAO,CAAC,QAAQ,CAAC,aAAa;IAD1C,iDAAiD;gBACpB,aAAa,EAAE,aAAa;IAEzD,oEAAoE;IAC7D,SAAS,CAAC,YAAY,EAAE,QAAQ,CAAC,mBAAmB;IAO3D;;;;;;;;;;OAUG;IACI,eAAe,CACpB,OAAO,EAAE,SAAS,CAAC,gBAAgB,EACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,OAAO;IAwCV;;;;;;OAMG;IACI,SAAS,CACd,OAAO,EAAE,SAAS,CAAC,gBAAgB,EACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,OAAO,CAAC,OAAO,CAAC;IAOnB;;;;;OAKG;IACI,UAAU,CACf,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,SAAS,CAAC,gBAAgB,CAAC;QACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC5C,CAAC,GACD,OAAO,CAAC,OAAO,CAAC;CAMpB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dx-do/client",
-  "version": "6.1.1",
+  "version": "6.2.1",
   "description": "Opinionated TS client library for DX O2",
   "author": "Ki Alam",
   "logo": {