@tnid/filter 0.1.0

package/script/internals.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Shared internals for filter functions.
+ * @internal Not part of the public API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lastSafeTimestamp = exports.V1_RANDOM_BITS = exports.V0_RANDOM_BITS = exports.FIRST_CHAR_WITH_RANDOM = void 0;
+exports.recordSafeTimestamp = recordSafeTimestamp;
+exports.getStartingTimestamp = getStartingTimestamp;
+exports.randomBigInt = randomBigInt;
+exports.dataString = dataString;
+exports.matchTouchesRandomPortion = matchTouchesRandomPortion;
+exports.timestampBumpForChar = timestampBumpForChar;
+exports.handleV0Match = handleV0Match;
+// V0 data string character layout:
+// Chars 0-6: pure timestamp bits
+// Char 7: 1 timestamp bit + 2 variant bits + 3 random bits
+// Chars 8-16: pure random bits
+exports.FIRST_CHAR_WITH_RANDOM = 7;
+exports.V0_RANDOM_BITS = 57;
+exports.V1_RANDOM_BITS = 100;
+/** Global last-known-safe timestamp to avoid re-discovering bad windows. */
+exports.lastSafeTimestamp = 0n;
+function recordSafeTimestamp(ts) {
+    if (ts > exports.lastSafeTimestamp) {
+        exports.lastSafeTimestamp = ts;
+    }
+}
+function getStartingTimestamp() {
+    const current = BigInt(Date.now());
+    return current > exports.lastSafeTimestamp ? current : exports.lastSafeTimestamp;
+}
+/** Generate a random bigint with the specified number of bits. */
+function randomBigInt(bits) {
+    const bytes = new Uint8Array(Math.ceil(bits / 8));
+    crypto.getRandomValues(bytes);
+    let result = 0n;
+    for (const b of bytes)
+        result = (result << 8n) | BigInt(b);
+    return result & ((1n << BigInt(bits)) - 1n);
+}
+/** Extract the 17-char data string from a TNID string. */
+function dataString(tnid) {
+    return tnid.substring(tnid.indexOf(".") + 1);
+}
+/**
+ * Check if a match touches the random portion of V0 data string.
+ * If true, regenerating random bits may resolve the match.
+ * If false, the match is entirely in the timestamp portion and requires bumping.
+ */
+function matchTouchesRandomPortion(start, length) {
+    return start + length > exports.FIRST_CHAR_WITH_RANDOM;
+}
+/**
+ * Minimum timestamp bump (in ms) needed to change the character at position `pos`.
+ * Each character encodes 6 bits. Lower positions = more significant = larger bump.
+ */
+function timestampBumpForChar(pos) {
+    return 1n << BigInt(42 - 6 * pos);
+}
+/**
+ * Handle a V0 blocklist match: bump timestamp if match is in timestamp portion.
+ * Returns the (possibly bumped) timestamp.
+ */
+function handleV0Match(match, timestamp) {
+    if (!matchTouchesRandomPortion(match.start, match.length)) {
+        const rightmostChar = match.start + match.length - 1;
+        return timestamp + timestampBumpForChar(rightmostChar);
+    }
+    return timestamp;
+}

package/script/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}