@secondlayer/sentinel 0.4.0 → 0.6.0

package/dist/index.js

@@ -79,6 +79,13 @@ class SentinelError extends Error {
     this.name = "SentinelError";
   }
 }
+var runInProgress = (status) => status === "queued" || status === "running";
+function runPhase(run) {
+  if (run.status === "queued")
+    return "queued";
+  const last = run.events.at(-1);
+  return last ? [last.name ?? last.kind, last.state].filter(Boolean).join(" ") : "starting";
+}
 var rowsOf = (intents) => intents.flatMap((i) => i.rows);
 var subjectKey = (s) => s.kind === "fn" ? `fn:${s.fn}` : s.kind === "group" ? `group:${s.group}` : `asset:${s.asset}`;
 var CONTROL_NAME = "Control changes";
@@ -206,10 +213,30 @@ function mutedUntilOf(w, now = Date.now()) {
   const at = w.delivery.mutedUntil;
   return at && Date.parse(at) > now ? at : null;
 }
+function changeText(c) {
+  const name = c.subject.kind === "asset" ? subjectName(c.subject, c.units) : c.watch.title;
+  const rule = (r) => ruleSummary(r, c.units);
+  switch (c.action) {
+    case "on":
+      return `${c.watch.title} turned on`;
+    case "off":
+      return `${c.watch.title} turned off`;
+    case "muted":
+    case "cooldown":
+      return `${c.watch.title}: ${c.action === "muted" ? "mute" : "cooldown"} ${c.note ?? ""}`.trim();
+    case "applied":
+      if (c.prevRule && c.rule)
+        return `${name} rule changed: ${rule(c.prevRule)} → ${rule(c.rule)}`;
+      return c.rule ? `${name} rule set: ${rule(c.rule)}` : `${name} rule set`;
+  }
+}
 function createClient(opts) {
   const baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
   const doFetch = opts.fetch ?? globalThis.fetch;
-  const authHeader = () => ({ authorization: `Bearer ${opts.token}` });
+  const authHeader = () => ({
+    authorization: `Bearer ${opts.token}`,
+    ...opts.client ? { "x-sentinel-client": opts.client } : {}
+  });
   async function call(method, path, body) {
     const res = await doFetch(`${baseUrl}${path}`, {
       method,
@@ -226,6 +253,7 @@ function createClient(opts) {
   }
   const plan = (id) => `/v1/plans/${encodeURIComponent(id)}`;
   const appPlan = (id) => `/plan/${encodeURIComponent(id)}`;
+  const appProject = (id) => `/projects/${encodeURIComponent(id)}`;
   return {
     me: () => call("GET", "/v1/me"),
     plans: async () => (await call("GET", "/v1/plans")).plans,
@@ -241,6 +269,8 @@ function createClient(opts) {
     testsFromRepo: (id) => call("POST", `${appPlan(id)}/tests`, { fromRepo: true }),
     previewPlan: (contractId) => call("POST", "/plan/preview", { contractId }),
     createPlan: (contractId) => call("POST", "/plan", { contractId }),
+    previewImport: (url) => call("POST", "/projects/import/preview", { url }),
+    importRepo: (input) => call("POST", "/projects/import", input),
     billing: () => call("GET", "/billing"),
     watches: (planId) => call("GET", `${appPlan(planId)}/watches`),
     setRule: (planId, watchId, rule) => call("POST", `${appPlan(planId)}/watches/${encodeURIComponent(watchId)}/rule`, { rule }),
@@ -257,9 +287,70 @@ function createClient(opts) {
     watchContract: (contractId) => call("POST", "/contracts/watch", {
       contractId
     }),
-    stopMonitoring: (planId) => call("DELETE", `${appPlan(planId)}/monitor`)
+    stopMonitoring: (planId) => call("DELETE", `${appPlan(planId)}/monitor`),
+    watchActivity: (planId, intentId, opts = {}) => call("GET", `${appPlan(planId)}/watches/${encodeURIComponent(intentId)}/activity${query(opts)}`),
+    functions: async (planId) => (await call("GET", `${appPlan(planId)}/functions`)).functions,
+    functionActivity: (planId, fn) => call("GET", `${appPlan(planId)}/functions/${encodeURIComponent(fn)}/activity`),
+    alertPreview: (planId, example) => call("GET", `${appPlan(planId)}/alert-preview${query({ example })}`),
+    threshold: (planId, asset) => call("GET", `${appPlan(planId)}/watches/asset/${encodeURIComponent(asset)}/threshold`),
+    setThreshold: (planId, asset, amount) => call("POST", `${appPlan(planId)}/watches/asset/${encodeURIComponent(asset)}/threshold`, { amount }),
+    retryHistory: (planId) => call("POST", `${appPlan(planId)}/history/retry`, {}),
+    readAlert: (alertId) => call("POST", `/alerts/${encodeURIComponent(alertId)}/read`),
+    readAllAlerts: () => call("POST", "/alerts/read-all"),
+    ask: (q) => call("POST", "/ask", { q }),
+    acknowledge: (planId, finding, title, reason, note = null) => call("POST", `${appPlan(planId)}/acknowledge`, {
+      finding,
+      title,
+      reason,
+      note
+    }),
+    reopen: (planId, finding, title) => call("POST", `${appPlan(planId)}/reopen`, { finding, title }),
+    ackHistory: async (planId) => (await call("GET", `${appPlan(planId)}/acks`)).events,
+    notes: async (planId, finding) => (await call("GET", `${appPlan(planId)}/findings/${finding}/notes`)).notes,
+    addNote: (planId, finding, title, body) => call("POST", `${appPlan(planId)}/findings/${finding}/notes`, {
+      title,
+      body
+    }),
+    tests: (planId, files) => call("POST", `${appPlan(planId)}/tests`, { files }),
+    fuzzCheck: (planId, harness) => call("POST", `${appPlan(planId)}/fuzzcheck`, { harness }),
+    fuzz: (planId, invariants) => call("POST", `${appPlan(planId)}/fuzz`, { invariants }),
+    latestCommit: (planId) => call("GET", `${appPlan(planId)}/latest`),
+    updatePlan: (planId, commit) => call("POST", `${appPlan(planId)}/update`, commit ? { commit } : {}),
+    setAutoPlan: (planId, auto) => call("POST", `${appPlan(planId)}/wait`, { auto }),
+    setLink: (planId, dependency, url) => call("POST", `${appPlan(planId)}/link`, { id: dependency, url }),
+    planLinked: (planId) => call("POST", `${appPlan(planId)}/plan-linked`, {}),
+    renameContract: (planId, name) => call("POST", `${appPlan(planId)}/settings`, { name }),
+    removeContract: (planId, confirm) => call("POST", `${appPlan(planId)}/remove`, {
+      confirm
+    }),
+    projects: () => call("GET", "/projects"),
+    project: (projectId) => call("GET", appProject(projectId)),
+    projectOverview: (projectId, opts = {}) => call("GET", `${appProject(projectId)}/overview${opts.watches ? "?watches=1" : ""}`),
+    renameProject: (projectId, name) => call("POST", `${appProject(projectId)}/rename`, { name }),
+    removeProject: (projectId, confirm) => call("POST", `${appProject(projectId)}/remove`, {
+      confirm
+    }),
+    answerMergeSuggestion: (from, into, accept) => call("POST", "/projects/merge", { from, into, accept }),
+    mergeProject: (projectId, into) => call("POST", `${appProject(projectId)}/merge-into`, { into }),
+    moveProjectContract: (projectId, contractId, into) => call("POST", `${appProject(projectId)}/contracts/${encodeURIComponent(contractId)}/move`, { into }),
+    removeProjectContract: (projectId, contractId, confirm) => call("POST", `${appProject(projectId)}/contracts/${encodeURIComponent(contractId)}/remove`, { confirm }),
+    previewProjectContract: (projectId, contractId) => call("POST", `${appProject(projectId)}/contracts/preview`, { contractId }),
+    addProjectContract: (projectId, contractId, opts = {}) => call("POST", `${appProject(projectId)}/contracts`, { contractId, ...opts }),
+    setProjectDestinations: (projectId, dest) => call("POST", `${appProject(projectId)}/destinations`, dest),
+    setProjectMonitoring: (projectId, on) => call("POST", `${appProject(projectId)}/monitoring`, { on }),
+    projectWatches: (projectId) => call("GET", `${appProject(projectId)}/watches`),
+    projectActivity: (projectId, intentId, opts = {}) => call("GET", `${appProject(projectId)}/watches/${encodeURIComponent(intentId)}/activity${query(opts)}`),
+    projectChanges: (projectId, opts = {}) => call("GET", `${appProject(projectId)}/changes${query(opts)}`)
   };
 }
+function query(params) {
+  const q = new URLSearchParams;
+  for (const [k, v] of Object.entries(params))
+    if (v !== undefined && v !== null)
+      q.set(k, String(v));
+  const s = q.toString();
+  return s ? `?${s}` : "";
+}
 var HOUR_MS = 3600000;
 var muteEnd = (hours) => new Date(Date.now() + Math.min(hours * HOUR_MS, 7 * 24 * HOUR_MS - 60000)).toISOString();
 async function watchContext(client, planId) {
@@ -295,6 +386,7 @@ export {
   SentinelError,
   SubjectError,
   assetClause,
+  changeText,
   clearSession,
   clearTokenFile,
   createClient,
@@ -312,6 +404,8 @@ export {
   resolveToken,
   rowsOf,
   ruleSummary,
+  runInProgress,
+  runPhase,
   savedChoices,
   savedMonitor,
   sessionPath,