@cdot65/prisma-airs-sdk 0.23.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.23.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";
@@ -17957,14 +17958,32 @@ var logsOptionsSchema = telemetryWindowSchema.extend({
   traceId: nonBlankString.optional(),
   statusCode: import_zod54.z.number().int().nonnegative().safe().optional()
 }).strict();
-var filteredChartOptionsSchema = 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 {
@@ -17992,7 +18011,7 @@ var AIGatewayTelemetryClient = class {
   }
   /**
    * Total and per-day spend. **Values are in cents.**
-   * @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 Cost series plus the period total, in cents.
    * @example
    * ```ts
@@ -18013,7 +18032,7 @@ var AIGatewayTelemetryClient = class {
   }
   /**
    * 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
@@ -18034,7 +18053,7 @@ var AIGatewayTelemetryClient = class {
   }
   /**
    * Latency in milliseconds. Percentiles are returned per-bucket and for the period.
-   * @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 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
@@ -18056,7 +18075,7 @@ var AIGatewayTelemetryClient = class {
   }
   /**
    * Token usage, split into request and response units.
-   * @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 Token series plus request/response unit totals.
    * @example
    * ```ts
@@ -22627,6 +22646,7 @@ function setDottedValue(input, path, value2) {
 0 && (module.exports = {
   AIGatewayApiKeysClient,
   AIGatewayAuditLogsClient,
+  AIGatewayChartFiltersSchema,
   AIGatewayClient,
   AIGatewayConfigsClient,
   AIGatewayDeploymentsClient,