@deadair/plugin-sdk 0.77.7 → 0.77.8

package/dist/index.d.ts

@@ -23,6 +23,7 @@ export * from './define.plugin.js';
 export * from './feed.parse.js';
 export * from './html.text.js';
 export * from './match.text.js';
+export * from './message.inbox.js';
 export * from './plausible.audio.js';
 export * from './plugin.api.version.js';
 export * from './plugin.base.js';
@@ -33,6 +34,7 @@ export * from './plugin.host.js';
 export * from './plugin.host.response.js';
 export * from './plugin.http.js';
 export * from './plugin.lifecycle.js';
+export * from './plugin.logger.js';
 export * from './plugin.manifest.js';
 export * from './plugin.permissions.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -308,6 +308,12 @@ function toPluginError(error, fallback = "internal") {
 }
 __name(toPluginError, "toPluginError");
 var errorText = /* @__PURE__ */ __name((error) => error instanceof Error ? error.message : String(error), "errorText");
+function scrubSecrets(text2, secrets) {
+  let scrubbed = text2;
+  for (const secret of secrets) if (secret !== "") scrubbed = scrubbed.split(secret).join("<token>");
+  return scrubbed;
+}
+__name(scrubSecrets, "scrubSecrets");
 
 // src/capabilities/llm.ts
 async function collectGeneration(handle, signal) {
@@ -1003,6 +1009,66 @@ function textAgreement(candidate, reference) {
 }
 __name(textAgreement, "textAgreement");
 
+// src/message.inbox.ts
+var MessageInbox = class {
+  static {
+    __name(this, "MessageInbox");
+  }
+  max;
+  held = [];
+  wake;
+  overflowed = false;
+  /** @param max - How many messages are held at once. */
+  constructor(max) {
+    this.max = max;
+  }
+  /**
+   * Queue one message, dropping the oldest past the bound, and wake a `take` that is waiting.
+   *
+   * Answers `true` the FIRST time a message is dropped and never again, so the caller can say so
+   * once in its log rather than once per message in a flood.
+   */
+  deliver(message) {
+    this.held.push(message);
+    let firstDrop = false;
+    if (this.held.length > this.max) {
+      this.held.shift();
+      firstDrop = !this.overflowed;
+      this.overflowed = true;
+    }
+    this.wake?.();
+    return firstDrop;
+  }
+  /**
+   * Everything held, emptying the inbox. When nothing is held it first waits up to `waitMs` for a
+   * message, an {@link interrupt} or a {@link close}, whichever comes first.
+   */
+  async take(waitMs) {
+    if (this.held.length === 0 && waitMs > 0) await this.waitForMessages(waitMs);
+    return this.held.splice(0);
+  }
+  /** Wake a waiting `take` without delivering anything, for a socket that has stopped for good. */
+  interrupt() {
+    this.wake?.();
+  }
+  /** Wake a waiting `take` and drop everything held, for a plugin being disposed. */
+  close() {
+    this.wake?.();
+    this.held.length = 0;
+  }
+  waitForMessages(waitMs) {
+    return new Promise((resolve) => {
+      const done = /* @__PURE__ */ __name(() => {
+        clearTimeout(timer);
+        if (this.wake === done) this.wake = void 0;
+        resolve();
+      }, "done");
+      const timer = setTimeout(done, waitMs);
+      this.wake = done;
+    });
+  }
+};
+
 // src/plausible.audio.ts
 var MIN_PLAUSIBLE_AUDIO_BYTES = 256;
 function plausibleAudio({ engine, asked, advice }) {
@@ -1149,6 +1215,19 @@ function parseRows(raw) {
   }
 }
 __name(parseRows, "parseRows");
+function rowsHaveColumns(raw, columns) {
+  if (raw === void 0) return true;
+  return parseRows(raw).every((row) => columns.every((column) => Boolean(row[column]?.trim())));
+}
+__name(rowsHaveColumns, "rowsHaveColumns");
+function numberCell(raw, options = {}) {
+  if (raw === void 0 || raw.trim().length === 0) return void 0;
+  const parsed = Number(raw);
+  if (!Number.isFinite(parsed)) return void 0;
+  if (options.positive === true && parsed <= 0) return void 0;
+  return options.range === void 0 ? parsed : Math.min(options.range.max, Math.max(options.range.min, parsed));
+}
+__name(numberCell, "numberCell");
 function sentToProblems(fields) {
   const isAddress = /* @__PURE__ */ __name((type) => type === "url" || type === "string", "isAddress");
   const problems = [];
@@ -1335,6 +1414,22 @@ async function tryJsonBody(response) {
 }
 __name(tryJsonBody, "tryJsonBody");
 
+// src/plugin.logger.ts
+function variadicLogger(logger) {
+  const meta = /* @__PURE__ */ __name((rest) => {
+    const first = rest[0];
+    return first !== null && typeof first === "object" && !Array.isArray(first) ? first : void 0;
+  }, "meta");
+  return {
+    error: /* @__PURE__ */ __name((message, ...rest) => logger.error(String(message), meta(rest)), "error"),
+    warn: /* @__PURE__ */ __name((message, ...rest) => logger.warn(String(message), meta(rest)), "warn"),
+    info: /* @__PURE__ */ __name((message, ...rest) => logger.info(String(message), meta(rest)), "info"),
+    debug: /* @__PURE__ */ __name((message, ...rest) => logger.debug(String(message), meta(rest)), "debug"),
+    trace: /* @__PURE__ */ __name((message, ...rest) => logger.debug(String(message), meta(rest)), "trace")
+  };
+}
+__name(variadicLogger, "variadicLogger");
+
 // src/plugin.manifest.ts
 import { z as z3 } from "zod";
 
@@ -1474,6 +1569,7 @@ export {
   KNOWN_ENRICHMENT_MATCH_KEYS,
   KNOWN_PLUGIN_CAPABILITIES,
   MIN_PLAUSIBLE_AUDIO_BYTES,
+  MessageInbox,
   PLUGIN_API_VERSION,
   PLUGIN_CAPABILITY_ALMANAC,
   PLUGIN_CAPABILITY_ANALYSIS,
@@ -1538,6 +1634,7 @@ export {
   jsonBody,
   networkPermissionSchema,
   normalize,
+  numberCell,
   parseFeed,
   parseMultiSelect,
   parseRows,
@@ -1550,6 +1647,8 @@ export {
   readRowSecret,
   retryAfterMs,
   rowSecretKey,
+  rowsHaveColumns,
+  scrubSecrets,
   sentToProblems,
   sentencesOf,
   sentencesWithin,
@@ -1561,6 +1660,7 @@ export {
   tryJsonBody,
   upstreamDetail,
   upstreamField,
+  variadicLogger,
   withoutCues
 };
 //# sourceMappingURL=index.js.map