@cdot65/prisma-airs-sdk 0.6.2 → 0.6.3

package/dist/index.js

@@ -29,7 +29,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.6.2";
+var SDK_VERSION = "0.6.3";
 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";
@@ -437,6 +437,11 @@ var Content = class _Content {
   _codePrompt;
   _codeResponse;
   _toolEvent;
+  /**
+   * Create a new Content instance.
+   * @param opts - Content fields; at least one of prompt, response, codePrompt, codeResponse, or toolEvent is required.
+   * @throws {AISecSDKException} If no content field is provided or a field exceeds its byte-length limit.
+   */
   constructor(opts) {
     if (!opts.prompt && !opts.response && !opts.codePrompt && !opts.codeResponse && !opts.toolEvent) {
       throw new AISecSDKException(
@@ -604,7 +609,7 @@ import { z } from "zod";
 var AiProfileSchema = z.object({
   profile_id: z.string().uuid().optional(),
   profile_name: z.string().max(MAX_AI_PROFILE_NAME_LENGTH).optional()
-}).refine((d) => d.profile_id || d.profile_name, {
+}).passthrough().refine((d) => d.profile_id || d.profile_name, {
   message: "Either profile_id or profile_name must be provided"
 });
 
@@ -614,14 +619,14 @@ var AgentMetaSchema = z2.object({
   agent_id: z2.string().optional(),
   agent_version: z2.string().optional(),
   agent_arn: z2.string().optional()
-});
+}).passthrough();
 var MetadataSchema = z2.object({
   app_name: z2.string().optional(),
   app_user: z2.string().optional(),
   ai_model: z2.string().optional(),
   user_ip: z2.string().optional(),
   agent_meta: AgentMetaSchema.optional()
-});
+}).passthrough();
 
 // src/models/tool-event.ts
 import { z as z3 } from "zod";
@@ -630,12 +635,12 @@ var ToolEventMetadataSchema = z3.object({
   method: z3.string(),
   server_name: z3.string(),
   tool_invoked: z3.string().optional()
-});
+}).passthrough();
 var ToolEventSchema = z3.object({
   metadata: ToolEventMetadataSchema.optional(),
   input: z3.string().optional(),
   output: z3.string().optional()
-});
+}).passthrough();
 
 // src/models/scan-request.ts
 import { z as z4 } from "zod";
@@ -646,14 +651,14 @@ var ScanRequestContentsInnerSchema = z4.object({
   code_response: z4.string().optional(),
   context: z4.string().optional(),
   tool_event: ToolEventSchema.optional()
-});
+}).passthrough();
 var ScanRequestSchema = z4.object({
   tr_id: z4.string().max(MAX_TRANSACTION_ID_STR_LENGTH).optional(),
   session_id: z4.string().max(MAX_SESSION_ID_STR_LENGTH).optional(),
   ai_profile: AiProfileSchema,
   metadata: MetadataSchema.optional(),
   contents: z4.array(ScanRequestContentsInnerSchema).min(1)
-});
+}).passthrough();
 
 // src/models/scan-response.ts
 import { z as z8 } from "zod";
@@ -662,7 +667,7 @@ import { z as z8 } from "zod";
 import { z as z5 } from "zod";
 var PromptDetectionDetailsSchema = z5.object({
   topic_guardrails_details: z5.record(z5.unknown()).optional()
-});
+}).passthrough();
 var PromptDetectedSchema = z5.object({
   url_cats: z5.boolean().optional(),
   dlp: z5.boolean().optional(),
@@ -671,13 +676,13 @@ var PromptDetectedSchema = z5.object({
   malicious_code: z5.boolean().optional(),
   agent: z5.boolean().optional(),
   topic_violation: z5.boolean().optional()
-});
+}).passthrough();
 
 // src/models/response-detected.ts
 import { z as z6 } from "zod";
 var ResponseDetectionDetailsSchema = z6.object({
   topic_guardrails_details: z6.record(z6.unknown()).optional()
-});
+}).passthrough();
 var ResponseDetectedSchema = z6.object({
   url_cats: z6.boolean().optional(),
   dlp: z6.boolean().optional(),
@@ -687,7 +692,7 @@ var ResponseDetectedSchema = z6.object({
   agent: z6.boolean().optional(),
   ungrounded: z6.boolean().optional(),
   topic_violation: z6.boolean().optional()
-});
+}).passthrough();
 
 // src/models/detection-reports.ts
 import { z as z7 } from "zod";
