@cdot65/prisma-airs-sdk 0.11.0 → 0.12.0

package/dist/index.cjs

@@ -121,9 +121,13 @@ __export(index_exports, {
   DSDetailResultSchema: () => DSDetailResultSchema,
   DSResultMetadataSchema: () => DSResultMetadataSchema,
   DashboardApplicationSchema: () => DashboardApplicationSchema,
+  DashboardApplicationSessionsBucketSchema: () => DashboardApplicationSessionsBucketSchema,
   DashboardApplicationViolationBreakdownSchema: () => DashboardApplicationViolationBreakdownSchema,
+  DashboardApplicationsOverviewItemSchema: () => DashboardApplicationsOverviewItemSchema,
+  DashboardApplicationsOverviewSchema: () => DashboardApplicationsOverviewSchema,
   DashboardClient: () => DashboardClient,
   DashboardOverviewResponseSchema: () => DashboardOverviewResponseSchema,
+  DashboardPaginationSchema: () => DashboardPaginationSchema,
   DashboardSessionStatsSchema: () => DashboardSessionStatsSchema,
   DataFilteringDetailsSchema: () => DataFilteringDetailsSchema,
   DataFilteringProfileRequestSchema: () => DataFilteringProfileRequestSchema,
@@ -274,6 +278,7 @@ __export(index_exports, {
   MGMT_CLIENT_SECRET: () => MGMT_CLIENT_SECRET,
   MGMT_CUSTOMER_APPS_TSG_PATH: () => MGMT_CUSTOMER_APPS_TSG_PATH,
   MGMT_CUSTOMER_APP_PATH: () => MGMT_CUSTOMER_APP_PATH,
+  MGMT_DASHBOARD_APPLICATIONS_OVERVIEW_PATH: () => MGMT_DASHBOARD_APPLICATIONS_OVERVIEW_PATH,
   MGMT_DASHBOARD_APPLICATION_PATH: () => MGMT_DASHBOARD_APPLICATION_PATH,
   MGMT_DASHBOARD_APPLICATION_VIOLATION_BREAKDOWN_PATH: () => MGMT_DASHBOARD_APPLICATION_VIOLATION_BREAKDOWN_PATH,
   MGMT_DEPLOYMENT_PROFILES_PATH: () => MGMT_DEPLOYMENT_PROFILES_PATH,
@@ -563,7 +568,7 @@ var MAX_NUMBER_OF_BATCH_SCAN_OBJECTS = 5;
 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.11.0";
+var SDK_VERSION = "0.12.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";
@@ -592,6 +597,7 @@ var MGMT_OAUTH_INVALIDATE_PATH = "/v1/mgmt/oauth/invalidateToken";
 var MGMT_OAUTH_TOKEN_PATH = "/v1/mgmt/oauth/client_credential/accesstoken";
 var MGMT_DASHBOARD_APPLICATION_PATH = "/v1/mgmt/dashboard/v2/apps/application";
 var MGMT_DASHBOARD_APPLICATION_VIOLATION_BREAKDOWN_PATH = "/v1/mgmt/dashboard/v2/apps/applicationviolationbreakdown";
+var MGMT_DASHBOARD_APPLICATIONS_OVERVIEW_PATH = "/v1/mgmt/dashboard/v2/apps/applicationsoverview";
 var DEFAULT_DLP_ENDPOINT = "https://api.dlp.paloaltonetworks.com";
 var DLP_DATA_FILTERING_PROFILES_PATH = "/v2/api/data-filtering-profiles";
 var DLP_DATA_PATTERNS_PATH = "/v2/api/data-patterns";
@@ -2044,6 +2050,31 @@ var DashboardApplicationViolationBreakdownSchema = import_zod21.z.object({
   detection_type_violation_breakdown: import_zod21.z.array(DetectorViolationBreakdownEntrySchema).optional(),
   total_violating: import_zod21.z.number().optional()
 }).passthrough();
+var DashboardApplicationSessionsBucketSchema = import_zod21.z.object({
+  bucket_number: import_zod21.z.number().optional(),
+  date: import_zod21.z.string().nullable().optional(),
+  total: import_zod21.z.number().optional(),
+  violated: import_zod21.z.number().optional()
+}).passthrough();
+var DashboardApplicationsOverviewItemSchema = import_zod21.z.object({
+  id: import_zod21.z.string().nullable().optional(),
+  name: import_zod21.z.string().nullable().optional(),
+  cloud: import_zod21.z.string().nullable().optional(),
+  source: import_zod21.z.string().nullable().optional(),
+  created_at: import_zod21.z.string().nullable().optional(),
+  sessions: import_zod21.z.array(DashboardApplicationSessionsBucketSchema).nullable().optional(),
+  sessions_total: import_zod21.z.number().nullable().optional(),
+  sessions_violated: import_zod21.z.number().nullable().optional()
+}).passthrough();
+var DashboardPaginationSchema = import_zod21.z.object({
+  limit: import_zod21.z.number().optional(),
+  skip: import_zod21.z.number().optional(),
+  total_items: import_zod21.z.number().optional()
+}).passthrough();
+var DashboardApplicationsOverviewSchema = import_zod21.z.object({
+  items: import_zod21.z.array(DashboardApplicationsOverviewItemSchema).optional(),
+  pagination: DashboardPaginationSchema.optional()
+}).passthrough();
 
 // src/models/mgmt-deployment-profile.ts
 var import_zod22 = require("zod");
@@ -5389,6 +5420,53 @@ var DashboardClient = class {
       numRetries: this.numRetries
     });
   }
+  /**
+   * Enumerate all dashboard application buckets the tenant has data for.
+   *
+   * This is the canonical apps-list source for the dashboard. The customer-apps endpoint
+   * (`mgmt.customerApps.list`) lists registered customer applications, but each registered
+   * customer-app can have **multiple dashboard buckets** when its API key is used to send scan
+   * requests carrying different `metadata.app_name` values - one bucket per distinct
+   * scan-payload name. This endpoint returns every bucket, so it is what you want for
+   * per-app token-consumption reporting and dashboard inventory.
+   *
+   * The `id` field on each item is the registered `customer_appId` UUID; the `name` field is
+   * the scan-payload value. Pass that `(id, name)` pair to {@link application} or
+   * {@link applicationViolationBreakdown} to retrieve drill-down data for a specific bucket.
+   *
+   * @param query - Time window and pagination.
+   * @returns Paginated bucket list plus pagination metadata.
+   * @example
+   * ```ts
+   * import { ManagementClient } from '@cdot65/prisma-airs-sdk';
+   * const mgmt = new ManagementClient();
+   *
+   * const { items } = await mgmt.dashboard.applicationsOverview();
+   * for (const item of items ?? []) {
+   *   const overview = await mgmt.dashboard.application({
+   *     appId: item.id ?? '',
+   *     appName: item.name ?? '',
+   *   });
+   *   console.log(item.name, overview.token_stats?.monthly_total_tokens);
+   * }
+   * ```
+   */
+  async applicationsOverview(query) {
+    return request({
+      method: "GET",
+      baseUrl: this.baseUrl,
+      path: MGMT_DASHBOARD_APPLICATIONS_OVERVIEW_PATH,
+      params: {
+        time_interval: String(query?.timeInterval ?? 30),
+        time_unit: query?.timeUnit ?? "days",
+        limit: String(query?.limit ?? 25),
+        offset: String(query?.offset ?? 0)
+      },
+      responseSchema: DashboardApplicationsOverviewSchema,
+      auth: this.auth,
+      numRetries: this.numRetries
+    });
+  }
 };
 
 // src/management/dlp/data-filtering-profiles.ts
@@ -9257,9 +9335,13 @@ var RedTeamClient = class {
   DSDetailResultSchema,
   DSResultMetadataSchema,
   DashboardApplicationSchema,
+  DashboardApplicationSessionsBucketSchema,
   DashboardApplicationViolationBreakdownSchema,
+  DashboardApplicationsOverviewItemSchema,
+  DashboardApplicationsOverviewSchema,
   DashboardClient,
   DashboardOverviewResponseSchema,
+  DashboardPaginationSchema,
   DashboardSessionStatsSchema,
   DataFilteringDetailsSchema,
   DataFilteringProfileRequestSchema,
@@ -9410,6 +9492,7 @@ var RedTeamClient = class {
   MGMT_CLIENT_SECRET,
   MGMT_CUSTOMER_APPS_TSG_PATH,
   MGMT_CUSTOMER_APP_PATH,
+  MGMT_DASHBOARD_APPLICATIONS_OVERVIEW_PATH,
   MGMT_DASHBOARD_APPLICATION_PATH,
   MGMT_DASHBOARD_APPLICATION_VIOLATION_BREAKDOWN_PATH,
   MGMT_DEPLOYMENT_PROFILES_PATH,