@cdot65/prisma-airs-sdk 0.24.0 → 0.25.0

package/dist/index.d.cts

@@ -154351,8 +154351,8 @@ declare const MAX_NUMBER_OF_BATCH_SCAN_OBJECTS = 20;
 declare const MAX_CONNECTION_POOL_SIZE = 100;
 declare const MAX_NUMBER_OF_RETRIES = 5;
 declare const HTTP_FORCE_RETRY_STATUS_CODES: number[];
-declare const SDK_VERSION = "0.24.0";
-declare const USER_AGENT = "PAN-AIRS/0.24.0-typescript-sdk";
+declare const SDK_VERSION = "0.25.0";
+declare const USER_AGENT = "PAN-AIRS/0.25.0-typescript-sdk";
 declare const DEFAULT_MGMT_ENDPOINT = "https://api.sase.paloaltonetworks.com/aisec";
 declare const DEFAULT_TOKEN_ENDPOINT = "https://auth.apps.paloaltonetworks.com/oauth2/access_token";
 declare const MGMT_CLIENT_ID = "PANW_MGMT_CLIENT_ID";
@@ -158897,7 +158897,7 @@ interface AIGatewayWindowOptions {
 }
 
 /**
- * Standalone verified chart-filter validation, without workspace resolution or authentication.
+ * Standalone verified chart/group filter validation, without workspace resolution or authentication.
  * Shared by the SDK transport and CLI input adapters; excludes time-window and workspace fields.
  * Cost bounds use cents. Lists use OR, distinct filters use AND, and bounds are inclusive.
  * @example
@@ -158958,7 +158958,7 @@ declare const AIGatewayChartFiltersSchema: z.ZodEffects<z.ZodObject<{
     costMin?: number | undefined;
     costMax?: number | undefined;
 }>;
-/** Validated filters shared by the request, cost, token and latency charts. */
+/** Validated filters shared by four charts and all six grouped analytics endpoints. */
 type AIGatewayChartFilters = z.infer<typeof AIGatewayChartFiltersSchema>;
 /** @internal */
 interface AIGatewayTelemetryClientOptions {
@@ -158968,7 +158968,7 @@ interface AIGatewayTelemetryClientOptions {
     tsgId: string;
 }
 /** Options for a `logs/groups/{dimension}` query. */
-interface AIGatewayGroupOptions extends AIGatewayWindowOptions {
+interface AIGatewayGroupOptions extends AIGatewayChartOptions {
     /**
      * Extra columns to aggregate. The SDK rejects unsupported names before I/O; the API would
      * silently drop them. See {@link AI_GW_GROUP_COLUMNS} for the valid set.
@@ -158976,7 +158976,9 @@ interface AIGatewayGroupOptions extends AIGatewayWindowOptions {
     columns?: (typeof AI_GW_GROUP_COLUMNS)[number][];
 }
 /**
- * Verified SCM filters for requests, cost, tokens and latency charts only.
+ * Verified SCM filters for requests, cost, tokens and latency charts, and grouped analytics.
+ * The historical chart-options name is retained for compatibility. Other charts still accept
+ * only time-window options; user grouping accepts these filters but not extra columns.
  * Members of each list match with OR; distinct supplied filters combine with AND.
  * Total-token and cost ranges are inclusive. Cost bounds are in cents, not dollars.
  * These are partial adapters, not the complete upstream analytics query contract.
@@ -159262,7 +159264,7 @@ declare class AIGatewayTelemetryClient {
     /**
      * Aggregate requests by a dimension.
      * @param dimension - One of {@link AI_GW_GROUP_DIMENSIONS}. Underscore names only.
-     * @param opts - Window plus optional extra columns.
+     * @param opts - Window, verified trace/metadata/list/range filters, and optional extra columns.
      * @returns One row per distinct dimension value.
      * @example
      * ```ts
@@ -159279,7 +159281,7 @@ declare class AIGatewayTelemetryClient {
     groupBy(dimension: (typeof AI_GW_GROUP_DIMENSIONS)[number], opts: AIGatewayGroupOptions): Promise<GroupListResponse>;
     /**
      * Requests and cost per end user.
-     * @param opts - Workspace slug and time window.
+     * @param opts - Workspace slug, time window and verified trace/metadata/list/range filters.
      * @returns One record per user; `_user: ''` means calls with no end-user id. Costs in cents.
      * @example
      * ```ts
@@ -159290,10 +159292,10 @@ declare class AIGatewayTelemetryClient {
      * // users.data.records[0] => { _user: '', count: 25748, cost: 411060.85 }
      * ```
      */
-    byUser(opts: AIGatewayWindowOptions): Promise<UserGroupResponse>;
+    byUser(opts: AIGatewayChartOptions): Promise<UserGroupResponse>;
     /**
      * Requests grouped by HTTP status code.
-     * @param opts - Window plus optional extra columns.
+     * @param opts - Window, verified trace/metadata/list/range filters, and optional extra columns.
      * @returns One row per status. **446 = AIRS security block** (cost 0, never reached the LLM).
      * @example
      * ```ts

package/dist/index.d.ts

@@ -154351,8 +154351,8 @@ declare const MAX_NUMBER_OF_BATCH_SCAN_OBJECTS = 20;
 declare const MAX_CONNECTION_POOL_SIZE = 100;
 declare const MAX_NUMBER_OF_RETRIES = 5;
 declare const HTTP_FORCE_RETRY_STATUS_CODES: number[];
-declare const SDK_VERSION = "0.24.0";
-declare const USER_AGENT = "PAN-AIRS/0.24.0-typescript-sdk";
+declare const SDK_VERSION = "0.25.0";
+declare const USER_AGENT = "PAN-AIRS/0.25.0-typescript-sdk";
 declare const DEFAULT_MGMT_ENDPOINT = "https://api.sase.paloaltonetworks.com/aisec";
 declare const DEFAULT_TOKEN_ENDPOINT = "https://auth.apps.paloaltonetworks.com/oauth2/access_token";
 declare const MGMT_CLIENT_ID = "PANW_MGMT_CLIENT_ID";
@@ -158897,7 +158897,7 @@ interface AIGatewayWindowOptions {
 }
 
 /**
- * Standalone verified chart-filter validation, without workspace resolution or authentication.
+ * Standalone verified chart/group filter validation, without workspace resolution or authentication.
  * Shared by the SDK transport and CLI input adapters; excludes time-window and workspace fields.
  * Cost bounds use cents. Lists use OR, distinct filters use AND, and bounds are inclusive.
  * @example
@@ -158958,7 +158958,7 @@ declare const AIGatewayChartFiltersSchema: z.ZodEffects<z.ZodObject<{
     costMin?: number | undefined;
     costMax?: number | undefined;
 }>;
-/** Validated filters shared by the request, cost, token and latency charts. */
+/** Validated filters shared by four charts and all six grouped analytics endpoints. */
 type AIGatewayChartFilters = z.infer<typeof AIGatewayChartFiltersSchema>;
 /** @internal */
 interface AIGatewayTelemetryClientOptions {
@@ -158968,7 +158968,7 @@ interface AIGatewayTelemetryClientOptions {
     tsgId: string;
 }
 /** Options for a `logs/groups/{dimension}` query. */
-interface AIGatewayGroupOptions extends AIGatewayWindowOptions {
+interface AIGatewayGroupOptions extends AIGatewayChartOptions {
     /**
      * Extra columns to aggregate. The SDK rejects unsupported names before I/O; the API would
      * silently drop them. See {@link AI_GW_GROUP_COLUMNS} for the valid set.
@@ -158976,7 +158976,9 @@ interface AIGatewayGroupOptions extends AIGatewayWindowOptions {
     columns?: (typeof AI_GW_GROUP_COLUMNS)[number][];
 }
 /**
- * Verified SCM filters for requests, cost, tokens and latency charts only.
+ * Verified SCM filters for requests, cost, tokens and latency charts, and grouped analytics.
+ * The historical chart-options name is retained for compatibility. Other charts still accept
+ * only time-window options; user grouping accepts these filters but not extra columns.
  * Members of each list match with OR; distinct supplied filters combine with AND.
  * Total-token and cost ranges are inclusive. Cost bounds are in cents, not dollars.
  * These are partial adapters, not the complete upstream analytics query contract.
@@ -159262,7 +159264,7 @@ declare class AIGatewayTelemetryClient {
     /**
      * Aggregate requests by a dimension.
      * @param dimension - One of {@link AI_GW_GROUP_DIMENSIONS}. Underscore names only.
-     * @param opts - Window plus optional extra columns.
+     * @param opts - Window, verified trace/metadata/list/range filters, and optional extra columns.
      * @returns One row per distinct dimension value.
      * @example
      * ```ts
@@ -159279,7 +159281,7 @@ declare class AIGatewayTelemetryClient {
     groupBy(dimension: (typeof AI_GW_GROUP_DIMENSIONS)[number], opts: AIGatewayGroupOptions): Promise<GroupListResponse>;
     /**
      * Requests and cost per end user.
-     * @param opts - Workspace slug and time window.
+     * @param opts - Workspace slug, time window and verified trace/metadata/list/range filters.
      * @returns One record per user; `_user: ''` means calls with no end-user id. Costs in cents.
      * @example
      * ```ts
@@ -159290,10 +159292,10 @@ declare class AIGatewayTelemetryClient {
      * // users.data.records[0] => { _user: '', count: 25748, cost: 411060.85 }
      * ```
      */
-    byUser(opts: AIGatewayWindowOptions): Promise<UserGroupResponse>;
+    byUser(opts: AIGatewayChartOptions): Promise<UserGroupResponse>;
     /**
      * Requests grouped by HTTP status code.
-     * @param opts - Window plus optional extra columns.
+     * @param opts - Window, verified trace/metadata/list/range filters, and optional extra columns.
      * @returns One row per status. **446 = AIRS security block** (cost 0, never reached the LLM).
      * @example
      * ```ts

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.24.0";
+var SDK_VERSION = "0.25.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";
@@ -16606,24 +16606,27 @@ function toOffsetIso(d) {
   return `${String(d.getFullYear()).padStart(4, "0")}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}T${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}${sign}${pad(offsetMin / 60)}:${pad(offsetMin % 60)}`;
 }
 function serializeWindow(tsgId, opts, schema = telemetryWindowSchema) {
+  return serializeWindowWithOptions(tsgId, opts, schema).params;
+}
+function serializeWindowWithOptions(tsgId, opts, schema) {
   const result = schema.safeParse(opts);
   if (!result.success || typeof tsgId !== "string" || !/^\d+$/.test(tsgId)) invalidWindow();
   const end = result.data.end ?? /* @__PURE__ */ new Date();
   const start = result.data.start ?? new Date(end.getTime() - (result.data.days ?? 7) * 864e5);
   if (start.getTime() > end.getTime()) invalidWindow();
   return {
-    organisationId: tsgId,
-    workspaceSlug: result.data.workspaceSlug,
-    timeOfGenerationMin: toOffsetIso(start),
-    timeOfGenerationMax: toOffsetIso(end)
+    options: result.data,
+    params: {
+      organisationId: tsgId,
+      workspaceSlug: result.data.workspaceSlug,
+      timeOfGenerationMin: toOffsetIso(start),
+      timeOfGenerationMax: toOffsetIso(end)
+    }
   };
 }
 
 // src/ai-gateway/telemetry-client.ts
 var nonBlankString = z54.string().min(1).refine((value2) => value2.trim().length > 0);
-var groupOptionsSchema = telemetryWindowSchema.extend({
-  columns: z54.array(z54.enum(AI_GW_GROUP_COLUMNS)).optional()
-}).strict();
 var logsOptionsSchema = telemetryWindowSchema.extend({
   pageSize: z54.number().int().nonnegative().safe().optional(),
   traceId: nonBlankString.optional(),
@@ -16645,8 +16648,12 @@ function validChartBounds(opts) {
 }
 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);
+var groupOptionsSchema = telemetryWindowSchema.extend({
+  ...chartFilterFields,
+  columns: z54.array(z54.enum(AI_GW_GROUP_COLUMNS)).optional()
+}).strict().refine(validChartBounds);
+function serializeFilteredOptions(tsgId, input, schema = filteredChartOptionsSchema) {
+  const { params, options: opts } = serializeWindowWithOptions(tsgId, input, schema);
   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(",");
@@ -16655,6 +16662,7 @@ function serializeChartOptions(tsgId, opts) {
   for (const key of ["totalUnitsMin", "totalUnitsMax", "costMin", "costMax"]) {
     if (opts[key] !== void 0) params[key] = String(opts[key]);
   }
+  if (opts.columns?.length) params.columns = opts.columns.join(",");
   return params;
 }
 var AIGatewayTelemetryClient = class {
@@ -16698,7 +16706,7 @@ var AIGatewayTelemetryClient = class {
       "cost",
       opts,
       CostChartResponseSchema,
-      serializeChartOptions(this.tsgId, opts)
+      serializeFilteredOptions(this.tsgId, opts)
     );
   }
   /**
@@ -16719,7 +16727,7 @@ var AIGatewayTelemetryClient = class {
       "requests",
       opts,
       CountChartResponseSchema,
-      serializeChartOptions(this.tsgId, opts)
+      serializeFilteredOptions(this.tsgId, opts)
     );
   }
   /**
@@ -16741,7 +16749,7 @@ var AIGatewayTelemetryClient = class {
       "latency",
       opts,
       LatencyChartResponseSchema,
-      serializeChartOptions(this.tsgId, opts)
+      serializeFilteredOptions(this.tsgId, opts)
     );
   }
   /**
@@ -16762,7 +16770,7 @@ var AIGatewayTelemetryClient = class {
       "tokens",
       opts,
       TokensChartResponseSchema,
-      serializeChartOptions(this.tsgId, opts)
+      serializeFilteredOptions(this.tsgId, opts)
     );
   }
   /**
@@ -16946,7 +16954,7 @@ var AIGatewayTelemetryClient = class {
   /**
    * Aggregate requests by a dimension.
    * @param dimension - One of {@link AI_GW_GROUP_DIMENSIONS}. Underscore names only.
-   * @param opts - Window plus optional extra columns.
+   * @param opts - Window, verified trace/metadata/list/range filters, and optional extra columns.
    * @returns One row per distinct dimension value.
    * @example
    * ```ts
@@ -16966,8 +16974,7 @@ var AIGatewayTelemetryClient = class {
         "Invalid telemetry grouping dimension",
         "AISEC_USER_REQUEST_PAYLOAD_ERROR" /* USER_REQUEST_PAYLOAD_ERROR */
       );
-    const params = serializeWindow(this.tsgId, opts, groupOptionsSchema);
-    if (opts.columns?.length) params.columns = opts.columns.join(",");
+    const params = serializeFilteredOptions(this.tsgId, opts, groupOptionsSchema);
     return request({
       method: "GET",
       baseUrl: this.baseUrl,
@@ -16980,7 +16987,7 @@ var AIGatewayTelemetryClient = class {
   }
   /**
    * Requests and cost per end user.
-   * @param opts - Workspace slug and time window.
+   * @param opts - Workspace slug, time window and verified trace/metadata/list/range filters.
    * @returns One record per user; `_user: ''` means calls with no end-user id. Costs in cents.
    * @example
    * ```ts
@@ -16996,7 +17003,7 @@ var AIGatewayTelemetryClient = class {
       method: "GET",
       baseUrl: this.baseUrl,
       path: `${AI_GW_GROUPS_PATH}/users`,
-      params: serializeWindow(this.tsgId, opts),
+      params: serializeFilteredOptions(this.tsgId, opts),
       responseSchema: UserGroupResponseSchema,
       auth: this.auth,
       numRetries: this.numRetries
@@ -17004,7 +17011,7 @@ var AIGatewayTelemetryClient = class {
   }
   /**
    * Requests grouped by HTTP status code.
-   * @param opts - Window plus optional extra columns.
+   * @param opts - Window, verified trace/metadata/list/range filters, and optional extra columns.
    * @returns One row per status. **446 = AIRS security block** (cost 0, never reached the LLM).
    * @example
    * ```ts
@@ -17019,8 +17026,7 @@ var AIGatewayTelemetryClient = class {
    * ```
    */
   async byStatusCode(opts) {
-    const params = serializeWindow(this.tsgId, opts, groupOptionsSchema);
-    if (opts.columns?.length) params.columns = opts.columns.join(",");
+    const params = serializeFilteredOptions(this.tsgId, opts, groupOptionsSchema);
     return request({
       method: "GET",
       baseUrl: this.baseUrl,
@@ -17055,10 +17061,14 @@ var AIGatewayTelemetryClient = class {
    * ```
    */
   async logs(opts) {
-    const params = serializeWindow(this.tsgId, opts, logsOptionsSchema);
-    if (opts.pageSize !== void 0) params.pageSize = String(opts.pageSize);
-    if (opts.traceId !== void 0) params.traceId = opts.traceId;
-    if (opts.statusCode !== void 0) params.statusCode = String(opts.statusCode);
+    const { params, options: validated } = serializeWindowWithOptions(
+      this.tsgId,
+      opts,
+      logsOptionsSchema
+    );
+    if (validated.pageSize !== void 0) params.pageSize = String(validated.pageSize);
+    if (validated.traceId !== void 0) params.traceId = validated.traceId;
+    if (validated.statusCode !== void 0) params.statusCode = String(validated.statusCode);
     return request({
       method: "GET",
       baseUrl: this.baseUrl,