@cdot65/prisma-airs-sdk 0.6.5 → 0.6.6

package/dist/index.cjs

@@ -430,7 +430,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.5";
+var SDK_VERSION = "0.6.6";
 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";
@@ -659,6 +659,11 @@ var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function isValidUuid(value) {
   return UUID_RE.test(value);
 }
+function validateJobId(jobId) {
+  if (!isValidUuid(jobId)) {
+    throw new AISecSDKException(`Invalid job id: ${jobId}`, "AISEC_USER_REQUEST_PAYLOAD_ERROR" /* USER_REQUEST_PAYLOAD_ERROR */);
+  }
+}
 function generatePayloadHash(payload, secret) {
   return (0, import_node_crypto.createHmac)("sha256", secret).update(payload).digest("hex");
 }
@@ -968,6 +973,7 @@ var Content = class _Content {
   /**
    * Load content from a JSON file.
    * @param filePath - Path to JSON file containing scan request contents.
+   * @returns A new Content instance populated from the JSON file.
    */
   static fromJSONFile(filePath) {
     const raw = (0, import_node_fs.readFileSync)(filePath, "utf-8");
@@ -3154,7 +3160,6 @@ var OAuthClient = class {
   }
   /**
    * Clear the cached token, forcing a fresh fetch on next call.
-   * @returns Nothing.
    */
   clearToken() {
     this.accessToken = null;
@@ -3501,7 +3506,7 @@ var TopicsClient = class {
   /**
    * Force-delete a custom topic, removing it from any referencing profiles.
    * @param topicId - UUID of the topic to force-delete.
-   * @param updatedBy - Email of the user performing the deletion.
+   * @param updatedBy - Optional. Email of the user performing the deletion.
    * @returns Deletion confirmation message.
    */
   async forceDelete(topicId, updatedBy) {
@@ -4713,11 +4718,6 @@ var RedTeamScansClient = class {
 };
 
 // src/red-team/reports-client.ts
-function validateJobId(jobId) {
-  if (!isValidUuid(jobId)) {
-    throw new AISecSDKException(`Invalid job id: ${jobId}`, "AISEC_USER_REQUEST_PAYLOAD_ERROR" /* USER_REQUEST_PAYLOAD_ERROR */);
-  }
-}
 var RedTeamReportsClient = class {
   baseUrl;
   oauthClient;
@@ -4975,7 +4975,7 @@ var RedTeamReportsClient = class {
    * Download a report in the specified format.
    * @param jobId - The job UUID.
    * @param format - The file format (e.g. "pdf", "csv").
-   * @returns The downloaded report data.
+   * @returns The report data in the requested format (untyped — shape depends on `format`).
    */
   async downloadReport(jobId, format) {
     validateJobId(jobId);
@@ -4993,7 +4993,7 @@ var RedTeamReportsClient = class {
   /**
    * Generate a partial report for a running scan.
    * @param jobId - The job UUID.
-   * @returns The partial report data.
+   * @returns The partial report payload (untyped — schema not yet defined by the API).
    */
   async generatePartialReport(jobId) {
     validateJobId(jobId);
@@ -5009,11 +5009,6 @@ var RedTeamReportsClient = class {
 };
 
 // src/red-team/custom-attack-reports-client.ts
-function validateJobId2(jobId) {
-  if (!isValidUuid(jobId)) {
-    throw new AISecSDKException(`Invalid job id: ${jobId}`, "AISEC_USER_REQUEST_PAYLOAD_ERROR" /* USER_REQUEST_PAYLOAD_ERROR */);
-  }
-}
 var RedTeamCustomAttackReportsClient = class {
   baseUrl;
   oauthClient;
@@ -5029,7 +5024,7 @@ var RedTeamCustomAttackReportsClient = class {
    * @returns The custom attack report response.
    */
   async getReport(jobId) {
-    validateJobId2(jobId);
+    validateJobId(jobId);
     const res = await managementHttpRequest({
       method: "GET",
       baseUrl: this.baseUrl,
@@ -5045,7 +5040,7 @@ var RedTeamCustomAttackReportsClient = class {
    * @returns The prompt sets report response.
    */
   async getPromptSets(jobId) {
-    validateJobId2(jobId);
+    validateJobId(jobId);
     const res = await managementHttpRequest({
       method: "GET",
       baseUrl: this.baseUrl,
@@ -5063,7 +5058,7 @@ var RedTeamCustomAttackReportsClient = class {
    * @returns The list of prompt detail responses.
    */
   async getPromptsBySet(jobId, promptSetId, opts) {
-    validateJobId2(jobId);
+    validateJobId(jobId);
     if (!isValidUuid(promptSetId)) {
       throw new AISecSDKException(
         `Invalid prompt set id: ${promptSetId}`,
@@ -5089,7 +5084,7 @@ var RedTeamCustomAttackReportsClient = class {
    * @returns The prompt detail response.
    */
   async getPromptDetail(jobId, promptId) {
-    validateJobId2(jobId);
+    validateJobId(jobId);
     if (!isValidUuid(promptId)) {
       throw new AISecSDKException(
         `Invalid prompt id: ${promptId}`,
@@ -5112,7 +5107,7 @@ var RedTeamCustomAttackReportsClient = class {
    * @returns The paginated list of custom attacks.
    */
   async listCustomAttacks(jobId, opts) {
-    validateJobId2(jobId);
+    validateJobId(jobId);
     const params = buildRedTeamListParams(opts);
     if (opts?.threat !== void 0) params.threat = String(opts.threat);
     if (opts?.prompt_set_id !== void 0) params.prompt_set_id = opts.prompt_set_id;
@@ -5134,7 +5129,7 @@ var RedTeamCustomAttackReportsClient = class {
    * @returns The list of attack outputs.
    */
   async getAttackOutputs(jobId, attackId) {
-    validateJobId2(jobId);
+    validateJobId(jobId);
     if (!isValidUuid(attackId)) {
       throw new AISecSDKException(
         `Invalid attack id: ${attackId}`,
@@ -5156,7 +5151,7 @@ var RedTeamCustomAttackReportsClient = class {
    * @returns The list of property statistics.
    */
   async getPropertyStats(jobId) {
-    validateJobId2(jobId);
+    validateJobId(jobId);
     const res = await managementHttpRequest({
       method: "GET",
       baseUrl: this.baseUrl,
@@ -5503,7 +5498,7 @@ var RedTeamCustomAttacksClient = class {
   /**
    * Download CSV template for a prompt set.
    * @param uuid - The prompt set UUID.
-   * @returns The CSV template data.
+   * @returns The CSV template content (untyped — raw response from the API).
    */
   async downloadTemplate(uuid) {
     validateUuid(uuid, "prompt set uuid");