@scanoss_test/sdk 2.0.7 → 2.0.9

package/dist/index.d.mts

@@ -292,6 +292,15 @@ interface FileResult {
     path: string;
     matches: Match[];
 }
+/** Progress information during scan */
+interface ScanProgress {
+    filesScanned: number;
+    totalFiles: number;
+    currentFile: string;
+    matchesSoFar: number;
+}
+/** Progress callback function */
+type ProgressCallback = (progress: ScanProgress) => void;
 /** Scan command parameters */
 interface ScanParams {
     path: string;
@@ -301,6 +310,10 @@ interface ScanParams {
     exclude?: string[];
     apiUrl?: string;
     apiKey?: string;
+    /** Number of files per batch for progress reporting (0 = no progress) */
+    batchSize?: number;
+    /** Callback function for progress updates */
+    onProgress?: ProgressCallback;
 }
 /** Scan result */
 interface ScanResult {
@@ -397,6 +410,19 @@ declare class Scanoss {
     private send;
     /**
      * Scan files for open source matches.
+     *
+     * @param params - Scan parameters including path, filters, and optional progress callback
+     * @example
+     * ```typescript
+     * // Scan with progress reporting
+     * const result = await scanoss.scan({
+     *   path: './src',
+     *   batchSize: 50,
+     *   onProgress: (progress) => {
+     *     console.log(`Scanned ${progress.filesScanned}/${progress.totalFiles} files`);
+     *   }
+     * });
+     * ```
      */
     scan(params: ScanParams): Promise<ScanResult$1>;
     /**
@@ -447,4 +473,4 @@ declare class ScanossError extends Error {
  */
 declare function getBinaryPath(): string;
 
-export { type FileInfo, type FileResult, type FilterFilesParams, type FilterFilesResult, type FingerprintParams, type FingerprintResult, type GenerateSbomParams, type GenerateSbomResult, type Match, type OutputFormat, type ScanParams, type ScanResult, type ScanType, Scanoss, ScanossError, type ScanossOptions, type VersionResult, getBinaryPath };
+export { type FileInfo, type FileResult, type FilterFilesParams, type FilterFilesResult, type FingerprintParams, type FingerprintResult, type GenerateSbomParams, type GenerateSbomResult, type Match, type OutputFormat, type ProgressCallback, type ScanParams, type ScanProgress, type ScanResult, type ScanType, Scanoss, ScanossError, type ScanossOptions, type VersionResult, getBinaryPath };

package/dist/index.d.ts

@@ -292,6 +292,15 @@ interface FileResult {
     path: string;
     matches: Match[];
 }
+/** Progress information during scan */
+interface ScanProgress {
+    filesScanned: number;
+    totalFiles: number;
+    currentFile: string;
+    matchesSoFar: number;
+}
+/** Progress callback function */
+type ProgressCallback = (progress: ScanProgress) => void;
 /** Scan command parameters */
 interface ScanParams {
     path: string;
@@ -301,6 +310,10 @@ interface ScanParams {
     exclude?: string[];
     apiUrl?: string;
     apiKey?: string;
+    /** Number of files per batch for progress reporting (0 = no progress) */
+    batchSize?: number;
+    /** Callback function for progress updates */
+    onProgress?: ProgressCallback;
 }
 /** Scan result */
 interface ScanResult {
@@ -397,6 +410,19 @@ declare class Scanoss {
     private send;
     /**
      * Scan files for open source matches.
+     *
+     * @param params - Scan parameters including path, filters, and optional progress callback
+     * @example
+     * ```typescript
+     * // Scan with progress reporting
+     * const result = await scanoss.scan({
+     *   path: './src',
+     *   batchSize: 50,
+     *   onProgress: (progress) => {
+     *     console.log(`Scanned ${progress.filesScanned}/${progress.totalFiles} files`);
+     *   }
+     * });
+     * ```
      */
     scan(params: ScanParams): Promise<ScanResult$1>;
     /**
@@ -447,4 +473,4 @@ declare class ScanossError extends Error {
  */
 declare function getBinaryPath(): string;
 
-export { type FileInfo, type FileResult, type FilterFilesParams, type FilterFilesResult, type FingerprintParams, type FingerprintResult, type GenerateSbomParams, type GenerateSbomResult, type Match, type OutputFormat, type ScanParams, type ScanResult, type ScanType, Scanoss, ScanossError, type ScanossOptions, type VersionResult, getBinaryPath };
+export { type FileInfo, type FileResult, type FilterFilesParams, type FilterFilesResult, type FingerprintParams, type FingerprintResult, type GenerateSbomParams, type GenerateSbomResult, type Match, type OutputFormat, type ProgressCallback, type ScanParams, type ScanProgress, type ScanResult, type ScanType, Scanoss, ScanossError, type ScanossOptions, type VersionResult, getBinaryPath };

package/dist/index.js

@@ -88,14 +88,14 @@ var import_codegenv22 = require("@bufbuild/protobuf/codegenv2");
 var file_scanoss_v1_enums = /* @__PURE__ */ (0, import_codegenv22.fileDesc)("ChZzY2Fub3NzL3YxL2VudW1zLnByb3RvEgpzY2Fub3NzLnYxKqgBCgxPdXRwdXRGb3JtYXQSHQoZT1VUUFVUX0ZPUk1BVF9VTlNQRUNJRklFRBAAEhYKEk9VVFBVVF9GT1JNQVRfSlNPThABEhYKEk9VVFBVVF9GT1JNQVRfU1BEWBACEhsKF09VVFBVVF9GT1JNQVRfQ1lDTE9ORURYEAMSFQoRT1VUUFVUX0ZPUk1BVF9DU1YQBBIVChFPVVRQVVRfRk9STUFUX1dGUBAFKlYKCFNjYW5UeXBlEhkKFVNDQU5fVFlQRV9VTlNQRUNJRklFRBAAEhYKElNDQU5fVFlQRV9JREVOVElGWRABEhcKE1NDQU5fVFlQRV9CTEFDS0xJU1QQAkJNCg9jb20uc2Nhbm9zcy5nZW5QAVo4Z2l0aHViLmNvbS9zY2Fub3NzL3NjYW5vc3MvY29yZS9nZW4vc2Nhbm9zcy92MTtzY2Fub3NzdjFiBnByb3RvMw");
 
 // src/gen/scanoss/v1/commands_pb.ts
-var file_scanoss_v1_commands = /* @__PURE__ */ (0, import_codegenv23.fileDesc)("ChlzY2Fub3NzL3YxL2NvbW1hbmRzLnByb3RvEgpzY2Fub3NzLnYxIqECCgdSZXF1ZXN0EgoKAmlkGAEgASgFEicKBHNjYW4YAiABKAsyFy5zY2Fub3NzLnYxLlNjYW5Db21tYW5kSAASNgoMZmlsdGVyX2ZpbGVzGAMgASgLMh4uc2Nhbm9zcy52MS5GaWx0ZXJGaWxlc0NvbW1hbmRIABI1CgtmaW5nZXJwcmludBgEIAEoCzIeLnNjYW5vc3MudjEuRmluZ2VycHJpbnRDb21tYW5kSAASOAoNZ2VuZXJhdGVfc2JvbRgFIAEoCzIfLnNjYW5vc3MudjEuR2VuZXJhdGVTYm9tQ29tbWFuZEgAEi0KB3ZlcnNpb24YBiABKAsyGi5zY2Fub3NzLnYxLlZlcnNpb25Db21tYW5kSABCCQoHY29tbWFuZCLAAgoIUmVzcG9uc2USCgoCaWQYASABKAUSJgoEc2NhbhgCIAEoCzIWLnNjYW5vc3MudjEuU2NhblJlc3VsdEgAEjUKDGZpbHRlcl9maWxlcxgDIAEoCzIdLnNjYW5vc3MudjEuRmlsdGVyRmlsZXNSZXN1bHRIABI0CgtmaW5nZXJwcmludBgEIAEoCzIdLnNjYW5vc3MudjEuRmluZ2VycHJpbnRSZXN1bHRIABI3Cg1nZW5lcmF0ZV9zYm9tGAUgASgLMh4uc2Nhbm9zcy52MS5HZW5lcmF0ZVNib21SZXN1bHRIABIsCgd2ZXJzaW9uGAYgASgLMhkuc2Nhbm9zcy52MS5WZXJzaW9uUmVzdWx0SAASIgoFZXJyb3IYZCABKAsyES5zY2Fub3NzLnYxLkVycm9ySABCCAoGcmVzdWx0ItgBCgtTY2FuQ29tbWFuZBIMCgRwYXRoGAEgASgJEigKBmZvcm1hdBgCIAEoDjIYLnNjYW5vc3MudjEuT3V0cHV0Rm9ybWF0EicKCXNjYW5fdHlwZRgDIAEoDjIULnNjYW5vc3MudjEuU2NhblR5cGUSDwoHaW5jbHVkZRgEIAMoCRIPCgdleGNsdWRlGAUgAygJEg8KB2FwaV91cmwYBiABKAkSDwoHYXBpX2tleRgHIAEoCRIPCgd0aHJlYWRzGAggASgFEhMKC3NraXBfaGlkZGVuGAkgASgIIo0BCgpTY2FuUmVzdWx0EiUKBWZpbGVzGAEgAygLMhYuc2Nhbm9zcy52MS5GaWxlUmVzdWx0EhMKC3RvdGFsX2ZpbGVzGAIgASgFEhoKEmZpbGVzX3dpdGhfbWF0Y2hlcxgDIAEoBRIVCg10b3RhbF9tYXRjaGVzGAQgASgFEhAKCHJhd19qc29uGAUgASgJInAKEkZpbHRlckZpbGVzQ29tbWFuZBIMCgRwYXRoGAEgASgJEg8KB2luY2x1ZGUYAiADKAkSDwoHZXhjbHVkZRgDIAMoCRITCgtza2lwX2hpZGRlbhgEIAEoCBIVCg1za2lwX3N5bWxpbmtzGAUgASgIImIKEUZpbHRlckZpbGVzUmVzdWx0EiMKBWZpbGVzGAEgAygLMhQuc2Nhbm9zcy52MS5GaWxlSW5mbxITCgt0b3RhbF9jb3VudBgCIAEoBRITCgt0b3RhbF9ieXRlcxgDIAEoAyJZChJGaW5nZXJwcmludENvbW1hbmQSDAoEcGF0aBgBIAEoCRIPCgdpbmNsdWRlGAIgAygJEg8KB2V4Y2x1ZGUYAyADKAkSEwoLb3V0cHV0X3BhdGgYBCABKAkiXgoRRmluZ2VycHJpbnRSZXN1bHQSCwoDd2ZwGAEgASgJEhMKC291dHB1dF9wYXRoGAIgASgJEhIKCmZpbGVfY291bnQYAyABKAUSEwoLdG90YWxfYnl0ZXMYBCABKAMihwEKE0dlbmVyYXRlU2JvbUNvbW1hbmQSEgoKaW5wdXRfcGF0aBgBIAEoCRIoCgZmb3JtYXQYAiABKA4yGC5zY2Fub3NzLnYxLk91dHB1dEZvcm1hdBITCgtvdXRwdXRfcGF0aBgDIAEoCRIMCgRuYW1lGAQgASgJEg8KB3ZlcnNpb24YBSABKAkiegoSR2VuZXJhdGVTYm9tUmVzdWx0EgwKBHNib20YASABKAkSEwoLb3V0cHV0X3BhdGgYAiABKAkSKAoGZm9ybWF0GAMgASgOMhguc2Nhbm9zcy52MS5PdXRwdXRGb3JtYXQSFwoPY29tcG9uZW50X2NvdW50GAQgASgFIhAKDlZlcnNpb25Db21tYW5kIlgKDVZlcnNpb25SZXN1bHQSDwoHdmVyc2lvbhgBIAEoCRIOCgZjb21taXQYAiABKAkSEgoKYnVpbGRfZGF0ZRgDIAEoCRISCgpnb192ZXJzaW9uGAQgASgJQk0KD2NvbS5zY2Fub3NzLmdlblABWjhnaXRodWIuY29tL3NjYW5vc3Mvc2Nhbm9zcy9jb3JlL2dlbi9zY2Fub3NzL3YxO3NjYW5vc3N2MWIGcHJvdG8z", [file_scanoss_v1_types, file_scanoss_v1_enums]);
+var file_scanoss_v1_commands = /* @__PURE__ */ (0, import_codegenv23.fileDesc)("ChlzY2Fub3NzL3YxL2NvbW1hbmRzLnByb3RvEgpzY2Fub3NzLnYxIqECCgdSZXF1ZXN0EgoKAmlkGAEgASgFEicKBHNjYW4YAiABKAsyFy5zY2Fub3NzLnYxLlNjYW5Db21tYW5kSAASNgoMZmlsdGVyX2ZpbGVzGAMgASgLMh4uc2Nhbm9zcy52MS5GaWx0ZXJGaWxlc0NvbW1hbmRIABI1CgtmaW5nZXJwcmludBgEIAEoCzIeLnNjYW5vc3MudjEuRmluZ2VycHJpbnRDb21tYW5kSAASOAoNZ2VuZXJhdGVfc2JvbRgFIAEoCzIfLnNjYW5vc3MudjEuR2VuZXJhdGVTYm9tQ29tbWFuZEgAEi0KB3ZlcnNpb24YBiABKAsyGi5zY2Fub3NzLnYxLlZlcnNpb25Db21tYW5kSABCCQoHY29tbWFuZCKFAwoIUmVzcG9uc2USCgoCaWQYASABKAUSEAoIaXNfZmluYWwYByABKAgSJgoEc2NhbhgCIAEoCzIWLnNjYW5vc3MudjEuU2NhblJlc3VsdEgAEjUKDGZpbHRlcl9maWxlcxgDIAEoCzIdLnNjYW5vc3MudjEuRmlsdGVyRmlsZXNSZXN1bHRIABI0CgtmaW5nZXJwcmludBgEIAEoCzIdLnNjYW5vc3MudjEuRmluZ2VycHJpbnRSZXN1bHRIABI3Cg1nZW5lcmF0ZV9zYm9tGAUgASgLMh4uc2Nhbm9zcy52MS5HZW5lcmF0ZVNib21SZXN1bHRIABIsCgd2ZXJzaW9uGAYgASgLMhkuc2Nhbm9zcy52MS5WZXJzaW9uUmVzdWx0SAASMQoNc2Nhbl9wcm9ncmVzcxgIIAEoCzIYLnNjYW5vc3MudjEuU2NhblByb2dyZXNzSAASIgoFZXJyb3IYZCABKAsyES5zY2Fub3NzLnYxLkVycm9ySABCCAoGcmVzdWx0IuwBCgtTY2FuQ29tbWFuZBIMCgRwYXRoGAEgASgJEigKBmZvcm1hdBgCIAEoDjIYLnNjYW5vc3MudjEuT3V0cHV0Rm9ybWF0EicKCXNjYW5fdHlwZRgDIAEoDjIULnNjYW5vc3MudjEuU2NhblR5cGUSDwoHaW5jbHVkZRgEIAMoCRIPCgdleGNsdWRlGAUgAygJEg8KB2FwaV91cmwYBiABKAkSDwoHYXBpX2tleRgHIAEoCRIPCgd0aHJlYWRzGAggASgFEhMKC3NraXBfaGlkZGVuGAkgASgIEhIKCmJhdGNoX3NpemUYCiABKAUiaAoMU2NhblByb2dyZXNzEhUKDWZpbGVzX3NjYW5uZWQYASABKAUSEwoLdG90YWxfZmlsZXMYAiABKAUSFAoMY3VycmVudF9maWxlGAMgASgJEhYKDm1hdGNoZXNfc29fZmFyGAQgASgFIo0BCgpTY2FuUmVzdWx0EiUKBWZpbGVzGAEgAygLMhYuc2Nhbm9zcy52MS5GaWxlUmVzdWx0EhMKC3RvdGFsX2ZpbGVzGAIgASgFEhoKEmZpbGVzX3dpdGhfbWF0Y2hlcxgDIAEoBRIVCg10b3RhbF9tYXRjaGVzGAQgASgFEhAKCHJhd19qc29uGAUgASgJInAKEkZpbHRlckZpbGVzQ29tbWFuZBIMCgRwYXRoGAEgASgJEg8KB2luY2x1ZGUYAiADKAkSDwoHZXhjbHVkZRgDIAMoCRITCgtza2lwX2hpZGRlbhgEIAEoCBIVCg1za2lwX3N5bWxpbmtzGAUgASgIImIKEUZpbHRlckZpbGVzUmVzdWx0EiMKBWZpbGVzGAEgAygLMhQuc2Nhbm9zcy52MS5GaWxlSW5mbxITCgt0b3RhbF9jb3VudBgCIAEoBRITCgt0b3RhbF9ieXRlcxgDIAEoAyJZChJGaW5nZXJwcmludENvbW1hbmQSDAoEcGF0aBgBIAEoCRIPCgdpbmNsdWRlGAIgAygJEg8KB2V4Y2x1ZGUYAyADKAkSEwoLb3V0cHV0X3BhdGgYBCABKAkiXgoRRmluZ2VycHJpbnRSZXN1bHQSCwoDd2ZwGAEgASgJEhMKC291dHB1dF9wYXRoGAIgASgJEhIKCmZpbGVfY291bnQYAyABKAUSEwoLdG90YWxfYnl0ZXMYBCABKAMihwEKE0dlbmVyYXRlU2JvbUNvbW1hbmQSEgoKaW5wdXRfcGF0aBgBIAEoCRIoCgZmb3JtYXQYAiABKA4yGC5zY2Fub3NzLnYxLk91dHB1dEZvcm1hdBITCgtvdXRwdXRfcGF0aBgDIAEoCRIMCgRuYW1lGAQgASgJEg8KB3ZlcnNpb24YBSABKAkiegoSR2VuZXJhdGVTYm9tUmVzdWx0EgwKBHNib20YASABKAkSEwoLb3V0cHV0X3BhdGgYAiABKAkSKAoGZm9ybWF0GAMgASgOMhguc2Nhbm9zcy52MS5PdXRwdXRGb3JtYXQSFwoPY29tcG9uZW50X2NvdW50GAQgASgFIhAKDlZlcnNpb25Db21tYW5kIlgKDVZlcnNpb25SZXN1bHQSDwoHdmVyc2lvbhgBIAEoCRIOCgZjb21taXQYAiABKAkSEgoKYnVpbGRfZGF0ZRgDIAEoCRISCgpnb192ZXJzaW9uGAQgASgJQk0KD2NvbS5zY2Fub3NzLmdlblABWjhnaXRodWIuY29tL3NjYW5vc3Mvc2Nhbm9zcy9jb3JlL2dlbi9zY2Fub3NzL3YxO3NjYW5vc3N2MWIGcHJvdG8z", [file_scanoss_v1_types, file_scanoss_v1_enums]);
 var RequestSchema = /* @__PURE__ */ (0, import_codegenv23.messageDesc)(file_scanoss_v1_commands, 0);
 var ResponseSchema = /* @__PURE__ */ (0, import_codegenv23.messageDesc)(file_scanoss_v1_commands, 1);
 var ScanCommandSchema = /* @__PURE__ */ (0, import_codegenv23.messageDesc)(file_scanoss_v1_commands, 2);
-var FilterFilesCommandSchema = /* @__PURE__ */ (0, import_codegenv23.messageDesc)(file_scanoss_v1_commands, 4);
-var FingerprintCommandSchema = /* @__PURE__ */ (0, import_codegenv23.messageDesc)(file_scanoss_v1_commands, 6);
-var GenerateSbomCommandSchema = /* @__PURE__ */ (0, import_codegenv23.messageDesc)(file_scanoss_v1_commands, 8);
-var VersionCommandSchema = /* @__PURE__ */ (0, import_codegenv23.messageDesc)(file_scanoss_v1_commands, 10);
+var FilterFilesCommandSchema = /* @__PURE__ */ (0, import_codegenv23.messageDesc)(file_scanoss_v1_commands, 5);
+var FingerprintCommandSchema = /* @__PURE__ */ (0, import_codegenv23.messageDesc)(file_scanoss_v1_commands, 7);
+var GenerateSbomCommandSchema = /* @__PURE__ */ (0, import_codegenv23.messageDesc)(file_scanoss_v1_commands, 9);
+var VersionCommandSchema = /* @__PURE__ */ (0, import_codegenv23.messageDesc)(file_scanoss_v1_commands, 11);
 
 // src/client.ts
 var Scanoss = class {
@@ -153,10 +153,19 @@ var Scanoss = class {
               response.result.value.code,
               response.result.value.message
             ));
-          } else {
+            this.pending.delete(response.id);
+          } else if (response.result.case === "scanProgress" && pending.onProgress) {
+            const progress = response.result.value;
+            pending.onProgress({
+              filesScanned: progress.filesScanned,
+              totalFiles: progress.totalFiles,
+              currentFile: progress.currentFile,
+              matchesSoFar: progress.matchesSoFar
+            });
+          } else if (response.isFinal || response.result.case !== "scanProgress") {
             pending.resolve(response);
+            this.pending.delete(response.id);
           }
-          this.pending.delete(response.id);
         }
       } catch (err) {
         console.error("Failed to parse daemon response:", err);
@@ -169,13 +178,13 @@ var Scanoss = class {
     }
     this.pending.clear();
   }
-  send(request) {
+  send(request, onProgress) {
     return new Promise((resolve, reject) => {
       if (!this.process || this.closed) {
         reject(new Error("Daemon process is not running"));
         return;
       }
-      this.pending.set(request.id, { resolve, reject });
+      this.pending.set(request.id, { resolve, reject, onProgress });
       const data = (0, import_protobuf.toBinary)(RequestSchema, request);
       const lengthBuf = Buffer.alloc(4);
       lengthBuf.writeUInt32BE(data.length);
@@ -185,6 +194,19 @@ var Scanoss = class {
   }
   /**
    * Scan files for open source matches.
+   *
+   * @param params - Scan parameters including path, filters, and optional progress callback
+   * @example
+   * ```typescript
+   * // Scan with progress reporting
+   * const result = await scanoss.scan({
+   *   path: './src',
+   *   batchSize: 50,
+   *   onProgress: (progress) => {
+   *     console.log(`Scanned ${progress.filesScanned}/${progress.totalFiles} files`);
+   *   }
+   * });
+   * ```
    */
   async scan(params) {
     const id = ++this.requestId;
@@ -195,13 +217,14 @@ var Scanoss = class {
       include: params.include ?? [],
       exclude: params.exclude ?? [],
       apiUrl: params.apiUrl,
-      apiKey: params.apiKey
+      apiKey: params.apiKey,
+      batchSize: params.batchSize ?? 0
     });
     const request = (0, import_protobuf.create)(RequestSchema, {
       id,
       command: { case: "scan", value: scanCmd }
     });
-    const response = await this.send(request);
+    const response = await this.send(request, params.onProgress);
     if (response.result.case !== "scan") {
       throw new Error("Unexpected response type");
     }

package/dist/index.mjs

@@ -67,14 +67,14 @@ import { enumDesc, fileDesc as fileDesc2 } from "@bufbuild/protobuf/codegenv2";
 var file_scanoss_v1_enums = /* @__PURE__ */ fileDesc2("ChZzY2Fub3NzL3YxL2VudW1zLnByb3RvEgpzY2Fub3NzLnYxKqgBCgxPdXRwdXRGb3JtYXQSHQoZT1VUUFVUX0ZPUk1BVF9VTlNQRUNJRklFRBAAEhYKEk9VVFBVVF9GT1JNQVRfSlNPThABEhYKEk9VVFBVVF9GT1JNQVRfU1BEWBACEhsKF09VVFBVVF9GT1JNQVRfQ1lDTE9ORURYEAMSFQoRT1VUUFVUX0ZPUk1BVF9DU1YQBBIVChFPVVRQVVRfRk9STUFUX1dGUBAFKlYKCFNjYW5UeXBlEhkKFVNDQU5fVFlQRV9VTlNQRUNJRklFRBAAEhYKElNDQU5fVFlQRV9JREVOVElGWRABEhcKE1NDQU5fVFlQRV9CTEFDS0xJU1QQAkJNCg9jb20uc2Nhbm9zcy5nZW5QAVo4Z2l0aHViLmNvbS9zY2Fub3NzL3NjYW5vc3MvY29yZS9nZW4vc2Nhbm9zcy92MTtzY2Fub3NzdjFiBnByb3RvMw");
 
 // src/gen/scanoss/v1/commands_pb.ts
-var file_scanoss_v1_commands = /* @__PURE__ */ fileDesc3("ChlzY2Fub3NzL3YxL2NvbW1hbmRzLnByb3RvEgpzY2Fub3NzLnYxIqECCgdSZXF1ZXN0EgoKAmlkGAEgASgFEicKBHNjYW4YAiABKAsyFy5zY2Fub3NzLnYxLlNjYW5Db21tYW5kSAASNgoMZmlsdGVyX2ZpbGVzGAMgASgLMh4uc2Nhbm9zcy52MS5GaWx0ZXJGaWxlc0NvbW1hbmRIABI1CgtmaW5nZXJwcmludBgEIAEoCzIeLnNjYW5vc3MudjEuRmluZ2VycHJpbnRDb21tYW5kSAASOAoNZ2VuZXJhdGVfc2JvbRgFIAEoCzIfLnNjYW5vc3MudjEuR2VuZXJhdGVTYm9tQ29tbWFuZEgAEi0KB3ZlcnNpb24YBiABKAsyGi5zY2Fub3NzLnYxLlZlcnNpb25Db21tYW5kSABCCQoHY29tbWFuZCLAAgoIUmVzcG9uc2USCgoCaWQYASABKAUSJgoEc2NhbhgCIAEoCzIWLnNjYW5vc3MudjEuU2NhblJlc3VsdEgAEjUKDGZpbHRlcl9maWxlcxgDIAEoCzIdLnNjYW5vc3MudjEuRmlsdGVyRmlsZXNSZXN1bHRIABI0CgtmaW5nZXJwcmludBgEIAEoCzIdLnNjYW5vc3MudjEuRmluZ2VycHJpbnRSZXN1bHRIABI3Cg1nZW5lcmF0ZV9zYm9tGAUgASgLMh4uc2Nhbm9zcy52MS5HZW5lcmF0ZVNib21SZXN1bHRIABIsCgd2ZXJzaW9uGAYgASgLMhkuc2Nhbm9zcy52MS5WZXJzaW9uUmVzdWx0SAASIgoFZXJyb3IYZCABKAsyES5zY2Fub3NzLnYxLkVycm9ySABCCAoGcmVzdWx0ItgBCgtTY2FuQ29tbWFuZBIMCgRwYXRoGAEgASgJEigKBmZvcm1hdBgCIAEoDjIYLnNjYW5vc3MudjEuT3V0cHV0Rm9ybWF0EicKCXNjYW5fdHlwZRgDIAEoDjIULnNjYW5vc3MudjEuU2NhblR5cGUSDwoHaW5jbHVkZRgEIAMoCRIPCgdleGNsdWRlGAUgAygJEg8KB2FwaV91cmwYBiABKAkSDwoHYXBpX2tleRgHIAEoCRIPCgd0aHJlYWRzGAggASgFEhMKC3NraXBfaGlkZGVuGAkgASgIIo0BCgpTY2FuUmVzdWx0EiUKBWZpbGVzGAEgAygLMhYuc2Nhbm9zcy52MS5GaWxlUmVzdWx0EhMKC3RvdGFsX2ZpbGVzGAIgASgFEhoKEmZpbGVzX3dpdGhfbWF0Y2hlcxgDIAEoBRIVCg10b3RhbF9tYXRjaGVzGAQgASgFEhAKCHJhd19qc29uGAUgASgJInAKEkZpbHRlckZpbGVzQ29tbWFuZBIMCgRwYXRoGAEgASgJEg8KB2luY2x1ZGUYAiADKAkSDwoHZXhjbHVkZRgDIAMoCRITCgtza2lwX2hpZGRlbhgEIAEoCBIVCg1za2lwX3N5bWxpbmtzGAUgASgIImIKEUZpbHRlckZpbGVzUmVzdWx0EiMKBWZpbGVzGAEgAygLMhQuc2Nhbm9zcy52MS5GaWxlSW5mbxITCgt0b3RhbF9jb3VudBgCIAEoBRITCgt0b3RhbF9ieXRlcxgDIAEoAyJZChJGaW5nZXJwcmludENvbW1hbmQSDAoEcGF0aBgBIAEoCRIPCgdpbmNsdWRlGAIgAygJEg8KB2V4Y2x1ZGUYAyADKAkSEwoLb3V0cHV0X3BhdGgYBCABKAkiXgoRRmluZ2VycHJpbnRSZXN1bHQSCwoDd2ZwGAEgASgJEhMKC291dHB1dF9wYXRoGAIgASgJEhIKCmZpbGVfY291bnQYAyABKAUSEwoLdG90YWxfYnl0ZXMYBCABKAMihwEKE0dlbmVyYXRlU2JvbUNvbW1hbmQSEgoKaW5wdXRfcGF0aBgBIAEoCRIoCgZmb3JtYXQYAiABKA4yGC5zY2Fub3NzLnYxLk91dHB1dEZvcm1hdBITCgtvdXRwdXRfcGF0aBgDIAEoCRIMCgRuYW1lGAQgASgJEg8KB3ZlcnNpb24YBSABKAkiegoSR2VuZXJhdGVTYm9tUmVzdWx0EgwKBHNib20YASABKAkSEwoLb3V0cHV0X3BhdGgYAiABKAkSKAoGZm9ybWF0GAMgASgOMhguc2Nhbm9zcy52MS5PdXRwdXRGb3JtYXQSFwoPY29tcG9uZW50X2NvdW50GAQgASgFIhAKDlZlcnNpb25Db21tYW5kIlgKDVZlcnNpb25SZXN1bHQSDwoHdmVyc2lvbhgBIAEoCRIOCgZjb21taXQYAiABKAkSEgoKYnVpbGRfZGF0ZRgDIAEoCRISCgpnb192ZXJzaW9uGAQgASgJQk0KD2NvbS5zY2Fub3NzLmdlblABWjhnaXRodWIuY29tL3NjYW5vc3Mvc2Nhbm9zcy9jb3JlL2dlbi9zY2Fub3NzL3YxO3NjYW5vc3N2MWIGcHJvdG8z", [file_scanoss_v1_types, file_scanoss_v1_enums]);
+var file_scanoss_v1_commands = /* @__PURE__ */ fileDesc3("ChlzY2Fub3NzL3YxL2NvbW1hbmRzLnByb3RvEgpzY2Fub3NzLnYxIqECCgdSZXF1ZXN0EgoKAmlkGAEgASgFEicKBHNjYW4YAiABKAsyFy5zY2Fub3NzLnYxLlNjYW5Db21tYW5kSAASNgoMZmlsdGVyX2ZpbGVzGAMgASgLMh4uc2Nhbm9zcy52MS5GaWx0ZXJGaWxlc0NvbW1hbmRIABI1CgtmaW5nZXJwcmludBgEIAEoCzIeLnNjYW5vc3MudjEuRmluZ2VycHJpbnRDb21tYW5kSAASOAoNZ2VuZXJhdGVfc2JvbRgFIAEoCzIfLnNjYW5vc3MudjEuR2VuZXJhdGVTYm9tQ29tbWFuZEgAEi0KB3ZlcnNpb24YBiABKAsyGi5zY2Fub3NzLnYxLlZlcnNpb25Db21tYW5kSABCCQoHY29tbWFuZCKFAwoIUmVzcG9uc2USCgoCaWQYASABKAUSEAoIaXNfZmluYWwYByABKAgSJgoEc2NhbhgCIAEoCzIWLnNjYW5vc3MudjEuU2NhblJlc3VsdEgAEjUKDGZpbHRlcl9maWxlcxgDIAEoCzIdLnNjYW5vc3MudjEuRmlsdGVyRmlsZXNSZXN1bHRIABI0CgtmaW5nZXJwcmludBgEIAEoCzIdLnNjYW5vc3MudjEuRmluZ2VycHJpbnRSZXN1bHRIABI3Cg1nZW5lcmF0ZV9zYm9tGAUgASgLMh4uc2Nhbm9zcy52MS5HZW5lcmF0ZVNib21SZXN1bHRIABIsCgd2ZXJzaW9uGAYgASgLMhkuc2Nhbm9zcy52MS5WZXJzaW9uUmVzdWx0SAASMQoNc2Nhbl9wcm9ncmVzcxgIIAEoCzIYLnNjYW5vc3MudjEuU2NhblByb2dyZXNzSAASIgoFZXJyb3IYZCABKAsyES5zY2Fub3NzLnYxLkVycm9ySABCCAoGcmVzdWx0IuwBCgtTY2FuQ29tbWFuZBIMCgRwYXRoGAEgASgJEigKBmZvcm1hdBgCIAEoDjIYLnNjYW5vc3MudjEuT3V0cHV0Rm9ybWF0EicKCXNjYW5fdHlwZRgDIAEoDjIULnNjYW5vc3MudjEuU2NhblR5cGUSDwoHaW5jbHVkZRgEIAMoCRIPCgdleGNsdWRlGAUgAygJEg8KB2FwaV91cmwYBiABKAkSDwoHYXBpX2tleRgHIAEoCRIPCgd0aHJlYWRzGAggASgFEhMKC3NraXBfaGlkZGVuGAkgASgIEhIKCmJhdGNoX3NpemUYCiABKAUiaAoMU2NhblByb2dyZXNzEhUKDWZpbGVzX3NjYW5uZWQYASABKAUSEwoLdG90YWxfZmlsZXMYAiABKAUSFAoMY3VycmVudF9maWxlGAMgASgJEhYKDm1hdGNoZXNfc29fZmFyGAQgASgFIo0BCgpTY2FuUmVzdWx0EiUKBWZpbGVzGAEgAygLMhYuc2Nhbm9zcy52MS5GaWxlUmVzdWx0EhMKC3RvdGFsX2ZpbGVzGAIgASgFEhoKEmZpbGVzX3dpdGhfbWF0Y2hlcxgDIAEoBRIVCg10b3RhbF9tYXRjaGVzGAQgASgFEhAKCHJhd19qc29uGAUgASgJInAKEkZpbHRlckZpbGVzQ29tbWFuZBIMCgRwYXRoGAEgASgJEg8KB2luY2x1ZGUYAiADKAkSDwoHZXhjbHVkZRgDIAMoCRITCgtza2lwX2hpZGRlbhgEIAEoCBIVCg1za2lwX3N5bWxpbmtzGAUgASgIImIKEUZpbHRlckZpbGVzUmVzdWx0EiMKBWZpbGVzGAEgAygLMhQuc2Nhbm9zcy52MS5GaWxlSW5mbxITCgt0b3RhbF9jb3VudBgCIAEoBRITCgt0b3RhbF9ieXRlcxgDIAEoAyJZChJGaW5nZXJwcmludENvbW1hbmQSDAoEcGF0aBgBIAEoCRIPCgdpbmNsdWRlGAIgAygJEg8KB2V4Y2x1ZGUYAyADKAkSEwoLb3V0cHV0X3BhdGgYBCABKAkiXgoRRmluZ2VycHJpbnRSZXN1bHQSCwoDd2ZwGAEgASgJEhMKC291dHB1dF9wYXRoGAIgASgJEhIKCmZpbGVfY291bnQYAyABKAUSEwoLdG90YWxfYnl0ZXMYBCABKAMihwEKE0dlbmVyYXRlU2JvbUNvbW1hbmQSEgoKaW5wdXRfcGF0aBgBIAEoCRIoCgZmb3JtYXQYAiABKA4yGC5zY2Fub3NzLnYxLk91dHB1dEZvcm1hdBITCgtvdXRwdXRfcGF0aBgDIAEoCRIMCgRuYW1lGAQgASgJEg8KB3ZlcnNpb24YBSABKAkiegoSR2VuZXJhdGVTYm9tUmVzdWx0EgwKBHNib20YASABKAkSEwoLb3V0cHV0X3BhdGgYAiABKAkSKAoGZm9ybWF0GAMgASgOMhguc2Nhbm9zcy52MS5PdXRwdXRGb3JtYXQSFwoPY29tcG9uZW50X2NvdW50GAQgASgFIhAKDlZlcnNpb25Db21tYW5kIlgKDVZlcnNpb25SZXN1bHQSDwoHdmVyc2lvbhgBIAEoCRIOCgZjb21taXQYAiABKAkSEgoKYnVpbGRfZGF0ZRgDIAEoCRISCgpnb192ZXJzaW9uGAQgASgJQk0KD2NvbS5zY2Fub3NzLmdlblABWjhnaXRodWIuY29tL3NjYW5vc3Mvc2Nhbm9zcy9jb3JlL2dlbi9zY2Fub3NzL3YxO3NjYW5vc3N2MWIGcHJvdG8z", [file_scanoss_v1_types, file_scanoss_v1_enums]);
 var RequestSchema = /* @__PURE__ */ messageDesc2(file_scanoss_v1_commands, 0);
 var ResponseSchema = /* @__PURE__ */ messageDesc2(file_scanoss_v1_commands, 1);
 var ScanCommandSchema = /* @__PURE__ */ messageDesc2(file_scanoss_v1_commands, 2);
-var FilterFilesCommandSchema = /* @__PURE__ */ messageDesc2(file_scanoss_v1_commands, 4);
-var FingerprintCommandSchema = /* @__PURE__ */ messageDesc2(file_scanoss_v1_commands, 6);
-var GenerateSbomCommandSchema = /* @__PURE__ */ messageDesc2(file_scanoss_v1_commands, 8);
-var VersionCommandSchema = /* @__PURE__ */ messageDesc2(file_scanoss_v1_commands, 10);
+var FilterFilesCommandSchema = /* @__PURE__ */ messageDesc2(file_scanoss_v1_commands, 5);
+var FingerprintCommandSchema = /* @__PURE__ */ messageDesc2(file_scanoss_v1_commands, 7);
+var GenerateSbomCommandSchema = /* @__PURE__ */ messageDesc2(file_scanoss_v1_commands, 9);
+var VersionCommandSchema = /* @__PURE__ */ messageDesc2(file_scanoss_v1_commands, 11);
 
 // src/client.ts
 var Scanoss = class {
@@ -132,10 +132,19 @@ var Scanoss = class {
               response.result.value.code,
               response.result.value.message
             ));
-          } else {
+            this.pending.delete(response.id);
+          } else if (response.result.case === "scanProgress" && pending.onProgress) {
+            const progress = response.result.value;
+            pending.onProgress({
+              filesScanned: progress.filesScanned,
+              totalFiles: progress.totalFiles,
+              currentFile: progress.currentFile,
+              matchesSoFar: progress.matchesSoFar
+            });
+          } else if (response.isFinal || response.result.case !== "scanProgress") {
             pending.resolve(response);
+            this.pending.delete(response.id);
           }
-          this.pending.delete(response.id);
         }
       } catch (err) {
         console.error("Failed to parse daemon response:", err);
@@ -148,13 +157,13 @@ var Scanoss = class {
     }
     this.pending.clear();
   }
-  send(request) {
+  send(request, onProgress) {
     return new Promise((resolve, reject) => {
       if (!this.process || this.closed) {
         reject(new Error("Daemon process is not running"));
         return;
       }
-      this.pending.set(request.id, { resolve, reject });
+      this.pending.set(request.id, { resolve, reject, onProgress });
       const data = toBinary(RequestSchema, request);
       const lengthBuf = Buffer.alloc(4);
       lengthBuf.writeUInt32BE(data.length);
@@ -164,6 +173,19 @@ var Scanoss = class {
   }
   /**
    * Scan files for open source matches.
+   *
+   * @param params - Scan parameters including path, filters, and optional progress callback
+   * @example
+   * ```typescript
+   * // Scan with progress reporting
+   * const result = await scanoss.scan({
+   *   path: './src',
+   *   batchSize: 50,
+   *   onProgress: (progress) => {
+   *     console.log(`Scanned ${progress.filesScanned}/${progress.totalFiles} files`);
+   *   }
+   * });
+   * ```
    */
   async scan(params) {
     const id = ++this.requestId;
@@ -174,13 +196,14 @@ var Scanoss = class {
       include: params.include ?? [],
       exclude: params.exclude ?? [],
       apiUrl: params.apiUrl,
-      apiKey: params.apiKey
+      apiKey: params.apiKey,
+      batchSize: params.batchSize ?? 0
     });
     const request = create(RequestSchema, {
       id,
       command: { case: "scan", value: scanCmd }
     });
-    const response = await this.send(request);
+    const response = await this.send(request, params.onProgress);
     if (response.result.case !== "scan") {
       throw new Error("Unexpected response type");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scanoss_test/sdk",
-  "version": "2.0.7",
+  "version": "2.0.9",
   "description": "SCANOSS SDK for Software Composition Analysis",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -58,10 +58,10 @@
     "@bufbuild/protobuf": "^2.10.2"
   },
   "optionalDependencies": {
-    "@scanoss_test/darwin-arm64": "2.0.7",
-    "@scanoss_test/darwin-x64": "2.0.7",
-    "@scanoss_test/linux-arm64": "2.0.7",
-    "@scanoss_test/linux-x64": "2.0.7",
-    "@scanoss_test/win32-x64": "2.0.7"
+    "@scanoss_test/darwin-arm64": "2.0.9",
+    "@scanoss_test/darwin-x64": "2.0.9",
+    "@scanoss_test/linux-arm64": "2.0.9",
+    "@scanoss_test/linux-x64": "2.0.9",
+    "@scanoss_test/win32-x64": "2.0.9"
   }
 }

package/src/client.ts

@@ -30,6 +30,7 @@ import type {
   FilterFilesParams,
   FingerprintParams,
   GenerateSbomParams,
+  ProgressCallback,
 } from './types';
 
 /** Options for creating a Scanoss instance */
@@ -41,6 +42,7 @@ export interface ScanossOptions {
 interface PendingRequest {
   resolve: (value: Response) => void;
   reject: (reason: Error) => void;
+  onProgress?: ProgressCallback;
 }
 
 /**
@@ -133,10 +135,21 @@ export class Scanoss {
               response.result.value.code,
               response.result.value.message
             ));
-          } else {
+            this.pending.delete(response.id);
+          } else if (response.result.case === 'scanProgress' && pending.onProgress) {
+            // Handle progress update - don't resolve yet
+            const progress = response.result.value;
+            pending.onProgress({
+              filesScanned: progress.filesScanned,
+              totalFiles: progress.totalFiles,
+              currentFile: progress.currentFile,
+              matchesSoFar: progress.matchesSoFar,
+            });
+          } else if (response.isFinal || response.result.case !== 'scanProgress') {
+            // Final response or non-progress response
             pending.resolve(response);
+            this.pending.delete(response.id);
           }
-          this.pending.delete(response.id);
         }
       } catch (err) {
         console.error('Failed to parse daemon response:', err);
@@ -151,14 +164,14 @@ export class Scanoss {
     this.pending.clear();
   }
 
-  private send(request: Request): Promise<Response> {
+  private send(request: Request, onProgress?: ProgressCallback): Promise<Response> {
     return new Promise((resolve, reject) => {
       if (!this.process || this.closed) {
         reject(new Error('Daemon process is not running'));
         return;
       }
 
-      this.pending.set(request.id, { resolve, reject });
+      this.pending.set(request.id, { resolve, reject, onProgress });
 
       // Serialize to binary
       const data = toBinary(RequestSchema, request);
@@ -174,6 +187,19 @@ export class Scanoss {
 
   /**
    * Scan files for open source matches.
+   *
+   * @param params - Scan parameters including path, filters, and optional progress callback
+   * @example
+   * ```typescript
+   * // Scan with progress reporting
+   * const result = await scanoss.scan({
+   *   path: './src',
+   *   batchSize: 50,
+   *   onProgress: (progress) => {
+   *     console.log(`Scanned ${progress.filesScanned}/${progress.totalFiles} files`);
+   *   }
+   * });
+   * ```
    */
   async scan(params: ScanParams): Promise<ScanResult> {
     const id = ++this.requestId;
@@ -186,6 +212,7 @@ export class Scanoss {
       exclude: params.exclude ?? [],
       apiUrl: params.apiUrl,
       apiKey: params.apiKey,
+      batchSize: params.batchSize ?? 0,
     });
 
     const request = create(RequestSchema, {
@@ -193,7 +220,7 @@ export class Scanoss {
       command: { case: 'scan', value: scanCmd },
     });
 
-    const response = await this.send(request);
+    const response = await this.send(request, params.onProgress);
     if (response.result.case !== 'scan') {
       throw new Error('Unexpected response type');
     }

package/src/gen/scanoss/v1/commands_pb.ts

@@ -14,7 +14,7 @@ import type { Message } from "@bufbuild/protobuf";
  * Describes the file scanoss/v1/commands.proto.
  */
 export const file_scanoss_v1_commands: GenFile = /*@__PURE__*/
-  fileDesc("ChlzY2Fub3NzL3YxL2NvbW1hbmRzLnByb3RvEgpzY2Fub3NzLnYxIqECCgdSZXF1ZXN0EgoKAmlkGAEgASgFEicKBHNjYW4YAiABKAsyFy5zY2Fub3NzLnYxLlNjYW5Db21tYW5kSAASNgoMZmlsdGVyX2ZpbGVzGAMgASgLMh4uc2Nhbm9zcy52MS5GaWx0ZXJGaWxlc0NvbW1hbmRIABI1CgtmaW5nZXJwcmludBgEIAEoCzIeLnNjYW5vc3MudjEuRmluZ2VycHJpbnRDb21tYW5kSAASOAoNZ2VuZXJhdGVfc2JvbRgFIAEoCzIfLnNjYW5vc3MudjEuR2VuZXJhdGVTYm9tQ29tbWFuZEgAEi0KB3ZlcnNpb24YBiABKAsyGi5zY2Fub3NzLnYxLlZlcnNpb25Db21tYW5kSABCCQoHY29tbWFuZCLAAgoIUmVzcG9uc2USCgoCaWQYASABKAUSJgoEc2NhbhgCIAEoCzIWLnNjYW5vc3MudjEuU2NhblJlc3VsdEgAEjUKDGZpbHRlcl9maWxlcxgDIAEoCzIdLnNjYW5vc3MudjEuRmlsdGVyRmlsZXNSZXN1bHRIABI0CgtmaW5nZXJwcmludBgEIAEoCzIdLnNjYW5vc3MudjEuRmluZ2VycHJpbnRSZXN1bHRIABI3Cg1nZW5lcmF0ZV9zYm9tGAUgASgLMh4uc2Nhbm9zcy52MS5HZW5lcmF0ZVNib21SZXN1bHRIABIsCgd2ZXJzaW9uGAYgASgLMhkuc2Nhbm9zcy52MS5WZXJzaW9uUmVzdWx0SAASIgoFZXJyb3IYZCABKAsyES5zY2Fub3NzLnYxLkVycm9ySABCCAoGcmVzdWx0ItgBCgtTY2FuQ29tbWFuZBIMCgRwYXRoGAEgASgJEigKBmZvcm1hdBgCIAEoDjIYLnNjYW5vc3MudjEuT3V0cHV0Rm9ybWF0EicKCXNjYW5fdHlwZRgDIAEoDjIULnNjYW5vc3MudjEuU2NhblR5cGUSDwoHaW5jbHVkZRgEIAMoCRIPCgdleGNsdWRlGAUgAygJEg8KB2FwaV91cmwYBiABKAkSDwoHYXBpX2tleRgHIAEoCRIPCgd0aHJlYWRzGAggASgFEhMKC3NraXBfaGlkZGVuGAkgASgIIo0BCgpTY2FuUmVzdWx0EiUKBWZpbGVzGAEgAygLMhYuc2Nhbm9zcy52MS5GaWxlUmVzdWx0EhMKC3RvdGFsX2ZpbGVzGAIgASgFEhoKEmZpbGVzX3dpdGhfbWF0Y2hlcxgDIAEoBRIVCg10b3RhbF9tYXRjaGVzGAQgASgFEhAKCHJhd19qc29uGAUgASgJInAKEkZpbHRlckZpbGVzQ29tbWFuZBIMCgRwYXRoGAEgASgJEg8KB2luY2x1ZGUYAiADKAkSDwoHZXhjbHVkZRgDIAMoCRITCgtza2lwX2hpZGRlbhgEIAEoCBIVCg1za2lwX3N5bWxpbmtzGAUgASgIImIKEUZpbHRlckZpbGVzUmVzdWx0EiMKBWZpbGVzGAEgAygLMhQuc2Nhbm9zcy52MS5GaWxlSW5mbxITCgt0b3RhbF9jb3VudBgCIAEoBRITCgt0b3RhbF9ieXRlcxgDIAEoAyJZChJGaW5nZXJwcmludENvbW1hbmQSDAoEcGF0aBgBIAEoCRIPCgdpbmNsdWRlGAIgAygJEg8KB2V4Y2x1ZGUYAyADKAkSEwoLb3V0cHV0X3BhdGgYBCABKAkiXgoRRmluZ2VycHJpbnRSZXN1bHQSCwoDd2ZwGAEgASgJEhMKC291dHB1dF9wYXRoGAIgASgJEhIKCmZpbGVfY291bnQYAyABKAUSEwoLdG90YWxfYnl0ZXMYBCABKAMihwEKE0dlbmVyYXRlU2JvbUNvbW1hbmQSEgoKaW5wdXRfcGF0aBgBIAEoCRIoCgZmb3JtYXQYAiABKA4yGC5zY2Fub3NzLnYxLk91dHB1dEZvcm1hdBITCgtvdXRwdXRfcGF0aBgDIAEoCRIMCgRuYW1lGAQgASgJEg8KB3ZlcnNpb24YBSABKAkiegoSR2VuZXJhdGVTYm9tUmVzdWx0EgwKBHNib20YASABKAkSEwoLb3V0cHV0X3BhdGgYAiABKAkSKAoGZm9ybWF0GAMgASgOMhguc2Nhbm9zcy52MS5PdXRwdXRGb3JtYXQSFwoPY29tcG9uZW50X2NvdW50GAQgASgFIhAKDlZlcnNpb25Db21tYW5kIlgKDVZlcnNpb25SZXN1bHQSDwoHdmVyc2lvbhgBIAEoCRIOCgZjb21taXQYAiABKAkSEgoKYnVpbGRfZGF0ZRgDIAEoCRISCgpnb192ZXJzaW9uGAQgASgJQk0KD2NvbS5zY2Fub3NzLmdlblABWjhnaXRodWIuY29tL3NjYW5vc3Mvc2Nhbm9zcy9jb3JlL2dlbi9zY2Fub3NzL3YxO3NjYW5vc3N2MWIGcHJvdG8z", [file_scanoss_v1_types, file_scanoss_v1_enums]);
+  fileDesc("ChlzY2Fub3NzL3YxL2NvbW1hbmRzLnByb3RvEgpzY2Fub3NzLnYxIqECCgdSZXF1ZXN0EgoKAmlkGAEgASgFEicKBHNjYW4YAiABKAsyFy5zY2Fub3NzLnYxLlNjYW5Db21tYW5kSAASNgoMZmlsdGVyX2ZpbGVzGAMgASgLMh4uc2Nhbm9zcy52MS5GaWx0ZXJGaWxlc0NvbW1hbmRIABI1CgtmaW5nZXJwcmludBgEIAEoCzIeLnNjYW5vc3MudjEuRmluZ2VycHJpbnRDb21tYW5kSAASOAoNZ2VuZXJhdGVfc2JvbRgFIAEoCzIfLnNjYW5vc3MudjEuR2VuZXJhdGVTYm9tQ29tbWFuZEgAEi0KB3ZlcnNpb24YBiABKAsyGi5zY2Fub3NzLnYxLlZlcnNpb25Db21tYW5kSABCCQoHY29tbWFuZCKFAwoIUmVzcG9uc2USCgoCaWQYASABKAUSEAoIaXNfZmluYWwYByABKAgSJgoEc2NhbhgCIAEoCzIWLnNjYW5vc3MudjEuU2NhblJlc3VsdEgAEjUKDGZpbHRlcl9maWxlcxgDIAEoCzIdLnNjYW5vc3MudjEuRmlsdGVyRmlsZXNSZXN1bHRIABI0CgtmaW5nZXJwcmludBgEIAEoCzIdLnNjYW5vc3MudjEuRmluZ2VycHJpbnRSZXN1bHRIABI3Cg1nZW5lcmF0ZV9zYm9tGAUgASgLMh4uc2Nhbm9zcy52MS5HZW5lcmF0ZVNib21SZXN1bHRIABIsCgd2ZXJzaW9uGAYgASgLMhkuc2Nhbm9zcy52MS5WZXJzaW9uUmVzdWx0SAASMQoNc2Nhbl9wcm9ncmVzcxgIIAEoCzIYLnNjYW5vc3MudjEuU2NhblByb2dyZXNzSAASIgoFZXJyb3IYZCABKAsyES5zY2Fub3NzLnYxLkVycm9ySABCCAoGcmVzdWx0IuwBCgtTY2FuQ29tbWFuZBIMCgRwYXRoGAEgASgJEigKBmZvcm1hdBgCIAEoDjIYLnNjYW5vc3MudjEuT3V0cHV0Rm9ybWF0EicKCXNjYW5fdHlwZRgDIAEoDjIULnNjYW5vc3MudjEuU2NhblR5cGUSDwoHaW5jbHVkZRgEIAMoCRIPCgdleGNsdWRlGAUgAygJEg8KB2FwaV91cmwYBiABKAkSDwoHYXBpX2tleRgHIAEoCRIPCgd0aHJlYWRzGAggASgFEhMKC3NraXBfaGlkZGVuGAkgASgIEhIKCmJhdGNoX3NpemUYCiABKAUiaAoMU2NhblByb2dyZXNzEhUKDWZpbGVzX3NjYW5uZWQYASABKAUSEwoLdG90YWxfZmlsZXMYAiABKAUSFAoMY3VycmVudF9maWxlGAMgASgJEhYKDm1hdGNoZXNfc29fZmFyGAQgASgFIo0BCgpTY2FuUmVzdWx0EiUKBWZpbGVzGAEgAygLMhYuc2Nhbm9zcy52MS5GaWxlUmVzdWx0EhMKC3RvdGFsX2ZpbGVzGAIgASgFEhoKEmZpbGVzX3dpdGhfbWF0Y2hlcxgDIAEoBRIVCg10b3RhbF9tYXRjaGVzGAQgASgFEhAKCHJhd19qc29uGAUgASgJInAKEkZpbHRlckZpbGVzQ29tbWFuZBIMCgRwYXRoGAEgASgJEg8KB2luY2x1ZGUYAiADKAkSDwoHZXhjbHVkZRgDIAMoCRITCgtza2lwX2hpZGRlbhgEIAEoCBIVCg1za2lwX3N5bWxpbmtzGAUgASgIImIKEUZpbHRlckZpbGVzUmVzdWx0EiMKBWZpbGVzGAEgAygLMhQuc2Nhbm9zcy52MS5GaWxlSW5mbxITCgt0b3RhbF9jb3VudBgCIAEoBRITCgt0b3RhbF9ieXRlcxgDIAEoAyJZChJGaW5nZXJwcmludENvbW1hbmQSDAoEcGF0aBgBIAEoCRIPCgdpbmNsdWRlGAIgAygJEg8KB2V4Y2x1ZGUYAyADKAkSEwoLb3V0cHV0X3BhdGgYBCABKAkiXgoRRmluZ2VycHJpbnRSZXN1bHQSCwoDd2ZwGAEgASgJEhMKC291dHB1dF9wYXRoGAIgASgJEhIKCmZpbGVfY291bnQYAyABKAUSEwoLdG90YWxfYnl0ZXMYBCABKAMihwEKE0dlbmVyYXRlU2JvbUNvbW1hbmQSEgoKaW5wdXRfcGF0aBgBIAEoCRIoCgZmb3JtYXQYAiABKA4yGC5zY2Fub3NzLnYxLk91dHB1dEZvcm1hdBITCgtvdXRwdXRfcGF0aBgDIAEoCRIMCgRuYW1lGAQgASgJEg8KB3ZlcnNpb24YBSABKAkiegoSR2VuZXJhdGVTYm9tUmVzdWx0EgwKBHNib20YASABKAkSEwoLb3V0cHV0X3BhdGgYAiABKAkSKAoGZm9ybWF0GAMgASgOMhguc2Nhbm9zcy52MS5PdXRwdXRGb3JtYXQSFwoPY29tcG9uZW50X2NvdW50GAQgASgFIhAKDlZlcnNpb25Db21tYW5kIlgKDVZlcnNpb25SZXN1bHQSDwoHdmVyc2lvbhgBIAEoCRIOCgZjb21taXQYAiABKAkSEgoKYnVpbGRfZGF0ZRgDIAEoCRISCgpnb192ZXJzaW9uGAQgASgJQk0KD2NvbS5zY2Fub3NzLmdlblABWjhnaXRodWIuY29tL3NjYW5vc3Mvc2Nhbm9zcy9jb3JlL2dlbi9zY2Fub3NzL3YxO3NjYW5vc3N2MWIGcHJvdG8z", [file_scanoss_v1_types, file_scanoss_v1_enums]);
 
 /**
  * Request envelope - wraps all commands
@@ -81,6 +81,13 @@ export type Response = Message<"scanoss.v1.Response"> & {
    */
   id: number;
 
+  /**
+   * True for final response (default behavior)
+   *
+   * @generated from field: bool is_final = 7;
+   */
+  isFinal: boolean;
+
   /**
    * @generated from oneof scanoss.v1.Response.result
    */
@@ -114,6 +121,14 @@ export type Response = Message<"scanoss.v1.Response"> & {
      */
     value: VersionResult;
     case: "version";
+  } | {
+    /**
+     * Progress update during scan
+     *
+     * @generated from field: scanoss.v1.ScanProgress scan_progress = 8;
+     */
+    value: ScanProgress;
+    case: "scanProgress";
   } | {
     /**
      * @generated from field: scanoss.v1.Error error = 100;
@@ -198,6 +213,13 @@ export type ScanCommand = Message<"scanoss.v1.ScanCommand"> & {
    * @generated from field: bool skip_hidden = 9;
    */
   skipHidden: boolean;
+
+  /**
+   * Files per batch for progress (0 = no progress)
+   *
+   * @generated from field: int32 batch_size = 10;
+   */
+  batchSize: number;
 };
 
 /**
@@ -207,6 +229,48 @@ export type ScanCommand = Message<"scanoss.v1.ScanCommand"> & {
 export const ScanCommandSchema: GenMessage<ScanCommand> = /*@__PURE__*/
   messageDesc(file_scanoss_v1_commands, 2);
 
+/**
+ * Progress update during scan
+ *
+ * @generated from message scanoss.v1.ScanProgress
+ */
+export type ScanProgress = Message<"scanoss.v1.ScanProgress"> & {
+  /**
+   * Number of files scanned so far
+   *
+   * @generated from field: int32 files_scanned = 1;
+   */
+  filesScanned: number;
+
+  /**
+   * Total number of files to scan
+   *
+   * @generated from field: int32 total_files = 2;
+   */
+  totalFiles: number;
+
+  /**
+   * Current file being processed
+   *
+   * @generated from field: string current_file = 3;
+   */
+  currentFile: string;
+
+  /**
+   * Matches found so far
+   *
+   * @generated from field: int32 matches_so_far = 4;
+   */
+  matchesSoFar: number;
+};
+
+/**
+ * Describes the message scanoss.v1.ScanProgress.
+ * Use `create(ScanProgressSchema)` to create a new message.
+ */
+export const ScanProgressSchema: GenMessage<ScanProgress> = /*@__PURE__*/
+  messageDesc(file_scanoss_v1_commands, 3);
+
 /**
  * Scan result
  *
@@ -246,7 +310,7 @@ export type ScanResult = Message<"scanoss.v1.ScanResult"> & {
  * Use `create(ScanResultSchema)` to create a new message.
  */
 export const ScanResultSchema: GenMessage<ScanResult> = /*@__PURE__*/
-  messageDesc(file_scanoss_v1_commands, 3);
+  messageDesc(file_scanoss_v1_commands, 4);
 
 /**
  * List files that would be scanned (dry run)
@@ -295,7 +359,7 @@ export type FilterFilesCommand = Message<"scanoss.v1.FilterFilesCommand"> & {
  * Use `create(FilterFilesCommandSchema)` to create a new message.
  */
 export const FilterFilesCommandSchema: GenMessage<FilterFilesCommand> = /*@__PURE__*/
-  messageDesc(file_scanoss_v1_commands, 4);
+  messageDesc(file_scanoss_v1_commands, 5);
 
 /**
  * Filter files result
@@ -324,7 +388,7 @@ export type FilterFilesResult = Message<"scanoss.v1.FilterFilesResult"> & {
  * Use `create(FilterFilesResultSchema)` to create a new message.
  */
 export const FilterFilesResultSchema: GenMessage<FilterFilesResult> = /*@__PURE__*/
-  messageDesc(file_scanoss_v1_commands, 5);
+  messageDesc(file_scanoss_v1_commands, 6);
 
 /**
  * Generate WFP fingerprints without scanning
@@ -366,7 +430,7 @@ export type FingerprintCommand = Message<"scanoss.v1.FingerprintCommand"> & {
  * Use `create(FingerprintCommandSchema)` to create a new message.
  */
 export const FingerprintCommandSchema: GenMessage<FingerprintCommand> = /*@__PURE__*/
-  messageDesc(file_scanoss_v1_commands, 6);
+  messageDesc(file_scanoss_v1_commands, 7);
 
 /**
  * Fingerprint result
@@ -404,7 +468,7 @@ export type FingerprintResult = Message<"scanoss.v1.FingerprintResult"> & {
  * Use `create(FingerprintResultSchema)` to create a new message.
  */
 export const FingerprintResultSchema: GenMessage<FingerprintResult> = /*@__PURE__*/
-  messageDesc(file_scanoss_v1_commands, 7);
+  messageDesc(file_scanoss_v1_commands, 8);
 
 /**
  * Generate SBOM from scan results
@@ -453,7 +517,7 @@ export type GenerateSbomCommand = Message<"scanoss.v1.GenerateSbomCommand"> & {
  * Use `create(GenerateSbomCommandSchema)` to create a new message.
  */
 export const GenerateSbomCommandSchema: GenMessage<GenerateSbomCommand> = /*@__PURE__*/
-  messageDesc(file_scanoss_v1_commands, 8);
+  messageDesc(file_scanoss_v1_commands, 9);
 
 /**
  * Generate SBOM result
@@ -491,7 +555,7 @@ export type GenerateSbomResult = Message<"scanoss.v1.GenerateSbomResult"> & {
  * Use `create(GenerateSbomResultSchema)` to create a new message.
  */
 export const GenerateSbomResultSchema: GenMessage<GenerateSbomResult> = /*@__PURE__*/
-  messageDesc(file_scanoss_v1_commands, 9);
+  messageDesc(file_scanoss_v1_commands, 10);
 
 /**
  * Get version information
@@ -506,7 +570,7 @@ export type VersionCommand = Message<"scanoss.v1.VersionCommand"> & {
  * Use `create(VersionCommandSchema)` to create a new message.
  */
 export const VersionCommandSchema: GenMessage<VersionCommand> = /*@__PURE__*/
-  messageDesc(file_scanoss_v1_commands, 10);
+  messageDesc(file_scanoss_v1_commands, 11);
 
 /**
  * Version result
@@ -540,5 +604,5 @@ export type VersionResult = Message<"scanoss.v1.VersionResult"> & {
  * Use `create(VersionResultSchema)` to create a new message.
  */
 export const VersionResultSchema: GenMessage<VersionResult> = /*@__PURE__*/
-  messageDesc(file_scanoss_v1_commands, 11);
+  messageDesc(file_scanoss_v1_commands, 12);
 

package/src/types.ts

@@ -30,6 +30,17 @@ export interface FileResult {
   matches: Match[];
 }
 
+/** Progress information during scan */
+export interface ScanProgress {
+  filesScanned: number;
+  totalFiles: number;
+  currentFile: string;
+  matchesSoFar: number;
+}
+
+/** Progress callback function */
+export type ProgressCallback = (progress: ScanProgress) => void;
+
 /** Scan command parameters */
 export interface ScanParams {
   path: string;
@@ -39,6 +50,10 @@ export interface ScanParams {
   exclude?: string[];
   apiUrl?: string;
   apiKey?: string;
+  /** Number of files per batch for progress reporting (0 = no progress) */
+  batchSize?: number;
+  /** Callback function for progress updates */
+  onProgress?: ProgressCallback;
 }
 
 /** Scan result */