react-semaphor 0.1.314 → 0.1.316

package/dist/briefings/index.js

@@ -0,0 +1,848 @@
+var P = Object.defineProperty;
+var G = (t, n, e) => n in t ? P(t, n, { enumerable: !0, configurable: !0, writable: !0, value: e }) : t[n] = e;
+var x = (t, n, e) => G(t, typeof n != "symbol" ? n + "" : n, e);
+const A = "BRIEFING", U = ["markdown", "html"], v = ["markdown"], ue = 20, c = {
+  name: 500,
+  description: 2e3,
+  instruction: 5e4,
+  customMessage: 5e4,
+  attachmentTitle: 500,
+  presentationAudience: 1e3,
+  presentationTone: 500,
+  presentationFormat: 2e3,
+  id: 500
+}, z = new Set(U), H = /* @__PURE__ */ new Set([
+  "EMAIL",
+  "WEBHOOK",
+  "SLACK",
+  "IN_APP",
+  "TELEGRAM"
+]), $ = {
+  maxToolCalls: { min: 1, max: 100 },
+  maxRows: { min: 1, max: 1e5 },
+  timeoutMs: { min: 1e3, max: 30 * 6e4 }
+}, q = /* @__PURE__ */ new Set([
+  "letter",
+  "legal",
+  "a4",
+  "a3",
+  "tabloid"
+]), K = /* @__PURE__ */ new Set([
+  "portrait",
+  "landscape"
+]), X = /* @__PURE__ */ new Set([",", ";", "	"]), J = [
+  "pageSize",
+  "orientation",
+  "includeFilters",
+  "includeTimestamp",
+  "delimiter",
+  "includeHeaders",
+  "useFormattedValues",
+  "sheetSelection",
+  "currentSheetId",
+  "currentSheetName",
+  "filterValues",
+  "inlineFilterValues",
+  "sheetFilterValues",
+  "filterLine",
+  "controlValues",
+  "controlDefinitions",
+  "cardControlDefinitions",
+  "controlBindings",
+  "tablePreferences",
+  "dashboardInputExecutionSnapshot",
+  "selectedSheetId",
+  "cardType",
+  "theme"
+];
+class S extends Error {
+  constructor(e) {
+    super(e.map((r) => `${r.field}: ${r.message}`).join("; "));
+    x(this, "issues");
+    this.name = "BriefingContractError", this.issues = e;
+  }
+}
+function F(t) {
+  return typeof t == "object" && t !== null && !Array.isArray(t);
+}
+function d(t, n, e) {
+  t.push({ field: n, message: e });
+}
+function m(t, n, e) {
+  return F(t) ? t : (d(e, n, "Expected an object."), {});
+}
+function l(t, n, e, r) {
+  const o = new Set(e);
+  Object.keys(t).forEach((i) => {
+    o.has(i) || d(
+      r,
+      n ? `${n}.${i}` : i,
+      `Unexpected field "${i}".`
+    );
+  });
+}
+function f(t, n, e, r) {
+  if (typeof t != "string")
+    return d(r, n, "Expected a string."), "";
+  const o = t.trim();
+  return o ? (o.length > e && d(r, n, `Must be ${e} characters or fewer.`), o) : (d(r, n, "Required value cannot be empty."), "");
+}
+function u(t, n, e, r) {
+  if (t == null)
+    return;
+  if (typeof t != "string") {
+    d(r, n, "Expected a string.");
+    return;
+  }
+  const o = t.trim();
+  if (o)
+    return o.length > e && d(r, n, `Must be ${e} characters or fewer.`), o;
+}
+function C(t, n, e, r) {
+  return t == null ? n : typeof t != "boolean" ? (d(r, e, "Expected a boolean."), n) : t;
+}
+function W(t, n) {
+  return t == null ? "ACTIVE" : t === "ACTIVE" || t === "PAUSED" || t === "DISABLED" ? t : (d(n, "status", "Expected ACTIVE, PAUSED, or DISABLED."), "ACTIVE");
+}
+function Y(t) {
+  return t.includes("@") && t.includes(".") && !t.includes(" ");
+}
+function O(t, n) {
+  if (t == null)
+    return { type: "project" };
+  const e = m(t, "source", n), r = e.type;
+  return r === "project" ? (l(e, "source", ["type"], n), { type: "project" }) : r === "dashboard" ? (l(e, "source", ["type", "dashboardId"], n), {
+    type: "dashboard",
+    dashboardId: f(
+      e.dashboardId,
+      "source.dashboardId",
+      c.id,
+      n
+    )
+  }) : (d(n, "source.type", "Expected project or dashboard."), { type: "project" });
+}
+function B(t, n) {
+  const e = m(t, "body", n), r = e.type;
+  return r === "generated_analysis" ? (l(e, "body", ["type", "instruction"], n), {
+    type: "generated_analysis",
+    instruction: f(
+      e.instruction,
+      "body.instruction",
+      c.instruction,
+      n
+    )
+  }) : r === "custom_message" ? (l(e, "body", ["type", "message"], n), {
+    type: "custom_message",
+    message: f(
+      e.message,
+      "body.message",
+      c.customMessage,
+      n
+    )
+  }) : r === "none" ? (l(e, "body", ["type"], n), { type: "none" }) : (d(
+    n,
+    "body.type",
+    "Expected generated_analysis, custom_message, or none."
+  ), { type: "none" });
+}
+function Z(t, n) {
+  if (t == null)
+    return [...v];
+  if (!Array.isArray(t))
+    return d(n, "presentation.artifactFormats", "Expected an array."), [...v];
+  if (t.length === 0)
+    return d(
+      n,
+      "presentation.artifactFormats",
+      "Choose at least one artifact format."
+    ), [];
+  const e = [];
+  return t.forEach((r, o) => {
+    if (typeof r != "string" || !z.has(r)) {
+      d(
+        n,
+        `presentation.artifactFormats.${o}`,
+        "Expected markdown or html."
+      );
+      return;
+    }
+    e.includes(r) || e.push(r);
+  }), e;
+}
+function R(t, n) {
+  if (t == null)
+    return {
+      artifactFormats: [...v],
+      includeEvidence: !0,
+      includeSql: !0
+    };
+  const e = m(t, "presentation", n);
+  l(
+    e,
+    "presentation",
+    ["artifactFormats", "includeEvidence", "includeSql", "audience", "tone", "format"],
+    n
+  );
+  const r = {
+    artifactFormats: Z(e.artifactFormats, n),
+    includeEvidence: C(
+      e.includeEvidence,
+      !0,
+      "presentation.includeEvidence",
+      n
+    ),
+    includeSql: C(
+      e.includeSql,
+      !0,
+      "presentation.includeSql",
+      n
+    )
+  }, o = u(
+    e.audience,
+    "presentation.audience",
+    c.presentationAudience,
+    n
+  ), i = u(
+    e.tone,
+    "presentation.tone",
+    c.presentationTone,
+    n
+  ), a = u(
+    e.format,
+    "presentation.format",
+    c.presentationFormat,
+    n
+  );
+  return o && (r.audience = o), i && (r.tone = i), a && (r.format = a), r;
+}
+function g(t, n, e, r) {
+  return typeof t == "string" && e.includes(t) ? t : (d(r, n, `Expected ${e.join(" or ")}.`), e[0]);
+}
+function I(t, n, e, r, o) {
+  if (t != null) {
+    if (typeof t == "string" && e.has(t))
+      return t;
+    d(o, n, `Expected ${r}.`);
+  }
+}
+function Q(t, n, e) {
+  if (t != null) {
+    if (!Array.isArray(t)) {
+      d(e, n, "Expected an array.");
+      return;
+    }
+    return t;
+  }
+}
+function ee(t, n, e) {
+  if (t != null) {
+    if (!F(t)) {
+      d(e, n, "Expected an object.");
+      return;
+    }
+    return t;
+  }
+}
+function te(t, n, e) {
+  if (t == null)
+    return;
+  const r = m(t, n, e);
+  l(r, n, J, e);
+  const o = {}, i = I(
+    r.pageSize,
+    `${n}.pageSize`,
+    q,
+    "letter, legal, a4, a3, or tabloid",
+    e
+  ), a = I(
+    r.orientation,
+    `${n}.orientation`,
+    K,
+    "portrait or landscape",
+    e
+  ), p = I(
+    r.delimiter,
+    `${n}.delimiter`,
+    X,
+    "comma, semicolon, or tab",
+    e
+  ), y = I(
+    r.sheetSelection,
+    `${n}.sheetSelection`,
+    /* @__PURE__ */ new Set(["current", "all"]),
+    "current or all",
+    e
+  );
+  i && (o.pageSize = i), a && (o.orientation = a), p && (o.delimiter = p), y && (o.sheetSelection = y);
+  for (const s of [
+    "includeFilters",
+    "includeTimestamp",
+    "includeHeaders",
+    "useFormattedValues"
+  ])
+    if (!(r[s] === void 0 || r[s] === null)) {
+      if (typeof r[s] != "boolean") {
+        d(e, `${n}.${s}`, "Expected a boolean.");
+        continue;
+      }
+      o[s] = r[s];
+    }
+  for (const s of [
+    "currentSheetId",
+    "currentSheetName",
+    "filterLine",
+    "selectedSheetId",
+    "cardType",
+    "theme"
+  ]) {
+    const h = u(
+      r[s],
+      `${n}.${s}`,
+      c.id,
+      e
+    );
+    h && (o[s] = h);
+  }
+  for (const s of [
+    "filterValues",
+    "inlineFilterValues",
+    "sheetFilterValues",
+    "controlDefinitions",
+    "cardControlDefinitions",
+    "controlBindings"
+  ]) {
+    const h = Q(r[s], `${n}.${s}`, e);
+    h && (o[s] = h);
+  }
+  for (const s of [
+    "controlValues",
+    "tablePreferences",
+    "dashboardInputExecutionSnapshot"
+  ]) {
+    const h = ee(r[s], `${n}.${s}`, e);
+    h && (o[s] = h);
+  }
+  return Object.keys(o).length > 0 ? o : void 0;
+}
+function b(t, n, e, r) {
+  const o = u(
+    n,
+    e,
+    c.attachmentTitle,
+    r
+  );
+  return o && (t.title = o), t;
+}
+function E(t, n, e, r) {
+  const o = te(n, e, r);
+  return o && (t.settings = o), t;
+}
+function ne(t, n, e) {
+  const r = `attachments.${n}`, o = m(t, r, e), i = o.type;
+  if (i === "dashboard") {
+    l(
+      o,
+      r,
+      ["type", "dashboardId", "format", "title", "settings"],
+      e
+    );
+    const a = b(
+      {
+        type: "dashboard",
+        dashboardId: f(
+          o.dashboardId,
+          `${r}.dashboardId`,
+          c.id,
+          e
+        ),
+        format: g(o.format, `${r}.format`, ["pdf"], e)
+      },
+      o.title,
+      `${r}.title`,
+      e
+    );
+    return E(a, o.settings, `${r}.settings`, e);
+  }
+  if (i === "dashboard_sheet" || i === "document_sheet") {
+    l(
+      o,
+      r,
+      ["type", "dashboardId", "sheetId", "format", "title", "settings"],
+      e
+    );
+    const a = b(
+      {
+        type: i,
+        dashboardId: f(
+          o.dashboardId,
+          `${r}.dashboardId`,
+          c.id,
+          e
+        ),
+        sheetId: f(
+          o.sheetId,
+          `${r}.sheetId`,
+          c.id,
+          e
+        ),
+        format: g(o.format, `${r}.format`, ["pdf"], e)
+      },
+      o.title,
+      `${r}.title`,
+      e
+    );
+    return E(a, o.settings, `${r}.settings`, e);
+  }
+  if (i === "visual") {
+    l(
+      o,
+      r,
+      ["type", "dashboardId", "visualId", "format", "title", "settings"],
+      e
+    );
+    const a = b(
+      {
+        type: "visual",
+        dashboardId: f(
+          o.dashboardId,
+          `${r}.dashboardId`,
+          c.id,
+          e
+        ),
+        visualId: f(
+          o.visualId,
+          `${r}.visualId`,
+          c.id,
+          e
+        ),
+        format: g(
+          o.format,
+          `${r}.format`,
+          ["pdf", "png"],
+          e
+        )
+      },
+      o.title,
+      `${r}.title`,
+      e
+    );
+    return E(a, o.settings, `${r}.settings`, e);
+  }
+  if (i === "card") {
+    l(
+      o,
+      r,
+      ["type", "dashboardId", "cardId", "format", "title", "settings"],
+      e
+    );
+    const a = b(
+      {
+        type: "card",
+        dashboardId: f(
+          o.dashboardId,
+          `${r}.dashboardId`,
+          c.id,
+          e
+        ),
+        cardId: f(
+          o.cardId,
+          `${r}.cardId`,
+          c.id,
+          e
+        ),
+        format: g(
+          o.format,
+          `${r}.format`,
+          ["csv", "pdf", "png"],
+          e
+        )
+      },
+      o.title,
+      `${r}.title`,
+      e
+    );
+    return E(a, o.settings, `${r}.settings`, e);
+  }
+  return d(
+    e,
+    `${r}.type`,
+    "Expected dashboard, dashboard_sheet, document_sheet, visual, or card."
+  ), { type: "dashboard", dashboardId: "", format: "pdf" };
+}
+function re(t) {
+  switch (t.type) {
+    case "dashboard":
+      return `${t.type}:${t.dashboardId}:${t.format}`;
+    case "dashboard_sheet":
+    case "document_sheet":
+      return `${t.type}:${t.dashboardId}:${t.sheetId}:${t.format}`;
+    case "visual":
+      return `${t.type}:${t.dashboardId}:${t.visualId}:${t.format}`;
+    case "card":
+      return `${t.type}:${t.dashboardId}:${t.cardId}:${t.format}`;
+  }
+}
+function D(t, n) {
+  if (t == null)
+    return [];
+  if (!Array.isArray(t))
+    return d(n, "attachments", "Expected an array."), [];
+  t.length > 20 && d(
+    n,
+    "attachments",
+    "Choose 20 attachments or fewer."
+  );
+  const e = t.slice(0, 20).map((o, i) => ne(o, i, n)), r = /* @__PURE__ */ new Set();
+  return e.forEach((o, i) => {
+    const a = re(o);
+    r.has(a) && d(n, `attachments.${i}`, "Duplicate attachment."), r.add(a);
+  }), e;
+}
+function V(t, n) {
+  if (t == null)
+    return;
+  const e = m(t, "limits", n);
+  l(e, "limits", Object.keys($), n);
+  const r = {};
+  return Object.keys($).forEach((o) => {
+    const i = e[o];
+    if (i == null)
+      return;
+    const a = $[o];
+    if (typeof i != "number" || !Number.isInteger(i) || i < a.min || i > a.max) {
+      d(
+        n,
+        `limits.${o}`,
+        `Expected an integer between ${a.min} and ${a.max}.`
+      );
+      return;
+    }
+    r[o] = i;
+  }), Object.keys(r).length > 0 ? r : void 0;
+}
+function N(t) {
+  if (t.length > 0)
+    throw new S(t);
+}
+function j(t, n, e) {
+  t.type === "none" && n.length === 0 && d(
+    e,
+    "body",
+    "Add briefing instructions, a custom message, or at least one attachment."
+  );
+}
+function w(t) {
+  const n = [], e = m(t, "jobConfig", n);
+  l(
+    e,
+    "jobConfig",
+    ["kind", "source", "body", "attachments", "presentation", "limits"],
+    n
+  ), e.kind !== A && d(n, "kind", "Expected BRIEFING.");
+  const r = O(e.source, n), o = B(e.body, n), i = D(e.attachments, n), a = R(e.presentation, n), p = V(e.limits, n);
+  return j(o, i, n), N(n), {
+    kind: A,
+    source: r,
+    body: o,
+    attachments: i,
+    presentation: a,
+    ...p ? { limits: p } : {}
+  };
+}
+function pe(t) {
+  return w({
+    ...t,
+    kind: A
+  });
+}
+function oe(t, n, e) {
+  const r = `deliveryConfig.recipients.${n}`, o = m(t, r, e), i = o.type;
+  if (i === "email") {
+    l(o, r, ["type", "address", "name"], e);
+    const a = f(
+      o.address,
+      `${r}.address`,
+      c.id,
+      e
+    ), p = u(
+      o.name,
+      `${r}.name`,
+      c.attachmentTitle,
+      e
+    );
+    return a && !Y(a) && d(e, `${r}.address`, "Email address is invalid."), {
+      type: "email",
+      address: a,
+      ...p ? { name: p } : {}
+    };
+  }
+  return i === "user" ? (l(o, r, ["type", "userId"], e), {
+    type: "user",
+    userId: f(
+      o.userId,
+      `${r}.userId`,
+      c.id,
+      e
+    )
+  }) : i === "tenant_user" ? (l(o, r, ["type", "tenantUserId"], e), {
+    type: "tenant_user",
+    tenantUserId: f(
+      o.tenantUserId,
+      `${r}.tenantUserId`,
+      c.id,
+      e
+    )
+  }) : i === "group" ? (l(o, r, ["type", "groupId"], e), {
+    type: "group",
+    groupId: f(
+      o.groupId,
+      `${r}.groupId`,
+      c.id,
+      e
+    )
+  }) : (d(
+    e,
+    `${r}.type`,
+    "Expected email, user, tenant_user, or group."
+  ), { type: "email", address: "" });
+}
+function ie(t, n) {
+  return Array.isArray(t) ? t.map(
+    (e, r) => oe(e, r, n)
+  ) : (d(n, "deliveryConfig.recipients", "Expected an array."), []);
+}
+function ae(t, n) {
+  if (!Array.isArray(t))
+    return d(n, "deliveryConfig.channels", "Expected an array."), [];
+  const e = [];
+  return t.forEach((r, o) => {
+    if (!M(r)) {
+      d(
+        n,
+        `deliveryConfig.channels.${o}`,
+        "Expected EMAIL, WEBHOOK, SLACK, IN_APP, or TELEGRAM."
+      );
+      return;
+    }
+    e.includes(r) || e.push(r);
+  }), e;
+}
+function de(t, n, e) {
+  if (t == null)
+    return;
+  const r = m(t, n, e), o = {};
+  return Object.entries(r).forEach(([i, a]) => {
+    if (typeof a != "string") {
+      d(e, `${n}.${i}`, "Expected a string.");
+      return;
+    }
+    o[i] = a.trim();
+  }), Object.keys(o).length > 0 ? o : void 0;
+}
+function ce(t, n, e) {
+  if (t == null)
+    return;
+  const r = m(t, n, e);
+  l(
+    r,
+    n,
+    ["url", "method", "headers", "secretEncrypted"],
+    e
+  );
+  const o = r.method === void 0 || r.method === null ? void 0 : g(r.method, `${n}.method`, ["POST", "PUT"], e), i = de(r.headers, `${n}.headers`, e), a = u(
+    r.secretEncrypted,
+    `${n}.secretEncrypted`,
+    2e3,
+    e
+  );
+  return {
+    url: f(r.url, `${n}.url`, 2e3, e),
+    ...o ? { method: o } : {},
+    ...i ? { headers: i } : {},
+    ...a ? { secretEncrypted: a } : {}
+  };
+}
+function se(t, n, e) {
+  const r = m(t, n, e);
+  l(
+    r,
+    n,
+    [
+      "subjectOverride",
+      "titleOverride",
+      "summaryOverride",
+      "actionBlockVisible",
+      "webhookConfig"
+    ],
+    e
+  );
+  const o = u(
+    r.subjectOverride,
+    `${n}.subjectOverride`,
+    500,
+    e
+  ), i = u(
+    r.titleOverride,
+    `${n}.titleOverride`,
+    500,
+    e
+  ), a = u(
+    r.summaryOverride,
+    `${n}.summaryOverride`,
+    2e3,
+    e
+  ), p = C(
+    r.actionBlockVisible,
+    !0,
+    `${n}.actionBlockVisible`,
+    e
+  ), y = ce(
+    r.webhookConfig,
+    `${n}.webhookConfig`,
+    e
+  );
+  return {
+    ...o ? { subjectOverride: o } : {},
+    ...i ? { titleOverride: i } : {},
+    ...a ? { summaryOverride: a } : {},
+    ...r.actionBlockVisible !== void 0 ? { actionBlockVisible: p } : {},
+    ...y ? { webhookConfig: y } : {}
+  };
+}
+function le(t, n) {
+  if (t == null)
+    return;
+  const e = m(t, "deliveryConfig.channelConfigs", n), r = {};
+  return Object.entries(e).forEach(([o, i]) => {
+    if (!M(o)) {
+      d(
+        n,
+        `deliveryConfig.channelConfigs.${o}`,
+        "Expected a supported delivery channel."
+      );
+      return;
+    }
+    r[o] = se(
+      i,
+      `deliveryConfig.channelConfigs.${o}`,
+      n
+    );
+  }), Object.keys(r).length > 0 ? r : void 0;
+}
+function fe(t, n) {
+  if (t == null)
+    return null;
+  const e = m(t, "deliveryConfig", n);
+  l(
+    e,
+    "deliveryConfig",
+    ["recipients", "channels", "channelConfigs"],
+    n
+  );
+  const r = le(e.channelConfigs, n), o = ie(e.recipients, n), i = ae(e.channels, n);
+  return o.length === 0 && d(
+    n,
+    "deliveryConfig.recipients",
+    "Add at least one recipient or remove delivery config."
+  ), i.length === 0 && d(
+    n,
+    "deliveryConfig.channels",
+    "Choose at least one delivery channel or remove delivery config."
+  ), {
+    recipients: o,
+    channels: i,
+    ...r ? { channelConfigs: r } : {}
+  };
+}
+function T(t) {
+  const n = [], e = m(t, "draft", n);
+  l(
+    e,
+    "draft",
+    [
+      "name",
+      "description",
+      "status",
+      "scheduleExpr",
+      "timezone",
+      "source",
+      "body",
+      "attachments",
+      "presentation",
+      "limits",
+      "deliveryConfig"
+    ],
+    n
+  );
+  const r = f(
+    e.name,
+    "name",
+    c.name,
+    n
+  ), o = u(
+    e.description,
+    "description",
+    c.description,
+    n
+  ) ?? null, i = u(e.scheduleExpr, "scheduleExpr", 500, n) ?? null, a = u(e.timezone, "timezone", 200, n) ?? "UTC", p = W(e.status, n), y = O(e.source, n), s = B(e.body, n), h = D(e.attachments, n), k = R(e.presentation, n), _ = V(e.limits, n), L = fe(e.deliveryConfig, n);
+  return j(s, h, n), N(n), {
+    name: r,
+    description: o,
+    status: p,
+    scheduleExpr: i,
+    timezone: a,
+    source: y,
+    body: s,
+    attachments: h,
+    presentation: k,
+    ..._ ? { limits: _ } : {},
+    deliveryConfig: L
+  };
+}
+function he(t) {
+  return T(t);
+}
+function ye(t) {
+  return T(t);
+}
+function ge(t) {
+  try {
+    return { valid: !0, value: T(t), issues: [] };
+  } catch (n) {
+    if (n instanceof S)
+      return { valid: !1, issues: n.issues };
+    throw n;
+  }
+}
+function Ie(t) {
+  try {
+    return { valid: !0, value: w(t), issues: [] };
+  } catch (n) {
+    if (n instanceof S)
+      return { valid: !1, issues: n.issues };
+    throw n;
+  }
+}
+function be(t) {
+  return typeof t == "string" && z.has(t);
+}
+function M(t) {
+  return typeof t == "string" && H.has(t);
+}
+export {
+  U as BRIEFING_ARTIFACT_FORMATS,
+  A as BRIEFING_KIND,
+  c as BRIEFING_TEXT_LIMITS,
+  S as BriefingContractError,
+  v as DEFAULT_BRIEFING_ARTIFACT_FORMATS,
+  ue as MAX_BRIEFING_ATTACHMENTS,
+  pe as buildBriefingJobConfig,
+  he as buildCreateBriefingRequest,
+  ye as buildUpdateBriefingRequest,
+  be as isBriefingArtifactFormat,
+  M as isBriefingDeliveryChannel,
+  T as normalizeBriefingDraft,
+  w as normalizeBriefingJobConfig,
+  ge as validateBriefingDraft,
+  Ie as validateBriefingJobConfig
+};