@cdot65/prisma-airs-sdk 0.22.0 → 0.24.0

package/dist/index.js

@@ -29,7 +29,7 @@ var MAX_NUMBER_OF_BATCH_SCAN_OBJECTS = 20;
 var MAX_CONNECTION_POOL_SIZE = 100;
 var MAX_NUMBER_OF_RETRIES = 5;
 var HTTP_FORCE_RETRY_STATUS_CODES = [500, 502, 503, 504];
-var SDK_VERSION = "0.22.0";
+var SDK_VERSION = "0.24.0";
 var USER_AGENT = `PAN-AIRS/${SDK_VERSION}-typescript-sdk`;
 var DEFAULT_MGMT_ENDPOINT = "https://api.sase.paloaltonetworks.com/aisec";
 var DEFAULT_TOKEN_ENDPOINT = "https://auth.apps.paloaltonetworks.com/oauth2/access_token";
@@ -5015,10 +5015,10 @@ var LatencyChartResponseSchema = aiGatewayEnvelope(
         p99: z42.number()
       }).passthrough()
     ),
-    total: z42.number(),
-    p50: z42.number(),
-    p90: z42.number(),
-    p99: z42.number(),
+    total: z42.number().nullable(),
+    p50: z42.number().nullable(),
+    p90: z42.number().nullable(),
+    p99: z42.number().nullable(),
     ...quotaFlag
   }).passthrough()
 );
@@ -16629,10 +16629,34 @@ var logsOptionsSchema = telemetryWindowSchema.extend({
   traceId: nonBlankString.optional(),
   statusCode: z54.number().int().nonnegative().safe().optional()
 }).strict();
-var requestChartOptionsSchema = telemetryWindowSchema.extend({
+var chartFilterFields = {
   traceId: nonBlankString.optional(),
-  metadata: GatewayJsonObjectSchema.pipe(z54.record(z54.string())).optional()
-}).strict();
+  metadata: GatewayJsonObjectSchema.pipe(z54.record(z54.string())).optional(),
+  statusCodes: z54.array(z54.number().int().nonnegative().safe()).nonempty().optional(),
+  apiKeyIds: z54.array(z54.string().uuid()).nonempty().optional(),
+  aiOrgModels: z54.array(z54.string().regex(/^[^,\s]+__[^,\s]+$/)).nonempty().optional(),
+  totalUnitsMin: z54.number().int().nonnegative().safe().optional(),
+  totalUnitsMax: z54.number().int().nonnegative().safe().optional(),
+  costMin: z54.number().finite().nonnegative().optional(),
+  costMax: z54.number().finite().nonnegative().optional()
+};
+function validChartBounds(opts) {
+  return (opts.totalUnitsMin === void 0 || opts.totalUnitsMax === void 0 || opts.totalUnitsMin <= opts.totalUnitsMax) && (opts.costMin === void 0 || opts.costMax === void 0 || opts.costMin <= opts.costMax);
+}
+var AIGatewayChartFiltersSchema = z54.object(chartFilterFields).strict().refine(validChartBounds);
+var filteredChartOptionsSchema = telemetryWindowSchema.extend(chartFilterFields).strict().refine(validChartBounds);
+function serializeChartOptions(tsgId, opts) {
+  const params = serializeWindow(tsgId, opts, filteredChartOptionsSchema);
+  if (opts.traceId !== void 0) params.traceId = opts.traceId;
+  if (opts.metadata !== void 0) params.metadata = JSON.stringify(opts.metadata);
+  if (opts.statusCodes !== void 0) params.statusCode = opts.statusCodes.join(",");
+  if (opts.apiKeyIds !== void 0) params.apiKeyIds = opts.apiKeyIds.join(",");
+  if (opts.aiOrgModels !== void 0) params.aiOrgModel = opts.aiOrgModels.join(",");
+  for (const key of ["totalUnitsMin", "totalUnitsMax", "costMin", "costMax"]) {
+    if (opts[key] !== void 0) params[key] = String(opts[key]);
+  }
+  return params;
+}
 var AIGatewayTelemetryClient = class {
   baseUrl;
   auth;
@@ -16658,7 +16682,7 @@ var AIGatewayTelemetryClient = class {
   }
   /**
    * Total and per-day spend. **Values are in cents.**
-   * @param opts - Workspace slug and time window.
+   * @param opts - Workspace slug, time window and verified trace, metadata, list and range filters.
    * @returns Cost series plus the period total, in cents.
    * @example
    * ```ts
@@ -16670,11 +16694,16 @@ var AIGatewayTelemetryClient = class {
    * ```
    */
   async cost(opts) {
-    return this.chart("cost", opts, CostChartResponseSchema);
+    return this.chart(
+      "cost",
+      opts,
+      CostChartResponseSchema,
+      serializeChartOptions(this.tsgId, opts)
+    );
   }
   /**
    * Per-day request counts.
-   * @param opts - Workspace slug, time window and optional verified trace/metadata filters.
+   * @param opts - Workspace slug, time window and verified trace, metadata, list and range filters.
    * @returns Request-count series plus the filtered period total.
    * @example
    * ```ts
@@ -16686,15 +16715,18 @@ var AIGatewayTelemetryClient = class {
    * ```
    */
   async requests(opts) {
-    const params = serializeWindow(this.tsgId, opts, requestChartOptionsSchema);
-    if (opts.traceId !== void 0) params.traceId = opts.traceId;
-    if (opts.metadata !== void 0) params.metadata = JSON.stringify(opts.metadata);
-    return this.chart("requests", opts, CountChartResponseSchema, params);
+    return this.chart(
+      "requests",
+      opts,
+      CountChartResponseSchema,
+      serializeChartOptions(this.tsgId, opts)
+    );
   }
   /**
    * Latency in milliseconds. Percentiles are returned per-bucket and for the period.
-   * @param opts - Workspace slug and time window.
+   * @param opts - Workspace slug, time window and verified trace, metadata, list and range filters.
    * @returns Latency series with p50/p90/p99; `data.total` is the period mean, not a sum.
+   * The period mean and percentiles are null when the cohort has no matching requests.
    * @example
    * ```ts
    * import { AIGatewayClient } from '@cdot65/prisma-airs-sdk';
@@ -16705,11 +16737,16 @@ var AIGatewayTelemetryClient = class {
    * ```
    */
   async latency(opts) {
-    return this.chart("latency", opts, LatencyChartResponseSchema);
+    return this.chart(
+      "latency",
+      opts,
+      LatencyChartResponseSchema,
+      serializeChartOptions(this.tsgId, opts)
+    );
   }
   /**
    * Token usage, split into request and response units.
-   * @param opts - Workspace slug and time window.
+   * @param opts - Workspace slug, time window and verified trace, metadata, list and range filters.
    * @returns Token series plus request/response unit totals.
    * @example
    * ```ts
@@ -16721,7 +16758,12 @@ var AIGatewayTelemetryClient = class {
    * ```
    */
   async tokens(opts) {
-    return this.chart("tokens", opts, TokensChartResponseSchema);
+    return this.chart(
+      "tokens",
+      opts,
+      TokensChartResponseSchema,
+      serializeChartOptions(this.tsgId, opts)
+    );
   }
   /**
    * Per-day error counts.
@@ -21274,6 +21316,7 @@ function setDottedValue(input, path, value2) {
 export {
   AIGatewayApiKeysClient,
   AIGatewayAuditLogsClient,
+  AIGatewayChartFiltersSchema,
   AIGatewayClient,
   AIGatewayConfigsClient,
   AIGatewayDeploymentsClient,