@cdot65/prisma-airs-sdk 0.22.0 → 0.24.0

package/README.md

@@ -101,6 +101,8 @@ Experimental runtime methods also model image/audio/moderation/rerank/OCR, legac
 
 Secret-reference CRUD is verified using owned, unbound synthetic references; external secret resolution is not certified. See the [captured lifecycle output](docs-site/docs/guides/examples.mdx#secret-reference-management-lifecycle). Portkey compatibility remains partial; retired upstream endpoints and tenant-unverified families stay visible in the [complete operation ledger](docs-site/docs/developer/gateway-coverage.md).
 
+Request, cost, token and latency charts accept verified trace/metadata filters, status-code/API-key/provider-model lists and inclusive total-token/cost bounds. List members match with OR; distinct filters combine with AND. Cost bounds are in cents. Empty latency aggregates remain `null`, not measured zero. Unknown filters are rejected before authentication; the SCM query names differ from upstream Portkey. See the [typed telemetry contract](docs-site/docs/guides/ai-gateway-api.mdx#charts).
+
 All AI Gateway write bodies have exported Zod schemas and inferred TypeScript types. Validation
 happens before OAuth and network access; documented nonempty-update requirements are enforced. The package also
 exports typed routing/provider configuration, deterministic known-value catalogs,

package/dist/index.cjs

@@ -22,6 +22,7 @@ var index_exports = {};
 __export(index_exports, {
   AIGatewayApiKeysClient: () => AIGatewayApiKeysClient,
   AIGatewayAuditLogsClient: () => AIGatewayAuditLogsClient,
+  AIGatewayChartFiltersSchema: () => AIGatewayChartFiltersSchema,
   AIGatewayClient: () => AIGatewayClient,
   AIGatewayConfigsClient: () => AIGatewayConfigsClient,
   AIGatewayDeploymentsClient: () => AIGatewayDeploymentsClient,
@@ -1357,7 +1358,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";
@@ -6343,10 +6344,10 @@ var LatencyChartResponseSchema = aiGatewayEnvelope(
         p99: import_zod42.z.number()
       }).passthrough()
     ),
-    total: import_zod42.z.number(),
-    p50: import_zod42.z.number(),
-    p90: import_zod42.z.number(),
-    p99: import_zod42.z.number(),
+    total: import_zod42.z.number().nullable(),
+    p50: import_zod42.z.number().nullable(),
+    p90: import_zod42.z.number().nullable(),
+    p99: import_zod42.z.number().nullable(),
     ...quotaFlag
   }).passthrough()
 );
@@ -17957,10 +17958,34 @@ var logsOptionsSchema = telemetryWindowSchema.extend({
   traceId: nonBlankString.optional(),
   statusCode: import_zod54.z.number().int().nonnegative().safe().optional()
 }).strict();
-var requestChartOptionsSchema = telemetryWindowSchema.extend({
+var chartFilterFields = {
   traceId: nonBlankString.optional(),
-  metadata: GatewayJsonObjectSchema.pipe(import_zod54.z.record(import_zod54.z.string())).optional()
-}).strict();
+  metadata: GatewayJsonObjectSchema.pipe(import_zod54.z.record(import_zod54.z.string())).optional(),
+  statusCodes: import_zod54.z.array(import_zod54.z.number().int().nonnegative().safe()).nonempty().optional(),
+  apiKeyIds: import_zod54.z.array(import_zod54.z.string().uuid()).nonempty().optional(),
+  aiOrgModels: import_zod54.z.array(import_zod54.z.string().regex(/^[^,\s]+__[^,\s]+$/)).nonempty().optional(),
+  totalUnitsMin: import_zod54.z.number().int().nonnegative().safe().optional(),
+  totalUnitsMax: import_zod54.z.number().int().nonnegative().safe().optional(),
+  costMin: import_zod54.z.number().finite().nonnegative().optional(),
+  costMax: import_zod54.z.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 = import_zod54.z.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;
@@ -17986,7 +18011,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
@@ -17998,11 +18023,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
@@ -18014,15 +18044,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';
@@ -18033,11 +18066,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
@@ -18049,7 +18087,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.
@@ -22603,6 +22646,7 @@ function setDottedValue(input, path, value2) {
 0 && (module.exports = {
   AIGatewayApiKeysClient,
   AIGatewayAuditLogsClient,
+  AIGatewayChartFiltersSchema,
   AIGatewayClient,
   AIGatewayConfigsClient,
   AIGatewayDeploymentsClient,