@@ -763,7 +768,7 @@ var ContentErrorSchema = z7.object({
 var MaskedDataSchema = z8.object({
   data: z8.string().optional(),
   pattern_detections: z8.array(PatternDetectionSchema).optional()
-});
+}).passthrough();
 var IODetectedSchema = z8.object({
   url_cats: z8.boolean().optional(),
   dlp: z8.boolean().optional(),
@@ -781,7 +786,7 @@ var ToolDetectedSchema = z8.object({
   summary: ScanSummarySchema.optional(),
   input_detected: IODetectedSchema.optional(),
   output_detected: IODetectedSchema.optional()
-});
+}).passthrough();
 var ScanResponseSchema = z8.object({
   source: z8.string().optional(),
   report_id: z8.string(),
@@ -804,20 +809,20 @@ var ScanResponseSchema = z8.object({
   tool_detected: ToolDetectedSchema.optional(),
   created_at: z8.string().optional(),
   completed_at: z8.string().optional()
-});
+}).passthrough();
 
 // src/models/async-scan.ts
 import { z as z9 } from "zod";
 var AsyncScanObjectSchema = z9.object({
   req_id: z9.number().int(),
   scan_req: ScanRequestSchema
-});
+}).passthrough();
 var AsyncScanResponseSchema = z9.object({
   received: z9.string(),
   scan_id: z9.string(),
   report_id: z9.string().optional(),
   source: z9.string().optional()
-});
+}).passthrough();
 
 // src/models/scan-id-result.ts
 import { z as z10 } from "zod";
@@ -827,7 +832,7 @@ var ScanIdResultSchema = z10.object({
   status: z10.string().optional(),
   scan_id: z10.string().optional(),
   result: ScanResponseSchema.optional()
-});
+}).passthrough();
 
 // src/models/threat-report.ts
 import { z as z14 } from "zod";
@@ -845,7 +850,7 @@ var DlpReportSchema = z11.object({
   data_pattern_rule1_verdict: z11.string().optional(),
   data_pattern_rule2_verdict: z11.string().optional(),
   data_pattern_detection_offsets: z11.array(DlpPatternDetectionSchema).optional()
-});
+}).passthrough();
 
 // src/models/urlf-report.ts
 import { z as z12 } from "zod";
@@ -854,7 +859,7 @@ var UrlfEntrySchema = z12.object({
   risk_level: z12.string().optional(),
   action: z12.string().optional(),
   categories: z12.array(z12.string()).optional()
-});
+}).passthrough();
 
 // src/models/detection.ts
 var DSDetailResultSchema = z13.object({
@@ -883,7 +888,7 @@ var DetectionServiceResultSchema = z13.object({
   action: z13.string().optional(),
   metadata: DSResultMetadataSchema.optional(),
   result_detail: DSDetailResultSchema.optional()
-});
+}).passthrough();
 
 // src/models/threat-report.ts
 var ThreatScanReportSchema = z14.object({
@@ -894,7 +899,7 @@ var ThreatScanReportSchema = z14.object({
   transaction_id: z14.string().optional(),
   session_id: z14.string().optional(),
   detection_results: z14.array(DetectionServiceResultSchema).optional()
-});
+}).passthrough();
 
 // src/models/error-response.ts
 import { z as z15 } from "zod";
@@ -2701,7 +2706,7 @@ var OAuthTokenResponseSchema = z26.object({
   token_type: z26.string().optional(),
   expires_in: z26.number(),
   scope: z26.string().optional()
-});
+}).passthrough();
 
 // src/management/oauth-client.ts
 var DEFAULT_TOKEN_BUFFER_MS = 3e4;
@@ -3717,6 +3722,7 @@ var ModelSecurityScansClient = class {
    * Delete labels from a scan by key.
    * @param scanUuid - Scan UUID.
    * @param keys - Label keys to delete.
+   * @returns Resolves when the labels are deleted.
    */
   async deleteLabels(scanUuid, keys) {
     if (!isValidUuid(scanUuid)) {
@@ -4200,7 +4206,11 @@ var RedTeamScansClient = class {
     this.oauthClient = opts.oauthClient;
     this.numRetries = opts.numRetries;
   }
-  /** Create a new red team scan job. */
+  /**
+   * Create a new red team scan job.
+   * @param request - Job creation request body.
+   * @returns The created job response.
+   */
   async create(request) {
     const res = await managementHttpRequest({
       method: "POST",
@@ -4660,7 +4670,12 @@ var RedTeamTargetsClient = class {
     this.oauthClient = opts.oauthClient;
     this.numRetries = opts.numRetries;
   }
-  /** Create a new target. */
+  /**
+   * Create a new target.
+   * @param request - Target creation request body.
+   * @param opts - Optional operation options (e.g. validate connection).
+   * @returns The created target response.
+   */
   async create(request, opts) {
     const params = {};
     if (opts?.validate !== void 0) params.validate = String(opts.validate);