@particle-academy/fancy-connector-core 0.3.0 → 0.4.0

package/dist/index.d.cts

@@ -814,7 +814,7 @@ type CallOptions = {
      */
     credentials?: ConnectionCredentials;
     /** Which estate to use. Resolved from the connection host when omitted. */
-    mode?: ConnectorMode;
+    mode?: RequestedMode;
     /** Connection id, for the registered-host path. */
     connectionId?: string | null;
     /**
@@ -1305,6 +1305,17 @@ type IdempotencyOptions = {
     now?: Date;
     /** For the error message when a key cannot be made safe. */
     context?: Partial<ConnectorErrorContext>;
+    /**
+     * The PROVIDER'S own limit, when it declares one — `idempotencyMaxLength` in
+     * the connector index. Omitted uses {@link MAX_IDEMPOTENCY_KEY_LENGTH}, which
+     * is the catalogue CEILING rather than any one provider's limit.
+     *
+     * Discord's `discord_message` declares 25, and for years only the ceiling was
+     * applied — so a legitimate engine-derived key came back at 29 characters and
+     * the connector's own validation refused it, failing the run at a node the
+     * host had no way to fix.
+     */
+    maxLength?: number | null;
 };
 /**
  * The idempotency key for this execution of this node, or `null`.

package/dist/index.d.ts

@@ -814,7 +814,7 @@ type CallOptions = {
      */
     credentials?: ConnectionCredentials;
     /** Which estate to use. Resolved from the connection host when omitted. */
-    mode?: ConnectorMode;
+    mode?: RequestedMode;
     /** Connection id, for the registered-host path. */
     connectionId?: string | null;
     /**
@@ -1305,6 +1305,17 @@ type IdempotencyOptions = {
     now?: Date;
     /** For the error message when a key cannot be made safe. */
     context?: Partial<ConnectorErrorContext>;
+    /**
+     * The PROVIDER'S own limit, when it declares one — `idempotencyMaxLength` in
+     * the connector index. Omitted uses {@link MAX_IDEMPOTENCY_KEY_LENGTH}, which
+     * is the catalogue CEILING rather than any one provider's limit.
+     *
+     * Discord's `discord_message` declares 25, and for years only the ceiling was
+     * applied — so a legitimate engine-derived key came back at 29 characters and
+     * the connector's own validation refused it, failing the run at a node the
+     * host had no way to fix.
+     */
+    maxLength?: number | null;
 };
 /**
  * The idempotency key for this execution of this node, or `null`.

package/dist/index.js

@@ -829,7 +829,7 @@ function idempotencyKeyFor(ctx, nodeId, options = {}) {
   const windowSeconds = options.windowSeconds === void 0 ? DEFAULT_IDEMPOTENCY_WINDOW_SECONDS : options.windowSeconds;
   if (!identity) {
     const runKey = runKeyFrom(ctx);
-    return runKey === null ? null : fit(`${runKey}:${nodeId}`);
+    return runKey === null ? null : fit(`${runKey}:${nodeId}`, options.maxLength);
   }
   if (!identity.isReplaySafe(windowSeconds, options.now ?? /* @__PURE__ */ new Date())) {
     throw new ConnectorIdempotencyExpiredError(
@@ -841,13 +841,15 @@ function idempotencyKeyFor(ctx, nodeId, options = {}) {
       }
     );
   }
-  return fit(identity.stepKey(nodeId, options.occurrence));
+  return fit(identity.stepKey(nodeId, options.occurrence), options.maxLength);
 }
 var NO_IDEMPOTENCY_KEY_WARNING = "no run identity available, so this write is being sent WITHOUT an idempotency key. A retry would repeat the effect rather than recover from it \u2014 the node is marked unsafe-to-replay, so a durable runner will give it one attempt. Durable runs supply an identity automatically; for a synchronous run, pass `run` in RunOptions.";
-function fit(key) {
-  if (key.length <= MAX_IDEMPOTENCY_KEY_LENGTH) return key;
+function fit(key, maxLength) {
+  const limit = maxLength === void 0 || maxLength === null ? MAX_IDEMPOTENCY_KEY_LENGTH : Math.max(1, Math.min(maxLength, MAX_IDEMPOTENCY_KEY_LENGTH));
+  if (key.length <= limit) return key;
   const digest = fnv1a(key);
-  const head = key.slice(0, MAX_IDEMPOTENCY_KEY_LENGTH - digest.length - 1);
+  if (limit <= digest.length + 1) return digest.slice(0, limit);
+  const head = key.slice(0, limit - digest.length - 1);
   return `${head}~${digest}`;
 }
 function fnv1a(value) {