@siglume/api-sdk 3.0.0 → 3.1.0

package/dist/cli/index.d.cts

@@ -396,6 +396,7 @@ interface RegistrationQuality {
 interface RegistrationConfirmation {
     listing_id: string;
     status: string;
+    visibility?: string | null;
     message?: string | null;
     checklist?: Record<string, boolean>;
     release: Record<string, unknown>;
@@ -1215,6 +1216,8 @@ interface SiglumeClientShape {
     confirm_registration(listing_id: string, options?: {
         manifest?: AppManifest | Record<string, unknown>;
         tool_manual?: ToolManual | Record<string, unknown>;
+        version_bump?: "patch" | "minor" | "major";
+        visibility?: "public" | "private";
     }): Promise<RegistrationConfirmation>;
     preview_quality_score(tool_manual: ToolManual | Record<string, unknown>): Promise<ToolManualQualityReport>;
     submit_review(listing_id: string): Promise<AppListingRecord>;

package/dist/cli/index.d.ts

@@ -396,6 +396,7 @@ interface RegistrationQuality {
 interface RegistrationConfirmation {
     listing_id: string;
     status: string;
+    visibility?: string | null;
     message?: string | null;
     checklist?: Record<string, boolean>;
     release: Record<string, unknown>;
@@ -1215,6 +1216,8 @@ interface SiglumeClientShape {
     confirm_registration(listing_id: string, options?: {
         manifest?: AppManifest | Record<string, unknown>;
         tool_manual?: ToolManual | Record<string, unknown>;
+        version_bump?: "patch" | "minor" | "major";
+        visibility?: "public" | "private";
     }): Promise<RegistrationConfirmation>;
     preview_quality_score(tool_manual: ToolManual | Record<string, unknown>): Promise<ToolManualQualityReport>;
     submit_review(listing_id: string): Promise<AppListingRecord>;

package/dist/cli/index.js

@@ -2544,8 +2544,12 @@ var init_client = __esm({
         };
       }
       async confirm_registration(listing_id, options = {}) {
-        const { version_bump: versionBump } = options;
+        const { version_bump: versionBump, visibility = "public" } = options;
         const payload = { approved: true };
+        if (visibility !== "public" && visibility !== "private") {
+          throw new Error(`visibility must be one of ["public","private"], got ${JSON.stringify(visibility)}`);
+        }
+        payload.visibility = visibility;
         if (versionBump !== void 0) {
           const allowed = ["patch", "minor", "major"];
           if (!allowed.includes(versionBump)) {
@@ -2563,6 +2567,7 @@ var init_client = __esm({
         return {
           listing_id: String(data.listing_id ?? listing_id),
           status: String(data.status ?? ""),
+          visibility: stringOrNull(data.visibility),
           message: stringOrNull(data.message),
           checklist,
           release: toRecord(data.release),
@@ -7058,7 +7063,9 @@ async function runRegistration(path = ".", options = {}, deps = {}) {
   }
   const shouldConfirm = Boolean(options.confirm) || options.confirm === void 0 && !options.draft_only && !options.submit_review;
   if (shouldConfirm) {
-    result.confirmation = toJsonable(await client.confirm_registration(receipt.listing_id));
+    result.confirmation = toJsonable(await client.confirm_registration(receipt.listing_id, {
+      visibility: options.confirm_visibility ?? "public"
+    }));
     if (options.submit_review) {
       result.submit_review_skipped = true;
     }
@@ -8335,26 +8342,44 @@ async function runCli(argv, deps = {}) {
     }
     if (report.runtime_validation_path) emit(stdout, `runtime_validation_path: ${String(report.runtime_validation_path)}`);
   });
-  program.command("register").option("--confirm", "explicitly confirm the registration; this is the default unless --draft-only is set", false).option("--draft-only", "create or refresh the draft without confirming publication", false).option("--submit-review", "legacy alias: publish immediately if your environment still routes through submit-review", false).option("--json", "emit machine-readable JSON", false).argument("[path]", ".", "project path").action(async (path, options) => {
+  program.command("register").option("--confirm", "explicitly confirm the registration; this is the default unless --draft-only is set", false).option("--private-confirm", "confirm the registration for private production testing without publishing it", false).option("--draft-only", "create or refresh the draft without confirming publication", false).option("--submit-review", "legacy alias: publish immediately if your environment still routes through submit-review", false).option("--json", "emit machine-readable JSON", false).argument("[path]", ".", "project path").action(async (path, options) => {
     const draftOnly = Boolean(options.draftOnly);
+    const privateConfirm = Boolean(options.privateConfirm);
     if (draftOnly && options.confirm) {
       throw new SiglumeProjectError("--draft-only cannot be combined with --confirm.");
     }
+    if (draftOnly && privateConfirm) {
+      throw new SiglumeProjectError("--draft-only cannot be combined with --private-confirm.");
+    }
+    if (options.confirm && privateConfirm) {
+      throw new SiglumeProjectError("--confirm cannot be combined with --private-confirm.");
+    }
     if (draftOnly && options.submitReview) {
       throw new SiglumeProjectError("--draft-only cannot be combined with --submit-review.");
     }
-    const shouldConfirm = Boolean(options.confirm) || !draftOnly && !options.submitReview;
+    if (privateConfirm && options.submitReview) {
+      throw new SiglumeProjectError("--private-confirm cannot be combined with --submit-review.");
+    }
+    const shouldConfirm = Boolean(options.confirm) || privateConfirm || !draftOnly && !options.submitReview;
     const report = await runRegistration(path, {
       confirm: shouldConfirm,
+      confirm_visibility: privateConfirm ? "private" : "public",
       draft_only: draftOnly,
       submit_review: options.submitReview
     }, deps);
+    if (privateConfirm && report.confirmation && !report.confirmation.visibility) {
+      report.confirmation.visibility = "private";
+    }
     if (options.json) {
       emit(stdout, renderJson(report));
     } else {
       const receipt = report.receipt;
-      const published = Boolean(report.confirmation || report.review);
-      if (published && receipt.registration_mode === "upgrade") {
+      const confirmationSummary = report.confirmation;
+      const privatelyConfirmed = confirmationSummary?.visibility === "private";
+      const published = !privatelyConfirmed && Boolean(report.confirmation || report.review);
+      if (privatelyConfirmed) {
+        emit(stdout, "Registration privately confirmed.");
+      } else if (published && receipt.registration_mode === "upgrade") {
         emit(stdout, "Upgrade registered.");
       } else if (published) {
         emit(stdout, "Registration accepted.");
@@ -8373,8 +8398,9 @@ async function runCli(argv, deps = {}) {
       if (receipt.request_id) emit(stdout, `request_id: ${receipt.request_id}`);
       if (report.confirmation) {
         const confirmation = report.confirmation;
-        emit(stdout, "Listing published.");
+        emit(stdout, confirmation.visibility === "private" ? "Listing confirmed privately for production testing." : "Listing published.");
         if (confirmation.status) emit(stdout, `confirmation_status: ${confirmation.status}`);
+        if (confirmation.visibility) emit(stdout, `confirmation_visibility: ${confirmation.visibility}`);
         if (confirmation.release?.release_status) emit(stdout, `release_status: ${confirmation.release.release_status}`);
       } else if (report.review) {
         const review = report.review;