hedge-broker 0.2.0 → 0.3.1

package/dist/index.js

@@ -565,12 +565,26 @@ function registerSubmissions(program2) {
     const r = await apiRequest(ctx.client, "GET", `/broker/submissions/${submissionId}/requirements`);
     if (ctx.json) return printJson(r);
     process.stdout.write(kv({ insured: r.insured_name, lines: (r.lines || []).join(", "), state: r.state, forms: (r.forms || []).join(", ") }) + "\n");
+    if (r.forms?.length) {
+      process.stdout.write("(download blanks with: hedge form <form_key>)\n");
+    }
     if (r.markets?.length) {
       process.stdout.write("\nMarkets:\n" + table(r.markets.map((m) => ({
         market: m.market_name,
         ready: m.ready ? "yes" : "no",
         needs_from_you: (m.needs_from_you || []).join("; ")
       })), ["market", "ready", "needs_from_you"]) + "\n");
+    } else {
+      const hint = typeof r.marketing_hint === "string" && r.marketing_hint ? r.marketing_hint : null;
+      if (r.marketing_status === "matching") {
+        process.stdout.write("\nNo markets yet - " + (hint ?? "Hedge is matching carrier markets now (usually ~5 minutes after finalize); re-run this in a few minutes.") + "\n");
+      } else if (r.marketing_status === "not_started") {
+        process.stdout.write("\nNo markets yet - " + (hint ?? "run hedge finalize " + submissionId + " to start marketing.") + "\n");
+      } else if (r.marketing_status === "no_markets_matched") {
+        process.stdout.write("\nNo markets attached - " + (hint ?? "Hedge is reviewing options for this risk and will follow up.") + "\n");
+      } else {
+        process.stdout.write("\nNo markets yet. If you just finalized, matching usually completes within ~5 minutes - re-run this shortly or use hedge status " + submissionId + ".\n");
+      }
     }
     if (r.carrier_api_sessions?.length) {
       process.stdout.write("\nInstant-quote carriers:\n" + table(r.carrier_api_sessions.map((s) => ({
@@ -594,6 +608,8 @@ function registerSubmissions(program2) {
         status: l.status_label ?? l.status,
         quote: l.quote_premium ?? ""
       }))), ["carrier", "line", "status", "quote"]) + "\n");
+    } else {
+      process.stdout.write("\nNo markets attached yet. Matching usually completes within ~5 minutes of finalize - re-run this shortly (or check hedge requirements " + submissionId + ").\n");
     }
     const byStatus = s.status_summary?.by_status;
     if (byStatus && Object.keys(byStatus).length) {
@@ -617,11 +633,74 @@ function registerSubmissions(program2) {
       premium: r.premium ?? ""
     })), ["id", "insured", "lines", "status", "premium"]) + "\n");
   });
-  program2.command("finalize <submissionId>").description("Start marketing the submission to carriers").action(async (submissionId) => {
+  program2.command("finalize <submissionId>").description("Start marketing the submission to carriers").option("--wait", "poll until markets attach (usually ~5 minutes), then print them").option("--timeout <minutes>", "how long --wait polls before giving up", "8").action(async (submissionId, opts) => {
     const ctx = makeCtx(program2.opts());
     const r = await apiRequest(ctx.client, "POST", `/broker/submissions/${submissionId}/finalize`);
-    if (ctx.json) return printJson(r);
-    process.stdout.write("Marketing started. Track with: hedge status " + submissionId + "\n");
+    if (ctx.json && !opts.wait) return printJson(r);
+    if (!opts.wait) {
+      const wait = Number(r.typical_wait_seconds) > 0 ? Math.round(Number(r.typical_wait_seconds) / 60) : 5;
+      process.stdout.write(
+        `Marketing started. Markets usually attach within ~${wait} minutes.
+Track with: hedge status ${submissionId}  (or use finalize --wait next time)
+`
+      );
+      return;
+    }
+    const timeoutMin = intFlag(opts.timeout, "--timeout");
+    const deadline = Date.now() + Math.max(1, timeoutMin) * 6e4;
+    process.stdout.write("Marketing started - waiting for markets to attach (usually ~5 minutes)");
+    let markets = [];
+    while (Date.now() < deadline) {
+      await new Promise((resolve) => setTimeout(resolve, 15e3));
+      process.stdout.write(".");
+      const s = await apiRequest(ctx.client, "GET", `/broker/submissions/${submissionId}`);
+      if (s.markets?.length) {
+        markets = s.markets;
+        break;
+      }
+    }
+    process.stdout.write("\n");
+    if (!markets.length) {
+      process.stdout.write(
+        `Still matching after ${timeoutMin} minutes - this can occasionally take longer.
+Check in with: hedge status ${submissionId}  or  hedge requirements ${submissionId}
+`
+      );
+      return;
+    }
+    const rows = markets.flatMap((m) => (m.lines || []).map((l) => ({
+      carrier: m.carrier_name,
+      line: l.lob_label ?? l.lob_slug,
+      status: l.status_label ?? l.status
+    })));
+    if (ctx.json) return printJson({ finalize: r, markets });
+    process.stdout.write(`Matched ${markets.length} market(s):
+
+` + table(rows, ["carrier", "line", "status"]) + "\n");
+    process.stdout.write("\nNext: hedge requirements " + submissionId + " shows what each market still needs from you.\n");
+  });
+  program2.command("forms [search]").description('Search the blank application-form catalog, e.g. hedge forms "liquor"').action(async (search) => {
+    const ctx = makeCtx(program2.opts());
+    const rows = await apiRequest(ctx.client, "GET", "/broker/forms", {
+      query: { q: search }
+    });
+    if (ctx.json) return printJson(rows);
+    if (!rows.length) {
+      process.stdout.write("No forms matched" + (search ? ` "${search}"` : "") + ".\n");
+      return;
+    }
+    process.stdout.write(table(rows.map((f) => ({
+      form_key: f.form_key,
+      title: f.title ?? "",
+      acord: f.is_acord ? "yes" : "",
+      pages: f.page_count ?? ""
+    })), ["form_key", "title", "acord", "pages"]) + "\n");
+    process.stdout.write("\nDownload a blank with: hedge form <form_key>\n");
+  });
+  program2.command("form <formKey>").description("Download a blank application form by its catalog key (the keys `hedge requirements` lists)").option("-o, --output <file>", "output file (default <formKey>.pdf)").action(async (formKey, opts) => {
+    const ctx = makeCtx(program2.opts());
+    const out = await downloadRequest(ctx.client, "GET", `/broker/forms/${encodeURIComponent(formKey)}/pdf`, opts.output, `${formKey}.pdf`);
+    process.stdout.write("Saved " + out + "\n");
   });
   program2.command("documents <submissionId>").description("List a submission's finalized documents (ACORDs, quotes, binders)").action(async (submissionId) => {
     const ctx = makeCtx(program2.opts());
@@ -794,7 +873,7 @@ function registerQuotes(program2) {
 
 // src/index.ts
 var program = new Command();
-program.name("hedge").description("Submit risks to Hedge and track them from your terminal.").version("0.2.0").option("--staging", "use the staging environment").option("--json", "output raw JSON (for scripting)");
+program.name("hedge").description("Submit risks to Hedge and track them from your terminal.").version("0.3.1").option("--staging", "use the staging environment").option("--json", "output raw JSON (for scripting)");
 registerAuth(program);
 registerSubmissions(program);
 registerAppetite(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hedge-broker",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Command-line tool for the Hedge broker portal. Submit risks, check appetite, track quotes and policies.",
   "type": "module",
   "bin": { "hedge": "dist/index.js" },